Cách sử dụng getTransaction

​

Các trường hợp sử dụng phổ biến

• Xác minh giao dịch: Xác nhận rằng một giao dịch đã được xử lý và kiểm tra kết quả của giao dịch (thành công hoặc thất bại).
• Hiển thị lịch sử giao dịch: Hiển thị cho người dùng thông tin chi tiết về các giao dịch trước đây của họ trong ví hoặc trình khám phá.
• Kiểm tra và phân tích: Xem xét chi tiết của một giao dịch, bao gồm các lệnh đã thực thi, phí đã trả và các tài khoản liên quan.
• Gỡ lỗi giao dịch thất bại: Kiểm tra các trường logMessages và err trong siêu dữ liệu để tìm hiểu nguyên nhân giao dịch thất bại.
• Lập chỉ mục dữ liệu: Trích xuất thông tin cụ thể từ các giao dịch để lưu trữ và phân tích ngoài chuỗi.

​

Tham số yêu cầu

1. transactionSignature (chuỗi, bắt buộc): Chữ ký giao dịch được mã hóa base-58 mà bạn muốn truy vấn.
2. options (đối tượng, không bắt buộc): Một đối tượng cấu hình không bắt buộc có thể bao gồm:
   • commitment (chuỗi, không bắt buộc): Chỉ định mức cam kết (ví dụ: "finalized", "confirmed"). Nếu không được cung cấp, mức cam kết mặc định của nút sẽ được sử dụng (thường là "finalized").
   • encoding (chuỗi, không bắt buộc): Kiểu mã hóa cho dữ liệu transaction. Các giá trị phổ biến:
     • "json": Trả về dữ liệu giao dịch ở định dạng JSON có cấu trúc (nhưng các lệnh vẫn có thể được mã hóa base64).
     • "jsonParsed": Trả về dữ liệu giao dịch với các lệnh dành riêng cho chương trình được phân tích thành cấu trúc JSON mà con người có thể đọc được khi có thể. Đây thường là kiểu mã hóa hữu ích nhất để phân tích.
     • "base58": Trả về dữ liệu giao dịch dưới dạng chuỗi được mã hóa base-58.
     • "base64": Trả về dữ liệu giao dịch dưới dạng chuỗi được mã hóa base-64.
     • Mặc định là "json" nếu Helius không chỉ định, nhưng giá trị mặc định của Solana có thể khác. Tốt nhất là nên chỉ định giá trị này.
   • maxSupportedTransactionVersion (số, không bắt buộc): Phiên bản giao dịch tối đa mà endpoint RPC sẽ xử lý.
     • Đặt thành 1 để bao gồm các giao dịch cũ, v0 và v1.
     • Nếu bỏ qua hoặc đặt thấp hơn phiên bản của giao dịch, yêu cầu sẽ thất bại với lỗi JSON-RPC -32015 (Transaction version (1) is not supported by the requesting client). Luôn đặt giá trị này thành 1. Xem Hỗ trợ giao dịch v1.

​

Cấu trúc phản hồi

