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.

​

명령어 목록

​

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,    // reward mint
    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 개의 reward mint를 보유합니다.
• staking_mint는 동결 권한이 없거나 동결 권한이 비활성화되어 있습니다.

• FarmState 초기화, total_staked = 0.
• 리워드 vault가 전체 스트림 예산으로 펀딩됨.
• Creator의 reward 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를 보유합니다.
• 각 활성 리워드 vault가 이 사용자에게 빚진 pending 이상을 보유합니다.

​

Withdraw (v6)

amount: u64

• amount ≤ user_ledger.deposited.
• Farm이 일시 중지되지 않았습니다.

​

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++됩니다.
• 리워드 vault가 호출자의 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에 있고 명령어로 리워드 vault로 전송됩니다.

​

RestartRewards (v5/v6)

• reward_state == 2 (종료됨).
• 호출자는 슬롯의 reward_sender (v6) 또는 farm 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 없음, 두 번째 슬롯 없음.
• Deposit 0이 청구하는 유일한 방법입니다.
• 첫 Deposit 전에 CreateUserLedger를 호출해야 합니다.

​

상태 변화 매트릭스

​

다음 단계

• products/farm-staking/code-demos — TypeScript 예제.
• products/farm-staking/accounts — FarmState / UserLedger / UserStake 레이아웃.
• reference/error-codes — farm 오류 enum.

• Raydium SDK v2 Farm module
• Raydium farm 프로그램 소스 (v3 / v5 / v6)