Configure wallets and the Base app.
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 pot 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 pot.