用途:viem 是轻量级 TypeScript 库,对 Celo 有一等支持,驱动 wagmi 与 RainbowKit。适用于构建与 Celo 交互的 dApp、使用替代费用货币发送交易、读取合约状态与链上数据、签名消息与交易。
主要能力:提供 Celo 主网(celo,Chain ID 42220,RPC https://forno.celo.org,浏览器 https://celoscan.io)与 Celo Sepolia 测试网(celoSepolia,Chain ID 11142220,RPC https://forno.celo-sepolia.celo-testnet.org,浏览器 https://celo-sepolia.blockscout.com)链定义;支持用 defineChain 与 viem/celo 的 chainConfig 自定义链;提供公共客户端读取与钱包客户端写入;支持费用货币(feeCurrency)支付 gas,含主网与测试网 USDC/USDT 适配器地址;提供 viem/celo 的 parseTransaction、serializeTransaction 等 Celo 专用工具;支持 multicall 批量读取。
使用方式:安装 npm install viem。用 createPublicClient 读取余额与合约,用 createWalletClient 发送交易或 writeContract,并在参数中传入 feeCurrency 适配器地址以用 USDC 等支付 gas。Celo 专用工具从 viem/celo 导入。
限制与注意:费用货币交易使用 type 0x7b(CIP-64),会额外消耗约 50,000 gas;省略 feeCurrency 则默认用 CELO 支付;viem 是 Celo 推荐库,ethers.js 与 web3.js 不支持 feeCurrency。依赖 viem ^2.0.0。更多费用货币参考见资料中的 fee-currencies.md。