Finish a token sign-in (get a pass)
finish_token_signinUse after start_token_signin, once your wallet has signed the message. Free. Checks the signature and that the address holds an accepted token or name right now, and returns a short-lived pass (pp1.…). Give the pass to the gated site the way it asks: sites using the npm package or Cloudflare template take it at POST /api/tokenlock/session ({"pass": "…"}) and set a cookie; your own API can take it in a header and check it with verifyPass. If the site accepts any name, send your name. Single use per challenge. A pass proves you controlled a wallet holding the token at sign-in, not who you are.
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>",
"address": "<address>",
"signature": "<signature>"
},
"name": "finish_token_signin"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Your vanity name, when the site accepts any name. | |
| address | Yes | The Bitcoin address that signed. | |
| signature | Yes | Base64 signature of the exact message (BIP-322 or legacy sign-message). | |
| challenge_id | Yes | challenge_id from start_token_signin. |