Transport ガイド

import { WebHidTransport } from '@openloop/transport-webhid'

// サポート確認
if (!WebHidTransport.isSupported()) {
  console.log('WebHID is not supported in this browser')
}

// 初回接続（ボタンクリック内で）
const transport = await WebHidTransport.connect()

// 自動再接続（ページ読み込み時）
const transport = await WebHidTransport.reconnect()

// 切断検知
transport.onDisconnect(() => {
  console.log('Device disconnected')
})

import { WebBleTransport } from '@openloop/transport-webble'

if (!WebBleTransport.isSupported()) {
  console.log('Web Bluetooth is not supported')
}

// 初回接続
const transport = await WebBleTransport.connect()

// 自動再接続
const transport = await WebBleTransport.reconnect()

import { LocalWsTransport } from '@openloop/transport-local'

// Connect アプリの起動確認
const available = await LocalWsTransport.isAvailable()

// 接続
const transport = new LocalWsTransport({
  port: 21320,    // デフォルト
  host: '127.0.0.1', // デフォルト
})
await transport.open()

// デバイス接続状態の変更通知
transport.onDeviceChange((connected: boolean) => {
  console.log('Device:', connected ? 'connected' : 'disconnected')
})

import { SafariTransport } from '@openloop/transport-safari'

// Extension の確認
const available = await SafariTransport.isAvailable()

// デバイスのスキャン
const devices = await SafariTransport.scan(5000) // 5秒スキャン
console.log('Found devices:', devices)

// 接続
const transport = await SafariTransport.connect(devices[0]?.deviceId)

import { UsbHidTransport } from '@openloop/transport-usb'

// デバイス検出
const devices = UsbHidTransport.discover()
if (devices.length === 0) {
  console.log('No device found')
}

// 接続
const transport = new UsbHidTransport({ path: devices[0].path })
await transport.open()

// 自動リトライ（デフォルト最大3回）
const transport = new UsbHidTransport({
  path: devices[0].path,
  maxRetries: 3,
  exchangeTimeout: 120000, // 2分
})

import OpenloopShared

// BLE接続
let transport = BleTransport(manager: .shared, targetUUID: targetUUID)
try await transport.open()

// CTAP2 makeCredential (passkey 登録)
let ctap = Ctap2Builder(transport: transport)
let result = try await ctap.makeCredential(MakeCredentialParams(
    clientDataHash: clientDataHash,
    rp: .init(id: rpId),
    user: .init(id: userHandle, name: userName),
    pubKeyCredParams: pubKeyCredParams,
    excludeList: nil,
    options: .init(rk: true, up: true, uv: true)
))

// CTAP2 getAssertion (passkey 認証)
let result = try await ctap.getAssertion(GetAssertionParams(
    rpId: rpId,
    clientDataHash: clientDataHash,
    allowList: allowList,
    options: .init(up: true, uv: true)
))

import { OpenloopSDK, EthereumApp, DEFAULT_ETH_PATH } from '@openloop/sdk-core'
import { WebHidTransport } from '@openloop/transport-webhid'
import { WebBleTransport } from '@openloop/transport-webble'
import { LocalWsTransport } from '@openloop/transport-local'

// Transport を登録
OpenloopSDK.registerTransport('webhid', {
  factory: () => WebHidTransport.connect(),
  name: 'WebHID (USB)',
  isAvailable: () => WebHidTransport.isSupported(),
})

OpenloopSDK.registerTransport('webble', {
  factory: () => WebBleTransport.connect(),
  name: 'Web Bluetooth',
  isAvailable: () => WebBleTransport.isSupported(),
})

OpenloopSDK.registerTransport('local', {
  factory: async () => {
    const t = new LocalWsTransport()
    await t.open()
    return t
  },
  name: 'LocalWS (Connect)',
  isAvailable: () => LocalWsTransport.isAvailable(),
})

// 利用可能な Transport を確認
const transports = await OpenloopSDK.discover()
console.log(transports)
// [
//   { type: 'webhid', name: 'WebHID (USB)', available: true },
//   { type: 'webble', name: 'Web Bluetooth', available: true },
//   { type: 'local', name: 'LocalWS (Connect)', available: false },
// ]

// 指定した Transport で接続
const transport = await OpenloopSDK.connect({ transport: 'webhid' })

// または最初に利用可能な Transport で接続
const transport = await OpenloopSDK.connect()

// ページ読み込み時に以前のデバイスへ自動再接続
async function autoReconnect(): Promise<ITransport | null> {
  // WebHID: 以前許可されたデバイスを検出
  if (WebHidTransport.isSupported()) {
    const transport = await WebHidTransport.reconnect()
    if (transport) return transport
  }

  // WebBLE: 以前ペアリングしたデバイスを検出（Chrome 100+）
  if (WebBleTransport.isSupported()) {
    const transport = await WebBleTransport.reconnect()
    if (transport) return transport
  }

  // LocalWS: Connect アプリが起動していれば接続
  if (await LocalWsTransport.isAvailable()) {
    const transport = new LocalWsTransport()
    await transport.open()
    return transport
  }

  return null
}