From 1c9ce6f3bc00b95476f1c9d87d29df5c14a98149 Mon Sep 17 00:00:00 2001 From: EnzinoBB Date: Tue, 27 Oct 2026 15:14:32 +0100 Subject: [PATCH 1/4] docs, release: community.14 (version 14 announced to peers, FEATURES, differences, README, release notes) Co-Authored-By: Claude Sonnet 5.5 --- .github/workflows/release.yml | 7 ++++--- README.md | 2 +- client/config/config.cpp | 2 +- docs/FEATURES.md | 16 +++++++++++++--- docs/differences.md | 17 +++++++++++++---- 5 files changed, 32 insertions(+), 12 deletions(-) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index fe08f2281..139f57319 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -224,9 +224,10 @@ jobs: One package for full and pruned storage: \`config.ini\` runs a full node, \`config.pruned.ini\` a pruned one on LMDB (\`./node --config-file config.pruned.ini\`). - Two builds of the same code: \`linux-x64\` needs glibc 2.38 (Ubuntu 24.04, Debian 13 and later); - \`linux-x64-glibc2.31\` runs on Ubuntu 20.04, Debian 11 and later. See README-COMMUNITY.txt inside - each package. Verify with SHA256SUMS. + Builds of the same code: \`linux-x64\` needs glibc 2.38 (Ubuntu 24.04, Debian 13 and later); + \`linux-x64-glibc2.31\` runs on Ubuntu 20.04, Debian 11 and later; \`windows-x64\` (.zip, Windows 10 and + later) and \`macos-arm64\` (Apple Silicon) come with Eclipse Temurin 11. See README-COMMUNITY.txt inside + each package. Verify with SHA256SUMS (Linux) and SHA256SUMS-windows-macos. What changes from the official node: https://github.com/${GITHUB_REPOSITORY}/blob/master/docs/differences.md Every change by release: https://github.com/${GITHUB_REPOSITORY}/blob/master/docs/CHANGES.md diff --git a/README.md b/README.md index d4cc3165b..71bfa47c6 100644 --- a/README.md +++ b/README.md @@ -23,7 +23,7 @@ This repository is the community continuation of [CREDITSCOM/node](https://githu | Every change, pull request by pull request | [docs/CHANGES.md](docs/CHANGES.md) | | Block database, pruned storage, conversion | [docs/storage.md](docs/storage.md) | | Docker (pruned node from a snapshot) | [packaging/docker/README.md](packaging/docker/README.md) | -| Packages (Linux x86-64; one package, `config.ini` full and `config.pruned.ini` pruned) | [Releases](https://github.com/EnzinoBB/node/releases) | +| Packages (Linux x86-64, Windows x64, macOS Apple Silicon; `config.ini` full and `config.pruned.ini` pruned, one package per system) | [Releases](https://github.com/EnzinoBB/node/releases) | Replacing the official binaries with the community ones, with the official `config.ini`, keeps the same BerkeleyDB database and the same behaviour on the network. The new features (other block databases, pruned storage, conversion) are opt-in. diff --git a/client/config/config.cpp b/client/config/config.cpp index d753d8a14..c8ec6fe4c 100644 --- a/client/config/config.cpp +++ b/client/config/config.cpp @@ -33,7 +33,7 @@ const NodeVersion NODE_VERSION = 532; // the community release (4.2.532-community.N); also announced to peers in host_data bits 32-47 -const uint8_t MINOR_NODE_VERSION = 13; +const uint8_t MINOR_NODE_VERSION = 14; const std::string BLOCK_NAME_PARAMS = "params"; const std::string BLOCK_NAME_HOST_INPUT = "host_input"; diff --git a/docs/FEATURES.md b/docs/FEATURES.md index 6b690fb84..46a775a38 100644 --- a/docs/FEATURES.md +++ b/docs/FEATURES.md @@ -6,7 +6,7 @@ consensus with them. This page lists what it adds; each item links the pull requ The full list of changes is in [CHANGES.md](CHANGES.md), the operational details in [differences.md](differences.md). -Everything listed here is in release 4.2.532-community.13 or earlier. +Everything listed here is in release 4.2.532-community.14 or earlier. ## Storage @@ -52,6 +52,10 @@ Everything listed here is in release 4.2.532-community.13 or earlier. [#101](https://github.com/EnzinoBB/node/pull/101), [#102](https://github.com/EnzinoBB/node/pull/102), [#104](https://github.com/EnzinoBB/node/pull/104), [#105](https://github.com/EnzinoBB/node/pull/105), [#106](https://github.com/EnzinoBB/node/pull/106), [#110](https://github.com/EnzinoBB/node/pull/110) +- **A survey of who serves what.** `node --survey-snapshots` asks the neighbours for the snapshots + they serve without opening the chain and prints what they declared; a weekly job publishes the + result and the list of serving nodes that ships in the packages. + [#116](https://github.com/EnzinoBB/node/pull/116) ## State that can be checked @@ -111,10 +115,16 @@ the storage engines (a full disk, a failed write) that hung or stopped the node. ## Packages and Docker -- **Release packages** for Ubuntu 20.04 and later, full and pruned, and a verified list of known +- **Release packages** for Ubuntu 20.04 and later (one package: `config.ini` full, `config.pruned.ini` + pruned), for Windows (x64, `.zip`) and for macOS (Apple Silicon), and a verified list of known hosts updated every week. [#34](https://github.com/EnzinoBB/node/pull/34), [#35](https://github.com/EnzinoBB/node/pull/35), - [#42](https://github.com/EnzinoBB/node/pull/42) + [#42](https://github.com/EnzinoBB/node/pull/42), [#113](https://github.com/EnzinoBB/node/pull/113) +- **Windows and macOS.** The node builds and passes its tests on Windows (MSVC) and on macOS + (Apple Silicon), and a Windows or macOS node loads the checkpoints and snapshots a Linux node + wrote and syncs mainnet with the same state digests; CI checks that on mainnet for the three + systems before the packages are published. + [#114](https://github.com/EnzinoBB/node/pull/114), [#115](https://github.com/EnzinoBB/node/pull/115) - **Docker image.** One command starts a node; the first start of a pruned node restores the published snapshot (or fetches one from its neighbours), the node serves snapshots, and a database conversion is one variable. diff --git a/docs/differences.md b/docs/differences.md index c92fba44e..98323512d 100644 --- a/docs/differences.md +++ b/docs/differences.md @@ -226,12 +226,21 @@ rounds for both). ## Packages and Docker - **Release packages.** Each release has one package for full and pruned storage (until - community.13, a full and a pruned package), in two builds: + community.13, a full and a pruned package), in these builds: - `linux-x64` needs glibc 2.38 (Ubuntu 24.04, Debian 13 and later); - - `linux-x64-glibc2.31` runs on Ubuntu 20.04, Debian 11 and later. - - Each package includes the JDK of the official release and the community build of the contract + - `linux-x64-glibc2.31` runs on Ubuntu 20.04, Debian 11 and later; + - `windows-x64` (a `.zip`, Windows 10 and later; start `node.exe` from a terminal in the `csnode` + folder) and `macos-arm64` (Apple Silicon; clear the download quarantine once with + `xattr -dr com.apple.quarantine csnode`; the node is not signed). + + The Linux packages include the JDK of the official release; the Windows and macOS ones include + Eclipse Temurin 11 (the official release has no JDK for them), in `jdk/`, and their + `executor_command` points at it. Each package includes the community build of the contract executor. +- **Checkpoints and snapshots are the same on every system.** A Windows or macOS node loads what a + Linux node wrote and the other way round: the binary checkpoint files record `long` as 8 bytes + whatever the system, and the checkpoint's text files are read and written in binary mode. On + Linux the files are byte for byte what they were. - **`config.ini` in the packages.** It is the official one, with five changes: - `[event_report]` is commented out (it reports node events to a fixed address); - `executor_commit_max` accepts the community executor; From 9832fb3e9260ce8981f5db882b9d1c5c3da194ac Mon Sep 17 00:00:00 2001 From: EnzinoBB Date: Tue, 27 Oct 2026 15:20:07 +0100 Subject: [PATCH 2/4] packaging: the packages and the Docker image carry the right VERSION make-package.sh writes VERSION (the release's version) into the package, and the Docker entrypoint copies it next to the node on every start. The node reads it for the 'node' field of the snapshots it builds; a package extracted over an older folder, or a new image on an old volume, corrects it. Co-Authored-By: Claude Sonnet 5.5 --- packaging/docker/entrypoint.sh | 2 ++ packaging/make-package.sh | 3 +++ 2 files changed, 5 insertions(+) diff --git a/packaging/docker/entrypoint.sh b/packaging/docker/entrypoint.sh index 79c4cef5e..d86ed152e 100755 --- a/packaging/docker/entrypoint.sh +++ b/packaging/docker/entrypoint.sh @@ -158,6 +158,8 @@ echo "mode=$cfg_mode backend=$cfg_backend" > .storage for f in settings.properties known_hosts.txt default_confidants.txt; do [ -e "$f" ] || cp "$OPT/$f" "$f" done +# the image's version, on every start: the node puts it in the snapshots it builds +[ ! -e "$OPT/VERSION" ] || cp -f "$OPT/VERSION" VERSION # the serving nodes of the weekly survey, when the package has them [ ! -e "$OPT/snapshot_sources.txt" ] || [ -e snapshot_sources.txt ] || cp "$OPT/snapshot_sources.txt" snapshot_sources.txt if [ ! -f keys/NodePublic.txt ]; then diff --git a/packaging/make-package.sh b/packaging/make-package.sh index d76c624e8..587d721d8 100755 --- a/packaging/make-package.sh +++ b/packaging/make-package.sh @@ -40,6 +40,9 @@ install -m 755 "$node" "$dir/$exe" install -m 644 "$executor/contract-executor.jar" "$executor/sc-api-support.jar" "$dir/" cp -a "$jdk" "$dir/$javadir" install -m 644 "$here/mainnet/settings.properties" "$here/mainnet/default_confidants.txt" "$dir/" +# the node reads VERSION for the "node" field of the snapshots it builds; a package extracted over an +# older folder corrects it +printf '%s\n' "$version" > "$dir/VERSION" install -m 644 "${hosts:-$here/mainnet/known_hosts.txt}" "$dir/known_hosts.txt" # the serving nodes the weekly survey found (ci/known-hosts/snapshot_sources.py), when it has found any [ ! -f "$here/mainnet/snapshot_sources.txt" ] || install -m 644 "$here/mainnet/snapshot_sources.txt" "$dir/snapshot_sources.txt" From daa9bcde6d6da6d36494f21f4bb037065c20d5f4 Mon Sep 17 00:00:00 2001 From: EnzinoBB Date: Tue, 27 Oct 2026 15:39:02 +0100 Subject: [PATCH 3/4] docs: CHANGES for community.14 Co-Authored-By: Claude Sonnet 5.5 --- docs/CHANGES.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/docs/CHANGES.md b/docs/CHANGES.md index 9ebd4eba1..7feb34f88 100644 --- a/docs/CHANGES.md +++ b/docs/CHANGES.md @@ -23,6 +23,8 @@ lines under the new release. - **Snapshots.** A node builds, verifies and restores signed snapshots itself, downloads the one published on GitHub on request, and shares snapshots with its p2p neighbours, so that a new node starts in minutes from several independent sources. See [snapshots.md](snapshots.md). +- **Windows and macOS.** Packages for Windows (x64) and macOS (Apple Silicon), with a mainnet check + that the three systems agree on the state. - **Wallet state digest.** A digest of all wallet state, logged every 1000 blocks, lets different nodes and builds compare their state. - **Continuous integration.** @@ -35,6 +37,10 @@ lines under the new release. ## Not released yet +Nothing yet. + +## community.14 — 2026-10-27 + | PR | Change | |---|---| | #113 | packaging: one package per build for full and pruned storage (`config.ini` full, `config.pruned.ini` pruned on LMDB), half the release size; the workflows that take the latest package accept both layouts | @@ -42,6 +48,22 @@ lines under the new release. | #115 | Windows and macOS nodes load the checkpoints and snapshots of Linux and sync mainnet with the same state digests: the binary checkpoint header records `long` as 8 bytes on every system (`cs::ArchiveOutput`, read back by `cs::ArchiveInput`), checkpoint text files are read and written in binary mode, macOS Boost is built as C++17; `Transport` releases the routing table with the p2p host, fixing a use-after-free at exit (a crash on macOS); a platform consensus check in CI | | #116 | snapshot: `node --survey-snapshots [seconds]` asks the neighbours for the snapshots they serve without opening the chain and prints what they declared; the weekly known-hosts job turns it into `snapshots.md` and `snapshot_sources.txt` (shipped in the packages when present) | | #117 | client: `--download-snapshot`, `--import-snapshot` and `--export-snapshot` start the logger with the configured levels; they printed every debug and trace record of the import to the console (about 684,000 lines for one `--download-snapshot`, the Docker first start included) | +| — | release: the version announced to peers (`MINOR_NODE_VERSION`) is 14; the packages and the Docker image carry a `VERSION` file with the release's version, which the node puts in the snapshots it builds | + +Windows and macOS (#113–#115). The release has a package for Windows (x64, a `.zip`) and for macOS +(Apple Silicon) next to the Linux ones, each with its own JDK (Eclipse Temurin 11); the Linux +package is one for full and pruned storage now (`config.ini`, `config.pruned.ini`), half the size +of the two it replaces. A Windows or macOS node loads the checkpoints and snapshots a Linux node +wrote and the other way round, and syncs mainnet with the same state digests: three nodes, one on +each system, restored the published snapshot and logged identical digests for 91 blocks, at 26,000 +to 51,000 blocks per minute from the snapshot to the head. On Linux the checkpoint and snapshot +files are byte for byte what they were. A use-after-free at exit (the routing table outliving the +p2p host) is fixed; it crashed the macOS node at every stop and was undefined behaviour on the +other systems. + +Snapshots (#116, #117). `node --survey-snapshots` shows which neighbours serve which snapshot, +and a weekly job publishes it with a list of serving nodes. `--download-snapshot` and the other +snapshot commands no longer print every debug record of the import to the console. ## community.13 — 2026-10-26 From e2b89532a4b13eed5a916f6e24049e1c2b45a51f Mon Sep 17 00:00:00 2001 From: EnzinoBB Date: Tue, 27 Oct 2026 15:39:20 +0100 Subject: [PATCH 4/4] release: the Windows and macOS packages are published with the release Their consensus check on mainnet (platform-sync.yml) runs on the packages of the commit before the tag. Co-Authored-By: Claude Sonnet 5.5 --- .github/workflows/release.yml | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 139f57319..710f91194 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -45,9 +45,10 @@ env: TEMURIN_WINDOWS_SHA256: d5008f02174c1ad21c10407cbf104815cb390ec4c263d53946e8d0507d7a77f9 TEMURIN_MACOS: OpenJDK11U-jdk_aarch64_mac_hotspot_11.0.32.1_1.tar.gz TEMURIN_MACOS_SHA256: c487a1c3a56588b3a32d0d07cdd526bf3d401c4b8422be772ca178bfcd647f3f - # the Windows and macOS packages join a published release only once a node on each system has - # matched the Linux state digests on mainnet; until then they are workflow artifacts - PUBLISH_PLATFORMS: 'false' + # the Windows and macOS packages join a published release: a node of each system matched the Linux + # state digests on mainnet (platform-sync.yml, run on the packages of this commit before the tag). + # 'false': they stay workflow artifacts + PUBLISH_PLATFORMS: 'true' jobs: # the node for Ubuntu 20.04 and later (glibc 2.31); the default build below needs glibc 2.38