Instruções CPMM

Esta página foi traduzida automaticamente por IA. A versão em inglês é a fonte oficial.Ver versão em inglês →

Esta página é a referência de instrução autoritativa. Para código que realmente compõe essas instruções, veja products/cpmm/code-demos. Para significados de códigos de erro, veja reference/error-codes.A atualização do programa 2026-09 reconstruiu o CPMM no Anchor 1.0.2 / Solana 3.1.10, adicionou a instrução de admin CollectExcessLamports, removeu a whitelist de mint Token-2022 codificada, e alterou o que CreateAmmConfig escreve em protocol_owner / fund_owner. Nenhuma instrução voltada para o usuário alterou suas contas, argumentos ou matemática. Veja a entrada do changelog de 2026-09-09.

Ambas as instruções de coleta de taxa de criador alteraram suas listas de contas em 2026-09-19. CollectCreatorFee ganha creator_fee_share; CollectCreatorFeePermissionless ganha amm_config e creator_fee_share. Ambas são anexadas após system_program, então cada conta que um cliente existente já passa mantém seu índice — mas as novas contas são obrigatórias, então uma transação construída contra o layout antigo fica com contas a menos e é rejeitada com AccountNotEnoughKeys (3005) do Anchor. Duas instruções de admin — CreateCreatorFeeShare e CloseCreatorFeeShare — são adicionadas, e UpdateAmmConfig recebe um novo param = 8. Veja a entrada do changelog de 2026-09-19.

Resumo de instruções

Nome do discriminador	Quem assina	O que faz
`Initialize`	criador do pool	Cria um novo pool CPMM a partir de dois mints e uma `AmmConfig`. Sem permissão; qualquer um pode chamar. Codifica `enable_creator_fee = false` no novo pool. A conta `pool_state` pode ser tanto o PDA canônico quanto uma keypair aleatória fresca (veja contas de Initialize).
`InitializeWithPermission`	pagador + detentor de um PDA `Permission`	Variante com permissão de `Initialize`. O chamador (`payer`) deve possuir um PDA `Permission` derivado de sua própria pubkey. Usado por plataformas que precisam de criação de pool controlada (ex: graduações do LaunchLab). Permite que o chamador fixe `creator_fee_on` (`BothToken` / `OnlyToken0` / `OnlyToken1`) e força `enable_creator_fee = true` no novo pool. O campo `creator` em `pool_state` é definido para uma conta `creator` passada separadamente, não o pagador. Mesma flexibilidade PDA-canônico-ou-keypair-aleatória para `pool_state` como em `Initialize`.
`Deposit`	LP	Adiciona liquidez em ambos os tokens; recebe tokens LP.
`Withdraw`	LP	Queima tokens LP; recebe ambos os tokens subjacentes pro-rata.
`SwapBaseInput`	swapper	Swap de entrada exata (`amount_in` dentro, ≥ `minimum_amount_out` fora).
`SwapBaseOutput`	swapper	Swap de saída exata (≤ `maximum_amount_in` dentro, `amount_out` fora).
`CollectProtocolFee`	`protocol_owner` (de `AmmConfig`)	Coleta taxas de protocolo acumuladas dos vaults.
`CollectFundFee`	`fund_owner` (de `AmmConfig`)	Coleta taxas de fundo acumuladas dos vaults.
`CollectCreatorFee`	`pool_creator`	Coleta taxas de criador acumuladas (se taxa de criador foi habilitada), líquida da participação do protocolo, que é registrada no bucket de protocolo do pool.
`CollectCreatorFeePermissionless`	qualquer pagador	Coleta taxas de criador acumuladas para as contas de token canônicas do `pool_creator`, líquida da mesma participação de protocolo. O pagador pode criar ATAs de destinatário ausentes, mas não pode redirecionar a transferência.
`UpdatePoolStatus`	`admin`	Pausa / retoma operações específicas em um pool via bitmask.
`UpdateAmmConfig`	`admin`	Altera taxas de taxa ou o proprietário de protocolo/fundo em uma `AmmConfig`.
`CreateAmmConfig`	`admin`	Cria um novo nível de taxa (nova conta `AmmConfig`).
`CreatePermissionPda`	`admin` ou criador de PDA de permissão delegado	Cria um PDA `Permission` que permite que uma autoridade específica chame `InitializeWithPermission`.
`ClosePermissionPda`	`admin` ou o criador dedicado de PDA de permissão	Revoga um PDA `Permission` emitido anteriormente. Desde a atualização 2026-09, a autoridade criadora dedicada também pode fechar uma concessão que emitiu; era apenas admin antes.
`CreateSupportMintAssociated`	`admin` ou o proprietário dedicado de mint de suporte	Registra um mint Token-2022 que falharia na lista de permissões de extensão, criando seu PDA `SupportMintAssociated`.
`CloseSupportMintAssociated`	`admin` ou o proprietário dedicado de mint de suporte	Remove o registro de um mint.
`CollectExcessLamports`	`admin` ou a carteira dedicada de coleta de lamports	Coleta lamports acima do mínimo isento de aluguel dos vaults controlados por CPMM, mints LP e PDAs. Adicionado em 2026-09.
`CreateCreatorFeeShare`	`admin` ou o proprietário dedicado de compartilhamento de taxa de criador	Define uma participação de protocolo personalizada da taxa de criador para um par `(creator, amm_config)`, substituindo `AmmConfig.creator_fee_share_rate`. Adicionado em 2026-09-19.
`CloseCreatorFeeShare`	`admin` ou o proprietário dedicado de compartilhamento de taxa de criador	Remove essa substituição; o par volta ao padrão da config. Adicionado em 2026-09-19.

