Overview

// EVM mental model — call a contract
oracle.getAssetInfo(assetId);

// Sui mental model — pass the shared object by reference
price_feed::get_asset_info(&feed, asset_id);

// Sui — 1 hour in milliseconds
let max_age_ms: u64 = 3_600_000;

// NOT 3_600 — that would be 3.6 seconds

let pair        = price_feed::get_pair_by_id(feed, cngn_id, usdt_id, 0);
let raw_price   = price_feed::derived_price(pair);
let human_price = raw_price / 1_000_000_000_000_000_000_000_000_000_000; // 10^30

// Safe — returns (PriceFeed, bool)
let (feed, exists) = price_feed::get_asset_info(oracle_feed, asset_id);
if (!exists) { /* handle gracefully */ };

// Aborts if either asset missing — verify first
assert!(exists_0 && exists_1, E_ASSET_NOT_FOUND);
let pair = price_feed::get_pair_by_id(oracle_feed, id0, id1, 0);

// Sui Move — hex literal, no 0x prefix
use ifa_oracle::bytes32;
let usdt_id = bytes32::new(
    x"6ca0cef6107263f3b09a51448617b659278cff744f0e702c24a2f88c91e65a0d"
);

// TypeScript — byte array, no 0x prefix
const usdtId = Array.from(
  Buffer.from("6ca0cef6107263f3b09a51448617b659278cff744f0e702c24a2f88c91e65a0d", "hex")
);

// Sui — built-in helper
let fresh = price_feed::is_fresh(price_feed, current_time_ms, max_age_ms);

// EVM — you implement this yourself
require(block.timestamp - info.lastUpdateTime <= MAX_PRICE_AGE, "Stale");

                    ┌─────────────────────────────────┐
                    │         IFÁ Labs Relayer          │
                    │  Aggregates prices off-chain and  │
                    │  submits via IfaPriceFeedVerifier  │
                    └───────────────┬─────────────────┘
                                    │
                                    ▼
                    ┌─────────────────────────────────┐
                    │     IfaPriceFeedVerifier          │
                    │  Shared object — validates        │
                    │  relayer address and feed ID      │
                    │  before writing to the feed       │
                    └───────────────┬─────────────────┘
                                    │  submit_price_feed
                                    ▼
                    ┌─────────────────────────────────┐
                    │         IfaPriceFeed              │
                    │  Shared object — stores all       │
                    │  asset prices keyed by Bytes32    │
                    │  asset ID                         │
                    └───────────────┬─────────────────┘
                                    │  get_asset_info
                                    │  get_assets_info
                                    │  get_pair_by_id
                                    ▼
                    ┌─────────────────────────────────┐
                    │       Your Move Protocol          │
                    │  Passes &IfaPriceFeed by          │
                    │  immutable reference to read      │
                    │  prices                           │
                    └─────────────────────────────────┘