Offizieller, von der Canton Foundation genehmigter HackathonSponsorenTempleDigital AssetWalletAlpendCashen
Zeitplan ansehen
HackTrail
Developer Hub

Alles, was du brauchst, um auf Canton zu entwickeln

Wenn du bei null anfängst, folge den Schritten der Reihe nach; mit Erfahrung springst du direkt zum passenden Abschnitt. Alle Links führen zu offiziellen Canton-Ressourcen. Wenn du nicht weiterkommst, frag den HackTrail-Assistenten.

Erste Schritte

Drei offizielle Quellen

Alles, was du brauchst, findest du unter diesen drei offiziellen Adressen. Die anderen Abschnitte führen dich direkt zur richtigen Seite.

Dokumentation

docs.canton.network: Konzepte, Leitfäden, Quickstart und API-Referenzen.

Öffnen

Developer Hub

dev-hub.canton.foundation: Werkzeuge, SDKs und APIs, dazu ein KI-Assistent, der aus der Dokumentation antwortet.

Öffnen

Forum

forum.canton.network: Fragen und Diskussionen. Deine Frage wurde vielleicht schon beantwortet.

Öffnen

Ein funktionierendes Canton-Projekt in fünf Schritten

  1. Canton kennenlernen

    Das Privatsphäre-Modell, Parteien (Parties) und wer was sieht. Das unterscheidet Canton von anderen Chains.

  2. Wähle deinen Lernpfad

    Neu bei Blockchain oder kommst du von Ethereum? Die offizielle Dokumentation schlägt dir einen passenden Weg vor.

  3. dpm installieren

    Installiere das Daml SDK mit einem Befehl, erstelle und teste dein erstes Projekt.

  4. LocalNet mit Quickstart starten

    Starte eine vollständige App mit Daml-Modell, Backend und Frontend auf deinem eigenen Rechner.

  5. Einreichung vorbereiten

    Arbeite die Checkliste vor der Einreichung ab: README, Demo-Video und eine Erklärung, wer was sieht.

Empfohlene erste Woche

Wenn du nicht weiterkommst

Canton Forum

Offizieller Support-Kanal: technische Fragen, Antworten und Ankündigungen.

Öffnen

HackTrail Telegram

Fragen zum Hackathon, Ankündigungen und Teamsuche.

Öffnen
Einrichtung

Einrichtung in vier Schritten

Geh der Reihe nach vor. Für reines Daml reichen die ersten beiden Schritte; für eine vollständige App installiere auch Quickstart.

1. Ist dein Rechner bereit?

Zum Schreiben und Testen von Daml reicht ein normaler Rechner. Wenn du mit Quickstart ein vollständiges LocalNet betreibst, empfehlen wir die folgenden Werte.

Nur Daml (dpm)Quickstart und LocalNet
Arbeitsspeicher (RAM)8 GB16 GB oder mehr
Prozessor2 Kerne4 Kerne
Freier Speicher5 GB50 GB
BetriebssystemmacOS, Linux, WindowsmacOS, Linux, WSL 2 unter Windows
Zusätzliche SoftwareKeineDocker Desktop (Compose 2.27 oder neuer), direnv, Nix, curl

Stelle den Speicher in Docker Desktop auf mindestens 8 GB, besser 16 GB. Zu wenig Speicher ist das häufigste Einrichtungsproblem.

Keine Lust auf Einrichtung? Mit Seaport schreibst und baust du Daml-Verträge im Browser und deployst sie auf DevNet. Für einen schnellen Test ohne Docker reicht dpm sandbox; für eine vollständige lokale Umgebung ohne Docker unter Windows und Linux nutze Raposza Tools.

2. Dein erstes Daml-Projekt mit dpm

dpm ist das offizielle Kommandozeilenwerkzeug für die Canton-Entwicklung: SDK-Installation, Projekterstellung, Build, Test und lokale Umgebung. Es ersetzt die alten daml Befehle.

macOS und Linux
$ curl https://get.digitalasset.com/install/install.sh | sh
$ export PATH="$HOME/.dpm/bin:$PATH"   # in deine Shell-Konfiguration eintragen, damit es bleibt
$ dpm install latest
$ dpm version --all

Unter Windows nutzt du das offizielle Installationsprogramm. Wähle als SDK-Version die, die auf DevNet läuft; die Kompatibilitätstabelle findest du unter dem Link unten.

erstes Projekt
$ dpm new my-project --template daml-intro-contracts
$ cd my-project
$ dpm build     # erstellt das DAR-Paket
$ dpm test      # führt die Daml-Script-Tests aus
$ dpm sandbox   # lokaler Ledger mit einem Teilnehmer
$ dpm studio    # Daml Studio in VS Code

