Documentation

Submit Externally Signed Transactions - Part 2 Complete Part 1 before proceeding. The tutorial illustrates the external signing process using two external parties, Alice and Bob, leveraging the same Ping Daml Template used in Part 1 of the tutorial. • In Part 1 Alice created a Ping contr

Local and external parties In Canton, a party represents an entity capable of creating and interacting with contracts on the ledger. Each party is hosted on one or more Participant Nodes , which act as intermediaries between the party and the ledger. Different kinds of interactions require the app

This page covers common installation problems you may encounter when setting up a Canton Network development environment, including Nix shell failures, Docker configuration, and memory allocation. Nix Problems Nix shell fails to start If nix-shell exits with a hash mismatch or download error

change the section where we provision smart contract code: - create a new empty project - use the “Understanding IOUs” section to explain the structure of a daml contract (see Java language bindings ) - transact on the IOU contract using curl and JSON Ledger API, not via console commands Getting S

Installation failures typically fall into three categories: container runtime issues, Kubernetes provisioning problems, or network-level blocks that prevent your validator from reaching the synchronizer. Docker Issues Image Pull Failures If docker compose up fails with an image pull error:

Onboard External Party This tutorial demonstrates how to onboard an external party using the Ledger API. Prerequisites This tutorial uses openssl to create keys on the file system, which is not secure for production use. From the artifact directory, start Canton using the command: ./bin

Canton relies on PostgreSQL for its storage needs. A key capability of Canton is privacy through data segregation, which results in the fact that ultimately, data must be stored reliably and cannot just be recovered trivially from other actors on the network. Use a Professional Cloud Operator Wh

Decommissioning Canton Nodes and Synchronizer Entities This page covers decommissioning a participant node. For decommissioning sequencer or mediator nodes, see Synchronizer Operations . This guide assumes general familiarity with Canton, in particular Canton identity management concepts and oper

Multi-Synchronizer Operations with the JSON Ledger API and TypeScript This tutorial shows you how to work with a multi-synchronizer Canton setup using the JSON Ledger API and TypeScript. Overview You will explore an example project that demonstrates five key scenarios: • Allocating parties an

Daml, Canton, and their underlying theory are described in the following research publications: • Daml: A Smart Contract Language for Securely Automating Real-World Multi-Party Business Workflows describes the theory underlying Daml’s language primitives for smart contracts and how Daml is compile

1.11.3 — 2026-09-17 🩹 Fixes • revert #2445 ( #2451 , #2445 ) • verify self signed token against client secret in each request ( #2392 ) • missing fe routes ( #2447 ) 🧱 Updated Dependencies • Updated @canton-network/core-wallet-dapp-rpc-client to 1.12.1 • Updated @canton-network/core-walle

Release of Canton 3.5.18 Canton 3.5.18 has been released on September 17, 2026. Summary This is a maintenace release that brings improvements to CantonBFT, LSU, and other minor improvements. What’s New CantonBFT • Batch fetching: retry patience defaults are now shorter to avoid long delay

This page collects deployment recommendations for operators running a Super Validator (SV) node. These settings are not strictly required, but following them helps your node run reliably and perform well under production load. PostgreSQL configuration The recommended values below are expressed t

This page catalogs Canton Improvement Proposals across all types. The canonical source of truth is the CIP GitHub repository , where each CIP has its own directory containing the full proposal text. To join current CIP discussions and other mailing lists, Check CIP Discuss . For background on what C

Identity Management On-ledger identity management focuses on the distributed aspect of identities across Canton system entities, while user identity management focuses on individual participants managing access of their users to their ledger APIs. Canton comes with a built-in identity management

This page covers Canton-side monitoring topics: participant node health endpoints and how to monitor ACS commitments. For Splice / Canton Network metrics specifically — what each component exposes, how to scrape it, and which metrics to watch on validators and Super Validators — see: • Splice Metr

Monitoring Best Practices Introduction Observability (also known as “monitoring”) lets you determine if Canton is healthy or not. If the state is not healthy, observability helps diagnose the root cause. There are three parts to observability: metrics, logs, and traces. These are described in th

Security-related failures typically block your validator from starting or from authenticating to the synchronizer and its APIs. The errors are often cryptic, but they fall into a few well-defined categories. Certificate Problems Certificate Expiry TLS certificates used by your validator (for i

Distributed systems can fail in many ways and finding the cause of an error is not straightforward. This guide captures the common steps our engineers take when trying to troubleshoot issues found during development or support. Key knowledge Canton transaction processing steps Canton transacti

Answers to frequently asked questions from Canton Network validators and application developers. This FAQ is compiled from actual support interactions and addresses the most common points of confusion. Getting Started What are the prerequisites for running the Canton Quickstart? Hardware Requi

Explore the Canton Network Application Quickstart demo Business case The Canton Network (CN) Quickstart is scaffolding to support development efforts to build, test, and deploy CN applications. It resolves infrastructure problems that every CN application must solve. Use the CN Quickstart Applic

Crypto key management This page explains how to list, rotate, generate, deactivate, and delete keys of a Canton node. It also explains how to configure the cryptographic schemes supported by a node. There is a separate section on the management of namespace keys. List keys Use the following c

Debugging and troubleshooting with lnav Contents Jumping In lnav is a log file viewer and navigator that helps you view, search, filter, and analyze log files. This section gets you started quickly with lnav in CN application development using LocalNet. Screenshots and instructions are mad

Canton Network quickstart installation Introduction The Quickstart application helps you and your team become familiar with CN application development by providing essential scaffolding. The Quickstart application provides a launchpad and is intended to be extended to meet your business needs. W

Whether you’re new to blockchain or migrating from another platform, this guide helps you find the most efficient path to building on Canton Network. Prefer to just start by building? The QuickStart walks you through running a full-stack Canton app that you can run on LocalNet. Quick Assessment

Canton Network is a public layer 1 blockchain designed for privacy-preserving transactions. Unlike traditional blockchains where all transactions are visible to all participants, Canton enables selective disclosure - parties see only the data they’re entitled to see. The 60-Second Pitch Canton N

The Daml SDK is the core development kit for building on Canton. It bundles the Daml compiler, Daml Script runner, Canton Sandbox, and supporting tools into a single installable package managed through dpm. What’s Included The Daml SDK provides the following components: • Daml compiler — Comp

1.11.2 — 2026-09-12 🩹 Fixes • temp disable client_id check ( #2445 ) ❤️ Thank You • Marc Juchli @mjuchli-da

1.5.0 Released on September 9th, 2026 • Correctly handle holding locks which have a relative expiresAfter previously, holdings with a relative expiresAfter could be incorrectly considered locked forever. This fix also revealed some misleading typings in the SDK which are now corrected. i

1.5.1 Released on September 10th, 2026 • Added support for Canton 3.6.X