A public registry of metadata for Cosmos SDK-based blockchains, including chain info, asset lists, and IBC data.
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.
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.
chain.json files containing essential data like chain ID, bech32 prefix, RPC/API endpoints, and staking parameters.assetlist.json files that map denoms to metadata (name, symbol, images, social links) for tokens, including IBC assets.versions.json tracking chain upgrade history, binaries, and dependencies.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.
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Provides consistent JSON schemas for chain.json and assetlist.json, enabling interoperability across Cosmos applications, as shown in the detailed sample structures in the README.
Invites stakeholders via Telegram and GitHub for discussions and updates, with daily CI testing of endpoints to ensure data reliability, as mentioned in the contributing section.
Includes structured IBC channel metadata in JSON files, essential for cross-chain applications and relayers, with examples detailing channel connections and tags.
Offers npm packages, Rust crates, and public APIs for programmatic access, making integration easy for developers, as listed in the README's tooling sections.
The README admits schemas are 'still undergoing revision,' which can lead to breaking changes and require frequent updates from dependent applications.
Data is hosted on GitHub, not on a blockchain, introducing centralization risks and contradicting Cosmos's decentralization goals, though an on-chain migration is planned.
Requires pull requests and community approval, which can slow down additions or updates for new or fast-evolving chains, as highlighted in the contributing guidelines.