The WELEPHANT Manifesto

A living text for the Prediction Mining protocol — what it is, who it's for, and why it matters in a world where the rules of earning are being rewritten.

Part I: The Human Case

1) Why This Text Exists

Prediction Mining is more than a game. It is a miniature economic system that blends open access, transparent probability, and on-chain redistribution into something anyone can use — anywhere, anytime, from a phone.

This document is written for real people: employees, contractors, small business owners, gig workers, and the self-employed — anyone who has felt the ground shift beneath them. Whether the cause is AI displacing your industry, a local currency losing value overnight, a banking system you can't access, or simply the reality that stable paychecks are no longer guaranteed — the question is the same: what options do you actually have?

For artisans, chefs, filmmakers, construction crews, street vendors, and every kind of independent operator, WELEPHANT is designed to be a parallel economic layer that can complement the work you already do. Not a replacement. A second door.

The goal is to make every major design decision legible:

• What the protocol does (a 1-minute prediction game with BNB + WELEPHANT rewards).
• Why it exists now (a practical alternative for agency and reward when conventional paths narrow).
• Who it serves (anyone in the world with a phone and a wallet).
• How it is built (contract layers, data flow, and security invariants — detailed in the Technical Appendix).

2) The Protocol in One Paragraph

Prediction Mining is a 60-second prediction game on BNB Chain where players select one or more of 16 numbered squares. At the end of each round, a winning square is selected using on-chain randomness. Winners share 90% of BNB in the round proportional to their play size, while 10% is converted into WELEPHANT and distributed as player rewards (50%), staking yield (20%), payday jackpots (20%), and protocol fees (10%). The system supports single-winner rounds, a PAYDAY jackpot, and a sponsorship model that allows others to fund your participation without controlling your rewards.

3) Who This Is For

Prediction Mining is built for the world, not a niche. Here's what that means in practice:

This matters because for billions of people, the barrier to financial participation isn't desire or ability — it's access. Prediction Mining removes the gatekeepers.

4) A Round in Real Life

Abstract descriptions hide what things actually feel like. Here's a concrete example:

Carlos runs a taco stand in Mexico City. Between the lunch and dinner rush, he opens the game on his phone. He puts 0.01 BNB (~$6) on square 11. The round has 1.2 BNB total across 8 players.

Sixty seconds pass. The protocol waits six blocks. Square 11 wins.

Total on square 11: 0.05 BNB. Carlos's share: 0.01 / 0.05 = 20%. Prize pool (90% of 1.2 BNB): 1.08 BNB. Carlos receives 0.216 BNB (~$130), plus WELEPHANT tokens.

He stakes the WELEPHANT. Now, every future round — even rounds he doesn't play — distributes a portion of WELEPHANT to stakers. His stake earns yield while he serves customers.

Some rounds he loses. Some rounds he wins. But the WELEPHANT he stakes keeps compounding regardless.

This is one round. It took ninety seconds. He never left the taco stand.

5) What Makes This Different

Prediction Mining is built on principles that traditional systems don't offer:

• 90% back to players in BNB, plus WELEPHANT token rewards on top.
• Fully on-chain, verifiable odds — every outcome is auditable by anyone.
• Instant payouts — winnings are credited to your on-chain balance the moment a round finalizes.
• Self-custody — no operator holds your money. You control your funds at all times.
• No KYC — just connect a wallet. No sign-ups, no identity documents, no bank account required.
• Rounds every 60 seconds — the game never closes.
• Immutable rules — fee percentages and game mechanics are constants in the contract. No one can change them.

The key difference is who has control. In traditional systems, an operator stands between you and your money. In Prediction Mining, the contract is the operator — and it can't change its mind.

6) Core Design Principles

6.1 Open to Everyone

Anyone can play, sponsor, or stake. There is no gatekeeper. The protocol is open by default; access control is only used to protect operational integrity.

6.2 Transparent Odds

Players can inspect odds, mechanics, and payoffs entirely on-chain. Every outcome is auditable. There is no hidden house edge beyond the stated 10% game fee.

6.3 Your Money Stays Yours

Rewards are credited to your on-chain balance and can only be claimed by you. The protocol allows sponsorship, but never custody: someone can fund your play, but they can never touch your winnings.

6.4 Built to Scale

Batch processing, cursor-based iteration, and storage separation mean the game works whether there are 5 players or 5,000.

6.5 Economic Alignment

90% of BNB goes to winners. 10% flows into a WELEPHANT-powered economy that rewards playing, staking, and jackpot participation. This creates constant buy pressure on WELEPHANT and a recurring reward stream for stakers — the more people play, the more everyone earns.

