Anchor IDL

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

​

ما هي IDL

​

حيث يمكنك العثور عليها

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

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

​

إعادة إنشاء عميل TypeScript

# باستخدام CLI الخاص بـ anchor
anchor build
anchor idl parse \
  --file target/idl/cpmm.json \
  --out target/types/cpmm.ts

# أو باستخدام مساعدات TS من `@coral-xyz/anchor` في وقت التشغيل:

import { Program, AnchorProvider } from "@coral-xyz/anchor";
// اسحب IDL مباشرة من مستودع raydium-idl (أو أدرجه في مشروعك).
import cpmmIdl from "./idls/raydium_cp_swap.json";

const provider = new AnchorProvider(connection, wallet, {});
const program  = new Program(cpmmIdl as any, CPMM_PROGRAM_ID, provider);

// منشئو الطرق المكتوبة التي يتم إنشاؤها تلقائيًا:
await program.methods
  .swapBaseInput(new BN(amountIn), new BN(minAmountOut))
  .accounts({ ... })
  .rpc();

​

إعادة إنشاء عميل Rust (صندوق CPI)

# Cargo.toml
[dependencies]
raydium_cp_swap = { git = "https://github.com/raydium-io/raydium-cp-swap", branch = "master", features = ["cpi"] }
raydium_amm_v3 = { git = "https://github.com/raydium-io/raydium-clmm",    branch = "master", features = ["cpi"] }

# من IDL، باستخدام anchor-client
anchor idl parse \
  --file raydium_cpmm/raydium_cp_swap.json \
  --out src/generated/cpmm_bindings.rs

​

إعادة إنشاء عميل Python

• anchorpy — نسخة Python من @coral-xyz/anchor. يولد منشئي طرق مكتوبة من IDLs.
• solders — بدائية Solana منخفضة المستوى (المعاملات، المفاتيح، المفاتيح العامة) في ربطات 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. تتطور تخطيطات هياكل الحساب فقط بشكل إضافي. تذهب الحقول الجديدة في النهاية، سابقة بنقل الحجم في الأسفل. الحقول الموجودة تحافظ على انزياحاتها.
3. رموز تعداد الأخطاء للإلحاق فقط. رمز الخطأ الموجود دائمًا يعني نفس الشيء.
4. التغييرات الجذرية تُرسل في برامج جديدة. عندما يكون هناك حاجة لإعادة التصميم، يعتمد الفريق برنامج 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