The Scroll ERC-20 gateway provides the canonical path for representing native L1 tokens on the L2. When a token project deploys on Ethereum mainnet and wants its asset to be available on Scroll, it does not deploy a new contract on the L2. Instead, it registers the L1 token with the gateway, which deploys a corresponding ScrollStandardERC20 proxy contract at a deterministic address on Scroll. This proxy automatically mirrors the L1 token's name, symbol, and decimals, ensuring that wallets, explorers, and dApps display the asset consistently without requiring manual metadata synchronization.

Cross-Layer Token Integration (ERC-20 Gateway)
Introduction
How token projects register canonical L1 tokens on Scroll using the standard ERC-20 gateway for automatic mapping and metadata resolution.
The gateway operates as a lock-and-mint bridge: users deposit tokens into the L1StandardERC20Gateway contract on Ethereum, which locks the assets and sends a cross-layer message to the L2StandardERC20Gateway on Scroll to mint an equivalent amount on the L2 proxy. Withdrawals reverse the flow by burning tokens on Scroll and releasing the locked L1 tokens after the challenge period. This architecture means that token projects do not need to write custom bridge contracts for standard ERC-20s, but they must ensure their L1 token is registered correctly—including verifying that the gateway recognizes the correct metadata and that no conflicting registrations exist.
For token project teams, DeFi protocol deployers, and wallet integrators, the gateway registration process is a critical integration step. Incorrect metadata resolution can fragment liquidity, confuse users, and break composability with lending markets, AMMs, and aggregators. Chainscore Labs helps teams audit the registration flow, verify metadata consistency across layers, and review the gateway's interaction with custom token logic such as fee-on-transfer mechanics or rebasing tokens that may behave unexpectedly within the lock-and-mint model.
Quick Facts
Key operational facts for token project teams, DeFi deployers, and wallet integrators registering L1 tokens on Scroll via the standard gateway.
| Field | Value | Why it matters |
|---|---|---|
Gateway Contract | L1ERC20Gateway / L2ERC20Gateway (canonical bridge) | Determines the trust model and upgrade authority for token mappings. |
Token Mapping Mechanism | L1 token address deterministically maps to a counterpart L2 contract | Ensures consistent cross-layer representation; incorrect mapping breaks deposits and withdrawals. |
Metadata Resolution | Name and symbol are resolved from the L1 token contract during registration | Wallets and explorers rely on correct metadata for display; mismatches cause user confusion. |
Automatic Mapping UX | Standard gateway creates L2 counterpart automatically on first deposit | Simplifies user onboarding but requires teams to verify the generated contract before integration. |
Affected Actors | Token project teams, DeFi protocol deployers, wallet integrators, exchanges | Each actor has distinct verification and integration responsibilities. |
Registration Prerequisite | L1 token must be standard ERC-20 compliant | Non-standard tokens (e.g., fee-on-transfer, rebasing) may fail or lock funds. |
Action Required | Verify L2 counterpart bytecode, metadata, and gateway permissions | Unverified contracts pose security and compatibility risks for all downstream integrators. |
Chainscore Service | Token gateway integration review and metadata consistency audit | Identifies mapping errors, metadata drift, and non-standard token risks before mainnet deployment. |
How the Standard Gateway Works
The standard ERC-20 gateway enforces a canonical, one-to-one mapping between L1 and L2 token representations, automating deployment and metadata synchronization for token projects on Scroll.
The standard gateway is the default, permissionless mechanism for bridging fungible tokens between Ethereum L1 and Scroll. It operates through a pair of gateway contracts—one on L1 and one on L2—that communicate via the canonical bridge's message-passing system. When a token project calls registerToken on the L2 gateway, the system deploys a counterpart token contract on the opposite layer using a deterministic CREATE2 address. This ensures that every L1 token maps to exactly one L2 representation and vice versa, preventing the liquidity fragmentation and user confusion that plague multi-bridge ecosystems.
The gateway enforces strict metadata consistency. During registration, it queries the original token's name(), symbol(), and decimals() and encodes them into a cross-layer message. The counterpart ScrollStandardERC20 contract is initialized with this exact metadata. This design prevents a common integration failure where wallets and explorers display incorrect token information because they rely on on-chain metadata rather than off-chain token lists. The gateway also handles the deposit and withdraw lifecycle: L1 tokens are locked in the gateway contract while the equivalent amount is minted on L2; on withdrawal, L2 tokens are burned and the L1 tokens are released. This lock-and-mint pattern preserves total supply invariants across layers.
For token project teams, the integration surface is small but the correctness requirements are high. The L1 token must be a standard ERC-20 without rebasing, fee-on-transfer, or other non-standard balance mechanics that would break the gateway's accounting. Teams must also verify that the automatically deployed L2 contract matches their expected bytecode and that the gateway and counterpart addresses are correctly set. Wallet integrators should resolve token metadata from the L2 contract directly rather than maintaining manual mappings. Chainscore Labs reviews token gateway integrations for metadata consistency, supply invariant correctness, and edge-case handling—ensuring that tokens behave identically across layers and that users never encounter broken balances or incorrect display names.
Affected Actors
Token Project Teams
Token project teams are the primary actors responsible for executing the gateway registration. The core task is calling the registerToken function on the L1 gateway contract, which deploys a corresponding mapped token on Scroll's L2. Teams must ensure the L1 token's metadata—name, symbol, and decimals—is correctly resolved on L2 to maintain a seamless user experience.
Key Actions:
- Verify the L1 token contract is finalized and non-upgradeable, or that the upgrade pattern is compatible with the gateway's expectations.
- Test the registration flow on Scroll Sepolia testnet before mainnet deployment.
- Confirm that the automatically generated L2 token contract matches the expected interface for wallets and explorers.
- Coordinate with wallet and explorer teams to update their token lists with the new L2 address.
Chainscore Labs can audit the registration transaction payload and verify metadata consistency across layers to prevent user-facing display errors.
Implementation Impact Areas
Token projects integrating with Scroll's standard ERC-20 gateway must address metadata consistency, automatic mapping logic, and edge cases that affect wallets, explorers, and DeFi protocols.
Metadata Consistency Audit
The gateway resolves token name and symbol from the L1 contract. Discrepancies between L1 and L2 metadata—caused by proxy patterns, upgradeable contracts, or non-standard implementations—break wallet displays and explorer indexing. Token teams must verify that name() and symbol() return identical values on both layers before registering. Chainscore can audit your token's metadata resolution path and proxy delegate calls to prevent integration failures.
Gateway Contract Verification
The standard gateway uses a counterfactual deployment pattern where L2 token addresses are deterministic based on the L1 address. Teams must confirm their L1 token maps to the expected L2 address and that no conflicting custom bridge logic exists. Incorrect assumptions about the mapping function can lead to permanently locked liquidity or duplicate token representations. Chainscore reviews gateway registration transactions and verifies address derivation against the canonical Scroll bridge contracts.
Wallet and Explorer Integration
Wallets and block explorers rely on the gateway's automatic token-list population to display correct names, symbols, and decimals. If a token's L1 metadata changes post-registration—common with upgradeable tokens—L2 representations may become stale. Token teams should notify ecosystem partners of metadata changes and coordinate updates. Chainscore can facilitate integration testing with wallet providers and verify metadata propagation across Scroll's indexing infrastructure.
DeFi Protocol Compatibility
Lending markets, AMMs, and yield protocols that permissionlessly list tokens depend on the gateway's standard interface for deposit and withdrawal flows. Non-standard ERC-20 behaviors—such as fee-on-transfer, rebasing, or pausable tokens—can break protocol assumptions and cause loss of funds. Teams must disclose token behaviors to DeFi integrators. Chainscore assesses token contract behavior against Scroll's DeFi protocol expectations and identifies integration risks before TVL is committed.
Upgrade and Proxy Risk
Tokens using upgradeable proxy patterns on L1 introduce a dynamic risk: a future L1 implementation change may alter metadata or behavior that the L2 gateway cannot automatically reflect. This can create a permanent divergence between L1 and L2 token representations. Governance teams should document their upgrade procedures and notify Scroll ecosystem participants before executing changes. Chainscore provides upgrade impact assessments that model how L1 proxy changes propagate through the gateway to L2 integrations.
Cross-Layer Supply Reconciliation
The gateway maintains a 1:1 supply relationship: tokens locked on L1 are minted on L2, and tokens burned on L2 are released on L1. Teams must implement monitoring to reconcile total supply across layers and detect anomalies such as unexpected mints or burns. Discrepancies may indicate bridge contract bugs or unauthorized gateway interactions. Chainscore builds supply reconciliation dashboards and alerting systems that track token flows through the canonical bridge in real time.
Integration Risk Matrix
Risk assessment for token projects registering L1 tokens on Scroll via the standard ERC-20 gateway, covering metadata consistency, mapping behavior, and operational failure modes.
| Area | Failure Mode | Who is affected | Mitigation |
|---|---|---|---|
Metadata Mismatch | L1 token name/symbol/decimals differ from the Scroll-side ERC-20 contract, causing display errors in wallets and dApps. | Token project teams, wallet integrators, DeFi frontends | Audit deployed bytecode on Scroll against the canonical L1 token contract before announcing the bridge address. |
Gateway Contract Trust | Reliance on the standard gateway's upgradeability or governance to correctly map tokens; a malicious or compromised upgrade could redirect deposits. | Token holders, DeFi protocols holding bridged assets | Monitor the gateway's proxy admin and governance multi-sig for unexpected upgrades. Consider a custom gateway for high-value tokens. |
Automatic Mapping UX | The gateway automatically deploys a counterpart token on Scroll upon first L1 deposit, but the deployer loses control over constructor arguments and custom logic. | Token project teams, protocol deployers | Pre-deploy a custom token on Scroll and register it with the gateway before user deposits begin to retain control over the contract. |
Finality Risk on Withdrawal | Users or protocols treating L2 bridge withdrawals as final before the L1 challenge period expires, leading to premature crediting. | Exchanges, custodians, lending protocols | Enforce the full challenge period before crediting withdrawals. Implement on-chain finality verification against the L1 bridge contract. |
Indexer Lag | Data pipelines that do not correctly handle L1-originated bridge events may show incorrect token balances or supply on Scroll. | Data analytics teams, block explorers, portfolio trackers | Validate indexer logic against both L1 bridge events and L2 token contract events to ensure supply reconciliation. |
Gas Spike on L1 Deposit | A surge in L1 gas prices during a mass deposit event could trap user funds in the bridge queue, delaying minting on Scroll. | Token holders, market makers | Communicate L1 gas risk to users. Monitor the bridge queue depth and L1 gas market during token launch events. |
Reentrancy via Bridge Hook | A custom token's | Token project teams, DeFi protocols integrating the token | Conduct a dedicated security review of any custom bridge hooks, treating the gateway as a privileged caller. |
Token Launch Readiness Checklist
A systematic checklist for token project teams preparing to register an L1-native ERC-20 on Scroll via the standard gateway. Each item identifies a critical integration point, explains why it matters for user experience and security, and specifies the signal that confirms readiness before mainnet deployment.
What to check: Confirm that the L1 token contract implements the standard IERC20 interface with correct name(), symbol(), and decimals() return values. The canonical gateway does not support fee-on-transfer tokens, rebasing tokens, or tokens with non-standard transfer semantics.
Why it matters: The gateway deploys a counterpart ScrollStandardERC20 contract on L2 that reads metadata from the L1 token during initialization. Non-standard implementations can cause metadata mismatches, failed deposits, or permanently bricked L2 representations.
Readiness signal: A successful testnet deposit that produces an L2 token with identical name, symbol, and decimals to the L1 original, verified on a Scroll block explorer.
Source Resources
Canonical references and verification points for Cross-Layer Token Integration (ERC-20 Gateway) on Scroll. Use these sources to confirm current gateway contracts, token mapping behavior, metadata handling, and production monitoring assumptions before launch.
Integration Evidence Pack
Maintain an internal evidence pack for each Scroll ERC-20 gateway integration: L1 token address, expected L2 token address or mapping transaction, gateway/router addresses used, metadata screenshots, explorer links, test deposits, withdrawal tests, event signatures consumed by indexers, and monitoring alerts. This gives wallets, exchanges, DeFi partners, and risk teams a concrete source of truth when validating support or investigating user reports.
Looking to build on a specific blockchain?
We build smart contracts, DeFi applications, wallets, tokenization platforms, and blockchain infrastructure across the major ecosystems teams choose today. That includes Ethereum, Arbitrum, Optimism, Polygon, Avalanche, Solana, Sui, Aptos, Hedera, Stellar, and NEAR, with support for additional EVM and non-EVM networks based on your product requirements.
EVM ecosystems
- Ethereum
- Arbitrum
- Optimism
- Polygon
- Avalanche
- Cronos

Non-EVM ecosystems
- Solana
- Sui
- Aptos
- Hedera
- Stellar
- NEAR
Additional ecosystems
- Polkadot
- Cosmos
- TON
- Cardano
- Algorand
- Tempo
Also available for Base, appchains, custom EVM networks, and cross-chain product architecture.
Frequently Asked Questions
Common questions and operational checks for token project teams, DeFi protocol deployers, and wallet integrators working with the Scroll canonical ERC-20 gateway.
The gateway relies on a mapping between the L1 token and its corresponding L2 representation. When a token is bridged for the first time, the gateway deploys a standard L2StandardERC20 contract on Scroll. The name and symbol are derived from the L1 token's metadata at the time of deployment.
- What to check: Verify that the L1 token's
name()andsymbol()return the exact strings you expect before initiating the first deposit. The gateway will use these values to set the L2 token's metadata permanently. - Why it matters: If the L1 token uses a proxy pattern and the implementation is upgraded to change the name or symbol after the L2 token is deployed, the L2 token's metadata will be stale. This creates a UX discrepancy across layers.
- Confirmation signal: The L2 token's
name()andsymbol()match the canonical L1 values at the block the first deposit transaction was confirmed.
Delivering blockchain solutions for 5+ years.
We have partnered with 50+ leading DeFi protocols, NFT ecosystems, and fintech innovators to build secure, scalable, and capital-efficient blockchain products.
Selected Partners & Clients
“I've been working with Chainscore Labs for last 3+ years, they've consistently delivered with strong ownership across multiple projects. The team is reliable and detail-oriented.”
How to get started?
If you're looking for blockchain integration, ChainScore Labs has 5+ years of experience helping teams build and integrate exchanges, wallets, smart contracts, tokenization solutions, and protocol-connected products, we can help you choose the right path, integrate securely, and get to production faster. Our team consists of experienced blockchain developers and architects who can help you with your blockchain integration needs.
Exploration & Strategy
Define your product goals and choose the right blockchain architecture for your use case.
Architecture & Design
Design the smart contracts, tokenomics, and security parameters of your system.
Development & Integration
Build and integrate with wallets, oracles, and front-end dApps for a seamless experience.
Security & Launch
Comprehensive audits followed by a risk-managed mainnet deployment to protect your users.
Discover our
blockchain development services.
We build production-grade blockchain solutions for top-tier projects across DeFi and Web3.
Need a blockchain engineering team?
Send the project context and we will respond with next steps, scope questions, and a practical path to delivery.


