APIs de Tarifa de Prioridad y Simulación

Utiliza getRecentPrioritizationFees, simulateTransaction y las APIs de tarifas del proveedor para estimar las unidades de cómputo y las tarifas de prioridad antes de enviar transacciones.

Receta

Tarjeta de receta de referencia rápida - lista para copiar y pegar.

import { createSolanaRpc, getBase64EncodedWireTransaction } from "@solana/kit";
 
const rpc = createSolanaRpc("https://api.mainnet-beta.solana.com");
 
await rpc.getRecentPrioritizationFees([]).send();
await rpc.simulateTransaction(encodedTx, {
  commitment: "processed",
  sigVerify: false,
}).send();

Cuándo usar esto:

• Establecer tarifas de prioridad dinámicas a partir de percentiles recientes de la red.
• Estimar el consumo de unidades de cómputo (CU) para establecer instrucciones de presupuesto de cómputo.
• Comprobación previa de errores de programas personalizados sin confirmación en la red.
• Depuración de fallos de transacciones en entornos de prueba.

Ejemplo Funcional

import { createSolanaRpc } from "@solana/kit";
 
const rpc = createSolanaRpc(process.env.RPC_URL!);
 
// Tarifas de prioridad recientes para cuentas relevantes (vacío = muestra global)
const fees = await rpc.getRecentPrioritizationFees([]).send();
const recent = fees.map((f) => f.prioritizationFee).filter((n) => n > 0);
recent.sort((a, b) => a - b);
const p75 = recent[Math.floor(recent.length * 0.75)] ?? 0;
console.log("precio sugerido de microLamports por CU (p75):", p75);
 
// Simular tx firmada o parcialmente firmada (wire en base64)
const simulation = await rpc
  .simulateTransaction("BASE64_WIRE_TX", {
    commitment: "processed",
    sigVerify: false,
    replaceRecentBlockhash: true,
  })
  .send();
 
console.log("err:", simulation.value.err);
console.log("units:", simulation.value.unitsConsumed);
console.log("logs:", simulation.value.logs?.slice(0, 5));

Lo que esto demuestra:

• La RPC de simulación de tarifas de prioridad utiliza muestras de transacciones recientes confirmadas para obtener orientación sobre las tarifas.
• La simulación devuelve unitsConsumed y registros sin confirmar estado (excepto cuando está configurado).
• replaceRecentBlockhash ayuda a simular transacciones con blockhashes caducados.

Análisis Profundo

Cómo Funciona

• Las tarifas de prioridad son micro-lamports por unidad de cómputo que se pagan a los validadores además de la tarifa base.
• getRecentPrioritizationFees devuelve observaciones de tarifas por slot para conjuntos de bloqueo de cuentas.
• simulateTransaction ejecuta SVM contra una instantánea del banco en el nivel de compromiso elegido.
• Los proveedores pueden exponer puntos finales mejorados priorityFeeEstimate con estadísticas de percentiles.

Opciones de Simulación

Notas de TypeScript

// Después de la simulación, establece la ix del presupuesto de cómputo con margen
const units = simulation.value.unitsConsumed ?? 200_000;
const limit = Math.ceil(units * 1.1);
const microLamports = Math.max(p75, 1_000);

Errores Comunes

• Éxito de simulación ≠ confirmación en la red - la congestión y los blockhashes caducados aún fallan al enviar. Solución: combinar con un blockhash nuevo y reintentos de tarifa de prioridad.
• Tarifa de prioridad infravalorada - la simulación pasa pero la transacción se cae. Solución: apuntar al percentil 75-90 con un límite.
• sigVerify falso ocultando errores del firmante - falsos positivos. Solución: pre-vuelo final con sigVerify: true antes de enviar a mainnet.
• Muestra de priorización obsoleta - las tarifas se disparan durante las acuñaciones de NFT. Solución: actualizar las tarifas por lote de envío.
• Ignorar unitsConsumed - el límite predeterminado de 200k CU puede ser demasiado bajo. Solución: establecer un límite explícito a partir de la simulación + 10% de margen.

Alternativas

Preguntas Frecuentes

Relacionado

• Estimar Unidades de Cómputo - margen de CU
• Establecer Tarifas de Prioridad - estrategia de tarifas
• Simular Transacciones - modelo conceptual
• Proveedores RPC - APIs mejoradas

Versiones de Stack: Esta página se escribió para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0, y LiteSVM 0.6.x.