Bitmask de status: o status de cada pool é um u8 onde bit 0 = depósito desabilitado, bit 1 = saque desabilitado, bit 2 = swap desabilitado (PoolStatusBitIndex { Deposit, Withdraw, Swap } no programa). Um bit claro significa que a operação é permitida; um bit definido significa que está pausada. UpdatePoolStatus recebe um u8 bruto e sobrescreve o valor existente. As próximas seções passam por cada uma em detalhes. A ordenação de contas segue o IDL do CPMM; o SDK e o cliente Rust em raydium-cp-swap/programs/cp-swap/src/instructions correspondem a essa ordem.

`Initialize`

Cria um novo pool CPMM. Argumentos

init_amount_0: u64
init_amount_1: u64
open_time:     u64   // Unix timestamp; swaps rejeitados antes disso

Contas (W = gravável, S = assinante)

#	Nome	W	S	Notas
1	`creator`	W	S	Paga aluguel; registrado como `pool_state.pool_creator`.
2	`amm_config`			O nível de taxa escolhido.
3	`authority`			PDA de autoridade global CPMM.
4	`pool_state`	W	S*	`init`ializado aqui. Ou o PDA canônico `["pool", amm_config, token_0_mint, token_1_mint]` ou uma keypair aleatória fresca — quando não é o PDA canônico, o programa requer que `pool_state` assine (`require_eq!(pool_account_info.is_signer, true)`). O caminho de keypair aleatória permite que um criador evite tentativas de front-running no PDA canônico. Os PDAs downstream (`lp_mint`, `vaults`, `observation_state`) são derivados de `pool_state.key()` de qualquer forma.
5	`token_0_mint`			Ordenado: `token_0_mint < token_1_mint`.
6	`token_1_mint`
7	`lp_mint`	W		`init`ializado aqui. Autoridade definida como `authority`.
8	`creator_token_0`	W		ATA de origem para `init_amount_0`.
9	`creator_token_1`	W		ATA de origem para `init_amount_1`.
10	`creator_lp_token`	W		ATA do criador em `lp_mint`. `init` (não `init_if_needed`) — não deve existir já, o que não pode, já que `lp_mint` é criado nesta mesma instrução.
11	`token_0_vault`	W		`init`ializado aqui. Possuído por `authority`.
12	`token_1_vault`	W
13	`create_pool_fee`	W		ATA de destino para a `create_pool_fee` paga pelo criador.
14	`observation_state`	W		`init`ializado aqui.
15	`token_program`			SPL Token (para mint LP).
16	`token_0_program`			SPL Token ou Token-2022.
17	`token_1_program`			SPL Token ou Token-2022.
18	`associated_token_program`
19	`system_program`
20	`rent`

* pool_state assina apenas no caminho de keypair aleatória; o caminho PDA canônico executa sem pool_state assinando. Pré-condições

Mints são ordenados (token_0_mint < token_1_mint por ordem de byte).
Nenhum mint usa uma extensão fora da lista de permissões CPMM (TransferFeeConfig, MetadataPointer, TokenMetadata, InterestBearingConfig, ScaledUiAmount) — veja products/cpmm/accounts. Um mint cuja PDA SupportMintAssociated (seed [b"support_mint", mint]) existe pula a verificação de extensão — mas você deve anexar esse PDA a remaining_accounts. O programa apenas verifica as contas que você passa e nunca carrega o PDA em si, então confiar no registro sem fornecer a conta ainda falha com NotSupportMint (6007). A ordem não importa (correspondência é por chave); passe uma entrada por mint que precisa do bypass. Esse registro é o único bypass desde que a atualização 2026-09 removeu a whitelist de quatro mints codificada.
creator tem pelo menos init_amount_0 e init_amount_1 nos respectivos ATAs.
amm_config.disable_create_pool == false.

