RELEASE NOTES

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

MetaInfo

• Mandatory Update Required: NO
• Target Audience: alpha release, no target audience
• Procedure: simply binary replacement should be good
• Schedule(Timeline): alpha release, no scheduled upgrade timeline

Description

v1.7.0-alpha is a preview release for upstream code sync, it catches up with go-ethereum release [v1.16.7] and also include several bug fix and improvements.

Changelog

Code Sync

• upstream: merge geth-v1.16.2 ～ geth-v1.16.7
  Key changes from the code sync include:
  • Osaka:
    • Implement EIP-7823 - Set upper bounds for MODEXP
    • Implement EIP-7825 - Transaction Gas Limit Cap.
    • Implement EIP-7883 - ModExp Gas Cost Increase.
    • Implement EIP-7918 - Blob base fee bounded by execution cost.
    • Implement EIP-7934 - RLP Execution Block Size Limit.
    • Implement EIP-7939 - CLZ opcode.
    • Implement EIP-7951 - Precompile for secp256r1 Curve Support.
  • eth_sendRawTransactionSync: Synchronous transaction submission
  • Performance Optimizations: Multiple improvements to enhance overall performance
  • Code Refactoring: Major cleanup and improvements to components including:
    • TriePrefetcher prefetch trie nodes in a account in parallel.
    • Introduced a file-based state journal and refactored state history writes

FEATURE

• internal/ethapi: recover GetDiffAccounts and GetDiffAccountsWithScope
• BEP648: Enhanced Fast Finality via InMemory Voting Pool

IMPROVEMENT

• miner: enable more prefetch threads in local mining mode
• miner/minerconfig: get defaultNoInterruptLeftOver automatically

BUGFIX

• core/state: fix handleDestruction for fast node (#3501,#3517,#3519)
• fix: add back Contract CodeAddr for superinstruction
• fix: fix pruned node init filtermap err

Others

• ci: upgrade github actions to latest versions
• ci: ignore nancy failre of quic-go@v0.49.1

Assets

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

While not an emergency patch, we highly recommend all node operators upgrade to ensure long-term network stability and security.

Upgrade Instructions

From v1.6.x: A simple binary replacement is sufficient.
From v1.5.x: Please refer to the v1.6.5 Release Announcement for specific migration steps.

Changelog

BUGFIX

core/txpool: drop peers on invalid KZG proofs
crypto/ecies: use aes blocksize

Assets

v1.6.5 is a maintenance release that introduces an optional gas limit cap for transactions.

Changelog

FEATURE

#3488 miner: optional transaction gas limit cap

IMPROVEMENT

#3483 feat: remove the handshake from the bsc protocol
#3486 feat: update filtermaps checkpoints

Notice regarding upgrade from v1.5.x to v1.6.5

Snapshot Regeneration

The upgrade will trigger snapshot regeneration. Please expect reduced node performance until this process finishes. On our reference hardware (8-core AMD EPYC 7R13, 32GB RAM, SSD), regeneration took approximately 5 hours.

Log Indexing

v1.6.x introduces a new log indexing mechanism. For v1.6.5, the index is constructed starting from block 71,126,721. This operation consumes significant CPU resources, and the node may appear unresponsive during startup. If you do not need the full index, add the flag --history.logs 576000 to limit indexing to the last 3 days, or disable it entirely using --history.logs.disable.

Assets