메인 콘텐츠로 건너뛰기

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.

이 페이지는 AI 자동 번역입니다. 모든 내용은 영문판을 기준으로 합니다.영문판 보기 →

두 개의 독립적인 수수료, 네 개의 목적지

CPMM은 모든 스왑에 두 개의 별도 비율의 수수료를 부과합니다:
  1. 거래 수수료AmmConfig.trade_fee_rate에서 부과되며 세 개의 목적지로 분배됩니다:
    • LP 몫 — 볼트에 남아 k를 증가시킵니다. LP 토큰을 소각하여 암시적으로 청구됩니다.
    • 프로토콜 몫PoolState.protocol_fees_token*에 누적되며, CollectProtocolFee를 통해 protocol_owner가 수거합니다.
    • 펀드 몫PoolState.fund_fees_token*에 누적되며, CollectFundFee를 통해 fund_owner가 수거합니다.
  2. 크리에이터 수수료 (선택 사항, 풀별) — AmmConfig.creator_fee_rate에서 부과되며 거래 수수료와 독립적이고, PoolState.creator_fees_token*에 누적되며, CollectCreatorFee를 통해 pool_state.pool_creator가 수거합니다. 풀이 enable_creator_fee = true로 생성된 경우에만 활성화됩니다.
크리에이터 수수료는 거래 수수료의 일부가 아닙니다. 두 비율은 스왑 입력에서 수수료를 취할 때 함께 추가되지만, 각각은 자신의 버킷으로 유지됩니다 — 프로토콜과 펀드 몫은 항상 trade_fee에서만 파생되며, creator_fee에서는 절대 파생되지 않습니다. creator_fee_rate = 1000 (0.10%)과 trade_fee_rate = 2500 (0.25%)을 가진 풀은 크리에이터-수수료-온-입력 스왑에서 입력의 0.35%를 청구하며, 이 중 크리에이터가 0.10%을 유지하고 거래 수수료 버킷이 0.25%를 받습니다. 거래 수수료 비율(trade_fee_rate, protocol_fee_rate, fund_fee_rate)과 creator_fee_rate 모두 AmmConfig에 존재합니다. 풀별 enable_creator_fee 플래그와 creator_fee_on 모드(거래의 어느 쪽에서 크리에이터 수수료를 취할지)는 PoolState에 존재합니다. products/cpmm/accounts를 참조하세요.

비율과 단위

모든 비율은 1 / FEE_RATE_DENOMINATOR 단위로 계산된 u64이며, 여기서 FEE_RATE_DENOMINATOR = 1_000_000입니다.
  • **trade_fee_rate**은 스왑 거래량의 분수입니다. 2500 ⇒ 관련 쪽의 0.25% (입력 또는 출력, creator_fee_on에 따라 다름 — 아래 “거래의 어느 쪽에서 수수료를 취할지” 참조).
  • **creator_fee_rate**은 스왑 거래량의 분수이며, 거래 수수료와 별도로 취합니다. 1000 ⇒ 관련 쪽의 0.10%.
  • **protocol_fee_rate**과 **fund_fee_rate**은 거래량이 아닌 거래 수수료의 분수입니다. 120_000 ⇒ 거래 수수료의 12%.
메인넷의 AmmConfig[index=0] (표준 0.25% 풀)에 대한 기본 파라미터 참조용:
필드실제 퍼센트
trade_fee_rate2500거래량의 0.25% (거래 수수료 버킷)
protocol_fee_rate120000거래 수수료의 12% ≈ 거래량의 0.030%
fund_fee_rate40000거래 수수료의 4% ≈ 거래량의 0.010%
creator_fee_rate0 (기본값)0% (별도 버킷)
→ LP 몫 실제거래량의 0.210%
따라서 AmmConfig[0]에 대해 enable_creator_fee = false인 $1,000 스왑에서: 총 $2.50 거래 수수료 중 $2.10이 LP와 남고, $0.30이 프로토콜로, $0.10이 펀드로 갑니다. 크리에이터 버킷은 크리에이터 수수료가 비활성화되어 있으므로 0입니다. 같은 풀이 enable_creator_fee = true이고 creator_fee_rate = 1000 (0.10%)을 가지면, 사용자는 creator_fee_on으로 설정된 같은 쪽의 거래에서 취해진 추가 $1.00을 크리에이터 버킷에 지불합니다 — 총 $3.50의 수수료를 위해서입니다. 거래 수수료 버킷과 프로토콜/펀드 분배는 변경되지 않습니다. 현재 메인넷 값을 GET https://api-v3.raydium.io/main/cpmm-config에서 확인하세요 — 비율은 관리자가 변경 가능하며 하드코딩하기보다는 신선하게 읽어야 합니다.

코드의 분배

