Instruksi Farm / Staking

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.

​

Inventaris instruksi

​

CreateFarm (v6)

reward_info_count: u8               // jumlah aliran hadiah saat pembuatan (1..=5)
reward_infos: [
  {
    open_time:            u64,
    end_time:             u64,
    emission_per_second_x64: u128,   // Q64.64
    mint:                 Pubkey,    // reward mint
    token_program:        Pubkey,    // SPL atau Token-2022
  }
]

• open_time > now, end_time > open_time.
• creator ATA memegang setidaknya emission_per_second_x64 × (end_time − open_time) / 2^64 dari reward mint.
• staking_mint tidak memiliki freeze authority, atau freeze authority dinonaktifkan.

• FarmState diinisialisasi, total_staked = 0.
• Vault hadiah didanai dengan anggaran aliran penuh.
• ATA hadiah creator dikurangi dengan jumlah tersebut.

​

Deposit (v6)

amount: u64

1. Segarkan reward_per_share_x64[i] untuk setiap aliran hadiah aktif menggunakan formula pembaruan lazy.
2. Hitung pending_i = user_ledger.deposited × reward_per_share_x64[i] / 2^64 − user_ledger.reward_debts[i].
3. Pindahkan pending_i dari reward_vault_{i} ke user_reward_ata_{i}.
4. Pindahkan amount staking mint dari user_staking_ata ke staking_vault.
5. Perbarui user_ledger.deposited += amount dan re-snapshot reward_debts[i].
6. Perbarui farm_state.total_staked += amount.

• amount > 0 untuk staking asli (v6 melarang amount = 0 — gunakan Harvest untuk klaim-saja).
• user_staking_ata memegang setidaknya amount.
• Setiap vault hadiah aktif memegang setidaknya pending yang diwajibkan kepada pengguna ini.

​

Withdraw (v6)

amount: u64

• amount ≤ user_ledger.deposited.
• Farm tidak dijeda.

​

Harvest (v6)

​

AddReward (v5/v6)

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

• Slot kosong ada (reward_info_count < 5 pada v6, < 2 pada v5).
• open_time ≥ now (mungkin di masa depan) atau open_time < now hanya diizinkan jika versi program memungkinkannya — v6 memungkinkan, v5 tidak.

• Aliran baru diinisialisasi pada indeks reward_info_count, reward_info_count++.
• Vault hadiah dikreditkan dengan anggaran aliran penuh dari ATA pemanggil.

​

SetRewards (v5/v6)

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

• Aliran masih berjalan (reward_state == 1).
• new_end_time ≥ current end_time.
• Anggaran tambahan yang diperlukan (new_emission × new_duration − already_emissioned) ada dalam ATA pengirim dan ditransfer ke vault hadiah oleh instruksi.

​

RestartRewards (v5/v6)

• reward_state == 2 (berakhir).
• Pemanggil adalah reward_sender slot (v6) atau farm owner (v5).

​

WithdrawReward (v5/v6)

reward_index: u8

• Aliran berakhir (reward_state == 2).
• reward_total_emissioned == reward_claimed + vault_balance (tidak ada yang saat ini diwajibkan).

​

Variasi v5

• Deposit / Withdraw memiliki bentuk yang sama dengan v6 tetapi menggunakan hingga 2 slot hadiah dan reward_per_share adalah u128 (titik-tetap dengan radix berbeda).
• CreateAssociatedLedger adalah panggilan terpisah yang diperlukan sebelum Deposit pertama; v6 menggabungkannya.
• AddReward tersedia, Harvest tidak (gunakan Deposit 0).

​

Variasi v3

• Aliran hadiah tunggal. Tidak ada AddReward, tidak ada slot kedua.
• Deposit 0 adalah satu-satunya cara untuk klaim.
• CreateUserLedger harus dipanggil sebelum Deposit pertama.

​

Matriks perubahan state

​

Langkah selanjutnya

• /id/products/farm-staking/code-demos — contoh TypeScript.
• /id/products/farm-staking/accounts — tata letak FarmState / UserLedger / UserStake.
• /id/reference/error-codes — enumerasi error farm.

• Modul Farm Raydium SDK v2
• Sumber program farm Raydium (v3 / v5 / v6)