Farm-/Staking-Anweisungen

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.

​

Anweisungsübersicht

​

CreateFarm (v6)

reward_info_count: u8               // Anzahl der Belohnungsströme bei der Erstellung (1..=5)
reward_infos: [
  {
    open_time:            u64,
    end_time:             u64,
    emission_per_second_x64: u128,   // Q64.64
    mint:                 Pubkey,    // Belohnungs-Mint
    token_program:        Pubkey,    // SPL oder Token-2022
  }
]

• open_time > now, end_time > open_time.
• Creator-ATAs halten mindestens emission_per_second_x64 × (end_time − open_time) / 2^64 der Belohnungs-Mint.
• staking_mint hat keine Gefrierautorität oder die Gefrierautorität ist deaktiviert.

• FarmState initialisiert, total_staked = 0.
• Belohnungsvaults mit dem vollständigen Stream-Budget finanziert.
• Die Belohnungs-ATA des Erstellers wird um diesen Betrag geleert.

​

Deposit (v6)

amount: u64

1. Aktualisieren Sie reward_per_share_x64[i] für jeden aktiven Belohnungsstrom mit der Lazy-Update-Formel.
2. Berechnen Sie pending_i = user_ledger.deposited × reward_per_share_x64[i] / 2^64 − user_ledger.reward_debts[i].
3. Übertragen Sie pending_i von reward_vault_{i} zu user_reward_ata_{i}.
4. Übertragen Sie amount Staking-Mint von user_staking_ata zu staking_vault.
5. Aktualisieren Sie user_ledger.deposited += amount und erstellen Sie einen neuen Snapshot von reward_debts[i].
6. Aktualisieren Sie farm_state.total_staked += amount.

• amount > 0 für einen echten Stake (v6 verbietet amount = 0 — verwenden Sie Harvest nur für Anspruchsforderungen).
• user_staking_ata hält mindestens amount.
• Jeder aktive Belohnungsvault hält mindestens das Ausstehende, das diesem Benutzer geschuldet wird.

​

Withdraw (v6)

amount: u64

• amount ≤ user_ledger.deposited.
• Farm ist nicht pausiert.

​

Harvest (v6)

​

AddReward (v5/v6)

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

• Ein freier Slot existiert (reward_info_count < 5 auf v6, < 2 auf v5).
• open_time ≥ now (kann in der Zukunft liegen) oder open_time < now ist nur zulässig, wenn die Programmversion dies erlaubt — v6 tut es, v5 nicht.

• Der neue Strom wird bei Index reward_info_count initialisiert, reward_info_count++.
• Der Belohnungsvault wird mit dem vollständigen Stream-Budget aus der ATA des Aufrufers gutgeschrieben.

​

SetRewards (v5/v6)

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

• Der Strom läuft noch (reward_state == 1).
• new_end_time ≥ current end_time.
• Das erforderliche zusätzliche Budget (new_emission × new_duration − already_emissioned) ist in der ATA des Absenders vorhanden und wird durch die Anweisung in den Belohnungsvault übertragen.

​

RestartRewards (v5/v6)

• reward_state == 2 (beendet).
• Aufrufer ist reward_sender des Slots (v6) oder Farm-owner (v5).

​

WithdrawReward (v5/v6)

reward_index: u8

• Stream ist beendet (reward_state == 2).
• reward_total_emissioned == reward_claimed + vault_balance (es ist nichts mehr geschuldet).

​

v5-Variationen

• Deposit / Withdraw haben die gleiche Form wie v6, aber verwenden bis zu 2 Belohnungsslots und reward_per_share ist u128 (Festkomma mit einer anderen Radix).
• CreateAssociatedLedger ist ein erforderlicher separater Aufruf vor dem ersten Deposit; v6 hat das zusammengeführt.
• AddReward ist verfügbar, Harvest ist nicht (verwenden Sie Deposit 0).

​

v3-Variationen

• Einzelner Belohnungsstrom. Kein AddReward, kein zweiter Slot.
• Deposit 0 ist die einzige Möglichkeit, Ansprüche geltend zu machen.
• CreateUserLedger muss vor dem ersten Deposit aufgerufen werden.

​

Zustandsänderungsmatrix

​

Nächste Schritte

• products/farm-staking/code-demos — TypeScript-Beispiele.
• products/farm-staking/accounts — FarmState / UserLedger / UserStake Layouts.
• reference/error-codes — Farm-Error-Enum.

• Raydium SDK v2 Farm Modul
• Raydium-Farm-Programmquelle (v3 / v5 / v6)