Orion Protocol Documentation

Welcome to the Orion Protocol developer documentation. Orion is a decentralized, non-custodial cross-chain liquidity aggregator designed to combine decentralized exchange (DEX) liquidity into a unified trading execution pipeline.

Core Architecture

Orion combines an off-chain order routing engine with on-chain settlement contracts across Ethereum, BNB Chain, Polygon, Base, Arbitrum One, and Optimism.

Key Subsystems

• Aggregator Engine: Scans multi-pool tick distributions and pools across Uniswap V3, PancakeSwap, Curve, and Balancer to find the optimal trade path.
• Execution Router: Dispatches atomic swap instructions (`exactInputSingle` / `exactInput`) with dynamic slippage thresholds to eliminate MEV sandwich vulnerabilities.
• Airdrop & Verification Layer: Verifies confirmed on-chain transaction receipts using RPC providers to award leaderboard activity points without spoofing risk.

Quickstart: Executing a Swap via Viem

Integrate Orion's smart order router into your dApp using standard TypeScript/JavaScript Web3 libraries:

import { createWalletClient, custom, parseUnits } from 'viem';
import { mainnet } from 'viem/chains';

// 1. Initialize Client
const client = createWalletClient({
  chain: mainnet,
  transport: custom(window.ethereum)
});

// 2. Approve Token Spending
const ROUTER_ADDRESS = '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45';
const USDT_ADDRESS = '0xdac17f958d2ee523a2206206994597c13d831ec7';
const amountIn = parseUnits('100', 6);

// 3. Dispatch Swap Transaction with 0.5% Slippage Protection
const minOut = (expectedAmountOut * 995n) / 1000n; // 0.5% slippage

Official Router & Token Addresses

The following smart contracts power swap routing and liquidity discovery across supported networks:

Slippage & MEV Safety

Orion enforces a strict minimum received amount (`amountOutMinimum`) on every trade. By setting slippage limits based on live pool ticks, your trades are safeguarded against frontrunning, sandwich attacks, and volatile price impact.