• slot (u64): Số slot chứa khối mà giao dịch được đưa vào.
• blockTime (i64 | null): Dấu thời gian Unix ước tính (số giây kể từ epoch) khi khối chứa giao dịch được tạo. Có thể là null nếu không có sẵn.
• meta (đối tượng | null): Đối tượng chứa siêu dữ liệu về quá trình thực thi giao dịch. Có thể là null nếu giao dịch thất bại trước khi được xử lý hoặc nếu không có siêu dữ liệu.
  • err (đối tượng | null): Đối tượng lỗi nếu giao dịch thất bại; nếu không thì là null.
  • fee (u64): Phí giao dịch đã trả, tính bằng lamport.
  • preBalances (mảng u64): Số dư lamport của các tài khoản liên quan trước khi giao dịch được xử lý.
  • postBalances (mảng u64): Số dư lamport của các tài khoản liên quan sau khi giao dịch được xử lý.
  • preTokenBalances (mảng đối tượng | null): Số dư token của các tài khoản token liên quan trước giao dịch.
  • postTokenBalances (mảng đối tượng | null): Số dư token của các tài khoản token liên quan sau giao dịch.
  • innerInstructions (mảng đối tượng | null): Mảng các lệnh được thực thi trong khuôn khổ CPI (lệnh gọi liên chương trình) trong giao dịch này.
  • logMessages (mảng chuỗi | null): Mảng thông báo nhật ký do các lệnh của giao dịch và mọi lệnh nội bộ phát ra.
  • loadedAddresses (đối tượng, không bắt buộc): Chỉ định các tài khoản được tải từ bảng tra cứu địa chỉ cho giao dịch này. Chứa các mảng khóa công khai writable và readonly.
  • returnData (đối tượng, không bắt buộc): Dữ liệu được giao dịch trả về qua sol_set_return_data và sol_get_return_data. Chứa programId (chuỗi) và data (mảng: [string, encoding]).
  • computeUnitsConsumed (u64, không bắt buộc): Số đơn vị tính toán mà giao dịch này đã tiêu thụ.
• transaction (đối tượng | mảng): Chính cấu trúc giao dịch. Định dạng phụ thuộc vào tham số encoding:
  • Nếu encoding là "jsonParsed" hoặc "json": Một đối tượng có message (chứa accountKeys, instructions, recentBlockhash, v.v.) và signatures (mảng chuỗi).
  • Nếu encoding là "base58", "base64": Một mảng [encoded_string, encoding_format_string].
• version (“legacy” | số | undefined): Phiên bản của giao dịch. Có thể là "legacy" đối với các giao dịch cũ hoặc một số (0 hoặc 1) đối với các giao dịch có phiên bản. Là undefined nếu maxSupportedTransactionVersion chưa được đặt và giao dịch có phiên bản. Giao dịch v1 cũng chứa một đối tượng transactionConfig trong message với ngân sách tính toán (computeUnitLimit, heapSize, loadedAccountsDataSizeLimit, priorityFee), thay thế các lệnh của chương trình ComputeBudget. priorityFee của giao dịch là tổng phí tính bằng lamport, không phải micro-lamport trên mỗi đơn vị tính toán.

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

​

Ví dụ mã

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

​

Mẹo dành cho nhà phát triển

• Tính hoàn tất của giao dịch: Đảm bảo truy vấn bằng mức commitment phù hợp. Việc yêu cầu một giao dịch chưa đạt mức cam kết đã chỉ định sẽ trả về null.
• Khối lượng dữ liệu: Đối tượng phản hồi có thể rất lớn, đặc biệt đối với các giao dịch phức tạp có nhiều lệnh hoặc nhật ký chi tiết. Hãy lưu ý điều này khi xử lý dữ liệu.
• jsonParsed so với json: Mặc dù jsonParsed rất tiện lợi, khả năng hỗ trợ phân tích cú pháp phụ thuộc vào khả năng của nút RPC đối với từng chương trình cụ thể. Nếu một chương trình không được nhận dạng, các lệnh của chương trình đó có thể dùng định dạng ít được phân tích hơn ngay cả khi sử dụng jsonParsed.
• Giao dịch có phiên bản: Luôn đặt maxSupportedTransactionVersion: 1 trong các tùy chọn yêu cầu để đảm bảo ứng dụng có thể xử lý cả giao dịch cũ lẫn giao dịch có phiên bản. Nếu không, bạn có thể bỏ sót dữ liệu hoặc gặp lỗi với các định dạng giao dịch mới hơn.
• Khác biệt giữa các nhà cung cấp RPC: Mặc dù API cốt lõi là tiêu chuẩn, một số nhà cung cấp RPC có thể cung cấp khả năng phân tích cú pháp nâng cao hoặc các trường bổ sung. Ví dụ, Helius cung cấp khả năng phân tích giao dịch phong phú.