Unterstützung für Transaktion v1

​

Was sich mit Transaktion v1 ändert

• Du musst den Empfang explizit aktivieren. Requests für vollständige Transaktionsdaten benötigen maxSupportedTransactionVersion: 1. Außerdem muss deine Clientbibliothek eine Version verwenden, die v1 deserialisieren kann.
• Das Compute-Budget wird in den Nachrichten-Header verschoben. Eine v1-Nachricht enthält ein transactionConfig-Objekt mit computeUnitLimit, heapSize, loadedAccountsDataSizeLimit und priorityFee. Eine v1-Transaktion enthält keine Anweisungen des ComputeBudget-Programms.

{
  "version": 1,
  "transaction": {
    "signatures": ["..."],
    "message": {
      "accountKeys": ["..."],
      "instructions": [
        { "programIdIndex": 3, "accounts": [0, 1], "data": "3Bxs4..." }
      ],
      "recentBlockhash": "...",
      "transactionConfig": {
        "computeUnitLimit": 200000,
        "heapSize": null,
        "loadedAccountsDataSizeLimit": 200000,
        "priorityFee": 50000
      }
    }
  }
}

​

maxSupportedTransactionVersion auf 1 setzen

• getTransaction
• getBlock
• getTransactionsForAddress mit transactionDetails: "full"
• transactionSubscribe mit transactionDetails: "accounts" oder "full"
• blockSubscribe

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32015,
    "message": "Transaction version (1) is not supported by the requesting client. Please use \"maxSupportedTransactionVersion\" in your request."
  },
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getTransaction",
  "params": [
    "2id3YC2jK9G5Wo2phDx4gJVAew8DcY5NAojnVuao8rkxwPYPe8cSwE5GzhEgJA2y8fVjDEo6iR6ykBvDxrTQrtpb",
    {
      "encoding": "jsonParsed",
      "commitment": "confirmed",
      "maxSupportedTransactionVersion": 1
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBlock",
  "params": [
    341197053,
    {
      "encoding": "jsonParsed",
      "transactionDetails": "full",
      "maxSupportedTransactionVersion": 1
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getTransactionsForAddress",
  "params": [
    "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
    {
      "transactionDetails": "full",
      "encoding": "jsonParsed",
      "limit": 100,
      "maxSupportedTransactionVersion": 1
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "transactionSubscribe",
  "params": [
    { "accountInclude": ["86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"] },
    {
      "commitment": "confirmed",
      "encoding": "jsonParsed",
      "transactionDetails": "full",
      "maxSupportedTransactionVersion": 1
    }
  ]
}

​

Aktualisiere dein SDK, bevor du den Wert erhöhst

​

Prioritätsgebühren aus transactionConfig lesen

import bs58 from "bs58";

const COMPUTE_BUDGET = "ComputeBudget111111111111111111111111111111";

/** Total priority fee in lamports for a `json`-encoded transaction. */
function priorityFeeLamports(tx: any): number {
  const message = tx.transaction.message;

  // v1: the header carries the total directly.
  if (message.transactionConfig) {
    return message.transactionConfig.priorityFee ?? 0;
  }

  // Legacy and v0: derive it from ComputeBudget instructions.
  let microLamportsPerCu = 0n;
  let computeUnitLimit: bigint | null = null;
  let otherInstructions = 0;

  for (const ix of message.instructions) {
    if (message.accountKeys[ix.programIdIndex] !== COMPUTE_BUDGET) {
      otherInstructions++;
      continue;
    }
    const data = bs58.decode(ix.data);
    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
    if (data[0] === 2) computeUnitLimit = BigInt(view.getUint32(1, true));
    if (data[0] === 3) microLamportsPerCu = view.getBigUint64(1, true);
  }

  // Without an explicit limit, the runtime grants 200,000 CU per non-ComputeBudget instruction, capped at 1,400,000.
  const limit = computeUnitLimit ?? BigInt(Math.min(otherInstructions * 200_000, 1_400_000));
  return Number((microLamportsPerCu * limit) / 1_000_000n);
}

​

Rohe Transaktionsbytes mit einem v1-kompatiblen Parser decodieren

• Versionsbyte. Eine v1-Transaktion beginnt mit 0x81 (dezimal 129). Eine v0-Transaktion beginnt mit 0x80.
• Signaturen werden ans Ende verschoben. Bei Legacy und v0 stehen zuerst die Signaturen und dann die Nachricht. Bei Transaktion v1 steht zuerst die Nachricht und danach die Signaturen. Decoder im Stil von bincode, die am Anfang ein Signatur-Array erwarten, schlagen daher bei v1-Bytes fehl.

• Rust: agave-transaction-view parst Legacy, v0 und v1 direkt. wincode, der von aktuellen Solana-SDKs verwendete bincode-kompatible Serializer, decodiert v1 ebenfalls in VersionedTransaction.
• JavaScript / TypeScript: @solana/kit 8.0+ oder @solana/web3.js v3.

​

Checkliste

1. Suche mit Grep nach getBlock, getTransaction, getTransactionsForAddress, transactionSubscribe und blockSubscribe. Berücksichtige dabei auch rohe JSON-RPC-Bodys und SDK-Wrapper wie connection.getParsedTransaction.
2. Aktualisiere auf ein v1-kompatibles SDK.
3. Setze maxSupportedTransactionVersion: 1 bei jedem in Schritt 1 gefundenen Aufruf.
4. Ersetze das Durchsuchen von ComputeBudget-Anweisungen durch eine Prüfung von transactionConfig und behandle priorityFee als Gesamtzahl der Lamports.
5. Ersetze rohe Decoder im Stil von bincode durch agave-transaction-view oder ein aktualisiertes SDK.
6. Aktualisiere die Streaming-Abhängigkeiten auf die Versionen aus der obigen Tabelle.
7. Suche nach der Änderung mit Grep in den Logs nach -32015. So stellst du sicher, dass nichts mehr fehlschlägt.

​

Verwandte Themen