# Ophis

> Ophis is an intent-based DEX aggregator across 13 EVM production deployments, including Robinhood Chain. You describe a swap in natural language ("swap 100 USDC for ETH on Base"), a network of solvers competes to fill it through batch auctions, and you sign the resulting order with your own wallet. Every supported chain charges a 1 bp Ophis base fee plus capped reference-quote-improvement capture: 80% on volatile pairs, capped at 99 bps of volume, or 50% on stable pairs, capped at 20 bps. CoW-hosted swaps also pay CoW Protocol's separate upstream fees (see https://docs.ophis.fi/fees). Ophis is a fork of CoW Protocol's frontend with an added natural-language intent-parsing layer; the full source is at github.com/ophis-fi/ophis.

## Core principles

- **Intent-based**, not router-based: users sign their *desired outcome*, solvers compete on *how* to deliver it.
- **MEV-aware batch execution**: signed intents are auctioned off-chain and settle on-chain; uniform clearing and solver competition reduce common sandwich-attack exposure without promising that every execution is immune to every form of MEV.
- **Self-custodial**: Ophis never holds funds. Every order is signed by the user's wallet (EIP-712 or ERC-1271).
- **Published all-chain pricing**: every supported chain uses a 1 bp base plus 80% of reference-quote improvement on volatile pairs (99 bps cap) or 50% on stable pairs (20 bps cap). On Ophis-operated chains the trader keeps the remainder and all improvement above Ophis's cap; hosted settlement additionally applies CoW Protocol's separate upstream policy.
- **Hosted-chain upstream pricing**: CoW-hosted swaps additionally pay CoW Protocol's separate upstream volume and price-improvement fees.
- **Open**: full frontend, intent-parser proxy, and infra runbooks are public.

## Routes

