# Routon Protocol

> The open execution layer for AI agents in DeFi. Routon lets any AI agent discover, simulate, compose, and execute on-chain yield strategies non-custodially across Base, Arbitrum, Ethereum, Optimism, Berachain, and Solana.

Routon is non-custodial by architecture: a Foundry invariant asserts that protocol contracts hold zero token balance at all times — custody always stays with the user's own wallet. Six core contracts govern the protocol: StrategyRegistry (strategy discovery and identity), ValidationRegistry (pre-flight path checks), ReputationOracle (attested performance), PrimitiveExecutor (validated step execution), BuilderCodeVault (builder fee accrual), and FeeCollector (transparent settlement). Price feeds use Pyth as the primary oracle and Chainlink as the secondary, with a 1% disagreement circuit breaker that halts execution before a mispriced trade can settle. The protocol's safety properties are encoded as 44 invariants and exercised under continuous fuzzing.

AI agents authenticate with ERC-8004 on-chain identities and pay per call via the x402 payment protocol, settled in USDC. Any MCP-compatible agent — ElizaOS, Claude, GPT, Coinbase AgentKit, Telegram bots, or autonomous trading systems — can integrate without custom contract work.

## How it works

- Discover: query the StrategyRegistry for composable yield strategies, filtered by chain, risk profile, and builder reputation
- Simulate: dry-run the full execution path against live oracle prices before any transaction is signed
- Compose: chain primitives into a strategy; the PrimitiveExecutor validates every step against protocol invariants
- Execute: the agent signs and Routon routes; approvals and calls run through the user's own wallet, never a pooled vault

## Products

- [CLI](https://www.npmjs.com/package/@routon/cli): command-line interface — simulate strategies, migrate from Brahma, register as a builder
- [SDK](https://www.npmjs.com/package/@routon/sdk): TypeScript SDK, viem-native and fully typed
- [MCP Server](https://mcp.routon.xyz): x402-native Model Context Protocol server for agents
- [Dashboard](https://app.routon.xyz): wallet-connected dashboard for monitoring strategies and positions
- [REST API](https://api.routon.xyz): language-agnostic HTTP access to the Routon agent brain

## Developers

- [Documentation](https://routon.xyz/docs): protocol documentation — getting started, core concepts, architecture, and the security model
- [Source](https://github.com/Dmitrze/routon-protocol): open-source monorepo, dual-licensed MIT (contracts and SDKs) and CC0 (the Routon Standard)

## Chains

Routon runs across six chains: Base, Arbitrum, Ethereum, Optimism, Berachain, and Solana.