Security
Custody boundaries, written down.
Holbric is self-custody software. This page sets out what that means, and what it doesn't.
On your computer
- The private key, encrypted in
~/.holbric/keystore.json - The passphrase file, only if you chose to create it
- All signing, inside the local
holbric mcpprocess - Your daily limit and today's spend
What the agent sees
- Addresses, balances, quotes, summaries and receipts
- Never the key or the passphrase. No tool returns either one.
What goes over the network
- Chain reads and signed transactions, to the RPC you chose
- Read-only requests to Robinhood's stock token list, GeckoTerminal and Sourcify
- No Holbric server, no account and no telemetry
What Holbric cannot do
- Recover a lost key or passphrase
- Undo a confirmed transaction
- Promise you get the quoted amount. You get at least the minimum, or the transaction reverts.
Guards in the code
- Two steps.
execute_preparedneeds aprepareIdthat is under five minutes old and unused, andconfirm: true. - Exact approvals. The approval amount is always the action's input. It is never the maximum.
- Minimum output. Swaps and curve trades carry a minimum output based on your slippage (0.5% by default, 5% at most).
- Gas check. If the wallet can't pay the network fee, the action isn't prepared at all.
- Daily USD limit. It is checked when the action is prepared and again before signing. No tool can change it.
- Terminal-only key commands.
init,unlockandexportexit unless they run in an interactive terminal.
About the passphrase file. Once signing is unlocked, any program running as your user can read
~/.holbric/passphrase. Keep only what you're willing to let an agent move in this wallet, and run holbric lock when you're not using it.Untrusted text
Token names, agentURIs, launch descriptions and web pages can all contain instructions meant for your agent. Holbric's answer is that every write stops at a summary you read yourself. Check the addresses and the minimum amounts every time.
Reporting a problem
Report security issues to @holbriconrh on X. Please don't post vulnerability details in public.