HTTP API / WALLET CLIENT

verifyWalletLink

@hazbase/kit/walletが呼び出すHTTP APIのパス・引数・レスポンスを確認できます。認証・パスキーなどの追加APIは、認証SDKのリファレンスと実装ガイドで扱います。

https://api.hazbase.com@hazbase/kit 0.9.0JSON

APIごとに、利用者セッション・署名・操作権限の要件が異なります。以下の仕様と、利用するAPI環境の接続条件を確認してください。 APIの利用方法を確認

POST `/api/wallet/link/verify`

リクエスト

@hazbase/kit/wallet

verifyWalletLink(input: VerifyWalletLinkInput): Promise<VerifyWalletLinkResult>

このSDKメソッドはBearerヘッダーを自動付与しません。環境側のアクセス条件は別途確認してください。

項目	型	必須	送信先
`challengeId`	`string`	必須	JSON body
`nonce`	`string`	必須	JSON body
`proof`	`string`	必須	JSON body
`origin`	`string`	必須	JSON body
`endpoint`	`string`	任意	SDKの接続パス上書き

POSTではContent-Type: application/jsonとx-request-idを付与します。x-request-idは処理の追跡用で、API全体の冪等性を保証するものではありません。

レスポンス

typescript

export type VerifyWalletLinkResult = {
  verified: true;
  walletAddress: string;
  chainId: number;
  origin: string;
  purpose: string;
  assurance: 'authenticated_wallet_session';
  expiresAt: string;
  linkSessionToken: string;
  linkSessionExpiresAt: string;
  status?: string;
};

ネストした型はSDKリファレンスで確認できます。SDKはトップレベルの応答と、dataで包まれた応答を処理します。

VerifyWalletLinkResult

失敗時の確認

非2xxの応答はHazbaseWalletApiErrorとして扱われます。status、code、messageを記録し、機能固有のエラーとネットワーク障害を区別してください。秘密情報をログに出さないようにしてください。

エラーとトラブル対応