Como Usar getTransaction

​

Casos de Uso Comuns

• Verificação de Transação: Confirmar que uma transação foi processada e checar seu resultado (sucesso ou falha).
• Exibição do Histórico de Transações: Mostrar aos usuários os detalhes de suas transações passadas em uma carteira ou explorador.
• Auditoria e Análise: Examinar os detalhes de uma transação, incluindo instruções executadas, taxas pagas e contas envolvidas.
• Depuração de Transações Falhadas: Inspecionar os campos logMessages e err nos metadados para entender por que uma transação falhou.
• Indexação de Dados: Extrair informações específicas de transações para armazenamento e análise off-chain.

​

Parâmetros da Solicitação

1. transactionSignature (string, obrigatório): A assinatura da transação codificada em base-58 que você deseja consultar.
2. options (objeto, opcional): Um objeto de configuração opcional que pode incluir:
   • commitment (string, opcional): Especifica o nível de compromisso (ex., "finalized", "confirmed"). Se não for fornecido, o compromisso padrão do nó é usado (geralmente "finalized").
   • encoding (string, opcional): A codificação para os dados transaction. Valores comuns:
     • "json": Retorna os dados da transação em um formato JSON estruturado (mas as instruções ainda podem ser codificadas em base64).
     • "jsonParsed": Retorna os dados da transação com instruções específicas do programa analisadas em uma estrutura JSON legível para humanos sempre que possível. Essa é frequentemente a codificação mais útil para análise.
     • "base58": Retorna os dados da transação como uma string codificada em base-58.
     • "base64": Retorna os dados da transação como uma string codificada em base-64.
     • O padrão é "json" se não especificado pelo Helius, mas o padrão do Solana pode ser diferente. É melhor especificar isso.
   • maxSupportedTransactionVersion (número, opcional): A versão máxima de transação que o endpoint RPC deve processar.
     • Defina como 1 para incluir transações legadas, v0 e v1.
     • Se omitido ou definido abaixo da versão da transação, a solicitação falha com erro JSON-RPC -32015 (Transaction version (1) is not supported by the requesting client). Sempre defina isso como 1. Veja Suporte à transação v1.

​

Estrutura da Resposta

• slot (u64): O número do slot no qual a transação foi incluída em um bloco.
• blockTime (i64 | null): O timestamp Unix estimado (segundos desde a era) quando o bloco contendo a transação foi produzido. Pode ser null se não disponível.
• meta (objeto | null): Um objeto contendo metadados sobre a execução da transação. Pode ser null se a transação falhou antes de ser processada ou se os metadados não estão disponíveis.
  • err (objeto | null): Um objeto de erro se a transação falhou, caso contrário null.
  • fee (u64): A taxa em lamports paga pela transação.
  • preBalances (array de u64): Saldos em lamports de contas envolvidas antes da transação ser processada.
  • postBalances (array de u64): Saldos em lamports de contas envolvidas depois da transação ser processada.
  • preTokenBalances (array de objetos | null): Saldos de token das contas de token envolvidas antes da transação.
  • postTokenBalances (array de objetos | null): Saldos de token das contas de token envolvidas depois da transação.
  • innerInstructions (array de objetos | null): Uma matriz de instruções executadas como parte de CPI (Convocações entre Programas) dentro desta transação.
  • logMessages (array de string | null): Uma matriz de mensagens de log emitidas pelas instruções da transação e quaisquer instruções internas.
  • loadedAddresses (objeto, opcional): Especifica as contas carregadas das tabelas de consulta de endereços para esta transação. Contém matrizes writable e readonly de chaves públicas.
  • returnData (objeto, opcional): Dados retornados pela transação via sol_set_return_data e sol_get_return_data. Contém programId (string) e data (matriz: [string, encoding]).
  • computeUnitsConsumed (u64, opcional): O número de unidades de computação consumidas por esta transação.
• transaction (objeto | array): A própria estrutura da transação. O formato depende do parâmetro encoding:
  • Se encoding for "jsonParsed" ou "json": Um objeto com message (contendo accountKeys, instructions, recentBlockhash, etc.) e signatures (matriz de strings).
  • Se encoding for "base58", "base64": Uma matriz [encoded_string, encoding_format_string].
• version (“legacy” | número | indefinido): A versão da transação. Pode ser "legacy" para transações mais antigas ou um número (0 ou 1) para transações versionadas. undefined se maxSupportedTransactionVersion não estiver definido e a transação for versionada. Uma transação v1 também carrega um objeto transactionConfig em seu message com o orçamento de computação (computeUnitLimit, heapSize, loadedAccountsDataSizeLimit, priorityFee), substituindo as instruções do programa ComputeBudget. Seu priorityFee é a taxa total em lamports, não micro-lamports por unidade de computação.

