Releases: ethereum/go-ethereum
Archanes (v1.13.4)
Geth v1.13.4 is a non-urgent hotfix release. The previous version of Geth (v1.13.3) introduced a warning log for bad transaction announcements, and on mainnet it generated too much logging noise due to a protocol violation in Erigon. To prevent overwhelming logging systems, Geth v1.13.4 lower the log to a more reasonable level until the bug in Erigon is fixed #28356.
Apart from the above reason, the release contains:
- Fix a snap sync corner-case that could cause a hang by a maliciously constructed contract storage (#28306).
- Update various dependencies to unstick versions of Go libs (#28329, #28333, #28334, #28332, #28336).
- Enable Pebble database support on 32bit platforms and on OpenBSD too (#28335).
- Fix returning the correct code hash for eth_getProof with empty storage (#28357).
- Simplify trie range prover for some upcoming snap sync optimisations (#28311).
- Fix a timeout mechanism in the transaction fetcher (#28220).
For a full rundown of the changes please consult the Geth 1.13.4 release milestone.
As with all our previous releases, you can find the:
- Pre-built binaries for all platforms on our downloads page.
- Docker images published under
ethereum/client-go
. - Ubuntu packages in our Launchpad PPA repository.
- OSX packages in our Homebrew Tap repository.
Armeni (v1.13.3)
Geth v1.13.3 is a scheduled maintenance release with various small additions and an important Pebble database fix.
- Update Pebble to fix an occasional IO and CPU runaway, adding some debugging capabilities too (#28224, #28070).
- Support full syncing to a specific hash without a beacon client via a
--synctarget
(#28209). - Allow configuring websocket message limits via the Go RPC client (#27801).
- Drop support for
eth/66
(Cancun will requireeth/68
anyway) (#28239). - Lower
snap
missingeth
protocol warning to debug level (#28249). - Enforce transaction metadata announcements in
eth/68
(#28261).
Features related to the Cancun hardfork:
- Implement the
BLOBFEE
opcode for the upcoming Cancun hard fork (#28098). - Enable blob transaction propagation and mining in Cancun networks (#28243).
- Start throttling transaction retrievals to prepare for blobs in Cancun (#28304).
For a full rundown of the changes please consult the Geth 1.13.3 release milestone.
As with all our previous releases, you can find the:
- Pre-built binaries for all platforms on our downloads page.
- Docker images published under
ethereum/client-go
. - Ubuntu packages in our Launchpad PPA repository.
- OSX packages in our Homebrew Tap repository.
Phaistos (v1.13.2)
Geth v1.13.2 is a bugfix release for the 1.13 family as well as contains the Holesky testnet relaunch.
Note, if you have previously ran Geth with the old Holesky testnet configs, the new version will probably fail to start with a genesis hash mismatch error. You will need to manually delete your holesky/chaindata
folder and restart. Geth did not implement special code for cleaning up the failed launch of the testnet.
- Fix various pathdb corruption corner-cases during snap sync node restart (#28171, #28163).
- Reconfigure the Holesky testnet with an updated genesis (#28191, #28192, #28193).
- Remove the rollback mechanism from snap sync, unneeded post-merge (#28147).
- Make the
block
parameter ineth_call
optional, defaulting tolatest
(#28165). - Forget transactions previously marked underpriced after 5 minutes (#28097).
- Fix JSON marshalling issue from
ethclient
retrieving block receipts (#28087). - Fix
--bootnodes
flag if the list is also configured in the toml file (#28095).
For a full rundown of the changes please consult the Geth 1.13.2 release milestone.
As with all our previous releases, you can find the:
- Pre-built binaries for all platforms on our downloads page.
- Docker images published under
ethereum/client-go
. - Ubuntu packages in our Launchpad PPA repository.
- OSX packages in our Homebrew Tap repository.
Zakros (v1.13.1)
Geth v1.13.1 is a hotfix release for v1.13.0.
It fixes the following issues:
- Fix the active fork detection on the engine API, causing the signer to create invalid blocks (#28135).
- Fix a db corruption in
path
scheme caused by a weirdly restarted snap sync (#28124, #28126). - Fix
geth db inspect
command running against oldhash
scheme databases (#28108). - Fix an effective gas price calculation regression on the RPC APIs (#28130).
Apart from the fixes, v1.13.1 introduces support for configuring Geth via environmental variables (#28103, #28119)!
For a full rundown of the changes please consult the Geth 1.13.1 release milestone.
As with all our previous releases, you can find the:
- Pre-built binaries for all platforms on our downloads page.
- Docker images published under
ethereum/client-go
. - Ubuntu packages in our Launchpad PPA repository.
- OSX packages in our Homebrew Tap repository.
Therum (v1.13.0)
Geth v1.13.0 is a major milestone in the lifetime of Geth, bits and bobs being in development for around 6 years now. Since a release note cannot do it justice, please see our Geth v1.13.0 release blog post.
Still, just to quickly recap, Geth v1.13.0 finally ships a new database model which supports proper, full pruning of historical states; meaning you will never need to take your node offline again to resync or to manually prune. The new database model is optional for now (you need to enable it via --state.scheme=path
) and does require resyncing the state, since we need to store it completely different (you can keep your ancients, no need to resync the chain too).
The path database will become the default eventually, but for safety reasons, we're keeping it opt-in for the moment. The old database model is not going away soon, though long term - unless there's something fundamentally wrong with the path db - it will. As for archive node users, we're working on a new model there too, but it does need a bit more work on top, so that's for another release.
The all important disclaimer: Geth's new path-based storage is considered stable and production ready, but was obviously not battle tested yet outside of the team. Everyone is welcome to use it, but if you have significant risks if your node crashes or goes out of consensus, you might want to wait a bit to see if anyone with a lower risk profile hits any issues.
Apart from the pruning work, the release contains:
- Built in support for the Holešky (Holešovice) testnet (#28007).
- Index transactions even if no blocks are received (#27847).
- Expose Geth version metadata into the metrics (#24877).
- Optimise
eth_estimateGas
to do fewer runs (#27710). - Add
eth_getBlockReceipts
RPC API call (#27702). - Support unpacking Solidity panic events (#27868).
- Reject GraphQL block queries where both number and hash is specified (#27876).
- Increase batch limits for RPC calls on the authenticated endpoint (#27924).
- Optimise logging library to avoid expensive call stack lookups (#28069).
And bugfixes:
- Fix forkid computation for genesis-merged non-zero timestamp networks (#27895, #28034).
- Fix a potential data race in the websocket ping/pong mechanism (#27733).
- Fix js tracers to return the gas price in base 16, not base 10 (#27903).
- Fix finalized block number in dev (
--dev
) mode (#27886).
For a full rundown of the changes please consult the Geth 1.13.0 release milestone, though do note that the state scheme changes and pruner have been gradually merged over the past year so are not explicitly tagged in this milestone.
As with all our previous releases, you can find the:
- Pre-built binaries for all platforms on our downloads page.
- Docker images published under
ethereum/client-go
. - Ubuntu packages in our Launchpad PPA repository.
- OSX packages in our Homebrew Tap repository.
Mawinor (v1.12.2)
Hot on the heels of v1.12.1 comes our next release, fixing some regressions reported by the community.
Here are the changes:
- A crash related to leveldb metrics is resolved (#27904)
- Metrics names used by the blobpool have been changed to be compatible with Prometheus (#27901)
- The c-kzg-4844 and blst libraries have been updated, hopefully fixing some build issues (#27890, #27907, #27910)
- We have also adapted go-ethereum to the latest changes in the 'slices' package provided by the golang.org/x/exp module. The Go authors decided to push an incompatible update, but didn't create a new release of that module, causing build issues when consumers mix-and-match dependency versions. (#27909)
For a full rundown of the changes please consult the Geth 1.12.2 release milestone.
As with all our previous releases, you can find the:
- Pre-built binaries for all platforms on our downloads page.
- Docker images published under
ethereum/client-go
. - Ubuntu packages in our Launchpad PPA repository.
- OSX packages in our Homebrew Tap repository.
Antibaar (v1.12.1)
Geth v1.12.1 is a maintenance release, albeit a rather large one, since we haven't put out a version since May.
This release is a recommended upgrade for all users and contains security-related fixes.
Here's the list of changes:
Cancun fork
Development for the upcoming Cancun hard fork has been a focus in this release cycle. Do note however, that Geth v1.12.1 is not yet ready for Cancun.
- For EIP-4844 'Shard Blob Transactions', this release contains basic type definitions and state transition logic (#27356, #27382, #27392, #27393, #27470, #27721, #27736, #27743, #27767, #27789, #27791, #27793, #27796, #27797, #27825, #27874)
- We have also implemented an entirely new mempool -- the blobpool -- for EIP-4844 transactions. The new pool is backed by an on-disk database and has an overall simpler design than the txpool we use for regular transactions. The blobpool is not yet used by p2p networking and is still being tested in the Cancun devnets. (#26940, #27429, #27463, #27481, #27790, #27822)
- EIP-6780: 'SELFDESTRUCT only in same transaction' (#27189)
- EIP-5656: 'MCOPY instruction' (#26181)
- EIP-1153: 'Transient storage opcodes' was already implemented and is enabled for Cancun (#27663, #27613)
Geth command changes
- The Rinkeby testnet is no longer supported in Geth (#27406)
geth --dev
now simulates a PoS-based chain (#27327)evm blocktest
can now output structured logs (#27396)- Geth will now configure GOMAXPROCS based on CPU quota settings. This should improve efficiency when running in Docker containers with a CPU core limit applied. (#27506, #27814)
- An IPv6 listening address for can now be configured for HTTP/WS (#27628) (#27635)
RPC/GraphQL API changes
- JSON transactions now have a
yParity
fields, as mandated by the RPC API spec (#27744, #27882) - Legacy transactions now have a
chainID
field in RPC responses, like all other transaction types (#27452) - Block headers returned by RPC no longer report a non-standard
size
field (#27347) eth_estimateGas
now supports state overrides likeeth_call
(#27845)eth_estimateGas
now handles internal chain reorgs more correctly (#27505)eth_getProof
is slight more efficient, and will now return a response in the canonical encoding even for off-spec input parameters (#27309, #27310)eth_getTransactionReceipt
now returnsnull
when the transaction is not available. It used return an error in that case. (#27712)debug_storageRangeAt
now takes a block hash or number as parameter (#27328)- The new
debug_getTrieFlushInterval
method reports the internal state saving interval (#27303) - A crash in the prestate tracer is resolved (#27691)
- Structured EVM logs returned by tracing now contain the
returnData
(#27704) - GraphQL now supports withdrawals (EIP-4895) (#27072)
Go library changes
- The RPC server now enforces limits on batch requests and responses. This is a potentially breaking change.
If you use batch requests with geth, and also use the go-ethereum RPC client library, we strongly recommend updating your go-ethereum library dependency as well. The new client version handles invalid batch responses way better than before. (#26681) - The RPC client has multiple new ways to test whether the transport supports real time subscriptions (#25942)
- fsync is now enabled for pebble database writes (#27615, #27522)
- Function calls timed by metrics will now run even if metrics are disabled (#27724, #27723)
Node.Attach
no longer returns an error. This is a breaking Go API change. (#27450)- The keystore has improved verification of keys loaded from disk (#27432)
- Per-level metrics are now available for LevelDB (#27643)
Core
- All block creation activity is now paused while the node is syncing (#27218)
- Two minor bugs in the transaction pool are resolved in this release (#27404, #27479)
- Geth no longer uses a 'clean cache file' to persist internal caches across restarts. While persistent cache added a small performance boost right after startup, it could cause obscure issues in certain restart scenarios. (#27525)
- A large portion of the new Path-Based State Storage scheme has been implemented. While it isn't active yet, we are planning to make this new storage method available in the next release. (#25963, #27323, #27349, #27428, #27687, #27753, #27815)
- As part of testing the new storage scheme, some inconsistencies in selfdestruct handling were discovered by fuzz tests and had to be fixed (#27376, #27339)
- We have also made significant progress on the integration of Verkle Trees, which required changes to internal state-handling APIs (#27000, #27209, #27464, #27476, #27544, #27853)
Networking
- A serious memory leak related to database writes in snap sync is fixed in this release (#27842)
- Large transactions (> 4kB) are no longer broadcasted to peers. This resolves a potential network congestion issue (#27618)
- The p2p networking layer has learned to announce alternate ports returned by UPnP/NAT-PMP (#26359)
- The p2p server now properly tracks all peer goroutines (#27887)
- Networking initialization now really disables all discovery when
--nodiscover
is used (#27518) - Obsolete parts of the LES protocol implementation, which is currently non-functional, have been removed (#27737)
- Discovery bootstrap nodes will now be filtered by the netrestrict setting, like all other nodes (#27701)
- We now provide additional metrics around p2p dialing, making it poss...
Krogam DMZ (v1.12.0)
Geth v1.12.0 is a potentially breaking change, hence it was deemed to deserve version bump, to 1.12
.
The v1.12 release family drops support for proof-of-work, and thus can not be used any more on PoW-based private chains, or as an upstream library for projects depending on ethash
PoW (#27178, #27147).
In our GraphQL API, a breaking change is that all numeric values are now encoded as hex strings (#26894). The internal GraphQL UI was updated to version 2.0. (#27294).
Regarding our move from leveldb
to pebble
, Geth now defaults to use Pebble as a backend if no existing database is found (#27136). If a previous LevelDB database exists Geth will keep using that, and if you must have LevelDB for some compatibility reasons, you can force it in Geth with the --db.engine=leveldb
flag.
We have made progress on "EIP-4844: Shard Blob Transactions" (#27257, #27256, #27155, #27049), beacon light sync (#27292), and path-based state storage (#27176, #26813) but neither is finished as of yet.
Other improvements:
Assorted bugfixes:
- Do not ignore
null
address while iterative dump (#27320) - Fix flatCallTracer crasher (#27304)
- Prevent pebble shutdown-panic (#27238)
- Make websocket use default "HTTP_PROXY" by default (#27264)
- Make
eth_estimateGas
uselatest
block by default (#24363) - Add
txHash
field on txTraceResult (#27183) - Fix crash on querying finalized block (#27162)
For a full rundown of the changes please consult the Geth 1.12.0 release milestone.
As with all our previous releases, you can find the:
- Pre-built binaries for all platforms on our downloads page.
- Docker images published under
ethereum/client-go
. - Ubuntu packages in our Launchpad PPA repository.
- OSX packages in our Homebrew Tap repository.
Azimir (v1.11.6)
Geth v1.11.6 is a maintenance release, fixing some minor issues and adding some log management features.
Log management
Log rotation has landed in geth
, via (#26843). Log rotation can be activated using the flag --log.rotate
. Additional parameters that can be given are:
--log.maxsize
to set maximum size before files are rotated,--log.maxbackups
to set how many files are retailed,--log.maxage
to configure max age of rotated files,--log.compress
whether to compress rotated files
The location the logfile(s) can be configured as previously, using the --log.logfile
parameter.
A new log output format, logfmt
was added (#27001, #26970). It can be enabled using --log.format
, which currently supports the options json
, logfmt
or terminal
. (Thus, the --log.json
option is now deprecated).
And finally, the flag --vmodule
was renamed to --log.vmodule
(#27071).
Assorted
- New sepolia bootnodes managed by EF devops are added (#27099)
- Converting the codebase to use
atomic
types (#27068, #27031, #27030, #27013,#27014, #27011, #26992, #26993, #26951, #26935, #27121) - Bugfixes to make tracers more correct avoid crashes (#27029, #26848)
- Fix race-conditions in
graphql
(#26965) - New CPU counter-typed metrics (#26796)
For a full rundown of the changes please consult the Geth 1.11.6 release milestone.
As with all our previous releases, you can find the:
- Pre-built binaries for all platforms on our downloads page.
- Docker images published under
ethereum/client-go
. - Ubuntu packages in our Launchpad PPA repository.
- OSX packages in our Homebrew Tap repository.
Erszbat (v1.11.5)
Geth v1.11.5 enables the Shanghai upgrade on Wednesday, April 12, 2023 10:27:35 PM UTC
The Shanghai upgrade contains the following EIPs:
- EIP-3651: Warm COINBASE
- EIP-3855: PUSH0 instruction
- EIP-3860: Limit and meter initcode
- EIP-4895: Beacon chain push withdrawals as operations
- EIP-6049: Deprecate SELFDESTRUCT
Notable changes:
Minor changes and bugfixes
- Preparatory changes for path-based storage (#26763)
- Changes needed use overlay protocols in discv5 (#26699)
- Add support for encoding uint256.Int in RLP (#26898)
- Fixed a bug where local transaction would be rejected with
-32000, future transaction tries to replace pending
when send out of order (#26930) - Reject keywords
safe
orpending
over RPC pre merge (#26862 - Fix file permissions on
admin_exportChain
(#26912)
For a full rundown of the changes please consult the Geth 1.11.5 release milestone.
As with all our previous releases, you can find the:
- Pre-built binaries for all platforms on our downloads page.
- Docker images published under
ethereum/client-go
. - Ubuntu packages in our Launchpad PPA repository.
- OSX packages in our Homebrew Tap repository.