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.

Managed locks, relays and xTOPAZ

Managed veTOPAZ locks and the relay interface are BNB features. Spokes use local xTOPAZ stake IDs, not managed NFTs, and their managed-lock call paths are unsupported.

The xTOPAZ vault holds one normal permanent aggregate NFT and issues fungible shares. A managed lock instead tracks deposited NFTs and its managed reward streams. Do not treat a relay deposit as an xTOPAZ mint or assume a manager’s historical returns apply to shares.

NFTs that have ever joined a relay are currently blocked from wrapping, including after withdrawal. Wrapping burns the source NFT, so unresolved historical relay payout rights must be preserved. Use a new eligible lock or deposit liquid TOPAZ instead. Get xTOPAZ.

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 locked state (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.

ℹWithdrawal preserves your TOPAZ
When you withdraw from a managed NFT, your normal veTOPAZ NFT is restored with its original TOPAZ amount, plus any locked rewards that were compounded into the managed NFT on your behalf. The lock end is set to the maximum (4 years from the withdraw timestamp), so your underlying lock duration is essentially reset whenever you exit.

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.

Active relays (managed NFTs) are listed on the Relays page. Each card shows the relay's strategy outcome (compounding or payout), its Relay APR and its locked TOPAZ.

Depositing into a managed NFT

  1. 1Hold an unexpired veTOPAZ NFT, decaying or permanent, that is not already in a relay.
  2. 2Choose a relay on the Relays page and review its strategy and Relay APR.
  3. 3Call depositManaged(tokenId, mTokenId) via the Voter contract (the app handles this for you). Your NFT transitions to the locked state.
  4. 4From that point, the managed NFT votes with your weight, claims fees + bribes, and tracks your share of all rewards.
⚠One epoch trade-off
Depositing into a managed NFT counts as your one allowed "vote" action for the epoch. You can't deposit and then vote your own NFT in the same week. The reverse is also true: voted NFTs cannot be deposited in the same epoch.

Withdrawing

  1. 1Wait until the epoch after your deposit (you can't withdraw in the same epoch you deposited).
  2. 2Call withdrawManaged(tokenId) via the Voter contract. The app provides a UI.
  3. 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.
  4. 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 FreeManagedReward while 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.

Continue reading

veTOPAZ Locks →

The full state machine — normal, permanent, locked, managed.

Gauge Voting →

What the managed NFT is actually doing on your behalf each epoch.

Incentives (Bribes) →

The income source that managers compete to capture.

Contracts →

VotingEscrow, Voter, and ManagedRewardsFactory addresses.