Canton 开发者文档

完整镜像 docs.canton.network 官方文档，并提供中文版。在本站即可阅读，无需跳转外部。

最近同步: 2026-06-04 · 页面数: 787

概览

  • Canton Coin

    Canton Coin（CC）用途：Traffic 费用、验证者奖励与网络治理参与。

  • Canton Coin 代币经济学

    CC 费用结构、铸造轮次、活动记录、销毁-铸造均衡与 UTXO 粉尘过期。

  • Canton 中的密码学密钥

    密钥存储选项（数据库、离线、KMS）、命名空间/节点/外部 Party 签名密钥与会话密钥。

  • Canton 协议规范

    协议技术规范索引：双层共识、账本模型、交易生命周期与拓扑参考页。

  • Canton 名称服务

    CNS 将可读名称映射到 Party ID：注册、续费、解析与 Scan/ANS API。

  • Canton 的解决方案

    Canton 如何通过子交易隐私与同步器架构化解完整性与隐私的矛盾。

  • Canton 要解决的问题

    公链全局可见性带来的抢跑、合规与商业机密风险，及常见折中方案的局限。

  • CIP 简介

    CIP 在生态中的角色：标准互操作、钱包与代币规范等。

  • CIP 索引

    Canton 改进提案（CIP）按类型与状态的参考索引。

  • CIP-0056：Canton Network 代币标准

    CIP-0056 标准接口：持仓、一步/两步转账、DvP 分配与钱包集成。

  • Global Synchronizer 架构

    Global Synchronizer 由跨 SV 的 Sequencer 与 Mediator 组成，BFT 排序与确认，协调加密交易且不见明文。

  • GSF 政策

    Global Synchronizer Foundation 治理框架、验证者入驻、流量定价与升级协调。

  • Splice 钱包参考

    Splice 参考钱包架构、Amulet/CC 持有与转账相关合约与 API。

  • SV 治理参考

    超级验证者治理流程、投票、参数变更与 Canton Foundation 政策接口。

  • 五分钟概览

    五分钟了解 Canton：隐私、同步器、Daml 与 Global Synchronizer 要点。

  • 交易如何工作

    Canton 交易四步生命周期：提交、排序分发、验证确认、提交；以 Alice→Bob 资产转移为例说明隐私与完整性。

  • 交易生命周期

    从命令提交到确认、同步器排序、参与方验证与最终性的完整流程。

  • 什么是 Canton Network

    Canton Network 定位：子交易隐私、同步器架构、Daml 与生态组件。

  • 什么是 CIP

    Canton 改进提案（CIP）流程、编号规范与已发布 CIP 索引说明。

  • 信任模型概览

    Canton 选择性信任：验证者、合约对手方、同步器、应用提供方与网络治理五个信任域及缓解措施。

  • 修剪（Pruning）

    参与方与同步器节点的数据修剪策略、保留窗口与运维注意事项。

  • 全局同步器

    Global Synchronizer 的定位、SV 运营、Canton Coin 与开放参与方式。

  • 全局同步器代币经济学

    Canton Coin、Traffic 费用、验证者奖励与 GS 经济激励设计。

  • 去中心化

    去中心化命名空间、同步器所有权与多宿主 Party 的确认阈值与外部提交。

  • 双层共识

    智能合约共识（利益相关方证明）与排序共识（BFT Sequencer）分离，使 Canton 同时实现隐私与完整性。

  • 同步器概览

    Synchronizer 在 Canton 中的角色：排序、调解、与参与方节点的关系。

  • 因果性与时间

    Daml 账本因果图、本地账本、Ledger API 排序保证与账本时间语义。

  • 多同步器架构

    合约指派、解除/重新指派、自动路由、确认策略与流量管理。

  • 应用上架与推广

    在 Canton 生态展示应用的要求、申请流程与最佳实践。

  • 拓扑

    Canton 拓扑状态：参与方、同步器连接、权限与拓扑事务生命周期。

  • 排序与共识

    全局同步器上的排序协议、BFT 共识与 Sequencer/Mediator 角色。

  • 智能合约共识

    Daml 交易在参与方侧的验证、视图分解与合约级共识流程。

  • 本地 Party 与外部 Party

    托管关系、SPN/CPN/OPN、外部签名准备/执行流程与信任模型。

  • 术语表

    Canton Network 权威术语表：ACS、Party、Synchronizer、Traffic 等。

  • 架构概览

    Canton 协调与存储分离：验证者、同步器、Party、交易流、拓扑与 Ledger API。

  • 核心概念

    Party、Contract、Synchronizer、Validator 等 Canton 基础术语与关系。

  • 用例

    DvP、代币化证券、跨组织工作流等 Canton 隐私模型擅长的场景。

  • 谁应阅读本文档

    按角色（开发者、运维、架构师）与目标选择 Canton 文档入口。

  • 账本模型

    扩展 UTXO 模型：合约生命周期、利益相关方角色、交易树、视图与可组合性。

  • 账本模型（详解）

    Canton 账本模型详解：合约、交易、授权、隐私视图与多同步器语义。

  • 超级验证者组件

    SV 节点组成：Sequencer、Mediator、治理与 DSO 相关服务。

  • 跨同步器 DvP 示例

    跨 Payments/Securities/Settlement 同步器的 DvP 交割与重新指派工作流示例。

  • 重分配协议

    合约在参与方节点间迁移（reassignment）的协议步骤与安全保证。

  • 隐私模型详解

    子交易隐私、视图分解、利益相关方可见性规则、常见模式与审计设计。

  • 验证者架构

    Canton 验证者节点内部组件：Participant、Validator 进程、PostgreSQL、Ledger API 及与同步器的出站连接。

  • 验证者节点组件

    Validator 参与方节点内部模块：Ledger API、同步、存储与运维接口。

