Farm / Staking talimatları

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.

​

Talimatlı envanter

​

CreateFarm (v6)

reward_info_count: u8               // oluşturulma sırasında ödül akışı sayısı (1..=5)
reward_infos: [
  {
    open_time:            u64,
    end_time:             u64,
    emission_per_second_x64: u128,   // Q64.64
    mint:                 Pubkey,    // ödül mint'i
    token_program:        Pubkey,    // SPL veya Token-2022
  }
]

• open_time > now, end_time > open_time.
• creator ATA’ları en az emission_per_second_x64 × (end_time − open_time) / 2^64 ödül mint’ini tutar.
• staking_mint dondurma yetkinliğine sahip değildir veya dondurma yetkinliği devre dışıdır.

• FarmState başlatıldı, total_staked = 0.
• Ödül vault’ları tam akış bütçesiyle finanse edildi.
• Yaratıcının ödül ATA’sı bu miktardan boşaltılır.

​

Deposit (v6)

amount: u64

1. Her canlı ödül akışı için tembel güncelleme formülünü kullanarak reward_per_share_x64[i]’ı yenileyin.
2. pending_i = user_ledger.deposited × reward_per_share_x64[i] / 2^64 − user_ledger.reward_debts[i] hesaplayın.
3. pending_i’ı reward_vault_{i}’dan user_reward_ata_{i}’ye aktarın.
4. amount stake etme mint’ini user_staking_ata’dan staking_vault’a aktarın.
5. user_ledger.deposited += amount’ı güncelleyin ve reward_debts[i]’ı yeniden görüntüleyin.
6. farm_state.total_staked += amount’ı güncelleyin.

• amount > 0 gerçek bir stake için (v6 amount = 0’ı yasaklar — sadece talep için Harvest kullanın).
• user_staking_ata en az amount tutar.
• Her canlı ödül vault’u bu kullanıcıya en az borçlu olunan tutarı tutar.

​

Withdraw (v6)

amount: u64

• amount ≤ user_ledger.deposited.
• Farm duraklatılmamış.

​

Harvest (v6)

​

AddReward (v5/v6)

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

• Boş bir slot mevcuttur (v6’de reward_info_count < 5, v5’te < 2).
• open_time ≥ now (gelecekte olabilir) veya open_time < now yalnızca program sürümü izin verirse — v6 verir, v5 vermez.

• Yeni akış reward_info_count dizininde başlatıldı, reward_info_count++.
• Ödül vault’u arayanın ATA’sından tam akış bütçesiyle kredilendi.

​

SetRewards (v5/v6)

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

• Akış hala çalışıyor (reward_state == 1).
• new_end_time ≥ geçerli end_time.
• Gerekli ek bütçe (yeni_emisyon × yeni_süre − zaten_emitlenmiş) gönderenin ATA’sında mevcuttur ve talimattan ödül vault’una aktarılır.

​

RestartRewards (v5/v6)

• reward_state == 2 (sona erdi).
• Arayanı slot’un reward_sender’ı (v6) veya farm owner’ı (v5).

​

WithdrawReward (v5/v6)

reward_index: u8

• Akış sona erdi (reward_state == 2).
• reward_total_emissioned == reward_claimed + vault_balance (şu anda hiç bir şey borçlu değil).

​

v5 varyasyonları

• Deposit / Withdraw v6 ile aynı şekle sahiptir ancak 2 adede kadar ödül slot’u kullanır ve reward_per_share u128’dir (farklı bir radiks ile sabit nokta).
• CreateAssociatedLedger ilk Deposit’ten önce gerekli bir ayrı çağrıdır; v6 bunu birleştirdi.
• AddReward mevcuttur, Harvest değildir (Deposit 0 kullanın).

​

v3 varyasyonları

• Tek ödül akışı. AddReward yok, ikinci slot yok.
• Deposit 0 talep etmenin tek yoludur.
• CreateUserLedger ilk Deposit’ten önce çağrılmalıdır.

​

Durum değişikliği matrisi

​

Sonraki adım nereye

• products/farm-staking/code-demos — TypeScript örnekleri.
• products/farm-staking/accounts — FarmState / UserLedger / UserStake düzenleri.
• reference/error-codes — farm hata enumı.

• Raydium SDK v2 Farm modülü
• Raydium farm programı kaynak kodu (v3 / v5 / v6)