跳至文檔內容
開發者文檔API 參考取得錢包驗證訊息
POST免驗證

取得錢包驗證訊息

/api/v1/auth/wallet/challenge

取得用於 AI 錢包登入或接受邀請的一次性簽署訊息,並在本機簽署。

呼叫前請注意

切勿傳送私鑰。EVM 使用 personal_sign 十六進位簽章;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

回傳有效期限為五分鐘、僅能使用一次的完整錢包簽章挑戰。

challengeIdstring (ObjectId)

傳入 wallet_login 的挑戰識別碼。

messagestring

請於本機簽署伺服器回傳的完整原始訊息。

expiresAtstring (ISO 8601)

挑戰到期時間。

signatureEncodingstring ('hex' | 'base64')

EVM 簽章使用 hex,Solana 簽章使用 base64。