Initia Registry

For a rollup to be supported by the the core Initia apps such as Initia Wallet, Initia Scan, and Initia App, it must be registered on the Initia Registry. This is a public GitHub repository that contains the metadata for all rollups that are currently live on the various Initia networks.

Adding a Rollup to the Registry

To add a rollup to the registry, follow these steps:

Fork the Initia Registry Repository

To make changes to the registry, you will need to fork the Initia Registry repository. This will create a copy of the repository in your own GitHub account.

Add the Rollup to the Registry

Once you have forked the repository, you can add the rollup to the registry by following these steps:

1. Add a new folder with your rollup’s name in the testnets or mainnets folder, depending on whether your rollup is currently live on the testnet or mainnet.
2. Add a chain.json file to the folder. This file will contain the metadata for your rollup to be used by the apps.

Example Chain Schema and Description

{
  "$schema": "../../chain.schema.json",
  "chain_name": "minimove",
  "chain_id": "minimove-2",
  "website": "https://initia.xyz",
  "pretty_name": "Minimove",
  "status": "live",
  "network_type": "testnet",
  "bech32_prefix": "init",
  "daemon_name": "minitiad",
  "node_home": "$HOME/.minitia",
  "key_algos": ["secp256k1"],
  "slip44": 118,
  "fees": {
    "fee_tokens": [
      {
        "denom": "umin",
        "fixed_min_gas_price": 0,
        "low_gas_price": 0,
        "average_gas_price": 0,
        "high_gas_price": 0
      }
    ]
  },
  "staking": {
    "staking_tokens": []
  },
  "codebase": {
    "git_repo": "https://github.com/initia-labs/minimove",
    "recommended_version": "v0.5.3",
    "compatible_versions": ["v0.5.3"],
    "binaries": {
      "linux/amd64": "https://github.com/initia-labs/minimove/releases/download/v0.5.3/minimove_v0.5.3_Linux_x86_64.tar.gz",
      "linux/arm64": "https://github.com/initia-labs/minimove/releases/download/v0.5.3/minimove_v0.5.3_Linux_aarch64.tar.gz",
      "darwin/amd64": "https://github.com/initia-labs/minimove/releases/download/v0.5.3/minimove_v0.5.3_Darwin_x86_64.tar.gz",
      "darwin/arm64": "https://github.com/initia-labs/minimove/releases/download/v0.5.3/minimove_v0.5.3_Darwin_aarch64.tar.gz"
    },
    "genesis": {
      "genesis_url": "https://storage.googleapis.com/init-common-genesis/minimove-2/genesis.json"
    },
    "versions": []
  },
  "description": "Minimove Public Testnet",
  "peers": {
    "seeds": [],
    "persistent_peers": []
  },
  "apis": {
    "rpc": [
      {
        "address": "https://rpc.minimove-2.initia.xyz",
        "provider": "Initia Labs"
      }
    ],
    "rest": [
      {
        "address": "https://rest.minimove-2.initia.xyz",
        "provider": "Initia Labs"
      }
    ],
    "grpc": [
      {
        "address": "grpc://35.247.132.75:9090",
        "provider": "Initia Labs"
      }
    ]
  },
  "explorers": [
    {
      "kind": "initia scan",
      "url": "https://scan.testnet.initia.xyz/minimove-2",
      "tx_page": "https://scan.testnet.initia.xyz/minimove-2/txs/${txHash}",
      "account_page": "https://scan.testnet.initia.xyz/minimove-2/accounts/${accountAddress}"
    }
  ],
  "images": [
    {
      "png": "https://raw.githubusercontent.com/initia-labs/initia-registry/main/testnets/minimove/images/minimove.png",
      "svg": "https://raw.githubusercontent.com/initia-labs/initia-registry/main/testnets/minimove/images/minimove.svg"
    }
  ],
  "logo_URIs": {
    "png": "https://raw.githubusercontent.com/initia-labs/initia-registry/main/testnets/minimove/images/minimove.png",
    "svg": "https://raw.githubusercontent.com/initia-labs/initia-registry/main/testnets/minimove/images/minimove.svg"
  },
  "metadata": {
    "op_bridge_id": "4",
    "op_denoms": ["uinit"],
    "executor_uri": "https://executor.minimove-2.initia.xyz",
    "ibc_channels": [
      {
        "chain_id": "initiation-2",
        "port_id": "transfer",
        "channel_id": "channel-0",
        "version": "ics20-1"
      },
      {
        "chain_id": "initiation-2",
        "port_id": "nft-transfer",
        "channel_id": "channel-1",
        "version": "ics721-1"
      }
    ],
    "assetlist": "https://raw.githubusercontent.com/initia-labs/initia-registry/main/testnets/minimove/assetlist.json",
    "minitia": {
      "type": "minimove",
      "version": "v0.5.3"
    }
  }
}