Pós-condições

pool_state.lp_supply = sqrt(init_amount_0 * init_amount_1) — a raiz quadrada completa. O criador é cunhado com lp_supply − 100; as 100 unidades base bloqueadas são contadas em lp_supply mas nunca cunhadas.
Então lp_mint.supply == pool_state.lp_supply − 100 pela vida do pool. Toda matemática de compartilhamento LP (depósito, saque) divide por lp_supply, então use esse campo e não substitua o fornecimento on-chain do mint. Reverte com InitLpAmountTooLess se sqrt(...) < 100.
observation_state é inicializado; observation_index = 0 e pool_id = pool_state.key().
Lamports de create_pool_fee são transferidos do criador para o receptor e sincronizados como SOL nativo (é um ATA wSOL).
O bitmask de status do pool é 0 (depósito / saque / swap todos habilitados).
enable_creator_fee = false e creator_fee_on = BothToken. Initialize não suporta habilitar a taxa de criador — esse caminho é InitializeWithPermission.
open_time é aumentado para block_timestamp + 1 se o chamador passou um valor <= block_timestamp. Swaps são rejeitados antes de open_time; depósitos e saques funcionam imediatamente.

Erros comuns (lista completa em reference/error-codes)

InvalidInput — mints desordenados ou mints idênticos.
NotSupportMint — extensão Token-2022 bloqueada.
ExceededSlippage — raramente; se init_amount_0/1 resultarem em zero LP devido a incompatibilidade de decimais.

`Deposit`

Adiciona liquidez em ambos os tokens proporcionais ao pool. Argumentos

lp_token_amount:   u64   // quantos tokens LP cunhar para o LP
maximum_token_0:   u64
maximum_token_1:   u64

Contas

#	Nome	W	S
1	`owner`		S
2	`authority`
3	`pool_state`	W
4	`owner_lp_token`	W
5	`token_0_account`	W
6	`token_1_account`	W
7	`token_0_vault`	W
8	`token_1_vault`	W
9	`token_program`
10	`token_program_2022`
11	`vault_0_mint`
12	`vault_1_mint`
13	`lp_mint`	W

Matemática

total_0 = vault_0 − protocol_fees_0 − fund_fees_0 − creator_fees_0    // mesmo para lado 1

needed_token_0 = ceil(lp_token_amount * total_0 / lp_supply)
transfer_0     = needed_token_0 + inverse_transfer_fee(needed_token_0) // Token-2022
require(transfer_0 <= maximum_token_0, "ExceededSlippage")             // mesmo para lado 1

Dois detalhes que valem a pena fixar: a base pro-rata é o total do vault excluindo taxas (vault_amount_without_fee, ou seja, o saldo bruto menos os contadores acumulados de protocolo, fundo e criador), não o saldo bruto do vault; e o limite de slippage é verificado contra o que o pagador realmente transfere, após a taxa de transferência Token-2022 ser adicionada, não contra o movimento bruto do vault. Nenhuma mudança na proporcionalidade de k — ambos os totais e lp_supply escalam pelo mesmo fator. Pós-condições

lp_supply += lp_token_amount.
vault_0 += needed_token_0 (líquido de qualquer taxa de transferência Token-2022 na entrada).
vault_1 += needed_token_1 (líquido de qualquer taxa de transferência Token-2022 na entrada).

Erros comuns — ExceededSlippage, ZeroTradingTokens, InvalidStatus se depósito está pausado.

`Withdraw`

Queima tokens LP e recebe ambos os tokens subjacentes pro-rata. Argumentos

lp_token_amount:   u64
minimum_token_0:   u64
minimum_token_1:   u64

Contas

#	Nome	W	S
1	`owner`		S
2	`authority`
3	`pool_state`	W
4	`owner_lp_token`	W
5	`token_0_account`	W
6	`token_1_account`	W
7	`token_0_vault`	W
8	`token_1_vault`	W
9	`token_program`
10	`token_program_2022`
11	`vault_0_mint`
12	`vault_1_mint`
13	`lp_mint`	W
14	`memo_program`

As primeiras 13 contas são idênticas a Deposit, e lp_mint é gravável porque os tokens LP são queimados. Withdraw adicionalmente recebe uma 14ª conta, memo_program (restrita address = memo::ID) — Deposit não. Um Withdraw de 13 contas falha na desserialização do Anchor, então o LP não pode sair. Matemática

