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] 범위 내.
• 필요한 틱 배열이 전달되고 초기화됨 (또는 트랜잭션에서 InitTickArray CPI를 통해 여기서 생성됨).
• 사용자는 소스 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을 그에 따라 조정합니다.
• 마지막 터치 이후 지불해야 할 수수료와 보상을 수집하고 tokens_fees_owed_{0,1} / reward_amount_owed에 입금합니다. 이들은 DecreaseLiquidity 또는 CollectReward에서만 지불되며, 증가 시에는 지불되지 않습니다.

​

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 토큰 민트는 닫을 수 없으며 공급량 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    // 입력 쪽 인출에 대한 슬리피지 하한

• 열기 이후 코호트의 unfilled_ratio_x64에서 주문의 채워진 금액을 재계산합니다.
• 채워진 출력을 output_token_account로 보냅니다.
• 미체결 입력의 amount를 input_token_account로 다시 보냅니다.
• limit_order를 그에 따라 업데이트합니다. 새로운 미체결 나머지가 0이면, 프로그램은 계정을 닫고 임차료를 owner에게 환불합니다.

​

SettleLimitOrder

• (limit_order.unfilled_ratio_x64, tick.unfilled_ratio_x64)를 사용하여 누적 출력 지불액을 계산합니다.
• 델타를 output_token_account로 전송합니다.
• limit_order.settled_output을 업데이트합니다.
• 주문을 닫지 않습니다. 남은 입력에 대해 여전히 열려 있습니다.

​

CloseLimitOrder

• 주문의 미체결 나머지가 0임 (amount == total_amount가 채워지고 정산되었거나, 소유자가 이전에 주문을 0으로 감소시키고 닫기를 잊음).

• limit_order를 닫습니다. 임차료는 limit_order.owner로 전송됩니다.

​

CreateDynamicFeeConfig (관리자)

index:                       u16
filter_period:               u16   // 초. 예: 30
decay_period:                u16   // 초. 예: 600. filter_period보다 커야 함
reduction_factor:            u16   // 1..10_000. 예: 5_000 = 감소 윈도우당 50% 유지
dynamic_fee_control:         u32   // 1..100_000. 변동성-수수료 곡선의 이득
max_volatility_accumulator:  u32   // 상한

​

UpdateDynamicFeeConfig (관리자)

​

CollectProtocolFee / CollectFundFee

​

InitializeReward

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

• 풀에서 현재 3개 미만의 스트림이 활성화됨.
• 펀더는 이 명령어의 일부로 total_emission = emissions_per_second × (end_time − open_time) 상당의 보상 토큰을 볼트에 입금합니다.
• operation_state당 화이트리스트된 보상 민트.

​

SetRewardParams

​

UpdateRewardInfos

​

CollectReward

• 보상 성장을 정산합니다 (수수료와 동일한 패턴).
• 지불해야 할 금액을 수신자 ATA로 전송하고, reward_amount_owed[i]를 0으로 설정합니다.

​

상태 변경 매트릭스