Transaksi dan biaya

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.

​

Anatomi transaksi

• Message: daftar instruksi terurut, akun yang dirujuk, dan blockhash terbaru.
• Signatures: satu per penandatangan, membuktikan transaksi telah diotorisasi.
• Recent blockhash: membuktikan transaksi baru; transaksi dengan blockhash lama (>150 slot) ditolak.

​

Instruksi

• program_id — program yang akan dipanggil.
• accounts — akun (dan flag writable/signer) yang dapat disentuh program.
• data — byte opak yang diinterpretasi oleh program.

1. ComputeBudget::SetComputeUnitLimit — naikkan batas CU default.
2. ComputeBudget::SetComputeUnitPrice — atur biaya prioritas.
3. Opsional CreateAssociatedTokenAccount — buat ATA output jika pengguna belum memilikinya.
4. Raydium::SwapBaseInput — jalankan swap.
5. Opsional CloseAccount — tutup ATA wrapped-SOL.

​

Akun dalam transaksi

• Signer / non-signer: harus pemilik akun menandatangani transaksi?
• Writable / read-only: dapat transaksi memodifikasi akun?

​

Batas ukuran transaksi

​

Address Lookup Tables (ALTs)

• Transaksi merujuk 20 akun secara langsung: ~640 B pubkey.
• Transaksi yang sama menggunakan ALT: ~20 B indeks + referensi ALT.

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

// SDK membangun v0 (versioned) tx dengan referensi ALT
const { transaction } = await raydium.trade.swap({ /* ... */ });
// transaction adalah VersionedTransaction, bukan legacy Transaction.

​

Budget komputasi

• Default: 200.000 CU per transaksi.
• Maximum: 1.400.000 CU per transaksi (dinaikkan melalui ComputeBudget::SetComputeUnitLimit).
• Per-block ceiling: 48M CU per blok (level protokol).

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

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

​

Biaya prioritas

priority_fee = compute_unit_price (micro-lamports) × compute_unit_limit

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

​

Batas jumlah instruksi dan jumlah akun

• Max akun per transaksi: 128.
• Max akun per instruksi (CPI): 64.
• Max instruksi per transaksi: tidak ada batas keras, hanya dibatasi oleh batas ukuran.
• Max CPI depth: 4 (program dapat memanggil program lain, yang dapat memanggil program lain, 4 level dalam).

​

Kategori biaya dalam swap Raydium

​

Biaya jaringan Solana

• Biaya signature dasar: 5000 lamport per signature. Hampir selalu 1 signature = 0,000005 SOL.
• Biaya prioritas: CU-price × CU-limit dalam microlamport. Bervariasi dengan kemacetan; lihat integration-guides/priority-fee-tuning.

​

Biaya protokol Raydium

• Biaya swap: persentase dari input (CPMM 0,25% tipikal, CLMM 0,01%–1% per tier). Dibagi antara LP dan tujuan protokol. Lihat ray/protocol-fees.

​

Contoh: $1000 USDC → SOL via CPMM 0,25% tier

​

Transaksi versioned

• Legacy: format asli, tidak ada dukungan ALT.
• v0 (Versioned): mendukung ALT, dapat diperluas ke versi masa depan.

// Membangun tx v0 secara langsung
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]);

​

Kesegaran 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;
    }
  }
}

​

Eksekusi paralel

• Dua swap di pool yang sama tidak dapat dieksekusi secara paralel — keduanya menulis state pool.
• Swap di Pool A dan swap di Pool B dieksekusi secara paralel jika daftar akun tidak tumpang tindih.
• Transaksi read-only tidak pernah memblokir penulis pada akun yang sama (read-only bersamaan dengan dirinya sendiri tetapi bukan dengan penulisan).

​

Tingkat konfirmasi transaksi

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

​

Simulasi

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

​

Penunjuk

• solana-fundamentals/account-model — akun dalam transaksi.
• solana-fundamentals/pdas-and-cpis — bagaimana program memanggil satu sama lain.
• integration-guides/priority-fee-tuning — mengukur batas CU dan biaya prioritas.
• ray/protocol-fees — struktur biaya protokol Raydium.

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