total_0 = vault_0 − protocol_fees_0 − fund_fees_0 − creator_fees_0    // mesmo para lado 1

out_token_0     = min(total_0, floor(lp_token_amount * total_0 / lp_supply))
receive_token_0 = out_token_0 − transfer_fee(out_token_0)             // Token-2022
require(receive_token_0 >= minimum_token_0, "ExceededSlippage")       // mesmo para lado 1

// Como com Deposit: a base é o total do vault excluindo taxas, e o piso é
// verificado contra o que o LP realmente recebe, após a taxa de transferência.

Pós-condições

lp_supply -= lp_token_amount.
Vaults enviam out_token_0 / out_token_1 (bruto; o usuário recebe líquido de qualquer taxa de transferência Token-2022).

`SwapBaseInput`

Swap de entrada exata. Argumentos

amount_in:            u64
minimum_amount_out:   u64

Contas

#	Nome	W	S
1	`payer`		S
2	`authority`
3	`amm_config`
4	`pool_state`	W
5	`input_token_account`	W
6	`output_token_account`	W
7	`input_vault`	W
8	`output_vault`	W
9	`input_token_program`
10	`output_token_program`
11	`input_token_mint`
12	`output_token_mint`
13	`observation_state`	W

A ordenação entrada → saída é pela direção do usuário, não pelo token_0 / token_1 canônico do pool. O programa descobre qual vault é qual combinando mints. Matemática — veja products/cpmm/math. Pré-condições

open_time <= now.
pool_status permite swap.
Nenhum mint pausado ou congelado para essa autoridade.
amount_in > 0.

Erros comuns

ExceededSlippage — amount_out < minimum_amount_out.
ZeroTradingTokens — o trade arredonda para zero.
NotApproved — pool está pausado para swaps via UpdatePoolStatus.
InvalidInput — mints não correspondem a nenhum dos mints do vault do pool.

`SwapBaseOutput`

Swap de saída exata. Argumentos

max_amount_in:  u64
amount_out:     u64

Contas — mesmas que SwapBaseInput. Matemática — curva inversa com teto, veja products/cpmm/math. Erros comuns — ExceededSlippage (gross_in > max_amount_in), ZeroTradingTokens, InvalidInput, NotApproved.

`CollectProtocolFee`

Coleta taxas de protocolo acumuladas dos vaults para o destino do protocolo. Argumentos — nenhum. Contas

#	Nome	W	S	Notas
1	`owner`		S	Deve ser igual a `amm_config.protocol_owner` ou a chave de admin codificada do programa.
2	`authority`
3	`pool_state`	W
4	`amm_config`
5	`token_0_vault`	W
6	`token_1_vault`	W
7	`vault_0_mint`
8	`vault_1_mint`
9	`recipient_token_0_account`	W
10	`recipient_token_1_account`	W
11	`token_program`
12	`token_program_2022`

Efeito

transfer pool_state.protocol_fees_token0 from vault_0 to recipient_0
transfer pool_state.protocol_fees_token1 from vault_1 to recipient_1
pool_state.protocol_fees_token0 = 0
pool_state.protocol_fees_token1 = 0

Nenhuma mudança nos saldos efetivos da curva (taxas acumuladas já foram excluídas). Erro comum — InvalidOwner (6001) se o assinante não é nem amm_config.protocol_owner nem o admin do programa. (Não há NotApproved nesse caminho.)

`CollectFundFee`

Mesma forma que CollectProtocolFee mas assinado por amm_config.fund_owner — ou, novamente, o admin do programa — e zerando os contadores fund_fees_*. Mesmo InvalidOwner em um assinante errado.

`CollectCreatorFee`

Assinado por pool_state.pool_creator. Ele liquida a taxa de criador acumulada e transfere a parte do criador para as contas de token do criador. Argumentos — nenhum. Contas

#	Nome	W	S	Notas
1	`creator`	W	S	Restrito `address = pool_state.pool_creator`.
2	`authority`			PDA de autoridade global de vault CPMM.
3	`pool_state`	W		Mantém os contadores de taxa de criador acumulados.
4	`amm_config`			Restrito `address = pool_state.amm_config`. Carrega o `creator_fee_share_rate` padrão.
5	`token_0_vault`	W		Deve corresponder ao vault de token 0 do pool.
6	`token_1_vault`	W		Deve corresponder ao vault de token 1 do pool.
7	`vault_0_mint`			Deve corresponder a `token_0_vault.mint`.
8	`vault_1_mint`			Deve corresponder a `token_1_vault.mint`.
9	`creator_token_0`	W		Destino para a parte do criador do token 0.
10	`creator_token_1`	W		Destino para a parte do criador do token 1.
11	`token_0_program`			SPL Token ou Token-2022, correspondendo ao token 0.
12	`token_1_program`			SPL Token ou Token-2022, correspondendo ao token 1.
13	`associated_token_program`
14	`system_program`
15	`creator_fee_share`			Adicionado em 2026-09-19, anexado após `system_program`. PDA em `["creator_fee_share", creator, amm_config]`. Deve ser passado em cada chamada, mas não é obrigatório existir — quando está vazio ou não é possuído por CPMM, o programa volta para `amm_config.creator_fee_share_rate`. A restrição de seed ainda se aplica, então o endereço deve ser o PDA canônico.

