هذه الصفحة مُترجَمة آليًا بواسطة الذكاء الاصطناعي. النسخة الإنجليزية هي المرجع المعتمد.عرض النسخة الإنجليزية →
عادة ما تحتاج المحافظ التي تدمج Raydium إلى الإجابة على أربعة أسئلة لكل مستخدم: في أي تجمعات يمتلك هذا المستخدم حصصًا من السيولة؟ ما المراكز (NFTs من CLMM) التي يحتفظ بها؟ في أي مزارع يراهن؟ كم تبلغ قيمة كل ذلك؟ توثق هذه الصفحة كل واحدة منها.
الكشف عن مراكز Raydium
رموز السيولة الكلاسيكية (CPMM و AMM v4)
تبدو مثل أي رمز SPL آخر: حساب ATA الخاص بالمستخدم يحتفظ برصيد. تعرض المحفظة هذا كرمز عادي افتراضيًا. لكشفه كمركز Raydium LP:- عدّد حسابات الرموز الخاصة بالمستخدم:
connection.getParsedTokenAccountsByOwner(user, { programId: TOKEN_PROGRAM_ID }). - لكل رمز، تحقق من قائمة Raydium:
GET https://api-v3.raydium.io/pools/info/lps?lps=<LP_MINT>,...(جمّع حتى ~50 رمز LP لكل استدعاء). - بالنسبة للرموز المطابقة، تعيد API مرجع التجمع. استخدمه لحساب قيمة المركز بالرموز:
NFTs مراكز CLMM
مراكز CLMM هي NFTs. يتم اشتقاقPersonalPositionState PDA لكل مركز من رمز NFT. للكشف:
- عدّد NFTs الخاصة بالمستخدم. بالنسبة لـ NFTs من Metaplex القديمة: صفّ حسابات الرموز إلى تلك التي تحتوي على supply 1 و decimals 0.
- لكل رمز NFT، حاول اشتقاق PersonalPositionState PDA:
-
عدّد مراكز المحفظة باستخدام
raydium.clmm.getOwnerPositionInfo({ programId })وطابق علىnftMint(لا توجد دالةgetPositionInfo). كل إدخال يعطيك:poolId→ جلب التجمع لحل الرموزtickLower,tickUpper→ نطاق العرضliquidity,tokensOwedA/B→ حساب قيمة المركز + الرسوم المعلقةrewardInfos→ المكافآت المعلقة لكل تدفق
-
بالنسبة لـ NFTs المراكز الصادرة بموجب Token-2022 (
OpenPositionWithToken22Nft)، يكون برنامج رمز NFT هو Token-2022 بدلاً من SPL Token. عدّد كليهما عند المسح.
مراهنات المزرعة
لكل من Farm v3 و v5 و v6 PDA دفتر أستاذ لكل مستخدم. الاشتقاقات:UserLedger المحتملة بتجزئة المستخدم مع قائمة منسقة من معرفات المزارع “المحتملة”. تعداد جميع معرفات المزارع بشكل شامل غير عملي (توجد آلاف)؛ استخدم API.
حساب قيمة المركز
CPMM و AMM v4 LP
الوحدات الثلاث لا تشترك في توقيع:liquidity.getPoolInfoFromRpc يأخذ { poolId }، بينما cpmm.getPoolInfoFromRpc و clmm.getPoolInfoFromRpc يأخذان سلسلة base58 موضعية.
raydium.token أو oracle سعر).
مركز CLMM
- قيمة السيولة (السعر الحالي)
- الرسوم غير المجمعة
- المكافآت المعلقة لكل تدفق
- النطاق:
[tickLower_price, tickUpper_price]مع شريط بصري يوضح ما إذا كان السعر الحالي ضمن النطاق
مراهنة المزرعة
reward_per_share_x64 بصيغة التحديث الكسول قبل الحساب (الوقت المنقضي × معدل الانبعاث ÷ إجمالي_المراهن).
محاكاة المعاملة لمعاينة
قبل أن يوقّع المستخدم، عادة ما تعاين المحافظ تغييرات الرصيد. استخدمsimulateTransaction:
accounts يطلب من المدقق إعادة حالة الحساب بعد المحاكاة للعناوين المدرجة. أكثر دقة بكثير من محاولة التنبؤ بتغيير الرصيد من شكل التعليمات وحده.
مزالق المحاكاة
- مبادلات CLMM تحتاج إلى مصفوفات tick صحيحة. إذا كان حجم إدخال المستخدم سيعبر إلى مصفوفة tick غير مهيأة، تعود المحاكاة (مثل التنفيذ). اعرض هذا بوضوح في الواجهة.
- رسوم الأولوية. تعمل المحاكاة بدون تطبيق تعليمات compute-budget. بالنسبة لمعاملة كبيرة تتجاوز 200k CU الافتراضي، تفشل المحاكاة لكن التنفيذ الفعلي مع حد CU صريح ينجح. اضبط حد CU على المعاملة المحاكاة أيضًا.
- blockhash طازج. تستخدم المحاكاة blockhash الحالي؛ إذا استغرق التوقيع >60 ثانية تصبح المعاملة غير صحيحة. أعد المحاكاة إذا تردد المستخدم.
عرض Token-2022
يجب تسمية الرموز ضمن برنامج Token-2022 كما هي في قائمة الرموز الخاصة بالمحفظة، لأن لديها سطوح مخاطر مختلفة:- رموز رسوم النقل: اعرض
transferFeeBasisPointsالحالي كـ “رسوم النقل: X%” بجانب الرصيد. حذّر عند الاستقبال — قد لا يدرك المستخدمون أنهم سيستقبلون أقل مما أرسله المرسل. - رموز transfer-hook: اعرض معرف برنامج الخطاف. يمكن لخطاف خبيث أن يحظر النقل الخارج؛ يجب على المستخدمين التحقق من أن الخطاف هو ما يتوقعونه.
- رموز غير قابلة للنقل: اعرض “غير قابل للنقل” وعطّل swap/send. عادة ما تكون هذه رموز مرتبطة بالروح أو بيانات اعتماد.
- رموز تحمل الفائدة: رصيد الواجهة المشتق من
TokenAccount.amountلا يعكس الفائدة المتراكمة. استخدمamountToUiAmountمن@solana/spl-token(الذي يطبق عامل التحجيم) للقيمة المعروضة.
عرض APR للمزرعة
يجب أن يجمع APR المعروض للمستخدمين جميع تدفقات المكافآت المباشرة، محولة إلى USD، وسنوية:APR: X.Y%. إذا كان رمز المراهنة رمز LP، احسب أيضًا APR رسوم القاعدة الخاصة بـ LP الأساسي وسمّ المجموع كـ “إجمالي APR” أو “APR + الرسوم”.
مؤشرات
products/clmm/ticks-and-positions— اشتقاق قيمة المركز.products/farm-staking/accounts— حقول حالة المزرعة.algorithms/token-2022-transfer-fees— دلالات العرض لرموز رسوم النقل.
- Raydium SDK v2 — مساعدات المركز والمزرعة.
- نقاط نهاية مراكز المستخدم على
api-v3.raydium.io.

