diff --git a/docs-main/docs.json b/docs-main/docs.json index 01caf85ec..666a7776e 100644 --- a/docs-main/docs.json +++ b/docs-main/docs.json @@ -551,15 +551,6 @@ "integrations/exchanges/guidance" ] }, - { - "group": "Ecosystem", - "pages": [ - "integrations/ecosystem", - "integrations/apps/finding-apps", - "integrations/wallets/canton-vs-web3", - "integrations/wallets/for-users" - ] - }, { "group": "Release Notes", "pages": [ @@ -2854,6 +2845,22 @@ { "source": "/global-synchronizer/splice-fundamentals/sv-governance", "destination": "/sdks-tools/api-reference/splice-architecture" + }, + { + "source": "/integrations/ecosystem", + "destination": "/integrations/overview" + }, + { + "source": "/integrations/apps/finding-apps", + "destination": "/integrations/overview" + }, + { + "source": "/integrations/wallets/canton-vs-web3", + "destination": "/integrations/overview" + }, + { + "source": "/integrations/wallets/for-users", + "destination": "/integrations/overview" } ], "footer": { diff --git a/docs-main/integrations/apps/finding-apps.mdx b/docs-main/integrations/apps/finding-apps.mdx deleted file mode 100644 index 2f002d556..000000000 --- a/docs-main/integrations/apps/finding-apps.mdx +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: "Finding Canton Network Apps" -description: "Discover applications built on Canton Network" ---- - -The Canton Network ecosystem includes a growing number of applications across various categories. - -## Browse the Ecosystem - -The primary directory of Canton Network applications is maintained at [canton.network/ecosystem](https://www.canton.network/ecosystem). There you can browse featured applications, ecosystem partners, and discover what's being built on Canton. - -## Building Your Own - -If you don't find what you need, consider building it yourself: - - - - - Build your own Canton application. - - - - How to list your application. - - - diff --git a/docs-main/integrations/ecosystem.mdx b/docs-main/integrations/ecosystem.mdx deleted file mode 100644 index e5800c3c0..000000000 --- a/docs-main/integrations/ecosystem.mdx +++ /dev/null @@ -1,190 +0,0 @@ ---- -title: "Canton Network Ecosystem" -description: "Overview of the Canton Network ecosystem including participants, applications, and infrastructure" ---- - -The Canton Network ecosystem encompasses the organizations, applications, and infrastructure that make up the network. This page provides an overview of the ecosystem landscape. - -## Ecosystem Overview - -```mermaid -flowchart TB - subgraph Foundation[Governance] - CF[Canton Foundation] - end - - subgraph Infrastructure[Infrastructure] - SVs[Super Validators
Operate synchronizer] - VALS[Validators
Host parties] - end - - subgraph Apps[Applications] - SPLICE[Splice Apps
Reference implementations] - THIRD[Third-Party Apps
Ecosystem applications] - end - - subgraph Users[Personas] - INST[Institutions] - DEVS[Developers] - END[End Users] - end - - CF --> SVs - SVs --> Infrastructure - VALS --> Infrastructure - SPLICE --> Apps - THIRD --> Apps - INST --> Users - DEVS --> Users - END --> Users - - Infrastructure --> Apps - Apps --> Users -``` - -## Governance - -### Canton Foundation (CF) - -The CF is an independent, non-profit body under the Linux Foundation that governs the Global Synchronizer. - -| Responsibility | Description | -|----------------|-------------| -| **Network policies** | Set parameters and rules | -| **Upgrade coordination** | Manage network upgrades | -| **SV oversight** | Oversee Super Validator participation | -| **Ecosystem development** | Foster network growth | - -**Learn more:** [canton.foundation](https://canton.foundation) - -## Infrastructure Participants - -### Super Validators - -Super Validators operate the Global Synchronizer infrastructure and participate in governance. - -| Role | Function | -|------|----------| -| **Sequencer operation** | Order transactions | -| **Mediator operation** | Aggregate confirmations | -| **Governance** | Vote on network parameters | -| **Sponsorship** | Onboard new validators | - -The current Super Validator set includes major financial institutions and technology providers. - -### Validators - -Validators host parties and run participant nodes connected to the Global Synchronizer. - -| Type | Description | -|------|-------------| -| **Enterprise validators** | Run by organizations for their own parties | -| **Service providers** | Offer validator services to others | -| **Application operators** | Run validators for specific applications | - -## Applications - -### Splice Applications - -[Splice](https://github.com/canton-network/splice) is the open-source project providing reference applications for Canton Network. - -| Application | Purpose | -|-------------|---------| -| **Canton Coin** | Native token implementation | -| **Wallet** | User wallet for CC management | -| **Scan** | Network explorer | -| **Validator App** | Validator node management | - -### Application Categories - -| Category | Examples | -|----------|----------| -| **Financial services** | Trading, settlement, custody | -| **Asset tokenization** | Securities, real estate, commodities | -| **Supply chain** | Trade finance, logistics | -| **Identity** | Digital identity, KYC | - -## Developer Ecosystem - -### Tools and SDKs - -| Tool | Purpose | -|------|---------| -| **Daml SDK** | Core development toolkit | -| **Daml** | Smart contract language | -| **Wallet SDK** | Wallet integration | -| **PQS** | Query optimization | - -### Development Resources - -| Resource | Description | -|----------|-------------| -| **QuickStart** | Example application and LocalNet | -| **Documentation** | This site and related docs | -| **Community** | Slack, forums, events | - -## Network Statistics - -Canton Network continues to grow across all metrics. - -### Network Activity - -For current network statistics, visit: -- [Canton Network Explorer](https://scan.sync.global) -- [Network Status](https://canton.foundation/sv-network-status/) - -## Getting Involved - -### As a Validator - -1. Review [infrastructure requirements](/global-synchronizer/understand/infrastructure-requirements) -2. Contact a [Super Validator](https://canton.foundation) for sponsorship -3. Complete the onboarding process -4. Begin operations - -### As a Developer - -1. Start with the [QuickStart](/appdev/quickstart) -2. Learn [Daml](/appdev/get-started/choose-your-path) -3. Build and deploy your application -4. Join the developer community {/* TODO: Add Slack link once available */} - -### As an Institution - -1. Evaluate Canton for your use case -2. Contact the [Canton Foundation](https://canton.foundation) -3. Explore partnership opportunities - -## Ecosystem Resources - -### Official Channels - -| Channel | Purpose | -|---------|---------| -| [canton.network](https://canton.network) | Main website | -| [canton.foundation](https://canton.foundation) | Canton Foundation and validator info | -| Slack | Community discussion | {/* TODO: Add Slack link once available */} -| [GitHub](https://github.com/canton-network/splice) | Splice source code | - -### Events - -The Canton Network community holds regular events: -- Developer workshops -- Validator operations calls -- Governance discussions - -Check [canton.network](https://canton.network) for upcoming events. - -## Next Steps - - - - - Learn common integration approaches. - - - - Begin developing on Canton Network. - - - diff --git a/docs-main/integrations/overview.mdx b/docs-main/integrations/overview.mdx index f77ca7742..c88b7b5c7 100644 --- a/docs-main/integrations/overview.mdx +++ b/docs-main/integrations/overview.mdx @@ -14,23 +14,7 @@ Canton Network provides several categories of integrations: - **Token standards** — Interoperable tokens following [CIP-0056](https://github.com/canton-foundation/cips/blob/main/cip-0056/cip-0056.md) - **Application integration** — Third-party app connectivity -## For Different Audiences - -### For End Users - - - - - Discover wallet options for managing your Canton Coin. - - - - Explore applications built on Canton Network. - - - - -### For Developers +## For Developers @@ -65,8 +49,4 @@ Unlike blockchain explorers on Ethereum that show all transactions, Canton explo Common patterns for building integrations. - - Explore the broader Canton Network ecosystem. - - diff --git a/docs-main/integrations/wallets/canton-vs-web3.mdx b/docs-main/integrations/wallets/canton-vs-web3.mdx deleted file mode 100644 index 6f9fec08c..000000000 --- a/docs-main/integrations/wallets/canton-vs-web3.mdx +++ /dev/null @@ -1,214 +0,0 @@ ---- -title: "How Canton Wallets Differ from Web3 Wallets" -description: "Understanding the key differences between Canton and traditional crypto wallets" ---- - -Canton wallets work differently from Web3 wallets like MetaMask. This page explains the key differences and what they mean for users and developers. - -## Fundamental Differences - -| Aspect | Web3 Wallets | Canton Wallets | -|--------|--------------|----------------| -| **Data visibility** | Balances public | CC balances public via scan; private contract data visible only to participants | -| **Transaction privacy** | All transactions public | CC transactions public via scan; private contract activity visible only to participants | -| **Network model** | Connect to any RPC | Connect to the validator with your party | -| **Identity** | Pseudonymous address | Party identifier | -| **Transfer model** | Single-step send | Single-step or multi-step (pre-approvals, allocations) | - -## Privacy Model - -### Web3: Public by Default - -On Ethereum, your wallet: -- Has a public address anyone can see -- Shows balance to anyone who queries -- All transactions visible on block explorers -- Transaction patterns analyzable - -``` -Anyone can query: 0x123...abc has 45.67 ETH -Anyone can see: 0x123...abc sent 5 ETH to 0x456...def -``` - -### Canton: Contract Privacy by Default - -Canton's privacy model depends on the contract type: - -- CC balances and transaction history are publicly visible via the network's scan service -- Private application contract data is visible to entitled parties -- There is no global view of all contracts - -``` -Anyone can query via scan: Your party's CC balance and transfer history -Only entitled parties see: Your private application contract data -``` - -## Transfer Capabilities - -Canton wallets support transfer patterns not possible in traditional wallets. - -### Multi-Step Transfers - -Traditional transfer: Send X now. - -Canton supports complex workflows: - -| Pattern | Description | -|---------|-------------| -| **Pre-approvals** | Recipient pre-approves accepting transfers from any sender | -| **Allocations** | Reserve tokens for specific purposes | -| **DvP** | Atomic delivery-vs-payment exchanges | -| **Conditional** | Transfers triggered by conditions | - -### Pre-Approvals - -Allow a recipient to receive tokens from any sender without accepting each incoming transfer: - -```mermaid -flowchart LR - B[Bob] -->|"1. creates pre-approval"| P[Pre-approval] - A[Alice] -->|"2. sends CC using pre-approval"| B - Note["Bob receives automatically — no per-transfer acceptance step"] -``` - -**Use cases:** -- Subscription payments -- Recurring transfers -- Automated application flows - -### Allocations - -Reserve tokens for a specific purpose: - -```mermaid -flowchart TB - WALLET[Your Wallet
100 CC] - ALLOC[Allocated
30 CC for Trade] - FREE[Available
70 CC] - - WALLET --> ALLOC - WALLET --> FREE -``` - -**Use cases:** -- Trade settlement -- Escrow arrangements -- Multi-step workflows - -### Delivery vs. Payment (DvP) - -Atomic exchange of different assets: - -```mermaid -flowchart LR - subgraph Atomic[Single Atomic Transaction] - A1[Alice sends CC] --> |atomic| B1[Bob sends Asset] - end - - Note[Either both happen or neither happens] -``` - -**Why this matters:** -- No settlement risk -- No trust required between parties -- Complex exchanges in single transaction - -## Connection Model - -### Web3: Any RPC - -Web3 wallets connect to any compatible RPC endpoint: -- Infura, Alchemy, or self-hosted -- Can switch providers freely -- Any node can answer queries - -### Canton: Your Validator - -Canton wallets connect to one or more validators: -- The validator(s) hosting your party -- Can't freely switch (party is hosted somewhere specific) -- Only your validator(s) have your data - -```mermaid -flowchart TB - subgraph Web3[Web3 Model] - W1[Wallet] --> RPC1[RPC 1] - W1 --> RPC2[RPC 2] - W1 --> RPC3[Any RPC] - end - - subgraph Canton[Canton Model] - W2[Wallet] --> VAL[Your Validator] - VAL --> |hosts| PARTY[Your Party] - end -``` - -## Identity Model - -### Web3: Address-Based - -- Address derived from public key -- Anyone can generate addresses -- Pseudonymous (address is identity) - -### Canton: Party-Based - -- Party identifier tied to validator hosting -- Party creation involves validator -- Not pseudonymous in the same way - - -For local parties (where the validator holds the keys), the validator signs on behalf of the party. For external parties, keys are held externally and require explicit signing. - - -| Web3 Address | Canton Party | -|--------------|--------------| -| `0x742d35Cc6634C0532925a3b844Bc454e4438f44e` | `alice::1220f2fe29866fd6a0009ecc8a64ccdc09f1958bd0f801166baaee469d1251b2eb72` | - -## Explorer Differences - -### Web3: Global Explorer - -Block explorers show all network activity: -- Any transaction -- Any address balance -- Any contract state - -### Canton: Scan Service for CC, Personal View for Private Contracts - -For CC, the network's scan service works like a block explorer — anyone can query CC balances and transaction history by party. For private application contracts, you see only your own activity: -- Your private contract transactions -- Your private contract balances -- Your contracts - -## Implications for Users - -| If you're used to... | On Canton... | -|----------------------|--------------| -| Checking any address balance | CC balances queryable via scan; private contract balances require entitlement | -| Viewing all transactions | CC history public via scan; private contract activity visible only to you | -| Connecting to any RPC | You connect to your validator(s) | -| Simple send transactions | You have more transfer options | - -## Implications for Developers - -| If you're building... | Consider... | -|----------------------|-------------| -| Wallet integration | Use Wallet SDK for Canton patterns | -| Transaction display | Show only user's transactions | -| Balance queries | Query via scan for CC; query user's party for private contracts | -| Multi-step workflows | Leverage pre-approvals and allocations | - -## Next Steps - - - - - Integrate wallet functionality into your app. - - - - Understand the Canton Token Standard. - - - diff --git a/docs-main/integrations/wallets/for-users.mdx b/docs-main/integrations/wallets/for-users.mdx deleted file mode 100644 index 534e070ef..000000000 --- a/docs-main/integrations/wallets/for-users.mdx +++ /dev/null @@ -1,167 +0,0 @@ ---- -title: "Wallets for Users" -description: "Finding and using Canton Network wallets" ---- - -A wallet is your gateway to Canton Network—it lets you manage Canton Coin, interact with applications, and track your activity. - -## What is a Canton Wallet? - -A Canton wallet allows you to: - -| Function | Description | -|----------|-------------| -| **Hold Canton Coin** | Store and manage your CC balance | -| **Hold other tokens** | Hold any [CIP-0056](https://github.com/canton-foundation/cips/blob/main/cip-0056/cip-0056.md) compliant token (support varies by wallet) | -| **Transfer value** | Send CC to other parties | -| **Interact with apps** | Connect to Canton Network applications | -| **View activity** | See your transaction history | - -## Finding a Wallet - -### Splice Wallet (Reference Implementation) - -The Splice project provides a reference wallet implementation: - -- **Type**: Web-based wallet -- **Access**: Through validator or application interfaces -- **Features**: Core wallet functionality - - -The Splice reference wallet is not yet [CIP-0056](https://github.com/canton-foundation/cips/blob/main/cip-0056/cip-0056.md) compliant. Support for the token standard is planned for a future release. - - -### Validator-Provided Wallets - -Some validators offer wallet interfaces as part of their services. Check with your validator or application provider. - -### Application-Integrated Wallets - -Many Canton applications include wallet functionality: -- Built into the application interface -- Seamless experience within the app -- May have application-specific features - -## Wallet Basics - -### Your Balance - -Your wallet shows your Canton Coin balance. Wallets may also display other tokens that follow the [CIP-0056](https://github.com/canton-foundation/cips/blob/main/cip-0056/cip-0056.md) token standard—check your specific wallet for supported assets. Unlike other cryptocurrencies: - -- Only you can see your balance -- Others cannot query your holdings -- Your transactions are private - -### Transfers - -To send CC to another party: - -1. Enter the recipient's party identifier -2. Specify the amount -3. Confirm the transfer -4. Transaction completes (typically within seconds) - -### Transaction History - -View your past transactions: -- Transfers sent and received -- Traffic fees paid -- Application interactions - - -You can only see transactions where you were a participant. There's no public ledger of all transactions. - - -## Security - -### Protecting Your Wallet - -| Practice | Description | -|----------|-------------| -| **Secure access** | Use strong authentication | -| **Verify parties** | Confirm recipient identifiers before sending | -| **Trusted validators** | Use wallets from reputable sources | - -### Understanding the Trust Model - -Your wallet connects to a validator that: -- Hosts your party -- Stores your contract data -- Processes your transactions - -Choose your validator carefully—they have visibility into your operations. - -## Differences from Other Crypto Wallets - -| Aspect | Traditional Crypto | Canton | -|--------|-------------------|--------| -| **Balance visibility** | Public | Private | -| **Transaction history** | Public | Private | -| **Address format** | Hex address | Party identifier | -| **Network explorer** | Shows all transactions | Shows only your transactions | - -## Getting Started - -### On DevNet/TestNet - -1. Access a wallet interface (through your validator or application) -2. Create or import your party -3. Use the faucet ("tap") to receive test CC -4. Start transacting - -### On MainNet - -1. Connect to a wallet through your validator or application -2. Obtain CC through: - - Exchange purchase - - Transfer from another party - - Network activity rewards - -## Common Tasks - -### Checking Your Balance - -Open your wallet interface to see your current CC balance. - -### Sending CC - -1. Navigate to "Send" or "Transfer" -2. Enter the recipient party -3. Enter the amount -4. Review and confirm - -### Receiving CC - -1. Share your party identifier with the sender -2. CC appears in your balance after confirmation - -### Topping Up Traffic - -If you're running an application that needs traffic: - -1. Navigate to traffic management -2. Initiate a top-up -3. CC is converted to traffic credits - -## Troubleshooting - -| Issue | Solution | -|-------|----------| -| Balance shows 0 | Ensure wallet is connected to correct validator | -| Transfer failed | Check recipient party format; ensure sufficient balance | -| Slow confirmation | Network may be busy; wait a few moments | -| Can't connect | Check network connectivity; verify validator status | - -## Next Steps - - - - - Understand the technical differences. - - - - Discover Canton Network applications. - - - diff --git a/docs-main/overview/understand/canton-coin.mdx b/docs-main/overview/understand/canton-coin.mdx index 368f88fbd..263167a7e 100644 --- a/docs-main/overview/understand/canton-coin.mdx +++ b/docs-main/overview/understand/canton-coin.mdx @@ -151,10 +151,6 @@ CC balances and transaction history are publicly visible via the network's scan - - Manage your Canton Coin. - - Operate and earn rewards.