@onekeyfe/hd-transport 1.2.0-alpha.1 → 1.2.0-alpha.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/hd-transport",
-  "version": "1.2.0-alpha.1",
+  "version": "1.2.0-alpha.10",
   "description": "Transport layer abstractions and utilities for OneKey hardware SDK.",
   "author": "OneKey",
   "homepage": "https://github.com/OneKeyHQ/hardware-js-sdk#readme",
@@ -28,5 +28,5 @@
     "long": "^4.0.0",
     "protobufjs": "^6.11.2"
   },
-  "gitHead": "4f4aae3a47be7bd54b4db4a10c400056784e01bd"
+  "gitHead": "db8135cc75ab2d8b87efa14e28517da892c7aa34"
 }

package/scripts/protobuf-build.sh

@@ -126,36 +126,6 @@ if [ -d "$SRC_PRO2_LATEST" ] && ls "$SRC_PRO2_LATEST"/messages*.proto 1>/dev/nul
             | sed 's/^option /\/\/ option /' \
             | grep -v '    reserved '
 
-        if ! grep -q '^message TonSignData ' "$SRC_PRO2_LEGACY"/messages*.proto; then
-            echo ''
-            echo '// --- TON signData (kept until firmware-pro2 legacy proto exports it) ---'
-            echo 'message TonSignData {'
-            echo '    repeated uint32 address_n = 1;'
-            echo '    required TonSignDataType type = 2;'
-            echo '    required bytes payload = 3;'
-            echo '    optional string schema = 4;'
-            echo '    required string appdomain = 5;'
-            echo '    required uint64 timestamp = 6;'
-            echo '    optional string from_address = 7;'
-            echo '    optional TonWalletVersion wallet_version = 8 [default=V4R2];'
-            echo '    optional uint32 wallet_id = 9 [default=698983191];'
-            echo '    optional TonWorkChain workchain = 10 [default=BASECHAIN];'
-            echo '    optional bool is_bounceable = 11 [default=false];'
-            echo '    optional bool is_testnet_only = 12 [default=false];'
-            echo ''
-            echo '    enum TonSignDataType {'
-            echo '        TEXT = 0;'
-            echo '        BINARY = 1;'
-            echo '        CELL = 2;'
-            echo '    }'
-            echo '}'
-            echo ''
-            echo 'message TonSignedData {'
-            echo '    optional bytes signature = 1;'
-            echo '    optional bytes digest = 2;'
-            echo '}'
-        fi
-
         echo ''
         echo '// --- Protocol V2 system messages ---'
         grep -hv \
@@ -164,83 +134,50 @@ if [ -d "$SRC_PRO2_LATEST" ] && ls "$SRC_PRO2_LATEST"/messages*.proto 1>/dev/nul
             "$SRC_PRO2_LATEST"/messages*.proto \
             | grep -v '    reserved '
 
-        if ! grep -q '^message GetOnboardingStatus ' "$SRC_PRO2_LATEST"/messages*.proto; then
-            echo ''
-            echo '// --- Onboarding status (kept until firmware-pro2 latest proto exports it) ---'
-            echo 'enum OnboardingStep {'
-            echo '    ONBOARDING_STEP_UNKNOWN = 0;'
-            echo '    ONBOARDING_STEP_DEVICE_VERIFICATION = 1;'
-            echo '    ONBOARDING_STEP_PERSONALIZATION = 2;'
-            echo '    ONBOARDING_STEP_SETUP = 3;'
-            echo '    ONBOARDING_STEP_FIRMWARE = 4;'
-            echo '}'
-            echo ''
-            echo 'message GetOnboardingStatus {'
-            echo '}'
-            echo ''
-            echo 'message OnboardingStatus {'
-            echo '    message Setup {'
-            echo '        message NewDevice {'
-            echo '            optional bool seedcard_backup = 1;'
-            echo '        }'
-            echo '        message Restore {'
-            echo '            optional bool mnemonic = 1;'
-            echo '            optional bool seedcard = 2;'
-            echo '        }'
-            echo '        optional NewDevice new_device = 1;'
-            echo '        optional Restore restore = 2;'
-            echo '    }'
-            echo '    required OnboardingStep step = 1;'
-            echo '    optional Setup setup = 2;'
-            echo '    optional uint32 detail_code = 3;'
-            echo '    optional string detail_str = 4;'
-            echo '}'
-        fi
     } > "$TMP_PROTO"
 
