Anchor IDL

​

IDL là gì

​

Nơi tìm chúng

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

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

​

Tái tạo client TypeScript

# Sử dụng anchor CLI
anchor build
anchor idl parse \
  --file target/idl/cpmm.json \
  --out target/types/cpmm.ts

# Hoặc với các trợ giúp TS `@anchor-lang/core` tại thời gian chạy:

import { Program, AnchorProvider } from "@anchor-lang/core";
// Kéo IDL trực tiếp từ kho raydium-idl (hoặc đưa nó vào dự án của bạn).
import cpmmIdl from "./idls/raydium_cp_swap.json";

const provider = new AnchorProvider(connection, wallet, {});
// Anchor >= 0.30 đọc program id từ `idl.address` — các IDL này là spec 0.1.0
// và mang nó. Dạng ba đối số `new Program(idl, programId, provider)` là
// trước 0.30 và ném lỗi.
const program  = new Program(cpmmIdl as any, provider);

// Các method builder được gõ được tạo tự động:
await program.methods
  .swapBaseInput(new BN(amountIn), new BN(minAmountOut))
  .accounts({ ... })
  .rpc();

​

Tái tạo client Rust (crate CPI)

# Cargo.toml — khóa phụ thuộc phải là tên PACKAGE của 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"] }

# Từ IDL, sử dụng anchor-client
anchor idl parse \
  --file raydium_cpmm/raydium_cp_swap.json \
  --out src/generated/cpmm_bindings.rs

​

Tái tạo client Python

• anchorpy — Cổng Python của client TypeScript của Anchor. Tạo các method builder được gõ từ IDL.
• solders — các nguyên thủy Solana cấp thấp (giao dịch, keypair, pubkey) trong binding Rust; được sử dụng bên dưới 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={...}))

​

Chính sách thay đổi IDL

1. Các discriminator instruction không bao giờ thay đổi. Thêm instruction mới mở rộng enum ở cuối; các discriminator hiện có vẫn ổn định.
2. Kích thước tài khoản ổn định; các trường mới đến từ padding dự trữ. Mỗi struct trạng thái Raydium mang một vùng padding ở cuối được định kích thước khi tạo, và một trường mới được tạo ra từ padding đó thay vì được nối thêm — vì vậy độ dài byte của tài khoản và các offset của tất cả các trường đã tồn tại trước đó vẫn cố định. Hệ quả là các byte bạn trước đó đọc là padding có thể trở nên có ý nghĩa, và một trường có thể được loại bỏ trở lại padding (như PlatformConfig.curve_params trong bản phát hành 2026-08-31). Đọc lại định nghĩa struct sau khi nâng cấp; không giả định padding vẫn bằng không.
3. Các mã enum lỗi chỉ được nối thêm. Một mã lỗi hiện có luôn có nghĩa là điều tương tự.
4. Các thay đổi phá vỡ được gửi trong các chương trình mới. Khi cần thiết kế lại, nhóm triển khai một ID chương trình mới (ví dụ: CPMM như một chương trình mới thay vì nâng cấp AMM v4). Các pool cũ tiếp tục chạy trên chương trình cũ; các pool mới đi đến chương trình mới.

​

Phải làm gì khi IDL thay đổi

1. Cập nhật SDK. npm update @raydium-io/raydium-sdk-v2.
2. Tái tạo mã client của bạn nếu bạn sử dụng Anchor codegen trực tiếp.
3. So sánh bố cục tài khoản. Các trường ở cuối của bố cục mới là điều duy nhất mã của bạn chưa thấy; xác nhận xem bạn có cần chúng không.
4. Không giả định các discriminator instruction cũ không hợp lệ. Theo quy tắc 1, chúng vẫn hoạt động.
5. Chạy lại các bài kiểm tra tích hợp trên devnet trước khi triển khai đến mainnet.

​

Khắc phục sự cố IDL

​

Lỗi “Invalid discriminator”

anchor idl fetch <PROGRAM_ID>

​

Lỗi giải mã tài khoản

​

Các instruction bị thiếu trong client được tạo

​

Con trỏ

• sdk-api/rust-cpi — sử dụng các crate CPI Rust.
• sdk-api/python-integration — Python qua anchorpy.
• sdk-api/typescript-sdk — client TS cấp cao hơn.

• Kho lưu trữ Raydium IDL
• Spec Anchor IDL