CPMM 지시사항

CPMM 프로그램의 모든 지시사항(인수, 계정 목록, 전제 조건/사후 조건, 반환 가능한 오류 포함).

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

영문판 보기 →

​

지시사항 요약

판별자 이름	서명자	동작
Initialize	풀 생성자	두 개의 민트와 AmmConfig에서 새로운 CPMM 풀을 생성합니다. 누구나 호출할 수 있습니다(퍼미션리스). 새 풀에서 enable_creator_fee = false로 고정합니다. pool_state 계정은 정규 PDA 또는 새로운 무작위 키페어일 수 있습니다(Initialize 계정 참고).
InitializeWithPermission	지불자 + Permission PDA 보유자	Initialize의 퍼미션 제어 변형입니다. 호출자(payer)는 자신의 공개키에서 파생된 Permission PDA를 소유해야 합니다. 풀 생성을 제한해야 하는 플랫폼에서 사용됩니다(예: LaunchLab 졸업). 호출자가 creator_fee_on(BothToken / OnlyToken0 / OnlyToken1)을 지정할 수 있으며, 새 풀에서 enable_creator_fee = true로 강제합니다. pool_state의 creator 필드는 지불자가 아닌 별도로 전달된 creator 계정으로 설정됩니다. pool_state에 대해 Initialize와 동일한 정규 PDA 또는 무작위 키페어 유연성이 있습니다.
Deposit	LP	두 토큰 모두에서 유동성을 추가합니다; LP 토큰을 받습니다.
Withdraw	LP	LP 토큰을 소각합니다; 기초 토큰을 비례적으로 받습니다.
SwapBaseInput	스왑 수행자	정확한 입력 스왑(amount_in 입력, 최소 minimum_amount_out 출력).
SwapBaseOutput	스왑 수행자	정확한 출력 스왑(최대 maximum_amount_in 입력, amount_out 출력).
CollectProtocolFee	protocol_owner(AmmConfig에서)	금고에서 축적된 프로토콜 수수료를 수집합니다.
CollectFundFee	fund_owner(AmmConfig에서)	금고에서 축적된 펀드 수수료를 수집합니다.
CollectCreatorFee	pool_creator	축적된 생성자 수수료를 수집합니다(생성자 수수료가 활성화된 경우).
UpdatePoolStatus	admin	비트마스크를 통해 풀의 특정 작업을 일시 중지/재개합니다.
UpdateAmmConfig	admin	AmmConfig의 수수료율 또는 프로토콜/펀드 소유자를 변경합니다.
CreateAmmConfig	admin	새로운 수수료 계층(새로운 AmmConfig 계정)을 생성합니다.
CreatePermissionPda	admin	특정 권한이 InitializeWithPermission을 호출할 수 있도록 하는 Permission PDA를 발급합니다.
ClosePermissionPda	admin	이전에 발급된 Permission PDA를 취소합니다.

상태 비트마스크: 각 풀의 status는 u8이며, 비트 0 = 입금 비활성화, 비트 1 = 출금 비활성화, 비트 2 = 스왑 비활성화입니다(PoolStatusBitIndex { Deposit, Withdraw, Swap }). 클리어 비트는 작업이 허용됨을 의미하고, 설정 비트는 일시 중지됨을 의미합니다. UpdatePoolStatus는 원시 u8을 받고 기존 값을 덮어씁니다.

다음 섹션에서는 각각을 자세히 설명합니다. 계정 순서는 CPMM IDL을 따르며, SDK와 raydium-cp-swap/programs/cp-swap/src/instructions의 Rust 클라이언트가 이 순서와 일치합니다.

​

Initialize

새로운 CPMM 풀을 생성합니다.

인수

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

계정 (W = 쓰기 가능, S = 서명자)

#	이름	W	S	설명
1	creator	W	S	렌트 지불; pool_state.pool_creator로 기록됨.
2	amm_config			선택된 수수료 계층.
3	authority			CPMM 전역 권한 PDA.
4	pool_state	W	S*	여기서 init됨. 정규 PDA ["pool", amm_config, token_0_mint, token_1_mint] 또는 새로운 무작위 키페어. 정규 PDA가 아닐 때, 프로그램은 pool_state가 서명하도록 요구합니다(require_eq!(pool_account_info.is_signer, true)). 무작위 키페어 경로를 통해 생성자가 정규 PDA에 대한 프론트러닝 시도를 회피할 수 있습니다. 다운스트림 PDA(lp_mint, vault, observation_state)는 어느 경우든 pool_state.key()에서 파생됩니다.
5	token_0_mint			정렬됨: token_0_mint < token_1_mint.
6	token_1_mint
7	lp_mint	W		여기서 init됨. 권한이 authority로 설정됨.
8	creator_token_0	W		init_amount_0에 대한 소스 ATA.
9	creator_token_1	W		init_amount_1에 대한 소스 ATA.
10	creator_lp_token	W		LP의 목적지(누락된 경우 생성됨).
11	token_0_vault	W		여기서 init됨. authority가 소유.
12	token_1_vault	W
13	create_pool_fee	W		생성자가 지불하는 create_pool_fee에 대한 목적지 ATA.
14	observation_state	W		여기서 init됨.
15	token_program			SPL Token (LP 민트용).
16	token_0_program			SPL Token 또는 Token-2022.
17	token_1_program			SPL Token 또는 Token-2022.
18	associated_token_program
19	system_program
20	rent

