One Entry Per Wallet
Each wallet can have one active entry path per game and round in one-entry mode.
Game Handbook
How To Play onefor49
Complete in-page handbook for the onefor49 game model: round lifecycle, winner selection, reward mechanics, forfeiture cases, local data responsibilities, and operational safety.
Quick Rule
Pick one or more numbers, reveal on time, then claim reward
You pick from 1 to N. After reveal closes, the winner is the option with the smallest non-zero revealed total. If your revealed picks include the Winning Number, you can claim based on settlement reward rate.
Reveal Is Required
Placed picks must be revealed in the reveal period to keep reward eligibility.
Claim Has a Strict Period
Eligible rewards must be claimed in the claim period or that round can be forfeited.
Rules Handbook
General Game Rules (N)
Round #--Stage commit
Simple Rule
Pick a number between 1 and N (N > 0). If your number becomes the minimum picked option, you win reward; payout can be around N× your pick amount (final reward rate depends on round settlement).
1. Place Picks
Pick one or more numbers from 1 to N (N > 0). Your pick is committed in encrypted form during this stage.
Period length: --
2. Reveal Picks
Reveal your committed picks and salt. If you skip reveal, your entry is forfeited for reward claim.
Period length: --
3. Claim Reward
Claim in claim stage. One-entry mode applies: missing claim loses reward for that round.
Period length: --
Winner Selection
After reveal closes, each option has a revealed total amount. The winner is the option with the smallest non-zero revealed total. If multiple options tie on that minimum, the smaller option number wins.
Reward Formula
Your winning allocation is your committed amount mapped to the Winning Number weight. Payout is:
payout = winning_amount × reward_rate
Reward rate is set at settlement by protocol rules and may vary per round.
Current Round Schedule
Schedule data will appear when game config is loaded.
Candidate Count
N is game-defined and can be any positive integer
This handbook defines N as the parameter representing the number of options. Typical configurations include 2, 49, 1,024, and 1,000,000, all operating under the same lifecycle and settlement logic.
In practice, 49 is chosen as the optimized configuration for the core game, which is why the project is commonly referred to as 1for49.
Stage Guide
What you do in each stage
Place Picks
Action: Choose one or more numbers in 1..N and submit your encrypted commitment.
Submitted: Commitment hash + amount allocation by option index.
If missed: No entry is recorded for that round.
Reveal Picks
Action: Reveal the original picks and salt-derived proof for your commitment.
Submitted: Reveal payload matching the earlier commitment.
If missed: Entry is forfeited for reward eligibility.
Claim Reward
Action: Claim settled reward if your revealed picks include the Winning Number.
Submitted: Claim transaction bound to wallet + game + round entry.
If missed: Unclaimed reward is lost in one-entry mode.
Design Reasoning
Why the game is structured this way
Why Commit First
Commitment hides your exact picks during Place Picks, so other players cannot react to your selection before reveal closes.
Why Reveal Later
Reveal proves your committed picks were fixed before stage change. Unrevealed picks are ignored during settlement.
Why Claim Period Exists
Claim is a user action that transfers reward from vault accounting to your wallet path. Settlement alone does not auto-transfer.
Worked Example
How winner is selected with tie handling
Example reveals after reveal period closes:
Option #4 · Revealed total 340 · high participation
Option #11 · Revealed total 56 · low participation
Option #17 · Revealed total 56 · ties option #11
Option #26 · Revealed total 92 · mid participation
Option #33 · Revealed total 0 · no revealed picks (ignored)
In this example, option #11 and #17 tie at 56. The smaller option number wins, so #11 is the Winning Number. Option #33 is zero and ignored for winner selection.
Winner and Settlement
How outcomes are finalized
- Each game round settles using on-chain state and finalized revealed amounts.
- For game candidate range 1..N, the Winning Number is selected from that configured range.
- Winning logic is based on the minimum revealed amount rule for that game configuration.
- If tie conditions happen, settlement follows on-chain tie handling for the deployed program logic.
- Displayed projections are estimates; settled on-chain values are final.
Reward Mechanics
How payout is computed
payout = winning_allocation × reward_rate
- Winning Number: Smallest non-zero revealed total option.
- Winning Allocation: Your revealed amount mapped to the Winning Number only.
- Reward Rate: On-chain settlement value shown as Nx.
- Payout: winning_allocation × reward_rate.
No Reward Cases
Common ways a round becomes non-claimable
- You placed picks but did not reveal before reveal period closed.
- You revealed, but your picks do not map to the final Winning Number.
- You are eligible, but claim period closes before you submit claim.
- Your transaction fails and is not confirmed before period close.
Data Responsibility
Stored On Chain
Game config, round snapshots, revealed totals, winner, reward rate, claimed status, and finalized balances.
Data Responsibility
Stored On Your Device
Commit helper payload and reveal helper data needed to produce reveal transaction quickly and safely.
Data Responsibility
If Local Data Is Deleted
On-chain history remains, but reveal helper recovery may be impossible for unrevealed rounds.
Finality and Safety
Boundaries you should know
- Support cannot reverse finalized transactions.
- Clearing local browser data does not change on-chain round records.
- Losing local reveal helper data before reveal can block reveal for that round.
- Always verify cluster + program context before signing actions.
Safety Checklist
Before signing any action
- Confirm network and program address before signing.
- Keep local reveal backup on your device until reveal confirms.
- Track stage countdowns, especially when less than 1 minute remains.
- After every action, check transaction confirmation and on-chain status.
Glossary
Shared terms
Round
A single game cycle with Place Picks, Reveal Picks, and Claim Reward periods.
Place Picks
Stage where you submit your entry for the active round.
Reveal Picks
Stage where you reveal your previously placed picks.
Settlement
On-chain computation that finalizes winner and reward outcomes for the round.
Claim Reward
Stage where eligible wallets claim settled rewards.