Skip to content

Releases

v2.2.2.0

Choose a tag to compare

@github-actions github-actions released this 26 Oct 22:11

Automatic update to Nethermind 2.2.2.

Built from Nethermind 2.2.2 @ be201120

Nethermind 2.2.2 Release Notes

v2.2.1.0

Choose a tag to compare

@github-actions github-actions released this 22 Oct 21:05

Automatic update to Nethermind 2.2.1.

Built from Nethermind 2.2.1 @ c4f1015b

Nethermind 2.2.1 Release Notes

v2.2.0.0

Choose a tag to compare

@github-actions github-actions released this 19 Oct 23:20
v2.2.0.0
d16d635

This release moves the plugin to Nethermind 2.2.0, restores the startup logic that Nethermind 2.0 silently stopped running, and fixes how MESS scores reorgs. It covers everything since v2.1.0.0.

⚠️ Breaking: EtcMining.Coinbase replaces KeyStore.BlockAuthorAccount

Etchash never signs anything, so mining no longer uses a signing key. Block rewards are paid to the new EtcMining.Coinbase address.

  • EtcMining.Coinbase is required when EtcMining.Mode is Local, Remote or Manual. A zero address stops the node at startup.
  • A leftover KeyStore.BlockAuthorAccount also stops the node at startup. Remove it and set EtcMining.Coinbase instead.
  • Before, an unloadable BlockAuthorAccount key made Nethermind fall back to the node key and pay rewards to a generated address. Nethermind 2.2.0 makes that case fatal.

⚠️ Requires Nethermind 2.2.0

The plugin is built against Nethermind 2.2.0, which changed the BlockTree constructor. Upgrade the node and the plugin together, or use one of the bundles below, which ship both.

Changes

