Skip to content

Contract Addresses

Complete reference of all FEY Protocol contracts deployed on Base Mainnet.

Base Mainnet (Chain ID: 8453)

Core Contracts

ContractAddressDescription
Factory (Fey.sol)0x8EEF0dC80ADf57908bB1be0236c2a72a7e379C2dMain factory for token deployments
FEY Token0xD09cf0982A32DD6856e12d6BF2F08A822eA5D91DNative protocol token (100B supply)
Hook (FeyHookStaticFeeV2)0x5B409184204b86f708d3aeBb3cad3F02835f68cCUniswap V4 hook for fee management

Supporting Infrastructure

ContractAddressDescription
LP Locker (FeyLpLockerMultiple)0x975aF6a738f502935AFE64633Ad3EA2A3eb3e7FaManages LP positions and rewards
Fee Locker (FeyFeeLocker)0xf739FC4094F3Df0a1Be08E2925b609F3C3Aa13c6Stores and distributes protocol fees
Pool Extension Allowlist0xFD549237CdEAbDc14438CAF3f3861e174fDEae46Controls approved pool extensions

Extensions

ExtensionAddressPurpose
FeyUniv4EthDevBuy0x173077c319c38bb08D4C4968014357fd518446b4ETH-based token purchases during deployment

MEV Protection

ContractAddressDescription
FeyMevNoop0x2ebc0fA629b268dFA3d455b67027d507a562EAC0No-op MEV module (template)

Key Addresses

RoleAddressPurpose
Team Fee Recipient0x72f5565Ab147105614ca4Eb83ecF15f751Fd8C50Receives protocol fees for distribution

Pool Information

Main Pool (FEY/WETH)

PropertyValue
Pool ID0xe155c517c53f078f4b443c99436e42c1b80fd2fb1b3508f431c46b8365e4f3f0
Currency0WETH (0x4200000000000000000000000000000000000006)
Currency1FEY (0xD09cf0982A32DD6856e12d6BF2F08A822eA5D91D)
Fee FlagDynamic (0x800000)
Tick Spacing200
HookFeyHookStaticFeeV2 (0x5B409184204b86f708d3aeBb3cad3F02835f68cC)

External Dependencies

Uniswap V4

ContractAddressDescription
Pool ManagerTBDUniswap V4 core pool manager
Position ManagerTBDUniswap V4 position manager

Permit2

ContractAddressDescription
Permit20x000000000022D473030F116dDEE9F6B43aC78BA3Universal approval interface

Base Infrastructure

ContractAddressDescription
WETH0x4200000000000000000000000000000000000006Wrapped ETH on Base
Superchain Token Bridge0x4200000000000000000000000000000000000010Cross-chain token bridge

Network Details

Base Mainnet

PropertyValue
Chain ID8453
RPC URLhttps://mainnet.base.org
ExplorerBaseScan
Native TokenETH
BridgeBase Bridge

Contract Verification

All contracts are verified on BaseScan with source code available:

Factory

FEY Token

Hook

Integration Examples

Web3 Configuration

// Base mainnet configuration
const baseConfig = {
  chainId: 8453,
  name: 'Base Mainnet',
  rpcUrl: 'https://mainnet.base.org',
  blockExplorer: 'https://basescan.org',
  contracts: {
    factory: '0x8EEF0dC80ADf57908bB1be0236c2a72a7e379C2d',
    feyToken: '0xD09cf0982A32DD6856e12d6BF2F08A822eA5D91D',
    hook: '0x5B409184204b86f708d3aeBb3cad3F02835f68cC',
    feeLocker: '0xf739FC4094F3Df0a1Be08E2925b609F3C3Aa13c6',
    lpLocker: '0x975aF6a738f502935AFE64633Ad3EA2A3eb3e7Fa',
  }
};

Contract Instances

import { ethers } from 'ethers';
 
// Provider setup
const provider = new ethers.JsonRpcProvider('https://mainnet.base.org');
 
// Contract instances
const factory = new ethers.Contract(
  '0x8EEF0dC80ADf57908bB1be0236c2a72a7e379C2d',
  factoryABI,
  provider
);
 
const feyToken = new ethers.Contract(
  '0xD09cf0982A32DD6856e12d6BF2F08A822eA5D91D',
  erc20ABI,
  provider
);
 
const hook = new ethers.Contract(
  '0x5B409184204b86f708d3aeBb3cad3F02835f68cC',
  hookABI,
  provider
);

Environment Variables

# Base mainnet configuration
export CHAIN_ID=8453
export RPC_URL="https://mainnet.base.org"
export FACTORY_ADDRESS="0x8EEF0dC80ADf57908bB1be0236c2a72a7e379C2d"
export FEY_TOKEN_ADDRESS="0xD09cf0982A32DD6856e12d6BF2F08A822eA5D91D"
export HOOK_ADDRESS="0x5B409184204b86f708d3aeBb3cad3F02835f68cC"
export FEE_LOCKER_ADDRESS="0xf739FC4094F3Df0a1Be08E2925b609F3C3Aa13c6"
export LP_LOCKER_ADDRESS="0x975aF6a738f502935AFE64633Ad3EA2A3eb3e7Fa"

Cast Commands

# Set environment for easier commands
export RPC="https://mainnet.base.org"
export FACTORY="0x8EEF0dC80ADf57908bB1be0236c2a72a7e379C2d"
export FEY="0xD09cf0982A32DD6856e12d6BF2F08A822eA5D91D"
 
# Quick status checks
cast call $FACTORY "deprecated()(bool)" --rpc-url $RPC
cast call $FEY "totalSupply()(uint256)" --rpc-url $RPC

Security Notes

Contract Immutability

Immutable Contracts:
  • Factory core logic (deployment functions)
  • Token contracts (ERC20 functionality)
  • Hook swap logic (fee collection)
Upgradeable Components:
  • System configuration (admin functions)
  • Module enablement (hooks, lockers, extensions)
  • Fee routing (can be frozen)

Admin Controls

Factory Owner:
  • Enable/disable system modules
  • Set system-wide configuration
  • Freeze critical parameters
Token Admins:
  • Update token metadata
  • Transfer admin role
  • Verify token authenticity

Access Patterns

Public Functions:
  • Token deployment (deployToken)
  • Fee claiming (claimWethFees, claimBaseTokenFees)
  • Reward collection (collectRewards)
Permissioned Functions:
  • System configuration (owner/admin only)
  • Module management (owner/admin only)
  • Critical parameter changes (owner only)

Related Documentation