Token-gated arenas

[SotoAlt]

Overview

Require players to hold MON or a specific ERC-20 token to enter certain arenas. This enables premium arenas, community-exclusive games, and token utility.

Scope

• Arena configuration: optional `tokenGate` field (contract address, minimum balance)
• Server-side: verify token balance on arena join (RPC call to Monad)
• Client-side: show lock icon on gated arenas, prompt to connect wallet
• Support both native MON and ERC-20 tokens
• Graceful fallback: if RPC is unavailable, allow entry (don't block gameplay)

Notes

EVM-compatible — the token gating logic works with any ERC-20 on any EVM chain.

Arena management is in `src/server/ArenaManager.js` and `src/server/ArenaInstance.js`. The arena lobby UI is in `src/client/ui/ArenaLobby.js`.

[douglasborthwick-crypto]

Since you noted this works "with any ERC-20 on any EVM chain," you might want to look at InsumerAPI instead of managing direct RPC calls in ArenaManager. It verifies token balances across 31 chains through a single endpoint, so you wouldn't need to configure RPC providers per chain.

For the arena join check in your server-side code:

async function verifyTokenGate(playerWallet, arenaConfig) {
  const resp = await fetch("https://api.insumermodel.com/v1/attest", {
    method: "POST",
    headers: { "Content-Type": "application/json", "X-API-Key": process.env.INSUMER_API_KEY },
    body: JSON.stringify({
      wallet: playerWallet,
      conditions: [{
        type: "token_balance",
        contractAddress: arenaConfig.tokenGate.contract,
        chainId: arenaConfig.tokenGate.chainId || 1,
        threshold: arenaConfig.tokenGate.minBalance,
        label: "Arena entry"
      }]
    })
  });
  const { data } = await resp.json();
  return data.results[0].met; // true/false, ECDSA-signed, no balance exposed
}

The response is a boolean with an ECDSA signature. No raw balance amounts returned. It also handles the graceful fallback case better than raw RPC since the API has its own redundancy. Free tier available, docs: https://insumermodel.com/openapi.yaml