Canton Network Onboarding Guide

Get Started

CF Onboarding & Dev Fund Guide

Everything builders, validators, and grant applicants need in one place.

DevNet Build
TestNet Validate scale
MainNet Production Live

Every participant follows the same progression. All three networks require IP whitelisting.

Part 1

Builder onboarding

A step-by-step path for builders and validators joining the Canton ecosystem.

Before you start

Choose your path

All participants follow the same network progression. Which steps apply depends on what you're here to do. Pick a path to highlight your route through the guide.

App Builder

Install the SDK, build locally, then get whitelisted and deploy through DevNet, TestNet, and Finally MainNet.

Steps 1 to 7

Validator only

Skip the SDK and local dev steps. Start at Step 3 (hosting model). Tokenomics Committee approval is required for Setup.

Steps 3 to 7

01

App Builders only

Install dpm

Install the Daml Package Manager (DPM).

install dpm
curl https://get.digitalasset.com/install/install.sh | sh

Then create a new project:

new project
dpm new my-project --template daml-intro-contracts
02

App Builders only

Set up local development

Before getting to DevNet, You can try the Canton Network Quickstart to run a LocalNet.

Requirements

Docker with 8 GB+ RAM (set in Docker Desktop settings) · Java SDK Eclipse Temurin JDK 21.

quickstart
git clone https://github.com/digital-asset/cn-quickstart.git
cd cn-quickstart/quickstart
make setup    # choose standard/test mode, OAuth options
make build
make start    # first run triggers setup assistant

Once running, access the local UIs:

03

Validator ops can start here

Choose your hosting model

Decide how you want to run your validator node before requesting any network access.

Self-host

You manage all infrastructure, upgrades, and maintenance across every network.

04

Infrastructure

Set up a static IP

Your validator node requires a static IP address for all outbound traffic. Provision this before requesting network access, whitelisting is tied to this IP across DevNet, TestNet, and MainNet.

05

Sponsorship

Find a Super Validator sponsor

You need an existing Super Validator (SV) to sponsor your onboarding. Your sponsor will:

  • Submit your TestNet and MainNet whitelisting requests to the Featured Applications and Validators committee.
  • Provide your onboarding secret on TestNet and MainNet (You do NOT need Secert on DevNet) as you cannot self-serve this on live networks.
  • Supply the Canton software packages needed to set up your node.

Browse active Super Validators and reach out directly. Confirm your sponsor before submitting any whitelisting forms — their contact details will be required.

No sponsor yet?

The Canton Foundation can act as your sponsor. Reach out at canton.foundation.

06

Get it Started

Get onto DevNet

6a

Request DevNet whitelisting

Submit your static IP via the DevNet whitelisting form.

Super Validators need to update their config files and conduct an on-chain vote to adopt the new IP.

DevNet whitelisting form →

6b

Set up your node infrastructure

While waiting for whitelisting, prepare your node environment:

  • Provision a VM or Kubernetes cluster (Kubernetes recommended for production).
  • Set up OIDC authentication (Auth0, Keycloak, or equivalent).
  • Download Canton software packages from your SV sponsor.

6c

Get your DevNet onboarding secret

Once your IP is whitelisted, get your onboarding secret. On DevNet you can self-serve this:

onboarding secret
curl -X POST SPONSOR_SV_URL/api/sv/v0/devnet/onboard/validator/prepare

SV URLs are listed at canton.foundation/sv-network-status-2.

You're on DevNet

You can now set up parties, upload DARs, test token transfers & run onboarding workflows.

07

Going live

Apply for TestNet & MainNet

You can submit your MainNet application while still working on DevNet, the 2 to 3 week approval process runs in parallel, so you don't need to wait until DevNet testing is complete.

Timeline

End-to-end approval typically takes Min 2 to 3 weeks. Applications go through manual compliance review (banned countries and invalid contacts are rejected), then Tokenomics Committee review on a weekly cadence.

TestNet

Same deployment pattern as DevNet. Your SV sponsor submits the whitelisting request to the Featured Applications and Validators committee. The onboarding secret must come from your sponsor so. no self-serve.

MainNet

Everything TestNet requires, plus Tokenomics Committee approval. Min. 7 day wait for SVs to adopt config changes via on-chain vote. Once live, your validator is eligible for Canton Coin rewards.

Part 2

The Development Fund

A grant program that funds open development strengthening the Canton Network.

Overview

What is the Development Fund?

The Canton Development Fund funds open development that strengthens the network. It was established through CIP-0082 and CIP-0100 and is administered by the Canton Foundation as a neutral facilitator.

