Instructions:

NukeTheSupply is a gamified DeFi protocol that consists of two smart contracts, and two tokens:

> NTS contract and WeaponsMarket contract

> ICBM token and Warhead token.

ICBM is the primary token, while Warhead is a reward token.

===================

PHASES OF THE GAME:

===================

OPERATIONS PHASE:

NTS contract's task:

NTS smart contract holds undistributed ICBM token's supply, and wants to Transfer it to WeaponsMarket contract during 100-days time period (fixed amount every day). Contract can't do it alone (solidity has no automation), so anyone can call Transfer function every 24 hours and earn Warheads as reward.

User's task:

Users commit their ICBM tokens for 24 hours (using ARM function). After 24 hours, you will see "ICBMs Ready" field populated with the quantity of your ICBM tokens ready to be used for nuking.

When NUKE function is called, user's ICBM tokens are returned to user's wallet, Warhead tokens are minted and sent to user's wallet, and some quantity of ICBM tokens held by NTS contract supply pool is burned.

Ratio for amount of ICBM used for nuking and amount of ICBM tokens burned from contract is 10:1. Example: For 10 ICBMs ARMED and used in nuking, 1 ICBM token will be burned in NTS contract, and user will earn 1 Warhead token.

AUCTION PHASE:

Auction system goes active after OPERATIONS PHASE ends, and distributes the remaining ICBM supply, held by WeaponsMarket auction pool. There will be 100 auctions, distributing 1% of the remaining supply, 1 auction every 24 hours.

IMPORTANT: Warhead tokens will be used for placing bids in WeaponsMarket auction system.

Winning bids will be burned.

HAPPY NUKING!

WHITEPAPER

Abstract

NukeTheSupply (NTS) is a revolutionary decentralized protocol that redefines tokenomics by empowering users to control the burning of token supply, fostering a competitive, deflationary economy. Unlike traditional projects where founders dictate burns, NTS introduces a game-theoretic system where users earn the right to burn ICBM tokens through a 24-hour commitment process, minting Warhead tokens as rewards. The proprietary NTS Formula drives daily competition between users and the smart contract, dynamically adjusting the supply transferred to a yield pool. Over a 100 days of Operations (arming, nuking and token transfers) and 100 days of Auctions—users burn ICBM and Warhead tokens, reduce circulating supply, and bid for rewards, creating a dual-token system that supports price appreciation for both assets. NTS is a bold experiment in user-driven scarcity and market-driven valuation, delivering a fair, transparent, and engaging DeFi experience.

1 Vision

• Empower users to control token burns, replacing founder-driven models with a decentralized, merit-based system.
• Foster a competitive economy where strategic participation (arming, nuking, bidding) drives value creation.
• Support price appreciation for ICBM and Warhead tokens through deflationary burns and market-driven auctions.

1.1 Key Features

• User-Driven Burns: Users earn the right to burn ICBM tokens by committing them for 24 hours, minting Warhead tokens as rewards.
• NTS Formula: A dynamic formula dailyTransfer = (day * defaultTransfer) - (totalBurned + totalSold) creates daily competition between users and the smart contract, adjusting the ICBM supply transferred to the Weapons Market auction pool.
• Dual-Token System: ICBM tokens are burned and auctioned, while Warhead tokens are minted and burned, supporting mutual price appreciation.
• Two-Phase Structure: 100 days of Operations (arming, nuking, transfering) + 100 days of Auctions (distributing remaining ICBM via Warhead bids).
• Deflationary Mechanics: Burns during nuking (ICBM) and auctions (Warhead), reduce circulating supply, enhancing scarcity.

2. Protocol Mechanics

NTS is implemented through two smart contracts: NukeTheSupply and WeaponsMarket, each governing specific aspects of the protocol’s 200-day token distribution game.

2.1 Tokens

• ICBM Token:
  • Total Supply: 500 million ICBM.
  • Role: Primary token, burned during nuking, locked during arming, and distributed via auctions.
  • Initial Distribution: 350 million to the NukeTheSupply contract , 100 million to the initial pair liquidity, 50 million for initial burns.
• Warhead Token:
  • Initial Supply: 1 million WH (minted to owner to establish initial pair liquidity).
  • Role: Reward token for nuking, bidding currency for auctions, burned upon winning auctions.
  • Dynamic Supply: Minted during nuking (1:1 with burned ICBM) and upon calling contract's transfer function (0.001% of supply per call), burned during auctions.

2.2 Operations Phase (Days 1–100)

