Hackathon officiel approuvé par la Canton FoundationSponsorsTempleDigital AssetWalletAlpendCashen
Voir le calendrier
HackTrail
Espace développeurs

Tout ce qu'il faut pour développer sur Canton

Si vous partez de zéro, suivez les étapes dans l'ordre ; si vous avez de l'expérience, allez directement à la section utile. Tous les liens mènent aux ressources officielles de Canton. En cas de blocage, demandez à l'assistant HackTrail.

Premiers pas

Trois sources officielles

Tout ce dont vous avez besoin se trouve à ces trois adresses officielles. Les autres sections vous mènent directement à la bonne page.

Documentation

docs.canton.network : concepts, guides, Quickstart et références d'API.

Ouvrir

Developer Hub

dev-hub.canton.foundation : outils, SDK et API, ainsi qu'un assistant IA qui répond à partir de la documentation.

Ouvrir

Forum

forum.canton.network : questions et discussions. Votre question a peut-être déjà une réponse.

Ouvrir

Un projet Canton fonctionnel en cinq étapes

  1. Découvrir Canton

    Le modèle de confidentialité, les parties (parties) et qui voit quoi. C'est ce qui distingue Canton des autres chaînes.

  2. Choisir votre parcours

    Nouveau dans la blockchain, ou vous venez d'Ethereum ? La documentation officielle vous propose un parcours adapté.

  3. Installer dpm

    Installez le SDK Daml en une commande, puis créez et testez votre premier projet.

  4. Lancer LocalNet avec Quickstart

    Lancez une application complète avec modèle Daml, backend et interface sur votre ordinateur.

  5. Préparer la soumission

    Suivez la liste de contrôle avant soumission : README, vidéo de démo et explication de qui voit quoi.

Première semaine conseillée

En cas de blocage

Canton Forum

Canal de support officiel : questions techniques, réponses et annonces.

Ouvrir

HackTrail Telegram

Questions sur le hackathon, annonces et recherche de coéquipiers.

Ouvrir
Installation

Installation en quatre étapes

Avancez dans l'ordre. Les deux premières étapes suffisent pour écrire du Daml ; pour une application complète, installez aussi Quickstart.

1. Votre ordinateur est-il prêt ?

Un ordinateur ordinaire suffit pour écrire et tester du Daml. Si vous lancez un LocalNet complet avec Quickstart, nous recommandons les valeurs ci-dessous.

Daml seul (dpm)Quickstart et LocalNet
Mémoire (RAM)8 Go16 Go ou plus
Processeur2 cœurs4 cœurs
Disque libre5 Go50 Go
Système d'exploitationmacOS, Linux, WindowsmacOS, Linux, WSL 2 sous Windows
Logiciels supplémentairesAucunDocker Desktop (Compose 2.27 ou plus récent), direnv, Nix, curl

Réglez la mémoire de Docker Desktop sur au moins 8 Go, idéalement 16 Go. Le manque de mémoire est le problème d'installation le plus fréquent.

Pas envie de gérer l'installation ? Avec Seaport, vous écrivez et compilez des contrats Daml dans le navigateur et les déployez sur DevNet. Pour un essai rapide sans Docker, dpm sandbox suffit ; pour un environnement local complet sans Docker sous Windows et Linux, utilisez Raposza Tools.

2. Votre premier projet Daml avec dpm

dpm est l'outil officiel en ligne de commande pour développer sur Canton : installation du SDK, création de projet, compilation, tests et environnement local. Il remplace les anciennes commandes daml.

macOS et Linux
$ curl https://get.digitalasset.com/install/install.sh | sh
$ export PATH="$HOME/.dpm/bin:$PATH"   # à ajouter à la configuration de votre shell pour le conserver
$ dpm install latest
$ dpm version --all

Sous Windows, utilisez le programme d'installation officiel. Comme version du SDK, choisissez celle qui tourne sur DevNet ; le tableau de compatibilité est accessible via le lien ci-dessous.

premier projet
$ dpm new my-project --template daml-intro-contracts
$ cd my-project
$ dpm build     # crée le paquet DAR
$ dpm test      # lance les tests Daml Script
$ dpm sandbox   # ledger local à un seul participant
$ dpm studio    # Daml Studio dans VS Code

3. LocalNet avec Quickstart

CN Quickstart lance sur Docker une application d'exemple complète avec modèle Daml, backend Java, interface React et paiements en Canton Coin. Ouvrez d'abord Docker Desktop et exécutez docker login.

