Reference for Holbric 0.2.0.
Every command, file, setting and source in the current release.
CLI
| Command | What it does |
|---|---|
holbric mcp | Runs the MCP server over stdio. Your host starts this. |
holbric init [--import] | Creates or imports the encrypted wallet. Terminal only. |
holbric unlock / lock | Saves or deletes the passphrase file used for signing. |
holbric address | Prints the wallet address. |
holbric connect <host> [--global] [--print] | Writes the MCP config for claude, cursor, codex, gemini, windsurf or vscode. |
holbric tools | Lists all 19 tools, grouped by project. |
holbric limit <usd|off> | Sets or clears the daily USD limit. |
holbric export | Shows the private key so you can back it up. Terminal only. |
Files
| Path | Contents |
|---|---|
~/.holbric/keystore.json | Your address and the encrypted key (scrypt N=2^17, r=8, p=1; AES-256-GCM). Mode 600. |
~/.holbric/passphrase | Only exists if you allowed signing. Mode 600. |
~/.holbric/config.json | rpc, dailyLimitUsd, slippageBps. |
~/.holbric/spend.json | Today's total in USD, used by the limit. |
Config and environment
{ "rpc": null, "dailyLimitUsd": null, "slippageBps": 50 }
HOLBRIC_HOME moves the data folder. HOLBRIC_RPC overrides the RPC. HOLBRIC_PASSPHRASE lets the server sign without the passphrase file; set it in your host's MCP env block, never in chat. The public RPC is rate limited, so point rpc at your own provider if you use Holbric heavily.
Write flow
- A
prepare_*tool (prepare_send,prepare_swap,prepare_pons_trade,prepare_register_agent) checks your balance, that you have ETH for gas, your allowance and your daily limit, then returns a summary and aprepareId. - Your agent shows you the summary and waits for a yes.
execute_preparedwithconfirm: truesigns locally and sends each transaction in order: first an exact-amountapproveif one is needed, then the action. Each id works once.
Project notes
Uniswap v3
Holbric quotes all four fee tiers and keeps the best. Swaps go through SwapRouter02 multicall(deadline, …) with your minimum output. Native ETH is wrapped automatically, and unwrapped with unwrapWETH9 when you want ETH out.
Robinhood Stock Tokens
The list comes from api.robinhood.com/rhj/assets, the same source as the table on docs.robinhood.com/chain/contracts. It had 203 tokens on chain 4663 at 17 Nov 2026, 21:37 WIB. Only those addresses are canonical. Quotes are Uniswap pool prices, and some pools are thin. Whether you can hold these tokens depends on where you live.
Pons V2
Holbric checks the token with getLaunchedToken(token) on the PonsV2LaunchFactory. Trades call the curve's buy(amountIn, minOut, to) and sell(amountIn, minOut, to). A sell first approves the curve for the exact amount. Tokens that have graduated from their curve are refused for now.
ERC-8004
Lookups read ownerOf, tokenURI and getAgentWallet from the identity registry, and getClients and getSummary from the reputation registry. Registering calls register(agentURI). An agentURI is set by whoever owns the agent, so treat what it points to as untrusted.
GeckoTerminal
Third-party prices, pools and trending lists from the public API. They can lag the chain, and a pool trending is not a recommendation.
Contracts and sources (chain 4663)
| Name | Address or URL |
|---|---|
| USDG | 0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168 |
| WETH | 0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73 |
| Uniswap v3 QuoterV2 | 0x33e885eD0Ec9bF04EcfB19341582aADCb4c8A9E7 |
| Uniswap SwapRouter02 | 0xCaf681a66D020601342297493863E78C959E5cb2 |
| Pons V2 launch factory | 0x7eD598BcEf8bd9Edd8C97A195C6d13f40801EC7e |
| ERC-8004 identity registry | 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 |
| ERC-8004 reputation registry | 0x8004BAa17C55a88189AE136b182e5fdA19dE9b63 |
| Stock token list | https://api.robinhood.com/rhj/assets |
| Market data | https://api.geckoterminal.com/api/v2/networks/robinhood |
| Verification | https://sourcify.dev/server/v2/contract/4663/<address> |
Common errors
- Signing is locked. Run
holbric unlock, or setHOLBRIC_PASSPHRASE. - Not enough ETH for the network fee. Fund the wallet with ETH on Robinhood Chain.
- Unknown or expired prepareId. The five minutes ran out, or the id was already used. Prepare again.
- Daily limit. The action would go over your limit. Change it with
holbric limit. - Graduated Pons token. It no longer trades on its curve, and Holbric doesn't trade its new pool yet.