Canton’s architecture enables use cases that are not feasible on public blockchains. This page explores key patterns and concrete examples.Documentation Index
Fetch the complete documentation index at: https://cantonfoundation-issue-409-bottom-header-height.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Delivery vs. Payment (DvP)
The canonical example of Canton’s capabilities is atomic delivery vs. payment across different assets and parties.The Scenario
Alice wants to buy a tokenized asset from Bob, paying with a tokenized cash instrument settled on a private payment synchronizer. The settlement should be:- Atomic: Either both legs complete, or neither does
- Private: Observers shouldn’t see the counterparties or the price
On Traditional Blockchains
This is problematic:- If done in two transactions: risk of one completing without the other
- If done atomically: all parties (and observers) see all legs of the trade
- Anyone watching can see the price and terms
On Canton
The entire exchange happens in a single atomic transaction with sub-transaction privacy:| Party | Sees | Doesn’t See |
|---|---|---|
| Alice | Both legs (she is the buyer) | N/A |
| Bob | Both legs (he is the seller) | N/A |
| Third party | Nothing | Everything about this trade |
This example assumes the cash and asset legs both settle on synchronizers where the trade participants are the only stakeholders — for instance, a private payment synchronizer for the cash leg and a private securities synchronizer for the asset leg. Trades that involve assets settled on the Global Synchronizer behave differently: Canton Coin transfers, topology transactions, and network governance transactions are visible to the Super Validators that operate the Global Synchronizer, so they are not private in the same sense. Private synchronizers preserve the full sub-transaction privacy model.
Why This Matters
- Regulatory compliance: Each party sees only their entitled information
- Atomic settlement: No settlement risk — both legs or neither
- Privacy: Trading relationships and prices protected
- Audit trail: Entitled auditors can be added as observers
Tokenized Securities
Issue and trade securities with regulatory compliance built in.Requirements
- Issuer controls who can hold the security
- Regulator has audit visibility
- Trades are private between buyer and seller
- Corporate actions affect all holders (but holdings remain private)
Canton Design
Cross-Border Payments
Move value across jurisdictions while respecting data sovereignty requirements.The Challenge
- Sender’s bank is in Country A with data localization requirements
- Receiver’s bank is in Country B with different requirements
- Correspondent banking requires coordination
- Neither country’s regulator should see the other’s customer data
Canton Solution
Each jurisdiction’s data stays with validators in that jurisdiction:- Sender’s details stay in Country A
- Receiver’s details stay in Country B
- Settlement is atomic across the synchronizer
- Each regulator sees only their jurisdiction’s data
Syndicated Loan Management
Multiple banks participate in a loan without seeing each other’s positions or terms.The Scenario
In syndicated loans:- Multiple banks hold portions of the same loan
- Each bank’s position is confidential
- The agent bank coordinates payments
- Borrower interacts with the group as a whole
Canton Solution
Each bank sees:- Their own position and terms
- Payments flowing to/from them
- Agent coordination for their portion
- Other banks’ positions
- Other banks’ terms
- Total syndicate size (unless explicitly shared)
Supply Chain Finance
Track goods and payments across multiple parties without exposing commercial relationships.The Scenario
A manufacturer ships to a distributor, who ships to a retailer. Financing is provided at each step.Privacy Requirements
- Manufacturer shouldn’t see retailer’s purchase price
- Retailer shouldn’t see manufacturing cost
- Each financier sees only their debtor’s portion
- Logistics providers see shipping info, not financial terms
Canton Approach
Canton’s privacy works at the contract level—observers see entire contracts, not individual fields. To give different parties access to different information, you design separate contracts for each audience:When Canton Fits
Canton is ideal when you need:| Requirement | Canton Provides |
|---|---|
| Multi-party coordination | Native multi-party contracts with explicit authorization |
| Confidential execution | Sub-transaction privacy by design |
| Regulatory compliance | Selective disclosure to authorized parties |
| Atomic settlement | All-or-nothing execution across parties |
| Audit trails | Observer roles for entitled auditors |
When Canton May Not Fit
Consider alternatives if you need:| Requirement | Consideration |
|---|---|
| Fully public applications | Transparency is a feature, not a limitation (e.g., public governance, open auctions) |
| EVM compatibility | Canton does not natively interoperate with Ethereum smart contracts |
| Anonymous participation | Canton parties have identity; truly anonymous systems need different approaches |
| Simple single-party apps | Blockchain overhead may not be justified |
Next Steps
Core Concepts
Understand parties, validators, and synchronizers.
Start Building
Begin your development journey.