$COOKIE TECHNICAL WHITEPAPER

Cookiebnb.xyz

Cookiebnb.xyz is a decentralized lottery system deployed on the BSC network and powered by a custom ERC-404 contract. It is designed to be automated, immutable, and provably fair. The system merges the viral dynamics of social media with on-chain randomness, reinforced by a tokenomic engine that compounds value through every transaction.

Cookie is built on two synergistic flywheels:

  • The Marketing Flywheel: Entry requires a public X (Twitter) post, ensuring that every participant becomes a promoter. Posts fuel visibility, visibility drives participation, participation grows liquidity, and liquidity expands prize pools.

  • The Token Flywheel: A built-in tax mechanism automatically allocates volume into buybacks and prize pools. Buybacks reduce supply and apply upward pressure, while prize pools expand continuously with activity.

Together, these dual flywheels create a self-perpetuating ecosystem where user engagement and tokenomics reinforce each other. Automation replaces intermediaries, smart contracts secure trust, and virality drives expansion.


How to Enter

Participation is streamlined into three steps:

Step 1 — Acquire Your Cookie Purchase at least 1 $Cookie token (ERC-404). Each token corresponds to 1 NFT, representing a verifiable lottery entry.

Step 2 — Post on X Participants must post their NFT on X (Twitter), tagging @CookieBinance and using the provided template. This step ensures visibility and viral propagation.

Step 3 — Automatic Entry CookieBNB's backend monitors X for qualifying posts. Tokens in the posting wallet are automatically entered. New tokens purchased are auto-added; tokens transferred out are removed. Deleted posts cancel entries until reposted.

At the conclusion of each draw cycle, winners are selected and rewarded instantly via smart contract.


Why It Works

1. Built-In Virality Every entry requires a public post. This transforms every participant into a promoter, fueling exponential exposure.

2. The Marketing Flywheel Posts generate attention → attention drives participation → participation increases liquidity → liquidity grows prize pools → larger prize pools attract more players. The cycle is autonomous.

3. The Token Flywheel Every transaction contributes to sustainability: 1% buybacks strengthen token value, 3% fuels prize pools, and 1% sustains the team. This ensures that activity directly compounds ecosystem strength.

4. Value Compounds Over Time Each draw amplifies attention. Each winner validates the system. Each transaction grows the prize pool and reduces supply. Over time, the marketing and tokenomics flywheels synchronize to create unstoppable momentum.


Technology Stack

ERC-404 Tax Standard CookieBNB is powered by the first-ever ERC-404 Tax contract, a substantial extension of the ERC-404 standard. ERC-404 already fuses ERC-20 fungibility with ERC-721 uniqueness; our ERC404Tax advances this by embedding the tax policy directly into the token’s core logic. Transfers route through an overridden _transfer path that calculates direction‑aware fees, respects AMM/fee‑exempt addresses for DEX safety, and performs controlled swaps using Uniswap V2 to realize ETH proceeds. The result is a protocol‑native monetary engine where accounting, exemptions, swaps, and URI semantics (via tokenURI/baseURI) are handled at the standard layer, not bolted on. This makes tokenomics inseparable from token behavior and establishes CookieBNB as the pioneer of ERC‑404 with native tax mechanics.

Lottery Contract The Lottery Contract governs the draw lifecycle and is designed for full automation. Core functions include:

  • Round managementcreateRound(start,end) opens a new round; addEntriesWithOwners(round, tokenIds, owners) snapshots eligible ERC‑404 IDs.

  • Randomness integrationdrawWinner(round) freezes the round and requests VRF; fulfillRandomWords(requestId, randomWords) deterministically maps the word to an entry index, resolves ownerOf(tokenId), finalizes state, and emits WinnerPicked/RoundCompleted.

  • Automation hookscheckUpkeep(data) validates conditions (round closed, entries exist, cadence met); performUpkeep(data) triggers the draw and advances the schedule.

  • Administrative controls — toggles/intervals (setAutomationEnabled, setAutomationInterval, setAutomationForwarder), funds admin rotation (setFundsAdmin), and guarded recovery (adminResetDrawFlag).

Events provide a complete on‑chain audit trail across creation, entry aggregation, VRF requests, winner resolution, and payouts. Guards like RoundStillOpen, NoEligibleEntries, and draw‑in‑progress checks enforce a clean state machine from Open → Closed → Drawing → Completed.

Chainlink VRF Winner selection is anchored to Chainlink VRF (Verifiable Random Function). VRF produces random values together with a proof verified directly on‑chain, ensuring that no participant, validator, or operator can tamper with or predict the outcome. Every draw is unpredictable before it happens, verifiable after, and trustless throughout.

BSC Network Deployment on BSC (Ethereum L1) provides low fees, fast finality, and Ethereum security assurances. This enables frequent rounds, economical automation, and cost‑effective routing of fee conversions without degrading UX.

Tokenomics

At the foundation of Cookiebnb.xyz lies a custom ERC-404 contract, the first of its kind. This is not a copy-paste implementation but a tailor-built protocol layer that integrates dynamic tax mechanics directly into the token standard. The result is a self-sustaining ecosystem where liquidity, incentives, and rewards compound naturally.

Tax Structure (5%) Every transaction—whether a buy, sell, or transfer—supports the ecosystem through a transparent and automated allocation:

  • 1% Buybacks: A permanent flywheel. Automated buybacks create sustained upward pressure, reducing circulating supply and reinforcing token value.

  • 1% Team Allocation: Ensures long-term development, operational continuity, and alignment of incentives between builders and the community.

  • 3% Prize Pool: Directly fuels the lottery rewards. Every transaction grows the prize pool, ensuring that each draw becomes more attractive as activity increases.

Sustainable Growth Engine This tokenomic model ties the health of the ecosystem to its activity. More participation → more volume → larger prize pools → stronger buybacks → reduced supply → higher value perception. The cycle strengthens itself.

Why It Matters Most projects rely on external marketing budgets or temporary incentives. Cookie's tokenomics embeds sustainability at the contract level. Value does not leak—it compounds. The buyback-prize pool dual mechanism ensures perpetual reinforcement of both liquidity and user engagement.

This design creates a self-perpetuating lottery economy, where every transaction is a bet not just on winning a prize, but on strengthening the system itself. In CookieBNB, the community doesn’t just play the game—they power it.


Design Principles

  • Automation First: No manual intervention. The system runs continuously and autonomously.

  • Immutability: Once deployed, smart contracts define the rules permanently.

  • Provable Fairness: Randomness and outcome selection are transparent and verifiable.

  • Virality as Code: Social posting is not an afterthought but a protocol requirement.

  • Liquidity Alignment: Every entry increases both prize pools and token utility.


Conclusion

Cookiebnb.xyz redefines lottery mechanics by embedding virality and tokenomics into its core. Through a dual-flywheel system—marketing (post-to-enter) and tokenomics (buybacks and prize pools)—the protocol creates unstoppable compounding momentum. Every post fuels visibility, every trade fuels liquidity, and every draw proves fairness.

With its custom ERC-404 contract, Chainlink VRF randomness, and BSC network scalability, Cookie creates not just a lottery, but a perpetual growth machine. Each draw is a marketing cycle. Each trade is a liquidity engine. Together, they form a system that is automated, immutable, and always fair.

Last updated