How danielx2d4144/zkverify-gatekeeper-agent works
This repository implements a signed proof-gatekeeper agent, with both a Vercel/local ESM transport and a separate plain-Node transport. Requests are authenticated, classified, and routed to Gatekeeper or Steal-the-VFY task logic; each task evaluates its domain rules and may generate and locally verify a Groth16 proof before returning a result. The README also identifies Vercel Blob as an optional durable proof-seen store. The graph covers both implementations; links among unsampled modules are omitted where their call relationships are not established by the available evidence.
Main entry points: gatekeeper-task.mjs Gatekeeper task · handlers.mjs Task handlers · core.js Legacy transport-independent core · handler.mjs Signed transport handler
Components 19
Transport and authentication
- Vercel endpoint
api/agent.mjs - Local ESM server
src/server.mjs - Plain Node server
src/server.js - Signed transport handler
src/handler.mjs - HMAC and time checks
src/security.mjs
Task routing
- Task handlers
src/handlers.mjs
Gatekeeper task
- Gatekeeper task
src/gatekeeper-task.mjs - Statement evaluation
src/gatekeeper.mjs - Gatekeeper proof generation
src/proofs.mjs - Task ID encoding
src/gk-encoding.mjs - Accepted proof tracking
src/seen.mjs
Steal strategy
- Steal turn processing
src/steal.mjs - Strategy policy
src/policy.mjs
Legacy gatekeeper
- Legacy transport-independent core
src/core.js - Legacy decision logic
src/decide.js - Legacy proof generation
src/prove.js - Legacy response and seen store
src/store.js
Other components
- Agent Games platform
- Vercel Blob
Connections 19
- Agent Games platform → Vercel endpoint: sends requests
README.md - Vercel endpoint → Signed transport handler: passes request
api/agent.mjs - Vercel endpoint → Task handlers: supplies handlers
api/agent.mjs - Local ESM server → Signed transport handler: passes request
src/server.mjs - Local ESM server → Task handlers: loads handlers
src/server.mjs - Plain Node server → Legacy transport-independent core: calls
src/server.js - Signed transport handler → HMAC and time checks: authenticates and checks time
src/handler.mjs - Signed transport handler → Task handlers: dispatches task
src/handler.mjs - Task handlers → Gatekeeper task: invokes
src/handlers.mjs - Task handlers → Steal turn processing: invokes
src/handlers.mjs - Gatekeeper task → Statement evaluation: evaluates statement
src/gatekeeper-task.mjs - Gatekeeper task → Accepted proof tracking: reads and marks
src/gatekeeper-task.mjs - Gatekeeper task → Gatekeeper proof generation: requests proof
src/gatekeeper-task.mjs - Gatekeeper task → Task ID encoding: encodes task ID
src/gatekeeper-task.mjs - Accepted proof tracking → Vercel Blob: may persist to
README.md - Steal turn processing → Strategy policy: decides and builds witness
src/steal.mjs - Legacy transport-independent core → Legacy decision logic: decides
src/core.js - Legacy transport-independent core → Legacy proof generation: generates proof
src/core.js - Legacy transport-independent core → Legacy response and seen store: reads and writes
src/core.js