LEARN · DOCUMENTATION
Documentation
Pages from 29 sources, kept in sync: the official Canton Network and Digital Asset docs, documentation from teams building on Canton, and readmes from their code. Search all of it, or start from a path below.
3,253pages
synced 3h ago29 sources
Official
SV Upgrades
There are two types of upgrades: Version upgrades (this corresponds to an upgrade from 0.A.X to 0.B.Y) and protocol upgrades (the actual versio…
May 16, 2026
Official
Validator Upgrades
There are two types of upgrades: Version upgrades (this corresponds to an upgrade from 0.A.X to 0.B.Y) and protocol upgrades (the actual versio…
May 16, 2026
Official
Smart Contract Upgrades Overview
…, and entirely new workflows get introduced. Smart Contract Upgrade (SCU) is the mechanism that makes this possible without breaking existing contracts or requiring coordinated dow…
May 16, 2026
Official
Upgrade Deployment
Deploying an upgrade means getting newer version packages onto all relevant validators and transitioning workflows from the current v…
May 16, 2026
Official
Testing Upgrades
…work. You need to verify both that the compiler accepts the upgrade and that workflows continue to function with mixed package versions. Type-Level Compatibility Tests A type-level…
May 16, 2026
Official
Deployment Progression
…production network that mirrors MainNet’s configuration and upgrade cadence. Used for final validation before production deployment. • MainNet — The production Canton Network. Real…
Jul 1, 2026
Official
Writing Your First Upgrade
…dd an optional field and a new choice, then verify that the upgrade compiles and that existing contracts work with the new code. Prerequisites • A working dpm installation with the…
May 13, 2026
Official
Upgrade Canton Nodes
Upgrade To a New Release This section covers the processes to upgrade Canton participant nodes and synchronizers. Upgrad…
Jun 9, 2026
Official
Smart Contract Upgrades in Production
…een parties, often across organizational boundaries, and an upgrade that works on your validator may behave differently when counterparties are running mixed versions. This page co…
May 12, 2026
Official
Logical Synchronizer Upgrades
Logical synchronizer upgrades (LSUs) allow upgrading the protocol version of a synchronizer with very limited network downtime and no operati…
Nov 6, 2026
Official
Smart Contract Upgrading Reference
… and how contracts, choice arguments and choice results are upgraded or downgraded at runtime. These topics are for a large part covered in Smart Contract Upgrade. This document ac…
Jun 6, 2026
Official
SV Operations Schedule and release calendar
…e that calendar whenever you need a specific release date , upgrade window, or network operations timeline. It is the source of truth for scheduled network activity across DevNet ,…
Sep 2, 2026
Official
Upgrade Limitations
Smart contract upgrades (SCU) in Daml are powerful but have firm boundaries. Understanding these limitations upfront prevents surprises…
May 16, 2026
Official
Smart Contract Upgrade (SCU)
Smart Contract Upgrade Overview What is Smart Contract Upgrade (SCU)? Smart Contract Upgrade (SCU) allows Daml models (packages in DAR …
Oct 29, 2026
Official
Package Selection
…and vetting rules determine whether the fetch succeeds (see Upgrade Compatibility ). • Exercising choices — The choice body from the version your code references is executed, not t…
May 16, 2026
Official
CF Policies
…ating in governance on behalf of its members • Coordinating upgrade schedules and network policies across the Super Validator set • Supporting ecosystem development through outreac…
Jul 16, 2026
Official
Upgrade Compatibility
SCU defines strict rules about which changes to Daml models are backward-compatible. The Daml compiler enforces these rules at build time — if your v2 package introduces a breaking…
Jul 14, 2026
Official
Common Questions
Setup How do I get onboarded to TestNet or MainNet? Onboarding to TestNet requires a Super Validator (SV) sponsor. Contact the SV you are working with, or reach out through the #va…
Jun 22, 2026
Official
Package Naming
…reaking changes that require a new package (as described in Upgrade Limitations ). Non-breaking upgrades (adding optional fields, new choices) happen within the same package name —…
May 16, 2026
Official
The Daml Compiler
The Daml Compiler At the core of the Daml toolchain lies the Daml Compiler, also known as damlc. Its primary usage is to compile Daml source code, which defines smart contracts and…
Jul 6, 2026
Official
SV Operated Networks and Use
…availability and operate on a best-effort basis, validating upgrades in a timely and appropriate manner. They employ this environment for load testing and perform periodic resets a…
Jul 15, 2026
Official
Daml.Script
Daml module Daml.Script The Daml Script testing library. Daml Updated 3.5.2 Module Daml.Script Latest release 3.5.9 Data Types data InvalidUserId Thrown if text for a user identifi…
Sep 22, 2026
Official
Validator Roles and Responsibilities
…Performance : Ensure adequate resources for your workload • Upgrades : Stay current with network versions • Monitoring : Track health, performance, and errors • Backup : Regular ba…
Jul 16, 2026
Official
Introduction to Node Operations
The Global Synchronizer is the public coordination layer of Canton Network, operated by a decentralized set of validators. This section introduces what it means to operate a node o…
Jun 10, 2026
Official
The Global Synchronizer
The Global Synchronizer is the public infrastructure backbone of Canton Network, a decentralized synchronizer operated by Super Validators. What It Is The Global Synchronizer is: •…
Aug 11, 2026
Official
Package Management
…ion validators and vet it. • Deprecate — After a successful upgrade cycle, unvet old package versions. Version Pinning Pin the SDK version in your daml.yaml to avoid accidental upg…
May 16, 2026
Official
Operational Issues
…d set up auto-top-up before deploying production workloads. Upgrade Issues Version skew between Daml packages When you deploy a new version of your Daml package alongside an existi…
May 12, 2026
Official
GET /v0/lsu
…0 { "lsu": { "topologyFreezeTime": "2026-01-01T00:00:00Z", "upgradeTime": "2026-01-01T00:00:00Z", "successorPhysicalSynchronizerId":
Aug 31, 2026
Official
com.digitalasset.canton.admin.topology.v30
…hronizerPredecessor 3 fields predecessor_physical_id string upgrade_time Timestamp is_late_upgrade bool
Nov 5, 2026
Official
Status Definitions and Compatibility
Semantic versioning, release cadence, and support duration are defined in Releases and Versioning . This page defines: the public API surface, status labels, and the compatibility …
Sep 3, 2026
Showing 1 to 30 of 148Search all sources →