Voting & Incentives
Managed Locks
A managed veNFT aggregates many normal veTOPAZ NFTs under a single voter. It exists so small holders can participate in fees and bribes without managing votes every week, and so DAOs and protocols can run professional veTOPAZ strategies on behalf of token holders.
The shape of a managed NFT
A managed NFT is a special veTOPAZ NFT minted by governance or a whitelisted manager. It's permanently locked by default — its voting power doesn't decay. Anyone can deposit their normal veTOPAZ NFT into it; the deposited NFT enters the lockedstate (read-only from the depositor's perspective) and its TOPAZ contributes to the managed NFT's aggregate voting weight.
The manager votes on behalf of the entire pool. Any fees and incentives the managed NFT earns get distributed pro-rata to the underlying depositors — net of any manager fee.
Who runs managed NFTs
- ✓Protocol-owned managed NFTs — run by the Topaz foundation or partner DAOs, typically with public, neutral voting strategies (e.g. 'always vote for the most-bribed pool').
- ✓Third-party manager NFTs — created by whitelisted managers (DeFi yield aggregators, voting cooperatives) with their own strategy and fee tier.
- ✓Allowed managers are explicitly listed and controlled by governance. A managed NFT can be deactivated by the Emergency Council if the manager misbehaves; deactivated NFTs cannot vote or accept new deposits, but existing depositors can still withdraw.
The list of currently-active managed NFTs is shown in the app when you view the lock page. Each manager surfaces their fee, historical APR, and voting strategy.
Depositing into a managed NFT
- 1Hold a normal (non-permanent) veTOPAZ NFT.
- 2Choose a managed NFT and review its strategy + fee tier.
- 3Call
depositManaged(tokenId, mTokenId)via the Voter contract (the app handles this for you). Your NFT transitions to the locked state. - 4From that point, the managed NFT votes with your weight, claims fees + bribes, and tracks your share of all rewards.
Withdrawing
- 1Wait until the epoch after your deposit (you can't withdraw in the same epoch you deposited).
- 2Call
withdrawManaged(tokenId)via the Voter contract. The app provides a UI. - 3Your NFT is restored to the normal state with your original TOPAZ amount, plus any compounded locked rewards. The lock end resets to the maximum (4 years from now), so you immediately regain full decaying voting power.
- 4Pending free rewards (anything the manager passed on as liquid tokens) are claimable via the standard Voter rewards flow.
Reward streams on a managed NFT
A managed NFT separates rewards into two streams:
- ✓Locked rewards. TOPAZ rebases and any TOPAZ-denominated rewards the manager compounds back into the underlying lock. These add to the underlying lock value but stay escrowed until you withdraw. Tracked by
LockedManagedReward. - ✓Free rewards. Anything the manager chooses to pass through as liquid (fees in stablecoins, bribe tokens, etc.). Distributed pro-rata and claimable via
FreeManagedRewardwhile your NFT is locked.
Use cases
- ✓Small holders who want fee + bribe income without active voting each week.
- ✓Treasury teams who want to delegate Topaz exposure to a trusted manager.
- ✓Yield aggregators offering Topaz veNFT vaults on top of the protocol.
- ✓Long-tail community pools that aggregate aligned community members behind a single voting strategy.
