TopazTOPAZDocs

Protocol

Contracts

Every Topaz contract deployed on BNB Chain (chain ID 56). All addresses are immutable. Click any address to view the verified source on BscScan.

Core Token & ve(3,3)

The TOPAZ token, vote-escrow NFT, weekly emission engine, and the rewards plumbing that pays trading fees and bribes back to voters.

ContractAddress
Topaz (TOPAZ)
The protocol token. 500M initial supply, then weekly emissions per the schedule on the Tokenomics page.
0xdf002282C1474C9592780618Adda7EaA99998Abd
VotingEscrow (veTOPAZ)
Vote-escrowed NFT. Lock TOPAZ here to mint a veTOPAZ position with voting power.
0xe951aC65EFE86682311ab0d8995E7A58750c5eB3
Voter
Routes votes to gauges, distributes emissions, and aggregates fee + bribe claims.
0x2F80F810a114223AC69E34E84E735CaD515dAD67
Minter
Mints weekly TOPAZ emissions and rebases for veTOPAZ holders.
0x606794d37991A426a189fD9FA8664D339A77f8ae
RewardsDistributor
Distributes rebases to veTOPAZ holders each epoch.
0x85e15e7Ad4f20d5ca3A1104B1c2CcE72f5F683dB
VeArtProxy
Generates the on-chain art for veTOPAZ NFTs.
0x9612305fe63DFb84Da8f6d6261169F6B85026601

Governance

On-chain governance for protocol parameters and epoch-level changes. veTOPAZ holders vote here.

ContractAddress
ProtocolGovernor
Top-level governance for protocol parameter changes.
0xbBCdCd30066cF25708F4A0aB9d9149D32Ea4C401
EpochGovernor
Per-epoch governance: tail emission rate adjustments and similar epoch-scoped votes.
0xbae5585Afb875A45292470078aa4D4A261749084

AMM (v2-style)

Constant-product pools and the router that swaps through them. Used for stable and volatile pairs.

ContractAddress
Router
Multi-hop swap router for v2-style pools.
0x1E98c8226e7d452e1888e3d3d2F929346321c6c3
PoolFactory
Deploys new v2-style pools.
0x65E6cD0eF5D3467030103cf3d433034E570b5784
Pool (implementation)
Implementation contract cloned by PoolFactory for each new pair.
0xdC942D8e37cC20BCf9aD1Fe0111eE6c5908f3678

Slipstream (Concentrated Liquidity)

Concentrated-liquidity pools with dynamic and custom fee modules. NFT-based positions managed by the position manager.

ContractAddress
CLFactory
Deploys new concentrated-liquidity pools.
0x73DC984D9490286E735548f61dfCCec67Af82ed9
CLPool (implementation)
Implementation contract cloned for each concentrated pool.
0x18e68051d1b1fB44cb539cA4436F112D28577AF7
CLGauge (implementation)
Implementation contract cloned for each concentrated-pool gauge.
0xc2f777a2e9f54f195212a5a2d394399252958b97
CLGaugeFactory
Deploys gauges for concentrated-liquidity pools.
0xeD2ED418f104E18B1D11eA5C26236A1caa675839
NonfungiblePositionManager
Mints and manages the NFT that represents a concentrated-liquidity position.
0xf8c30c3C362941C23025f2eA30B066A73C982f63
SwapRouter
Multi-hop swap router for concentrated pools.
0x9B63CA87919617d042A89663492dB3c8686e0CaE
QuoterV2
Off-chain swap quoting for concentrated pools.
0x7CCB89bB9BdEF68688F39a2c22d249fD1D9759f1
MixedRouteQuoterV1
Quoter that supports mixed v2 + concentrated routes.
0x47c3570b90e7234FE695Ad5F1bE69E21fe1a9ee2
DynamicSwapFeeModule
Adjusts swap fees on concentrated pools based on price volatility vs TWAP.
0x656cf5d2f1A70177E011e2c27DeafBeE4C7B0541
CustomSwapFeeModule
Lets the fee manager set custom swap fee overrides per pool.
0xA0462a52af4f8cbF7766Efbba75355B30b6BCCe2
CustomUnstakedFeeModule
Custom fee overrides for liquidity that is not staked in a gauge.
0x3bad7F96cd1b51CE86e12C42541Ac7d559A78582

Factories & Infrastructure

Factory registry, gauge factories, and infrastructure used by the protocol but not typically called directly by users.

ContractAddress
FactoryRegistry
Registry of approved pool, gauge, and rewards factories.
0x268d1C8a538Ecf6628838C11d581e1EABD13D6A4
GaugeFactory
Deploys gauges for v2-style pools.
0xFc080D1EcD7c332022cebf942AEb62d5E1d4Cb08
VotingRewardsFactory
Deploys the fee and bribe vaults attached to each gauge.
0x4C303f7af7b8b05226440e4e12FF9a82F513716c
ManagedRewardsFactory
Deploys managed-veNFT reward contracts.
0xe4b23F13b24232C1E68AD0575191216152AA9480
Forwarder
EIP-2771 trusted forwarder for meta-transactions.
0xE79EB7c4D06ff38e6483921DE8e85A37eC7c731b

Airdrop

Distributes airdrop and sacrifice veTOPAZ to locked destination wallets at mainnet launch.

ContractAddress
AirdropDistributor
Distributes airdrop + sacrifice veTOPAZ to each wallet's locked BNB-Chain destination.
0x7B1d8745079C85af80Ff7A7eA7C2C4769Eab5348
Per-pool addresses live in the app
Topaz will host thousands of pools and gauges over time. The canonical list of every active pool and gauge — plus their fee tiers, TVL, and emission share — lives in the app at app.topazdex.com.