Các tài khoản CLMM

Mọi tài khoản mà một pool CLMM sử dụng: PoolState, AmmConfig, TickArrayState, TickArrayBitmapExtension, PersonalPositionState, và Observation.

Trang này được dịch tự động bằng AI. Phiên bản tiếng Anh là bản chính thức.

Xem bản tiếng Anh →

Trang này mô tả bố cục và vai trò của từng tài khoản. Các seed được liệt kê chính thức trong reference/program-addresses. Một pool CLMM sử dụng nhiều tài khoản hơn pool CPMM vì tính thanh khoản được lưu trữ thưa thớt trên phạm vi tick; phần lớn trang này giải thích tính thưa thớt đó.

​

Danh sách tài khoản

Một pool CLMM đang hoạt động được mô tả bởi các họ tài khoản sau. Tất cả đều được sở hữu bởi chương trình CLMM ngoại trừ hai mint và các vault của chúng.

Tài khoản	Mục đích	Số lượng trên mỗi pool
AmmConfig	Tầng phí: tỷ lệ phí giao dịch, chia sẻ giao thức, chia sẻ quỹ, tick-spacing mặc định. Được chia sẻ trên tất cả các pool trong tầng này.	1 (chia sẻ)
PoolState	sqrt_price_x64 hiện tại, tick hiện tại, tổng thanh khoản, toàn cục tăng trưởng phí, thông tin phần thưởng, con trỏ quan sát.	1
TickArrayState	Một khối TICK_ARRAY_SIZE tick liền kề. Chỉ được khởi tạo khi cần.	0 ≤ N ≤ phạm vi
TickArrayBitmapExtension	Bitmap tràn theo dõi tick array nào tồn tại vượt quá bitmap nội tuyến trong PoolState.	0 hoặc 1
PersonalPositionState	Một cho mỗi vị trí LP. Lưu trữ phạm vi, thanh khoản, và tăng trưởng phí/phần thưởng lần cuối cùng nhìn thấy. Authority = chủ sở hữu NFT.	1 trên mỗi vị trí
Position NFT mint	Mint với cung cấp 1, liên kết với PersonalPositionState. Tài khoản token của nó không bị đóng băng theo mặc định; V2 mở chỉ đóng băng nó khi một mint cơ bản khớp với bộ lọc restricted-issuer.	1 trên mỗi vị trí
ObservationState	Ring buffer của các quan sát giá cho TWAP.	1
token_0_vault, token_1_vault	Các tài khoản token giữ số dư của pool. Được sở hữu bởi pool authority.	2
DynamicFeeConfig	Bộ tham số có thể tái sử dụng cho cơ chế phí động. Các pool được tạo qua create_customizable_pool có thể chọn tham gia. Được quản lý bởi admin.	chia sẻ (trên mỗi chỉ mục)
LimitOrderState	Một cho mỗi lệnh giới hạn mở. Ghi lại chủ sở hữu, tick, bên, tổng số tiền, ảnh chụp đầu ra đã giải quyết.	1 trên mỗi lệnh
LimitOrderNonce	Bộ đếm (wallet, nonce_index) trên mỗi pool dẫn xuất các PDA lệnh duy nhất.	1 trên mỗi (wallet, chỉ mục)

​

PoolState

Trạng thái trực tiếp của pool, được đọc trên mỗi swap và mỗi thay đổi vị trí.

// programs/amm/src/states/pool.rs
pub struct PoolState {
    pub bump:           [u8; 1],
    pub amm_config:     Pubkey,            // fee tier binding
    pub owner:          Pubkey,            // admin (multisig)
    pub token_mint_0:   Pubkey,
    pub token_mint_1:   Pubkey,
    pub token_vault_0:  Pubkey,
    pub token_vault_1:  Pubkey,
    pub observation_key: Pubkey,

    pub mint_decimals_0: u8,
    pub mint_decimals_1: u8,
    pub tick_spacing:   u16,               // inherited from amm_config at init

    pub liquidity:      u128,              // total active (in-range) liquidity
    pub sqrt_price_x64: u128,              // Q64.64 of sqrt(price)
    pub tick_current:   i32,               // current tick index

