Fomo3D — BNB Chain Blockchain Game

Fomo3D is a decentralized game on BNB Chain (BSC) with three game modes:

1. 1. Fomo3D Main Game — Buy shares with tokens. Each purchase resets a countdown timer. The last buyer when the timer hits zero wins the grand prize pool. All shareholders earn dividends from each purchase.

1. 2. Slot Machine — Bet tokens for a VRF-powered random spin. Matching symbols win multiplied payouts (up to 100x). Depositors earn dividend shares from every spin.

1. 3. Prediction Market — Bet on the outcome of events (Yes/No/Draw). Markets use either Oracle (Chainlink price feeds) or Optimistic (human proposal + challenge) settlement. Bettors earn dividends from other bets on the same market, and winners share the prize pool.

Installation and Config (required)

Ensure dependencies are installed at repo root (npm install).

A private key is required. If the user has not configured the skill yet, run fomo3d setup from the repo root. This runs an interactive CLI that prompts for:

• - BSC private key (for signing transactions)
• Network (testnet or mainnet)
• Optional custom RPC URL

Alternatively, set environment variables (no setup needed):

• - FOMO3D_PRIVATE_KEY — BSC wallet private key (hex, with or without 0x prefix)
• INLINECODE4 — testnet or mainnet (default: testnet)
• INLINECODE7 — custom RPC endpoint (optional)
• INLINECODE8 — override FLAP token address for buy/sell commands (optional, for testing)

Important: The wallet must be an EOA (externally owned account), not a smart contract wallet. The game contracts require msg.sender == tx.origin.

How to run (CLI)

Run from the repo root (where package.json lives). For machine-readable output, always append --json. The CLI prints JSON to stdout in --json mode.

CODEBLOCK0

On error the CLI prints {"success":false,"error":"message"} to stdout and exits with code 1. On success the CLI prints {"success":true,"data":{...}}.

Important Concepts

Token Amounts

All token amounts in CLI arguments and JSON output are in wei (18 decimals). For example:

• - 1 token = 1000000000000000000 (1e18)
• 0.5 tokens = 500000000000000000 (5e17)

When displaying amounts to users, divide by 1e18 for human-readable values.

Share Amounts

Share amounts for purchase --shares are integers (not wei). 1 share = 1 share.

Auto-Approve

The CLI automatically checks ERC20 token allowance and approves if needed before purchase, buy, sell, slot spin, slot deposit, pred bet, pred propose, and pred dispute. No manual approval step required.

FOMO Token Trading

The FOMO token is launched on the FLAP platform (BNB Chain bonding curve). Trading uses BNB as the quote token:

• - 内盘 (Portal): Directly calls FLAP Portal's swapExactInput with native BNB
• 外盘 (PancakeSwap V2): After the token graduates to DEX, uses PancakeSwap V2 Router

The CLI auto-detects the current phase via getTokenV6 and routes accordingly. Buy/sell commands work on both testnet and mainnet.

VRF (Verifiable Random Function)

Slot machine spins use Binance Oracle VRF for provably fair randomness. Each spin requires a small BNB fee (~0.00015 BNB) sent as msg.value. The spin result is determined by a VRF callback (1-3 blocks later) — the CLI returns the spin request transaction, not the result. Check the result with fomo3d slot status or fomo3d player afterward.

Commands Reference

Setup

CODEBLOCK1
Interactive configuration. Prompts for private key, network, and optional RPC URL. Saves to config.json.

Wallet — Check Balances

CODEBLOCK2
Returns BNB balance and game token balance for the configured wallet.

Output fields: address, bnbBalance (wei), tokenBalance (wei), tokenSymbol, INLINECODE37

Status — Game Round Info

CODEBLOCK3
Returns current round status including countdown, prize pools, share price, and last buyers.

Output fields: currentRound, roundStatus (NotStarted/Active/Ended), paused, countdownRemaining (seconds), grandPrizePool (wei), dividendPool (wei), sharePrice (wei), totalShares, lastBuyers (address[]), INLINECODE47

