거래 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 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 인식 파서를 사용하여 원시 거래 바이트 해독

• 버전 바이트. v1 거래는 0x81 (십진수 129)로 시작합니다. v0 거래는 0x80로 시작합니다.
• 서명이 끝으로 이동합니다. 레거시 및 v0는 서명을 먼저 두고, 그 다음 메시지를 두지만 거래 v1은 메시지를 먼저 두고 서명을 마지막에 두므로, 선행 서명 배열을 기대하는 bincode 스타일 디코더가 v1 바이트에서 실패합니다.

• Rust: agave-transaction-view는 레거시, v0, v1을 현장에 디코드합니다. 현재 Solana SDK에서 사용하는 bincode 호환 시리얼라이저인 wincode도 v1을 VersionedTransaction로 디코드합니다.
• 자바스크립트 / 타입스크립트: @solana/kit 8.0+ 또는 @solana/web3.js v3.

​

체크리스트

1. getBlock, getTransaction, getTransactionsForAddress, transactionSubscribe, 그리고 blockSubscribe를 포함하여 원시 JSON-RPC 본문과 connection.getParsedTransaction 같은 SDK 래퍼를 그랩합니다.
2. v1 지원 SDK로 업그레이드합니다.
3. 1단계에서 찾은 모든 호출에 maxSupportedTransactionVersion: 1를 설정합니다.
4. ComputeBudget 명령어 스캔을 transactionConfig 확인으로 대체하고 priorityFee를 총 람포트로 취급합니다.
5. bincode 스타일 원시 디코더를 agave-transaction-view나 업그레이드된 SDK로 대체합니다.
6. 위 테이블의 버전으로 스트리밍 종속성을 증가시킵니다.
7. 변경 후 로그에서 -32015를 검색하여 여전히 실패하는 것이 없는지 확인합니다.

​

관련