From bd83c3d4a751b2807b7c813a35bab1be93f00618 Mon Sep 17 00:00:00 2001 From: Soam Desai Date: Sun, 20 Sep 2026 20:54:05 -0700 Subject: [PATCH 1/7] docs(world-chain): fix 21 audit findings across quick-start, developers, providers, reference, tokens - world-chain/providers/explorers.mdx: removed the Dora entry (ondora.xyz deployment fully disabled, HTTP 402) - world-chain/quick-start/info.mdx: updated Mainnet/Sepolia Gas Limit and Gas Target to current live values (280M/140M, 480M/240M); added Isthmus, Jovian, and Karst hardfork rows to both tables - world-chain/developers/fees.mdx: softened the "L1 fee is typically higher" claim to reflect current reality post-Ecotone/blob fees; unlinked the dead GasHawk reference - world-chain/developers/deploy.mdx: added --broadcast to the forge create command and noted Foundry's dry-run default - world-chain/developers/evm-equivalence.mdx: refreshed the parameter table with live gas limit/elasticity/denominator values and added a note pointing to the Superchain Registry for values that keep moving - world-chain/providers/developer-tooling.mdx: removed the Blocknative Gas Price API entry (product sunsetting, docs endpoint unreachable) - world-chain/providers/bridges.mdx: removed the Cortex Protocol entry (site rebranded away from lending/liquidity); updated Synapse link to its current hypercall.xyz destination - world-chain/reference/node-setup.mdx: rewrote the Configuration section for the current simple-worldchain-node (NODE_TYPE, FLASHBLOCKS_ENABLED, DOWNLOAD_SNAPSHOT; dropped op-geth-specific vars and the broken Bware Labs snapshot link); documented Grafana's anonymous access instead of stale admin/worldchain credentials - world-chain/reference/useful-contracts.mdx: fixed the World ID Address Book link to point directly at the correct page; removed the "AddModules Helper" row that duplicated the verified SafeProxyFactory address - world-chain/developers/template.mdx: added --broadcast to the forge create example; fixed the "pnpm" link to point to pnpm.io instead of yarnpkg.com - world-chain/developers/grants.mdx: removed the dead/empty Mina RFP link and the broken Zeth blog link (kept as plain text) - world-chain/providers/oracles.mdx: updated the dead Chainlink Data Streams Direct link to the current Data Streams docs - world-chain/tokens/superchain-token.mdx: renamed SuperchainERC20Bridge -> SuperchainTokenBridge and ICrosschainERC20 -> IERC7802 to match the current spec - world-chain/developers/world-chain-contracts.mdx: clarified that the GovernanceToken predeploy is an unused OP Stack scaffold contract unrelated to WLD - world-chain/providers/data.mdx: added a link to GoldSky for consistency with other entries --- world-chain/developers/deploy.mdx | 5 ++- world-chain/developers/evm-equivalence.mdx | 24 +++++----- world-chain/developers/fees.mdx | 4 +- world-chain/developers/grants.mdx | 2 +- world-chain/developers/template.mdx | 6 +-- .../developers/world-chain-contracts.mdx | 2 +- world-chain/providers/bridges.mdx | 7 +-- world-chain/providers/data.mdx | 4 +- world-chain/providers/developer-tooling.mdx | 8 ---- world-chain/providers/explorers.mdx | 7 --- world-chain/providers/oracles.mdx | 2 +- world-chain/quick-start/info.mdx | 44 +++++++++++++++++-- world-chain/reference/node-setup.mdx | 27 ++++-------- world-chain/reference/useful-contracts.mdx | 8 +--- world-chain/tokens/superchain-token.mdx | 8 ++-- 15 files changed, 80 insertions(+), 78 deletions(-) diff --git a/world-chain/developers/deploy.mdx b/world-chain/developers/deploy.mdx index 2cded5c..d14fd47 100644 --- a/world-chain/developers/deploy.mdx +++ b/world-chain/developers/deploy.mdx @@ -172,11 +172,12 @@ Now that you have a wallet and you funded it with World Chain Sepolia ETH, you c ```bash Deploy the contract forge create src/HelloWorldChain.sol:HelloWorldChain \ --rpc-url https://worldchain-sepolia.g.alchemy.com/public \ - --private-key 0xcc1b30a6af68ea9a9917f1dda20c927704c5cdb2bbe0076901a8a0e40bf997c5 + --private-key 0xcc1b30a6af68ea9a9917f1dda20c927704c5cdb2bbe0076901a8a0e40bf997c5 \ + --broadcast ``` Here, we are using the `:` format to specify the contract. This tells Foundry where to find the contract file (`src/HelloWorldChain.sol`) and which contract within the file (HelloWorldChain) to deploy. -We also use the `--rpc-url` flag to specify the RPC URL of the World Chain Sepolia network and the `--private-key` flag to specify the private key of the wallet we generated earlier. +We also use the `--rpc-url` flag to specify the RPC URL of the World Chain Sepolia network and the `--private-key` flag to specify the private key of the wallet we generated earlier. Current versions of Foundry default `forge create` to a dry run, so the `--broadcast` flag is required to actually send the deployment transaction. On top of this we can also provide other flags like `-vvvvv` to get more verbose output from the deployment process, `--verify` to verify the contract on [Worldscan](https://worldscan.org) or [Blockscout](https://worldchain-sepolia.explorer.alchemy.com/) (alongside with an `--etherscan-api-key` flag) and several other flags to toggle different features that you can find more about in the [Foundry documentation](https://book.getfoundry.sh/). diff --git a/world-chain/developers/evm-equivalence.mdx b/world-chain/developers/evm-equivalence.mdx index 2b24a4f..f2bdc50 100644 --- a/world-chain/developers/evm-equivalence.mdx +++ b/world-chain/developers/evm-equivalence.mdx @@ -17,6 +17,8 @@ ensuring a flexible yet consistent environment for developers and users alike. Though the EVM remains unchanged across OP Stack (Superchain) chains compared to the Ethereum layer 1, there are some configurations of the execution clients that do differ. +These parameters are on-chain configuration values that change over time (for example, as gas limits are raised). You can always find the current values in the [Superchain Registry](https://github.com/ethereum-optimism/superchain-registry/blob/main/superchain/configs/mainnet/worldchain.toml). + @@ -35,25 +37,25 @@ do differ. - - - + + + - - - + + + - - + + - + @@ -61,7 +63,7 @@ do differ. - + @@ -69,7 +71,7 @@ do differ. - + diff --git a/world-chain/developers/fees.mdx b/world-chain/developers/fees.mdx index 6669ea9..5489f46 100644 --- a/world-chain/developers/fees.mdx +++ b/world-chain/developers/fees.mdx @@ -5,9 +5,9 @@ description: "Understand World Chain fees: L2 execution vs L1 security costs, va "twitter:image": "https://raw.githubusercontent.com/worldcoin/developer-docs/main/images/docs/docs-meta.png" --- -Every World Chain transaction consists of two costs: an L2 (execution) fee and an L1 (security) fee. The L2 fee is the cost to execute your transaction on the L2, while the L1 fee covers the estimated cost of publishing the transaction on the L1. Typically, the L1 security fee is higher than the L2 execution fee. +Every World Chain transaction consists of two costs: an L2 (execution) fee and an L1 (security) fee. The L2 fee is the cost to execute your transaction on the L2, while the L1 fee covers the estimated cost of publishing the transaction on the L1. The relative size of each component varies over time as L1 data-posting costs and L2 network usage change; following the Ecotone upgrade's blob fees, the L2 execution fee is typically the larger of the two, though this can shift again with future protocol upgrades. -The L1 fee fluctuates depending on the volume of transactions on the L1. If your transaction timing is flexible, you can save on costs by submitting during periods of lower gas fees on the L1 (for example, weekends) or using products like [GasHawk](https://gashawk.io/) which schedule transactions during periods of low demand. +The L1 fee fluctuates depending on the volume of transactions on the L1. If your transaction timing is flexible, you can save on costs by submitting during periods of lower gas fees on the L1 (for example, weekends) or using transaction-scheduling products which submit during periods of low demand. Similarly, the L2 fee can vary based on the number of transactions submitted to the L2. This dynamic adjustment works similarly to the L1; you can learn more about it [here](https://blog.thirdweb.com/eip-1559-ethereum-gas-fees/). diff --git a/world-chain/developers/grants.mdx b/world-chain/developers/grants.mdx index 47c4325..2236f58 100644 --- a/world-chain/developers/grants.mdx +++ b/world-chain/developers/grants.mdx @@ -14,7 +14,7 @@ you can read the [Continuous Grants program announcement blogpost](https://world - Rustification of the [OP Stack](https://docs.optimism.io/stack/getting-started) - Furthering [the gigagas roadmap](https://www.google.com/url?q=https://www.paradigm.xyz/2024/04/reth-perf&sa=D&source=editors&ust=1726507097184499&usg=AOvVaw34fUyrLcoigheJlrfbIDM2) -- ZK-ifying the OP Stack (efforts like [OP Succinct](https://blog.succinct.xyz/op-succinct/), [Zeth from Risc0](https://risczero.com/blog/zeth-release) and [Mina's ZK fault proof RFP]()) +- ZK-ifying the OP Stack (efforts like [OP Succinct](https://blog.succinct.xyz/op-succinct/), Zeth from Risc0 and Mina's ZK fault proof RFP) - Scalability research and engineering (can be Ethereum core as well) - Embedding priority blockspace for humans into the OP Stack derivation pipeline + fault proof program (open R&D) - Separate eip1559 fee market for humans on OP Stack diff --git a/world-chain/developers/template.mdx b/world-chain/developers/template.mdx index b0be356..bc5cb10 100644 --- a/world-chain/developers/template.mdx +++ b/world-chain/developers/template.mdx @@ -16,7 +16,7 @@ Before we start, make sure you have the following tools installed: - [Git](https://git-scm.com/) (usually pre-installed on most systems) - [Node.js](https://nodejs.org/en/) -- [pnpm](https://yarnpkg.com/) (or equivalent like npm, yarn or bun) +- [pnpm](https://pnpm.io/) (or equivalent like npm, yarn or bun) - [Foundry CLI](https://book.getfoundry.sh/) ## Clone template @@ -173,10 +173,10 @@ Once the fork is running, you can deploy the World ID template app to the World ```bash # cd into the contracts directory cd contracts -forge create --rpc-url http://localhost:8545 --private-key 0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80 src/Contract.sol:Contract --constructor-args $WORLD_ID_ROUTER $NEXT_PUBLIC_APP_ID $NEXT_PUBLIC_ACTION +forge create --rpc-url http://localhost:8545 --private-key 0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80 src/Contract.sol:Contract --constructor-args $WORLD_ID_ROUTER $NEXT_PUBLIC_APP_ID $NEXT_PUBLIC_ACTION --broadcast ``` -This command will deploy the `Contract` contract to the World Chain Sepolia network using the provided RPC URL and private key. +This command will deploy the `Contract` contract to the World Chain Sepolia network using the provided RPC URL and private key. The `--broadcast` flag is required because current versions of Foundry default `forge create` to a dry run. ## Local Web Setup diff --git a/world-chain/developers/world-chain-contracts.mdx b/world-chain/developers/world-chain-contracts.mdx index 281ec09..bef8d7a 100644 --- a/world-chain/developers/world-chain-contracts.mdx +++ b/world-chain/developers/world-chain-contracts.mdx @@ -63,7 +63,7 @@ title: "World Chain Contracts" - + diff --git a/world-chain/providers/bridges.mdx b/world-chain/providers/bridges.mdx index 9d3231d..2afdcee 100644 --- a/world-chain/providers/bridges.mdx +++ b/world-chain/providers/bridges.mdx @@ -37,7 +37,7 @@ The next best method is to use the native Superchain bridge for which both Alche ### Synapse -[Synapse](https://synapseprotocol.com/) is a cross-chain communication protocol that enables seamless asset transfers and messaging across different blockchain networks. It provides a secure and efficient infrastructure for interoperability, allowing users to move tokens and data between various chains without the need for centralized intermediaries. +[Synapse](https://hypercall.xyz/synapse) is a cross-chain communication protocol that enables seamless asset transfers and messaging across different blockchain networks. It provides a secure and efficient infrastructure for interoperability, allowing users to move tokens and data between various chains without the need for centralized intermediaries. Synapse's parent brand is now Hypercall. ### Hyperlane @@ -59,8 +59,3 @@ You can see World Chain-specific documentation for CCIP [here](https://docs.chai Thirdweb's [Universal Bridge](https://portal.thirdweb.com/connect/pay/overview) is a comprehensive Web3 payment solution that allows your users to onramp, bridge, and swap on any EVM chain — with any EVM token or fiat — thanks to its automatic cross-chain routing. -## Liquidity Layers - -### Cortex Protocol - -[Cortex Protocol](https://cortexprotocol.com/) is a decentralized, non-custodial liquidity protocol built on Ethereum that enables users to lend and borrow crypto assets. The protocol is designed to provide a secure and efficient platform for decentralized finance (DeFi) activities. \ No newline at end of file diff --git a/world-chain/providers/data.mdx b/world-chain/providers/data.mdx index 64078e7..e99788b 100644 --- a/world-chain/providers/data.mdx +++ b/world-chain/providers/data.mdx @@ -53,11 +53,11 @@ For more data on [World](https://world.org/) and [World Chain](https://world.org - World Chain -## GoldSky Subgraphs +## [GoldSky](https://goldsky.com/) Subgraphs GoldSky Subgraphs is a data indexing service designed to simplify querying blockchain data. It provides developers with scalable, customizable subgraphs for efficiently indexing and retrieving on-chain data from various blockchain networks. GoldSky streamlines data access for decentralized applications (dApps), - offering a user-friendly interface and advanced APIs that help developers query blockchain data faster and more accurately. + offering a user-friendly interface and advanced APIs that help developers query blockchain data faster and more accurately. See the [GoldSky docs](https://docs.goldsky.com/) for more information. ### Supported networks diff --git a/world-chain/providers/developer-tooling.mdx b/world-chain/providers/developer-tooling.mdx index 2bbe2a8..393f3c7 100644 --- a/world-chain/providers/developer-tooling.mdx +++ b/world-chain/providers/developer-tooling.mdx @@ -18,14 +18,6 @@ Alchemy provides a suite of data tools to make it easy to build on World Chain: - World Chain - World Chain Sepolia -## Blocknative - -[Blocknative's Gas Price API](https://docs.blocknative.com/gas-prediction/gas-platform) predicts next-block gas prices. - -### Supported networks - -- World Chain - ## QuickNode Access comprehensive developer tools built for World Chain: diff --git a/world-chain/providers/explorers.mdx b/world-chain/providers/explorers.mdx index 0cfc4d7..84d2a1c 100644 --- a/world-chain/providers/explorers.mdx +++ b/world-chain/providers/explorers.mdx @@ -12,13 +12,6 @@ Blockscout is a comprehensive, open-source blockchain explorer designed for insp A testnet explorer is also available for [World Chain Sepolia](https://worldchain-sepolia.explorer.alchemy.com/). -## Dora - -[Dora](https://www.ondora.xyz/network/worldchain/interactions) is an advanced multi-chain block explorer and unified search engine designed for the evolving blockchain ecosystem. -It offers users the ability to search and interact with data across more than 10 different networks, including World Chain. - -It is an innovative blockchain explorer and search engine designed for the multichain and multi-VM world. - ## Worldscan (Etherscan) [Worldscan](https://worldscan.org) (provided by [Etherscan](https://etherscan.io)) is a comprehensive blockchain explorer and analytics platform specifically designed for the World Chain network. diff --git a/world-chain/providers/oracles.mdx b/world-chain/providers/oracles.mdx index a4442ee..f71cc51 100644 --- a/world-chain/providers/oracles.mdx +++ b/world-chain/providers/oracles.mdx @@ -20,7 +20,7 @@ You can enable any of Api3's data feeds on World Chain using the [Api3 Market](h [Chainlink Data Streams](https://chain.link/) delivers low-latency market data offchain, which you can verify onchain. -You can find documentation for Chainlink Data Streams Direct [here](https://docs.chain.link/data-streams/streams-direct). +You can find documentation for Chainlink Data Streams [here](https://docs.chain.link/data-streams). ### Supported networks diff --git a/world-chain/quick-start/info.mdx b/world-chain/quick-start/info.mdx index b050b00..390ef7b 100644 --- a/world-chain/quick-start/info.mdx +++ b/world-chain/quick-start/info.mdx @@ -45,11 +45,11 @@ description: "World Chain network configuration and technical details" - + - + @@ -131,6 +131,24 @@ description: "World Chain network configuration and technical details" 1738238400 (Thu 30 Jan 2025 12:00:00 UTC) + + + + + + + + + + + +
Block gas limit30,000,00030,000,00030,000,000280,000,00040,000,000~60,000,000
Block gas target10,000,0005,000,00015,000,000See [Superchain Registry](https://github.com/ethereum-optimism/superchain-registry/blob/main/superchain/configs/mainnet/worldchain.toml)20,000,000~30,000,000
EIP-1559 elasticity multiplier66222 2
EIP-1559 denominator250100 250 8
Maximum base fee increase (per block) 0.8%See [Superchain Registry](https://github.com/ethereum-optimism/superchain-registry/blob/main/superchain/configs/mainnet/worldchain.toml) 2% 12.5%
Maximum base fee decrease (per block) 0.4%See [Superchain Registry](https://github.com/ethereum-optimism/superchain-registry/blob/main/superchain/configs/mainnet/worldchain.toml) 0.4% 12.5%
[`0x420000000000000000000000000000000000001A`](https://worldscan.org/address/0x420000000000000000000000000000000000001A)
GovernanceTokenGovernanceToken (unused OP Stack scaffold predeploy — symbol `OP`, totalSupply 0; unrelated to WLD/Worldcoin governance) [`0x4200000000000000000000000000000000000042`](https://worldscan.org/address/0x4200000000000000000000000000000000000042)
Gas Limit80M280M
Gas Target40M140M
Block Time
Isthmus + 1764072000 (Tue 25 Nov 2025 12:00:00 UTC) +
Jovian + 1777593600 (Fri 1 May 2026 00:00:00 UTC) +
Karst + 1789992000 (Mon 21 Sep 2026 12:00:00 UTC) +
@@ -174,11 +192,11 @@ description: "World Chain network configuration and technical details" Gas Limit - 30M + 480M Gas Target - 15M + 240M Block Time @@ -270,5 +288,23 @@ description: "World Chain network configuration and technical details" 1742486400 (Thu 20 Mar 2025 16:00:00 UTC) + + Isthmus + + 1761825600 (Thu 30 Oct 2025 12:00:00 UTC) + + + + Jovian + + 1777161600 (Sun 26 Apr 2026 00:00:00 UTC) + + + + Karst + + 1788868800 (Tue 8 Sep 2026 12:00:00 UTC) + + diff --git a/world-chain/reference/node-setup.mdx b/world-chain/reference/node-setup.mdx index d63c8aa..0a3ea3f 100644 --- a/world-chain/reference/node-setup.mdx +++ b/world-chain/reference/node-setup.mdx @@ -16,11 +16,7 @@ World Chain mainnet and testnet run on the OP Stack as part of the Superchain. W ## Using `simple-worldchain-node` -`simple-worldchain-node` supports World Chain Mainnet and Sepolia, full nodes and archive nodes, and two execution clients: [op-geth](https://github.com/ethereum-optimism/op-geth) and [op-reth](https://github.com/paradigmxyz/reth). - - - World Chain archive node snapshots for `op-geth` are available from Bware Labs [here](https://bwarelabs.com/snapshots/worldchain). - +`simple-worldchain-node` supports World Chain Mainnet and Sepolia, and archive, full, and minimal node types, running the `world-chain` client (a customized extension of [op-reth](https://github.com/paradigmxyz/reth)). ### Installation @@ -46,12 +42,8 @@ Open your `.env` file in an editor of your choice. The following values must be Used to select which network the node connects to, either `worldchain-mainnet` or `worldchain-sepolia`. - - Used to select your execution client, either `geth` (default) or `reth` (recommended for archive nodes). - - - - When using `op-geth`, determines which type of node to run. Either `full` (less storage, but only recent history) or `archive` (more storage, all history). + + Determines which type of node to run: `archive` (more storage, all history), `full` (less storage, only recent history), or `minimal` (smallest storage footprint). @@ -66,12 +58,12 @@ Open your `.env` file in an editor of your choice. The following values must be Selects which RPC provider is set in `OP_NODE__RPC_ENDPOINT`. This allows for more efficient syncing given different RPC capabilities. Choose from `alchemy`, `quicknode`, `erigon`, or `basic` for other RPC providers. - - Selects whether `op-geth` will use snap sync or full sync. Defaults to `snap` for non-archival nodes and `full` for archive nodes. + + Enables Flashblocks support for faster block propagation. - - Selects whether `op-geth` uses hash-based or path-based storage. As of `op-geth` v1.101602.0, path-based storage is supported for archive nodes and is enabled by default, leading to lower disk usage. The `eth_getProof` RPC method is not supported when using path-based storage. + + When set, downloads a snapshot to speed up initial sync instead of syncing from genesis. For details on additional settings, see the `simple-worldchain-node` [README](https://github.com/worldcoin-foundation/simple-worldchain-node?tab=readme-ov-file#optional-configurations). @@ -98,10 +90,7 @@ docker compose down ### Monitoring your node -A Grafana dashboard is included to monitor your node. Access it by visiting http://localhost:3000 and logging in with these credentials: - -- Username: `admin` -- Password: `worldchain` +A Grafana dashboard is included to monitor your node. Access it by visiting http://localhost:3000 — anonymous access is enabled by default, so no login is required. ### Upgrading your Node diff --git a/world-chain/reference/useful-contracts.mdx b/world-chain/reference/useful-contracts.mdx index 0a84d62..23fb3ba 100644 --- a/world-chain/reference/useful-contracts.mdx +++ b/world-chain/reference/useful-contracts.mdx @@ -59,7 +59,7 @@ title: "Useful Contract Deployments" ## World ID -You can find the World ID Address Book for all chains [here](https://docs.world.org/world-id/reference/address-book). +You can find the World ID Address Book for all chains [here](https://docs.world.org/mini-apps/reference/address-book). @@ -176,12 +176,6 @@ You can find the World ID Address Book for all chains [here](https://docs.world. [`0x75cf11467937ce3F2f357CE24ffc3DBF8fD5c226`](https://worldscan.org/address/0x75cf11467937ce3F2f357CE24ffc3DBF8fD5c226) - - - -
AddModules Helper - [`0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67`](https://worldscan.org/address/0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67) -
diff --git a/world-chain/tokens/superchain-token.mdx b/world-chain/tokens/superchain-token.mdx index 2dbee21..212b30e 100644 --- a/world-chain/tokens/superchain-token.mdx +++ b/world-chain/tokens/superchain-token.mdx @@ -10,12 +10,12 @@ title: "Superchain Token Bridging (Coming Soon)" The [Superchain token bridging standard](https://github.com/ethereum-optimism/specs/blob/main/specs/interop/token-bridging.md) (`SuperchainERC20`) is a set of properties and an interface designed to enable ERC20 tokens -to be fungible across the Superchain using the official `SuperchainERC20Bridge`. This standard builds -upon the existing [ERC20 token standard](https://docs.openzeppelin.com/contracts/4.x/erc20) and implements the `ICrosschainERC20` interface, which includes -two key properties: only allowing the `SuperchainERC20Bridge` to call `crosschainMint` and `crosschainBurn` functions, +to be fungible across the Superchain using the official `SuperchainTokenBridge`. This standard builds +upon the existing [ERC20 token standard](https://docs.openzeppelin.com/contracts/4.x/erc20) and implements the `IERC7802` interface, which includes +two key properties: only allowing the `SuperchainTokenBridge` to call `crosschainMint` and `crosschainBurn` functions, and ensuring the token is deployed at the same address on every chain in the Superchain. -The `SuperchainERC20Bridge` is a predeploy that works as an abstraction on top of the `L2ToL2CrossDomainMessenger` for token bridging. +The `SuperchainTokenBridge` is a predeploy that works as an abstraction on top of the `L2ToL2CrossDomainMessenger` for token bridging. It includes two main functions: `sendERC20`, which initiates a cross-chain transfer by burning tokens locally and sending a message to the target chain, and `relayERC20`, which processes incoming messages and mints the corresponding amount of tokens on the destination chain. This bridge utilizes the `L2ToL2CrossDomainMessenger` for replay protection, domain binding, and access to additional message information. From 9cbf23392bb47e0ec996f9b081aae9435a6cb4f6 Mon Sep 17 00:00:00 2001 From: Soam Desai Date: Mon, 21 Sep 2026 10:20:15 -0700 Subject: [PATCH 2/7] polish: tighten wording, match house style Trims verbose additions from the audit pass (fees, deploy/template forge create notes, EVM equivalence note, GovernanceToken table annotation) so they read at the same terseness as the surrounding docs. --- world-chain/developers/deploy.mdx | 2 +- world-chain/developers/evm-equivalence.mdx | 2 +- world-chain/developers/fees.mdx | 2 +- world-chain/developers/world-chain-contracts.mdx | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/world-chain/developers/deploy.mdx b/world-chain/developers/deploy.mdx index d14fd47..3302836 100644 --- a/world-chain/developers/deploy.mdx +++ b/world-chain/developers/deploy.mdx @@ -177,7 +177,7 @@ forge create src/HelloWorldChain.sol:HelloWorldChain \ ``` Here, we are using the `:` format to specify the contract. This tells Foundry where to find the contract file (`src/HelloWorldChain.sol`) and which contract within the file (HelloWorldChain) to deploy. -We also use the `--rpc-url` flag to specify the RPC URL of the World Chain Sepolia network and the `--private-key` flag to specify the private key of the wallet we generated earlier. Current versions of Foundry default `forge create` to a dry run, so the `--broadcast` flag is required to actually send the deployment transaction. +We also use the `--rpc-url` flag to specify the RPC URL of the World Chain Sepolia network and the `--private-key` flag to specify the private key of the wallet we generated earlier. The `--broadcast` flag is required because current versions of Foundry default `forge create` to a dry run. On top of this we can also provide other flags like `-vvvvv` to get more verbose output from the deployment process, `--verify` to verify the contract on [Worldscan](https://worldscan.org) or [Blockscout](https://worldchain-sepolia.explorer.alchemy.com/) (alongside with an `--etherscan-api-key` flag) and several other flags to toggle different features that you can find more about in the [Foundry documentation](https://book.getfoundry.sh/). diff --git a/world-chain/developers/evm-equivalence.mdx b/world-chain/developers/evm-equivalence.mdx index f2bdc50..3c8b146 100644 --- a/world-chain/developers/evm-equivalence.mdx +++ b/world-chain/developers/evm-equivalence.mdx @@ -17,7 +17,7 @@ ensuring a flexible yet consistent environment for developers and users alike. Though the EVM remains unchanged across OP Stack (Superchain) chains compared to the Ethereum layer 1, there are some configurations of the execution clients that do differ. -These parameters are on-chain configuration values that change over time (for example, as gas limits are raised). You can always find the current values in the [Superchain Registry](https://github.com/ethereum-optimism/superchain-registry/blob/main/superchain/configs/mainnet/worldchain.toml). +These are on-chain configuration values that change over time. You can always find the current values in the [Superchain Registry](https://github.com/ethereum-optimism/superchain-registry/blob/main/superchain/configs/mainnet/worldchain.toml). diff --git a/world-chain/developers/fees.mdx b/world-chain/developers/fees.mdx index 5489f46..5e718cb 100644 --- a/world-chain/developers/fees.mdx +++ b/world-chain/developers/fees.mdx @@ -5,7 +5,7 @@ description: "Understand World Chain fees: L2 execution vs L1 security costs, va "twitter:image": "https://raw.githubusercontent.com/worldcoin/developer-docs/main/images/docs/docs-meta.png" --- -Every World Chain transaction consists of two costs: an L2 (execution) fee and an L1 (security) fee. The L2 fee is the cost to execute your transaction on the L2, while the L1 fee covers the estimated cost of publishing the transaction on the L1. The relative size of each component varies over time as L1 data-posting costs and L2 network usage change; following the Ecotone upgrade's blob fees, the L2 execution fee is typically the larger of the two, though this can shift again with future protocol upgrades. +Every World Chain transaction consists of two costs: an L2 (execution) fee and an L1 (security) fee. The L2 fee is the cost to execute your transaction on the L2, while the L1 fee covers the estimated cost of publishing the transaction on the L1. The relative size of each fee shifts over time with L1 data-posting costs and L2 usage; since the Ecotone upgrade, the L2 execution fee is typically the larger of the two. The L1 fee fluctuates depending on the volume of transactions on the L1. If your transaction timing is flexible, you can save on costs by submitting during periods of lower gas fees on the L1 (for example, weekends) or using transaction-scheduling products which submit during periods of low demand. diff --git a/world-chain/developers/world-chain-contracts.mdx b/world-chain/developers/world-chain-contracts.mdx index bef8d7a..afaab0c 100644 --- a/world-chain/developers/world-chain-contracts.mdx +++ b/world-chain/developers/world-chain-contracts.mdx @@ -63,7 +63,7 @@ title: "World Chain Contracts" - + From 7f27606d577b73543bcdad49e76a9e1cf216842d Mon Sep 17 00:00:00 2001 From: Soam Desai Date: Mon, 21 Sep 2026 16:03:42 -0700 Subject: [PATCH 3/7] chore: add Hypercall/Flashblocks to cspell dictionary Fixes the spellcheck CI failure on this PR. --- cspell.json | 3 +++ 1 file changed, 3 insertions(+) diff --git a/cspell.json b/cspell.json index 61daf8c..b099e87 100644 --- a/cspell.json +++ b/cspell.json @@ -47,6 +47,8 @@ "ethersproject", "fdir", "fintech", + "FLASHBLOCKS", + "Flashblocks", "gatekept", "getenv", "gigagas", @@ -55,6 +57,7 @@ "Hackathon", "Hardfork", "Holdstation", + "Hypercall", "Hyperlane", "idkit", "IDKit", From 23c8e12c79f7d1080a3c0a1ec004d65982084155 Mon Sep 17 00:00:00 2001 From: Soam Desai Date: Mon, 21 Sep 2026 16:30:40 -0700 Subject: [PATCH 4/7] fix: correct World Chain / OP Mainnet EIP-1559 parameters Verified against the live superchain-registry configs and on-chain gas limits (both networks' Canyon denominator is 250, not the values previously stated): - World Chain: elasticity 22 -> 10, denominator 100 -> 250, derived gas target/max-base-fee-change values corrected accordingly (mainnet 280M/10=28M, Sepolia 480M/10=48M) - OP Mainnet: elasticity 2 -> 6, which was the actual source of the contradiction with its already-correct 2%/0.4% max-base-fee rows Addresses a Codex review comment on PR #196: the previous 22 vs. the Sepolia info.mdx figures were internally inconsistent, and 2 vs. OP Mainnet's own listed 2% base-fee increase didn't reconcile either. --- world-chain/developers/evm-equivalence.mdx | 12 ++++++------ world-chain/quick-start/info.mdx | 4 ++-- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/world-chain/developers/evm-equivalence.mdx b/world-chain/developers/evm-equivalence.mdx index 3c8b146..4ddbbda 100644 --- a/world-chain/developers/evm-equivalence.mdx +++ b/world-chain/developers/evm-equivalence.mdx @@ -43,19 +43,19 @@ do differ. - + - - + + - + @@ -63,7 +63,7 @@ do differ. - + @@ -71,7 +71,7 @@ do differ. - + diff --git a/world-chain/quick-start/info.mdx b/world-chain/quick-start/info.mdx index 390ef7b..5c9a33c 100644 --- a/world-chain/quick-start/info.mdx +++ b/world-chain/quick-start/info.mdx @@ -49,7 +49,7 @@ description: "World Chain network configuration and technical details" - + @@ -196,7 +196,7 @@ description: "World Chain network configuration and technical details" - + From acc47376e3d5f0f7caab32f6d4c5af1a210858df Mon Sep 17 00:00:00 2001 From: Soam Desai Date: Tue, 22 Sep 2026 18:47:20 -0700 Subject: [PATCH 5/7] docs(world-chain): align gas parameters with live configuration --- world-chain/developers/evm-equivalence.mdx | 24 ++++++++++++---------- world-chain/providers/bridges.mdx | 1 - world-chain/quick-start/info.mdx | 2 +- world-chain/reference/useful-contracts.mdx | 2 +- 4 files changed, 15 insertions(+), 14 deletions(-) diff --git a/world-chain/developers/evm-equivalence.mdx b/world-chain/developers/evm-equivalence.mdx index 4ddbbda..43f6c16 100644 --- a/world-chain/developers/evm-equivalence.mdx +++ b/world-chain/developers/evm-equivalence.mdx @@ -17,7 +17,7 @@ ensuring a flexible yet consistent environment for developers and users alike. Though the EVM remains unchanged across OP Stack (Superchain) chains compared to the Ethereum layer 1, there are some configurations of the execution clients that do differ. -These are on-chain configuration values that change over time. You can always find the current values in the [Superchain Registry](https://github.com/ethereum-optimism/superchain-registry/blob/main/superchain/configs/mainnet/worldchain.toml). +Values below were checked on September 22, 2026 and can change. For current OP Stack parameters, read the latest block's `gasLimit` and decode its `extraData` using the [block header specification](https://specs.optimism.io/protocol/jovian/exec-engine.html). The Superchain Registry records genesis and fork settings, which may differ from the current configuration.
[`0x420000000000000000000000000000000000001A`](https://worldscan.org/address/0x420000000000000000000000000000000000001A)
GovernanceToken (unused OP Stack scaffold predeploy — symbol `OP`, totalSupply 0; unrelated to WLD/Worldcoin governance)GovernanceToken (unused OP Stack predeploy — symbol `OP`, totalSupply 0; not WLD governance) [`0x4200000000000000000000000000000000000042`](https://worldscan.org/address/0x4200000000000000000000000000000000000042)
Block gas targetSee [Superchain Registry](https://github.com/ethereum-optimism/superchain-registry/blob/main/superchain/configs/mainnet/worldchain.toml)280,000,000 / 10 = 28,000,000 20,000,000 ~30,000,000
EIP-1559 elasticity multiplier222106 2
EIP-1559 denominator100250 250 8
Maximum base fee increase (per block) See [Superchain Registry](https://github.com/ethereum-optimism/superchain-registry/blob/main/superchain/configs/mainnet/worldchain.toml)3.6% 2% 12.5%
Maximum base fee decrease (per block) See [Superchain Registry](https://github.com/ethereum-optimism/superchain-registry/blob/main/superchain/configs/mainnet/worldchain.toml)0.4% 0.4% 12.5%
Gas Target140M28M
Block Time
Gas Target240M48M
Block Time
@@ -43,39 +43,41 @@ do differ. - + - - + + - + - - + + - - + +
Block gas target280,000,000 / 10 = 28,000,00012,727,272 (280,000,000 / 22, rounded down) 20,000,000 ~30,000,000
EIP-1559 elasticity multiplier106222 2
EIP-1559 denominator250100 250 8
- Maximum base fee increase (per block) + Nominal maximum base fee increase (per block) 3.6%2%~21%~0.4% 12.5%
- Maximum base fee decrease (per block) + Nominal maximum base fee decrease (per block) 0.4%0.4%~1%~0.4% 12.5%
+Fee changes are subject to integer rounding and the configured minimum base fee. World Chain's current minimum is 500,000 wei; the base fee cannot decrease below it. + For more information check out the [OP Stack docs](https://docs.optimism.io/stack/getting-started). diff --git a/world-chain/providers/bridges.mdx b/world-chain/providers/bridges.mdx index 2afdcee..18ade58 100644 --- a/world-chain/providers/bridges.mdx +++ b/world-chain/providers/bridges.mdx @@ -58,4 +58,3 @@ You can see World Chain-specific documentation for CCIP [here](https://docs.chai ### Thirdweb Universal Bridge Thirdweb's [Universal Bridge](https://portal.thirdweb.com/connect/pay/overview) is a comprehensive Web3 payment solution that allows your users to onramp, bridge, and swap on any EVM chain — with any EVM token or fiat — thanks to its automatic cross-chain routing. - diff --git a/world-chain/quick-start/info.mdx b/world-chain/quick-start/info.mdx index 5c9a33c..be22376 100644 --- a/world-chain/quick-start/info.mdx +++ b/world-chain/quick-start/info.mdx @@ -49,7 +49,7 @@ description: "World Chain network configuration and technical details" Gas Target - 28M + 12,727,272 (280M / 22, rounded down) Block Time diff --git a/world-chain/reference/useful-contracts.mdx b/world-chain/reference/useful-contracts.mdx index 23fb3ba..42665ce 100644 --- a/world-chain/reference/useful-contracts.mdx +++ b/world-chain/reference/useful-contracts.mdx @@ -59,7 +59,7 @@ title: "Useful Contract Deployments" ## World ID -You can find the World ID Address Book for all chains [here](https://docs.world.org/mini-apps/reference/address-book). +See the [World ID contract reference](/world-id/reference/contracts) for deployments across supported chains. From 9690741a14fcb0da2036711edddc08fffa0c4151 Mon Sep 17 00:00:00 2001 From: Soam Desai Date: Tue, 22 Sep 2026 18:49:39 -0700 Subject: [PATCH 6/7] docs(world-chain): link current World ID deployments guide --- world-chain/reference/useful-contracts.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/world-chain/reference/useful-contracts.mdx b/world-chain/reference/useful-contracts.mdx index 42665ce..db89901 100644 --- a/world-chain/reference/useful-contracts.mdx +++ b/world-chain/reference/useful-contracts.mdx @@ -59,7 +59,7 @@ title: "Useful Contract Deployments" ## World ID -See the [World ID contract reference](/world-id/reference/contracts) for deployments across supported chains. +See the [World ID on-chain verification guide](/world-id/idkit/onchain-verification) for deployments across supported chains.
From f05383d2c35c9ba3a281b68ccdcb2777d743f69b Mon Sep 17 00:00:00 2001 From: Soam Desai Date: Wed, 23 Sep 2026 14:56:03 -0700 Subject: [PATCH 7/7] docs(world-chain): address verification findings - template: pass --broadcast before the contract ID so --constructor-args does not swallow it; say the deploy targets the local fork - bridges: drop the incorrect Hypercall sentence and its cspell word - node-setup: L1_RPC_TYPE applies to L1_RPC_ENDPOINT; document the FLASHBLOCKS_ENABLED and DOWNLOAD_SNAPSHOT defaults; drop op-geth from the upgrade note - useful-contracts: relabel 0x091AD9...6cF6 as SwapRouter02; link the Address Book reference - world-chain-contracts: note on both GovernanceToken rows that tokens at this address are not OP or WLD - fees: attribute the larger L2 fee to the minimum L2 base fee - superchain-token: match the spec's non-exclusive caller wording - grants: link the reth-perf post directly --- cspell.json | 1 - world-chain/developers/fees.mdx | 2 +- world-chain/developers/grants.mdx | 2 +- world-chain/developers/template.mdx | 6 +++--- world-chain/developers/world-chain-contracts.mdx | 4 ++-- world-chain/providers/bridges.mdx | 2 +- world-chain/reference/node-setup.mdx | 8 ++++---- world-chain/reference/useful-contracts.mdx | 4 ++-- world-chain/tokens/superchain-token.mdx | 2 +- 9 files changed, 15 insertions(+), 16 deletions(-) diff --git a/cspell.json b/cspell.json index b099e87..e1c4ca7 100644 --- a/cspell.json +++ b/cspell.json @@ -57,7 +57,6 @@ "Hackathon", "Hardfork", "Holdstation", - "Hypercall", "Hyperlane", "idkit", "IDKit", diff --git a/world-chain/developers/fees.mdx b/world-chain/developers/fees.mdx index 5e718cb..91bd919 100644 --- a/world-chain/developers/fees.mdx +++ b/world-chain/developers/fees.mdx @@ -5,7 +5,7 @@ description: "Understand World Chain fees: L2 execution vs L1 security costs, va "twitter:image": "https://raw.githubusercontent.com/worldcoin/developer-docs/main/images/docs/docs-meta.png" --- -Every World Chain transaction consists of two costs: an L2 (execution) fee and an L1 (security) fee. The L2 fee is the cost to execute your transaction on the L2, while the L1 fee covers the estimated cost of publishing the transaction on the L1. The relative size of each fee shifts over time with L1 data-posting costs and L2 usage; since the Ecotone upgrade, the L2 execution fee is typically the larger of the two. +Every World Chain transaction consists of two costs: an L2 (execution) fee and an L1 (security) fee. The L2 fee is the cost to execute your transaction on the L2, while the L1 fee covers the estimated cost of publishing the transaction on the L1. The relative size of each fee shifts over time with L1 data-posting costs and L2 usage; on World Chain, the L2 execution fee is typically the larger of the two because the L2 base fee has a [configured minimum](/world-chain/developers/evm-equivalence). The L1 fee fluctuates depending on the volume of transactions on the L1. If your transaction timing is flexible, you can save on costs by submitting during periods of lower gas fees on the L1 (for example, weekends) or using transaction-scheduling products which submit during periods of low demand. diff --git a/world-chain/developers/grants.mdx b/world-chain/developers/grants.mdx index 2236f58..db7b030 100644 --- a/world-chain/developers/grants.mdx +++ b/world-chain/developers/grants.mdx @@ -13,7 +13,7 @@ you can read the [Continuous Grants program announcement blogpost](https://world ## Areas of interest for applications - Rustification of the [OP Stack](https://docs.optimism.io/stack/getting-started) -- Furthering [the gigagas roadmap](https://www.google.com/url?q=https://www.paradigm.xyz/2024/04/reth-perf&sa=D&source=editors&ust=1726507097184499&usg=AOvVaw34fUyrLcoigheJlrfbIDM2) +- Furthering [the gigagas roadmap](https://www.paradigm.xyz/writing/reth-perf) - ZK-ifying the OP Stack (efforts like [OP Succinct](https://blog.succinct.xyz/op-succinct/), Zeth from Risc0 and Mina's ZK fault proof RFP) - Scalability research and engineering (can be Ethereum core as well) - Embedding priority blockspace for humans into the OP Stack derivation pipeline + fault proof program (open R&D) diff --git a/world-chain/developers/template.mdx b/world-chain/developers/template.mdx index bc5cb10..3d59505 100644 --- a/world-chain/developers/template.mdx +++ b/world-chain/developers/template.mdx @@ -168,15 +168,15 @@ We also need to set three important environment variables that are required for - `NEXT_PUBLIC_APP_ID`: The app ID that was generated in the [Developer Portal](https://developer.worldcoin.org/login) - `NEXT_PUBLIC_ACTION`: The action ID as configured in the [Developer Portal](https://developer.worldcoin.org/login) -Once the fork is running, you can deploy the World ID template app to the World Chain Sepolia network using the Foundry CLI: +Once the fork is running, you can deploy the World ID template app to your local World Chain Sepolia fork using the Foundry CLI: ```bash # cd into the contracts directory cd contracts -forge create --rpc-url http://localhost:8545 --private-key 0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80 src/Contract.sol:Contract --constructor-args $WORLD_ID_ROUTER $NEXT_PUBLIC_APP_ID $NEXT_PUBLIC_ACTION --broadcast +forge create --rpc-url http://localhost:8545 --private-key 0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80 --broadcast src/Contract.sol:Contract --constructor-args $WORLD_ID_ROUTER $NEXT_PUBLIC_APP_ID $NEXT_PUBLIC_ACTION ``` -This command will deploy the `Contract` contract to the World Chain Sepolia network using the provided RPC URL and private key. The `--broadcast` flag is required because current versions of Foundry default `forge create` to a dry run. +This command will deploy the `Contract` contract to your local World Chain Sepolia fork using the provided RPC URL and private key. The `--broadcast` flag is required because current versions of Foundry default `forge create` to a dry run. ## Local Web Setup diff --git a/world-chain/developers/world-chain-contracts.mdx b/world-chain/developers/world-chain-contracts.mdx index afaab0c..82772c9 100644 --- a/world-chain/developers/world-chain-contracts.mdx +++ b/world-chain/developers/world-chain-contracts.mdx @@ -63,7 +63,7 @@ title: "World Chain Contracts" - + @@ -230,7 +230,7 @@ title: "World Chain Contracts" - + diff --git a/world-chain/providers/bridges.mdx b/world-chain/providers/bridges.mdx index 18ade58..7ac2c88 100644 --- a/world-chain/providers/bridges.mdx +++ b/world-chain/providers/bridges.mdx @@ -37,7 +37,7 @@ The next best method is to use the native Superchain bridge for which both Alche ### Synapse -[Synapse](https://hypercall.xyz/synapse) is a cross-chain communication protocol that enables seamless asset transfers and messaging across different blockchain networks. It provides a secure and efficient infrastructure for interoperability, allowing users to move tokens and data between various chains without the need for centralized intermediaries. Synapse's parent brand is now Hypercall. +[Synapse](https://hypercall.xyz/synapse) is a cross-chain communication protocol that enables seamless asset transfers and messaging across different blockchain networks. It provides a secure and efficient infrastructure for interoperability, allowing users to move tokens and data between various chains without the need for centralized intermediaries. ### Hyperlane diff --git a/world-chain/reference/node-setup.mdx b/world-chain/reference/node-setup.mdx index 0a3ea3f..877dcba 100644 --- a/world-chain/reference/node-setup.mdx +++ b/world-chain/reference/node-setup.mdx @@ -55,15 +55,15 @@ Open your `.env` file in an editor of your choice. The following values must be - Selects which RPC provider is set in `OP_NODE__RPC_ENDPOINT`. This allows for more efficient syncing given different RPC capabilities. Choose from `alchemy`, `quicknode`, `erigon`, or `basic` for other RPC providers. + Selects which RPC provider is set in `L1_RPC_ENDPOINT`. This allows for more efficient syncing given different RPC capabilities. Choose from `alchemy`, `quicknode`, `erigon`, or `basic` for other RPC providers. - Enables Flashblocks support for faster block propagation. + Enables Flashblocks support for faster block propagation. Defaults to `true`. - When set, downloads a snapshot to speed up initial sync instead of syncing from genesis. + Downloads a snapshot to speed up initial sync when the data directory is empty. Defaults to `true`; set to `false` to sync from genesis instead (not recommended). For details on additional settings, see the `simple-worldchain-node` [README](https://github.com/worldcoin-foundation/simple-worldchain-node?tab=readme-ov-file#optional-configurations). @@ -94,7 +94,7 @@ A Grafana dashboard is included to monitor your node. Access it by visiting http ### Upgrading your Node -When new versions of `op-geth`, `op-reth`, or `op-node` are released, we will update the `simple-worldchain-node` repository to use these new versions. You can then update your node to use these versions with the following commands: +When new versions of `world-chain` or `op-node` are released, we will update the `simple-worldchain-node` repository to use these new versions. You can then update your node to use these versions with the following commands: ```bash git pull diff --git a/world-chain/reference/useful-contracts.mdx b/world-chain/reference/useful-contracts.mdx index db89901..3685498 100644 --- a/world-chain/reference/useful-contracts.mdx +++ b/world-chain/reference/useful-contracts.mdx @@ -59,7 +59,7 @@ title: "Useful Contract Deployments" ## World ID -See the [World ID on-chain verification guide](/world-id/idkit/onchain-verification) for deployments across supported chains. +See the [World ID on-chain verification guide](/world-id/idkit/onchain-verification) for deployments across supported chains, and the [Address Book reference](/mini-apps/reference/address-book) for `WorldIDAddressBook`.
[`0x420000000000000000000000000000000000001A`](https://worldscan.org/address/0x420000000000000000000000000000000000001A)
GovernanceToken (unused OP Stack predeploy — symbol `OP`, totalSupply 0; not WLD governance)GovernanceToken (unused OP Stack predeploy, not WLD governance; despite its `OP` symbol, tokens at this address are not OP or WLD) [`0x4200000000000000000000000000000000000042`](https://worldscan.org/address/0x4200000000000000000000000000000000000042)
[`0x420000000000000000000000000000000000001A`](https://worldchain-sepolia.explorer.alchemy.com/address/0x420000000000000000000000000000000000001A)
GovernanceTokenGovernanceToken (unused OP Stack predeploy, not WLD governance; despite its `OP` symbol, tokens at this address are not OP or WLD) [`0x4200000000000000000000000000000000000042`](https://worldchain-sepolia.explorer.alchemy.com/address/0x4200000000000000000000000000000000000042)
@@ -204,7 +204,7 @@ See the [World ID on-chain verification guide](/world-id/idkit/onchain-verificat - + diff --git a/world-chain/tokens/superchain-token.mdx b/world-chain/tokens/superchain-token.mdx index 212b30e..b8fe425 100644 --- a/world-chain/tokens/superchain-token.mdx +++ b/world-chain/tokens/superchain-token.mdx @@ -12,7 +12,7 @@ title: "Superchain Token Bridging (Coming Soon)" The [Superchain token bridging standard](https://github.com/ethereum-optimism/specs/blob/main/specs/interop/token-bridging.md) (`SuperchainERC20`) is a set of properties and an interface designed to enable ERC20 tokens to be fungible across the Superchain using the official `SuperchainTokenBridge`. This standard builds upon the existing [ERC20 token standard](https://docs.openzeppelin.com/contracts/4.x/erc20) and implements the `IERC7802` interface, which includes -two key properties: only allowing the `SuperchainTokenBridge` to call `crosschainMint` and `crosschainBurn` functions, +two key properties: allowing the `SuperchainTokenBridge` to call `crosschainMint` and `crosschainBurn` functions (other callers may also be allowed), and ensuring the token is deployed at the same address on every chain in the Superchain. The `SuperchainTokenBridge` is a predeploy that works as an abstraction on top of the `L2ToL2CrossDomainMessenger` for token bridging.
AddModules HelperSwapRouter02 [`0x091AD9e2e6e5eD44c1c66dB50e49A601F9f36cF6`](https://worldscan.org/address/0x091AD9e2e6e5eD44c1c66dB50e49A601F9f36cF6)