Strategy tip: When countdownRemaining is low, buying shares has higher expected value because you may win the grand prize. Each purchase resets the countdown by a fixed increment.

Player — Player Info

CODEBLOCK4
Returns player's shares, earnings, and pending withdrawals. Without --address, uses the configured wallet.

Output fields: address, shares, totalEarnings (wei), pendingEarnings (wei), pendingWithdrawal (wei), hasExited, INLINECODE56

Decision guide:

• - If pendingWithdrawal > 0: Must run fomo3d settle before purchasing more shares
• If pendingEarnings > 0 and round is active: Can exit to lock in earnings, or hold for more dividends
• If hasExited == true: Already exited this round, wait for round to end or settle

Purchase — Buy Shares

CODEBLOCK5
Buy shares in the current round. The --shares value is an integer count (not wei). Token cost = shares × sharePrice (auto-calculated).

Pre-checks performed automatically:

• - Game must not be paused
• No pending withdrawal (must settle first)
• Token approval (auto-approved if needed)

Output fields: txHash, blockNumber, status, sharesAmount, tokensCost (wei)

Exit — Exit Game

CODEBLOCK6
Exit the current round and lock in your dividend earnings.

Output fields: txHash, blockNumber, INLINECODE71

Settle — Claim Dividends & Prize

CODEBLOCK7
Settle dividends and claim any grand prize after a round ends. Must be called if pendingEarnings > 0 or pendingWithdrawal > 0.

Output fields: txHash, blockNumber, status, pendingEarnings (wei), pendingWithdrawal (wei)

End Round — End Expired Round

CODEBLOCK8
End a round whose countdown has reached zero. Anyone can call this. The grand prize is distributed to the last buyer.

Output fields: txHash, blockNumber, INLINECODE81

Faucet — Claim Test Tokens (testnet only)

CODEBLOCK9
Claim 10000 test FOMO game tokens on BSC Testnet. Rate limited to 1 claim per address per hour.

Output fields: txHash, amount, token, INLINECODE85

Buy — Buy FOMO with BNB

CODEBLOCK10
Buy FOMO tokens using BNB via the FLAP platform. Auto-detects market phase: Portal (内盘) or PancakeSwap V2 (外盘).

Example: Buy with 0.01 BNB:
CODEBLOCK11

Output fields: txHash, blockNumber, status, bnbSpent (wei), token, INLINECODE91

Note: Buy and sell commands use minOutputAmount=0 (no slippage protection). For large trades, consider splitting into smaller amounts.

Sell — Sell FOMO for BNB

CODEBLOCK12
Sell FOMO tokens for BNB. Two modes:

• - --amount: Sell exact token amount (in wei, 18 decimals)
• INLINECODE94: Sell by percentage of holdings in basis points (10000=100%, 5000=50%, 1000=10%)

Cannot use both flags simultaneously. Token allowance is auto-approved for Portal/PancakeSwap.

Example: Sell 50% of holdings:
CODEBLOCK13

Output fields: txHash, blockNumber, status, tokensSold (wei), market, INLINECODE100

Token Info — Token Status & Balances

CODEBLOCK14
Query FOMO token status on the FLAP platform and balances. Works without private key (shows token status only). Supports --address flag to check another wallet.

Output fields: token, network, portal, status (Invalid/Tradable/InDuel/Killed/DEX/Staged), phase (内盘/外盘), quoteToken, price (wei), reserve (wei), circulatingSupply (wei), taxRate, progress (wei), fomoBalance (wei), bnbBalance (wei), INLINECODE115

Decision guide:

• - status == Tradable: Token is on 内盘 (bonding curve), buy/sell via Portal
• INLINECODE117: Token has graduated to 外盘 (PancakeSwap), buy/sell via DEX
• INLINECODE118: How close to graduation (higher = closer to DEX)

Slot Status — Slot Machine Info

CODEBLOCK15
Returns slot machine configuration, prize pool, and statistics.

