# Cosmos Documentation

> Build the future of the internet of blockchains with Cosmos.

## Docs

- [Ethereum JSON-RPC](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/api-reference/ethereum-json-rpc/index.md): The JSON-RPC server provides an API that allows you to connect to a Cosmos EVM-enabled blockchain and interact with the EVM. This gives you direct access to reading Ethereum-formatted transactions or sending them to the network.
- [Methods](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/api-reference/ethereum-json-rpc/methods.md): Find below a list of JSON-RPC methods supported on Cosmos EVM, sorted by namespaces.
- [JSON-RPC Explorer](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/api-reference/ethereum-json-rpc/rpc-explorer.md): Complete reference for Ethereum JSON-RPC methods supported on Cosmos EVM
- [Release Notes](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/changelog/release-notes.md): Release history and changelog for Cosmos EVM
- [Accounts](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/concepts/accounts.md): Crypto Wallets (or Accounts) can be created and represented in unique ways on different blockchains. For developers who interface with account types on a Cosmos EVM chain, e.g. during wallet integration on their dApp frontend, it is therefore important to understand that accounts in the Cosmos EVM a…
- [Chain ID](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/concepts/chain-id.md): Chain IDs are unique identifiers that distinguish blockchain networks from each other. Cosmos EVM uses a dual Chain ID system to maintain compatibility with both Cosmos SDK and Ethereum ecosystems.
- [EIP-1559 Fee Market](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/concepts/eip-1559-feemarket.md): Understanding dynamic fee pricing and the EIP-1559 mechanism in Cosmos EVM chains
- [Encoding](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/concepts/encoding.md): Encoding refers to the process of converting data from one format to another to make it more secure and efficient. In the context of blockchain, encoding is used to ensure that data is stored and transmitted in a way that is secure and easily accessible.
- [Gas and Fees](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/concepts/gas-and-fees.md): Users need to pay a fee to submit transactions on a Cosmos EVM-based blockchain. As fees are handled differently on Ethereum and Cosmos, it is important to understand how a Cosmos EVM blockchain implements an Ethereum-type fee calculation, that is compatible with the Cosmos SDK.
- [IBC](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/concepts/ibc.md): An Overview of the Inter-Blockchain Communication Protocol
- [Mempool](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/concepts/mempool.md): Design and Rationale
- [State Export/Import](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/concepts/migrations.md): Cosmos EVM can dump the entire application state to a JSON file. This, besides upgrades, can be useful for manual analysis of the state at a given height.
- [Overview](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/concepts/overview.md): Understanding how the EVM module provides Ethereum compatibility within the Cosmos SDK platform
- [Pending State](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/concepts/pending-state.md): When a transaction is submitted to the Ethereum network, it first goes into the pending status, waiting to be executed by the nodes. A transaction can be in the pending state for a longer duration if the gas price is set very low in the transaction and the nodes are busy processing other higher gas…
- [Performance Optimization](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/concepts/performance.md): Performance improvements and optimization techniques in Cosmos EVM v0.5.0
- [Precision Handling](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/concepts/precision-handling.md): Understanding decimal precision bridging between Cosmos and EVM
- [Predeployed Contracts](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/concepts/predeployed-contracts.md): Understanding predeployed contracts - what they are, why they're used, and how they differ from precompiles
- [EIP-155: Replay Protection](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/concepts/replay-protection.md): EIP-155 is an Ethereum Improvement Proposal that introduced replay protection by including chain ID information in signed transaction data. This prevents a signed transaction from being valid on multiple networks, protecting users from replay attacks.
- [Signing](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/concepts/signing.md): Signing is the process of creating a digital signature using a private key to verify a transaction on a blockchain. The signature is created using a specific cryptographic algorithm that ensures the authenticity and integrity of the transaction using methods like wallets and the CLI.
- [Single Token Representation](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/concepts/single-token-representation.md): Understanding unified token models across Cosmos and EVM ecosystems
- [Tokens](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/concepts/tokens.md): It is recommend to uses  for your base denomination to maintain parity with Ethereum. There are two types of assets to consider on a Cosmos EVM-based chain:
- [Transactions](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/concepts/transactions.md): A transaction refers to an action initiated by an account which changes the state of the blockchain. To effectively perform the state change, every transaction is broadcasted to the whole network. Any node can broadcast a request for a transaction to be executed on the blockchain state machine; afte…
- [Command Line Interface (CLI)](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/cosmos-sdk/cli.md): The CLI tool ('evmd') provides a full-feature interface for interacting with the blockchain. This includes commands for node operations, key management, querying blockchain state, submitting transactions, and more.
- [Erc20](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/cosmos-sdk/modules/erc20.md)
- [Feemarket](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/cosmos-sdk/modules/feemarket.md)
- [IBC](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/cosmos-sdk/modules/ibc.md): Inter-Blockchain Communication protocol implementation with EVM callbacks
- [Precisebank](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/cosmos-sdk/modules/precisebank.md)
- [Vm](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/cosmos-sdk/modules/vm.md)
- [Overview](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/cosmos-sdk/overview.md): Build application-specific blockchains with the modular Cosmos SDK framework.
- [Technical Architecture](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/cosmos-sdk/protocol.md): Cosmos EVM is a framework that allows you to add Ethereum Virtual Machine (EVM) compatibility to any Cosmos SDK-based chain. Built on the CometBFT consensus engine, it provides fast finality, high transaction throughput, and short block times (~2 seconds).
- [Custom Improvement Proposals](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/custom-improvement-proposals.md): Cosmos EVM allows protocol developers to register custom EIP activators that modify EVM behavior. This advanced feature enables chains to enable additional Ethereum Improvement Proposals or create chain-specific EVM modifications when needed.
- [EIP-2935: Historical Block Hash Storage](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/evm-compatibility/eip-2935.md): Implementation of EIP-2935 for reliable historical block hash access in smart contracts
- [EIP-7702: Set EOA Code](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/evm-compatibility/eip-7702.md): Implementation of EIP-7702 for enabling externally owned accounts to execute smart contract code temporarily
- [EIP Reference](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/evm-compatibility/eip-reference.md): A complete list of Ethereum Mainnet "Final" EIPs and details on their implementation with Cosmos-EVM
- [Overview](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/evm-compatibility/overview.md)
- [EVM Mempool Integration](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/getting-started/build-a-chain/additional-configuration/mempool-integration.md): Integrate the EVM mempool with your Cosmos EVM chain
- [Predeployed Contracts](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/getting-started/build-a-chain/additional-configuration/predeployed-contracts.md): Deploying and managing predeployed contracts
- [Introduction](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/getting-started/build-a-chain/overview.md)
- [Build A Custom EVM Chain](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/getting-started/build-a-chain/quick-start.md): Create your own blockchain by forking and customizing the Cosmos EVM reference chain (evmd). This guide covers the example chain configuration, running the chain locally, and understanding the foundation for building your custom network.
- [Using the Local Node](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/getting-started/build-a-chain/using-local-node.md): Learn how to run your Cosmos EVM chain locally for development and testing. This guide covers the local_node.sh script, configuration options, wallet connections, and key management.
- [Frequently Asked Questions](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/getting-started/faq.md)
- [Overview](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/getting-started/index.md): Start building with Cosmos EVM.
- [Block Explorers](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/getting-started/tooling-and-resources/block-explorers.md): Blockchain explorers allow users to query the blockchain for data. Explorers are often compared to search engines for the blockchain. By using an explorer, users can search and track balances, transactions, contracts, and other broadcast data to the blockchain.
- [Development Environment Setup](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/getting-started/tooling-and-resources/development-environment.md): A guide to setting up a local environment for Cosmos EVM development.
- [Foundry Guide - Setup & Walkthrough](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/getting-started/tooling-and-resources/foundry.md): An introduction to Foundry and using the `cast` function, replacing complex scripts that may otherwise require multiple rpc calls and other functions in between with a single command.
- [Hardhat Guide: Setup & Workflows](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/getting-started/tooling-and-resources/hardhat.md): A guide to setting up and using the Hardhat development environment for building, testing, and deploying on Cosmos EVM.
- [Overview](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/getting-started/tooling-and-resources/overview.md): Tooling and resources to 10x your development workflows.
- [Remix IDE](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/getting-started/tooling-and-resources/remix.md): Deploy and test smart contracts on Cosmos EVM chains using the Remix browser-based IDE
- [Popular Libraries for Development, Testing & Fuzzing](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/getting-started/tooling-and-resources/testing-and-fuzzing.md): Key frameworks, libraries, and practices for frontend development, wallet integration, smart contracts, testing and more.
- [Wallet Integration](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/getting-started/tooling-and-resources/wallet-integration.md): Wallet integration is an essential aspect of dApp development that allows users to securely interact with blockchain-based applications.
- [ERC20 Precompiles Migration](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/migrations/erc20-precompiles-migration.md): Migration for ERC20 precompiles when upgrading to v0.4.0
- [Migration: v0.3.0 to v0.4.0](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/migrations/migration-v0.3-to-v0.4.md)
- [Migration: v0.4.x to v0.5.0](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/migrations/migration-v0.4-to-v0.5.md)
- [Upgrade Handlers](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/migrations/upgrade-handlers.md): Understanding and performing coordinated chain upgrades
- [Overview](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/overview.md): Cosmos EVM is an open-source platform for teams building their own chain, rollup, or EVM-compatible application. It offers the industry's leading Layer 1 stack with custom modules, instant finality, and a native interoperability layer. With Cosmos EVM, you maintain full ownership of your entire stac…
- [Introduction](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/smart-contracts/introduction.md): Build and deploy EVM smart contracts on Cosmos chains with full Ethereum compatibility
- [Bank](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/smart-contracts/precompiles/bank.md): An ERC20 interface to native Cosmos SDK tokens for balance queries and supply information
- [Bech32](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/smart-contracts/precompiles/bech32.md): Address format conversion between Ethereum hex addresses and Cosmos bech32 addresses
- [Callbacks](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/smart-contracts/precompiles/callbacks.md): Interface for IBC packet lifecycle callbacks in smart contracts
- [Distribution](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/smart-contracts/precompiles/distribution.md): Withdraw staking rewards and interact with the community pool
- [ERC20](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/smart-contracts/precompiles/erc20.md): Standard ERC20 token functionality for native Cosmos tokens
- [Governance](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/smart-contracts/precompiles/governance.md): On-chain governance participation through proposal submission, voting, and governance query operations
- [ICS20](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/smart-contracts/precompiles/ics20.md): Cross-chain token transfers via IBC (Inter-Blockchain Communication) protocol
- [Precompiled Contracts](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/smart-contracts/precompiles/index.md): A hub for precompiled contracts that bridge EVM and Cosmos SDK modules.
- [Overview](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/smart-contracts/precompiles/overview.md): Precompiles are predefined functions that are integrated at the protocol level but exposed as EVM smart contract interfaces. Many precompiles provide access to Cosmos SDK module functionality for EVM applications and clients to easily leverage.
- [P256](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/smart-contracts/precompiles/p256.md): secp256r1 (P-256) signature verification precompile for WebAuthn and secure hardware
- [Slashing](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/smart-contracts/precompiles/slashing.md): Validator slashing and jail management for network security
- [Staking](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/smart-contracts/precompiles/staking.md): Validator operations, delegation management, and staking functionality
- [WERC20](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/smart-contracts/precompiles/werc20.md): Single token representation: An ERC20 interface for any token
- [Create2 Factory](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/smart-contracts/predeployed-contracts/create2.md): Deterministic contract deployment factory using the CREATE2 opcode
- [Multicall3](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/smart-contracts/predeployed-contracts/multicall3.md): Batch multiple contract calls in a single transaction for gas efficiency and atomicity
- [Overview](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/smart-contracts/predeployed-contracts/overview.md): Ready-to-use smart contracts deployed at predefined addresses
- [Permit2](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/smart-contracts/predeployed-contracts/permit2.md): Universal token approval and transfer management system with signature-based permissions
- [Safe Singleton Factory](https://cosmos-docs-selective-ibc-merge.mintlify.app/docs/evm/v0.5.0/documentation/smart-contracts/predeployed-contracts/safe-factory.md): Factory contract for deploying Safe multisig wallets at deterministic addresses