Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.canton.network/llms.txt

Use this file to discover all available pages before exploring further.

Per-version migration steps live with the component release notes. Use the links below for the change you are migrating across.

Within Canton 3.x

From Canton 2.x to 3.x

Canton 3.x is a major release with backward-incompatible changes across the SDK, APIs, and runtime. The high-level shape of the migration:
  • SDK toolingdaml CLI is replaced by dpm.
  • Ledger API — services have been restructured. Regenerate gRPC stubs from the 3.x protobuf definitions, or update to a 3.x client library.
  • Package management — the new Smart Contract Upgrade (SCU) mechanism replaces the previous upgrade model.
  • Synchronizer terminology — what was previously called a “domain” is now called a synchronizer throughout the APIs and documentation.
  • Daml exceptions — deprecated and being removed. Replace with preconditions, encoded return types, or workflow patterns.
For a worked migration path, build against the cn-quickstart reference application and consult the version-specific release notes above.