Skip to content

Forgemint111/forgemint

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Forgemint

Tiered inscriptions + forge mechanic + fee-reroute on Base.

Live: forgemint.fun · Chain: Base mainnet (8453)


What it is

Forgemint is a fully on-chain inscription protocol on Base. Each inscription is a tier-weighted ERC721 NFT minted through a linear bonding curve. After the mint phase completes, the protocol activates — pairing collected ETH with a newly-minted ERC20 (FORGE) into a Uniswap V3 LP. Inscription holders earn pro-rata pool rewards forever based on their inscription weight.

Three twists differentiate it from a vanilla inscription drop:

  1. Tiered Rarity — Mint order determines tier:

    • #1–100MYTHIC (weight 10×)
    • #101–1000LEGENDARY (weight 3×)
    • #1001–21000COMMON (weight 1×)
  2. Forge Mechanic — Burn 3 inscriptions of the same tier to mint 1 of the next tier with a +33% bonus on combined weight.

  3. Fee Reroute — After activation, Uniswap V3 LP fees flow back to the rewards accumulator and are distributed pro-rata to inscription holders forever.


Mainnet addresses

Contract Address
ForgeInscription 0xE7739dFB8EfBca60D025d26E1900dD0e1B47E768
ForgeActivator 0x719dA3D228dB3265739e3C41D6C5c5082C6Dd9b8
ForgeToken (FORGE) 0x2Ef98aa4fa83aec56f803Ff88FAFbd2b09a50C21

All contracts verified on BaseScan.


Repo layout

forgemint/
├── contracts/     # Foundry — Solidity contracts + tests + deploy scripts
└── web/           # Next.js 16 frontend (static export → Cloudflare Pages)

Contracts (contracts/)

  • src/ForgeInscription.sol — ERC721 inscription + bonding curve + tier logic + forge + on-chain SVG
  • src/ForgeActivator.sol — Rewards accumulator (MasterChef-style debt snapshots)
  • src/ForgeToken.sol — ERC20 FORGE (one-shot mint controlled by activator)
  • script/Deploy.s.sol — Single-command mainnet deploy script
  • test/ — 44 unit tests, full coverage

Run tests:

cd contracts
forge test

Deploy:

cd contracts
PRIVATE_KEY=0x... START_MINT=true forge script script/Deploy.s.sol \
  --rpc-url https://mainnet.base.org --broadcast --verify \
  --etherscan-api-key $BASESCAN_API_KEY -vvv

Frontend (web/)

  • Next.js 16 + React 19 + Tailwind CSS v4
  • Wagmi v2 + RainbowKit + Viem
  • Static export → Cloudflare Pages

Dev:

cd web
pnpm install
pnpm dev

Build:

cd web
pnpm build --webpack    # produces ./out/ for static hosting

Bonding curve

price(n) = MIN_PRICE + (MAX_PRICE - MIN_PRICE) × n / MAX_SUPPLY
        = 0.0005 + 0.00475 × n / 21000  (ETH)
  • Min price: 0.0005 Ξ (slot #1)
  • Max price: 0.005 Ξ (slot #21,000)
  • Max per tx: 50
  • Max supply: 21,000

License

MIT

About

Forgemint Protocol — Tiered inscriptions, three-into-one forge mechanic, and lifetime LP fee rewards on Base.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors