路由指令

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）。
• 變體： Legacy 指令即使路由中無 CLMM 跳躍也需要非空的 limit_prices 雙端佇列。當前指令（8 / 9）將空的 limit_prices 視為「無檢查」，這是新程式碼的推薦方式。

​

當前交換指令（推薦）

​

SwapBaseIn（標籤 8）

amount_in:            u64
minimum_amount_out:   u64
limit_prices:         VecDeque<u128>  // 可選；空雙端佇列表示無按跳躍 CLMM 價格檢查

[
  <user_input_ata> W S,         // 簽署者；餘額 >= amount_in
  <user_intermediate_ata_1> W,  // 每個中間跳躍一個
  ... <user_intermediate_ata_N> W,
  <user_output_ata> W,
  <token_program>,

  <pool_program_hop_1>,         // 識別第 1 跳躍屬於哪個 AMM 系列
  <pool_state_hop_1> W,
  ... <hop 1 計畫所需的其他帳戶>,

  <pool_program_hop_2>,
  <pool_state_hop_2> W,
  ... <hop 2 帳戶>,

  ... [按跳躍數重複]
]

• 呼叫者使用 user_input_ata 簽署。
• user_input_ata.amount >= amount_in。
• 每個中間使用者 ATA 存在且由呼叫者擁有。
• 如果任何跳躍是 CLMM 且你想要價格界限強制執行，請為每個 CLMM 跳躍提供一個 limit_prices 項目。

• user_input_ata 餘額減少 amount_in。
• user_output_ata 餘額增加 ≥ minimum_amount_out。
• 每個中間 ATA 保持零淨變化（路由消耗上一個跳躍產生的任何內容）。

• 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>  // 可選；空雙端佇列表示無按跳躍 CLMM 價格檢查

• 呼叫者使用 user_input_ata 簽署；餘額 >= maximum_amount_in（最壞情況）。
• 每個中間 ATA 及輸出 ATA 存在。

• user_input_ata 減少所需的實際金額（≤ maximum_amount_in）。
• user_output_ata 增加正好 amount_out。

• ExceededSlippage — 所需輸入超過 maximum_amount_in。
• InvalidInput、SqrtPriceX64 — 如標籤 8。

​

Legacy 交換指令

​

SwapBaseInWithUserAccount（標籤 0）

amount_in:           u64
minimum_amount_out:  u64
limit_prices:        VecDeque<u128>  // 必須、非空

• 呼叫者使用 user_input_ata 簽署。
• user_input_ata.amount >= amount_in。
• 所有中間使用者 ATA 存在且由呼叫者擁有。
• limit_prices 非空（每個 CLMM 跳躍一個項目；如無 CLMM 跳躍，用佔位符值填充）。

• user_input_ata 餘額減少 amount_in。
• user_output_ata 餘額增加 ≥ minimum_amount_out。

• ExceededSlippage。
• InvalidInput — 此 Legacy 變體拒絕空的 limit_prices。
• SqrtPriceX64。

​

SwapBaseOutWithUserAccount（標籤 1）

maximum_amount_in:   u64
amount_out:          u64
limit_prices:        VecDeque<u128>  // 必須、非空

• 呼叫者使用 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（lamports）

[
  <user_wsol_ata> W,            // wSOL 的 ATA；若缺少則建立
  <user_native_account> W S,    // 簽署者；SOL 從此處扣除
  <wsol_mint>,
  <system_program>,
  <token_program>,
  <associated_token_program>,
]

• 若 user_wsol_ata 不存在則建立它。
• 從簽署者的原生 SOL 餘額轉移 amount lamports 到 ATA。
• 在 ATA 上呼叫 SyncNative 使其代幣餘額反映新的 lamports。

• InvalidOwner — user_wsol_ata 的擁有者不是簽署者。

​

CloseTokenAccount（標籤 6）

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

• 關閉 token_account_to_close。
• 將租金豁免的 lamport 餘額（主網上標準 SPL Token 帳戶約 0.00203928 SOL）轉移到 destination_for_rent。
• 代幣帳戶必須具有零代幣餘額。

• InvalidOwner — 呼叫者不是 ATA 擁有者。
• 代幣帳戶餘額非零。

​

後續步驟

• products/routing/code-demos — 用 TypeScript 構建這些指令。
• products/routing/accounts — 按 AMM 分派鍵及按跳躍帳戶佈局。
• reference/error-codes — 完整 RouteError 清單。