Hướng dẫn lệnh Farm / Staking

​

Danh mục lệnh

​

CreateFarm (v6)

reward_info_count: u8               // số lượng luồng phần thưởng khi tạo (1..=5)
reward_infos: [
  {
    open_time:            u64,
    end_time:             u64,
    emission_per_second_x64: u128,   // Q64.64
    mint:                 Pubkey,    // phần thưởng mint
    token_program:        Pubkey,    // SPL hoặc Token-2022
  }
]

• open_time > now, end_time > open_time.
• ATA của creator chứa ít nhất emission_per_second_x64 × (end_time − open_time) / 2^64 của phần thưởng mint.
• staking_mint không có freeze authority hoặc freeze authority bị vô hiệu hóa.

• FarmState được khởi tạo, total_staked = 0.
• Vault phần thưởng được tài trợ với toàn bộ ngân sách luồng.
• ATA phần thưởng của creator bị xóa theo số tiền đó.

​

Deposit (v6)

amount: u64

1. Làm mới reward_per_share_x64[i] cho mỗi luồng phần thưởng hiện hoạt bằng công thức cập nhật lười biếng.
2. Tính toán pending_i = user_ledger.deposited × reward_per_share_x64[i] / 2^64 − user_ledger.reward_debts[i].
3. Chuyển pending_i từ reward_vault_{i} đến user_reward_ata_{i}.
4. Chuyển amount staking mint từ user_staking_ata đến staking_vault.
5. Cập nhật user_ledger.deposited += amount và chụp lại reward_debts[i].
6. Cập nhật farm_state.total_staked += amount.

• amount > 0 cho một stake thực sự (v6 không cho phép amount = 0 — sử dụng Harvest cho chỉ nhận).
• user_staking_ata chứa ít nhất amount.
• Mỗi vault phần thưởng hiện hoạt chứa ít nhất số tiền còn lại phải trả cho người dùng này.

​

Withdraw (v6)

amount: u64

• amount ≤ user_ledger.deposited.
• Farm không bị tạm dừng.

​

Harvest (v6)

​

AddReward (v5/v6)

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

• Khe trống tồn tại (reward_info_count < 5 trên v6, < 2 trên v5).
• open_time ≥ now (có thể ở tương lai) hoặc open_time < now được phép chỉ khi phiên bản chương trình cho phép — v6 có, v5 thì không.

• Luồng mới được khởi tạo tại chỉ mục reward_info_count, reward_info_count++.
• Vault phần thưởng được tín dụng với toàn bộ ngân sách luồng từ ATA của người gọi.

​

SetRewards (v5/v6)

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

• Luồng vẫn đang chạy (reward_state == 1).
• new_end_time ≥ current end_time.
• Ngân sách bổ sung cần thiết (new_emission × new_duration − already_emissioned) có trong ATA của người gửi và được chuyển đến vault phần thưởng bởi lệnh.

​

RestartRewards (v5/v6)

• reward_state == 2 (đã kết thúc).
• Người gọi là reward_sender của khe (v6) hoặc owner của farm (v5).

​

WithdrawReward (v5/v6)

reward_index: u8

• Luồng đã kết thúc (reward_state == 2).
• reward_total_emissioned == reward_claimed + vault_balance (không có gì đang nợ).

​

Biến thể v5

• Deposit / Withdraw có hình dạng giống v6 nhưng sử dụng tối đa 2 khe phần thưởng và reward_per_share là u128 (điểm cố định với cơ số khác).
• CreateAssociatedLedger là lệnh gọi riêng biệt cần thiết trước Deposit đầu tiên; v6 đã hợp nhất nó.
• AddReward có sẵn, Harvest thì không (sử dụng Deposit 0).

​

Biến thể v3

• Luồng phần thưởng duy nhất. Không có AddReward, không có khe thứ hai.
• Deposit 0 là cách duy nhất để nhận.
• CreateUserLedger phải được gọi trước Deposit đầu tiên.

​

Ma trận thay đổi trạng thái

​

Bước tiếp theo

• products/farm-staking/code-demos — ví dụ TypeScript.
• products/farm-staking/accounts — bố cục FarmState / UserLedger / UserStake.
• reference/error-codes — liệt kê lỗi farm.

• Raydium SDK v2 Farm module
• Raydium farm program source (v3 / v5 / v6)