blockrun_wallet
Check USDC balance, set spending limits, switch payment chains (Base/Solana), and delegate budgets to child agents for cost control in multi-agent systems.
Instructions
Call this tool to manage the BlockRun payment wallet and control agent spending budgets.
Call this FIRST if any other blockrun_* tool returns a payment/balance error. Call this to check your current USDC balance before expensive operations. Call this to set spending limits before spawning child agents.
The server holds TWO wallets — one on Base, one on Solana — but pays on ONE active chain at a time. status shows both addresses/balances and which is active. Default chain is Base.
To pay on Solana (no env vars, no file editing, no restart):
action:"chain" chain:"solana" → provisions + activates the Solana wallet
action:"setup" → Solana address + funding QR (send USDC SPL on Solana) Switch back with action:"chain" chain:"base". Base-only — these ignore Solana and need Base: blockrun_music, blockrun_speech, blockrun_video, blockrun_realface, paid blockrun_price, blockrun_chat routing:"smart", and native Anthropic (claude-*). blockrun_image pays on either chain.
Actions:
status (default): Both wallet addresses + USDC balances, active chain, session spending
setup: Get funding instructions + QR code for the ACTIVE chain (call this when balance is 0)
qr: Open QR code (active chain) in system viewer
chain + chain:"base"|"solana": Switch the active payment chain (omit chain: to just see the current one)
Budget controls:
budget + budget_action:"set" + budget_amount:1.00 → Set global spend cap
budget + budget_action:"clear" → Remove global spend cap
Multi-agent orchestration:
delegate + agent_id:"research" + agent_limit:2.00 → Allocate $2 to a child agent
revoke + agent_id:"research" → Remove a child agent's budget
report → See per-agent spending breakdown
Usage pattern for multi-agent systems:
blockrun_wallet action:"delegate" agent_id:"worker-1" agent_limit:1.00
Pass agent_id:"worker-1" to all blockrun_chat/search/etc calls for that agent
blockrun_wallet action:"report" to audit spending
Do NOT call this for actual AI queries — use blockrun_chat for that.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Target chain for action='chain'. Omit to view the current active chain. | |
| action | No | What to do | status |
| agent_id | No | Agent identifier for delegate/revoke/report actions | |
| agent_limit | No | Budget limit in USD for this agent (required for delegate action) | |
| budget_action | No | Budget action (for action='budget') | |
| budget_amount | No | Budget limit in USD (for budget_action='set') |