Documentation
Every moving part of Zecpass, written to be read from top to bottom. The same files live in the repository under docs/.
Overview
What Zecpass is, who it is for, and the one sentence that describes the whole system.
Using Zecpass
Step by step for a first pass: the wallet, the refund address, the amounts, the wait, and what each state on the road means.
Architecture
The whole system on one page: the two rails, the relayer, the hub, the passes, the two delivery modes and the order state machine.
Privacy
What each observer on the road can see, what they cannot, where the relayer is a weak point, and how to behave so the privacy actually holds.
Contract
The hub and the passes on Robinhood Chain: storage, functions, events, invariants, caps, the market adapter and the gas figures.
Relayer
The service that drives orders: every state and the exact condition for each transition, the environment, the HTTP API it serves, and how it is deployed on Fly.
Token
$ZECPASS on Pons V2: the curve, the creator tax, the hub fee, where every unit of fee goes, and the launch procedure.
API
The site's API routes and the relayer's endpoints with request and response examples, and the two upstream APIs they wrap.
Security and trust
Trust assumptions, what each party can do to you, the caps that bound the damage, the keys, the failure modes, and what has and has not been audited.
Operations
The runbook: from an empty deployer to a live gate, launch day, the environment on Vercel and Fly, monitoring, and every manual intervention.
FAQ
Short answers to the questions that come up first.