اوراکل قیمت برای قراردادهای هوشمند: فارکس، طلا، شاخص‌ها و سهام روی زنجیره

چگونه کار می‌کند

1. دریافت گزارش امضاشده: GET /oracle/report با کلید API شما.
2. آن را در تراکنش خود ارسال کنید: قرارداد تأییدکننده ما امضا را با ecrecover بررسی می‌کند.
3. از قیمت تأییدشده استفاده کنید؛ اگر برای کاربرد شما خیلی قدیمی است ردش کنید.

گزارش‌ها داده‌های تایپ‌شده EIP-712 PriceReport(bytes32 feedId,int256 price,uint64 timestamp,uint64 validUntil,uint8 marketStatus,uint32 spreadBps) هستند، به یک زنجیره و یک قرارداد تأییدکننده گره خورده‌اند (بدون استفاده مجدد در جای دیگر) و فقط تا validUntil پذیرفته می‌شوند، حدود یک دقیقه پس از امضا (انباشتن گزارش‌های مساعد ممکن نیست). قیمت‌ها میانگین خرید و فروش با 8 رقم اعشار هستند؛ spreadBps اسپرد خرید و فروش است. وقتی گزارشی را در تراکنش خودتان ارسال می‌کنید، گس آن را می‌پردازید. فیدهای پرتقاضا را رله‌کننده ما هم گاه‌به‌گاه روی زنجیره ذخیره می‌کند (خواندن رایگان)، اما همیشه عمر قیمت ذخیره‌شده را بررسی کنید.

ساعات بازار

هر گزارش وضعیت بازار را اعلام می‌کند: OPEN (قیمت زنده، حداکثر 60 ثانیه قدیمی)، CLOSED (آخرین قیمت رسمی پیش از بسته شدن، برای همه یکسان، که هر زمان در مدت بسته بودن بازار امضا می‌شود) یا HALTED (معاملات متوقف). getPriceNoOlderThan فقط قیمت‌های OPEN را برمی‌گرداند، پس قیمت بسته شدن هرگز به‌جای قیمت زنده پذیرفته نمی‌شود. توکن‌های پشتوانه‌دار باید سفارش‌هایی را که در زمان بسته بودن بازار ثبت شده‌اند با قیمت OPEN بعدی تسویه کنند (قیمت‌گذاری پیش‌رو، همان کاری که صندوق‌ها و ETFها می‌کنند).

مدارشکن

هر فید می‌تواند حداکثر جهش مجاز داشته باشد. حرکت بزرگ‌تر ذخیره نمی‌شود: فید تا زمانی که ما آن را بررسی و دوباره باز کنیم متوقف می‌ماند، پس قیمت نادرست یا دست‌کاری‌شده هرگز به قرارداد شما نمی‌رسد.

فیدها

شبکه‌ها

نشانی امضاکننده: 0x83fa2d8836525251FAd214A78A72038D0864f877. فهرست ماشین‌خوان: /oracle/feeds.

یکپارچه‌سازی

1. دریافت گزارش امضاشده

curl -H "Authorization: Bearer $API_KEY" \
  "https://api.marketapi.app/v1/oracle/report?symbols=EURUSD&chain_id=10"

برای هر نماد report (تاپل کدگذاری‌شده ABI) و signature (۶۵ بایت) برمی‌گرداند. کلید شما به دامنه read:oracle نیاز دارد.

2. تأیید آن در قرارداد شما

interface IMarketApiOracle {
    struct PriceReport { bytes32 feedId; int256 price; uint64 timestamp; uint64 validUntil;
                         uint8 marketStatus; uint32 spreadBps; }
    function submit(PriceReport calldata r, bytes calldata sig) external returns (bool);  // verifies, stores if newer
    function getPriceNoOlderThan(bytes32 feedId, uint256 maxAge)
        external view returns (int256 price, uint64 timestamp);   // OPEN and fresh only, else reverts
    function getPrice(bytes32 feedId) external view
        returns (int256 price, uint64 timestamp, uint8 marketStatus, uint32 spreadBps);   // incl. CLOSED
}