-    if ! grep -q 'MessageType_TonSignData' "$TMP_PROTO"; then
-        node - "$TMP_PROTO" <<'NODE'
-const fs = require('fs');
-
-const protoPath = process.argv[2];
-const proto = fs.readFileSync(protoPath, 'utf8');
-const updated = proto.replace(
-  /(    MessageType_TonTxAck\s*=\s*11907[^\n]*;\n)/,
-  `$1    MessageType_TonSignData = 11908 [(wire_in) = true];\n    MessageType_TonSignedData = 11909 [(wire_out) = true];\n`
-);
-
-if (updated === proto) {
-  throw new Error('Unable to insert TON signData MessageType entries into Pro2 schema');
-}
-
-fs.writeFileSync(protoPath, updated);
-NODE
-    fi
-
-    if ! grep -q 'MessageType_GetOnboardingStatus' "$TMP_PROTO"; then
-        node - "$TMP_PROTO" <<'NODE'
+    node - "$TMP_PROTO" <<'NODE'
 const fs = require('fs');
 
 const protoPath = process.argv[2];
-const proto = fs.readFileSync(protoPath, 'utf8');
-const updated = proto.replace(
-  /(    MessageType_DeviceInfo\s*=\s*60601[^\n]*;\n)/,
-  `$1    MessageType_GetOnboardingStatus = 60602;\n    MessageType_OnboardingStatus = 60603;\n`
-);
-
-if (updated === proto) {
-  throw new Error('Unable to insert onboarding MessageType entries into Pro2 schema');
-}
+let proto = fs.readFileSync(protoPath, 'utf8');
+
+const removeTopLevelMessage = (source, name) => {
+  const pattern = new RegExp(`(^|\\n)message\\s+${name}\\s*\\{`, 'm');
+  const match = pattern.exec(source);
+  if (!match) return source;
+
+  const start = match.index + (match[1] ? match[1].length : 0);
+  let index = start;
+  let depth = 0;
+  while (index < source.length) {
+    const char = source[index];
+    if (char === '{') {
+      depth += 1;
+    } else if (char === '}') {
+      depth -= 1;
+      if (depth === 0) {
+        index += 1;
+        while (index < source.length && /\s/.test(source[index])) index += 1;
+        return `${source.slice(0, start)}${source.slice(index)}`;
+      }
+    }
+    index += 1;
+  }
+  throw new Error(`Unterminated message block: ${name}`);
+};
 
-fs.writeFileSync(protoPath, updated);
-NODE
-    fi
+[
+  'Initialize',
+  'GetFeatures',
+  'OnekeyGetFeatures',
+  'Features',
+].forEach(name => {
+  proto = removeTopLevelMessage(proto, name);
+});
 
-    node - "$TMP_PROTO" <<'NODE'
-const fs = require('fs');
+fs.writeFileSync(protoPath, proto);
 
