ルーティング命令

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.

​

命令の概要

• 完全: 呼び出し元が固定する金額（入力 = 完全入力 amount_in；出力 = 完全出力 amount_out）。
• バリアント: レガシー命令ではルートに CLMM ホップがない場合でも、空でない limit_prices デックが必要です。現在の命令（8 / 9）は空の limit_prices を「チェックなし」として扱い、これが新しいコードの推奨パスです。

​

現在のスワップ命令（推奨）

​

SwapBaseIn（タグ 8）

amount_in:            u64
minimum_amount_out:   u64
limit_prices:         VecDeque<u128>  // optional; empty deque means no per-hop CLMM price check

[
  <user_input_ata> W S,         // signer; balance >= amount_in
  <user_intermediate_ata_1> W,  // one per intermediate hop
  ... <user_intermediate_ata_N> W,
  <user_output_ata> W,
  <token_program>,

  <pool_program_hop_1>,         // identifies which AMM family hop 1 is
  <pool_state_hop_1> W,
  ... <other accounts required by hop 1's program>,

  <pool_program_hop_2>,
  <pool_state_hop_2> W,
  ... <hop 2 accounts>,

  ... [repeat per hop]
]

• 呼び出し元は user_input_ata で署名します。
• user_input_ata.amount >= amount_in。
• すべての中間ユーザー ATA が存在し、呼び出し元が所有しています。
• CLMM ホップがあり、価格バウンド強制を望む場合は、CLMM ホップごとに 1 つの limit_prices エントリを指定します。

• user_input_ata 残高が amount_in だけ減少します。
• user_output_ata 残高が ≥ minimum_amount_out 増加します。
• 各中間 ATA はネット変化ゼロで残されます（ルートは 1 ホップ前に生成したものを消費します）。

• ExceededSlippage — 最終出力 < minimum_amount_out。
• InvalidInput — ルートが空、アカウントが不正形式、または pool_program がサポートされていません。
• SqrtPriceX64 — CLMM ホップの価格が指定された limit_prices バウンド外に移動しました（limit_prices が空でない場合のみ）。

​

SwapBaseOut（タグ 9）

maximum_amount_in:   u64
amount_out:          u64
limit_prices:        VecDeque<u128>  // optional; empty deque means no per-hop CLMM price check

• 呼び出し元は user_input_ata で署名します；残高 >= maximum_amount_in（最悪の場合）。
• 各中間および出力 ATA が存在します。

• user_input_ata が必要な実際の金額（≤ maximum_amount_in）だけ減少します。
• user_output_ata が正確に amount_out だけ増加します。

• ExceededSlippage — 必要な入力が maximum_amount_in を超えています。
• InvalidInput、SqrtPriceX64 — タグ 8 と同様。

​

レガシースワップ命令

​

SwapBaseInWithUserAccount（タグ 0）

amount_in:           u64
minimum_amount_out:  u64
limit_prices:        VecDeque<u128>  // required, non-empty

• 呼び出し元は user_input_ata で署名します。
• user_input_ata.amount >= amount_in。
• すべての中間ユーザー ATA が存在し、呼び出し元が所有しています。
• limit_prices が空でありません（CLMM ホップごとに 1 エントリ；CLMM ホップが関係ない場合はプレースホルダー値を指定してください）。

• user_input_ata 残高が amount_in だけ減少します。
• user_output_ata 残高が ≥ minimum_amount_out 増加します。

• ExceededSlippage。
• InvalidInput — 空の limit_prices はこのレガシーバリアントで拒否されます。
• SqrtPriceX64。

​

SwapBaseOutWithUserAccount（タグ 1）

maximum_amount_in:   u64
amount_out:          u64
limit_prices:        VecDeque<u128>  // required, non-empty

• 呼び出し元は user_input_ata で署名します。
• user_input_ata.amount >= maximum_amount_in。
• すべての中間ユーザー ATA が存在し、呼び出し元が所有しています。
• limit_prices が空でありません。

• user_input_ata が必要な実際の金額（≤ maximum_amount_in）だけ減少します。
• user_output_ata が正確に amount_out だけ増加します。

• ExceededSlippage。
• InvalidInput。
• SqrtPriceX64。

​

ユーティリティ命令

​

CreateSyncNative（タグ 5）

amount: u64    // SOL to wrap (lamports)

[
  <user_wsol_ata> W,            // ATA for wSOL; created if missing
  <user_native_account> W S,    // signer; SOL is debited from here
  <wsol_mint>,
  <system_program>,
  <token_program>,
  <associated_token_program>,
]

• user_wsol_ata がまだ存在しない場合、作成します。
• サイナーのネイティブ SOL 残高から ATA に amount ラムポート転送します。
• ATA で SyncNative を呼び出して、トークン残高が新しいラムポートを反映するようにします。

• InvalidOwner — user_wsol_ata の所有者がサイナーではありません。

​

CloseTokenAccount（タグ 6）

[
  <token_account_to_close> W,
  <destination_for_rent> W,
  <owner> S,
  <token_program>,
]

• token_account_to_close を閉じます。
• レント相当のラムポート残高（メインネットでバニラ SPL Token アカウントの場合、約 0.00203928 SOL）を destination_for_rent に転送します。
• トークンアカウントはゼロトークン残高を持つ必要があります。

• InvalidOwner — 呼び出し元が ATA 所有者ではありません。
• トークンアカウント残高がゼロ以外です。

​

次のステップ

• products/routing/code-demos — TypeScript でこれらの各命令を構築します。
• products/routing/accounts — AMM ごとのディスパッチキーとホップごとのアカウントレイアウト。
• reference/error-codes — 完全な RouteError リスト。