Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Domains

This page introduces Domains (or Synchronizers) in Canton and explains how they are created and configured in Catalyst. Canton is a network composed of multiple domains, each operating under its own rules, governance, and set of participants. Each domain functions as an independent sub-network that participates in the wider Canton Network.

What is a Domain/ Synchronizer?

In a composed solution, each domain is a sub-network. A Participant Node connects to one or more Domains, enabling transactions that span Domains.

For more information about Participant nodes, see Participants.

How Do I Create a Domain?

To create a Domain, go to the Domains tab and click the Create button to open a side window.

1

Provide a Domain name

Enter a unique Domain name (required).

2

Fill in the main settings

Using a predefined image is recommended for compatibility. However, you can select your own image if needed. If you want to use an image from a private repository, specify an imagePullSecret. You can create an imagePullSecret in your Kubernetes cluster and reference it by name here.

  • Choose domain image

  • Enable Daemon if required

  • Enable Ingress if required

  • Resources allocation:

    • Requested CPU — Guaranteed CPU resources that will be allocated

    • CPU limit — Maximum CPU resources that will be allocated

    • Requested memory (MB) — Guaranteed amount of RAM that will be allocated

    • Memory limit (MB) — Maximum amount of RAM that can be allocated

    • Storage size

  • You can add custom environment variables if needed

3

Fill in Topology

  • Enable Embedded Topology if needed

  • Topology:

    • Choose between form or raw view topology

    • Choose Admin Port

    • Choose Public port

    • Choose Storage type:

No additional configuration required.

A PostgreSQL database will be provisioned in the cluster.

  • Choose User

  • Choose Password

  • Choose Storage size

When selecting PostgreSQL as storage type, a postgres database will be provisioned in the cluster.

For production deployments, consider using the External option below instead. See Validator Backups and Identity Dumps for recommendations on database hosting and safe pod operations.

A database is expected to be hosted at the given hostname and port, with the same name as the domain and a user with the provided credentials.

  • Choose User

  • Choose Password

  • Choose Hostname

  • Choose Port

4

Bootstrap (optional)

Provide bootstrap commands if needed.


Last updated

Was this helpful?