应用开发

  • Admin API 参考

    Canton Admin API：participant、sequencer、mediator 的管理访问，用于拓扑、密钥与运维，勿暴露公网。

  • Canton Coin 与 Traffic

    CC 购买 traffic 额度；Global Synchronizer 交易费机制、自动充值、应用提供方管理与钱包集成。

  • Canton Coin 预批准

    TransferPreapproval 如何启用预批准的 Canton Coin 转入、费用与有效期、设置/续期/撤销及通过预批准转账。

  • Canton Network QuickStart

    在本地用 cn-quickstart 运行完整 Canton 应用：Daml 模型、Java 后端、React 前端与 LocalNet 沙箱。

  • Canton Network 应用架构设计

    Canton 应用组件、后端读写路径、技术栈与三种部署架构的权衡与成本视角。

  • Canton 与 JSON Ledger API

    用 curl 与 TypeScript 入门 JSON Ledger API：启用配置、创建 party/合约、查询 ACS、排错及扩展示例。

  • Canton 开发技术栈

    概览构建 Canton 应用所需的 Daml、SDK、dpm、Ledger API、LocalNet 与 PQS 等工具如何协同。

  • Canton 心智模型

    建立 Canton 开发所需直觉：私有数据库网络、合约即事实、授权即结构、视图即窗口、同步器如邮局。

  • Choice

    用 choice 为合约添加可授权的数据变换：消耗型 choice、controller、exerciseCmd 与 exercise，账本 create/exercise/fetch 事务树与隐式 Archive；并构建简单现金 IOU，以及将更新电话/地址权委托给其他参与方。

  • CI/CD 集成

    Canton 应用 CI/CD：dpm build/test、DAR 制品、容器镜像、Ledger API 部署与环境晋升（DevNet→MainNet）。

  • DA.Action

    Daml 标准库模块 DA.Action：when、unless、foldrA、filterA 等 Action 工具函数。

  • DA.Action.State

    State monad：runState、evalState、execState 与状态变量读写。

  • DA.Action.State.Class

    ActionState 类型类：get、put、modify 及状态变量法则。

  • DA.Assert

    断言与相等性检查：assertEq、===、时间截止与账本时间断言。

  • DA.Bifunctor

    Bifunctor 类型类：bimap、first、second 及 Either 等实例。

  • DA.Crypto.Text

    Alpha 加密工具：SHA256、Keccak256、SECP256K1 验签与十六进制类型。

  • DA.Date

    Date 与 Gregorian 日历：加减天数、星期、闰年与 datetime 构造。

  • DA.Either

    Either 双分支类型：lefts/rights、partitionEithers、isLeft/isRight、fromLeft/fromRight 及与 Optional 互转。

  • DA.Exception

    已弃用的 Daml 异常模块；推荐 failWithStatus/FailureStatus，避免 catch。

  • DA.Fail

    FailureStatus 与 FailureCategory：failWithStatus、invalidArgument、failedPrecondition 及 Canton 错误分类映射。

  • DA.Foldable

    可折叠结构类型类 fold/foldMap/toList 及 mapA_/forA_/sequence_/concat/and/or/any/all。

  • DA.Functor

    Functor 辅助：$>、<&>、<$$>、void 等映射与替换算子。

  • DA.Internal.Interface.AnyView

    接口 AnyView：HasFromAnyView 与 fromAnyView 将 AnyView 转回具体视图类型。

  • DA.Internal.Interface.AnyView.Types

    AnyView 与 InterfaceTypeRep 数据类型及字段访问实例。

  • DA.List

    列表排序/分组/去重/前后缀/索引与 mapAccumL、chunksOf、delete、!! 等扩展函数。

  • DA.List.BuiltinOrder

    基于 Daml-LF 内建序的 dedup/sort/unique（Daml-LF 1.11+），通常比 Ord 版更高效。

  • DA.List.Total

    列表 head/tail/last/init/!!/foldl1 等的 Optional 安全变体，空列表返回 None。

  • DA.Logic

    命题演算：Formula 类型、合取/析取/否定与 NNF、DNF 化简及求值。

  • DA.Map

    泛型 Map（Daml-LF 1.11+）：查找、插入、合并、过滤与 Ord 键约束。

  • DA.Math

    Decimal 数学函数：幂、根、exp/log 与三角函数；高精度但非高性能。

  • DA.Monoid

    Monoid 新类型：All/Any、Endo、Product、Sum 及相应实例。

  • DA.NonEmpty

    非空列表类型与函数：cons、append、fold、qualified import 约定。

  • DA.NonEmpty.Types

    NonEmpty 类型定义（稳定 package id）；通常由 DA.NonEmpty 再导出。

  • DA.Numeric

    Numeric 运算与 RoundingMode：mul/div、cast、shift、roundNumeric。

  • DA.Optional

    Optional 工具：fromSome、catOptionals、whenSome、findOptional 等。

  • DA.Record

    GetField/SetField/HasField：记录多态 getter/setter 与记录语法说明。

  • DA.Semigroup

    Semigroup 新类型 Min/Max：在 min/max 下的 <> 运算。

  • DA.Set

    Daml 集合类型 Set k：empty、insert、union 等；需 Ord k，仅 Daml-LF 1.11+。

  • DA.Stack

    调用栈 SrcLoc 与 prettyCallStack、getCallStack、callStack。

  • DA.Text

    Text 拆分、拼接、前缀/后缀、解析 Int/Decimal/Numeric 与 sha256 等工具函数。

  • DA.TextMap

    Text 键关联数组 TextMap：fromList、lookup、insert、merge 等。

  • DA.Time

    Time/RelTime 运算、相对时间构造与 isLedgerTime* 账本时间比较。

  • DA.Traversable

    Traversable 类型类：mapA、sequence、forA；可从左到右遍历的数据结构。

  • DA.Tuple

    元组工具：first/second/both/swap、三元组 fst3/snd3/thd3 与 curry3。

  • DA.Validation

    Validation 类型：可累积多条错误的校验结果，含 ok/invalid/run 等。

  • Daml 标准库

    概览 Prelude 与列表、元组、Optional、Either，Eq/Ord/Show/Functor/Applicative/Action 等类型类，DA.List 等模块分工，Foldable/Traversable 泛化迭代，以及用 Daml Hoogle 按名称或类型签名查找函数。

  • Daml 语言参考

    Daml 模板、choice、数据类型、表达式、包、接口与异常的完整语言参考。

  • Daml 错误码

    Daml 编译、Canton 运行时与 Ledger API 常见错误码参考。

  • Daml-LF 参考

    Daml-LF 类型转换、JSON 编码、Protobuf 映射、包与 DAR 文件结构。

  • Featured App 活动标记

    FeaturedAppActivityMarker 记录应用经济活动，SV 自动化转换为 AppRewardCoupon 并发放 CC 奖励；含创建步骤与 featured 申请流程。

  • IDE 配置

    为 Canton 应用开发配置 VS Code 与其他 IDE（Daml、Java、全栈工具）。

  • Java 中的合约与交易

    通过 Java 客户端与 Daml Codegen 在 Java 应用中读写账本合约与交易。

  • Ledger API 中的值

    值的宽松校验、规范化与动态包解析。

  • Ledger API 客户端 OpenTracing

    在 Daml 应用中接入 OpenTelemetry 分布式追踪。

  • Ledger API 错误

    提交命令时常见的 Ledger API gRPC 状态码、成因与修复步骤。

  • LocalNet 开发

    cn-quickstart LocalNet 拓扑、开发五阶段、启停与端口规律，以及日志与 Canton Console 调试。

  • PQS SQL

    Participant Query Store (PQS) 完整 SQL API：表函数、offset 管理、维护操作与 JSONB 索引。

  • Prelude

    Daml Prelude：内建类型、类型类、模板/接口函数与常用列表/Optional 工具。

  • SDK 与 API

    Canton SDK、dpm 代码生成、Ledger API（gRPC/JSON）、PQS 与 Wallet SDK 的用途与选型。

  • SV 运营网络与用例

    DevNet/TestNet/MainNet 定位、应用运营商测试指南，以及 Daml Script、CI 集成与 TestNet 部署三层测试。

  • 代币标准

    Canton Network 代币标准 API 与 Daml 接口概览，含 Holding UTXO 管理与钱包集成指引。

  • 代币经济学

    轮次、活动记录、CC 转账、流量与奖励分配。

  • 使用 JSON Ledger API

    在 LocalNet 用 JSON Ledger API 创建 Party、上传 DAR、建合约并完成许可续期全流程。

  • 使用 lnav 调试

    用 lnav 查看、过滤与分析 Quickstart 的 Canton 结构化日志与 trace ID。

  • 使用 PQS 查询合约与交易

    Participant Query Store 通过 SQL 查询 ACS：active()、JSONB 过滤、join、聚合、历史 offset 与性能优化。

  • 最新动态

    Canton Network 各组件发布说明入口、版本兼容性看板、升级指引与跟进渠道。

  • 函数式编程入门

    Daml 函数式编程：函数类型与应用、中缀与类型类、模式匹配、控制流、fold/map 与 Action 中的 mapA。

  • 分配与查询 Daml Party

    通过 JSON Ledger API 在 participant 上创建与发现 Daml Party，含查询与分配示例。

  • 前端开发

    以 cn-quickstart 为例：React/TypeScript、OpenAPI 客户端、Context 状态、OAuth2 认证、钱包集成与评论 UI 练习。

  • 前置条件与安装

    CN Quickstart 环境要求：Docker、Nix、Direnv 与 LocalNet 分步/快速安装。

  • 包命名

    反向 DNS、合约模型版本标记、接口与模板分包，以及破坏性变更时的新包命名。

  • 包管理

    跨环境 DAR 生命周期、SDK 版本固定、依赖与制品库、向对手方分发及按 stakeholder 模块化包。

  • 包选择

    多版本共存时的运行时解析、符号化包引用、vetting/unvetting 及跨版本 fetch 的安全失败规则。

  • 升级兼容性

    SCU 允许的向后兼容变更、破坏性变更规则，以及后端符号包引用与包命名约定。

  • 升级架构考量

    Canton Network 应用跨版本升级：异步 rollout、同步切换、向后兼容、测试与回滚。

  • 升级部署

    v1→v2 部署序列、对手方协调、合约迁移策略、回滚方式及按环境分阶段推广。

  • 升级限制

    SCU 硬性边界：包不可删除、模板不可移除、字段/choice/变体构造器不可删及规划兼容变更。

  • 去中心化

    Canton 栈各层去中心化策略：单验证者、多验证者、多方托管、BFT 同步器与多同步器。

  • 可观测性

    Canton 应用生产环境的日志（Logback JSON）、Prometheus 指标、Grafana 仪表盘与告警配置。

  • 可观测性与链路追踪

    Quickstart 可观测性栈：Grafana、Tempo、Prometheus、lnav 与关联 ID 排障。

  • 合约模板

    最小 Daml 模板：账本提交与合约、模块与文件、模板字段、签署方，以及合约不可变与活跃集合。

  • 合约键

    合约键提供稳定业务标识：key/maintainer、fetchByKey、lookupByKey、exerciseByKey 的查找顺序，多合约同键时 DA.ContractKeys，以及 Script 侧 queryByKey 与 exerciseByKeyCmd。

  • 合规考量

    Canton 应用的隐私、审计与监管相关技术特性：子交易隐私、PQS 审计、数据驻留、不可变账本与 GDPR 等设计指引。

  • 后端开发

    以 cn-quickstart 为例：连接 Ledger API/PQS、命令提交与 SQL 查询、错误处理及许可评论完整后端练习。

  • 命令去重

    Daml 命令去重机制及应用在已知/未知处理时间边界下实现恰好一次账本变更。

  • 在 Daml 中组合多方工作流

    提议-接受、委托、授权链、原子组合与接口等高级多方 Daml 设计模式。

  • 在 Quickstart 中接入外部 Party

    外部 Party 自管签名密钥：OpenSSL 密钥、拓扑 API 与交互式提交三步流程。

  • 处理时间

    为 Coin/TransferProposal 实现截止、延迟与时间窗约束，比较 ledger time 原语与 getTime；并说明 ensure 前置条件、assertMsg、账本 LT/RT/skew，以及 Action、do 块与纯函数错误处理。

  • 外部签名

    用外部密钥签署 Canton 交易：概述、Party 入网与提交流程。

  • 外部签名：Party 入网

    通过 Admin API 或 Ledger API 入网外部 Party：拓扑映射、多交易哈希签名与多方托管。

  • 外部签名：哈希算法

    PreparedTransaction 确定性哈希规范（V2），供外部 Party 私钥签名授权账本变更。

  • 外部签名：拓扑交易

    构建、签署并提交拓扑交易；哈希、指纹、命名空间委托与 Admin API 提交流程。

  • 外部签名：提交交易

    InteractiveSubmission 准备、签署、执行外部签名交易（含第 2 部分显式披露）。

  • 多托管与韧性

    多验证者托管同一 Party 以实现高可用与故障转移。

  • 多方工作流

    Canton 与以太坊在多方协调上的差异：提议-接受模式、委托、多步状态机、原子多合约操作及隐私下的视图划分。

  • 如何上传与查询 Daml 包

    经 JSON Ledger API 上传 DAR、用 damlc 提取包 ID，并查询 participant 上已注册包状态。

  • 安全最佳实践

    链上授权、Ledger API 认证与 TLS、密钥管理、安全配置及 Open Tracing、Authorization 深度专题链接。

  • 安装问题

    排查 Canton Network 开发环境安装中的 Nix、Docker 与内存问题。

  • 将 Quickstart 部署到 DevNet

    从 LocalNet 把 Quickstart 部署到 DevNet：验证者申请、VPN、主机名与端到端验证。

  • 常见问题

    Canton Network 应用开发常见问题与解答。

  • 常见问题 FAQ

    验证者与开发者常见问题：环境区别、运维、认证、交易错误、Quickstart、备份与 CC 钱包。

  • 应用奖励

    说明应用如何通过 Featured 应用活动与奖励券在 Canton Network 上获得 Canton Coin 激励。

  • 应用开发者隐私模型

    解释 Canton 子交易级隐私：交易视图分解、利益相关方共识、披露模式，以及可审计性。

  • 应用架构

    Canton 应用分层：Daml 模型、后端连接 Ledger API/PQS、前端经 REST；角色与完全中介架构选型。

  • 开发工具概览

    Canton 开发工具链概览：DPM、Daml Studio、Canton Console、Sandbox、LocalNet 与 PQS。

  • 开发环境搭建

    介绍 Daml 账本结构，并通过资产持有与交易示例学习编写、测试、编译与发布 Canton 应用。

  • 开发问题

    排查 Daml 编译错误、API 连接问题与开发期交易失败。

  • 性能优化

    Canton 应用的网络/节点扩展、批处理、存储、配置与模型调优。

  • 性能最佳实践

    Canton 应用性能指南已整合至 Performance Optimization 深度专题；含排障链接。

  • 授权

    Canton Ledger API 的访问令牌、身份提供方、作用域与权限说明。

  • 授权模型

    Daml 授权：signatory、observer、controller；IOU 撤销问题、提议-接受与角色合约、权限传递及形式化授权规则。

  • 接口

    Daml 接口声明与 interface instance：viewtype、方法与接口 choice，toInterface/fromInterface 等函数，requires 依赖闭包，及 Canton 上 CIP-0056 Token 与 CIP-0103 dApp 标准。

  • 故障排查速查表

    Canton Network 应用开发详细故障排查指南索引。

  • 显式合约披露

    向非利益相关方链下披露合约，使提交方在交易中附带披露合约并绕过可见性限制。

  • 智能合约升级（SCU）

    Daml 包透明升级：兼容规则、示例、包选择与测试。

  • 智能合约升级参考

    DAR 上传静态检查与运行时升降级详细规则。

  • 智能合约升级概览

    介绍 Canton 智能合约升级（SCU）为何重要、异步 rollout 与同步切换模型，以及包版本共存与零停机升级思路。

  • 智能合约范式转变

    Solidity 与 Daml 在编程范式、可变/不可变状态、UTXO 式持仓、类型系统、授权与多方模式上的对比及需调整的习惯。

  • 构建与打包

    DAR/Daml-LF、包哈希与标识符、dependencies 与 data-dependencies、多包项目结构，以及用 dpm 构建、测试与打包部署。

  • 构建应用

    模块 4 从 Daml 合约到全栈 Canton 应用：架构、SDK/API、后端与前端开发，以及 Canton Coin 与 traffic。

  • 概念对照表

    以太坊到 Canton 的详细概念映射：协议、身份、合约、交易、授权、网络、工具与常见模式，以及无法直接平移的概念。

  • 模块 1：理解 Canton

    在动手写代码前建立 Canton 概念基础：隐私优先、无全局状态、不可变与声明式授权。

  • 测试 Daml 合约

    intro-test 多包将模板与 script 分离；在 VS Code 用 Script results 调试，用 dpm test 做回归与 choice 覆盖率，debug/trace 排错，并对比 Daml Script、sandbox 与 LocalNet 的集成测试场景。

  • 测试升级

    验证升级兼容性、跨版本工作流测试与回归策略；含类型级/工作流级测试、Daml Script 模式与 CI 集成。

  • 测试策略

    Canton 应用测试金字塔：Daml Script 单元测试、后端集成、E2E、性能测试及 flaky 测试处理。

  • 环境配置

    DPM 全局与项目配置、daml.yaml 环境变量插值，以及 LocalNet 与共享网络的认证设置。

  • 生产环境中的智能合约升级

    生产 SCU rollout 的运营清单：升级前检查、对手方沟通、混合版本部署、监控与回滚程序。

  • 组合与设计模式

    intro-compose 可拆分资产与 Trade 工作流：组合 choice/script、原子交易与观察方披露，隐私原则与 divulgence；并详解 Coin 模型的提议-接受、委托、授权、锁定与 Pending 多方签署等模式。

  • 编写你的第一个升级

    分步教程：从 v1 许可模板出发，添加 Optional 字段与新 choice，验证 SCU 兼容并模拟跨版本行为。

  • 网络架构对比

    Canton 与以太坊在网络拓扑、验证者与同步器角色、交易/查询流程及应用设计（数据可用性、UX、扩展）上的差异。

  • 详情与历史

    Daml 标准库模块总览：版本 3.4.11、各模块生命周期与版本变更摘要。

  • 语言基础

    Daml 函数、控制流与数据类型：函数应用、fold/map、记录与变体，及合约不可变更新方式。

  • 调试工具

    调试 Canton 应用的工具与工作流：测试输出、Canton Console、PQS 查询与日志分析。

  • 迁移清单

    以太坊开发者迁移到 Canton 的分阶段清单：架构评估、Party 建模、合约翻译、API/索引、测试与部署，以及常见陷阱。

  • 运维问题

    DevNet、TestNet 与 MainNet 上流量耗尽、升级与 PQS 故障的排障指南。

  • 运行演示

    启动 Quickstart 许可演示：安装请求、续期、Canton 钱包付款与 Console/Shell。

  • 选择你的学习路径

    根据你的背景（区块链新手、以太坊开发者、架构/产品）选择最高效的 Canton 学习与开发路径。

  • 部署晋级路径

    LocalNet→DevNet→TestNet→MainNet 四环境差异、Global Synchronizer 三类升级与晋级检查清单。

  • 配置参考

    Canton HOCON 配置、DPM 项目设置、存储、命令行参数与环境变量参考。

  • 错误处理

    Canton 应用中的命令拒绝、争用、超时、流量不足及幂等提交、完成流监控与后端恢复模式。

  • 错误码

    Canton 错误码、类别、gRPC 状态映射与重试策略参考。

  • 隐私模型差异

    Canton 默认私有、子交易级视图、私有账本视图、同步器可见范围，以及与 L2/ZK/通道的对比及开发者设计清单。

  • 面向区块链开发者的 Canton

    将以太坊/区块链概念映射到 Canton：同步器、模板与 Choice、Party 授权、默认隐私，以及需调整的心智模型与常见陷阱。

  • 项目结构

    cn-quickstart 目录、Gradle/Make、Docker Compose 与许可应用四层架构说明。