{
  "jsonrpc": "2.0",
  "result": {
    "blockTime": 1635900000,
    "meta": {
      "err": null,
      "fee": 5000,
      "innerInstructions": [],
      "logMessages": [
        "Program Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS invoke [1]",
        "Program log: Memo 'Hello, Solana!'",
        "Program Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS success"
      ],
      "postBalances": [
        499999999999994999, 
        1000000000
      ],
      "postTokenBalances": [],
      "preBalances": [
        500000000000000000, 
        1000000000
      ],
      "preTokenBalances": [],
      "rewards": [],
      "status": { "Ok": null },
      "computeUnitsConsumed": 200
    },
    "slot": 98765432,
    "transaction": {
      "message": {
        "accountKeys": [
          "SysvarRent111111111111111111111111111111111",
          "Vote111111111111111111111111111111111111111"
        ],
        "instructions": [
          {
            "parsed": {
              "type": "vote",
              "info": {
                "votePubkey": "Vote111111111111111111111111111111111111111",
                "slot": 123,
                "hash": "abc..."
              }
            },
            "program": "vote",
            "programId": "Vote111111111111111111111111111111111111111"
          }
        ],
        "recentBlockhash": "xyz..."
      },
      "signatures": [
        "sig1..."
      ]
    },
    "version": "legacy"
  },
  "id": 1
}

​

Exemplos de Código

# Replace <TRANSACTION_SIGNATURE> with an actual signature
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTransaction",
    "params": [
      "<TRANSACTION_SIGNATURE>",
      {
        "encoding": "jsonParsed",
        "maxSupportedTransactionVersion": 1
      }
    ]
  }' \
  <YOUR_RPC_URL>

const { Connection } = require('@solana/web3.js');

async function getTransactionDetails(signature) {
  // Replace with your RPC endpoint
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');

  try {
    const transaction = await connection.getTransaction(signature, {
      maxSupportedTransactionVersion: 1, // Required for legacy, v0, and v1 transactions
      // commitment: 'confirmed', // Optional: specify commitment level
    });

    if (transaction) {
      console.log('Transaction Details:');
      console.log(`  Slot: ${transaction.slot}`);
      console.log(`  Block Time: ${transaction.blockTime ? new Date(transaction.blockTime * 1000).toLocaleString() : 'N/A'}`);
      console.log(`  Fee: ${transaction.meta ? transaction.meta.fee : 'N/A'} lamports`);
      console.log(`  Status: ${transaction.meta && transaction.meta.err ? 'Failed' : 'Success'}`);
      if (transaction.meta && transaction.meta.err) {
        console.log(`    Error: ${JSON.stringify(transaction.meta.err)}`);
      }
      // console.log(JSON.stringify(transaction, null, 2)); // Log full transaction details

      if (transaction.meta && transaction.meta.logMessages) {
        console.log('  Log Messages:');
        transaction.meta.logMessages.forEach(log => console.log(`    ${log}`));
      }

    } else {
      console.log('Transaction not found or not confirmed.');
    }
  } catch (error) {
    console.error(`Error fetching transaction ${signature}:`, error);
  }
}

// Replace with an actual transaction signature from Mainnet-beta or your test environment
const exampleSignature = '5h4zCwobYsdL3mY26FgfXy8c4rTPkX6gYVXW8w2tTjCXZMWzE9jX9p8Q2Y8Yj9p8ZQ8Yj9p8ZQ8Yj9p8ZQ8Yj9'; // Replace with a real signature
// getTransactionDetails(exampleSignature);

// Example of a known transaction (you'll need to find a recent one on an explorer)
// getTransactionDetails('2xNdnHjZDmJRy1L6jC1mF87K3V9nXZo2bY6vA8GzQ3T7bS9xU8cM7sR5eD3fG2hJ1aB0cE9lK6mN5pP4qR7');

console.log("Please replace 'exampleSignature' with a real transaction signature to run the example.");

​

Dicas para Desenvolvedores

• Finalidade da Transação: Certifique-se de consultar com um nível adequado commitment. Solicitar uma transação que não alcançou o compromisso especificado resultará em null.
• Volume de Dados: O objeto de resposta pode ser muito grande, especialmente para transações complexas com muitas instruções ou logs detalhados. Tenha isso em mente ao processar os dados.
• jsonParsed vs. json: Enquanto jsonParsed é muito conveniente, o suporte à análise depende das capacidades do nó RPC para programas específicos. Se um programa não for reconhecido, suas instruções podem voltar a um formato menos analisado mesmo com jsonParsed.
• Transações Versionadas: Sempre defina maxSupportedTransactionVersion: 1 nas opções de sua solicitação para garantir que sua aplicação possa lidar com transações legadas e versionadas. Caso contrário, você pode perder dados ou encontrar erros para formatos de transações mais recentes.
• Diferenças entre Provedores RPC: Embora a API principal seja padrão, alguns provedores RPC podem oferecer análise aprimorada ou campos adicionais. Helius, por exemplo, fornece rica análise de transações.