ZIPsZoo Proposals
All Proposals
ZIP-0064

Zoo Contract Registry

Active
Type
Standards Track
Author
Zoo Labs Foundation
Created
2025-12-23

ZIP-100: Zoo Contract Registry

Abstract

This ZIP provides a comprehensive registry of all deployed contracts, token addresses, governance infrastructure, and DeFi protocols across the Zoo ecosystem. It serves as the canonical reference for Zoo mainnet (200200), Zoo testnet, and cross-chain bridge integrations.

Motivation

The Zoo ecosystem requires a single source of truth for:

  • Deployed contract addresses across all networks
  • Token registries for each network
  • Governance infrastructure (ZooGovernor, ZOO token)
  • Bridge tokens from Lux ↔ Zoo
  • AMM/DEX infrastructure
  • GameFi and NFT marketplace contracts

Network Configuration

Chain Details

ChainChain IDNative TokenRPCExplorer
Zoo Mainnet200200ZOOhttp://127.0.0.1:9630/ext/bc/zy5VXh7K.../rpcTBD
Zoo Testnet200201ZOOTBDTBD
Lux Mainnet96369LUXhttp://127.0.0.1:9630/ext/bc/C/rpcTBD

Genesis Parameters

chainId: 200200
blockTime: ~1s
finality: sub-second (Lux L2 rollup confirmation)
gasLimit: 8000000
gasPrice: 25000000000 (25 gwei)

Core Contracts

ZOO Token

Contract: ZOO.sol Location: ~/work/zoo/zoo/contracts/src/ZOO.sol

FeatureDescription
StandardERC20 with AccessControl, Pausable, Burnable
SymbolZOO
Decimals18
BlacklistAddress blacklisting via AccessControl role
Bridge IntegrationbridgeMint(), bridgeBurn() for cross-chain
AirdropBatch airdrop with one-time completion lock

Key Functions:

function configure(address _bridge) public onlyOwner;
function blacklistAddress(address _addr) public onlyOwner;
function bridgeMint(address to, uint256 value) external onlyBridge;
function bridgeBurn(address account, uint256 amount) external onlyBridge;
function airdrop(address[] memory addresses, uint256[] memory amounts) public onlyOwner;
function airdropDone() public onlyOwner; // Locks airdrop permanently

ZooGovernor

Contract: ZooGovernor.sol Location: ~/work/zoo/zoo/contracts/contracts/governance/ZooGovernor.sol Standard: OpenZeppelin Governor with extensions

ParameterValue
Voting Delay1 block
Voting Period50,400 blocks (~1 week)
Proposal Threshold1 ZOO
Quorum4%
TimelockTimelockController integration

Inheritance:

  • Governor
  • GovernorSettings
  • GovernorCountingSimple
  • GovernorVotes
  • GovernorVotesQuorumFraction
  • GovernorTimelockControl

ZooToken (Governance Token)

Contract: ZooToken.sol Location: ~/work/zoo/zoo/contracts/contracts/governance/ZooToken.sol Standard: ERC20Votes for on-chain governance

ZKStaking

Contract: ZKStaking.sol Location: ~/work/zoo/zoo/contracts/contracts/governance/ZKStaking.sol Purpose: Zero-knowledge staking mechanism for governance

DeFi Infrastructure

Uniswap V2 (AMM)

All contracts deployed via CREATE2 for deterministic addresses across chains:

ContractAddress
V2 Factory0xD173926A10A0C4eCd3A51B1422270b65Df0551c1
V2 Router0xAe2cf1E403aAFE6C05A5b8Ef63EB19ba591d8511

Source Files (in ~/work/zoo/zoo/contracts/src/uniswapv2/):

  • UniswapV2Factory.sol
  • UniswapV2Pair.sol
  • UniswapV2Router02.sol
  • UniswapV2ERC20.sol

Uniswap V3 (Concentrated Liquidity)

ContractAddress
V3 Factory0x80bBc7C4C7a59C899D1B37BC14539A22D5830a84
V3 Router0x939bC0Bca6F9B9c52E6e3AD8A3C590b5d9B9D10E
Quoter0x12e2B76FaF4dDA5a173a4532916bb6Bfa3645275
NonfungiblePositionManager0x7a4C48B9dae0b7c396569b34042fcA604150Ee28
TickLens0x57A22965AdA0e52D785A9Aa155beF423D573b879
Multicall0xd25F88CBdAe3c2CCA3Bb75FC4E723b44C0Ea362F

Token Registry: Zoo Mainnet (200200)

Core Bridged Tokens