cn-quickstart
$ git clone https://github.com/digital-asset/cn-quickstart.git
$ cd cn-quickstart
$ direnv allow
$ cd quickstart          # les commandes make s'exécutent dans ce dossier
$ make setup             # choisir OAuth2 activé, Observability désactivé
$ make build
$ make start
$ make capture-logs      # facultatif, dans un autre terminal
$ make stop && make clean-all   # pour arrêter

La première installation peut prendre 30 à 90 minutes à cause du téléchargement du SDK. Interfaces locales : app-provider.localhost:3000, wallet.localhost:2000, scan.localhost:4000.

4. Choix du réseau : LocalNet suffit

Vous pouvez développer et soumettre votre projet sur LocalNet, sur votre propre ordinateur ; cela suffit pour le jury. DevNet est facultatif.

Outils des sponsors

Les outils de nos sponsors

Les produits, la documentation et les vidéos de formation de nos principaux sponsors se trouvent dans cette section.

Five North

Loop Wallet et Loop SDK

Le Loop SDK connecte votre dApp à un portefeuille Loop. Les utilisateurs signent les transactions dans Loop Wallet sur mobile ou dans le navigateur ; toute l'interaction reste dans votre dApp.

app.js
// npm install @fivenorth/loop-sdk
import { loop } from '@fivenorth/loop-sdk';

loop.init({
  appName: 'HackTrail dApp',
  network: 'devnet',            // 'local' | 'devnet' | 'mainnet'
  onAccept: (provider) => console.log(provider.party_id),
  onReject: () => console.log('rejected'),
});

loop.connect();                     // ouvre la fenêtre de connexion par QR code
Five North

Seaport

Seaport est une plateforme cloud pour écrire, compiler, déployer et gérer des contrats Daml. Vous travaillez dans le navigateur sans rien installer ; c'est une alternative hébergée à l'installation de LocalNet.

Canton Coin

Outils

Outils de l'écosystème

Nous avons sélectionné dans le catalogue Developer Hub de la Canton Foundation les outils les plus utiles pour le hackathon. Les descriptions sont de courts résumés ; les détails se trouvent sur la page de chaque outil. Examinez vous-même les outils « Community » et partenaires avant de les utiliser.

Vidéos de formation de la Canton Foundation

Les vidéos se chargent depuis YouTube quand vous cliquez dessus. Elles sont en anglais.

Modèles et contrats prêts à l'emploi

OpenZeppelin Canton Contracts

Composants Daml réutilisables : permissions temporaires et révocables et contrats suspendables.

Ouvrir

Five North ID SDK

Vérification d'identité et gestion des attestations avec des contrats intelligents.

Ouvrir

Développement local

Canton Builder Tool

Un outil de la Canton Foundation pour lancer votre projet sur LocalNet en quelques commandes.

Ouvrir

Canton DevKit

Ligne de commande et interface web locale pour gérer LocalNet : gestion des DAR, inspection du registre, instantanés.

Ouvrir

dpm

Daml Package Manager : l'outil officiel en ligne de commande pour installer le SDK Daml, gérer les versions, compiler et tester les projets.

Ouvrir

Canton dAppBooster

Kit de démarrage avec une stack Canton locale, des hooks React, des composants d'interface prêts, la prise en charge des portefeuilles et une dApp de démo.

Ouvrir

Raposza Tools

Canton en local sous Windows et Linux sans Docker : sandbox, LocalNet et un atelier qui affiche vos contrats.

Ouvrir

canton-deploy

Outil en ligne de commande pour envoyer des paquets Daml vers un validateur, créer des parties et exécuter des scripts.

Ouvrir

Connexion de portefeuille

dApp SDK et Wallet SDK

SDK navigateur pour les dApps et SDK d'intégration pour les fournisseurs de portefeuilles.

Ouvrir

WalletConnect

Le réseau qui connecte les portefeuilles compatibles Canton aux dApps.

Ouvrir

PartyLayer

Connecte tous les portefeuilles CIP-0103 à votre dApp via une seule couche de connexion ; paquets React, Vue et React Native.

Ouvrir

Données et explorateurs

Loop Data

Explorateur public gratuit et données du réseau Canton.

Ouvrir

CCView Explorer

Explorateur qui affiche l'activité du réseau Canton en temps réel.

Ouvrir

Noves

