Chain follower

A chain follower such as DB Sync is a component that observes the transactions on the main chain such as Cardano. The chain follower provides the information for a sidechain to stay consistent with the main chain.

The DB Sync page gives detailed information about the functionality and how to set it up.

Using the chain follower on a sidechain

The sidechain node uses DB Sync for getting information regarding the main chain.

This is a non-exhaustive list of data retrieved from the main chain:

  • The nonce for a given epoch
  • The stake distribution for a given epoch
  • The list of UTXO for a given address, after a given block
  • The latest block for a slot
  • The latest block for the chain
  • The block information for a given block number
  • The slot number corresponding to a UTXO
  • The cross-chain transactions for a given policy, asset name, and a range of blocks within a slot
  • The cross-chain transactions for a given policy, asset name, and a UTXO ID.

The sidechain client uses DB Sync to listen to the mainchain’s activity, and perform various tasks:

  • Update the sidechain pool committee: a specific transaction is done on the main chain, observed with DB Sync, and taken into account to determine the next slot’s pool committee on the sidechain
  • Transfer funds from the main chain to the sidechain: when a token is burned on the main chain, the corresponding transaction is observed with DB Sync, and used to provide corresponding funds on the sidechain.

Transferring funds back from the sidechain to the main chain doesn’t use DB Sync, but a different mechanism.

Configuring the sidechain node to use your DB Sync instance

After installing and setting up a DB Sync instance, you need to configure a sidechain node to point to it. In the node’s configuration file, set the data source type to db-sync and configure connection details to match your setup. The finished configuration should look similar to the example below:


  "sc-evm": {
        "sidechain": {
            "datasource": {
                "db-sync": {
                    "connect-thread-pool-size": 4,
                    "driver": "org.postgresql.Driver",
                    "host": "",
                    "name": "your db sync instance name",
                    "port": 5432,
                    "username": "your db sync username"
                    "password": "your db sync password",
                "type": "db-sync"