文档
docs.canton.network:概念、指南、Quickstart 和 API 参考。
打开你需要的一切都在这三个官方网址。其他栏目会直接带你到对应页面。
docs.canton.network:概念、指南、Quickstart 和 API 参考。
打开dev-hub.canton.foundation:工具、SDK 和 API,还有一个根据文档回答问题的 AI 助手。
打开forum.canton.network:问答与讨论。你的问题可能已经有人回答过。
打开隐私模型、参与方(party)以及谁能看到什么。这正是 Canton 与其他区块链的不同之处。
刚接触区块链,还是从以太坊转过来?官方文档会为你推荐合适的路径。
一条命令安装 Daml SDK,然后创建并测试你的第一个项目。
在自己的电脑上运行一个包含 Daml 模型、后端和前端的完整应用。
按提交前检查清单准备:README、演示视频,以及“谁能看到什么”的说明。
按顺序进行。只写 Daml 的话前两步就够了;要做完整应用,还需要安装 Quickstart。
只写和测试 Daml,普通电脑就够用。如果要用 Quickstart 运行完整的 LocalNet,建议使用下面的配置。
| 仅 Daml(dpm) | Quickstart 与 LocalNet | |
|---|---|---|
| 内存(RAM) | 8 GB | 16 GB 或以上 |
| 处理器 | 2 核 | 4 核 |
| 可用磁盘 | 5 GB | 50 GB |
| 操作系统 | macOS, Linux, Windows | macOS、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。
dpm 是 Canton 开发的官方命令行工具:安装 SDK、创建项目、构建、测试和本地环境。它取代了旧的 daml 命令。
$ 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
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 # 关闭
由于需要下载 SDK,首次安装可能需要 30–90 分钟。本地界面: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(); // 打开二维码连接窗口
Seaport 是一个用于编写、构建、部署和管理 Daml 合约的云平台。无需在电脑上安装任何东西,在浏览器中即可工作;它是搭建 LocalNet 的托管替代方案。
我们从 Canton Foundation 的 Developer Hub 目录中挑选了对黑客松最有用的工具。描述只是简短摘要,详情请看各工具的页面。社区和合作伙伴工具在使用前请自行审查。
点击后才会从 YouTube 加载视频。视频为英文。
可复用的 Daml 组件:限时且可撤销的权限,以及可暂停的合约。
打开利用智能合约进行身份验证和凭证管理。
打开Canton Foundation 的工具,几条命令就能让你的项目在 LocalNet 上运行。
打开用于管理 LocalNet 的命令行和本地网页界面:DAR 管理、账本查看、快照。
打开Daml Package Manager:官方命令行工具,用于安装 Daml SDK、管理版本、构建和测试项目。
打开入门套件:本地 Canton 环境、React hooks、现成的界面组件、钱包支持和示例 dApp。
打开无需 Docker,在 Windows 和 Linux 上运行本地 Canton:沙盒、LocalNet,以及展示合约的工作台。
打开命令行工具,用于把 Daml 包上传到验证节点、创建参与方并运行脚本。
打开面向 dApp 的浏览器 SDK,以及面向钱包提供方的集成 SDK。
打开把兼容 Canton 的钱包连接到 dApp 的网络。
打开通过一个连接层把所有 CIP-0103 钱包接入你的 dApp;提供 React、Vue 和 React Native 包。
打开免费、公开的 Canton 网络浏览器和网络数据。
打开实时显示 Canton 网络活动的浏览器。
打开为 Canton 应用提供交易、余额和网络指标的数据 API。
打开扫描 Daml 合约中不安全模式的静态分析工具。
在 GitHub 上打开以 Canton 为重点的安全指南,涵盖 Daml 开发、网页应用和运维安全。
打开可视化交易、并显示提交失败原因的 dpm 插件。
在 GitHub 上打开把 Canton 官方文档连接到你的 AI 助手。地址:docs.canton.network/mcp。无需身份验证。
安装Canton Foundation 的工具目录,以及根据文档回答问题的 AI 助手。
打开Canton Foundation 官方的 Claude Skill:让你的助手掌握关于 Canton 上 Daml 合约的最新、准确知识。
在 GitHub 上打开面向 AI 的 Canton 知识库,涵盖 CIP、论坛、GitHub、文档和视频;也提供 MCP 服务器。
打开社区 MCP 集成,让你的助手掌握在 Canton 上开发的知识。
在 GitHub 上打开务必测试 AI 生成的代码。如果用了 AI,请在提交表中注明。
提交前请核对这份清单。评委不需要自己安装你的项目,他们会看视频、代码仓库和 README。主办方会在预审中确认项目能运行。
daml.yaml 以及真正的 Daml 模板:signatory、observer 和 choice 设计正确。dpm build 能构建出包, dpm test 测试通过。私密的 Daml 交易不会出现在浏览器中;这不是错误,而是 Canton 的隐私模型。浏览器只显示 Canton Coin 和网络交易。
几乎都是内存不足造成的。把 Docker Desktop 的内存调到 16 GB,运行 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,请按官方指南操作;如遇问题,请通过个人面板中的“报告问题”联系我们。
Canton Foundation 的 Protocol Development Fund 支持为整个网络带来长期价值的工作。优秀的 HackTrail 项目可以申请这项计划。