Efeito

share_rate = creator_fee_share.share_rate   (se a conta existe)
           | amm_config.creator_fee_share_rate   (caso contrário)

shared_i  = floor(creator_fees_token_i * share_rate / 1_000_000)
creator_i = creator_fees_token_i - shared_i

transfer creator_i from vault_i to creator_token_i
pool_state.protocol_fees_token_i += shared_i     // fica no vault
pool_state.creator_fees_token_i   = 0
pool_state.recent_epoch = current epoch

A participação do protocolo nunca sai do vault aqui — é re-rotulada como uma taxa de protocolo e aguarda CollectProtocolFee. Ambos os contadores já foram excluídos da visão da curva do vault, então o preço do pool não se move. Derivação completa em products/cpmm/fees. Erros comuns — NoFeeCollect quando ambos os contadores de criador são zero (verificado antes da divisão), InvalidInput (6003) se o share_rate resolvido excede 1_000_000, MathOverflow (6011) se registrar a participação causaria overflow em protocol_fees_token_*, e erro ConstraintSeeds do Anchor se creator_fee_share não é o PDA canônico.

`CollectCreatorFeePermissionless`

Qualquer um pode disparar a coleta de taxa de criador. A instrução sempre envia a parte do criador para as contas de token associadas canônicas possuídas por pool_state.pool_creator; o chamador não pode escolher outro criador ou destino. Se qualquer ATA estiver faltando, o pagador financia sua criação. O CollectCreatorFee original permanece chamável, então um criador que quer assinar sua própria coleta ainda pode. Argumentos — nenhum. Contas

#	Nome	W	S	Notas
1	`payer`	W	S	Qualquer assinante; financia ATAs de criador ausentes.
2	`creator`			Deve ser igual a `pool_state.pool_creator`; não assina.
3	`authority`			PDA de autoridade global de vault CPMM.
4	`pool_state`	W		Mantém os contadores de taxa de criador acumulados.
5	`token_0_vault`	W		Deve corresponder ao vault de token 0 do pool.
6	`token_1_vault`	W		Deve corresponder ao vault de token 1 do pool.
7	`vault_0_mint`			Deve corresponder a `token_0_vault.mint`.
8	`vault_1_mint`			Deve corresponder a `token_1_vault.mint`.
9	`creator_token_0`	W		ATA canônica do criador para `vault_0_mint`; criada se faltando.
10	`creator_token_1`	W		ATA canônica do criador para `vault_1_mint`; criada se faltando.
11	`token_0_program`			SPL Token ou Token-2022, correspondendo ao token 0.
12	`token_1_program`			SPL Token ou Token-2022, correspondendo ao token 1.
13	`associated_token_program`			Cria um ATA de destinatário faltando.
14	`system_program`			Financia criação de conta a partir de `payer`.
15	`amm_config`			Adicionado em 2026-09-19, anexado após `system_program`. Restrito `address = pool_state.amm_config`.
16	`creator_fee_share`			Adicionado em 2026-09-19, anexado por último. Mesmo PDA e mesma regra de existência opcional que em `CollectCreatorFee`.

As duas novas contas são anexadas após system_program, não inseridas. Cada conta de payer até system_program mantém a posição que tinha antes da atualização, então a quebra é limpa: uma transação construída contra o layout de quatorze contas anterior à atualização não malinterpreta um vault como um config — ela simplesmente passa contas de menos e o Anchor a rejeita com AccountNotEnoughKeys (3005) antes de qualquer restrição ser executada. As contas continuam obrigatórias, então anexe ambas e atualize o IDL; não há caminho de compatibilidade para o layout antigo.

Efeito — idêntico a CollectCreatorFee acima: a participação é resolvida de creator_fee_share ou amm_config, a parte do protocolo é registrada em protocol_fees_token_{0,1}, a parte do criador é transferida para os ATAs do criador, ambos os contadores de criador são zerados, e recent_epoch é atualizado. Retorna NoFeeCollect quando ambos os contadores são zero.