Output fields: paused, token, minBet (wei), maxBet (wei), prizePool (wei), totalShares, vrfFee (wei), stats { totalSpins, totalBetAmount, totalWinAmount, totalDividendsDistributed }

Note: maxBet = prizePool / 100 (dynamic). If prize pool is low, max bet is low.

Slot Spin — Spin the Slot Machine

CODEBLOCK16
Spin the slot machine. Requires token balance for the bet AND BNB for VRF fee (~0.00015 BNB).

Constraints:

• - INLINECODE132
• Wallet must have enough BNB for VRF fee
• Cannot spin while a previous spin is pending

Payout table:

Symbols	Multiplier
💎💎💎	100x
🍒🍒🍒

50x |
| 🔔🔔🔔 | 50x |
| 🍋🍋🍋 | 20x |

Output fields: txHash, blockNumber, status, betAmount (wei), vrfFee (wei), INLINECODE138

Important: The spin result is NOT in this response. The VRF callback determines the outcome 1-3 blocks later. Check fomo3d player --json or fomo3d slot status --json afterward.

Slot Cancel — Cancel Timed-Out Spin

CODEBLOCK17
Cancel a spin that timed out waiting for VRF callback. Only needed if VRF fails to respond.

Output fields: txHash, blockNumber, INLINECODE143

Slot Deposit — Deposit to Prize Pool

CODEBLOCK18
Deposit tokens into the slot machine prize pool. WARNING: Deposited tokens are permanently locked. You receive dividend shares in return — each spin distributes 5% of the bet amount to all depositors proportionally.

Output fields: txHash, blockNumber, status, amount (wei)

Slot Claim — Claim Slot Dividends

CODEBLOCK19
Claim accumulated dividends from slot machine deposits.

Output fields: txHash, blockNumber, status, dividends (wei)

Pred Config — Prediction Market Config

CODEBLOCK20
Returns global prediction market configuration.

Output fields: network, diamond, token, minBet (wei), devFeeBps, creatorFeeBps, dividendBps, nextMarketId, totalMarkets, paused, minDuration (seconds)

Pred Market — Market Details

CODEBLOCK21
Returns detailed info for a specific prediction market.

Output fields: marketId, title, creator, status (Active/Closed/Resolved), outcome (Yes/No/Draw, only when Resolved), settlementType (Oracle/Optimistic), drawEnabled, endTime, timeRemaining (seconds), prizePool (wei), totalYesShares (wei), totalNoShares (wei), totalDrawShares (wei), totalShares (wei), totalBets, totalBetAmount (wei), totalDividendsDistributed (wei), INLINECODE180

Decision guide:

• - status == Active: Market is open for betting
• INLINECODE182: Market ended, waiting for settlement
• INLINECODE183: Settlement complete, winners can INLINECODE184
• INLINECODE185: Market has ended, needs settlement

Pred Position — Player Position

CODEBLOCK22
Returns player's position in a specific market. Without --address, uses the configured wallet.

Output fields: marketId, player, yesShares (wei), noShares (wei), drawShares (wei), pendingYesDividends (wei), pendingNoDividends (wei), pendingDrawDividends (wei), estimatedPrizeIfYes (wei), estimatedPrizeIfNo (wei), estimatedPrizeIfDraw (wei), exited, INLINECODE199

Decision guide:

• - pendingXxxDividends > 0: Accumulated dividends, claim via pred exit or INLINECODE202
• INLINECODE203: How much you'd win if that side wins (before fees)
• INLINECODE204: Already exited all sides
• INLINECODE205: Already claimed settlement

Pred Bet — Place a Bet

CODEBLOCK23
Place a bet on a prediction market. The --side value is yes, no, or draw. Amount is in wei. A portion (dividendBps%) of each bet goes to existing holders as dividends; the rest goes to the prize pool.

Pre-checks performed automatically:

• - Market must be Active (not paused)
• Amount must be >= minBet
• Token approval (auto-approved if needed)

Output fields: txHash, blockNumber, status, marketId, side, amount (wei)

Pred Exit — Exit a Side

