CLMM 명령어

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

​

명령어 목록

​

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으로 초기화됩니다(해당 풀에서 영구적으로 동적 수수료 비활성화).

​

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, 수수료 성장 스냅샷 유지).
• 포지션이 범위 내인 경우(tick_lower ≤ tick_current < tick_upper) pool_state.liquidity += L.

​

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

• personal_position.liquidity == 0.
• tokens_fees_owed_{0,1} == 0.
• 모든 리워드 카운터 reward_amount_owed == 0.

• NFT를 소각합니다.
• NFT 민트 계정과 personal_position 계정을 종료하고, payer에게 렌트를 환급합니다.

​

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. 지정가 주문 매칭 — 가격 이동이 미체결 지정가 주문이 있는 틱을 통과할 때, 프로그램은 먼저 해당 틱의 지정가 주문 유동성을 order_phase 순서로 FIFO 방식으로 체결한 후 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       // 사용자가 선택한 nonce 계정 인덱스 (지갑당 0..255)
zero_for_one:   bool     // true: token0으로 token1 매도; false: token1으로 token0 매도
tick_index:     i32      // pool.tick_spacing의 배수이어야 함
amount:         u64      // 입력 토큰 수량

• tick_index % pool.tick_spacing == 0이고 [MIN_TICK, MAX_TICK] 범위 내에 있어야 합니다.
• tick_index는 선택한 방향에 맞게 pool.tick_current의 올바른 쪽에 있어야 합니다(token0 매도 → 틱이 현재보다 위에 있어야 하며, 그 반대도 마찬가지). 이미 통과된 틱에서의 매도는 즉시 매칭되므로 거부됩니다.
• pool_state.status가 지정가 주문 작업을 허용해야 합니다(비트 5).

• 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이어야 합니다(전액 체결 및 정산되었거나, 소유자가 이전에 주문을 0으로 감소시키고 종료하지 않은 경우).

• limit_order를 종료하고, 렌트를 limit_order.owner에게 전송합니다.

​

CreateDynamicFeeConfig (admin)

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 (admin)

​

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으로 초기화합니다.

​

상태 변경 매트릭스

​

다음 단계

• products/clmm/code-demos — 실행 가능한 TypeScript 샘플.
• products/clmm/fees — 수수료 및 리워드 발생에 대한 세부 정보.
• reference/error-codes — 전체 CLMM Anchor 오류 표.

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