From 9e972a38a95edf77c9f38db677090f48910fc872 Mon Sep 17 00:00:00 2001 From: jtfirek Date: Fri, 4 Oct 2024 17:49:07 -0500 Subject: [PATCH 1/7] EFIP adapter migration --- proposals/EFIP-9.md | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 proposals/EFIP-9.md diff --git a/proposals/EFIP-9.md b/proposals/EFIP-9.md new file mode 100644 index 00000000..cf847e28 --- /dev/null +++ b/proposals/EFIP-9.md @@ -0,0 +1,39 @@ +# [EFIP-9] OFT Adapter Migration + +**Author**: Jacob Firek (jacob@ether.fi) + +**Date**: 2023-10-3 + +## Summary + +Our current [OFT Adapter](https://etherscan.io/address/0xFE7fe01F8B9A76803aF3750144C2715D9bcf7D0D) is non-upgradeable, limiting our ability to add security features such as rate limiting and contract pausing in case of exploits. This proposal outlines the migration to a new upgradeable version of the OFTAdapter. This will allow us to add additional security features. + +## Motivation + +LayerZero provides a generic base layer for the bridging of any token via OFT. Their contracts are minimal and lack security features. Moving to an upgradeable version of the OFTAdapter will allow the protocol to add these features and ensure future flexibility to introduce improvements: + - rate limiting + - pausing of the contract + - queuing of large transfers + +## Proposal + +Below is a high-level description of the migration process. Please see the pull request and audit linked below for more details. + +1. **Custom Migration Contract**: + A custom migrationOFT contract will be deployed on Arbitrum to facilitate the migration process. This contract will allow us to send migration messages to mainnet with a hardcoded destination of the Upgradeable OFT Adapter. + +2. **Asset Transfer**: + The sendMigrationMessage function will trigger a series of messages to be sent to the Ethereum mainnet to transfer the weETH tokens from the old OFTAdapter to the new UpgradeableOFTAdapter. The destination is hardcoded to ensure that the assets are securely transferred. + +3. **L2 Synchronization**: + After the asset migration is complete, the Layer 2 OFTs will be updated to designate the new UpgradeableOFTAdapter as the peer contract. This ensures that the new adapter can communicate with the Layer 2 instances and maintain cross-chain functionality. + +## References + +[Migration Pull Request](https://github.com/etherfi-protocol/weETH-cross-chain/pull/5) +[Migration Audit](https://github.com/etherfi-protocol/smart-contracts/blob/master/audits/2024.09.30%20-%20Paladin_EtherFi_OFT_Adapter_Migration.pdf) + +## Copyright + +Copyright and related rights waived via [CC0](https://creativecommons.org/publicdomain/zero/1.0/). + From 41b7005330d9e04cf55a3e92dace12723adc51b9 Mon Sep 17 00:00:00 2001 From: Jacob T Firek <106350168+jtfirek@users.noreply.github.com> Date: Fri, 4 Oct 2024 17:51:44 -0500 Subject: [PATCH 2/7] Update EFIP-9.md Signed-off-by: Jacob T Firek <106350168+jtfirek@users.noreply.github.com> --- proposals/EFIP-9.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/proposals/EFIP-9.md b/proposals/EFIP-9.md index cf847e28..62266345 100644 --- a/proposals/EFIP-9.md +++ b/proposals/EFIP-9.md @@ -10,7 +10,7 @@ Our current [OFT Adapter](https://etherscan.io/address/0xFE7fe01F8B9A76803aF3750 ## Motivation -LayerZero provides a generic base layer for the bridging of any token via OFT. Their contracts are minimal and lack security features. Moving to an upgradeable version of the OFTAdapter will allow the protocol to add these features and ensure future flexibility to introduce improvements: +LayerZero provides a generic base layer for the bridging of any token via OFT. Their contracts are minimal and lack security features. Moving to an upgradeable version of the OFTAdapter will allow the protocol to add these features listed below and maintain flexibility for future improvements: - rate limiting - pausing of the contract - queuing of large transfers From 7d64162d4c84946b85a1b0a0be9d65ca00132b69 Mon Sep 17 00:00:00 2001 From: Jacob T Firek <106350168+jtfirek@users.noreply.github.com> Date: Fri, 4 Oct 2024 17:52:39 -0500 Subject: [PATCH 3/7] Update EFIP-9.md Signed-off-by: Jacob T Firek <106350168+jtfirek@users.noreply.github.com> --- proposals/EFIP-9.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/proposals/EFIP-9.md b/proposals/EFIP-9.md index 62266345..7317d942 100644 --- a/proposals/EFIP-9.md +++ b/proposals/EFIP-9.md @@ -20,7 +20,7 @@ LayerZero provides a generic base layer for the bridging of any token via OFT. T Below is a high-level description of the migration process. Please see the pull request and audit linked below for more details. 1. **Custom Migration Contract**: - A custom migrationOFT contract will be deployed on Arbitrum to facilitate the migration process. This contract will allow us to send migration messages to mainnet with a hardcoded destination of the Upgradeable OFT Adapter. + A custom migrationOFT contract will be deployed on Arbitrum to facilitate the migration process. This contract will allow us to send migration messages to mainnet with a hardcoded destination of the UpgradeableOFTAdapter. 2. **Asset Transfer**: The sendMigrationMessage function will trigger a series of messages to be sent to the Ethereum mainnet to transfer the weETH tokens from the old OFTAdapter to the new UpgradeableOFTAdapter. The destination is hardcoded to ensure that the assets are securely transferred. From e68bfac5428476c056a19a1a84f9daf88037303c Mon Sep 17 00:00:00 2001 From: Jacob T Firek <106350168+jtfirek@users.noreply.github.com> Date: Fri, 4 Oct 2024 17:53:06 -0500 Subject: [PATCH 4/7] Update EFIP-9.md Signed-off-by: Jacob T Firek <106350168+jtfirek@users.noreply.github.com> --- proposals/EFIP-9.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/proposals/EFIP-9.md b/proposals/EFIP-9.md index 7317d942..1c6738e0 100644 --- a/proposals/EFIP-9.md +++ b/proposals/EFIP-9.md @@ -26,7 +26,7 @@ Below is a high-level description of the migration process. Please see the pull The sendMigrationMessage function will trigger a series of messages to be sent to the Ethereum mainnet to transfer the weETH tokens from the old OFTAdapter to the new UpgradeableOFTAdapter. The destination is hardcoded to ensure that the assets are securely transferred. 3. **L2 Synchronization**: - After the asset migration is complete, the Layer 2 OFTs will be updated to designate the new UpgradeableOFTAdapter as the peer contract. This ensures that the new adapter can communicate with the Layer 2 instances and maintain cross-chain functionality. + After the asset migration is complete, the Layer 2 OFTs will be reconfigured to designate the new UpgradeableOFTAdapter as the peer contract. This ensures that the new adapter can communicate with the Layer 2 instances and maintain cross-chain functionality. ## References From f97e60c9c6b9ecd46d035913a896563d2e4d499f Mon Sep 17 00:00:00 2001 From: Jacob T Firek <106350168+jtfirek@users.noreply.github.com> Date: Fri, 4 Oct 2024 17:55:07 -0500 Subject: [PATCH 5/7] Update EFIP-9.md Signed-off-by: Jacob T Firek <106350168+jtfirek@users.noreply.github.com> --- proposals/EFIP-9.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/proposals/EFIP-9.md b/proposals/EFIP-9.md index 1c6738e0..c2716a85 100644 --- a/proposals/EFIP-9.md +++ b/proposals/EFIP-9.md @@ -2,7 +2,7 @@ **Author**: Jacob Firek (jacob@ether.fi) -**Date**: 2023-10-3 +**Date**: 2023-10-03 ## Summary From 77a917fa1c852dc251dde4a9de9b1dd342ca791a Mon Sep 17 00:00:00 2001 From: syko Date: Mon, 7 Oct 2024 10:17:06 +0900 Subject: [PATCH 6/7] Update and rename EFIP-9.md to EFIP-14-OFT-Adapter-Migration.md Signed-off-by: syko --- proposals/{EFIP-9.md => EFIP-14-OFT-Adapter-Migration.md} | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename proposals/{EFIP-9.md => EFIP-14-OFT-Adapter-Migration.md} (98%) diff --git a/proposals/EFIP-9.md b/proposals/EFIP-14-OFT-Adapter-Migration.md similarity index 98% rename from proposals/EFIP-9.md rename to proposals/EFIP-14-OFT-Adapter-Migration.md index c2716a85..5dc97dc8 100644 --- a/proposals/EFIP-9.md +++ b/proposals/EFIP-14-OFT-Adapter-Migration.md @@ -1,4 +1,4 @@ -# [EFIP-9] OFT Adapter Migration +# [EFIP-14] OFT Adapter Migration **Author**: Jacob Firek (jacob@ether.fi) From b24f8e95e166d1f6d099b57bfc768de459a57508 Mon Sep 17 00:00:00 2001 From: syko Date: Mon, 7 Oct 2024 10:17:26 +0900 Subject: [PATCH 7/7] Update and rename EFIP-14-OFT-Adapter-Migration.md to EFIP-15-OFT-Adapter-Migration.md Signed-off-by: syko --- ...FT-Adapter-Migration.md => EFIP-15-OFT-Adapter-Migration.md} | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename proposals/{EFIP-14-OFT-Adapter-Migration.md => EFIP-15-OFT-Adapter-Migration.md} (98%) diff --git a/proposals/EFIP-14-OFT-Adapter-Migration.md b/proposals/EFIP-15-OFT-Adapter-Migration.md similarity index 98% rename from proposals/EFIP-14-OFT-Adapter-Migration.md rename to proposals/EFIP-15-OFT-Adapter-Migration.md index 5dc97dc8..4e571ac0 100644 --- a/proposals/EFIP-14-OFT-Adapter-Migration.md +++ b/proposals/EFIP-15-OFT-Adapter-Migration.md @@ -1,4 +1,4 @@ -# [EFIP-14] OFT Adapter Migration +# [EFIP-15] OFT Adapter Migration **Author**: Jacob Firek (jacob@ether.fi)