chain-registry
A public registry of metadata for Cosmos SDK-based blockchains, including chain info, asset lists, and IBC data.
What is chain-registry?
Cosmos Chain Registry is a public repository of structured metadata for Cosmos SDK-based blockchains. It provides standardized JSON files (chain.json, assetlist.json, versions.json) that describe chain configurations, token assets, and IBC connections. The registry solves the problem of fragmented blockchain metadata by offering a single source of truth for developers building on Cosmos.
Blockchain developers, validators, wallet builders, and relayer operators working within the Cosmos ecosystem who need reliable chain and asset metadata.
Developers choose Chain Registry because it provides standardized, community-maintained metadata that reduces integration complexity. Its schema-driven approach ensures consistency across Cosmos networks, and its public availability enables easy discovery and interoperability.
Overview
The Cosmos Chain Registry is a centralized repository of structured metadata for Cosmos SDK-based blockchains and their assets. It provides standardized JSON schemas (chain.json, assetlist.json, versions.json) that describe chain configurations, token metadata, and Inter-Blockchain Communication (IBC) channel information. This registry enables developers, validators, and applications to easily discover and interact with Cosmos networks.
Key Features
- Chain Metadata — Standardized
chain.jsonfiles containing essential data like chain ID, bech32 prefix, RPC/API endpoints, and staking parameters. - Asset Lists —
assetlist.jsonfiles that map denoms to metadata (name, symbol, images, social links) for tokens, including IBC assets. - IBC Data — JSON files describing IBC channel connections between chains, useful for relayers and cross-chain applications.
- Version History — Optional
versions.jsontracking chain upgrade history, binaries, and dependencies. - Tooling Integration — Provides npm packages, Rust crates, and public APIs for programmatic access to registry data.
Philosophy
The registry follows a community-driven, schema-first approach to standardize blockchain metadata, with the long-term vision of migrating to an on-chain representation via the Cosmos Hub.
Related Projects
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
