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 depends on the settled reward rate, including a middle-band penalty that gives broad even-pick coverage real risk.
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 deterministic at settlement: raw = total committed / winning total. If raw is at most the candidate count, raw is used. If raw is between 1× and 1.5× the candidate count, the rate is 90% of the candidate count. At 1.5× or higher, raw is used again.
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.
Asset and Airdrop Policy
How M149 is positioned in the protocol
onefor49 supports game-specific assets. M149 is the protocol play/test token, and Daily Airdrop is scoped specifically to M149 games.
Asset Selection Is Per Game
Every game uses one configured mint for place/reveal/claim flow. Different games can run on different mints at the same time.
M149 Is Protocol Play/Test Token
M149 is designed for fun and testing gameplay flows, including onboarding and round-action practice.
Daily Airdrop Applies Only To M149
Daily Airdrop is available only when the game mint is M149, limited to one request every 24 hours per game and wallet.
No Price Promise
Protocol test-token behavior does not imply guaranteed market value. Treat M149 utility as product testing context.
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: Deterministic on-chain multiplier M(r) from total committed amount and winning total amount.
- Payout: winning_allocation × reward_rate.
if all revealed totals are zero: M(r) = 0/1 (no winner, no payout)
Reward Rate Paths
Exact calculation paths and value ranges
Definitions: N = candidate count, T = total committed amount, W = winning option revealed total, raw = T/W.
Base Path · M(r) = T/W
Branch: Deterministic
Trigger: raw = T/W is less than or equal to N.
Range: 1x to Nx
Notes: Even coverage does not gain above break-even in this zone.
Penalty Band · M(r) = (9N)/10
Branch: Deterministic
Trigger: raw = T/W is greater than N and less than 1.5N.
Range: Exactly 0.9N x
Notes: This gives full/even-pick coverage a loss zone, so broad hedging still carries risk.
High-Raw Path · M(r) = T/W
Branch: Deterministic
Trigger: raw = T/W is greater than or equal to 1.5N.
Range: > Nx (no explicit hard cap besides integer limits)
Notes: High-imbalance rounds can still pay above N; the penalty only applies in the middle band.
The reward-rate branch is deterministic from settled round totals. No random branch is used for this multiplier.
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.
M149
Protocol play/test token used for fun rounds; Daily Airdrop support is scoped to M149 games.