// raydium-cp-swap/programs/cp-swap/src/curve/{calculator,fees}.rs에서 의역됨.
// 실제 코드는 `is_creator_fee_on_input`에서 분기합니다; 두 분기 모두
// creator_fee가 자신의 비율이며 trade_fee의 조각이 아니라는 불변성을 유지합니다.

const FEE_RATE_DENOMINATOR_VALUE: u64 = 1_000_000;

pub struct FeeBreakdown {
    pub amount_in_after_fees: u64,    // 입력 수수료 차감
    pub amount_out_after_fees: u64,   // 출력에서 취해진 크리에이터 수수료 차감
    pub trade_fee:    u64,            // → 아래의 LP / 프로토콜 / 펀드 버킷으로 분배
    pub protocol_fee: u64,            // trade_fee의 몫
    pub fund_fee:     u64,            // trade_fee의 몫
    pub creator_fee:  u64,            // 독립적인 버킷 (입력 또는 출력 쪽)
}

fn take_fees_on_input(
    amount_in: u64,
    trade_rate: u64,
    creator_rate: u64,
    protocol_rate: u64,
    fund_rate: u64,
) -> (u64 /* trade_fee */, u64 /* creator_fee */, u64 /* amount_in_after_fees */) {
    // 두 비율이 추가되므로 조합 수수료에서 한 번만 반올림한 후
    // 비례적으로 분배합니다 — 이는 순전히 반올림/효율성 트릭입니다.
    // 분배는 비율을 정확히 따릅니다: creator_fee/trade_fee == creator_rate/trade_rate.
    let total_fee = ((amount_in as u128) * ((trade_rate + creator_rate) as u128))
        .div_ceil(FEE_RATE_DENOMINATOR_VALUE as u128) as u64;

    let creator_fee = ((total_fee as u128) * (creator_rate as u128)
                       / ((trade_rate + creator_rate) as u128)) as u64;
    let trade_fee   = total_fee - creator_fee;

    (trade_fee, creator_fee, amount_in - total_fee)
}

fn take_creator_fee_on_output(amount_out_swapped: u64, creator_rate: u64) -> (u64, u64) {
    // creator_fee_on이 크리에이터 수수료를 출력 쪽으로 라우팅할 때,
    // trade_fee는 입력에서 단일 비율로 취해지고, creator_fee는
    // 곡선 출력에 대해 계산됩니다.
    let creator_fee = ((amount_out_swapped as u128) * (creator_rate as u128))
        .div_ceil(FEE_RATE_DENOMINATOR_VALUE as u128) as u64;
    (amount_out_swapped - creator_fee, creator_fee)
}

fn split_trade_fee(
    trade_fee: u64,
    protocol_rate: u64,
    fund_rate: u64,
) -> (u64 /* protocol_fee */, u64 /* fund_fee */) {
    let protocol_fee = (trade_fee as u128 * protocol_rate as u128
                        / FEE_RATE_DENOMINATOR_VALUE as u128) as u64;
    let fund_fee     = (trade_fee as u128 * fund_rate as u128
                        / FEE_RATE_DENOMINATOR_VALUE as u128) as u64;
    (protocol_fee, fund_fee)
}
참고:
  • 입력의 총 수수료는 올림하므로 풀이 과소 청구하지 않습니다.
  • trade_fee의 부분 분배 (프로토콜, 펀드)는 내림하므로 합이 trade_fee를 초과하지 않습니다; 나머지가 LP 몫입니다.
  • lp_share = trade_fee − protocol_fee − fund_fee (creator_fee는 자신의 버킷이기 때문에 여기서 차감되지 않습니다).
  • 크리에이터 수수료는 입력 또는 출력에서 PoolState.creator_fee_on에 따라 취합니다 (다음 섹션 참조). 비율은 어느 쪽이든 변경되지 않습니다.

거래의 어느 쪽에서 수수료를 취할지

CPMM은 풀별 creator_fee_on 설정 (BothToken / OnlyToken0 / OnlyToken1)을 가지며, 이는 크리에이터 수수료가 주어진 스왑의 입력 쪽에서 취해질지 출력 쪽에서 취해질지를 결정합니다. 런타임 헬퍼 is_creator_fee_on_input(direction)은 스왑별로 이를 부울로 축약합니다:
creator_fee_on스왑 0 → 1스왑 1 → 0
BothToken (0)입력 쪽입력 쪽
OnlyToken0 (1)입력 쪽출력 쪽
OnlyToken1 (2)출력 쪽입력 쪽
크리에이터 수수료가 입력 쪽에 있을 때, 거래 수수료와 크리에이터 수수료 모두 곡선이 실행되기 전에 amount_in에서 차감됩니다. 가격 계산: trade_rate + creator_rate를 입력에서 빼십시오. 크리에이터 수수료가 출력 쪽에 있을 때, 거래 수수료만 amount_in에서 차감됩니다; 곡선은 수수료 없는 출력을 생성한 후, 크리에이터 수수료가 그 출력에서 차감됩니다. 가격 계산: trade_rate를 입력에서 빼고; creator_rate를 출력에서 빼십시오. 거래 수수료 자체는 항상 입력 쪽에서 취합니다 (표준 Uniswap-V2 패턴). 크리에이터 수수료만 출력에 도착할 수 있습니다.

