From 7365be9f836c8d3563a7f783ffa629f21bf6673f Mon Sep 17 00:00:00 2001
From: Sjors Provoost <sjors@sprovoost.nl>
Date: Tue, 10 Mar 2026 16:41:48 +0100
Subject: [PATCH] doc: document Cap'n Proto build prerequisites

---
 README.md | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index f580167..b0ff965 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,26 @@
 ## Bitcoin Cap'n Proto Rust Client
 
-This project auto-generates the client code to interact with Bitcoin Core in Rust using interprocess communication. To build the code locally, you will need to have the [`capnp`](https://capnproto.org/install.html) compiler installed on your system.
+This project auto-generates the client code to interact with Bitcoin Core in Rust using interprocess communication.
+
+## Build prerequisites
+
+Building this crate requires the [`capnp`](https://capnproto.org/install.html)
+compiler.
+
+macOS:
+
+```sh
+brew install capnp
+```
+
+Debian / Ubuntu:
+
+```sh
+sudo apt-get install capnproto libcapnp-dev
+```
+
+If `/capnp/c++.capnp` cannot be found during `cargo build`, install the
+platform's Cap'n Proto development package in addition to the compiler.
 
 ## Minimum Standard Rust Version