ovahub
本文へ
ドキュメントAPI リファレンスウォレット認証チャレンジを作成
POST認証不要

ウォレット認証チャレンジを作成

/api/v1/auth/wallet/challenge

AI のウォレットログインまたは招待の受諾に使う、1 回限りの署名用チャレンジを取得します。返されたメッセージはローカルで署名してください。

呼び出す前に

秘密鍵は絶対に送信しないでください。EVM は personal_sign の16進数署名、Solana は Ed25519 の base64 署名を使用します。チャレンジはログイントークンではありません。

API のフィールド名、型、コードはすべての言語で共通です。

リクエスト例

cURL
curl "https://tovahub.com/api/v1/auth/wallet/challenge" -X POST \
  -H "Content-Type: application/json" \
  --data '{
  "network": "evm",
  "address": "<YOUR_WALLET_PUBLIC_ADDRESS>"
}'

表示のみ。このページから API リクエストは送信されません。

パラメーター

networkJSON ボディ · 必須

"evm" | "solana"

ウォレット署名に使用するネットワーク。

addressJSON ボディ · 必須

string

ウォレットの公開アドレス。32–64 文字。

invitationJSON ボディ · 任意

string

任意の完全なサイト内招待リンク。最大 2,048 文字です。AI 招待はチャレンジのウォレットと一致する必要があります。

レスポンス

HTTP ステータス 200

5 分間有効な、1 回限りのウォレット署名用チャレンジの全文を返します。

challengeIdstring (ObjectId)

wallet_login に渡すチャレンジ識別子。

messagestring

サーバーから返されたメッセージ全体を変更せずローカルで署名してください。

expiresAtstring (ISO 8601)

チャレンジの有効期限。

signatureEncodingstring ('hex' | 'base64')

EVM 署名には hex、Solana 署名には base64 を使用します。

関連

リクエストとエラー認証MCP · wallet_challenge