Instruções do CLMM

​

Inventário de instruções

​

CreatePool

sqrt_price_x64: u128           // preço inicial
open_time:      u64            // swaps rejeitados antes deste horário

• token_mint_0 < token_mint_1 por ordem de bytes.
• amm_config.disable_create_pool == false.
• Os mints não são rejeitados pela lista de permissões de extensão Token-2022.

• pool_state.sqrt_price_x64 = sqrt_price_x64, tick_current = floor(log_{1.0001}(price)).
• pool_state.liquidity = 0 (nenhuma posição ainda).
• pool_state.fee_on = FromInput (padrão legado).
• pool_state.dynamic_fee_info é zerado (taxa dinâmica desativada).

​

CreateCustomizablePool

pub struct CreateCustomizableParams {
    pub sqrt_price_x64:    u128,
    pub collect_fee_on:    CollectFeeOn,   // FromInput | Token0Only | Token1Only
    pub enable_dynamic_fee: bool,
}

• pool_state.fee_on definido para a variante CollectFeeOn escolhida.
• Se a taxa dinâmica foi habilitada: pool_state.dynamic_fee_info é inicializado a partir do DynamicFeeConfig fornecido (cinco parâmetros de calibração copiados; campos de estado zerados).
• Caso contrário: pool_state.dynamic_fee_info é zerado (= taxa dinâmica inativa permanentemente para este pool).

​

OpenPositionV2 / OpenPositionWithToken22Nft

tick_lower_index: i32
tick_upper_index: i32
tick_array_lower_start_index: i32
tick_array_upper_start_index: i32
liquidity:  u128              // L desejado (ou 0 para usar os valores abaixo)
amount_0_max: u64
amount_1_max: u64
with_metadata: bool           // gravar metadados do NFT (Metaplex)
base_flag: Option<bool>       // true = ajustar ao amount0; false = ajustar ao amount1

• tick_lower < tick_upper, ambos múltiplos de pool.tick_spacing, dentro de [MIN_TICK, MAX_TICK].
• Tick arrays necessários passados e inicializados (ou criados aqui via CPI InitTickArray na transação).
• O usuário tem pelo menos amount_0_max e amount_1_max nas ATAs de origem.

• personal_position existe, liquidity definido, fee_growth_inside_last com snapshot capturado.
• Entradas de tick-array em tick_lower e tick_upper atualizadas (liquidity_gross += L, liquidity_net ± L, snapshots de crescimento de taxa mantidos).
• pool_state.liquidity += L se a posição estiver no intervalo (tick_lower ≤ tick_current < tick_upper).

​

IncreaseLiquidityV2

liquidity: u128
amount_0_max: u64
amount_1_max: u64
base_flag: Option<bool>

• Transfere amount_0_actual / amount_1_actual do usuário para os vaults.
• Incrementa personal_position.liquidity e pool_state.liquidity (se estiver no intervalo), além dos valores liquidity_gross / liquidity_net dos ticks extremos.
• Coleta taxas e recompensas devidas desde o último toque e as credita em tokens_fees_owed_{0,1} / reward_amount_owed. Esses valores são pagos apenas em DecreaseLiquidity ou CollectReward, não no aumento.

​

DecreaseLiquidityV2

liquidity: u128
amount_0_min: u64
amount_1_min: u64

• Calcula (amount_0, amount_1) para o L removido com base no sqrt_price_x64 atual.
• Liquida as taxas/recompensas acumuladas desde o último toque, da mesma forma que IncreaseLiquidity.
• Transfere amount_0 + fees_owed_0 e amount_1 + fees_owed_1 dos vaults para o usuário.
• Decrementa os contadores de liquidez; se o novo personal_position.liquidity == 0, a posição é elegível para ClosePosition.

​

ClosePosition

• personal_position.liquidity == 0.
• tokens_fees_owed_{0,1} == 0.
• Todos os contadores de recompensa reward_amount_owed == 0.

• Queima o NFT.
• Fecha a conta do mint do NFT e a conta personal_position, devolvendo o rent ao payer.

​

SwapV2

amount: u64                  // entrada se is_base_input=true, saída caso contrário
other_amount_threshold: u64  // mínimo de saída ou máximo de entrada
sqrt_price_limit_x64: u128   // limite rígido; 0 ⇒ sem limite
is_base_input: bool

• pool_state.status permite swap.
• now >= open_time.
• sqrt_price_limit_x64 está no lado correto de sqrt_price_x64 para a direção escolhida.

