Skip to main content
Esta página foi traduzida automaticamente por IA. A versão em inglês é a fonte oficial.Ver versão em inglês →
Esta entrada cobre uma atualização futura do programa CLMM. Foi verificada contra o branch chore/upgrade-anchor do raydium-clmm (head a72f9e1) antes da implantação. Confirme o programa implantado antes de depender da nova instrução ou do comportamento alterado de CreateAmmConfig.
CLMM agora recebe a mesma migração de framework que CPMM e LaunchLab entregaram em 2026-09-09. Anchor vai de 0.32.1 para =1.0.2, e a cadeia de ferramentas de compilação vai de Agave 2.3.0 para 3.1.10. Duas mudanças do lado admin acompanham: uma nova instrução CollectExcessLamports e proprietários de taxa fixos em CreateAmmConfig. Toda instrução que um trader, um LP, um usuário de limite de ordem ou um criador de pool chama mantém sua lista de contas, argumentos e matemática.

​
TL;DR para integradores

  • Nenhuma instrução voltada ao usuário foi alterada. CreatePool, CreateCustomizablePool, CreatePermissionedPool, todos os caminhos OpenPosition* / IncreaseLiquidity* / DecreaseLiquidity*, ClosePosition, Swap / SwapV2 / SwapRouterBaseIn, as cinco instruções de limite de ordem e as instruções de recompensa são idênticas em bytes na rede. Nenhum layout de conta foi alterado.
  • Uma instrução é adicionada: CollectExcessLamports. É apenas para admin e não leva argumentos. Varre um pool por chamada: o próprio PoolState do pool é sempre varrido, e o pool PDA assina seus vaults, que você passa em remaining_accounts. Qualquer outra conta de propriedade do CLMM em remaining_accounts também é varrida. Veja products/clmm/instructions.
  • Um código de erro é adicionado: 6052 LamportsCalculateError. Os códigos 6000–6051 permanecem inalterados.
  • CreateAmmConfig não copia mais o signatário em owner / fund_owner. Novas configs recebem chaves protocol_fee_owner e fund_fee_owner codificadas. Na mainnet, estas são as mesmas duas chaves já armazenadas em todas as 21 configs existentes. As contas AmmConfig existentes não são tocadas, então continue lendo os campos da conta.
  • Atualize seu IDL. Ele adiciona uma instrução e uma variante de erro, para 39 instruções e 53 erros.
  • Você agora pode colocar CPMM e CLMM em um crate. Ambos os repos fixam anchor-lang / anchor-spl =1.0.2 em seus branches chore/upgrade-anchor, então um único programa pode fazer CPI em ambos. Veja sdk-api/rust-cpi.
  • O pacote do cliente TypeScript foi renomeado. A suite de testes migra de @coral-xyz/anchor 0.32.1 para @anchor-lang/core 1.0.2.

​
CollectExcessLamports

A etapa 1 de SIMD-0437 foi ativada na mainnet em 3 de setembro de 2026. Toda conta CLMM criada antes de uma etapa agora está super-financiada, e apenas o programa CLMM pode mover lamports para fora de uma conta que possui. Isso cobre vaults de pool, vaults de recompensa, PoolState, AmmConfig, ObservationState, TickArrayBitmapExtension e o resto. A instrução leva quatro contas fixas, depois qualquer número de contas de origem em remaining_accounts: O pool é a autoridade de assinatura, não um PDA em nível de programa. CPMM assina com uma autoridade global vault_and_lp_mint_auth_seed. Os vaults de token CLMM são de propriedade de seu PoolState, então uma única chamada pode apenas assinar para o pool passado no slot 2. Cada conta de programa de token deve ter esse pool como sua autoridade: token_vault_0, token_vault_1 ou um dos vaults de recompensa do pool. Uma conta de token de outro pool ou uma conta de token do usuário falha na verificação de proprietário do programa de token e reverte toda a instrução. O programa não a ignora. Os mints de NFT de posição também não são varríveis, porque sua autoridade de mint é revogada quando a posição é aberta. Varra pool por pool. A instrução faz duas passagens, e essa ordem é fixa:
  1. CPIs do programa de token primeiro. Para cada origem de propriedade do SPL Token ou Token-2022, uma conta não-nativa recebe WithdrawExcessLamports (discriminante 38). Um vault wSOL nativo recebe a rodada SyncNative → UnwrapLamports (discriminante 45), que termina com uma verificação de que o saldo envolvido é igual ao seu valor pré-sincronização. Se não for, a chamada falha com LamportsCalculateError. Um vault do lado SOL mantém sua liquidez total, e nenhuma cotação de swap muda em uma varredura.
  2. Débitos diretos em segundo. A passagem 2 debita pool_state primeiro, depois cada origem de propriedade do programa CLMM, até rent.minimum_balance(data_len).
Origens de propriedade de qualquer outro programa são ignoradas silenciosamente. Esta ordem de duas passagens é a que CPMM adotou em 2026-09-19. CLMM a tem desde seu primeiro lançamento. Se um PDA é debitado antes de um CPI, o runtime aborta com UnbalancedInstruction, então os chamadores podem passar origens em qualquer ordem.
A passagem de propriedade do programa não verifica qual pool ou usuário uma conta pertence. Qualquer conta de propriedade do programa CLMM é elegível, incluindo algumas cujo rent um usuário pagou: PersonalPositionState, LimitOrderState e TickArrayState. Apenas o excesso acima do mínimo isento de rent se move. A conta mantém seus dados e permanece isenta de rent. Quando uma posição ou ordem é posteriormente fechada, o programa reembolsa qualquer saldo que a conta mantém naquele ponto. Após uma varredura, esse saldo é o mínimo de rent atual.
Os endereços da carteira estão listados em reference/program-addresses.

