Transacciones y tarifas

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.

​

Anatomía de la transacción

• Mensaje: la lista ordenada de instrucciones, las cuentas que referencian, y el blockhash reciente.
• Firmas: una por cada firmante, atestiguando que la transacción fue autorizada.
• Blockhash reciente: demuestra que la transacción es reciente; las transacciones con blockhashes obsoletos (>150 slots de antigüedad) son rechazadas.

​

Instrucciones

• program_id — el programa a invocar.
• accounts — las cuentas (y sus indicadores de escribible/firmante) que el programa puede tocar.
• data — bytes opacos que el programa interpreta.

1. ComputeBudget::SetComputeUnitLimit — aumentar el límite de CU por defecto.
2. ComputeBudget::SetComputeUnitPrice — establecer una tarifa de prioridad.
3. CreateAssociatedTokenAccount opcional — crear el ATA de salida si el usuario no tiene uno.
4. Raydium::SwapBaseInput — ejecutar el swap.
5. CloseAccount opcional — cerrar un ATA de SOL envuelto.

​

Cuentas en transacciones

• Firmante / no firmante: ¿debe el propietario de la cuenta firmar la transacción?
• Escribible / solo lectura: ¿puede la transacción modificar la cuenta?

​

Límite de tamaño de transacción

​

Tablas de búsqueda de direcciones (ALT)

• Una transacción que referencia 20 cuentas directamente: ~640 B de claves públicas.
• La misma transacción usando ALT: ~20 B de índices + referencias de ALT.

import { VersionedTransaction } from "@solana/web3.js";

// El SDK construye una tx v0 (versionada) con referencias de ALT
const { transaction } = await raydium.trade.swap({ /* ... */ });
// transaction es una VersionedTransaction, no una Legacy Transaction.

​

Presupuesto de cómputo

• Por defecto: 200,000 CU por transacción.
• Máximo: 1,400,000 CU por transacción (aumentado vía ComputeBudget::SetComputeUnitLimit).
• Límite por bloque: 48M CU por bloque (a nivel de protocolo).

import { ComputeBudgetProgram } from "@solana/web3.js";

tx.add(
  ComputeBudgetProgram.setComputeUnitLimit({ units: 300_000 }),
);

​

Tarifas de prioridad

priority_fee = compute_unit_price (micro-lamports) × compute_unit_limit

tx.add(
  ComputeBudgetProgram.setComputeUnitPrice({ microLamports: 10_000 }),
);

​

Límites de contador de instrucciones y contador de cuentas

• Máximo de cuentas por transacción: 128.
• Máximo de cuentas por instrucción (CPI): 64.
• Máximo de instrucciones por transacción: sin límite duro, limitado solo por el límite de tamaño.
• Profundidad máxima de CPI: 4 (un programa puede llamar otro, que puede llamar otro, 4 niveles de profundidad).

​

Categorías de tarifas en un swap de Raydium

​

Tarifas de red de Solana

• Tarifa de firma base: 5000 lamports por firma. Casi siempre 1 firma = 0.000005 SOL.
• Tarifa de prioridad: CU-price × CU-limit en microlamports. Varía con la congestión; ver integration-guides/priority-fee-tuning.

​

Tarifas del protocolo Raydium

• Tarifa de swap: porcentaje de entrada (CPMM típicamente 0.25%, CLMM 0.01%–1% por tier). Dividida entre LP y destinos del protocolo. Ver ray/protocol-fees.

​

Ejemplo: $1000 USDC → SOL vía CPMM tier 0.25%

​

Transacciones versionadas

• Legacy: el formato original, sin soporte para ALT.
• v0 (Versionado): soporta ALT, extensible a versiones futuras.

// Construyendo una tx v0 directamente
import { VersionedTransaction, TransactionMessage } from "@solana/web3.js";

const msg = new TransactionMessage({
  payerKey:        owner.publicKey,
  recentBlockhash: blockhash,
  instructions:    [ /* ... */ ],
}).compileToV0Message([lookupTableAccount]);

const tx = new VersionedTransaction(msg);
tx.sign([owner]);

​

Frescura del blockhash

async function sendWithRetry(tx, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
    tx.message.recentBlockhash = blockhash;
    tx.sign([owner]);
    try {
      return await connection.sendRawTransaction(tx.serialize());
    } catch (e) {
      if (i === maxRetries - 1) throw e;
    }
  }
}

​

Ejecución paralela

• Dos swaps en el mismo pool no pueden ejecutarse en paralelo — ambos escriben el estado del pool.
• Un swap en Pool A y un swap en Pool B se ejecutan en paralelo si las listas de cuentas no se superponen.
• Una transacción de solo lectura nunca bloquea un escritor en la misma cuenta (solo lectura es concurrente consigo mismo pero no con escrituras).

​

Niveles de confirmación de transacción

await connection.sendAndConfirmTransaction(tx, [owner], {
  commitment: "confirmed",
});

​

Simulación

const sim = await connection.simulateTransaction(tx);
console.log(sim.value.logs);
console.log(sim.value.unitsConsumed);

​

Referencias

• solana-fundamentals/account-model — cuentas en transacciones.
• solana-fundamentals/pdas-and-cpis — cómo los programas se invocan entre sí.
• integration-guides/priority-fee-tuning — dimensionando límites de CU y tarifas de prioridad.
• ray/protocol-fees — estructura de tarifas del protocolo Raydium.

• Documentación de transacciones de Solana.
• Propuesta de tablas de búsqueda de direcciones.
• Documentación de presupuesto de cómputo.