From 143e5679b234ddf4d9327594aebbb98848db33dc Mon Sep 17 00:00:00 2001
From: thephez <thephez@users.noreply.github.com>
Date: Wed, 17 Jun 2026 11:40:41 -0400
Subject: [PATCH] docs: update Node version references to 22.22 toolchain

Point the dev container image, install prerequisites, and CLAUDE.md toolchain guidance at the repo-pinned Node 22.22.x instead of the prior Node 20 references.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .devcontainer/devcontainer.json |  2 +-
 CLAUDE.md                       | 12 ++++++++++++
 README.md                       |  2 +-
 example-apps/dashnote/README.md |  2 +-
 4 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
index 4b9b364..f99d3fe 100644
--- a/.devcontainer/devcontainer.json
+++ b/.devcontainer/devcontainer.json
@@ -1,6 +1,6 @@
 {
   "name": "Dash Platform Tutorials",
-  "image": "mcr.microsoft.com/devcontainers/javascript-node:20",
+  "image": "mcr.microsoft.com/devcontainers/javascript-node:22",
   "remoteUser": "node",
 
   "onCreateCommand": "cp -n .env.example .env",
diff --git a/CLAUDE.md b/CLAUDE.md
index c9c7f84..3c06af9 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -18,6 +18,7 @@ Run `node view-wallet.mjs` to confirm the identity is found before proceeding.
 ## Commands
 
 ```bash
+nvm use                 # Use the repo's tested Node 22.22.x toolchain
 npm test                # Read-only tests (~2min, safe to run anytime)
 npm run test:read-write # Write tests (destructive, consumes testnet credits, ~5min)
 npm run test:all        # Both suites sequentially
@@ -27,6 +28,17 @@ npm run lint            # TypeScript type-check all JS files (tsc)
 npm run fmt             # Format with Prettier
 ```
 
+## Node / npm Toolchain
+
+Use the repo-root `.nvmrc` before installing dependencies or updating lockfiles:
+
+```bash
+nvm use
+npm ci
+```
+
+The root package and each standalone example app declare `engines.node` for the tested Node minor version. The example apps have their own `package-lock.json` files, and npm's optional native/WASM dependency resolution can differ across Node/npm versions. For contributor work, prefer `npm ci` under `nvm use`; do not commit lockfile rewrites from another Node/npm version.
+
 **Running a single tutorial directly:**
 
 ```bash
diff --git a/README.md b/README.md
index 9e2d359..bfa9222 100644
--- a/README.md
+++ b/README.md
@@ -25,7 +25,7 @@ your `.env` file to begin the tutorials.
 
 ## Install
 
-Note: [NodeJS](https://nodejs.org/en/download/) (v20+) must be installed to run the tutorial code.
+Note: [NodeJS](https://nodejs.org/en/download/) (v22.22+) must be installed to run the tutorial code.
 
 ### Clone this repository
 
diff --git a/example-apps/dashnote/README.md b/example-apps/dashnote/README.md
index e7b1492..6f858c9 100644
--- a/example-apps/dashnote/README.md
+++ b/example-apps/dashnote/README.md
@@ -6,7 +6,7 @@ The app stays close to the tutorial `note` contract shape, but extends it with a
 
 ## Prerequisites
 
-- Node >= 20
+- Node 22.22+
 - A funded Dash Platform testnet identity for write operations. Login accepts either a BIP-39 mnemonic (with an optional identity index for DIP-13 derivation) or a WIF private key for an existing HIGH/CRITICAL authentication key on that identity.
 - Read-only mode works without any identity — visitors can read notes for any identity ID against the bundled contract. A previously-logged-in identity can also be re-browsed without re-auth via the remembered-identity flow.