Token Gate: Rewarding Your Holders with Extra Discounts
Debitum's Token Gate module lets bond creators configure tiered extra discounts for wallets that hold a minimum balance of a specified token or NFT. It's a simple but powerful tool for community-aligned token distributions.
How Token Gate Works
When creating a bond, you can optionally configure a Token Gate. The gate checks the buyer's wallet balance at the time of purchase:
- 1.Buyer initiates a bond purchase
- 2.The bond contract queries the Token Gate module
- 3.The gate checks which tier the buyer qualifies for (based on their balance)
- 4.If they qualify, an extra discount is added on top of the base bond discount
The check is entirely on-chain — no off-chain database, no snapshots, no manual whitelisting.
Configuring Tiers
A Token Gate supports multiple tiers. Each tier has:
- →Gate token — any ERC20 or ERC721 contract on the supported network
- →Minimum balance — threshold to qualify (e.g. 1,000 tokens, or 1 NFT)
- →Extra discount BPS — additional discount on top of the base bond discount
Tiers are evaluated from highest balance threshold to lowest. The buyer receives the highest discount tier they qualify for.
Example configuration:
| Tier | Required Balance | Extra Discount |
|---|---|---|
| Bronze | Hold 100+ $PROJECT | +3% |
| Silver | Hold 500+ $PROJECT | +7% |
| Gold | Hold 1,000+ $PROJECT | +12% |
A buyer holding 600 $PROJECT qualifies for Silver and gets the base discount + 7%.
Use Cases for Token Gate
Reward existing holders:
If your project already has circulating tokens, Token Gate lets you give existing holders preferential access to new bond allocations. This creates a direct incentive to hold rather than sell.
NFT community perks:
Configure the gate with your NFT collection. NFT holders get exclusive discounts — a way to make your collection more valuable beyond aesthetics.
Tiered investor access:
Large holders get bigger discounts, aligning the incentives of your most committed community members with the project's token distribution.
Partner protocol discounts:
Gate on a partner project's token. If you want to incentivize cross-protocol cooperation, offering discounts to holders of a partner's token creates mutual alignment.
Works with Any ERC20 or ERC721
The Token Gate module checks a standard balanceOf() call. This means it works with:
- →Any ERC20 token on any supported network
- →Any ERC721 NFT collection on any supported network
- →Wrapped tokens, LP tokens, governance tokens
There's no registration or whitelist required for the gate token. Any contract address with a balanceOf function works.
For Buyers: How to Qualify
If a bond has Token Gate enabled:
- 1.Hold the required token in your connected wallet at the time of purchase
- 2.The extra discount is automatically applied — no claim or proof required
- 3.The bond detail page shows the gate tiers so you know what to hold
Check the bond page before buying to see if you qualify for a better tier, and whether acquiring more of the gate token would unlock a higher discount.
Security Model
The Token Gate module is the only component in Debitum that retains an upgrade path — this is intentional. As new token standards emerge (ERC-1155, etc.), the gate logic may need to be extended. However:
- →The upgrade only affects the token gate check logic, not bond terms or vesting
- →Existing bonds are unaffected by any gate module upgrade
- →The vesting schedule and discount base rate are immutable regardless