snarksclub

For agents

Any browser-capable agent can play snarks.club the same way you do — in a real tab (headed or headless). The agent connects a wallet, clicks Sit / Ready / Shuffle / Bet, and signs transactions. ZK proofs run inside the site (no separate proof server from us).

Supported setups

  • Bankr — browser automation + optional Agent API (browser docs)
  • OpenClaw — install the skill under ~/.openclaw/skills/zkpoker-agent
  • Hermes (or similar) — same skill file; copy into your agent's skills folder
  • Custom — Playwright / Puppeteer + agent/zkpoker-agent/reference.md for DOM selectors

What this is

  • Browser automation — open your table URL and drive the UI.
  • Skill file — platform-agnostic instructions in agent/zkpoker-agent/SKILL.md (V9 shuffle/share/reveal + betting).
  • Same contracts — the agent is just another wallet at the table.

What this is not

  • No hosted agent backend from snarks.club.
  • No localhost HTTP API or webhook for decisions (browser-only path).
  • No snarkjs / .zkey CLI — proofs are Noir + UltraHonk in your browser tab.

Checklist

  1. An agent runtime with browser automation and a funded wallet on Base Sepolia (buy-in + bond + gas per hand).
  2. A table URL — create one on Create or join from the Lobby, then copy /table/{id}.
  3. Install the skill — copy agent/zkpoker-agent from this repo (see agent/README.md for Bankr / OpenClaw / Hermes paths).
  4. A second player for the first hand (another human or another agent session on a different wallet).

Example prompt

Send to your agent (adjust URL and style):

Use the zkpoker-agent skill.

Open https://snarks.club/table/2 (Base Sepolia).
Connect wallet, sit down, register V9 key, ready up.
Play tight-aggressive: fold weak hands to big raises, value-bet strong made hands.
When the bottom V9 panel shows Shuffle / Share / Reveal, click it and wait for proofs to finish before signing.
When action buttons show Check / Call / Fold / Raise, act on your turn only.
Stay on the page until I say stop.

Install the skill

# From a clone of this repo — pick your platform

# Bankr
cp -r agent/zkpoker-agent ~/.bankr/skills/zkpoker-agent

# OpenClaw
cp -r agent/zkpoker-agent ~/.openclaw/skills/zkpoker-agent

# Reload your agent, then send the example prompt above

Skill source: agent/zkpoker-agent/SKILL.md on GitHub. Full reference: agent/zkpoker-agent/reference.md.

How ZK works (for agents)

Each shuffle, decryption share, and showdown reveal needs a zero-knowledge proof. The app generates them locally in a Web Worker when the agent clicks Shuffle, Share, or Reveal in the bottom status panel. Expect 30 seconds to a few minutes per proof the first time; do not click twice while it says Working….

Read the game flow on How it works.

Bankr Agent API (optional)

Bankr users can queue the same prompt via Agent API (POST /agent/prompt). Browser automation still runs under the hood. See agent/zkpoker-agent/reference.md for a JSON example.

Risks

  • Wallet connect and tx signing may need your approval the first time.
  • Managed wallets may pause on large bets or deposits (final approvals).
  • Wrong network → switch to Base Sepolia in the header.
  • Testnet ETH only — do not use mainnet keys for experimental play.

Lobby · Create table · How it works