1. Sobretaxa dinâmica — se pool.dynamic_fee_info for diferente de zero, o programa atualiza o acumulador de volatilidade usando a distância de tick percorrida desde o último swap (com as regras de filtro/decaimento de products/clmm/fees) e adiciona um dynamic_fee_component sobre AmmConfig.trade_fee_rate. A taxa total é limitada a 10% (MAX_FEE_RATE_NUMERATOR / 1_000_000).
2. Correspondência de ordens limitadas — quando o percurso de preço cruza um tick que contém ordens limitadas abertas, o programa preenche primeiro a liquidez disponível de ordens limitadas naquele tick (FIFO por order_phase), e depois continua ao longo da curva de liquidez do LP. Os valores preenchidos atualizam tick.unfilled_ratio_x64 e tick.part_filled_orders_remaining para liquidação posterior; as próprias ordens permanecem pendentes até que o dono chame SettleLimitOrder.
3. Roteamento de taxa unilateral — quando pool.fee_on = Token0Only ou Token1Only, o passo de swap ainda calcula a mesma negociação entrada-saída; a taxa é então roteada para o lado configurado. Para direções em que o lado de taxa configurado é a saída, a taxa é deduzida da saída do swap (o usuário recebe out − fee); para direções em que é a entrada, o comportamento é igual ao FromInput. Veja is_fee_on_input(zero_for_one) e is_fee_on_token0(zero_for_one) em PoolState.

​

OpenLimitOrder

nonce_index:    u8       // índice de conta nonce escolhido pelo usuário (0..255 por carteira)
zero_for_one:   bool     // true: vende token0 por token1; false: vende token1 por token0
tick_index:     i32      // deve ser múltiplo de pool.tick_spacing
amount:         u64      // quantidade do token de entrada

• tick_index % pool.tick_spacing == 0 e dentro de [MIN_TICK, MAX_TICK].
• tick_index está no lado correto de pool.tick_current para a direção escolhida (vender token0 → tick deve estar acima do atual, e vice-versa). Vender em um tick já cruzado seria correspondido imediatamente e é rejeitado.
• pool_state.status permite a operação de ordem limitada (bit 5).

• limit_order existe, com snapshot de tick.order_phase e tick.unfilled_ratio_x64 no momento da abertura.
• tick.orders_amount += amount (no coorte atual).
• limit_order_nonce.order_nonce += 1.
• Evento OpenLimitOrderEvent emitido.

​

IncreaseLimitOrder

amount: u64    // quantidade adicional do token de entrada

• limit_order.owner == signer.
• A ordem ainda está no mesmo coorte (tick.order_phase == limit_order.order_phase). Se o coorte já começou a ser preenchido, a ordem está parcialmente liquidada — o chamador deve chamar DecreaseLimitOrder ou SettleLimitOrder primeiro para avançar.

• Transfere amount da ATA do dono para input_vault.
• limit_order.total_amount += amount; tick.orders_amount += amount.

​

DecreaseLimitOrder

amount:     u64    // quantidade do token de entrada a retirar (máx = saldo não preenchido)
amount_min: u64    // piso de slippage na retirada do lado de entrada

• Recalcula o valor preenchido da ordem a partir do unfilled_ratio_x64 do coorte desde a abertura.
• Envia a saída preenchida para output_token_account.
• Envia amount da entrada não preenchida de volta para input_token_account.
• Atualiza limit_order conforme necessário. Se o novo saldo não preenchido for zero, o programa fecha a conta e devolve o rent ao owner.

​

SettleLimitOrder

• Calcula a saída acumulada devida usando (limit_order.unfilled_ratio_x64, tick.unfilled_ratio_x64).
• Transfere o delta para output_token_account.
• Atualiza limit_order.settled_output.
• Não fecha a ordem; ela continua aberta para qualquer entrada restante.

​

CloseLimitOrder

• A ordem tem saldo não preenchido zero (seja porque amount == total_amount foi preenchido e liquidado, seja porque o dono reduziu anteriormente a ordem para zero e não a fechou).

• Fecha limit_order; o rent é enviado para limit_order.owner.

​

CreateDynamicFeeConfig (admin)

index:                       u16
filter_period:               u16   // segundos; ex: 30
decay_period:                u16   // segundos; ex: 600. Deve ser > filter_period
reduction_factor:            u16   // 1..10_000; ex: 5_000 = 50% de retenção por janela de decaimento
dynamic_fee_control:         u32   // 1..100_000; ganho na curva de volatilidade para taxa
max_volatility_accumulator:  u32   // limite máximo

​

UpdateDynamicFeeConfig (admin)

​

CollectProtocolFee / CollectFundFee

​

InitializeReward

open_time:     u64
end_time:      u64
emissions_per_second_x64: u128   // Q64.64

• Menos de 3 fluxos ativos no pool no momento.
• O financiador deposita total_emission = emissions_per_second × (end_time − open_time) de token de recompensa no vault como parte desta instrução.
• Mint de recompensa na whitelist conforme operation_state.

​

SetRewardParams

​

UpdateRewardInfos

​

CollectReward

• Liquida o crescimento de recompensas (mesmo padrão das taxas).
• Transfere o valor devido para a ATA destinatária e zera reward_amount_owed[i].

​

Matriz de mudanças de estado

​

Próximos passos

• products/clmm/code-demos — exemplos TypeScript executáveis.
• products/clmm/fees — detalhes sobre acúmulo de taxas e recompensas.
• reference/error-codes — tabela completa de erros Anchor do CLMM.

• raydium-io/raydium-clmm — programs/amm/src/instructions
• Raydium SDK v2 — @raydium-io/raydium-sdk-v2