RELEASE NOTES

MetaInfo

Mandatory Update Required: No
Target Audience: developers and testnet operators, this is a preview release and is not intended for production
Procedure: simply binary replacement should be good
Schedule(Timeline): no scheduled upgrade timeline

Changelog

v1.8.0-alpha is a preview release for upstream code sync, it catches up with go-ethereum release [v1.17.3] and also removes several BSC features and fixes bugs.

Feature Removal

• core/vm: revert opcode-level optimization and fold EVMInterpreter into EVM
  The EVM opcode-level optimization (superinstruction) feature added in #3395 is removed entirely: the superinstruction interpreter, the fused opcodes and their jump-table entries are gone, and EVMInterpreter is folded back into EVM.
• core, triedb, ethdb: remove incremental snapshot (incr db) feature
  The incr downloader and merger, the incr freezers and the pathdb incr manager are all deleted.
• core/txpool, eth: remove local transaction reannounce mechanism
  Local pending transactions are no longer periodically re-announced.
• p2p: remove BSC table-layer ENR node filtering and dead bootnode bucket-size code
  The discovery table no longer filters nodes by ENR.

Code Sync

• upstream: merge geth-v1.16.9 ~ geth-v1.17.3
  Key changes from the code sync include:
• Wire protocol: eth/70 becomes the primary protocol. BSC keeps eth/68 for peer compatibility, retains TD in StatusPacket, and sends no UpgradeStatusMsg on eth/70. snap/2 groundwork landed, but only snap/1 is advertised.
• State: Verkle is replaced by the unified binary trie (UBT), with state readers split into MPT/UBT databases.
• PathDB: path-based archive with proofs, history index pruner, trienode history on existing nodes.
• EIP-7928 block access list scaffolding replaces BEP-592.
• The Amsterdam EIP set landed but stays dormant on BSC: EIP-7778, EIP-7843, EIP-8024, EIP-7708, EIP-7954, EIP-7976/7981, EIP-8037, EIP-7610.

RPC Changes

• Breaking debug_trace* structLog output follows the client-wide spec: memory words are 0x-prefixed and padded to 32 bytes, storage keys and values are 0x-prefixed, and error is omitted when empty.
• Breaking reexec is no longer accepted in the tracing config.
• eth_getLogs / eth_getFilterLogs: --rpc.rangelimit (default 5000) replaces the fixed cap toggled by --rangelimit, and exceeding it returns -32602 invalid params.
• eth_simulateV1: every call result gains a maxUsedGas field.
• New method eth_getStorageValues, which reads up to 1024 storage slots in one call.

Config Changes

• Default --cache is raised from 1024 to 4096 MB, so nodes that do not set it explicitly will use about 3GB more memory.
• Renamed: --rangelimit to --rpc.rangelimit, --override.verkle to --override.ubt.
• New: --history.trienode (serve historical state proofs, disabled by default), --miner.maxblobs, --debug.logslowblock, and the opt-in --rpc.telemetry family.
• Removed: the seven --incr.* flags plus the inspect-incr-snapshot and merge-incr-snapshot subcommands, --txpool.reannouncetime, and bootnode -network.
• Accepted but inert, warning only: --enable-bal, --rangelimit, --vm.opcode.optimize.
• config.toml: [Eth] EnableOpcodeOptimizing, [Eth.TxPool] ReannounceTime and [Node.P2P] EnableENRFilter are no longer supported.

BUGFIX

• core, eth, consensus, miner, tests: stabilize the v1.17.3 merge
• internal/ethapi, eth/filters: fix eth_simulateV1 multi-block and getLogs latest range-limit regressions
• miner, core/vm: fix MEV bid gas accounting and EVM stack-arena double-release
• core/txpool: fall back to an empty state when head state is unavailable
• eth/downloader: fix legacy snap sync regressions from the v1.17.3 merge
• miner, core: fix mining prefetch rate-limiting broken by shadowing
• miner: make MEV bid per-builder quota admission atomic
• consensus/parlia: only blind-sign legacy system txs

Others

• core/filtermaps: update BSC mainnet and chapel log index checkpoints
• cmd/faucet: add United Stables ($U) testnet token

Assets

MetaInfo

Mandatory Update Required: No
Target Audience: all BSC Mainnet/Testnet users
Procedure: simply binary replacement should be good
Schedule(Timeline): no scheduled upgrade timeline

Changelog

v1.7.8 is a maintenance release.

Assets

MetaInfo

Mandatory Update Required: Yes
Target Audience: all BSC Mainnet users
Procedure: before upgrading, review the deprecated flags and config fields listed above and confirm their removal has no impact on your node; once confirmed, binary replacement is sufficient:

--journalfile: no longer has any effect, safe to remove
--miner.txgaslimit: per-transaction gas limit is now enforced by EIP-7825; confirm EIP-7825 behaviour meets your requirements before removing
--enablebal: no longer has any effect, safe to remove
--multidatabase: single-database mode is now the only option; confirm your data directory is compatible
--txpool.overflowpoolslots: overflow pool is removed; review your txpool capacity settings if you relied on it
[Eth] EnableBAL in config.toml: must be removed before upgrading — will cause a startup error if left in
[TxPool] OverflowPoolSlots in config.toml: silently ignored, but recommend removing to keep config clean
Schedule(Timeline): TBD

Changelog

v1.7.7 is for BSC Mainnet Pasteur hardfork,the hard fork time is 2026-08-25 02:30:00 AM UTC

Assets

MetaInfo

Mandatory Update Required: Yes
Target Audience: all BSC Testnet users
Procedure: before upgrading, review the deprecated flags and config fields listed above and confirm their removal has no impact on your node; once confirmed, binary replacement is sufficient:

• --journalfile: no longer has any effect, safe to remove
• --miner.txgaslimit: per-transaction gas limit is now enforced by EIP-7825; confirm EIP-7825 behaviour meets your requirements before removing
• --enablebal: no longer has any effect, safe to remove
• --multidatabase: single-database mode is now the only option; confirm your data directory is compatible
• --txpool.overflowpoolslots: overflow pool is removed; review your txpool capacity settings if you relied on it
• [Eth] EnableBAL in config.toml: must be removed before upgrading — will cause a startup error if left in
• [TxPool] OverflowPoolSlots in config.toml: silently ignored, but recommend removing to keep config clean
  Schedule(Timeline): TBD

Changelog

v1.7.6 is for BSC Chapel testnet Pasteur hardfork,the hard fork time is 2026-07-21 02:30:00 AM UTC

Pasteur Hardfork

• #3623 core/vm: reject duplicate bridge validators at Pasteur
• #3691 miner: support builder-proposed block with validator blind signing
• #3717 params: move Pasteur next to Mendel
• #3721 core/systemcontracts: introduce Pasteur hardfork system-contract upgrade
• #3727 core/systemcontracts: point Pasteur CommitUrl to genesis-contract v1.2.6
• #3741 miner: disable BidBlock on hard-fork activation blocks
• #3742 miner: optimize BidBlock signing hash

BUGFIX

• #3668 eth/handler.go: add verify bal
• #3671 eth/protocols/bsc: cap GetBlocksByRange response size
• #3672 eth/protocols/bsc: rate-limit incoming votes by vote count
• #3680 internal/ethapi: limit number of getProofs keys
• #3681 internal/ethapi: limit number of calls to eth_simulateV1
• #3682 internal/ethapi: fix gas cap for eth_simulateV1
• #3683 core: fix txLookupLock mutex leak on error returns in reorg()
• #3684 cmd, core, eth, tests: prevent state flushing in RPC
• #3685 core/tracing: fix nonce revert edge case
• #3686 eth/filters: fix race in pending tx and new heads subscriptions
• #3687 core, internal/ethapi: fix incorrect max-initcode RPC error mapping
• #3688 eth/filters: rangeLogs should error on invalid block range
• #3689 eth/filters: fix race in NewVotes and NewFinalizedHeaders
• #3692 eth/filters: fix source leak when New Filters
• #3700 crypto: add hash length check in nocgo VerifySignature
• #3701 p2p/discover: copy buffer before sending read errors to unhandled
• #3702 p2p/discover: fix timeout loop early exit when removing expired matchers
• #3703 eth/tracers/logger: fix exclude address list
• #3705 eth/protocols/eth: stop serving on unavailable responses
• #3706 triedb/pathdb: fix lookup sentinel collision with zero disk layer root
• #3707 eth/tracers: forward OnSystemCall hooks through mux
• #3708 eth/downloader: drop invalid peers + fix deliver index
• #3709 core/state: fix StateDB Reader error discarded after Commit
• #3710 p2p/discover: decouple nodeFeed from Table mutex in waitForNodes
• #3711 core/rawdb: fix file descriptor leak in freezer error paths
• #3712 core/rawdb: fsync temp file before rename in copyFrom
• #3718 fix: nocgo sigToPub hash check + pathdb zero-base regression test

IMPROVEMENT

• #3669 miner: reduce local mining time for last block in one turn
• #3694 consensus/parlia: extract VerifyUnsealedHeader from verifyHeader
• #3736 miner: add BidBlock verify metrics

CLEAN UP

• #3670 triedb/pathdb: remove legacy field JournalFilePath
• #3678 miner: remove optional transaction gas limit cap
• #3690 all: remove BEP-592 non-consensus block access list
• #3716 ethdb,trie: remove multidb code from bsc
• #3720 core/rawdb: cleanup bep-592 bal key related
• #3722 core/txpool/legacypool: remove overflowpool for txs
• #3728 beacon, cmd: remove fake-beacon op-stack shim (revert #2678)
• #3739 core/types: extract bid and block mev info into builder subpackage

