Anchor IDL

​

O que é um IDL

​

Onde encontrá-los

https://github.com/raydium-io/raydium-idl

anchor idl fetch <PROGRAM_ID> --provider.cluster mainnet

​

Regenerando um cliente TypeScript

# Usando o Anchor CLI
anchor build
anchor idl parse \
  --file target/idl/cpmm.json \
  --out target/types/cpmm.ts

# Ou com os helpers TS `@anchor-lang/core` em tempo de execução:

import { Program, AnchorProvider } from "@anchor-lang/core";
// Puxe o IDL diretamente do repositório raydium-idl (ou coloque-o em seu projeto).
import cpmmIdl from "./idls/raydium_cp_swap.json";

const provider = new AnchorProvider(connection, wallet, {});
// Anchor >= 0.30 lê o id do programa de `idl.address` — esses IDLs são spec 0.1.0
// e o carregam. A forma de três argumentos `new Program(idl, programId, provider)` é
// pré-0.30 e lança erro.
const program  = new Program(cpmmIdl as any, provider);

// Construtores de método tipados gerados automaticamente:
await program.methods
  .swapBaseInput(new BN(amountIn), new BN(minAmountOut))
  .accounts({ ... })
  .rpc();

​

Regenerando um cliente Rust (crate CPI)

# Cargo.toml — a chave de dependência deve ser o nome PACKAGE do crate.
[dependencies]
raydium-cp-swap = { git = "https://github.com/raydium-io/raydium-cp-swap", branch = "chore/upgrade-anchor", features = ["cpi"] }
raydium-clmm    = { git = "https://github.com/raydium-io/raydium-clmm",    branch = "master",              features = ["cpi"] }

# A partir do IDL, usando anchor-client
anchor idl parse \
  --file raydium_cpmm/raydium_cp_swap.json \
  --out src/generated/cpmm_bindings.rs

​

Regenerando um cliente Python

• anchorpy — porta Python do cliente TypeScript do Anchor. Gera construtores de método tipados a partir de IDLs.
• solders — primitivos Solana de baixo nível (transações, keypairs, pubkeys) em bindings Rust; usado sob anchorpy.

pip install anchorpy solders solana

from anchorpy import Program, Provider
from solana.rpc.async_api import AsyncClient
from pathlib import Path
import json

idl = json.loads(Path("cpmm.json").read_text())
provider = Provider(AsyncClient("https://api.mainnet-beta.solana.com"), wallet)
program  = Program(idl, CPMM_PROGRAM_ID, provider)

await program.rpc["swap_base_input"](amount_in, min_amount_out, ctx=Context(accounts={...}))

​

Política de mudanças de IDL

1. Discriminadores de instrução nunca mudam. Adicionar novas instruções estende o enum no final; discriminadores existentes permanecem estáveis.
2. Tamanhos de conta são estáveis; novos campos saem do padding reservado. Cada struct de estado Raydium carrega uma região de padding final dimensionada na criação, e um novo campo é esculpido a partir desse padding em vez de ser anexado — então o comprimento em bytes da conta e os offsets de todos os campos pré-existentes permanecem fixos. O corolário é que bytes que você anteriormente lia como padding podem se tornar significativos, e um campo pode ser aposentado de volta ao padding (como PlatformConfig.curve_params foi na versão de 2026-08-31). Releia a definição da struct após uma atualização; não assuma que o padding permanece zero.
3. Códigos de enum de erro são apenas anexados. Um código de erro existente sempre significa a mesma coisa.
4. Mudanças quebradas são enviadas em novos programas. Quando um redesenho é necessário, a equipe implanta um novo ID de programa (por exemplo, CPMM como um programa novo em vez de atualizar AMM v4). Pools antigos continuam a rodar no programa antigo; novos pools vão para o novo.

​

O que fazer quando o IDL muda

1. Atualize o SDK. npm update @raydium-io/raydium-sdk-v2.
2. Regenere seu código cliente se usar codegen Anchor diretamente.
3. Diferencie o layout da conta. Os campos finais do novo layout são a única coisa que seu código não viu; confirme se você precisa deles.
4. Não assuma que discriminadores de instrução antigos são inválidos. Pela regra 1, eles ainda funcionam.
5. Re-execute testes de integração contra devnet antes de passar para mainnet.

​

Solução de problemas de IDL

​

Erros “Invalid discriminator”

anchor idl fetch <PROGRAM_ID>

​

Falhas de decodificação de conta

​

Instruções ausentes no cliente gerado

​

Referências

• sdk-api/rust-cpi — usando os crates CPI Rust.
• sdk-api/python-integration — Python via anchorpy.
• sdk-api/typescript-sdk — o cliente TS de nível superior.

• Repositório Raydium IDL
• Especificação Anchor IDL