トランザクションと手数料

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.

​

トランザクションの構成

• メッセージ：命令の順序付きリスト、それらが参照するアカウント、および最近のブロックハッシュ。
• 署名：署名者あたり 1 つ、トランザクションが認可されたことを証明します。
• 最近のブロックハッシュ：トランザクションが最新であることを証明します。古いブロックハッシュ（150 スロット以上前）を持つトランザクションは拒否されます。

​

命令

• program_id — 呼び出すプログラム。
• accounts — プログラムが触れる可能性があるアカウント（と書き込み可能/署名者フラグ）。
• data — プログラムが解釈する不透明なバイト。

1. ComputeBudget::SetComputeUnitLimit — デフォルトの CU 制限を上げます。
2. ComputeBudget::SetComputeUnitPrice — プライオリティ手数料を設定します。
3. オプション CreateAssociatedTokenAccount — ユーザーが持っていない場合、出力 ATA を作成します。
4. Raydium::SwapBaseInput — スワップを実行します。
5. オプション CloseAccount — ラップされた SOL ATA を閉じます。

​

トランザクション内のアカウント

• 署名者/非署名者：アカウントの所有者がトランザクションに署名する必要がありますか？
• 書き込み可能/読み取り専用：トランザクションはアカウントを変更できますか？

​

トランザクションサイズ制限

​

アドレスルックアップテーブル（ALT）

• 20 個のアカウントを直接参照するトランザクション：約 640 B の公開キー。
• ALT を使用した同じトランザクション：約 20 B のインデックス + ALT 参照。

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

// SDK は ALT 参照を含む v0（バージョン管理）tx を構築します
const { transaction } = await raydium.trade.swap({ /* ... */ });
// transaction は VersionedTransaction であり、レガシー 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 (マイクロラムポート) × compute_unit_limit

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

​

命令カウントとアカウントカウント制限

• トランザクションあたりの最大アカウント数：128。
• 命令あたりの最大アカウント数（CPI）：64。
• トランザクションあたりの最大命令数：ハード制限なし、サイズ制限によってのみ制限されます。
• 最大 CPI 深度：4（プログラムは別のプログラムを呼び出すことができ、別のプログラムは 4 レベル深くまで呼び出すことができます）。

​

Raydium スワップの手数料カテゴリ

​

Solana ネットワーク手数料

• 基本署名手数料：署名あたり 5000 ラムポート。ほぼ常に 1 署名 = 0.000005 SOL。
• プライオリティ手数料：マイクロラムポート単位の CU 価格 × CU 制限。混雑と共に変わります。integration-guides/priority-fee-tuning を参照してください。

​

Raydium プロトコル手数料

• スワップ手数料：入力の割合（CPMM 典型的 0.25%、CLMM ティアごと 0.01%～1%）。LP とプロトコル先へ分割。ray/protocol-fees を参照してください。

​

例：CPMM 0.25% ティア経由で $1000 USDC → SOL

​

バージョン管理トランザクション

• レガシー：元の形式、ALT サポートなし。
• v0（バージョン管理）：ALT をサポートし、将来のバージョンに拡張可能。

// v0 tx を直接構築
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]);

​

ブロックハッシュの新鮮さ

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

​

並列実行

• 同じプール上の 2 つのスワップは並列で実行できません — 両方ともプール状態に書き込みます。
• プール A 上のスワップとプール 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.