The Operations Phase starts 48 hours after deployment. Users have a 2-day advantage over NTC Contract. During operations phase, users arm, nuke, and influence the ICBM yield pool through the NTS Formula, preparing for the Auction Phase.

2.2.1 Arming

• Function: arm(uint256 amount_)
• Description: Users commit ICBM tokens to the NukeTheSupply contract for 24 hours, entering an "armed" state, symbolizing a strategic delay akin to preparing a warhead.
• Requirements: Available until day 100; amount > 0.
• Mechanics: Tokens are transferred to the contract, tracked in ArmBatch structs with a 24-hour end time.
• Impact: Removes ICBM tokens from circulation, reducing market supply and supporting price appreciation.

2.2.2 Nuking

• Function: nuke()
• Description: After 24 hours, users are able to use ARMED tokens to nuke the ICBM supply from the NTS contract, triggering three actions:
  • Return: 100% of armed ICBM tokens are returned to the user’s wallet.
  • Burn: 10% of armed ICBM tokens quantity are burned from the NTS contract, reducing the contract’s balance.
  • Mint: Warhead tokens are minted in a 1:1 ratio with burned ICBM tokens.
• Example: Arm 1,000 ICBM → Wait 24 hours → Nuke → Return 1000 ICBM, burn 100 ICBM from NTS contract, mint 100 WH.
• Impact:
  • Burns ICBM tokens, reducing total supply and supporting price growth.
  • Mints Warhead tokens, providing "fresh capital" for the Auction Phase.
  • Reduces the ICBM available for auction pool

