Hướng dẫn CLMM

​

Danh sách hướng dẫn

​

CreatePool

sqrt_price_x64: u128           // giá ban đầu
open_time:      u64            // swap bị từ chối trước thời gian 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 phần mở rộng 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ị trí).
• pool_state.fee_on = FromInput (mặc định cũ).
• pool_state.dynamic_fee_info được đặt thành 0 (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 thành biến thể CollectFeeOn được 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 thành 0).
• Nếu không: pool_state.dynamic_fee_info được đặt thành 0 (= phí động không hoạt động mãi mãi cho pool này).

​

CreatePermissionedPool

customizable_params: CreateCustomizableParams   // cùng struct như CreateCustomizablePool
seed_index:          u16                          // phải khác 0; được gấp vào seed PDA pool

• seed_index != 0. Một seed_index bằng 0 được dành riêng cho các pool cũ và bị từ chối ở đây; thành phần seed [0, 0] là những gì làm cho địa chỉ pool cũ sụp đổ thành dạng bốn seed cổ điển.
• PDA permission cho payer tồn tại (được tạo bởi admin qua CreatePermissionPda).
• Các quy tắc mint / danh sách cho phép giống như CreatePool.

• Một pool_state mới tồn tại ở địa chỉ được lấy từ seed_index, với pool_state.seed_index = seed_index.
• Tất cả các trạng thái hậu khác khớp với CreateCustomizablePool (chế độ phí, phí động tùy chọn).

​

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 để sử dụng số tiền bên dưới)
amount_0_max: u64
amount_1_max: u64
with_metadata: bool           // viết siêu dữ liệu NFT (Metaplex)
base_flag: Option<bool>       // true = vừa với amount0; false = vừa với amount1

• tick_lower < tick_upper, cả hai là bội số của pool.tick_spacing, trong [MIN_TICK, MAX_TICK].
• Các tick array bắt buộc được chuyển và khởi tạo (hoặc được tạo ở đây qua InitTickArray CPI trong giao dịch).
• Người dùng có ít nhất amount_0_max và amount_1_max trong ATA nguồn.

• personal_position tồn tại, liquidity được đặt, fee_growth_inside_last được chụp.
• Các mục tick-array ở tick_lower và tick_upper được cập nhật (liquidity_gross += L, liquidity_net ± L, ảnh chụp tăng trưởng phí được duy trì).
• pool_state.liquidity += L nếu vị trí nằm trong phạm vi (tick_lower ≤ tick_current < tick_upper).
• Mint NFT vị trí ghi lại pool_state làm cơ quan đóng băng. Cơ quan mint được loại bỏ sau khi mint NFT duy nhất. Ghi lại cơ quan đóng băng không thay đổi trạng thái của tài khoản token NFT.
• Tài khoản token NFT vẫn không bị đóng băng trừ khi hướng dẫn là OpenPositionV2 hoặc OpenPositionWithToken22Nft và cơ quan đóng băng của mint vault khớp với danh sách nhà phát hành bị hạn chế của CLMM. Chỉ đường dẫn V2 khớp đó mới đóng băng tài khoản. OpenPosition V1 không đóng băng.

​

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 nằm trong phạm vi), và liquidity_gross / liquidity_net tick điểm cuối tương ứng.
• Thu thập phí và phần thưởng nợ kể từ lần chạm cuối cùng và ghi có chúng vào tokens_fees_owed_{0,1} / reward_amount_owed. Những khoản này chỉ được trả 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 toán (amount_0, amount_1) cho L được loại bỏ cho sqrt_price_x64 hiện tại.
• Giải quyết phí/phần thưởng tích lũy kể từ lần chạm cuối cùng, giống như IncreaseLiquidity.
• Chuyển amount_0 + fees_owed_0 và amount_1 + fees_owed_1 từ vault đến người dùng.
• Giảm bộ đếm thanh khoản; nếu personal_position.liquidity == 0 mới, vị trí đủ điều kiện cho ClosePosition.

​

ClosePosition

• NFT không bị đóng băng: không cần; một tài khoản pool bổ sung là vô hại vì trình xử lý không đọc nó.
• NFT bị đóng băng: thêm personal_position.pool_id làm tài khoản còn lại đầu tiên. Chương trình tải nó dưới dạng PoolState và sử dụng seed PDA của nó để ký thaw.

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

• Nếu tài khoản token NFT bị đóng băng, xác minh tài khoản còn lại đầu tiên bằng personal_position.pool_id, sau đó rã đông nó với PDA pool.
• Đốt NFT.
• Đóng tài khoản token NFT và personal_position, hoàn lại tiền thuê cho nft_owner. Nếu NFT vị trí sử dụng Token-2022, nó cũng đóng mint NFT; mint Token SPL cổ điển không thể đóng và vẫn có cung cấp bằng 0.

