A modular, controller-driven, mutable NFT standard built for the B Side ecosystem on Berachain.
comB NFTs represent honeycomb fragments containing 1–7 Bcells, and evolve on-chain through forging, merging, and burning. The protocol enables an upgradable, deflationary, multiplier-based NFT system without redeploying the core NFT.
This repository includes the immutable comB NFT contract, its configurable Controller, deployment scripts, and a full testing suite.
The comB NFT functions as an upgradeable multiplier for staking, rewards, and ecosystem mechanics.
Its state evolves through strictly validated transitions:
- Forge increases Bcells
- Merge combines two 3-Bcell comBs into one 6-Bcell comB
- Burn Bcell reduces Bcells; NFT is destroyed at 0
- No economic rules inside comB
- Upgradeable controller manages all cost, treasury, and future Proof-of-Liquidity rules
- The NFT logic is secure and unchanging
- Economic rules can evolve without redeploying comB
- Marketplaces automatically re-index metadata changes via ERC-4906
- Future features such as Vase Finance LP logic or Booga PoL multipliers can be added through the controller
cost = baseCost × currentBcellCount
- Two 3-Bcell comBs → one 6-Bcell comB
- One NFT burned
- Flat 15 HONEY cost
- Free
- If Bcells reach 0 → NFT burned permanently
tokenURI(id) = baseURI + "comb_.json"
{
"name": "comB (3 Bcells)",
"description": "A humble comB containing three Bcells. In Botanica it can be filled further with honey.",
"image": "ipfs://<CID>/comb_3_poster.jpg",
"animation_url": "ipfs://<CID>/comb_3.mp4",
"attributes": [{ "trait_type": "Bcells", "value": 3 }]
}contracts/ scripts/ test/ README.md
npm install
npx hardhat test
npx hardhat console
Env variables and deployment script included.
MIT