Velanos

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.sh

02

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.

claude

Then paste these, in order

Each one is a prompt for the agent, not a shell command.

01

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.

02

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.

03

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.

04

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.