Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 8 additions & 6 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
2 changes: 1 addition & 1 deletion client/config/config.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -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";
Expand Down
22 changes: 22 additions & 0 deletions docs/CHANGES.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.**
Expand All @@ -35,13 +37,33 @@ 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 |
| #114 | the node builds and passes its tests on Windows (MSVC, x64) and macOS (Apple Silicon): POSIX-only code behind `lib/system/platform.hpp`, the database lock now also on Windows, a new `build-platforms.yml` workflow; the release workflow also makes a Windows `.zip` and a macOS package (with Eclipse Temurin 11), kept as artifacts until a mainnet state-digest check on each system |
| #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

Expand Down
16 changes: 13 additions & 3 deletions docs/FEATURES.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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

Expand Down Expand Up @@ -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.
Expand Down
17 changes: 13 additions & 4 deletions docs/differences.md
Original file line number Diff line number Diff line change
Expand Up @@ -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;
Expand Down
2 changes: 2 additions & 0 deletions packaging/docker/entrypoint.sh
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
3 changes: 3 additions & 0 deletions packaging/make-package.sh
Original file line number Diff line number Diff line change
Expand Up @@ -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"
Expand Down
Loading