Docs · Getting started

Start here

Getting started

Wallet, faucet, first bet, claiming: step by step.

On this page

This takes about five minutes. You will need a browser and a Solana wallet. Everything uses Solana devnet and test USDC, so nothing you do here costs real money.

  1. 1. Get a wallet

    A wallet is the app that holds your tokens and signs your bets. FlySports works with Phantom and Solflare (browser extensions or mobile apps). Install one and create a wallet. Write the recovery phrase down offline and never share it with anyone.

  2. 2. Switch your wallet to devnet

    FlySports runs on Solana devnet, so your wallet has to point at it. In Phantom: Settings, Developer Settings, turn on Testnet Mode, then choose Solana Devnet. In Solflare: Settings, Network, Devnet. Menu names can change between wallet versions, so search your wallet's settings for “devnet” if you cannot find them.

    If a balance looks like zero or a bet fails straight away, a wrong network is the most common cause.

  3. 3. Connect your wallet

    Open the Live page and press the wallet button in the top right (or Connect your wallet in the bet panel). Choose your wallet and approve the connection. Connecting only shares your public address. It does not move anything and cannot spend your funds.

  4. 4. Get test USDC and SOL from the faucet

    In the bet panel you will see your USDC balance with a Get test USDC button. Press it. The built-in faucet mints 500 test USDC to your wallet and, if your wallet is low, sends a small amount of devnet SOL (0.05 SOL) to pay network fees. You do not need to approve anything: the faucet sends tokens to you and does not ask for a signature.

    • The faucet is rate limited per wallet and per network (about once a minute), and has daily limits overall. If you see “Slow down”, wait a minute and try again.
    • SOL pays the tiny fee on each transaction (and a small refundable deposit while a bet account exists). USDC is what you bet. You need both.
    • Both are devnet tokens with no value. If you want extra devnet SOL, a public devnet faucet will also work.
  5. 5. Place your first bet

    • Wait for a race that is in its betting window (the bet panel shows a countdown, “Betting locks in …”). The window is roughly a minute.
    • Pick a breed. Each row shows the fly's current pool, its win chance and its payout multiplier. A 2.50× multiplier means every 1 USDC on that fly would return about 2.50 USDC if it wins at the current pools. Read How betting works for why that number moves.
    • Enter an amount (or tap a quick amount such as 5, 10, 25 or 100) and press Place bet.
    • Your wallet asks you to approve one transaction. Check it says devnet, approve it, and wait a moment for the green “Bet placed” confirmation. Your stake appears under Your bets.
  6. 6. Watch the race

    When the window closes the race is locked: no new bets, and the race seed is fixed. The race then airs on the shared broadcast on the Live page, so everyone sees the same race at the same moment. The result is withheld from the bet panel until it has aired, so a stream delay never spoils anything for you.

    Want to see the thinking behind the movement? The race pages include a brain panel for each fly. A fly and its brain explains every bar.

  7. 7. Claim your winnings

    If your fly won (or the race was cancelled and you are owed a refund) a Claim button appears in the bet panel once the result has aired. Press it and approve the transaction. The USDC goes straight to your wallet and the small deposit for your bet account comes back with it. You can see every past bet on the My bets page.

    Claiming is on you: payouts are never sent automatically, and your winnings stay safe until you claim them.

If something goes wrong

  • Wallet will not connect. Refresh, unlock the wallet extension, and make sure no other wallet extension is fighting for control.
  • “Insufficient USDC balance”. Use Get test USDC again, or lower your bet.
  • Transaction fails with a fee or “insufficient funds” message. You are out of devnet SOL. The faucet tops it up automatically when you request test USDC.
  • The faucet says “Slow down” or is under heavy load. Wait a minute and retry. Devnet is a shared public network and can be slow or briefly unavailable.
  • Betting closed before I clicked. The window locks at a fixed Solana slot. Lock time is final, so just wait for the next race.
  • My bet vanished after claiming. That is expected. Claiming closes the bet account to return its deposit. Your history is still on My bets.

Still stuck? See the FAQ or how to report a problem. Never paste a recovery phrase anywhere. We will never ask for it. The raw faucet endpoint is /api/faucet, but the button does everything for you.