CODEBLOCK24
Exit one direction and claim accumulated dividends for that side. Can be called even when the contract is paused (user safety). Dev fee + creator fee are deducted from dividends.

Output fields: txHash, blockNumber, status, marketId, INLINECODE221

Pred Claim — Claim Settlement

CODEBLOCK25
After a market is Resolved, claim your winnings. Winners receive: accumulated dividends + prize pool share. Losers receive: accumulated dividends only. Dev fee + creator fee are deducted.

Output fields: txHash, blockNumber, status, INLINECODE225

Pred Create — Create Optimistic Market

CODEBLOCK26
Create a new prediction market using optimistic oracle settlement. Anyone can create a market.

Parameters:

• - --title: Market question (max 200 bytes)
• INLINECODE227: Unix timestamp when betting closes
• INLINECODE228: Bond amount required for proposing/disputing outcome (in wei, min 0.01 FOMO)
• INLINECODE229: Time window for disputes in seconds (min 600s = 10min, max 604800s = 7 days)
• INLINECODE230: Include this flag to enable Draw as a third option

Output fields: txHash, blockNumber, status, marketId, title, endTime, bondAmount (wei), challengePeriod (seconds), INLINECODE239

Pred Oracle — Oracle Market Info

CODEBLOCK27
View Chainlink oracle configuration for an Oracle-type market. Shows price feed, strike price, condition, and current price.

Output fields: marketId, feedAddress, feedDescription, feedDecimals, strikePrice, strikePriceFormatted, isAbove, condition, currentPrice, currentPriceFormatted, settlementPrice, INLINECODE251

Pred Optimistic — Optimistic Settlement Status

CODEBLOCK28
View optimistic oracle status for an Optimistic-type market. Shows proposal state, challenge deadline, and available actions.

Output fields: marketId, bondAmount (wei), challengePeriod (seconds), hasProposal, proposer, proposedOutcome, proposalTime, disputed, disputer, challengeDeadline, challengeRemaining (seconds), canFinalize, INLINECODE264

Decision guide:

• - hasProposal == false: Market needs someone to pred propose an outcome
• INLINECODE267: Proposal is open for challenge via INLINECODE268
• INLINECODE269: Challenge period passed, call INLINECODE270
• INLINECODE271: Needs arbiter to INLINECODE272

Pred Settle Oracle — Settle with Oracle

CODEBLOCK29
Settle an Oracle-type market using Chainlink price feed. Permissionless — anyone can call this after market ends.

Output fields: txHash, blockNumber, status, INLINECODE276

Pred Propose — Propose Outcome

CODEBLOCK30
Propose the outcome for an Optimistic-type market. Requires bond (auto-approved from token balance). Bond is returned if proposal is not disputed and is finalized.

Output fields: txHash, blockNumber, status, marketId, outcome, bondAmount (wei)

Pred Dispute — Dispute Proposal

CODEBLOCK31
Challenge a proposed outcome within the challenge period. Requires same bond amount (auto-approved). If you win the dispute, you get your bond back + 50% of proposer's bond.

Output fields: txHash, blockNumber, status, marketId, bondAmount (wei)

Pred Finalize — Finalize Outcome

CODEBLOCK32
Finalize a proposed outcome after the challenge period expires without dispute. Returns the proposer's bond and resolves the market.

Output fields: txHash, blockNumber, status, INLINECODE291

Pred Resolve — Arbiter Resolve Dispute

CODEBLOCK33
Resolve a disputed market. Only the contract owner or designated arbiters can call this. The winner gets their bond back + 50% of loser's bond. The other 50% goes to devAddress.

Parameters:

• - --outcome: The correct outcome
• INLINECODE293: Include this flag if the proposer was correct (default: disputer wins)

Output fields: txHash, blockNumber, status, marketId, outcome, INLINECODE299

Recommended Workflows

First-Time Setup

1. 1. fomo3d setup — configure wallet and network
2. INLINECODE301 — verify BNB and token balances
3. INLINECODE302 — check game state

Testing on Testnet

Before using real funds on mainnet, test all features on BSC Testnet. You need:

• - tBNB: Get from BNB Chain Faucet (for gas + token trading)
• Test FOMO tokens: Use the built-in faucet command (for game actions)

CODEBLOCK34

Note: Testnet has two separate FOMO tokens:

• - Game token (0x57e3...5d46): Used by purchase, slot spin, slot deposit. Get via faucet.
• FLAP token (0x32bf...8888): Used by buy/sell on FLAP Portal. Buy with tBNB.

Testing Token Trading — 内盘 (Portal)

The default FOMO token on testnet (0x32bf...8888) is in 内盘 (Portal bonding curve) phase. Test buy/sell with tBNB:

CODEBLOCK35

Testing Token Trading — 外盘 (PancakeSwap)

To test the PancakeSwap DEX path, use FOMO3D_FLAP_TOKEN env var to override the token address with a PancakeSwap-listed testnet token:

CODEBLOCK36

How it works: The CLI auto-detects the market phase via FLAP Portal getTokenV6. If the token is not on FLAP (query fails) or has status DEX (4), it routes to PancakeSwap V2 Router. If status is Tradable (1), it routes to Portal.

Buying FOMO Tokens

1. 1. fomo3d token-info --json — check token status and your BNB balance
2. INLINECODE317 — buy with 0.01 BNB
3. INLINECODE318 — verify FOMO balance

Selling FOMO Tokens

1. 1. fomo3d token-info --json — check FOMO balance
2. INLINECODE320 — sell 50% of holdings
3. Or: fomo3d sell --amount 1000000000000000000 --json — sell exactly 1 FOMO

Playing Fomo3D

1. 1. fomo3d status --json — check round status and countdown
2. INLINECODE323 — buy shares (start small)
3. INLINECODE324 — check your earnings
4. When ready to claim: fomo3d exit --json then INLINECODE326
5. If countdown reaches 0 and you're the last buyer: fomo3d end-round --json then INLINECODE328

Playing Slot Machine

1. 1. fomo3d slot status --json — check min/max bet and prize pool
2. INLINECODE330 — spin
3. Wait 5-10 seconds for VRF callback
4. INLINECODE331 — check if you won

Earning Passive Income (Slot Dividends)

1. 1. fomo3d slot deposit --amount <amount> --json — deposit tokens (permanent)
2. Periodically check: fomo3d slot claim --json — claim dividends

Playing Prediction Market

1. 1. fomo3d pred config --json — check prediction market config and minBet
2. INLINECODE335 — view a specific market
3. INLINECODE336 — bet 1000 FOMO on Yes
4. INLINECODE337 — check your position and dividends
5. After market resolves: fomo3d pred claim --id 1 --json — claim winnings
6. Or exit early: fomo3d pred exit --id 1 --side yes --json — exit and claim dividends

Creating a Prediction Market

CODEBLOCK37

Settling an Optimistic Market

CODEBLOCK38

Global Flags

Flag	Description
INLINECODE340	JSON output (always use for programmatic access)
INLINECODE341

Override network | | --help | Show help | | --version | Show version |

Network Info

Network	Chain ID	Fomo3D Diamond	Slot Diamond	Prediction Diamond	Game Token	FLAP Token (buy/sell)
BSC Testnet	97	INLINECODE344	INLINECODE345	INLINECODE346	INLINECODE347	INLINECODE348
BSC Mainnet

56 | 0x062AfaB...948b | 0x6eB59f...156E | 0xc64083...8d45 | 0x13f266...7777 | 0x13f266...7777 |

Note: Prediction Market uses the same game token as Fomo3D and Slot Machine.

Trading Contracts

Contract	Testnet	Mainnet	Purpose
FLAP Portal	INLINECODE354	INLINECODE355	内盘交易 + 状态查询
PancakeSwap V2 Router

0xD99D1c33F9fC3444f8101754aBC46c52416550D1 | 0x10ED43C718714eb63d5aA57B78B54704E256024E | 外盘交易 | | Quote Token | BNB (native) | BNB (native) | 支付媒介 |