From 749ef4638c0e2a1fbd41c9f863fb2822ead03856 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ga=C3=ABl=20Blanchemain?= Date: Tue, 22 Oct 2024 11:14:48 -0700 Subject: [PATCH 1/5] fix: update arbitrum-sdk --- arbitrum-sdk | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/arbitrum-sdk b/arbitrum-sdk index f5b3d04ba..91562af78 160000 --- a/arbitrum-sdk +++ b/arbitrum-sdk @@ -1 +1 @@ -Subproject commit f5b3d04baf62356032f5475057637d989da5b6c1 +Subproject commit 91562af787312bc27891ba6ec2545752b2ccdac1 From fa336c646f61c0357e3bd7b3f8c1ba4631db374d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ga=C3=ABl=20Blanchemain?= Date: Tue, 22 Oct 2024 12:13:38 -0700 Subject: [PATCH 2/5] feat: add layer leap article --- .../token-bridging/layer-leap.mdx | 84 +++++++++++++++++++ website/sidebars.js | 5 ++ 2 files changed, 89 insertions(+) create mode 100644 arbitrum-docs/build-decentralized-apps/token-bridging/layer-leap.mdx diff --git a/arbitrum-docs/build-decentralized-apps/token-bridging/layer-leap.mdx b/arbitrum-docs/build-decentralized-apps/token-bridging/layer-leap.mdx new file mode 100644 index 000000000..4ab141400 --- /dev/null +++ b/arbitrum-docs/build-decentralized-apps/token-bridging/layer-leap.mdx @@ -0,0 +1,84 @@ +--- +title: 'Layer leap contracts' +description: 'Learn to use Layer leap contracts.' +author: leerderek +sme: amarrazza +target_audience: 'Developers who want to implement Layer leap contracts on their Orbit chain' +sidebar_position: 1 +--- + +import PublicPreviewBannerPartial from '../../partials/_public-preview-banner-partial.mdx'; + + + +## Single click bridging from L1 to L3 is now possible with layer leap + +- [ Main repository ](https://github.com/OffchainLabs/l1-l3-teleport-contracts) +- [ SDK support ](https://www.npmjs.com/package/@arbitrum/sdk/v/3.5.1-teleporter.0) (pre-release!) +- [ Request Feature ](https://github.com/OffchainLabs/arbitrum-token-bridge/issues/new?assignees=&labels=feat,triage&projects=&template=add-layerleap-request.yml&title=[feat]) + +Contract Addresses + +| Contract | Address | +| --------------------- | ----------------------------------------------------------------------- | +| Arb One L1Teleporter | https://etherscan.io/address/0xCBd9c6e310D6AaDeF9F025f716284162F0158992 | +| Arb Nova L1Teleporter | https://etherscan.io/address/0xCBd9c6e310D6AaDeF9F025f716284162F0158992 | + +## Launch details + +_Key timelines & announcements_ + +**Orbit Onboarding:** We are looking for interested Orbit L3s with ETH gas for immediate rollout **AND** Orbit L3s with custom gas tokens for future adoption in our next release. + +_Upcoming launches & future releases_ + +A future release of Layer Leap is not yet scheduled, but upcoming features including providing support for Orbit L3s with custom gas tokens. + +## Value & user impact + +**End-users:** Can now bridge `ETH` and `ERC-20`s from Ethereum to your Orbit L3 in a single click. + +- Bridging `ETH` requires one call on L1 +- Bridging an `ERC-20` requires one approval and one call on L1 + +**Orbit L3s:** Can more seamlessly onboard `ETH` and `ERC-20`s from Ethereum mainnet. + +_Which Orbit configurations can adopt this feature?_ + +**Any L3 Orbit Chains on top of an Arbitrum chain** **_with ETH gas fees_** can use Layer Leap. + +- Layer Leap contracts are currently only deployed for Arb One and Arb Nova, but contracts can be deployed for additional Arbitrum Layer-2s by Offchain Labs or your RaaS provider. + - The Layer 2 must be an Arbitrum chain due to the use of retryables. +- _Future support: Layer Leap will support Orbit chains with custom gas tokens in a future release_ + +## Implementation + +_How can Orbit chains adopt this feature?_ + +**UI Adoption:** Layer leap contracts can be integrated into your own bridge or added to your chain’s UI for the Arbitrum bridge (bridge.arbitrum.io) + +### Arbitrum bridge UI: if you are already on the arbitrum bridge UI then you can sign up for layer leap adoption by using this [github template](https://github.com/offchainlabs/arbitrum-token-bridge/issues/new?assignees=&labels=feat%2ctriage&projects=&template=add-layerleap-request.yml&title=%5bfeat%5d%3a+enable+layer+leap+for+%3corbit+chain%3e). + + - If you are not on the Arbitrum Bridge UI yet you can sign up by filling out this [GitHub Template](https://github.com/OffchainLabs/arbitrum-token-bridge/issues/new?assignees=&labels=feat%2Ctriage&projects=&template=add-orbit-chain-request.yml&title=%5Bfeat%5D%3A+), and then also fill out the template above. + - You can demo Layer Leap on the Arbitrum Bridge by bridging to [Rari](https://bridge.arbitrum.io/?destinationChain=rari-mainnet&sourceChain=ethereum) and [Proof of Play](https://bridge.arbitrum.io/?destinationChain=pop-apex&sourceChain=ethereum). + +### Custom bridge UI: if you want to integrate layer leap functionality into your custom bridge UI, read the [info page on the layer leap github](https://github.com/offchainlabs/l1-l3-teleport-contracts/blob/main/docs/info.md) to learn more. + +_What chains are currently supported?_ + +Layer Leap requires an L1 teleporter contract for each L2 chain. `L1Teleporter` contracts are deployed on Ethereum L1 for Arb One and Arb Nova. + +| Contract | Address | +| --------------------- | ----------------------------------------------------------------------- | +| Arb One L1Teleporter | https://etherscan.io/address/0xCBd9c6e310D6AaDeF9F025f716284162F0158992 | +| Arb Nova L1Teleporter | https://etherscan.io/address/0xCBd9c6e310D6AaDeF9F025f716284162F0158992 | + +For non Arbitrum One L3s: + +- To enable Layer Leap for your Layer 3 you can follow the Deployment Procedure defined [here](https://github.com/OffchainLabs/l1-l3-teleport-contracts/blob/main/docs/info.md). Before self deploying, let Offchain Labs know about your request! + +_Implementation requirements for RaaSes?_ + +Sending tokens from L2 to L3 relies on creation of a retryable. If you are supporting Layer Leap for your Orbit chains it’s highly recommended to be running the Retryables Monitoring tool: https://github.com/OffchainLabs/arb-retryables-monitoring. This will allow you to track and redeem any failed retryables + +_What configuration options or parameter changes should I consider?_ diff --git a/website/sidebars.js b/website/sidebars.js index 92483af4a..2af1a5ed8 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -150,6 +150,11 @@ const sidebars = { label: 'ETH bridging', id: 'build-decentralized-apps/token-bridging/token-bridge-ether', }, + { + type: 'doc', + label: 'Layer leap', + id: 'build-decentralized-apps/token-bridging/layer-leap', + }, { type: 'doc', label: 'ERC-20 token bridging', From 9ac3f0062cf680596d72831126ac9b1ad430ed1c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ga=C3=ABl=20Blanchemain?= Date: Mon, 28 Oct 2024 15:56:39 -0700 Subject: [PATCH 3/5] Revert "fix: update arbitrum-sdk" This reverts commit 749ef4638c0e2a1fbd41c9f863fb2822ead03856. --- arbitrum-sdk | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/arbitrum-sdk b/arbitrum-sdk index 91562af78..f5b3d04ba 160000 --- a/arbitrum-sdk +++ b/arbitrum-sdk @@ -1 +1 @@ -Subproject commit 91562af787312bc27891ba6ec2545752b2ccdac1 +Subproject commit f5b3d04baf62356032f5475057637d989da5b6c1 From 2942898ce8667bba584e6d3668a7152c3213ba23 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ga=C3=ABl=20Blanchemain?= Date: Mon, 28 Oct 2024 15:57:21 -0700 Subject: [PATCH 4/5] fix: fix title --- .../build-decentralized-apps/token-bridging/layer-leap.mdx | 2 +- website/sidebars.js | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/arbitrum-docs/build-decentralized-apps/token-bridging/layer-leap.mdx b/arbitrum-docs/build-decentralized-apps/token-bridging/layer-leap.mdx index 4ab141400..1c6527d84 100644 --- a/arbitrum-docs/build-decentralized-apps/token-bridging/layer-leap.mdx +++ b/arbitrum-docs/build-decentralized-apps/token-bridging/layer-leap.mdx @@ -1,5 +1,5 @@ --- -title: 'Layer leap contracts' +title: 'Layer Leap contracts' description: 'Learn to use Layer leap contracts.' author: leerderek sme: amarrazza diff --git a/website/sidebars.js b/website/sidebars.js index 2af1a5ed8..adeb31cf7 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -152,7 +152,7 @@ const sidebars = { }, { type: 'doc', - label: 'Layer leap', + label: 'Layer Leap contracts', id: 'build-decentralized-apps/token-bridging/layer-leap', }, { From 4c9855cc621926f9e4a0779accebf7f9703b4caa Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ga=C3=ABl=20Blanchemain?= Date: Fri, 15 Nov 2024 09:54:20 -0800 Subject: [PATCH 5/5] Update arbitrum-docs/build-decentralized-apps/token-bridging/layer-leap.mdx Co-authored-by: Derek Lee <103802618+leeederek@users.noreply.github.com> --- .../build-decentralized-apps/token-bridging/layer-leap.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/arbitrum-docs/build-decentralized-apps/token-bridging/layer-leap.mdx b/arbitrum-docs/build-decentralized-apps/token-bridging/layer-leap.mdx index 1c6527d84..19394ef4d 100644 --- a/arbitrum-docs/build-decentralized-apps/token-bridging/layer-leap.mdx +++ b/arbitrum-docs/build-decentralized-apps/token-bridging/layer-leap.mdx @@ -28,7 +28,7 @@ Contract Addresses _Key timelines & announcements_ -**Orbit Onboarding:** We are looking for interested Orbit L3s with ETH gas for immediate rollout **AND** Orbit L3s with custom gas tokens for future adoption in our next release. +**Orbit Onboarding:** Orbit L3 chains that use ETH for their gas token are eligible for immediate onboarding, while Orbit L3 chains that use custom gas tokens will be supported in future releases. Orbit L3s interested in adopting Layer Leap, regardless of the token they use for gas, should reach out regardless . _Upcoming launches & future releases_