From 7b031466984b795712502451ac1317a4914efa46 Mon Sep 17 00:00:00 2001
From: Michael Nielsen <4518975+mikdk@users.noreply.github.com>
Date: Fri, 24 Apr 2026 15:11:54 +0200
Subject: [PATCH] doc: add benchmarks page

---
 docs/src/SUMMARY.md             |  1 +
 docs/src/appendix/benchmarks.md | 28 ++++++++++++++++++++++++++++
 2 files changed, 29 insertions(+)
 create mode 100644 docs/src/appendix/benchmarks.md

diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md
index ed1c3e8..89d7977 100644
--- a/docs/src/SUMMARY.md
+++ b/docs/src/SUMMARY.md
@@ -28,3 +28,4 @@
   - [Namada](./integration/namada.md)
 
 - [References](./appendix/references.md)
+- [Benchmarks](./appendix/benchmarks.md)
diff --git a/docs/src/appendix/benchmarks.md b/docs/src/appendix/benchmarks.md
new file mode 100644
index 0000000..a6478ad
--- /dev/null
+++ b/docs/src/appendix/benchmarks.md
@@ -0,0 +1,28 @@
+# Benchmarks
+
+Indicative single-run timings and preprocessed data sizes for the three main `zair` commands.
+
+## Hardware
+
+- **CPU:** AMD Ryzen 9 3900X (12 cores / 24 threads)
+- **Memory:** 32 GiB DDR4-2666
+- **Disk:** Samsung SSD 970 EVO Plus
+
+## Results
+
+| Command  | Time     | Notes                                  |
+| -------- | -------- | -------------------------------------- |
+| `setup`  | 24m 25s  | Sapling + Orchard parameter generation |
+| `claim`  | 25s      | 2 claims total (1 Sapling, 1 Orchard)  |
+| `verify` | 1.4s     | 2 claims total (1 Sapling, 1 Orchard)  |
+
+## Preprocessed Data Size
+
+Measured at block height `3319090`.
+
+| File                  | Size     |
+| --------------------- | -------- |
+| `snapshot-sapling.bin` | 67.4 MB  |
+| `snapshot-orchard.bin` | 1.6 GB   |
+| `gaptree-sapling.bin`  | 134.8 MB |
+| `gaptree-orchard.bin`  | 3.2 GB   |