Connect and get test funds
Set up your wallet, switch networks and understand the two tokens.
You need an EVM wallet connected to Somnia Shannon to trade. Browsing markets, Practice and the two arcade games work without one.
| Token | What you use it for | Where to get it |
|---|---|---|
| tUSDC | Test stakes, trading balances and supported reserves | The app's Get test funds dialog |
| STT | Testnet transaction fees | An eligible in-app top-up, or an external STT faucet |
The funding dialog checks STT first, then mints test collateral. It is not a card payment, bank transfer or bridge for real USDC.
Earlier funding-dialog capture: the receiving wallet and external faucet link are in the same panel. The current Get test funds flow also checks STT and offers an eligible gas top-up, as described below.
- 1Confirm the wallet receiving the test collateral.
- 2Mint the displayed amount of free test tUSDC.
- 3Use the Somnia faucet link if you need STT for gas.
Connect the right account
- Choose Connect in the header.
- Select a wallet from the connection dialog and approve access to your address.
- Confirm that the address shown is the one you want to use.
- If Wrong network appears, choose Switch to Somnia Shannon and approve the switch in your wallet.
Changing wallets also changes which positions, balances and permissions the app can show. A different wallet cannot collect the original wallet's funds.
Get test funds in one flow
- Open the header balance pill, or go to Portfolio and choose Get test funds.
- Check the receiving address and select Somnia Shannon if asked. The dialog shows separate tUSDC and STT balances; unavailable is different from zero.
- Choose Get test funds. A wallet below 1 STT can receive enough to reach 2 STT, subject to availability.
- If eligible, sign the Masayume testnet gas request message. This proves wallet ownership and costs no gas. Wait for the STT transfer to confirm.
- Confirm the separate 10,000 tUSDC faucet transaction in your wallet. This transaction uses some STT for network fees.
- After confirmation, choose Trade from wallet →.
A wallet can receive one STT top-up per rolling 24 hours. Masayume distributes at most 40 STT across all wallets in that period and retains a 10 STT reserve. For example, a wallet holding 0.5 STT receives 1.5 STT; a wallet holding 1 STT or more skips the top-up. Shared connections also have a request cap.
If the allocation is exhausted or waiting for a refill, the panel offers external STT faucets. A wallet that already has sufficient gas can still mint tUSDC. Both assets stay on Shannon testnet.
The minted tUSDC lands in your wallet. Moving it into Trading Balance, a strategy, X-trade or a private pool is a separate action. This top-up funds the connected owner wallet; it does not automatically fund a browser key.
If only the first step completes
Cancelling the tUSDC transaction does not undo a confirmed STT top-up. Retry to continue the mint with the gas already received. A saved STT transfer keeps its transaction hash across retries and server restarts; the service checks or rebroadcasts that same transfer rather than paying again. The wallet's cooldown still applies after clearing browser storage.
If a tUSDC mint itself has an unknown result, check its explorer receipt before requesting another mint. The STT recovery protection does not make a new tUSDC transaction safe to repeat blindly.
Understand wallet prompts
A connection shares your address. A message signature proves that address approved some text, such as a public take or a room login. A token approval allows a named contract to spend the token within the approved amount. A transaction changes chain state and may cost STT.
Read the app's receipt when enabling a browser key or an agent: it names the spending limits and expiry. Tap-trading explains why later buys can happen without another owner prompt.
When setup gets stuck
- No gas: open Get test funds, even if you already have plenty of tUSDC. If the allocation is unavailable, use its external STT faucet links.
- Balance is still loading: wait for the read to finish; an unread balance is not proof of zero.
- Signature rejected: the requested action was not signed. Keep the amount and try again when ready.
- Submitted, then disconnected: reconnect the same address and check the transaction before resubmitting.
Continue with your first trade or where your money is held.
Source notes
This guide follows the application code reviewed on 2026-09-07. Links point to that reviewed commit and require repository access. GitHub may show 404 if you are signed out or do not have access.