3. LocalNet mit Quickstart

CN Quickstart startet eine vollständige Beispiel-App mit Daml-Modell, Java-Backend, React-Frontend und Canton-Coin-Zahlungen auf Docker. Öffne zuerst Docker Desktop und führe docker login aus.

cn-quickstart
$ git clone https://github.com/digital-asset/cn-quickstart.git
$ cd cn-quickstart
$ direnv allow
$ cd quickstart          # make-Befehle laufen in diesem Ordner
$ make setup             # OAuth2 an, Observability aus wählen
$ make build
$ make start
$ make capture-logs      # optional, in einem separaten Terminal
$ make stop && make clean-all   # zum Beenden

Die erste Einrichtung kann wegen des SDK-Downloads 30-90 Minuten dauern. Lokale Oberflächen: app-provider.localhost:3000, wallet.localhost:2000, scan.localhost:4000.

4. Netzwerkwahl: LocalNet reicht

Du kannst dein Projekt auf LocalNet auf deinem eigenen Rechner entwickeln und einreichen; für die Jury reicht das. DevNet ist optional.

Sponsoren-Tools

Werkzeuge unserer Sponsoren

Produkte, Dokumentation und Schulungsvideos unserer Hauptsponsoren findest du in diesem Bereich.

Five North

Loop Wallet und Loop SDK

Das Loop SDK verbindet deine dApp mit einer Loop-Wallet. Nutzer signieren Transaktionen in Loop Wallet auf dem Handy oder im Browser; die ganze Interaktion bleibt in deiner 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();                     // öffnet das Verbindungsfenster mit QR-Code
Five North

Seaport

Seaport ist eine Cloud-Plattform zum Schreiben, Bauen, Deployen und Verwalten von Daml-Verträgen. Du arbeitest im Browser, ohne etwas zu installieren; eine gehostete Alternative zur LocalNet-Einrichtung.

Canton Coin

Werkzeuge

Werkzeuge im Ökosystem

Aus dem Developer-Hub-Katalog der Canton Foundation haben wir die nützlichsten Tools für den Hackathon ausgewählt. Die Beschreibungen sind kurze Zusammenfassungen; Details stehen auf der Seite des jeweiligen Tools. Prüfe Community- und Partner-Tools selbst, bevor du sie nutzt.

Schulungsvideos der Canton Foundation

Die Videos werden erst beim Anklicken von YouTube geladen. Sie sind auf Englisch.

Fertige Vorlagen und Verträge

OpenZeppelin Canton Contracts

Wiederverwendbare Daml-Komponenten: zeitlich begrenzte und widerrufbare Berechtigungen sowie pausierbare Verträge.

Öffnen

Five North ID SDK

Identitätsprüfung und Verwaltung von Nachweisen mit Smart Contracts.

Öffnen

Lokale Entwicklung

Canton Builder Tool

Ein Tool der Canton Foundation, um dein Projekt mit wenigen Befehlen auf LocalNet zu starten.

Öffnen

Canton DevKit

Kommandozeile und lokale Web-Oberfläche zur Verwaltung von LocalNet: DAR-Verwaltung, Ledger-Inspektion, Snapshots.

Öffnen

dpm

Daml Package Manager: das offizielle Kommandozeilen-Tool, um das Daml SDK zu installieren, Versionen zu verwalten und Projekte zu bauen und zu testen.

Öffnen

Canton dAppBooster

Starterpaket mit lokalem Canton-Stack, React-Hooks, fertigen UI-Komponenten, Wallet-Unterstützung und Demo-dApp.

Öffnen

Raposza Tools

Lokales Canton unter Windows und Linux ohne Docker: Sandbox, LocalNet und eine Workbench, die deine Verträge zeigt.

Öffnen

canton-deploy

Kommandozeilen-Tool, um Daml-Pakete auf einen Validator hochzuladen, Parteien anzulegen und Skripte auszuführen.

Öffnen

Wallet-Anbindung

dApp SDK und Wallet SDK

Browser-SDK für dApps und Integrations-SDK für Wallet-Anbieter.

Öffnen

WalletConnect

Das Netzwerk, das Canton-kompatible Wallets mit dApps verbindet.

Öffnen

PartyLayer

Verbindet jede CIP-0103-Wallet über eine einzige Verbindungsschicht mit deiner dApp; Pakete für React, Vue und React Native.

Öffnen

Daten und Explorer

Loop Data

Kostenloser, öffentlicher Explorer und Netzwerkdaten für das Canton-Netzwerk.

Öffnen

CCView Explorer

Explorer, der die Aktivität im Canton-Netzwerk in Echtzeit zeigt.

Öffnen

Noves

