Instruções Farm / Staking

​

Inventário de instruções

​

CreateFarm (v6)

reward_info_count: u8               // número de fluxos de recompensas na criação (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 ou Token-2022
  }
]

• open_time > now, end_time > open_time.
• ATAs do creator possuem pelo menos emission_per_second_x64 × (end_time − open_time) / 2^64 do mint de recompensas.
• staking_mint não tem autoridade de congelamento, ou ela está desabilitada.

• FarmState inicializado, total_staked = 0.
• Vault(s) de recompensas financiados com o orçamento completo do fluxo.
• A ATA de recompensas do criador é drenada por essa quantidade.

​

Deposit (v6)

amount: u64

1. Atualizar reward_per_share_x64[i] para cada fluxo de recompensas ativo usando a fórmula de atualização lazy.
2. Calcular pending_i = user_ledger.deposited × reward_per_share_x64[i] / 2^64 − user_ledger.reward_debts[i].
3. Transferir pending_i de reward_vault_{i} para user_reward_ata_{i}.
4. Transferir amount do mint de staking de user_staking_ata para staking_vault.
5. Atualizar user_ledger.deposited += amount e re-fazer snapshot de reward_debts[i].
6. Atualizar farm_state.total_staked += amount.

• amount > 0 para um stake verdadeiro (v6 proíbe amount = 0 — use Harvest para claim-only).
• user_staking_ata contém pelo menos amount.
• Cada vault de recompensa ativo contém pelo menos o pendente devido a este usuário.

​

Withdraw (v6)

amount: u64

• amount ≤ user_ledger.deposited.
• Farm não está pausado.

​

Harvest (v6)

​

AddReward (v5/v6)

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

• Existe um slot livre (reward_info_count < 5 na v6, < 2 na v5).
• open_time ≥ now (pode estar no futuro) ou open_time < now é permitido apenas se a versão do programa permitir — v6 permite, v5 não.

• O novo fluxo é inicializado no índice reward_info_count, reward_info_count++.
• O vault de recompensas é creditado com o orçamento completo do fluxo a partir da ATA do chamador.

​

SetRewards (v5/v6)

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

• O fluxo ainda está em execução (reward_state == 1).
• new_end_time ≥ current end_time.
• O orçamento adicional requerido (new_emission × new_duration − already_emissioned) está presente na ATA do remetente e é transferido para o vault de recompensas pela instrução.

​

RestartRewards (v5/v6)

• reward_state == 2 (encerrado).
• Chamador é reward_sender do slot (v6) ou farm owner (v5).

​

WithdrawReward (v5/v6)

reward_index: u8

• Fluxo encerrado (reward_state == 2).
• reward_total_emissioned == reward_claimed + vault_balance (nada está atualmente devido).

​

Variações v5

• Deposit / Withdraw têm a mesma forma que v6 mas usam até 2 slots de recompensas e reward_per_share é u128 (ponto fixo com um radicix diferente).
• CreateAssociatedLedger é uma chamada separada obrigatória antes do primeiro Deposit; v6 a incorporou.
• AddReward está disponível, Harvest não (use Deposit 0).

​

Variações v3

• Fluxo único de recompensas. Sem AddReward, sem segundo slot.
• Deposit 0 é a única forma de reclamar.
• CreateUserLedger deve ser chamado antes do primeiro Deposit.

​

Matriz de mudança de estado

​

Próximos passos

• products/farm-staking/code-demos — exemplos TypeScript.
• products/farm-staking/accounts — layouts FarmState / UserLedger / UserStake.
• reference/error-codes — enum de erros do farm.

• Módulo Farm do Raydium SDK v2
• Código-fonte do programa Raydium farm (v3 / v5 / v6)