Official hackathon approved by the Canton FoundationSponsorsTempleDigital AssetWalletAlpendCashen
See the timeline
HackTrail
Developer Hub

Everything you need to build on Canton

If you are starting from zero, follow the steps in order; if you are experienced, jump to the section you need. All links go to official Canton resources. If you get stuck, ask the HackTrail Assistant.

Getting started

Three official sources

Everything you need is at these three official addresses. The other sections take you straight to the right page.

Documentation

docs.canton.network: concepts, guides, Quickstart and API references.

Open

Developer Hub

dev-hub.canton.foundation: tools, SDKs and APIs, plus an AI assistant that answers from the docs.

Open

Forum

forum.canton.network: questions and discussions. Your question may already have an answer.

Open

A working Canton project in five steps

  1. Get to know Canton

    The privacy model, parties and who sees what. This is what sets Canton apart from other chains.

  2. Choose your learning path

    New to blockchain, or coming from Ethereum? The official docs suggest a path for you.

  3. Install dpm

    Install the Daml SDK with one command, then create and test your first project.

  4. Run LocalNet with Quickstart

    Run a full app with a Daml model, backend and frontend on your own computer.

  5. Get ready to submit

    Follow the pre-submission checklist: README, demo video and a "who sees what" explanation.

Suggested first week

When you get stuck

Canton Forum

Official support channel: technical questions, answers and announcements.

Open

HackTrail Telegram

Hackathon questions, announcements and finding teammates.

Open
Setup

Setup in four steps

Go in order. The first two steps are enough to write Daml; install Quickstart too for a full app.

1. Is your computer ready?

An ordinary computer is enough to write and test Daml. If you will run a full LocalNet with Quickstart, we recommend the values below.

Daml only (dpm)Quickstart and LocalNet
Memory (RAM)8 GB16 GB or more
Processor2 cores4 cores
Free disk5 GB50 GB
Operating systemmacOS, Linux, WindowsmacOS, Linux, WSL 2 on Windows
Extra softwareNoneDocker Desktop (Compose 2.27 or later), direnv, Nix, curl

Set Docker Desktop memory to at least 8 GB, ideally 16 GB. Low memory is the most common setup problem.

Don't want to deal with setup? With Seaport you can write and build Daml contracts in the browser and deploy them to DevNet. For a quick try without Docker, dpm sandbox is enough; for a full local environment without Docker on Windows and Linux, use Raposza Tools.

2. Your first Daml project with dpm

dpm is the official command-line tool for Canton development: SDK install, project creation, build, test and local environment. It replaces the old daml commands.

macOS and Linux
$ curl https://get.digitalasset.com/install/install.sh | sh
$ export PATH="$HOME/.dpm/bin:$PATH"   # add it to your shell profile to keep it
$ dpm install latest
$ dpm version --all

On Windows, use the official installer. As SDK version, pick the one running on DevNet; the compatibility table is at the link below.

first project
$ dpm new my-project --template daml-intro-contracts
$ cd my-project
$ dpm build     # builds the DAR package
$ dpm test      # runs the Daml Script tests
$ dpm sandbox   # single-participant local ledger
$ dpm studio    # Daml Studio in VS Code

3. LocalNet with Quickstart

CN Quickstart runs a full sample app with a Daml model, Java backend, React frontend and Canton Coin payments on Docker. First open Docker Desktop and run docker login.

cn-quickstart
$ git clone https://github.com/digital-asset/cn-quickstart.git
$ cd cn-quickstart
$ direnv allow
$ cd quickstart          # make commands run in this folder
$ make setup             # choose OAuth2 on, Observability off
$ make build
$ make start
$ make capture-logs      # optional, in a separate terminal
$ make stop && make clean-all   # to shut down

The first setup can take 30-90 minutes because of the SDK download. Local UIs: app-provider.localhost:3000, wallet.localhost:2000, scan.localhost:4000.

4. Choosing a network: LocalNet is enough

You can build and submit your project on LocalNet on your own computer; that is enough for the jury. DevNet is optional.

Sponsor tools

Our sponsors' tools

Our main sponsors' products, docs and training videos are in this section.

Five North

Loop Wallet and Loop SDK

Loop SDK connects your dApp to a Loop wallet. Users sign transactions in Loop Wallet on mobile or in the browser; the whole interaction stays inside your dApp.

app.js
// npm install @fivenorth/loop-sdk
import { loop } from '@fivenorth/loop-sdk';

loop.init({
  appName: 'HackTrail dApp',
  network: 'devnet',            // 'local' | 'devnet' | 'mainnet'
  onAccept: (provider) => console.log(provider.party_id),
  onReject: () => console.log('rejected'),
});

loop.connect();                     // opens the QR-code connection window
Five North

Seaport

Seaport is a cloud platform for writing, building, deploying and managing Daml contracts. You work in the browser without installing anything; it's a hosted alternative to setting up LocalNet.

