Anchor IDL

​

Qu’est-ce qu’un IDL

​

Où les trouver

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

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

​

Régénérer un client TypeScript

# Utilisant l'Anchor CLI
anchor build
anchor idl parse \
  --file target/idl/cpmm.json \
  --out target/types/cpmm.ts

# Ou avec les assistants TS `@anchor-lang/core` à l'exécution :

import { Program, AnchorProvider } from "@anchor-lang/core";
// Tirez l'IDL directement du dépôt raydium-idl (ou vendorisez-le dans votre projet).
import cpmmIdl from "./idls/raydium_cp_swap.json";

const provider = new AnchorProvider(connection, wallet, {});
// Anchor >= 0.30 lit l'ID du programme à partir de `idl.address` — ces IDLs sont spec 0.1.0
// et le portent. La forme à trois arguments `new Program(idl, programId, provider)` est
// pré-0.30 et lève une exception.
const program  = new Program(cpmmIdl as any, provider);

// Les constructeurs de méthodes typés sont auto-générés :
await program.methods
  .swapBaseInput(new BN(amountIn), new BN(minAmountOut))
  .accounts({ ... })
  .rpc();

​

Régénérer un client Rust (crate CPI)

# Cargo.toml — la clé de dépendance doit être le nom 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"] }

# À partir de l'IDL, utilisant anchor-client
anchor idl parse \
  --file raydium_cpmm/raydium_cp_swap.json \
  --out src/generated/cpmm_bindings.rs

​

Régénérer un client Python

• anchorpy — port Python du client TypeScript d’Anchor. Génère des constructeurs de méthodes typés à partir d’IDLs.
• solders — primitives Solana de bas niveau (transactions, paires de clés, clés publiques) dans les liaisons Rust ; utilisé sous 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={...}))

​

Politique de changement d’IDL

1. Les discriminateurs d’instruction ne changent jamais. L’ajout de nouvelles instructions étend l’énumération à la fin ; les discriminateurs existants restent stables.
2. Les tailles de compte sont stables ; les nouveaux champs sortent du remplissage réservé. Chaque structure d’état Raydium porte une région de remplissage finale dimensionnée à la création, et un nouveau champ est extrait de ce remplissage plutôt qu’ajouté — donc la longueur en octets du compte et les décalages de tous les champs pré-existants restent fixes. Le corollaire est que les octets que vous lisiez précédemment comme remplissage peuvent devenir significatifs, et un champ peut être retiré dans le remplissage (comme PlatformConfig.curve_params l’a été dans la version du 2026-08-31). Relisez la définition de la structure après une mise à niveau ; ne supposez pas que le remplissage reste zéro.
3. Les codes d’énumération d’erreur sont append-only. Un code d’erreur existant signifie toujours la même chose.
4. Les changements de rupture sont livrés dans de nouveaux programmes. Quand une refonte est nécessaire, l’équipe déploie un nouvel ID de programme (par exemple CPMM comme un programme frais plutôt que de mettre à niveau AMM v4). Les anciens pools continuent à fonctionner sur l’ancien programme ; les nouveaux pools vont au nouveau.

​

Que faire quand l’IDL change

1. Mettez à jour le SDK. npm update @raydium-io/raydium-sdk-v2.
2. Régénérez votre code client si vous utilisez la génération de code Anchor directement.
3. Comparez la disposition du compte. Les champs de fin de la nouvelle disposition sont la seule chose que votre code n’a pas vue ; confirmez si vous en avez besoin.
4. Ne supposez pas que les anciens discriminateurs d’instruction sont invalides. Selon la règle 1, ils fonctionnent toujours.
5. Réexécutez les tests d’intégration contre devnet avant de passer au mainnet.

​

Dépannage d’IDL

​

Erreurs « Invalid discriminator »

anchor idl fetch <PROGRAM_ID>

​

Échecs de décodage de compte

​

Instructions manquantes dans le client généré

​

Pointeurs

• sdk-api/rust-cpi — utilisation des crates CPI Rust.
• sdk-api/python-integration — Python via anchorpy.
• sdk-api/typescript-sdk — le client TS de niveau supérieur.

• Dépôt Raydium IDL
• Spécification Anchor IDL