    pub padding3:       u16,
    pub padding4:       u16,

    // Global fee growth per unit of liquidity, Q64.64.
    pub fee_growth_global_0_x64: u128,
    pub fee_growth_global_1_x64: u128,

    // Accrued-but-not-swept protocol fees (per mint).
    pub protocol_fees_token_0: u64,
    pub protocol_fees_token_1: u64,

    // Reserved padding for future upgrades.
    pub padding5: [u128; 4],

    // Status bitmask. Bits 0-5: open-position, decrease-liquidity,
    // collect-fee, collect-reward, swap, limit-order. A set bit disables
    // the corresponding operation.
    pub status:  u8,

    // Fee-collection mode (CollectFeeOn).
    //   0 = FromInput (deduct fee from the swap input — Uniswap-V3 default)
    //   1 = Token0Only (always deduct fee from token0 vault)
    //   2 = Token1Only (always deduct fee from token1 vault)
    pub fee_on: u8,

    // Client-supplied index (u16 LE) folded into the pool PDA seeds by
    // create_customizable_pool_v2. [0, 0] for pools created via CreatePool /
    // CreateCustomizablePool (the seed component collapses to empty).
    pub seed_index: [u8; 2],
    pub padding: [u8; 4],

    // Live reward streams (up to REWARD_NUM = 3).
    pub reward_infos: [RewardInfo; 3],

    // Inline bitmap tracking initialized tick-arrays in the primary range.
    pub tick_array_bitmap: [u64; 16],

    // Reserved padding for future upgrades.
    pub padding6: [u64; 4],

    pub fund_fees_token_0: u64,
    pub fund_fees_token_1: u64,

    pub open_time:    u64,                 // currently disabled by the program
    pub recent_epoch: u64,

    // Per-pool dynamic-fee state. Zero-valued unless the pool was
    // created with `enable_dynamic_fee = true` via create_customizable_pool.
    pub dynamic_fee_info: DynamicFeeInfo,

    // Reserved for future upgrades.
    pub padding1: [u64; 14],
    pub padding2: [u64; 32],
}

Các trường bạn sẽ thực sự sử dụng:

• sqrt_price_x64 và tick_current là trạng thái giá của pool. Chúng được cập nhật cùng nhau trên mỗi swap. tick_current là sàn của log_{1.0001}(price).
• liquidity là thanh khoản hoạt động — tổng các giá trị L cho tất cả các vị trí có phạm vi chứa tick_current. Nó thay đổi mỗi khi một swap vượt qua một tick và mỗi khi một vị trí được mở/đóng/thay đổi kích thước.
• fee_growth_global_{0,1}_x64 là các phí tích lũy trên mỗi đơn vị thanh khoản trên toàn bộ lịch sử pool. Các vị trí đọc điều này để tính toán những gì được nợ cho chúng.
• tick_spacing được khóa vào AmmConfig khi khởi tạo và không bao giờ thay đổi. Nó xác định chỉ số tick nào được phép là điểm cuối vị trí.
• tick_array_bitmap là một bitmap nội tuyến bao phủ phạm vi tick thường được sử dụng xung quanh giá spot. Đối với các pool có vị trí đạt xa, theo dõi tràn sống trong TickArrayBitmapExtension riêng biệt.
• fee_on được cố định khi tạo pool. 0 (FromInput) tái tạo hành vi Uniswap-V3 cổ điển. 1 và 2 định tuyến phí swap sang một bên của sách — xem products/clmm/fees để biết các sự đánh đổi.
• seed_index là [0, 0] cho mọi pool được tạo thông qua CreatePool / CreateCustomizablePool (một pool chính thức trên mỗi cặp). Một giá trị khác không có nghĩa là pool được tạo qua CreateCustomizablePoolV2 (được đặt tên CreatePermissionedPool trước 2026-10-22) và chỉ mục là một phần của các seed PDA của pool, cho phép nhiều pool cùng tồn tại cho cùng một (config, mint0, mint1). Để dẫn xuất lại địa chỉ của pool như vậy, bạn phải biết seed_index của nó.
• dynamic_fee_info mang trạng thái biến động cho khoản phí động. Khi được bật, mỗi swap tính toán lại một dynamic_fee_component trên AmmConfig.trade_fee_rate. Bố cục được ghi chép dưới DynamicFeeInfo bên dưới; các pool không có phí động để toàn bộ struct bằng không.

