UnVaultDeveloper Docs
Launchpad and creators

Pools and DIVIT

Liquidity pools#

A pool is a contract, deployed through the pool factory and owned by the wallet that created it, that trades one collection's NFTs against deposited tokens.

ParameterValues
Pool typeBUY (holds tokens, buys NFTs), SELL (holds NFTs, sells them), TRADE (both)
CurveLINEAR or EXPONENTIAL delta applied after each trade
Spot priceStarting quote, in the deposited token
FeeBasis points retained by the pool for its owner on each trade, in addition to the 10% protocol swap fee on every swap into or out of the pool

Pool owners deposit and withdraw tokens and NFTs, collect fees, update the spot price, and transfer ownership in two steps (nominate, then the new owner accepts on-chain). Health indicators shown in the app are derived from indexed inventory, not from a contract status. No pool issues a liquidity token.

DIVIT#

DIVIT is a per-collection marketing-reward pool. There is no DIVIT token: "receiving a DIVIT" means receiving a reward paid out of the pool.

  • Funding. The collection owner decides what goes into the pool and when — a share of creator earnings routed from the royalty registry, other project income, or any other deposit — and configures how the pool is split between holder rewards, the creator, the protocol and, where enabled, the Minter's Bonus. Nothing flows in automatically unless the owner configures it.
  • Eligibility. Holding the collection's NFTs gives a wallet the opportunity to take part, subject to conditions the owner sets: minimum holding duration, non-listing status, or participation in licensing programmes.
  • Earning. Rewards are earned by posting about the collection on X and claiming through Unvault (post-to-claim); the post must carry the paid-advertising disclosure X requires. Rewards are weighted by how many of the collection's NFTs the poster holds.
  • Claiming. Holders claim on-chain with a backend-signed proof derived from the cycle snapshot; claim history is indexed per wallet across pools. US persons must provide the information needed for Form 1099 reporting before rewards are paid.

Events emitted: ROYALTY_RECEIVED, REWARDS_CLAIMED (holder claim), MINTERS_DIVIT_CLAIMED (Minter's Bonus claim), CREATOR_PAID, PROTOCOL_PAID.

Minter's Bonus#

A separate reward for the wallets that minted in the collection's drop. The project allocates whatever funds it chooses; Unvault distributes them to the minting wallets, excluding items a minter has listed for sale from that minter's calculation. The bonus is paid to the Genesis Bugz NFT tied to the profile the minter used when minting (each Bugz has its own token-bound account), so it follows the Bugz rather than the wallet.

Gacha cycles#

A collection may attach a DivitGacha contract. Eligible holders draw from a prize pool deposited by the collection, weighted by proofs published for the cycle. Draws execute on-chain; prizes are whatever the collection deposited.

Nothing about DIVIT is a guarantee of any distribution or value; rewards are marketing incentives, are not guaranteed, and can be zero. See Section 11 of the Terms of Service.

Markdown version: /pools-and-divit.md · llms.txt · Use of the APIs is governed by the Terms of Service, Section 21.