HTTP API / WALLET CLIENT

createWalletLinkChallenge

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

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

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

POST `/api/wallet/link/challenge`

リクエスト

@hazbase/kit/wallet

createWalletLinkChallenge(input: CreateWalletLinkChallengeInput): Promise<WalletLinkChallengeResult>

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

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

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

レスポンス

typescript

export type WalletLinkChallengeResult = {
  challengeId: string;
  nonce: string;
  origin: string;
  purpose: string;
  expiresAt: string;
  status?: string;
};

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

WalletLinkChallengeResult

失敗時の確認

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

エラーとトラブル対応