Tapahtuman tarkastelu

getTransaction-vastaus ei anna sinulle suoraan valmista ohjeluetteloa. Tilit tallennetaan numeroindekseinä, versioituihin tapahtumiin tilit jaetaan staattisiin avaimiin sekä osoitteisiin, jotka ladataan Address Lookup Tables -taulukoista, ja Cross Program Invocation (CPI) -sisäohjeet saapuvat koodattuina blob-tietoina tapahtuman metatiedoissa.

@solana/transaction-introspection tekee tämän resoluution puolestasi. Se purkaa lanka-tapahtuman, yhdistää jokaisen tilitunnisteen vastaavaan Address-arvoon, normalisoi sisäiset ohjeet ja palauttaa ohjeet samassa ulko-sisä-järjestyksessä kuin lohkoselain näyttää. Palautetut ohjeet sopivat suoraan codama-generoitujen klienttien (esim. @solana-program/*) parseXInstruction -apufunktioihin.

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

Pura vastaus

Hae tapahtuma lanka-muotoisella koodauksella ja välitä vastaus decodeTransactionFromRpcResponse-funktiolle.

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

Jäljellä olevat koodinpätkät käyttävät uudelleen rpcTx-, compiledMessage- ja loadedAddresses-muuttujia tästä vaiheesta.

Käy ohjeet läpi

walkInstructions palauttaa jokaisen ohjeen – ulomman ja sisemmän – taulukkona siinä järjestyksessä kuin lohkoselain näyttää: kukin ulompi ohje välittömästi sitä seuraten sisemmät ohjeet, jotka sen CPI:t tuottivat. Jokaisessa ohjeessa on trace- kenttä, joka kuvaa sen sijaintia kutsuhierarkiassa.

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 on eriytetty unioni: { kind: "outer", index } ylimmän tason ohjeelle tai { kind: "inner", outerIndex, innerIndex, stackHeight? } ulomman ohjeeseen sisäkkäiselle CPI-ohjeelle.

meta on valinnainen – välitä rpcTx.meta suoraan, vaikka se saattaisi olla null. Ilman metaa walkInstructions palauttaa vain ulommat ohjeet.

Jäsennä ohjelmaklientillä

Jokainen walkInstructions:ltä saatu ohje on ResolvedInstruction, joten se toimii suoraan @solana/instructions:n predikaattien sekä @solana-program/*-klienttien tuottamien identifyXInstruction- / parseXInstruction-apuohjelmien kanssa – ei muunnosvaihetta.

Tämä esimerkki tarkastaa jokaisen Token Program SyncNative -ohjeen transaktiossa, oli se sitten suoritettu ylimmällä tasolla tai CPI:n sisällä.

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

Alemman tason apuohjelmat

walkInstructions kattaa useimmat tarpeet, mutta paketti paljastaa myös sen rakentamat osat:

• getInstructionsFromCompiledTransactionMessage(compiledMessage, loadedAddresses?) palauttaa vain ulommat ohjeet ratkaistuin tiliviittauksin ja dekoodatuin tiedoin.
• getInnerInstructionsFromMeta(meta, accountMetas) dekoodaa sisemmät CPI- ohjeet transaktion metatiedoista.
• getAccountMetasFromCompiledTransactionMessage(compiledMessage, loadedAddresses?) palauttaa täydellisen tililuettelon transaktiojärjestyksessä – syöte, jota edellinen apuohjelma tarvitsee sisempien ohjeiden tili-indeksien ratkaisemiseen.

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

Katso myös

• Transaktiorakenne - paketin dekoodaaman vastauksen rakenne
• Versioidut transaktiot - miten osoitehakutaulukot jakavat tilit staattisiin ja ladattuihin ryhmiin
• getTransaction - RPC-metodi, joka palauttaa transaktion