Contract Architecture

This page provides a technical overview of how the Coins protocol contracts work together to enable coin creation, trading, and automatic reward distribution.

Architecture Overview

Visual overview of how contracts work together in the Zora Coins system

Core Components

Coins Contracts

• Base implementation for all coin types
• Integrates with Uniswap V4 PoolManager
• Handles liquidity migration between hook versions
• Manages pool key and basic coin functionality

• One per creator, backed by ZORA tokens
• 1 billion total supply with 5-year vesting schedule
• 500M tokens vest to creator, 500M available for trading
• 1% trading fee split across creator, referrers, protocol, and LP

• Multiple per creator, backed by creator's coin
• 1 billion total supply with instant creator allocation
• 10M tokens to creator immediately, 990M available for trading
• 1% trading fee with the same reward split as Creator Coins

• Lightweight coins for trending topics and cultural moments
• 1 billion total supply, 100% allocated to liquidity pool
• No creator allocation, no payout recipient, no platform referrer
• 0.01% (1 bps) trading fee — 100x lower than Creator/Content Coins
• Sniper Tax: 99% fee at launch decaying to 0.01% over 10 seconds
• All fees go to protocol; no LP remint
• Unique, case-insensitive tickers enforced on-chain

Factory Contract

• Deploys new coins with deterministic addresses
• Supports custom pool configurations and post-deployment hooks
• Creates Uniswap V4 pools automatically with appropriate hook contracts
• Provides address prediction before deployment

Key functions:

• deploy() - General coin deployment with full customization
• deployCreatorCoin() - Simplified Creator Coin deployment
• deployTrendCoin() - Trend Coin deployment with unique ticker enforcement
• coinAddress() - Predict deployment address for Content/Creator Coins
• trendCoinAddress() - Predict deployment address for Trend Coins

Hook System

The protocol uses a unified hook architecture:

• Contains all shared hook functionality for both coin types
• Implements Uniswap V4 hook interface (afterSwap, afterInitialize)
• Handles pool initialization, fee collection, and currency conversion
• Supports migration to new hook versions while preserving liquidity

Core functionality:

• Collects trading fees from liquidity positions
• Splits fees between LP rewards and market rewards
• Converts fees to backing currency via multi-hop swaps
• Distributes rewards based on coin type via unified logic

History: Prior to v2.3.0 the protocol used two hooks (ContentCoinHook and CreatorCoinHook). This was consolidated into ZoraV4CoinHook for a single, unified implementation.