Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
45 commits
Select commit Hold shift + click to select a range
50925f5
import sidebar
NicNomadic Aug 3, 2026
80e01c6
import section Overview
NicNomadic Aug 3, 2026
cd85b24
import section Michelson
NicNomadic Aug 3, 2026
104d033
create section EVM
NicNomadic Aug 3, 2026
d06b80b
import section Examples
NicNomadic Aug 3, 2026
9adbaa3
fixup root index
NicNomadic Aug 3, 2026
92ea3bb
update moved pages
NicNomadic Aug 3, 2026
e730c9c
fixes to build right
NicNomadic Aug 3, 2026
0429643
fix some doclib tests
NicNomadic Aug 3, 2026
4d54044
refine projected network info
NicNomadic Aug 4, 2026
11da74c
with each other
NicNomadic Aug 4, 2026
9754805
short interface names
NicNomadic Aug 4, 2026
e9d6124
within the boundaries
NicNomadic Aug 4, 2026
cbd792a
put fast-fair-free at the top
NicNomadic Aug 4, 2026
cd63e56
minimize changes to the landing page
NicNomadic Aug 4, 2026
aa7eae2
Remove Learn more section in Get started
NicNomadic Aug 4, 2026
b9048cd
explain how to ask Michelson RPCs
NicNomadic Aug 4, 2026
0fddbf5
add redirections for moved sections
NicNomadic Aug 5, 2026
d973eb1
fix path of chatbot page in chatbot box
NicNomadic Aug 5, 2026
a8f5d04
de-collapse Overview section when starting
NicNomadic Aug 5, 2026
b30ba3e
refactor 3 pages on fees into 2 pagess
NicNomadic Aug 5, 2026
f69cbe4
more specific titles for EVM & Michelson Overview pages
NicNomadic Aug 5, 2026
0738b90
fix glossary
NicNomadic Aug 5, 2026
7537659
fix sidebar icons
NicNomadic Aug 5, 2026
06d70c4
fix "a Etherlink" to "an Etherlink"
NicNomadic Aug 5, 2026
a5f7526
fix modexp precompile for Shadownet
NicNomadic Aug 6, 2026
ceaaa47
fix formula for kt1_alias
NicNomadic Aug 6, 2026
a405391
fix gas constants
NicNomadic Aug 6, 2026
2facd25
fix formula for inclusion fees
NicNomadic Aug 6, 2026
205c42a
block gas limit -> tx gas limit
NicNomadic Aug 6, 2026
2f3242e
delegation is not supported
NicNomadic Aug 6, 2026
abbe502
link to Tezos X roadmap
NicNomadic Aug 6, 2026
281bd71
better summarize atomicity
NicNomadic Aug 6, 2026
22c6d40
EVM nodes could be called Etherlink nodes
NicNomadic Aug 6, 2026
b06e16e
remove demo testnet from Previewnet page
NicNomadic Aug 6, 2026
c86cc4a
more concrete about callMichelson & callMichelsonView
NicNomadic Aug 6, 2026
5398001
replace Michelson/EVM interface
NicNomadic Aug 6, 2026
3517441
fix getting-started.md
NicNomadic Aug 6, 2026
63f99ab
Michelson network-information.md is WIP
NicNomadic Aug 6, 2026
6fc500a
michelson/bridging.md is WIP
NicNomadic Aug 6, 2026
d28a4c9
expand RPC diffs from L1
NicNomadic Aug 6, 2026
c3e55e1
dipatch Read more/Get started
NicNomadic Aug 6, 2026
bd71ba2
reorder overview pages
NicNomadic Aug 6, 2026
763e221
comment out for now "ETH7 = TX milestone"
NicNomadic Aug 6, 2026
4479ab3
remove phrase on "economical perspective"
NicNomadic Aug 6, 2026
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
16 changes: 9 additions & 7 deletions docs/conrefs/cementing-delay.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,20 @@
:::note
<h3>Bridging time</h3>
Tokens that you bridge from Tezos layer 1 to Etherlink are available for use on Etherlink immediately.

