نظرة عامة على Transaction API

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.

​

ما هو Transaction API؟

• واجهات الويب التي لا تستطيع تشغيل عميل RPC محلي
• تطبيقات الهاتف المحمول ذات الموارد المحدودة
• بوتات التداول بدون واجهة مستخدم
• المجمعات وموفرو المحافظ

​

نظرة عامة على سير العمل

​

1. مرحلة الحساب: الحصول على عرض سعر

GET /compute/swap-base-in?inputMint=EPjF...&outputMint=So111...&amount=1000000&slippageBps=50&txVersion=V0

• مقدار الإخراج المتوقع
• تفصيل المسار (أي المجمعات ومصادر السيولة المستخدمة)
• تأثير السعر

​

2. مرحلة المعاملة: البناء والتوقيع

POST /transaction/swap-base-in
Content-Type: application/json

{
  "wallet": "YourWalletAddress",
  "swapResponse": { ...response from /compute/swap-base-in },
  "txVersion": "V0",
  "computeUnitPriceMicroLamports": "1000",
  "wrapSol": false,
  "unwrapSol": false,
  "inputAccount": "TokenAccount1...",
  "outputAccount": "TokenAccount2..."
}

• معاملة مرمزة بصيغة base64 جاهزة للتوقيع
• عناوين جدول البحث عن العناوين (إذا كان txVersion=V0)

1. فك تشفير المعاملة
2. توقيعها باستخدام مفتاح المستخدم الخاص
3. بثها عبر أي RPC للـ Solana
4. انتظار التأكيد

​

Compute Endpoints

​

GET /compute/swap-base-in

• inputMint – عنوان mint للرمز الذي تُرسله
• outputMint – عنوان mint للرمز الذي تريده
• amount – مقدار الإدخال بالـ lamports (أصغر وحدة)
• slippageBps – الانزلاق الأقصى المقبول بالنقاط الأساسية (0–10000)
• txVersion – V0 أو LEGACY

• referrerBps – إذا كان لديك سلطة مرجع، نقاط أساسية من الإخراج لتحصيلها كرسم إحالة

​

GET /compute/swap-base-out

• inputMint، outputMint، amount (الإخراج المطلوب)، slippageBps، txVersion

​

Transaction Endpoints

​

POST /transaction/swap-base-in

• wallet – عنوان محفظتك الموقعة
• swapResponse – كائن استجابة الحساب بالكامل
• txVersion – إصدار المعاملة
• computeUnitPriceMicroLamports – رسم الأولوية بالـ micro-lamports

• wrapSol – إذا كانت true، يتم تغليف SOL الأصلي من أجل الإدخال
• unwrapSol – إذا كانت true، يتم فك تغليف WSOL إلى SOL في الإخراج
• inputAccount – حساب الرمز للإدخال (مطلوب إذا لم يتم تغليف SOL)
• outputAccount – حساب الرمز للإخراج
• nonceInfo – nonce دائم للتوقيع غير المتصل
• jitoInfo – معاملات Jito MEV protection bundle
• referrerWallet – محفظة المرجع لتحصيل الرسوم

​

POST /transaction/swap-base-out

• حقل referrerInfo معلق حاليًا (لم يتم تطبيقه بعد)

​

Response Envelope

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "success": true,
  "version": "V1",
  "data": { ... }
}

​

شكل استجابة المعاملة

{
  "id": "...",
  "success": true,
  "version": "V1",
  "data": {
    "transaction": "AgABB...",  // Base64-encoded transaction
    "addressLookupTableAddresses": ["Address1...", "Address2..."]  // For V0 only
  }
}

​

مثال على التكامل

// 1. Get quote
const quote = await fetch(
  'https://transaction-v1.raydium.io/compute/swap-base-in?' +
  'inputMint=EPjF...&outputMint=So111...&amount=1000000&slippageBps=50&txVersion=V0'
).then(r => r.json());

// 2. Validate quote
if (!quote.success) {
  throw new Error(quote.msg);
}

// 3. Build transaction
const tx = await fetch(
  'https://transaction-v1.raydium.io/transaction/swap-base-in',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      wallet: userWalletAddress,
      swapResponse: quote,
      txVersion: 'V0',
      computeUnitPriceMicroLamports: '1000',
      inputAccount: userInputTokenAccount,
      outputAccount: userOutputTokenAccount,
    }),
  }
).then(r => r.json());

// 4. Decode and sign
const transaction = VersionedTransaction.deserialize(
  Buffer.from(tx.data.transaction, 'base64')
);
transaction.sign([userKeypair]);

// 5. Send via RPC
const rpc = new Connection('https://api.mainnet-beta.solana.com');
const sig = await rpc.sendTransaction(transaction);
await rpc.confirmTransaction(sig);

​

شرح المعاملات الرئيسية

​

txVersion

• V0: معاملة Solana حديثة مع جداول البحث عن العناوين (ALTs). حجم تسلسل أصغر، رسوم أقل.
• LEGACY: صيغة المعاملة السابقة للـ ALT. أكبر، لكنها تعمل مع جميع نقاط نهاية RPC.

​

computeUnitPriceMicroLamports

​

slippageBps

• استخدم قيم أقل (مثل 25–50 bps) لمعظم المبادلات المستقرة
• زيادة للأزواج المتقلبة أو قليلة السيولة

​

wrapSol و unwrapSol

• wrapSol: إذا كانت true، API تغلف SOL الأصلي في WSOL. لا حاجة إلى inputAccount.
• unwrapSol: إذا كانت true، API تفك تغليف الإخراج WSOL إلى SOL الأصلي. لا حاجة إلى outputAccount.

​

نقاط نهاية الشبكة

​

رموز الخطأ

​

انظر أيضًا

• OpenAPI Specification
• Aggregator Integration Guide