Visão geral de 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.

​

O que é um farm

• Baseado em emissão, não em taxas. Diferentemente dos fluxos de recompensa built-in do CLMM, as recompensas do farm não estão vinculadas ao volume de swap ou atividade do pool. O orçamento de um farm é depositado antecipadamente pelo criador e é emitido a uma taxa constante por segundo até se esgotar.
• Independente do pool. O pool não sabe que o farm existe. Mover LP entre carteiras não notifica o farm; um usuário deve ativamente fazer Withdraw do farm primeiro. Da mesma forma, fazer Withdraw do pool não faz withdraw do farm.
• Ledger por usuário, por recompensa. Cada staker tem uma conta UserStake (ou “Ledger”) por farm que rastreia seu montante em stake e seu snapshot do contador reward-per-share para cada um dos fluxos de recompensa do farm.
• Multi-recompensa. Farm v5 suporta até 2 recompensas; v6 suporta até 5. Cada recompensa tem seu próprio vault, taxa por segundo, hora de início e hora de término.

​

As três versões ao vivo

​

Contagem reward-per-share

reward_per_share := total_rewards_distributed_by_stream / total_staked
pending(user)    := user.staked × (reward_per_share − user.reward_debt)

• reward_per_share é armazenado na conta farm como um contador de ponto fixo (Q64.64 em v5+, Q56.8 em v3). Ele apenas cresce.
• user.reward_debt é o snapshot de reward_per_share na última interação do usuário. Não é uma dívida que o usuário deve; é um offset usado para calcular acréscimos futuros.
• Em Deposit e Withdraw, o farm primeiro liquida recompensas pendentes (creditando user.pending_reward ou enviando diretamente para a ATA do usuário, dependendo da versão), depois atualiza user.reward_debt para o contador atual.
• Em Harvest, o farm paga pending_reward e snapshots reward_debt novamente.

elapsed        := min(now, reward.end_time) − reward.last_update_time
new_emissions  := reward.per_second × elapsed
if total_staked > 0:
    reward_per_share += new_emissions / total_staked
reward.last_update_time := now

​

Staking mint vs reward mint

​

Cronogramas de emissão

• start_time — o timestamp UNIX em que as emissões começam. Antes disso, sem acréscimo.
• end_time — o timestamp em que as emissões param. Depois disso, reward_per_share não cresce mais a partir deste fluxo.
• per_second — a taxa de emissão enquanto start_time ≤ now < end_time.

​

O que farms não são

• Não um distribuidor de taxas. CPMM e CLMM coletam taxas de negociação diretamente no estado do pool. Farms não tocam em taxas de pool. O único caminho das taxas do pool para um token holder é redenção de LP ou CLMM’s CollectFee.
• Não automático. LP deve ser explicitamente feito stake para ganhar recompensas de farm. Detentores de LP que deixam seus tokens em sua carteira não ganham nada do farm.
• Não fungível. Cada conta UserStake está vinculada a um par (farm, user). Você não pode transferir seu stake para outra carteira sem fazer unstake primeiro.
• Não compatível com posições CLMM diretamente. Farm v6 introduziu um adaptador CLMM, mas na prática pools CLMM usam seus próprios fluxos de recompensa built-in (veja products/clmm/fees) em vez de emissões de farm.

​

Quando farms são a ferramenta certa

• Incentivar LP para um de seus pools CPMM ou AMM v4 com um token externo (seu token de projeto, token de um parceiro, etc.).
• Executar um programa de staking em um mint single-asset (clássico “stake RAY, earn RAY”) sem implantar seu próprio contrato.
• Sobrepor recompensas adicionais em um pool existente sem precisar de acesso admin a esse pool.

​

Conteúdos do capítulo

• accounts — layout de estado on-chain completo por versão.
• instructions — toda instrução farm com sua lista de contas e pré/pós-condições.
• code-demos — exemplos TypeScript para staking, harvesting e criação de um novo farm.

​

Onde ir a seguir

• products/clmm/fees — compare emissões de farm com o modelo de recompensa built-in do CLMM.
• reference/program-addresses — os três IDs de programa farm.
• protocol-overview/versions-and-migration — quando usar cada versão de farm.

• Farm v6 IDL incluído no SDK: raydium-io/raydium-sdk-V2 em src/raydium/farm/.
• Módulo Farm do Raydium SDK v2