​
CreateAmmConfig escreve proprietários de taxa fixos

Antes desta versão, create_amm_config definia ambos os campos de proprietário de taxa a partir do signatário chamador:
Agora escreve as constantes do próprio programa:
CreateAmmConfig ainda é controlado por crate::admin::ID. Antes desta versão, cada novo nível de taxa começava com o admin em ambos os campos e tinha que ser rotacionado com o parâmetro UpdateAmmConfig 3 / 4. Agora começa com as carteiras operacionais. Na mainnet, as constantes são as mesmas chaves já armazenadas como owner / fund_owner em todas as 21 configs existentes. O programa agora escreve um valor que as operações costumavam definir manualmente. Os signatários de coleta não mudam. CollectProtocolFee aceita amm_config.owner ou crate::admin::ID, e CollectFundFee aceita amm_config.fund_owner ou crate::admin::ID, antes e depois desta versão. Na devnet, ambas as constantes resolvem para a mesma chave. Veja reference/program-addresses.
Esta não é uma migração. Cada AmmConfig existente mantém o owner e fund_owner que já possui. Leia os campos em vez de codificar as constantes ou a chave do admin.

​
Mudanças de cadeia de ferramentas e dependências

As mudanças do Anchor 1.0 nos locais de chamada CPI são as mesmas que os integradores de CPMM já trataram. CpiContext::new leva a Pubkey do programa em vez de sua AccountInfo, e Context tem um parâmetro de lifetime em vez de quatro. No crate do cliente, RequestBuilder::instructions() agora retorna Vec<Instruction> sem um Result, e system_program se moveu para solana-system-interface. Veja sdk-api/rust-cpi. Detalhes do sistema de compilação sem efeito on-chain:
  • Admin localnet. O recurso localnet não compila mais uma chave de teste fixa apoiada por um fixture comprometido. Em vez disso, lê o admin da variável de ambiente CLMM_LOCALNET_ADMIN no tempo de compilação, que yarn test:local-admin define a partir de sua carteira local. A exceção .gitignore do fixture desapareceu.
  • Perfil de lançamento. O bloco duplicado [profile.release] em programs/amm/Cargo.toml foi deletado. Cargo ignora [profile] fora da raiz do workspace, então o bloco raiz já era o em efeito, e o panic = "abort" em nível de programa nunca foi aplicado.
  • Anchor.toml. seeds = false se torna resolution = true mais skip-lint = false, e a URL [registry] obsoleta é removida.
  • Lints. programs/amm/Cargo.toml adiciona uma lista de permissões [lints.rust] unexpected_cfgs para os cfgs de recurso que as macros Anchor e Solana emitem.
  • README. Neste branch, o README ainda diz para você executar rustup default 1.86.0 e avm install 0.32.1 de coral-xyz/anchor. Siga Anchor.toml e solana-fundamentals/toolchain em vez disso.

​
O que não mudou

  • Cada layout de conta. PoolState, AmmConfig, TickArrayState, TickArrayBitmapExtension, PersonalPositionState, ObservationState, LimitOrderState, DynamicFeeConfig, Permission e SupportMintAssociated mantêm os mesmos tamanhos e deslocamentos.
  • Códigos de erro 6000–6051.
  • Swap, liquidez, taxa, taxa dinâmica e matemática de limite de ordem. CollectExcessLamports move lamports que nunca fizeram parte das reservas de nenhum pool.
  • Congelamento de NFT de posição de 2026-08-17, incluindo a regra de pool-como-autoridade-de-congelamento e o caminho de descongelamento de ClosePosition.
  • spl_memo. A restrição do programa de memo de DecreaseLiquidityV2 se moveu de spl_memo::id() para anchor_spl::memo::ID. Ambos nomeiam o mesmo endereço; anchor-spl apenas renomeou a exportação.
  • ID do programa.

​
Páginas atualizadas

  • products/clmm/instructions: banner de atualização; seção CollectExcessLamports com sua lista de contas, tabela de despacho de duas passagens e escopo por pool; linhas de inventário, controle de admin e matriz de mudança de estado; nota de proprietário de taxa em CollectProtocolFee / CollectFundFee.
  • products/clmm/accounts: comentários de proprietário de AmmConfig e uma nota sobre o que CreateAmmConfig escreve.
  • products/clmm/code-demos: banner de versão e esqueleto Rust CPI movido para Anchor 1.0.
  • products/cpmm/code-demos: a nota “não pode compartilhar um crate com CLMM” removida.
  • reference/error-codes: 6052 documentado.
  • reference/program-addresses: nova seção “Carteiras de proprietário de taxa CLMM”; CLMM adicionado a “Carteiras de coleta de excess-lamports”.
  • sdk-api/rust-cpi, sdk-api/anchor-idl, solana-fundamentals/toolchain: pins Anchor 1.0 para raydium-clmm, e o aviso de divisão de crate aposentado.
  • solana-fundamentals/rent-and-reclaimable-rent: CLMM adicionado a “O que os programas Raydium varrem do seu próprio lado”.
  • security/admin-and-multisig: função de coletor de excess-lamports CLMM.
  • protocol-overview/versions-and-migration: marcador de histórico de atualização CLMM.