如何使用 getTransaction

​

常见用例

• 交易验证： 确认交易已被处理并检查其结果（成功或失败）。
• 交易历史显示： 向用户显示钱包或浏览器中过去交易的详细信息。
• 审计和分析： 检查交易的详细信息，包括执行的指令、支付的费用和涉及的账户。
• 调试失败的交易： 检查元数据中的 logMessages 和 err 字段，以了解交易失败的原因。
• 数据索引： 从交易中提取特定信息以进行链下存储和分析。

​

请求参数

1. transactionSignature（字符串，必需）：您想查询的 base-58 编码的交易签名。
2. options（对象，可选）：一个可选的配置对象，可以包括：
   • commitment（字符串，可选）：指定承诺级别（例如，"finalized"，"confirmed"）。如果未提供，则使用节点的默认承诺（通常是 "finalized"）。
   • encoding（字符串，可选）：transaction 数据的编码。常见值：
     • "json"：以结构化 JSON 格式返回交易数据（但指令可能仍是 base64 编码）。
     • "jsonParsed"：返回交易数据，其中程序特定的指令在可能的情况下解析为可读的 JSON 结构。这通常是分析最有用的编码。
     • "base58"：将交易数据以 base-58 编码的字符串形式返回。
     • "base64"：将交易数据以 base-64 编码的字符串形式返回。
     • 如果 Helius 未指定，则默认为 "json"，但 Solana 默认值可能不同。最好指定这一点。
   • maxSupportedTransactionVersion（数字，可选）：RPC 端点应处理的最大交易版本。
     • 设置为 1 以包括旧版、v0 和 v1 交易。
     • 如果省略或设置低于交易的版本，请求将因 JSON-RPC 错误 -32015（Transaction version (1) is not supported by the requesting client）而失败。始终将此设置为 1。参见交易 v1 支持。

​

响应结构

• slot（u64）：包含交易的区块的槽位号。
• blockTime（i64 | null）：生成包含交易的区块时的估计 Unix 时间戳（自纪元以来的秒数）。如果不可用，可以是 null。
• meta（对象 | null）：包含交易执行元数据的对象。如果交易在处理前失败或元数据不可用，可以是 null。
  • err（对象 | null）：如果交易失败，则为错误对象，否则为 null。
  • fee（u64）：交易支付的 lamports 费用。
  • preBalances（u64 数组）：交易处理之前涉及账户的 lamport 余额。
  • postBalances（u64 数组）：交易处理之后涉及账户的 lamport 余额。
  • preTokenBalances（对象数组 | null）：交易之前涉及的 token 账户的 token 余额。
  • postTokenBalances（对象数组 | null）：交易之后涉及的 token 账户的 token 余额。
  • innerInstructions（对象数组 | null）：作为本交易中 CPI（跨程序调用）一部分执行的指令数组。
  • logMessages（字符串数组 | null）：交易指令和任何内部指令发出的日志消息数组。
  • loadedAddresses（对象，可选）：指定为此交易从地址查找表加载的账户。包含 PUBLIC_writable 和 readonly 公钥数组。
  • returnData（对象，可选）：通过 sol_set_return_data 和 sol_get_return_data 返回的数据。包含 programId（字符串）和 data（数组：[string, encoding]）。
  • computeUnitsConsumed（u64，可选）：此交易消耗的计算单元数。
• transaction（对象或数组）：交易结构本身。格式取决于 encoding 参数：
  • 如果 encoding 为 "jsonParsed" 或 "json"：包含 message（包含 accountKeys，instructions，recentBlockhash 等）和 signatures（字符串数组）的对象。
  • 如果 encoding 为 "base58"，"base64"：一个数组 [encoded_string, encoding_format_string]。
• version（“legacy” | 数字 | 未定义）：交易的版本。对于较旧的交易，可以是 "legacy"，对于版本化交易，则为一个数字（0 或 1）。如果 maxSupportedTransactionVersion 未设置且交易已版本化，则为 undefined。v1 交易还在其 message 中具有 transactionConfig 对象，内含计算预算（computeUnitLimit，heapSize，loadedAccountsDataSizeLimit，priorityFee），替代计算预算程序指令。其 priorityFee 是 lamports 的总费用，而不是每计算单元的微 lamports。

{
  "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
}

​

代码示例

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

​

开发者提示

• 交易最终性： 确保使用适当的 commitment 级别进行查询。请求尚未达到指定承诺的交易将导致 null。
• 数据量： 响应对象可能非常庞大，尤其是对于包含许多指令或详细日志记录的复杂交易。在处理数据时要注意这一点。
• jsonParsed 与 json： 虽然 jsonParsed 非常方便，但解析支持取决于 RPC 节点对特定程序的能力。如果程序未被识别，即使使用 jsonParsed，其指令可能也会回退到较少解析的格式。
• 版本化交易： 始终在请求选项中设置 maxSupportedTransactionVersion: 1 以确保您的应用程序可以处理旧版和版本化交易。否则，您可能会错过数据或遇到新交易格式的错误。
• RPC 提供者差异： 虽然核心 API 是标准的，但一些 RPC 提供者可能会提供增强的解析或附加字段。例如，Helius 提供了丰富的交易解析。