cosmos-explorer/chains/README.md

Directory Layout

We accept all blockchains which have 10+ independent validators.

• Submit configs for mainnet, go to https://github.com/ping-pub/explorer/tree/master/chains/mainnet

• Submit configs for testnet, go to https://github.com/ping-pub/explorer/tree/master/chains/testnet

Sample of Config

{
    "chain_name": "cosmos",
    "api": [
        {
            "address": "https://cosmos.api.ping.pub", 
            "provider": "Ping"
        }
    ], 
    "rpc": [
        {
            "address": "https://cosmos.api.ping.pub", 
            "provider": "Ping"
        }
    ],
    "sdk_version": "0.42.6",
    "coin_type": "118",
    "min_tx_fee": "800",
    "assets": [{
        "base": "uatom",
        "symbol": "ATOM",
        "exponent": "6",
        "coingecko_id": "cosmos", 
        "logo": "https://dl.airtable.com/.attachments/e54f814bba8c0f9af8a3056020210de0/2d1155fb/cosmos-hub.svg"
    }],
    "addr_prefix": "cosmos",
    "theme_color": "#ce4747",
    "logo": "https://dl.airtable.com/.attachments/e54f814bba8c0f9af8a3056020210de0/2d1155fb/cosmos-hub.svg"
}

• chain_name the name to identify the chain on ping.pub, would be better to use the same one as registry
• api the rest api endpoint.(make sure that CORS is enabled: Allow-Control-Allow-Origin: *)
• rpc the rpc endpoint, make sure that the port is added. rpc endpoint is only used for state sync. it's optional.
• assets Native Assets on blockchain.

Endpoint providers will be listed in the "Popular" tab of the staking.

Token Unit conversion

We have two methods to load token metadata for token unit conversion:

Loading from a REST endpoint (recommended).

you can define the metadata in the bank -> metadata section of the blockchain's genesis file.

{
  "name": "atom",
  "description": "The native staking token of the Cosmos Hub.",
  "denom_units": [
    {
      "denom": "uatom",
      "exponent": 0,
      "aliases": [
        "microatom"
      ],
    },
    {
      "denom": "matom",
      "exponent": 3,
      "aliases": [
        "milliatom"
      ]
    },
    {
      "denom": "atom",
      "exponent": 6,
    }
  ],
  "base": "uatom",
  "display": "atom",
}

you can see more details here: https://github.com/cosmos/cosmos-sdk/blob/main/docs/architecture/adr-024-coin-metadata.md

Loading from Cosmos Registry:

https://github.com/cosmos/chain-registry

Test

please add these check points in comments with your PR, and adding your test result by clicking the checkbox of each line

Test Result:
- [ ] Connect wallet, check if address is correct? 
- [ ] Transfer
- [ ] Delegate
- [ ] Redelegate
- [ ] Unbond
- [ ] withdraw Validator's Commission
- [ ] withdraw Rewards

Test is very important for us and our users.