Description

General Information

Field	Description	Optional
$schema	The schema definition file. (should always be ../../chain.schema.json)	No
chain_name	The name of the rollup.	No
chain_id	The chain ID of the rollup.	No
website	The website of the rollup.	No
pretty_name	A human-readable name for your rollup.	No
status	The current status of the rollup (e.g., live).	No
network_type	The type of network (one of mainnet, testnet, devnet).	No
bech32_prefix	The Bech32 prefix used for addresses on the blockchain.	No
daemon_name	The name of the daemon process for the blockchain (e.g., minitiad).	No
node_home	The default home directory for the blockchain node.	No
key_algos	The cryptographic algorithms supported for keys.	No
slip44	The SLIP-0044 identifier for the blockchain.	No
description	A brief description of the rollup.	No

Fees

Field	Description	Optional
fees	Details about the fee and fee tokens on the rollup.	No
fee_tokens	Tokens used for fees, including their denominations and gas prices.	No

Staking

These fields should be empty for all rollups.

Field	Description	Optional
staking	Information about staking on the rollup.	No
staking_tokens	Tokens used for staking.	No

Codebase

Field	Description	Optional
codebase	Information about the blockchain’s codebase.	No
git_repo	The URL of the Git repository for the rollup.	No
recommended_version	The recommended version of the rollup software. This should in most cases be the latest version of the software.	No
compatible_versions	Versions of the rollup software that are compatible.	No
binaries	URLs for downloading binary files for different platforms.	No
genesis	Information about the genesis block of the rollup.	No
genesis_url	The URL to download the rollup genesis file.	No
versions	List of versions of the rollup software.	No

Peers

Field	Description	Optional
peers	Information about network peers.	No
seeds	The list of seed nodes for the rollup.	No
persistent_peers	The list of persistent peers for the rollup.	No

APIs

Field	Description	Optional
apis	Information about the different endpoints for the rollup.	No
rpc	RPC endpoints and their providers.	No
rest	REST endpoints and their providers.	No
grpc	gRPC endpoints and their providers.	No

Explorers

Field	Description	Optional
explorers	Blockchain explorers available for the network.	No
kind	The type of explorer.	No
url	The URL of the explorer.	No
tx_page	The URL template for transaction pages.	No
account_page	The URL template for account pages.	No

Images

Field	Description	Optional
images	URLs for images related to the blockchain.	No
png	URL for the PNG image.	No
svg	URL for the SVG image.	No
logo_URIs	URLs for the blockchain logo.	No

Metadata

Field	Description	Optional
metadata	Additional metadata about the blockchain.	No
op_bridge_id	The bridge ID for operations.	Yes
op_denoms	Denominations used in by the OP Bridge.	Yes
executor_uri	The URI for the executor service.	Yes
ibc_channels	Information about IBC channels.	Yes
chain_id	The chain ID for the IBC channel.	No
port_id	The port ID for the IBC channel.	No
channel_id	The channel ID for the IBC channel.	No
version	The version of the IBC protocol used.	No
assetlist	URL for the asset list JSON file.	Yes
minitia	Specific metadata for the rollup.	No
type	The type of chain (one of minimove, minievm, or miniwasm).	No
version	The version of the rollup.	No

