Como Usar getTransaction

​

Casos de Uso Comuns

• Verificação de Transação: Confirmar que uma transação foi processada e verificar seu resultado (sucesso ou falha).
• Exibição de Histórico de Transações: Mostrar aos usuários os detalhes de 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 com Falha: Inspecionar 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 fora da cadeia e análise.

​

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 (por exemplo, "finalized", "confirmed"). Se não for fornecido, o compromisso padrão do nó é usado (normalmente "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 convertidas em uma estrutura JSON legível sempre que possível. Esta é 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 por Helius, mas o padrão Solana pode ser diferente. É melhor especificar isso.
   • maxSupportedTransactionVersion (número, opcional): A versão máxima da transação que o endpoint RPC deve processar.
     • Defina como 0 para incluir transações versionadas (incluindo legados).
     • Se omitido, alguns nós podem apenas retornar transações legadas ou erro se transações versionadas forem encontradas. É altamente recomendável configurar isso para 0 para suportar todos os tipos de transações.

​

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 época) 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 estiverem 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 de lamports das contas envolvidas antes do processamento da transação.
  • postBalances (array de u64): Saldos de lamports das contas envolvidas depois do processamento da transação.
  • preTokenBalances (array de objetos | null): Saldos de tokens das contas de token envolvidas antes da transação.
  • postTokenBalances (array de objetos | null): Saldos de tokens das contas de token envolvidas depois da transação.
  • innerInstructions (array de objetos | null): Uma série de instruções executadas como parte do CPI (Cross-Program Invocations) dentro desta transação.
  • logMessages (array de string | null): Uma série de mensagens de log emitidas pelas instruções da transação e quaisquer instruções internas.
  • loadedAddresses (objeto, opcional): Especifica as contas carregadas de tabelas de pesquisa de endereços para esta transação. Contém arrays 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 (array: [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 (array de strings).
  • Se encoding for "base58", "base64": Um array [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 (por exemplo, 0) para transações versionadas. undefined se maxSupportedTransactionVersion não estiver configurado e a transação for versionada.

{
  "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": 0
      }
    ]
  }' \
  <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: 0, // Recommended to support all transaction versions
      // 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 commitment apropriado. Solicitar uma transação que não atingiu 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 registros detalhados. Tenha isso em mente ao processar os dados.
• jsonParsed vs. json: Embora jsonParsed seja 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 configure maxSupportedTransactionVersion: 0 em suas opções de 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 em formatos de transações mais recentes.
• Diferenças em Provedores RPC: Embora a API principal seja padrão, alguns provedores RPC podem oferecer análise aprimorada ou campos adicionais. Helius, por exemplo, fornece uma análise rica de transações.