interledger · mirunagherman · Jun 10, 2026 · Jun 10, 2026 · Jun 10, 2026 · Jun 10, 2026
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
@@ -20,17 +20,17 @@
 
 ### Required Environment
 
-- **Node.js 20 LTS** (`lts/iron`, enforced by `package.json` engines field)
+- **Node.js 24 LTS** (enforced by `package.json` engines field)
 - **pnpm 9.x** (managed via Corepack; CI uses `pnpm/action-setup@v2`)
 - **Docker** and **Docker Compose** (for local services: Postgres, Redis, Traefik, Kratos, Rafiki, MockGatehub)
 - **Git**
 
 ### Setup Steps (First Time Only)
 
 ```bash
-# 1. Switch to Node 20 (assumes nvm installed)
-nvm install lts/iron
-nvm use lts/iron
+# 1. Switch to Node 24 (assumes nvm installed)
+nvm install 24
+nvm use 24
 
 # 2. Enable Corepack (pnpm package manager)
 corepack enable
@@ -134,7 +134,7 @@ testnet/
 ├── pnpm-workspace.yaml               # Defines monorepo packages
 ├── tsconfig.base.json                # Shared TypeScript config
 ├── .eslintrc.js, .prettierrc.js     # Lint & format config
-├── .nvmrc                            # Node version (lts/iron)
+├── .nvmrc                            # Node version (24)
 │
 ├── .github/workflows/
 │   ├── ci.yml                        # PR validation (checks → builds → tests)
@@ -176,12 +176,12 @@ testnet/
 
 ### Scenario: Node Version Mismatch
 
-**Symptom**: `ERR_PNPM_UNSUPPORTED_ENGINE Expected version: ^20.12.1`
+**Symptom**: `ERR_PNPM_UNSUPPORTED_ENGINE Expected version: ^24.13.1`
 
 **Fix**:
 
 ```bash
-nvm install lts/iron && nvm use lts/iron && pnpm install --frozen-lockfile
+nvm install 24 && nvm use 24 && pnpm install --frozen-lockfile
 ```
 
 ### Scenario: Stale Dependencies
@@ -228,7 +228,7 @@ pnpm wallet:backend test --detectOpenHandles --forceExit
 **Fix**:
 
 ```bash
-node --version  # Verify v20.x.x
+node --version  # Verify v24.x.x
 pnpm install --frozen-lockfile
 pnpm build
 ```
@@ -240,7 +240,7 @@ pnpm build
 1. **Trust this file first**: Before running grep/search/explore commands, check if information exists here. Minimize search time by following the command sequences documented above.
 
 2. **Always validate prerequisites**:
-   - Node version: `node --version` → must be `v20.x.x`
+   - Node version: `node --version` → must be `v24.x.x`
    - pnpm installed: `pnpm --version` → must be `9.x`
    - Dependences installed: Run `pnpm install --frozen-lockfile` before any other command
 

diff --git a/.github/workflows/build-publish.yaml b/.github/workflows/build-publish.yaml
@@ -31,7 +31,7 @@ jobs:
           version: v9.1.4
       - uses: actions/setup-node@v4
         with:
-          node-version: '20.19.5'
+          node-version: '24.13.1'
           cache: 'pnpm'
       - name: Install dependencies for ${{ matrix.package }}
         shell: bash

diff --git a/.github/workflows/setup/action.yml b/.github/workflows/setup/action.yml
@@ -9,7 +9,7 @@ runs:
     - name: Setup NodeJS
       uses: actions/setup-node@v4
       with:
-        node-version: 'lts/iron'
+        node-version: '24'
 
     - name: Install PNPM
       uses: pnpm/action-setup@v2

diff --git a/.nvmrc b/.nvmrc
@@ -1 +1 @@
-lts/iron
+v24
diff --git a/README.md b/README.md
@@ -46,10 +46,9 @@ Please read the [contribution guidelines](.github/contributing.md) before submit
 ### Environment Setup
 
 ```sh
