Документация
docs.canton.network: концепции, руководства, Quickstart и справочник API.
ОткрытьЕсли начинаете с нуля, идите по шагам по порядку; если есть опыт, переходите сразу к нужному разделу. Все ссылки ведут на официальные ресурсы Canton. Если застряли, спросите ассистента HackTrail.
Всё нужное есть по этим трём официальным адресам. Остальные разделы ведут прямо на нужную страницу.
docs.canton.network: концепции, руководства, Quickstart и справочник API.
Открытьdev-hub.canton.foundation: инструменты, SDK и API, а также ИИ-ассистент, который отвечает по документации.
Открытьforum.canton.network: вопросы и обсуждения. Возможно, ответ на ваш вопрос уже есть.
ОткрытьМодель конфиденциальности, стороны (parties) и то, кто что видит. Именно этим Canton отличается от других сетей.
Новичок в блокчейне или пришли из Ethereum? Официальная документация предложит подходящий путь.
Установите Daml SDK одной командой, создайте и протестируйте первый проект.
Поднимите на своём компьютере полноценное приложение с моделью Daml, бэкендом и интерфейсом.
Пройдите чек-лист перед сдачей: README, демо-видео и объяснение того, кто что видит.
Идите по порядку. Чтобы писать на Daml, хватит первых двух шагов; для полноценного приложения установите и Quickstart.
Чтобы писать и тестировать Daml, достаточно обычного компьютера. Если будете запускать полный LocalNet через Quickstart, рекомендуем параметры ниже.
| Только Daml (dpm) | Quickstart и LocalNet | |
|---|---|---|
| Память (RAM) | 8 ГБ | 16 ГБ и больше |
| Процессор | 2 ядра | 4 ядра |
| Свободное место | 5 ГБ | 50 ГБ |
| Операционная система | macOS, Linux, Windows | macOS, 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.
dpm — официальный инструмент командной строки для разработки на Canton: установка SDK, создание проекта, сборка, тесты и локальное окружение. Он заменяет старые команды daml.
$ 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
CN Quickstart запускает в Docker полноценное демо-приложение с моделью Daml, бэкендом на Java, интерфейсом на React и платежами в Canton Coin. Сначала откройте Docker Desktop и выполните docker login.
$ 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.
Вы можете разработать и сдать проект на LocalNet на своём компьютере; для жюри этого достаточно. DevNet — по желанию.
В этом разделе — продукты, документация и обучающие видео наших главных спонсоров.
Loop SDK подключает ваш dApp к кошельку Loop. Пользователи подписывают транзакции в Loop Wallet на телефоне или в браузере; всё взаимодействие остаётся внутри вашего 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(); // открывает окно подключения по QR-коду
Seaport — облачная платформа для написания, сборки, развёртывания и управления контрактами Daml. Вы работаете в браузере, ничего не устанавливая; это размещённая альтернатива установке LocalNet.
Из каталога Developer Hub от Canton Foundation мы выбрали самые полезные для хакатона инструменты. Описания — короткие резюме; подробности на странице каждого инструмента. Инструменты сообщества и партнёров проверяйте сами перед использованием.
Видео загружаются с YouTube только по клику. Они на английском языке.
Переиспользуемые компоненты Daml: временные и отзываемые права и приостанавливаемые контракты.
ОткрытьПроверка личности и управление учётными данными с помощью смарт-контрактов.
ОткрытьИнструмент Canton Foundation, чтобы запустить проект в LocalNet за несколько команд.
ОткрытьКомандная строка и локальный веб-интерфейс для управления LocalNet: управление DAR, просмотр леджера, снимки.
ОткрытьDaml Package Manager: официальный инструмент командной строки для установки Daml SDK, управления версиями, сборки и тестирования проектов.
ОткрытьСтартовый набор: локальный стек Canton, React-хуки, готовые компоненты интерфейса, поддержка кошельков и демо-dApp.
ОткрытьЛокальный Canton на Windows и Linux без Docker: песочница, LocalNet и рабочая среда, показывающая ваши контракты.
ОткрытьИнструмент командной строки для загрузки пакетов Daml на валидатор, создания сторон и запуска скриптов.
ОткрытьБраузерный SDK для dApp и SDK интеграции для провайдеров кошельков.
ОткрытьСеть, которая соединяет совместимые с Canton кошельки с dApp.
ОткрытьПодключает любые кошельки CIP-0103 к вашему dApp через единый слой; пакеты для React, Vue и React Native.
ОткрытьБесплатный публичный обозреватель и данные сети Canton.
ОткрытьОбозреватель, показывающий активность сети Canton в реальном времени.
ОткрытьAPI данных с транзакциями, балансами и метриками сети для приложений Canton.
ОткрытьИнструмент статического анализа, находящий небезопасные шаблоны в контрактах Daml.
Открыть на GitHubРуководство по безопасности разработки Daml, веб-приложений и эксплуатации с фокусом на Canton.
ОткрытьПлагин dpm, который визуализирует транзакции и показывает, почему отправка не удалась.
Открыть на GitHubПодключает официальную документацию Canton к вашему ИИ-ассистенту. Адрес: docs.canton.network/mcp. Аутентификация не нужна.
УстановкаКаталог инструментов Canton Foundation и ИИ-ассистент, который отвечает по документации.
ОткрытьОфициальный Claude Skill от Canton Foundation: даёт вашему ассистенту актуальные и точные знания о контрактах Daml в Canton.
Открыть на GitHubБаза знаний о Canton для ИИ: CIP, форум, GitHub, документация и видео; есть и MCP-сервер.
ОткрытьИнтеграция MCP от сообщества, которая даёт вашему ассистенту знания о разработке на Canton.
Открыть на GitHubВсегда тестируйте код, созданный ИИ. Если использовали ИИ, укажите это в форме сдачи.
Проверьте этот список перед сдачей. Жюри не обязано устанавливать проект; оно смотрит видео, репозиторий и README. Организатор на предварительной проверке убеждается, что проект работает.
daml.yaml и настоящие шаблоны Daml: signatory, observer и choice устроены правильно.dpm build собирает пакет, dpm test проходит тесты.Конфиденциальные транзакции Daml не видны в обозревателях; это не ошибка, а модель конфиденциальности Canton. Обозреватели показывают только Canton Coin и сетевые транзакции.
Почти всегда причина — нехватка памяти. Увеличьте память Docker Desktop до 16 ГБ, выполните make clean-all и в make setupвыключите Observability.
Убедитесь, что запускаете команды внутри папки cn-quickstart/quickstart.
В Docker Desktop 4.38.0 есть известная ошибка. Обновите Docker Desktop до последней версии.
make install-daml-sdk загружает SDK заново. Первая загрузка может занять несколько минут.
Так бывает в корпоративных сетях и за прокси. По возможности попробуйте личную сеть.
Safari может некорректно работать с этими локальными адресами; используйте Chrome или Firefox.
Ту, что работает в DevNet. Команда dpm version --all покажет установленные версии; версию DevNet проверьте в таблице совместимости.
Это нормально. В Canton транзакции приложений конфиденциальны, их видят только стороны. Обозреватели показывают только Canton Coin и сетевые транзакции.
Нет. docs.daml.com описывает старую версию 2.x. Для Canton Network используйте актуальную документацию на docs.canton.network.
DevNet — по желанию; сдать проект можно и на LocalNet. Для DevNet следуйте шагам официального руководства; если возникнут проблемы, напишите нам через «Сообщить о проблеме» в личном кабинете.
Protocol Development Fund фонда Canton Foundation поддерживает работы, которые приносят долгосрочную пользу всей сети. Сильные проекты HackTrail могут подать заявку в эту программу.