Overview

Cosmos EVM 是一个开源的 Cosmos SDK 模块，可将完整的以太坊虚拟机嵌入基于 CometBFT 的链中。你可以部署现有的 Solidity 合约、使用标准 EVM 工具链，并启动一条具备瞬时终局性和原生跨链支持的主权 L1。 与 Rollup 不同，Cosmos EVM 链可以自行控制验证者集合、治理机制和手续费经济模型，同时完整保留 Ethereum 字节码与 JSON-RPC 兼容性。

​

你可以构建什么

Cosmos EVM 面向那些既希望获得完整 EVM 兼容性，又不愿放弃启动主权 L1 所带来优势的团队。你可以控制整套技术栈：EVM 执行环境、gas 模型、验证者集合、治理规则，以及需要纳入的 Cosmos SDK 模块。如果你已经在 Ethereum 或 EVM Rollup 上部署应用，那么迁移到 Cosmos EVM 链时无需修改合约。 链还可以运行许可型 EVM，通过将合约部署或调用限制为白名单地址，满足那些需要在协议层实施访问控制的使用场景。

​

EVM 等价性

你的链运行标准 Ethereum 字节码，行为方式与任何 Ethereum 网络一致：可使用 Hardhat、Foundry 或 Remix 部署 Solidity 合约；可连接 MetaMask 或任何 EVM 钱包；也可直接使用 ethers.js、viem 或 web3.js，无需修改。支持的工具列表请参见工具与资源页面。 Cosmos EVM 实现了完整的 Ethereum JSON-RPC API，并支持所有常见交易格式：EIP-155（链 ID 保护）、EIP-1559（动态手续费）、EIP-2930（访问列表）以及 EIP-7702（EOA 代码委托）。由于 Cosmos EVM 链是主权 L1 链，因此不支持 blob 交易这类 L2 特有特性（EIP-4844）以及其他面向 Rollup 的原语。

​

在 Ethereum 之上更进一步

如果你熟悉 Solidity，那么你已经知道如何在 Cosmos EVM 上构建应用。合约会以相同方式编译和部署，可用的操作码也完全一致，相同的库同样可用。不同之处在于，这里增加的是能力，而不是替代品。

• 瞬时终局性： 在 Ethereum 上，交易需要经过多个区块才能达到概率终局性。在 Cosmos EVM 上，交易通过 CometBFT 在一个区块后（约 1 到 2 秒）即完成终局确认，不存在链重组的可能。你的合约无需考虑 reorg。
• 手续费分配： 两者都使用 EIP-1559 动态手续费机制。Cosmos EVM 上的基础费不会被销毁，而是分配给验证者和委托人；对开发者来说手续费机制相同，但对链来说经济模型不同。
• 原生跨链： Cosmos EVM 不依赖外部桥接合约，而是在协议中内置了 IBC（跨链通信）。跨链代币转账是一项一等公民能力，并且可通过 IBC 预编译 从 Solidity 直接访问。
• 预编译合约： Cosmos EVM 将协议级功能以固定地址的预编译合约形式暴露出来。在 Solidity 中，你可以像调用任意其他合约一样调用质押、分发、治理、bank、IBC 转账（ICS-20）、slashing、vesting 以及地址转换工具。完整地址和接口列表请参见预编译参考。
• EIP-712 签名： MetaMask 和其他 EVM 钱包可以使用标准 eth_signTypedData 方法签名 Cosmos SDK 交易，包括治理投票、质押操作等。无需单独的 Cosmos 钱包。

​

快速开始

最快的入门方式是在本地运行示例链，整个过程不到 3 分钟，只需要 Go 和 Make。

---

Cosmos EVM is an open-source Cosmos SDK module that embeds a full Ethereum Virtual Machine into a CometBFT-based chain. Deploy existing Solidity contracts, use standard EVM tooling, and launch a sovereign L1 with instant finality and native cross-chain support. Unlike rollups, Cosmos EVM chains control their own validator set, governance, and fee economics, all while preserving full Ethereum bytecode and JSON-RPC compatibility.

​

What you can build

Cosmos EVM is for teams that want full EVM compatibility without giving up the benefits of launching a sovereign L1. You control the entire stack: the EVM execution environment, gas model, validator set, governance rules, and which Cosmos SDK modules to include. If you already deploy to Ethereum or EVM rollups, you can deploy to a Cosmos EVM chain with no contract changes. Chains can also run a permissioned EVM, restricting contract deployment or calls to whitelisted addresses for use cases that require access controls at the protocol level.

​

EVM Equivalent

Your chain runs standard Ethereum bytecode and behaves like any Ethereum network: deploy Solidity contracts with Hardhat, Foundry, or Remix; connect MetaMask or any EVM wallet; use ethers.js, viem, or web3.js without changes. See the tooling and resources page for a list of supported tools. Cosmos EVM implements the full Ethereum JSON-RPC API and supports all common transaction formats: EIP-155 (chain ID protection), EIP-1559 (dynamic fees), EIP-2930 (access lists), and EIP-7702 (EOA code delegation). Because Cosmos EVM chains are sovereign L1 chains, they do not support L2-specific features like blob transactions (EIP-4844) and other rollup-oriented primitives.

​

Ethereum with more

If you know Solidity, you already know how to build on Cosmos EVM. Contracts compile and deploy the same way, the same opcodes are available, and the same libraries work. The differences are additions, not substitutions.

• Instant finality: On Ethereum, transactions reach probabilistic finality over multiple blocks. On Cosmos EVM, transactions are final after one block (~1-2 seconds) via CometBFT with no possibility of reorganization. Your contracts do not need to account for reorgs.
• Fee distribution: Both use EIP-1559 dynamic fees. The base fee on Cosmos EVM is distributed to validators and delegators rather than burned, the same fee mechanics for the developer with different economics for the chain.
• Native cross-chain: Rather than relying on external bridge contracts, Cosmos EVM has IBC (Inter-Blockchain Communication) built into the protocol. Cross-chain token transfers are a first-class feature, accessible from Solidity via the IBC precompile.
• Precompiles: Cosmos EVM exposes protocol-level functionality as precompiled contracts at fixed addresses. From Solidity, you can call into staking, distribution, governance, bank, IBC transfers (ICS-20), slashing, vesting, and address conversion utilities the same way you would call any other contract. See the precompiles reference for the full list of addresses and interfaces.
• EIP-712 signing: MetaMask and other EVM wallets can sign Cosmos SDK transactions, including governance votes and staking operations, using the standard eth_signTypedData method. No separate Cosmos wallet is required.

​

Getting started

The quickest way to get started is running the example chain locally. It takes less than 3 minutes and requires only Go and Make.