- [/](https://ophis.fi/): Landing, entry point, brand surfaces, language-first swap intent input.
- [/#/swap](https://swap.ophis.fi/#/swap): Trade, standard swap UI (token A → token B, instant fill via solver auction).
- [/#/limit](https://swap.ophis.fi/#/limit): Limit orders, sign-once orders that solvers fill when your target price is reachable.
- [/#/advanced](https://swap.ophis.fi/#/advanced): Advanced trading. TWAP / programmable order types.
- [/#/yield](https://swap.ophis.fi/#/yield): Yield, token-to-yield-bearing-token routes.
- [/#/about](https://swap.ophis.fi/#/about): About, what Ophis is and isn't.
- [/#/profile](https://swap.ophis.fi/#/profile): Profile, wallet identity read from your connected wallet (address, chain, ENS).
- [/#/learn](https://swap.ophis.fi/#/learn): Learn, primers on intents, solvers, MEV, batch auctions.
- [/#/affiliate](https://swap.ophis.fi/#/affiliate): Affiliate, mint a referral code and earn a share of the fee on referred volume.
- [https://docs.ophis.fi](https://docs.ophis.fi): Full docs, protocol overview, intent API spec, architecture, AI-agent integration guide, audits.
- [https://business.ophis.fi](https://business.ophis.fi): Business portal, integration playbook for institutional desks, custodians, and AI agents.

## APIs

- [POST /api/intent](https://ophis.fi/api/intent): Natural-language → structured `ParsedIntent`. Backed by LibertAI Qwen 3.6 27B; CF Pages Function proxies, browser never sees the LLM key. Rate-limited 30 req/min/IP. Response shape: `{ ok: true, data: { intent: 'swap'|'unknown', entities: [{type, value, raw, start, end}] } }` or `{ ok: false, error: { code, message } }` with codes `TIMEOUT | UPSTREAM | INVALID_JSON | BAD_INPUT | RATE_LIMITED | FORBIDDEN`. Browser calls are Origin-allowlisted (ophis.fi, swap.ophis.fi); non-browser callers (curl, server-side scripts, agents) that omit the Origin header are allowed, subject to the rate limit. Full spec: [/openapi.yaml](https://ophis.fi/openapi.yaml).

## For AI agents

Ophis is designed to be agent-friendly. The intent endpoint above accepts free-form natural language; the response is structured JSON your agent can map directly to a pre-filled swap URL. Recommended flow:

1. POST your user's request (or your agent-generated trade idea) to `/api/intent`.
2. Receive `ParsedIntent` with normalized `sellToken`, `buyToken`, `amount`, `chain` entities.
3. Construct a deep-link: `https://swap.ophis.fi/#/<chainId>/swap/<sellTokenSymbol>/<buyTokenSymbol>?inputCurrency=<amount>`.
4. Open the link for the user to review and sign. Ophis never auto-signs, every order requires explicit wallet approval.

Agents that submit orders programmatically should use `@ophis/sdk` or the Ophis MCP server so the orderbook URL and EIP-712 signing domain are resolved safely per chain. Ophis surfaces 13 EVM source/destination chains in the network selector: Ethereum, Arbitrum One, Avalanche, Base, BNB Smart Chain, Gnosis Chain, Ink, Linea, Optimism, Plasma, Polygon, Robinhood Chain, and Unichain, plus Sepolia for integration testing. CoW-hosted chain endpoints live at `api.cow.fi`; Ophis-operated deployments use `optimism-mainnet.ophis.fi`, `unichain-mainnet.ophis.fi`, and `robinhood-mainnet.ophis.fi`. All follow the same orderbook schema. See [Ophis AI agent integration](https://docs.ophis.fi/ai-agents) for the safe programmatic flow.

Ophis intentionally does NOT implement x402 (HTTP-native payments). The wallet-sign model is the trust boundary; bypassing it for payment automation would compromise self-custody.

## Trust, audits, custody

- **Custody**: Ophis is non-custodial. The protocol cannot move user funds without an EIP-712 signature from the user's wallet.
- **Smart contracts**: On the Ophis-operated networks Optimism (chain 10) and Unichain (chain 130), Ophis settles through its OWN GPv2Settlement deployments at non-canonical addresses; on Optimism that is `0x310784c7FCE12d578dA6f53460777bAc9718B859`, which is NOT CoW Protocol's canonical settlement address (`0x9008D19f58AAbD9eD0D60971565AA8510560ab41`). The bytecode is identical to CoW's audited GPv2Settlement, so the original audits apply: [github.com/cowprotocol/contracts/tree/main/docs](https://github.com/cowprotocol/contracts/tree/main/docs). Agents MUST resolve the per-chain settlement domain via the `@ophis/sdk` helpers or the MCP `list_chains` tool before signing; signing against CoW's canonical address on an Ophis-operated network yields a domain the deployed contract rejects.
- **Ophis-specific code**: Frontend fork, intent-parser CF Pages Function, rebate-indexer service. Source: [github.com/ophis-fi/ophis](https://github.com/ophis-fi/ophis).
- **Operator contact**: [/#/contact](https://swap.ophis.fi/#/contact) (form) or contact@ophis.fi.

## Optional

- [github.com/ophis-fi/ophis](https://github.com/ophis-fi/ophis): Full source code (frontend, intent proxy, indexer, infra runbooks).
- [github.com/cowprotocol/contracts](https://github.com/cowprotocol/contracts): Underlying settlement contracts. Ophis deploys bytecode-identical GPv2Settlement at its own non-canonical addresses on the Ophis-operated networks (Optimism, Unichain, Robinhood Chain); resolve the exact address via `@ophis/sdk` or the MCP `list_chains` tool.
- [docs.cow.fi/cow-protocol](https://docs.cow.fi/cow-protocol): CoW Protocol docs, the settlement primitives Ophis is built on.
- [Full docs text](https://docs.ophis.fi/llms-full.txt): the entire documentation concatenated into one file for LLM context windows.