Repository navigation
Releases
v2.2.2.0
Automatic update to Nethermind 2.2.2.
Built from Nethermind 2.2.2 @ be201120
v2.2.1.0
Automatic update to Nethermind 2.2.1.
Built from Nethermind 2.2.1 @ c4f1015b
v2.2.0.0
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.Coinbaseis required whenEtcMining.ModeisLocal,RemoteorManual. A zero address stops the node at startup.- A leftover
KeyStore.BlockAuthorAccountalso stops the node at startup. Remove it and setEtcMining.Coinbaseinstead. - Before, an unloadable
BlockAuthorAccountkey 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
BlockTreeMutationLocktoBlockTree. - Refresh the Classic and Mordor snap sync pivots.
Restore the plugin startup logic (#20)
- Nethermind removed the
InitandInitNetworkProtocolplugin 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.Enabledmade 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
Headstayed 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
⚠️ 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
v2.0.0.0
⚠️ 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.cfgandmordor.cfgdisableSync.FastSyncandSync.SnapSyncand 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
ETHinstead ofETC. 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.jsonandmordor.jsonmatch the ones core-geth ships. Each one was checked and is reachable. Network.DiscoveryDnsnow points atetcdisco.netfor both classic and mordor. It serves the same ENR tree, signed with the same key, as theblockd.infodomain 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
Automatic update to Nethermind 1.39.3.
Built from Nethermind 1.39.3 @ 28cbe2a0
v1.39.2.0
Automatic update to Nethermind 1.39.2.
Built from Nethermind 1.39.2 @ 65689105
v1.39.1.1
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_getWorkserves 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_getWorkblock-number field is now minimal-length hex (0x1, not0x0000000000000001), matching geth'shexutil.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
Built from plugin ref main (commit 80a8bb6c).
Bundles include Nethermind from NethermindEth/nethermind@1.39.1.
v1.39.0.0
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_hashrateandeth_miningon top of the existingeth_getWork/eth_submitWork, so external miners (e.g. ethminer) can report and read hashrate. Available whenEtcMining.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.