Instrucciones de Farm / Staking

​

Inventario de instrucciones

​

CreateFarm (v6)

reward_info_count: u8               // number of reward streams at creation (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 or Token-2022
  }
]

• open_time > now, end_time > open_time.
• Las ATA del creator contienen al menos emission_per_second_x64 × (end_time − open_time) / 2^64 del mint de recompensa.
• staking_mint no tiene autoridad de congelación, o la autoridad de congelación está deshabilitada.

• FarmState inicializado, total_staked = 0.
• Vault(s) de recompensa financiado(s) con el presupuesto completo del stream.
• El ATA de recompensa del creador se drena por esa cantidad.

​

Deposit (v6)

amount: u64

1. Actualizar reward_per_share_x64[i] para cada stream de recompensa activa usando la fórmula de actualización lazy.
2. Calcular pending_i = user_ledger.deposited × reward_per_share_x64[i] / 2^64 − user_ledger.reward_debts[i].
3. Transferir pending_i desde reward_vault_{i} a user_reward_ata_{i}.
4. Transferir amount del mint de staking desde user_staking_ata a staking_vault.
5. Actualizar user_ledger.deposited += amount y reenganchar reward_debts[i].
6. Actualizar farm_state.total_staked += amount.

• amount > 0 para un stake real (v6 prohíbe amount = 0 — usar Harvest para claim-only).
• user_staking_ata contiene al menos amount.
• Cada vault de recompensa activa contiene al menos lo pendiente adeudado a este usuario.

​

Withdraw (v6)

amount: u64

• amount ≤ user_ledger.deposited.
• El farm no 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 un slot libre (reward_info_count < 5 en v6, < 2 en v5).
• open_time ≥ now (puede ser en el futuro) u open_time < now está permitido solo si la versión del programa lo permite — v6 lo hace, v5 no.

• El nuevo stream se inicializa en el índice reward_info_count, reward_info_count++.
• El vault de recompensa se acredita con el presupuesto completo del stream desde el ATA del llamador.

​

SetRewards (v5/v6)

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

• El stream sigue en ejecución (reward_state == 1).
• new_end_time ≥ current end_time.
• El presupuesto adicional requerido (new_emission × new_duration − already_emissioned) está presente en el ATA del remitente y se transfiere al vault de recompensa por la instrucción.

​

RestartRewards (v5/v6)

• reward_state == 2 (ended).
• El llamador es reward_sender del slot (v6) o el farm owner (v5).

​

WithdrawReward (v5/v6)

reward_index: u8

• El stream ha terminado (reward_state == 2).
• reward_total_emissioned == reward_claimed + vault_balance (nada se adeuda actualmente).

​

Variaciones de v5

• Deposit / Withdraw tienen la misma forma que v6 pero usan hasta 2 slots de recompensa y reward_per_share es u128 (punto fijo con un radix diferente).
• CreateAssociatedLedger es una llamada separada requerida antes del primer Deposit; v6 lo fusionó.
• AddReward está disponible, Harvest no (usar Deposit 0).

​

Variaciones de v3

• Stream de recompensa único. Sin AddReward, sin segundo slot.
• Deposit 0 es la única forma de reclamar.
• CreateUserLedger debe ser llamado antes del primer Deposit.

​

Matriz de cambio de estado

​

Hacia dónde ir a continuación

• products/farm-staking/code-demos — ejemplos en TypeScript.
• products/farm-staking/accounts — layouts de FarmState / UserLedger / UserStake.
• reference/error-codes — enumeración de errores del farm.

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