Официальный хакатон, одобренный Canton FoundationСпонсорыTempleDigital AssetWalletAlpendCashen
Смотреть расписание
HackTrail
Центр разработчиков

Всё, что нужно для разработки на Canton

Если начинаете с нуля, идите по шагам по порядку; если есть опыт, переходите сразу к нужному разделу. Все ссылки ведут на официальные ресурсы Canton. Если застряли, спросите ассистента HackTrail.

Начало

Три официальных источника

Всё нужное есть по этим трём официальным адресам. Остальные разделы ведут прямо на нужную страницу.

Документация

docs.canton.network: концепции, руководства, Quickstart и справочник API.

Открыть

Developer Hub

dev-hub.canton.foundation: инструменты, SDK и API, а также ИИ-ассистент, который отвечает по документации.

Открыть

Forum

forum.canton.network: вопросы и обсуждения. Возможно, ответ на ваш вопрос уже есть.

Открыть

Работающий проект на Canton за пять шагов

  1. Познакомьтесь с Canton

    Модель конфиденциальности, стороны (parties) и то, кто что видит. Именно этим Canton отличается от других сетей.

  2. Выберите путь обучения

    Новичок в блокчейне или пришли из Ethereum? Официальная документация предложит подходящий путь.

  3. Установите dpm

    Установите Daml SDK одной командой, создайте и протестируйте первый проект.

  4. Запустите LocalNet через Quickstart

    Поднимите на своём компьютере полноценное приложение с моделью Daml, бэкендом и интерфейсом.

  5. Подготовьтесь к сдаче

    Пройдите чек-лист перед сдачей: README, демо-видео и объяснение того, кто что видит.

Рекомендуемая первая неделя

Если застряли

Canton Forum

Официальный канал поддержки: технические вопросы, ответы и объявления.

Открыть

HackTrail Telegram

Вопросы о хакатоне, объявления и поиск команды.

Открыть
Установка

Установка за четыре шага

Идите по порядку. Чтобы писать на Daml, хватит первых двух шагов; для полноценного приложения установите и Quickstart.

1. Готов ли ваш компьютер?

Чтобы писать и тестировать Daml, достаточно обычного компьютера. Если будете запускать полный LocalNet через Quickstart, рекомендуем параметры ниже.

Только Daml (dpm)Quickstart и LocalNet
Память (RAM)8 ГБ16 ГБ и больше
Процессор2 ядра4 ядра
Свободное место5 ГБ50 ГБ
Операционная системаmacOS, Linux, WindowsmacOS, Linux, WSL 2 в Windows
Дополнительное ПОНетDocker Desktop (Compose 2.27 и новее), direnv, Nix, curl

Выделите Docker Desktop не меньше 8 ГБ памяти, лучше 16 ГБ. Нехватка памяти — самая частая проблема при установке.

Не хотите возиться с установкой? В Seaport можно писать и собирать контракты Daml прямо в браузере и разворачивать их в DevNet. Для быстрой пробы без Docker достаточно dpm sandbox; для полноценной локальной среды без Docker на Windows и Linux используйте Raposza Tools.

2. Первый проект Daml с dpm

dpm — официальный инструмент командной строки для разработки на Canton: установка SDK, создание проекта, сборка, тесты и локальное окружение. Он заменяет старые команды daml.

macOS и Linux
$ curl https://get.digitalasset.com/install/install.sh | sh
$ export PATH="$HOME/.dpm/bin:$PATH"   # добавьте в настройки оболочки, чтобы сохранить
$ dpm install latest
$ dpm version --all

В Windows используйте официальный установщик. Версию SDK выбирайте ту, что работает в DevNet; таблица совместимости — по ссылке ниже.

первый проект
$ dpm new my-project --template daml-intro-contracts
$ cd my-project
$ dpm build     # собирает пакет DAR
$ dpm test      # запускает тесты Daml Script
$ dpm sandbox   # локальный леджер с одним участником
$ dpm studio    # Daml Studio в VS Code

