Transaction v1 サポート

​

transaction v1 の変更点

• 受け取るにはオプトインが必要です。 完全なトランザクションデータを要求する場合は maxSupportedTransactionVersion: 1 が必要で、クライアントライブラリも v1 を逆シリアル化できるバージョンが必要です。
• 計算予算がメッセージヘッダに移動します。 v1 メッセージは、transactionConfig オブジェクトを持ち、computeUnitLimit、heapSize、loadedAccountsDataSizeLimit、および priorityFee を含みます。v1 トランザクションには ComputeBudget プログラム指令がありません。

{
  "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 を 1 に設定する

• getTransaction
• getBlock
• getTransactionsForAddress with transactionDetails: "full"
• transactionSubscribe with transactionDetails: "accounts" or "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
    }
  ]
}

​

値を上げる前に SDK をアップグレードする

​

transactionConfig からプライオリティ手数料を読み取る

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

​

v1-aware parser で生トランザクションバイトをデコードする

• バージョンバイト。 v1 トランザクションは 0x81（十進数 129）で始まります。v0 トランザクションは 0x80 で始まります。
• 署名が末尾に移動します。 レガシーおよび v0 は最初に署名があり、その後メッセージがあります。トランザクション v1 はメッセージを先にして署名を最後にするため、署名配列を先頭に期待する bincode スタイルのデコーダは v1 バイトで失敗します。

• Rust: agave-transaction-view は、レガシー、v0、および v1 の場所で解析します。wincode、現在のSolana SDKで使用されるバイナリー互換のシリアライザは、VersionedTransactionにデコードします。
• JavaScript / TypeScript: @solana/kit 8.0+ または @solana/web3.js v3。

​

チェックリスト

1. getBlock、getTransaction、getTransactionsForAddress、transactionSubscribe、blockSubscribe を grep し、生の JSON-RPC 本体や connection.getParsedTransaction などの SDK ラッパーを含める。
2. v1 に対応した SDK にアップグレードする。
3. ステップ1で見つかったすべての呼び出しに maxSupportedTransactionVersion: 1 を設定する。
4. ComputeBudget 命令スキャンをやめ、transactionConfig チェックに置き換え、priorityFee を総ラムポーツとして扱う。
5. bincode スタイルの生デコーダを agave-transaction-view またはアップグレードした SDK に置き換える。
6. ストリーミング依存関係を上記の表のバージョンにバンプする。
7. 変更後に inline_code_placeholder_d5454a928a6e3cfa_END がログに表示されないことを確認するためにログを grep する。

​

関連