System Architecture

Omni.fun is a hub-and-spoke architecture with Base as the home chain and 7 remote chains connected via LayerZero V2 messaging and Across Protocol bridging. Every cross-chain operation ultimately settles on Base, where the bonding curves and Uniswap V3 pools live.

High-Level Topology

┌─────────────────────────────────────────────────────────┐
│                    BASE (Home Chain)                      │
│                                                           │
│  OmniLaunchFactory ──→ LaunchToken + BondingCurve        │
│  CCBuyerV3         ←── LZ _lzReceive() ← remote buys    │
│  CrossChainSellerV3 ←── LZ _lzReceive() ← remote sells  │
│  AcrossSellHandler ←── LZ lzCompose() ← OFT compose     │
│  CrossChainLauncher ←── LZ _lzReceive() ← remote launch │
│  OFTFactory        ──→ LZ messages to 6 OFTFactoryRemote│
│  OFTAdapter        ←→ OFT lock/unlock (per token)        │
│                                                           │
│  Uniswap V3 ← graduation pool + post-grad trading        │
│  FeeOnlyVault ← permanent LP lock (no admin, no keys)    │
└─────────────┬───────────────────────────────┬─────────────┘
              │ LayerZero V2                  │ Across Protocol
              │ (OApp + OFT)                  │ (USDC settlement)
              ▼                               ▼
┌──────────────────────────────────────────────────────────┐
│              REMOTE CHAINS (7 EVM + Solana)               │
│                                                            │
│  EVM (Ethereum, Arbitrum, Optimism, Polygon, BSC, Avax):  │
│    AcrossBuyAdapter    → Across USDC deposit → buy Base   │
│    NativeBuyAdapter    → swap native→USDC → Across → buy  │
│    AcrossSellAdapter   → OFT bridge + LZ compose → sell   │
│    OFTFactoryRemote    → receives LZ → CREATE2 OmniOFT   │
│    RemoteLauncher      → LZ message → deploy on Base      │
│    OmniOFT             → burn/mint (LZ OFT standard)      │
│                                                            │
│  Solana:                                                   │
│    CC Buyer Program    → LZ message → buy on Base          │
│    CC Seller Program   → LZ message → sell on Base         │
│    OFT Program         → SPL token bridging via LZ         │
│    Token Launcher      → LZ message → launch on Base       │
└──────────────────────────────────────────────────────────┘

LayerZero Integration Points

Omni.fun uses LayerZero V2 through four distinct integration patterns. Each one uses _lzReceive() or lzCompose() as the entry point on Base.

1. Cross-Chain Buy (LZ OApp)

A user on any remote chain initiates a buy. The adapter encodes the buy parameters and sends an LZ message to CCBuyerV3 on Base.

Remote Chain                          Base
┌──────────────┐    LayerZero V2    ┌─────────────────┐
│ CC Buyer     │ ──── lzSend ────→ │ CCBuyerV3       │
│ (EVM or Sol) │                    │ _lzReceive()    │
└──────────────┘                    │   ↓ buyFor()    │
                                    │   ↓ OFT send()  │──→ tokens bridge
                                    └─────────────────┘    back to buyer

Key detail: After buying tokens on the bonding curve, CCBuyerV3 automatically bridges tokens back to the buyer’s origin chain via OFT send(). The buyer receives tokens on their home chain — not on Base.

2. Cross-Chain Sell (LZ OApp + Across)

A user burns their OFT tokens on a remote chain. The LZ message triggers a sell on Base, and USDC returns via Across Protocol.

Remote Chain                          Base
┌──────────────┐    LayerZero V2    ┌─────────────────────┐
│ OFT burn()   │ ──── lzSend ────→ │ CrossChainSellerV3  │
│ + sell msg   │                    │ _lzReceive()        │
└──────────────┘                    │   ↓ sellFor()       │
                                    │   ↓ Across deposit  │──→ USDC returns
                                    └─────────────────────┘    to seller

Key detail: The seller auto-detects whether the token is still on the bonding curve or has graduated to Uniswap V3, and routes accordingly. No user intervention needed.

3. Cross-Chain Launch (LZ OApp)

A user on BSC, Ethereum, or Solana launches a token that deploys on Base.

Remote Chain                          Base
┌──────────────┐    LayerZero V2    ┌─────────────────────┐
│ RemoteLauncher│ ──── lzSend ────→ │ CrossChainLauncher  │
│ or Token     │                    │ _lzReceive()        │
│ Launcher(Sol)│                    │   ↓ factory         │
└──────────────┘                    │     .launchFor()    │
                                    └─────────────────────┘
                                      ↓ deploys Token + Curve

