Esta página foi traduzida automaticamente por IA. A versão em inglês é a fonte oficial.Ver versão em inglês →
Uma entrada de changelog de documentação para uma atualização futura do programa CPMM. Para o índice de todas as atualizações, consulte
reference/changelog. Para a linha do tempo histórica do protocolo, consulte introduction/history-and-milestones.PoolState.pool_creator e fixa ambos os destinos para as contas de token associadas canônicas desse criador. A instrução assinada pelo criador existente permanece inalterada.
Também permite que uma autoridade dedicada crie PDAs de Permission do CPMM. Essa delegação é intencionalmente assimétrica: a autoridade dedicada pode conceder acesso a InitializeWithPermission, enquanto apenas o administrador do programa pode revogar uma concessão com ClosePermissionPda.
TL;DR para integradores
- Nova instrução aditiva:
CollectCreatorFeePermissionless. Qualquer signatário pode ser opayer. O criador do pool registrado não assina. - O chamador não pode redirecionar fundos.
creatordeve ser igual apool_state.pool_creator.creator_token_0ecreator_token_1devem ser as ATAs canônicas desse criador para os mints do vault do pool e seus respectivos programas de token. - O pagador cobre ATAs ausentes. Ambas as contas de destinatário usam
init_if_needed; o pagador financia aluguel quando qualquer conta não existe. - A coleta é tudo ou nada. A instrução transfere ambos os contadores de taxa de criador acumulados completos, zera ambos e atualiza
recent_epoch. Retorna o erroNoFeeCollectexistente quando ambos os contadores são zero. - Integrações existentes permanecem compatíveis.
CollectCreatorFeenão é modificado ou removido. Nenhuma alteração de layoutPoolState,AmmConfig,Permission, evento ou código de erro está presente. - A criação de permissão tem um segundo proprietário.
CreatePermissionPdaaceita o administrador do programa ou um proprietário dedicado de criar-PDA-de-permissão.ClosePermissionPdapermanece apenas para administrador.
Novas contas de instrução
CollectCreatorFeePermissionless leva 14 contas nesta ordem:
Diferentemente de
CollectCreatorFee, o novo layout tem contas payer e creator não-assinante separadas e não leva amm_config. Portanto, requer seu próprio discriminador e construtor.
Impacto do SDK e IDL
O branch de origem do programa não inclui uma atualização de SDK ou IDL confirmada. Os integradores devem atualizar o IDL do CPMM implantado ou usar uma versão de cliente que suporte explicitamenteCollectCreatorFeePermissionless. O conjunto de construtor @raydium-io/raydium-sdk-v2@0.2.42-alpha fixado da documentação cobre apenas o caminho assinado pelo criador original.
Limite de segurança
Invocação sem permissão não significa custódia sem permissão. O chamador pode escolher quando coletar e pode gastar SOL para criar ATAs de criador ausentes. O chamador não pode escolher o beneficiário, substituir contas de token arbitrárias, solicitar um valor parcial ou alterar a configuração de taxa de criador do pool. O novo papel de criador de PDA de permissão pode criar uma concessão para qualquerpermission_authority e paga o aluguel da nova conta. Não pode fechar esse PDA sob essa mudança. Trate-o como uma autoridade de concessão delegada, não como um administrador de permissão completo.
Notas de migração
- Mantenha as transações
CollectCreatorFeeexistentes inalteradas. - Adicione a instrução sem permissão apenas após a implantação do CPMM de destino e o IDL do cliente incluírem-na.
- A automação pode verificar pools com
creator_fees_token_0oucreator_fees_token_1não-zero e disparar a coleta sem custódia de chaves de criador. - Trate
NoFeeCollectcomo uma corrida benigna quando outro chamador drena os contadores primeiro. - Não passe contas de token de destinatário arbitrárias; derive as ATAs de criador de
pool_state.pool_creator, cada mint de vault e o programa de token correspondente.
Páginas atualizadas
products/cpmm/overview— atualização de coleta de taxa de criador e resumo de segurança de destino.products/cpmm/instructions— resumo de nova instrução, lista completa de contas, efeitos e matriz de mudança de estado.products/cpmm/accounts— caminhos de coleta de contador de taxa de criador e criação de PDA de Permissão delegada.products/cpmm/fees— mecânica de coleta sem permissão e fluxo operacional.products/cpmm/code-demos— aviso de disponibilidade do SDK e limite de migração do cliente.products/launchlab/platform-config— esclarecido que o criador do CPMM registrado permanece o beneficiário mesmo quando outro pagador dispara a coleta.protocol-overview/shared-infrastructure— caminhos de coleta com porta de autoridade e restritos por destino.security/admin-and-multisig— autoridade de concessão delegada e limites de coletor sem permissão.reference/program-addresses— endereços de proprietário dedicadoCreatePermissionPdacanônico.reference/error-codes—NoFeeCollectexpandido para cobrir coleta de taxa de criador.
- Branch
raydium-cp-swapfeat/permissionless-collect-creator-fee. - Commits
9585ea1ed99d542, comparados commasterem78f254e.

