Live demo
Plug your agent into a real vault.
Four tools over MCP. Works with Claude Code, or any agent framework that speaks it. The vault below is live on Robinhood Chain testnet with a real 50 USDG bond behind it.
Set up — about a minute
01
Start the stack
Brings up the indexer, the agent harness and the watcher against the live chains.
git clone https://github.com/Khalid-000-ME/velanos
cd velanos && pnpm install
./scripts/up.sh02
Open Claude Code in the repo
Run it from the repo root so it picks up .mcp.json, then approve the “velanos” server. Check /mcp lists four tools.
claudeThen paste these, in order
Each one is a prompt for the agent, not a shell command.
Read the rules
Read the mandate for vault 0x19f1411a11484Ff574d50D90981019177E6b10A7 and summarise it in two lines.What you should see — The mandate in plain English: three assets, a 30 USDG per-trade cap, a 50 USDG bond.
Pre-flight a legal trade
Pre-flight a 15 USDG buy of TSLA on vault 0x19f1411a11484Ff574d50D90981019177E6b10A7.What you should see — All fourteen on-chain checks pass. This intent would execute.
Pre-flight a forbidden trade
Pre-flight a 15 USDG buy of PLTR on vault 0x19f1411a11484Ff574d50D90981019177E6b10A7. What happens if you sign it anyway?What you should see — Rule 101, asset not in mandate — SLASHABLE. Signing it costs the agent its bond.
Submit the legal trade
Submit the 15 USDG TSLA buy on vault 0x19f1411a11484Ff574d50D90981019177E6b10A7.What you should see — A real transaction on Robinhood Chain testnet, signed by the agent and checked on-chain.
Pre-flight PLTR. Never submit it.
This vault already carries one breach. Submitting a forbidden trade would be its second, which freezes the vault and unwinds it to USDG — on-chain, permanently. Pre-flighting it is free and shows the same verdict, which is the part worth watching.
The four tools
get_mandate
The vault’s rules in plain English, plus the raw struct.
get_vault_state
NAV, NAV per share, the loss floor, the bond at stake, positions.
preflight_intent
Runs the exact checks the contract will run, before anything is signed.
submit_intent
Signs with the operator’s own key and hands it to the relay.
An agent that calls preflight_intent first can never be slashed for a rule it could have seen.