diff --git a/docs/building-on-etherlink/endpoint-support.md b/docs/building-on-etherlink/endpoint-support.md index 22bf88fc..ed5ba60e 100644 --- a/docs/building-on-etherlink/endpoint-support.md +++ b/docs/building-on-etherlink/endpoint-support.md @@ -480,7 +480,7 @@ For examples of using these ethers.js methods, see [Using ethers.js](/building-o EVM version - Prague + Osaka Whitelisting Fireblocks IP addresses diff --git a/docs/get-started/network-information.mdx b/docs/get-started/network-information.mdx index 0d899597..a9d3ce3a 100644 --- a/docs/get-started/network-information.mdx +++ b/docs/get-started/network-information.mdx @@ -37,7 +37,7 @@ or subscribe to a commercial [RPC provider](/tools/node-providers) plan which of EVM version - Prague + Osaka RPC Endpoint @@ -123,7 +123,7 @@ However, this test work will be decommissioned soon and the Etherlink Shadownet EVM version - Prague + Osaka RPC Endpoint @@ -203,7 +203,7 @@ This a new network that will become the primary test network for Etherlink, so u EVM version - Prague + Osaka RPC Endpoint @@ -269,7 +269,7 @@ This a new network that will become the primary test network for Etherlink, so u Feature | Details | --- | --- | Genesis date | 2nd May 2024 (Mainnet), 15th November 2023 (Ghostnet Testnet), 28th August 2025 (Shadownet Testnet) -EVM-compatible | Yes, up to version Prague +EVM-compatible | Yes, up to version Osaka Block speed | Variable; see [Architecture](/network/architecture) Docker image | https://hub.docker.com/r/tezos/tezos-bare images that start with `octez-evm-node` Debugging | Supported via standard [Ethereum endpoints](/building-on-etherlink/endpoint-support) @@ -295,8 +295,6 @@ Therefore, you cannot compute Etherlink block hashes with tools such as Geth. ## Precompiled contracts -The precompiled contracts on Etherlink are listed in the [`mod.rs`](https://gitlab.com/tezos/tezos/-/blob/master/etherlink/kernel_latest/evm_execution/src/precompiles/mod.rs#L181) file. - These precompiled contracts are specific to Etherlink: @@ -444,5 +442,11 @@ Etherlink also includes these [Ethereum precompiled contracts](https://www.evm.c + + + + + +
`secp256r1`
diff --git a/docs/network/evm-nodes.mdx b/docs/network/evm-nodes.mdx index e389eb36..ea5f4016 100644 --- a/docs/network/evm-nodes.mdx +++ b/docs/network/evm-nodes.mdx @@ -32,8 +32,7 @@ If you don't want to see all of the options and settings for the EVM node, you c 1. Download the latest release of the `octez-evm-node` binary from https://gitlab.com/tezos/tezos/-/releases. :::note - As of August 1st 2025, Etherlink Mainnet and Ghostnet Testnet require at least version 0.35 of the `octez-evm-node` binary. - Etherlink Shadownet Testnet requires at least version 0.44 of the `octez-evm-node` binary. + As of version 6.0, Etherlink requires at least version 0.48 of the `octez-evm-node` binary. ::: 1. Run the `octez-evm-node run observer` command to start the node as an observer: @@ -71,7 +70,7 @@ If you don't want to see all of the options and settings for the EVM node, you c - With version 0.44 of the EVM node or later, use this command for Etherlink Shadownet Testnet: + Use this command for Etherlink Shadownet Testnet: ```bash octez-evm-node run observer \ @@ -110,10 +109,6 @@ To switch modes, see [Switching history modes](#switching-history-modes). The easiest way to get the `octez-evm-node` binary is to download the binaries distributed as part of its latest release from https://gitlab.com/tezos/tezos/-/releases. The release page provides static binaries for Linux systems (for amd64 and arm64 architectures). -:::note -As of August 1st 2025, Etherlink Mainnet and Etherlink Ghostnet or Shadownet Testnet require at least version 0.35 of the `octez-evm-node` binary. -::: - As an alternative, you can use the minimal Docker image [tezos/tezos-bare](https://hub.docker.com/r/tezos/tezos-bare/tags?name=octez-evm-node) with a tag that includes `octez-evm-node`. These images contain the correct version of the binary. Docker examples below use `tezos/tezos-bare:octez-evm-node-latest` which will always be the most recent release. diff --git a/docs/network/fees.md b/docs/network/fees.md index 6820b472..bcc21806 100644 --- a/docs/network/fees.md +++ b/docs/network/fees.md @@ -34,7 +34,7 @@ Etherlink measures throughput in terms of the amount of execution gas (that is, As demand increases and more execution gas is used in a shorter time, Etherlink increases the gas price to increase the execution fee. Etherlink has a target amount of execution gas to use per second, referred to as the _speed limit_ or _target_. -The speed limit is currently set to 7 million gas per second. +The speed limit is currently set to 13.5 million gas units per second, exactly half of Etherlink's capacity of 27 million gas units per second. To calculate the throughput, Etherlink records the total execution gas used and subtracts the speed limit every second. The remaining execution gas amount is known as the _backlog_. diff --git a/docs/progress/upgrades.md b/docs/progress/upgrades.md index a9f04b38..348f5c35 100644 --- a/docs/progress/upgrades.md +++ b/docs/progress/upgrades.md @@ -89,6 +89,31 @@ For more information, see [Execution fee](/network/fees#execution-fee). For more information, see [Announcing Ebisu: A 5th Upgrade proposal for Etherlink Mainnet](https://medium.com/@etherlink/announcing-ebisu-a-5th-upgrade-proposal-for-etherlink-mainnet-4dfdd1c8819e). +## Etherlink 6.0 (Farfadet) + +:::note + +Etherlink 6.0 requires version 0.48 or later of the `octez-evm-node` binary. + +::: + +The Etherlink 6.0 upgrade includes: + +- Support for EVM Osaka, including support for the count leading zeroes (CLZ) opcode (EIP-7939), the ecp256r1 Curve Support precompile (EIP-7951), and the increase in ModExp gas cost (EIP-7883) + +- The ability to provide instant confirmations, which allow users to know (within roughly 50ms) that their transactions will be in the next block and receive receipts with information about the completed transaction. +This update puts the functionality for instant confirmations in the kernel, but they are not available to users until the EVM node enables the functionality. + +- The speed limit (also known as the target) is increased to 13.5 million gas units per second. +The speed limit decides when the gas price raises. +For more information, see [Execution fee](/network/fees#execution-fee). + +- A breaking change to the `QueuedDeposit` event that the FA bridge emits. +This event is now emitted by the FA bridging precompiled contract (`0xff0...0002`) and the first topic of the event is changed to match its ABI signature. +For more information about bridging events, see [How bridging FA tokens works](/bridging/bridging-fa-how). + +For more information, see [Announcing Farfadet: A 6th Upgrade Proposal for Etherlink Mainnet](https://medium.com/@etherlink/announcing-farfadet-a-6th-upgrade-proposal-for-etherlink-mainnet-6bc59793962d). + ## Changelog For full details about changes to Etherlink, see [Changelogs](/progress/changelogs).