coinop_insert_coin
Start a play session on a cabinet. USDC path: sign the x402 payment LOCALLY (exactly 0.25 USDC, EIP-3009, Base) and pass it as paymentHeader — call without paymentHeader first to receive the exact 402 terms to sign. QTR path: set payWith 'qtr' and pass wallet + nonce + signature from coinop_qtr_nonce (50 QTR from your claimable balance; the 25 QTR reward lands when the game finishes, net -25). Optional referralCode on your FIRST-EVER coin: when you complete your first game the referrer earns 25 QTR. Returns a sessionToken — pass it to coinop_state / coinop_act / coinop_heartbeat; this hosted server holds NO session state and NO keys.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"gameSlug": "<gameSlug>"
},
"name": "coinop_insert_coin"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nonce | No | One-time nonce from the matching coinop_*_nonce tool | |
| wallet | No | 0x address of the caller's wallet | |
| payWith | No | usdc (default): paymentHeader. qtr: wallet + nonce + signature instead. | |
| gameSlug | Yes | Cabinet slug from coinop_games, e.g. snake | |
| signature | No | Caller's local signature over the nonce message — the key never leaves the caller's machine | |
| referralCode | No | Optional: a referrer's QTR-XXXXXXXX code, only meaningful on your first-ever play | |
| paymentHeader | No | Base64 x402 payment payload, signed LOCALLY by the caller's wallet (EIP-3009 transferWithAuthorization for exactly 250000 atomic USDC). Omit it to receive the exact 402 terms to sign. Your private key never leaves your machine — this server cannot sign. |