全局同步器

  • BFT 排序器架构

    Canton 同步器 BFT Orderer 的信任模型、API 与交易排序流水线。

  • Canton API 配置

    Admin API、gRPC Ledger API、JSON Ledger API 端口与缓存等通用配置。

  • Canton Console 参考

    验证者与 SV 运维所需的 Canton Console 访问方式与调试流程。

  • Canton Console 命令

    Canton 管理控制台命令参考：参与方、排序器、中介者与拓扑命令。

  • Canton Docker 运维

    获取与运行 Canton Docker 镜像、环境变量、端口与自定义配置。

  • Canton KMS 运维

    为 Canton 配置与运维 KMS：AWS/GCP/驱动模式、信封加密、外部密钥与轮换。

  • Canton Network 全局同步器

    全局同步器在 Canton Network 中的定位、角色与代币经济学概览。

  • Canton 入门教程

    安装 Canton、理解拓扑、连接同步器并执行首笔 Daml 交易。

  • Canton 发布说明

    Canton 工具（含 PQS、Daml Shell、Daml 语言等）的版本发布说明。

  • Canton 可观测性配置

    在 Canton 节点上配置日志、追踪、指标与健康检查。

  • Canton 多重签名

    去中心化命名空间、去中心化 Party 托管与去中心化提交签名。

  • Canton 安全配置

    为 Canton 节点配置 TLS、JWT 认证与 API 限制。

  • Canton 指标

    Canton 节点导出至 Prometheus 的指标类型与说明。

  • Canton 节点备份与恢复

    备份与恢复 Canton 参与方与同步器节点，含数据库复制与灾备。

  • Canton 身份管理

    链上拓扑身份、拓扑事务、参与方入驻与用户身份管理 cookbook。

  • Canton 配置指南

    使用 HOCON、命令行与声明式配置 Canton 节点（静态与动态配置）。

  • Console 概览

    访问 Participant、Sequencer、Mediator Console 的配置与 Docker/K8s 步骤。

  • Docker Compose 验证者部署

    使用 Docker Compose 部署独立验证者节点、钱包与 CNS UI 的完整指南。

  • KMS 驱动开发指南

    自定义 Canton KMS Driver 的 API、实现步骤与配置方法。

  • Kubernetes 验证者部署

    使用 Helm 在 Kubernetes 上部署验证者、认证、流量充值与运维配置。

  • Okta 与 Keycloak OIDC 配置

    验证者节点部署时 Okta 与 Keycloak OIDC 提供方逐步配置说明。

  • Party 管理

    在 Canton 节点上管理 Party：分配、复制与去中心化 Party 配置。

  • Splice 发布说明

    Global Synchronizer 软件的版本发布说明与历史记录。

  • Splice 指标参考

    Canton Network 验证者与超级验证者节点暴露的监控指标说明。

  • Splice 指标概览

    Canton Network 各组件暴露的 Prometheus 指标及抓取方式。

  • SV 网络重置

    DevNet/TestNet 定期重置时超级验证者节点的备份、卸载与重新部署步骤。

  • SV 运维概览

    超级验证者运营：入驻密钥、身份层级、奖励权重、流量参数与 Scan 重摄取。

  • 下线 Canton 节点

    参与方节点与同步器实体下线的前置条件与不可逆注意事项。

  • 交易失败

    授权错误、包 vetting 失败、超时与 ACS 承诺不一致排查。

  • 修剪

    全局同步器节点的定序器与 CometBFT 修剪及参与方自动修剪配置。

  • 关键指标

    验证者与 SV 节点的就绪/存活探针及核心运维监控指标。

  • 前置条件

    运行 Canton Network 验证者的硬件、内存与数据库延迟要求。

  • 升级 Canton 节点

    升级 Canton 参与方与同步器二进制、变更协议版本的完整指南。

  • 同步器流量

    全局同步器上的流量计费、参数查询、自动充值与浪费流量监控。

  • 同步器监控

    Sequencer/Mediator 健康检查、裁决（verdict）检查与故障排查。

  • 同步器运维

    集中式/去中心化同步器引导、拓扑、参数与日常运维操作。

  • 如何引导网络

    以超级验证者身份从零引导新 Canton Network 的 Helm 配置要点。

  • 安全问题

    证书、JWT 校验与 KMS 密钥管理相关的安全故障排查。

  • 安装兼容的 Daml SDK

    如何安装与当前 Splice 版本兼容的 Daml SDK。

  • 安装问题

    Docker、Kubernetes 与网络层面的验证者安装故障排查。

  • 密钥管理

    节点密钥列举、轮换、生成、停用、删除与密码方案配置。

  • 将验证者连接到多个同步器

    验证者连接多个同步器、拓扑注册与跨同步器工作流配置。

  • 常用命令

    Canton Console 健康检查、Party、包管理与拓扑查询命令参考。

  • 常见错误码

    验证者运维中最常遇到的 Canton 与 Splice 结构化错误码说明。

  • 常见问题

    验证者、超级验证者与 JSON API 等 Canton Network 运维常见问题。

  • 常见问题

    验证者搭建、运维与升级相关的 Global Synchronizer 常见问题。

  • 开发基金

    验证者运营方如何访问与使用 Splice 开发基金。

  • 必需网络参数

    初始化验证者并连接网络所需的 MIGRATION_ID、SPONSOR_SV_URL 等参数。

  • 性能优化

    为验证者与 SV 调优数据库、JVM、定序器容量与修剪策略。

  • 性能问题

    交易变慢、资源耗尽与数据库瓶颈等性能问题处理。

  • 支持的密码学方案

    Canton 支持的签名、对称/非对称加密方案与密钥格式。

  • 故障排查方法论

    收集日志、配置与常见错误信息的系统化排查方法。

  • 本地测试

    基于 Docker Compose 的 LocalNet 本地 Canton Network 部署与使用。

  • 术语表

    Canton Network、Splice 与 CNS 相关术语释义。

  • 混合同步器模式

    私有同步器与全局同步器并行的混合部署、合约迁移与配置。

  • 灾难恢复

    数据损坏恢复、SV 完整节点还原与通过验证者找回 Amulet。

  • 独立私有同步器

    不连接全局同步器、完全独立运行的私有 Canton 同步器部署与取舍。

  • 监控搭建

    Canton 监控示例：Prometheus、Grafana、ELK、健康端点与 ACS 承诺监控。

  • 社区 Docker Compose 部署

    社区贡献的 Canton 验证者 Docker Compose 方案与 x-docker 标准。

  • 社区 Helm 模板工具

    社区 Helm/Kubernetes values 模板工具，多环境 DevNet/TestNet/MainNet。

  • 社区 Keycloak 配置

    验证者节点 Keycloak OIDC 端到端配置：Realm、Client Scope 与 Mapper。

  • 私有同步器

    与全局同步器并行的扩展同步器：隐私、性能、治理与连接方式。

  • 私有同步器上的验证者

    仅连接私有同步器、无需全局同步器连接的验证者部署与选型。

  • 管理 Daml 包与归档

    在参与方节点上上传、审查（vet）与取消审查 Daml 包。

  • 网络可扩展性

    Canton Network 节点的扩展特性、Party 数量限制与调优建议。

  • 脚本编写

    用 Scala/Ammonite 编写 .canton 脚本、自动化运维与健康检查。

  • 自定义配置

    验证者/SV 应用 HOCON 扩展配置、ADDITIONAL_CONFIG 与 bootstrap 脚本。

  • 节点运维入门

    Canton Network 全局同步器上验证者节点运维的概念、环境与职责。

  • 调试工作流

    用 Canton Console 诊断卡住交易、连通性与 ACS 不一致等问题。

  • 超级验证者 Helm 部署

    在 Kubernetes 上使用 Helm 部署超级验证者（SV）完整节点。

  • 超级验证者修剪

    超级验证者节点上 Sequencer 与 CometBFT 的修剪配置。

  • 超级验证者升级

    超级验证者节点的小版本升级流程与注意事项。

  • 超级验证者备份

    超级验证者节点身份、数据库与 CometBFT 的备份流程。

  • 超级验证者奖励

    超级验证者节点如何获得并分配 Canton Coin 奖励。

  • 超级验证者安全

    超级验证者节点安全加固、KMS 配置与第三方 Daml 应用说明。

  • 运维手册

    验证者离线、流量耗尽、磁盘满与升级回滚等事件运维手册。

  • 连接问题

    同步器连接失败、TLS 握手错误与 VPN 相关连通性排查。

  • 逻辑同步器升级

    通过逻辑同步器升级（LSU）以极低停机升级全局同步器协议版本。

  • 部署选项

    Docker Compose 与 Kubernetes 验证者部署方式对比及选型建议。

  • 配置参考

    验证者与超级验证者的 Splice、Canton、数据库、认证与可观测性配置项。

  • 配置问题

    HOCON 解析错误、文件权限与环境变量冲突等配置故障排查。

  • 铸造委托

    验证者如何为节点上托管的外部 Party 委托铸造权限。

  • 错误码参考

    Canton 结构化错误码、日志级别含义与运维需关注的错误类别。

  • 验证者入站与出站要求

    验证者节点的网络入站/出站与 SV 连通性要求。

  • 验证者入驻流程

    通过 SV 赞助在 DevNet、TestNet、MainNet 入驻验证者的步骤与 IP 校验。

  • 验证者升级

    验证者节点版本升级与协议升级的操作说明与注意事项。

  • 验证者备份

    验证者节点身份、数据库与组件转储的备份流程。

  • 验证者安全

    验证者节点安全加固与参与方密钥的外部 KMS 配置。

  • 验证者活跃度

    验证者活跃度奖励及其代币经济学机制。

  • 验证者灾难恢复

    验证者节点灾难恢复与从备份/转储恢复的详细步骤。

  • 验证者用户与钱包

    在验证者上管理用户、Party 关联、自定义 Party Hint 与禁用钱包。

  • 验证者网络重置

    DevNet/TestNet 定期重置时验证者节点的卸载与重新部署步骤。

  • 验证者角色与职责

    Canton Network 验证者的运维职责、期望与成本说明。

  • 高级 Canton Console

    Canton 管理控制台：远程管理、节点引用、超时与 gRPC 管理 API。

  • 高级运维操作

    Canton Console 高级操作：拓扑管理、密钥轮换与修复流程。