​

AmmConfig

pub struct AmmConfig {
    pub bump: u8,
    pub index: u16,                       // uses "amm_config"+u16 seed

    pub owner:             Pubkey,        // protocol-fee owner (CollectProtocolFee)
    pub protocol_fee_rate: u32,           // fraction of trade fee to protocol, denom 1e6
    pub trade_fee_rate:    u32,           // trade fee in 1e6ths of volume
    pub tick_spacing:      u16,           // default spacing for pools using this config
    pub fund_fee_rate:     u32,           // fraction of trade fee to fund, denom 1e6
    pub padding_u32: u32,

    pub fund_owner: Pubkey,               // fund-fee owner (CollectFundFee)
    pub padding: [u64; 3],
}

Kể từ bản nâng cấp 2026-09, CreateAmmConfig ghi protocol_fee_owner::ID được mã hóa cứng của chương trình vào owner và fund_fee_owner::ID vào fund_owner. Trước đó, nó sao chép khóa của người ký admin vào cả hai. Các config hiện có giữ bất kỳ thứ gì chúng được tạo hoặc xoay vòng, vì vậy hãy đọc cả hai trường từ tài khoản. Các tham số UpdateAmmConfig 3 / 4 vẫn xoay vòng chúng. Các địa chỉ nằm trong reference/program-addresses.

