Configure wallets and the Base app.
Try it first
Use the intended wallet on the intended chain#
You need A connected EIP-1193 wallet; test ETH and USDC for wallet-funded checkout.
- Read and display the selected payer and Base Sepolia chain 84532.
- Prepare one saved test purchase, then let that wallet approve it.
- Verify the receipt on your backend and check recovery after interruption.
Check your result The original payer, order and test network remain pinned throughout checkout.
Keep wallet login, transaction sends and receipt reads on the same chain. Test keys use Base Sepolia, chain ID 84532.
Provide the wallet#
wallet.provider accepts an EIP-1193 provider from your host. The base-account connector name does not install or construct Base Account for you: use an injected provider or install the host’s Base Account package yourself and pass its provider.
const client = new Playmos({apiKey: publishableTestKey,wallet: { provider },rpcUrl: 'https://sepolia.base.org',});
Pin the login chain#
For a game opened as a web page inside the Base app, wallet login needs a signature; a Farcaster account or manifest is not required for that web-page path. Your wallet configuration, sign-in message and server-side signature verification must all use 84532. The message must also bind your actual domain and URI.
Pin every payment send#
Both wallet_sendCalls and fallback eth_sendTransaction must name Base Sepolia (0x14a34). Check older buy buttons as well. Chain 8453 is Base mainnet and uses real funds. Testnet USDC and mainnet USDC are different contracts.
Use the SDK’s key-selected network and service-provided contract configuration. Do not copy a second contract address into the host. A custom rpcUrl is checked against the key’s chain on first use; a mismatched RPC throws ConfigError.
Gas and approval prompts#
| Path | Gas / prompts |
|---|---|
| Public sandbox server settlement | Playmos test signer pays gas; the player does not need a wallet. |
| Wallet-funded EOA payment | Player needs testnet ETH and USDC; approval may require a separate confirmation. |
| Sponsored wallet payment | Pass gas.mode sponsored and your paymasterUrl; there is no default studio paymaster. |
| Wallet batch fallback | SDK sends the same calls sequentially when batching is unsupported. |
Fund your test wallet#
The no-wallet demo needs no player funds. For wallet testing, get Base Sepolia ETH from the Coinbase faucet and official test USDC from the Circle faucet. Select Base Sepolia each time. The SDK’s Base Sepolia token is official Circle test USDC, 0x036CbD53842c5426634e7929541eC2318f3dCF7e. Check the selected chain and service-provided token before sending. Playmos does not provide a general player faucet.
Test-host boundaries#
A prize pool balance is not a payout. First-party practice hosts keep paid settlement and round alerts disabled during login/entry testing. Your own contest integration chooses when to settle; it must not infer a winner from an open prize pool.
Privy wallet access and backup#
In Account → Wallets, link or reconnect your wallet, read test balances and follow the Base Sepolia faucet links. Choose Open Privy wallet backup to open Privy’s secure export window for your linked embedded wallet. The Hub never receives its private key. External wallets use their own wallet app’s backup settings. See Privy’s wallet export guide.
If it did not work#
Insufficient test funds and unavailable balances are different states. Fund the intended wallet instead of switching it silently.
Try one variation Compare a wallet on the wrong chain with one that lacks test funds. Explain why these need different recovery actions.
Continue with the next guide →