Assinatura e envio

Assine mensagens de transação e confirme landing no Agave 4.1.1.

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

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

Quando usar:

• Submeter transferências e instruções de programa a partir de TypeScript.
• Envios aprovados pela carteira após construção da mensagem.
• Scripts que precisam de confirmação antes de prosseguir.

Exemplo prático

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");

O que isso demonstra:

• Simule antes do envio para expor erros de programa cedo.
• sendAndConfirmTransactionFactory combina envio HTTP com subscription de assinatura.
• Links do explorer ajudam suporte e QA.

Mergulho profundo

Como funciona

• Assinatura produz transação wire com assinaturas Ed25519 válidas.
• RPC sendTransaction transmite para o cluster.
• Confirmação espera até commitment escolhido ser atingido.
• Erros retornam logs de programa em simulação e meta de transação.

Opções de confirmação

Erros comuns

• Pular simulação - usuários pagam taxas por falhas previsíveis. Correção: simule em dev e staging.
• Sem WSS para confirm factory - trava ou faz fallback. Correção: forneça rpcSubscriptions.
• processed tratado como final - rollback de UI possível. Correção: confirme em confirmed+.
• Duplo envio no retry - txs duplicadas se blockhash ainda válido. Correção: chaves de idempotência ou novo blockhash.
• Assinatura parcial da carteira - erro de signer ausente no envio. Correção: garanta todos os signers invocados.

Alternativas

FAQs

Relacionados

• Construindo mensagens de transação - compor primeiro
• RPC e subscriptions - confirmação WSS
• UX de transação - padrões de UI

Versões da stack: Esta página foi 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 e LiteSVM 0.6.x.