Skip to content

WhisperNode/chain-registry

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Chain Registry

This repo contains a chain.json, assetlist.json, and versions.json for a number of cosmos-sdk based chains (and assetlist.json for non-cosmos chains). A chain.json contains data that makes it easy to start running or interacting with a node.

Schema files containing the recommended metadata structure can be found in the *.schema.json files located in the root directory. Schemas are still undergoing revision as user needs are surfaced. Optional fields may be added beyond what is contained in the schema files.

We invite stakeholders to join the Cosmos Chain Registry Working Group on Telegram to discuss major structure changes, ask questions, and develop tooling.

Once schemas have matured and client needs are better understood Chain Registry data is intended to migrate to an on-chain representation hosted on the Cosmos Hub, i.e. the Cosmos Chain Name Service. If you are interested in this effort please join the discussion here!

Npm Modules

Rust Crates

Web Endpoints

APIs

Web Interfaces

Tooling

Contributing

We accept pull requests to add data to an existing assetlist.json or chain.json (especially to add peer data or public rpc endpoint) or to add a new chain or asset.

Please give Pull Requests a title that somewhat describes the change more precisely than the default title given to a Commit. PRs titled 'Update chain.json' are insufficient, and would be difficult to navigate when searching through the backlog of Pull Requests. Some recommended details would be: the affected Chain Name, API types, or Provider to give some more detail; e.g., "Add Cosmos Hub APIs for Acme Validator".

chain.json

Sample

A sample chain.json includes the following information.

