Anchor IDL

​

IDL nedir

​

Nerede bulunur

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

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

​

TypeScript istemcisini yeniden oluşturma

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

# Veya `@anchor-lang/core` TS yardımcılarını çalışma zamanında kullanarak:

import { Program, AnchorProvider } from "@anchor-lang/core";
// IDL'yi raydium-idl deposundan doğrudan çekin (veya projenize dahil edin).
import cpmmIdl from "./idls/raydium_cp_swap.json";

const provider = new AnchorProvider(connection, wallet, {});
// Anchor >= 0.30 program id'sini `idl.address`'ten okur — bu IDL'ler spec 0.1.0'dır
// ve bunu taşırlar. Üç argümanlı form `new Program(idl, programId, provider)` 
// 0.30 öncesidir ve hata fırlatır.
const program  = new Program(cpmmIdl as any, provider);

// Yazılı yöntem oluşturucuları otomatik olarak oluşturulur:
await program.methods
  .swapBaseInput(new BN(amountIn), new BN(minAmountOut))
  .accounts({ ... })
  .rpc();

​

Rust istemcisini yeniden oluşturma (CPI crate)

# Cargo.toml — bağımlılık anahtarı crate'in PACKAGE adı olmalıdır.
[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"] }

# IDL'den, anchor-client kullanarak
anchor idl parse \
  --file raydium_cpmm/raydium_cp_swap.json \
  --out src/generated/cpmm_bindings.rs

​

Python istemcisini yeniden oluşturma

• anchorpy — Anchor’un TypeScript istemcisinin Python portu. IDL’lerden yazılı yöntem oluşturucuları oluşturur.
• solders — düşük seviyeli Solana ilkelleri (işlemler, keypair’ler, pubkey’ler) Rust bağlamalarında; anchorpy altında kullanılır.

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 değişiklik politikası

1. Talimat ayırıcıları asla değişmez. Yeni talimatlar eklenmesi enum’u sonunda genişletir; mevcut ayırıcılar kararlı kalır.
2. Hesap boyutları kararlıdır; yeni alanlar ayrılmış dolgudan çıkar. Her Raydium durum struct’ı, oluşturulduğunda boyutlandırılmış bir sondaki dolgu bölgesi taşır ve yeni bir alan eklenmek yerine bu dolgulardan oyulur — bu nedenle hesabın bayt uzunluğu ve tüm önceden var olan alanların ofsetleri sabit kalır. Sonuç olarak, daha önce dolgu olarak okuduğunuz baytlar anlamlı hale gelebilir ve bir alan dolguya geri çekilebilir (2026-08-31 sürümünde PlatformConfig.curve_params gibi). Yükseltmeden sonra struct tanımını yeniden okuyun; dolgunun sıfır kalacağını varsaymayın.
3. Hata enum kodları yalnızca ekleme yönelidir. Mevcut bir hata kodu her zaman aynı şeyi ifade eder.
4. Kırıcı değişiklikler yeni programlarda gönderilir. Bir yeniden tasarım gerektiğinde, ekip yeni bir program ID’si dağıtır (örn. CPMM, AMM v4’ü yükseltmek yerine taze bir program olarak). Eski havuzlar eski programda çalışmaya devam eder; yeni havuzlar yenisine gider.

​

IDL değiştiğinde ne yapılır

1. SDK’yı güncelleyin. npm update @raydium-io/raydium-sdk-v2.
2. İstemci kodunuzu yeniden oluşturun Anchor codegen’i doğrudan kullanıyorsanız.
3. Hesap düzenini karşılaştırın. Yeni düzenin sondaki alanları, kodunuzun görmediği tek şeydir; bunlara ihtiyacınız olup olmadığını doğrulayın.
4. Eski talimat ayırıcılarının geçersiz olduğunu varsaymayın. Kural 1’e göre, hala çalışırlar.
5. Entegrasyon testlerini yeniden çalıştırın mainnet’e geçmeden önce devnet’te.

​

IDL sorun giderme

​

”Invalid discriminator” hataları

anchor idl fetch <PROGRAM_ID>

​

Hesap çözme hataları

​

Oluşturulan istemcide eksik talimatlar

​

İşaretçiler

• sdk-api/rust-cpi — Rust CPI crate’lerini kullanma.
• sdk-api/python-integration — anchorpy aracılığıyla Python.
• sdk-api/typescript-sdk — daha yüksek seviyeli TS istemcisi.

• Raydium IDL deposu
• Anchor IDL spec