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
- 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.
- Pick a table. Each table has one fixed stake. Both players put in the same amount.
- 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.
- Pick a car. Cars are looks only. They never change the odds.
- 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.
- Open. The first player pays the stake into a new match account and calls a lane. No randomness exists yet.
- 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.
- 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.
- 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.
- 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:
- 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.
- Join. Side B joins with a random seed of their own. B cannot see A's seed, only its fingerprint.
- 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.
- 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:
- Challenge. You pick a table, call a lane and send the link. It carries your stake, your lane and your seed's fingerprint.
- Reply. Your friend opens it, picks a car and accepts. They send a link back that carries their seed.
- 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.
| Situation | What happens |
|---|---|
| You cancel before a rival joins | Full stake back, no fee |
| Nobody joins within 10 minutes | Full stake back, no fee |
| A rival has joined | The draw is requested. The race can no longer be cancelled |
| The oracle delivers no draw within 10 minutes of the join | Both stakes go back in full, no fee |
| You close the page while waiting | The race stays open on-chain. It is in the lobby when you connect again, or already refunded |
| You close the page after a rival joined | The race is settled without you. If you won, the pot is in your wallet |
| New races are paused by the admin | Races 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.
| Situation | What happens |
|---|---|
| You cancel before a rival joins | Full stake back, no fee |
| Quick race, nobody joins in 60 seconds | Full stake back |
| Invite, nobody joins in 15 minutes | Full stake back |
| You joined a friend, no result link within 15 minutes of the invite's expiry | Full stake back |
| Both seeds are in | The draw is made. The match can no longer be cancelled |
| You close the page while waiting | The race is still open when you return, or refunded if it timed out |
| You close the page mid-race | The 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:
| Cost | Who pays | Amount |
|---|---|---|
| Versus fee | The winner, out of the pot | 2.5% of the pot, or 1% for a $VS holder |
| Oracle fee for the draw | The player who joins | About 0.0005 SOL, set by the oracle network |
| Deposit for the match account | The player who opens the race | About 0.0022 SOL, returned when the race closes |
| Deposit for your player record | You, once, on your first race | About 0.0015 SOL, not returned |
| Solana network fee | Whoever sends each transaction | About 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 demo | The on-chain game | |
|---|---|---|
| Money | Play credits | SOL from your wallet |
| Quick-race rival | Simulated | Another player at the same table |
| The draw | Commit and reveal in the browser | ORAO VRF, an independent oracle network |
| Settlement | None; credits change in your browser | A transaction on every receipt |
| Open challenges | Only your own and links you open | Everyone waiting at each table |
| $VS holder rate | A preview switch | Checked by the program from your $VS balance |
| VIP tables | Shown, not playable | 5, 10 and 50 SOL, holders only |
| Records | Personal records and friends | Ranked by races run, counted by the program |
| Fees | Worked out, never collected | Split 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.
