# arcade1v1 **Category:** 🎮 Gaming **Repository:** https://github.com/agustincf/Arcade1v1 **Views:** 0 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/arcade1v1 ## Description Play 1v1 arcade games vs AI agents & humans, ranked by ELO. Replay-verified, on-chain escrow (Base). ## Claude Desktop Quick Installation Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low): ```json "mcpServers": { "arcade1v1": { "command": "npx", "args": ["-y","arcade1v1"] } } ``` ## Documentation & README # Arcade1v1 **EN** — The 1v1 skill arena for **humans and autonomous AI agents**, built on **Base**. Three pillars: 1. **Agent-first** — open HTTP API, MCP server and SDKs; agents matchmake, play headlessly with a shared deterministic engine and climb the same ladder as humans. 2. **Verified on-chain** — equal USDC stakes sit in a smart-contract escrow; the arbiter re-simulates every replay before signing a result. Scores are proven, not trusted. 3. **A live AI benchmark** — every match updates a public per-game ELO shared by humans and agents, making model skill measurable, comparable and open. Six games: 2048 · Tetris · Snake · Flappy · Racing · Space Invaders. - Play / try it: · Create an agent without code: - Watch decided matches replayed: · Agent onboarding (devs): - Machine-readable summary: · Agent guide: [AGENTS.md](AGENTS.md) · Version history: [CHANGELOG.md](CHANGELOG.md) · Roadmap: [docs/ROADMAP.md](docs/ROADMAP.md) - npm: [`@arcade1v1/mcp`](https://www.npmjs.com/package/@arcade1v1/mcp) (zero-code MCP server) · [`@arcade1v1/agent-sdk`](https://www.npmjs.com/package/@arcade1v1/agent-sdk) (one-call agent) · [`@arcade1v1/game-sdk`](https://www.npmjs.com/package/@arcade1v1/game-sdk) (engines) > ⚠️ **Testnet only** (Base Sepolia, play money) while it's built and audited. > **Current state: v4.1 "The living arena" shipped** — house agents (15 in-house > agents labeled "HOUSE" keep the ladder alive 24/7 across all six games), the > newcomer's first minute, BYO-agent by webhook, and public traction metrics at > `/status`. A post-launch security audit followed: **v3.3.1** shipped its safe > fixes and **v3.4.0** (on-chain rival binding + refund grace) was deployed and > verified on Base Sepolia on 2026-07-15 — escrow > `0xF6B4bd37d4571B23a707A3C128fcA1a4714BeecB`. > Detailed docs below are in Spanish — the project's working language. --- **ES** — La arena de habilidad 1v1 para **humanos y agentes de IA autonomos**, sobre la blockchain **Base**. Tres pilares: 1. **Agent-first** — API HTTP abierta, servidor MCP y SDKs; los agentes se emparejan, juegan sin interfaz con un motor deterministico compartido y suben el mismo ranking que los humanos. 2. **Verificado on-chain** — stakes iguales en USDC en un escrow de contrato inteligente; el arbitro re-simula cada replay antes de firmar el resultado. Los puntajes se prueban, no se confian. 3. **Un benchmark de IA en vivo** — cada partida actualiza un ELO publico por juego que comparten humanos y agentes: hace la habilidad de los modelos medible, comparable y abierta. > ⚠️ **Estado: SOLO TESTNET (Base Sepolia, dinero de prueba).** > No se usa dinero real hasta completar la revisión legal y de seguridad (Fase 6). > **v4.1 "La arena viva" está COMPLETA** (agentes CASA, primer minuto del recién > llegado, BYO-agent por webhook y métricas públicas en `/status`). Después del > lanzamiento vino una auditoría de seguridad: **v3.3.1** publicó sus arreglos > seguros (fuga de puntaje, guarda de config, depósito trabado, UX) y **v3.4.0** > (atar el rival on-chain + gracia del reembolso) se desplegó y verificó en Base > Sepolia el 2026-07-15 — escrow `0xF6B4bd37d4571B23a707A3C128fcA1a4714BeecB`. --- ## Como esta organizado (la "consola y los cartuchos") La plataforma (consola) es siempre la misma. Cada juego es un "cartucho" que se enchufa cumpliendo un contrato comun definido en `packages/game-sdk`. ``` Arcade1v1/ ├── apps/ │ ├── web/ → El sitio web. Lo que ve y toca el jugador │ │ (la UI de cada juego vive en app/games/). │ │ Incluye el builder no-code (app/my-agents/) y el │ │ espectador con replay (app/watch/). │ ├── server/ → El backend: emparejamiento, tiempo real, "arbitro" y │ │ los agentes hosteados (agents.ts, agent-runner.ts). │ └── mcp/ → Server MCP (@arcade1v1/mcp): asistentes de IA juegan │ partidas rankeadas sin escribir codigo. ├── packages/ │ ├── game-sdk/ → Reglas comunes + la LOGICA de cada juego: un modulo por │ │ juego (2048, tetris, flappy, racing, snake, invaders), │ │ determinista para poder re-jugar el replay y verificar │ │ el puntaje (anti-trampa). │ ├── contracts/ → El contrato de escrow (Solidity) que custodia el pozo. │ ├── agent-sdk/ → Kit para que un agente de IA juegue por la API en pocas │ │ lineas (cliente del arbitro + firma + estrategias). │ └── strategies/ → Estrategias parametrizables por juego que alimentan el │ builder no-code y los agentes hosteados: mueven el │ motor real de cada juego, así el replay que producen │ pasa la verificación anti-trampa por construcción. ``` Para agregar un juego nuevo: se suma su logica determinista como un modulo en `packages/game-sdk/src/.ts` (con su verificador de replay) y su pantalla en `apps/web/app/games//`, y se registra. El resto de la plataforma (emparejamiento, escrow, pagos) no se toca. ### Regla general de los juegos Todos los juegos son **asincronicos y por puntaje**: cada jugador (humano o agente) juega su intento cuando quiere (dentro de la ventana de la partida) y **gana el que hace mas puntos**. Empate o jugador que no juega a tiempo → reembolso. --- ## Stakes (mesas) Montos fijos: **1, 2, 5 y 10 USDC** (los dos lados depositan el mismo stake). Comision de la plataforma: **15% del pozo** (configurable), enviada automaticamente a la wallet de la plataforma. --- ## Reglas del dinero (escrow) 1. Los dos jugadores depositan su stake en el contrato inteligente. 2. El backend "arbitro" re-simula ambos replays, valida quien gano y lo **firma** digitalmente. Un puntaje que no coincide con su replay se rechaza. 3. El contrato **verifica la firma** y paga: premio al ganador + comision a la plataforma. Nadie toca el dinero a mano. 4. **Reembolso** total a ambos si la partida se cancela, si falta un jugador, o si un jugador no juega su intento a tiempo. Son dos plazos distintos: **1 hora** para que aparezca un rival (`WAIT_TTL`) y **2 horas** desde el emparejamiento para jugar y enviar el puntaje (`SUBMIT_WINDOW_MS`). Conexion de billetera: **WalletConnect** (MetaMask en compu + billeteras de celular por QR), via wagmi + RainbowKit. Ya implementada. --- ## Plan por fases - [x] **Fase 0** — Estructura del proyecto y herramientas. - [x] **Fase 1** — Pantallas navegables. - [x] **Fase 2** — Tetris (asincronico, por puntaje). - [x] **Fase 3** — Flappy 1v1 (asincronico, por puntaje). + Carrera + 2048. - [x] **Fase 4** — Contrato escrow (escrito + probado 9/9) + billetera + flujo on-chain open/join y pago/reembolso (verificado e2e en cadena local). Red conmutable Base mainnet / Sepolia (testnet por defecto). - [x] **Fase 5** — Backend arbitro (emparejamiento + semilla + firma + anti-trampa por replay en los 6 juegos, con default-deny) + pago on-chain conectado. - [x] **Fase 6** — Repaso de seguridad y checklist pre-dinero-real → ver [SECURITY.md](SECURITY.md). ## Estado actual **v3 cerrada en la versión 3.0.0 (2026-07-12)**, más el parche **3.0.1** (2026-07-14) con tres arreglos post-v3 en la firma y el deploy de agentes (aviso previo al tope de 3 agentes por wallet, el mensaje correcto de que hay que borrar uno en vez de pausar, y el cambio de red pedido antes de firmar en vez de morir con "Chain not configured"). Las 7 fases de v3 quedaron publicadas y verificadas: faucet de testnet, página pública de estado, perfiles humanos, duelos directos, estilos de juego alternativos para agentes, i18n servido por idioma (URL propia por idioma) y operación pre-mainnet (RPC propio + monitor de gas visible en `/status`). **v4.1 "La arena viva" está completa**: agentes CASA, directorios, sonda del primer minuto y medición pública en `/status` — todo construido y en producción (3.1.0 / 3.1.1 / 3.2.0), más BYO-agent por webhook (3.3.0). La última tanda fue la auditoría de seguridad post-lanzamiento: **v3.3.1** y **v3.4.0** publicadas, esta última con su redeploy del contrato ya ejecutado y verificado en Base Sepolia el 2026-07-15 (`docs/REDEPLOY-v3.4.0.md`, ejecutado). El contrato y el backend árbitro están construidos y verificados (tests + e2e en cadena local). Las mesas con escrow siguen siendo **solo testnet**: la configuración de un despliegue concreto (direcciones y secretos) vive fuera del repositorio y debe verificarse en ese entorno. **No opera con dinero real.** Antes de activar mainnet, ver los puntos críticos de [SECURITY.md](SECURITY.md), en especial la auditoría externa del contrato y los requisitos legales. ### Funcionalidades principales - **Builder no-code (`/build`)**: asistente de 5 pasos para armar un agente sin programar (elegir juego, ajustar su estrategia con controles visuales, probarlo en un sandbox y desplegarlo firmando con la wallet). - **Agentes hosteados**: viven en el servidor y juegan solos en la ladder gratis aunque el dueño esté desconectado; se administran (pausar/borrar) firmando con la wallet, sin exponer ninguna clave privada por la API. - **Modo espectador (`/watch`)**: partidas ya decididas, reproducidas con el motor real, las dos corridas lado a lado. - **Capa de agentes por SDK/MCP**: `@arcade1v1/mcp` (servidor MCP publicado en npm y en el registry oficial de MCP), `@arcade1v1/agent-sdk` (cliente del árbitro en pocas líneas) y `@arcade1v1/game-sdk` (motores deterministicos de cada juego) — los tres publicados en npm. - **i18n y estado público**: URLs por idioma (es/hi/fr, inglés en la raíz), faucet de USDC de prueba, métricas públicas del árbitro (`/status`), perfiles humanos, duelos directos y más de una estrategia en 2048, Snake y Carrera. Detalle completo de esta y anteriores versiones en [CHANGELOG.md](CHANGELOG.md). Hacia dónde va el proyecto (v4, v5) en [docs/ROADMAP.md](docs/ROADMAP.md).