CLMM 명령어

​

명령어 목록

​

CreatePool

sqrt_price_x64: u128           // 초기 가격
open_time:      u64            // 이 시간 이전의 스왑은 거부됨

• token_mint_0 < token_mint_1 (바이트 순서).
• amm_config.disable_create_pool == false.
• 민트는 Token-2022 확장 허용 목록에 의해 거부되지 않습니다.

• pool_state.sqrt_price_x64 = sqrt_price_x64, tick_current = floor(log_{1.0001}(price)).
• pool_state.liquidity = 0 (아직 포지션 없음).
• pool_state.fee_on = FromInput (레거시 기본값).
• pool_state.dynamic_fee_info는 0으로 설정됨 (동적 수수료 비활성화).

​

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이 선택된 CollectFeeOn 변형으로 설정됨.
• 동적 수수료가 활성화된 경우: pool_state.dynamic_fee_info는 제공된 DynamicFeeConfig에서 초기화됨 (5개 보정 매개변수 복사됨, 상태 필드는 0으로 설정됨).
• 그렇지 않으면: pool_state.dynamic_fee_info는 0으로 설정됨 (= 이 풀에 대해 영구적으로 동적 수수료 비활성화).

​

CreatePermissionedPool

customizable_params: CreateCustomizableParams   // CreateCustomizablePool과 동일한 구조
seed_index:          u16                          // 0이 아니어야 함. 풀 PDA 시드에 포함됨

• seed_index != 0. seed_index가 0이면 레거시 풀용으로 예약되어 있으며 여기서 거부됩니다. [0, 0] 시드 구성요소는 레거시 풀 주소를 클래식 4시드 형태로 축소하는 것입니다.
• payer에 대한 permission PDA가 존재합니다 (관리자가 CreatePermissionPda를 통해 생성).
• CreatePool과 동일한 민트 / 허용 목록 규칙.

• 새로운 pool_state가 seed_index 파생 주소에 존재하며, pool_state.seed_index = seed_index.
• 다른 모든 사후 상태는 CreateCustomizablePool과 일치합니다 (수수료 모드, 선택적 동적 수수료).

​

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 (또는 아래 금액을 사용하려면 0)
amount_0_max: u64
amount_1_max: u64
with_metadata: bool           // NFT 메타데이터 작성 (Metaplex)
base_flag: Option<bool>       // true = amount0에 맞춤; false = amount1에 맞춤

• tick_lower < tick_upper, 모두 pool.tick_spacing의 배수, [MIN_TICK, MAX_TICK] 내.
• 두 개의 틱 배열 PDA가 전달됩니다. 이미 존재할 필요는 없습니다. get_or_create_tick_array는 이 명령어 내에서 payer의 비용으로 누락된 것을 할당합니다. 별도의 초기화 틱 배열 명령어는 없습니다.
• 사용자는 소스 ATA에 최소 amount_0_max와 amount_1_max를 가지고 있습니다.

• personal_position이 존재하고, liquidity가 설정되고, fee_growth_inside_last가 스냅샷됨.
• tick_lower와 tick_upper의 틱 배열 항목이 업데이트됨 (liquidity_gross += L, liquidity_net ± L, 수수료 성장 스냅샷 유지).
• 포지션이 범위 내에 있으면 pool_state.liquidity += L (tick_lower ≤ tick_current < tick_upper).
• 포지션 NFT 민트는 pool_state를 동결 권한으로 기록합니다. 민트 권한은 단일 NFT가 발행된 후 제거됩니다. 동결 권한을 기록하는 것은 NFT 토큰 계정의 상태를 변경하지 않습니다.
• NFT 토큰 계정은 명령어가 OpenPositionV2 또는 OpenPositionWithToken22Nft 이고 볼트 민트의 동결 권한이 CLMM의 제한된 발행자 목록과 일치하는 경우를 제외하고는 동결되지 않은 상태로 유지됩니다. 일치하는 V2 경로만 계정을 동결합니다. OpenPosition V1은 동결하지 않습니다.

​

IncreaseLiquidityV2

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

• 사용자 → 볼트에서 amount_0_actual / amount_1_actual을 전송합니다.
• personal_position.liquidity와 pool_state.liquidity (범위 내인 경우)를 증가시키고, 끝점 틱 liquidity_gross / liquidity_net을 그에 따라 증가시킵니다.
• 마지막 터치 이후 미지급 수수료 및 보상을 수집하고 token_fees_owed_{0,1} / reward_amount_owed에 입금합니다. 이들은 DecreaseLiquidity / DecreaseLiquidityV2에서만 지급되며, 증가에서는 지급되지 않습니다. 독립형 수집 명령어는 없습니다.

​

DecreaseLiquidityV2

liquidity: u128
amount_0_min: u64
amount_1_min: u64

• 현재 sqrt_price_x64가 주어진 제거된 L에 대해 (amount_0, amount_1)을 계산합니다.
• 마지막 터치 이후 발생한 수수료/보상을 정산합니다. IncreaseLiquidity와 동일합니다.
• amount_0 + fees_owed_0과 amount_1 + fees_owed_1을 볼트에서 사용자에게 전송합니다.
• 유동성 카운터를 감소시킵니다. 새로운 personal_position.liquidity == 0이면 포지션은 ClosePosition에 적합합니다.

​

ClosePosition

