on-chain-registry
on-chain-registry copied to clipboard
metadata oracle: asset list of all cosmos-sdk chains
On-Chain Registry: Cosmos-SDK Asset List
Proof-of-Nodes Concept
Rather than a static registry, the OCR represents a living, constantly updating protocol that sources data straight directly from nodes. This mechanism leads to:
- Accuracy: The registry furnishes complete and precise data, crucial for meaningful and successful blockchain transactions.
- Reliability: By ruling out the chance of human error, the registry delivers consistent information that users can rely on.
- Inclusivity: It leaves out no data not specified in the chains, thereby offering a comprehensive overview of the blockchain environment.
Milestones
Workflow:
Functionality
OCR provides an interface for updating, storing, and accessing data on-chain. This enables it to dynamically adapt to the ever-changing state of the chains.
API & IBC Tokens Verification. OCR functions as a robust and secure API, offering users the capability to verify Inter-Blockchain Communication (IBC) tokens with trusted and verified metadata. This feature further enhances the transparency and security of cross-chain transactions.
Integration of External Registries. In the pursuit of providing an all-encompassing data access point, OCR integrates data from other registries as well. This guarantees that users have a comprehensive, unified, and updated view of the entire blockchain ecosystem.
Assets
On-chain based data allows viewing of all existing assets:
Asset Data Structure
OCR uses a chain-registry like asset data structure for better compatibility.

Differences from the chain-registry asset data structure:
- add
chain_idrequired property; denom_units,display,nameandsymbolasset object properties are optional;- add
chain_idrequired property in asset traces section; - set
chain_nameproperty in asset traces section as optional; - add
supplyoptional property in asset section andbase_supplyoptional property in asset traces section; - add
adminrequired property forfactoryasset type in asset section.
Contract queries
Query schema
Query examples
How to deploy
clone repo and optionally edit the .env file
git clone https://github.com/Snedashkovsky/on-chain-registry && \
cd on-chain-registry && \
cp .env.example .env
install python virtual environment and requirements in it
make install_venv
update asset list
make update
Data Sources
REST APIs Queries
Contributions
We warmly welcome pull requests, issues, and feedback from the community.