Firma y Envío

Firma mensajes de transacción y confirma el aterrizaje en Agave 4.1.1.

Receta

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

import {
  signTransactionMessageWithSigners,
  getSignatureFromTransaction,
  sendAndConfirmTransactionFactory,
  createSolanaRpc,
  createSolanaRpcSubscriptions,
} from "@solana/kit";
 
const signed = await signTransactionMessageWithSigners(message);
const sendAndConfirm = sendAndConfirmTransactionFactory({ rpc, rpcSubscriptions });
await sendAndConfirm(signed, { commitment: "confirmed" });

Cuándo usar esto:

• Envío de transferencias e instrucciones de programa desde TypeScript.
• Envíos aprobados por la billetera después de la construcción del mensaje.
• Scripts que necesitan confirmación antes de continuar.

Ejemplo de Trabajo

import {
  createSolanaRpc,
  createSolanaRpcSubscriptions,
  signTransactionMessageWithSigners,
  getSignatureFromTransaction,
  sendAndConfirmTransactionFactory,
  getBase64EncodedWireTransaction,
} from "@solana/kit";
 
const rpc = createSolanaRpc(process.env.RPC_URL!);
const rpcSubscriptions = createSolanaRpcSubscriptions(process.env.RPC_WSS_URL!);
 
const signed = await signTransactionMessageWithSigners(message);
const signature = getSignatureFromTransaction(signed);
 
const simulation = await rpc
  .simulateTransaction(getBase64EncodedWireTransaction(signed), { sigVerify: true })
  .send();
if (simulation.value.err) throw new Error(JSON.stringify(simulation.value.err));
 
const sendAndConfirm = sendAndConfirmTransactionFactory({ rpc, rpcSubscriptions });
await sendAndConfirm(signed, { commitment: "confirmed" });
console.log("https://explorer.solana.com/tx/" + signature + "?cluster=devnet");

Lo que esto demuestra:

• Simular antes de enviar para detectar errores del programa de forma temprana.
• sendAndConfirmTransactionFactory empareja el envío HTTP con la suscripción de firma.
• Los enlaces del explorador ayudan al soporte y control de calidad.

Análisis Profundo

Cómo Funciona

• La firma produce una transacción en el cable con firmas Ed25519 válidas.
• RPC sendTransaction transmite al clúster.
• La confirmación espera hasta que se alcance el compromiso elegido.
• Los errores devuelven los registros del programa en la simulación y los metadatos de la transacción.

Opciones de Confirmación

Errores Comunes

• Omitir la simulación - los usuarios pagan tarifas por fallos predecibles. Solución: simular en desarrollo y staging.
• No hay WSS para la fábrica de confirmación - se cuelga o recurre a un fallback. Solución: proporcionar rpcSubscriptions.
• processed tratado como final - posible reversión de la UI. Solución: confirmar en confirmed o superior.
• Doble envío al reintentar - transacciones duplicadas si el hash del bloque aún es válido. Solución: claves de idempotencia o nuevo hash de bloque.
• Firma parcial de la billetera - error de firmante faltante al enviar. Solución: asegurar que se invocan todos los firmantes.

Alternativas

Preguntas Frecuentes

Relacionado

• Construcción de Mensajes de Transacción - componer primero
• RPC y Suscripciones - confirmación WSS
• UX de Transacciones - patrones de UI

Versiones de Stack: Esta página fue escrita 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.