Support de la Transaction v1

​

Ce qui change dans la transaction v1

• Vous devez opter pour la recevoir. Les requêtes pour les données complètes de transaction nécessitent maxSupportedTransactionVersion: 1, et votre bibliothèque client nécessite une version capable de désérialiser v1.
• Le budget de calcul passe dans l’en-tête du message. Un message v1 transporte un objet transactionConfig avec computeUnitLimit, heapSize, loadedAccountsDataSizeLimit, et priorityFee. Il n’y a pas d’instructions de programme ComputeBudget dans une transaction v1.

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

​

Définir maxSupportedTransactionVersion à 1

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

​

Mettez à niveau votre SDK avant d’augmenter la valeur

​

Lire les frais de priorité à partir de 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);
}

​

Décodez les octets de transaction bruts avec un analyseur compatible v1

• Octet de version. Une transaction v1 commence par 0x81 (décimal 129). Une transaction v0 commence par 0x80.
• Les signatures passent à la fin. Les transactions Legacy et v0 mettent d’abord les signatures, puis le message. La transaction v1 met d’abord le message et les signatures en dernier, donc les décodeurs de style bincode qui s’attendent à un tableau de signatures en tête échouent sur les octets v1.

• Rust : agave-transaction-view analyse Legacy, v0, et v1 sur place. wincode, le sérialiseur compatible bincode utilisé par les SDK Solana actuels, décode également v1 en VersionedTransaction.
• JavaScript / TypeScript : @solana/kit 8.0+ ou @solana/web3.js v3.

​

Liste de vérification

1. Recherchez getBlock, getTransaction, getTransactionsForAddress, transactionSubscribe, et blockSubscribe, y compris les corps JSON-RPC bruts et les wrappers SDK comme connection.getParsedTransaction.
2. Mettez à niveau vers un SDK compatible v1.
3. Définissez maxSupportedTransactionVersion: 1 sur chaque appel trouvé à l’étape 1.
4. Remplacez la recherche d’instruction ComputeBudget par une vérification transactionConfig, et traitez priorityFee comme des lamports totaux.
5. Remplacez les décodeurs bruts de style bincode par agave-transaction-view ou un SDK mis à jour.
6. Augmentez les dépendances de streaming aux versions du tableau ci-dessus.
7. Recherchez les journaux pour -32015 après le changement pour confirmer que rien n’échoue encore.

​

En relation