diff --git a/pages/builders/app-developers/contracts/_meta.json b/pages/builders/app-developers/contracts/_meta.json index f8ed2c3be..50aa18684 100644 --- a/pages/builders/app-developers/contracts/_meta.json +++ b/pages/builders/app-developers/contracts/_meta.json @@ -1,5 +1,6 @@ { "compatibility": "Solidity Compatibility", "system-contracts": "System Contracts", - "optimization": "Cost Optimization" + "optimization": "Cost Optimization", + "superchain-erc20": "SuperchainERC20 Token Standard" } diff --git a/pages/builders/app-developers/contracts/superchain-erc20.mdx b/pages/builders/app-developers/contracts/superchain-erc20.mdx new file mode 100644 index 000000000..e966aac46 --- /dev/null +++ b/pages/builders/app-developers/contracts/superchain-erc20.mdx @@ -0,0 +1,6 @@ +--- +--- + +import SuperchainERC20 from '@/pages/stack/protocol/interop/superchain-erc20.mdx' + + diff --git a/pages/stack/protocol/interop/_meta.json b/pages/stack/protocol/interop/_meta.json index 309682173..d59a68f5d 100644 --- a/pages/stack/protocol/interop/_meta.json +++ b/pages/stack/protocol/interop/_meta.json @@ -1,5 +1,6 @@ { "explainer": "Interop Explainer", "cross-chain-message": "Anatomy of Cross-Chain Message", - "supersim": "Supersim Multichain Development Environment" + "supersim": "Supersim Multichain Development Environment", + "superchain-erc20": "SuperchainERC20 Token Standard" } \ No newline at end of file diff --git a/pages/stack/protocol/interop/superchain-erc20.mdx b/pages/stack/protocol/interop/superchain-erc20.mdx new file mode 100644 index 000000000..8abfb474e --- /dev/null +++ b/pages/stack/protocol/interop/superchain-erc20.mdx @@ -0,0 +1,90 @@ +--- +title: SuperchainERC20 Token Standard +lang: en-US +description: Learn basic details about the SuperchainERC20 token standard. +--- + +import { Callout } from 'nextra/components' + +# SuperchainERC20 Token Standard + + + Interop is currently in active development and not yet ready for production use. The information provided here may change. Check back regularly for the most up-to-date information. + + +`SuperchainERC20` is a token standard designed to enable asset interoperability in the Superchain. +Asset interoperability allows for tokens to securely move across chains without asset wrapping or liquidity pools for maximal capital efficiency, thus unifying liquidity and simplifying the user experience. + +Additional features: + +* **Simplified deployments**: Provides a consistent, unified standard for tokens across all Superchain-compatible networks and a common crosschain interface for the EVM ecosystem at large. +* **Permissionless propagation**: Easily clone an existing token contract to a new OP Stack chain using `create2` without requiring the original owner, which enables movement of assets to the new chain once Interop goes live. Importantly, permissionless propagation retains the integrity of the original owner on the contract and preserves security but proliferates the contract's availability to new chains. +* **Ethereum-aligned**: Intentionally designed to be generic and supported as an Ethereum-wide standard (RIP coming soon). + +## How it works + +`SuperchainERC20` token standard facilitates secure token transfers between chains in the Superchain networks via native burning and minting. + +* **Token Burning**: Initiating message where token is **burned** on the source chain. A user initiates a transfer of token from one blockchain to another and specifies the recipient wallet address on the destination chain. A specified amount of token is burned on the source chain. +* **Token Minting**: Executing message where token is **minted** on the destination chain. The specified amount of token is minted on the destination chain directly to the recipient wallet address. + +```mermaid +sequenceDiagram + box rgba(255, 4, 32, 0.1) ChainA + participant User-op + participant SuperchainERC20-op + participant SuperchainERC20Bridge-op + end + box rgba(248, 61, 213, 0.1) ChainB + participant SuperchainERC20Bridge-uni + participant SuperchainERC20-uni + participant User-uni + end + + + User-op->>SuperchainERC20-op: Initiate token transfer + SuperchainERC20-op->>SuperchainERC20Bridge-op: Bridge to Uni + SuperchainERC20Bridge-op->>SuperchainERC20-op: Burn tokens + SuperchainERC20Bridge-op-->>SuperchainERC20Bridge-op: Emit cross-chain event + SuperchainERC20Bridge-uni-->>SuperchainERC20Bridge-uni: Validates message + SuperchainERC20Bridge-uni-->>SuperchainERC20-uni: Mint tokens + SuperchainERC20-uni->>User-uni: User receives tokens +``` + +This diagram illustrates the process where tokens are burned on the source chain and minted on the destination chain, enabling seamless cross-chain transfers without the need for asset wrapping or liquidity pools. + +## Major components + +* **Token Contract**: implements the `SuperchainERC20` standard with bridging functionality. +* **Factory Predeploy**: uses a `create2`-based factory for deploying `SuperchainERC20` tokens consistently across chains. +* **Bridging Functions**: using methods like `sendERC20` and `relayERC20` for cross-chain transfers. + +## Comparison to other standards + +`SuperchainERC20` differs from other token standards in its focus and implementation: + +* `SuperchainERC20` has minimal differentiation from a standard ERC20 deployment, only requiring a minimal crosschain mint/burn interface, which aims to be a common pattern for the EVM ecosystem (RIP coming soon). +* `SuperchainERC20` shares trust assumptions across all chains in the Superchain, such that custom assumptions around security and latency are not required to account for when executing transfers. + + + Projects moving from other token standards may need to adapt to the `SuperchainERC20` specification. + + +## Implementation details + +Application developers must do two things to make their tokens `SuperchainERC20` compatible. Doing this setup now ensures that tokens can benefit from Interop once the Interop upgrade happens. + +1. Permission only `SuperchainERC20Bridge` to call `crosschainMint` and `crosschainBurn`. +2. Deployment at same address on every chain in the Superchain using `create2` function. + +For now, application developers should view `SuperchainERC20`as standard ERC20 tokens with additional built-in functions that allow cross-chain asset movement that will be enabled once Interop goes live. + + + To enable asset interoperability, `SuperchainERC20` token must give access to the address where the future `SuperchainERC20Bridge` will live. + + +## 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 e3500e2dd..d7b98eb3e 100644 --- a/words.txt +++ b/words.txt @@ -64,6 +64,7 @@ computependingblock confs corsdomain counterfactually +crosschain Crossmint daserver DATACAP @@ -204,6 +205,7 @@ MTLO MULT multiaddr Multichain +multichain multiclient multisigs MULTU @@ -260,6 +262,7 @@ POAPs PPROF pprof preconfigured +Predeploy predeploy Predeployed predeployed