Introspeksi Transaksi

Respons getTransaction tidak langsung memberikan daftar instruksi yang siap digunakan. Akun disimpan sebagai indeks numerik, transaksi berversi membagi akun-akun tersebut menjadi kunci statis ditambah alamat yang dimuat dari Address Lookup Tables, dan instruksi dalam dari Cross Program Invocation (CPI) hadir sebagai blob terenkode dalam metadata transaksi.

@solana/transaction-introspection melakukan resolusi ini untuk Anda. Ini mendekode transaksi wire, memetakan setiap indeks akun kembali ke Address-nya, menormalisasi instruksi dalam, dan mengembalikan instruksi dalam urutan luar-kemudian-dalam yang sama seperti yang ditampilkan block explorer. Instruksi yang dikembalikan dapat langsung digunakan ke helper parseXInstruction dari klien yang dihasilkan codama (misalnya, @solana-program/*).

npm install @solana/transaction-introspection @solana/kit @solana/instructions @solana-program/token

Dekode respons

Ambil transaksi dengan encoding format wire dan teruskan respons ke decodeTransactionFromRpcResponse.

import { createSolanaRpc, signature } from "@solana/kit";
import { decodeTransactionFromRpcResponse } from "@solana/transaction-introspection";

const rpc = createSolanaRpc("https://api.mainnet-beta.solana.com");

const txid =
  "3jUKrQp1UGq5ih6FTDUUt2kkqUfoG2o4kY5T1DoVHK2tXXDLdxJSXzuJGY4JPoRivgbi45U2bc7LZfMa6C4R3szX";

const rpcTx = await rpc
  .getTransaction(signature(txid), {
    commitment: "confirmed",
    encoding: "base64",
    maxSupportedTransactionVersion: 0
  })
  .send();
if (!rpcTx) throw new Error(`Transaction ${txid} not found`);

const { compiledMessage, loadedAddresses } =
  decodeTransactionFromRpcResponse(rpcTx);

Cuplikan berikutnya menggunakan kembali rpcTx, compiledMessage, dan loadedAddresses dari langkah ini.

Menelusuri instruksi

walkInstructions mengembalikan setiap instruksi - luar dan dalam - sebagai array dalam urutan yang ditampilkan oleh block explorer: setiap instruksi luar diikuti langsung oleh instruksi dalam yang dihasilkan oleh CPI-nya. Setiap instruksi memiliki field trace yang menjelaskan posisinya dalam hierarki panggilan.

import { walkInstructions } from "@solana/transaction-introspection";

for (const ix of walkInstructions({
  compiledMessage,
  loadedAddresses,
  meta: rpcTx.meta
})) {
  const location =
    ix.trace.kind === "outer"
      ? `outer[${ix.trace.index}]`
      : `inner[${ix.trace.outerIndex}/${ix.trace.innerIndex}]`;
  console.log(location, ix.programAddress, ix.accounts?.length ?? 0);
}

trace adalah discriminated union: { kind: "outer", index } untuk instruksi tingkat atas, atau { kind: "inner", outerIndex, innerIndex, stackHeight? } untuk instruksi CPI yang bersarang di bawah instruksi luar.

meta bersifat opsional - teruskan rpcTx.meta secara langsung meskipun nilainya mungkin null. Tanpa meta, walkInstructions hanya mengembalikan instruksi luar.

Mengurai dengan program client

Setiap instruksi dari walkInstructions adalah ResolvedInstruction, sehingga dapat digunakan langsung dengan predikat dari @solana/instructions dan helper identifyXInstruction / parseXInstruction yang dihasilkan oleh client @solana-program/* - tanpa langkah konversi.

Contoh ini mengaudit setiap instruksi Token Program SyncNative dalam sebuah transaksi, baik yang berjalan di tingkat atas maupun di dalam CPI.

import {
  isInstructionForProgram,
  isInstructionWithAccounts,
  isInstructionWithData
} from "@solana/instructions";
import { walkInstructions } from "@solana/transaction-introspection";
import {
  identifyTokenInstruction,
  parseSyncNativeInstruction,
  TOKEN_PROGRAM_ADDRESS,
  TokenInstruction
} from "@solana-program/token";

for (const ix of walkInstructions({
  compiledMessage,
  loadedAddresses,
  meta: rpcTx.meta
})) {
  if (!isInstructionForProgram(ix, TOKEN_PROGRAM_ADDRESS)) continue;
  if (!isInstructionWithData(ix) || !isInstructionWithAccounts(ix)) continue;
  if (identifyTokenInstruction(ix) !== TokenInstruction.SyncNative) continue;

  const parsed = parseSyncNativeInstruction(ix);
  console.log(ix.trace, parsed);
}

Helper tingkat lebih rendah

walkInstructions mencakup sebagian besar kebutuhan, tetapi paket ini juga mengekspos komponen yang menjadi dasarnya:

• getInstructionsFromCompiledTransactionMessage(compiledMessage, loadedAddresses?) hanya mengembalikan instruksi luar, dengan akun yang telah diselesaikan dan data yang telah didekode.
• getInnerInstructionsFromMeta(meta, accountMetas) mendekode instruksi CPI dalam dari metadata transaksi.
• getAccountMetasFromCompiledTransactionMessage(compiledMessage, loadedAddresses?) mengembalikan daftar akun lengkap dalam urutan transaksi - input yang dibutuhkan helper sebelumnya untuk menyelesaikan indeks akun instruksi dalam.

import {
  getAccountMetasFromCompiledTransactionMessage,
  getInnerInstructionsFromMeta,
  getInstructionsFromCompiledTransactionMessage
} from "@solana/transaction-introspection";

const outer = getInstructionsFromCompiledTransactionMessage(
  compiledMessage,
  loadedAddresses
);

const accountMetas = getAccountMetasFromCompiledTransactionMessage(
  compiledMessage,
  loadedAddresses
);

if (!rpcTx.meta) throw new Error("Transaction metadata missing");
const inner = getInnerInstructionsFromMeta(rpcTx.meta, accountMetas);

Lihat juga

• Struktur Transaksi - anatomi dari respons yang didekode oleh paket ini
• Transaksi Berversi - bagaimana Address Lookup Tables membagi akun menjadi grup statis dan grup yang dimuat
• getTransaction - metode RPC yang mengembalikan transaksi