Unlike grant programs at other networks, there is no premine or central treasury. Instead, 5% of Canton Coin emissions are programmatically reallocated to the fund across the reward streams a durable, predictable source of funding tied directly to network activity. Funding decisions are made by the Tech & Ops Committee, with milestone-based payments denominated in Canton Coin.

Eligibility

What gets funded?

The fund supports work that is a public good for the Canton ecosystem, not commercial products, and not work that primarily benefits a single organization.

Core protocol R&D Developer tooling & SDKs Security reviews & audits Reference implementations Critical ecosystem infrastructure

Access

Who can apply?

Foundation members & contributors

Canton Foundation members and Tech & Ops contributors can submit proposals directly.

External teams & individuals

Can also apply, but must be supported by a Champion who is a Core Contributor, SIG Member, or member of the Tech & Ops Committee.

If you're external and don't yet have a champion, finding one is your first step.

01

Development Fund

Find a champion

A champion vouches for your proposal, helps you refine it, and guides it through review. Champions aren't responsible for delivering the work, they help ensure the proposal reaches the bar the committee expects.

Who can be a champion

A Tech & Ops Voting Committee Member Organization or an SIG Member or a Core Contributors Group Member. SIGs help the committee, Core Contributors, and Voting groups evaluate proposals, SIG members can champion directly or connect you to a potential champion.

To find a champion:

  • Cross-reference the SIG Directory to find named individuals with expertise relevant to your work, the best signal of who is engaged in your area.
  • Or reach out via approved GitHub PRs to the championing organizations in them. Be specific: describe your proposal in 2 to 3 sentences and ask whether they'd be willing to champion it.
02

Development Fund

Prepare your proposal

All proposals are submitted as Markdown files via Pull Request to the canton-dev-fund repository's proposals/ directory. Use the PR template at .github/pull_request_template.md and don't skip sections. It requires:

  • Objective and scope: what problem does this solve, and for whom?
  • Technical approach: how will the work be implemented, in depth?
  • Architectural alignment: how does it fit Canton's architecture and priorities?
  • Milestones and deliverables: what will be produced, and by when?
  • Acceptance criteria: how will reviewers objectively verify each milestone?
  • Funding request: how much $CC per milestone?

What makes a strong proposal

Public good framing

Clearly explain the shared benefit to the ecosystem. If the primary output is a commercial product, it won't pass the public good gate regardless of technical quality.

Objectively verifiable acceptance criteria

Each milestone needs criteria an independent reviewer can check without your attestation. "A working indexer with documented API endpoints and integration tests" is verifiable. "A high-quality solution" is not.

Sustainability

Explain who will operate and maintain the output after the grant period ends. Reviewers want a credible answer, not a vague commitment.

GTM & adoption strategy

Mandatory, not optional. Adoption is the primary indicator of success. Be specific on target users, how they'll discover the tool, and what initial adoption looks like.

Milestone based structure

Organize work into discrete milestones with payment tied to completion.

03

Development Fund

Submit your Pull Request

Once your proposal document is ready:

  1. Fork the canton-dev-fund repository.
  2. Add your proposal as a Markdown file under proposals/<project-name>.md.
  3. Open a Pull Request.
04

Development Fund

The review process

SIG review

Special Interest Groups (SIGs) are architects, engineers, and domain experts organized by technical area, from Daml Language & Developer Tooling to DeFi Protocols, Token Standards, and Node Operations. SIG members may self-assign your proposal and provide feedback. Indicate in your PR which SIG you believe your proposal aligns with so the right reviewers find it quickly. SIG membership is open to any ecosystem participant.

Why a proposal moves to "Needs Revision"

  • Milestones are unclear or not measurable.
  • Scope is too broad or underspecified.
  • Ecosystem benefit is not clearly demonstrated.
  • Adoption metrics, GTM, or success criteria are missing.
  • Security or operational implications need clarification.

Reviewers leave specific feedback in the PR. Address comments by updating the proposal file directly, and it re-enters the review queue.

Moving toward a vote

When a champion believes the proposal is ready, it moves to Ready for Vote, reviewed by Voting Committee members, Core Contributors, and the Security Group, giving all reviewers time to read and comment before voting begins.

Track your status

The official proposal board is the authoritative source of truth. Columns include In Review, Needs Champion, Needs Revision, and Ready for Vote.

Funding

Payment & milestones

  • Funding is denominated and paid in Canton Coin (CC).
  • Funding may be paused or stopped if milestones are not met or are disputed.
  • The committee may issue Requests for Proposals (RFPs) for strategic work, watch Foundation channels for announcements.

Reference

All links in one place

Copied to clipboard