diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index fe08f2281..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 @@ -224,9 +225,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/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 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; 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"