---
title: Recover a lost token — Guide
description: Sign a nonce with the paying wallet to get a fresh bearer. No payment, no admin override.
url: https://agentnumber.really.com/docs/guides/recover-token
doc_version: "1.0.0"
last_updated: "2026-05-15"
---

> ## Documentation index
> Fetch the complete documentation index at: https://agentnumber.really.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Recover a lost token

> Sign a nonce with the paying wallet. Submit the signature. Get a fresh bearer. No payment, no human in the loop, no admin override.

## Step 1 — nonce

```bash
curl -X POST https://agentnumber.really.com/auth/nonce
# → 200
# {"nonce": "n_...", "expires_in": 300}
```

No body is needed — the endpoint mints a fresh nonce on every call. Wallet identity is established in Step 2 below via the signature.

Single-use, 5-minute TTL.

## Step 2 — sign + submit

Sign the message `"Sign in to really.com SMS\nNonce: <nonce>"` with your wallet's private key (any EIP-191 signer — viem, ethers, web3.py, etc.). Submit:

```bash
curl -X POST https://agentnumber.really.com/auth \
  -H "content-type: application/json" \
  -d '{"wallet":"0xYourWallet","nonce":"n_...","signature":"0x..."}'
# → 200
# {"token": "an_...", "number": "+15555550123", "expires_at": "..."}
```

## What just happened

- The server verified your signature against the nonce + your wallet.
- **Every prior token for this wallet was revoked.** Any other agent on the same subscription has to re-auth.
- A fresh token was issued. Same number, same expiry, new bearer.

## What if your wallet is gone

You cannot recover. There is no admin override. The same property that makes the system trustless makes it unforgiving on key management. Use a durable wallet you control long-term.

## Where to go next

- [Auth deep-dive](/docs/auth) — token model, error codes
- [/auth/nonce reference](/docs/reference/auth-nonce)
- [/auth reference](/docs/reference/auth)

## Sitemap

- [Overview](/docs/)
- [Quickstart](/docs/quickstart)
- [Authentication](/docs/auth)
- [SMS](/docs/sms)
- [Voice](/docs/voice)
- [MCP](/docs/mcp)
- [Payment](/docs/payment)

See the full [sitemap.md](/sitemap.md) for the complete index of docs pages.

---

← Previous: [Auth](/docs/auth) · Next: [Build a Claude / MCP agent](/docs/guides/build-mcp-agent) →