From 96b11effe4a60e7a5d541e6ee9efb60f5b2baeca Mon Sep 17 00:00:00 2001 From: EnzinoBB Date: Tue, 10 Nov 2026 22:05:08 +0100 Subject: [PATCH] docs, release: community.18.2 Co-Authored-By: Claude Opus 5.5 --- docs/CHANGES.md | 10 ++++++++++ docs/FEATURES.md | 6 +++++- docs/differences.md | 2 +- docs/quick-start.md | 16 ++++++++-------- 4 files changed, 24 insertions(+), 10 deletions(-) diff --git a/docs/CHANGES.md b/docs/CHANGES.md index 7965f53b2..d762cb2c7 100644 --- a/docs/CHANGES.md +++ b/docs/CHANGES.md @@ -42,10 +42,20 @@ lines under the new release. ## Not released yet +Nothing yet. + +## community.18.2 — 2026-11-10 + +Release 18.2 is a point release of 18: the protocol and the announced minor version (18) are unchanged. It applies one known state correction on mainnet: the balance of wallet `7hWM6wvs` lacks one contract-state fee, which made community nodes the stage-3 minority in every round where that wallet is a confidant. It also carries the CI and documentation changes merged since 18.1. + | PR | Change | |---|---| +| release | community.18.2, a point release of 18: `MINOR_NODE_VERSION` stays 18, the package and the tag carry 4.2.532-community.18.2 | +| #184 | state correction: `csnode/statecorrection`, a table of known state differences (one entry: `7hWM6wvs`, +0.008740234375 CS, mainnet only, from block 176,760,929, with optional counterpart adjustments); applied at a block where the wallet is a trusted confidant, only if the stored reward split differs from the one this node's stakes give and is reproduced exactly with the delta, so a correct state is never changed and a correction is never applied twice | +| #183 | ci: the macOS job of `mainnet-join.yml` runs on macos-15 | | #181 | docs: the design documents of snapshot serving over p2p and of backward sync (`docs/specs`), each with a note on what was implemented and where the code differs | | #182 | ci: `mainnet-join.yml`, the Linux, Windows and macOS packages each start on mainnet with an empty database, fetch their snapshot over p2p from a named source and must log the same state digests (run with a `mainnet-join-*` tag or manually) | +| #180 | tests: the `PollUntil` deadline test tolerates a slow runner (test only) | ## community.18.1 — 2026-11-09 diff --git a/docs/FEATURES.md b/docs/FEATURES.md index c041c0191..16ae76826 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.18.1 or earlier. +Everything listed here is in release 4.2.532-community.18.2 or earlier. ## Storage @@ -143,6 +143,10 @@ Everything listed here is in release 4.2.532-community.18.1 or earlier. stage-1 messages made the confidants build different blocks and left the node in the stage-3 minority. A replacement on the writer side and in a bootstrap round still signs twice. [#178](https://github.com/CreditsCommunity/node/pull/178) +- **Known state correction.** A table of proven state differences (one entry: wallet `7hWM6wvs`, + one contract-state fee) is applied on mainnet only, only where the stored block reward split + proves it and a node's own state does not already match, so a node synced from scratch is not + changed. [#184](https://github.com/CreditsCommunity/node/pull/184) ## Diagnostics diff --git a/docs/differences.md b/docs/differences.md index 1ed238c1a..4f74d09c0 100644 --- a/docs/differences.md +++ b/docs/differences.md @@ -109,7 +109,7 @@ from the Thrift definitions of the fork | Field | Value | |---|---| | `9: optional i64 networkUuid` | The chain identifier: the first 8 bytes of the hash of block 1, read as a little-endian unsigned 64-bit number (`BlockChain::uuid()`). It is the same on every node of a network, so a client such as a wallet can tell mainnet from a test network. Pruned nodes and nodes started from a snapshot know it too (it is in the checkpoint). Left out while the node does not know it yet (an empty database before block 1). Thrift has no unsigned type: the same 64 bits travel as a signed number, so mainnet, `11024959585341937636`, arrives as `-7421784488367613980`; add 2^64 to a negative value (or mask with `0xFFFFFFFFFFFFFFFF`) to get the unsigned one. | -| `10: optional string communityVersion` | The package version, the first line of the `VERSION` file, for example `4.2.532-community.18.1`. Without a `VERSION` file it is `4.2..`. Always set by the community node. | +| `10: optional string communityVersion` | The package version, the first line of the `VERSION` file, for example `4.2.532-community.18.2`. Without a `VERSION` file it is `4.2..`. Always set by the community node. | The official node sets neither field, and clients built from the official definitions ignore them, so a client can detect a community node by the presence of `communityVersion`. A local clone made diff --git a/docs/quick-start.md b/docs/quick-start.md index 364750ee7..8d2b4a6dc 100644 --- a/docs/quick-start.md +++ b/docs/quick-start.md @@ -124,16 +124,16 @@ caches. 1. Open the [latest release](https://github.com/CreditsCommunity/node/releases/latest) and download the Linux package and `SHA256SUMS`: - - `credits-node-4.2.532-community.18.1-linux-x64.tar.gz` for Ubuntu 24.04, Debian 13 and later + - `credits-node-4.2.532-community.18.2-linux-x64.tar.gz` for Ubuntu 24.04, Debian 13 and later (glibc 2.38); - - `credits-node-4.2.532-community.18.1-linux-x64-glibc2.31.tar.gz` for Ubuntu 20.04, Debian 11 + - `credits-node-4.2.532-community.18.2-linux-x64-glibc2.31.tar.gz` for Ubuntu 20.04, Debian 11 and later. 2. Check and extract: ```sh sha256sum -c --ignore-missing SHA256SUMS # must print "OK" - tar -xzf credits-node-4.2.532-community.18.1-linux-x64.tar.gz + tar -xzf credits-node-4.2.532-community.18.2-linux-x64.tar.gz cd csnode ``` @@ -209,12 +209,12 @@ The node's own log is in `csnode/log/`. ## 5. Native on Windows -1. Download `credits-node-4.2.532-community.18.1-windows-x64.zip` and `SHA256SUMS-windows-macos` +1. Download `credits-node-4.2.532-community.18.2-windows-x64.zip` and `SHA256SUMS-windows-macos` from the [latest release](https://github.com/CreditsCommunity/node/releases/latest). Check it in PowerShell and compare with the file: ```powershell - Get-FileHash credits-node-4.2.532-community.18.1-windows-x64.zip + Get-FileHash credits-node-4.2.532-community.18.2-windows-x64.zip ``` 2. Extract the zip, for example to `C:\credits`. Open the `csnode` folder. @@ -234,12 +234,12 @@ The package has no Windows service. Run the node in a console window you keep op ## 6. macOS (Apple Silicon) -Download `credits-node-4.2.532-community.18.1-macos-arm64.tar.gz`, check it with +Download `credits-node-4.2.532-community.18.2-macos-arm64.tar.gz`, check it with `shasum -a 256 -c --ignore-missing SHA256SUMS-windows-macos`, extract it, then clear the download quarantine once (the binaries are not signed) and follow the Linux steps: ```sh -tar -xzf credits-node-4.2.532-community.18.1-macos-arm64.tar.gz +tar -xzf credits-node-4.2.532-community.18.2-macos-arm64.tar.gz xattr -dr com.apple.quarantine csnode cd csnode && ./setup.sh ``` @@ -251,7 +251,7 @@ In the console or the log (`csnode/log/`, or `docker compose logs -f`), look for 1. The banner with the version and your settings: ``` - node 4.2.532-community.18.1 (protocol 532, build ...) + node 4.2.532-community.18.2 (protocol 532, build ...) storage: pruned, lmdb snapshots: serve on ```