エラー処理ガイド

import { OpenloopError, ApduError, TransportError } from '@openloop/sdk-core'
import type { TransportErrorCode } from '@openloop/sdk-core'

// Bitcoin の出口の誤り（サブパス）
import { BtcError } from '@openloop/sdk-core/bitcoin'
import type { BtcErrorCode } from '@openloop/sdk-core/bitcoin'

class ApduError extends OpenloopError {
  readonly statusWord: number  // 例: 0x6985
}

import { ApduError, DEFAULT_ETH_PATH } from '@openloop/sdk-core'

try {
  const sig = await eth.signPersonalMessage(DEFAULT_ETH_PATH, 'Hello')
} catch (err) {
  if (err instanceof ApduError) {
    if (err.statusWord === 0x6985) {
      console.log('デバイスで拒否されたか、デバイスが使用中です。画面を確認してもう一度お試しください')
    } else {
      console.log(`APDU エラー: 0x${err.statusWord.toString(16)}`)
    }
  }
}

class TransportError extends OpenloopError {
  readonly code: TransportErrorCode   // v0.6.0 で追加
  // message には英語の詳細が入る（表示用ではなくログ用）

  // Safari Extension transport が橋の通知を載せる欄（いずれも省略されうる）
  stale?: boolean
  busy?: boolean
  noResponse?: boolean
  sent?: number
  awaited?: boolean
}

class BtcError extends OpenloopError {
  readonly code: BtcErrorCode
}

type BtcErrorCode =
  | 'bad_argument'
  | 'invalid_address'
  | 'network_mismatch'
  | 'fetch_failed'
  | 'bad_response'
  | 'prev_tx_too_large'
  | 'fee_rate_out_of_range'
  | 'insufficient'
  | 'insufficient_unconfirmed'
  | 'fee_too_high'
  | 'fee_exceeds_amount'
  | 'psbt_too_large'
  | 'bad_psbt'
  | 'broadcast_rejected'

import { BtcError, type BtcErrorCode } from '@openloop/sdk-core/bitcoin'

/** BtcError なら code を返す */
function btcCode(err: unknown): BtcErrorCode | null {
  return err instanceof BtcError ? err.code : null
}

function describeBtcError(err: unknown): string | null {
  switch (btcCode(err)) {
    case null:
      return null // BtcError ではない
    case 'invalid_address':
      return 'アドレスが正しくありません'
    case 'network_mismatch':
      return '別のネットワークのアドレスです'
    case 'insufficient':
      return '残高が足りません'
    case 'insufficient_unconfirmed':
      return '確定待ちの入金があります。確定すれば送れます'
    case 'fee_too_high':
    case 'fee_exceeds_amount':
    case 'fee_rate_out_of_range':
      return '手数料が異常です。送金を止めました'
    case 'fetch_failed':
      return '残高を確認できませんでした。もう一度お試しください'
    case 'broadcast_rejected':
      return '送信できませんでした。状況を確認してください'
    default:
      return '処理に失敗しました' // bad_argument など。詳細はログへ
  }
}

import { OpenloopError, ApduError, TransportError, DEFAULT_ETH_PATH } from '@openloop/sdk-core'

try {
  const { address } = await eth.getAddress(DEFAULT_ETH_PATH)
} catch (err) {
  if (err instanceof ApduError) {
    // デバイスからのエラー応答
    switch (err.statusWord) {
      case 0x6985:
        showMessage('デバイスで拒否されたか、デバイスが使用中です。画面を確認してもう一度お試しください')
        break
      case 0x6a80:
        showMessage('無効なデータです')
        break
      default:
        showMessage(`デバイスエラー: ${err.message}`)
    }
  } else if (err instanceof TransportError) {
    // 通信エラー — message ではなく code で分岐する
    switch (err.code) {
      case 'not-supported':
        showMessage('このブラウザは対応していません')
        break
      case 'not-found':
        showMessage('デバイスが見つかりませんでした')
        break
      case 'timeout':
        showMessage('デバイスが応答しません。画面をご確認ください。')
        break
      case 'disconnected':
      case 'not-connected':
        showMessage('接続が切れました。再接続してください。')
        break
      default:
        showMessage(`通信エラー: ${err.message}`)
    }
  } else if (err instanceof OpenloopError) {
    // その他の SDK エラー
    showMessage(`エラー: ${err.message}`)
  } else {
    // 予期しないエラー（BtcError・通常の Error など）
    throw err
  }
}

import { EthereumApp, DEFAULT_ETH_PATH, TransportError } from '@openloop/sdk-core'
import { WebHidTransport } from '@openloop/transport-webhid'

async function withRetry<T>(
  fn: () => Promise<T>,
  reconnect: () => Promise<void>,
  maxRetries: number = 1
): Promise<T> {
  for (let i = 0; i <= maxRetries; i++) {
    try {
      return await fn()
    } catch (err) {
      if (err instanceof TransportError && i < maxRetries) {
        await reconnect()
        continue
      }
      throw err
    }
  }
  throw new Error('Unreachable')
}

// 使用例
let transport = await WebHidTransport.connect()
let eth = new EthereumApp(transport)

const { address } = await withRetry(
  () => eth.getAddress(DEFAULT_ETH_PATH),
  async () => {
    const t = await WebHidTransport.reconnect()
    if (!t) throw new Error('デバイスが見つかりません')
    transport = t
    eth = new EthereumApp(transport)
  }
)

import { ApduError, DEFAULT_ETH_PATH } from '@openloop/sdk-core'

function isRejectedOrBusy(err: unknown): boolean {
  return err instanceof ApduError && err.statusWord === 0x6985
}

async function signAndHandle(): Promise<void> {
  try {
    const sig = await eth.signTransaction(DEFAULT_ETH_PATH, rawTx)
    console.log(sig)
  } catch (err) {
    if (isRejectedOrBusy(err)) {
      // 拒否か使用中 — 画面を確かめてもう一度
      showMessage('デバイスで拒否されたか、デバイスが使用中です。画面を確認してもう一度お試しください')
      return
    }
    // その他のエラーは表示
    showError(err)
  }
}