بوابة الأوركل
خلاصات أسعار Pyth وSwitchboard خلف واجهة AggregatorV3Interface الخاصة بـ Chainlink.
تُعرِض Oracle Gateway خلاصات أسعار أصلية من سولانا (Pyth وSwitchboard V3) عبر واجهة Chainlink AggregatorV3Interface، لذا تحتفظ بروتوكولات Ethereum التي تُنقل إلى Rome بكود تكامل الأوركل الحالي لديها. تم نشر Oracle Gateway V2 على Hadrian وRubicon، رغم أن السجل يدرج عناوين الخلاصات لـ Hadrian فقط، وتتكفل بوابة العملاء بالتسجيل. يقوم keeper الذي يديره Rome بتحديث الخلاصات المخبأة وخلاصات الدفتر، لكن ليست كل الخلاصات حديثة في كل لحظة — أيّ الخلاصات تستجيب اليوم مبيّن أدناه. وتُغطَّى المحولات والمصنع ونموذج keeper في الـ rome-oracle-gateway المستودع.
معاينة. لم تخضع Oracle Gateway للتدقيق. وتقول البوابة الشيء نفسه: لا تستخدمها في مسارات القيمة في الإنتاج.
المشكلة
تتوقع DeFi على Ethereum من واجهة Chainlink AggregatorV3Interface:
(, int256 price,,,) = priceFeed.latestRoundData();مزوّدو الأوركل في Solana (Pyth وSwitchboard) لديهم صيغ بيانات مختلفة. ومن دون تكييف، سيحتاج كل بروتوكول مُنقول إلى كود أوركل مخصص.
الحل
ينشر Oracle Gateway V2 عقود محوّل خفيفة الوزن تقوم بما يلي:
قراءة بيانات الأسعار مباشرةً من حسابات Pyth أو Switchboard على Solana (قراءات عبر الحالة، وليست CPI)
تحليل البيانات على السلسلة
تطبيع الأسعار إلى 8 منازل عشرية
تعرِض واجهة Chainlink القياسية
AggregatorV3Interface
import {IAggregatorV3Interface} from "@rome-protocol/rome-solidity/contracts/oracle/IAggregatorV3Interface.sol";
// نفس الواجهة مثل Chainlink على Ethereum
(, int256 price,,,) = IAggregatorV3Interface(ADAPTER).latestRoundData();
// السعر = SOL/USD بثماني منازل عشرية (مثلًا 15000000000 = 150.00 دولار)استهلك خلاصة في ثلاث خطوات
استخرج عنوان المحوّل من السجل — لا تُثبِّته في الكود أبدًا:
يُثبَّت السجل من GitHub (npm install github:rome-protocol/rome-registry#v0.2.0). وتحمل مفاتيح الخلاصات لاحقةً تُبيّن نوع المحوّل الموجود خلفها؛ راجع مفاتيح الخلاصات في السجل قبل أن تختار أحدها.
اقرأها بالواجهة التي يستخدمها بروتوكولك بالفعل —
IAggregatorV3Interface(solUsd).latestRoundData(). خلاصة قديمة أو غير مهيأة يتراجع بدلاً من تقديم سعر مجمّد.عدة خلاصات في آنٍ واحد؟
BatchReader.getLatestPrices(adapters[])(Hadrian، إصدار السجل v0.2.0:0x2869f0a96572e7fb15036656e9a32fd17346499b) — وgetFeedHealth(adapters[])قبل أن تعتمد عليها. تجعل المحولات المخبأة كل مستهلك يقرأ مجردSLOAD، لذا تبقى المعاملات متعددة الخلاصات (اقتراض متعدد الضمانات، عرض محفظة) رخيصة.
cardo يقرأ هذه الخلاصات على Hadrian. ولأن الواجهة هي تمامًا AggregatorV3Interface، يمكن لبروتوكولات فئة Compound وAave استخدام هذه الخلاصات من دون تغييرات في كود الأوركل — فقط وجّه إعدادات خلاصات الأسعار إلى عناوين المحوّلات.
أنواع المحوّلات
PythPullAdapter — يقرأ حسابات أسعار Pyth (السعر، الثقة، EMA، وقت النشر).
SwitchboardV3Adapter — يقرأ حسابات مجمّع Switchboard (السعر، الطابع الزمني؛ بلا EMA).
محوّلات CachedPyth / CachedFeed — نسخ تتبع مخبأة لقراءات أكثر كفاءة في استهلاك CU.
BookFeedAdapter — عرض للقراءة فقط متوافق مع Chainlink فوق أحد إدخالات
PriceBookعقد. يحتفظ الدفتر بأسعار جميع خلاصاته المسجَّلة ويُحدَّث على دفعات (والتحديث غير مقيَّد بالإذن)؛ ولا يحتفظ محوّل كل خلاصة بأي ذاكرة تخزين مؤقتة خاصة به. ويؤدي إدخال متوقف إلى revert فورًا معAdapterPaused، بدلًا من الانتظار حتى يصبح قديمًا.
تُنشَر المحوّلات على شكل نسخ minimal-proxy وفق EIP-1167: يقوم OracleAdapterFactory OracleAdapterFactory باستنساخ محوّلات Pyth وSwitchboard والمحوّلات المخبأة، ويقوم كل PriceBook بنسخ خاص به BookFeedAdapter عند تسجيل خلاصة. وهي تعرض واجهة موسعة إلى جانب AggregatorV3Interface (latestPriceData, maxStaleness, oracleType، و metadata() المجال المستخدم لفحوصات الصحة).
مفاتيح الخلاصات في السجل
getOracle(chainId).feeds يحتوي على عدة مفاتيح لكل أصل. وتُسمّي اللاحقة في المفتاح نوع المحوّل:
SOL/USD
Pyth مباشر (PythPullAdapter)
يحلّل حساب Pyth في كل استدعاء.
SOL/USD-BOOK
BookFeedAdapter
يقرأ PriceBook إدخالًا يحدّثه keeper.
SOL/USD-CACHED
مخبأ (يلفّ خلاصة أخرى)
يقرأ سعرًا مخزّنًا يحدّثه keeper.
SOL/USD-CACHEDPYTH
Pyth مخبأ (CachedPythAdapter)
يقرأ سعرًا مخزّنًا يحدّثه keeper.
SOL/USD-SB
Switchboard (SwitchboardV3Adapter)
يحلّل حساب Switchboard في كل استدعاء. ويعلّم السجل هذه الإدخالات متقاعدة.
أيّها تستهلك يعتمد على السلسلة. تحقّق من القسم التالي أولًا.
أيّ الخلاصات تستجيب اليوم
هذه نتائج latestRoundData() للاستدعاءات للقراءة فقط على الخلاصات المدرجة في registry v0.2.0، أُجريت أثناء كتابة هذه الصفحة. تتغير حداثة الخلاصات من دقيقة إلى أخرى على devnet، لذا تعامل معها كلقطة آنية وأجرِ الاستدعاء نفسه على الخلاصة التي تنوي استخدامها.
Hadrian. غالبًا ما تكون الخلاصات المباشرة قديمة: في الفحوصات المتكررة، أرجع معظمها (BONK وBTC وETH وJITOSOL وJTO وJUP وMSOL وUSDC وUSDT) خطأً
StalePriceFeedفي كل مرة، وSOL/USDأجابت في بعض الاستدعاءات ولم تُجب في أخرى. وقد كانت-BOOKالخلاصات هي الأكثر موثوقية وأجابت في كل استدعاء لكل أصل باستثناء JTO، التي-BOOKأرجعت خلاصةها حالة قديمة. وكل-CACHEDو-CACHEDPYTHخلاصة أرجعتUninitializedPriceFeed(لم يُحدّثها شيء)، وSOL/USD-SBأرجعتStalePriceFeed. على Hadrian، يُفضَّل-BOOKالخلاصة، وشغّلlatestRoundData()على الخلاصة التي تختارها قبل أن تعتمد عليها.Rubicon. لا يدرج السجل خلاصات الأوركل الخاصة بـ Rubicon، لذا لا تغطيها هذه الصفحة. المصنع منشور هناك (انظر العناوين المنشورة) وتستجيب محوّلاته الأولى، لكن ابحث عن عناوين الخلاصات من المصنع (
adapterCount()وallAdapters(i)) بدلًا من السجل.
إرجاع revert هنا هو السلوك المقصود: فشل الخلاصة القديمة أو غير المهيأة بصوت عالٍ بدلًا من إرجاع سعر قديم. تعامل مع ذلك داخل عقدك.
الحداثة — keeper الخاص بالأوركل
تفرض المحوّلات maxStaleness نافذة: إذا block.timestamp - publishTime > maxStaleness، فإن القراءات تُرجِع revert. على الشبكة الرئيسية لـ Solana، يشغّل Pyth عمليات keeper للإنتاج. وعلى devnet الخاصة بـ Solana (حيث يوجد Hadrian)، تكون عمليات الدفع الخاصة بـ Pyth على أساس أفضل جهد، لذا يشغّل Rome keeper الخاص بالأوركل مكوّنًا جانبيًا لإبقاء حسابات Pyth الأساسية حديثة ولتحديث الخلاصات المخبأة وخلاصات الدفتر. ولا يغطي keeper كل خلاصة على كل سلسلة في كل لحظة (انظر أيّ الخلاصات تستجيب اليوم).
تحقّق من صحة الخلاصات باستخدام BatchReader.getFeedHealth (الذي يقرأ metadata()), وليس فقط latestRoundData — يمكن أن تكون الخلاصة قابلة للوصول لكنها قديمة.
بوابة العملاء
سجّل الخلاصات وعيّن المستهلكين لكل سلسلة عبر بوابة Oracle Gateway. راجع صفحة البوابة للاطلاع على ما تغطيه.
العناوين المنشورة
العناوين المعيارية لكل سلسلة (المصانع، تطبيقات المحوّل، والخلاصات الحية) موجودة في السجل. أما المصانع الرئيسية، فمن نشطًا إدخالات registry v0.2.0 (الإصدار 5.0.0 على Hadrian؛ وعناوين Rubicon هي تلك الموجودة على عناوين العقود الصفحة)؛ انظر قراءة قائمة العقود:
OracleAdapterFactory
0x52b008771fc95b4674a4f3533570b3d223f27f68
0x6a1340dd86c3951b6f13d9001b3951d56a2fe581
BatchReader
0x2869f0a96572e7fb15036656e9a32fd17346499b
0x580dc0ecb226530ee8a90b57e0f0cd2555fb4f0f
القيود
لا توجد بيانات جولات تاريخية —
getRoundData(roundId)يُرجع revert؛ فقطlatestRoundData()مدعوم.EMA الخاص بـ Switchboard غير مدعوم — بيانات EMA خاصة بـ Pyth فقط.
الحد الأقصى للقدم لكل سلسلة —
maxStalenessيُضبط حسب البيئة عند الإقلاع: المحوّلات المباشرة (التي تقرأ Pyth) تكون قيمتها الافتراضية نحو 60 ثانية؛ أما المحوّلات المخبأة فقيمتها الافتراضية 3600 ثانية (وعندما يقوم keeper بتحديثها، يفعل ذلك بوتيرة أعلى بكثير من ذلك).إزاحات المحلل تُتحقَّق صحتها مقابل التخطيطات الحالية لـ Pyth/Switchboard؛ وتتطلب تغييرات التخطيط إعادة التحقق.
ما التالي
بوابة Oracle Gateway — سجّل الخلاصات، وعيّن المستهلكين
عناوين العقود — الـ precompiles والعناوين الخاصة بكل سلسلة
آخر تحديث
هل كان هذا مفيدا؟