`UpdatePoolStatus`

Pausa ou retoma operações individuais em um pool. O campo status é um bitmask:

Bit	Flag	Efeito quando definido
0	`DEPOSIT_DISABLED`	`Deposit` rejeita com `NotApproved`.
1	`WITHDRAW_DISABLED`	`Withdraw` rejeita.
2	`SWAP_DISABLED`	`SwapBaseInput` / `SwapBaseOutput` rejeitam.

Argumentos

status: u8      // novo bitmask

Contas

#	Nome	W	S	Notas
1	`authority`		S	Deve corresponder à chave de admin no programa CPMM.
2	`pool_state`	W

A chave de admin é uma pubkey compilada no programa (crate::admin::ID), não a autoridade de upgrade BPF — alterá-la requer uma atualização de programa. Veja reference/program-addresses para o valor e security/admin-and-multisig para quem a mantém.

`CreateAmmConfig`

Cria um novo nível de taxa. Argumentos

index:             u16
trade_fee_rate:    u64
protocol_fee_rate: u64
fund_fee_rate:     u64
create_pool_fee:   u64
creator_fee_rate:  u64

Contas

#	Nome	W	S	Notas
1	`owner`	W	S	Admin.
2	`amm_config`	W		`init`ializado aqui.
3	`system_program`

Pré-condições

Nenhuma AmmConfig existente com o mesmo index.
protocol_fee_rate + fund_fee_rate <= FEE_RATE_DENOMINATOR_VALUE.

Alterado em 2026-09: os proprietários de taxa da nova config não vêm mais do assinante. create_amm_config agora escreve o protocol_fee_owner::ID codificado do programa em protocol_owner e fund_fee_owner::ID em fund_owner, em vez de copiar a chave do assinante de admin em ambos. Os endereços estão em reference/program-addresses.Consequências: taxas em uma AmmConfig recém-criada vão para as carteiras de taxa dedicadas em vez da do admin. O admin permanece um assinante aceito para coleta — CollectProtocolFee / CollectFundFee aceitam amm_config.protocol_owner / fund_owner ou crate::admin::ID — então nada tem que ser rotacionado para varrer; o que mudou é apenas para onde os rendimentos vão por padrão. Contas AmmConfig existentes não são reescritas — o que quer que esteja armazenado nelas ainda governa, então sempre leia protocol_owner / fund_owner da conta em vez de assumir qualquer valor. Os parâmetros 3 e 4 de UpdateAmmConfig ainda os rotacionam.

`UpdateAmmConfig`

Altera taxas ou propriedade em uma AmmConfig existente. Recebe um param: u8 (qual campo atualizar) e um value: u64. A tabela de despacho completa:

param = 0 → trade_fee_rate (afirma trade_fee_rate + creator_fee_rate < 1_000_000)
param = 1 → protocol_fee_rate (afirma ≤ 1_000_000 e + fund_fee_rate ≤ 1_000_000)
param = 2 → fund_fee_rate (afirma ≤ 1_000_000 e + protocol_fee_rate ≤ 1_000_000)
param = 3 → protocol_owner. A nova chave não está em value: anexe-a como remaining_accounts[0] (somente leitura é ok). Não deve ser a pubkey padrão, e omitir a conta entra em pânico em um unwrap().
param = 4 → fund_owner. Mesmo mecanismo que 3.
param = 5 → create_pool_fee
param = 6 → disable_create_pool (qualquer value não-zero desabilita)
param = 7 → creator_fee_rate (afirma creator_fee_rate + trade_fee_rate < 1_000_000)
param = 8 → creator_fee_share_rate (afirma ≤ 1_000_000). Adicionado em 2026-09-19. A participação padrão do protocolo da taxa de criador nesse nível; veja products/cpmm/fees. Não está relacionado a protocol_fee_rate, que divide a taxa de trade.

Qualquer outro param retorna InvalidInput. As mudanças são assinadas pelo admin e afetam cada pool vinculado a essa AmmConfig no próximo swap. Sem migração; pools simplesmente leem os novos valores.

`CreateCreatorFeeShare`

Define uma participação de protocolo personalizada da taxa de criador para um par (creator, amm_config), substituindo AmmConfig.creator_fee_share_rate para cada pool que esse criador possui nesse nível de taxa. Adicionado na atualização de compartilhamento de taxa de criador 2026-09-19. Argumentos

share_rate: u64   // participação do protocolo DA taxa de criador, sobre FEE_RATE_DENOMINATOR = 1_000_000

Contas