{
  "$schema": "../chain.schema.json",
  "chain_name": "osmosis",
  "status": "live",
  "website": "https://osmosis.zone/",
  "network_type": "mainnet",
  "chain_type": "cosmos"
  "pretty_name": "Osmosis",
  "chain_id": "osmosis-1",
  "bech32_prefix": "osmo",
  "daemon_name": "osmosisd",
  "node_home": "$HOME/.osmosisd",
  "key_algos": [
    "secp256k1"
  ],
  "slip44": 118,
  "fees": {
    "fee_tokens": [
      {
        "denom": "uosmo",
        "fixed_min_gas_price": 0,
        "low_gas_price": 0,
        "average_gas_price": 0.025,
        "high_gas_price": 0.04
      }
    ]
  },
  "staking": {
    "staking_tokens": [
      {
        "denom": "uosmo"
      }
    ],
    "lock_duration": {
      "time": "1209600s"
    }
  },
  "codebase": {
    "git_repo": "https://github.com/osmosis-labs/osmosis",
    "genesis": {
      "name": "v3",
      "genesis_url": "https://github.com/osmosis-labs/networks/raw/main/osmosis-1/genesis.json"
    },
    "recommended_version": "v25.0.0",
    "compatible_versions": [
      "v25.0.0"
    ],
    "binaries": {
      "linux/amd64": "https://github.com/osmosis-labs/osmosis/releases/download/v25.0.0/osmosisd-25.0.0-linux-amd64",
      "linux/arm64": "https://github.com/osmosis-labs/osmosis/releases/download/v25.0.0/osmosisd-25.0.0-linux-arm64"
    },
    "consensus": {
      "type": "cometbft",
      "version": "osmosis-labs/cometbft v0.37.4-v25-osmo-2"
    },
    "language": {
      "type": "go",
      "version": "1.21.4"
    },
    "sdk": {
      "type": "cosmos",
      "repo": "https://github.com/osmosis-labs/cosmos-sdk",
      "version": "v0.47.5",
      "tag": "v0.47.5-v25-osmo-1"
    },
    "ibc": {
      "type": "go",
      "version": "v7.4.0",
      "ics_enabled": [
        "ics20-1"
      ]
    },
    "cosmwasm": {
      "version": "v0.45.0",
      "repo": "https://github.com/osmosis-labs/wasmd",
      "tag": "v0.45.0-osmo",
      "enabled": true
    }
    "versions": [
      {
        "name": "v3",
        "tag": "v3.1.0",
        "height": 0,
        "next_version_name": "v4"
      },
      ...//version history can alternatively go into 'versions.json'
      {
        "name": "v25",
        "tag": "v25.0.0",
        "proposal": 782,
        "height": 15753500,
        "recommended_version": "v25.0.0",
        "compatible_versions": [
          "v25.0.0"
        ],
        "binaries": {
          "linux/amd64": "https://github.com/osmosis-labs/osmosis/releases/download/v25.0.0/osmosisd-25.0.0-linux-amd64",
          "linux/arm64": "https://github.com/osmosis-labs/osmosis/releases/download/v25.0.0/osmosisd-25.0.0-linux-arm64"
        },
        "previous_version_name": "v24",
        "next_version_name": "v26",
        "consensus": {
          "type": "cometbft",
          "version": "osmosis-labs/cometbft v0.37.4-v25-osmo-2"
        },
        "cosmwasm": {
          "version": "v0.45.0",
          "repo": "https://github.com/osmosis-labs/wasmd",
          "tag": "v0.45.0-osmo",
          "enabled": true
        },
        "sdk": {
          "type": "cosmos",
          "version": "v0.47.5",
          "repo": "https://github.com/osmosis-labs/cosmos-sdk",
          "tag": "v0.47.5-v25-osmo-1"
        },
        "ibc": {
          "type": "go",
          "version": "v7.4.0",
          "ics_enabled": [
            "ics20-1"
          ]
        },
        "language": {
          "type": "go",
          "version": "1.21.4"
        }
      }
    ]
  },
  "images": [
    {
      "svg": "https://raw.githubusercontent.com/cosmos/chain-registry/master/osmosis/images/osmosis-chain-logo.svg",
      "png": "https://raw.githubusercontent.com/cosmos/chain-registry/master/osmosis/images/osmosis-chain-logo.png",
      "theme": {
        "circle": true,
        "primary_color_hex": "#231D4B"
      }
    }
  ],
  "peers": {
    "seeds": [
      {
        "id": "83adaa38d1c15450056050fd4c9763fcc7e02e2c",
        "address": "ec2-44-234-84-104.us-west-2.compute.amazonaws.com:26656",
        "provider": "notional"
      },
      ...
      {
        //another peer
      }
    ],
    "persistent_peers": [
      {
        "id": "8f67a2fcdd7ade970b1983bf1697111d35dfdd6f",
        "address": "52.79.199.137:26656",
        "provider": "cosmostation"
      },
      ...
      {
        //another peer
      }
    ]
  },
  "apis": {
    "rpc": [
      {
        "address": "https://osmosis.validator.network/",
        "provider": "validatornetwork"
      },
      ...
      {
        //another rpc
      }
    ],
    "rest": [
      {
        "address": "https://lcd-osmosis.blockapsis.com",
        "provider": "chainapsis"
      },
      ...
      {
        //another rest
      }
    ]
  },
  "explorers": [
    {
      "kind": "mintscan",
      "url": "https://www.mintscan.io/osmosis",
      "tx_page": "https://www.mintscan.io/osmosis/txs/${txHash}",
      "account_page": "https://www.mintscan.io/osmosis/account/${accountAddress}"
    },
    ...
    {
      //another explorer
    }
  ],
  "keywords": [
    "dex"
  ]
}

Assetlists

Asset Lists are inspired by the Token Lists project on Ethereum which helps discoverability of ERC20 tokens by providing a mapping between erc20 contract addresses and their associated metadata.

Asset lists are a similar mechanism to allow frontends and other UIs to fetch metadata associated with Cosmos SDK denoms, especially for assets sent over IBC.

This standard is a work in progress. You'll notice that the format of assets in the assetlist.json structure is a strict superset json representation of the banktypes.DenomMetadata from the Cosmos SDK. This is purposefully done so that this standard may eventually be migrated into a Cosmos SDK module in the future, so it can be easily maintained on chain instead of on Github.

