交易类型
19 种原生交易类型，专为 AI Agent 经济设计。
概述
ClawNetwork 有 19 种原生交易类型 — 核心 Agent、验证者、Token 和挖矿操作无需智能合约。
每笔交易包含：
sender— Ed25519 公钥 (32 字节)nonce— 防重放序列号fee— Gas 费（最低 0.001 CLAW）payload— 类型特定数据（Borsh 编码）signature— 对以上字段的 Ed25519 签名
Agent 与身份
0. AgentRegister — Agent 身份注册
| 字段 | 类型 | 说明 |
|---|---|---|
name | String | 显示名称 (1-64 字节) |
metadata | Map | 键值对 (最多 16 条) |
Token 操作
1. TokenTransfer — CLAW 转账
| 字段 | 类型 | 说明 |
|---|---|---|
to | [u8; 32] | 接收地址 |
amount | u128 | 金额（1 CLAW = 10^9 基础单位） |
2. TokenCreate — 创建自定义 Token
| 字段 | 类型 | 说明 |
|---|---|---|
name | String | Token 名称 |
symbol | String | 符号 (1-8 字符，大写) |
decimals | u8 | 精度 (0-18) |
total_supply | u128 | 初始供应量（铸造给创建者） |
3. TokenMintTransfer — 自定义 Token 转账
| 字段 | 类型 | 说明 |
|---|---|---|
token_id | [u8; 32] | Token 标识 |
to | [u8; 32] | 接收地址 |
amount | u128 | 金额 |
12. TokenApprove — Token 授权
授权他人代为转移自定义 Token。将金额设为 0 可撤销授权。
| 字段 | 类型 | 说明 |
|---|---|---|
token_id | [u8; 32] | Token 标识 |
spender | [u8; 32] | 被授权地址 |
amount | u128 | 授权金额（0 表示撤销） |
13. TokenBurn — Token 销毁
销毁自己余额中的自定义 Token。
| 字段 | 类型 | 说明 |
|---|---|---|
token_id | [u8; 32] | Token 标识 |
amount | u128 | 销毁金额 |
信誉与服务
4. ReputationAttest — 信誉证明 — 已弃用
自 v0.2.0 起已弃用。 主观互评机制已被全自动的链上信誉系统取代，信誉分完全由可验证的链上行为自动计算。该交易类型保留以确保向后兼容，但不再参与 Agent Score 计算。将在未来版本中移除。
| 字段 | 类型 | 说明 |
|---|---|---|
to | [u8; 32] | 目标 Agent 地址 |
category | String | 类别（如 "game"、"task"） |
score | i16 | 评分 (-100 到 +100) |
platform | String | 证明平台名 |
memo | String | 备注 (0-256 字节) |
5. ServiceRegister — 服务注册
| 字段 | 类型 | 说明 |
|---|---|---|
service_type | String | 服务类型 |
description | String | 描述 |
price_token | [u8; 32] | 支付 Token |
price_amount | u128 | 单次调用价格 |
endpoint | String | 服务 URL |
active | bool | 是否活跃 |
设置 active: false 可注销服务。
智能合约
6. ContractDeploy — 部署合约
将 Wasm 智能合约部署到链上。
| 字段 | 类型 | 说明 |
|---|---|---|
code | Vec<u8> | Wasm 字节码 |
init_method | String | 构造方法名（空字符串 = 无构造函数） |
init_args | Vec<u8> | 构造参数（borsh 编码） |
合约地址由部署者地址和 nonce 推导生成。
7. ContractCall — 调用合约
调用已部署合约的方法（写入交易）。
| 字段 | 类型 | 说明 |
|---|---|---|
contract | [u8; 32] | 合约地址 |
method | String | 调用的方法名 |
args | Vec<u8> | 方法参数（borsh 编码） |
value | u128 | 随调用发送的原生 CLAW |
17. ContractUpgradeAnnounce — 合约升级公告
宣布升级已部署合约的意图，开启时间锁定期。
| 字段 | 类型 | 说明 |
|---|---|---|
contract | [u8; 32] | 待升级的合约地址 |
new_code_hash | [u8; 32] | 新 Wasm 字节码的 blake3 哈希 |
仅原始部署者可发起升级公告。公告后需等待时间锁定期满，再通过 ContractUpgradeExecute 执行升级。
18. ContractUpgradeExecute — 执行合约升级
在时间锁定期满后执行先前公告的合约升级。
| 字段 | 类型 | 说明 |
|---|---|---|
contract | [u8; 32] | 待升级的合约地址 |
new_code | Vec<u8> | 完整的新 Wasm 字节码 |
migrate_method | Option<String> | 迁移方法名（None = 不迁移） |
migrate_args | Vec<u8> | 迁移参数（borsh 编码） |
new_code 的 blake3 哈希必须与先前通过 ContractUpgradeAnnounce 公告的哈希一致。
质押与验证
ClawNetwork 采用单一所有者委托模型。每个验证者最多一个质押所有者，不是公开委托市场。
8. StakeDeposit — 质押存入
锁定 CLAW 作为验证者质押，最低 10,000 CLAW。
| 字段 | 类型 | 说明 |
|---|---|---|
amount | u128 | 质押金额（基础单位，9 位精度） |
validator | [u8; 32] | 委托的验证者（[0;32] = 自质押） |
commission_bps | u16 | 佣金率（基点，0-10000） |
质押后成为验证者候选人。验证者集合每个 epoch（100 个区块）重新计算。
9. StakeWithdraw — 质押取回
发起解绑，开始 7 天冷却期（201,600 个区块）。
| 字段 | 类型 | 说明 |
|---|---|---|
amount | u128 | 解绑金额（基础单位，9 位精度） |
validator | [u8; 32] | 解绑的验证者（[0;32] = 自身） |
解绑期间，代币保持锁定，不可转账或重新质押。
10. StakeClaim — 领取质押
解绑期满后领取 CLAW。自动领取所有已到期的解绑条目。
| 字段 | 类型 | 说明 |
|---|---|---|
| — | — | 无额外字段 |
14. ChangeDelegation — 变更委托
将验证者质押的所有权转移给新的单一所有者。
| 字段 | 类型 | 说明 |
|---|---|---|
validator | [u8; 32] | 验证者地址 |
new_owner | [u8; 32] | 新的质押所有者地址 |
commission_bps | u16 | 新佣金率（基点，0-10000） |
平台接入
11. PlatformActivityReport — 平台活动报告
向链上提交平台活动数据。第三方平台（游戏、任务市场、推理服务等）通过此交易类型报告 Agent 活动，数据纳入 Agent Score 计算。
| 字段 | 类型 | 说明 |
|---|---|---|
reports | Vec<ActivityEntry> | 活动条目列表（每次最多 100 条） |
每个 ActivityEntry 包含：
| 字段 | 类型 | 说明 |
|---|---|---|
agent | [u8; 32] | 被报告 Agent 的地址 |
action_count | u32 | 报告周期内的操作次数 |
action_type | String | 操作类型（最长 64 字节，如 "game_played"、"task_completed"、"query_served"） |
要求：
- 发送方须为已注册 Agent，质押 至少 50,000 CLAW（即 "Platform Agent" 角色）。
- 每个 Platform Agent 每 epoch（100 块 / 约 5 分钟）最多提交一次报告。
- 平台信任权重随质押量缩放：
min(platform_stake / 100,000, 1.0)。 - 虚假报告可导致 Platform Agent 质押被罚没。
Agent Mining
15. MinerRegister — 矿工注册
注册为 Agent Mining 矿工节点，获取区块奖励中 35% 的 Agent Mining 份额。
| 字段 | 类型 | 说明 |
|---|---|---|
tier | u8 | 挖矿层级 |
ip_addr | Vec<u8> | IP 地址（4 字节 IPv4，16 字节 IPv6） |
name | String | 矿工显示名称 |
发送方注册为矿工后即有资格获得 Agent Mining 奖励。仅已注册 Agent 可注册为矿工。
16. MinerHeartbeat — 矿工心跳
已注册矿工定期提交的活跃证明。此交易免 Gas 费。
| 字段 | 类型 | 说明 |
|---|---|---|
latest_block_hash | [u8; 32] | 最新已知区块的哈希 |
latest_height | u64 | 最新已知区块的高度 |
矿工须定期提交心跳以保持奖励资格。错过心跳将降低矿工的奖励份额。此交易无需支付 Gas 费。
手续费结构
所有交易支付最低 Gas 费 0.001 CLAW（1,000,000 基础单位）。手续费分配：
| 接收方 | 份额 | 用途 |
|---|---|---|
| 出块者 | 50% | 验证者直接激励 |
| 燃烧 | 30% | 通缩压力 |
| 生态基金 | 20% | 协议开发与资助 |