Examples & Boilerplates
Browse ready-to-use code examples and boilerplate projects to kickstart your Zeko development.
To get up and running quickly, see the Quick Start guide, which walks through resources for developers, end users, and node operators. Zeko Labs is the main GitHub organization for Zeko protocol code, developer demos, agent skills, CLIs, SDKs, and related tools.
Before using a demo, read How to Use These Demos for the recommended prompt-first workflow and production review guidance.
How to Use These Demos
These demos are working reference implementations and agent context. Before deploying anything derived from a demo to production, teams should run their own final code review, security review, and audit.
Recommended workflow:
- Start with the demo README, docs, scripts, and local agent skills.
- Ask your agent to extract a PRD, litepaper, or architecture document from the demo.
- Use that document to first generate a fresh implementation instead of only copying demo code.
- Review the result against Zeko docs, o1js docs, the demo source, and relevant skills.
Useful context links for agents:
Developer Demos
The developer_demos repository is a monorepo of end-to-end examples for building zero-knowledge applications on Zeko. Each demo is independent, so start with the README and docs inside the folder you want to run.
The descriptions below are condensed from the public repository README and current folder tree.
| Demo | What it demonstrates | Agent skills |
|---|---|---|
| Agent Coordination Protocol | Privacy-preserving agent marketplace and payment flow with request, accept, deliver, attest, wallet payment, relayer, credits, performance, and settlement patterns. | Includes skills for agent marketplaces, attestations, credits ledgers, escrow ACP flows, model adapters, price data, private outputs, relayers, storage hardening, and wallet connection. |
| Agent Execution Escrow | Zeko-native trust layer for agent transactions, gated execution, intent approval APIs, verifier registries, threshold signatures, and proof-checked per-intent zkApp lifecycle state. | Includes skills for agent intent APIs, private intent artifacts, per-intent zkApp lifecycle proving, transaction state sync, verifier approval, registry parsing, signature checks, and threshold quorum relay. |
| Private Prediction Market | Private weather prediction market with hosted frontend, oracle worker, transaction prover services, wallet-signed bet and claim flows, event sync, and zk-backed settlement. | Includes skills for weather market demos, private betting privacy, private market protocol design, agent-market integration, event sync/archive operations, market ops, and zkTLS weather oracle workflows. |
| Private Tokenized Asset Protocol | Tokenized asset protocol reference for private and programmable asset flows, including multi-package app structure, infrastructure, scripts, and deeper protocol organization patterns. | Documents TAP-specific skills for flagship pilot runs, customer sandbox onboarding, policy-linked settlement guards, zkTLS source integration, proof runtime configuration, issuer workflows, release packaging, and UI surface polish. |
| Private Order Book | Private order book exchange with note-backed trading, public-anonymous and private-dark orders, off-chain matching, on-chain settlement anchoring, reference zkApp, and matching infrastructure. | Includes skills for trading UI composition, shared-liquidity SDK architecture, Zeko DA privacy, wallet-signed non-magic transactions, and production runbook debugging. |
| Private Data Registry & Transaction Sponsor | Privacy-preserving consumer app with encrypted user content, wallet and non-wallet submission paths, sponsored anchoring, moderation, and participation-proof patterns. | Includes a Zeko Auro zkApp debugging skill for wallet connection and transaction troubleshooting. |
| AI & Truth: Data Provenance | AI media provenance demo with image provenance, metadata flows, attestable claim patterns, and reference frontend/backend wiring for verifiable media UX. | Includes skills for Auro zkApp preflight, deterministic image canonicalization, historical proof verification, secure public demo packaging, non-magic fee-payer flows, and safe zkApp redeploy consistency. |
| Verifiable AI Execution & Runtime | Zeko-native verifiable AI runtime with off-chain inference, attestable receipts, sealed private inputs, client-encrypted outputs, operator routing, failover, credits, and compatibility adapters. | Includes runtime-scoped skills for native and private inference builders, credits balance operators, lane/operator failover, and compatibility adapters for legacy-shaped integrations. |
| Agent Mission-Bound Auth | Protocol sidecar for delegated and autonomous agents: binds enterprise OIDC identity to a specific mission, signs approvals, enforces checkpoints before side effects, links x402 payment context, exports portable zk-mission-bundle-v1 receipts, and optionally anchors approval/receipt roots on Zeko. | Includes a mission-bound auth skill for autonomous-agent authorization with Auth0, Okta, generic OIDC/SAML entrypoints, mission-scoped approvals, ZK authorization commitments, private-compute receipts, x402 payment context, Zeko anchoring, sandbox verification, and PR packaging. |
Agent Skills
| Resource | What it is for |
|---|---|
| Zeko Skills | The public installable zeko skill for agents working with Zeko: Bridge CLI/SDK usage, faucet flows, endpoint discovery, GraphQL and curl queries, sequencer/archive/DA orientation, and zkApp development with o1js or OCaml. |
| Demo-local skills | Many demos include their own skills/, agent-skills/, agent_skills/, or docs/agent-skills.md files for domain-specific workflows. Use these when an agent needs to understand, operate, or extend a specific demo. |
Install the public Zeko skill with:
npx skills add https://github.com/zeko-labs/zeko-skills --skill zeko
CLI, SDK, and Tooling
| Tool | What it is for |
|---|---|
| Bridge CLI | zeko-bridge command-line tool for bridging assets between Mina L1 and Zeko. The high-level bridge command signs, submits, waits, retries transient checks, advances queued claims, and streams progress until completion. |
| Bridge SDK | TypeScript SDK for integrating deposits and withdrawals between Mina L1 and Zeko L2 into applications, services, and scripts. |
| Faucet CLI | Command-line client for the Zeko testnet faucet. Use it to verify GitHub authentication and claim testnet tokens for a Zeko address. |
| x402 Zeko | x402 starter for Zeko-centric paid services, including 402 Payment Required negotiation, signed payment authorization payloads, Zeko testnet settlement, EVM/Base/Ethereum USDC rails, and proof-oriented payment metadata. |
| Launch a Rollup | Operator guide for launching a Zeko rollup stack with sequencer, DA layer, prover, PostgreSQL, RabbitMQ, wallets, keys, deployment config, and Docker Compose. |