Canton Foundation 认可的官方黑客松赞助方TempleDigital AssetWalletAlpendCashen
查看日程
HackTrail
开发者中心

在 Canton 上开发所需的一切

如果你从零开始,请按顺序完成每一步;如果你有经验,可以直接跳到需要的部分。所有链接都指向 Canton 官方资源。遇到困难时,可以问 HackTrail 助手。

入门

三个官方来源

你需要的一切都在这三个官方网址。其他栏目会直接带你到对应页面。

文档

docs.canton.network:概念、指南、Quickstart 和 API 参考。

打开

Developer Hub

dev-hub.canton.foundation:工具、SDK 和 API,还有一个根据文档回答问题的 AI 助手。

打开

Forum

forum.canton.network:问答与讨论。你的问题可能已经有人回答过。

打开

五步完成一个可运行的 Canton 项目

  1. 认识 Canton

    隐私模型、参与方(party)以及谁能看到什么。这正是 Canton 与其他区块链的不同之处。

  2. 选择学习路径

    刚接触区块链,还是从以太坊转过来?官方文档会为你推荐合适的路径。

  3. 安装 dpm

    一条命令安装 Daml SDK,然后创建并测试你的第一个项目。

  4. 用 Quickstart 运行 LocalNet

    在自己的电脑上运行一个包含 Daml 模型、后端和前端的完整应用。

  5. 准备提交

    按提交前检查清单准备:README、演示视频,以及“谁能看到什么”的说明。

建议的第一周

遇到困难时

Canton Forum

官方支持渠道:技术问题、解答和公告。

打开

HackTrail Telegram

黑客松相关问题、公告以及寻找队友。

打开
安装

四步完成安装

按顺序进行。只写 Daml 的话前两步就够了;要做完整应用,还需要安装 Quickstart。

1. 你的电脑准备好了吗?

只写和测试 Daml,普通电脑就够用。如果要用 Quickstart 运行完整的 LocalNet,建议使用下面的配置。

仅 Daml(dpm)Quickstart 与 LocalNet
内存(RAM)8 GB16 GB 或以上
处理器2 核4 核
可用磁盘5 GB50 GB
操作系统macOS, Linux, WindowsmacOS、Linux、Windows 上的 WSL 2
其他软件无Docker Desktop(Compose 2.27 或更高版本)、direnv、Nix、curl

将 Docker Desktop 的内存设置为至少 8 GB,最好 16 GB。内存不足是最常见的安装问题。

不想折腾安装? 用 Seaport 可以在浏览器中编写和构建 Daml 合约,并部署到 DevNet。想不装 Docker 快速试一试,用 dpm sandbox 就够了;如果要在 Windows 和 Linux 上不用 Docker 搭建完整的本地环境,可以用 Raposza Tools。

2. 用 dpm 创建第一个 Daml 项目

dpm 是 Canton 开发的官方命令行工具:安装 SDK、创建项目、构建、测试和本地环境。它取代了旧的 daml 命令。

macOS 和 Linux
$ curl https://get.digitalasset.com/install/install.sh | sh
$ export PATH="$HOME/.dpm/bin:$PATH"   # 添加到 shell 配置中以永久生效
$ 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    # 在 VS Code 中打开 Daml Studio

3. 用 Quickstart 运行 LocalNet

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   # 关闭

由于需要下载 SDK,首次安装可能需要 30–90 分钟。本地界面: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();                     // 打开二维码连接窗口
Five North

Seaport

Seaport 是一个用于编写、构建、部署和管理 Daml 合约的云平台。无需在电脑上安装任何东西,在浏览器中即可工作;它是搭建 LocalNet 的托管替代方案。

Canton Coin

工具

生态工具

我们从 Canton Foundation 的 Developer Hub 目录中挑选了对黑客松最有用的工具。描述只是简短摘要,详情请看各工具的页面。社区和合作伙伴工具在使用前请自行审查。

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 hooks、现成的界面组件、钱包支持和示例 dApp。

打开

Raposza Tools

无需 Docker,在 Windows 和 Linux 上运行本地 Canton:沙盒、LocalNet,以及展示合约的工作台。

打开

canton-deploy

命令行工具,用于把 Daml 包上传到验证节点、创建参与方并运行脚本。

打开

钱包连接

dApp SDK 与 Wallet SDK

面向 dApp 的浏览器 SDK,以及面向钱包提供方的集成 SDK。

打开

WalletConnect

把兼容 Canton 的钱包连接到 dApp 的网络。

打开

PartyLayer

通过一个连接层把所有 CIP-0103 钱包接入你的 dApp;提供 React、Vue 和 React Native 包。

打开

数据与浏览器

Loop Data

免费、公开的 Canton 网络浏览器和网络数据。

打开

CCView Explorer

实时显示 Canton 网络活动的浏览器。

打开

Noves

为 Canton 应用提供交易、余额和网络指标的数据 API。

打开

安全、测试与调试

Canton Security 101

以 Canton 为重点的安全指南,涵盖 Daml 开发、网页应用和运维安全。

打开

用 AI 编写 Daml

Canton 文档 MCP 服务器

把 Canton 官方文档连接到你的 AI 助手。地址:docs.canton.network/mcp。无需身份验证。

安装

Canton Developer Hub

Canton Foundation 的工具目录,以及根据文档回答问题的 AI 助手。

打开

Claude Code Daml Skill

Canton Foundation 官方的 Claude Skill:让你的助手掌握关于 Canton 上 Daml 合约的最新、准确知识。

在 GitHub 上打开

CCPedia

面向 AI 的 Canton 知识库,涵盖 CIP、论坛、GitHub、文档和视频;也提供 MCP 服务器。

打开

Build-on-Canton MCP

社区 MCP 集成,让你的助手掌握在 Canton 上开发的知识。

在 GitHub 上打开

务必测试 AI 生成的代码。如果用了 AI,请在提交表中注明。

提交前

评委会看你项目的哪些方面?

提交前请核对这份清单。评委不需要自己安装你的项目,他们会看视频、代码仓库和 README。主办方会在预审中确认项目能运行。

私密的 Daml 交易不会出现在浏览器中;这不是错误,而是 Canton 的隐私模型。浏览器只显示 Canton Coin 和网络交易。

问题排查

常见问题

安装

容器一直处于“unhealthy”状态。

几乎都是内存不足造成的。把 Docker Desktop 的内存调到 16 GB,运行 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 资助

Canton Foundation 的 Protocol Development Fund 支持为整个网络带来长期价值的工作。优秀的 HackTrail 项目可以申请这项计划。

需要帮助吗?
HackTrail 助手可以回答关于报名、日程和 Daml 的问题。