2.2.3 Transfer function (contract is distributing it's ICBM tokens to the WeaponsMarket)

• Function: transfer()
• Description: Contract transfers, up to 3.5 million ICBM tokens daily from the NukeTheSupply contract to the WeaponsMarket contract, building the yield pool for auctions. This has to be done by the users, due to solidity limitations. Other option would be a third-party automation.
• Requirements: Callable every 24 hours during the 100-day Operations Phase. Rewards the caller with minted warhead tokens as compensation for gas and effort.
• NTS Formula:

  dailyTransfer = (day * DAILY_ICBM_TRANSFER_AMOUNT) - (totalICMBTokensBurned + totalICMBTokensSold)

  • Variables:
    • day: Current day (1 to 100), incremented daily.
    • DAILY_ICBM_TRANSFER_AMOUNT: 3.5 million ICBM.
    • totalICMBTokensBurned: Total ICBM burned via nuking.
    • totalICMBTokensSold: Total ICBM transferred to WeaponsMarket.
  • Mechanics: Calculates the ICBM amount to transfer, based on the result of NTS Formula.
• Incentives: Callers receive 0.001% of the current Warhead supply as a reward.
• Impact:
  • Builds the WeaponsMarket yield pool.
  • Creates a daily competition: users nuke to burn ICBM, reducing the dailyTransfer amount, while the contract aims to maximize transfers.

2.2.4 Competition via NTS Formula

The NTS Formula is the protocol’s cornerstone, enabling a unique competition:

• User Strategy: Nuking burns ICBM, increasing totalICMBTokensBurned and reducing dailyTransfer, limiting the auction pool’s growth and making ICBM scarcer.
• Contract Strategy: The contract aims to transfer 3.5M ICBM daily, increasing totalICMBTokensSold and building a larger auction pool.
• Dynamic Balance: Each day, the formula recalculates dailyTransfer, reflecting the tug-of-war between user burns and contract transfers, driving strategic participation.

2.3 Auction Phase (Days 101–200)

The Auction Phase distributes the ICBM pool accumulated in WeaponsMarket through competitive English auctions, leveraging Warhead tokens as the bidding currency.

2.3.1 Auction Mechanics

• Start: Any user can initiate an auction after day 100, submitting an initial Warhead token bid.
• Duration: 24 hours per auction, with only one active at a time.
• Lot Size: 1% of the initial ICBM yield pool (e.g., 3.5M ICBM for a 350M pool), fixed at the start of the Auction Phase via setAuctionQuantity.
• Bidding:
  • Users bid Warhead tokens, with each bid exceeding the current highest.
  • Bidders transfer tokens to WeaponsMarket via safeTransferFrom, requiring prior approval.
  • Outbid users can withdraw their previous bids via withdrawBid or submit a new, higher bid.
• Ending: After 24 hours, the highest bidder calls endAuction, receiving the ICBM lot (1% of the pool), and their Warhead tokens are burned.
• Outcome:
  • Approximately 100 auctions distribute the yield pool over 100 days (one per day).
  • Warhead burns reduce circulating supply, supporting price appreciation.
  • ICBM distribution rewards strategic bidders.

2.3.2 Fairness and Accessibility

• Equal Start: Auctions begin only after the 100-day Operations Phase, allowing all users to acquire Warhead tokens via nuking or market purchases.
• Market-Driven Valuation: Bidders determine ICBM value through competitive bids, guided by the Warhead/ICBM price ratio.
• Burn Cost: Burning winning Warhead bids prevents large holders from dominating auctions without cost, ensuring fairness.

2.4 Dual-Token Synergy

The ICBM and Warhead tokens work in tandem to drive price appreciation:

• Operations Phase:
  • ICBM: Arming removes tokens from circulation, reducing market supply. Nuking burns ICBMs from NTS contract, further decreasing supply, supporting price growth.
  • Warhead: Minted via nuking, providing users with capital for auctions.
• Auction Phase:
  • ICBM: Auctioned in 1% lots, rewarding bidders and maintaining demand.
  • Warhead: Burned upon winning bids, reducing supply and increasing scarcity, which supports price appreciation.
• Mutual Reinforcement: ICBM burns increase Warhead supply, enabling currency for bidding, while Warhead burns in auctions distribute what is left un-nuked, at the same time shrinking Warhead supply, creating a virtuous cycle.

3. Tokenomics

NTS’s tokenomics are designed to maximize scarcity and user engagement through the NTS Formula, burns, and auctions.

3.1 ICBM Token

• Price Drivers:
  • Arming locks tokens, reducing circulating supply.
  • Nuking burns tokens, increasing scarcity.
  • Auctions create demand, as users bid Warhead to acquire ICBM.

3.2 Warhead Token

3.3 NTS Formula

The NTS Formula (dailyTransfer = (day * 3.5M) - (totalBurned + totalSold)) is the protocol’s defining feature:

• Competition: Users burn ICBM to reduce dailyTransfer, limiting the auction pool and making ICBM scarcer. The contract counters by maximizing transfers.
• Dynamic Supply: Adjusts daily transfers based on user burns and past transfers, creating a live, strategic game.
• Economic Impact: Encourages nuking to influence supply, supporting ICBM price appreciation, while Warhead minting fuels auctions.

4. Phases:

• Arming: Users lock ICBM tokens for 24 hours, removing them from circulation.
• Nuking: Users burn 10% equivalent of armed ICBM, mint Warhead tokens, and reduce ICBM supply held by NTS contract.
• ICBM Emission: Daily transfers of up to 3.5M ICBM to WeaponsMarket, governed by the NTS Formula, builds the auction pool.
• Outcome: Users acquire Warhead tokens, and the yield pool forms.

5. Technical Details

NTS is built with solidity by a professional developer, leveraging OpenZeppelin libraries for reliability.

5.1 Smart Contracts

• NukeTheSupply.sol:
  • Manages arming, nuking, and transfering with the NTS Formula.
  • Deploys ICBMToken, WarheadToken , and WeaponsMarket.
  • Tracks 100-day Operations Phase and yield pool contributions.
• WeaponsMarket.sol:
  • Implements English auctions with a fixed 1% ICBM lot size.
  • Enforces post-100-day start via isOperationsPhaseEnded.
  • Burns Warhead tokens for winning bids, distributing ICBM.

5.2 Security Features

• OpenZeppelin Libraries: SafeERC20 for secure token transfers,ReentrancyGuard for attack prevention.
• Checks-Effects-Interactions: Ensures safe state updates and token transfers.
• Allowance Checks: Requires user approval for Warhead bids, preventing unauthorized transfers.
• Time Locks: Enforces 100-day Operations Phase, 24-hour arming, and 24-hour auctions via block.timestamp.

6. Use Cases

• Strategic Gameplay: Users arm, nuke, and bid to maximize Warhead and ICBM rewards, engaging in a competitive, 200-day economy.
• Speculative Trading: ICBM and Warhead tokens can be traded on any DEX, capitalizing on burn-driven scarcity.
• Community Engagement: The NTS Formula and auctions foster a dynamic, war-themed community experience.

7. Conclusion

NukeTheSupply reimagines DeFi with a user-driven burning system, the innovative NTS Formula, and a dual-token economy that supports price appreciation through scarcity and competition. By empowering users to burn ICBM tokens, compete via the NTS Formula, and bid in auctions, NTS creates a fair, transparent, and engaging 200-day game. The protocol’s deflationary mechanics, market-driven valuation, and strategic interplay of ICBM and Warhead tokens set a new standard for tokenomics, inviting participants to shape a dynamic, war-themed economy.