#	Nome	W	S	Notas
1	`owner`	W	S	Deve ser o admin do programa CPMM ou o proprietário dedicado de compartilhamento de taxa de criador — veja `reference/program-addresses`. Qualquer outro assinante falha com `InvalidOwner` (`6001`). Paga aluguel.
2	`creator`			O criador do pool ao qual a taxa se aplica. Não verificado — não precisa ser um criador de pool existente, e não assina.
3	`amm_config`			O nível de taxa ao qual a taxa se aplica.
4	`creator_fee_share`	W		`init`ializado aqui em `["creator_fee_share", creator, amm_config]`, `space = 145`.
5	`system_program`

Pré-condições

share_rate <= 1_000_000, caso contrário InvalidInput (6003).
O PDA não deve existir já — o init do Anchor falha em uma segunda chamada para o mesmo par. Para alterar uma taxa, feche a conta e crie-a novamente.

Pós-condições

creator_fee_share armazena bump, creator, amm_config e share_rate.
Cada CollectCreatorFee / CollectCreatorFeePermissionless subsequente em um pool criado por creator sob amm_config resolve a participação dessa conta em vez da config.

O criador do pool não é parte dessa instrução e não a assina. A taxa é lida no momento da coleta, então uma substituição criada após as taxas já terem acumulado se aplica a esse saldo acumulado também.

`CloseCreatorFeeShare`

Remove a substituição. O par volta para AmmConfig.creator_fee_share_rate. Argumentos — nenhum. Contas

#	Nome	W	S	Notas
1	`owner`	W	S	Mesmos dois assinantes aceitos que `CreateCreatorFeeShare`; recebe o aluguel.
2	`creator`			O criador do pool ao qual a taxa se aplicava.
3	`amm_config`			O nível de taxa ao qual a taxa se aplicava.
4	`creator_fee_share`	W		Fechado para `owner`. Deve ser o PDA canônico para o par.
5	`system_program`

Pós-condições

A conta é fechada e seus lamports vão para owner.
Coletas para esse par resolvem a participação de amm_config.creator_fee_share_rate novamente — que é 0 a menos que um admin tenha definido o parâmetro 8 de UpdateAmmConfig.

`CollectExcessLamports`

Varredura de admin de lamports sentados acima do mínimo isento de aluguel em contas que CPMM controla. Adicionado na atualização 2026-09 para que o protocolo possa recuperar o sobre-financiamento que a redução de aluguel SIMD-0437 deixa para trás em contas criadas antes de cada passo. Apenas o excesso se move. Saldos de token, dados de conta, proprietários, estado do pool e a curva não são tocados, e a instrução é um no-op contra uma conta já em seu mínimo — então é seguro re-executar após cada passo de rollout. Argumentos — nenhum. Contas

#	Nome	W	S	Notas
1	`collect_lamports_wallet`	W	S	Destino para cada lamport varrido. Deve ser o admin do programa CPMM ou a carteira dedicada de coleta de lamports — veja `reference/program-addresses`. Qualquer outro assinante falha com `InvalidOwner`.
2	`authority`			O PDA de autoridade de vault-e-mint-LP CPMM em seed `[b"vault_and_lp_mint_auth_seed"]`. Assina os CPIs do programa de token.
3	`token_program`			SPL Token.
4	`token_program_2022`			Token-2022. Ambos são obrigatórios incondicionalmente; o programa escolhe por conta de origem.
5..	`remaining_accounts`	W		`M` contas de origem para varrer, qualquer número, qualquer ordem.

Correção de ordenação, 2026-09-19. O programa agora faz duas passagens sobre remaining_accounts — cada CPI do programa de token primeiro, depois os débitos diretos de PDAs de propriedade de CPMM. Intercalá-los abortava com o UnbalancedInstruction do runtime (“soma dos saldos de conta antes e depois da instrução não correspondem”) sempre que um PDA era debitado antes de um CPI, porque as mudanças de lamport pendentes do chamador são apenas liberadas em contas que um CPI realmente carrega. Chamadores não têm que agrupar ou ordenar a lista eles mesmos.

Como cada conta de origem é tratada O programa despacha no owner da conta de origem:

Proprietário da conta de origem	Tratamento
SPL Token ou Token-2022, conta de token não-nativa ou mint — vaults de pool e mints LP	CPI `WithdrawExcessLamports` (discriminante do programa de token `38`), assinado por `authority`.
SPL Token ou Token-2022, conta de token nativa (wSOL)	`WithdrawExcessLamports` rejeita contas nativas. O programa CPIs `SyncNative`, mede quanto o `amount` envolvido cresceu, `UnwrapLamports` (discriminante `45`) para exatamente esse delta, então requer que o saldo envolvido seja igual ao seu valor pré-sync — caso contrário `LamportsCalculateError` (`6015`). Um vault de pool do lado SOL portanto mantém sua liquidez completa.
O próprio programa CPMM — `PoolState`, `AmmConfig`, `ObservationState`, `Permission`, `SupportMintAssociated`	O programa debita a conta diretamente para `rent.minimum_balance(data_len)`.
Qualquer outra coisa	Pulado silenciosamente. Sem erro, sem lamports movidos.

