# Empire Upgrade: Introducing V2 Contracts

> Overview of the Empire Builder V2 contract upgrade

**Published by:** [Empire Builder](https://paragraph.com/@empire_builder/)
**Published on:** 2025-05-19
**Categories:** empirebuilder, glanker, v2
**URL:** https://paragraph.com/@empire_builder/v2-contracts

## Content

Version 2 of the Smart Contracts that power the Empire treasury are now live on empirebuilder.world! Several new features, including onchain leaderboards (the biggest upgrade), individual token distributions, scheduled distribution and burn options, and updated default tokens are being introduced. The upgrade will also create greater onchain composability and allow token communities to incentivize participation and distribute value within their Empire’s in a more transparent and flexible way. Empire V2 Factory CA: 0x4fDB434838dcA8F48F97280570f08535Eb6155d5 Empire V2 Implementation CA: 0xC0198731A8a5b558caA7bfF4C19d20B318d9Bb41DiviFlyy on WarpcastOnchain Leaderboards are coming 👀 🏛️Farcaster1. Onchain Leaderboards: The most powerful aspect of the V2 Empire contracts is the onchain leaderboard implementation. Leaderboard data lives entirely on the blockchain, making it a public resource that other smart contracts can access, read, and build upon without special permission. With this composability, the following use cases (and more) become possible:Access Control Based on Leaderboard Position:A protocol could gate access to certain features based on a user's position in an Empire leaderboardFor example, only users in the top 100 of a leaderboard might be able to access premium community features.Cross-Protocol Rewards:Another protocol could distribute its own tokens to users based on their position in an Empire leaderboard on the smart contract level.This creates possibilities for cross-protocol incentive alignment directly onchain.Meta-Leaderboards:A contract could aggregate user scores across multiple Empire leaderboards to create composite rankings.This enables more complex incentive designs spanning multiple activity types.Weighted Governance:DAO governance contracts could weight votes based on a member's position or score in a contribution leaderboard.This creates a merit-based governance system tied to verifiable onchain activity.Dynamic NFT Properties:NFT contracts could update metadata or attributes based on the owner's leaderboard position.For example, an NFT might evolve or gain new visual features as its owner climbs a leaderboard.Whitelabel Solutions:The onchain leaderboard implementation also opens up an opportunity for Empire Builder whitelabel solutions. Each contract can support up to 50 leaderboards. A whitelabeled partner interface could be given access to update one or more of these leaderboards — allowing for their own dynamic leaderboard ecosystem. For example, a project like ProductClank can utilize the Empire Builder endpoints to generate leaderboards more suited to product founders, focusing on rewarding community marketing rather than just token holders.Custom Leaderboards:Empire Guardians will also be able to import or create custom leaderboards, maintaining their own branded leaderboards while leveraging Empire's infrastructure. A gaming platform could track player rankings, a DeFi protocol could measure liquidity provision, or a content platform could reward creator engagement — all using the same underlying leaderboard architecture.2. Individual Token Distributions:The second update is a heavily requested feature from the community — specifying which tokens to include in a distribution event. Rather than always distributing all tokens held by the contract, Guardians can now target specific tokens for distribution. When initiating a distribution, V2 contracts can accept an array of specific token addresses to distribute. If no specific tokens are provided, the system defaults to distributing all allowed tokens. The contract still validates that specified tokens are part of the allowed token list before proceeding with the distribution. This upgrade provides several key benefits:Strategic Distribution Planning: Communities can now plan more strategic token distributions, e.g., distributing a particular token for specific activities.Resource Optimization: By selecting specific tokens to distribute rather than distributing everything at once, Guardians can better control the flow of different token types within their ecosystem.Targeted Incentives: Different tokens can be used for different purposes or different leaderboards, allowing for more nuanced incentive mechanisms.3. Scheduled Distribution and Burn Options:V2 introduces the ability to set up future token distributions or burns that can only be executed after a certain time. The scheduled distributions will go to the leaderboard at the time of execution (not the time of scheduling). This enables several new use cases:Predictable Reward Cycles: Communities can establish regular, predictable reward distributions that are verifiable onchain.Long-term Planning: Token distribution strategies can be planned well in advance, allowing for more strategic community management and better participant expectations.Further Gamification: Guardians can run contests, introduce new boosters, or add additional leaderboards while the scheduled distribution is still yet to occur to help drive community participation (and volume to the token).4. Updated Default Tokens:Upon launching a new Empire, the following tokens will be automatically authorized in the treasury:WETH (Wrapped ETH): 0x4200000000000000000000000000000000000006USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913CLANKER: 0x1bc0c42215582d5A085795f4baDbaC3ff36d1BcbGLANKER: 0x33aC788bc9Ccb27e9ec558fb2bde79950A6b9d5BThe Empire's associated token (e.g., $dickbutt will be auto authorized for the DICKBUTT Empire)5. Additional MonetizationAll "Ascended" Empires (Empires for tokens not launched directly through Empire Builder or with @glanker bot) will have a 3% fee set to their distributions. "Forged" Empires (Empire-native tokens) will have a 0% fee. The fee is adjustable - active Ascended Empires can request for a fee reduction and eventually work their way down to 0%. Alternatively, bad actors and Empires trying to game the system will have their fee increase as a disincentivization measure.How to Upgrade Existing EmpiresAll current Empires can be upgraded to V2 contracts – it is not mandatory to upgrade, users are more than welcome to continue using the current contracts and the Empire Builder interface will continue to support all versions. If you do wish to upgrade, the process is currently manual (an upgrade interface will be added to empirebuilder.world in the coming weeks). To upgrade, you will need to:Distribute all funds out of your treasury - perform a 100% distribution before upgrading to ensure no funds are left behind.Make sure your Clanker rewards are set to ‘claim to wallet’ (not ‘claim to treasury’)Send a DM to @diviflyy on Farcaster or submit an upgrade request on the Empire Builder Discord (current manual upgrade system).After upgrading, refresh your leaderboard and re-authorize any tokens you wish to have in your treasury.ConclusionBy moving leaderboards fully onchain, enabling targeted token distributions, implementing scheduled operations, and streamlining token management, Empire has created a framework that's more interoperable with the broader Web3 ecosystem. The V2 upgrades provide the essential building blocks for sophisticated, transparent, and engagement-driven token economies. Follow @glankerempire on X or join the community on Farcaster and Discord to stay up to date with the latest Empire news!

## Publication Information

- [Empire Builder](https://paragraph.com/@empire_builder/): Publication homepage
- [All Posts](https://paragraph.com/@empire_builder/): More posts from this publication
- [RSS Feed](https://api.paragraph.com/blogs/rss/@empire_builder): Subscribe to updates

## Optional

- [Collect as NFT](https://paragraph.com/@empire_builder/v2-contracts): Support the author by collecting this post
- [View Collectors](https://paragraph.com/@empire_builder/v2-contracts/collectors): See who has collected this post