Skip to content

wyeditthea/inferno

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

875 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Inferno $IFR

Inferno ($IFR)

The Deflationary Utility Token — Deployed on Ethereum Mainnet

Website · Documentation · X / Twitter · Etherscan

14 on-chain components | 578 tests | 91% branch coverage | 9 verified contracts + BootstrapVaultV3 + LP Pair + 3 upgrade deploys


What is Inferno?

Inferno (IFR) is a deflationary ERC-20 utility token on Ethereum. Every transfer burns 2.5% permanently, reducing total supply over time. Users lock IFR tokens on-chain to unlock lifetime premium access to builder products — no subscriptions, no recurring payments.

Community Fair Launch Model — No presale, no VC, no insider allocations.

Inferno Protocol is fully open source and community-owned. No single entity controls the protocol. All contracts are verified on Ethereum Mainnet, governed by a 48-hour timelock, and protected by Gnosis Safe multisig. The protocol lives on-chain — permanently.

Key Features

  • Deflationary: 2.5% burned per transfer (2% sender + 0.5% recipient). 1% pool fee. Hard cap: 5% max.
  • Utility Lock: Lock IFR → lifetime premium access across builder products → unlock anytime.
  • Timelock Governance: 48-hour delay on all changes. Guardian cancel. No instant admin access.
  • No Mint Function: Supply can only decrease, never increase.
  • Fair Launch: No presale, no VC. Transparent allocation from day one.

Token Allocation

Allocation Share Amount Note
DEX Liquidity 40% 400M IFR Held by deployer. Paired on Uniswap V2 via BootstrapVaultV3.finalise() after Bootstrap completion.
Liquidity Reserve 20% 200M IFR Smart-contract-locked until 01.09.2026. Phase 2 LP expansion. NOT used for Bootstrap.
Team Vesting 15% 150M IFR 12-month cliff, 36-month linear vesting. 0 tokens available before March 2027.
Treasury 15% 150M IFR Gnosis Safe multisig (0x5ad6193...). Funds Bootstrap via Plan B (~144.75M to vault).
Community & Grants 6% 60M IFR Community Safe (57.9M received after burn). 50M → Bootstrap. ~7.9M operational reserve.
Builder Ecosystem 4% 40M IFR PartnerVault contract. Lock-triggered Creator Rewards, milestone vesting.

BuybackVault and BurnReserve accumulate from the 1% protocol pool fee — not pre-funded genesis allocations. Team tokens: 48-month vesting, 12-month cliff. Liquidity reserve: locked until 01.09.2026.

Fair Launch

No presale, no VC, no IDO. Direct Uniswap V2 listing. Team allocation (15%) is locked in a vesting contract for 4 years with a 1-year cliff. See Fair Launch Statement.

Smart Contracts (Ethereum Mainnet)

Contract Mainnet Address
InfernoToken 0x77e99917Eca8539c62F509ED1193ac36580A6e7B
Governance 0xc43d48E7FDA576C5022d0670B652A622E8caD041
IFRLock 0x769928aBDfc949D0718d8766a1C2d7dBb63954Eb
BurnReserve 0xaA1496133B6c274190A2113410B501C5802b6fCF
BuybackVault 0x670D293e3D65f96171c10DdC8d88B96b0570F812
PartnerVault 0xc6eb7714bCb035ebc2D4d9ba7B3762ef7B9d4F7D
FeeRouterV1 0x4807B77B2E25cD055DA42B09BA4d0aF9e580C60a
Vesting 0x2694Bc84e8D5251E9E4Ecd4B2Ae3f866d6106271
LiquidityReserve 0xdc0309804803b3A105154f6073061E3185018f64
BootstrapVaultV3 0xf72565C4cDB9575c9D3aEE6B9AE3fDBd7F56e141 [ACTIVE]
BootstrapVault V1 0xA820540936d18e1377C39dd9445E5b36F3F1261a [DEPRECATED]

Gnosis Safe (Mainnet)

Role Address
Treasury Multisig 0x5ad6193eD6E1e31ed10977E73e3B609AcBfEcE3b

Threshold: 3-of-5 (5 active signers: A.K., M.G., A.M., Y.K., A.P.).

Builder Ecosystem

Lock-triggered Creator Rewards: when users lock IFR for a builder's product, the builder earns a percentage from the 40M Builder Ecosystem Pool.

  • Hard bounds (contract): 5-25%
  • Policy target: 10-20%
  • Annual emission: default 4M IFR (bounds: 1-10M IFR)
  • Vesting: 6-12 months
  • Authorized caller whitelist for automated reward recording
  • Anti-double-count: each wallet can only be rewarded once per builder
  • Algorithmic emission throttle: reward rate scales down as more IFR is locked (1% → 50% lock ratio)

Token holdings grant future DAO voting rights.

The ecosystem is open and permissionless. Any product can integrate IFR Lock.

Integration Guide →

Testing & Security

578 tests — all passing

Protocol Tests — 521

Suite Count Framework
Smart Contracts 367 Hardhat/Mocha
BuilderRegistry 27 Hardhat
App Backend 77 Mocha
Bootstrap Suite 50 Hardhat

Ecosystem Tests — 57