API de données avec transactions, soldes et métriques réseau pour les applications Canton.

Ouvrir

Sécurité, tests et débogage

daml-lint

Outil d'analyse statique qui détecte les mauvaises pratiques de sécurité dans les contrats Daml.

Ouvrir sur GitHub

Canton Security 101

Un guide centré sur Canton pour la sécurité du développement Daml, des applications web et de l'exploitation.

Ouvrir

dpm trace

Un plugin dpm qui visualise les transactions et montre pourquoi une soumission a échoué.

Ouvrir sur GitHub

Écrire du Daml avec l'IA

Serveur MCP de la documentation Canton

Connecte la documentation officielle de Canton à votre assistant IA. Adresse : docs.canton.network/mcp. Aucune authentification requise.

Installation

Canton Developer Hub

Le catalogue d'outils de la Canton Foundation et un assistant IA qui répond à partir de la documentation.

Ouvrir

Claude Code Daml Skill

Le Claude Skill officiel de la Canton Foundation : donne à votre assistant des connaissances à jour et exactes sur les contrats Daml sur Canton.

Ouvrir sur GitHub

CCPedia

Une base de connaissances Canton adaptée à l'IA, couvrant les CIP, le forum, GitHub, la documentation et les vidéos ; avec un serveur MCP.

Ouvrir

Build-on-Canton MCP

Intégration MCP communautaire qui donne à votre assistant des connaissances sur le développement sur Canton.

Ouvrir sur GitHub

Testez toujours le code généré par l'IA. Si vous l'avez utilisée, indiquez-le dans le formulaire de soumission.

Avant de soumettre

Que regardera le jury dans votre projet ?

Vérifiez cette liste avant de soumettre. Le jury n'a pas à installer votre projet ; il regarde la vidéo, le dépôt et le README. L'organisateur vérifie lors du contrôle préalable que le projet fonctionne.

Les transactions Daml privées n'apparaissent pas dans les explorateurs ; ce n'est pas un bug, c'est le modèle de confidentialité de Canton. Les explorateurs n'affichent que le Canton Coin et les transactions du réseau.

Dépannage

Problèmes fréquents

Installation

Les conteneurs restent « unhealthy ».

C'est presque toujours un manque de mémoire. Passez la mémoire de Docker Desktop à 16 Go, exécutez make clean-all et, dans make setup, désactivez Observability.

Les commandes make ne fonctionnent pas.

Vérifiez que vous lancez les commandes dans le dossier cn-quickstart/quickstart.

J'ai des erreurs après une mise à jour de Docker Desktop.

Docker Desktop 4.38.0 a un bug connu. Mettez Docker Desktop à jour vers la dernière version.

Le téléchargement du SDK s'est interrompu ou est corrompu.

make install-daml-sdk télécharge à nouveau le SDK. Le premier téléchargement peut prendre quelques minutes.

Nix affiche une erreur SSL.

Cela arrive sur les réseaux d'entreprise et derrière un proxy. Essayez sur un réseau personnel si possible.

Les adresses locales ne s'ouvrent pas dans le navigateur.

Safari peut avoir du mal avec ces adresses locales ; utilisez Chrome ou Firefox.

Développement

Quelle version du SDK utiliser ?

Celle qui tourne sur DevNet. Utilisez dpm version --all pour voir les versions installées et vérifiez la version DevNet dans le tableau de compatibilité.

Ma transaction n'apparaît pas dans l'explorateur.

C'est normal. Sur Canton, les transactions applicatives sont privées et seules les parties les voient. Les explorateurs n'affichent que le Canton Coin et les transactions du réseau.

Puis-je utiliser l'ancienne documentation Daml 2.x ?

Non. docs.daml.com décrit l'ancienne version 2.x. Pour Canton Network, utilisez la documentation à jour sur docs.canton.network.

Je n'arrive pas à accéder à DevNet.

DevNet est facultatif ; vous pouvez aussi soumettre avec LocalNet. Pour DevNet, suivez les étapes du guide officiel ; en cas de problème, écrivez-nous via « Signaler un problème » dans votre espace.

Grant

Après HackTrail : la subvention de la Canton Foundation

Le Protocol Development Fund de la Canton Foundation soutient les travaux qui apportent une valeur durable à tout le réseau. Les projets HackTrail solides peuvent candidater à ce programme.

Besoin d'aide ?
L'assistant HackTrail répond à vos questions sur la candidature, le calendrier et Daml.