”누적된” 수수료가 곡선과 상호작용하는 방식

중요한 미묘한 점: 프로토콜, 펀드, 크리에이터 수수료는 각 Collect* 명령어가 호출될 때까지 물리적으로 볼트에 남아 있습니다. 하지만 곡선의 볼트 잔액 보기에서는 제외됩니다. 한 스왑 후의 구체적인 그림:
raw_vault_0_balance = getTokenAccountBalance(vault_0).amount
                    = lp_entitled + protocol_fees_token0
                      + fund_fees_token0 + creator_fees_token0

curve_x = raw_vault_0_balance − (protocol_fees_token0
                                  + fund_fees_token0
                                  + creator_fees_token0)
프로그램은 k' ≥ k를 강제할 때 curve_x (및 유사한 curve_y)를 사용합니다. 이것이 비-LP 수수료가 LP 몫을 부풀리지 않고 목적지에 도달하는 방식입니다. 설계해야 할 결과:
  • 원시 잔액에서 가격 계산은 잘못되었습니다. getTokenAccountBalance에서 가격 계산기를 작성하면, 풀이 수용할 가격을 지속적으로 과대평가합니다. 항상 누적된 수수료를 빼거나, SwapBaseInput / API를 통해 시뮬레이션하세요.
  • CollectProtocolFee는 가격을 이동하지 않습니다. 토큰을 볼트 밖으로 이동하고 protocol_fees_token* 카운터를 0으로 설정하므로, curve_xcurve_y는 변경되지 않습니다.
  • LP 수수료는 카운터에 누적되지 않습니다. 이들은 볼트 잔액에 암시적입니다. LP의 누적된 LP 수수료에 대한 자격은 LP 토큰을 소각하여 행사됩니다 (Withdraw를 통해) — CollectLpFee는 없습니다.

Token-2022 전송 수수료와의 상호작용

Token-2022 전송 수수료는 CPMM이 아닌 민트에서 적용됩니다. 모든 토큰 전송에 작용합니다 — 스왑, 예치, 인출, Collect* 수거. CPMM의 거래 수수료 계산은 실제로 볼트에 도착한 금액에 대해 계산됩니다. 즉, 입력 민트의 전송 수수료를 차감한 것입니다 (있는 경우). 따라서 최악의 경우 사용자는 입력-정확 스왑에서 세 가지 서로 다른 세금을 지불합니다:
  1. 입력 민트의 전송 수수료 (민트의 수수료 권한에).
  2. 풀의 trade_fee (위와 같이 분배됨).
  3. 출력 민트의 전송 수수료 (민트의 수수료 권한에).
SDK의 가격 계산기는 세 가지를 모두 고려하므로 minimum_amount_out은 사용자가 실제로 받는 것으로 표시됩니다. 자신만의 가격 계산기를 작성하는 경우, 그 동작을 반영하세요. 그렇지 않으면 슬리피지 확인이 체계적으로 너무 관대할 것입니다. 자세한 유도는 algorithms/token-2022-transfer-fees를 참조하세요.

크리에이터 수수료

크리에이터 수수료는 선택 사항이며 풀별입니다. 비율AmmConfig.creator_fee_rate에 있습니다; 활성화 플래그 (creator_fee_on)은 PoolState에 있습니다:
  • 풀 생성 시 활성화됩니다. Initialize는 기본적으로 enable_creator_fee = false로 설정합니다; InitializeWithPermission을 통해 생성된 풀 (LaunchLab 졸업 및 기타 게이티드 경로에서 사용)은 enable_creator_fee = true를 전달하고 creator_fee_on을 선택할 수 있습니다.
  • 비율은 수수료 티어와 공유됩니다. 비율 자체는 AmmConfig.creator_fee_rate이며, 그 설정에 바인딩된 모든 풀에서 같은 값입니다. 각 풀은 그 후 이를 청구할지 (enable_creator_fee) 결정하고 스왑의 어느 쪽에서 청구할지 (creator_fee_on)를 결정합니다. enable_creator_fee = false일 때, 풀의 유효 크리에이터-수수료 비율은 설정 값에 관계없이 0입니다 (소스에서 PoolState::adjust_creator_fee_rate 참조).
  • 거래 수수료와 독립적입니다. 크리에이터 수수료는 LP / 프로토콜 / 펀드 몫을 절대 줄이지 않습니다 — 자신의 비율이며, 별도로 적용되고, 자신의 카운터에 누적됩니다.
  • CollectCreatorFee를 통해 수거되며, PoolState.pool_creator에서 서명합니다.
  • 생성 후 다시 활성화하거나 다시 라우팅할 수 없습니다. enable_creator_fee = false로 초기화된 풀은 크리에이터 수수료를 청구하지 않습니다; 특정 creator_fee_on으로 초기화된 풀은 쪽을 전환할 수 없습니다.
