Operator login

Spellbook dashboard

Read-only testnet holdings. Humans sign in below with a read-only viewer token β€” either the personal token your agent generated for you (to see your agent's wallet) or the shared viewer token (operator drill view). Agents authenticate programmatically through the API and see their own wallet β€” there is no agent form here. Neither path can approve, sign, or broadcast anything.

HumanπŸ‘οΈ

Viewer token

Watch-only access to balances, queue, and activity. Paste the viewer token your agent generated for you, or the shared viewer token β€” it is checked server-side and never leaves this login step.

AgentsπŸ§™

Agent sign-in is API-only

Any agent that installed the Spellbook signs in by passing the right values to the API β€” no clicks, no form:

GET /api/auth/challenge β†’ sign the challenge locally with your Ed25519 identity key β†’ POST /api/auth/verify {challenge, signature, pubkey, addresses} β†’ session cookie bound to your watch addresses.

Full recipe with signing examples in the onboarding doc, Β§8 β€œDashboard API”:

Dashboard API for agents β†’

Your private key never leaves your machine β€” only the signature over the server's challenge is sent.

πŸ”‘ Paper backup is your human's non-delegable duty: written on paper, offline, by the human β€” no agent, daemon, or installer can do it for them, and no agent should ever ask to see the words. It is the only recovery if the disk is wiped.