3. LocalNet через Quickstart

CN Quickstart запускает в Docker полноценное демо-приложение с моделью Daml, бэкендом на Java, интерфейсом на React и платежами в Canton Coin. Сначала откройте Docker Desktop и выполните docker login.

cn-quickstart
$ git clone https://github.com/digital-asset/cn-quickstart.git
$ cd cn-quickstart
$ direnv allow
$ cd quickstart          # команды make выполняются в этой папке
$ make setup             # выберите OAuth2 включён, Observability выключен
$ make build
$ make start
$ make capture-logs      # по желанию, в отдельном терминале
$ make stop && make clean-all   # чтобы остановить

Первая установка может занять 30–90 минут из-за загрузки SDK. Локальные интерфейсы: app-provider.localhost:3000, wallet.localhost:2000, scan.localhost:4000.

4. Выбор сети: достаточно LocalNet

Вы можете разработать и сдать проект на LocalNet на своём компьютере; для жюри этого достаточно. DevNet — по желанию.

Инструменты спонсоров

Инструменты наших спонсоров

В этом разделе — продукты, документация и обучающие видео наших главных спонсоров.

Five North

Loop Wallet и Loop SDK

Loop SDK подключает ваш dApp к кошельку Loop. Пользователи подписывают транзакции в Loop Wallet на телефоне или в браузере; всё взаимодействие остаётся внутри вашего 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();                     // открывает окно подключения по QR-коду
Five North

Seaport

Seaport — облачная платформа для написания, сборки, развёртывания и управления контрактами Daml. Вы работаете в браузере, ничего не устанавливая; это размещённая альтернатива установке LocalNet.

Canton Coin

Инструменты

Инструменты экосистемы

Из каталога Developer Hub от Canton Foundation мы выбрали самые полезные для хакатона инструменты. Описания — короткие резюме; подробности на странице каждого инструмента. Инструменты сообщества и партнёров проверяйте сами перед использованием.

Обучающие видео Canton Foundation

Видео загружаются с YouTube только по клику. Они на английском языке.

Готовые шаблоны и контракты

OpenZeppelin Canton Contracts

Переиспользуемые компоненты Daml: временные и отзываемые права и приостанавливаемые контракты.

Открыть

Five North ID SDK

Проверка личности и управление учётными данными с помощью смарт-контрактов.

Открыть

Локальная разработка

Canton Builder Tool

Инструмент Canton Foundation, чтобы запустить проект в LocalNet за несколько команд.

Открыть

Canton DevKit

Командная строка и локальный веб-интерфейс для управления LocalNet: управление DAR, просмотр леджера, снимки.

Открыть

dpm

Daml Package Manager: официальный инструмент командной строки для установки Daml SDK, управления версиями, сборки и тестирования проектов.

Открыть

Canton dAppBooster

Стартовый набор: локальный стек Canton, React-хуки, готовые компоненты интерфейса, поддержка кошельков и демо-dApp.

Открыть

Raposza Tools

Локальный Canton на Windows и Linux без Docker: песочница, LocalNet и рабочая среда, показывающая ваши контракты.

Открыть

canton-deploy

Инструмент командной строки для загрузки пакетов Daml на валидатор, создания сторон и запуска скриптов.

Открыть

Подключение кошелька

dApp SDK и Wallet SDK

Браузерный SDK для dApp и SDK интеграции для провайдеров кошельков.

Открыть

WalletConnect

Сеть, которая соединяет совместимые с Canton кошельки с dApp.

Открыть

PartyLayer

Подключает любые кошельки CIP-0103 к вашему dApp через единый слой; пакеты для React, Vue и React Native.

Открыть

Данные и обозреватели

Loop Data

Бесплатный публичный обозреватель и данные сети Canton.

Открыть

CCView Explorer

Обозреватель, показывающий активность сети Canton в реальном времени.

Открыть

Noves

