Hướng dẫn CLMM

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.

​

Danh sách lệnh

​

CreatePool

sqrt_price_x64: u128           // giá khởi tạo
open_time:      u64            // các swap bị từ chối trước thời điểm này

• token_mint_0 < token_mint_1 theo thứ tự byte.
• amm_config.disable_create_pool == false.
• Các mint không bị từ chối bởi danh sách cho phép extension Token-2022.

• pool_state.sqrt_price_x64 = sqrt_price_x64, tick_current = floor(log_{1.0001}(price)).
• pool_state.liquidity = 0 (chưa có vị thế nào).
• pool_state.fee_on = FromInput (mặc định legacy).
• pool_state.dynamic_fee_info bằng không (phí động bị vô hiệu hóa).

​

CreateCustomizablePool

pub struct CreateCustomizableParams {
    pub sqrt_price_x64:    u128,
    pub collect_fee_on:    CollectFeeOn,   // FromInput | Token0Only | Token1Only
    pub enable_dynamic_fee: bool,
}

• pool_state.fee_on được đặt theo biến thể CollectFeeOn đã chọn.
• Nếu phí động được bật: pool_state.dynamic_fee_info được khởi tạo từ DynamicFeeConfig được cung cấp (năm tham số hiệu chỉnh được sao chép; các trường trạng thái được đặt về không).
• Ngược lại: pool_state.dynamic_fee_info bằng không (= phí động không hoạt động vĩnh viễn đối với pool này).

​

OpenPositionV2 / OpenPositionWithToken22Nft

tick_lower_index: i32
tick_upper_index: i32
tick_array_lower_start_index: i32
tick_array_upper_start_index: i32
liquidity:  u128              // L mong muốn (hoặc 0 để dùng các số lượng bên dưới)
amount_0_max: u64
amount_1_max: u64
with_metadata: bool           // ghi metadata NFT (Metaplex)
base_flag: Option<bool>       // true = khớp với amount0; false = khớp với amount1

• tick_lower < tick_upper, cả hai đều là bội số của pool.tick_spacing, trong phạm vi [MIN_TICK, MAX_TICK].
• Các tick array cần thiết được truyền vào và đã khởi tạo (hoặc được tạo tại đây qua CPI InitTickArray trong transaction).
• Người dùng có ít nhất amount_0_max và amount_1_max trong các ATA nguồn.

• personal_position tồn tại, liquidity được đặt, fee_growth_inside_last được snapshot.
• Các mục tick-array tại tick_lower và tick_upper được cập nhật (liquidity_gross += L, liquidity_net ± L, duy trì snapshot tăng trưởng phí).
• pool_state.liquidity += L nếu vị thế trong phạm vi (tick_lower ≤ tick_current < tick_upper).

​

IncreaseLiquidityV2

liquidity: u128
amount_0_max: u64
amount_1_max: u64
base_flag: Option<bool>

• Chuyển amount_0_actual / amount_1_actual từ người dùng → vault.
• Tăng personal_position.liquidity và pool_state.liquidity (nếu trong phạm vi), cùng với liquidity_gross / liquidity_net của tick endpoint tương ứng.
• Thu phí và phần thưởng còn nợ kể từ lần chạm cuối và ghi có vào tokens_fees_owed_{0,1} / reward_amount_owed. Các khoản này chỉ được thanh toán khi DecreaseLiquidity hoặc CollectReward, không phải khi tăng.

​

DecreaseLiquidityV2

liquidity: u128
amount_0_min: u64
amount_1_min: u64

• Tính (amount_0, amount_1) cho L được rút dựa trên sqrt_price_x64 hiện tại.
• Thanh toán phí/phần thưởng tích lũy kể từ lần chạm cuối, tương tự IncreaseLiquidity.
• Chuyển amount_0 + fees_owed_0 và amount_1 + fees_owed_1 từ vault về cho người dùng.
• Giảm các bộ đếm thanh khoản; nếu personal_position.liquidity == 0 mới, vị thế đủ điều kiện để ClosePosition.

​

ClosePosition

• personal_position.liquidity == 0.
• tokens_fees_owed_{0,1} == 0.
• Tất cả bộ đếm phần thưởng reward_amount_owed == 0.

• Đốt NFT.
• Đóng tài khoản NFT mint và tài khoản personal_position, hoàn lại rent cho payer.

​

SwapV2

amount: u64                  // đầu vào nếu is_base_input=true, đầu ra nếu ngược lại
other_amount_threshold: u64  // tối thiểu nhận ra hoặc tối đa bỏ vào
sqrt_price_limit_x64: u128   // giới hạn cứng; 0 ⇒ không giới hạn
is_base_input: bool

• pool_state.status cho phép swap.
• now >= open_time.
• sqrt_price_limit_x64 nằm đúng phía so với sqrt_price_x64 theo chiều giao dịch.