Porque recebe uma lista remaining_accounts ilimitada, o tamanho da transação é o limite real — a mesma restrição que a varredura do lado da carteira descrita em solana-fundamentals/rent-and-reclaimable-rent. Erros comuns — InvalidOwner (6001, assinante errado), LamportsCalculateError (6015, a volta redonda wSOL não resultou em zero), e InsufficientFunds do caminho de propriedade do programa quando uma conta mantém menos que seu próprio mínimo de aluguel. Sem builder SDK. @raydium-io/raydium-sdk-v2 não envia um builder para essa instrução, e nem o repo raydium-sdk-V2-demo — é um caminho de admin. Codifique-a à mão, da forma que a varredura do lado da carteira em solana-fundamentals/rent-and-reclaimable-rent faz para a instrução do programa de token.

Matriz de mudança de estado

Instrução	`lp_supply`	Saldos de vault	Campos de taxa acumulada	`observation`
`Initialize`	+ init LP	+ `init_amount_{0,1}`	0	init
`InitializeWithPermission`	+ init LP	+ `init_amount_{0,1}`	0	init
`Deposit`	+	+ ambos	—	—
`Withdraw`	−	− ambos	—	—
`SwapBaseInput`	—	+ entrada, − saída	+ `trade_fee` dividido em protocolo/fundo; + `creator_fee` se habilitado	+ (se intervalo decorrido)
`SwapBaseOutput`	—	+ entrada, − saída	+ `trade_fee` dividido em protocolo/fundo; + `creator_fee` se habilitado	+ (se intervalo decorrido)
`CollectProtocolFee`	—	− (por buckets de protocolo)	`protocol_*` → 0	—
`CollectFundFee`	—	− (por buckets de fundo)	`fund_*` → 0	—
`CollectCreatorFee`	—	− (apenas pela parte do criador)	`creator_` → 0; `protocol_` += a parte compartilhada	—
`CollectCreatorFeePermissionless`	—	− (apenas pela parte do criador)	`creator_` → 0; `protocol_` += a parte compartilhada	—
`UpdatePoolStatus`	—	—	—	—
`CreateCreatorFeeShare`	—	—	—	—
`CloseCreatorFeeShare`	—	—	—	—
`CollectExcessLamports`	—	— (saldos de token inalterados)	—	—

Para onde ir a seguir

products/cpmm/code-demos — amostras TypeScript executáveis para o acima.
reference/error-codes — a tabela de erro Anchor completa.
products/cpmm/fees — o modelo de acúmulo de taxa que as instruções Collect*Fee drenam.

Fontes:

Products

Algorithms

Resumo de instruções

`Initialize`

`Deposit`

`Withdraw`

`SwapBaseInput`

`SwapBaseOutput`

`CollectProtocolFee`

`CollectFundFee`

`CollectCreatorFee`

`CollectCreatorFeePermissionless`

`UpdatePoolStatus`

`CreateAmmConfig`

`UpdateAmmConfig`

`CreateCreatorFeeShare`

`CloseCreatorFeeShare`

`CollectExcessLamports`

Matriz de mudança de estado

Para onde ir a seguir

​Resumo de instruções

​Initialize

​Deposit

​Withdraw

​SwapBaseInput

​SwapBaseOutput

​CollectProtocolFee

​CollectFundFee

​CollectCreatorFee

​CollectCreatorFeePermissionless

​UpdatePoolStatus

​CreateAmmConfig

​UpdateAmmConfig

​CreateCreatorFeeShare

​CloseCreatorFeeShare

​CollectExcessLamports

​Matriz de mudança de estado

​Para onde ir a seguir

Resumo de instruções

`Initialize`

`Deposit`

`Withdraw`

`SwapBaseInput`

`SwapBaseOutput`

`CollectProtocolFee`

`CollectFundFee`

`CollectCreatorFee`

`CollectCreatorFeePermissionless`

`UpdatePoolStatus`

`CreateAmmConfig`

`UpdateAmmConfig`

`CreateCreatorFeeShare`

`CloseCreatorFeeShare`

`CollectExcessLamports`

Matriz de mudança de estado

Para onde ir a seguir