7) Round Mechanics

1. Choose squares: pick from 16 squares and set the amount you want to play.
2. Round starts: once at least 2 players have joined, the 60-second timer begins.
3. Entropy delay: after the timer, the protocol waits six blocks (~18 seconds) to finalize randomness.
4. Winner selection: a winning square is selected. All players on the winning square split 90% of the round's BNB proportional to their play size. In 50% of winning rounds, a single winner is also chosen — they take the entire WELEPHANT player reward share (50% of the WELEPHANT bought back from the 10% fee), while BNB is always split proportionally.
5. PAYDAY chance: 1 in 625 rounds, the accumulated WELEPHANT jackpot pays out to winners.
6. Rewards accrue: BNB + WELEPHANT are credited to your on-chain balance. Claim anytime.

8) The Escape Hatch Thesis

The world is changing in ways that make traditional economic paths less reliable. AI is automating white-collar work. Currencies are inflating. Platforms are extracting more and giving back less. Banking systems remain inaccessible to billions. For many, the question isn't "how do I get a better job?" — it's "what systems can I participate in that don't require someone else's permission?"

An escape hatch is defined by three conditions:

1. It is accessible without permission, paperwork, or a minimum net worth.
2. It offers a credible path to reward — volatile, yes, but real and transparent.
3. It maintains self-custody — no one can freeze, seize, or withhold what you've earned.

Prediction Mining meets these conditions. It does not replace employment, a business, or a craft. It creates a parallel, opt-in pathway — a second economic layer that runs alongside whatever you're already doing. Over time, consistent participation deepens the reward pool, making rounds stronger and the ecosystem more resilient.

This applies everywhere: an employee in Chicago hedging income volatility. A contractor in Lagos smoothing gaps between gigs. A food vendor in Manila building a staking position between customers. A collective in São Paulo pooling funds to sponsor members who can't afford to play alone.

The protocol doesn't care where you are, what language you speak, or what your credit score is. It only asks: do you want to participate?

9) The Compounder's Path

The most common mistake is to see Prediction Mining as pure chance. It's not. The system is designed so that consistent, small participation creates a compounding position over time:

1. Play — even small amounts — and win BNB + WELEPHANT.
2. Stake your WELEPHANT in the vault. The staking vault receives 20% of all WELEPHANT generated every round.
3. Earn yield from every round played by anyone — even rounds you don't play in.
4. Compound automatically — the vault's share price appreciates as rewards flow in. Your position grows without any manual action.
5. Loop — enable auto-play with ETH looping, which automatically re-invests your BNB winnings into future rounds.

A player who plays 10 rounds and loses 7 of them can still come out ahead if they stake their WELEPHANT winnings from the 3 they won. A player who never plays again but holds a staked position still earns from every round the protocol runs.

This is the difference between gambling and building. The protocol rewards attention, consistency, and patience — not just luck.

10) Community and Sponsorship

The protocol's sponsorship model unlocks something most games can't offer: the ability to bring others in without giving up control.

• A business sponsors its customers: a coffee shop buys rounds for regulars. The customers keep all winnings.
• A community pools funds: a neighborhood collective sponsors its members. Winners keep their rewards.
• Friends gift rounds: send someone a play for their birthday. They win, they keep it.
• A DAO funds participation: a treasury allocates BNB to auto-play for members. Each member controls their own rewards.

The sponsorship model is enforced at the contract level: sponsors can only give, never take. There is no mechanism for a sponsor to withdraw, redirect, or claim a player's rewards. The player always controls their balance and can cancel sponsored auto-play at any time.

This transforms Prediction Mining from an individual activity into a social and economic tool — something communities can use to support each other, onboard new participants, and create shared upside.

11) Honest Risk

An escape hatch that hides its risks is just another trap.

Prediction Mining is not a guaranteed income product. You can lose. Some rounds, you'll win nothing. The WELEPHANT you earn might go down in value. Gas fees take a cut of every transaction. The protocol is only as liquid as the people playing it.

Never play with money you need for rent, food, or your family. This system is a tool — and like any tool, it works best when used deliberately, not desperately.

What the protocol does promise: the rules won't change on you. The odds won't be secretly adjusted. Nobody can freeze your account or withhold your winnings. The contract is the contract.

That's not everything. But it's more than most systems offer.

Part II: Economics

1) Economic Flows

Every round moves value through a simple, transparent path:

1. Players enter by placing BNB on numbered squares.
2. 90% of all BNB goes directly to winners.
3. 10% is converted into WELEPHANT and distributed:

The system is not zero-sum. It continuously recycles value into its own economy, creating aligned incentives between players and stakers. More players means more WELEPHANT bought back from the market, which means stronger price support, which means better staking yields, which attracts more stakers, which deepens the ecosystem.

For small businesses, this acts like a treasury upgrade: instead of leaving idle capital on a balance sheet, a measured allocation can plug into a reward loop that benefits both the business and the wider network.

2) The PAYDAY Jackpot

PAYDAY is funded every round: 20% of the WELEPHANT fee stream is routed to the PAYDAY pool regardless of outcome. When a round has no winners (no players on the winning square), the round's funds are also converted into WELEPHANT and added to the PAYDAY pool, increasing its size beyond the baseline allocation.

This creates a social energy storage mechanism:

• Baseline growth every round from the 20% fee allocation.
• Missed rounds add extra WELEPHANT, accelerating jackpot growth.
• Large payouts re-inject confidence and liquidity into the ecosystem.
• Carryover: when PAYDAY triggers, 90% of the accumulated fund is distributed to winners and 10% carries over as a seed for the next cycle. The jackpot is never fully depleted.

PAYDAY can be 10x to 100x+ the normal WELEPHANT reward for a round. It is the protocol's way of rewarding persistence — the longer you stay, the more likely you are present when it hits.

3) The Role of Staking

Staking is the stability pillar of the system. While gameplay is variable, staking rewards offer a consistent path to passive yield.

The staking vault receives yield from two sources:

• 20% of game fees — every round distributes 20% of its WELEPHANT to stakers.
• 0.25% swap fees — the WelephantSwap contract charges a 0.25% fee on all WELEPHANT/BNB swaps, which is automatically forwarded to the staking vault.

This means:

• You earn from rounds you don't play in.
• You earn from every swap that flows through the protocol.
• Your yield grows as the protocol grows.
• Compounding is automatic — the vault's share price rises as rewards accumulate. You don't need to claim and re-stake; your position appreciates on its own.

The staking vault uses the ERC-4626 standard, which means your staked position is represented as a token whose value increases over time. Stake once, and every round makes your position worth more. This makes the protocol more inclusive for users who want exposure without constant gameplay or manual management.

4) Long-Term Vision

Prediction Mining aspires to be a self-sustaining ecosystem with three enduring properties:

1. Fairness — transparent rules and verifiable randomness, enforced by code.
2. Resilience — modular contracts that can evolve without losing history, and an architecture that never stops running due to a single point of failure.
3. Opportunity — a shared reward system open to anyone in the world, regardless of where they were born, what language they speak, or what institutions will serve them.

In a future where AI reshapes labor, currencies inflate, and platforms extract — the WELEPHANT protocol stands as a bridge between uncertainty and agency, letting people convert attention, community, or strategy into real rewards.

5) Closing Statement

The WELEPHANT Manifesto is not just documentation. It is a statement of intent: to build a system where people can regain some autonomy in a world of accelerating uncertainty.

The protocol doesn't promise wealth. It doesn't promise stability. It promises fair rules, open access, and the right to participate — for everyone, everywhere, always.

That's the escape hatch. The door is open.

Part III: Technical Appendix

This section is for developers, auditors, and technical reviewers. If you're a player, everything you need is in Parts I and II above.

1) System Overview

Prediction Mining is a layered smart contract system designed to be rug-proof, gas-efficient, and audit-friendly. The implementation is engineered to guarantee fairness, upgradeability, and long-term sustainability.

The system is split into the following layers:

1. User Interface Layer (read-only views, pagination)
2. Game Engine Layer (game logic, auto-play, reward routing)
3. State Storage Layer (round history, player stats, verification)
4. Vault Layer (rewards, staking, liquidity, gas charge, fee accounting)
5. External Integrations (swap routing, TWAP oracle)

2) Contract Layering and Responsibilities

2.1 User Interface Layer

• RaffleMiningViews.sol exposes read-only views with pagination.
• This prevents front-end indexers from being a single point of failure.

2.2 Game Engine Layer

• RaffleMining.sol handles player interactions (plays, configuration, auto-play with manual or random square selection, ETH looping).
• RaffleMiningCrank.sol finalizes rounds, runs batch distribution, and selects winners.

2.3 State Storage Layer

• GameHistory.sol stores round data, player stats, participant tracking, and summaries.
• Verification.sol manages hash-chained entropy accumulation to secure randomness.

2.4 Vault Layer

