From 908637ca1c459205176d1543611cdce77bbd78d5 Mon Sep 17 00:00:00 2001
From: Michael Turner <mike@provable.com>
Date: Wed, 29 Jul 2026 14:02:50 -0500
Subject: [PATCH 1/3] bump version to 0.2.2

---
 Cargo.lock | 2 +-
 Cargo.toml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/Cargo.lock b/Cargo.lock
index 25a21f6..3739af1 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -19,7 +19,7 @@ dependencies = [
 
 [[package]]
 name = "aleo-devnode"
-version = "0.2.1"
+version = "0.2.2"
 dependencies = [
  "aleo-std-storage",
  "anyhow",
diff --git a/Cargo.toml b/Cargo.toml
index f35f884..f2e0f2f 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "aleo-devnode"
-version = "0.2.1"
+version = "0.2.2"
 edition = "2021"
 
 [[bin]]

From d899e9f76fe033d83c21cfce698aa22c9ef4b68b Mon Sep 17 00:00:00 2001
From: Michael Turner <mike@provable.com>
Date: Wed, 29 Jul 2026 14:03:51 -0500
Subject: [PATCH 2/3] add installation guide to README

---
 README.md | 36 +++++++++++++++++++++++++++++++++++-
 1 file changed, 35 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 6f8794b..fa1dc30 100644
--- a/README.md
+++ b/README.md
@@ -2,10 +2,44 @@
 
 The devnode is a standalone Aleo development node for local testing and development. Unlike a production node, it **does not verify proofs**. This means transactions can be built with placeholder proofs (for executions) and placeholder verifying keys (for deployments and upgrades), making quick local iteration and fast end-to-end testing by bypassing proof generation when creating a transaction.
 
-## Build
+## Installation
+
+### npm (recommended)
+
+Prebuilt binaries are distributed on npm for macOS (arm64, x64), Linux (x64, arm64), and Windows (x64). Requires Node.js ≥ 18.
+
+Run without installing:
+
+```sh
+npx @provablehq/aleo-devnode start --private-key <PRIVATE_KEY>
+```
+
+Install globally:
+
+```sh
+npm install -g @provablehq/aleo-devnode
+aleo-devnode --help
+```
+
+Or add it to a project as a dev dependency:
+
+```sh
+npm install --save-dev @provablehq/aleo-devnode
+```
+
+The `@provablehq/aleo-devnode` package is a small launcher that pulls in the binary for your platform via an optional dependency (e.g. `@provablehq/aleo-devnode-darwin-arm64`). Packages are published from CI via [npm trusted publishing](https://docs.npmjs.com/trusted-publishers) with provenance attestation — verify with `npm audit signatures`.
+
+### Prebuilt binaries
+
+Download the zip for your platform from the [GitHub releases page](https://github.com/ProvableHQ/aleo-devnode/releases), verify it against the release's `sha256sums.txt`, unpack it, and put `aleo-devnode` on your `PATH`.
+
+### From source
+
+Requires a Rust toolchain and `clang`/`libclang` (needed by RocksDB; on macOS it comes with the Xcode Command Line Tools, on Debian/Ubuntu install `libclang-dev`):
 
 ```sh
 cargo build --release
+# binary at target/release/aleo-devnode
 ```
 
 ## Usage

From ebf09febb4184aba5a82941c8e178c0981ce0f5e Mon Sep 17 00:00:00 2001
From: Michael Turner <mike@provable.com>
Date: Wed, 29 Jul 2026 14:05:43 -0500
Subject: [PATCH 3/3] drop npx one-off usage from install guide

---
 README.md | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/README.md b/README.md
index fa1dc30..7f506fd 100644
--- a/README.md
+++ b/README.md
@@ -8,12 +8,6 @@ The devnode is a standalone Aleo development node for local testing and developm
 
 Prebuilt binaries are distributed on npm for macOS (arm64, x64), Linux (x64, arm64), and Windows (x64). Requires Node.js ≥ 18.
 
-Run without installing:
-
-```sh
-npx @provablehq/aleo-devnode start --private-key <PRIVATE_KEY>
-```
-
 Install globally:
 
 ```sh