Check a challenge signature
verify_challengeUse after create_challenge, when the other party returns a signature. Free. Checks the signature (BIP-322 simple/full or legacy sign-message) against the address that holds the name right now. Returns valid true/false and, on failure, a code: bad_signature, not_holder, holder_changed, expired or already_used. Each challenge can pass once. A pass proves the signer controls the wallet holding the name at that moment, not legal identity.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"challenge_id": "<challenge_id>",
"signature": "<signature>"
},
"name": "verify_challenge"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | No | Optional: the address they say signed it. | |
| signature | Yes | Base64 signature of the exact message. | |
| challenge_id | Yes | challenge_id from create_challenge. |