Nethermind 2.2.0 (#19)

  • Pass the new BlockTreeMutationLock to BlockTree.
  • Refresh the Classic and Mordor snap sync pivots.

Restore the plugin startup logic (#20)

  • Nethermind removed the Init and InitNetworkProtocol plugin hooks. They were default interface methods, so the plugin kept compiling while its overrides silently stopped running. The gas token ticker, the mining configuration check and the MESS activation monitor were not running.
  • They now run as startup steps. The plugin implements the plugin interface explicitly, so a member removed upstream fails the build instead of going dead.
  • Enabling EtcMess.Enabled made the node fail at startup because its keyed DB parameters could not be resolved. Fixed.

MESS (#21)

  • A block is scored when it is suggested and again before it is processed. A fork rejected by MESS is stored but not processed, and no longer blocks honest extensions. Before, it stayed canonical while Head stayed behind.
  • The common ancestor's total difficulty is loaded, where it used to count as zero.
  • The walk to the common ancestor has no depth limit, and a fork whose ancestor is not found is rejected, as in core-geth. Before, reorgs deeper than 8192 blocks were accepted.
  • A head slightly ahead of the local clock no longer switches MESS off.
  • The polynomial now has core-geth's reference vectors in the tests.

Coinbase (#22)

  • See the breaking change above.

Verification

  • 114 unit tests passing.
  • Integration test against Nethermind 2.2.0: 14/14 across the Manual, Remote and Local mining modes, the MESS monitor, and both invalid mining configurations.

Nethermind 2.2.0 Release Notes


Built from plugin ref main (commit d16d6357).

Bundles include Nethermind from NethermindEth/nethermind@2.2.0.

Built from Nethermind 2.2.0 @ 1d2aff00

v2.1.0.0

v2.1.0.0 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 06 Oct 18:10

⚠️ Known issue (inherited from v2.0.0.0): upgrade to v2.2.2.0

Syncing (including snap sync), block validation and mining work. Two startup checks don't run, because Nethermind 2.0 removed the plugin hooks they ran from. An invalid mining configuration is not rejected at startup, and block logs show the reward as ETH instead of ETC. Fixed in v2.2.0.0.

Before upgrading, read the EtcMining.Coinbase breaking change in v2.2.0.0.


Automatic update to Nethermind 2.1.0.

Built from Nethermind 2.1.0 @ b3e7e84c

Nethermind 2.1.0 Release Notes

v2.0.0.0

Choose a tag to compare

@github-actions github-actions released this 23 Sep 12:31
v2.0.0.0
67afbb8

⚠️ Known issues: upgrade to v2.2.2.0

Syncing, block validation and mining work. Two things don't:

  • Snap sync is off by default. The bundled classic.cfg and mordor.cfg disable Sync.FastSync and Sync.SnapSync and ship no pivot, so the node full-syncs from genesis. Snap sync works if you pass a recent pivot (--Sync.PivotNumber, --Sync.PivotHash, --Sync.PivotTotalDifficulty) and turn both flags on. Fixed in v2.1.0.0.
  • Two startup checks don't run, because Nethermind 2.0 removed the plugin hooks they ran from. An invalid mining configuration is not rejected at startup, and block logs show the reward as ETH instead of ETC. Fixed in v2.2.0.0.

Before upgrading, read the EtcMining.Coinbase breaking change in v2.2.0.0.


This release moves the plugin to Nethermind 2.0.0 and updates the network's peer discovery. It covers everything since the last stable release, v1.39.1.1, including the 1.39.2 and 1.39.3 updates.

⚠️ Requires Nethermind 2.0.0

Nethermind 2.0.0 changed block numbers from signed to unsigned integers across its plugin API, so this build does not load on Nethermind 1.x. The same change hits 1.x plugin builds going the other way. Upgrade the node and the plugin together, or use one of the bundles below, which ship both.

ETC consensus is unchanged. On mainnet the node reports the same current fork ID as core-geth, 0xbe46d57c (Spiral).

Changes

Nethermind 2.0.0 (#14)

  • Every block-number value in the plugin is now unsigned, as in Nethermind 2.0.0. That covers the ECIP-1017 rewards, ECIP-1099 epochs, the difficulty bomb, mining and the chainspec parameters.
  • Two difficulty-bomb branches relied on signed arithmetic. They now use explicit comparisons and have their own tests. Mainnet results are unchanged.
  • Chainspec engine parameters now use the same System.Text.Json converters as upstream. The plugin no longer depends on Newtonsoft.Json.

Bootnodes and DNS discovery (#15)

  • The bootnodes in classic.json and mordor.json match the ones core-geth ships. Each one was checked and is reachable.
  • Network.DiscoveryDns now points at etcdisco.net for both classic and mordor. It serves the same ENR tree, signed with the same key, as the blockd.info domain it replaces.

Nethermind 1.39.2 and 1.39.3

  • Rebuilt against both upstream patch releases. They were published as pre-releases.

Release automation (#13, #16)

  • The auto-update job no longer assumes the plugin revision is always .0.
  • The auto-update job no longer overwrites an open auto-update branch that already has manual fixes on it.

Verification

  • 107 unit tests passing.
  • Integration test against Nethermind 2.0.0: 10/10 across the Manual, Remote and Local mining modes.

Nethermind 2.0.0 Release Notes


Built from plugin ref main (commit 67afbb87).

Bundles include Nethermind from NethermindEth/nethermind@2.0.0.

Built from Nethermind 2.0.0 @ bec830cd

v1.39.3.0

Choose a tag to compare

@github-actions github-actions released this 07 Aug 01:13

Automatic update to Nethermind 1.39.3.

Built from Nethermind 1.39.3 @ 28cbe2a0

Nethermind 1.39.3 Release Notes

v1.39.2.0

Choose a tag to compare

@github-actions github-actions released this 27 Jul 18:20

Automatic update to Nethermind 1.39.2.

Built from Nethermind 1.39.2 @ 65689105

Nethermind 1.39.2 Release Notes

v1.39.1.1

Choose a tag to compare

@github-actions github-actions released this 20 Jul 22:56
v1.39.1.1
f8921b5

Remote mining now works end-to-end, and the mining modes were restructured around it. See #12 for the full change set.

Highlights

Remote mining fixed (EtcMining.Mode=Remote)

Previously eth_getWork returned -32002 No mining work available until someone called evm_mine, and after that the node froze on a single work template — an external getwork miner could never mine a block. Block production is now self-triggering, the way geth's remote sealer works:

  • a block template is built on startup, so eth_getWork serves work immediately;
  • a new template is built after each chain-head change, re-arming after every sealed block;
  • the template is refreshed periodically so pending transactions get picked up — configurable via the new EtcMining.WorkRefreshSeconds (default 4);
  • solutions for superseded work (a template just replaced by a refresh) are no longer silently dropped: if the sealed block still extends the current head it is imported, matching geth's stale-work acceptance;
  • the eth_getWork block-number field is now minimal-length hex (0x1, not 0x0000000000000001), matching geth's hexutil.EncodeUint64.

New: continuous CPU mining (EtcMining.Mode=Local)

Local now means real built-in CPU mining: the chain advances by itself, driven by the same template refresh cycle as Remote. Useful for private networks and testnets.

⚠️ Breaking: the old Local is now Manual

The previous Local mode never mined on its own — it sealed with the CPU only when evm_mine was called (a dev/test facility). It has been renamed to Manual to say what it does. If your config uses EtcMining.Mode=Local and you expect the old behavior, switch to EtcMining.Mode=Manual.

EtcMining.Mode now names the three valid combinations of sealer (CPU vs remote miners) × trigger policy (self-triggering vs manual evm_mine): Manual, Local, Remote. The broken fourth combination — remote sealing on a manual trigger — can no longer be configured.

Testing

  • New unit tests for the build-scheduling policy (ContinuousBuildScheduler); 105 passing.
  • The integration test now runs one node per mining mode — Manual, Remote, and Local — 10/10 passing.
  • Verified end-to-end with a real getwork miner (etchash hashimoto light): blocks mined and accepted both for current and for superseded-but-head-extending work.

Built from plugin ref main (commit f8921b57).

Bundles include Nethermind from NethermindEth/nethermind@1.39.1.

v1.39.1.0

Choose a tag to compare

@github-actions github-actions released this 17 Jul 00:06
80a8bb6

Built from plugin ref main (commit 80a8bb6c).

Bundles include Nethermind from NethermindEth/nethermind@1.39.1.

v1.39.0.0

Choose a tag to compare

@github-actions github-actions released this 08 Jul 21:07
de749ea

Ethereum Classic plugin for Nethermind, built for Nethermind 1.39.0.
Supports ETC Mainnet (chain ID 61) and the Mordor testnet (chain ID 63).

What's new

  • PoW mining RPC completed. Adds eth_submitHashrate, eth_hashrate and eth_mining on top of the existing eth_getWork / eth_submitWork, so external miners (e.g. ethminer) can report and read hashrate. Available when EtcMining.Mode = Remote.
  • Now runs on Nethermind 1.39.0 (upstream release notes).

Downloads

  • nethermind-etc-plugin-v1.39.0.0.zip — the plugin only (DLL + chainspecs + configs), to drop into an existing Nethermind 1.39.0 install.
  • nethermind-etc-v1.39.0.0-<os>.zip — full ready-to-run bundle (Nethermind 1.39.0 + plugin) for linux-x64, linux-arm64, macos-x64, macos-arm64 and windows-x64.
  • SHA256SUMS — checksums for the files above.

Start the node with --config classic (mainnet) or --config mordor.