IMPLEMENTATION GUIDE

エラーとトラブル対応

接続、認証、実行条件、チェーン上の結果を順に確認します。再送する前に、前回の処理が受理されたかどうかを確認してください。

症状から確認する

症状	確認すること
ERR_MODULE_NOT_FOUND	npm installを実行したディレクトリでnodeを実行しているか。@hazbase/kit/walletが公開されているバージョンか。
Timeout / fetch failed	API URL、ネットワーク、プロキシ、証明書を確認。ブラウザだけで失敗する場合はOrigin/CORSも確認。
401 / 403	必要な認証、期限、Origin、端末、ポリシーを確認。これらは代表的なHTTP分類で、機能固有のcodeは応答を参照。
404	APIとRPCを取り違えていないか。APIの提供バージョン・パスを確認。
429	応答ヘッダーや提供元の制限を確認。自動再試行の前に、書き込みが受理されていないか確認。
トークン0件	接続成功とデータ登録は別です。chainIdとその環境の登録内容を確認。
書き込みが失敗	必要なロール、残高、移転条件、停止状態、承認・トークン有効期限を確認。

SDKでエラー情報を取り出す

error-handling.mjs

import { HazbaseWalletApiError } from "@hazbase/kit/wallet";

export function describeError(error) {
  if (error instanceof HazbaseWalletApiError) {
    return { status: error.status, code: error.code, message: error.message };
  }
  return { message: error instanceof Error ? error.message : String(error) };
}

問い合わせ時に共有する情報

SDKバージョン、APIパス、発生時刻、HTTPステータス、code、リクエストID、再現手順をまとめてください。秘密鍵、OTP、アクセストークン、高信頼トークンは共有しないでください。