BaseScore
BaseScore documentation

Understand every
score onchain.

A practical guide to BaseScore markets, the BSU trading token, wallet positions, settlement, protocol statistics, and owner controls—limited to features the product actually supports.

Start with the basics Explore live markets

Getting started

What is BaseScore?

BaseScore is a two-outcome prediction market on Base. Each market asks a question, defines Option A and Option B, accepts positions in BSU, and settles according to an outcome recorded by the market contract. The interface reads market state and wallet data directly from the configured contracts.

Two outcomes

Every live market has Option A and Option B.

BSU positions

BSU is the internal token used for market activity.

Onchain settlement

Claims and refunds execute through the contract.

Quickstart

From wallet to settled position

The standard participant journey has five steps. Every approval, purchase, and claim is a separate wallet-confirmed transaction when required by the contract.

  1. 1

    Get BSU

    Open Buy BSU and use the active token claim condition to acquire the market trading token.

  2. 2

    Choose a market

    Review the question, description, options, pool totals, status, and closing time.

  3. 3

    Approve BSU

    If allowance is insufficient, approve the market contract before buying shares.

  4. 4

    Buy a position

    Select Option A or Option B, enter the BSU amount, review, and confirm.

  5. 5

    Settle

    After resolution, eligible wallets claim winnings; cancelled markets use the refund path.

Core terminology

The language of BaseScore

These terms appear throughout the market, portfolio, settlement, and leaderboard interfaces.

Share
A wallet's recorded position on Option A or Option B for a particular market.
Pool
The combined Option A and Option B shares shown for a market.
Probability
The interface's percentage signal derived from each option's share of the visible pool.
Outcome
The resolved option. BaseScore contract actions use 1 for Option A and 2 for Option B.
Claimable
A contract-dependent winning or refundable position that has not already been claimed.

Core concepts

How BaseScore markets work

BaseScore uses a two-outcome, pool-based model. Participants take a side with BSU, and wallets holding the winning side divide the distributable reward according to their share of the winning position.

Simplified reward model

market pool = Option A shares + Option B shares

share ratio = your winning shares / total winning shares

estimated gross reward = share ratio × market pool

The contract is the source of truth for the final payout. The UI can display an estimate from visible pool data, but fees, rounding, claimed state, and the deployed contract's accounting determine the executable result.

Market lifecycle

A visible state from submission to settlement

The market status controls what participants and the owner can do. Cancelled and rejected states remain separate from a normal resolved outcome.

01

Pending

A submitted market waits for the contract owner to approve or reject it.

02

Open

An approved market accepts Option A and Option B share purchases in BSU.

03

Closed

Trading stops after the onchain closing time while the final result is prepared.

04

Resolved

The recorded outcome unlocks contract-calculated claims for winning wallets.

Cancelled or rejected is not a winning outcome. Cancelled markets use claimRefund when a wallet is eligible. Rejected markets never appear as normal resolved markets.

Trading

Buying Option A or Option B shares

A participant chooses an outcome and commits a BSU amount. BaseScore checks balance and allowance before preparing the market transaction.

Option A

Outcome 1

The first answer defined by the market creator.

Option B

Outcome 2

The second answer defined by the market creator.

  • Trading is available only while a market is Open and before its contract closing time.
  • The token approval and the share purchase can require two separate wallet confirmations.
  • The displayed percentage is a pool-composition signal, not an orderbook price or guaranteed return.
  • Wallet shares refresh from getUserShares after confirmed activity.

Settlement

Winnings, refunds, and accrued fees

The settlement center separates normal resolved rewards from cancelled-market refunds and creator or owner fee balances.

Winning claim

claimWinnings uses the connected wallet's recorded winning position for a resolved market.

Cancelled refund

claimRefund returns the eligible position for a market that was cancelled rather than resolved.

Accrued fees

claimAccruedFees sends the connected account's available accrued balance to that same wallet.

BaseScore reads getUserWinningsInfo for the connected wallet, including winning shares, losing shares, and whether the reward was already claimed. Duplicate claims remain disabled.

Create a market

Submit clear, resolvable questions

A standard market submission includes the question, description, category, two options, and closing duration.

Standard creation flow

01

Approve 20 BSU

Approve the exact market-creation amount for the market contract.

02

Submit the market

Confirm the createMarket transaction with the completed fields.

03

Wait for review

The owner approves or rejects the pending submission.

