Concept Translation Tables

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.

Concept Translation Tables

Comprehensive mapping of Ethereum concepts to Canton equivalents

This reference provides detailed translations from Ethereum concepts to their Canton equivalents. Use this as a quick reference when you encounter familiar terms and need to understand their Canton counterpart.

Core Protocol Concepts

Identity & Accounts

Party vs. Address Deep Dive

flowchart TB
    subgraph Ethereum
        A1[Address: 0x1234...]
        A2[Derived from public key]
        A3[No on-chain creation cost]
        A4[Anonymous by default]
    end

    subgraph Canton
        B1["Party: alice::fingerprint"]
        B2[Registered with validator]
        B3[Creates state on validator]
        B4[Identity known to validator]
    end

Implications:

• Don’t create parties frivolously (unlike Ethereum addresses)
• Party creation requires interaction with a validator
• Parties are not pseudonymous in the same way as Ethereum addresses

Smart Contract Concepts

State Model Comparison

Ethereum: Mutable State

contract Token {
    mapping(address => uint256) balances;

    function transfer(address to, uint256 amount) public {
        balances[msg.sender] -= amount;  // Mutate in place
        balances[to] += amount;
    }
}

Canton: Immutable Contracts

template Token
  with
    owner : Party
    amount : Decimal
  where
    signatory owner

    choice Transfer : ContractId Token
      with newOwner : Party
      controller owner
      do
        -- Archive this contract (implicit)
        -- Create new contract with new owner
        create this with owner = newOwner

Transaction Concepts

Transaction Visibility

Authorization Concepts

Authorization Example

Ethereum: Runtime Check

function transfer(address to, uint256 amount) public {
    require(msg.sender == owner, "Not authorized");
    // ... transfer logic
}

Canton: Compile-Time Declaration

choice Transfer : ContractId Asset
  controller owner  -- Only owner can exercise this choice
  do
    -- No runtime check needed; protocol enforces
    create this with owner = newOwner

Event & Data Concepts

Network Concepts

Environment Comparison

Development Tooling

Common Patterns

What Doesn’t Translate

Some Ethereum concepts have no direct Canton equivalent:

Next Steps

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