Welcome to Unicorn Docs

Unicorn Protocol is the most customisable, lowest-cost AMM ever deployed on Ethereum. This documentation covers everything from a 5-minute quickstart to deep-dives into Horn Hook architecture, contract interfaces, and SDK reference.

What makes Unicorn different?

• Horn Hooks — Inject arbitrary logic at 8 lifecycle points of every pool
• Singleton Pool Manager — All pools in one contract. Pool creation from ~$400 to ~$0.40
• Flash Accounting — EIP-1153 transient storage; settle all balances in one pass
• Native ETH — No WETH wrapping. Trade raw ETH, save ~21k gas per swap
• ERC-6909 Claims — Keep surplus tokens as receipts inside the Pool Manager
• Dynamic Fees — Hooks can update fees in real-time based on any on-chain signal

Quick Links

Quickstart

Install the Unicorn SDK and execute your first swap in under 5 minutes.

Install

npm install @unicorn-protocol/sdk
# or
forge install unicorn-protocol/v1-core

Execute a Swap

import { UnicornClient, Token } from '@unicorn-protocol/sdk';

const client = new UnicornClient({ chainId: 1 });

const route = await client.route({
  tokenIn:  Token.ETH,
  tokenOut: Token.from('0xCORN...'),
  amountIn: parseEther('1.0'),
  slippage: 0.5, // percent
});

const tx = await client.swap(route, signer);
console.log('Swap tx:', tx.hash);

Deployments

Unicorn v1 Pool Manager addresses across all supported chains.

Ethereum Mainnet (Chain ID: 1)

PoolManager:   0x1234...UNI1
Router:        0xAbCd...R0U7
CORN Token:    0xC0Rn...T0K3N
Governance:    0x9876...G0V1

Arbitrum (Chain ID: 42161)

PoolManager:   0x2345...UNI2
Router:        0xBcDe...R0U8

Base (Chain ID: 8453)

PoolManager:   0x3456...UNI3
Router:        0xCdEf...R0U9

Optimism (Chain ID: 10)

PoolManager:   0x4567...UNI4
Router:        0xDeF0...R0UA