-const protoPath = process.argv[2];
-const proto = fs.readFileSync(protoPath, 'utf8');
 const messageNames = new Set(
   Array.from(proto.matchAll(/^\s*message\s+([A-Za-z_][A-Za-z0-9_]*)\s*\{/gm)).map(
     match => match[1]
@@ -252,17 +189,29 @@ const messageTypeNames = new Set(
   )
 );
 const requiredMessages = [
+  'DeviceFactoryInfoSet',
+  'DeviceFactoryInfoGet',
+  'DeviceFactoryInfo',
+  'ProtocolInfoRequest',
+  'ProtocolInfo',
   'Ping',
   'Success',
   'Failure',
-  'DevReboot',
-  'DevGetDeviceInfo',
+  'DeviceReboot',
+  'DeviceInfoGet',
   'DeviceInfo',
-  'DevFirmwareUpdate',
-  'DevFirmwareInstallProgress',
-  'DevGetFirmwareUpdateStatus',
-  'DevFirmwareUpdateStatus',
-  'FilesystemFixPermission',
+  'DeviceStatusGet',
+  'DeviceStatus',
+  'DevGetOnboardingStatus',
+  'DevOnboardingStatus',
+  'DeviceSessionGet',
+  'DeviceSession',
+  'DeviceSessionAskPin',
+  'DeviceSessionPinResult',
+  'DeviceFirmwareUpdateRequest',
+  'DeviceFirmwareUpdateStatusGet',
+  'DeviceFirmwareUpdateStatus',
+  'FilesystemPermissionFix',
   'FilesystemPathInfo',
   'FilesystemPathInfoQuery',
   'FilesystemFile',
@@ -274,10 +223,7 @@ const requiredMessages = [
   'FilesystemDirMake',
   'FilesystemDirRemove',
   'FilesystemFormat',
-  'TonSignData',
-  'TonSignedData',
-  'GetOnboardingStatus',
-  'OnboardingStatus',
+  'PortfolioUpdate',
 ];
 const missingMessages = requiredMessages.filter(name => !messageNames.has(name));
 const missingMessageTypes = requiredMessages.filter(name => !messageTypeNames.has(name));
@@ -288,39 +234,11 @@ if (missingMessages.length > 0 || missingMessageTypes.length > 0) {
       ', '
     )}], messageTypes=[${missingMessageTypes.join(
       ', '
-    )}]. Make sure submodules/firmware-pro2 is checked out on branch dev_romloader_split ` +
-      '(origin/dev_romloader_split), which contains the Filesystem*/DevFirmwareUpdate/DevReboot messages.'
+    )}]. Make sure submodules/firmware-pro2 is checked out on branch dev ` +
+      '(origin/dev), which contains the latest Protocol V2 Device*/Filesystem* messages.'
   );
 }
 