* pool_state는 무작위 키페어 경로에서만 서명하며, 정규 PDA 경로는 pool_state 서명 없이 실행됩니다.

전제 조건

• 민트는 정렬됩니다(바이트 순서로 token_0_mint < token_1_mint).
• 두 민트 모두 CPMM 허용 목록 외의 확장 프로그램을 사용하지 않습니다(TransferFeeConfig, MetadataPointer, TokenMetadata, InterestBearingConfig, ScaledUiAmount) — products/cpmm/accounts 참고. 프로그램 내의 작은 민트별 허용 목록은 케이별 온보딩을 우회합니다.
• 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) − LOCKED_LP로 존재합니다.
• LOCKED_LP(LP 토큰 100 라마포)의 LP 스타터는 풀에서 영구적으로 잠깁니다 — pool_state.lp_supply는 liquidity − 100을 기록하는 동안 100 LP 단위는 순환 외부에 남아있어 풀이 완전히 비워지는 것과 0으로 나누는 것을 방지합니다.
• observation_state가 초기화됩니다; observation_index = 0이고 pool_id = pool_state.key().
• create_pool_fee 라마포는 생성자에서 수신자로 전송되고 네이티브 SOL로 동기화됩니다(wSOL ATA입니다).
• 풀의 상태 비트마스크는 0입니다(입금 / 출금 / 스왑 모두 활성화).
• enable_creator_fee = false이고 creator_fee_on = BothToken. Initialize는 생성자 수수료 활성화를 지원하지 않습니다 — 그 경로는 InitializeWithPermission입니다.
• open_time은 호출자가 <= block_timestamp 값을 전달한 경우 block_timestamp + 1로 범프됩니다. 스왑은 open_time 전에 거부됩니다; 입금 및 출금은 즉시 작동합니다.

일반적인 오류 (전체 목록은 reference/error-codes에서)

• 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

계정

#	이름	W	S
1	owner		S
2	authority
3	pool_state	W
4	owner_lp_token	W
5	token_0_account	W
6	token_1_account	W
7	token_0_vault	W
8	token_1_vault	W
9	token_program
10	token_program_2022
11	vault_0_mint
12	vault_1_mint
13	lp_mint	W

수학

needed_token_0 = ceil(lp_token_amount * vault_0 / lp_supply)
needed_token_1 = ceil(lp_token_amount * vault_1 / lp_supply)
require(needed_token_0 <= maximum_token_0, "ExceededSlippage")
require(needed_token_1 <= maximum_token_1, "ExceededSlippage")

k의 비례성에는 변화가 없습니다 — 금고와 lp_supply 모두 동일한 계수로 확장됩니다.

사후 조건

• lp_supply += lp_token_amount.
• vault_0 += needed_token_0 (입력 시 Token-2022 이전 수수료 순).
• vault_1 += needed_token_1 (입력 시 Token-2022 이전 수수료 순).

일반적인 오류 — ExceededSlippage, ZeroTradingTokens, 입금이 일시 중지된 경우 InvalidStatus.

​

Withdraw

LP 토큰을 소각하고 기초 토큰을 비례적으로 받습니다.

인수

lp_token_amount:   u64
minimum_token_0:   u64
minimum_token_1:   u64

계정

#	이름	W	S
1	owner		S
2	authority
3	pool_state	W
4	owner_lp_token	W
5	token_0_account	W
6	token_1_account	W
7	token_0_vault	W
8	token_1_vault	W
9	token_program
10	token_program_2022
11	vault_0_mint
12	vault_1_mint
13	lp_mint	W

(Deposit과 동일합니다; lp_mint는 LP 토큰이 소각되기 때문에 쓰기 가능합니다.)

수학

out_token_0 = floor(lp_token_amount * vault_0 / lp_supply)
out_token_1 = floor(lp_token_amount * vault_1 / lp_supply)
require(out_token_0 >= minimum_token_0, "ExceededSlippage")
require(out_token_1 >= minimum_token_1, "ExceededSlippage")

사후 조건

• lp_supply -= lp_token_amount.
• 금고는 out_token_0 / out_token_1을 전송합니다(총액; 사용자는 Token-2022 이전 수수료 순으로 받음).

​

SwapBaseInput

정확한 입력 스왑.

인수

amount_in:            u64
minimum_amount_out:   u64

계정

#	이름	W	S
1	payer		S
2	authority
3	amm_config
4	pool_state	W
5	input_token_account	W
6	output_token_account	W
7	input_vault	W
8	output_vault	W
9	input_token_program
10	output_token_program
11	input_token_mint
12	output_token_mint
13	observation_state	W

순서는 풀의 정규 token_0 / token_1이 아닌 사용자의 방향 입력 → 출력입니다. 프로그램은 민트를 일치시켜 어느 금고가 어느 것인지 파악합니다.

