Module 1: Understanding Canton

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.

Module 1: Understanding Canton

Build the foundational understanding needed for Canton development

This module provides the conceptual foundation you need before writing Canton code. Even if you’re eager to start coding, taking time to understand these concepts will make you more effective.

Module Overview

Why This Module Matters

Canton is not just another blockchain with different syntax. It represents a fundamentally different approach to distributed ledgers:

• Privacy is native, not bolted on
• Consensus is targeted, not global
• State is distributed, not replicated
• Authorization is declared, not coded

Understanding these principles upfront will save you from fighting against the architecture later.

Core Insights

Privacy First

On most blockchains, you build an application and then try to add privacy. On Canton, you start with privacy and choose what to reveal and whom to reveal it to.

flowchart LR
    subgraph Traditional[Traditional Blockchain]
        T1[Build app] --> T2[Add privacy layer]
        T2 --> T3[Hope it works]
    end

    subgraph Canton[Canton]
        C1[Design privacy] --> C2[Declare visibility]
        C2 --> C3[Privacy enforced]
    end

No Global State

There is no single “blockchain” you can query for all information. Each party has their own view of the ledger.

Immutable Everything

Contracts don’t change. When you “update” a contract, you archive the old one and create a new one. This isn’t a limitation—it’s the foundation of privacy and integrity guarantees.

Explicit Authorization

You declare what each party can do at compile time, and the protocol enforces it. Unlike traditional systems where you check caller identity at runtime, Canton’s authorization is structural.

Prerequisites Check

Before proceeding, you should:

• Understand what Canton is (Five-Minute Overview)
• Know the basic components (Core Concepts)
• Have programming experience (any language)

No blockchain experience is required—and if you have it, be prepared to unlearn some things.

What You’ll Learn

By the end of this module, you’ll understand:

1. How to think about Canton’s privacy model
2. The relationship between parties, validators, and synchronizers
3. How transactions flow through the system
4. What tools you’ll use for development

Learning Path

After completing this module, continue to:

• Module 2: If you have Ethereum/blockchain experience
• Choose your path: If you’re ready to start writing Daml

Mirrored from Canton Network official documentation (CC-BY-4.0) by CC Privacy Club for learning purposes.