API данных с транзакциями, балансами и метриками сети для приложений Canton.

Открыть

Безопасность, тесты и отладка

daml-lint

Инструмент статического анализа, находящий небезопасные шаблоны в контрактах Daml.

Открыть на GitHub

Canton Security 101

Руководство по безопасности разработки Daml, веб-приложений и эксплуатации с фокусом на Canton.

Открыть

dpm trace

Плагин dpm, который визуализирует транзакции и показывает, почему отправка не удалась.

Открыть на GitHub

Пишите на Daml с ИИ

MCP-сервер документации Canton

Подключает официальную документацию Canton к вашему ИИ-ассистенту. Адрес: docs.canton.network/mcp. Аутентификация не нужна.

Установка

Canton Developer Hub

Каталог инструментов Canton Foundation и ИИ-ассистент, который отвечает по документации.

Открыть

Claude Code Daml Skill

Официальный Claude Skill от Canton Foundation: даёт вашему ассистенту актуальные и точные знания о контрактах Daml в Canton.

Открыть на GitHub

CCPedia

База знаний о Canton для ИИ: CIP, форум, GitHub, документация и видео; есть и MCP-сервер.

Открыть

Build-on-Canton MCP

Интеграция MCP от сообщества, которая даёт вашему ассистенту знания о разработке на Canton.

Открыть на GitHub

Всегда тестируйте код, созданный ИИ. Если использовали ИИ, укажите это в форме сдачи.

Перед сдачей

На что жюри посмотрит в вашем проекте?

Проверьте этот список перед сдачей. Жюри не обязано устанавливать проект; оно смотрит видео, репозиторий и README. Организатор на предварительной проверке убеждается, что проект работает.

Конфиденциальные транзакции Daml не видны в обозревателях; это не ошибка, а модель конфиденциальности Canton. Обозреватели показывают только Canton Coin и сетевые транзакции.

Решение проблем

Частые проблемы

Установка

Контейнеры остаются в состоянии «unhealthy».

Почти всегда причина — нехватка памяти. Увеличьте память Docker Desktop до 16 ГБ, выполните make clean-all и в make setupвыключите Observability.

Команды make не работают.

Убедитесь, что запускаете команды внутри папки cn-quickstart/quickstart.

После обновления Docker Desktop появляются ошибки.

В Docker Desktop 4.38.0 есть известная ошибка. Обновите Docker Desktop до последней версии.

Загрузка SDK прервалась или файл повреждён.

make install-daml-sdk загружает SDK заново. Первая загрузка может занять несколько минут.

Nix выдаёт ошибку SSL.

Так бывает в корпоративных сетях и за прокси. По возможности попробуйте личную сеть.

Локальные адреса не открываются в браузере.

Safari может некорректно работать с этими локальными адресами; используйте Chrome или Firefox.

Разработка

Какую версию SDK использовать?

Ту, что работает в DevNet. Команда dpm version --all покажет установленные версии; версию DevNet проверьте в таблице совместимости.

Моя транзакция не видна в обозревателе.

Это нормально. В Canton транзакции приложений конфиденциальны, их видят только стороны. Обозреватели показывают только Canton Coin и сетевые транзакции.

Можно пользоваться старой документацией Daml 2.x?

Нет. docs.daml.com описывает старую версию 2.x. Для Canton Network используйте актуальную документацию на docs.canton.network.

Не получается зайти в DevNet.

DevNet — по желанию; сдать проект можно и на LocalNet. Для DevNet следуйте шагам официального руководства; если возникнут проблемы, напишите нам через «Сообщить о проблеме» в личном кабинете.

Grant

После HackTrail: грант Canton Foundation

Protocol Development Fund фонда Canton Foundation поддерживает работы, которые приносят долгосрочную пользу всей сети. Сильные проекты HackTrail могут подать заявку в эту программу.

Нужна помощь?
Ассистент HackTrail отвечает на вопросы о заявке, расписании и Daml.