Anchor IDL

​

Was eine IDL ist

​

Wo Sie sie finden

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

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

​

Regenerieren eines TypeScript-Clients

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

# Oder mit den `@anchor-lang/core` TS-Helfern zur Laufzeit:

import { Program, AnchorProvider } from "@anchor-lang/core";
// Ziehen Sie die IDL direkt aus dem raydium-idl-Repo (oder bündeln Sie sie in Ihr Projekt).
import cpmmIdl from "./idls/raydium_cp_swap.json";

const provider = new AnchorProvider(connection, wallet, {});
// Anchor >= 0.30 liest die Programm-ID aus `idl.address` — diese IDLs sind Spezifikation 0.1.0
// und tragen sie. Die dreiargumentige Form `new Program(idl, programId, provider)` ist
// Pre-0.30 und wirft einen Fehler.
const program  = new Program(cpmmIdl as any, provider);

// Typisierte Methoden-Builder werden automatisch generiert:
await program.methods
  .swapBaseInput(new BN(amountIn), new BN(minAmountOut))
  .accounts({ ... })
  .rpc();

​

Regenerieren eines Rust-Clients (CPI-Crate)

# Cargo.toml — der Abhängigkeitsschlüssel muss der PACKAGE-Name der Crate sein.
[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 = "chore/upgrade-anchor", features = ["cpi"] }

# Aus der IDL mit anchor-client
anchor idl parse \
  --file raydium_cpmm/raydium_cp_swap.json \
  --out src/generated/cpmm_bindings.rs

​

Regenerieren eines Python-Clients

• anchorpy — Python-Port des Anchor TypeScript-Clients. Generiert typisierte Methoden-Builder aus IDLs.
• solders — Low-Level-Solana-Primitive (Transaktionen, Keypairs, Pubkeys) in Rust-Bindings; wird unter anchorpy verwendet.

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={...}))

​

IDL-Änderungsrichtlinie

1. Instruktions-Diskriminatoren ändern sich nie. Das Hinzufügen neuer Instruktionen erweitert das Enum am Ende; bestehende Diskriminatoren bleiben stabil.
2. Account-Größen sind stabil; neue Felder kommen aus reserviertem Padding. Jede Raydium-State-Struktur trägt eine nachfolgende Padding-Region, die bei der Erstellung dimensioniert wird, und ein neues Feld wird aus diesem Padding herausgeschnitten, anstatt angehängt zu werden — daher bleiben die Byte-Länge des Accounts und die Offsets aller bereits vorhandenen Felder fest. Die Folge ist, dass Bytes, die Sie zuvor als Padding gelesen haben, aussagekräftig werden können, und ein Feld kann zurück in Padding zurückgezogen werden (wie PlatformConfig.curve_params in der Version vom 2026-08-31). Lesen Sie die Struct-Definition nach einem Upgrade erneut; gehen Sie nicht davon aus, dass Padding Null bleibt.
3. Error-Enum-Codes sind nur Anhänge. Ein vorhandener Error-Code bedeutet immer dasselbe.
4. Breaking Changes werden in neuen Programmen ausgeliefert. Wenn ein Redesign erforderlich ist, stellt das Team eine neue Programm-ID bereit (z. B. CPMM als neues Programm statt Upgrade von AMM v4). Alte Pools laufen weiterhin auf dem alten Programm; neue Pools gehen zum neuen.

​

Was zu tun ist, wenn sich die IDL ändert

1. Aktualisieren Sie das SDK. npm update @raydium-io/raydium-sdk-v2.
2. Regenerieren Sie Ihren Client-Code, wenn Sie Anchor-Codegen direkt verwenden.
3. Diff das Account-Layout. Die nachfolgenden Felder des neuen Layouts sind das Einzige, das Ihr Code nicht gesehen hat; bestätigen Sie, ob Sie sie benötigen.
4. Gehen Sie nicht davon aus, dass alte Instruktions-Diskriminatoren ungültig sind. Gemäß Regel 1 funktionieren sie immer noch.
5. Führen Sie Integrationstests erneut aus gegen Devnet, bevor Sie zu Mainnet wechseln.

​

IDL-Fehlerbehebung

​

Fehler „Invalid discriminator”

anchor idl fetch <PROGRAM_ID>

​

Account-Dekodierungsfehler

​

Fehlende Instruktionen im generierten Client

​

Verweise

• sdk-api/rust-cpi — Verwendung der Rust-CPI-Crates.
• sdk-api/python-integration — Python über anchorpy.
• sdk-api/typescript-sdk — der höherstufige TS-Client.

• Raydium IDL Repository
• Anchor IDL Spezifikation