TokenSymbolDecimalsAddress
Wrapped ZOOWZOO180x4888E4a2Ee0F03051c72D2BD3ACf755eD3498B3E
Zoo ETHZETH180x60E0a8167FC13dE89348978860466C9ceC24B9ba
Zoo USDZUSD180x848Cff46eb323f323b6Bbe1Df274E40793d7f2c2
Zoo BTCZBTC180x1E48D32a4F5e9f08DB9aE4959163300FaF8A6C8e
Zoo LUXZLUX180x5E5290f350352768bD2bfC59c2DA15DD04A7cB88
Zoo BNBZBNB180x6EdcF3645DeF09DB45050638c41157D8B9FEa1cf
Zoo POLZPOL180x28BfC5DD4B7E15659e41190983e5fE3df1132bB9
Zoo CELOZCELO180x3078847F879A33994cDa2Ec1540ca52b5E0eE2e5
Zoo FTMZFTM180x8B982132d639527E8a0eAAD385f97719af8f5e04
Zoo xDAIZXDAI180x7dfb3cBf7CF9c96fd56e3601FBA50AF45C731211
Zoo SOLZSOL180x26B40f650156C7EbF9e087Dd0dca181Fe87625B7
Zoo TONZTON180x3141b94b89691009b950c96e97Bff48e0C543E3C
Zoo ADAZADA180x8b34152832b8ab4a3274915675754AA61eC113F0
Zoo AVAXZAVAX180x0EE4602429bFCEf8aEB1012F448b23532f9855Bd
Zoo BLASTZBLAST180x7a56c769C50F2e73CFB70b401409Ad1F1a5000cd

Meme Tokens

TokenSymbolDecimalsAddress
Zoo BONKZBONK180x8a873ad8CfF8ba640D71274d33a85AB1B2d53b62
Zoo WIFZWIF180x4586D49f3a32c3BeCA2e09802e0aB1Da705B011D
Zoo PopcatZPOPCAT180x68Cd9b8Df6E86dA02ef030c2F1e5a3Ad6B6d747F
Zoo PNUTZPNUT180x0e4bD0DD67c15dECfBBBdbbE07FC9d51D737693D
Zoo MEWZMEW180x94f49D0F4C62bbE4238F4AaA9200287bea9F2976
Zoo BOMEZBOME180xEf770a556430259d1244F2A1384bd1A672cE9e7F
Zoo GIGAZGIGA180xBBd222BD7dADd241366e6c2CbD5979F678598A85
Zoo AI16ZZAI16Z180x273196F2018D61E31510D1Aa1e6644955880D122
Zoo FWOGZFWOG180xd8ab3C445d81D78E7DC2d60FeC24f8C7328feF2f
Zoo MOODENGZMOODENG180xe6cd610aD16C8Fe5BCeDFff7dAB2e3d461089261
Zoo PONKEZPONKE180xDF7740fCC9B244c192CfFF7b6553a3eEee0f4898
Zoo NOTZNOT180xdfCAdda48DbbA09f5678aE31734193F7CCA7f20d
Zoo DOGSZDOGS180x0b0FF795d0A1C162b44CdC35D8f4DCbC2b4B9170
Zoo MRBZMRB180x3FfA9267739C04554C1fe640F79651333A2040e1
Zoo REDOZREDO180x137747A15dE042Cd01fCB41a5F3C7391d932750B
SlogSLOG60xED15C23B27a69b5bd50B1eeF5B8f1C8D849462b7

NFT & GameFi Contracts

Core NFT Infrastructure

Located in ~/work/zoo/zoo/contracts/src/:

ContractPurpose
Media.solNFT media with content/metadata URIs
Market.solNFT marketplace with bid shares
Auction.solEnglish auction for NFTs
Drop.solNFT drops with egg/animal mechanics
DropEggs.solEgg drop mechanics
EGGDrop.solEgg airdrop functionality

GameFi Contracts

ContractPurpose
ZooKeeper.solGame logic manager
Farm.solYield farming with rewards
NFTStaking.solStake NFTs for rewards
Random.solOn-chain randomness
Savage.solGame mechanics

Zoo Interfaces (~/work/zoo/zoo/contracts/src/interfaces/)

InterfacePurpose
IZoo.solCore Zoo types (Token, Rarity, Parents, Breed, etc.)
IMedia.solMedia contract interface
IMarket.solMarket contract interface
IAuctionHouse.solAuction house interface
IDrop.solDrop interface
IKeeper.solZooKeeper interface
IVoting.solGovernance voting
IRewarder.solReward distribution

Bridge Infrastructure

Cross-Chain Bridge (Lux ↔ Zoo)

Architecture: MPC-signed bridge with ERC4626 vaults