集成

  • API

    Wallet Gateway 的 dApp API 与 User API、SSE 与速率限制。

  • Canton Network 生态

    治理、基础设施、应用类别、开发者工具与参与方式。

  • Canton 钱包与 Web3 钱包

    Canton 钱包在隐私、余额与浏览器集成上与 Web3 钱包的差异。

  • dApp SDK

    @canton-network/dapp-sdk 版本发布说明（摘自 GitHub releases）。

  • dApp 构建概览

    dApp、Wallet Gateway 与 Canton Network 的关系、架构与连接流程。

  • Wallet Gateway

    @canton-network/wallet-gateway-remote 版本发布说明。

  • Wallet SDK

    Canton Network Wallet SDK 各版本功能与修复说明。

  • Wallet SDK v1 迁移

    从 v0 迁移到 Wallet SDK v1 API 的分模块指南。

  • Wallet SDK 下载

    安装 @canton-network/wallet-sdk 与相关资源链接。

  • 下载

    通过 npm、yarn 或 pnpm 安装 @canton-network/dapp-sdk。

  • 下载

    安装并启动 @canton-network/wallet-gateway-remote。

  • 交易所 SDK 下载

    Wallet SDK、Java 示例与分阶段交易所集成里程碑。

  • 交易所集成指南

    交易所与 Canton 集成的架构、工作流、交易摄取、容错、备份与扩展。

  • 最佳实践

    dApp SDK 集成的推荐模式（文档占位，待补充详细内容）。

  • 发现 Canton Network 应用

    在官方生态目录浏览应用，或自行开发与申请上架。

  • 故障排除

    Wallet Gateway 常见问题：数据库、认证、网络、端口与签名。

  • 用户钱包指南

    终端用户选择与管理 Canton Coin 钱包的说明。

  • 用法

    dApp SDK 与 Provider API：连接、账户、交易、事件与 Ledger API 代理。

  • 用法

    User UI、User API 与典型钱包/ dApp 操作流程。

  • 签名提供方

    Wallet Gateway 支持的内部、Participant、Fireblocks、Blockdaemon、Dfns 签名。

  • 转账证明

    在 Canton 上生成与验证转账证明的机制与用法。

  • 适配器与发现

    dApp SDK 适配器注册、默认网关与钱包选择器发现机制。

  • 配置

    远程 Wallet Gateway 的 JSON 配置：内核、服务、存储与签名。

  • 钱包交易所集成

    钱包侧交易所集成说明（镜像官方 wallet-integration-guide）。

  • 钱包提供方集成

    钱包/扩展如何出现在 dApp SDK 发现与选择器中。

  • 钱包配置

    Wallet SDK 在 LocalNet、DevNet、TestNet 与 MainNet 的连接与认证配置。

  • 钱包集成指南

    应用开发者使用 Wallet SDK 的完整集成指南。

  • 集成概览

    钱包、交易所、代币标准与应用集成类别及与公链的差异。

  • 集成模式

    钱包、代币、应用与数据访问的常见 Canton 集成模式。

  • 验证者节点运维

    交易所验证者：奖励铸造、流量、Party 设置、Ledger API 用户与主升级。

参考

API 参考

  • API 参考

    Canton 全部程序化接口索引：Ledger API、gRPC、TypeScript、标准库、dApp API、Wallet Gateway 与 Splice OpenAPI。