User Guide Overview¶

FairWins lets you make a wager with a friend, lock both stakes in a smart contract, and have the outcome settled by whoever — or whatever — you both agreed to trust: each other, a neutral friend, or an external oracle like Polymarket, Chainlink, or UMA.

This guide covers everything you do in the app at fairwins.app.

The five-minute version¶

flowchart LR
    A[Connect wallet] --> B[Get a membership]
    B --> C[Create a wager]
    C --> D[Share QR / link]
    D --> E[Friend accepts]
    E --> F[Outcome declared<br/>or oracle settles]
    F --> G[Winner claims pot]

Connect a wallet (MetaMask or WalletConnect) on Polygon.
Buy a membership tier — this is what authorizes you to create and accept wagers, and sets how many you can run at once.
Create a wager: terms, stake (USDC), deadlines, and a resolution method.
Share it with your friend as a QR code or link.
They accept, their stake locks, and the bet is on.
When the event happens, the wager resolves — by one of you, an arbitrator, or an oracle — and the winner claims both stakes.

Reading paths¶

New here? Start with Getting Started, then skim User Journeys to see the full flows.
Making your first bet? Creating a Wager, then Accepting a Wager for your friend's side.
Bet finished? Resolving a Wager covers declaring winners, draws, oracle settlement, and refunds.
Care about privacy? Private Wager Encryption explains how wager terms stay readable only to participants.
Questions? The FAQ.

What you'll need¶

A wallet on Polygon mainnet (chain 137) — the app can switch networks for you, and a testnet mode (Polygon Amoy) is available from the wallet menu.
A little POL for gas.
USDC for stakes and the membership fee.

What FairWins is not¶

There is no order book, no trading, no house, and no token to farm. Wagers are private 1-v-1 agreements; the protocol just escrows the stakes and pays the winner. Operators can pause the protocol or freeze abusive accounts (see the Account Moderation Policy), but they can never take escrowed stakes.