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.
As instruções AMM v4 esperam uniformemente tanto um pool side (contas do programa AMM v4) quanto um market side (contas OpenBook para o mercado vinculado). Omitir ou descompasar qualquer um dos conjuntos reverte a operação. As listas de contas abaixo usam nomes de campo do Raydium SDK para clareza; o IDL subjacente às vezes usa prefixos serum_*.
Inventário de instruções
| Grupo | Instrução | Notas |
|---|
| Ciclo de vida do pool | Initialize2 | Instrução de criação de pool atual (ainda funcional; a UI padrão para novos pools é CPMM). |
| Liquidez | Deposit | Adicionar liquidez, receber LP. |
| Liquidez | Withdraw | Queimar LP, receber ambos os lados pro-rata. |
| Swap | SwapBaseIn | Swap de entrada exata (caminho completo: vaults + OpenBook). |
| Swap | SwapBaseOut | Swap de saída exata (caminho completo). |
| Swap | SwapBaseInV2 | Swap de entrada exata que ignora OpenBook — apenas vaults, menos contas. |
| Swap | SwapBaseOutV2 | Swap de saída exata que ignora OpenBook. |
| Manutenção | SetParams | Admin: alterar parâmetros do pool. |
| Manutenção | WithdrawPnl | Varrer PnL do protocolo acumulado para as contas proprietário-PnL. |
| Manutenção | CreateConfigAccount | Admin: inicializar o AmmConfig PDA em nível de programa. |
| Manutenção | UpdateConfigAccount | Admin: alterar parâmetros de configuração em nível de programa. |
Initialize2
Bootstrap um novo pool AMM v4 vinculado a um mercado OpenBook existente.
Argumentos
nonce: u8
open_time: u64
init_pc_amount: u64
init_coin_amount: u64
W, assinante S)
| # | Nome | W | S | Notas |
|---|
| 1 | token_program | | | SPL Token. |
| 2 | system_program | | | |
| 3 | rent | | | |
| 4 | amm | W | | Conta AmmInfo (chave com seed). |
| 5 | amm_authority | | | PDA do programa. |
| 6 | amm_open_orders | W | | OpenBook OpenOrders (com seed). |
| 7 | lp_mint | W | | |
| 8 | coin_mint | | | |
| 9 | pc_mint | | | |
| 10 | pool_coin_token_account | W | | |
| 11 | pool_pc_token_account | W | | |
| 12 | pool_withdraw_queue | W | | |
| 13 | pool_target_orders_account | W | | |
| 14 | pool_lp_token_account | W | | ATA LP do criador. |
| 15 | pool_temp_lp_token_account | W | | Conta de rascunho. |
| 16 | market_program | | | Programa OpenBook. |
| 17 | market | | | Mercado OpenBook. |
| 18 | user_wallet | W | S | Criador. Paga rent e financia depósito inicial. |
| 19 | user_token_coin | W | | |
| 20 | user_token_pc | W | | |
lp_supply = sqrt(init_coin_amount × init_pc_amount) − INIT_BURN, onde INIT_BURN ≈ 100 unidades LP são mantidas fora de circulação.- As ordens OpenBook ainda não foram postadas; o primeiro
MonitorStep posta a grid inicial.
Erros comuns — InvalidInput (decimais descompassadas, não ordenados), NotApproved, InvalidMarketState do lado OpenBook.
Deposit
Adicionar liquidez.
Argumentos
max_coin_amount: u64
max_pc_amount: u64
base_side: u64 // 0 = base em coin, 1 = base em pc
// (algumas variantes do SDK também aceitam other_amount_min)
| # | Nome | W | S |
|---|
| 1 | token_program | | |
| 2 | amm | W | |
| 3 | amm_authority | | |
| 4 | amm_open_orders | | |
| 5 | amm_target_orders | W | |
| 6 | lp_mint | W | |
| 7 | pool_coin_token_account | W | |
| 8 | pool_pc_token_account | W | |
| 9 | market | | |
| 10 | user_coin_token_account | W | |
| 11 | user_pc_token_account | W | |
| 12 | user_lp_token_account | W | |
| 13 | user_owner | | S |
max_*. Reverte com ExceededSlippage se qualquer lado exceder o limite.
Withdraw
Queimar LP, receber ambos os lados.
Argumentos
amount: u64 // LP a queimar
Deposit com a direção invertida; lp_mint é escrita para burn, os ATAs do usuário são receptores. Uma etapa de settle-from-OpenBook semelhante a MonitorStep acontece internamente antes da matemática pro-rata para que o resgate use reservas frescas.
SwapBaseIn
Swap de entrada exata. Sempre um swap de caminho AMM (não roteia através de matching OpenBook).
Use as variantes V2 para novo código. Como o AMM v4 não compartilha mais liquidez com OpenBook, os entrypoints V1 (SwapBaseIn, SwapBaseOut) — que ainda requerem o conjunto completo de contas OpenBook para validação — são funcionalmente redundantes. Novas integrações devem usar SwapBaseInV2 / SwapBaseOutV2, que levam uma lista de contas muito menor e representam o caminho de execução canônico hoje. As formas V1 são documentadas aqui para completude e para ler transações on-chain existentes. amount_in: u64
minimum_amount_out: u64
| # | Nome | W | S |
|---|
| 1 | token_program | | |
| 2 | amm | W | |
| 3 | amm_authority | | |
| 4 | amm_open_orders | W | |
| 5 | amm_target_orders | W | |
| 6 | pool_coin_token_account | W | |
| 7 | pool_pc_token_account | W | |
| 8 | market_program | | |
| 9 | market | W | |
| 10 | market_bids | W | |
| 11 | market_asks | W | |
| 12 | market_event_queue | W | |
| 13 | market_coin_vault | W | |
| 14 | market_pc_vault | W | |
| 15 | market_vault_signer | | |
| 16 | user_source_token_account | W | |
| 17 | user_dest_token_account | W | |
| 18 | user_owner | | S |
products/amm-v4/math.
Pré-condições
amm.status permite swap (bit 0 da máscara de bitmask de status não está definido).amm.state_data.pool_open_time <= now.amount_in > 0.user_source_token_account mantém pelo menos amount_in.
Pós-condições
- Usuário perde
amount_in do token de origem, ganha amount_out ≥ minimum_amount_out do token de destino.
state_data.swap_*_in_amount e swap_*_out_amount incrementados (para análise).need_take_pnl_* incrementado pela parcela de taxa de protocolo.
Erros comuns — ExceededSlippage, InvalidInput, InvalidStatus, InvalidMarket.
SwapBaseOut
Saída exata, inverso de SwapBaseIn. Mesmas contas.
Argumentos
max_amount_in: u64
amount_out: u64
SwapBaseInV2 / SwapBaseOutV2
Variantes de entrypoint de swap que ignoram as contas OpenBook completamente. A matemática é idêntica ao caminho V1, mas a lista de contas encolhe apenas para o lado AMM:
| # | Nome | W | S |
|---|
| 1 | token_program | | |
| 2 | amm | W | |
| 3 | amm_authority | | |
| 4 | amm_open_orders | | |
| 5 | pool_coin_token_account | W | |
| 6 | pool_pc_token_account | W | |
| 7 | user_source_token_account | W | |
| 8 | user_dest_token_account | W | |
| 9 | user_owner | | S |
amount_in / minimum_amount_out para SwapBaseInV2; max_amount_in / amount_out para SwapBaseOutV2).
MonitorStep (legado / inerte)
Não é mais acionado. AMM v4 não compartilha mais liquidez com OpenBook, então MonitorStep não tem nada a fazer — o pool não tem ordens postadas para settle, cancel ou replace. A instrução permanece no programa on-chain para compatibilidade com versões anteriores, mas o keeper do Raydium não a chama mais. Chamá-la manualmente é efetivamente um no-op (exceto por atualizar o estado zerado) e não deve ser necessário para integradores.
plan_order_limit: u16
place_order_limit: u16
cancel_order_limit: u16
- Settled quaisquer ordens preenchidas (seus rendimentos movidos de
market_coin_vault/market_pc_vault para os vaults do pool via OpenBook CPI).
- Cancelou ordens obsoletas cujos preços ou tamanhos não correspondiam mais a
target_orders.
- Postou novas ordens para fechar a lacuna entre
target_orders e amm_open_orders.
Sem permissão. Qualquer conta pode chamá-la; historicamente o keeper do Raydium o fazia rotineiramente.
WithdrawPnl / TakePnl
Sweep administrativo de taxas de protocolo acumuladas.
Argumentos
WithdrawPnl não leva argumentos; lê need_take_pnl_* e move exatamente esses valores.
Contas (abreviado)
| # | Nome | W | S | |
|---|
| 1 | token_program | | | |
| 2 | amm | W | | |
| 3 | amm_authority | | | |
| 4 | amm_config | | | |
| 5 | amm_open_orders | W | | |
| 6 | pool_coin_token_account | W | | |
| 7 | pool_pc_token_account | W | | |
| 8 | pnl_coin_token_account | W | | Destinatário, armazenado em AmmConfig. |
| 9 | pnl_pc_token_account | W | | |
| 10 | pnl_owner | | S | Multisig admin. |
| 11 | market_program | | | |
| 12 | market | W | | |
| 13 | market_event_queue | W | | |
| 14 | market_coin_vault | W | | |
| 15 | market_pc_vault | W | | |
| 16 | market_vault_signer | | | |
- Transfere
need_take_pnl_coin de pool_coin_token_account para pnl_coin_token_account.
- Mesmo para pc.
- Zera
need_take_pnl_coin e need_take_pnl_pc.
Nenhuma alteração nas reservas já que o PnL acumulado foi excluído do invariante.
SetParams
Alterações de parâmetros admin: máscara de status bitmask, profundidade da grid de ordenação, ondas de quantidade, taxas (raramente), etc. Chamado pelo multisig do Raydium. Os argumentos são uma tag param: u8 + payload, análogo ao UpdateAmmConfig do CPMM.
Matriz de mudança de estado
| Instrução | Oferta lp_mint | Vaults | Contadores PnL | OpenBook |
|---|
Initialize2 | oferta inicial cunhada para criador | + init_coin_amount, + init_pc_amount | 0 | OpenOrders criado |
Deposit | + | + ambos | — | settle fills |
Withdraw | − | − ambos | — | settle fills |
SwapBaseIn | — | + in, − out | + pnl share | talvez re-post grid |
SwapBaseOut | — | + in, − out | + pnl share | talvez re-post grid |
MonitorStep | — | settle fills | — | cancel / post |
WithdrawPnl | — | − (pnl swept) | 0 | — |
SetParams | — | — | — | — |
Próximos passos
Fontes:
