Instrucciones de AMM v4

Cada instrucción de AMM v4 con sus argumentos, las cuentas del pool y OpenBook que espera, y las condiciones previas/posteriores en cada una.

Esta página fue traducida automáticamente por IA. La versión en inglés es la fuente autorizada.

Ver versión en inglés →

A partir de la actualización del programa 2026-07, la dependencia de OpenBook / Serum de AMM v4 ha sido eliminada. Las instrucciones heredadas v1 SwapBaseIn / SwapBaseOut, Deposit y Withdraw mantienen sus diseños de cuenta antiguos para compatibilidad hacia atrás: las cuentas de mercado aún se aceptan en sus posiciones antiguas, pero ya no se validan ni se usan (no se emite CPI). Las nuevas integraciones deben usar los puntos de entrada de intercambio V2, que omiten completamente las cuentas de mercado. Varias instrucciones han sido eliminadas y ahora revierten — consulta la entrada del registro de cambios. Las listas de cuentas a continuación utilizan los nombres de campo del SDK de Raydium; el IDL subyacente a veces usa prefijos serum_*.

​

Inventario de instrucciones

Grupo	Instrucción	etiqueta	Notas
Ciclo de vida del pool	Initialize2	1	Única instrucción de creación de pool (la interfaz predeterminada es CPMM para nuevos pools).
Liquidez	Deposit	3	Agregar liquidez, recibir LP. Diseño sin cambios (cuentas de mercado ignoradas).
Liquidez	Withdraw	4	Quemar LP, recibir ambos lados prorrateados. Diseño sin cambios (cuentas de mercado ignoradas).
Intercambio	SwapBaseIn	9	Intercambio de entrada exacta. Diseño v1 sin cambios; cuentas de mercado aceptadas pero ignoradas.
Intercambio	SwapBaseOut	11	Intercambio de salida exacta. Igual que arriba.
Intercambio	SwapBaseInV2	16	Recomendado. Intercambio de entrada exacta sin las cuentas de mercado.
Intercambio	SwapBaseOutV2	17	Recomendado. Intercambio de salida exacta sin las cuentas de mercado.
Mantenimiento	SetParams	6	Admin: cambiar parámetros del pool. Diseño + valores de param cambiados (ruptura).
Mantenimiento	WithdrawPnl	7	Barrer PnL de protocolo acumulado. Diseño de cuenta cambiado (ruptura).
Mantenimiento	CreateConfigAccount	14	Admin: inicializar el PDA AmmConfig a nivel de programa.
Mantenimiento	UpdateConfigAccount	15	Admin: cambiar parámetros de configuración a nivel de programa.

El SDK expone constructores solo para las instrucciones orientadas al usuario. Las instrucciones de mantenimiento generalmente son invocadas por el mantenedor de Raydium.

Eliminadas / ya no invocables (ahora revierten con unimplemented!, y sus constructores de cliente fueron eliminados): Initialize (etiqueta 0, usa Initialize2), MonitorStep (2), MigrateToOpenBook (5), WithdrawSrm (8), PreInitialize (10, usa Initialize2), SimulateInfo (12), AdminCancelOrders (13).

​

Initialize2

Arrancar un nuevo pool de AMM v4 vinculado a un mercado OpenBook existente.

Argumentos

nonce:        u8
open_time:    u64
init_pc_amount:   u64
init_coin_amount: u64

Cuentas (escribible W, firmante S)

#	Nombre	W	S	Notas
1	token_program			Token SPL.
2	system_program
3	rent
4	amm	W		Cuenta AmmInfo (clave sembrada).
5	amm_authority			PDA del programa.
6	amm_open_orders	W		OpenBook OpenOrders (sembrado).
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 de LP del creador.
15	pool_temp_lp_token_account	W		Cuenta temporal.
16	market_program			Programa OpenBook.
17	market			Mercado OpenBook.
18	user_wallet	W	S	Creador. Paga renta y financia el depósito inicial.
19	user_token_coin	W
20	user_token_pc	W

Condiciones posteriores

• lp_supply = sqrt(init_coin_amount × init_pc_amount) − INIT_BURN, donde INIT_BURN ≈ 100 unidades de LP se mantienen fuera de circulación.
• No se publican órdenes de OpenBook (la cuadrícula del libro de órdenes ha sido eliminada). market_program / market aún se pasan pero solo se almacenan como campos de referencia; coin_lot_size / pc_lot_size / min_size se inicializan a 0.