By default, tokens that you bridge from Etherlink to Tezos layer 1 are available for use on Tezos in 15 days.
You can bridge XTZ tokens within 1 minute for an additional fee with [fast withdrawals](/bridging/bridging-tezos#fast-withdrawals).
### Bridging time

Tokens that you bridge from Tezos layer 1 to Etherlink<!--TX--> are available for use on Etherlink<!--TX--> immediately.

By default, tokens that you bridge from Etherlink<!--TX--> to Tezos layer 1 are available for use on Tezos in 15 days.
You can bridge XTZ tokens within 1 minute for an additional fee with [fast withdrawals](/evm/bridging/bridging-tezos#fast-withdrawals).

This delay is caused by the Smart Rollup refutation period.
As with all Smart Rollups, Etherlink nodes post commitments about their state to Tezos layer 1, including incoming bridging transactions, on a regular schedule.
As with all Smart Rollups, EVM nodes<!--TXN--> post commitments about their state to Tezos layer 1, including incoming bridging transactions, on a regular schedule.
Other nodes have the length of the refutation period (14 days) to challenge those commitments.
At the end of the refutation period, the correct commitment is cemented, or made final and unchangeable.

After the commitment with the withdrawal transaction is cemented, any user can execute the transaction to make the bridged tokens available on Tezos layer 1.

<h3>Delay variations</h3>
### Delay variations

This delay can vary if a Tezos layer 1 protocol upgrade changes the block times during a commitment's refutation period.

Expand All @@ -29,4 +31,4 @@ The maximum change is the new block time divided by the old block time multiplie
For example, if the new block time is 8 seconds and the old block time is 10 seconds, the maximum addition to a commitment's refutation period is 10 / 8, or 1.25 times the standard 14-day period.
Commitments that are close to being cemented when the block time changes have the largest change to their refutation periods, while commitments that are made close to when the block time changes have a very small change.

:::
:::
2 changes: 1 addition & 1 deletion docs/conrefs/gas-price-warning.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,4 +15,4 @@ Most wallets periodically check the status of submitted transactions via the `et

If the gas price drops, the sequencer may eventually accept the transaction, but the better solution is to use the wallet's "speed up" function (available in most popular supported wallets), and increase the maximum base gas fee.

:::
:::
6 changes: 3 additions & 3 deletions docs/conrefs/rate-limit.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
:::note

The following examples use the public Etherlink RPC endpoints listed in [Network information](/get-started/network-information), which are rate-limited.
If you need to make requests in a production environment, run your own EVM node as described in [Running an Etherlink EVM node](/network/evm-nodes) and send the requests to it.
The following examples use the public Etherlink<!--TX--> RPC endpoints listed in [Network information](/evm/get-started/network-information), which are rate-limited.
If you need to make requests in a production environment, run your own EVM node as described in [Running an EVM node<!--TXN-->](/network/evm-nodes) and send the requests to it.

:::
:::
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: Bridging tokens between Etherlink and other EVM networks
title: Bridging tokens between Etherlink EVM and other EVM networks # tevm
sidebar_label: Bridging to EVM networks
---

Expand All @@ -8,9 +8,9 @@ import Video from '@site/src/components/Video';
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

[The Etherlink EVM bridge](https://bridge.etherlink.com/evm) is a web application that allows you to transfer wrapped tokens between Etherlink and several other EVM-compatible blockchain networks.
[The Etherlink EVM{/* TEVM */} bridge](https://bridge.etherlink.com/evm) is a web application that allows you to transfer wrapped tokens between Etherlink EVM{/* TEVM */} and several other EVM-compatible blockchain networks.

The EVM bridge supports connections from Etherlink to these networks:
The EVM bridge supports connections from Etherlink EVM{/* TEVM */} to these networks:

- Ethereum
- Avalanche C-Chain
Expand All @@ -29,29 +29,27 @@ It allows users to transfer several wrapped tokens, including:
- WBNB
- SHIB

For the Etherlink addresses of these tokens, see [Token addresses](#token-addresses).
For the Etherlink EVM{/* TEVM */} addresses of these tokens, see [Token addresses](#token-addresses).

Etherlink's LayerZero bridge infrastructure also supports a number of tokens that meet their [Omnichain Fungible Token (OFT)](https://docs.layerzero.network/v2/developers/evm/oft/quickstart) standard.
The token addresses for OFTs that can be transferred between Etherlink and other networks (including WXTZ) can be retrieved from the [LayerZero API](https://docs.layerzero.network/v2/tools/api/oft), or are listed [here](#token-addresses).
Etherlink EVM{/* TEVM */}'s LayerZero bridge infrastructure also supports a number of tokens that meet their [Omnichain Fungible Token (OFT)](https://docs.layerzero.network/v2/developers/evm/oft/quickstart) standard.
The token addresses for OFTs that can be transferred between Etherlink EVM{/* TEVM */} and other networks (including WXTZ) can be retrieved from the [LayerZero API](https://docs.layerzero.network/v2/tools/api/oft), or are listed [here](#token-addresses).

## Bridge security

The bridge uses the decentralized smart contracts of [LayerZero](https://layerzero.network/) that are deployed on the supported EVM networks without the intervention of a third party.
It also relies on the Etherlink node and sequencer operators that secure Etherlink itself; these operators are listed in [Network operators](/network/operators).
It also relies on the EVM node{/* TXN */} and sequencer operators that secure Etherlink{/* TX */} itself; these operators are listed in [Network operators](/network/operators).

## Using the EVM bridge

For a video walkthrough of the bridge, see this video:

<Video src="https://www.loom.com/embed/6a1bb548a5c7439fafdb328b4785adca?sid=bfeed550-9191-4fea-b274-453ff1f1caf9"/>
For a video walkthrough of the bridge, see [this video](https://www.loom.com/share/6a1bb548a5c7439fafdb328b4785adca).

![Overview of the EVM bridge](/img/wab-details.png)

1. Go to the Etherlink EVM bridge at https://bridge.etherlink.com/evm.
1. Go to the Etherlink EVM{/* TEVM */} bridge at https://bridge.etherlink.com/evm.

1. Click the **Connect** button and connect your EVM wallet.

1. Select the source network from which to bridge tokens to Etherlink, or select Etherlink as the source network to bridge tokens out of Etherlink.
1. Select the source network from which to bridge tokens to Etherlink EVM{/* TEVM */}, or select Etherlink EVM{/* TEVM */} as the source network to bridge tokens out of Etherlink EVM{/* TEVM */}.

1. Next to the source network, click the source token and select the token to transfer from the source network.
The interface shows all bridgeable tokens across all available networks and your token balances.
Expand All @@ -66,18 +64,22 @@ The interface shows all bridgeable tokens across all available networks and your

1. Set the other parameters for the transfer, including the **Gas on destination** and **Slippage tolerance** fields.

:::note Gas on destination
Interacting with Etherlink requires XTZ (its native token) to pay for gas fees.
As part of your bridging transaction, you can choose to send up to 0.1 XTZ to your Etherlink wallet address to pay for fees for later transactions and interact with the Etherlink ecosystem.
:::note[Gas on destination]
Interacting with Etherlink EVM{/* TEVM */} requires XTZ (its native token) to pay for gas fees.
As part of your bridging transaction, you can choose to send up to 0.1 XTZ to your Etherlink EVM{/* TEVM */} wallet address to pay for fees for later transactions and interact with the Etherlink EVM{/* TEVM */} ecosystem.
The cost of this XTZ is added to the fees that you pay for the transfer.
By default, the bridge adds 0.1 XTZ if the destination account has no XTZ.
:::

1. To make the transfer, click **Transfer** and confirm the transfer in your wallet.

The bridge shows a popup with a link to [LayerZero Scan](https://layerzeroscan.com/) where you can observe the progress of the bridge transaction and see an estimated time to completion.
When the status changes to "completed," the tokens are in your EVM account.
When the status changes to "completed" (or "delivered") the tokens are in your EVM account.
If you don't see the tokens, you may need to import the token into your wallet on the destination network.
For that, in the LayerZero page for your transaction, note the address of the "Destination Omnichain Application".
Then in your Temple wallet:
- Enable the target chain if needed, from the wallet Settings, section Networks.
- Click on the Settings icon right above the list of tokens you own, then choose "Add token" and enter the token address you noted.

## Troubleshooting

Expand All @@ -96,32 +98,32 @@ The transfer button can show these errors:
- **Select Different Chain**

The source and destination chains are not compatible.
This bridge is for moving tokens in and out of Etherlink, not for moving tokens between other networks.
This bridge is for moving tokens in and out of Etherlink EVM{/* TEVM */}, not for moving tokens between other networks.

- **Transfer Cap Reached**

The bridge cannot transfer the amount of tokens that you have selected.
Select a smaller amount to transfer.

This error can occur for bridgeable tokens that exist on multiple networks (ETH/WETH, USDT and USDC).
For example, if the bridge contract on Avalanche has 100 USDT, you can transfer no more than 100 USDT from Etherlink to Avalanche.
For example, if the bridge contract on Avalanche has 100 USDT, you can transfer no more than 100 USDT from Etherlink EVM{/* TEVM */} to Avalanche.

For further support, visit the [LayerZero Discord](https://discord.gg/ktbvm8Nkcr).

If you have general questions about Etherlink, we welcome you to join the [Etherlink Discord Community](https://discord.com/invite/etherlink).
If you have general questions about Etherlink{/* TX */}, we welcome you to join the [Etherlink{/* TX */} Discord Community](https://discord.com/invite/etherlink).

## Token addresses

:::note

Not all Etherlink tokens can be bridged to and from other chains.
See the tables below for the tokens that the bridge supports for each chain.
Not all Etherlink EVM{/* TEVM */} tokens can be bridged to and from other chains.
See the bridge UI for the tokens that the bridge supports for each chain.

:::

### Etherlink
### Etherlink EVM{/* TEVM */}

This table shows the Etherlink address of tokens that you can bridge between Etherlink and certain other chains:
This table shows the Etherlink EVM{/* TEVM */} address of some of the tokens you can bridge between Etherlink EVM{/* TEVM */} and certain other chains:

<table class="customTableContainer">
<thead>
Expand Down Expand Up @@ -394,17 +396,17 @@ These tables show the addresses of the equivalent tokens on other networks:

## How bridging wrapped assets works

The Etherlink EVM bridge uses a [wrapped asset bridge](https://github.com/LayerZero-Labs/wrapped-asset-bridge) created by [LayerZero](https://layerzero.network/).
It works by maintaining liquidity pools on other networks and minting equivalent tokens on Etherlink.
The Etherlink EVM{/* TEVM */} bridge uses a [wrapped asset bridge](https://github.com/LayerZero-Labs/wrapped-asset-bridge) created by [LayerZero](https://layerzero.network/).
It works by maintaining liquidity pools on other networks and minting equivalent tokens on Etherlink EVM{/* TEVM */}.

When you bridge tokens from other networks to Etherlink, the bridge contracts lock the tokens in a liquidity pool on the source network, send a message over LayerZero's software to Etherlink, and mint tokens on Etherlink.
When you bridge tokens out of Etherlink, the contracts burn the tokens on Etherlink and unlock them in the liquidity pool on the target network.
Therefore, bridging tokens out of Etherlink is dependent on the liquidity pool on the target chain.
LayerZero also maintains Etherlink EVM and Smart Rollup nodes to verify that the transactions complete on Etherlink.
When you bridge tokens from other networks to Etherlink EVM{/* TEVM */}, the bridge contracts lock the tokens in a liquidity pool on the source network, send a message over LayerZero's software to Etherlink EVM{/* TEVM */}, and mint tokens on Etherlink EVM{/* TEVM */}.
When you bridge tokens out of Etherlink EVM{/* TEVM */}, the contracts burn the tokens on Etherlink EVM{/* TEVM */} and unlock them in the liquidity pool on the target network.
Therefore, bridging tokens out of Etherlink EVM{/* TEVM */} is dependent on the liquidity pool on the target chain.
LayerZero also maintains EVM nodes{/* TXN */} to verify that the transactions complete on Etherlink EVM{/* TEVM */}.

This diagram shows how the EVM bridge works:

![Overview of the EVM bridge, showing the interaction between contracts on other chains and Etherlink, moderated by LayerZero](/img/wrapped-asset-bridge.png)
![Overview of the EVM bridge, showing the interaction between contracts on other chains and Etherlink EVM{/* TEVM */}, moderated by LayerZero](/img/wrapped-asset-bridge.png)
{/* https://lucid.app/lucidchart/cac80916-85c8-455d-b50b-f265057dcc1b/edit */}

For more information, see the repository for the bridge: https://github.com/LayerZero-Labs/wrapped-asset-bridge.
Expand All @@ -423,7 +425,7 @@ Developers can integrate these contracts into their own cross-chain bridge if re
</thead>
<tbody>
<tr>
<td>Etherlink</td>
<td>Etherlink EVM{/* TEVM */}</td>
<td><InlineCopy href="https://explorer.etherlink.com/address/0x1f8E735f424B7A49A885571A2fA104E8C13C26c7" code="0x1f8E735f424B7A49A885571A2fA104E8C13C26c7" abbreviate="5,4"></InlineCopy></td>
</tr>
<tr>
Expand Down Expand Up @@ -455,7 +457,7 @@ Developers can integrate these contracts into their own cross-chain bridge if re

## LayerZero endpoints for OFTs

LayerZero uses these contracts to connect Etherlink to its network for tokens that meet their Omnichain Fungible Token (OFT) standard.
LayerZero uses these contracts to connect Etherlink EVM{/* TEVM */} to its network for tokens that meet their Omnichain Fungible Token (OFT) standard.
For more information, see [Deployed Endpoints, Message Libraries, and Executors](https://docs.layerzero.network/v2/deployments/deployed-contracts?chains=etherlink).

<Tabs groupId="layerzero_contract_addresses">
Expand Down Expand Up @@ -536,7 +538,7 @@ For more information, see [Deployed Endpoints, Message Libraries, and Executors]
## Related tools and information

- For information about pending transactions, see the [LayerZero Cross Chain Explorer](https://layerzeroscan.com/).
- For information about Etherlink transactions, see the [Etherlink block explorer](https://explorer.etherlink.com/).
- For information about Etherlink EVM{/* TEVM */} transactions, see the [Etherlink EVM{/* TEVM */} block explorer](https://explorer.etherlink.com/).
- More Information about the LayerZero protocol is available in their [official documentation](https://docs.layerzero.network/).
- The audit reports of the LayerZero protocol are available in this [LayerZero GitHub Repository](https://github.com/LayerZero-Labs/LayerZero/tree/main/audit).
- To review the open source code of the EVM bridge, visit the [LayerZero Github Repository](https://github.com/LayerZero-Labs/wrapped-asset-bridge).
Loading
Loading