Key detail: The Solana Token Launcher ABI-encodes the launch parameters in an Anchor program and sends them via LZ. The CrossChainLauncher on Base decodes and calls the factory — enabling cross-VM token launches from Solana to EVM.

4. OFT Factory Deployment (LZ OApp)

A single Base transaction deploys an OFTAdapter locally and sends LZ messages to 6 remote OFTFactoryRemote contracts, each of which CREATE2-deploys an OmniOFT.

Base                                  Remote Chains (×6)
┌──────────────┐    LayerZero V2    ┌─────────────────────┐
│ OFTFactory   │ ──── 6× lzSend ──→│ OFTFactoryRemote    │
│ deployOFT()  │                    │ _lzReceive()        │
│  ↓ adapter   │                    │   ↓ CREATE2 deploy  │
│  ↓ set peers │                    │   ↓ set peers       │
│  ↓ options   │                    │   ↓ enforced opts   │
└──────────────┘                    └─────────────────────┘

Key detail: OFTFactory predicts all 6 remote OFT addresses using CREATE2 determinism before sending the messages. This allows it to set bidirectional peers on the adapter in the same transaction. Total cost: ~$1.60 in LZ fees for 6-chain deployment.

LZ Configuration

All Omni.fun OFT deployments use the following LayerZero V2 configuration:

Parameter	Value	Notes
LZ Endpoint V2	`0x1a44076050125825900e736c501f859c50fE728c`	Same on all EVM chains
ULN Confirmations	10	Increased from default 5 — required for cross-chain delivery
OFT Receive Gas	65,000	Enforced options on all OFT pairs
Message Type	1 (SEND)	Standard OFT send
Peer Format	`bytes32(uint256(uint160(address)))`	Left-padded for EVM, raw 32 bytes for Solana
Solana Endpoint	`76y77prsiCMvXMjuoZ5VRrhG5qYBrUMYTE5WgHqgjEn6`	LZ Endpoint on Solana

Cross-Chain Routing Summary

Action	Protocol Used	LZ Message Type	Settlement
Buy from EVM (Across path)	Across Protocol	None (Across intent)	Tokens on Base
Buy from EVM (CC Buy path)	LayerZero V2	`_lzReceive()` → OFT `send()`	Tokens on origin chain
Buy from Solana	LayerZero V2	`_lzReceive()` → OFT `send()`	Tokens on Solana
Buy with native currency	Across Protocol	None (swap + Across)	Tokens on Base
Sell from EVM (compose)	LayerZero V2	`lzCompose()` → Across	USDC on origin chain
Sell from EVM (LZ direct)	LayerZero V2	`_lzReceive()` → Across	USDC on origin chain
Sell from Solana	LayerZero V2	`_lzReceive()` → Across	USDC on Solana
Bridge OFT tokens	LayerZero V2	OFT `send()` / `lz_receive`	Tokens on destination
Launch from EVM	LayerZero V2	`_lzReceive()`	Token + Curve on Base
Launch from Solana	LayerZero V2	`_lzReceive()`	Token + Curve on Base
Deploy OFTs (6 chains)	LayerZero V2	6× `_lzReceive()`	OmniOFT on each chain

Every row with “LayerZero V2” generates LZ messages that flow through LayerZero’s DVN and executor infrastructure.

Overview

On-Chain Evidence

Integrations

Architecture

System Architecture

High-Level Topology

LayerZero Integration Points

1. Cross-Chain Buy (LZ OApp)

2. Cross-Chain Sell (LZ OApp + Across)

3. Cross-Chain Launch (LZ OApp)

4. OFT Factory Deployment (LZ OApp)

LZ Configuration

Cross-Chain Routing Summary

​System Architecture

​High-Level Topology

​LayerZero Integration Points

​1. Cross-Chain Buy (LZ OApp)

​2. Cross-Chain Sell (LZ OApp + Across)

​3. Cross-Chain Launch (LZ OApp)

​4. OFT Factory Deployment (LZ OApp)

​LZ Configuration

​Cross-Chain Routing Summary

System Architecture

High-Level Topology

LayerZero Integration Points

1. Cross-Chain Buy (LZ OApp)

2. Cross-Chain Sell (LZ OApp + Across)

3. Cross-Chain Launch (LZ OApp)

4. OFT Factory Deployment (LZ OApp)

LZ Configuration

Cross-Chain Routing Summary