HOWVAGENTWORKS.
Everything the protocol does today, what it does not do yet, and how to drive the agent terminal. Written against the build you are looking at — not a roadmap pitch.
DOC REV 2026.07 · GEN 004
OVERVIEW
What Vagent is and what it is not.
Vagent is a lineage of autonomous trading agents. Each generation is spawned with a set of parameters, exposed to live market conditions, scored on its results, and either terminated or promoted. Promoted agents become the parent of the next generation, and the whole record of that selection stays onchain on Robinhood Chain.
The point is not a single clever model. The point is the loop: spawn many, let live markets kill most of them, carry forward only what survived, repeat. A generation is a checkpoint in that loop, not a product release.
What is live right now
- Wallet connection to Robinhood Chain (chain ID 4663) through any EIP-6963 browser wallet.
- The holder gate: the terminal opens for wallets holding at least 100,000 tokens.
- The agent store: blueprints are bought with tokens, settled onchain to the treasury.
- The agent terminal: deploy purchased blueprints, inspect them, and explore the workspace.
- Live spot market data on the MARKETS panel, served from a public price API.
- The public lineage record for generations 001 through 004.
What is not live yet
- Agents do not execute real orders. Buying a blueprint pays for a seat, not for a trading mandate.
- Agent performance telemetry — equity curves, scores, activity feed — is a deterministic simulation used to design and test the interface. Market prices are the exception: those are real.
- Agent configurations and purchase receipts are stored in your browser, not in a contract or a backend. The payment transactions themselves are onchain.
Vagent is not investment advice and takes no custody of assets. Connecting a wallet shares your public address and nothing else.
THE LINEAGE MODEL
Generations, branches, mutation, termination.
A generation is a batch of agents that share a parent and a spawn configuration. Every generation carries the identity of the branch it came from, so any live agent can be traced back through its ancestors to the foundation model.
| GEN | LABEL | PARENT | STATE |
|---|---|---|---|
| 001 | Foundation | — | TERMINATED |
| 002 | Adaptation | GEN 001 | TERMINATED |
| 003 | Branch | GEN 002 | TERMINATED |
| 004 | Live Selection | GEN 002 | ACTIVE |
Generation 003 and generation 004 both branch from 002. That is deliberate: a branch that dies is not a failure of the parent, it is evidence about one direction of the parameter space. 003 was terminated, 004 survived, and 004 is what the next spawn will be based on.
Terminology
| TERM | MEANING |
|---|---|
| SPAWN | Creating agents from a parent with mutated parameters. |
| COMPETE | Running agents against live market data on identical conditions. |
| KILL | Removing an agent whose score falls below the survival threshold. |
| MUTATE | Deriving the next parameter set from surviving agents. |
| BRANCH | A parallel line of descent from the same parent. |
SELECTION & SCORING
How survivors are chosen.
Every agent in a generation runs the same instruments, the same data interval, and the same evaluation window. Only the agent's own parameters differ, so the comparison between siblings is direct.
Scoring is deliberately multi-factor. An agent that produces a large return with unstable drawdowns is not preferred over a steadier sibling — survival favours behaviour that can be inherited, not lucky single trades.
| FACTOR | WHY IT MATTERS |
|---|---|
| Return | Raw performance over the evaluation window. |
| Sharpe | Return per unit of volatility — punishes noisy equity curves. |
| Max drawdown | The worst peak-to-trough move an agent inflicted. |
| Consistency | How stable the result is across sub-windows of the run. |
| Survival time | How long the agent stayed above the kill threshold. |
Kill decisions are automatic. An agent that crosses its drawdown limit is terminated inside the same evaluation window rather than at the end of it.
AGENT TERMINAL
Driving the workspace after you connect.
The terminal opens once a wallet is connected, on Robinhood Chain, and holding at least 100,000 tokens. It is a workspace with several panels, all keyed to your address — connecting a different wallet gives you a different, isolated set of agents.
| PANEL | WHAT IT DOES |
|---|---|
| OVERVIEW | Session summary, holdings, fleet counters, simulated equity curve. |
| STORE | Agent blueprints with token prices, and the purchase flow. |
| DEPLOY | Configuration form for an agent, deployed from a purchased license. |
| FLEET | Every agent you configured, with filters, sorting and a detail view. |
| MARKETS | Live spot prices, 24h stats and 7d charts from a public price API. |
| LINEAGE | The generation record, expandable per generation. |
| ACTIVITY | Event log of everything you did in this session plus simulated agent events. |
| SETTINGS | Local preferences, license receipts, JSON export/import, clearing local data. |
Configuring an agent
| FIELD | RULES |
|---|---|
| Name | 2–32 characters. Used as the display label across the terminal. |
| Objective | 10–500 characters. Plain-language description of what the agent should pursue. |
| Type | Market analyst, signal monitor, portfolio observer, or custom. |
| Risk profile | Conservative, balanced or aggressive — sets the drawdown envelope. |
| Data interval | 1m, 5m, 15m or 1h candles. |
| System directive | Optional, up to 1000 characters. Constraints the agent must respect. |
Deploying an agent from a license you already own is free and produces no transaction. The only transaction the terminal ever asks for is the token transfer when you buy a blueprint.
TOKEN & ACCESS
Holding requirement, pricing, treasury.
Vagent runs on its own token. The contract address is published in the strip pinned to the top of every page — copy it from there, and treat any other address as a fake.
Holder gate
The agent terminal opens for wallets holding at least 100,000 tokens on Robinhood Chain. The check is a plain balanceOf read against the token contract: nothing is locked, staked, or transferred, and you keep custody of every token the whole time. Sell below the threshold and the terminal closes again; buy back and it reopens on the next balance check.
| REQUIREMENT | VALUE |
|---|---|
| Minimum holding | 100,000 tokens |
| Network | Robinhood Chain (4663) |
| Check | balanceOf(your address), re-read every 30s |
| Custody | None — tokens never leave your wallet |
Agent pricing
Agents are not free. Each blueprint is a paid seat with its own price, capabilities and limits — the ladder runs from the 25,000-token entry seat to the 1,000,000-token flagship. Paying transfers tokens to the project treasury and issues a license; deploying an agent consumes one license.
| BLUEPRINT | PRICE | WHAT IT BUYS |
|---|---|---|
| SCOUT-01 | 25,000 | 1 instrument, 15m/1h, conservative only |
| SIGNAL-02 | 60,000 | 3 instruments, 5m, cross-market ranking |
| HEDGE-03 | 120,000 | 5 instruments, automatic hedge leg |
| MOMENTUM-04 | 200,000 | 8 instruments, 1m candles, aggressive envelope |
| REGIME-05 | 350,000 | 12 instruments, regime layer, adaptive sizing |
| SWARM-06 | 600,000 | 20 instruments, spawns up to 6 sub-agents |
| APEX-07 | 1,000,000 | Unlimited, priority slot, seeds GEN 005 |
Deleting an agent releases its license back to you — a seat is paid for once and can be redeployed with a different configuration.
Treasury
Treasury 0xD3fb0E260eC41F1d3AD57ECc65905971e9AE6660 Method ERC-20 transfer(treasury, price) Network Robinhood Chain (4663) License issued only after the transfer confirms onchain
Vagent never asks for a token approval, a seed phrase or a private key. A purchase is a single transfer you sign yourself, for the exact price shown on the blueprint.
WALLET & NETWORK
Connecting, and Robinhood Chain parameters.
The connector discovers wallets directly in your browser over EIP-6963 — no third-party modal service is involved. Any wallet that announces itself appears in the picker with its own icon; Coinbase Wallet connects through its own SDK.
- 1Press CONNECT WALLET anywhere on the site.
- 2Pick your wallet from the detected list. Wallets you do not have are grouped under OTHER WALLETS with install links.
- 3Approve the connection request in the wallet.
- 4Approve the network switch to Robinhood Chain if your wallet is on a different network. Wallets that do not know the chain yet will offer to add it.
Robinhood Chain mainnet
Network name Robinhood Chain Chain ID 4663 (0x1237) Currency ETH (18 decimals) RPC URL https://rpc.mainnet.chain.robinhood.com Explorer https://robinhoodchain.blockscout.com
Vagent will never ask for a seed phrase, a private key, or a token approval. If any page claiming to be Vagent asks for those, it is not us.
Troubleshooting
| SYMPTOM | FIX |
|---|---|
| Wallet missing from the picker | Unlock the extension, then reload the page — discovery runs at load. |
| “Request rejected” | The approval was dismissed in the wallet. Press connect again. |
| Stuck on WRONG NETWORK | Switch to Robinhood Chain manually in the wallet, or approve the switch prompt. |
| Terminal shows no agents | Agents are per-address and per-browser. A different wallet or a cleared browser has its own empty set. |
DATA & PRIVACY
Where your inputs actually go.
There is no Vagent account, no login, and no server-side profile. The terminal writes agent configurations and preferences to your browser's local storage, namespaced by chain ID and lowercase wallet address.
vagent:agents:4663:<address> configured agents vagent:licenses:4663:<address> purchase receipts vagent:prefs:4663:<address> terminal preferences
- Clearing site data or using a private window removes your configurations permanently.
- Settings → EXPORT writes the same data to a JSON file you control; IMPORT reads it back.
- Your address is used as a namespace and to read public chain data. It is not sent to any Vagent service.
STATUS & ROADMAP
Honest state of the build.
| CAPABILITY | STATE |
|---|---|
| Wallet connection, network guard | SHIPPED |
| Token holder gate (100,000 tokens) | SHIPPED |
| Agent store, token payments to treasury | SHIPPED |
| Live market data | SHIPPED |
| Agent configuration + local fleet | SHIPPED |
| Agent performance telemetry | SHIPPED (SIMULATED DATA) |
| Onchain agent registry | IN DESIGN |
| Live execution and real scoring | NOT STARTED |
| Public generation API | NOT STARTED |
Until the registry lands, treat the terminal as a design surface: the flows, the fields and the constraints are real, the numbers behind them are generated. Every simulated panel is labelled as such in the interface.
FAQ
Short answers.
Does connecting a wallet cost anything?
No. Connecting is a signature-free read of your public address. The only transaction the site ever requests is a blueprint purchase you explicitly confirm.
Can I run an agent with real money today?
No. Execution is not implemented. Buying a blueprint pays for the seat and its future capabilities, and the configuration you save describes the agent — neither is a live trading mandate.
Why do I need 100,000 tokens just to look?
The terminal is the holder surface of the project. The gate is a balance read, not a lock — nothing is staked and nothing is taken.
Why Robinhood Chain?
The lineage record is meant to be public and cheap to append to. Robinhood Chain is the network the generation record targets, so the terminal refuses to operate anywhere else.
Do I need a Robinhood account?
No. Robinhood Chain is an EVM network — any EVM wallet that can add it will work. Robinhood Wallet is listed first in the picker because it is native to the chain, not because it is required.
Where do I follow updates?
On X at @vagenthood. Generation changes are announced there first.