Skip to main content

Directory Chain

Overview​

The Directory Chain is a system chain in the Chromia network, it acts as the central registry and coordination hub for all network participants and blockchains.

Core functions​

Chain registry and management​

The Directory Chain maintains comprehensive records of the Chromia network:

  • Chain registration: Stores metadata and operational information for all chains:
    • Dapp chains
    • System chains
  • Chain discovery: Enables efficient node discovery and interaction between chains
  • Version management: Tracks blockchain configurations and updates

Network governance​

The Directory Chain facilitates network governance:

  • Providers: Manages network governors such as system and node providers
  • Network management: Coordinates network changes such as adding new clusters and nodes

Economy Chain integration​

The Directory Chain works in tandem with the Economy Chain to enable:

  • Provider reward logic: Allows cluster and node information to be synchronized so that providers can be rewarded appropriately
  • Container leasing: Once payment is secured, containers can be registered or upgraded in the directory chain

Integration and system queries​

To integrate Directory Chain functionality into your dapp or perform system queries, you can:

System queries and metadata​

Provider and network management​

Repository​

The Directory Chain is open source and available on GitLab:

Repository: https://gitlab.com/chromaway/core/directory-chain