Documentation
docs.canton.network : concepts, guides, Quickstart et références d'API.
OuvrirSi 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.
Tout ce dont vous avez besoin se trouve à ces trois adresses officielles. Les autres sections vous mènent directement à la bonne page.
docs.canton.network : concepts, guides, Quickstart et références d'API.
Ouvrirdev-hub.canton.foundation : outils, SDK et API, ainsi qu'un assistant IA qui répond à partir de la documentation.
Ouvrirforum.canton.network : questions et discussions. Votre question a peut-être déjà une réponse.
OuvrirLe modèle de confidentialité, les parties (parties) et qui voit quoi. C'est ce qui distingue Canton des autres chaînes.
Nouveau dans la blockchain, ou vous venez d'Ethereum ? La documentation officielle vous propose un parcours adapté.
Installez le SDK Daml en une commande, puis créez et testez votre premier projet.
Lancez une application complète avec modèle Daml, backend et interface sur votre ordinateur.
Suivez la liste de contrôle avant soumission : README, vidéo de démo et explication de qui voit quoi.
Avancez dans l'ordre. Les deux premières étapes suffisent pour écrire du Daml ; pour une application complète, installez aussi Quickstart.
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 Go | 16 Go ou plus |
| Processeur | 2 cœurs | 4 cœurs |
| Disque libre | 5 Go | 50 Go |
| Système d'exploitation | macOS, Linux, Windows | macOS, Linux, WSL 2 sous Windows |
| Logiciels supplémentaires | Aucun | Docker 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.
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.
$ 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.
$ 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
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.
$ 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.
Vous pouvez développer et soumettre votre projet sur LocalNet, sur votre propre ordinateur ; cela suffit pour le jury. DevNet est facultatif.
Les produits, la documentation et les vidéos de formation de nos principaux sponsors se trouvent dans cette section.
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.
// 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
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.
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.
Les vidéos se chargent depuis YouTube quand vous cliquez dessus. Elles sont en anglais.
Composants Daml réutilisables : permissions temporaires et révocables et contrats suspendables.
OuvrirVérification d'identité et gestion des attestations avec des contrats intelligents.
OuvrirUn outil de la Canton Foundation pour lancer votre projet sur LocalNet en quelques commandes.
OuvrirLigne de commande et interface web locale pour gérer LocalNet : gestion des DAR, inspection du registre, instantanés.
OuvrirDaml Package Manager : l'outil officiel en ligne de commande pour installer le SDK Daml, gérer les versions, compiler et tester les projets.
OuvrirKit 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.
OuvrirCanton en local sous Windows et Linux sans Docker : sandbox, LocalNet et un atelier qui affiche vos contrats.
OuvrirOutil en ligne de commande pour envoyer des paquets Daml vers un validateur, créer des parties et exécuter des scripts.
OuvrirSDK navigateur pour les dApps et SDK d'intégration pour les fournisseurs de portefeuilles.
OuvrirLe réseau qui connecte les portefeuilles compatibles Canton aux dApps.
OuvrirConnecte tous les portefeuilles CIP-0103 à votre dApp via une seule couche de connexion ; paquets React, Vue et React Native.
OuvrirExplorateur public gratuit et données du réseau Canton.
OuvrirExplorateur qui affiche l'activité du réseau Canton en temps réel.
OuvrirAPI de données avec transactions, soldes et métriques réseau pour les applications Canton.
OuvrirOutil d'analyse statique qui détecte les mauvaises pratiques de sécurité dans les contrats Daml.
Ouvrir sur GitHubUn guide centré sur Canton pour la sécurité du développement Daml, des applications web et de l'exploitation.
OuvrirUn plugin dpm qui visualise les transactions et montre pourquoi une soumission a échoué.
Ouvrir sur GitHubConnecte la documentation officielle de Canton à votre assistant IA. Adresse : docs.canton.network/mcp. Aucune authentification requise.
InstallationLe catalogue d'outils de la Canton Foundation et un assistant IA qui répond à partir de la documentation.
OuvrirLe Claude Skill officiel de la Canton Foundation : donne à votre assistant des connaissances à jour et exactes sur les contrats Daml sur Canton.
Ouvrir sur GitHubUne base de connaissances Canton adaptée à l'IA, couvrant les CIP, le forum, GitHub, la documentation et les vidéos ; avec un serveur MCP.
OuvrirIntégration MCP communautaire qui donne à votre assistant des connaissances sur le développement sur Canton.
Ouvrir sur GitHubTestez toujours le code généré par l'IA. Si vous l'avez utilisée, indiquez-le dans le formulaire de soumission.
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.
daml.yaml et de vrais templates Daml : signatories, observers et choices bien conçus.dpm build construit le paquet, dpm test passe les tests.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.
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.
Vérifiez que vous lancez les commandes dans le dossier cn-quickstart/quickstart.
Docker Desktop 4.38.0 a un bug connu. Mettez Docker Desktop à jour vers la dernière version.
make install-daml-sdk télécharge à nouveau le SDK. Le premier téléchargement peut prendre quelques minutes.
Cela arrive sur les réseaux d'entreprise et derrière un proxy. Essayez sur un réseau personnel si possible.
Safari peut avoir du mal avec ces adresses locales ; utilisez Chrome ou Firefox.
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é.
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.
Non. docs.daml.com décrit l'ancienne version 2.x. Pour Canton Network, utilisez la documentation à jour sur docs.canton.network.
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.
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.