contract MyVault {
    IMarketApiOracle immutable oracle;
    bytes32 constant EURUSD = keccak256("EURUSD");
    constructor(IMarketApiOracle o) { oracle = o; }

    function act(IMarketApiOracle.PriceReport calldata r, bytes calldata sig) external {
        oracle.submit(r, sig);                                       // reverts on a bad signature
        (int256 price, ) = oracle.getPriceNoOlderThan(EURUSD, 60);   // 8 decimals
        // ... use price ...
    }
}

مصرف‌کنندگان به سبک Chainlink می‌توانند فید را از طریق MarketApiFeedAdapter بخوانند (latestRoundData()، AggregatorV3Interface).

تعرفه‌ها

5 اعتبار برای هر گزارش امضاشده، پرداخت از موجودی عادی API شما. خواندن قیمت‌هایی که از قبل روی زنجیره ذخیره شده‌اند رایگان است.

کاربردهای فیدهای قیمت روی زنجیره ما

• دارایی‌های توکنیزه و RWA: سهام توکنیزه، توکن‌های پشتوانه‌دار طلا و دیگر دارایی‌های دنیای واقعی را با داده‌های قیمتی که ساعات بازار را در نظر می‌گیرند قیمت‌گذاری کنید.
• وام‌دهی DeFi و وثیقه: وثیقه‌های مبتنی بر فارکس و کالا را با قیمت‌های تازه و قابل تأیید و بررسی‌های تازگی ایمن برای لیکوئید شدن ارزش‌گذاری کنید.
• دارایی‌های مصنوعی و FX روی زنجیره: موقعیت‌های مصنوعی فارکس، شاخص و کالا را با قیمت‌های مرجع امضاشده تسویه کنید.
• استیبل‌کوین‌ها و پرداخت‌ها: با نرخ‌های زنده EUR/USD، GBP/USD و دیگر نرخ‌های فارکس، ارزها را روی زنجیره تبدیل کنید.

چرا یک اوراکل کششی امضاشده؟

اوراکل‌های فشاری طبق برنامه به‌روزرسانی می‌شوند و کسی گس هر به‌روزرسانی را می‌پردازد. با اوراکل کششی، قرارداد شما دقیقاً وقتی نیاز دارد یک قیمت تازه با امضای رمزنگاری‌شده می‌گیرد: هزینه کمتر، داده تازه‌تر و همان تأیید روی زنجیره. وضعیت بازار، اسپرد خرید و فروش و انقضا بخشی از هر گزارش امضاشده‌اند.

توصیه‌شده: الگوی کششی (قیمت‌های همیشه تازه)

به قیمتی که از قبل روی زنجیره ذخیره شده تکیه نکنید. یک گزارش تازه امضاشده بگیرید و آن را در همان تراکنشی که از آن استفاده می‌کند ارسال کنید: قرارداد شما همیشه قیمت فعلی را می‌بیند و فقط هزینه به‌روزرسانی‌های خودتان را می‌پردازید.

// 1) off-chain: GET https://api.marketapi.app/v1/oracle/report?symbols=EURUSD&chain_id=CHAIN_ID  (header: Authorization: Bearer KEY)
// 2) on-chain: verify, store and use the report atomically
interface IMarketApiOracle {
    struct PriceReport { bytes32 feedId; int256 price; uint64 timestamp; uint64 validUntil; uint8 marketStatus; uint32 spreadBps; }
    function submit(PriceReport calldata r, bytes calldata sig) external returns (bool);
    function getPriceNoOlderThan(bytes32 feedId, uint256 maxAge) external view returns (int256 price, uint64 timestamp);
}

contract MyVault {
    IMarketApiOracle immutable oracle;
    bytes32 constant EURUSD = keccak256("EURUSD");
    constructor(IMarketApiOracle o) { oracle = o; }

    function settle(IMarketApiOracle.PriceReport calldata r, bytes calldata sig) external {
        oracle.submit(r, sig);                                         // ignored if an equal/newer price is stored
        (int256 price, ) = oracle.getPriceNoOlderThan(EURUSD, 60);    // reverts unless OPEN and fresh
        // ... use price (8 decimals)
    }
}

فیلدهای report و signature گزارش از API دقیقاً دو آرگومان submit هستند. گزارش‌ها حدود یک دقیقه معتبرند، پس درست پیش از ارسال تراکنش دریافتشان کنید.