Hướng dẫn routing instruction

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.

​

Tóm tắt instruction

• Chính xác: số tiền nào được xác định cố định bởi người gọi (Input = exact-input amount_in; Output = exact-output amount_out).
• Biến thể: Các instruction Legacy yêu cầu một deque limit_prices không rỗng ngay cả khi không có CLMM hop nào trong route. Các instruction hiện tại (8 / 9) coi deque limit_prices rỗng là “không kiểm tra”, đây là cách được khuyến nghị cho code mới.

​

Các instruction swap hiện tại (được khuyến nghị)

​

SwapBaseIn (tag 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]
]

• Người gọi ký bằng user_input_ata.
• user_input_ata.amount >= amount_in.
• Mỗi ATA user trung gian tồn tại và được sở hữu bởi người gọi.
• Nếu bất kỳ hop nào là CLMM và bạn muốn thực thi giới hạn giá, hãy cung cấp một mục limit_prices cho mỗi CLMM hop.

• Số dư user_input_ata giảm đi amount_in.
• Số dư user_output_ata tăng lên ≥ minimum_amount_out.
• Mỗi ATA trung gian được để lại với thay đổi ròng bằng không (route tiêu thụ bất cứ thứ gì nó tạo ra ở hop trước đó).

• ExceededSlippage — output cuối cùng < minimum_amount_out.
• InvalidInput — route rỗng, account dị hình, hoặc pool_program không được hỗ trợ.
• SqrtPriceX64 — giá CLMM hop di chuyển ngoài giới hạn limit_prices được cung cấp (chỉ khi limit_prices không rỗng).

​

SwapBaseOut (tag 9)

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

• Người gọi ký bằng user_input_ata; số dư >= maximum_amount_in (trường hợp xấu nhất).
• Mỗi ATA trung gian và ATA output tồn tại.

• user_input_ata giảm đi số lượng thực tế cần thiết (≤ maximum_amount_in).
• user_output_ata tăng lên chính xác amount_out.

• ExceededSlippage — input cần thiết vượt quá maximum_amount_in.
• InvalidInput, SqrtPriceX64 — giống như tag 8.

​

Các instruction swap Legacy

​

SwapBaseInWithUserAccount (tag 0)

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

• Người gọi ký bằng user_input_ata.
• user_input_ata.amount >= amount_in.
• Tất cả các ATA user trung gian tồn tại và được sở hữu bởi người gọi.
• limit_prices không rỗng (một mục cho mỗi CLMM hop; điền các giá trị placeholder nếu không có CLMM hop nào liên quan).

• Số dư user_input_ata giảm đi amount_in.
• Số dư user_output_ata tăng lên ≥ minimum_amount_out.

• ExceededSlippage.
• InvalidInput — deque limit_prices rỗng bị từ chối ở biến thể Legacy này.
• SqrtPriceX64.

​

SwapBaseOutWithUserAccount (tag 1)

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

• Người gọi ký bằng user_input_ata.
• user_input_ata.amount >= maximum_amount_in.
• Tất cả các ATA user trung gian tồn tại và được sở hữu bởi người gọi.
• limit_prices không rỗng.

• user_input_ata giảm đi số lượng thực tế cần thiết (≤ maximum_amount_in).
• user_output_ata tăng lên chính xác amount_out.

• ExceededSlippage.
• InvalidInput.
• SqrtPriceX64.

​

Các instruction tiện ích

​

CreateSyncNative (tag 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>,
]

• Tạo user_wsol_ata nếu nó chưa tồn tại.
• Chuyển amount lamports từ số dư SOL gốc của người ký đến ATA.
• Gọi SyncNative trên ATA để số dư token của nó phản ánh lamports mới.

• InvalidOwner — chủ sở hữu của user_wsol_ata không phải là người ký.

​

CloseTokenAccount (tag 6)

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

• Đóng token_account_to_close.
• Chuyển số dư lamport miễn phí tiền thuê (~0.00203928 SOL trên mainnet cho một tài khoản SPL Token vanilla) đến destination_for_rent.
• Tài khoản token phải có số dư token bằng không.

• InvalidOwner — người gọi không phải là chủ sở hữu ATA.
• Số dư tài khoản token khác không.

​

Tiếp theo bạn nên tham khảo

• products/routing/code-demos — xây dựng từng instruction này bằng TypeScript.
• products/routing/accounts — các khoá dispatch theo AMM và bố cục tài khoản theo hop.
• reference/error-codes — danh sách đầy đủ RouteError.