Suite Count Framework
Wallet Verification + OnChain 23 Mocha
Vote Announcements 12 Mocha
Bot Announcements 10 Mocha
Browser / WalletConnect 12 Playwright
  • Branch coverage: 91% (99% statements)
  • GitHub Actions CI: Creator Gateway, Points Backend, AI Copilot
  • Slither security audit: 0 high/critical findings
  • Internal security audit: 0 FAIL, 20 WARN (1 fixed), 81 PASS (full report)
  • App security review: 12 findings (2 CRITICAL, 5 HIGH — all fixed) (full report)
  • Bootstrap security review (13.03.2026): BootstrapVaultV3 + InfernoToken + FeeRouterV1 + Governance — 11/14 secure, 3/14 low risk, 0 critical (full report)
  • Full Sepolia testnet deployment with verified contracts
  • Governance lifecycle tested: propose → 48h wait → execute

Community Audit

All smart contracts are open source and community review is explicitly encouraged.

Applications

App Path Port Stack
Token Dashboard apps/dashboard/ 5173 React 18 + Vite + ethers v5
Governance Dashboard apps/governance-dashboard/ 5174 React 18 + Vite + TypeScript + Tailwind + ethers v5
AI Copilot apps/ai-copilot/ 5175 React 18 + Vite + TypeScript + Tailwind + Express
Points Backend apps/points-backend/ 3004 Express + Prisma + SQLite + ethers v5 + siwe + jose
Creator Gateway apps/creator-gateway/ 3005 Express + ethers v5 + googleapis + JWT
Benefits Network Backend apps/benefits-network/backend/ 3001 Express + Prisma + SQLite + ethers v5
Benefits Network Frontend apps/benefits-network/frontend/ 3000 Next.js 14 + Tailwind + wagmi v2 (PWA)
Telegram Bot apps/telegram/telegram-bot/ Telegraf + Railway (16 commands, moderation, governance notifier)

Token Dashboard

Token dashboard for monitoring balances, transfers, lock management, and contract status.

Start: cd apps/dashboard && npm install && npm run devhttp://localhost:5173

Benefits Network

The IFR Benefits Network lets any business verify on-chain IFR lock status to grant discounts and premium access. QR-based flow — no accounts, no subscriptions.

Routes: /b/:businessId (merchant console) · /r/:sessionId (customer verification)

Governance Dashboard

Read-only governance dashboard for monitoring PartnerVault, proposals, and generating calldata.

Tabs: Overview · Builders · Timelock Queue · Calldata Generator

Start: cd apps/governance-dashboard && npm run devhttp://localhost:5174

AI Copilot

Embedded chat widget with RAG knowledge base — helps users, builders, and developers understand IFR.

Modes: Customer · Builder · Developer

Safety: Automatic seed phrase / private key detection, instant warnings, source citation tags.

Start: cd apps/ai-copilot && npm install && cp .env.example .env && npm run devhttp://localhost:5175

Points Backend

SIWE authentication, points tracking, and EIP-712 signed voucher issuance for protocol fee discounts.

IFR Points are not a token — no transfer value, no monetary promise. Points only reduce the protocol fee on a single swap (via EIP-712 discount voucher).

Endpoints: /auth/siwe/* (SIWE auth) · /points/* (events + balance) · /voucher/issue (EIP-712 voucher)

Anti-Sybil: Rate limiting per IP + per wallet + global daily caps.

Start: cd apps/points-backend && npm install && npx prisma migrate dev --name init && npm run devhttp://localhost:3004

Documentation

Development

Hardhat Admin Tasks

# Sepolia (historical/testing) — use --network mainnet for production
npx hardhat lock-check --wallet 0x... --network sepolia
npx hardhat vault-status --network sepolia
npx hardhat feerouter-status --network sepolia
npx hardhat token-stats --network sepolia
npx hardhat gov-queue --network sepolia

Mainnet Preparation Scripts

# Mainnet deploy — DRY RUN (all 9 contracts, 12 steps)
npx hardhat run scripts/deploy-mainnet.js --network hardhat

# Mainnet deploy — LIVE (requires env vars: TREASURY_ADDRESS, COMMUNITY_ADDRESS, TEAM_BENEFICIARY, VOUCHER_SIGNER_ADDRESS)
npx hardhat run scripts/deploy-mainnet.js --network mainnet

# On-chain audit (8 checks) — use --network mainnet for production
npx hardhat run scripts/onchain-audit.js --network sepolia

# Propose ownership transfer (historical/testing)
npx hardhat run scripts/propose-ownership-transfer.js --network sepolia

# Execute ownership transfer (after 48h timelock, historical/testing)
PROP_RESERVE=4 PROP_BUYBACK=5 PROP_BURN=6 npx hardhat run scripts/execute-ownership-transfer.js --network sepolia

# Burn LP tokens (historical/testing)
npx hardhat run scripts/burn-lp-tokens.js --network sepolia

# Governance: set poolFeeReceiver to FeeRouterV1 (Proposal #6)
npx hardhat run scripts/propose-set-pool-fee-receiver.js --network mainnet

License

© 2026 Inferno Protocol. All rights reserved.

About

Deflationary ERC-20 utility token with on-chain lock mechanism

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • JavaScript 65.9%
  • TypeScript 21.9%
  • Solidity 10.3%
  • CSS 1.3%
  • Shell 0.4%
  • HTML 0.2%