-# Install Node 20
-nvm install lts/iron
-nvm use lts/iron
-
+# Install Node 24
+nvm install 24
+nvm use 24
 # Install pnpm using Corepack
 corepack enable
 ```

diff --git a/package.json b/package.json
@@ -71,7 +71,7 @@
     "pnpm": "^9.1.4",
     "npm": "pnpm",
     "yarn": "pnpm",
-    "node": "^20.12.1"
+    "node": "^24.13.1"
   },
   "private": true,
   "packageManager": "pnpm@9.1.4"

diff --git a/packages/boutique/backend/Dockerfile.dev b/packages/boutique/backend/Dockerfile.dev
@@ -1,4 +1,4 @@
-FROM node:iron-slim
+FROM node:24-slim
 
 RUN apt-get update && \
     apt-get install -y python3 build-essential && \

diff --git a/packages/boutique/backend/Dockerfile.prod b/packages/boutique/backend/Dockerfile.prod
@@ -1,9 +1,9 @@
-FROM node:20-alpine AS base
+FROM node:24-alpine AS base
 
 WORKDIR /testnet
 
 RUN corepack enable
-RUN corepack prepare pnpm@9.1.1 --activate
+RUN corepack prepare pnpm@9.1.4 --activate
 RUN apk add --no-cache \
     libc6-compat \
     python3 \
@@ -32,7 +32,7 @@ RUN rm -rf ./node_modules ./packages/boutique/backend/node_modules ./packages/sh
 RUN --mount=type=cache,id=pnpm,target=/root/.local/share/pnpm/store pnpm install -r --frozen-lockfile --prod \
     | grep -v "cross-device link not permitted\|Falling back to copying packages from store"
 
-FROM node:20-alpine AS runner
+FROM node:24-alpine AS runner
 
 WORKDIR /testnet
 

diff --git a/packages/boutique/backend/package.json b/packages/boutique/backend/package.json
@@ -27,7 +27,7 @@
     "@types/cors": "^2.8.19",
     "@types/express": "^4.17.23",
     "@types/jest": "^29.5.14",
-    "@types/node": "^20.17.30",
+    "@types/node": "^24.13.1",
     "jest": "^29.7.0",
     "node-mocks-http": "^1.17.2",
     "ts-jest": "^29.4.4",

diff --git a/packages/boutique/frontend/Dockerfile.prod b/packages/boutique/frontend/Dockerfile.prod
@@ -1,9 +1,9 @@
-FROM node:20-alpine AS base
+FROM node:24-alpine AS base
 
 WORKDIR /testnet
 
 RUN corepack enable
-RUN corepack prepare pnpm@9.1.1 --activate
+RUN corepack prepare pnpm@9.1.4 --activate
 
 RUN apk add --no-cache \
     libc6-compat \

diff --git a/packages/boutique/shared/package.json b/packages/boutique/shared/package.json
@@ -14,7 +14,7 @@
   "author": "",
   "license": "ISC",
   "devDependencies": {
-    "@types/node": "^20.17.30"
+    "@types/node": "^24.13.1"
   },
   "dependencies": {
     "zod": "^3.25.76"

diff --git a/packages/shared/backend/package.json b/packages/shared/backend/package.json
@@ -14,18 +14,18 @@
   "author": "",
   "license": "ISC",
   "devDependencies": {
-    "@types/node": "^20.17.30",
-    "tsc-alias": "^1.8.16",
-    "typescript": "^5.9.3",
     "@types/express": "^4.17.23",
-    "ioredis": "^5.8.0"
+    "@types/node": "^24.13.1",
+    "ioredis": "^5.8.0",
+    "tsc-alias": "^1.8.16",
+    "typescript": "^5.9.3"
   },
   "dependencies": {
     "awilix": "^12.0.5",
+    "axios": "^1.12.2",
     "express": "^4.21.2",
-    "objection": "^3.1.5",
     "knex": "^3.1.0",
-    "winston": "^3.18.3",
-    "axios": "^1.12.2"
+    "objection": "^3.1.5",
+    "winston": "^3.18.3"
   }
 }
diff --git a/packages/wallet/backend/Dockerfile.dev b/packages/wallet/backend/Dockerfile.dev
@@ -1,4 +1,4 @@
-FROM node:iron-slim
+FROM node:24-slim
 
 RUN apt-get update && \
     apt-get install -y python3 build-essential && \

diff --git a/packages/wallet/backend/Dockerfile.prod b/packages/wallet/backend/Dockerfile.prod
@@ -1,9 +1,9 @@
-FROM node:20-alpine AS base
+FROM node:24-alpine AS base
 
 WORKDIR /testnet
 
 RUN corepack enable
-RUN corepack prepare pnpm@9.1.1 --activate
+RUN corepack prepare pnpm@9.1.4 --activate
 RUN apk add --no-cache \
     libc6-compat \
     python3 \
@@ -32,7 +32,7 @@ RUN rm -rf ./node_modules ./packages/wallet/backend/node_modules ./packages/wall
 RUN --mount=type=cache,id=pnpm,target=/root/.local/share/pnpm/store pnpm install -r --frozen-lockfile --prod \
     | grep -v "cross-device link not permitted\|Falling back to copying packages from store"
 
-FROM node:20-alpine AS runner
+FROM node:24-alpine AS runner
 
 WORKDIR /testnet
 

diff --git a/packages/wallet/backend/package.json b/packages/wallet/backend/package.json
@@ -51,7 +51,7 @@
     "@types/crypto-js": "^4.2.2",
     "@types/express": "^4.17.23",
     "@types/jest": "^29.5.14",
-    "@types/node": "^20.17.30",
+    "@types/node": "^24.13.1",
     "@types/uuid": "^10.0.0",
     "jest": "^29.7.0",
     "node-mocks-http": "^1.17.2",

diff --git a/packages/wallet/frontend/Dockerfile.dev b/packages/wallet/frontend/Dockerfile.dev
@@ -1,4 +1,4 @@
-FROM node:iron-slim
+FROM node:24-slim
 
 # Set the working directory
 WORKDIR /home/testnet

diff --git a/packages/wallet/frontend/Dockerfile.prod b/packages/wallet/frontend/Dockerfile.prod
@@ -1,9 +1,9 @@
-FROM node:20-alpine AS base
+FROM node:24-alpine AS base
 
 WORKDIR /testnet
 
 RUN corepack enable
-RUN corepack prepare pnpm@8.10.5 --activate
+RUN corepack prepare pnpm@9.1.4 --activate
 
 RUN apk add --no-cache \
     libc6-compat \
@@ -50,7 +50,7 @@ ENV PORT=$PORT \
 
 RUN pnpm wallet:frontend build
 
-FROM node:20-alpine AS runner
+FROM node:24-alpine AS runner
 
 WORKDIR /testnet
 

diff --git a/packages/wallet/frontend/package.json b/packages/wallet/frontend/package.json
@@ -36,7 +36,7 @@
     "@next/bundle-analyzer": "^13.4.12",
     "@next/eslint-plugin-next": "^13.4.12",
     "@tailwindcss/forms": "^0.5.10",
-    "@types/node": "^20.17.30",
+    "@types/node": "^24.13.1",
     "@types/nprogress": "^0.2.3",
     "@types/react": "18.3.25",
     "@types/react-dom": "18.3.7",

diff --git a/packages/wallet/shared/package.json b/packages/wallet/shared/package.json
@@ -14,7 +14,7 @@
   "author": "",
   "license": "ISC",
   "devDependencies": {
-    "@types/node": "^20.17.30"
+    "@types/node": "^24.13.1"
   },
   "dependencies": {
     "zod": "^3.25.76"