diff --git a/pages/stack/interop/assets.mdx b/pages/stack/interop/assets.mdx index 7aa352c94..4d287b5f9 100644 --- a/pages/stack/interop/assets.mdx +++ b/pages/stack/interop/assets.mdx @@ -1,5 +1,5 @@ --- -title: Interop +title: Assets description: Documentation covering Cross Chain Message, Explainer, Message Passing, Op Supervisor, Superchain Erc20, Superchain Weth, Supersim, Transfer Superchainerc20 in the Interop section of the OP Stack ecosystem. lang: en-US --- @@ -18,4 +18,6 @@ Documentation covering SuperchainERC20, Superchain WETH, Supersim, and how to tr + + diff --git a/pages/stack/interop/assets/_meta.json b/pages/stack/interop/assets/_meta.json index 9398906a4..fb51b47ae 100644 --- a/pages/stack/interop/assets/_meta.json +++ b/pages/stack/interop/assets/_meta.json @@ -1,6 +1,7 @@ { "superchain-erc20": "SuperchainERC20", - "superchain-weth": "SuperchainWETH (Interoperable ETH)", "transfer-superchainERC20": "How to transfer a SuperchainERC20", - "deploy-superchain-erc20": "Deploy assets using SuperchainERC20" + "deploy-superchain-erc20": "Deploy assets using SuperchainERC20", + "superchainERC20-best-practices": "SuperchainERC20 best practices", + "superchain-weth": "SuperchainWETH (Interoperable ETH)" } \ No newline at end of file diff --git a/pages/stack/interop/assets/superchainerc20-best-practices.mdx b/pages/stack/interop/assets/superchainerc20-best-practices.mdx new file mode 100644 index 000000000..a483ce43c --- /dev/null +++ b/pages/stack/interop/assets/superchainerc20-best-practices.mdx @@ -0,0 +1,31 @@ +--- +title: Best practices for managing SuperchainERC20 tokens +lang: en-US +description: Essential best practices for deploying and managing SuperchainERC20 assets across Superchain networks. +--- + +# Best practices for managing SuperchainERC20 tokens + +The following best practices are essential for deploying and managing `SuperchainERC20` assets across the Superchain. These guidelines help ensure optimal cross-chain functionality. + +Note that the total supply of your tokens never fluctuates across the Superchain. Cross-chain burning and minting only affects the location of a token across the Superchain. + +## Consistent addresses across chains + +Use predefined addresses: Assign and verify the same address for each `SuperchainERC20` instance on every chain. Predefined addresses reduce deployment conflicts and ensure tokens are accurately recognized across chains. Otherwise, the SuperchainERC20Bridge would need a way to verify if the tokens they mint on destination correspond to the tokens that were burned on source. + +Consider using `Create2Deployer` or one of our [predeploys](https://specs.optimism.io/interop/predeploys.html) to ensure this. + +## Testing before mainnet deployment + +Test with production-like conditions: Deploy to staging environments that simulate mainnet conditions, especially for functions like `crosschainBurn` and `crosschainMint`. Test under realistic transaction loads to validate performance. + +We recommend using [Supersim](https://supersim.pages.dev/introduction) as an easy way to simulate the Superchain and test your SuperchainERC20 deployment. + +Test edge cases such as maximum balance transfers and interchain latency to ensure asset reliability across different scenarios. + +## Next steps + +* Explore the [SuperchainERC20 specifications](https://specs.optimism.io/interop/token-bridging.html) for in-depth implementation details. +* Watch the [Superchain interop design video walkthrough](https://www.youtube.com/watch?v=FKc5RgjtGes) for a visual explanation of the concepts. +* Review the [Superchain Interop Explainer](explainer) for answers to common questions about interoperability. diff --git a/words.txt b/words.txt index ee47a71c4..9b508946d 100644 --- a/words.txt +++ b/words.txt @@ -400,6 +400,7 @@ VMDEBUG vmdebug VMODULE vmodule +wagmi Warpcast xlarge XORI @@ -408,3 +409,4 @@ ZKPs ZKVM Zora zora +interchain \ No newline at end of file