Esta página foi traduzida automaticamente por IA. A versão em inglês é a fonte oficial.Ver versão em inglês →
Banner de versão. Todos os demos TypeScript visam
@raydium-io/raydium-sdk-v2@0.2.64-alpha; foram executados pela última vez contra 0.2.42-alpha (2026-04) e suas assinaturas de chamada foram verificadas novamente contra a fonte 0.2.64-alpha em 2026-09-09, contra Solana mainnet-beta. O esqueleto CPI em Rust visa raydium-cp-swap no branch chore/upgrade-anchor, Anchor 1.0.2 — master ainda fixa 0.32.1. Os IDs de programa são extraídos via constantes de reference/program-addresses.Pré-requisitos
raydium-sdk-V2-demo/src/cpmm; o link do GitHub fica ao lado de cada seção. O bootstrap segue o config.ts.template do repositório de demos (fonte):
Raydium é a fachada do SDK — cada demo abaixo a utiliza. Raydium.load é assíncrono porque carrega a lista de tokens por padrão; passe disableLoadToken: true para pular essa busca. A verificação de disponibilidade de recursos já é ignorada, a menos que você passe disableFeatureCheck: false. As configurações de taxa são buscadas preguiçosamente no primeiro uso via raydium.api.getCpmmConfigs().
Criar um pool CPMM
Fonte:src/cpmm/createCpmmPool.ts
- Ordenar os mints na ordem token0/token1 antes de derivar o PDA.
- Pagar a
create_pool_feeúnica parapoolFeeAccount. - Criar as contas de token associadas do chamador se estiverem faltando.
- Escolher o programa de token correto (SPL Token vs Token-2022) por lado.
Swap (entrada base)
Fonte:src/cpmm/swap.ts
getPoolInfoFromRpc. Não cotize fora de api-v3.raydium.io para uma transação que você está prestes a assinar — uma cotação que está um bloco desatualizada pode escorregar para ExceededSlippage no momento do desembarque.
Swap (saída base)
Fonte:src/cpmm/swapBaseOut.ts
Depositar liquidez
Fonte:src/cpmm/deposit.ts
maximum_* da instrução e constrói as criações de ATA se necessário. raydium.cpmm.computePairAmount({ ... }) retorna os mesmos números se você quiser para uma visualização de UI.
Sacar liquidez
Fonte:src/cpmm/withdraw.ts
Coletar taxas de protocolo/fundo/criador
Fonte:src/cpmm/collectCreatorFee.ts, src/cpmm/collectAllCreatorFee.ts
A coleta de protocolo e fundo permanece com portão de autoridade. As taxas do criador têm dois caminhos: o CollectCreatorFee assinado pelo criador e o aditivo CollectCreatorFeePermissionless, que qualquer pagador pode invocar, mas que pode transferir apenas para as ATAs canônicas do criador. 0.2.64-alpha envia construtores em nível de módulo para ambos os caminhos do criador:
As duas instruções do criador têm discriminadores e layouts de conta diferentes — a sem permissão substitui o assinante do criador por um
payer separado e um creator não assinante. Use o construtor correspondente em vez de trocar manualmente contas no outro.Não há construtor de taxa de protocolo ou fundo no SDK (makeCollectProtocolFeeInstruction e makeCollectFundFeeInstruction não existem sob nenhum nome) — esses são caminhos de administrador, assim como CreateCreatorFeeShare / CloseCreatorFeeShare, que também não têm construtor. Os construtores de instrução de baixo nível que existem são collectCpFeeInstruction, makeCollectCreatorFeeInstruction e collectCreatorFeePermissionlessInInstruction.PoolState:
Esqueleto CPI em Rust
Se você quiser invocar CPMM a partir do seu próprio programa Anchor — por exemplo, um vault que faz swap em nome de seus depositantes — o contexto CPI fica assim. A ordenação de contas segueproducts/cpmm/instructions.
CpiContext::new por CpiContext::new_with_signer e passe suas sementes.
Armadilhas comuns
Uma lista de verificação rápida antes de abrir um ticket de suporte:- Mints ordenados. Se seu PDA
poolStatederivado não corresponder ao pool on-chain, você provavelmente esqueceu de ordenar os mints. - Cotação de API desatualizada. Nunca passe um valor de reserva de
api-v3.raydium.ioparaCurveCalculator.swap. Busque de um RPC. - Programa de token errado. O vault de um mint Token-2022 é de propriedade do programa Token-2022, não do SPL Token. Sempre use os campos
token_0_program/token_1_programdo pool. - Slippage sub-denominado para mints com taxa de transferência. Se qualquer lado do pool for um mint Token-2022 com taxa de transferência, seu
minimum_amount_outdeve ser denominado no que o usuário realmente recebe, não no que o vault envia. NotApprovedem um swap. VerifiquePoolState.status— o administrador pode ter pausado swaps nesse pool. Vejaproducts/cpmm/instructionspara a máscara de status.
Próximos passos
sdk-api/typescript-sdk— referência completa do SDK.sdk-api/rest-api— endpoints de cotação e metadados de pool.user-flows/create-cpmm-pool— o passo a passo sem código do mesmo fluxo.integration-guides/aggregator— se você está roteando CPMM como parte de um caminho multi-hop.

