Documentation Index
Fetch the complete documentation index at: https://docs.raydium.io/llms.txt
Use this file to discover all available pages before exploring further.
هذه الصفحة مُترجَمة آليًا بواسطة الذكاء الاصطناعي. النسخة الإنجليزية هي المرجع المعتمد.عرض النسخة الإنجليزية →
عادة ما تحتاج المحافظ التي تدمج Raydium إلى الإجابة على أربعة أسئلة لكل مستخدم: في أي تجمعات لديه المستخدم حصص سيولة؟ ما المراكز (NFTs الخاصة بـ CLMM) التي يملكها؟ في أي مزارع يرهن؟ كم تبلغ قيمة كل هذا؟ توثق هذه الصفحة كل واحد منها.
كشف مراكز Raydium
رموز LP الكلاسيكية (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 القديمة: فلتر حسابات الرموز تلك التي لها عرض 1 وعدد عشري 0.
- لكل صك NFT، حاول اشتقاق PDA الخاص بـ PersonalPositionState:
-
قم بفك التشفير عبر
raydium.clmm.getPositionInfo({ positionPda })للحصول على: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
raydium.token أو برنامج معالجة الأسعار).
مركز CLMM
- قيمة السيولة (السعر الحالي)
- الرسوم غير المجموعة
- المكافآت المعلقة لكل تيار
- النطاق:
[tickLower_price, tickUpper_price]مع شريط بصري يوضح ما إذا كان السعر الحالي ضمن النطاق
رهان المزرعة
reward_per_share_x64 بصيغة التحديث البطيء قبل الحساب (الوقت المنقضي × معدل الإصدار ÷ إجمالي المرهون).
محاكاة المعاملة للمعاينة
قبل أن يوقّع المستخدم، عادة ما تعاين المحافظ تغييرات الرصيد. استخدمsimulateTransaction:
accounts من المدقق إرجاع حالة الحساب بعد المحاكاة للعناوين المدرجة. أكثر دقة بكثير من محاولة التنبؤ بتغيير الرصيد من شكل التعليمات وحده.
مخاطر المحاكاة
- تبديلات CLMM تحتاج إلى صفائف علامات صالحة. إذا كان حجم إدخال المستخدم سيعبر إلى صفيفة علامات غير مهيأة، تنعكس المحاكاة (مثل التنفيذ). اسطح هذا بوضوح في الواجهة.
- رسم الأولوية. تعمل المحاكاة بدون تطبيق تعليمات ميزانية الحساب. بالنسبة لمعاملة كبيرة تتجاوز الـ 200k CU الافتراضي، تفشل المحاكاة لكن التنفيذ الفعلي مع حد CU صريح ينجح. اضبط دائمًا حد CU على tx المحاكاة أيضًا.
- blockhash طازج. تستخدم المحاكاة blockhash الحالي؛ إذا استغرقت التوقيع أكثر من 60 ثانية، تصبح tx غير صالحة. أعد المحاكاة إذا تردد المستخدم.
عرض Token-2022
يجب وضع علامات على الرموز الموجودة في برنامج Token-2022 كما هي في قائمة الرموز الخاصة بالمحفظة، لأن لها سطحًا مختلفًا للمخاطر:- صكوك رسم التحويل: عرض
transferFeeBasisPointsالحالي باسم “Transfer fee: X%” بجانب الرصيد. أنذر عند الاستقبال — قد لا يدرك المستخدمون أنهم سيتلقون أقل مما أرسله المرسل. - صكوك hook التحويل: اسطح معرّف برنامج hook. يمكن لـ hook ضار حجب التحويلات الصادرة؛ يجب على المستخدمين التحقق من أن hook هو الذي يتوقعونه.
- صكوك غير قابلة للتحويل: عرض “Non-transferable” وتعطيل swap/send. عادة ما تكون هذه رموز soulbound أو بيانات اعتماد.
- صكوك تحمل الفائدة: الرصيد في الواجهة المشتقة من
TokenAccount.amountلا يعكس الفائدة المتراكمة. استخدمamountToUiAmountمن@solana/spl-token(الذي يطبق عامل التحجيم) للقيمة المعروضة.
عرض APR للمزرعة
يجب أن يجمع APR المعروض للمستخدمين جميع تيارات المكافآت المباشرة، المحولة إلى دولار وسنويًا:APR: X.Y%. إذا كان صك الرهان رمز LP، احسب أيضًا APR رسم المزرعة الأساسي الأساسي وضع علامة على المجموع باسم “Total APR” أو “APR + fees”.
مؤشرات
products/clmm/ticks-and-positions— استخلاص قيمة المركز.products/farm-staking/accounts— حقول حالة المزرعة.algorithms/token-2022-transfer-fees— دلالات العرض للرموز ذات رسوم التحويل.
- Raydium SDK v2 — مساعدات المركز/المزرعة.
- نقاط نهاية موقع المستخدم على
api-v3.raydium.io.