​

SwapV2

amount: u64                  // đầu vào nếu is_base_input=true, đầu ra nếu không
other_amount_threshold: u64  // tối thiểu ra hoặc tối đa 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 ở phía chính xác của sqrt_price_x64 cho hướng.

1. Phí bổ sung động — nếu pool.dynamic_fee_info khác 0, chương trình cập nhật bộ tích lũy biến động bằng cách sử dụng khoảng cách tick được duyệt kể từ lần swap cuối cùng (với các quy tắc bộ lọc/phân rã từ products/clmm/fees) và thêm dynamic_fee_component trên AmmConfig.trade_fee_rate. Tổng phí được giới hạn ở 10% (MAX_FEE_RATE_NUMERATOR / 1_000_000).
2. Khớp lệnh giới hạn — khi bước đi giá vượt qua một tick giữ các lệnh giới hạn mở, chương trình trước tiên điền thanh khoản lệnh giới hạn có sẵn ở tick đó (FIFO theo order_phase), sau đó tiếp tục dọc theo đường cong thanh khoản LP. Các số tiền đã điền cập nhật tick.unfilled_ratio_x64 và tick.part_filled_orders_remaining để giải quyết sau; các lệnh chính nó 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 đến phía được cấu hình. Đối với các hướng mà phía phí được cấu hình là đầu ra, phí được khấu trừ từ đầu ra swap (người dùng nhận out − fee); đối với các hướng 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ỉ mục tài khoản nonce được chọn của người dùng (0..255 trên 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      // số tiền token đầu vào

• Cả input_token_account và output_token_account đều không bị đóng băng (nếu không NotApproved).
• pool_state.status cho phép cả hoạt động swap (bit 4) và lệnh giới hạn (bit 5) (nếu không NotApproved).
• tick_index % pool.tick_spacing == 0 và trong [MIN_TICK, MAX_TICK].
• tick_index nằm ở phía bên phải của pool.tick_current cho hướng được chọn (bán token0 → tick phải ở trên hiện tại, và ngược lại). Bán ở một tick đã vượt qua sẽ được khớp ngay lập tức và bị từ chối.

• limit_order tồn tại, chụp tick.order_phase và tick.unfilled_ratio_x64 khi mở.
• tick.orders_amount += amount (trong nhóm hiện tại).
• limit_order_nonce.order_nonce += 1.
• OpenLimitOrderEvent được phát hành.

​

IncreaseLimitOrder

amount: u64    // số tiền token đầu vào bổ sung

• limit_order.owner == signer.
• Lệnh vẫn nằm trong cùng một nhóm (tick.order_phase == limit_order.order_phase). Nếu nhóm đã bắt đầu điền, lệnh được giải quyết 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 chủ sở hữu đến input_vault.
• limit_order.total_amount += amount; tick.orders_amount += amount.

​

DecreaseLimitOrder

amount:     u64    // số tiền token đầu vào để rút (tối đa = phần còn lại chưa điền)
amount_min: u64    // sàn slippage trên rút phía đầu vào

• Tính toán lại số tiền đã điền của lệnh từ unfilled_ratio_x64 của nhóm kể từ khi mở.
• Gửi đầu ra đã điền đến output_token_account.
• Gửi amount của đầu vào chưa điền trở lại input_token_account.
• Cập nhật limit_order tương ứng. Nếu phần còn lại chưa điền mới bằng 0, chương trình đóng tài khoản và hoàn lại tiền thuê cho owner.

​

SettleLimitOrder

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

​

CloseLimitOrder

• Lệnh có phần còn lại chưa điền bằng 0 (hoặc amount == total_amount được điền và giải quyết, hoặc chủ sở hữu trước đó giảm lệnh xuống 0 và quên đóng).

• Đóng limit_order; tiền thuê đượ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 = 50% giữ lại trên mỗi cửa sổ phân rã
dynamic_fee_control:         u32   // 1..100_000; lợi ích trên đường cong biến động-phí
max_volatility_accumulator:  u32   // 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 hoạt động trên pool.
• Người tài trợ gửi total_emission = emissions_per_second × (end_time − open_time) giá trị token phần thưởng vào vault như một phần của hướng dẫn này.
• Mint phần thưởng được liệt kê trắng theo operation_state.

​

SetRewardParams

​

UpdateRewardInfos

​

CollectReward

• Giải quyết tăng trưởng phần thưởng (cùng mẫu như phí).
• Chuyển số tiền nợ đến ATA người nhận, đặt lại reward_amount_owed[i].

​

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

​

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 hoàn chỉnh.

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