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 エンドポイントが処理すべき最大トランザクションバージョンです。
     • レガシー、v0、v1 トランザクションを含むように 1 に設定します。
     • 省略された場合、またはトランザクションのバージョンより低く設定された場合、要求は 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): トランザクション前に関与するアカウントのトークンバランス。
  • postTokenBalances (オブジェクトの配列 | null): トランザクション後に関与するアカウントのトークンバランス。
  • innerInstructions (オブジェクトの配列 | null): このトランザクション内で CPI (クロスプログラム呼び出し) の一部として実行された指示の配列。
  • logMessages (文字列の配列 | null): トランザクションの指示および内部指示によって発行されたログメッセージの配列。
  • loadedAddresses (オブジェクト, オプション): このトランザクションに対してアドレスルックアップテーブルからロードされたアカウントを指定します。writable および readonly のパブリックキーの配列を含みます。
  • returnData (オブジェクト, オプション): トランザクションによって sol_set_return_data および sol_get_return_data 経由で返されたデータ。programId (文字列) および data (配列: [string, encoding]) を含みます。
  • computeUnitsConsumed (u64, オプション): このトランザクションによって消費された計算ユニットの数。

{
  "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 は豊富なトランザクション解析を提供します。