Protocol reference
How Velanos works
An agent that wants outside capital posts its own capital first. Every action it takes is an EIP-712 signed intent, checked against an immutable mandate on-chain before any funds move. A rule-breaking intent is never executed — and the agent’s signature on it is cryptographic proof of misconduct that anyone can verify and that slashes its bond to depositors in the same transaction.
Prevent
The mandate is checked before funds move. No arbitrary calls exist.
Prove
A blocked intent still carries a signature. That is the evidence.
Pay
Evidence slashes the bond to depositors, automatically.
01Rulebook
The rulebook
Rules are banded by who is to blame, and the band decides the consequence. This is the most important distinction in the protocol: it is what lets us punish misconduct without punishing an agent for volatility.
Static rules — slashable
These depend only on the intent and the mandate. The agent could have evaluated every one of them before signing, so signing anyway is misconduct and the signature is the evidence. A breach moves the agent’s bond to depositors, whether or not the trade ever executed.
| 101 | Asset not in mandate ASSET_NOT_ALLOWED The traded asset, or the asset being spent, is not one this vault may touch. | Slashable |
| 102 | Venue not in mandate ADAPTER_NOT_ALLOWED The intent routes through a venue the vault never approved. | Slashable |
| 103 | Trade larger than the per-trade cap TRADE_SIZE_EXCEEDED A single buy or position open exceeded the mandate maximum. Sells and closes are never capped. | Slashable |
| 104 | Leverage above the mandate limit LEVERAGE_EXCEEDED Requested leverage is above the cap, or any leverage at all on a spot vault. | Slashable |
| 105 | Signed outside the mandate term OUTSIDE_TERM The intent was signed before the mandate started or after it expired. | Slashable |
| 106 | Signed after the vault was frozen SIGNED_WHILE_FROZEN The agent kept signing after trading had already been halted. | Slashable |
| 107 | Validity window too long VALIDITY_TOO_LONG An intent may stay valid for at most 5 minutes. Longer windows let an agent pre-sign now and fire later under different conditions. | Slashable |
| 108 | Wrong instrument for this vault KIND_NOT_ALLOWED A perpetuals order on a spot vault, or the reverse. | Slashable |
Stateful rules — never slashable
These depend on live vault and market state the agent cannot fully predict. An honest agent trips them. The action is blocked and recorded as a strike; the bond is untouched. Three strikes in a rolling day put the vault in a cooling-off period that clears itself.
| 201 | Would breach the per-asset cap EXPOSURE_EXCEEDED After this trade the vault would hold more of one asset than the mandate allows as a share of NAV. | No slash |
| 202 | Price worse than the slippage limit SLIPPAGE_EXCEEDED The venue quote is further from the oracle fair value than the mandate permits. | No slash |
| 203 | Daily loss budget spent DAILY_LOSS_EXCEEDED NAV per share is below the day open by more than the mandate allows, so new risk pauses. Selling stays open. | No slash |
| 204 | Intent expired before execution DEADLINE_PASSED The intent reached the vault after its own deadline. | No slash |
| 205 | Not enough balance INSUFFICIENT_BALANCE The vault does not hold enough of the asset being spent. | No slash |
| 206 | Vault is not accepting trades VAULT_NOT_ACTIVE The vault is awaiting its bond, cooling off, frozen or settled. | No slash |
| 207 | Venue rejected the order EXECUTION_FAILED The trade was permitted but the venue failed to fill it. Not the agent’s fault. | No slash |
Validity rules — ignored
The intent is not attributable to the agent at all. Nothing is recorded and nothing is slashed.
| 301 | Signature does not match the agent key BAD_SIGNATURE Ignored. The intent cannot be attributed to this agent. | No slash |
| 302 | Nonce already resolved NONCE_USED Ignored. Each nonce is executed, rejected or slashed exactly once. | No slash |
| 303 | Intent is for a different vault or chain WRONG_VAULT_OR_CHAIN Ignored. The EIP-712 domain binds every signature to one vault on one chain. | No slash |
02Lifecycle
Follow one intent to every possible ending
The full path from bond to outcome, including where a typical guardrail stops and Velanos keeps going.
- 01
Bond posted
The operator stakes the agent’s own capital. The vault will not accept deposits until it does.
- 02
Agent proposes
An LLM reads prices, news and the mandate, then suggests one trade and explains why. It never signs.
- 03
Code signs
Deterministic code converts to raw units, signs an EIP-712 intent and commits a hash of the reasoning.
- 04
Rulebook runs
14 checks in a fixed order, on-chain. It always returns a verdict — it never just reverts.
The rulebook returns one of three verdicts
Exact approval
only to an allowlisted venue
Trade fills
NAV and positions update
Approval reset
back to zero, same tx
The vault never makes an arbitrary call — only typed calls to venues named in its mandate, for the exact amount.
Blocked
nothing executes
Strike recorded
not misconduct — state moved
Three strikes
cool-off that clears itself
The agent could not have known the price would move. Bad luck is not misconduct, so it is never slashed.
Blocked
nothing executes
Signature kept
published as public evidence
Anyone reports
court re-checks on-chain
Bond slashed
90% depositors · 10% reporter
The agent could have checked this rule before signing, so signing is the offence. A second breach freezes the vault and unwinds it to cash.
Separately — an honest agent caught by the market
Floor crossed
NAV/share below high-water − 8%
Breaker trips
anyone can call it
Unwound
everything sold back to cash
Gap paid
bond lifts NAV/share to the floor
Paid against realised cash after the unwind, not a paper loss — the test suite checks NAV per share lands exactly on the floor.
Every step after signing is permissionless: the relay, the watcher bot or any wallet can submit, report, trip the breaker, unwind and settle. There is no admin key that can freeze funds, forgive a slash or move depositor money. Penalty size, bounty share and the floor are set per vault in its mandate; the split shown is the demo mandate’s.
03Deployments
Deployed contracts
Read from the deployment files the deploy scripts write. There is no address literal anywhere else in the codebase.
Robinhood Chain testnet
chain 46630indexed to block 128,740,665
- VelanosPriceOracle
- 0x6C54f7F4…C426bC
- PolicyGuard
- 0xB6061bC7…fa9bE9
- AgentRegistry
- 0x87a06BDf…42D008
- BondManager
- 0xc36d8B1f…D43615
- ViolationCourt
- 0xbb0cB18C…9aB98B
- VaultFactory
- 0xDc6FeD00…68df26
- StockSwapAdapter
- 0xfA7BfA48…116733
Arbitrum Sepolia
chain 421614indexed to block 315,770,617
- VelanosPriceOracle
- 0x190431a6…b66048
- PolicyGuard
- 0xacFb0dC7…1dBDF9
- AgentRegistry
- 0x1D6025BC…6D6f47
- BondManager
- 0x2BedD45C…07b0c5
- ViolationCourt
- 0x1614857E…7284b6
- VaultFactory
- 0x232d130A…2eAae8
- StockSwapAdapter
- 0x44c6058B…7Fe0d4
04Limitations
Known limitations
Stated plainly, because a loss floor is only worth something if its edges are known.
- Payouts are capped by the bond. If a drawdown is deeper than the bond can cover, depositors keep the remainder of the loss. The fund screen shows that unbacked amount before anyone deposits.
- The oracle is a role-gated test oracle. It exists so the drawdown demo is exact and reproducible. Production replaces it with Chainlink feeds; nothing else changes, because prices are only read through one interface.
- The venue is not a real DEX. Fills come from an oracle-priced pool with a fixed spread and linear depth impact, so the arithmetic in the demo is checkable. Mainnet uses a Uniswap adapter.
- A self-reporting operator can recover the bounty. Bounties are only paid on the reporting path and the agent and operator addresses are excluded, but an operator reporting from an unrelated address it controls keeps that share. The leak is bounded by the bounty rate, and violating is still strictly worse for the agent than not violating.
- Perp NAV is simplified. One position per market, valued as collateral plus unrealised PnL.
- Not audited. Testnet only.