تعليمات المزرعة / Staking

​

فهرس التعليمات

​

CreateFarm (v6)

reward_info_count: u8               // عدد تدفقات المكافآت عند الإنشاء (1..=5)
reward_infos: [
  {
    open_time:            u64,
    end_time:             u64,
    emission_per_second_x64: u128,   // Q64.64
    mint:                 Pubkey,    // نعناع المكافأة
    token_program:        Pubkey,    // SPL أو Token-2022
  }
]

• open_time > now، end_time > open_time.
• ATAs المنشئ تحتفظ بما لا يقل عن emission_per_second_x64 × (end_time − open_time) / 2^64 من نعناع المكافأة.
• لا يحتوي staking_mint على سلطة تجميد، أو يتم تعطيل سلطة التجميد.

• تم تهيئة FarmState، total_staked = 0.
• تم تمويل منجم (منجم) المكافآت بميزانية التدفق الكاملة.
• تم استنزاف ATA المكافأة للمُنشئ بهذا المبلغ.

​

Deposit (v6)

amount: u64

1. تحديث reward_per_share_x64[i] لكل تدفق مكافأة نشط باستخدام صيغة التحديث الكسول.
2. حساب pending_i = user_ledger.deposited × reward_per_share_x64[i] / 2^64 − user_ledger.reward_debts[i].
3. نقل pending_i من reward_vault_{i} إلى user_reward_ata_{i}.
4. نقل amount نعناع الحصة من user_staking_ata إلى staking_vault.
5. تحديث user_ledger.deposited += amount وإعادة التقاط reward_debts[i].
6. تحديث farm_state.total_staked += amount.

• amount > 0 للحصة الحقيقية (v6 يمنع amount = 0 — استخدم Harvest للمطالبة فقط).
• يحتفظ user_staking_ata بـ amount على الأقل.
• يحتفظ كل منجم مكافأة نشط بـ pending المستحق لهذا المستخدم على الأقل.

​

Withdraw (v6)

amount: u64

• amount ≤ user_ledger.deposited.
• المزرعة لم تتوقف عن العمل.

​

Harvest (v6)

​

AddReward (v5/v6)

reward_info: {
  open_time:            u64,
  end_time:             u64,
  emission_per_second_x64: u128,
  mint:                 Pubkey,
  token_program:        Pubkey,
}

• توجد فتحة حرة (reward_info_count < 5 على v6، < 2 على v5).
• open_time ≥ now (قد يكون في المستقبل) أو يُسمح بـ open_time < now فقط إذا سمح برنامج الإصدار — v6 يفعل، v5 لا.

• تم تهيئة التدفق الجديد في الفهرس reward_info_count، reward_info_count++.
• يتم جمع منجم المكافأة بميزانية التدفق الكاملة من ATA المستدعي.

​

SetRewards (v5/v6)

reward_index:         u8
new_open_time:        u64,
new_end_time:         u64,
new_emission_per_second_x64: u128,

• التدفق لا يزال قيد التشغيل (reward_state == 1).
• new_end_time ≥ current end_time.
• الميزانية الإضافية المطلوبة (new_emission × new_duration − already_emissioned) موجودة في ATA المُرسل ويتم نقلها إلى منجم المكافأة بواسطة التعليمة.

​

RestartRewards (v5/v6)

• reward_state == 2 (انتهى).
• المستدعي هو reward_sender للفتحة (v6) أو مالك المزرعة (v5).

​

WithdrawReward (v5/v6)

reward_index: u8

• التدفق انتهى (reward_state == 2).
• reward_total_emissioned == reward_claimed + vault_balance (لا شيء مستحق حاليًا).

​

تباينات v5

• Deposit و Withdraw لهما نفس الشكل مثل v6 لكنهما يستخدمان ما يصل إلى 2 فتحة مكافآت و reward_per_share هو u128 (نقطة ثابتة بأساس مختلف).
• CreateAssociatedLedger مكالمة منفصلة مطلوبة قبل أول Deposit؛ دمج v6 هذا.
• AddReward متاح، Harvest ليس كذلك (استخدم Deposit 0).

​

تباينات v3

• تدفق مكافأة واحد. لا AddReward، لا فتحة ثانية.
• Deposit 0 هو الطريقة الوحيدة للمطالبة.
• يجب استدعاء CreateUserLedger قبل أول Deposit.

​

مصفوفة تغيير الحالة

​

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

• products/farm-staking/code-demos — أمثلة TypeScript.
• products/farm-staking/accounts — تخطيطات FarmState و UserLedger و UserStake.
• reference/error-codes — تعداد خطأ المزرعة.

• وحدة Raydium SDK v2 Farm
• مصدر برنامج مزرعة Raydium (v3 / v5 / v6)