Quantillon Protocol

IStorkFeed

Git Source

Stork Network oracle feed interface

This interface is based on Stork's EVM contract API VERIFICATION STATUS: ✅ Function getTemporalNumericValueV1 - Verified matches Stork's contract ✅ Struct TemporalNumericValue - Verified matches Stork's contract ✅ Decimals handling - Stork feeds use 18 decimals (constant, no function needed) NOTE: Stork's official SDK uses interface name "IStork" instead of "IStorkFeed", but the function signatures are identical. This interface should work correctly. IMPORTANT: Stork's contract does NOT have a decimals() function. Stork feeds use 18 decimals precision (value is multiplied by 10^18). We use constant STORK_FEED_DECIMALS = 18 instead of calling decimals(). See docs/STORK_INTERFACE_VERIFICATION.md for detailed verification Resources:

  • Documentation: https://docs.storkengine.com/contract-apis/evm
  • Contract Addresses: https://docs.stork.network/resources/contract-addresses/evm
  • Asset ID Registry: https://docs.stork.network/resources/asset-id-registry
  • GitHub: https://github.com/Stork-Oracle/stork-external
  • Official SDK: storknetwork/stork-evm-sdk (npm package) NOTE: Stork also provides Chainlink and Pyth adapters that may be easier to integrate. Consider using StorkChainlinkAdapter if you want to use Chainlink's familiar interface.

Note: security-contact: team@quantillon.money

Functions

getTemporalNumericValueV1

Gets the latest temporal numeric value for a given feed ID

Feed IDs are specific to each price pair (e.g., EUR/USD, USDC/USD) Obtain feed IDs from Stork's Asset ID Registry: https://docs.stork.network/resources/asset-id-registry ✅ Verified: Function signature matches Stork's contract

Notes:

  • security: Interface function - no security implications

  • validation: No validation - interface definition

  • state-changes: No state changes - view function

  • events: No events emitted

  • errors: No errors thrown

  • reentrancy: Not protected - view function

  • access: Public - no access restrictions

  • oracle: Interface for Stork feed contract

function getTemporalNumericValueV1(bytes32 id) external view returns (TemporalNumericValue memory);

Parameters

NameTypeDescription
idbytes32The feed ID (bytes32 identifier for the price feed)

Returns

NameTypeDescription
<none>TemporalNumericValueThe temporal numeric value containing price and timestamp

Structs

TemporalNumericValue

Temporal numeric value structure returned by Stork feeds

Verified to match Stork's StorkStructs.TemporalNumericValue

struct TemporalNumericValue {
    int256 value;
    uint256 timestamp;
}

Properties

NameTypeDescription
valueint256The price value (can be negative for some feeds)
timestampuint256The timestamp when the value was last updated