Diem Move 框架 VASP 模块深度解析:双层账户层级、凭证发布与链上合规机制
Diem Move 框架 VASP 模块深度解析:双层账户层级、凭证发布与链上合规机制
导读
0x1::VASP 是 Diem 区块链 Move 标准框架中负责管理 VASP(Virtual Asset Service Provider,虚拟资产服务提供商)账户的核心模块。它定义了"父 VASP + 子 VASP"的两层账户层级结构,是链上账户限额(AccountLimits)、双签证明(DualAttestation)等合规机制的数据基础。读完本文,你将掌握 ParentVASP 与 ChildVASP 两种链上资源的结构与语义、父/子 VASP 凭证的发布流程与全部中止条件、账户类型判定与层级导航 API,以及模块级形式化规格如何约束这些不变量。
VASP 账户模型:两层层级结构
在 Diem 网络中,VASP 是持币账户(balance-holding account)的一种,涵盖交易所、托管机构、金融机构等需要合规运营的实体。模块文档明确指出,VASP 形成两层层级(two-layer hierarchy):
- 父 VASP(Parent VASP):每个 VASP 的唯一根账户,持有
ParentVASP资源; - 子 VASP(Child VASP):挂在父 VASP 名下的业务账户,持有
ChildVASP资源。
该模块的全部职责是管理这两类 VASP 账户:创建凭证、查询类型、导航层级。它本身不直接持有余额,余额管理由 DiemAccount 承担;模块只依赖 AccountLimits、DiemTimestamp、Roles、Errors、Signer 五个库(见 VASP.move 的头部 import)。
从源码结构看,模块内部明确划分为两个区块:// To-be parent-vasp called functions(发布凭证的 friend 函数)与 // Publicly callable APIs(公开查询 API),这体现了"写操作受控、读操作公开"的设计意图。
链上资源:ParentVASP 与 ChildVASP
VASP 模块定义了两个 has key 资源,分别标识账户在层级中的身份。
Resource ParentVASP
struct ParentVASP has key {
/// Number of child accounts this parent has created.
num_children: u64
}
每个 VASP 有且只有一个持有 ParentVASP 资源的根账户。该资源记录两个层面的信息:VASP 的全局唯一名称,以及其它 VASP 与该实体执行**链下协议(off-chain protocols)**所需的全部元数据(模块文档原文)。当前版本中,资源内实际存储的唯一字段是 num_children——父 VASP 已创建的子账户数量,该计数器由创建子 VASP 的流程自增维护。
Resource ChildVASP
struct ChildVASP has key {
parent_vasp_addr: address
}
ChildVASP 代表父 VASP 账户(地址为 parent_vasp_addr)的一个子账户。它是层级导航的关键:仅凭 parent_vasp_addr 一个地址字段,链上即可把任意子账户归并到其父账户,从而让账户限额、双签证明等策略在"整个 VASP"粒度上生效。
模块常量:错误码与硬上限
模块定义了 4 个错误码与 1 个数量上限常量:
| 常量 | 值 | 语义 |
|---|---|---|
EPARENT_OR_CHILD_VASP |
0 | ParentVASP 或 ChildVASP 资源未处于所需状态(如目标账户已存在 VASP 资源) |
ETOO_MANY_CHILDREN |
1 | 创建新子 VASP 会使父 VASP 的子账户数超过允许上限 |
ENOT_A_VASP |
2 | 账户既不是父 VASP 也不是子 VASP |
ENOT_A_PARENT_VASP |
3 | 创建者账户必须是父 VASP 账户 |
MAX_CHILD_ACCOUNTS |
65536(2^16) | 单个父 VASP 可创建子账户的最大数量 |
MAX_CHILD_ACCOUNTS 在 VASP.move 中以 65536(即 2^16)定义,配合 ETOO_MANY_CHILDREN 在子账户创建入口强制执行,防止单个父 VASP 无限扩张子账户、导致层级结构失控。
凭证发布:如何创建父/子 VASP
两个发布函数均为 public(friend) 可见性,唯一的 friend 是 DiemFramework::DiemAccount(见 VASP.move)。这意味着普通用户无法直接调用,必须经由 DiemAccount 的账户创建流程间接触发,将凭证发布与角色分配、余额初始化等步骤原子地捆绑在一起。
publish_parent_vasp_credential
public(friend) fun publish_parent_vasp_credential(vasp: &signer, tc_account: &signer)
在 vasp 账户下创建新的 ParentVASP 资源。实现分四步校验与写入:
DiemTimestamp::assert_operating():链必须处于运行状态;Roles::assert_treasury_compliance(tc_account):tc_account必须是 TreasuryCompliance 账户(即监管合规签发方);Roles::assert_parent_vasp_role(vasp):vasp必须先被授予 ParentVASP 角色;assert(!is_vasp(vasp_addr), ...):该地址上不得已存在任何 VASP(父或子)资源,否则以Errors::already_published(EPARENT_OR_CHILD_VASP)中止;
通过后 move_to(vasp, ParentVASP { num_children: 0 }),子账户计数初始化为 0。
实际调用链在 DiemAccount.move 的 create_parent_vasp_account<Token> 中可见:它先由 TreasuryCompliance 签发方调用,依次执行 Roles::new_parent_vasp_role、VASP::publish_parent_vasp_credential、Event::publish_generator、DualAttestation::publish_credential(登记人类可读名称 human_name)、VASPDomain::publish_vasp_domains,最后 make_account 并附加货币余额。一个 ParentVASP 账户的诞生是"角色 + VASP 凭证 + 事件生成器 + 双签凭证 + 域名"五件套的原子组合。
publish_child_vasp_credential
public(friend) fun publish_child_vasp_credential(
parent: &signer,
child: &signer,
) acquires ParentVASP
为 parent 创建一个子 VASP 凭证。流程:
Roles::assert_parent_vasp_role(parent)与Roles::assert_child_vasp_role(child):父账户需为 ParentVASP 角色,子账户需为 ChildVASP 角色;assert(!is_vasp(child_vasp_addr), ...):子地址不得已存在 VASP 资源;assert(is_parent(parent_vasp_addr), ...):父地址必须持有ParentVASP资源,否则以Errors::invalid_argument(ENOT_A_PARENT_VASP)中止;assert(*num_children < MAX_CHILD_ACCOUNTS, ...):若子账户数已达上限,以Errors::limit_exceeded(ETOO_MANY_CHILDREN)中止;- 将
num_children自增 1,并move_to(child, ChildVASP { parent_vasp_addr })写入子凭证。
对应的调用入口是 DiemAccount.move 的 create_child_vasp_account<Token>:父 VASP 自行调用,流程为 Roles::new_child_vasp_role → VASP::publish_child_vasp_credential → Event::publish_generator → make_account → 附加货币余额。注意子账户创建不需要 TreasuryCompliance 参与,体现了"父 VASP 自主管理自身子账户"的权限模型。
在测试侧,testsuite/smoke-test/src/test_utils.rs 中的账户创建工具直接调用 chain_info().create_parent_vasp_account(Currency::XUS, account.authentication_key()) 生成测试用父 VASP,随后用 fund 注入余额,可作为端到端理解创建流程的参考。
公开查询 API:类型判定与层级导航
以下函数全部为 public,供链上任意模块与合约查询 VASP 状态。
is_parent / is_child / is_vasp
public fun is_parent(addr: address): bool { exists<ParentVASP>(addr) }
public fun is_child(addr: address): bool { exists<ChildVASP>(addr) }
public fun is_vasp(addr: address): bool { is_parent(addr) || is_child(addr) }
三个谓词都以"资源是否存在"作为判定标准,语义直接、无副作用。is_vasp 是前两者的逻辑或,表示该地址属于 VASP 体系(父或子)。从实现看,它们都是只读的 exists 查询,不中止(spec 中 aborts_if false)。
parent_address
public fun parent_address(addr: address): address acquires ChildVASP
层级导航的核心函数:若 addr 是父 VASP 则原样返回自身地址;若是子 VASP 则返回其 ChildVASP.parent_vasp_addr;否则以 Errors::invalid_argument(ENOT_A_VASP) 中止。它把"任意 VASP 地址 → 根账户地址"统一起来,是后续一切按 VASP 粒度做策略判断的前置工具。
is_same_vasp
public fun is_same_vasp(addr1: address, addr2: address): bool acquires ChildVASP
返回 is_vasp(addr1) && is_vasp(addr2) && parent_address(addr1) == parent_address(addr2):仅当两个地址都是 VASP 且具有相同父地址时为真。这直接服务于"同一实体内部转账 vs 跨实体转账"的合规区分——见下文 DualAttestation 的联动。
num_children
public fun num_children(addr: address): u64 acquires ChildVASP, ParentVASP
返回父 VASP 的子账户数(若传入子 VASP 地址,则返回其父 VASP 的子账户数)。该 VASP 的总账户数为 num_children() + 1。实现先通过 parent_address(addr) 归一到父账户,再读取 ParentVASP.num_children;若地址不是任何 VASP,则以 ENOT_A_VASP 中止。
has_account_limits
public fun has_account_limits<CoinType>(addr: address): bool acquires ChildVASP
若 addr 是父或子 VASP,且其父 VASP 账户持有 AccountLimits<CoinType> 资源,则返回 true,否则 false;addr 非 VASP 时中止。实现为 AccountLimits::has_window_published<CoinType>(parent_address(addr)),其底层(AccountLimits.move)即 exists<Window<CoinType>>(addr)——检查父账户是否已发布该币种的限额时间窗口。注意限额检查永远落在父账户而非子账户上,这正是限额机制按"整个 VASP"而非"单个账户"实施的关键。
跨模块联动:VASP 判定如何支撑合规逻辑
VASP 模块虽小,却是多条合规主链的基石。最有代表性的联动在 DualAttestation.move:
- 凭证存储定位:
credential_address(addr)用if (VASP::is_child(addr)) VASP::parent_address(addr) else addr把子 VASP 的双签凭证查找重定向到父账户,实现"凭证以父为单位持有、子账户共享"; - 跨 VASP 判定:
dual_attestation_required<Token>中,当转账金额超过限额且VASP::is_vasp(payer) && VASP::is_vasp(payee) && VASP::parent_address(payer) != VASP::parent_address(payee)时,判定为跨实体转账、需要双签证明。parent_address的归一化让"同一父 VASP 的两个子账户之间转账"被正确识别为非跨实体转账,免于双签。
由此可见,VASP 模块的类型谓词与 parent_address 归一化逻辑,是账户限额(AccountLimits)与双签证明(DualAttestation)两大合规机制正确区分"实体内部操作"与"实体间操作"的共同前提。
模块级形式化规格:四组不可违反的不变量
VASP 模块随实现附带了完整的 Move Prover 形式化规格(spec module),将层级结构的核心约束固化为可机器验证的不变量:
持久性(Persistence of parent and child VASPs)
invariant update forall addr: address where old(is_parent(addr)): is_parent(addr);
invariant update forall addr: address where old(is_child(addr)): is_child(addr);
父/子 VASP 身份一旦建立便永久存在,任何函数都不能删除或覆盖这两个资源。
父账户必然存在(Existence of Parents)
invariant forall child_addr: address where is_child(child_addr):
is_parent(global<ChildVASP>(child_addr).parent_vasp_addr);
每个 ChildVASP.parent_vasp_addr 指向的地址必须真实持有 ParentVASP 资源,杜绝"孤儿子账户"。
子 VASP 的唯一创建途径(Creation of Child VASPs)
apply ChildVASPsDontChange to *<T>, * except publish_child_vasp_credential;
apply NumChildrenRemainsSame to * except publish_child_vasp_credential;
除 publish_child_vasp_credential 外,任何函数都不得新增/移除 ChildVASP 资源(ChildVASPsDontChange),也不得改变任何父 VASP 的 num_children 计数(NumChildrenRemainsSame)。也就是说,子账户的增减只能经由该凭证发布函数一个入口。
父地址不可变(Immutability of Parent Address)
invariant update
forall a: address where old(is_child(a)): spec_parent_address(a) == old(spec_parent_address(a));
子 VASP 中记录的父地址一经写入永不改变,保证层级归属的终身稳定——这也是限额与双签策略可以安全地缓存/复用父账户状态的前提。
这四组规格与各函数的 spec 块(如 PublishParentVASPEnsures 保证发布后 is_parent 成立且 spec_num_children == 0;PublishChildVASPEnsures 保证子账户计数 +1、子地址 is_child 且父地址正确)共同构成了 VASP 层级的可证明安全边界。
小结
0x1::VASP 模块以两个资源、一个上限常量、两个受控发布函数和一组只读查询 API,定义了 Diem 链上"父-子"两层 VASP 账户模型:凭证发布被限定为 DiemAccount 的 friend,保障创建流程的原子性与权限受控;parent_address 归一化与 is_vasp/is_same_vasp 谓词为 AccountLimits 与 DualAttestation 提供了"按实体而非按账户"执行合规策略的统一视角;Move Prover 规格则将持久性、父存在性、唯一创建途径与父地址不可变四条不变量固化为形式化保证。对于希望深入理解 Diem 账户体系或在其上构建合规应用的开发者,本模块是理解链上实体模型的最佳切入点,相关源码与测试可分别在 VASP.move、DiemAccount.move 与 smoke-test 中继续研读。