Consensus & Network

• Only arm a peer stall deadline for a getblocks with a non-zero stop hash. An open-ended getblocks needs no reply, so the deadline disconnected honest, fully-synced peers (btcsuite/btcd#1317).
• Stop replying to getblocks with an empty notfound when pruned.
• Fix a hang on shutdown caused by a blocking queue send to a peer that had already quit.
• Always signal the send completion channel when serving a merkle block, which could otherwise wedge a peer's input handler.
• Fix two data races in the connection manager on ConnReq.Addr.
• Log a warning when a transaction is relayed to no peer, which happens when its fee rate is below every peer's fee filter.

Mining

• Pad the coinbase to the minimum transaction size enforced at the block height. Block generation was permanently broken on regtest above height 1000 and simnet above 3000.
• Set the Upgrade9 behavior flag in CheckConnectBlockTemplate, which rejected valid CashToken transactions in getblocktemplate.

RPC & gRPC

• Match transaction subscriptions on the address funding an input, so spends of outputs the subscription did not watch arrive now notify. Confirmed parents require --txindex.
• Report the missing parent rather than "already have transaction" when submitting a transaction held in the orphan pool, matching BCHN.
• Make the estimatefee nblocks parameter optional, matching BCHN and Bitcoin ABC 0.19.1.

Database

• Fix a panic when a block rolls the block store over to a new flat file. The panic was recovered while the file lock was held, leaving the database wedged rather than crashing.

Security

• Fix a CashTokens consensus rule violation allowing minting NFT forgery. The authorization check shared one flag across all output categories, so a single authorized minting output authorized every other one in the same transaction. Reported by 0xaudron.
• Fix a remotely triggerable crash in the committed filter handlers, which dereferenced a missing index. --fastsync also advertised NODE_CF without maintaining one.
• Reject raw transactions with trailing bytes in decoderawtransaction and sendrawtransaction, which were previously discarded and the transaction relayed.

Build & Packaging

• Publish the Docker image to GHCR on each release tag.
• Rewrite the deprecated io/ioutil usage go-bindata emits, with a make bindata target so it survives regeneration.
• Update dependencies, including google.golang.org/grpc, golang.org/x/crypto, and golang.org/x/net.

Other

• Export bchec.ErrInvalidSquareRoot for use with errors.Is.
• Modernize loops to range over integers, and adopt slices.Backward and strings.Builder.
• Assert the CHIP-2021-05 hashing density limit in the VM limits tests, which previously carried a check that could never execute.
• Fail rather than skip in the invalid VMB vector tests when a vector executes without error.
• Fix flaky address manager tests by generating only routable addresses.
• Removed support for plan9.

Consensus & Network

• Only arm a peer stall deadline for a getblocks with a non-zero stop hash. An open-ended getblocks needs no reply, so the deadline disconnected honest, fully-synced peers (btcsuite/btcd#1317).
• Stop replying to getblocks with an empty notfound when pruned.
• Fix a hang on shutdown caused by a blocking queue send to a peer that had already quit.
• Always signal the send completion channel when serving a merkle block, which could otherwise wedge a peer's input handler.
• Fix two data races in the connection manager on ConnReq.Addr.
• Log a warning when a transaction is relayed to no peer, which happens when its fee rate is below every peer's fee filter.

Mining

• Pad the coinbase to the minimum transaction size enforced at the block height. Block generation was permanently broken on regtest above height 1000 and simnet above 3000.
• Set the Upgrade9 behavior flag in CheckConnectBlockTemplate, which rejected valid CashToken transactions in getblocktemplate.

RPC & gRPC

• Match transaction subscriptions on the address funding an input, so spends of outputs the subscription did not watch arrive now notify. Confirmed parents require --txindex.
• Report the missing parent rather than "already have transaction" when submitting a transaction held in the orphan pool, matching BCHN.
• Make the estimatefee nblocks parameter optional, matching BCHN and Bitcoin ABC 0.19.1.

Database

• Fix a panic when a block rolls the block store over to a new flat file. The panic was recovered while the file lock was held, leaving the database wedged rather than crashing.

Security

• Fix a CashTokens consensus rule violation allowing minting NFT forgery. The authorization check shared one flag across all output categories, so a single authorized minting output authorized every other one in the same transaction. Reported by 0xaudron.
• Fix a remotely triggerable crash in the committed filter handlers, which dereferenced a missing index. --fastsync also advertised NODE_CF without maintaining one.
• Reject raw transactions with trailing bytes in decoderawtransaction and sendrawtransaction, which were previously discarded and the transaction relayed.

Build & Packaging

• Publish the Docker image to GHCR on each release tag.
• Rewrite the deprecated io/ioutil usage go-bindata emits, with a make bindata target so it survives regeneration.
• Update dependencies, including google.golang.org/grpc, golang.org/x/crypto, and golang.org/x/net.

Other

• Export bchec.ErrInvalidSquareRoot for use with errors.Is.
• Modernize loops to range over integers, and adopt slices.Backward and strings.Builder.
• Assert the CHIP-2021-05 hashing density limit in the VM limits tests, which previously carried a check that could never execute.
• Fail rather than skip in the invalid VMB vector tests when a vector executes without error.
• Fix flaky address manager tests by generating only routable addresses.
• Removed support for plan9.

v0.22.2 Latest

Latest

Compare

Choose a tag to compare

Consensus & Network

• Only arm a peer stall deadline for a getblocks with a non-zero stop hash. An open-ended getblocks needs no reply, so the deadline disconnected honest, fully-synced peers (btcsuite/btcd#1317).
• Stop replying to getblocks with an empty notfound when pruned.
• Fix a hang on shutdown caused by a blocking queue send to a peer that had already quit.
• Always signal the send completion channel when serving a merkle block, which could otherwise wedge a peer's input handler.
• Fix two data races in the connection manager on ConnReq.Addr.
• Log a warning when a transaction is relayed to no peer, which happens when its fee rate is below every peer's fee filter.

Mining

• Pad the coinbase to the minimum transaction size enforced at the block height. Block generation was permanently broken on regtest above height 1000 and simnet above 3000.
• Set the Upgrade9 behavior flag in CheckConnectBlockTemplate, which rejected valid CashToken transactions in getblocktemplate.

RPC & gRPC

• Match transaction subscriptions on the address funding an input, so spends of outputs the subscription did not watch arrive now notify. Confirmed parents require --txindex.
• Report the missing parent rather than "already have transaction" when submitting a transaction held in the orphan pool, matching BCHN.
• Make the estimatefee nblocks parameter optional, matching BCHN and Bitcoin ABC 0.19.1.

Database

• Fix a panic when a block rolls the block store over to a new flat file. The panic was recovered while the file lock was held, leaving the database wedged rather than crashing.

Security

• Fix a CashTokens consensus rule violation allowing minting NFT forgery. The authorization check shared one flag across all output categories, so a single authorized minting output authorized every other one in the same transaction. Reported by 0xaudron.
• Fix a remotely triggerable crash in the committed filter handlers, which dereferenced a missing index. --fastsync also advertised NODE_CF without maintaining one.
• Reject raw transactions with trailing bytes in decoderawtransaction and sendrawtransaction, which were previously discarded and the transaction relayed.

Build & Packaging

• Publish the Docker image to GHCR on each release tag.
• Rewrite the deprecated io/ioutil usage go-bindata emits, with a make bindata target so it survives regeneration.
• Update dependencies, including google.golang.org/grpc, golang.org/x/crypto, and golang.org/x/net.

Other

• Export bchec.ErrInvalidSquareRoot for use with errors.Is.
• Modernize loops to range over integers, and adopt slices.Backward and strings.Builder.
• Assert the CHIP-2021-05 hashing density limit in the VM limits tests, which previously carried a check that could never execute.
• Fail rather than skip in the invalid VMB vector tests when a vector executes without error.
• Fix flaky address manager tests by generating only routable addresses.

Consensus & Network

• Remove the defunct dnsseed.electroncash.de DNS seed.

Mining

• Include the Upgrade9 (CashTokens) script flags when building block templates. Templates were previously validated with the bare StandardVerifyFlags, so on token-active networks valid CashToken transactions already in the mempool were dropped from the template, producing empty or near-empty blocks; the flags are now computed the same way the mempool and consensus block validation do.

Other

• Modernize sync/atomic usage with the typed atomic APIs and adopt WaitGroup.Go.

Consensus & Network

• Remove the defunct dnsseed.electroncash.de DNS seed.

Mining

• Include the Upgrade9 (CashTokens) script flags when building block templates. Templates were validated with the bare StandardVerifyFlags, so on token-active networks valid CashToken transactions were dropped from the template, producing empty or near-empty blocks.

Other

• Modernize sync/atomic usage with the typed atomic APIs and adopt WaitGroup.Go.

v0.22.1

Compare

Choose a tag to compare

This release adds support for the May 15, 2026 Bitcoin Cash network upgrade ("upgrade12"). All node operators must upgrade before activation to stay in consensus.

What's new

• CHIP-2021-05 — Bounded looping operations (OP_BEGIN / OP_UNTIL)
• CHIP-2025-05 Functions — Function definition and invocation (OP_DEFINE / OP_INVOKE)
• CHIP-2025-05 Bitwise — Re-enables OP_INVERT, OP_LSHIFTNUM, OP_RSHIFTNUM, OP_LSHIFTBIN, OP_RSHIFTBIN
• CHIP-2024-12 P2S — Pay-to-Script standardization
• VMB test vectors for all of the above

Activation

Upgrade notes

• No database migration required.
• Pre-upgrade script types (P2PKH, P2SH20, P2SH32, etc.) continue to behave as before.
• Upgrade before May 15, 2026 to avoid consensus divergence.

Full Changelog: v0.21.1...v0.22.0

Consensus & Network

• Add network parameters and activation logic for the May 15, 2026 BCH upgrade (Upgrade12), gating the new script flags by activation time across chains.
• Implement CHIP-2024-12 P2S (Pay to Script).
• Implement CHIP-2025-05 Functions: function definition and invocation operations.
• Implement CHIP-2021-05 Loops: bounded looping operations.
• Implement CHIP-2025-05: re-enable the bitwise opcodes OP_INVERT, OP_2MUL, OP_2DIV, OP_LSHIFT, and OP_RSHIFT.
• Align Upgrade12 consensus, policy, and VMB tests with BCHN, including corrected operation-cost accounting.

Security

• Fix CVE-2018-17145 (inv-message memory-exhaustion denial-of-service vector).

Build & Packaging

• Bump the Dockerfile to the latest Go release and trim the Docker build context.

Other

• Add VMB (VM bytecode) test vectors for the May 2026 upgrade covering bitwise ops, loops, functions, and P2S.

v0.22.0

Compare

Choose a tag to compare

• Fixed "go get: module source tree too large" issue
• Reduced size for json tests
• Refactor: use the built-in max/min to simplify the code

Build & Packaging

• Gzip test fixtures and ignore node_modules to dramatically reduce the module/package size, resolving "module source tree too large" errors when installing through the Go module proxy.

v0.21.1

Compare

Choose a tag to compare

• Ensure CashToken data is populated correctly for gRPC endpoints.
• Update README.md with accurate install directions.
• A few minor memory improvements.
• Update GW RPC tests.

Consensus & Network

• Add full support for the BCH May 2023 network upgrade (Upgrade 9): native CashTokens, new token-aware opcodes, P2SH32 outputs, and updated transaction size limits (#545).
• Implement ABLA (Adaptive Blocksize Limit Algorithm) for the dynamic block size limit, with state persisted to the database and a fixed-size config option (#545, #553).
• Add chipnet support and bring TestNet4 onto the correct network magic bytes with updated chain parameters (#545).
• Bump the P2P protocol version to 70016 and update DNS seeds to match BCHN, adding bchd.cash seeds.
• Add support for receiving the sendaddrv2 message from peers, including before verack (#554).
• Fix a consensus incompatibility in txscript.IsUnspendable that diverged from other implementations and posed a fork/UTXO-commitment risk (#475).

Mempool & Policy

• Actively prevent network discovery and outbound connections when running in regression-test (regnet) mode (#519).

RPC & gRPC

• Add the signrawtransactionwithkey JSON-RPC method (#497).
• Expose CashTokens token data and TestNet4 in the gRPC (bchrpc) API, and populate token data correctly across endpoints.
• Increase RPC read/write timeouts to 5 minutes for expensive lookups (#515).

Wallet & Indexing

• Fix an SLP graph indexer bug and correct SLP index map allocation.

Performance

• Reduce map allocations during block processing and avoid slice reallocations in processOrphans.

Security

• Fix an opcodeCheckSig bug where input token data was not passed to the BIP143 signature hash under certain conditions (#552).

Build & Packaging

• Update to Go 1.23.4 and migrate CI from Travis to GitHub Actions.
• Fix bchctl in the Dockerfile and update the Kubernetes deployment to handle certificates.

Bug Fixes

• Fix a bug when cloning the script engine stacks used by meep (#506).

v0.20.0

Compare

Choose a tag to compare

• Updated seeds to match BCHN and add newly restored BCHD seeds.
• Fixed syncing issue with nodes supporting sendaddrv2 messages.
• Fixed syncing testnet4 with SLP indexes.

v0.20.0-rc2

Compare

Choose a tag to compare

This is a huge milestone. Finally are back in consensus with the rest of the BCH ecosystem!

v0.20.0-rc1

Compare

Choose a tag to compare

• Includes changes required for the May 15th, 2022 upgrade. #499

Consensus & Network

• Implement the May 2022 BCH hard fork: 64-bit script integers, native introspection opcodes, and OP_MUL, with fork activation and new TestNet4 parameters (#499).

Mempool & Policy

• Treat OP_RETURN OP_1NEGATE as a standard transaction (#476).

RPC & gRPC

• Add HTTPS support to the gRPC proxy (#478).

Bug Fixes

• Fix NullDataScript handling and standardness tests (#477).

v0.19.0

Compare

Choose a tag to compare

This is a maintenance release and we urge all users to upgrade!

• Peer syncing improvements (#470)
• Fix panic issue due to nil bucket (#473)

Consensus & Network

• Improve peer and sync-manager candidate selection, including a regtest isSyncCandidate fix (#470).
• Isolate height checks in peer syncing (#471).

Wallet & Indexing

• Guard against nil buckets in the address, cfilter, SLP, and tx indexers to prevent panics (#473).

Other

• Promote select peer logging messages from trace to debug level (#469).

v0.18.1

Compare

Choose a tag to compare

Consensus & Network

• Avoid connecting to Bitcoin ABC nodes and prevent the connection manager from dialing duplicate addresses (#450).
• Remove the dead seed-bch.bitcoinforks.org DNS seed (#443).
• Add a clean-shutdown check in updateSyncPeer to avoid races during node shutdown (#442).

Mempool & Policy

• Allow multiple OP_RETURN (null-data) outputs per transaction via a configurable policy (#467).

Mining

• Add a SignMuSig function to the bchec package (#457).

RPC & gRPC

• Add SLP gRPC/REST endpoints and fields: GetParsedSlpScript, GetTrustedValidation, GetTokenMetadata, and CheckSlpTransaction (with DisableSlpBurnErrors), plus SLP token metadata/addresses on GetTransaction, GetUnspentOutput, and the transaction subscription filters (#387, #458).
• Validate SLP transactions by default in SubmitTransaction (clients must opt out via skip_slp_validity_check) to guard against accidental token burns (#387).
• Add a gRPC-gateway REST/JSON proxy server (with CORS and no-cache middleware) and regenerated Swagger definitions for the bchrpc API (#387).
• Return pubkey (P2PK) outputs from GetAddressUnspentOutputs (#432).

Wallet & Indexing

• Add the SLP (Simple Ledger Protocol) token index, validating SLP/NFT1 token transactions (genesis, mint, send, mint-baton tracking, burn detection) with a new --slpindex config option (#387, #452).
• Add SLP Graph Search, building a token transaction graph to support trusted client-side validation (#451).
• Fix index-manager handling of indexers whose StartBlock() height is greater than 0, so SLP and other late-starting indexes sync correctly (#455).
• Refuse to start an index on a pruned node (print an error and exit) and prevent a crash when SLP index initialization fails (#433).

Performance

• Flush the UTXO cache during state reconstruction and correctly set lastFlushHash on init, with tests for a hard shutdown mid-flush (#445, #446, #447).

Build & Packaging

• Add Prometheus metrics support and per-component shutdown logging (#453).
• Add darwin/arm64 (Apple Silicon) binary builds.
• Add RegressionTestAnyHost and RegressionTestNoReset regtest options for Docker-based setups (#462).

Bug Fixes

• Fix a panic in the fee estimator triggered by chain reorgs (#434).
• Fix a crash related to unconfirmed NFT child tokens in the gRPC server (#387).