VERSUS
DEMO PLAY ▶

How Versus works

Versus is a coin flip between two players, shown as a drag race. Both players stake the same SOL, a random draw picks a lane, and the winner takes the pot minus the fee. This page explains the rules, the fees, how the draw is made and checked, and what happens to your stake in every case.

Versus is played with SOL from your own wallet. Every stake is held by the Versus program on Solana until the race is settled or refunded.

You are on the demo build. It runs on play credits in your browser, with no wallet and no real money. The rules below are the rules of the game; the section "This demo build" lists what the demo does differently.

How to play

  1. Connect a wallet. Any Solana wallet that supports the Wallet Standard works, for example Phantom. Versus never sees your keys. Your wallet shows you every transaction before you approve it.
  2. Pick a table. Each table has one fixed stake. Both players put in the same amount.
  3. Call a lane. Left or right, like heads or tails. Your rival gets the other lane. This is the only choice that affects the result.
  4. Pick a car. Cars are looks only. They never change the odds.
  5. Watch the race. The draw picks a lane before the lights go green. The car in that lane wins, and the winner takes the pot minus the fee.

Versus is luck, not skill. Revving while you wait does nothing. A streak is a run of coin flips and says nothing about the next race.

How you meet a rival

Each table shows how many players are waiting at it. The number is counted from the open races on the chain. When you pick a table, Versus first looks for someone already waiting there:

  • If a rival is waiting on the other lane, you join their race straight away.
  • If a rival is waiting on the lane you called, you choose: take the other lane and race now, or keep your lane and wait for someone else. Your call is never changed for you.
  • If nobody is waiting, your race opens and waits for a rival for up to 10 minutes.

Tables, stakes and the pot

There are four tables open to everyone: 0.1, 0.5, 1 and 5 SOL. The lobby features one of them so that players meet in one place instead of waiting in four separate queues. Three more tables, at 5, 10 and 50 SOL, are VIP tables for $VS holders.

The fee is 2.5% of the pot, which is the same as 2.5% of each player's stake. A winner who holds $VS pays 1% instead. The winner's own rate applies to the whole pot, so a win pays 1.95 times your stake at the standard rate and 1.98 times at the holder rate. The loser pays nothing beyond the stake.

The fee rate of a race is fixed when the race is opened. A later change to the fee does not touch a race that already exists.

Pot calculator

Half of every fee (50%) is set aside to buy $VS on the market and burn it. The other half goes to the Versus treasury.

The split happens inside the settlement transaction: the program sends one half to the treasury wallet and one half to the buyback wallet, and adds both to running totals that anyone can read. The buying and burning itself is done from the buyback wallet. It is not automatic.

$VS holders and VIP tables

A wallet counts as a holder when it holds at least 0.1% of the $VS supply. Holders get two things:

  • The 1% fee. When a holder wins, the fee on the pot is 1% instead of 2.5%, at every table.
  • VIP tables. The 5, 10 and 50 SOL VIP tables can only be opened and joined by holders. Both players at a VIP table are holders, so the fee there is always 1%.

Other holder perks are cosmetic: paint, underglow, win animations. The odds are the same for everyone, at every table.

How holding is checked

The program checks your $VS balance itself, in the same transaction that takes your stake. Versus looks for a $VS token account in your wallet and passes it along; the program reads the balance and decides. Nothing has to be locked or staked, and the tokens never leave your wallet.

The check is made at the moment you pay in, and that answer is kept for the race. Buying $VS after you have paid in does not change a race already open. A frozen token account does not count.

The current $VS address, the minimum balance and the VIP tables are listed under "On-chain facts" below. Until the $VS address is set in the program, nobody counts as a holder and the VIP tables stay closed.

In the demo there is no token. The fee button in the garage is a preview switch that shows the 1% rate, and the VIP tables are shown but cannot be played.

The fair draw

The result must not depend on trusting either player, the website or Versus. The draw comes from ORAO VRF, an independent network of oracles that produces verifiable random numbers on Solana.

  1. Open. The first player pays the stake into a new match account and calls a lane. No randomness exists yet.
  2. Join. The second player pays the same stake. In that same transaction the program asks the oracle network for a random value. From here the race cannot be cancelled.
  3. Seed. The request is tied to a seed: the SHA-256 hash of the match address, the joining wallet and 32 random bytes from the joining player's device. The seed only makes the request impossible to prepare in advance. It cannot steer the result.
  4. Draw. The oracles sign the seed. Their signature is the random value: 64 bytes that nobody outside the oracle network can compute, and that the oracle program verifies on-chain before storing it. It usually arrives within a few seconds.
  5. Result. If the first byte of the random value is even, the left lane wins. If it is odd, the right lane wins. Half of all byte values are even, so each lane wins half the time.

