# Directory Chain · Chromia Docs (concept)

> 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.

Source: https://docs.chromia.com/get-started/about/architecture/chains/directory-chain/

# Directory Chain

On this page

* [Overview](#overview)
* [Core functions](#core-functions)
* [Chain registry and management](#chain-registry-and-management)
* [Network governance](#network-governance)
* [Economy Chain integration](#economy-chain-integration)
* [Integration and system queries](#integration-and-system-queries)
* [System queries and metadata](#system-queries-and-metadata)
* [Provider and network management](#provider-and-network-management)
* [Repository](#repository)

## 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

* **System queries**: Use [Rell system queries](https://docs.chromia.com/rell/language-features/systemlib/system-queries/) to retrieve network
  information and chain metadata
* **Chain discovery**: Learn how to [connect clients to your dapp](https://docs.chromia.com/get-started/create-dapp/deploy-to-testnet/) using
  Directory Chain for node discovery
* **Network configuration**: Understand
  [Directory Chain configuration](https://docs.chromia.com/ecosystem/providers/nodes/directory-chain-config/) for custom deployments

### Provider and network management

* **Provider operations**: Explore [PMC commands](https://docs.chromia.com/ecosystem/providers/pmc/) for advanced Directory Chain interactions
* **Container management**: Learn about
  [adding providers to voter sets](https://docs.chromia.com/ecosystem/providers/container-management/add-dapp-provider-to-voterset/) and
  [transferring container ownership](https://docs.chromia.com/ecosystem/providers/container-management/transfer-container-ownership/)
* **Blockchain authentication**: Understand
  [blockchain-based provider authentication](https://docs.chromia.com/ecosystem/providers/blockchain-based-provider-authentication/) for
  Directory Chain operations

## Repository

The Directory Chain is open source and available on GitLab:

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

[View this page on docs.chromia.com](https://docs.chromia.com/get-started/about/architecture/chains/directory-chain/)Content mirrored from the live docs