Deprecated Flags & Config Fields

The following flags and config fields are removed or deprecated in this release. Please update your node configuration accordingly before upgrading:

CLI Flags

Config File (TOML) Fields

Assets

MetaInfo

Mandatory Update Required: No
Target Audience: all BSC Mainnet/Testnet users
Procedure: simply binary replacement should be good
Schedule(Timeline): no scheduled upgrade timeline

Changelog

v1.7.5 is a maintenance release.

Assets

MetaInfo

Mandatory Update Required: No
Target Audience: all BSC Mainnet/Testnet users
Procedure: simply binary replacement should be good
Schedule(Timeline): no scheduled upgrade timeline

Changelog

v1.7.4 is a maintenance release.

Assets

MetaInfo

Mandatory Update Required: NO — recommended to fix the database size growth issue
Target Audience: All BSC Mainnet and Testnet users
Procedure: Binary replacement is sufficient from v1.7.x
Schedule(Timeline): No scheduled rollout

Changelog

v1.7.3 is a maintenance release, which mainly fixes online block pruning and kvdb abnormal continuous growth, pls refer change log for detail.

BUGFIX

• #3653 core/rawdb: fix freeze header-number shadowing for block prune
• #3633 core/rawdb: increase SlowFreezerBatchLimit from 100 to 200, fixing kvdb abnormal continuous growth
• #3631 core/vote: fix deadlock in votepool when stop client
• #3627 core/vm: fix super-instruction LT comparison after swap1
• #3652 consensus/parlia: fix big.Int pointer comparison in isIntentionalDelayMining

FEATURE

• #3624 cmd/utils: disabled transaction unindexing for archive node by default; when running in archive mode, the --history.transactions flag is now respected to specify transaction history range instead of being forced to index all history
• #3634 eth/ethconfig: set default value to 576000 for history.logs

IMPROVEMENT

• #3626 eth: tune timing parameters and broadcast queue for 450ms block
• #3618 #3629 miner: async blob tx validation during bid simulation with worker pool
• #3650 miner: shrink greedy merge buffer
• #3645 core: use now for DA check instead of chasingHead.time
• #3622 core/vm: continue after super-instruction fallback

Others

• #3639 go.mod: use go1.25.0 and update otel
• #3637 build(deps): bump go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp from 1.34.0 to 1.43.0
• #3617 build(deps): bump github.com/mattn/go-colorable from 0.1.13 to 0.1.14
• #3616 build(deps): bump github.com/gorilla/mux from 1.8.0 to 1.8.1
• #3648 Revert ".github: change dependabot target branch to develop"

Assets

MetaInfo

Mandatory Update Required: YES
Target Audience: all BSC Mainnet users
Procedure: simply binary replacement should be good (ensure no 'JournalFileEnabled' field in config file)
Schedule(Timeline): before 2026-04-28 02:30:00 AM UTC

Changelog

v1.7.2 is for BSC Mainnet Osaka/Mendel hardfork,the hard fork time is 2026-04-28 02:30:00 AM UTC

BUGFIX

• #3597 miner: support blob sidecar validation for bids
• #3590 eth: delayed p2p message decoding
• #3601 core: reject future chasing heads for DA checks

Assets

MetaInfo

Mandatory Update Required: YES
Target Audience: all Chapel testnet users
Procedure: simply binary replacement should be good (ensure no 'JournalFileEnabled' field in config file)
Schedule(Timeline): before 2026-03-24 02:30:00 AM UTC

Changelog

v1.7.1 is for BSC Chapel testnet Osaka/Mendel hardfork,the hard fork time is 2026-03-24 02:30:00 AM UTC

FEATURE

• feat: support bid block size check for BEP-655
• feat: support mev bid gas check of bep 652
• eip4844.go: disable eip-7918 for bsc
• feat: implement BEP-657 - Limit Blob Transaction Inclusion by Block Number

BUGFIX

• core/types: fix typo in vote comparison (#3573)
• Fee history issue
• go.mod: upgrade otel to fix CVE-2026-24051
• fix: fix gaslimit check in trace api (#3580)
• miner: fix missing tcount increment in commitBlobTransaction (#3581)
• fix: superinstruction bad block (#3582)
• core/vm: align super-instruction minStack and maxStack bounds (#3584)
• rlp: finalize listIterator on parse error to prevent non-advancing loops (#3586)
• eth/protocols/snap: restore peers to idle pool on request revert (#3587)

Assets

MetaInfo

Mandatory Update Required: NO
Target Audience: all users
Procedure: simply binary replacement should be good from v1.6.x
Schedule(Timeline): no scheduled upgrade timeline, but we recommend upgrading.

Description

This release ports critical security fixes from go-ethereum v1.16.9, resolving two P2P vulnerabilities.

Changelog

BUGFIX

crypto/secp256k1: fix coordinate check
crypto/ecies: fix ECIES invalid-curve handling

Assets