Using a Solana app on a phone often means moving between a website, a wallet, and the browser. Every switch can leave users wondering: Did I approve the transaction? Did it go through? Can I continue playing?
A clear interface should make those moments easy to understand.
- Say what the user needs to do
Before opening a wallet, explain the next action in plain language. “Approve transaction in your wallet” is clearer than a vague “Continue.” If the user needs to connect a wallet first, make that a separate step.
- Separate submitted from confirmed
A wallet approval is not the same as a confirmed transaction. Show distinct states, such as “Waiting for wallet approval,” “Transaction submitted,” and “Confirmed.” If something fails, say what failed and what the user can do next.
This avoids a common source of confusion: a button can stop loading even though the user still does not know whether the action succeeded.
- Keep the game context when users return
Wallet apps may open over the browser or switch the user to another screen. When they return, the game should still show what they were doing and what happened next. Avoid resetting the selected side, amount, or round details without explanation.
- Make errors useful
“Something went wrong” gives the player no way to decide what to do. A better message identifies whether the transaction was rejected, failed, or is still processing. Only offer a retry when it is safe to do so; otherwise, explain how to check the existing transaction first.
- Keep the result and the payment status separate
A game result and a payout can be different states. The interface should not show a payout as complete until it is confirmed. If a payment is still processing, label it clearly and let the user inspect the transaction when that information is available.
While building coinflip.bar, a Solana coin-flip game, I’ve learned that a good mobile wallet flow is not just about connecting successfully. It should help players understand each step, recover from interruptions, and know what has—and has not—been confirmed.
The simplest test is to ask: after returning from the wallet, can a player tell what happened and what to do next without guessing?