The owner workspace also exposes createMarketByOwner, which creates a market without the standard user token charge.

BSU trading token

The internal currency of BaseScore markets

BSU is the utility token used inside the prediction-market system. It is not presented as BaseScore's governance token, project token, or airdrop token.

BSU

BaseScore market utility unit

Used for

  • Buying Option A or B shares
  • Paying the standard market-creation amount
  • Receiving winning rewards
  • Receiving cancelled-market refunds

Buying BSU

The Buy BSU page reads the token contract's active claim condition, price currency, and allowance requirements before preparing a purchase.

Redeeming BSU

The redeemer path approves the wallet contract, checks backing rules onchain, burns the submitted BSU, and releases the configured reserve asset when eligible.

BSU uses 18 decimals. Reserve assets such as USDC can use a different decimal scale; conversion and collateral checks belong to the deployed redeemer contract, not a browser-side estimate.

Portfolio

Your wallet's market activity in one view

The portfolio combines per-market shares with the connected wallet's aggregate protocol statistics.

Position value

The total visible Option A and Option B shares held across markets.

Active positions

Markets where the wallet has shares and the market remains Open or Closed.

Claimable gross

An estimated gross value derived from visible resolved pools and winning shares.

Protocol activity

Markets created, cumulative shares bought, and markets won from getUserStatistics.

Leaderboard

Three ways to earn a protocol rank

The market contract returns all three top-five groups in one showLeaderboardInfo read. The UI does not manufacture offchain rankings.

Top creators

Ranked by the recorded number of markets created.

Top winners

Ranked by markets won as recorded through successful winning claims.

Top buyers

Ranked by cumulative market shares bought in token base units.

Owner controls

Moderation and outcome recording

Owner functions are shown only when the connected wallet matches the market contract owner. They are governance powers, not normal participant actions.

approveMarket

Approves a pending market so it can enter its tradable lifecycle.

rejectMarket

Rejects a pending submission instead of opening it.

resolveMarket

Records Option A (1) or Option B (2) after the normal closing path.

forceResolveMarket

Owner-only resolution path exposed by the current owner workspace.

BaseScore ID

A contract-ready identity collectible

The NFT minting page is a preview until a verified collection contract is supplied. It intentionally exposes no live mint transaction yet.

Status

Contract pending

Mint price, supply, per-wallet limit, contract address, and final utility remain explicitly marked TBA.

View NFT page

Contract reference

Core actions used by the interface

This is a product-level reference, not a replacement for a verified ABI or deployed source code.

Market discoverymarketCountsReturns the number of markets available to read.
Market detailsgetMarketInfoReturns the market copy, state, outcome, creator, timing, and share totals.
Wallet positiongetUserSharesReturns a wallet's Option A and Option B shares for one market.
Buy positionbuySharesTransfers BSU and records a position for the selected outcome.
Create marketcreateMarketSubmits a user-created market after the required BSU approval.
Claim resultclaimWinningsClaims a resolved market's contract-calculated winning payout.
Claim refundclaimRefundReturns the eligible position for a cancelled market.
Wallet settlementgetUserWinningsInfoReturns wallet-specific winning, losing, and claimed state.
Protocol statsgetUserStatisticsReturns created markets, shares bought, and markets won.
RankingsshowLeaderboardInfoReturns top creators, winners, and share buyers in one read.

Safety

Verify before every transaction

Prediction markets and tokens involve smart-contract and resolution risk. The interface helps expose state, but it cannot remove those risks.

  • Confirm the wallet is connected to Base and review every wallet simulation before signing.
  • Use only verified market, token, redeemer, and NFT contract addresses published by BaseScore.
  • Treat displayed payout values as estimates until the contract call is simulated and confirmed.
  • Owner-controlled resolution is a material trust assumption in the current protocol design.

FAQ

Common BaseScore questions

Short answers to the questions most likely to come up before a first market interaction.

Is BSU the main BaseScore token?

No. BSU is documented as the internal market utility token used for shares, creation, rewards, and refunds.

Can I trade after a market closes?

No. Share purchases are limited to markets that remain Open and have not passed their closing time.

What happens if my market is cancelled?

Eligible wallets use the cancelled-market refund path instead of a normal winning claim.

Why is my win not on the leaderboard yet?

The current contract records won-market statistics through a successful winning claim.

Can I mint BaseScore ID now?

Not yet. The page remains deliberately disabled until the verified NFT contract and mint terms are configured.