Anchor IDL

​

Что такое IDL

​

Где их найти

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

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

​

Регенерация TypeScript клиента

# Используя anchor CLI
anchor build
anchor idl parse \
  --file target/idl/cpmm.json \
  --out target/types/cpmm.ts

# Или с помощью TS-помощников `@anchor-lang/core` во время выполнения:

import { Program, AnchorProvider } from "@anchor-lang/core";
// Получите IDL непосредственно из репозитория raydium-idl (или поместите его в свой проект).
import cpmmIdl from "./idls/raydium_cp_swap.json";

const provider = new AnchorProvider(connection, wallet, {});
// Anchor >= 0.30 читает program id из `idl.address` — эти IDL имеют spec 0.1.0
// и содержат его. Трёхаргументная форма `new Program(idl, programId, provider)` —
// это pre-0.30 и выбрасывает ошибку.
const program  = new Program(cpmmIdl as any, provider);

// Типизированные построители методов генерируются автоматически:
await program.methods
  .swapBaseInput(new BN(amountIn), new BN(minAmountOut))
  .accounts({ ... })
  .rpc();

​

Регенерация Rust клиента (CPI крейт)

# Cargo.toml — ключ зависимости должен быть PACKAGE-именем крейта.
[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"] }

# Из IDL, используя anchor-client
anchor idl parse \
  --file raydium_cpmm/raydium_cp_swap.json \
  --out src/generated/cpmm_bindings.rs

​

Регенерация Python клиента

• anchorpy — Python-порт TypeScript-клиента Anchor. Генерирует типизированные построители методов из IDL.
• solders — низкоуровневые примитивы Solana (транзакции, пары ключей, pubkey) в привязках Rust; используется под 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={...}))

​

Политика изменения IDL

1. Дискриминаторы инструкций никогда не меняются. Добавление новых инструкций расширяет перечисление в конце; существующие дискриминаторы остаются стабильными.
2. Размеры аккаунтов стабильны; новые поля выходят из зарезервированного заполнения. Каждая структура состояния Raydium содержит конечную область заполнения, размер которой определён при создании, и новое поле вырезается из этого заполнения, а не добавляется — поэтому длина аккаунта в байтах и смещения всех существующих ранее полей остаются фиксированными. Следствие состоит в том, что байты, которые вы ранее читали как заполнение, могут стать значимыми, и поле может быть отправлено обратно в заполнение (как PlatformConfig.curve_params в выпуске от 2026-08-31). Перечитайте определение структуры после обновления; не предполагайте, что заполнение остаётся нулевым.
3. Коды перечисления ошибок только добавляются. Существующий код ошибки всегда означает одно и то же.
4. Критические изменения поставляются в новых программах. Когда требуется переделка, команда развёртывает новый program ID (например, CPMM как свежую программу вместо обновления AMM v4). Старые пулы продолжают работать на старой программе; новые пулы переходят на новую.

​

Что делать при изменении IDL

1. Обновите SDK. npm update @raydium-io/raydium-sdk-v2.
2. Регенерируйте код вашего клиента, если вы используете Anchor codegen напрямую.
3. Сравните макет аккаунта. Конечные поля нового макета — это единственное, что ваш код не видел; подтвердите, нужны ли они вам.
4. Не предполагайте, что старые дискриминаторы инструкций недействительны. По правилу 1 они по-прежнему работают.
5. Повторно запустите интеграционные тесты на devnet перед развёртыванием на mainnet.

​

Устранение неполадок IDL

​

Ошибки “Invalid discriminator”

anchor idl fetch <PROGRAM_ID>

​

Ошибки декодирования аккаунта

​

Отсутствующие инструкции в сгенерированном клиенте

​

Ссылки

• sdk-api/rust-cpi — использование крейтов Rust CPI.
• sdk-api/python-integration — Python через anchorpy.
• sdk-api/typescript-sdk — более высокоуровневый TS клиент.

• Репозиторий Raydium IDL
• Спецификация Anchor IDL