Поддержка транзакций v1

​

Что изменилось в транзакциях 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 с transactionDetails: "full"
• transactionSubscribe с transactionDetails: "accounts" или "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

• Байт версии. Транзакция v1 начинается с 0x81 (десятичное значение 129). Транзакция v0 начинается с 0x80.
• Подписи перемещаются в конец. В устаревшем формате и v0 сначала идут подписи, а затем сообщение. В транзакции v1 сначала идет сообщение, а подписи находятся в конце, поэтому декодеры типа bincode, ожидающие массив подписей в начале, не могут обработать байты v1.

• Rust: agave-transaction-view выполняет синтаксический анализ устаревшего формата, v0 и v1 без копирования. wincode, совместимый с bincode сериализатор, используемый текущими SDK Solana, также декодирует v1 в VersionedTransaction.
• JavaScript / TypeScript: @solana/kit 8.0+ или @solana/web3.js v3.

​

Контрольный список

1. Найдите с помощью grep все упоминания getBlock, getTransaction, getTransactionsForAddress, transactionSubscribe и blockSubscribe, включая необработанные тела JSON-RPC и обертки SDK, такие как connection.getParsedTransaction.
2. Обновитесь до SDK с поддержкой v1.
3. Задайте maxSupportedTransactionVersion: 1 во всех вызовах, найденных на шаге 1.
4. Замените поиск инструкций ComputeBudget проверкой transactionConfig и интерпретируйте priorityFee как общее количество лампортов.
5. Замените декодеры необработанных данных типа bincode на agave-transaction-view или обновленный SDK.
6. Обновите зависимости потоковой передачи до версий, указанных в таблице выше.
7. После изменения найдите в журналах -32015 с помощью grep, чтобы убедиться, что ошибок больше нет.

​

Связанные материалы