• WelephantRewards.sol tracks BNB + WELEPHANT rewards and enforces claim logic.
• StakingVault.sol offers a permissionless ERC-4626 staking vault for WELEPHANT.
• WelephantVault.sol holds WELEPHANT liquidity for just-in-time reward delivery.
• GasChargeVault.sol manages gas refunds for round finalization.
• AutoPlayDeposit.sol holds deposits for auto-play and looping strategies.
• FeeAccounting.sol decouples fee recording from token transfers, enabling async distribution without blocking round finalization.

2.5 External Integrations

• WelephantSwap.sol integrates with PancakeSwap V2 for BNB/WELEPHANT swaps with dual-path routing (direct and indirect via BUSD) and selects the most liquid route automatically. A 0.25% fee is charged on all swaps and forwarded to the StakingVault as additional staker yield.
• IPcsSnapshotTwapOracle provides a time-weighted average price (TWAP) oracle that resists same-block price manipulation, used for all crank-side swap accounting.

3) Storage Separation and Upgradeability

Prediction Mining separates storage contracts from logic contracts. This allows the system to:

• Upgrade or optimize game logic without overwriting historical game data.
• Preserve player stats and round data on-chain (no off-chain dependencies).
• Maintain long-term auditability for future governance decisions.

4) Randomness and Fairness

Randomness is generated through hash-chained entropy accumulation and applied after a six-block delay. Every player action (address, square, amount, timestamp, block number, and block.prevrandao) is folded into the round's seed via keccak256, creating a one-way, order-dependent chain that no single participant can predict or reverse. At finalization, the accumulated seed is combined with blockhashes from three recent blocks and beacon chain randomness (prevrandao).

The Verification contract stores all entropy components across rounds, creating a verifiable audit trail. Finalization only occurs after the six-block cooldown, ensuring the blocks used for final randomness cannot be influenced by players.

5) Access Control Design

The protocol uses OpenZeppelin's AccessControl for role-gated operations.

Key roles include:

• DEFAULT_ADMIN_ROLE: governance-level configuration access.
• ADMIN_ROLE: parameter updates (min players, fees, gas settings).
• PAUSER_ROLE: emergency pause/unpause.
• STORAGE_WRITER_ROLE / WRITER_ROLE: round writes and player state updates.
• DEPOSITOR_ROLE: credits WELEPHANT rewards and manages gas refunds.
• CONSUMER_ROLE / CRANK_ROLE: swap execution and just-in-time liquidity operations.
• DISTRIBUTOR_ROLE: distributes accumulated fees from FeeAccounting when vault liquidity is available.

By splitting operational roles, the protocol reduces the blast radius of any single key compromise and preserves decentralization of responsibility.

6) Sponsorship Model (Technical)

Prediction Mining allows one address to fund the play of another. This is enforced at the contract level:

• The sponsor pays the BNB for plays or auto-play deposits.
• The player receives the rewards if the play wins.
• The sponsor cannot withdraw or claim the player's rewards.
• A sponsor cannot overwrite an active auto-play registration for another player.

All withdrawal and claim functions check msg.sender, ensuring strict self-custody for the player regardless of who funded the play.

7) Gas-Efficient Finalization

Rounds are finalized via RaffleMiningCrank, which processes large data sets in batches using gas-checked cursors. This design prevents exceeding block gas limits and ensures finalization can proceed even when thousands of players participate.

8) Async Swap Resilience

The protocol decouples BNB-to-WELEPHANT swaps from round finalization. Game fee BNB is deposited into the WelephantVault incrementally as plays occur (preventing front-running), and swaps are executed asynchronously by the crank with try/catch safety. If a swap fails, the crank continues and retries on the next cycle. Fee amounts are tracked in FeeAccounting as accounting entries (no token custody), and actual WELEPHANT transfers happen only when vault liquidity is available. This ensures that round finalization never blocks on swap failures, and the game remains operational even during liquidity shortages or DEX issues.

9) Security Invariants

1. Withdrawals are self-only: claims and cancellations always check msg.sender.
2. Sponsors cannot steal: sponsors only fund, never receive.
3. No emergency withdraws: fee percentages are constant, no rug switches.
4. On-chain history: round outcomes are stored and verifiable forever.
5. Graceful failure: gas refund vaults and swap logic use try/catch to avoid hard reverts. The crank never halts due to swap failures, auto-stake errors, or vault underfunding.
6. Partial claims: if the WELEPHANT vault is temporarily underfunded, players can still claim their BNB rewards. WELEPHANT balances are preserved for a later retry.
7. Async fee accounting: fee recording is decoupled from token transfers, so round finalization is never blocked by liquidity conditions.