Một bộ tầng phí CLMM được xuất bản điển hình (xác nhận so với GET https://api-v3.raydium.io/main/clmm-config):

Chỉ mục	trade_fee_rate	Tick spacing	Sử dụng điển hình
0	100 (0.01%)	1	Cặp ổn định, USDC/USDT
1	500 (0.05%)	10	Blue-chip tương quan
2	2_500 (0.25%)	60	Cặp tiêu chuẩn
3	10_000 (1.00%)	120	Biến động hoặc long-tail

protocol_fee_rate và fund_fee_rate là các phân số của phí giao dịch; cùng quy ước như CPMM. Xem products/clmm/fees.

​

TickArrayState

CLMM không lưu trữ một bản ghi riêng cho mỗi tick. Điều đó sẽ tạo ra hàng tỷ tài khoản. Thay vào đó, nó nhóm TICK_ARRAY_SIZE tick liền kề (đã khởi tạo hoặc chưa) (thường là 60 hoặc 88 tùy theo phiên bản chương trình) thành một TickArrayState được tạo một cách lười biếng khi lần đầu tiên sử dụng.

pub const TICK_ARRAY_SIZE: usize = 60;
pub const TICK_ARRAY_SIZE_USIZE: usize = 60;

pub struct TickArrayState {
    pub pool_id:                Pubkey,
    pub start_tick_index:       i32,                            // lowest tick in this array
    pub ticks:                  [TickState; TICK_ARRAY_SIZE],   // 60 entries
    pub initialized_tick_count: u8,
    pub recent_epoch:           u64,
    pub padding:                [u8; 107],
}

pub struct TickState {
    pub tick:                       i32,
    pub liquidity_net:              i128,                       // ΔL when crossing this tick upward
    pub liquidity_gross:            u128,                       // total L referencing this tick
    pub fee_growth_outside_0_x64:   u128,                       // see math.mdx
    pub fee_growth_outside_1_x64:   u128,
    pub reward_growths_outside_x64: [u128; 3],

    // Limit-order bookkeeping. All zero for ticks that have never carried
    // a limit order. See products/clmm/math for the matching algorithm.
    pub order_phase:                  u64,                      // monotonic FIFO cohort id
    pub orders_amount:                u64,                      // unfilled tokens in current cohort
    pub part_filled_orders_remaining: u64,                      // remaining tokens of partially-filled cohort
    pub unfilled_ratio_x64:           u128,                     // Q64.64; starts at 1.0 and shrinks as fills occur

    pub padding:                    [u32; 3],
}

Bốn trường limit-order là zero trên bất kỳ tick nào chưa bao giờ được sử dụng cho limit order. Khi các đơn hàng được mở trên một tick, chương trình theo dõi chúng dưới dạng một chuỗi các cohort:

• order_phase là id của cohort. Nó tăng lên mỗi khi một cohort chuyển từ “hoàn toàn chưa điền” sang “một phần đã điền”.
• orders_amount là tổng token đầu vào của cohort hiện tại (mới nhất).
• part_filled_orders_remaining theo dõi cohort trước đó hiện đang được điền bởi các swap đang diễn ra.
• unfilled_ratio_x64 là một bộ nhân Q64.64 được mang trên cohort: khi một swap điền X% của cohort, tỷ lệ được nhân với (1 − X). Mỗi đơn hàng mở lưu trữ ảnh chụp (order_phase, unfilled_ratio_x64) của riêng nó tại thời điểm mở, vì vậy toán học settle được rút gọn thành so sánh các ảnh chụp.

Quy tắc:

• Một tick điểm cuối vị trí t phải thỏa mãn t % tick_spacing == 0. Chương trình từ chối các vị trí không đúng khoảng cách.
• Mảng của tick được đặt tại floor(t / (TICK_ARRAY_SIZE * tick_spacing)) * (TICK_ARRAY_SIZE * tick_spacing).
• Một mảng tick được khởi tạo một cách lười biếng: vị trí hoặc swap đầu tiên chạm vào một mảng chưa được khởi tạo sẽ tạo nó, trả tiền thuê.
• Một mảy tick không bao giờ được đóng bởi chương trình. Sau khi được cấp phát, nó tồn tại suốt vòng đời của pool, ngay cả sau khi mọi tick bên trong nó quay trở lại liquidity_gross == 0. Các vị trí và swap tiếp theo sử dụng lại tài khoản hiện có mà không cần thuê thêm. Không có đường dẫn dọn dẹp do ClosePosition điều khiển cho các mảng tick.

​

TickArrayBitmapExtension

PoolState.tick_array_bitmap (inline) bao phủ phạm vi “gần spot” — ±512 mảng tick (TICK_ARRAY_BITMAP_SIZE = 512; trường [u64; 16] là 1.024 bit chia đều giữa các chỉ số bắt đầu âm và dương, vì vậy chỉ số mảng −512 … +511). Ngoài phạm vi đó (đối với các giá trị tick cực đoan), chương trình duy trì một tài khoản mở rộng:

pub struct TickArrayBitmapExtension {
    pub pool_id: Pubkey,
    pub positive_tick_array_bitmap: [[u64; 8]; 14],
    pub negative_tick_array_bitmap: [[u64; 8]; 14],
}

Nếu phạm vi vị trí của bạn là “bình thường”, bạn không bao giờ cần suy nghĩ về tài khoản mở rộng. Các vị trí toàn phạm vi (ví dụ: (MIN_TICK, MAX_TICK)) yêu cầu nó; SDK sẽ giải quyết nó cho bạn.

​

Vị trí

Một vị trí CLMM là một gói gồm ba tài khoản cộng với một mint:

​

Mint NFT vị trí

Một mint SPL Token hoặc Token-2022 có cung cấp 1. NFT vị trí trong ví của chủ sở hữu là một ATA giữ token duy nhất đó. Chương trình ủy quyền khóa cho chủ sở hữu hiện tại của số dư ATA của NFT, không phải cho một Pubkey được lưu trữ trong trạng thái.

Các mint NFT vị trí mới đặt pool_state làm freeze authority của chúng trước khi mint token duy nhất và loại bỏ mint authority. Đặt freeze authority không tự động đóng băng tài khoản NFT. Tài khoản vẫn không bị đóng băng và có thể chuyển được trừ khi cả hai điều kiện được thỏa mãn: người gọi sử dụng OpenPositionV2 hoặc OpenPositionWithToken22Nft, và freeze authority của ít nhất một mint vault cơ bản xuất hiện trong danh sách restricted-issuer của CLMM. Chỉ khi đó CLMM mới đóng băng tài khoản NFT sau khi mint. Điều này không thay đổi bất kỳ byte PersonalPositionState hoặc PoolState nào.

​

PersonalPositionState

Một cho mỗi vị trí mở. Được khóa từ mint NFT.

pub struct PersonalPositionState {
    pub bump: [u8; 1],
    pub nft_mint: Pubkey,                 // this position's NFT mint
    pub pool_id:  Pubkey,

    pub tick_lower_index: i32,
    pub tick_upper_index: i32,

    pub liquidity: u128,                  // this position's L

    // Fee-growth snapshots at last time the position was touched.
    pub fee_growth_inside_0_last_x64: u128,
    pub fee_growth_inside_1_last_x64: u128,
    pub token_fees_owed_0: u64,           // accrued since last collect
    pub token_fees_owed_1: u64,

    pub reward_infos: [PositionRewardInfo; 3],
    pub recent_epoch: u64,
    pub padding: [u64; 7],
}

pub struct PositionRewardInfo {
    pub growth_inside_last_x64: u128,
    pub reward_amount_owed: u64,
}

​

ProtocolPositionState (không dùng nữa)

Các bản phát hành CLMM cũ hơn lưu trữ sổ cái tổng hợp theo (pool, tick_lower, tick_upper) trong một PDA ProtocolPositionState. Các bản phát hành mới không còn tạo hoặc đọc tài khoản này. Slot vẫn xuất hiện trong danh sách tài khoản OpenPosition / IncreaseLiquidity / DecreaseLiquidity dưới dạng UncheckedAccount để tương thích ABI, nhưng chương trình không ghi vào nó. Các tài khoản hiện có trên chuỗi là dư thừa; quản trị viên có thể gọi CloseProtocolPosition để lấy lại tiền thuê cho chúng.

Sổ cái phạm vi tổng hợp hiện được lấy trực tiếp từ hai tick điểm cuối (liquidity_gross, liquidity_net và fee_growth_outside_* / reward_growths_outside_x64 theo tick) trong TickArrayState. Công thức fee-growth-inside fee_growth_inside = global − outside_lower − outside_upper tiếp tục hoạt động mà không cần tài khoản vị trí tổng hợp.

​

Quan sát

pub const OBSERVATION_NUM: usize = 100;

pub struct Observation {
    pub block_timestamp: u32,
    pub tick_cumulative: i64,                            // Σ tick_current × Δt
    pub padding:         [u64; 4],
}

pub struct ObservationState {
    pub initialized:       bool,
    pub recent_epoch:      u64,
    pub observation_index: u16,
    pub pool_id:           Pubkey,
    pub observations:      [Observation; OBSERVATION_NUM], // 100 entries
    pub padding:           [u64; 4],
}

Bộ đệm quan sát của CLMM lưu trữ một tick tích lũy, không phải giá tích lũy. Các người tiêu dùng bên ngoài tính giá trung bình hình học trong một khoảng thời gian từ (tick_cumulative[t1] − tick_cumulative[t0]) / (t1 − t0) và sau đó price = 1.0001 ** tick. Xem algorithms/clmm-math.

​

DynamicFeeConfig và DynamicFeeInfo

Các tham số phí động sống ở hai nơi. Mẫu có thể tái sử dụng — DynamicFeeConfig — được quản lý bởi quản trị viên và chia sẻ giữa các pool chọn tham gia. Trạng thái thời gian chạy theo pool — DynamicFeeInfo — được nhúng trong PoolState và được cập nhật bởi mỗi swap.

​

DynamicFeeConfig

// programs/amm/src/states/pool_fee.rs
pub struct DynamicFeeConfig {
    pub index:                       u16,    // identifier; PDA seed component
    pub filter_period:               u16,    // seconds — within this window the volatility reference is held
    pub decay_period:                u16,    // seconds — beyond this window the reference fully decays
    pub reduction_factor:            u16,    // fixed-point in [1, 10_000); applied at decay
    pub dynamic_fee_control:         u32,    // fixed-point in (0, 100_000); fee-rate gain
    pub max_volatility_accumulator:  u32,    // ceiling on the volatility accumulator
    pub padding:                     [u64; 8],
}

Hạt giống PDA: ["dynamic_fee_config", index.to_be_bytes()]. Được tạo thông qua create_dynamic_fee_config (được bảo vệ bởi quản trị viên) và được sửa đổi thông qua update_dynamic_fee_config. Một pool được tạo với enable_dynamic_fee = true chụp năm tham số hiệu chỉnh của cấu hình (filter_period, decay_period, reduction_factor, dynamic_fee_control, max_volatility_accumulator) vào DynamicFeeInfo của riêng nó tại thời điểm tạo; các chỉnh sửa sau này đối với DynamicFeeConfig không ảnh hưởng retroactively đến các pool hiện có.

​

DynamicFeeInfo (nhúng trong PoolState)

pub struct DynamicFeeInfo {
    pub filter_period:                u16,
    pub decay_period:                 u16,
    pub reduction_factor:             u16,
    pub dynamic_fee_control:          u32,
    pub max_volatility_accumulator:   u32,
    pub tick_spacing_index_reference: i32,    // tick-spacing-units; reference for next swap
    pub volatility_reference:         u32,    // running floor for the accumulator
    pub volatility_accumulator:       u32,    // current cumulative volatility (capped)
    pub last_update_timestamp:        u64,
    pub padding:                      [u8; 46],
}

Bốn trường dưới cùng là trạng thái; năm trường trên cùng là hiệu chỉnh được sao chép từ DynamicFeeConfig. Toán học phí và các quy tắc phân rã được ghi lại dưới products/clmm/math và products/clmm/fees.

Các hằng số được sử dụng bởi công thức:

Hằng số	Giá trị	Ý nghĩa
VOLATILITY_ACCUMULATOR_SCALE	10_000	Độ chi tiết của bộ tích lũy biến động
REDUCTION_FACTOR_DENOMINATOR	10_000	Mẫu số cho reduction_factor
DYNAMIC_FEE_CONTROL_DENOMINATOR	100_000	Mẫu số cho dynamic_fee_control
MAX_FEE_RATE_NUMERATOR	100_000	Giới hạn cứng 10% trên tỷ lệ phí kết quả

​

LimitOrderState

Một tài khoản cho mỗi limit order mở.

// programs/amm/src/states/limit_order.rs
pub struct LimitOrderState {
    pub pool_id:            Pubkey,
    pub owner:              Pubkey,
    pub tick_index:         i32,
    pub zero_for_one:       bool,    // direction: true sells token0 for token1
    pub order_phase:        u64,     // snapshot of TickState.order_phase at open time
    pub total_amount:       u64,     // input-token amount placed
    pub filled_amount:      u64,     // informational; computed precisely on settle
    pub settle_base:        u64,     // unfilled remainder at last settle/decrease
    pub settled_output:     u64,     // cumulative output-token paid to owner
    pub open_time:          u64,
    pub unfilled_ratio_x64: u128,    // Q64.64 snapshot of TickState.unfilled_ratio_x64 at open
    pub padding:            [u64; 4],
}

Vòng đời:

1. Mở — người dùng gọi open_limit_order, gửi total_amount của token đầu vào, đơn hàng được ràng buộc với một cohort TickState.
2. (tùy chọn) Tăng / Giảm — increase_limit_order thêm vào total_amount; decrease_limit_order trả lại các token chưa điền (và bất kỳ đầu ra đã settle nào cho đến thời điểm đó).
3. Settle — khi cohort được điền hoàn toàn hoặc một phần, chủ sở hữu hoặc người giữ gìn hoạt động gọi settle_limit_order để đẩy token đầu ra đến ATA của chủ sở hữu.
4. Đóng — khi unfilled_amount == 0, tài khoản có thể đóng được. Tiền thuê luôn quay trở lại owner.

Hạt giống PDA: [owner.as_ref(), limit_order_nonce.key().as_ref(), limit_order_nonce.order_nonce.to_be_bytes().as_ref()]. Do đó, PDA đơn hàng là duy nhất cho mỗi (owner, nonce_index, order_nonce).

​

LimitOrderNonce

Bộ đếm cho mỗi cặp (wallet, nonce_index) cho phép một người dùng chạy nhiều pipeline lệnh giới hạn song song mà không xảy ra va chạm PDA.

pub struct LimitOrderNonce {
    pub user_wallet: Pubkey,
    pub nonce_index: u8,             // user-chosen, 0..255
    pub order_nonce: u64,            // monotonic, incremented every time a new order is opened
    pub padding:     [u64; 4],
}

Seed PDA: [user_wallet.as_ref(), &[nonce_index]]. Hầu hết các client sử dụng nonce_index = 0 và để order_nonce mang lại tính chất cardinality.

​

Permission (đã loại bỏ)

Tài khoản Permission đã bị xóa trong bản nâng cấp 2026-10-22. Trước đây nó được sử dụng để kiểm soát CreatePermissionedPool, hiện nay là CreateCustomizablePoolV2 không yêu cầu quyền. Chương trình không còn đọc hoặc đóng các tài khoản này, và các lệnh CreatePermissionPda / ClosePermissionPda đã biến mất. Các PDA được tạo trước bản nâng cấp (["permission", authority], 280 byte) vẫn tồn tại trên chuỗi dưới dạng dữ liệu không hoạt động; hãy bỏ qua chúng khi quét các tài khoản do CLMM sở hữu.

​

Dẫn xuất các tài khoản chính

import { PublicKey } from "@solana/web3.js";

const CLMM_PROGRAM_ID = new PublicKey(
  "CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK"
); // see reference/program-addresses

function i32ToBytes(n: number): Buffer {
  const b = Buffer.alloc(4);
  b.writeInt32BE(n);
  return b;
}

export function deriveClmmAccounts(
  ammConfig: PublicKey,
  token0Mint: PublicKey,           // must already be sorted
  token1Mint: PublicKey,
) {
  const [poolState] = PublicKey.findProgramAddressSync(
    [Buffer.from("pool"), ammConfig.toBuffer(),
     token0Mint.toBuffer(), token1Mint.toBuffer()],
    CLMM_PROGRAM_ID,
  );
  // NOTE: pools created via CreateCustomizablePoolV2 append a non-zero u16
  // seed_index (LE) as a 5th seed — see deriveCustomizablePoolV2 below.
  const [observation] = PublicKey.findProgramAddressSync(
    [Buffer.from("observation"), poolState.toBuffer()],
    CLMM_PROGRAM_ID,
  );
  const [tickArrayBitmapExtension] = PublicKey.findProgramAddressSync(
    [Buffer.from("pool_tick_array_bitmap_extension"), poolState.toBuffer()],
    CLMM_PROGRAM_ID,
  );
  return { poolState, observation, tickArrayBitmapExtension };
}

export function deriveTickArray(
  pool: PublicKey,
  startTickIndex: number,
) {
  const [tickArray] = PublicKey.findProgramAddressSync(
    [Buffer.from("tick_array"), pool.toBuffer(), i32ToBytes(startTickIndex)],
    CLMM_PROGRAM_ID,
  );
  return tickArray;
}

export function deriveDynamicFeeConfig(index: number) {
  const idx = Buffer.alloc(2);
  idx.writeUInt16BE(index);
  const [pda] = PublicKey.findProgramAddressSync(
    [Buffer.from("dynamic_fee_config"), idx],
    CLMM_PROGRAM_ID,
  );
  return pda;
}

export function deriveCustomizablePoolV2(
  ammConfig: PublicKey,
  token0Mint: PublicKey,           // must already be sorted
  token1Mint: PublicKey,
  seedIndex: number,               // non-zero u16
) {
  const idx = Buffer.alloc(2);
  idx.writeUInt16LE(seedIndex);    // little-endian, unlike the u16 seeds above
  const [pool] = PublicKey.findProgramAddressSync(
    [Buffer.from("pool"), ammConfig.toBuffer(),
     token0Mint.toBuffer(), token1Mint.toBuffer(), idx],
    CLMM_PROGRAM_ID,
  );
  return pool;
}

export function deriveLimitOrderNonce(
  wallet: PublicKey,
  nonceIndex: number,
) {
  const [pda] = PublicKey.findProgramAddressSync(
    [wallet.toBuffer(), Buffer.from([nonceIndex & 0xff])],
    CLMM_PROGRAM_ID,
  );
  return pda;
}

export function deriveLimitOrder(
  wallet: PublicKey,
  nonceAccount: PublicKey,
  orderNonce: bigint,
) {
  const nonceBytes = Buffer.alloc(8);
  nonceBytes.writeBigUInt64BE(orderNonce);
  const [pda] = PublicKey.findProgramAddressSync(
    [wallet.toBuffer(), nonceAccount.toBuffer(), nonceBytes],
    CLMM_PROGRAM_ID,
  );
  return pda;
}

export function derivePersonalPosition(nftMint: PublicKey) {
  const [personalPosition] = PublicKey.findProgramAddressSync(
    [Buffer.from("position"), nftMint.toBuffer()],
    CLMM_PROGRAM_ID,
  );
  return personalPosition;
}

Các chuỗi seed chính xác nên luôn được kiểm tra lại với IDL trên chuỗi và reference/program-addresses.

​

Tham chiếu nhanh vòng đời

Sự kiện	Tài khoản được tạo	Tài khoản bị xóa
CreatePool	poolState, observation, token_0_vault, token_1_vault	—
OpenPosition[V2] / OpenPositionWithToken22Nft	NFT mint + ATA, personalPosition, có thể là tickArrayState mới, tickArrayBitmapExtension nếu chưa tồn tại; có thể đóng băng NFT ATA cho pool có restricted-issuer	—
IncreaseLiquidity	Có thể là tickArrayState mới	—
DecreaseLiquidity	—	Có thể xóa các mục tick (nhưng tickArrayState chính nó không bị đóng)
ClosePosition	—	NFT ATA, personalPosition, và Token-2022 NFT mint; classic SPL NFT mint vẫn ở supply zero. Đường dẫn đóng băng trước tiên được rã đông thông qua pool được truyền vào remaining accounts.
SwapV2	Có thể là tickArrayState mới	—
OpenLimitOrder	limitOrderState, có thể là limitOrderNonce (init-if-needed), có thể là tickArrayState mới	—
IncreaseLimitOrder	—	—
DecreaseLimitOrder	—	Đóng limitOrderState nếu lệnh được tiêu thụ hoàn toàn
SettleLimitOrder	—	—
CloseLimitOrder	—	limitOrderState (rent → owner)
CreateDynamicFeeConfig	dynamicFeeConfig	—
CreateCustomizablePool	poolState, observation, vaults — giống như CreatePool. Chụp ảnh dynamicFeeConfig nếu enable_dynamic_fee = true.	—
CreateCustomizablePoolV2	poolState (tại địa chỉ dẫn xuất từ seed_index), observation, vaults — giống như CreateCustomizablePool. Không yêu cầu quyền.	—
CollectRewards	—	—
UpdateRewardInfos	—	—
CloseProtocolPosition (admin)	—	protocolPositionState còn sót lại (rent → admin)

Các tài khoản TickArrayState không bao giờ bị chương trình đóng — chúng tồn tại suốt vòng đời của pool. Khi một tick array đã được khởi tạo, nó vẫn tồn tại trên chuỗi ngay cả khi mọi tick bên trong nó quay trở lại liquidity_gross == 0. Tái sử dụng một tick array hiện có là miễn phí; chỉ vị trí đầu tiên chạm vào một array chưa được khởi tạo mới phải trả tiền thuê của nó.

​

Nên đọc ở đâu

• Toán tick và cơ chế phạm vi: products/clmm/ticks-and-positions.
• Swap walk và toán phí-tăng trưởng: products/clmm/math.
• Danh sách tài khoản lệnh: products/clmm/instructions.
• Phí và tích lũy phần thưởng: products/clmm/fees.
• ID chương trình chính thức và seed: reference/program-addresses.

Nguồn:

• raydium-io/raydium-clmm — programs/amm/src/states