You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: pages/stack/interop/superchainerc20-best-practices.mdx
+11-7Lines changed: 11 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: Best practices for managing SuperchainERC20 tokens
3
3
lang: en-US
4
-
description: Essential best practices for deploying and managing SuperchainERC20 assets across Superchain-compatible networks.
4
+
description: Essential best practices for deploying and managing SuperchainERC20 assets across Superchain networks.
5
5
---
6
6
7
7
# Best practices for managing SuperchainERC20 tokens
@@ -10,19 +10,23 @@ The following best practices are essential for deploying and managing `Superchai
10
10
11
11
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.
12
12
13
-
## Consistent addressing across chains
13
+
## Consistent addresses across chains
14
14
15
-
* 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.
15
+
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.
16
+
17
+
Consider using `Create2Deployer` or one of our [predeploys](https://specs.optimism.io/interop/predeploys.html) to ensure this.
16
18
17
19
## Token metadata consistency
18
20
19
-
* Standardize token metadata: Use identical values for `name`, `symbol`, and `decimals` across all chain instances. Inconsistent metadata can lead to display errors and transaction rejections during cross-chain operations.
21
+
Standardize token metadata: Use identical values for `name`, `symbol`, and `decimals` across all chain instances. Inconsistent metadata can lead to display errors and transaction rejections during cross-chain operations.
22
+
23
+
## Testing before mainnet deployment
20
24
21
-
## Comprehensive testing before mainnet deployment
25
+
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.
22
26
23
-
* 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.
27
+
We recommend using [Supersim](https://supersim.pages.dev/introduction) as an easy way to simulate the Superchain and test your SuperchainERC20 deployment.
24
28
25
-
* Validate transfer handling: Test edge cases such as maximum balance transfers and inter-chain latency to ensure asset reliability across different scenarios.
29
+
Test edge cases such as maximum balance transfers and inter-chain latency to ensure asset reliability across different scenarios.
0 commit comments