نظرة عامة على المزرعة / الرهن

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.

​

ما هي المزرعة

• قائم على الإصدار، وليس على الرسوم. على عكس تدفقات المكافآت المدمجة في CLMM، فإن مكافآت المزرعة لا تُرتبط بحجم المبادلات أو نشاط الحمام. يودع منشئ المزرعة الميزانية مقدماً وتُصدرها بمعدل ثابت في الثانية حتى تنتهي.
• مستقلة عن الحمام. الحمام لا يعرف أن المزرعة موجودة. نقل LP بين المحافظ لا يخطر المزرعة؛ يجب على المستخدم أن يقوم بسحب نشط من المزرعة أولاً. وبالمثل، السحب من الحمام لا يسحب من المزرعة.
• دفتر أحوال لكل مستخدم، لكل مكافأة. كل مراهن لديه حساب UserStake (أو “دفتر أحوال”) لكل مزرعة يتتبع مبلغ رهنهم واللقطة الخاصة بهم لعداد المكافأة لكل حصة لكل من تدفقات مكافآت المزرعة.
• مكافآت متعددة. المزرعة v5 تدعم ما يصل إلى مكافأتين؛ v6 تدعم ما يصل إلى 5. كل مكافأة لها خزانة خاصة بها ومعدل لكل ثانية ووقت بدء ووقت نهاية.

​

الإصدارات الثلاثة النشطة

​

محاسبة المكافأة لكل حصة

reward_per_share := total_rewards_distributed_by_stream / total_staked
pending(user)    := user.staked × (reward_per_share − user.reward_debt)

• reward_per_share يتم تخزينها في حساب المزرعة كعداد نقطة ثابتة (Q64.64 في v5+، Q56.8 في v3). تنمو فقط.
• user.reward_debt هي لقطة من reward_per_share في آخر تفاعل للمستخدم. إنها ليست ديناً يدين به المستخدم؛ إنها إزاحة تُستخدم لحساب التراكمات المستقبلية.
• في Deposit و Withdraw، تقوم المزرعة أولاً بتسوية المكافآت المعلقة (حيث تحتسب user.pending_reward أو ترسلها مباشرة إلى ATA للمستخدم، حسب الإصدار)، ثم تحدث user.reward_debt للعداد الحالي.
• في Harvest، تدفع المزرعة pending_reward وتلتقط reward_debt مرة أخرى.

elapsed        := min(now, reward.end_time) − reward.last_update_time
new_emissions  := reward.per_second × elapsed
if total_staked > 0:
    reward_per_share += new_emissions / total_staked
reward.last_update_time := now

​

رمز الرهن مقابل رمز المكافأة

​

جداول الانبعاث

• start_time — الطابع الزمني UNIX الذي تبدأ الانبعاثات. قبل هذا، لا تراكم.
• end_time — الطابع الزمني الذي تتوقف الانبعاثات. بعد هذا، reward_per_share لم تعد تنمو من هذا التدفق.
• per_second — معدل الانبعاث بينما start_time ≤ now < end_time.

​

ما لا تكونه المزارع

• ليست موزع رسوم. CPMM و CLMM يجمعان رسوم التداول مباشرة في حالة الحمام. المزارع لا تلمس رسوم الحمام. المسار الوحيد من رسوم الحمام إلى حامل الرمز هو استرجاع LP أو CollectFee في CLMM.
• ليست تلقائية. يجب رهن LP بشكل صريح لكسب مكافآت المزرعة. حاملو LP الذين يتركون الرموز في محفظتهم لا يكسبون شيئاً من المزرعة.
• ليست قابلة للاستبدال. كل حساب UserStake مرتبط بزوج واحد من (farm, user). لا يمكنك نقل رهنك إلى محفظة أخرى دون إلغاء الرهن أولاً.
• لا تتوافق مع مواقع CLMM مباشرة. قدمت المزرعة v6 محول CLMM، لكن في الممارسة العملية تستخدم حمامات CLMM تدفقات المكافآت المدمجة الخاصة بها (راجع products/clmm/fees) بدلاً من انبعاثات المزرعة.

​

عندما تكون المزارع الأداة الصحيحة

• تحفيز LP لأحد حمامات CPMM أو AMM v4 في مشروعك برمز خارجي (رمز مشروعك، رمز شريك، إلخ).
• تشغيل برنامج رهن على رمز أصل فردي (الكلاسيكية “رهن RAY، كسب RAY”) دون نشر عقدك الخاص.
• إضافة مكافآت إضافية فوق حمام موجود دون الحاجة إلى وصول إداري لهذا الحمام.

​

محتويات الفصل

• accounts — تخطيط حالة على السلسلة الكامل لكل إصدار.
• instructions — كل تعليمة مزرعة مع قائمة حسابها والشروط المسبقة واللاحقة.
• code-demos — أمثلة TypeScript للرهن والحصاد وإنشاء مزرعة جديدة.

​

الخطوات التالية

• products/clmm/fees — قارن انبعاثات المزرعة بنموذج المكافآت المدمج في CLMM.
• reference/program-addresses — معرّفات برنامج المزرعة الثلاثة.
• protocol-overview/versions-and-migration — متى تستخدم كل إصدار مزرعة.

• IDL المزرعة v6 مضمّن في SDK: raydium-io/raydium-sdk-V2 تحت src/raydium/farm/.
• وحدة Farm في SDK v2 الخاصة بـ Raydium