• 동결되지 않은 NFT: 필요 없음. 추가 풀 계정은 핸들러가 읽지 않으므로 무해합니다.
• 동결된 NFT: personal_position.pool_id를 첫 번째 남은 계정으로 추가합니다. 프로그램은 이를 PoolState로 로드하고 해동에 서명하기 위해 PDA 시드를 사용합니다.

• personal_position.liquidity == 0.
• tokens_fees_owed_{0,1} == 0.
• 모든 보상 카운터 reward_amount_owed == 0.

• NFT 토큰 계정이 동결되어 있으면, 첫 번째 남은 계정이 personal_position.pool_id와 같은지 확인한 다음 풀 PDA로 해동합니다.
• NFT를 소각합니다.
• NFT 토큰 계정과 personal_position을 닫고 임차료를 nft_owner에게 환불합니다. 포지션 NFT가 Token-2022를 사용하면 NFT 민트도 닫습니다. 클래식 SPL Token 민트는 닫을 수 없으며 공급량 0으로 유지됩니다.

​

SwapV2

amount: u64                  // is_base_input=true이면 입력, 그렇지 않으면 출력
other_amount_threshold: u64  // 최소 출력 또는 최대 입력
sqrt_price_limit_x64: u128   // 하드 바운드. 0 ⇒ 무제한
is_base_input: bool

• pool_state.status가 스왑을 허용합니다.
• now >= open_time.
• sqrt_price_limit_x64는 방향에 대해 sqrt_price_x64의 올바른 쪽에 있습니다.

1. 동적 수수료 할증 — pool.dynamic_fee_info가 0이 아니면, 프로그램은 마지막 스왑 이후 순회한 틱 거리를 사용하여 변동성 누적기를 업데이트하고 (필터/감소 규칙 포함 products/clmm/fees) AmmConfig.trade_fee_rate 위에 dynamic_fee_component를 추가합니다. 총 수수료는 10% (MAX_FEE_RATE_NUMERATOR / 1_000_000)로 제한됩니다.
2. 지정가 주문 매칭 — 가격 이동이 공개 지정가 주문을 보유한 틱을 지날 때, 프로그램은 먼저 해당 틱에서 사용 가능한 지정가 주문 유동성을 채웁니다 (FIFO by order_phase), 그 다음 LP 유동성 곡선을 따라갑니다. 채워진 금액은 나중의 정산을 위해 tick.unfilled_ratio_x64와 tick.part_filled_orders_remaining을 업데이트합니다. 주문 자체는 소유자가 SettleLimitOrder를 호출할 때까지 미지급 상태로 유지됩니다.
3. 단측 수수료 라우팅 — pool.fee_on = Token0Only 또는 Token1Only일 때, 스왑 단계는 여전히 동일한 입력 출력 거래를 계산합니다. 수수료는 구성된 쪽으로 라우팅됩니다. 구성된 수수료 쪽이 출력인 방향의 경우, 수수료는 스왑 출력에서 공제됩니다 (사용자는 out − fee를 받음). 입력인 방향의 경우, 동작은 FromInput과 일치합니다. PoolState의 is_fee_on_input(zero_for_one)과 is_fee_on_token0(zero_for_one)을 참조하세요.

​

OpenLimitOrder

nonce_index:    u8       // 사용자가 선택한 논스 계정 인덱스 (지갑당 0..255)
zero_for_one:   bool     // true: 토큰0을 토큰1로 판매; false: 토큰1을 토큰0으로 판매
tick_index:     i32      // pool.tick_spacing의 배수여야 함
amount:         u64      // 입력 토큰 금액

• input_token_account와 output_token_account 모두 동결되지 않음 (그렇지 않으면 NotApproved).
• pool_state.status가 스왑 (비트 4)과 지정가 주문 (비트 5) 작업을 모두 허용함 (그렇지 않으면 NotApproved).
• tick_index % pool.tick_spacing == 0이고 [MIN_TICK, MAX_TICK] 내.
• tick_index는 선택된 방향에 대해 pool.tick_current의 올바른 쪽에 있습니다 (토큰0 판매 → 틱은 현재 위에 있어야 하며, 그 반대도 마찬가지). 이미 지나간 틱에서 판매하면 즉시 매칭되며 거부됩니다.

• limit_order가 존재하고, 열기 시간에 tick.order_phase와 tick.unfilled_ratio_x64를 스냅샷합니다.
• tick.orders_amount += amount (현재 코호트에서).
• limit_order_nonce.order_nonce += 1.
• OpenLimitOrderEvent 발행됨.

​

IncreaseLimitOrder

amount: u64    // 추가 입력 토큰 금액

• limit_order.owner == signer.
• 주문은 여전히 동일한 코호트에 있습니다 (tick.order_phase == limit_order.order_phase). 코호트가 이미 채우기를 시작했으면 주문이 부분적으로 정산됩니다. 호출자는 먼저 DecreaseLimitOrder 또는 SettleLimitOrder를 호출하여 앞으로 이동해야 합니다.

• 소유자 ATA에서 input_vault로 amount를 전송합니다.
• limit_order.total_amount += amount. tick.orders_amount += amount.

​

DecreaseLimitOrder

amount:     u64    // 인출할 입력 토큰 금액 (최대 = 미체결 나머지)
amount_min: u64    // 입력 측 인출에 대한 슬리피지 바닥