Neither player picks the random value, and neither does Versus. The program reads it from the oracle's account and pays out by that rule alone.

Every finished race has a receipt with the settlement transaction. That transaction's log contains the full random value, the winning lane, the payout and both fee shares.

The result must not depend on trusting either player or the page. The demo uses a method called commit and reveal:

  1. Lock. Side A makes a secret random seed and shows only its fingerprint, the SHA-256 hash of the seed. The fingerprint is fixed before anyone joins.
  2. Join. Side B joins with a random seed of their own. B cannot see A's seed, only its fingerprint.
  3. Reveal. Side A reveals the seed. Anyone can hash it and see that it matches the fingerprint, so A could not have swapped it after seeing B's seed.
  4. Draw. The two seeds are joined with a colon and hashed: SHA-256("seedA:seedB"). If the first byte of the result is even, the left lane wins. If it is odd, the right lane wins.

Neither side can steer the result, because each seed was fixed before the other was known. Half of all byte values are even, so each lane wins half the time.

Every finished race has a receipt that lists the fingerprint, both seeds and the hash, and re-checks all three steps on the spot.

Limit of the demo: in a quick race the rival is simulated, so both seeds come from your own browser. That receipt shows the method but is not an independent guarantee. In a friend match the two seeds come from two devices and the check is real. The on-chain game uses an independent oracle network instead.

Check a draw yourself

Open the receipt of any race and follow the settlement transaction to the explorer. In its log, the settled event lists the random value. You can also read it from the oracle's request account for that race.

Paste the random value below, or only its first two characters. The sum runs in your browser and nothing is sent anywhere.

Draw checker

Paste the values from any receipt. The sums run in your browser and nothing is sent anywhere. You can also do it in a terminal: printf '%s' 'seedA:seedB' | shasum -a 256

Draw checker

Friend matches

You can race a specific person by link. The demo has no server to pass messages, so a friend match takes three links:

  1. Challenge. You pick a table, call a lane and send the link. It carries your stake, your lane and your seed's fingerprint.
  2. Reply. Your friend opens it, picks a car and accepts. They send a link back that carries their seed.
  3. Result. You open the reply. The draw is made and you see the race. You send the last link, which reveals your seed, so your friend's side can check it and settle too.

You can set a nickname under History, then Records. It travels in your links so friends see who challenged them. It is the only thing you type that leaves your browser.

A result link that does not match the locked fingerprint is rejected.

Cancels, timeouts and refunds

Your stake is only ever in one of three places: your wallet, the match account of your race, or the winner's wallet. The program has no other place to send it.

SituationWhat happens
You cancel before a rival joinsFull stake back, no fee
Nobody joins within 10 minutesFull stake back, no fee
A rival has joinedThe draw is requested. The race can no longer be cancelled
The oracle delivers no draw within 10 minutes of the joinBoth stakes go back in full, no fee
You close the page while waitingThe race stays open on-chain. It is in the lobby when you connect again, or already refunded
You close the page after a rival joinedThe race is settled without you. If you won, the pot is in your wallet
New races are paused by the adminRaces already open can still be settled, cancelled and refunded

The keeper

A refund or a payout is a transaction, and somebody has to send it. The program lets anyone send these three, because the money can only go where the rules say:

  • return the stake of a race that nobody joined in time,
  • pay out a race whose draw is in,
  • return both stakes of a race whose draw never came.

Versus runs a small service called the keeper that watches the open races and sends these transactions, so a timed-out stake comes back without you doing anything. It pays out a drawn race one minute after the join if neither player has collected by then. If the keeper is ever down, the buttons on the site do the same job: the lobby shows any race of yours that is waiting to be refunded or collected.

SituationWhat happens
You cancel before a rival joinsFull stake back, no fee
Quick race, nobody joins in 60 secondsFull stake back
Invite, nobody joins in 15 minutesFull stake back
You joined a friend, no result link within 15 minutes of the invite's expiryFull stake back
Both seeds are inThe draw is made. The match can no longer be cancelled
You close the page while waitingThe race is still open when you return, or refunded if it timed out
You close the page mid-raceThe draw was already made. The same race and result play when you return

Every one of these leaves a receipt in your history.

What a race costs

Besides the stake, a race involves a few small amounts that do not go to Versus:

