Инструкции CPMM

​

Сводка инструкций

​

Initialize

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

• Минты отсортированы (token_0_mint < token_1_mint по порядку байтов).
• Ни один минт не использует расширение вне списка разрешений CPMM (TransferFeeConfig, MetadataPointer, TokenMetadata, InterestBearingConfig, ScaledUiAmount) — см. products/cpmm/accounts. Минт, для которого существует PDA SupportMintAssociated (seed [b"support_mint", mint]), пропускает проверку расширения — но вы должны добавить этот PDA в remaining_accounts. Программа сканирует только переданные вами счёты и никогда не загружает PDA самостоятельно, поэтому полагаться на реестр без предоставления счёта всё равно не удаётся с NotSupportMint (6007). Порядок не имеет значения (сопоставление по ключу); передайте одну запись на минт, которому нужен обход. Этот реестр — единственный обход с тех пор, как обновление 2026-09 удалило жёстко закодированный список четырёх минтов.
• 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) — полный квадратный корень. Создателю выдаётся lp_supply − 100; 100 заблокированных базовых единиц учитываются в lp_supply, но никогда не выпускаются.
• Таким образом, lp_mint.supply == pool_state.lp_supply − 100 на протяжении всей жизни пула. Вся математика LP-доли (депозит, вывод) делится на lp_supply, поэтому используйте это поле и не подставляйте предложение минта в цепи. Возвращает InitLpAmountTooLess, если sqrt(...) < 100.
• 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; депозиты и выводы работают немедленно.

• 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

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 — сделка округляется до нуля.
• NotApproved — пул приостановлен для своп через UpdatePoolStatus.
• InvalidInput — минты не совпадают ни с одним из минтов хранилища пула.

​

SwapBaseOutput

max_amount_in:  u64
amount_out:     u64

​

CollectProtocolFee

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

​

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

transfer creator_i from vault_i to creator_token_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

• Нет существующего AmmConfig с тем же index.
• 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 (любое ненулевое 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.
• Каждый последующий CollectCreatorFee / CollectCreatorFeePermissionless на пуле, созданном creator под amm_config, разрешает долю из этого счёта вместо конфига.

​

CloseCreatorFeeShare

• Счёт закрыт и его лампорты идут на owner.
• Сборы для этой пары разрешают долю из amm_config.creator_fee_share_rate снова — что 0, если админ не установил UpdateAmmConfig param 8.

​

CollectExcessLamports

​

Матрица изменения состояния

​

Куда дальше

• products/cpmm/code-demos — запускаемые примеры TypeScript для вышеперечисленного.
• reference/error-codes — полная таблица ошибок Anchor.
• products/cpmm/fees — модель накопления комиссий, которую инструкции Collect*Fee осушают.

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