Faryar (v1.10.15)

This release resolves a few regressions introduced by the previous release. Most importantly, it fixes an issue that could cause peer-to-peer 'eth' connections to lock up.

Please upgrade ASAP if you are running geth v1.10.12 / .13 / .14.

• A hang in ancient data serving caused by double-locking is fixed. (#24189)
• A crash in the LES server related to reorg handling is resolved. (#24189)
• The SyncProgress method of ethclient.Client works again. (#24199)
• Several inconsistencies in the GraphQL API are also fixed in this release. (#24190, #24188, #24191)

For a full rundown of the changes please consult the Geth 1.10.15 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.

Hourglass Nebula (v1.10.14)

The focus of this release is bug fixes and performance improvements.

We are especially pleased to announce that this release contains a prototype implementation of the PoW to PoS transition (a.k.a. 'The Merge'). As of this version, Geth is compatible with the Kintsugi testnet spec v3.

We would also like to thank Team Ipsilon for their development of the EVM optimizations included in this release. EVM bytecode evaluation is now ~20% faster.

Geth changes

• A regression in txpool limit handling is resolved. This affects the --pricelimit option, which has been reverted to work exactly as it did in geth v1.10.12. (#24080)
• Geth can now handle the transition from PoW to PoS. (#23761)
• In the JavaScript console, long-running JS computation (i.e. for/while loops) can now be interrupted with Ctrl-C. (#23387)
• A corner-case issue in the transaction hash indexer is resolved. (#24024)
• Unclean shutdown markers are now updated regularly and report more accurate geth startup/shutdown times. (#24077)
• In log messages related to RPC method invocations, the key "t" is now called "duration" to prevent a name clash when using the JSON output format. (#24112)

RPC API changes

• The engine APIs (enabled in geth --catalyst mode) are now up-to-date for Kintsugi testnet v3. (#23984, #24067, #24075)
• A panic in the clique_getSigner RPC method is resolved. (#23961)

Go library changes

• The EVM implementation has been cleaned up and interpreter loop performance is improved. (#24120, #24048, #24085, #24026, #24031, #24040, #23970, #23952, #23974, #23977, #23967, #24066)
• In preparation for EIP-3670, the EVM now recognizes the INVALID opcode 0xFE. (#24017)
• Internal opcode names have been modernized to match Solidity: SHA3 is now KECCAK256, SUICIDE is now SELFDESTRUCT. (#23976, #24022, #24016)
• Generating Go/Java bindings for contracts with struct-typed constructor parameters now works correctly. (#23940)
• Built-in EVM trace loggers have moved from core/vm to a dedicated package. (#23892)
• EIP-712 (typed data signing) structs have moved from signer/core to package signer/core/apitypes. (#24029)

Networking

• The eth protocol implementation now uses request IDs (added by eth/66) internally. (#23576)
• Hashing of eth response data now uses multiple threads, improving sync performance. (#24032)
• The now-unused 2GB fast sync bloom filter has been removed. (#24047)
• Serving ancient headers to other peers has been optimized. (#23105)
• The discv4 test suite is more robust and logs received packets better. (#23966)
• There are now fuzz tests for the snap protocol message handler. (#23957)

For a full rundown of the changes please consult the Geth 1.10.14 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.

Far Rim (v1.10.13)

Geth v1.10.13 is a scheduled maintenance release. It introduces a few polishes, though nothing major. Fixes wise, it does address a few thorns that affect a small portion of our users.

New features:

• Retrospectively enforce account nonces to be less than 2^64-1 (#23853).
• Configurable genesis gas limit in dev mode via dev.gaslimit (#23686).
• Sanitize history config fields in the GPO when using toml (#23886).
• Add support for custom freezer paths in db inspect (#23946).
• Create evm b11r to build and seal blocks from json (#23843).
• Extend evm t8n to support signing unprotected txs (#23937).
• Polish evm t8n to have more meaningful CLI flags (#23934).
• Implement the 4byte tracer natively in Go (#23882, #23916).
• Use faster freezer scanning when reiniting leveldb (#23612).
• Expose the gasUsed field in the evm command (#23919).
• Improve error messages in the freezer (#23901).

New fixes:

• Fix price filtering in tx pool to prevent low price legacy transaction from spamming the pool (#23855).
• Fix log retrievals for users with very old archive nodes having legacy database formats (#23879).
• Fix a snap sync issue where a malicious response could crash the syncing node (#23960).
• Fix a data race in the simulated backed's gas price suggestion (#23898).
• Fix receiptsRoot field name in the evm command output (#23924).
• Fix setHead when pointing it back to the genesis (#23949).
• Fix transaction sender recovery in ethclient (#23877).
• Fix DNS discovery entry TTLs on Clouflare (#23885).
• Fix intrinsicGas output in the t9n tool (#23889).

For a full rundown of the changes please consult the Geth 1.10.13 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.

Vallhallan Threshold (v1.10.12)

Geth v1.10.12 is a scheduled maintenance release, but also contains some significant features!

The release enables the Arrow Glacier hard-fork, scheduled approximately for the 8th of December. The sole change is to postpone the difficulty-bomb until summer 2022, by which time hopefully The Merge will have happened.

The release also ships support for a new PoW testnet called Sepolia. This testnet was dreamed up during the merge interop in Athens and it's purpose is to replace Ropsten after the merge as the main cross client testnet. You can access it via geth --sepolia. Being a PoW testnet, it's possible to mine it for Ether to use as test funds.

Lastly, the release also contains a brand new call tracer implemented in Go, which should be significantly (2.5x) faster than the one currently used. You can use the new tracer via debug.traceTransaction("0xhash", {tracer: "callTracer"}). The original JavaScript tracer is still available for fallback purposes called callTracerLegacy. The latter will be dropped if nobody reports issues with the native one.

Improvements:

• Implement the Arrow Glacier hard fork and schedule (#23810).
• Bake in support for the Sepolia PoW test network (#23730).
• Switch the call tracer to a fast native Go implementation (#23867, #23708).
• Optimize nonce handling performance in the txpool (#22231).
• Support password protected SSH key files in puppeth (#22148).
• Optimize request/response matching in RPC batch queries (#23856).
• Support transferring snapshots via geth db export snapshot (#22931).
• Read chain data atomically from ancients/leveldb, avoiding an extra read (#23566).
• Improve the hexutil package's big-int encoding performance by 50% (#23780)
• Remove the xgo cross compiler as docker auto-build limits killed it (#23800).
• Support invalid RLP blobs (at least fail gracefully) in the state t8n tool (#23771).

Bug-fixes:

• Fix a crash in LES serving code (#23865).
• Fix a data race in the miner's receipt copying code (#23835).
• Fix a missing snapshot error after recovering from a crash (#23496).
• Fix a memory leak in Clique if the network temporarilly halts (#23861).
• Fix a crash if the disk gets full during ethash DAG generation (#23799).
• Fix chain tracing to not go OOM during long running sessions (#23736).
• Fix the simulated backend to allow running EIP-1559 transactions (#23838, #23840).
• Fix an RPC crash when getting the signer of an empty Clique chain (#23832).
• Fix the total difficulty number of nil-diff genesis blocks in the database (#23793).
• Fix a crash in abigen generated code if backend header retrieval fails (#23781).

For a full rundown of the changes please consult the Geth 1.10.12 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.

Xathorron (v1.10.11)

Geth v1.10.11 is another bug fix release, fixing an issue with sender not being recovered on pending transactions, and fixing a data corruption issue.

Changes in this release

• For pending transactions returned by RPC, the sender address is again reported correctly. This was broken in the previous release. (#23765)
• The rlpdump command can now turn structured text into RLP. (#23745)
• A database corruption issue caused by the snapshot system is resolved. (#23635)
• The evm tool's t9n mode performs even stricter transaction validation. (#23743)
• You can now use line editing at the puppeth prompt. (#23718)
• The geth db subcommands now accept (non-hex) string keys. (#23744)

For a full rundown of the changes please consult the Geth 1.10.11 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.

Sytau (v1.10.10)

Geth v1.10.10 is another bug fix release.

Geth changes

• Geth is much less likely to crash during shutdown, especially when mining is active. (#23435, #21992, #22853)
• The new --rpc.evmtimeout flag allows setting the internal timeout for eth_call. The default timeout is still 5s. (#23645)
• The geth console supports some ECMAScript 6 features like arrow functions, typed arrays and let bindings (#23721)
• The console no longer crashes when trying to complete on properties with value 'null' or 'undefined'. (#23701)
• The evm debugging/testing tool now validates transaction gas limits in 't9n' mode. (#23694)

RPC API changes

• A regression in the JS-based call tracer is resolved. (#23667)
• The new debug_getAccessibleState RPC method finds a block number at which full state is available. (#23646)
• The new debug_getHeaderRlp RPC method fetches RLP-encoded headers from the database. (#23670, #23677)
• The sender address is once again returned correctly for very old Frontier-era transactions. (#23683)

Go library changes

• For contract calls using accounts/abi/bind, a regression that could lead to incorrect gas estimation is fixed. (#23719)
• Package accounts/abi now has basic support for Solidity error types. (#23161)
• Miner stress test tools work again (they were broken in the previous release) (#23699)
• The transaction recipient address stored in types.Transaction is now truly independent of the address pointer passed to the constructor. (#23376)
• The Receipt type now implements encoding.BinaryMarshaler, like Transaction (#22806)
• TxPool.Pending no longer returns an error (#23720)

Build

• As a workaround for tracing issues on Alpine Linux, we now set the C stack size to 8MB for release builds. (#23676)
• Go module vendoring issues related to github.com/karalable/usb are finally resolved. (#23684)
• This release is built with Go 1.17.2. (#23698)

For a full rundown of the changes please consult the Geth 1.10.10 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.

Attican Beta (v1.10.9)

Geth v1.10.9 is a maintenance release containing mostly bug fixes.

Chain tracing has received quite a bit of attention during this release cycle. JS-based tracing now supports additional callbacks for entry and exit of contract calls, improving performance if processing individual opcodes is not needed.

Geth command changes

• The 'evm' command has a new subcommand for testing tx decoding. (#23494)
• 'evm t8n' now calculates and returns block difficulty. (#23353, #23507)
• Legacy flags --rpc, --rpcaddr, --rpcport, etc. are no longer supported. (#23358)
• Legacy debugging flags --pprofport, --pprofaddr, etc. are also no longer supported. (#23368)
• When initializing Clique-based private networks, zero-length extradata in genesis.json now prints an error message instead of crashing. (#23538)

Go library changes

• Contract bindings created by accounts/abi/bind now validate log event signatures. This prevents accidentally decoding events with the wrong signature. (#23230)
• A crash in accounts/abi when decoding struct-typed Solidity return values is resolved. (#23573)
• Writes to the ancient database are now batched internally for improved performance. (#23462)
• Multiple data races in transaction pool code are fixed. (#23474)
• Comprehensive benchmarks for RLP encoding/decoding of consensus types have been added. (#23190)
• RLP encoding of slices and arrays is slightly faster. (#23467)
• rpc.BlockNumber now implements encoding.TextMarshaler. (#23324)
• The Account type has been moved from package core/state to core/types. (#23567)
• For crypto/cloudflare/bn256 EC curve, in-place addition and unmarshalling now works correctly. (#23419)
• A very rare crash in the background 'bloombits' indexer is resolved. (#23437)

RPC/GraphQL changes

• JS tracing of EVM execution now provides additional callbacks for call entry/exit. Using these callbacks instead of 'step' can yield a 10-100x tracing speedup if you don't need to process every VM opcode. (#23087)
• The '4byte' built-in tracer now uses enter/exit. (#23622)
• A state database corruption bug caused by tracer re-execution of old blocks is resolved. (#23632)
• The new debug_intermediateRoots method computes per-transaction state roots of a block. (#23594)
• EVM memory and return data are no longer captured by default when tracing. (#23558)
• EVM execution is now aborted on the server side when tracing is interrupted. (#23580)
• Broken WebSocket connections are now detected better and their subscriptions report an error instead of hanging indefinitely. (#23556)
• personal_sendTransaction now supports both "input" and "data" arguments, just like eth_sendTransaction. (#23476)
• Log filtering performance is improved. (#23147)
• Transaction access lists returned by GraphQL are now correct. (#23650)
• The debug_stacks method now supports an optional filter expression. (#23605)
• For clique blocks returned by RPC, the "miner" field once again contains the actual block coinbase field instead of the derived block signer. This fixes a regression where clients would no longer be able to verify the block seal signature. (#23466)

Networking

• The eth/65 peer-to-peer protocol is no longer supported. Geth only supports eth/66 as of this release. (#23456)
• The cross-client eth protocol tests suite better distinguishes eth/65 and eth/66. (#23568)
• ENR sequence numbers are now initialized as a timestamp. This prevents issues when the p2p nodes database is dropped/re-created while keeping the nodekey the same. (#19903)
• Several data races are resolved in packages p2p and p2p/enode. (#23434)
• Note: to simplify the ongoing rewrite of eth/downloader, the package has been duplicated temporarily. The additional copy will be removed later. (#23561)

Build

• This release is built with Go 1.17. (#23464, #23465, #23468)
• 32 bit builds of Geth should be fully functional again. (#23543, #23542)
• We no longer publish .deb packages for Ubuntu 20.10 Gorilla because this version is not supported by Launchpad anymore. (#23470)
• The 'node' package no longer depends on wallet backends. Specifically, this removes the dependencies on libusb for contract bindings and other uses of the go-ethereum library. If you are using package node, you must now register required account manager backends individually. (#23019)
• The 'metrics' package, and many packages that depend on it can now be compiled for WebAssembly. (#23449)
• EVM performance tests no longer run on CI. (#23304)

For a full rundown of the changes please consult the Geth 1.10.9 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.

Hades Gamma (v1.10.8)

Geth v1.10.8 is a pre-announced hotfix release to patch a vulnerability in the EVM (CVE-2021-39137).

The exact attack vector will be provided at a later date to give node operators and dependent downstream projects time to update their nodes and software. All Geth versions supporting the London hard fork are vulnerable (the bug is older than London), so all users should update.

Credits for the discovery go to @guidovranken (working for Sentnl during an audit of the Telos EVM) and reported via bounty@ethereum.org.

Beside the fix, we're merged in a few tiny polishes and fixes. For a rundown, please consult the Geth 1.10.8 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.

Styx Theta (v1.10.7)

Geth v1.10.7 is a maintenance release, mostly focusing on a few post-London polishes.

A few important notes to keep in mind:

• The return type for oldestBlock in eth_feeHistory was changed from decimal to hex. This is to conform to the updated spec that was released after Geth's London hard-fork release was already made. The input blockCount parameter was also updated, but there Geth will accept both hex and decimal to keep backward compatibility.
• The -miner.gastarget CLI flag was deprecated and is a noop. This flag is already a noop for networks running the London hard-fork, since it London miners only take into account the -miner.gaslimit flag. For non-London private networks and Geth forks, this might result in a gas bump depending on how the miners are configured.
• Docker builds were changed from DockerHub Automated Builds to offsite builds and manual pushes to DockerHub. At the same time, we've added support for multi-arch images, the original tags being the metadata image, linking a -amd64 and a -arm64 tags together. No changes are needed for docker users, but keep us posted if something strange happens. On the upside, Geth now has official arm64 docker images too.

Changes made:

• Change the oldestBlock return type in eth_feeHistory to hex, accept both decimal and hex as the block count (#23239, #23363).
• Cap max usable gas in eth_estimateGas better for 1559 transactions (#23309).
• When deploying multiple contracts via abigen, only parse the ABI once (#22583).
• Return maxFeePerGas for the gasPrice of pending transactions (#23345).
• Check cached blocks too when attempting to retrieve a header (#23299).
• Reject transactions imitated from non EOA accounts (#23303).
• Reduce allocations a bit while CPU mining ethash (#23199).
• Deprecate the -miner.gastarget CLI flag (#23213).
• Switch over to manual docker pushes (#23373).

Bugs fixed:

• Fix a nil pointer panic for certain abigen generated code due to missing context initialization (#23188).
• Fix nil pointer panic in certain automatic access list generation RPC API calls (#23225).
• Fix a regression that prevented clef from signing a legacy transaction (#23274).
• Fix a permission error during snapshot based pruning on Windows (#23370).
• Fix the marshaling of errors from the tracers (#23292).

For a full rundown of the changes please consult the Geth 1.10.7 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.

Terra Nova (v1.10.6)

Geth v1.10.6 is a hotfix release. This resolves a consensus failure on the Ropsten testnet.

Users of Geth on the Ethereum mainnet must upgrade to this release before the London hard-fork activates to remain in consensus. Reminder: the London hard fork is scheduled to occur at block #12965000 on mainnet (~ August 4th, 2021).

More information about the Ropsten incident

During testing of the London hardfork on Ropsten, a consensus failure occurred in block 10679538, leading to a network split between OpenEthereum/Besu and Geth/Nethermind. The block contained a transaction from an account with enough funds to cover the effective fee, but too little funds for the transaction's maximum gas price. EIP-1559 mandates that such transactions should be rejected. Geth's implementation of EIP-1559 did not perform the check correctly and accepted the transaction.

For more information see PR #23244 and the post-mortem writeup.

Other changes in this release

• Compatibility with old receipt formats stored in the database is restored. This fixes a regression introduced in Geth v1.10.4 for people with very old chain databases. (#23247)
• A regression for eth_sendTransaction in light client mode is fixed. (#23215)
• The Go API function Node.Close() has been fixed to stop the WebSocket server correctly (#23211)

For a full rundown of the changes please consult the Geth 1.10.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.