ファーム・ステーキング命令

​

命令一覧

​

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。
• creator ATA は少なくとも 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. reward_vault_{i} から user_reward_ata_{i} に pending_i を転送。
4. user_staking_ata から staking_vault にステーキングミント amount を転送。
5. user_ledger.deposited += amount を更新し、reward_debts[i] を再スナップショット。
6. farm_state.total_staked += amount を更新。

• 真のステーキングについて amount > 0（v6 は amount = 0 を禁止 — クレーム限定は Harvest を使用）。
• user_staking_ata は少なくとも amount を保有。
• 各アクティブ報酬ボールトはこのユーザーに支払うべき保留分を少なくとも保有。

​

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,
}

• 空きスロットが存在（v6 の場合 reward_info_count < 5、v5 の場合 < 2）。
• 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）またはファーム owner（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 なし、2 番目のスロットなし。
• 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）