수학 — products/cpmm/math 참고.

전제 조건

• 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

계정 — SwapBaseInput과 동일합니다.

수학 — 역 곡선과 함께 천정, products/cpmm/math 참고.

일반적인 오류 — ExceededSlippage(gross_in > max_amount_in), ZeroTradingTokens, InvalidInput, NotApproved.

​

CollectProtocolFee

금고에서 프로토콜 목적지로 축적된 프로토콜 수수료를 수집합니다.

인수 — 없음.

계정

#	이름	W	S
1	owner		S	amm_config.protocol_owner와 일치해야 함.
2	authority
3	pool_state	W
4	amm_config
5	token_0_vault	W
6	token_1_vault	W
7	vault_0_mint
8	vault_1_mint
9	recipient_token_0_account	W
10	recipient_token_1_account	W
11	token_program
12	token_program_2022

효과

transfer pool_state.protocol_fees_token0 from vault_0 to recipient_0
transfer pool_state.protocol_fees_token1 from vault_1 to recipient_1
pool_state.protocol_fees_token0 = 0
pool_state.protocol_fees_token1 = 0

곡선의 유효 잔액에는 변화가 없습니다(축적된 수수료는 이미 제외됨).

일반적인 오류 — 서명자가 protocol_owner이 아닌 경우 NotApproved.

​

CollectFundFee

CollectProtocolFee와 동일한 형태이지만 fund_owner가 서명하고 fund_fees_* 카운터를 0으로 설정합니다.

​

CollectCreatorFee

마찬가지로 동일한 형태이며 pool_state.pool_creator가 서명합니다. 풀이 0이 아닌 생성자 수수료율로 초기화된 경우에만 이전을 내보냅니다.

​

UpdatePoolStatus

풀의 개별 작업을 일시 중지하거나 재개합니다. status 필드는 비트마스크입니다:

비트	플래그	설정 시 효과
0	DEPOSIT_DISABLED	Deposit가 NotApproved로 거부됨.
1	WITHDRAW_DISABLED	Withdraw가 거부됨.
2	SWAP_DISABLED	SwapBaseInput / SwapBaseOutput이 거부됨.

인수

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

계정

#	이름	W	S
1	authority		S	CPMM 프로그램의 관리 키와 일치해야 함.
2	pool_state	W

관리 키는 CPMM 프로그램의 업그레이드 권한입니다 — 실제로는 Raydium 멀티시그입니다. security/admin-and-multisig 참고.

​

CreateAmmConfig

새로운 수수료 계층을 생성합니다.

인수

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

계정

#	이름	W	S
1	owner	W	S	관리자.
2	amm_config	W		여기서 init됨.
3	system_program

전제 조건

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

​

UpdateAmmConfig

기존 AmmConfig의 수수료율 또는 소유권을 변경합니다. param: u8(어느 필드를 업데이트할지 판별자)과 value: u64를 사용합니다. 매개변수당 값 의미론은 소스에 있습니다; 일반적으로:

• param = 0 → trade_fee_rate
• param = 1 → protocol_fee_rate
• param = 2 → fund_fee_rate
• param = 3 → new_protocol_owner (Pubkey 바이트를 재해석으로 전달)
• param = 4 → new_fund_owner
• param = 5 → create_pool_fee
• param = 6 → disable_create_pool

변경 사항은 관리자가 서명하며 다음 스왑에서 이 AmmConfig에 바인드된 모든 풀에 영향을 줍니다. 마이그레이션 없음; 풀은 단순히 새 값을 읽습니다.

​

상태 변경 매트릭스

지시사항	lp_supply	금고 잔액	축적 수수료 필드	observation
Initialize	+ init LP	+ init_amount_{0,1}	0	init
InitializeWithPermission	+ init LP	+ init_amount_{0,1}	0	init
Deposit	+	+ 둘 다	—	—
Withdraw	−	− 둘 다	—	—
SwapBaseInput	—	+ in, − out	+ trade_fee를 프로토콜/펀드로 분할; 활성화된 경우 + creator_fee	+ (간격 경과 시)
SwapBaseOutput	—	+ in, − out	+ trade_fee를 프로토콜/펀드로 분할; 활성화된 경우 + creator_fee	+ (간격 경과 시)
CollectProtocolFee	—	− (프로토콜 버킷별)	protocol_* → 0	—
CollectFundFee	—	− (펀드 버킷별)	fund_* → 0	—
CollectCreatorFee	—	− (생성자 버킷별)	creator_* → 0	—
UpdatePoolStatus	—	—	—	—

​

다음 단계

• products/cpmm/code-demos — 위의 실행 가능한 TypeScript 샘플.
• reference/error-codes — 완전한 Anchor 오류 테이블.
• products/cpmm/fees — CollectProtocolFee / CollectFundFee / CollectCreatorFee가 수집하는 수수료 축적 모델.

소스:

• raydium-io/raydium-cp-swap — instructions
• Raydium SDK v2 — @raydium-io/raydium-sdk-v2