Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/building-on-etherlink/endpoint-support.md
Original file line number Diff line number Diff line change
Expand Up @@ -480,7 +480,7 @@ For examples of using these ethers.js methods, see [Using ethers.js](/building-o
<tbody>
<tr>
<td>EVM version</td>
<td><code>Prague</code></td>
<td><code>Osaka</code></td>
</tr>
<tr>
<td>Whitelisting Fireblocks IP addresses</td>
Expand Down
16 changes: 10 additions & 6 deletions docs/get-started/network-information.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ or subscribe to a commercial [RPC provider](/tools/node-providers) plan which of
</tr>
<tr>
<td>EVM version</td>
<td><code>Prague</code></td>
<td><code>Osaka</code></td>
</tr>
<tr>
<td>RPC Endpoint</td>
Expand Down Expand Up @@ -123,7 +123,7 @@ However, this test work will be decommissioned soon and the Etherlink Shadownet
</tr>
<tr>
<td>EVM version</td>
<td><code>Prague</code></td>
<td><code>Osaka</code></td>
</tr>
<tr>
<td>RPC Endpoint</td>
Expand Down Expand Up @@ -203,7 +203,7 @@ This a new network that will become the primary test network for Etherlink, so u
</tr>
<tr>
<td>EVM version</td>
<td><code>Prague</code></td>
<td><code>Osaka</code></td>
</tr>
<tr>
<td>RPC Endpoint</td>
Expand Down Expand Up @@ -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)
Expand All @@ -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:

<table class="customTableContainer">
Expand Down Expand Up @@ -444,5 +442,11 @@ Etherlink also includes these [Ethereum precompiled contracts](https://www.evm.c
<td><InlineCopy code="0x0000000000000000000000000000000000000011" href="https://testnet.explorer.etherlink.com/address/0x0000000000000000000000000000000000000011" abbreviate="5,4"></InlineCopy></td>
<td><InlineCopy code="0x0000000000000000000000000000000000000011" href="https://shadownet.explorer.etherlink.com/address/0x0000000000000000000000000000000000000011" abbreviate="5,4"></InlineCopy></td>
</tr>
<tr>
<td>`secp256r1`</td>
<td><InlineCopy code="0x0000000000000000000000000000000000000100" href="https://explorer.etherlink.com/address/0x0000000000000000000000000000000000000100" abbreviate="5,4"></InlineCopy></td>
<td><InlineCopy code="0x0000000000000000000000000000000000000100" href="https://testnet.explorer.etherlink.com/address/0x0000000000000000000000000000000000000100" abbreviate="5,4"></InlineCopy></td>
<td><InlineCopy code="0x0000000000000000000000000000000000000100" href="https://shadownet.explorer.etherlink.com/address/0x0000000000000000000000000000000000000100" abbreviate="5,4"></InlineCopy></td>
</tr>
</tbody>
</table>
9 changes: 2 additions & 7 deletions docs/network/evm-nodes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down Expand Up @@ -71,7 +70,7 @@ If you don't want to see all of the options and settings for the EVM node, you c
</TabItem>
<TabItem value="shadownet" label="Etherlink Shadownet Testnet">

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 \
Expand Down Expand Up @@ -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.

Expand Down
2 changes: 1 addition & 1 deletion docs/network/fees.md
Original file line number Diff line number Diff line change
Expand Up @@ -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_.

Expand Down
25 changes: 25 additions & 0 deletions docs/progress/upgrades.md
Original file line number Diff line number Diff line change
Expand Up @@ -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).