Canton Coin

Tools

Ecosystem tools

We picked the most useful tools for the hackathon from the Canton Foundation's Developer Hub catalogue. Descriptions are short summaries; details are on each tool's own page. Review "Community" and partner tools yourself before using them.

Canton Foundation training videos

Videos load from YouTube when you click them. They are in English.

Ready-made templates and contracts

OpenZeppelin Canton Contracts

Reusable Daml components: timed and revocable permissions and pausable contracts.

Open

Five North ID SDK

Identity verification and credential management with smart contracts.

Open

Local development

Canton Builder Tool

A Canton Foundation tool to run your project on LocalNet in a few commands.

Open

Canton DevKit

Command line and local web UI for managing LocalNet: DAR management, ledger inspection, snapshots.

Open

dpm

Daml Package Manager: the official command-line tool to install the Daml SDK, manage versions, and build and test projects.

Open

Canton dAppBooster

Starter kit with a local Canton stack, React hooks, ready UI components, wallet support and a demo dApp.

Open

Raposza Tools

Local Canton on Windows and Linux without Docker: sandbox, LocalNet and a workbench that shows your contracts.

Open

canton-deploy

Command-line tool to upload Daml packages to a validator, allocate parties and run scripts.

Open

Wallet connection

dApp SDK and Wallet SDK

Browser SDK for dApps and integration SDK for wallet providers.

Open

WalletConnect

The network that connects Canton-compatible wallets to dApps.

Open

PartyLayer

Connects every CIP-0103 wallet to your dApp through one connection layer; React, Vue and React Native packages.

Open

Data and explorers

Loop Data

Free, public explorer and network data for the Canton network.

Open

CCView Explorer

Explorer showing Canton network activity in real time.

Open

Noves

Data API with transactions, balances and network metrics for Canton apps.

Open

Security, testing and debugging

daml-lint

Static analysis tool that scans Daml contracts for security anti-patterns.

Open on GitHub

Canton Security 101

A Canton-focused guide to Daml development, web app and operational security.

Open

dpm trace

A dpm plugin that visualizes transactions and shows why a submission failed.

Open on GitHub

Write Daml with AI

Canton docs MCP server

Connects the official Canton docs to your AI assistant. Address: docs.canton.network/mcp. No authentication needed.

Setup

Canton Developer Hub

The Canton Foundation's tool catalog and an AI assistant that answers from the docs.

Open

Claude Code Daml Skill

The Canton Foundation's official Claude Skill: gives your assistant up-to-date, accurate knowledge of Daml contracts on Canton.

Open on GitHub

CCPedia

An AI-ready Canton knowledge base over CIPs, the forum, GitHub, docs and videos; it also has an MCP server.

Open

Build-on-Canton MCP

Community MCP integration that gives your assistant knowledge of building on Canton.

Open on GitHub

Always test AI-generated code. If you used it, say so in the submission form.

Before you submit

What will the jury look for in your project?

Check this list before you submit. The jury does not have to set up your project; they look at the video, repo and README. The organizer confirms in the pre-check that the project runs.

Private Daml transactions do not appear in explorers; that is not a bug, it is Canton's privacy model. Explorers only show Canton Coin and network transactions.

Troubleshooting

Common problems

Setup

Containers stay "unhealthy".

It is almost always low memory. Raise Docker Desktop memory to 16 GB, run make clean-all and in make setup, turn Observability off.

make commands don't work.

Make sure you run the commands inside the cn-quickstart/quickstart folder.

I get errors after a Docker Desktop update.

Docker Desktop 4.38.0 has a known bug. Update Docker Desktop to the latest version.

The SDK download stopped halfway or is corrupted.

make install-daml-sdk downloads the SDK again. The first download can take a few minutes.

Nix gives an SSL error.

This happens on corporate networks and behind proxies. Try a personal network if you can.

Local addresses don't open in the browser.

Safari can have trouble with these local addresses; use Chrome or Firefox.

Development

Which SDK version should I use?

The version running on DevNet. Use dpm version --all to see installed versions, and check the DevNet version in the compatibility table.

My transaction doesn't show up in the explorer.

That's normal. On Canton, app transactions are private and only the parties see them. Explorers only show Canton Coin and network transactions.

Can I use the old Daml 2.x docs?

No. docs.daml.com covers the old 2.x version. For Canton Network, use the current docs at docs.canton.network.

I can't access DevNet.

DevNet is optional; you can submit with LocalNet too. For DevNet, follow the steps in the official guide; if you run into problems, write to us with "Report a problem" in your panel.

Grant

After HackTrail: the Canton Foundation grant

The Canton Foundation's Protocol Development Fund supports work that adds long-term value to the whole network. Strong HackTrail projects can apply to this program.

Need help?
The HackTrail Assistant answers your questions about applying, the timeline and Daml.