-// Provisional wire IDs injected by this script for messages the firmware proto does
-// not export yet (pending firmware confirmation, see
-// docs/protocol-v2-deviceinfo-field-gaps.md). If the firmware submodule starts
-// exporting these MessageType entries itself, the injection above is skipped and the
-// firmware-assigned IDs flow into TMP_PROTO — assert they still match the IDs the SDK
-// was built against, and fail loudly on any drift.
-const expectedInjectedIds = {
-  TonSignData: 11908,
-  TonSignedData: 11909,
-  GetOnboardingStatus: 60602,
-  OnboardingStatus: 60603,
-};
-const actualIds = {};
-for (const match of proto.matchAll(/^\s*MessageType_([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(\d+)/gm)) {
-  actualIds[match[1]] = Number(match[2]);
-}
-const idMismatches = Object.entries(expectedInjectedIds)
-  .filter(([name, id]) => name in actualIds && actualIds[name] !== id)
-  .map(([name, id]) => `${name}: expected ${id}, firmware proto has ${actualIds[name]}`);
-
-if (idMismatches.length > 0) {
-  throw new Error(
-    `Protocol V2 injected MessageType wire IDs conflict with the firmware proto: ${idMismatches.join(
-      '; '
-    )}. Update the injected IDs in protobuf-build.sh and the registry section in ` +
-      'docs/protocol-v2-deviceinfo-field-gaps.md.'
-  );
-}
 NODE
 
     npx pbjs -t json \
@@ -345,8 +263,8 @@ else
     # Unlike the optional Pro1 (legacy) section above, the firmware-pro2 submodule is
     # the only source of the Protocol V2 schema, so a missing checkout is a hard error.
     echo "firmware-pro2 latest protobuf schema not found at $SRC_PRO2_LATEST"
-    echo "The Protocol V2 schema requires firmware-pro2 on branch dev_romloader_split."
+    echo "The Protocol V2 schema requires firmware-pro2 on branch dev."
     echo "Run: git submodule update --init submodules/firmware-pro2"
-    echo "Then: git -C submodules/firmware-pro2 fetch origin dev_romloader_split && git -C submodules/firmware-pro2 checkout origin/dev_romloader_split"
+    echo "Then: git -C submodules/firmware-pro2 fetch origin dev && git -C submodules/firmware-pro2 checkout origin/dev"
     exit 1
 fi

package/src/constants.ts

@@ -20,15 +20,21 @@ export const PROTOCOL_V1_ENVELOPE_HEADER_SIZE = 1 + 1 + PROTOCOL_V1_MESSAGE_HEAD
 
 // ---- Protocol V2 (Pro2 USB / BLE transports) ----
 
-/** Protocol V2 单帧最大长度，包含 header、payload 和 CRC；需容纳 4096 数据块及 protobuf 开销。 */
+/** Protocol V2 单帧最大长度，包含 header、payload 和 CRC；需容纳 4000 数据块及 protobuf 开销。 */
 export const PROTOCOL_V2_FRAME_MAX_BYTES = 4608;
 
 /** WebUSB 下 FilesystemFileWrite 的文件数据分块大小。 */
-export const PROTOCOL_V2_WEBUSB_FILE_CHUNK_SIZE = 4096;
+export const PROTOCOL_V2_WEBUSB_FILE_CHUNK_SIZE = 4000;
 
 /** BLE 下 FilesystemFileWrite 的文件数据分块大小。 */
 export const PROTOCOL_V2_BLE_FILE_CHUNK_SIZE = 1800;
 
+/** BLE 下 FilesystemFileRead 的文件数据分块大小，受 Pro2 UART 1024B TX 缓冲限制。 */
+export const PROTOCOL_V2_BLE_FILE_READ_CHUNK_SIZE = 900;
+
+/** Pro2 BLE/UART 接收 FIFO 必须容纳完整 Proto Link 帧。 */
+export const PROTOCOL_V2_BLE_FRAME_MAX_BYTES = 2048;
+
 /** @deprecated 使用按传输区分的 PROTOCOL_V2_WEBUSB_FILE_CHUNK_SIZE / PROTOCOL_V2_BLE_FILE_CHUNK_SIZE。 */
 export const PROTOCOL_V2_FILE_CHUNK_SIZE = PROTOCOL_V2_WEBUSB_FILE_CHUNK_SIZE;
 

package/src/index.ts

@@ -10,8 +10,11 @@ import {
 } from './serialization';
 import { PROTOCOL_V2_SYS_MESSAGE_THRESHOLD, ProtocolV1, ProtocolV2 } from './protocols';
 import * as protocolV2Codec from './protocols/v2';
+import { ProtocolV2LinkManager } from './protocols/v2/link-manager';
+import { ProtocolV2UsbTransportBase } from './protocols/v2/usb-transport-base';
 import {
   ProtocolV2FrameAssembler,
+  ProtocolV2SequenceCursor,
   ProtocolV2Session,
   bytesToHex,
   concatUint8Arrays,
@@ -49,6 +52,8 @@ export * from './protocols';
 export * as protocolV1 from './protocols/v1';
 export * as protocolV2 from './protocols/v2';
 export * from './protocols/v2/session';
+export * from './protocols/v2/link-manager';
+export * from './protocols/v2/usb-transport-base';
 
 export default {
   check,
@@ -58,7 +63,10 @@ export default {
   ProtocolV2,
   PROTOCOL_V2_SYS_MESSAGE_THRESHOLD,
   ProtocolV2FrameAssembler,
+  ProtocolV2LinkManager,
+  ProtocolV2SequenceCursor,
   ProtocolV2Session,
+  ProtocolV2UsbTransportBase,
   bytesToHex,
   concatUint8Arrays,
   createMessageFromName,

package/src/protocols/index.ts

@@ -6,7 +6,7 @@ import { decodeMessage as decodeV1Message } from './v1/receive';
 import { createMessageFromName, createMessageFromType } from '../serialization/protobuf/messages';
 import { encode as encodeProtobuf } from '../serialization/protobuf/encode';
 import { decode as decodeProtobuf } from '../serialization/protobuf/decode';
-import { decodeFrame as decodeV2Frame, encodeProtobufFrame } from './v2';
+import { decodeFrame as decodeV2Frame, encodeProtobufFrame, isAckFrame } from './v2';
 
 import type { Root } from 'protobufjs/light';
 import type { ProtocolV2DebugLogger } from './v2';
@@ -38,6 +38,7 @@ const resolveProtocolV2EncodeSchema = (name: string, schemas: ProtocolV2Schemas)
 };
 
 const PROTOCOL_V2_LEGACY_DECODE_ALLOWLIST = new Set([
+  'Failure',
   'ButtonRequest',
   'EntropyRequest',
   'PinMatrixRequest',
@@ -73,6 +74,8 @@ export const ProtocolV1 = {
 };
 
 export const ProtocolV2 = {
+  isAckFrame,
+
   encodeFrame(
     schemas: ProtocolV2Schemas,
     name: string,

package/src/protocols/v2/constants.ts

@@ -4,3 +4,4 @@ export const PROTO_HEAD_CRC_SIZE = 8;
 export const CRC8_INIT = 0x30;
 export const PACKET_SIZE = 4096;
 export const PROTO_DATA_TYPE_PACKET = 0;
+export const PROTO_DATA_TYPE_ACK = 1;

package/src/protocols/v2/decode.ts

@@ -1,4 +1,4 @@
-import { PROTO_HEAD_CRC_SIZE, PROTO_HEAD_SOF } from './constants';
+import { PROTO_DATA_TYPE_ACK, PROTO_HEAD_CRC_SIZE, PROTO_HEAD_SOF } from './constants';
 import { crc8 } from './crc8';
 import { logProtocolV2Debug } from './debug';
 
@@ -13,20 +13,7 @@ export interface ProtoV2Frame {
   seq: number;
 }
 
-/**
- * Parse and validate a Protocol V2 response frame.
- *
- * Validates:
- *   - SOF byte (0x5A)
- *   - Header CRC (bytes 0-2)
- *   - Frame CRC (full frame except last byte)
- *
- * Returns the decoded messageTypeId, raw protobuf payload, and sequence number.
- */
-export function decodeFrame(
-  data: Uint8Array,
-  debugOptions?: ProtocolV2FrameDebugOptions
-): ProtoV2Frame {
+function validateFrame(data: Uint8Array): number {
   if (data.length < PROTO_HEAD_CRC_SIZE) {
     throw new Error(`Protocol V2 frame too short: ${data.length} bytes`);
   }
@@ -43,7 +30,6 @@ export function decodeFrame(
     throw new Error(`Frame truncated: expected ${frameLen} bytes, got ${data.length}`);
   }
 
-  // Verify pre-header CRC (bytes 0-2)
   const expectedHeaderCrc = crc8(data, 3);
   if (data[3] !== expectedHeaderCrc) {
     throw new Error(
@@ -53,7 +39,6 @@ export function decodeFrame(
     );
   }
 
-  // Verify frame CRC (all bytes except last)
   const expectedFrameCrc = crc8(data, frameLen - 1);
   if (data[frameLen - 1] !== expectedFrameCrc) {
     throw new Error(
@@ -63,6 +48,40 @@ export function decodeFrame(
     );
   }
 
+  return frameLen;
+}
+
+export function isAckFrame(data: Uint8Array): boolean {
+  // eslint-disable-next-line no-bitwise
+  if (data.length < 6 || (data[5] & 0x03) !== PROTO_DATA_TYPE_ACK) {
+    return false;
+  }
+
+  const frameLen = validateFrame(data);
+  if (frameLen !== PROTO_HEAD_CRC_SIZE) {
+    throw new Error(`Invalid Protocol V2 ACK frame length: ${frameLen}`);
+  }
+  return true;
+}
+
+/**
+ * Parse and validate a Protocol V2 response frame.
+ *
+ * Validates:
+ *   - SOF byte (0x5A)
+ *   - Header CRC (bytes 0-2)
+ *   - Frame CRC (full frame except last byte)
+ *
+ * Returns the decoded messageTypeId, raw protobuf payload, and sequence number.
+ */
+export function decodeFrame(
+  data: Uint8Array,
+  debugOptions?: ProtocolV2FrameDebugOptions
+): ProtoV2Frame {
+  const frameLen = validateFrame(data);
+  const expectedHeaderCrc = data[3];
+  const expectedFrameCrc = data[frameLen - 1];
+
   const seq = data[6];
   // Payload spans bytes 7 to frameLen-2 (inclusive), excluding final CRC byte
   const payloadData = data.slice(7, frameLen - 1);

package/src/protocols/v2/link-manager.ts

@@ -0,0 +1,160 @@
+import { ProtocolV2SequenceCursor } from './sequence-cursor';
+import { ProtocolV2Session, getErrorMessage } from './session';
+
+import type { MessageFromOneKey, TransportCallOptions } from '../../types';
+import type { ProtocolV2CallContext, ProtocolV2Schemas, ProtocolV2SessionOptions } from './session';
+
+export type ProtocolV2LinkErrorClassification = 'link-fatal' | 'recoverable';
+
+export interface ProtocolV2LinkAdapter {
+  router: number;
+  maxFrameBytes?: number;
+  generation: number;
+  prepareCall(context: ProtocolV2CallContext): Promise<void> | void;
+  writeFrame(frame: Uint8Array, context: ProtocolV2CallContext): Promise<void>;
+  readFrame(context: ProtocolV2CallContext): Promise<Uint8Array>;
+  reset(reason: string): Promise<void> | void;
+  logger?: ProtocolV2SessionOptions['logger'];
+  logPrefix?: string;
+  createTimeoutError?: ProtocolV2SessionOptions['createTimeoutError'];
+}
+
+export type ProtocolV2LinkManagerOptions<Key> = {
+  getSchemas: () => ProtocolV2Schemas;
+  classifyError: (error: unknown) => ProtocolV2LinkErrorClassification;
+  onLinkInvalidated?: (key: Key, reason: string) => Promise<void> | void;
+};
+
+type ProtocolV2Link = {
+  adapter: ProtocolV2LinkAdapter;
+  session: ProtocolV2Session;
+  state: {
+    invalidatedReason?: string;
+  };
+};
+
+export class ProtocolV2LinkManager<Key> {
+  private readonly links = new Map<Key, ProtocolV2Link>();
+
+  private readonly sequences = new Map<Key, ProtocolV2SequenceCursor>();
+
+  private readonly callQueues = new Map<Key, Promise<unknown>>();
+
+  private readonly options: ProtocolV2LinkManagerOptions<Key>;
+
+  constructor(options: ProtocolV2LinkManagerOptions<Key>) {
+    this.options = options;
+  }
+
+  call(
+    key: Key,
+    createAdapter: () => ProtocolV2LinkAdapter,
+    name: string,
+    data: Record<string, unknown>,
+    options?: TransportCallOptions
+  ): Promise<MessageFromOneKey> {
+    const run = () => this.executeCall(key, createAdapter, name, data, options);
+    const previous = this.callQueues.get(key) ?? Promise.resolve();
+    const result = previous.then(run, run);
+    const queue = result.catch(() => undefined);
+    this.callQueues.set(key, queue);
+    result
+      .then(
+        () => this.clearSettledCallQueue(key, queue),
+        () => this.clearSettledCallQueue(key, queue)
+      )
+      .catch(() => undefined);
+    return result;
+  }
+
+  async invalidateLink(key: Key, reason: string): Promise<void> {
+    const link = this.links.get(key);
+    if (!link) return;
+
+    this.links.delete(key);
+    link.state.invalidatedReason = reason;
+    await link.adapter.reset(reason);
+    await this.options.onLinkInvalidated?.(key, reason);
+  }
+
+  async invalidateAllLinks(reason: string): Promise<void> {
+    await Promise.all(Array.from(this.links.keys(), key => this.invalidateLink(key, reason)));
+  }
+
+  async dispose(reason: string): Promise<void> {
+    await this.invalidateAllLinks(reason);
+    this.sequences.clear();
+    this.callQueues.clear();
+  }
+
+  private getOrCreateLink(key: Key, createAdapter: () => ProtocolV2LinkAdapter): ProtocolV2Link {
+    const existing = this.links.get(key);
+    if (existing) return existing;
+
+    const adapter = createAdapter();
+    const state: ProtocolV2Link['state'] = {};
+    const assertLinkActive = () => {
+      if (state.invalidatedReason) {
+        throw new Error(state.invalidatedReason);
+      }
+    };
+    let sequenceCursor = this.sequences.get(key);
+    if (!sequenceCursor) {
+      sequenceCursor = new ProtocolV2SequenceCursor();
+      this.sequences.set(key, sequenceCursor);
+    }
+    const session = new ProtocolV2Session({
+      schemas: this.options.getSchemas(),
+      router: adapter.router,
+      maxFrameBytes: adapter.maxFrameBytes,
+      generation: adapter.generation,
+      sequenceCursor,
+      prepareCall: async context => {
+        assertLinkActive();
+        await adapter.prepareCall(context);
+        assertLinkActive();
+      },
+      writeFrame: async (frame, context) => {
+        assertLinkActive();
+        await adapter.writeFrame(frame, context);
+        assertLinkActive();
+      },
+      readFrame: async context => {
+        assertLinkActive();
+        const frame = await adapter.readFrame(context);
+        assertLinkActive();
+        return frame;
+      },
+      logger: adapter.logger,
+      logPrefix: adapter.logPrefix,
+      createTimeoutError: adapter.createTimeoutError,
+    });
+    const link = { adapter, session, state };
+    this.links.set(key, link);
+    return link;
+  }
+
+  private async executeCall(
+    key: Key,
+    createAdapter: () => ProtocolV2LinkAdapter,
+    name: string,
+    data: Record<string, unknown>,
+    options?: TransportCallOptions
+  ): Promise<MessageFromOneKey> {
+    try {
+      return await this.getOrCreateLink(key, createAdapter).session.call(name, data, options);
+    } catch (error) {
+      if (this.options.classifyError(error) === 'link-fatal') {
+        const errorMessage = getErrorMessage(error) || 'unknown error';
+        await this.invalidateLink(key, `Protocol V2 link-fatal error: ${errorMessage}`);
+      }
+      throw error;
+    }
+  }
+
+  private clearSettledCallQueue(key: Key, queue: Promise<unknown>) {
+    if (this.callQueues.get(key) === queue) {
+      this.callQueues.delete(key);
+    }
+  }
+}

package/src/protocols/v2/sequence-cursor.ts

@@ -0,0 +1,10 @@
+import { nextProtoSeq } from './encode';
+
+export class ProtocolV2SequenceCursor {
+  private current = 0;
+
+  next(): number {
+    this.current = nextProtoSeq(this.current);
+    return this.current;
+  }
+}