Errores comunes — InvalidInput (decimales no coincidentes, no ordenados), NotAllowed.

​

Deposit

Agregar liquidez.

Argumentos

max_coin_amount: u64
max_pc_amount:   u64
base_side:       u64    // 0 = base en coin, 1 = base en pc
// (algunas variantes del SDK también aceptan other_amount_min)

Cuentas (abreviadas)

#	Nombre	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

Matemáticas — prorrateo estándar. Usando las reservas efectivas del pool (bóvedas + en libro), el SDK calcula el par coin/pc que produce la cantidad de LP dada y lo verifica contra max_*. Revierte con ExceededSlippage si alguno de los lados excede el límite.

​

Withdraw

Quemar LP, recibir ambos lados.

Argumentos

amount: u64    // LP a quemar

Cuentas — como Deposit con la dirección invertida; lp_mint es escribible para quemar, los ATA del usuario son receptores. El diseño de la cuenta no ha cambiado (cuentas de mercado aún pasadas posicionalmente, ignoradas). Ya no hay un paso de liquidación desde OpenBook — las matemáticas prorrateadas usan directamente los saldos de la bóveda.

​

SwapBaseIn

Intercambio de entrada exacta. Siempre un intercambio de ruta AMM (no se enruta a través de la coincidencia de OpenBook).

Usa las variantes V2 para código nuevo. Dado que la dependencia de OpenBook de AMM v4 ha sido eliminada, los puntos de entrada V1 (SwapBaseIn, SwapBaseOut) aún esperan la lista completa de 17 cuentas (o 18 con la cuenta de órdenes objetivo opcional), pero las cuentas de OpenBook/mercado ahora se aceptan posicionalmente e ignoran — no se validan y no se emite CPI. Pasar un número de cuenta incorrecto aún revierte con WrongAccountsNumber, pero el contenido de la cuenta de mercado ya no se verifica. Las nuevas integraciones deben usar SwapBaseInV2 / SwapBaseOutV2, que toman una lista de cuentas mucho más pequeña y representan la ruta de ejecución canónica hoy. Las formas V1 se documentan aquí para completitud y para leer transacciones existentes en cadena.

Argumentos

amount_in:            u64
minimum_amount_out:   u64

Cuentas (abreviadas)

#	Nombre	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

Matemáticas — consulta products/amm-v4/math.

Precondiciones

• amm.status permite intercambio (bit 0 de la máscara de bits de estado no establecido).
• amm.state_data.pool_open_time <= now.
• amount_in > 0.
• user_source_token_account contiene al menos amount_in.

Condiciones posteriores

• El usuario pierde amount_in del token de origen, gana amount_out ≥ minimum_amount_out del token de destino.
• need_take_pnl_* incrementado por la parte de la tarifa del protocolo.
• Nota: los contadores de análisis state_data.swap_*_in_amount / swap_*_out_amount ya no se actualizan — sus valores están congelados. Usa registros de transacciones para análisis de volumen.

Errores comunes — ExceededSlippage, InvalidInput, InvalidStatus, NotAllowed (mint de coin/pc idéntico).

​

SwapBaseOut

Salida exacta, inversa de SwapBaseIn. Mismas cuentas.

Argumentos

max_amount_in: u64
amount_out:    u64

​

SwapBaseInV2 / SwapBaseOutV2

Variantes de puntos de entrada de intercambio (etiquetas 16 / 17) que omiten completamente las cuentas de OpenBook. Las matemáticas son idénticas a la ruta V1, pero la lista de cuentas se reduce a solo el lado AMM y el usuario — 8 cuentas, y amm_open_orders no se pasa:

#	Nombre	W	S
1	token_program
2	amm	W
3	amm_authority
4	pool_coin_token_account	W
5	pool_pc_token_account	W
6	user_source_token_account	W
7	user_dest_token_account	W
8	user_owner		S

Las reservas del pool ahora son los saldos de la bóveda (menos PnL pendiente), por lo que las matemáticas de cotización son directas e idénticas a la ruta v1. Usa V2 para ahorrar cómputo y evitar pasar las cuentas de mercado (ahora ignoradas). El enrutador de Raydium siempre usa la forma V2 al enrutar a través de AMM v4.

Los argumentos son los mismos que las formas V1 (amount_in / minimum_amount_out para SwapBaseInV2; max_amount_in / amount_out para SwapBaseOutV2).

​

MonitorStep y otras instrucciones eliminadas

