x402 agent path
Agents can request Torinox randomness over HTTP 402 instead of sending ETH themselves. The paid price is fixed $0.05 USDG via Primer on Robinhood Chain. The gateway sponsors the exact onchain requestV2 fee. Direct onchain requests remain fully supported.
| Network | Robinhood Chain mainnet |
| Chain ID | 4663 |
| Oracle (TorinoxEntropy v10) | 0xd8a0680e7699526b57140ed4eafdcc7219dc0a0c |
| Provider / keeper | 0x8741b8a825644D9Ef18Faf2DAB5e9b47B900F2b6 |
| Fee | exact 0.000025 ETH via getFeeV2() |
| Refund delay | 6 L1 blocks (~60-90s) |
| Hash chain length | 500,000 registered |
| SDK | @diceprotocol/sdk |
| Agent paid path | $0.05 USDG fixed over x402 |
Endpoints
POST https://diceprotocol.world/x402/v1/randomPOST https://diceprotocol.world/x402/v1/random/freeGET https://diceprotocol.world/x402/v1/infoGET https://diceprotocol.world/x402/healthGET https://diceprotocol.world/x402/v1/subscription/0x...
Asset USDG 0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168 · network eip155:4663 · facilitator https://x402.primer.systems · payTo 0x4ACD2C88a239a924E47Fc4995114ca1Bb0CA3CaD
Stake credits
Lock $TORINOX in TorinoxStake to earn a score. Free daily credits are tracked on TorinoxQuota (UTC day) and consumed before the gateway sponsors randomness. Overflow and non-stakers pay $0.05 USDG.
- Score 1 · ≥ 100,000 $TORINOX · 50 free / UTC day
- Score 2 · ≥ 1,000,000 $TORINOX · 150 free / UTC day
- Score 3 · ≥ 10,000,000 $TORINOX · 400 free / UTC day
- Score 4 · 10M + lock ≥ 30 days · 1000 free / UTC day
Stake 0xc091ce59cAC1112A30e4344ced039c25B6cfa174
Quota 0x825AC2A5Ca8D8A6E56dF418C3227a72bD39830F3
Stake UI: /stake/. Free call uses personal_sign of dice:x402:free:{address}:{YYYY-MM-DD}.
Direct onchain path
Integrators who do not want HTTP 402 still call requestV2 with exact ETH from getFeeV2(). See /docs/quickstart/.
// Info document for agents GET https://diceprotocol.world/x402/v1/info
Home · RNG for Robinhood Chain · Docs · Architecture · Security · SDK · x402 · GitHub