CPMM 명령어

​

명령어 요약

​

Initialize

init_amount_0: u64
init_amount_1: u64
open_time:     u64   // Unix 타임스탬프; 이 시간 이전의 스왑은 거부됨

• 민트가 정렬되어 있습니다 (token_0_mint < token_1_mint 바이트 순서로).
• 어떤 민트도 CPMM 허용 목록 외의 확장을 사용하지 않습니다 (TransferFeeConfig, MetadataPointer, TokenMetadata, InterestBearingConfig, ScaledUiAmount) — products/cpmm/accounts를 참조하세요. SupportMintAssociated PDA (시드 [b"support_mint", mint])가 존재하는 민트는 확장 검사를 건너뜁니다 — 하지만 해당 PDA를 remaining_accounts에 추가해야 합니다. 프로그램은 전달한 계정만 스캔하고 PDA를 직접 로드하지 않으므로, 레지스트리에 의존하면서 계정을 제공하지 않으면 NotSupportMint (6007)로 실패합니다. 순서는 중요하지 않습니다 (키로 일치). 우회가 필요한 민트당 하나의 항목을 전달하세요. 해당 레지스트리는 2026-09 업그레이드가 하드코딩된 4-민트 화이트리스트를 제거한 이후 유일한 우회입니다.
• creator는 각 ATA에서 최소 init_amount_0과 init_amount_1을 보유합니다.
• amm_config.disable_create_pool == false.

• pool_state.lp_supply = sqrt(init_amount_0 * init_amount_1) — 전체 제곱근. 생성자는 lp_supply − 100을 민팅받습니다. 100개의 잠긴 기본 단위는 lp_supply에 계산되지만 절대 민팅되지 않습니다.
• 따라서 lp_mint.supply == pool_state.lp_supply − 100은 풀의 수명 동안 유지됩니다. 모든 LP-공유 수학 (입금, 출금)은 lp_supply로 나누므로 해당 필드를 사용하고 민트의 온체인 공급을 대체하지 마세요. sqrt(...) < 100이면 InitLpAmountTooLess로 되돌립니다.
• observation_state가 초기화됩니다. observation_index = 0이고 pool_id = pool_state.key().
• create_pool_fee lamport가 생성자에서 수신자로 전송되고 네이티브 SOL로 동기화됩니다 (wSOL ATA입니다).
• 풀의 상태 비트마스크는 0입니다 (입금 / 출금 / 스왑 모두 활성화).
• enable_creator_fee = false이고 creator_fee_on = BothToken. Initialize는 크리에이터 수수료 활성화를 지원하지 않습니다 — 해당 경로는 InitializeWithPermission입니다.
• open_time은 호출자가 <= block_timestamp 값을 전달한 경우 block_timestamp + 1로 범프됩니다. 스왑은 open_time 이전에 거부됩니다. 입금과 출금은 즉시 작동합니다.

• InvalidInput — 민트가 정렬되지 않았거나 동일한 민트.
• NotSupportMint — 차단된 Token-2022 확장.
• ExceededSlippage — 드물게; init_amount_0/1이 소수 자릿수 불일치로 인해 0 LP를 초래하는 경우.

​

Deposit

lp_token_amount:   u64   // LP에 민팅할 LP 토큰 수
maximum_token_0:   u64
maximum_token_1:   u64

total_0 = vault_0 − protocol_fees_0 − fund_fees_0 − creator_fees_0    // 측면 1도 동일

needed_token_0 = ceil(lp_token_amount * total_0 / lp_supply)
transfer_0     = needed_token_0 + inverse_transfer_fee(needed_token_0) // Token-2022
require(transfer_0 <= maximum_token_0, "ExceededSlippage")             // 측면 1도 동일

• lp_supply += lp_token_amount.
• vault_0 += needed_token_0 (입력의 Token-2022 전송 수수료 제외).
• vault_1 += needed_token_1 (입력의 Token-2022 전송 수수료 제외).

​

Withdraw

lp_token_amount:   u64
minimum_token_0:   u64
minimum_token_1:   u64

total_0 = vault_0 − protocol_fees_0 − fund_fees_0 − creator_fees_0    // 측면 1도 동일

out_token_0     = min(total_0, floor(lp_token_amount * total_0 / lp_supply))
receive_token_0 = out_token_0 − transfer_fee(out_token_0)             // Token-2022
require(receive_token_0 >= minimum_token_0, "ExceededSlippage")       // 측면 1도 동일

// Deposit과 마찬가지로: 기반은 수수료 제외 볼트 총액이고, 바닥은
// LP가 실제로 받는 것에 대해 확인되며, 전송 수수료 후입니다.

