Introspekcja transakcji

Odpowiedź getTransaction nie dostarcza gotowej listy instrukcji. Konta są przechowywane jako indeksy numeryczne, transakcje wersjonowane dzielą te konta na klucze statyczne oraz adresy ładowane z Address Lookup Tables, a wewnętrzne instrukcje z Cross Program Invocation (CPI) trafiają jako zakodowane dane w metadanych transakcji.

@solana/transaction-introspection wykonuje to rozwiązywanie za Ciebie. Dekoduje transakcję w formacie wire, mapuje każdy indeks konta z powrotem na jego Address, normalizuje wewnętrzne instrukcje i zwraca instrukcje w tej samej kolejności zewnętrzne-a-następnie-wewnętrzne, jaką pokazuje eksplorator bloków. Zwrócone instrukcje można bezpośrednio podłączyć do helperów parseXInstruction klientów generowanych przez codamę (np. @solana-program/* ).

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

Dekodowanie odpowiedzi

Pobierz transakcję z kodowaniem w formacie wire i przekaż odpowiedź do 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);

Pozostałe fragmenty kodu ponownie wykorzystują rpcTx, compiledMessage i loadedAddresses z tego kroku.

Przeglądanie instrukcji

walkInstructions zwraca każdą instrukcję — zewnętrzną i wewnętrzną — jako tablicę w kolejności, w jakiej pokazuje ją eksplorator bloków: każda instrukcja zewnętrzna następuje bezpośrednio po instrukcjach wewnętrznych wygenerowanych przez jej CPI. Każda instrukcja zawiera pole trace opisujące jej miejsce w hierarchii wywołań.

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 to unia dyskryminowana: { kind: "outer", index } dla instrukcji najwyższego poziomu lub { kind: "inner", outerIndex, innerIndex, stackHeight? } dla instrukcji CPI zagnieżdżonej pod instrukcją zewnętrzną.

meta jest opcjonalne — przekaż rpcTx.meta bezpośrednio, nawet jeśli może być null. Bez metadanych walkInstructions zwraca tylko instrukcje zewnętrzne.

Parsowanie za pomocą klienta programu

Każda instrukcja z walkInstructions jest ResolvedInstruction, więc działa bezpośrednio z predykatami z @solana/instructions oraz pomocnikami identifyXInstruction / parseXInstruction generowanymi przez klientów @solana-program/* — bez etapu konwersji.

Ten przykład audytuje każdą instrukcję Token Program SyncNative w transakcji, niezależnie od tego, czy została wykonana na najwyższym poziomie, czy wewnątrz 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);
}

Pomocniki niższego poziomu

walkInstructions pokrywa większość potrzeb, jednak pakiet udostępnia również składowe, na których jest oparty:

• getInstructionsFromCompiledTransactionMessage(compiledMessage, loadedAddresses?) zwraca tylko instrukcje zewnętrzne z rozwiązanymi kontami i zdekodowanymi danymi.
• getInnerInstructionsFromMeta(meta, accountMetas) dekoduje wewnętrzne instrukcje CPI z metadanych transakcji.
• getAccountMetasFromCompiledTransactionMessage(compiledMessage, loadedAddresses?) zwraca pełną listę kont w kolejności transakcji — dane wejściowe, których poprzedni pomocnik potrzebuje do rozwiązania indeksów kont instrukcji wewnętrznych.

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);

Zobacz również

• Struktura transakcji - anatomia odpowiedzi dekodowanej przez ten pakiet
• Transakcje wersjonowane - jak tablice wyszukiwania adresów dzielą konta na grupy statyczne i ładowane
• getTransaction - metoda RPC, która zwraca transakcję