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
10 changes: 10 additions & 0 deletions docs/CHANGES.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
6 changes: 5 additions & 1 deletion 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.18.1 or earlier.
Everything listed here is in release 4.2.532-community.18.2 or earlier.

## Storage

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

Expand Down
2 changes: 1 addition & 1 deletion docs/differences.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.<protocol>.<minor>`. 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.<protocol>.<minor>`. 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
Expand Down
16 changes: 8 additions & 8 deletions docs/quick-start.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
```

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

Expand Down
Loading