Reserved Balance
Reserved Balance is the amount a player has deliberately made available to Ranked competition. It is held for one Main Wallet and one stake asset, and it is separate from both ordinary wallet balance and Rank Signer execution float.
Not sure whether Main Wallet and Rank Signer are the same address? See Login & Ranked Setup for the distinction between provider-login and external-wallet accounts.
The Three Balances
Section titled “The Three Balances”| Balance | Purpose |
|---|---|
| Main Wallet balance | Permanent player funds and the fallback source for an explicitly approved top-up |
| Embedded wallet or Rank Signer balance | Pays permitted transaction fees and may fund reserve when it holds the matching asset |
| Reserved Balance | Player-approved stake value available to exact backend-authorized matches |
For a provider-login account, the first two rows refer to the same embedded Main Wallet. For an external-wallet account, Main Wallet and Rank Signer are different addresses belonging to the same player account.
What Happens When a Match Starts?
Section titled “What Happens When a Match Starts?”Only the selected stake is moved into the match when the roster freezes and the on-chain match is created.
For example, suppose a player has 1,000 tokens in Reserved Balance and joins
a room with a 10 token stake:
10is locked for that match.990remains available Reserved Balance.- The remaining
990can still be withdrawn or used for another eligible match after participation rules allow it.
This can happen when a player previously prepared for a 1,000 token room,
canceled before lock, and then selected a 10 token room. Leaving matchmaking
before lock does not consume the reserve.
Find Match or Sit in a Hosted Room
Section titled “Find Match or Sit in a Hosted Room”When the player requests admission:
- The client reads the exact room configuration and available Reserved Balance.
- If reserve already covers the stake, admission can continue immediately.
- If reserve is short, the selected executor may fund the missing amount when it holds the matching asset and can pay the transaction cost.
- Otherwise, Main Wallet must explicitly approve the top-up.
- The server independently checks the exact configuration and Reserved Balance before accepting the player.
A program cannot silently debit Main Wallet. Registration also does not move stake: Rank Signer authorization and Reserved Balance funding are separate actions.
Video Reference
Section titled “Video Reference”The 0.02 SOL execution floor is not part of Reserved Balance and is not part
of the selected match stake.
Next: Ranked Matchmaking and Claims & Payouts.