Wallet & Contract Guide
Every wallet and smart contract in the IFR ecosystem — explained. From genesis to Phase 4.
8
Wallets
12
Contracts
7
Upcoming
3-of-5
Multisig
👛 Project Wallets
All 7 wallets that hold or interact with IFR tokens. Active wallets manage protocol operations; historical wallets were used during migration to multisig infrastructure.
🚀 Deployer EOA
Transferred
Genesis Balance: 1,000,000,000 IFR (100% — then distributed)
Current Balance: 0 IFR — 400.6M transferred to LP Reserve Safe on 18.03.2026 (TX)
Ecosystem Role: Genesis deployer. Received all 1B IFR at deploy, distributed to all protocol wallets and contracts. LP reserve (400.6M) transferred to LP Reserve Safe (Gnosis 3-of-5) on 18.03.2026. Former Governance Owner — ownership transferred to TreasurySafe 3-of-5 on 20.03.2026.
Access Control: EOA — former Governance Owner (transferred to TreasurySafe 3-of-5 on 20.03.2026)
feeExempt: ✅ Active since 18.03.2026
💰 IFR LP Reserve Safe
Multisig 3-of-5
Balance: 400,600,000 IFR
Current Role: LP Reserve for Phase 2 (100M) + Phase 3 (150M) Uniswap expansion. Received from Deployer on 18.03.2026.
Ecosystem Role: Holds the full DEX liquidity reserve under multisig control. Phase 2: 100M IFR for Uniswap LP expansion (after 01.09.2026 LiqRes unlock). Phase 3: 150M IFR for additional LP depth. All transfers require 3-of-5 multisig approval.
Access Control: Gnosis Safe — 3-of-5 (same signers as Treasury + Community)
🏛️ Treasury Safe
Multisig 3-of-5
Genesis Balance: 150,000,000 IFR (15%)
Current Role: Protocol treasury. Funded Bootstrap Plan B (144.75M IFR). Current balance: 0 IFR (all funds deployed to Bootstrap + operations).
Ecosystem Role: Controls protocol development spend AND Governance ownership (since 20.03.2026). All transactions require 3-of-5 multisig approval.
Access Control: Gnosis Safe — 3-of-5 (A.K./M.G./A.M./Y.K./A.P.) active since 15.03.2026
feeExempt: ✅ Active since 18.03.2026
👥 Community Safe
Multisig 3-of-5
Genesis Balance: 57,900,000 IFR (received after 2.1M burn)
Current Role: 50M sent to Bootstrap Plan B. ~7.9M permanent Community Operations Reserve.
Ecosystem Role: Bug bounties, grants, ecosystem incentives, DAO seed funding. All spends publicly announced.
Access Control: Gnosis Safe — 3-of-5 active
feeExempt: ✅ Active since 18.03.2026
⏳ Team Beneficiary
Vesting — Locked
Genesis Balance: 0 IFR (receives from Vesting Contract)
Current Role: Designated beneficiary of the Vesting Contract. Core Developer acting as trustee for entire team allocation (150M IFR).
Ecosystem Role: Cannot claim until March 2027 (cliff). Then ~4.17M IFR/month linear over 36 months. Planned: migrate to Gnosis Safe after cliff.
Access Control: Single EOA — immutable in Vesting Contract
✍️ Voucher Signer
Backend Signer
Genesis Balance: 0 IFR
Current Role: Signs EIP-712 vouchers for FeeRouterV1 fee discounts. Backend-only — never holds IFR.
Ecosystem Role: Points system backend generates vouchers signed by this wallet. Users redeem on-chain via FeeRouterV1 for fee discounts. Rotatable via Governance.
Access Control: EOA — Backend wallet (not multisig)
📦 Community EOA (Historical)
Migrated
Genesis Balance: 60,000,000 IFR
History: Interim wallet before Community Safe deployment. Migrated 07.03.2026: sent 60M IFR, received 57.9M (2.1M permanently burned — EOA was not feeExempt).
Current Role: Inactive — 0 IFR. Historical only.
Access Control: EOA — no longer in use
📦 Treasury EOA (Historical)
Migrated
Genesis Balance: 150,000,000 IFR
History: Interim wallet before Treasury Safe deployment. Migrated 07.03.2026: sent 150M, received 150M (feeExempt transfer — zero burn).
Current Role: Inactive — 0 IFR. Historical only.
Access Control: EOA — no longer in use
⛓ Smart Contracts
All 12 deployed contracts on Ethereum Mainnet. Every contract is open source and verified on Etherscan.
🔥 InfernoToken
Core Token
Owner: Governance (Timelock)
feeExempt: ✅ Self (yes)
Function: The deflationary ERC-20 token. Every transfer applies 3.5% fee: 2% sender burn + 0.5% recipient burn + 1% to FeeRouterV1. No mint function — supply decreases permanently.
Phase: Active since 05.03.2026
⚖️ Governance
Timelock Controller
Owner: TreasurySafe 3-of-5 (transferred 20.03.2026 — TX)
feeExempt: ✅ Yes
Function: 48-hour timelock for all protocol changes. No parameter change can take effect instantly. Guardian can emergency-cancel any pending proposal.
Proposals: #0–#9 executed | #10 cancelled (ownership transferred directly 20.03.2026)
Phase: Active — controls all protocol parameters
🔒 IFRLock
Access Gate
Owner: Guardian = Deployer (pause-only)
feeExempt: ✅ Yes
Function: Users lock IFR here to gain lifetime premium access. Any builder product can query
isLocked() to verify access. No admin can touch user funds.
Phase: Active — gateway to all premium features
🚀 BootstrapVaultV3
LIVE
Owner: Permissionless (no admin)
feeExempt: ✅ Yes (since Proposal #4)
Function: Community price discovery. Holds 200M IFR. Contributors send 0.01–2 ETH. After June 5, 2026: anyone calls
finalise() to create Uniswap V2 LP. LP locked 12 months.
Phase: LIVE since 07.03.2026 — ends 05.06.2026
💧 LiquidityReserve
Time-Locked
Owner: Governance
feeExempt: ✅ Yes
Function: Holds 200M IFR for Phase 2/3 LP expansion. Hard-locked until 01.09.2026. Cannot be accessed before that date by anyone — including the team.
Phase: Locked — unlocks 01.09.2026
⏳ Vesting
Cliff Active
Owner: Guardian = Deployer (pause-only)
feeExempt: ✅ Yes
Function: Team allocation locked 4 years. 12-month cliff (no release before March 2027), then linear over 36 months until March 2030.
Balance: 150,000,000 IFR
Phase: Cliff active — first release March 2027
🏗️ PartnerVault
Builder Rewards
Owner: Governance
feeExempt: ✅ Yes
Function: 40M IFR — Governance-locked. Cannot be withdrawn directly by anyone.
How it works:
→ User locks IFR for a Builder product
→ Vault automatically releases % as Builder reward
→ Reward vests linearly over 6–12 months (annual cap: 4M IFR)
→ If no users lock IFR → 40M stay locked forever
All parameters controlled by Governance (48h timelock).
How it works:
→ User locks IFR for a Builder product
→ Vault automatically releases % as Builder reward
→ Reward vests linearly over 6–12 months (annual cap: 4M IFR)
→ If no users lock IFR → 40M stay locked forever
All parameters controlled by Governance (48h timelock).
Balance: 40,000,000 IFR
Phase: Active
🔀 FeeRouterV1
Fee Accumulator
Owner: Governance
feeExempt: ✅ Yes
Function: Receives 1% pool fee from every IFR transfer. Accumulates fees — NO automatic distribution. Phase 3: BuybackController will route accumulated fees.
Phase: Accumulating
♻️ BuybackVault
Phase 3
Owner: Governance
feeExempt: ✅ Yes
Function: Will receive IFR from FeeRouterV1 via BuybackController (Phase 3). Auto-refills PartnerVault when below 85% threshold (34M IFR). 70% Operating Pool + 30% SOS Reserve.
Balance: 0 IFR
Phase: Inactive — activates Phase 3
🔥 BurnReserve
Permanent Burns
Owner: Governance
feeExempt: ✅ Yes
Function: Permanent burn pool. Burns IFR forever via
burn(). Accumulates from protocol fee share (Phase 3).
Balance: 0 IFR
Phase: Inactive — activates Phase 3
🏛️ Treasury Safe (Gnosis)
Multisig 3-of-5
Note: Same address as Wallet 2 — this is both a wallet AND a smart contract (Gnosis Safe).
Function: Controls Treasury funds AND Governance (owner since 20.03.2026). Requires 3-of-5 signatures.
feeExempt: ✅ Active since 18.03.2026
👥 Community Safe (Gnosis)
Multisig 3-of-5
Function: Gnosis Safe multisig for community funds. 7.9M IFR permanent reserve for grants/bounties/DAO.
feeExempt: ✅ Active since 18.03.2026
🔮 Upcoming Contracts
Contracts planned for Phase 2–4. Not yet deployed to Ethereum Mainnet.
💱 Uniswap V2 LP Pair
After Bootstrap
Created via:
BootstrapVaultV3.finalise()Timeline: After 05.06.2026
Function: IFR/ETH trading pair on Uniswap V2. Created automatically when Bootstrap concludes. LP tokens locked for 12 months.
💧 LiquidityVault.sol
Phase 2
Purpose: Phase 2 LP management
Timeline: After 05.06.2026
Function: Manages liquidity expansion using the 200M IFR from LiquidityReserve. Controlled by Governance.
🏗️ BuilderRegistry.sol
Mainnet
Owner: Governance (0xc43d...D041) — controlled by TreasurySafe 3-of-5
Function: On-chain registry for approved builders. Maps builder addresses to product metadata and reward eligibility. Registration via Governance proposals (48h timelock).
Deployed: 20.03.2026 | 27/27 tests passing
🔀 BuybackController.sol
Phase 3
Purpose: Routes FeeRouter fees to BuybackVault & BurnReserve
Function: Automates fee distribution from FeeRouterV1. Splits accumulated fees between BuybackVault and BurnReserve according to governance-set ratios.
🗳️ RatVoting.sol
Phase 4
Purpose: Council governance
Function: Merkle tree-based council voting with on-chain anchoring. Enables trusted council members to vote on protocol proposals.
💬 ForumVoting.sol
Phase 4
Purpose: Community voting
Function: Community-wide voting using ecrecover signatures. Gasless off-chain signature collection with on-chain verification.
🛡️ IFRSpamProtection.sol
Phase 4
Purpose: Proposal spam prevention
Function: Requires 10 IFR per proposal submission (burned permanently). Deflationary mechanism that prevents governance spam.
🔄 Ecosystem Flow
How tokens flow from genesis through the entire IFR protocol infrastructure.