NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules
Go modules, #3022 by repository stars
Latest stable
v0.22.4
Last release 13 days ago
09 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 29 of 29 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
161 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
Nothing published for this version
This release fetches announced blocks through their headers, as BCHN does, cuts the memory --slpgraphsearch needs to about a fifth, and has the gRPC a
This release fetches announced blocks through their headers, as BCHN does, cuts the memory --slpgraphsearch needs to about a fifth, and has the gRPC address calls return the address's number of transactions. Nodes with --addrindex should read the upgrade notes first.
--slpgraphsearch keeps about 210 bytes per SLP transaction instead of the whole transaction (about 1,000 bytes for a typical SEND, more for larger ones), and reads the transactions a search returns from the memory pool or the transaction index.--slpgraphsearch takes about a third less memory at its peak, about 280 MB less per million SLP transactions.chipnet-seed.bchd.cash DNS seed.GetAddressTransactions and GetRawAddressTransactions return the address's number of confirmed transactions in confirmed_count.GetAddressTransactions and GetRawAddressTransactions with an nb_skip of 2^31 or more return no confirmed transactions instead of the newest ones.GetAddressTransactions and GetRawAddressTransactions no longer list a just-confirmed transaction as unconfirmed too.GetSlpGraphSearch and the graph search count of GetSlpTrustedValidation answer bad client input with InvalidArgument or NotFound instead of Internal or Aborted.GetSlpGraphSearch and GetSlpTrustedValidation answer a transaction the SLP index does not hold with NotFound, and a failure to read the index with Internal, rather than both with Aborted.GetSlpTrustedValidation answers a query hash of the wrong length with InvalidArgument rather than Aborted.GetSlpTokenMetadata answers a token with no GENESIS or metadata in the SLP index with NotFound, a failure to read the index with Internal, and a token ID of the wrong length with InvalidArgument, instead of Aborted.CheckSlpTransaction and SubmitTransaction answer Internal when the SLP index cannot read an input's entry, rather than taking the input for one without tokens.GetTransaction, GetBlock, GetMempool and GetAddressTransactions answer Internal, and the subscriptions send the transaction as UNKNOWN_OR_INVALID, instead of reporting an invalid SLP transaction that burns its inputs.GetUnspentOutput, GetAddressUnspentOutputs and GetTransaction answer Internal when the SLP index fails to read a token or its metadata, rather than leaving it out.GetUnspentOutput returns the SLP token and token metadata of a confirmed output, not only of an unconfirmed one.Internal, and streams send it with its SLP state unknown, instead of answering without its token or token metadata.GetUnspentOutput returns an output's SLP token metadata only when include_token_metadata is set, as GetAddressUnspentOutputs does, so clients that read it must now set the flag.GetSlpTokenMetadata no longer reports a mint baton that a block burned while confirming, from the memory pool, the GENESIS or MINT that created it.GetSlpTokenMetadata reports a token's mint baton ended once a MINT ending it is in the memory pool, as it does once the MINT is confirmed, instead of the baton the MINT spent.searchrawtransactions, the websocket address filters and notifyreceived, and the gRPC address calls and transaction filters refuse a legacy address from another network, such as a testnet address on mainnet, instead of reading it as this network's address with the same hash.--dropslpindex, instead of storing the spending transaction as invalid for good.bchrpc/pb with them.SIGHASH_UTXOS. SignTxOutputWithSigHashes, SignatureScriptWithSigHashes, RawTxInECDSASignatureWithSigHashes and RawTxInSchnorrSignatureWithSigHashes take the transaction's signature hashes, computed once for all its inputs, which must include the outputs it spends (NewTxSigHashes(tx).WithUtxos(tx, utxos)) for those. The functions without them can't see the spent outputs, so they now return an error for SIGHASH_UTXOS instead of a signature the network refuses.SIGHASH_UTXOS with SIGHASH_ANYONECANPAY.SignTxOutput and SignTxOutputWithSigHashes sign P2SH32 inputs.SignTxOutput keeps a P2PKH or P2PK signature from previousScript only if it is valid, and no longer returns an invalid script when re-signing one wrapped in P2SH.CalcSignatureHash returns an error for SIGHASH_UTXOS unless the signature hashes include all the outputs the transaction spends.--slpgraphsearch no longer logs an error for each SLP transaction that arrives while the graph loads.SignTxOutput drops multisig signatures in previousScript whose hash type the network refuses, and returns an error for a previousScript in Schnorr multisig mode instead of losing its signatures.SigHashOld, instead of a signature it rejects.SignTxOutput returns an error for a P2SH or P2SH32 input whose redeem script is itself P2SH or P2SH32, instead of an invalid script.--addrindex, nodes with it read the address index once to count the transactions of large addresses: under a second on chipnet, a few minutes at most on mainnet.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
--limitfreerelay , --norelaypriority , --blockminsize and --blockprioritysize are deprecated and do nothing.
This release makes validation, initial sync and block relay considerably faster, adds double spend proofs, block finalization and Tor v3 support, adds CashTokens data and several BCHN-compatible calls to the JSON-RPC server, and brings consensus validation in line with Bitcoin Cash Node in a number of edge cases. It also drops free transactions, as BCHN did, and fixes many robustness issues in the P2P, RPC, gRPC and database code. Upgrading is recommended for all nodes; read the upgrade notes first if the node sets --minrelaytxfee to 0 or uses --profile, runs pruned or with --addrindex or --slpindex, serves sendrawtransaction, websocket or gRPC clients, or is short of memory.
bchec, as btcd does. Script validation is 26% faster and mempool acceptance 18% faster.--gcpercent uses about half the CPU: ffldb commits to its cache's treaps in batches, the transaction and address indexes find transaction locations by scanning the block's bytes, and the SLP index sorts a block's transactions in linear time.--nocheckpoints validates every block in full.--gcpercent (default 50, up from v0.22.2's fixed 10) sets the garbage collector target; higher values trade memory for CPU. GOGC and GOMAXPROCS are no longer overridden.--maxtxfee (default 0.1 BCH, as in BCHN) is the highest fee sendrawtransaction and testmempoolaccept accept without allowhighfees.--maxreorgdepth (default 10) and --finalizationdelay (default 7200 seconds), as in BCHN.--rpcauthtimeout now also applies to websocket clients.--nodoublespendproof turns off double spend proofs.--sigcachemaxsize also bounds the cache of transaction signature hashes, whose entries for transactions that failed validation or left the mempool unmined stayed until restart.--maxpeers keeps --targetoutboundpeers slots for outbound peers, as BCHN keeps slots for its outbound connections, so inbound peers can't take them all. Persistent peers no longer count toward it, and a negative value is refused instead of crashing the node.--minrelaytxfee must be above 0 and at most 21000000. --limitfreerelay, --norelaypriority, --blockminsize and --blockprioritysize are deprecated and do nothing.--profile with a bare port listens on localhost only.--grpcmaxsubscriptions (default 100) limits the gRPC subscriptions all clients hold at once, and one client's to a quarter of it without --grpcauthtoken, --grpcmaxfilterentries (default 100,000) the entries one subscription's requests add to its transaction filter, and --grpcmaxconcurrentcalls (default 16) the other gRPC calls in progress, with up to four times as many waiting, as BCHN's HTTP server runs 16 requests and queues 64. A call over a limit gets ResourceExhausted. A client is an IPv4 address or an IPv6 /56, so one with several addresses can hold more; clients at loopback, private or link-local addresses, such as a proxy in front of the server, share only the overall limit.OP_NUM2BIN, and orphan blocks. No block on mainnet, testnet3, testnet4 or chipnet is affected.--excessiveblocksize now defaults to the network's default size, which is also its minimum, and a larger value no longer raises the size and sigchecks limits blocks are validated against, except on regtest and simnet.addrv2, as BCHN does. Tor v2 addresses, which Tor no longer supports, are dropped.dsproof-beta), as BCHN does.--minrelaytxfee, as in BCHN. Free relay and coin-age priority are gone.-dustrelayfee of 1000 satoshis per kB, whatever --minrelaytxfee is, so raising that no longer refuses outputs BCHN relays. After the May 2026 upgrade an output whose script starts with OP_RETURN but isn't a data carrier is never dust, as in BCHN.-mempoolexpiry. A transaction a reorg put back below the minimum fee is never mined, and no longer stays until a restart. A reorg no longer leaves mempool transactions spending a block transaction the mempool refused, and puts back one that was also an orphan.notfound, 60 s without the transaction or the peer leaving moves a transaction request to the next peer that announced it, each peer's tracked announcements are capped at 100,000, and a peer that delivers none of the blocks it was asked for within BCHN's timeout is disconnected, its blocks going to other announcers. A compact block whose missing transactions don't arrive within 30 s, or that arrives while two from its peer are being reconstructed, is fetched in full.getdata for the compact block of a block more than 5 below the tip gets the full block, as in BCHN, and a compact block is built without copying the peer's whole known inventory.--maxpeersperip. Ended bans are dropped every 15 minutes, and node disconnect releases its peer's per-IP slot.sendcmpct flags, and bound UPnP requests to five seconds.OP_CHECKSEQUENCEVERIFY read the transaction version as unsigned, as BCHN does. Only versions that have been invalid since May 2023 are affected.filteradd without a filter is ignored, filterclear is always accepted and turns relay on, and the mempool reply lists the whole pool, parents first, with the peer's fee filter applied.--excessiveblocksize sets, so after a long run of full blocks the node can still receive the largest valid blocks. cfilter messages may hold the filter of any block that limit allows, instead of at most 4 MiB.testmempoolaccept, sendrawtransaction and P2P rejects, for example mandatory-script-verify-flag-failed (Push value size limit exceeded). With --relaynonstd, or on a network that relays nonstandard transactions, a transaction whose version breaks the May 2023 rule gets BCHN's code 64 and bad-txns-version before its scripts run, instead of code 16 and a script error, and is not kept as an orphan.--nobanning is honored, and a block rebuilt from a compact block adds nothing, as in BCHN.error parsing message, and other read errors get none, as from BCHN. A peer's reject is logged at debug level, and one with a reason over the 111 bytes, or a command over the 12 bytes, that BCHN reads is logged as unparseable, where every reject was logged as a warning with its whole reason.getdata for a block relayed early as a compact block waits until the block is processed instead of getting notfound, which BCHN answers by disconnecting, and a block known to be invalid is no longer served. A compact block for a block held as an orphan no longer fetches it again from each relaying peer.tokenData) in transaction outputs, in BCHN's format, and fix CashTokens outputs in createrawtransaction.testmempoolaccept, getblock verbosity 3 (input prevout), the transaction fee at verbosity 2 and 3, finalizeblock and getfinalizedblockhash, as in BCHN. Verbosity 2 still lists the transactions under rawtx, where BCHN uses tx; rpcclient's GetBlockVerboseTx now reads either.sendrawtransaction honours allowhighfees, relays a transaction already in the mempool again, and returns -26 for rejected transactions, as BCHN does.testmempoolaccept gives BCHN's short reject reasons, such as 18: txn-mempool-conflict, with the description in reject-details, and sendrawtransaction's -26 message is in BCHN's form: the reason, the description and the reject code.scripthash with the correct address (gcash/bchutil#47), pay to script outputs as script, and renamed opcodes by their current names. JSON-RPC shows the public key of a P2PK or bare multisig output as the cashaddr of its key hash, as BCHN does.rescan spends on the outputs they spend.ResourceExhausted.-rpcservertimeout for HTTP, or when more than 64 MiB of notifications wait for it. A client that stopped reading used to stall every client's notifications, new websocket connections and shutdown, and loadtxfilter no longer holds them up while it decodes its addresses.getdsproof and gRPC GetDoubleSpendProof search at most 1000 unconfirmed ancestors and list at most the 1000 nearest descendants.SubscribeTransactionStream call that ends on a bad filter no longer leaves a goroutine holding the client's next request.gcash/goslp v1.0.0, a maintained copy of simpleledgerinc/goslp, whose repository was deleted. 32-bit builds now read SLP amounts of 2^31 base units or more correctly.GetUnspentOutput returns an unconfirmed output that holds no tokens instead of failing.getdsproof, getdsprooflist and getdsproofscore as in BCHN, the notifydsproofs websocket command, and the gRPC calls GetDoubleSpendProof, GetDoubleSpendProofs, GetDoubleSpendProofScore and SubscribeDoubleSpendProofs.verifymessage accepts cashaddr addresses. validateaddress keeps the token-aware form and adds istokenaware, scriptPubKey and isscript. createrawtransaction rejects a repeated destination or an amount above 21 million BCH, and accepts legacy addresses. getinfo and getmininginfo report testnet on testnet4 and chipnet. Limited users can stop the notifications they can start.gettxout returns null for an output a mempool transaction spends and for an index past a mempool transaction's outputs, as BCHN does.gettxoutproof without a block hash no longer needs --txindex: it finds the block from an unspent output of the first transaction, in one read of the UTXO database, where BCHN tries each transaction. It checks its txids in linear time. verifytxoutproof returns an empty list for a proof that proves nothing, such as one whose merkle root does not match its header, as BCHN does.GetAddressUnspentOutputs no longer returns an output twice, or both an output and the change of a transaction that spent it while the call ran, misses one created while it runs, or lists a bare multisig output under its first key's address, and GetBlockchainInfo works on chipnet.getrawmempool's startingpriority and currentpriority, and gRPC's starting_priority, are deprecated and always 0. estimatepriority is now an unknown method.createrawtransaction takes BCHN's forms too: outputs as an array, data outputs, outputs with tokenData, the locktime as the third argument and an input's sequence. It keeps the outputs in order, makes version 2 transactions, and refuses what BCHN refuses: null arguments, an input without its vout or its txid in full, a vout that is negative or above 2^31-1, and a sequence out of range. bchctl sends its arguments as given and shows both forms in its usage, and rpcclient gains CreateRawTransactionOrdered and sends cashtokens entries with their documented field names instead of Go's.decodescript gives p2sh_32, getblocktemplate gives each transaction's txid and sigops and the sigoplimit, the sigops fields holding the sigchecks, and validateaddress shows a legacy address as its cashaddr, as BCHN does."id":null, alone or in a batch, as in BCHN, instead of being taken for a notification and dropped. Websocket requests without an id are still notifications.searchrawtransactions, which limited users can call, refuses a count above 10,000 and clamps its skip, where a huge count could exhaust memory or panic. gRPC GetAddressTransactions gives an unconfirmed transaction's fee_per_kb per kB, as documented and as the subscriptions do, where 0.22.2 gave it per byte.--rpcmaxwebsockets slots of their own, and when those are full the one that has waited longest makes room, so they can no longer keep out authenticated clients or those using the authenticate command.getrawmempool builds its result after releasing the mempool lock, and a recovered panic no longer leaves the getblocktemplate long poll or a client's rescan filter locked.getblockchaininfo asks the sync manager for the sync peer's height, where it read the sync peer beside the sync manager, a data race that failed the call when the sync peer changed. Like BCHN's, it now waits while a block is being processed.--txindex. GetAddressUnspentOutputs reads an address's history once and stops when its call ends, as the SLP graph search now does.GetAddressTransactions loads each transaction its results' inputs spend from once per call, and the transaction subscriptions take confirmed transactions' inputs from the block's spend journal once per block: for an address whose transactions spend from one large transaction, a call took 22 s and 18 GB, and now 0.12 s and 130 MB. The address calls and searchrawtransactions read an address's entries and transactions in one database transaction, so a block connected between reading the entries and the transactions no longer fails the call, and GetAddressUnspentOutputs fails with Aborted when the chain reorganizes during the call instead of mixing the two chains' histories.--grpcmaxfilterentries of the outputs it matched, the newest, to match their spends, where it kept every one for the life of the call.-rpcservertimeout; streams whose client sends its messages when it chooses are not affected.GetSlpTrustedValidation counts graph searches without serializing their transactions, once per transaction and valid hashes in a request. An SLP transaction back in the mempool, as when its wallet sends it again after it expired, stays in the SLP cache while there; gRPC could otherwise show it and its outputs as not SLP and refuse SENDs of its tokens.getblocktemplate no longer fails when the mempool holds a transaction that is not final yet, and template size limits follow ABLA. blockmaxsize now defaults to the network's block size limit less 1000 bytes.getblocktemplate transaction's depends now includes parents that come later in canonical order, and each transaction is listed with its own fee and sigchecks rather than another transaction's.submitblock returns BIP22 reasons such as duplicate-invalid or prev-blk-not-found, as BCHN does, and no longer reports a block with an unknown parent, or one that ends up on a side chain, as accepted. Proposals are checked at the next block height.submitblock and block proposals reject trailing data after the block.generate writes the right coinbase height when the tip moves while mining, and only returns blocks that were accepted.--blockminsize filling are gone.peers.json is rejected.--reindexchainstate resumes on the next start instead of leaving an incomplete UTXO set, and it deletes the old UTXO set in batches rather than holding every deletion in memory.rescan retried without end.--reindexchainstate advice, and only a re-index that cannot read the stored blocks says to sync again. Deleting the old UTXO set for a re-index or a fast sync logs its progress.--dropaddrindex, --droptxindex, --dropcfindex or --dropslpindex or when the address index is rebuilt, no longer slows down as it goes, and it can be interrupted between batches; it resumes on the next start that enables the index or gives its drop flag again.--fastsync is refused before it changes the database when the last checkpoint has no UTXO set, as on testnet3, testnet4 and chipnet; it used to empty the UTXO set and mark the database pruned. A start without --fastsync is refused until a downloaded set is verified, and each fast sync start deletes the old set in batches.gcash/goleveldb v1.1.0, a maintained fork of syndtr/goleveldb that brings upstream fixes since 2018 and fixes data loss during crash recovery, hangs after failed writes, and several panics. After a failed disk write it takes no more writes until the node restarts, and a corrupted MANIFEST fails the open instead of silently dropping tables. The on-disk format is unchanged.OP_ACTIVEBYTECODE in a script holding an OP_PUSHDATA1, 2 or 4 push, which a relayed transaction, or a block BCHN accepts, caused on every node.invalidateblock removed the block that first mined its transaction and a block after the reorg mined it again, so the node would accept a block spending the output a second time, which BCHN rejects.--slpindex node for time quadratic in the chain's length.--slpgraphsearch, a graph search through a token whose graph held a chain of about 2.2 million sends, or 0.9 million in 32-bit builds, stopped the node, as the search recursed once per transaction past Go's stack limit; it now keeps a stack of its own.--prometheus, where every handler ran before the --grpcauthtoken check.--profile with a bare port served its unauthenticated pages on every interface, and they show the command line, which can hold the RPC password. It now listens on localhost.gettxoutproof's work. P2P messages are now allocated by the bytes actually received, and the ban list and peer limits apply as soon as a connection is accepted, as in BCHN.golang.org/x/net update brings five HTTP/2 fixes to the gRPC client in bchrpc/proxy.gorilla/websocket v1.5.3 instead of btcsuite/websocket, a 2015 snapshot of it that lacks its later fixes, such as v1.4.1's frame-length check.--excessiveblocksize of about 244 MB or more could be crashed by a peer sending or claiming a message over 1 GiB, and at 512 MB or more any build could send or receive no message at all. The block message limit now stops at 2 GB, ABLA's maximum.--grpcauthtoken is set.linux/riscv64 too, and update dependencies.github.com/traefik/grpc-web v0.18.0, a maintained fork of improbable-eng/grpc-web, whose nhooyr.io/websocket dependency's domain no longer resolves, so bchd's modules can again be fetched without proxy.golang.org (#761).go-grpc-prometheus with an in-tree gRPC metrics interceptor, which exports the same metric names, help strings and labels with --prometheus.bchrpc/pb with protoc-gen-go v1.36.11, protoc-gen-go-grpc v1.6.2 and grpc-gateway v2.29.0, from one bchrpc/regen.sh with the plugins pinned as go.mod tools, so the deprecated github.com/golang/protobuf is no longer a dependency.linux/arm64 and darwin/arm64 too.bchctl, rpcclient and the fast sync download, are dialed with an in-tree client on golang.org/x/net/proxy instead of btcsuite/go-socks, so the dial timeout covers the handshake and a malformed proxy reply returns an error (#757).addrmgr and peer APIs use the new wire.NetAddressV2 type, as btcd did.txscript.GetScriptClass and ExtractPkScriptAddrs recognize P2PK and multisig only in BCHN's forms, so the address index and address filters no longer match outputs written any other way.bchec no longer verifies ECDSA signatures over an empty hash, as Go 1.27's crypto/ecdsa does.txscript.ExtractRedeemScript and CalcScriptInfo return an error for an empty signature script instead of panicking.database.Tx has a new method, FetchBlockSize, which gives a stored block's size without reading the block, also after the block was pruned.bchrpc/pb get code from protoc-gen-go v1.36.11 and protoc-gen-go-grpc v1.6.2, which no longer imports github.com/golang/protobuf and needs grpc-go 1.64 or newer; the streaming types keep their old names as aliases. UnimplementedBchrpcServer now has value methods, so embed it by value: RegisterBchrpcServer panics on a nil embedded pointer. RegisterBchrpcHandlerFromEndpoint connects with grpc.NewClient, which resolves the endpoint with the dns resolver and ignores grpc.WithBlock.blockchain.CheckTransactionVersion is exported. txscript has 19 new error codes named after BCHN's script errors, such as ErrMinimalNumber and ErrNumberRange64Bit, which the engine returns instead of ErrNumberTooBig, ErrNumberTooSmall, ErrIntegerOverflow, ErrMinimalData, ErrInvalidIndex and others where BCHN tells failures apart. NewEngine accepts a pay-to-script-hash input script that is not push only, and Execute refuses it. netsync's PeerNotifier interface gains Misbehaving, which implementations must add, and SyncManager gains QueueCompactBlock. blockchain.Config gains NotifyMaxBlockSizeLookAhead and wire gains SetMaxBlockSizeLookAhead; wire.MaxCFilterDataSize is now the floor of the cfilter limit, which follows the block limit. indexers.ErrAddrHistoryChanged, slpgraphsearch's Db.Count, BlockChain.DisconnectCount and bchrpc.GrpcServerConfig.AuthRequired are new; with AuthRequired false, a program embedding the gRPC server gets the per-client subscription share. indexers.SlpCache.RemoveTokenMetadata takes the confirming MINT's hash, and netsync.SyncManager.SyncHeight is answered by the block handler.--addrindex rebuild the address index on first start. This is very slow: every block is read and indexed again, and the node does not sync or serve RPC or gRPC until it is done. After downgrading to an earlier release with --addrindex and upgrading again, start once with --dropaddrindex, which exits when done, then with --addrindex to rebuild it; this release cannot tell which blocks the earlier one indexed.--dropslpindex, which exits when done, then with --slpindex to rebuild it. On any platform an index can also hold a zero-amount SEND, or after a reorg and a restart a token's metadata, under another token's internal ID, which the same rebuild fixes.--minrelaytxfee, and a node set to 0 refuses to start. The four deprecated options still parse, with a warning, for this release.sendrawtransaction. Fees above 0.1 BCH need allowhighfees or a higher --maxtxfee. Transactions that break a blockchain rule, such as a failed script, now return -26 instead of -25; missing inputs still return -25. The -26 message starts with BCHN's reason instead of TX rejected:.createrawtransaction. The token category is now read in txid byte order, as tokenData reports it. The token amount may be a JSON integer or a string, as in BCHN. Transactions are now version 2, so the same request gives a different txid, and null arguments or an input without vout are refused.1.0 or 1e3 is rejected, as in BCHN, rather than read as 1 or 1000.type or script_class will see scripthash for P2SH32 and script for pay to script outputs. Data carriers over 223 bytes were nonstandard; they are now nulldata in type and datacarrier in script_class. Scripts that do not parse now have a script_class of script or nonstandard instead of an empty one. JSON-RPC shows the public key of a P2PK or multisig output as the cashaddr of its key hash. P2PK and multisig follow BCHN's templates too, so a key pushed with OP_PUSHDATA1 or with a malformed first byte makes the output script or nonstandard, with no addresses.authenticate must send it within --rpcauthtimeout, and a websocket client that takes less than 64 KiB in 30 s while a message waits for it, or falls more than 64 MiB behind on notifications, is disconnected. Inbound connections still in the handshake count toward the peer limits, and --maxpeers keeps --targetoutboundpeers slots for outbound peers, so at the defaults at most 117 inbound peers are accepted.gettxout. With the mempool included, an output a mempool transaction spends is now null, and an index past a mempool transaction's outputs is null instead of error -5.--grpcmaxsubscriptions, --grpcmaxconcurrentcalls or --grpcmaxfilterentries. A gRPC client that takes less than 64 KiB of a reply in 30 s has its call reset, and one whose socket takes nothing for 30 s is disconnected. Address filters now match spends of confirmed outputs without --txindex. GetAddressTransactions gives an unconfirmed transaction's fee_per_kb per kB, 1000 times the per-byte value 0.22.2 gave. A request whose client sends less than 64 KiB of it in 30 s is ended, a server sending more than 512 MiB of replies at once resets those whose clients have taken no 64 KiB part of them in the last 2 s and closes the connection of a client that does not read its socket, and GetAddressUnspentOutputs fails with Aborted when the chain reorganizes during the call; call it again. Without --grpcauthtoken, one client address, or IPv6 /56, may hold at most a quarter of --grpcmaxsubscriptions; a server behind a proxy that connects from a public address sees all its clients as one, so raise --grpcmaxsubscriptions fourfold or connect the proxy from a private address.testmempoolaccept, the -26 message and P2P rejects, with BCHN's reasons.searchrawtransactions. A count above 10,000 is refused with -8, so page through results in steps of at most 10,000.--gcpercent now defaults to 50, where 0.22.2 fixed the garbage collector's target at 10, so garbage collection takes less CPU and bchd uses more memory, most of all during a sync. A node short of memory can set gcpercent=10, as before, or a limit with GOMEMLIMIT.invalidateblock removed the block that first mined its transaction, a block after the reorg mined it again, and a later block spent it before the next UTXO flush. Such an output stays until the UTXO set is rebuilt, so a node whose log shows REORGANIZE lines can start once with --reindexchainstate to rebuild it. A pruned node, or one that ever ran a fast sync, can't re-index; to rebuild its UTXO set, sync it again from an empty data directory.--banthreshold, 100 by default, so one such failure plus any further misbehavior bans the peer for --banduration. Transactions add nothing while the node syncs. Whitelisted and persistent peers are spared, and --nobanning turns bans off."id":null, as in BCHN; they used to be ignored.json.Number and a bool, object or array id as a json.RawMessage.ErrNumberRange32Bit, ErrNumberRange64Bit or ErrNumberRangeBigInt, a number not minimally encoded ErrMinimalNumber, division by zero ErrDivByZero, and an introspection index ErrInvalidTxInputIndex or ErrInvalidTxOutputIndex; the txscript error codes list the other splits. btcjson's TransactionOutputCashToken marshals with lowercase field names and leaves out an empty capability and commitment.--profile. A bare port now listens on 127.0.0.1. Use 0.0.0.0:port or :port to listen on every interface as before.submitblock failures return a BIP22 reason instead of rejected: <error>, and submitblock and block proposals now use BCHN's reason strings, for example bad-cb-amount instead of bad-cb-value and bad-version(0x00000002) instead of bad-version. Templates follow the network's block size limit as ABLA grows it; a larger excessiveblocksize no longer makes them bigger or loosens validation, except on regtest and simnet.invalidateblock on the node's own chain, or start with --maxreorgdepth=-1.peers.json moves to a new format; downgrading discards it and the address list refills from seeds.--miningaddr in a form it now refuses stops the node at startup. validateaddress shows a legacy address as its cashaddr.mismatched spend journal serialization. Start once with --reindexchainstate to rebuild the UTXO set. A pruned node, or one that ever ran a fast sync, can't re-index; to rebuild its UTXO set, sync it again from an empty data directory.--reindexchainstate finish before downgrading. Earlier releases don't resume it: they roll back every block above the point it reached and replay them, the whole chain if it was still deleting the old set.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Rewrite the deprecated io/ioutil usage go-bindata emits, with a make bindata target so it survives regeneration.
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).getblocks with an empty notfound when pruned.ConnReq.Addr.CheckConnectBlockTemplate, which rejected valid CashToken transactions in getblocktemplate.--txindex.estimatefee nblocks parameter optional, matching BCHN and Bitcoin ABC 0.19.1.--fastsync also advertised NODE_CF without maintaining one.decoderawtransaction and sendrawtransaction, which were previously discarded and the transaction relayed.io/ioutil usage go-bindata emits, with a make bindata target so it survives regeneration.google.golang.org/grpc, golang.org/x/crypto, and golang.org/x/net.bchec.ErrInvalidSquareRoot for use with errors.Is.slices.Backward and strings.Builder.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Remove the defunct dnsseed.electroncash.de DNS seed.
dnsseed.electroncash.de DNS seed.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.sync/atomic usage with the typed atomic APIs and adopt WaitGroup.Go.dnsseed.electroncash.de DNS seed.StandardVerifyFlags, so on token-active networks valid CashToken transactions were dropped from the template, producing empty or near-empty blocks.sync/atomic usage with the typed atomic APIs and adopt WaitGroup.Go.Nothing published for this version
Nothing published for this version
Nothing published for this version
This release adds support for the May 15, 2026 Bitcoin Cash network upgrade ("upgrade12"). All node operators must upgrade before activation to stay i
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.
OP_BEGIN / OP_UNTIL)OP_DEFINE / OP_INVOKE)OP_INVERT, OP_LSHIFTNUM, OP_RSHIFTNUM, OP_LSHIFTBIN, OP_RSHIFTBIN| Network | MTP activation |
|---|---|
| Mainnet / testnet3 / testnet4 | 2026-05-15 12:00 UTC |
| Chipnet | 2025-11-15 12:00 UTC (already active) |
| Regtest / simnet | always active |
Full Changelog: v0.21.1...v0.22.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fixed "go get: module source tree too large" issue
node_modules to dramatically reduce the module/package size, resolving "module source tree too large" errors when installing through the Go module proxy.Nothing published for this version
Nothing published for this version
Ensure CashToken data is populated correctly for gRPC endpoints.
sendaddrv2 message from peers, including before verack (#554).txscript.IsUnspendable that diverged from other implementations and posed a fork/UTXO-commitment risk (#475).signrawtransactionwithkey JSON-RPC method (#497).processOrphans.opcodeCheckSig bug where input token data was not passed to the BIP143 signature hash under certain conditions (#552).bchctl in the Dockerfile and update the Kubernetes deployment to handle certificates.meep (#506).Updated seeds to match BCHN and add newly restored BCHD seeds.
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.