Инструкции CPMM

Все инструкции программы CPMM с аргументами, списком аккаунтов, предусловиями, постусловиями и возвращаемыми ошибками.

Эта страница переведена с помощью ИИ. За эталон принимается английская версия.

Открыть английскую версию →

​

Итоговая таблица инструкций

Имя дискриминатора	Кто подписывает	Что делает
Initialize	создатель пула	Создаёт новый пул CPMM из двух монет и AmmConfig. Без ограничений: любой может её вызвать. Устанавливает enable_creator_fee = false для нового пула. Аккаунт pool_state может быть либо каноническим PDA, либо случайной свежей парой (см. аккаунты Initialize).
InitializeWithPermission	плательщик + владелец PDA Permission	Версия Initialize с ограничениями. Вызывающий (payer) должен владеть PDA Permission, производной от его публичного ключа. Используется платформами, нуждающимися в контролируемом создании пула (например, LaunchLab выпуски). Позволяет вызывающему зафиксировать creator_fee_on (BothToken / OnlyToken0 / OnlyToken1) и устанавливает enable_creator_fee = true для нового пула. Поле creator на pool_state принимает значение отдельно переданного аккаунта creator, а не плательщика. Та же гибкость в выборе между каноническим PDA и случайной парой для pool_state, как в Initialize.
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	Выпускает PDA Permission, позволяющий определённому органу вызывать InitializeWithPermission.
ClosePermissionPda	admin	Отзывает ранее выпущенный PDA Permission.

Битовая маска состояния: поле status каждого пула — это u8, где бит 0 = депозиты отключены, бит 1 = снятия отключены, бит 2 = своп отключён (PoolStatusBitIndex { Deposit, Withdraw, Swap } в программе). Нулевой бит означает, что операция разрешена; установленный бит означает, что она приостановлена. UpdatePoolStatus берёт сырой u8 и перезаписывает существующее значение.

Следующие разделы подробно рассматривают каждую инструкцию. Порядок аккаунтов следует IDL CPMM; SDK и Rust-клиент в raydium-cp-swap/programs/cp-swap/src/instructions соответствуют этому порядку.

​

Initialize

Создаёт новый пул CPMM.

Аргументы

init_amount_0: u64
init_amount_1: u64
open_time:     u64   // Unix timestamp; своп отклоняется до этого момента

Аккаунты (W = записываемый, S = подписывает)

#	Имя	W	S	Примечания
1	creator	W	S	Оплачивает ренту; записывается как pool_state.pool_creator.
2	amm_config			Выбранный уровень комиссий.
3	authority			Глобальный PDA полномочий CPMM.
4	pool_state	W	S*	Инициализируется здесь. Либо каноническая 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, хранилища, observation_state) выводятся из pool_state.key() в любом случае.
5	token_0_mint			Отсортирована: token_0_mint < token_1_mint.
6	token_1_mint
7	lp_mint	W		Инициализируется здесь. Полномочия установлены на authority.
8	creator_token_0	W		Исходящая ATA для init_amount_0.
9	creator_token_1	W		Исходящая ATA для init_amount_1.
10	creator_lp_token	W		Назначение для LP (создаётся если отсутствует).
11	token_0_vault	W		Инициализируется здесь. Принадлежит authority.
12	token_1_vault	W
13	create_pool_fee	W		Целевая ATA для create_pool_fee, уплачиваемой создателем.
14	observation_state	W		Инициализируется здесь.
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 имеет как минимум init_amount_0 и init_amount_1 в соответствующих ATA.
• amm_config.disable_create_pool == false.

Постусловия

• pool_state существует с lp_supply = sqrt(init_amount_0 * init_amount_1) − LOCKED_LP.
• Начальные LP токены в количестве LOCKED_LP (100 унитов LP) постоянно заблокированы в пуле — pool_state.lp_supply записывает liquidity − 100, в то время как 100 LP единиц остаются вне обращения, предотвращая полное истощение пула и деление на ноль.
• observation_state инициализируется; observation_index = 0 и pool_id = pool_state.key().
• create_pool_fee ламортов передаются от создателя к получателю и синхронизируются как нативный SOL (это ATA wSOL).
• Битовая маска состояния пула — 0 (депозиты / снятия / своп все включены).
• enable_creator_fee = false и creator_fee_on = BothToken. Initialize не поддерживает включение комиссии создателя — этот путь — InitializeWithPermission.
• open_time повышается до block_timestamp + 1 если вызывающий передал значение <= block_timestamp. Своп отклоняется до open_time; депозиты и снятия работают немедленно.

Частые ошибки (полный список в reference/error-codes)

• InvalidInput — монеты не отсортированы или идентичны.
• NotSupportMint — заблокированное расширение Token-2022.
• ExceededSlippage — редко; если init_amount_0/1 приводят к нулевому 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 — сделка округляется до нуля.
• 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

Без изменения эффективных балансов кривой (накопленные комиссии уже исключены).

Частая ошибка — NotApproved если подписывающий не является protocol_owner.

​

CollectFundFee

Та же структура, что CollectProtocolFee, но подписывается fund_owner и обнуляет счётчики fund_fees_*.

​

CollectCreatorFee

Та же структура, подписывается pool_state.pool_creator. Выпускает передачи только если пул был инициализирован с ненулевой ставкой комиссии создателя.

​

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		Инициализируется здесь.
3	system_program

Предусловия

• Существующей AmmConfig с тем же index нет.
• 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	+ LP инициализ.	+ init_amount_{0,1}	0	инициализ.
InitializeWithPermission	+ LP инициализ.	+ init_amount_{0,1}	0	инициализ.
Deposit	+	+ обе	—	—
Withdraw	−	− обе	—	—
SwapBaseInput	—	+ вход, − выход	+ trade_fee разделён на протокол/фонд; + creator_fee если включена	+ (если интервал истёк)
SwapBaseOutput	—	+ вход, − выход	+ 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