SuperchainERC20 best practices

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
   <Card title="How to transfer a SuperchainERC20" href="/stack/interop/assets/transfer-superchainERC20" />
 
   <Card title="How to deploy assets using SuperchainERC20" href="/stack/interop/assets/deploy-superchain-erc20" />
+
+  <Card title="Best practices for SuperchainERC20" href="/stack/interop/assets/superchainerc20-best-practices" />
 </Cards>

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)"
 }

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.

words.txt

@@ -400,6 +400,7 @@ VMDEBUG
 vmdebug
 VMODULE
 vmodule
+wagmi
 Warpcast
 xlarge
 XORI
@@ -408,3 +409,4 @@ ZKPs
 ZKVM
 Zora
 zora
+interchain