Eliminadas — ya no invocables. A partir de la actualización 2026-07, MonitorStep (etiqueta 2) ha sido eliminada del programa y ahora revierte (unimplemented!) si se invoca. Su constructor de cliente también fue eliminado. Lo mismo se aplica a MigrateToOpenBook (5), WithdrawSrm (8), SimulateInfo (12), AdminCancelOrders (13), y los puntos de entrada heredados de creación de pool Initialize (0) / PreInitialize (10) — usa Initialize2 en su lugar.

Históricamente, MonitorStep accionaba la interacción de OpenBook del pool: liquidaba órdenes completadas (moviendo ganancias de las bóvedas de mercado a las bóvedas del pool a través de CPI de OpenBook), cancelaba órdenes obsoletas y publicaba nuevas órdenes para cerrar la brecha entre target_orders y amm_open_orders. Con la dependencia de OpenBook eliminada, no hay nada que accionar y la instrucción se ha ido. Cualquier mantenedor o integración que aún la llame debe eliminar la llamada.

​

WithdrawPnl / TakePnl

Barrido administrativo de tarifas de protocolo acumuladas.

Argumentos

• WithdrawPnl no toma argumentos; lee need_take_pnl_* y mueve esas cantidades exactas.

Cambio de ruptura (solo admin). La lista de cuentas se redujo de 17 (+1 opcional) a 10 — amm_open_orders y las seis cuentas de mercado fueron eliminadas — sin análisis de compatibilidad. El diseño antiguo se desalinea (el antiguo #5 era amm_open_orders, ahora pool_coin_token_account) y falla con errores como InvalidCoinVault. Las herramientas administrativas deben actualizarse.

Cuentas (nuevo diseño de 10 cuentas)

#	Nombre	W	S
1	token_program
2	amm	W
3	amm_config
4	amm_authority
5	pool_coin_token_account	W
6	pool_pc_token_account	W
7	pnl_coin_token_account	W		Destinatario.
8	pnl_pc_token_account	W
9	pnl_owner		S	Multifirma de admin.
10	amm_target_orders	W

Efecto

• Transfiere need_take_pnl_coin de pool_coin_token_account a pnl_coin_token_account.
• Lo mismo para pc.
• Pone a cero need_take_pnl_coin y need_take_pnl_pc.
• Cambio de lógica: si el saldo de la bóveda es insuficiente para cubrir el PnL acumulado, la instrucción devuelve TakePnlError directamente (ya no manipula el estado del libro de órdenes).

Sin cambio en las reservas ya que el PnL acumulado ya fue excluido del invariante.

​

SetParams

Cambios de parámetros administrativos, llamados por la multifirma de Raydium. Los argumentos son una etiqueta param: u8 + carga útil.

Cambio de ruptura (solo admin). La lista de cuentas se redujo a solo [amm (W), admin (S)] (la autoridad, órdenes abiertas, órdenes objetivo, bóveda y todas las cuentas de mercado fueron eliminadas). La enumeración param fue renumerada y recortada: Status = 0, State = 1, Fees = 2 (era 9), SetOpenTime = 3 (era 11). Todos los parámetros de cuadrícula del libro de órdenes y AmmOwner, LastOrderDistance, UpdateOpenOrder fueron eliminados, y la estructura SetParamsInstruction eliminó new_pubkey y last_order_distance. Las herramientas administrativas deben actualizarse.

​

Matriz de cambio de estado

La columna OpenBook se ha ido — ninguna instrucción toca un libro de órdenes más.

Instrucción	Suministro de lp_mint	Bóvedas	Contadores de PnL
Initialize2	suministro inicial acuñado al creador	+ init_coin_amount, + init_pc_amount	0
Deposit	+	+ ambos	—
Withdraw	−	− ambos	—
SwapBaseIn / SwapBaseInV2	—	+ entrada, − salida	+ parte de pnl
SwapBaseOut / SwapBaseOutV2	—	+ entrada, − salida	+ parte de pnl
WithdrawPnl	—	− (pnl barrido)	0
SetParams	—	—	—

​

Dónde ir a continuación

• products/amm-v4/code-demos — Ejemplos de TypeScript para flujos de intercambio y LP.
• products/amm-v4/fees — Detalles de WithdrawPnl y la división de tarifas.
• reference/error-codes — Tabla de referencia directa (los errores de AMM v4 se enumeran en esa página).

Fuentes:

• Programa Raydium AMM — raydium-io/raydium-amm
• Módulo Liquidity del SDK de Raydium v2
• Programa OpenBook — validaciones de cuentas en el lado del mercado