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.
Итоговая таблица инструкций
| Имя дискриминатора | Кто подписывает | Что делает |
|---|
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 | Примечания |
|---|
| 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).
Своп с точным входом.
Аргументы
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 | | |
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_rateparam = 1 → protocol_fee_rateparam = 2 → fund_fee_rateparam = 3 → new_protocol_owner (передаёт байты Pubkey как переинтерпретацию)param = 4 → new_fund_ownerparam = 5 → create_pool_feeparam = 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 | — | — | — | — |
Куда дальше
Источники:
