Linea是Consensys推出的零知识以太坊虚拟机网络，属于Type 2 zkEVM，也就是说它在字节码层面与以太坊EVM高度兼容。对于已经跑在以太坊或其他EVM链上的React应用来说，迁移到Linea的核心工作量不在智能合约，而在前端与链的交互层：网络配置、钱包连接、RPC端点、合约地址和Gas行为差异。本文将以一个典型的React加wagmi的DApp为例，完整走一遍迁移流程。
一、为什么Linea的zkEVM架构让迁移变简单
在动手改代码之前，先理解Linea的技术定位很重要。Linea采用Type 2 zkEVM设计，目标是与EVM在字节码层面完全等效。这意味着Solidity或Vyper编写的智能合约，编译后的字节码可以原封不动地部署到Linea上，开发工具链（Hardhat、Foundry）也基本可以直接复用。这与Type 3或更偏Optimistic的方案不同，后者往往需要对操作码做适配，甚至要替换部分预编译合约。
不过“等效”不等于“完全相同”。Linea对少数操作码和预编译合约的行为做了调整，例如某些与指数运算相关的成本模型有差异，极端情况下合约的Gas消耗会和以太坊主网略有出入。另外，Linea作为Rollup，交易最终确认依赖L1上的验证批次，这个异步的最终性模型也会影响前端的状态刷新策略。
React前端通常不直接触碰这些底层细节，但如果不理解这些差异，遇到交易长时间pending、Gas估算偏差时就会无从排查。带着这个认知去做迁移，思路会清晰很多。
二、网络配置与钱包连接改造
迁移的第一步是让MetaMask等钱包识别Linea网络。虽然MetaMask已经内置了Linea主网和测试网，但稳妥的做法是在代码中显式声明链配置，并在用户未添加网络时主动触发wallet_addEthereumChain。下面是Linea主网和Linea Sepolia测试网的关键参数。
export const lineaMainnet = {
chainId: 59144, // 十六进制为 0xe708
chainName: 'Linea',
rpcUrls: ['https://rpc.linea.build'],
nativeCurrency: { name: 'ETH', symbol: 'ETH', decimals: 18 },
blockExplorerUrls: ['https://lineascan.build'],
};
export const lineaSepolia = {
chainId: 148111, // 0x241e7，测试网
chainName: 'Linea Sepolia',
rpcUrls: ['https://rpc.sepolia.linea.build'],
nativeCurrency: { name: 'ETH', symbol: 'ETH', decimals: 18 },
blockExplorerUrls: ['https://sepolia.lineascan.build'],
};如果你的项目使用wagmi加viem的组合，推荐直接在WagmiConfig中注册Linea链对象。wagmi从v1开始内置了linea和lineaSepolia的链定义，直接从viem/chains导入即可，不需要手写Chain对象。改造时需要注意的一点是：切换链的体验设计。很多应用的做法是在检测到用户处于错误网络时弹出提示，引导用户调用switchChain，如果钱包中没有该链则fallback到添加网络的请求。
import { createConfig, http } from 'wagmi';
import { mainnet, linea, lineaSepolia } from 'wagmi/chains';
export const config = createConfig({
chains: [linea, lineaSepolia, mainnet],
transports: {
[linea.id]: http('https://rpc.linea.build'),
[lineaSepolia.id]: http('https://rpc.sepolia.linea.build'),
},
});对于还在用旧版ethers.js直连window.ethereum的项目，改造思路类似：监听chainChanged事件，在应用挂载时校验eth_chainId返回值是否为0xe708。一个常见的坑是chainId比较时类型不一致——有的钱包返回十六进制字符串，有的返回数字，务必统一处理。
三、合约部署与环境变量切换
智能合约层面几乎不用改动，但需要重新部署并更换前端引用的合约地址。推荐在.env文件中按环境区分地址，而不是硬编码在组件里。这样测试网与主网的切换只需要改变量，不碰代码。
# .env.development REACT_APP_CHAIN_ID=148111 REACT_APP_NFT_ADDRESS=0x测试网合约地址 # .env.production REACT_APP_CHAIN_ID=59144 REACT_APP_NFT_ADDRESS=0x主网合约地址
部署合约时，Hardhat用户只需在配置文件中新增一个network条目，指向Linea的RPC并填入私钥。建议同时保留OpenZeppelin Defender或多签作为主网合约的部署方式，避免私钥泄露风险。部署完成后，用Lineascan验证合约源码，这一步能极大方便后续调试。
有一个容易被忽略的细节：如果你的合约依赖Chainlink喂价或其他预言机，需要确认这些外部合约在Linea上是否有对应部署。Linea官方文档维护了主流基础设施的部署地址列表，迁移前逐项核对，能省掉大量运行时报错排查时间。
四、交易体验与最终性差异的应对
Linea作为ZK Rollup，交易被打包进批次，证明提交到L1后才算最终确认。这意味着前端不能照搬以太坊主网“出块即确认”的假设。实际开发中常见的处理方式是：在waitForTransactionReceipt时保持合理的超时，同时在UI上区分“已上链”和“已最终化”两个状态，用更友好的文案缓解用户等待焦虑。
Gas估算方面，Linea的费用结构与L1略有不同，包含L2执行费用和数据发布到L1的成本两部分。前端的Gas预估展示建议留出一定余量，或者在估算失败时降级为固定值加提示。此外，Linea在区块时间上比以太坊更快，轮询交易状态的间隔可以适当缩短，但要注意RPC限流，公共节点对请求频率有约束，生产环境建议使用Infura或Alchemy等提供的专用端点。
最后一步是端到端联调。建议先用Linea Sepolia走通完整流程，重点验证钱包切换、合约读写、事件监听和区块浏览器链接跳转。事件订阅在Rollup上偶尔会出现延迟，如果应用依赖实时事件更新UI，考虑加上手动刷新或定期重新拉取状态的兜底逻辑。这些都验证通过后，再切到主网环境变量发布，整个迁移就完成了。