You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 7435cf7
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: CLAUDE.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -142,4 +142,4 @@ This will generate the necessary boilerplate for a new coin implementation.
142
142
143
143
## Node.js Version Support
144
144
145
-
BitGoJS supports Node.js versions 22 and later, including Node.js 26, with NPM >=3.10.10.
145
+
BitGoJS supports Node.js versions 22 and later, including Node.js 26, with NPM >=3.10.10. Node.js 22 is deprecated and will be removed from engines.node in the first major release on or after its 2027-04-30 end-of-life; see README.md "Node.js Version Support Policy".
Copy file name to clipboardExpand all lines: DEVELOPERS.md
+3-1Lines changed: 3 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
# Requirements
2
2
3
3
- yarn version 1 (classic)
4
-
- Node.js version 22 or later
4
+
- Node.js version 22 or later (Node.js 22 is deprecated and support ends with the first major release on or after 2027-04-30; Node.js 24 or 26 recommended)
5
5
6
6
# Installing
7
7
@@ -186,6 +186,8 @@ Engines should be set to the following:
186
186
}
187
187
```
188
188
189
+
Node.js 22 is deprecated; keep `>=22` until the removal release described in the [Node.js Version Support Policy](README.md#nodejs-version-support-policy), then change every package to `>=24` in a single breaking-change commit.
190
+
189
191
### `tsconfig.json`
190
192
191
193
There are a few things each module's `tsconfig.json` must do:
Copy file name to clipboardExpand all lines: README.md
+7-3Lines changed: 7 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -56,16 +56,20 @@ BitGoJS currently provides support for the following Node versions per package.j
56
56
}
57
57
```
58
58
59
+
## Deprecation notice: Node.js 22
60
+
61
+
Node.js 22 is deprecated as of 2026-10-28, when Node.js 26 entered Active LTS. Node.js 22 remains supported, and required to pass continuous integration, until it reaches end-of-life on 2027-04-30. The first BitGoJS major release on or after 2027-04-30 will remove Node.js 22 from `engines.node` (changing it to `>=24`) and from the continuous integration matrix. Upgrade to Node.js 24 or 26 before then.
62
+
59
63
We specifically limit our support to these versions of Node, not because this package won't work on other versions, but because these versions tend to be the most widely used in practice. The packages may work correctly on newer or older versions, but only the supported versions below are required to pass continuous integration. We also run one newer Node.js release as a non-blocking early-warning check so incompatibilities are visible before that release becomes supported.
60
64
61
65
As each Node LTS version reaches its end-of-life we will exclude that version from the node engines property of our package's package.json file. Removing a Node version is considered a breaking change and will entail the publishing of a new major version of this package. We will not accept any requests to support an end-of-life version of Node, and any pull requests or issues regarding support for an end-of-life version of Node will be closed. We will accept code that allows this package to run on newer, non-LTS, versions of Node. Furthermore, we will attempt to ensure our own changes work on the latest version of Node. To help in that commitment, our continuous integration setup runs the full test suite on the latest release of the following versions of node:
62
66
63
-
-`22` (Maintenance LTS) — required to pass
67
+
-`22` (Maintenance LTS, deprecated; removal planned for the first major release on or after 2027-04-30) — required to pass
64
68
-`24` (Maintenance LTS) — required to pass
65
-
-`26` (Current) — required to pass
69
+
-`26` (Active LTS) — required to pass
66
70
-`27` nightly (experimental) — non-blocking; a failure posts a warning comment on the pull request
67
71
68
-
When a new Node.js major becomes supported, add it to the required `node-version` matrix in `.github/workflows/ci.yml` and update the `engines.node` range across all `modules/*/package.json` files if the range does not already include it. Keep exactly one newer release as the non-blocking early-warning check: when Node.js 28 development builds become available, replace the Node.js 27 nightly entry rather than adding another experimental matrix entry. Node.js 26 is required before its Long Term Support (LTS) transition, so its CI check is intentionally blocking already.
72
+
When a new Node.js major becomes supported, add it to the required `node-version` matrix in `.github/workflows/ci.yml` and update the `engines.node` range across all `modules/*/package.json` files if the range does not already include it. Keep exactly one newer release as the non-blocking early-warning check: when Node.js 28 development builds become available, replace the Node.js 27 nightly entry rather than adding another experimental matrix entry. When a new Node.js major enters Active LTS, mark the oldest supported LTS as deprecated in this section, keep it in the required matrix, and plan its removal for the first major release on or after its end-of-life date. Removal changes `engines.node` in every package and the generators, drops the version from the CI matrix, and must be committed with a `BREAKING CHANGE:` footer so the release publishes a major version of every package.
69
73
70
74
JavaScript package managers should allow you to install this package with any version of Node, with, at most, a warning if your version of Node does not fall within the range specified by our node engines property. If you encounter issues installing this package on a supported version of Node, please report the issue to us.
Copy file name to clipboardExpand all lines: modules/bitgo/README.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ If you have questions or comments about this API, email support@bitgo.com.
15
15
16
16
# Installation
17
17
18
-
Ensure you're running Node.js version 22 or later, including Node.js 26, and NPM version 10.
18
+
Ensure you're running Node.js version 22 or later, including Node.js 26, and NPM version 10. Node.js 22 is deprecated and support will be removed in the first major release on or after 2027-04-30; use Node.js 24 or 26.
19
19
For setting your Node version, we recommend using `nvm` - the [Node Version Manager](https://github.com/creationix/nvm/blob/master/README.markdown#installation).
Copy file name to clipboardExpand all lines: modules/express/README.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -125,7 +125,7 @@ For users who are unable to run BitGo Express as a Docker container, we recommen
125
125
126
126
### Prerequisites
127
127
128
-
Use Node.js 22 or later. The required continuous integration checks cover Node.js 22, 24, and 26. We recommend using `nvm`, the [Node Version Manager](https://github.com/creationix/nvm/blob/master/README.markdown#installation), for setting your Node.js version. BitGo Express is part of the monorepo, so use `yarn` for local setup.
128
+
Use Node.js 22 or later. The required continuous integration checks cover Node.js 22, 24, and 26. Node.js 22 is deprecated and support will be removed in the first major release on or after 2027-04-30. We recommend using `nvm`, the [Node Version Manager](https://github.com/creationix/nvm/blob/master/README.markdown#installation), for setting your Node.js version. BitGo Express is part of the monorepo, so use `yarn` for local setup.
129
129
130
130
### Cloning the repository and installing dependencies
0 commit comments