• lp_supply -= lp_token_amount.
• 볼트는 out_token_0 / out_token_1을 전송합니다 (총액; 사용자는 Token-2022 전송 수수료 제외 후 받습니다).

​

SwapBaseInput

amount_in:            u64
minimum_amount_out:   u64

• open_time <= now.
• pool_status가 스왑을 허용합니다.
• 어떤 민트도 이 권한에 대해 일시 중지되거나 동결되지 않았습니다.
• amount_in > 0.

• ExceededSlippage — amount_out < minimum_amount_out.
• ZeroTradingTokens — 거래가 0으로 반올림됩니다.
• NotApproved — 풀이 UpdatePoolStatus를 통해 스왑에 대해 일시 중지됩니다.
• InvalidInput — 민트가 풀의 볼트 민트 중 어느 것과도 일치하지 않습니다.

​

SwapBaseOutput

max_amount_in:  u64
amount_out:     u64

​

CollectProtocolFee

vault_0에서 recipient_0으로 pool_state.protocol_fees_token0 전송
vault_1에서 recipient_1으로 pool_state.protocol_fees_token1 전송
pool_state.protocol_fees_token0 = 0
pool_state.protocol_fees_token1 = 0

​

CollectFundFee

​

CollectCreatorFee

share_rate = creator_fee_share.share_rate   (계정이 존재하는 경우)
           | amm_config.creator_fee_share_rate   (그렇지 않은 경우)

shared_i  = floor(creator_fees_token_i * share_rate / 1_000_000)
creator_i = creator_fees_token_i - shared_i

vault_i에서 creator_token_i로 creator_i 전송
pool_state.protocol_fees_token_i += shared_i     // 볼트에 남음
pool_state.creator_fees_token_i   = 0
pool_state.recent_epoch = current epoch

​

CollectCreatorFeePermissionless

​

UpdatePoolStatus

status: u8      // 새로운 비트마스크

​

CreateAmmConfig

index:             u16
trade_fee_rate:    u64
protocol_fee_rate: u64
fund_fee_rate:     u64
create_pool_fee:   u64
creator_fee_rate:  u64

• 동일한 index를 가진 기존 AmmConfig가 없습니다.
• protocol_fee_rate + fund_fee_rate <= FEE_RATE_DENOMINATOR_VALUE.

​

UpdateAmmConfig

• param = 0 → trade_fee_rate (어설션 trade_fee_rate + creator_fee_rate < 1_000_000)
• param = 1 → protocol_fee_rate (어설션 ≤ 1_000_000 및 + fund_fee_rate ≤ 1_000_000)
• param = 2 → fund_fee_rate (어설션 ≤ 1_000_000 및 + protocol_fee_rate ≤ 1_000_000)
• param = 3 → protocol_owner. 새 키는 value에 없습니다: remaining_accounts[0]으로 추가합니다 (읽기 전용 괜찮음). 기본 공개키가 아니어야 하며, 계정을 생략하면 unwrap()에서 패닉합니다.
• param = 4 → fund_owner. 3과 동일한 메커니즘.
• param = 5 → create_pool_fee
• param = 6 → disable_create_pool (0이 아닌 value는 비활성화)
• param = 7 → creator_fee_rate (어설션 creator_fee_rate + trade_fee_rate < 1_000_000)
• param = 8 → creator_fee_share_rate (어설션 ≤ 1_000_000). 2026-09-19에 추가됨. 이 계층에서 크리에이터 수수료의 프로토콜 기본 몫; products/cpmm/fees를 참조하세요. 거래 수수료를 분할하는 protocol_fee_rate와 관련이 없습니다.

​

CreateCreatorFeeShare

share_rate: u64   // 크리에이터 수수료의 프로토콜 몫, FEE_RATE_DENOMINATOR = 1_000_000 이상

• share_rate <= 1_000_000, 그렇지 않으면 InvalidInput (6003).
• PDA는 아직 존재하지 않아야 합니다 — Anchor의 init은 동일한 쌍에 대한 두 번째 호출에서 실패합니다. 비율을 변경하려면 계정을 닫고 다시 생성하세요.

• creator_fee_share는 bump, creator, amm_config 및 share_rate를 저장합니다.
• amm_config 아래 creator에 의해 생성된 풀에서 이후의 모든 CollectCreatorFee / CollectCreatorFeePermissionless는 구성 대신 이 계정에서 몫을 해결합니다.

​

CloseCreatorFeeShare

• 계정이 닫혀 있고 lamport가 owner로 이동합니다.
• 해당 쌍에 대한 수집은 다시 amm_config.creator_fee_share_rate에서 몫을 해결합니다 — 관리자가 UpdateAmmConfig 매개변수 8을 설정하지 않은 경우 0입니다.

​

CollectExcessLamports