# Cosmos Docs

> Developer documentation for the Cosmos stack. Build secure, reliable, and high-performance blockchains.

## Home

- [Cosmos Developer Documentation](https://docs.cosmos.network/index.md)

- [Cosmos SDK (442 pages)](https://docs.cosmos.network/_llms/cosmos-sdk.md): Documentation for Cosmos SDK.

## Cosmos EVM

### v0.7.0

#### Documentation

##### About

- [Overview](https://docs.cosmos.network/evm/latest/documentation/overview.md)
- [EVM Compatibility](https://docs.cosmos.network/evm/latest/documentation/evm-compatibility.md)
- [Frequently Asked Questions](https://docs.cosmos.network/evm/latest/documentation/getting-started/faq.md)

##### Build

- [Run an EVM Chain](https://docs.cosmos.network/evm/latest/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.
- [Tooling & Resources](https://docs.cosmos.network/evm/latest/documentation/getting-started/tooling-and-resources.md): Tools, libraries, wallets, and explorers for building on Cosmos EVM.

###### Additional Configuration

- [Mempool Configuration](https://docs.cosmos.network/evm/latest/documentation/getting-started/build-a-chain/additional-configuration/mempool-integration.md): Customize the EVM mempool behavior on your Cosmos EVM chain.
- [Predeployed Contracts](https://docs.cosmos.network/evm/latest/documentation/getting-started/build-a-chain/additional-configuration/predeployed-contracts.md): Deploy standard EVM contracts at fixed addresses on your Cosmos EVM chain.
- [Precompile Configuration](https://docs.cosmos.network/evm/latest/documentation/getting-started/build-a-chain/additional-configuration/precompiles.md): Choose which precompiles are active on your chain and add custom ones.
- [Node Configuration](https://docs.cosmos.network/evm/latest/documentation/getting-started/network-operators/node-configuration.md): Complete reference for configuring Cosmos EVM nodes, JSON-RPC settings, and command-line options

##### Learn

###### Concepts

- [Overview](https://docs.cosmos.network/evm/latest/documentation/concepts/overview.md): Understanding how the EVM module provides Ethereum compatibility within the Cosmos SDK platform
- [Accounts](https://docs.cosmos.network/evm/latest/documentation/concepts/accounts.md): Cosmos EVM accounts are implemented to be compatible with Ethereum type addresses
- [Chain ID](https://docs.cosmos.network/evm/latest/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.
- [Encoding](https://docs.cosmos.network/evm/latest/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://docs.cosmos.network/evm/latest/documentation/concepts/gas-and-fees.md): Fee calculation and gas metering in Cosmos EVM
- [IBC](https://docs.cosmos.network/evm/latest/documentation/concepts/ibc.md): An Overview of the Inter-Blockchain Communication Protocol
- [Mempool](https://docs.cosmos.network/evm/latest/documentation/concepts/mempool.md): Design and Rationale
- [State Export/Import](https://docs.cosmos.network/evm/latest/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.
- [Pending State](https://docs.cosmos.network/evm/latest/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…
- [EIP-155: Replay Protection](https://docs.cosmos.network/evm/latest/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://docs.cosmos.network/evm/latest/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://docs.cosmos.network/evm/latest/documentation/concepts/single-token-representation.md): Unified token model across Cosmos and EVM ecosystems
- [Tokens](https://docs.cosmos.network/evm/latest/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://docs.cosmos.network/evm/latest/documentation/concepts/transactions.md): Transaction types and lifecycle in Cosmos EVM
- [EIP-1559 Fee Market](https://docs.cosmos.network/evm/latest/documentation/concepts/eip-1559-feemarket.md): Understanding dynamic fee pricing and the EIP-1559 mechanism in Cosmos EVM chains

###### Precompiles

- [Overview](https://docs.cosmos.network/evm/latest/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.
- [Bank](https://docs.cosmos.network/evm/latest/documentation/smart-contracts/precompiles/bank.md): An ERC20 interface to native Cosmos SDK tokens for balance queries and supply information
- [Bech32](https://docs.cosmos.network/evm/latest/documentation/smart-contracts/precompiles/bech32.md): Address format conversion between Ethereum hex addresses and Cosmos bech32 addresses
- [Callbacks](https://docs.cosmos.network/evm/latest/documentation/smart-contracts/precompiles/callbacks.md): Interface for IBC packet lifecycle callbacks in smart contracts
- [Distribution](https://docs.cosmos.network/evm/latest/documentation/smart-contracts/precompiles/distribution.md): Withdraw staking rewards and interact with the community pool
- [ERC20](https://docs.cosmos.network/evm/latest/documentation/smart-contracts/precompiles/erc20.md): Standard ERC20 token functionality for native Cosmos tokens
- [Governance](https://docs.cosmos.network/evm/latest/documentation/smart-contracts/precompiles/governance.md): On-chain governance participation through proposal submission, voting, and governance query operations
- [ICS20](https://docs.cosmos.network/evm/latest/documentation/smart-contracts/precompiles/ics20.md): Cross-chain token transfers via IBC (Inter-Blockchain Communication) protocol
- [P256](https://docs.cosmos.network/evm/latest/documentation/smart-contracts/precompiles/p256.md): secp256r1 (P-256) signature verification precompile for WebAuthn and secure hardware
- [Slashing](https://docs.cosmos.network/evm/latest/documentation/smart-contracts/precompiles/slashing.md): Validator slashing and jail management for network security
- [Staking](https://docs.cosmos.network/evm/latest/documentation/smart-contracts/precompiles/staking.md): Validator operations, delegation management, and staking functionality
- [WERC20](https://docs.cosmos.network/evm/latest/documentation/smart-contracts/precompiles/werc20.md): Single token representation: An ERC20 interface for any token

###### Cosmos SDK

- [Overview](https://docs.cosmos.network/evm/latest/documentation/cosmos-sdk/overview.md): Build application-specific blockchains with the modular Cosmos SDK framework.
- [Command Line Interface (CLI)](https://docs.cosmos.network/evm/latest/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.
- [Technical Architecture](https://docs.cosmos.network/evm/latest/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).

###### Modules

- [ERC20](https://docs.cosmos.network/evm/latest/documentation/cosmos-sdk/modules/erc20.md): ERC-20 token representation and conversion for native Cosmos tokens
- [Fee Market](https://docs.cosmos.network/evm/latest/documentation/cosmos-sdk/modules/feemarket.md): EIP-1559 dynamic fee pricing for EVM transactions
- [IBC](https://docs.cosmos.network/evm/latest/documentation/cosmos-sdk/modules/ibc.md): Inter-Blockchain Communication protocol implementation with EVM callbacks
- [PreciseBank](https://docs.cosmos.network/evm/latest/documentation/cosmos-sdk/modules/precisebank.md): High-precision bank module for 18-decimal EVM token accounting
- [VM](https://docs.cosmos.network/evm/latest/documentation/cosmos-sdk/modules/vm.md): Core EVM implementation for Ethereum compatibility on Cosmos chains

##### Migrations

- [Migration: v0.6.0 to v0.7.0](https://docs.cosmos.network/evm/latest/documentation/migrations/migration-v0.6-to-v0.7.md)
- [Migrating off x/precisebank: Gas Converter Precompile](https://docs.cosmos.network/evm/latest/documentation/migrations/gas-converter-migration.md): Run an 18-decimal gas token alongside a 6-decimal staking denom using a converter precompile, replacing the deprecated x/precisebank module.

###### Previous Versions

- [Migration: v0.4.x to v0.5.0](https://docs.cosmos.network/evm/latest/documentation/migrations/migration-v0.4-to-v0.5.md)
- [Migration: v0.3.0 to v0.4.0](https://docs.cosmos.network/evm/latest/documentation/migrations/migration-v0.3-to-v0.4.md)
- [Migration: v0.5.0 to v0.6.0](https://docs.cosmos.network/evm/latest/documentation/migrations/migration-v0.5-to-v0.6.md)
- [ERC20 Precompiles Migration](https://docs.cosmos.network/evm/latest/documentation/migrations/erc20-precompiles-migration.md): Migration for ERC20 precompiles when upgrading to v0.4.0

###### Advanced

- [Upgrade Handlers](https://docs.cosmos.network/evm/latest/documentation/migrations/upgrade-handlers.md): Understanding and performing coordinated chain upgrades
- [Custom Improvement Proposals](https://docs.cosmos.network/evm/latest/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.
- [Adding EVM to an Existing Chain](https://docs.cosmos.network/evm/latest/documentation/migrations/add-evm-to-existing-chain.md): Guide for integrating the EVM module into a running Cosmos chain post-genesis

#### API Reference

- [Ethereum JSON-RPC](https://docs.cosmos.network/evm/latest/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://docs.cosmos.network/evm/latest/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://docs.cosmos.network/evm/latest/api-reference/ethereum-json-rpc/rpc-explorer.md): Complete reference for Ethereum JSON-RPC methods supported on Cosmos EVM

#### Changelog

- [Changelog](https://docs.cosmos.network/evm/latest/changelog/release-notes.md): Release history and changelog for Cosmos EVM

- [IBC Protocol (192 pages)](https://docs.cosmos.network/_llms/ibc-protocol.md): Documentation for IBC Protocol.
- [CometBFT (202 pages)](https://docs.cosmos.network/_llms/comet-bft.md): Documentation for CometBFT.

## Skip Go

### Documentation

#### General API Docs

- [Introduction](https://docs.cosmos.network/skip-go/general/getting-started.md): This pages explains what the Skip Go API is, gives examples of applications built with it, and provides guidance on standard ways to use it.
- [Quickstart Guide](https://docs.cosmos.network/skip-go/general/quickstart-guide.md): This guide walks you through the process of setting up and using the Skip Go Client to perform a cross-chain from USDC on Noble to TIA on Celestia.
- [Overview & Common Usage Patterns](https://docs.cosmos.network/skip-go/general/overview-and-typical-usage.md)
- [Supported Ecosystems](https://docs.cosmos.network/skip-go/general/supported-ecosystems-and-bridges.md)
- [Transaction Tracking](https://docs.cosmos.network/skip-go/general/multi-chain-realtime-transaction-and-packet-tracking.md): This document covers the tooling provided in Skip Go for tracking transaction status across multiple chains and bridge hops.
- [Skip Explorer Integration](https://docs.cosmos.network/skip-go/general/explorer-integration.md): Guide to integrating Skip Explorer v2 for transaction visualization and tracking in your applications.
- [Requesting & Using API Keys](https://docs.cosmos.network/skip-go/general/api-keys.md)
- [Smart Relay](https://docs.cosmos.network/skip-go/general/smart-relay.md): This page covers Smart Relay -- Skip Go API's universal cross-chain data & token delivery service
- [Post-Route Actions](https://docs.cosmos.network/skip-go/general/post-route-actions.md): How to specify actions to perform after a route of transfers/swaps is completed
- [Setting Affiliate Fees](https://docs.cosmos.network/skip-go/general/affiliate-fees.md): This page covers how integrators can earn affiliate fees on swaps.
- [Getting Fee Info](https://docs.cosmos.network/skip-go/general/fee-info.md): Understand how Skip Go handles user-facing fees
- [Transaction Support](https://docs.cosmos.network/skip-go/general/transaction-support.md)
- [FAQ](https://docs.cosmos.network/skip-go/general/faq.md)

#### Skip Go Widget

- [Getting Started](https://docs.cosmos.network/skip-go/widget/getting-started.md)
- [Configuration](https://docs.cosmos.network/skip-go/widget/configuration.md): This page details your widget configuration options. Tweak it to fit your exact user experience needs!
- [Gas on Receive](https://docs.cosmos.network/skip-go/widget/gas-on-receive.md): Automatically provide users with gas tokens on destination chains during cross-chain swaps
- [Web Component](https://docs.cosmos.network/skip-go/widget/web-component.md)
- [Migration Guide](https://docs.cosmos.network/skip-go/widget/migration-guide.md)
- [FAQ](https://docs.cosmos.network/skip-go/widget/faq.md)

#### Skip Go Client

- [Getting Started](https://docs.cosmos.network/skip-go/client/getting-started.md): @skip-go/client is a TypeScript library that streamlines interaction with the Skip Go API, enabling cross-chain swaps and transfers across multiple ecosystems.
- [Balances, Gas and Transaction Fee Utilities](https://docs.cosmos.network/skip-go/client/balance-gas-and-fee-tooling.md): This page details the utility functions for token balances, gas calculations, and transaction fees in Skip Go.
- [Executing a route](https://docs.cosmos.network/skip-go/client/executing-a-route.md): This page documents the executeRoute function, used to execute a token transfer/swap using a route from /v2/fungible/route API
- [Gas on Receive with Custom Frontends](https://docs.cosmos.network/skip-go/client/gas-on-receive.md): Implement Gas on Receive functionality in your custom frontend using the Skip Go Client Library
- [Advanced Features](https://docs.cosmos.network/skip-go/client/advanced-features.md): This page details advanced features and utilities in the Skip Go client library.
- [Migration Guide](https://docs.cosmos.network/skip-go/client/migration-guide.md)

#### Advanced Transfer

- [Cross-chain Failure Cases](https://docs.cosmos.network/skip-go/advanced-transfer/handling-cross-chain-failure-cases.md): This page covers the different ways our cross-chain swaps + transfers might fail to help identify failures and manage user expectations
- [Interpreting Transaction & Transfer Status](https://docs.cosmos.network/skip-go/advanced-transfer/interpreting-transaction-status.md): Learn how to interpret the status of transactions and individual transfer steps from the Skip Go API's /v2/tx/status endpoint to provide accurate feedback to users.
- [IBC Token Routing: Problem + Skip Go API Routing Algorithm](https://docs.cosmos.network/skip-go/advanced-transfer/ibc-routing-algorithm.md): This page describes the IBC token routing problem and the algorithm Skip Go API uses to select / recommend token denoms and IBC paths
- [EVM Transactions](https://docs.cosmos.network/skip-go/advanced-transfer/evm-transactions.md): This doc covers how to interact with the EvmTx type returned by the Skip Go API
- [SVM Transactions](https://docs.cosmos.network/skip-go/advanced-transfer/svm-transaction-details.md): This document explains how to use Skip Go API and Client TypeScript Package to construct SVM transactions.
- [CW20 Tokens & Their Limitations](https://docs.cosmos.network/skip-go/advanced-transfer/cw20-swaps.md): Information about performing CW20 swaps
- [Experimental Features](https://docs.cosmos.network/skip-go/advanced-transfer/experimental-features.md): This page provides a living record of the features that can be turned on with the experimental_features flag
- [Go Fast](https://docs.cosmos.network/skip-go/advanced-transfer/go-fast.md): A brief overview of the Go Fast Transfer system

#### Advanced Swapping

- [Understanding Quote Quality Metrics](https://docs.cosmos.network/skip-go/advanced-swapping/understanding-quote-quality-metrics.md): This doc covers the various ways route quote quality is measured -- slippage, USD estimates of the amount in and out, and price impact
- [`allow_unsafe`: Preventing & Handling Bad Execution](https://docs.cosmos.network/skip-go/advanced-swapping/allow_unsafe-preventing-handling-bad-execution.md)
- [SAFE Swapping: How to Protect Users from Bad Trades](https://docs.cosmos.network/skip-go/advanced-swapping/safe-swapping-how-to-protect-users-from-harming-themselves.md)
- [Smart Swap](https://docs.cosmos.network/skip-go/advanced-swapping/smart-swap-options.md): This page introduces the Smart Swap functionality provided by the Skip Go API to improve swap speed, price, and customization.

#### Support Requirements

- [Chain Support Requirements](https://docs.cosmos.network/skip-go/support-requirements/chain-support-requirements.md): This document describes what new chains need to do the support Skip Go API
- [Token & Route Support Requirements](https://docs.cosmos.network/skip-go/support-requirements/token-support-requirements.md): This document describes the steps you must complete for the Skip Go API to begin providing new routes for users to transfer a token over to various remote chains using IBC.
- [Skip Go Asset Registry & Overrides](https://docs.cosmos.network/skip-go/support-requirements/asset-registry-overrides.md)
- [Swap Venue Requirements](https://docs.cosmos.network/skip-go/support-requirements/swap-venue-requirements.md): This document covers what Skip Go API requires of DEXes to support them as potential swapping venues within the API's cross-chain DEX aggregation functionality. At the end, the document provides instructions for helping the Skip team add your DEX to the API as a swapping venue
- [Chain Integration Request](https://docs.cosmos.network/skip-go/support-requirements/chain-integration-request.md)

#### Eureka

- [Overview](https://docs.cosmos.network/skip-go/eureka/eureka-overview.md): An overview of IBC Eureka for developers
- [Technical Overview](https://docs.cosmos.network/skip-go/eureka/eureka-tech-overview.md): Technical details of how IBC Eureka works
- [Integration Guide](https://docs.cosmos.network/skip-go/eureka/integration-guide.md): A guide on how to integrate IBC Eureka for chain developers, asset issuers, and application developers
- [Custom ERC20 Integration](https://docs.cosmos.network/skip-go/eureka/custom-erc20-integration.md): A guide for asset issuers to deploy and register custom ERC20 contracts for their tokens on Ethereum
- [Security Properties](https://docs.cosmos.network/skip-go/eureka/security-properties.md)
- [Contract Addresses](https://docs.cosmos.network/skip-go/eureka/contract-addresses.md): Key contract addresses for the IBC Eureka deployment.

### API Reference

#### Prod Endpoints

##### Info

- [Get /v2/info/chains](https://docs.cosmos.network/skip-go/api-reference/prod/info/get-v2infochains.md): Get all supported chains along with additional data useful for building applications + frontends that interface with them (e.g. logo URI, IBC capabilities, fee assets, bech32 prefix, etc...)
- [Get /v2/info/bridges](https://docs.cosmos.network/skip-go/api-reference/prod/info/get-v2infobridges.md): Get all supported bridges
- [Post /v2/info/balances](https://docs.cosmos.network/skip-go/api-reference/prod/info/post-v2infobalances.md): Get the balances of a given set of assets on a given chain and wallet address. Compatible with all Skip Go-supported assets, excluding CW20 assets, across SVM, EVM, and Cosmos chains.

##### Fungible

- [Get /v2/fungible/venues](https://docs.cosmos.network/skip-go/api-reference/prod/fungible/get-v2fungiblevenues.md): Get supported swap venues.
- [Get /v2/fungible/assets](https://docs.cosmos.network/skip-go/api-reference/prod/fungible/get-v2fungibleassets.md): Get supported assets. Optionally limit to assets on a given chain and/or native assets.
- [Post /v2/fungible/assets_from_source](https://docs.cosmos.network/skip-go/api-reference/prod/fungible/post-v2fungibleassets_from_source.md): Get assets that can be reached from a source via transfers under different conditions (e.g. single vs multiple txs)
- [Post /v2/fungible/route](https://docs.cosmos.network/skip-go/api-reference/prod/fungible/post-v2fungibleroute.md): This supports cross-chain actions among EVM chains, Cosmos chains, and between them. Returns the sequence of transfers and/or swaps to reach the given destination asset from the given source asset, along with estimated amount out. Commonly called before /msgs to generate route info and quote.
- [Post /v2/fungible/msgs](https://docs.cosmos.network/skip-go/api-reference/prod/fungible/post-v2fungiblemsgs.md): This supports cross-chain actions among EVM chains, Cosmos chains, and between them. Returns minimal number of messages required to execute a multi-chain swap or transfer. Input consists of the output of route with additional information required for message construction (e.g. destination addresses…
- [Post /v2/fungible/msgs_direct](https://docs.cosmos.network/skip-go/api-reference/prod/fungible/post-v2fungiblemsgs_direct.md): This supports cross-chain actions among EVM chains, Cosmos chains, and between them. Returns minimal number of messages required to execute a multi-chain swap or transfer. This is a convenience endpoint that combines /route and /msgs into a single call.
- [Post /v2/fungible/ibc_origin_assets](https://docs.cosmos.network/skip-go/api-reference/prod/fungible/post-v2fungibleibc_origin_assets.md): Get origin assets from a given list of denoms and chain IDs.
- [Post /v2/fungible/assets_between_chains](https://docs.cosmos.network/skip-go/api-reference/prod/fungible/post-v2fungibleassets_between_chains.md): Given 2 chain IDs, returns a list of equivalent assets that can be transferred

##### Transaction

- [Post /v2/tx/submit](https://docs.cosmos.network/skip-go/api-reference/prod/transaction/post-v2txsubmit.md): Submit a signed base64 encoded transaction to be broadcast to the specified network. On successful submission, the status of the transaction and any subsequent IBC or Axelar transfers can be queried through the /status endpoint.
- [Post /v2/tx/track](https://docs.cosmos.network/skip-go/api-reference/prod/transaction/post-v2txtrack.md): Requests tracking of a transaction that has already landed on-chain but was not broadcast through the Skip Go API. The status of a tracked transaction and subsequent IBC or Axelar transfers if routing assets cross chain can be queried through the /status endpoint.
- [Get /v2/tx/status](https://docs.cosmos.network/skip-go/api-reference/prod/transaction/get-v2txstatus.md): Get the status of the specified transaction and any subsequent IBC or Axelar transfers if routing assets cross chain. The transaction must have previously been submitted to either the /submit or /track endpoints.

#### Reference Guides

- [API Error Codes & Status Messages](https://docs.cosmos.network/skip-go/api-reference/error-codes.md): Reference for error codes and status messages returned by the Skip Go API, including transaction, bridge, and packet-specific statuses.

## Cosmos Hub

### Latest

#### Documentation

##### Cosmos Hub

- [Introduction](https://docs.cosmos.network/hub/latest/index.md): Welcome to the Cosmos Hub

###### Getting Started

- [Getting Started](https://docs.cosmos.network/hub/latest/getting-started/README.md): This folder contains tutorials related to the gaia application.
- [What is Gaia?](https://docs.cosmos.network/hub/latest/getting-started/what-is-gaia.md): The Cosmos Hub is a public Proof-of-Stake chain that uses ATOM as its native staking token. It is the first blockchain launched in the Cosmos Network and developed using the cosmos-sdk development framework and ibc-go.
- [Installing Gaia](https://docs.cosmos.network/hub/latest/getting-started/installation.md): This guide will explain how to install the gaiad binary and run the cli. With this binary installed on a server, you can participate on the mainnet as either a Full Node or a Validator.
- [Quick Start - Join Mainnet](https://docs.cosmos.network/hub/latest/getting-started/quickstart.md): Bootstrap a cosmoshub-4 mainnet node
- [System requirements](https://docs.cosmos.network/hub/latest/getting-started/system-requirements.md)

###### Hub Tutorials

- [Interacting with Gaiad (CLI)](https://docs.cosmos.network/hub/latest/hub-tutorials/gaiad.md)
- [Joining Mainnet](https://docs.cosmos.network/hub/latest/hub-tutorials/join-mainnet.md)
- [Joining Testnet](https://docs.cosmos.network/hub/latest/hub-tutorials/join-testnet.md): Visit the testnets repo for the most up-to-date information on the currently available public testnets:
- [Upgrading the Chain](https://docs.cosmos.network/hub/latest/hub-tutorials/live-upgrade-tutorial.md): This document demonstrates how a live upgrade can be performed on-chain through a governance process.
- [Gaia Tutorials](https://docs.cosmos.network/hub/latest/hub-tutorials/README.md): This folder contains tutorials related to the gaiad application.
- [Upgrading Your Node](https://docs.cosmos.network/hub/latest/hub-tutorials/upgrade-node.md): This document describes the upgrade procedure of a gaiad full-node to a new version.

###### Validators

- [Validator Overview](https://docs.cosmos.network/hub/latest/validators/overview.md)
- [Validators](https://docs.cosmos.network/hub/latest/validators/README.md): This folder contains documentation relevant to validators of the Cosmos Hub and other gaia blockchains.
- [Validator Security](https://docs.cosmos.network/hub/latest/validators/security.md): Each validator candidate is encouraged to run its operations independently, as diverse setups increase the resilience of the network. Validator candidates should commence their setup phase now in order to be on time for launch.
- [Validator FAQ](https://docs.cosmos.network/hub/latest/validators/validator-faq.md)
- [Running a Validator](https://docs.cosmos.network/hub/latest/validators/validator-setup.md)
- [Setting up Tendermint KMS + Ledger](https://docs.cosmos.network/hub/latest/validators/kms/kms_ledger.md)
- [KMS - Key Management System](https://docs.cosmos.network/hub/latest/validators/kms/kms.md): Tendermint KMS is a key management service that allows separating key management from Tendermint nodes. In addition it provides other advantages such as:

###### Delegators

- [Delegator FAQ](https://docs.cosmos.network/hub/latest/delegators/delegator-faq.md)
- [Delegator Guide (CLI)](https://docs.cosmos.network/hub/latest/delegators/delegator-guide-cli.md): This document contains all the necessary information for delegators to interact with the Cosmos Hub through the Command-Line Interface (CLI).
- [Delegator Security](https://docs.cosmos.network/hub/latest/delegators/delegator-security.md)
- [Delegators](https://docs.cosmos.network/hub/latest/delegators/README.md): This folder contains documentation relevant to delegators of the Cosmos Hub and other gaia blockchains.

###### Governance

- [Off-Chain Proposal Process](https://docs.cosmos.network/hub/latest/governance/best-practices.md): Once a proposal is on-chain, it cannot be changed to reflect feedback or new information. It's very important to give a proposal time off-chain to receive feedback, input, and edits before going on-chain and asking for votes.
- [Formatting a Proposal](https://docs.cosmos.network/hub/latest/governance/formatting.md)
- [On-Chain Proposal Process](https://docs.cosmos.network/hub/latest/governance/process.md)
- [Governance Overview](https://docs.cosmos.network/hub/latest/governance/README.md): The Cosmos Hub ("Gaia") has an on-chain governance mechanism for signaling, changing consensus parameters, and spending funds from the community pool.
- [Submitting a Proposal](https://docs.cosmos.network/hub/latest/governance/submitting.md): If you have a final draft of your proposal ready to submit, you may want to push your proposal live on the testnet first. These are the three primary steps to getting your proposal live on-chain.
- [Community Pool Spend](https://docs.cosmos.network/hub/latest/governance/proposal-types/community-pool-spend.md): Cosmos Hub launched with community-spend capabilities on December 11, 2019, effectively unlocking the potential for token-holders to vote to approve spending from the Community Pool.
- [Parameter Changes](https://docs.cosmos.network/hub/latest/governance/proposal-types/param-change.md): This documentation aims to provide guidelines for creating and assessing parameter-change proposals.
- [Proposal Types](https://docs.cosmos.network/hub/latest/governance/proposal-types/README.md): - Text - Community Pool Spend - Parameter Change - Software Upgrade - IBC Client Update
- [Software Upgrade](https://docs.cosmos.network/hub/latest/governance/proposal-types/software-upgrade.md): Software upgrade proposals are submitted to signal that a Cosmos Hub release with new features, bugfixes and various other improvements is available and ready for production deployment.
- [Text (Signaling)](https://docs.cosmos.network/hub/latest/governance/proposal-types/text-prop.md): Signaling proposals are used to make an on-chain record of support or agreement on a certain topic or ideas. Text proposals do not contain any code. That is, they do not directly cause any changes to the Hub once passed.

###### Interchain Security

- [Interchain Security](https://docs.cosmos.network/hub/latest/interchain-security/README.md)

###### Modules

- [x/liquid](https://docs.cosmos.network/hub/latest/modules/liquid.md): The x/liquid module used by the Hub includes types and APIs that enable liquid staking. You can read more about it in our module documentation.
- [Cosmos SDK LSM](https://docs.cosmos.network/hub/latest/modules/lsm-migration.md): As of the v24.x release of Gaia, the Cosmos SDK based Liquid Staking Module is deprecated. The v24 release line will still have all the types from the forked SDK version, but all the API endpoints will be disabled.
- [Metaprotocol](https://docs.cosmos.network/hub/latest/modules/metaprotocols.md): The x/metaprotocol module adds support for encoding and decoding additional fields attached to transactions.
- [Gaia Modules](https://docs.cosmos.network/hub/latest/modules/README.md): Here you can find an overview of the modules included on the Cosmos Hub (Gaia) blockchain with relevant info and links for each one.

###### Architecture

- [ADR Creation Process](https://docs.cosmos.network/hub/latest/architecture/PROCESS.md)
- [Architecture Decision Records (ADR)](https://docs.cosmos.network/hub/latest/architecture/README.md): This is a location to record all high-level architecture decisions for new feature and module proposals in the Cosmos Hub.
- [ADR 001: Interchain Accounts](https://docs.cosmos.network/hub/latest/architecture/adr/adr-001-interchain-accounts.md)
- [Adr template](https://docs.cosmos.network/hub/latest/architecture/templates/adr-template.md)
- [ADR 002: Globalfee Module [DEPRECATED]](https://docs.cosmos.network/hub/latest/architecture/adr/adr-002-globalfee.md): - 2023-06-12: Initial Draft - 2024-06-06: Change status to deprecated
- [ADR 003: Interchain Accounts Controller Module](https://docs.cosmos.network/hub/latest/architecture/adr/adr-003-ica-controller.md)
- [ADR Creation Process](https://docs.cosmos.network/hub/latest/architecture/adr/PROCESS.md)
- [Architecture Decision Records (ADR)](https://docs.cosmos.network/hub/latest/architecture/adr/README.md)

###### Resources

- [Cosmos Hub Archives](https://docs.cosmos.network/hub/latest/resources/archives.md): With each breaking upgrade of the Cosmos Hub, the network is restarted at height 0. During this process, an export of the last state of the previous network is made to produce the genesis state of the new one.
- [The Genesis File](https://docs.cosmos.network/hub/latest/resources/genesis.md): This document explains how the genesis file of the Cosmos Hub mainnet is structured. It also explains how you can build a genesis file for your own gaia testnet.
- [HD Wallets](https://docs.cosmos.network/hub/latest/resources/hd-wallets.md)
- [Ledger Nano Support](https://docs.cosmos.network/hub/latest/resources/ledger.md)
- [Resources](https://docs.cosmos.network/hub/latest/resources/README.md): This folder contains resources on the gaia software.
- [Building Gaia Deterministically](https://docs.cosmos.network/hub/latest/resources/reproducible-builds.md)
- [Service Providers](https://docs.cosmos.network/hub/latest/resources/service-providers.md): 'Service Providers' are defined as entities that provide services for end-users that involve some form of interaction with the Cosmos Hub. More specifically, this document is focused on interactions with tokens.

###### Telemetry

- [Gaia Telemetry](https://docs.cosmos.network/hub/latest/telemetry/telemetry.md)

## OpenAPI Specs

- [openapi](/sdk/latest/api-reference/rest/openapi.yaml)
- [openapi](/sdk/next/api-reference/rest/openapi.yaml)
- [openapi](/cometbft/latest/api-reference/rpc/openapi.yaml)
- [openapi](/cometbft/next/api-reference/rpc/openapi.yaml)
- [openapi](/cometbft/v0.39/api-reference/rpc/openapi.yaml)
- [openapi](/cometbft/v0.38/api-reference/rpc/openapi.yaml)
- [swagger](/swagger.yml)
- [openapi](/evm/v0.4.x/api-reference/ethereum-json-rpc/openapi.yaml)

> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.

## Indexes

- [Cosmos SDK (442 pages)](https://docs.cosmos.network/_llms/cosmos-sdk.md): Documentation for Cosmos SDK.
- [Cosmos SDK / v0.55 (311 pages)](https://docs.cosmos.network/_llms/cosmos-sdk/v0-55.md): Documentation for Cosmos SDK / v0.55.
- [Cosmos SDK / v0.55 / Cosmos SDK (180 pages)](https://docs.cosmos.network/_llms/cosmos-sdk/v0-55/cosmos-sdk.md): Documentation for Cosmos SDK / v0.55 / Cosmos SDK.
- [Cosmos SDK / v0.55 / API Reference (131 pages)](https://docs.cosmos.network/_llms/cosmos-sdk/v0-55/api-reference.md): Documentation for Cosmos SDK / v0.55 / API Reference.
- [Cosmos SDK / next (131 pages)](https://docs.cosmos.network/_llms/cosmos-sdk/next.md): Documentation for Cosmos SDK / next.
- [Cosmos SDK / next / API Reference (131 pages)](https://docs.cosmos.network/_llms/cosmos-sdk/next/api-reference.md): Documentation for Cosmos SDK / next / API Reference.
- [IBC Protocol (192 pages)](https://docs.cosmos.network/_llms/ibc-protocol.md): Documentation for IBC Protocol.
- [IBC Protocol / v11.x.x (163 pages)](https://docs.cosmos.network/_llms/ibc-protocol/v11-x-x.md): Documentation for IBC Protocol / v11.x.x.
- [CometBFT (202 pages)](https://docs.cosmos.network/_llms/comet-bft.md): Documentation for CometBFT.