Excited to drop the zk playbook! 🔥 

Building with zk + attestations is complicated. This playbook makes it easier so devs can ship faster and confidently. Special thanks to the @ethereumfndn for supporting the research.

Links below. Open a PR if you want to contribute.

The Ethereum Foundation (EF) is a non-profit that supports Ethereum. Learn more at ethereum.foundation.

What you'll find inside:
- Overview (why we built this)
- Quickstart (15mins)
- ZK + Attestations 101
- Devex Challenges
- Avoid Misconceptions
- Design patterns that work
- Recommended tools
- Going beyond privacy
- Interoperability
- What to build
- Contribute

This playbook is just the start. We're excited to watch the tooling evolve from here.

building /eas. product leader
https://attest.org

What you'll find inside:
- Overview (why we built this)
- Quickstart (15mins)
- ZK + Attestations 101
- Devex Challenges
- Avoid Misconceptions
- Design patterns that work
- Recommended tools
- Going beyond privacy
- Interoperability
- What to build
- Contribute

This playbook is just the start. We're excited to watch the tooling evolve from here.

https://docs.attest.org/docs/zk--playbook/overview

The 15-Min Quickstart

Build a privacy-preserving flow that proves a user's age is over 18 using  Succinct's SP1 + EAS offchain attestations.

Tyty to the ZK Attestify team!
@shivansheth + gautam

The 15-Min Quickstart

Build a privacy-preserving flow that proves a user's age is over 18 using  Succinct's SP1 + EAS offchain attestations.

Tyty to the ZK Attestify team!
@shivansheth + gautam
https://docs.attest.org/docs/zk--playbook/quickstart

ZK + Attestations 101

Breaks down key concepts and mental models around ZK and attestations and the value of bringing them together. Great place to start if you're not super familiar yet.

ZK + Attestations 101

Breaks down key concepts and mental models around ZK and attestations and the value of bringing them together. Great place to start if you're not super familiar yet.

https://docs.attest.org/docs/zk--playbook/core-concepts

DevEx Challenges

Acknowledges common challenges devs face when building with zk and attestations and provides a few tips.

- Mental overhead can be daunting
- Tooling is fragmented (still)
- Performance isn't quite there yet
- Understanding proof validation vs truth
- Interoperability is a mess
- Managing offchain data and onchain logic
- Debugging circuits is complicated

DevEx Challenges

Acknowledges common challenges devs face when building with zk and attestations and provides a few tips.

- Mental overhead can be daunting
- Tooling is fragmented (still)
- Performance isn't quite there yet
- Understanding proof validation vs truth
- Interoperability is a mess
- Managing offchain data and onchain logic
- Debugging circuits is complicated

https://docs.attest.org/docs/zk--playbook/zk-roadblocks

Avoid Misconceptions

Any new paradigm comes with baggage. This section breaks down common myths, outdated assumptions, and misapplied mental models.

- Proofs are too slow to be practical
- You need a phd in cryptography to use ZK
- Attestations leak private data
- Attestations reintroduce trust assumptions
- ZK proofs guarantee everything is secure

Design Patterns That Work

Reliable patterns that are emerging as reliable, reusable, and modular. Easy ways to get inspired and avoid complexity.

- Merkle membership proofs
- Offchain attestation → ZK Proof → onchain attestation
- Resolver contracts + proof triggered actions
- Attested zkVM execution (proof as attestation)

Recommended Tooling

Curated "builder-first" toolbox for anyone combining zk with EAS. This is an opinionated list and not intended to be comprehensive.

Includes resources/tools for:
- Attestation types
- Encrypting and scaling your payloads
- Starter templates you can fork
- Choosing a zkVM or DSL for your logic
- ZK research orgs and research
- Early zkApps to watch
- ZK People to follow

Want to get added? Create a PR!
https://docs.attest.org/docs/zk--playbook/recommended-tooling

Design Patterns That Work

Reliable patterns that are emerging as reliable, reusable, and modular. Easy ways to get inspired and avoid complexity.

- Merkle membership proofs
- Offchain attestation → ZK Proof → onchain attestation
- Resolver contracts + proof triggered actions
- Attested zkVM execution (proof as attestation)

https://docs.attest.org/docs/zk--playbook/best-practices

Avoid Misconceptions

Any new paradigm comes with baggage. This section breaks down common myths, outdated assumptions, and misapplied mental models.

- Proofs are too slow to be practical
- You need a phd in cryptography to use ZK
- Attestations leak private data
- Attestations reintroduce trust assumptions
- ZK proofs guarantee everything is secure

https://docs.attest.org/docs/zk--playbook/myths