Daten-API mit Transaktionen, Guthaben und Netzwerkkennzahlen für Canton-Apps.

Öffnen

Sicherheit, Tests und Debugging

daml-lint

Statisches Analyse-Tool, das Daml-Verträge nach Sicherheits-Antipatterns durchsucht.

Auf GitHub öffnen

Canton Security 101

Ein Canton-spezifischer Leitfaden zur Sicherheit bei Daml-Entwicklung, Web-Apps und Betrieb.

Öffnen

dpm trace

Ein dpm-Plugin, das Transaktionen visualisiert und zeigt, warum eine Übermittlung fehlgeschlagen ist.

Auf GitHub öffnen

Daml mit KI schreiben

MCP-Server der Canton-Dokumentation

Verbindet die offizielle Canton-Dokumentation mit deinem KI-Assistenten. Adresse: docs.canton.network/mcp. Keine Authentifizierung nötig.

Einrichtung

Canton Developer Hub

Werkzeugkatalog der Canton Foundation und ein KI-Assistent, der aus der Dokumentation antwortet.

Öffnen

Claude Code Daml Skill

Der offizielle Claude Skill der Canton Foundation: gibt deinem Assistenten aktuelles, korrektes Wissen über Daml-Verträge auf Canton.

Auf GitHub öffnen

CCPedia

Eine KI-taugliche Canton-Wissensbasis über CIPs, Forum, GitHub, Dokumentation und Videos; mit MCP-Server.

Öffnen

Build-on-Canton MCP

Community-MCP-Integration, die deinem Assistenten Wissen über die Entwicklung auf Canton gibt.

Auf GitHub öffnen

Teste von KI erzeugten Code immer. Wenn du KI genutzt hast, gib es im Einreichungsformular an.

Vor der Einreichung

Worauf achtet die Jury bei deinem Projekt?

Prüfe diese Liste vor dem Einreichen. Die Jury muss dein Projekt nicht einrichten; sie schaut sich Video, Repo und README an. Der Veranstalter prüft in der Vorprüfung, dass das Projekt läuft.

Private Daml-Transaktionen erscheinen nicht in Explorern; das ist kein Fehler, sondern Cantons Privatsphäre-Modell. Explorer zeigen nur Canton Coin und Netzwerktransaktionen.

Fehlerbehebung

Häufige Probleme

Einrichtung

Container bleiben "unhealthy".

Fast immer ist zu wenig Speicher die Ursache. Erhöhe den Speicher in Docker Desktop auf 16 GB, führe make clean-all aus und wähle bei make setupObservability aus.

make-Befehle funktionieren nicht.

Stelle sicher, dass du die Befehle im Ordner cn-quickstart/quickstart ausführst.

Nach einem Docker-Desktop-Update bekomme ich Fehler.

Docker Desktop 4.38.0 hat einen bekannten Fehler. Aktualisiere Docker Desktop auf die neueste Version.

Der SDK-Download ist abgebrochen oder beschädigt.

make install-daml-sdk lädt das SDK erneut herunter. Der erste Download kann ein paar Minuten dauern.

Nix meldet einen SSL-Fehler.

Das passiert in Firmennetzen und hinter Proxys. Versuch es, wenn möglich, in einem privaten Netz.

Lokale Adressen öffnen sich im Browser nicht.

Safari kann mit diesen lokalen Adressen Probleme haben; nutze Chrome oder Firefox.

Entwicklung

Welche SDK-Version soll ich nutzen?

Die Version, die auf DevNet läuft. Mit dpm version --all siehst du die installierten Versionen; prüfe die DevNet-Version in der Kompatibilitätstabelle.

Meine Transaktion erscheint nicht im Explorer.

Das ist normal. Auf Canton sind App-Transaktionen privat und nur die Parteien sehen sie. Explorer zeigen nur Canton Coin und Netzwerktransaktionen.

Kann ich die alte Daml-2.x-Dokumentation nutzen?

Nein. docs.daml.com beschreibt die alte Version 2.x. Für Canton Network nutze die aktuelle Dokumentation unter docs.canton.network.

Ich komme nicht auf DevNet.

DevNet ist optional; du kannst auch mit LocalNet einreichen. Für DevNet folge den Schritten im offiziellen Leitfaden; bei Problemen schreib uns über "Problem melden" in deinem Panel.

Grant

Nach HackTrail: der Grant der Canton Foundation

Der Protocol Development Fund der Canton Foundation fördert Arbeit, die dem ganzen Netzwerk langfristig Wert bringt. Starke HackTrail-Projekte können sich für dieses Programm bewerben.

Brauchst du Hilfe?
Der HackTrail-Assistent beantwortet deine Fragen zu Bewerbung, Zeitplan und Daml.