Canton Validators

Dfns supports the Canton network, including self-hosted validators. For more information, you can read our announcement on our blog.

The Canton Network is a speciality chain that requires a dedicated activation by Dfns teams.

Please reach out to your account manager or raise a support request indicating your organization id so we can activate it for you.

1/ Setup a Canton Validator

Dfns offers two options for interacting with the Canton Network:

Option 1: Use Dfns’ shared validator

This is the easiest way to start quickly broadcasting transactions with Canton wallets.

Create a new validator, name it and select kind "shared" when requested and you are done.

Via API: see details here for the related endpoint to call.

Via the Dashboard: head to the dashboard: Settings > Developers > Canton Validators (direct link) and click ➕ New Validator to access the creation form. Once you are done you will be requested to 🔑 sign the creation with your passkey. Then you are done!

Option 2: Connect your own validator (BYOV)

If you are running your own validator, then you can connect it to Dfns over API (see details here) or via the Dashboard. Once connected, you can create secure wallets linked to your validator. There is no extra setup needed on your validator side.

You will always earn the rewards associated with the validator in the native wallet on that validator.

We recommend configuring a automated sweep into a separate Dfns-secured Canton wallet to ensure your coins are safe. See an example configuration here.

We need several information to be able to connect to your validator:

  • The validator URL: we expect to be able to call the validator External Signing API, for instance $URL/api/validator/v0/admin/external-party/topology/generate. See the underlying calls details here. The calls will be originating from our IP addresses (see Dfns Environments)

  • The Validator OAuth2 authentication parameters: this is how we will authenticate into your validator. You should have setup authentication already (see details here), you can reuse the same Application details. For convenience you can find some examples with some common providers on Sample request body for Custom

    • Domain: your OAuth2 tenant domain. Provided by your auth provider.

    • Token Path: token endpoint from your authorization provider. We will call this endpoint on your tenant domain (i.e.: <domain>/<token path>)

    • Audience: the audience your configured on your auth provider. It is suggested to start with https://canton.network.global.

    • Client ID: The client id from your auth provider for this application.

    • Client Secret: The client secret from your auth provider for this application.

  • The Ledger API URL: URL to access the Ledger JSON API and call endpoints such as /v2/state/ledger-end, /v2/state/active-contracts, /v2/parties/participant-id, /v2/interactive-submission/prepare, /v2/interactive-submission/execute, /v2/commands/completions. See the underlying details here. The calls will be originating from our IP addresses (see Dfns Environments)

  • The Ledger OAuth2 authentication parameters: this is how we will authenticate to your ledger API. This will usually use the same parameters as for the validator.

Once you have gathered these information, you can start setting up the custom validator on Dfns.

Via API: see details here for the related endpoint to call.

Via the Dashboard: head to the dashboard: Settings > Developers > Canton Validators (direct link) and click ➕ New Validator to access the creation form. Once you are done you will be requested to 🔑 sign the creation with your passkey, then you are done!

Canton Validators support a limited number of wallets. You can connect several validators to your Dfns account.

Check out the video tutorial on our Youtube Channel:

2/ Setup a Canton Wallet

1

Create a Canton Wallet

Once setup using the shared or your own validator, you can create wallets via the dashboard Wallets page or via the Wallets API. You will be requested to select the validator you want to leverage.

Should you need help to create a wallet, you can watch the video above, or follow the tutorial: Using the dashboard: create your first wallet or use our deditated API doc: Create Wallet

2

Pre-approve assets reception

To do before sending assets to your Canton Wallet

The Canton networks has two ways of transferring funds: offers that need to be explicitely accepted, or automated transfers.

Dfns does not yet support responding to transfer offers (it's coming soon!).

You need to pre-approve receiving Canton Coins to make it automated before issuing a transfer to your wallet. After that receiving Canton Coins will automatically be accepted.

Note: if you sent an offer before approving assets, then it will automatically expire within 24hrs.

Pre-approve receiving assets into your Canton Wallet from the Dashboard Wallet page.

Click " Approve Assets" button on the dashboard, then " Approve" for the assets needed.

API reference

Create ValidatorList Validators

Last updated