Core Bridge Contract: Bridge.sol

  • MPC verification for cross-chain messages
  • Stealth mint/burn operations
  • Fee: 1% (100 basis points)
  • Treasury: 0x9011E888251AB053B7bD1cdB598Db4f9DEd94714

Zoo Bridge Token Contracts

Located in ~/work/lux/bridge/contracts/contracts/zoo/:

TokenContract
ZETHZETH.sol
ZUSDZUSD.sol
ZBTCZBTC.sol
ZLUXZLUX.sol
ZBNBZBNB.sol
ZPOLZPOL.sol
ZCELOZCELO.sol
ZFTMZFTM.sol
ZXDAIZXDAI.sol
ZSOLZSOL.sol
ZTONZTON.sol
ZAVAXZAVAX.sol
ZBLASTZBLAST.sol
ZADAZADA.sol
ZAI16ZZAI16Z.sol
ZBONKZBONK.sol
ZWIFZWIF.sol
ZPOPCATZPOPCAT.sol
ZPNUTZPNUT.sol
ZMEWZMEW.sol
ZBOMEZBOME.sol
ZGIGAZGIGA.sol
ZFWOGZFWOG.sol
ZMOODENGZMOODENG.sol
ZPONKEZPONKE.sol
ZNOTZNOT.sol
ZDOGSZDOGS.sol
SLOGSLOG.sol
TRUMPTRUMP.sol
MELANIAMELANIA.sol
CYRUSCYRUS.sol

Zoo Vault

Contract: ZooVault.sol Location: ~/work/lux/bridge/contracts/contracts/ZooVault.sol Standard: ERC4626 tokenized vault

Crowdfund / DAO Factory

Located in ~/work/zoo/zoo/contracts/src/crowdfund/:

ContractPurpose
ZooDAO.solDAO contract for crowdfund projects
DAOFactory.solFactory for creating project DAOs
CrowdfundProject.solIndividual crowdfund project
KeeperToken.solGovernance token for project donors

Deployment Scripts

Located in ~/work/zoo/zoo/contracts/deploy.backup/:

ScriptPurpose
00_token.tsZOO token deployment
01_faucet.tsFaucet deployment
02_weth.tsWETH deployment
05_v2factory.tsUniswap V2 Factory
06_v2router02.tsUniswap V2 Router
07_pair.tsLP pair creation
09_dao.tsDAO deployment
10_bridge.tsBridge deployment
11_market.tsNFT market deployment
12_media.tsMedia contract deployment
13_zookeeper.tsZooKeeper deployment
14_drop.tsDrop contract deployment
15_auction.tsAuction deployment
16_farm.tsFarm deployment
17_EggDrop.tsEgg drop deployment
20_crowdfund.tsCrowdfund deployment

Test Suite

Located in ~/work/zoo/zoo/contracts/test/:

TestCoverage
Auction.test.tsAuction mechanics
Bridge.test.tsCross-chain bridge
Drop.test.tsNFT drops
Farm.test.tsYield farming
Faucet.test.tsToken faucet
GoveranceToken.test.tsGovernance token
Market.test.tsNFT marketplace
Media.test.tsMedia contract
Random.test.tsRandomness
Savage.test.tsGame mechanics
ZOO.test.tsZOO token
ZooKeeper.test.tsZooKeeper
integration.test.tsEnd-to-end integration

Related ZIPs

ZIPTitle
ZIP-0Zoo Ecosystem Architecture & Framework
ZIP-1Hamiltonian LLMs for Zoo
ZIP-2Genesis Airdrop to Original ZOO Token Victims
ZIP-4Gaming Standards for Zoo Ecosystem
ZIP-5Post-Quantum Security for DeFi/NFTs
ZIP-6User-Owned AI Models on Zoo
ZIP-12LP Integration (Chain-Agnostic AI Standards)
ZIP-13LP Standards Conformance and Chain Interoperability
ZIP-14Zoo KMS Integration via Lux KMS

Solidity Compiler Configuration

From hardhat.config.ts:

VersionOptimizerRuns
0.4.24Enabled1000
0.6.12Enabled1000
0.8.4Enabled1000
0.8.20Enabled200

BNB Smart Chain Deployments (Legacy)

From contracts.v4.json - BNB mainnet (Chain ID: 56):

ContractAddress
BNB0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c
DAO0x85Bb05348905eDE5D6f91EC0F0B1e7957d978461
Drop0x6f918d5E359276A8A4120BC4Af89d0A8a044Fe48

Copyright

Copyright and related rights waived via CC0.

Document Maintainer: Zoo Labs Foundation Last Updated: 2025-12-23