Anchor IDL

​

Qué es un IDL

​

Dónde encontrarlos

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

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

​

Regenerar un cliente TypeScript

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

# O con los ayudantes TS de `@anchor-lang/core` en tiempo de ejecución:

import { Program, AnchorProvider } from "@anchor-lang/core";
// Extrae el IDL directamente del repositorio raydium-idl (o inclúyelo en tu proyecto).
import cpmmIdl from "./idls/raydium_cp_swap.json";

const provider = new AnchorProvider(connection, wallet, {});
// Anchor >= 0.30 lee el id del programa desde `idl.address` — estos IDLs son especificación 0.1.0
// y lo llevan. La forma de tres argumentos `new Program(idl, programId, provider)` es
// pre-0.30 y lanza un error.
const program  = new Program(cpmmIdl as any, provider);

// Constructores de métodos tipados generados automáticamente:
await program.methods
  .swapBaseInput(new BN(amountIn), new BN(minAmountOut))
  .accounts({ ... })
  .rpc();

​

Regenerar un cliente Rust (crate de CPI)

# Cargo.toml — la clave de dependencia debe ser el nombre PACKAGE de la 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"] }

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

​

Regenerar un cliente Python

• anchorpy — puerto de Python del cliente TypeScript de Anchor. Genera constructores de métodos tipados a partir de IDLs.
• solders — primitivas de Solana de bajo nivel (transacciones, pares de claves, claves públicas) en enlaces de Rust; se usa debajo de 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 cambios de IDL

1. Los discriminadores de instrucciones nunca cambian. Agregar nuevas instrucciones extiende la enumeración al final; los discriminadores existentes permanecen estables.
2. Los tamaños de cuentas son estables; los nuevos campos salen del relleno reservado. Cada estructura de estado de Raydium lleva una región de relleno final dimensionada en la creación, y un nuevo campo se extrae de ese relleno en lugar de agregarse — por lo que la longitud de bytes de la cuenta y los desplazamientos de todos los campos preexistentes permanecen fijos. El corolario es que los bytes que previamente leías como relleno pueden volverse significativos, y un campo puede retirarse nuevamente al relleno (como PlatformConfig.curve_params fue en la versión 2026-08-31). Relee la definición de estructura después de una actualización; no asumas que el relleno permanece en cero.
3. Los códigos de enumeración de errores son solo de adición. Un código de error existente siempre significa lo mismo.
4. Los cambios disruptivos se envían en nuevos programas. Cuando se necesita un rediseño, el equipo implementa un nuevo ID de programa (por ejemplo, CPMM como un programa nuevo en lugar de actualizar AMM v4). Los pools antiguos continúan ejecutándose en el programa antiguo; los nuevos pools van al nuevo.

​

Qué hacer cuando cambia el IDL

1. Actualiza el SDK. npm update @raydium-io/raydium-sdk-v2.
2. Regenera tu código cliente si usas codegen de Anchor directamente.
3. Compara el esquema de cuenta. Los campos finales del nuevo esquema son lo único que tu código no ha visto; confirma si los necesitas.
4. No asumas que los discriminadores de instrucciones antiguos son inválidos. Según la regla 1, aún funcionan.
5. Vuelve a ejecutar pruebas de integración contra devnet antes de pasar a mainnet.

​

Solución de problemas de IDL

​

Errores “Invalid discriminator”

anchor idl fetch <PROGRAM_ID>

​

Fallos de decodificación de cuenta

​

Instrucciones faltantes en el cliente generado

​

Referencias

• sdk-api/rust-cpi — usando las crates de CPI de Rust.
• sdk-api/python-integration — Python vía anchorpy.
• sdk-api/typescript-sdk — el cliente de TS de nivel superior.

• Repositorio de IDL de Raydium
• Especificación de IDL de Anchor