1. Phụ thu phí động — nếu pool.dynamic_fee_info khác không, chương trình cập nhật bộ tích lũy biến động bằng khoảng cách tick đã duyệt kể từ swap cuối (theo các quy tắc lọc/suy giảm từ products/clmm/fees) và cộng thêm dynamic_fee_component vào AmmConfig.trade_fee_rate. Tổng phí được giới hạn ở mức 10% (MAX_FEE_RATE_NUMERATOR / 1_000_000).
2. Khớp lệnh giới hạn — khi hành trình giá vượt qua một tick có lệnh giới hạn đang mở, chương trình trước tiên điền thanh khoản lệnh giới hạn khả dụng tại tick đó (FIFO theo order_phase), sau đó tiếp tục theo đường cong thanh khoản LP. Các lượng đã khớp cập nhật tick.unfilled_ratio_x64 và tick.part_filled_orders_remaining để thanh toán sau; bản thân các lệnh vẫn chưa được chi tiêu cho đến khi chủ sở hữu gọi SettleLimitOrder.
3. Định tuyến phí một chiều — khi pool.fee_on = Token0Only hoặc Token1Only, bước swap vẫn tính toán cùng một giao dịch đầu vào-đầu ra; phí sau đó được định tuyến về phía đã cấu hình. Đối với các chiều mà phía phí cấu hình là đầu ra, phí được trừ từ đầu ra swap (người dùng nhận out − fee); đối với các chiều mà nó là đầu vào, hành vi khớp với FromInput. Xem is_fee_on_input(zero_for_one) và is_fee_on_token0(zero_for_one) trên PoolState.

​

OpenLimitOrder

nonce_index:    u8       // chỉ số tài khoản nonce do người dùng chọn (0..255 mỗi ví)
zero_for_one:   bool     // true: bán token0 lấy token1; false: bán token1 lấy token0
tick_index:     i32      // phải là bội số của pool.tick_spacing
amount:         u64      // lượng token đầu vào

• tick_index % pool.tick_spacing == 0 và trong phạm vi [MIN_TICK, MAX_TICK].
• tick_index nằm đúng phía so với pool.tick_current cho chiều đã chọn (bán token0 → tick phải cao hơn hiện tại, và ngược lại). Bán tại một tick đã được vượt qua sẽ bị khớp ngay lập tức và bị từ chối.
• pool_state.status cho phép thao tác lệnh giới hạn (bit 5).

• limit_order tồn tại, snapshot tick.order_phase và tick.unfilled_ratio_x64 tại thời điểm mở.
• tick.orders_amount += amount (trong cohort hiện tại).
• limit_order_nonce.order_nonce += 1.
• Phát ra sự kiện OpenLimitOrderEvent.

​

IncreaseLimitOrder

amount: u64    // lượng token đầu vào bổ sung

• limit_order.owner == signer.
• Lệnh vẫn còn trong cùng cohort (tick.order_phase == limit_order.order_phase). Nếu cohort đã bắt đầu điền, lệnh đã được thanh toán một phần — người gọi nên gọi DecreaseLimitOrder hoặc SettleLimitOrder trước để cuộn tiến.

• Chuyển amount từ ATA của owner đến input_vault.
• limit_order.total_amount += amount; tick.orders_amount += amount.

​

DecreaseLimitOrder

amount:     u64    // lượng token đầu vào cần rút (tối đa = phần chưa khớp còn lại)
amount_min: u64    // mức sàn slippage cho việc rút phía đầu vào

• Tính lại lượng đã khớp của lệnh từ unfilled_ratio_x64 của cohort kể từ lúc mở.
• Gửi đầu ra đã khớp đến output_token_account.
• Gửi amount đầu vào chưa khớp về input_token_account.
• Cập nhật limit_order tương ứng. Nếu phần chưa khớp còn lại mới bằng không, chương trình đóng tài khoản và hoàn lại rent cho owner.

​

SettleLimitOrder

• Tính đầu ra tích lũy còn nợ bằng cách dùng (limit_order.unfilled_ratio_x64, tick.unfilled_ratio_x64).
• Chuyển phần chênh lệch đến output_token_account.
• Cập nhật limit_order.settled_output.
• Không đóng lệnh; lệnh vẫn còn mở đối với bất kỳ đầu vào nào còn lại.

​

CloseLimitOrder

• Lệnh có phần chưa khớp còn lại bằng không (hoặc amount == total_amount đã được khớp và thanh toán, hoặc owner đã giảm lệnh về không trước đó và quên đóng).

• Đóng limit_order; rent được gửi đến limit_order.owner.

​

CreateDynamicFeeConfig (admin)

index:                       u16
filter_period:               u16   // giây; ví dụ 30
decay_period:                u16   // giây; ví dụ 600. Phải > filter_period
reduction_factor:            u16   // 1..10_000; ví dụ 5_000 = giữ lại 50% mỗi cửa sổ suy giảm
dynamic_fee_control:         u32   // 1..100_000; hệ số khuếch đại trên đường cong biến động-thành-phí
max_volatility_accumulator:  u32   // giới hạn trên

​

UpdateDynamicFeeConfig (admin)

​

CollectProtocolFee / CollectFundFee

​

InitializeReward

open_time:     u64
end_time:      u64
emissions_per_second_x64: u128   // Q64.64

• Ít hơn 3 luồng hiện đang hoạt động trên pool.
• Người cấp vốn nạp total_emission = emissions_per_second × (end_time − open_time) token phần thưởng vào vault như một phần của lệnh này.
• Mint phần thưởng được đưa vào danh sách trắng theo operation_state.

​

SetRewardParams

​

UpdateRewardInfos

​

CollectReward

• Thanh toán tăng trưởng phần thưởng (cùng mẫu với phí).
• Chuyển lượng còn nợ đến ATA người nhận, đặt reward_amount_owed[i] về không.

​

Ma trận thay đổi trạng thái

​

Bước tiếp theo

• products/clmm/code-demos — các mẫu TypeScript có thể chạy được.
• products/clmm/fees — chi tiết về tích lũy phí và phần thưởng.
• reference/error-codes — bảng lỗi Anchor CLMM đầy đủ.

• raydium-io/raydium-clmm — programs/amm/src/instructions
• Raydium SDK v2 — @raydium-io/raydium-sdk-v2