CostWho paysAmount
Versus feeThe winner, out of the pot2.5% of the pot, or 1% for a $VS holder
Oracle fee for the drawThe player who joinsAbout 0.0005 SOL, set by the oracle network
Deposit for the match accountThe player who opens the raceAbout 0.0022 SOL, returned when the race closes
Deposit for your player recordYou, once, on your first raceAbout 0.0015 SOL, not returned
Solana network feeWhoever sends each transactionAbout 0.000005 SOL per transaction

The site keeps 0.01 SOL of headroom in your wallet for these when it checks whether you can afford a table.

How the race is built

The race is a show. It never decides anything. The order is always: draw first, race second.

  • Byte 0 of the draw picks the winning lane.
  • Bytes 1 to 3 only style the race: how far the lead swings mid-race (8 to 15 metres) and the winning margin (9 to 21 metres).
  • Both cars follow one speed curve over a 402 metre strip in 7.2 seconds. The gap between them is added on top, so the car in the drawn lane is always in front at the line.
  • The last 16 metres play in slow motion, then a photo-finish freeze.

Because the race is built only from the draw, the same draw always produces the same race.

In a test of 20,000 simulated draws, the left lane won 49.6% of the time and the animation agreed with the draw every time.

The scene is drawn in code on a low-resolution canvas and scaled up without smoothing: a pseudo-3D road, a three-layer skyline, roadside buildings and six car models. Apart from the logo there are no image files.

What the program can do

The rules live in a program on Solana, not on this website. The website only builds transactions for your wallet to approve.

What nobody can do

  • Nobody, including the Versus admin, can move a stake anywhere except back to its player or, on a settled race, to the winner and the two fee wallets.
  • Nobody can choose or change the random value. The program only accepts the value stored by the oracle program for that race's seed.
  • Nobody can change the fee or the fee split of a race that is already open.

What the admin can do

  • Pause new races. Races already open still settle, cancel and refund.
  • Change the tables, the fee (never above 10% of the pot) and the two fee wallets, for races opened afterwards.
  • Set the $VS address, the holder minimum, the holder fee (never above the standard fee) and the VIP tables.

Risks you should know

  • You can lose your whole stake on any race. That is the game.
  • The program can be upgraded by the wallet that deployed it. An upgrade could change the rules above.
  • The program has automated tests for every rule on this page, but it has not had an independent security audit.
  • The draw depends on the ORAO oracle network. If it stops answering, races are refunded after 10 minutes and no new race can finish until it is back.
  • The holder check reads your balance at the moment you pay in. It does not stop someone from holding $VS only for that moment.

On-chain facts

These values are read from the program each time this page loads, so they are always the ones in force.

Status
Reading from the network…

History, records and fees inside the game: History is the list of receipts kept in this browser. Records ranks wallets by races run, from counts the program keeps. Fees shows the program's running totals for the treasury and the buyback wallet.

This demo build

This demoThe on-chain game
MoneyPlay creditsSOL from your wallet
Quick-race rivalSimulatedAnother player at the same table
The drawCommit and reveal in the browserORAO VRF, an independent oracle network
SettlementNone; credits change in your browserA transaction on every receipt
Open challengesOnly your own and links you openEveryone waiting at each table
$VS holder rateA preview switchChecked by the program from your $VS balance
VIP tablesShown, not playable5, 10 and 50 SOL, holders only
RecordsPersonal records and friendsRanked by races run, counted by the program
FeesWorked out, never collectedSplit on-chain at every settlement

Questions

Does my car or revving change my chances?

No. Only the draw decides, and it is 50/50.

Does it matter which lane I call?

Each lane wins half the time. The call matters the way calling heads or tails matters: it is your side of the flip.

Does Versus hold my SOL?

No. Your stake sits in the match account of your race, which only the program controls, until the race is settled or refunded. Versus has no key that can move it.

I closed the page with a race open. Where is my stake?

Either still in the race, or already back in your wallet. Connect the same wallet and look at the lobby: a race that is still open or timed out is listed there with a button to open or refund it.

Why did I get a little less than my stake back after cancelling?

The stake and the match deposit come back in full. The Solana network fee for the transactions, and the one-time deposit for your player record on your first race, do not.

Can I race a specific friend?

Not by invitation yet. For now, agree on a table and opposite lanes: one of you opens the race and the other picks the same table. Another player could join first.

Where is my history stored?

Receipts are kept in this browser, and each one links to its transaction on the chain. Clearing site data removes the list but not the transactions. Your race counts are kept by the program.

Where is my history stored?

In this browser only. Clearing site data removes it. You can download it from the History tab.

Can I play for real money here?

Not on this build. Nothing on the demo takes or pays real money.

Is Versus connected to another game or studio?

No. Versus is an original game and is not affiliated with any other game, studio or publisher.