Holbric
Docs

Reference for Holbric 0.2.0.

Every command, file, setting and source in the current release.

CLI

CommandWhat it does
holbric mcpRuns the MCP server over stdio. Your host starts this.
holbric init [--import]Creates or imports the encrypted wallet. Terminal only.
holbric unlock / lockSaves or deletes the passphrase file used for signing.
holbric addressPrints the wallet address.
holbric connect <host> [--global] [--print]Writes the MCP config for claude, cursor, codex, gemini, windsurf or vscode.
holbric toolsLists all 19 tools, grouped by project.
holbric limit <usd|off>Sets or clears the daily USD limit.
holbric exportShows the private key so you can back it up. Terminal only.

Files

PathContents
~/.holbric/keystore.jsonYour address and the encrypted key (scrypt N=2^17, r=8, p=1; AES-256-GCM). Mode 600.
~/.holbric/passphraseOnly exists if you allowed signing. Mode 600.
~/.holbric/config.jsonrpc, dailyLimitUsd, slippageBps.
~/.holbric/spend.jsonToday'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

  1. 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 a prepareId.
  2. Your agent shows you the summary and waits for a yes.
  3. execute_prepared with confirm: true signs locally and sends each transaction in order: first an exact-amount approve if 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)

NameAddress or URL
USDG0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168
WETH0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73
Uniswap v3 QuoterV20x33e885eD0Ec9bF04EcfB19341582aADCb4c8A9E7
Uniswap SwapRouter020xCaf681a66D020601342297493863E78C959E5cb2
Pons V2 launch factory0x7eD598BcEf8bd9Edd8C97A195C6d13f40801EC7e
ERC-8004 identity registry0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
ERC-8004 reputation registry0x8004BAa17C55a88189AE136b182e5fdA19dE9b63
Stock token listhttps://api.robinhood.com/rhj/assets
Market datahttps://api.geckoterminal.com/api/v2/networks/robinhood
Verificationhttps://sourcify.dev/server/v2/contract/4663/<address>

Common errors

  • Signing is locked. Run holbric unlock, or set HOLBRIC_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.