Hỗ trợ giao dịch v1

​

Những thay đổi trong giao dịch v1

• Bạn phải chủ động cho phép nhận giao dịch này. Các yêu cầu lấy toàn bộ dữ liệu giao dịch cần maxSupportedTransactionVersion: 1, đồng thời thư viện máy khách phải có phiên bản có thể giải tuần tự hóa v1.
• Ngân sách tính toán được chuyển vào header của thông điệp. Một thông điệp v1 chứa đối tượng transactionConfig với computeUnitLimit, heapSize, loadedAccountsDataSizeLimit và priorityFee. Giao dịch v1 không có lệnh chương trình 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
      }
    }
  }
}

​

Đặt maxSupportedTransactionVersion thành 1

• getTransaction
• getBlock
• getTransactionsForAddress với transactionDetails: "full"
• transactionSubscribe với transactionDetails: "accounts" hoặc "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
    }
  ]
}

​

Nâng cấp SDK trước khi tăng giá trị

​

Đọc phí ưu tiên từ 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);
}

​

Giải mã các byte giao dịch thô bằng trình phân tích cú pháp hỗ trợ v1

• Byte phiên bản. Giao dịch v1 bắt đầu bằng 0x81 (129 ở hệ thập phân). Giao dịch v0 bắt đầu bằng 0x80.
• Chữ ký được chuyển xuống cuối. Legacy và v0 đặt chữ ký trước, sau đó là thông điệp. Giao dịch v1 đặt thông điệp trước và chữ ký ở cuối, vì vậy các trình giải mã kiểu bincode vốn yêu cầu mảng chữ ký ở đầu sẽ thất bại với các byte v1.

• Rust: agave-transaction-view phân tích trực tiếp legacy, v0 và v1. wincode, bộ tuần tự hóa tương thích với bincode được các SDK Solana hiện tại sử dụng, cũng giải mã v1 thành VersionedTransaction.
• JavaScript / TypeScript: @solana/kit 8.0+ hoặc @solana/web3.js v3.

​

Danh sách kiểm tra

1. Dùng Grep để tìm getBlock, getTransaction, getTransactionsForAddress, transactionSubscribe và blockSubscribe, bao gồm cả phần thân JSON-RPC thô và các trình bao SDK như connection.getParsedTransaction.
2. Nâng cấp lên SDK hỗ trợ v1.
3. Đặt maxSupportedTransactionVersion: 1 trên mọi lệnh gọi tìm thấy ở bước 1.
4. Thay việc quét lệnh ComputeBudget bằng phép kiểm tra transactionConfig và coi priorityFee là tổng số lamport.
5. Thay các trình giải mã thô kiểu bincode bằng agave-transaction-view hoặc SDK đã nâng cấp.
6. Nâng các phần phụ thuộc phát trực tuyến lên các phiên bản trong bảng trên.
7. Dùng Grep để tìm -32015 trong nhật ký sau khi thay đổi nhằm xác nhận không còn lỗi nào.

​

Nội dung liên quan