Hướng dẫn lệnh CLMM

​

Danh sách lệnh

​

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 kế thừa).
• 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 của 0 được dành riêng cho các pool kế thừa và bị từ chối ở đây; thành phần seed [0, 0] là những gì làm cho địa chỉ pool kế thừa 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 sau 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 dưới đây)
amount_0_max: u64
amount_1_max: u64
with_metadata: bool           // ghi 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 bội số của pool.tick_spacing, trong [MIN_TICK, MAX_TICK].
• Hai PDA tick-array được truyền. Chúng không cần phải tồn tại — get_or_create_tick_array phân bổ một cái bị thiếu ở chi phí của payer bên trong lệnh này. Không có lệnh init-tick-array riêng biệt.
• 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 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 NFT duy nhất được mint. 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 lệnh là OpenPositionV2 hoặc OpenPositionWithToken22Nft và cơ quan phát hành hạn chế của mint vault bất kỳ khớp với danh sách. 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 token_fees_owed_{0,1} / reward_amount_owed. Những cái đó chỉ được trả ra trên DecreaseLiquidity / DecreaseLiquidityV2, không phải trên tăng — không có lệnh thu thập độc lập.

​

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 ra khỏi vault cho người dùng.
• Giảm bộ đếm thanh khoản; nếu personal_position.liquidity mới == 0, 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: nối personal_position.pool_id làm tài khoản còn lại đầu tiên. Chương trình tải nó làm PoolState và sử dụng seed PDA của nó để ký rã đông.

• 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 pool PDA.
• Đốt NFT.
• Đóng tài khoản token NFT và personal_position, hoàn lại tiền thuê nhà cho nft_owner. Nếu NFT vị trí sử dụng Token-2022, nó cũng đóng mint NFT; mint SPL Token cổ điển không thể đóng và vẫn có cung cấp 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ụ phí phí độ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ừ 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 của chúng 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 tại thời gian 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 về phía trước.

• 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 trượt giá 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 quay 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ê nhà 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