The assetlist JSON Schema can be found here.

An example assetlist json contains the following structure:

{
  "$schema": "../assetlist.schema.json",
  "chain_name": "osmosis",
  "assets": [
    {
      "description": "The native token of Osmosis",
      "denom_units": [
        {
          "denom": "uosmo",
          "exponent": 0
        },
        {
          "denom": "osmo",
          "exponent": 6
        }
      ],
      "type_asset": "sdk.coin",
      "base": "uosmo",
      "name": "Osmosis",
      "display": "osmo",
      "symbol": "OSMO",
      "images": [
        {
          "png": "https://raw.githubusercontent.com/cosmos/chain-registry/master/osmosis/images/osmo.png",
          "svg": "https://raw.githubusercontent.com/cosmos/chain-registry/master/osmosis/images/osmo.svg",
          "theme": {
            "circle": false,
            "primary_color_hex": "#5c09a0"
          }
        }
      ],
      "coingecko_id": "osmosis",
      "keywords": [
        "dex",
        "staking"
      ],
      "socials": {
        "website": "https://osmosis.zone",
        "twitter": "https://twitter.com/osmosiszone"
      }
    },
    ..
    {
      "description": "The native staking and governance token of the Cosmos Hub.",
      "denom_units": [
        {
          "denom": "ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2",
          "exponent": 0,
          "aliases": [
            "uatom"
          ]
        },
        {
          "denom": "atom",
          "exponent": 6
        }
      ],
      "type_asset": "ics20",
      "base": "ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2",
      "name": "Cosmos Hub",
      "display": "atom",
      "symbol": "ATOM",
      "traces": [
        {
          "type": "ibc",
          "counterparty": {
            "chain_name": "cosmoshub",
            "base_denom": "uatom",
            "channel_id": "channel-141"
          },
          "chain": {
            "channel_id": "channel-0",
            "path": "transfer/channel-0/uatom"
          }
        }
      ],
      "images": [
        {
          "image_sync": {
            "chain_name": "cosmoshub",
            "base_denom": "uatom"
          },
          "png": "https://raw.githubusercontent.com/cosmos/chain-registry/master/cosmoshub/images/atom.png",
          "svg": "https://raw.githubusercontent.com/cosmos/chain-registry/master/cosmoshub/images/atom.svg",
          "theme": {
            "primary_color_hex": "#272d45"
          }
        }
      ]
    }
  ]
}

IBC Data

The metadata contained in these files represents a path abstraction between two IBC-connected networks. This information is particularly useful when relaying packets and acknowledgments across chains.

This schema also allows us to provide helpful info to describe open channels.

Note: when creating these files, please ensure the chains in both the file name and the references of chain-1 and chain-2 in the json file are in alphabetical order. Ex: Achain-Zchain.json. The chain names used must match name of the chain's directory here in the chain-registry.

An example ibc metadata file contains the following structure:

{
  "$schema": "../ibc_data.schema.json",
  "chain_1": {
    "chain_name": "juno",
    "client_id": "07-tendermint-0",
    "connection_id": "connection-0"
  },
  "chain_2": {
    "chain_name": "osmosis",
    "client_id": "07-tendermint-1457",
    "connection_id": "connection-1142"
  },
  "channels": [
    {
      "chain_1": {
        "channel_id": "channel-0",
        "port_id": "transfer"
      },
      "chain_2": {
        "channel_id": "channel-42",
        "port_id": "transfer"
      },
      "ordering": "unordered",
      "version": "ics20-1",
      "tags": {
        "status": "live",
        "preferred": true,
        "dex": "osmosis"
      }
    }
  ]
}

Creative Commons Licence
This work is licensed under a Creative Commons Attribution 4.0 International License.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 98.1%
  • JavaScript 1.9%