3. Create an assetlist.json file in the folder. This file will contain the metadata for the assets on your rollup to be used by the apps.

Example Assetlist Schema and Description

{
  "$schema": "../../assetlist.schema.json",
  "chain_name": "minimove",
  "assets": [
    {
      "description": "The native token of Initia",
      "denom_units": [
        {
          "denom": "l2/771d639f30fbe45e3fbca954ffbe2fcc26f915f5513c67a4a2d0bc1d635bdefd",
          "exponent": 0
        },
        {
          "denom": "INIT",
          "exponent": 6
        }
      ],
      "base": "l2/771d639f30fbe45e3fbca954ffbe2fcc26f915f5513c67a4a2d0bc1d635bdefd",
      "display": "INIT",
      "traces": [
        {
          "type": "op",
          "counterparty": {
            "base_denom": "uinit",
            "chain_name": "initia"
          },
          "chain": {
            "bridge_id": "1"
          }
        }
      ],
      "name": "Initia Native Token",
      "symbol": "INIT",
      "coingecko_id": "",
      "images": [
        {
          "png": "https://raw.githubusercontent.com/initia-labs/initia-registry/main/testnets/minimove/images/INIT.png",
          "svg": "https://raw.githubusercontent.com/initia-labs/initia-registry/main/testnets/minimove/images/INIT.svg"
        }
      ],
      "logo_URIs": {
        "png": "https://raw.githubusercontent.com/initia-labs/initia-registry/main/testnets/minimove/images/INIT.png",
        "svg": "https://raw.githubusercontent.com/initia-labs/initia-registry/main/testnets/minimove/images/INIT.svg"
      }
    },
  ]
}

General Information

Field	Description	Optional
name	The name of the token	No
symbol	The symbol of the token	No
description	The description of the token	No
coingecko_id	The CoinGecko ID of the token	Yes

Denomination Units

Field	Description	Optional
denom_units	List of denomination units	No
denom_units.denom	The denomination identifier (e.g. “uinit”, “INIT”)	No
denom_units.exponent	The exponent of the denomination (e.g. 0, 6)	No

Base and Display

Field	Description	Optional
base	The base denomination of the token (e.g. uinit, l2/…)	No
display	The display denomination identifier (e.g. INIT)	No

Traces

Field	Description	Optional
traces	List of trace information for the token	No
traces.type	The type of trace (e.g., “op”, “ibc”)	No
traces.counterparty	Information about the counterparty chain	No
traces.counterparty.base_denom	The base denomination on the counterparty chain	No
traces.counterparty.chain_name	The name of the counterparty chain	No
traces.counterparty.channel_id	The channel ID on the counterparty chain	Yes
traces.chain	Information about the current chain	No
traces.chain.bridge_id	The bridge ID on the current chain	Yes
traces.chain.channel_id	The channel ID on the current chain	Yes
traces.chain.path	The path on the current chain	Yes

Images

Field	Description	Optional
images	List of image URIs for the token	No
images.png	The PNG image URI for the token	No
images.svg	The SVG image URI for the token	No

Logo URIs

Field	Description	Optional
logo_URIs	Object containing logo URIs for the token	No
logo_URIs.png	The PNG logo URI for the token	No
logo_URIs.svg	The SVG logo URI for the token	No

4. (Optional) create an images folder to store the images for your rollup logo and token logos to link to in the two JSON files above.

Submit a Pull Request

Once you have completed the above steps, you can submit a pull request to the Registry repository to add your rollup to the registry. Once your pull request is reviewed & merged by a member of the Initia team, your rollup will be supported by the core Initia apps shortly after.