المعاملات والرسوم

​

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

• الرسالة (Message): القائمة المرتّبة للتعليمات والحسابات التي تشير إليها، و blockhash الحديث.
• التوقيعات (Signatures): واحد لكل موقّع، يثبت أن المعاملة مُرخّصة.
• blockhash الحديث: يثبت أن المعاملة حديثة؛ المعاملات ذات blockhashes القديمة (أقدم من 150 فتحة) مرفوضة.

​

التعليمات

• program_id — البرنامج المراد استدعاؤه.
• accounts — الحسابات (وأعلامها القابلة للكتابة/الموقّع) التي قد يلمسها البرنامج.
• data — بايتات معتّمة يفسّرها البرنامج.

1. ComputeBudget::SetComputeUnitLimit — رفع حد CU الافتراضي.
2. ComputeBudget::SetComputeUnitPrice — تعيين رسم الأولوية.
3. CreateAssociatedTokenAccount اختياري — إنشاء ATA الإخراج إذا لم يكن لدى المستخدم واحد.
4. Raydium::SwapBaseInput — تنفيذ المبادلة.
5. CloseAccount اختياري — إغلاق wrapped-SOL ATA.

​

الحسابات في المعاملات

• موقّع / غير موقّع: هل يجب على صاحب الحساب توقيع المعاملة؟
• قابل للكتابة / للقراءة فقط: هل يمكن للمعاملة تعديل الحساب؟

​

حد حجم المعاملة

​

جداول البحث عن العناوين (ALTs)

• معاملة تشير إلى 20 حساب مباشرة: ~640 B من المفاتيح العمومية.
• نفس المعاملة باستخدام ALTs: ~20 B من الفهارس + مراجع ALT.

import { VersionedTransaction } from "@solana/web3.js";

// SDK builds a v0 (versioned) tx with ALT references
const { transaction } = await raydium.trade.swap({ /* ... */ });
// transaction is a VersionedTransaction, not a legacy Transaction.

​

ميزانية الحساب

• الافتراضي: 200,000 CU لكل معاملة.
• الحد الأقصى: 1,400,000 CU لكل معاملة (مرفوع عبر ComputeBudget::SetComputeUnitLimit).
• سقف لكل كتلة: 48M CU لكل كتلة (مستوى البروتوكول).

import { ComputeBudgetProgram } from "@solana/web3.js";

tx.add(
  ComputeBudgetProgram.setComputeUnitLimit({ units: 300_000 }),
);

​

رسوم الأولوية

priority_fee = compute_unit_price (micro-lamports) × compute_unit_limit

tx.add(
  ComputeBudgetProgram.setComputeUnitPrice({ microLamports: 10_000 }),
);

​

حدود عدد التعليمات وعدد الحسابات

• حد أقصى من الحسابات لكل معاملة: 128.
• حد أقصى من الحسابات لكل تعليمة (CPI): 64.
• حد أقصى من التعليمات لكل معاملة: لا يوجد حد صارم، محصور فقط بحد الحجم.
• حد أقصى من عمق CPI: 4 (برنامج قد يستدعي آخر، الذي قد يستدعي آخر، 4 مستويات عميقة).

​

فئات الرسوم في مبادلة Raydium

​

رسوم شبكة Solana

• رسم التوقيع الأساسي: 5000 lamports لكل توقيع. تقريبًا دائمًا 1 توقيع = 0.000005 SOL.
• رسم الأولوية: CU-price × CU-limit بالمايكروlamports. يتغيّر مع الاختناق؛ انظر integration-guides/priority-fee-tuning.

​

رسوم بروتوكول Raydium

• رسم المبادلة: نسبة مئوية من المدخل (CPMM 0.25% نموذجي، CLMM 0.01%–1% لكل طبقة). مقسمة بين LPs والوجهات البروتوكول. انظر ray/protocol-fees.

​

مثال: $1000 USDC → SOL عبر CPMM 0.25% tier

​

المعاملات المُصدّرة

• Legacy: الصيغة الأصلية، بدون دعم ALT.
• v0 (المُصدّرة): تدعم ALTs، قابلة للتوسع للإصدارات المستقبلية.

// Building a v0 tx directly
import { VersionedTransaction, TransactionMessage } from "@solana/web3.js";

const msg = new TransactionMessage({
  payerKey:        owner.publicKey,
  recentBlockhash: blockhash,
  instructions:    [ /* ... */ ],
}).compileToV0Message([lookupTableAccount]);

const tx = new VersionedTransaction(msg);
tx.sign([owner]);

​

حداثة Blockhash

async function sendWithRetry(tx, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
    tx.message.recentBlockhash = blockhash;
    tx.sign([owner]);
    try {
      return await connection.sendRawTransaction(tx.serialize());
    } catch (e) {
      if (i === maxRetries - 1) throw e;
    }
  }
}

​

التنفيذ المتوازي

• مبادلتان على نفس pool لا يمكن أن تنفذا بالتوازي — كلاهما يكتب حالة pool.
• مبادلة على Pool A ومبادلة على Pool B تنفذان بالتوازي إذا لم تتداخل قوائم الحسابات.
• معاملة للقراءة فقط لا تحجز كاتبًا على نفس الحساب (القراءة فقط متزامنة مع نفسها لكن ليس مع الكتابات).

​

مستويات تأكيد المعاملات

await connection.sendAndConfirmTransaction(tx, [owner], {
  commitment: "confirmed",
});

​

المحاكاة

const sim = await connection.simulateTransaction(tx);
console.log(sim.value.logs);
console.log(sim.value.unitsConsumed);

​

مؤشرات

• solana-fundamentals/account-model — الحسابات في المعاملات.
• solana-fundamentals/pdas-and-cpis — كيف تستدعي البرامج بعضها.
• integration-guides/priority-fee-tuning — تحديد حجم حدود CU ورسوم الأولوية.
• ray/protocol-fees — هيكل رسوم بروتوكول Raydium.

• Solana Transaction docs.
• Address Lookup Tables proposal.
• Compute budget documentation.