Giao dịch và phí

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.

​

Cấu trúc giao dịch

• Message: danh sách có thứ tự các instruction, các account mà chúng tham chiếu, và blockhash gần đây.
• Signatures: một cái cho mỗi signer, xác nhận rằng giao dịch được phép.
• Recent blockhash: chứng minh giao dịch là gần đây; các giao dịch có blockhash cũ (>150 slot) bị từ chối.

​

Instructions

• program_id — chương trình được gọi.
• accounts — các account (và cờ writable/signer của chúng) mà chương trình có thể sửa đổi.
• data — các byte không minh bạch mà chương trình diễn giải.

1. ComputeBudget::SetComputeUnitLimit — nâng giới hạn CU mặc định.
2. ComputeBudget::SetComputeUnitPrice — đặt priority fee.
3. Optional CreateAssociatedTokenAccount — tạo output ATA nếu người dùng không có.
4. Raydium::SwapBaseInput — thực thi swap.
5. Optional CloseAccount — đóng wrapped-SOL ATA.

​

Accounts trong giao dịch

• Signer / non-signer: chủ sở hữu của account phải ký giao dịch không?
• Writable / read-only: giao dịch có thể sửa đổi account không?

​

Giới hạn kích thước giao dịch

​

Address Lookup Tables (ALTs)

• Giao dịch tham chiếu 20 account trực tiếp: ~640 B pubkey.
• Cùng giao dịch sử dụng ALT: ~20 B chỉ mục + tham chiếu ALT.

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

// SDK xây dựng v0 (versioned) tx với tham chiếu ALT
const { transaction } = await raydium.trade.swap({ /* ... */ });
// transaction là VersionedTransaction, không phải legacy Transaction.

​

Compute budget

• Mặc định: 200,000 CU mỗi giao dịch.
• Tối đa: 1,400,000 CU mỗi giao dịch (nâng lên thông qua ComputeBudget::SetComputeUnitLimit).
• Trần mỗi block: 48M CU mỗi block (cấp độ giao thức).

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

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

​

Priority fees

priority_fee = compute_unit_price (micro-lamports) × compute_unit_limit

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

​

Giới hạn số lượng instruction và account

• Max account mỗi giao dịch: 128.
• Max account mỗi instruction (CPI): 64.
• Max instruction mỗi giao dịch: không có giới hạn cứng, chỉ bị giới hạn bởi giới hạn kích thước.
• Max CPI depth: 4 (một chương trình có thể gọi cái khác, cái đó có thể gọi cái khác, 4 cấp độ).

​

Danh mục phí trong swap Raydium

​

Phí mạng Solana

• Base signature fee: 5000 lamport mỗi signature. Hầu như luôn là 1 signature = 0.000005 SOL.
• Priority fee: CU-price × CU-limit tính bằng microlamport. Thay đổi tùy theo tắc nghẽn; xem integration-guides/priority-fee-tuning.

​

Phí giao thức Raydium

• Swap fee: phần trăm của input (CPMM 0.25% típ, CLMM 0.01%–1% mỗi tier). Chia giữa LP và các điểm đến giao thức. Xem ray/protocol-fees.

​

Ví dụ: $1000 USDC → SOL qua CPMM 0.25% tier

​

Versioned transactions

• Legacy: định dạng gốc, không hỗ trợ ALT.
• v0 (Versioned): hỗ trợ ALT, mở rộng cho các phiên bản trong tương lai.

// Xây dựng v0 tx trực tiếp
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]);

​

Tươi mới 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;
    }
  }
}

​

Thực thi song song

• Hai swap trên cùng pool không thể thực thi song song — cả hai sửa đổi trạng thái pool.
• Swap trên Pool A và swap trên Pool B thực thi song song nếu danh sách account không chồng lấp.
• Giao dịch read-only không bao giờ chặn writer trên cùng một account (read-only là song phương với chính nó nhưng không với ghi).

​

Mức xác nhận giao dịch

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

​

Mô phỏng

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

​

Con trỏ

• solana-fundamentals/account-model — account trong giao dịch.
• solana-fundamentals/pdas-and-cpis — cách các chương trình gọi nhau.
• integration-guides/priority-fee-tuning — kích cỡ giới hạn CU và priority fee.
• ray/protocol-fees — cấu trúc phí giao thức Raydium.

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