크리에이터 수수료는 Raydium의 “Burn & Earn” 패턴의 메커니즘입니다: LP 토큰은 LP Lock 프로그램에서 잠겨 있어 크리에이터가 유동성을 인출할 수 없지만, CollectCreatorFee를 무한정 청구할 수 있습니다.

수거 운영 흐름

| 서명자 | 명령어 | 소스 카운터 0 | 카운터 1 | 일반적인 리듬 | |--------|-------------|------------------------|-----------------| | amm_config.protocol_owner | CollectProtocolFee | protocol_fees_token{0,1} | 주간 또는 프로그래밍 | | amm_config.fund_owner | CollectFundFee | fund_fees_token{0,1} | 주간 또는 프로그래밍 | | pool_state.pool_creator | CollectCreatorFee | creator_fees_token{0,1} | 언제든지 | 프로토콜과 펀드 소유자는 메인넷의 Raydium 멀티시그입니다; security/admin-and-multisig를 참조하세요. 크리에이터 서명자는 Initialize를 실행한 계정입니다.

수수료 티어 변경

수수료 비율은 UpdateAmmConfig를 통해 관리자가 변경할 수 있습니다 ((products/cpmm/instructions 참조). 변경 사항은 해당 AmmConfig에 바인딩된 모든 풀에 대해 다음 스왑에서 적용됩니다 — 풀이 각 스왑에서 설정을 로드하기 때문에 마이그레이션이 없습니다. 관리자가 할 수 없는 것:
  • 풀을 한 AmmConfig에서 다른 것으로 이동합니다.
  • 이미 누적된 수수료를 소급으로 다시 가격 책정합니다.
  • protocol_owner / fund_owner 서명자 없이 수수료를 수거합니다.

실행 중인 풀에서 수수료 읽기

// 오프체인: 각 버킷의 현재 누적 수수료
const pool = await connection.getAccountInfo(poolStatePda);
const decoded = PoolState.decode(pool.data);
console.log(
  "Protocol accrued:",
  decoded.protocolFeesToken0.toString(),
  decoded.protocolFeesToken1.toString(),
);
console.log(
  "Fund accrued:",
  decoded.fundFeesToken0.toString(),
  decoded.fundFeesToken1.toString(),
);
console.log(
  "Creator accrued:",
  decoded.creatorFeesToken0.toString(),
  decoded.creatorFeesToken1.toString(),
);

// 오프체인: 오늘의 유효 비율.
// trade_fee_rate, creator_fee_rate는 거래량의 분수 (분모 1e6).
// protocol_fee_rate, fund_fee_rate는 *거래 수수료*의 분수 (같은 분모).
const config = await fetch("https://api-v3.raydium.io/main/cpmm-config")
  .then((r) => r.json());
const tier = config.data.find((t) => t.index === decoded.ammConfigIndex);

const tradeFeeOfVolume   = tier.tradeFeeRate / 1_000_000;
const protocolOfTradeFee = tier.protocolFeeRate / 1_000_000;
const fundOfTradeFee     = tier.fundFeeRate / 1_000_000;
const lpOfTradeFee       = 1 - protocolOfTradeFee - fundOfTradeFee;

console.log("LP fee effective:",       (tradeFeeOfVolume * lpOfTradeFee * 100).toFixed(4), "%");
console.log("Protocol fee effective:", (tradeFeeOfVolume * protocolOfTradeFee * 100).toFixed(4), "%");
console.log("Fund fee effective:",     (tradeFeeOfVolume * fundOfTradeFee * 100).toFixed(4), "%");
console.log(
  "Creator fee effective:",
  decoded.enableCreatorFee
    ? ((tier.creatorFeeRate / 1_000_000) * 100).toFixed(4) + " %"
    : "0 % (disabled on this pool)",
);

CLMM 및 AMM v4와의 비교

reference/fee-comparison에서 나란히 비교 매트릭스를 참조하세요. 요약:
  • AMM v4는 고정 0.25% 거래 수수료를 다른 LP/프로토콜 분배와 펀드 수수료 없이 사용합니다.
  • CLMM 수수료는 틱-스페이싱 티어별로, 풀별이 아닌 포지션별로 누적되며, DecreaseLiquidity 또는 CollectFees를 통해 청구됩니다.

다음 단계

소스: