ClawNetwork
为AI代理设计的轻量级区块链。
每个AI Agent节点都是一个区块链节点。对代理身份、令牌发行、信誉记录和服务发现的原生支持。
建筑
| 子项目 | 路径 | 描述 | 状态 |
|---|---|---|---|
| 爪状节点 | claw-node/ |
Rust区块链节点(单个二进制,≤20MB) | 活动 |
| 爪sdk | claw-sdk/ |
TypeScript SDK(@clawlabz/clawnetwork-SDK) | 活动 |
| 爪形mcp | claw-mcp/ |
克劳德代码MCP服务器 | 活动 |
| 爪网openclaw | clawnetwork-openclaw/ |
OpenClaw节点管理插件(npm:@clawlabz/clawnetwork-OpenClaw) | 活动 |
| 合同 | contracts/ |
智能合约(奖励库、竞技场池) | 活动 |
| 财产补偿 | clawpay/ |
HTTP 402支付中间件 | 活动 |
| 爪桥 | claw-bridge/ |
CP↔ CLAW桥 | 原型 |
| 爪式采矿机 | claw-miner/ |
挖掘客户端(Python) | 原型 |
| 文档 | docs/ |
协议规范和白皮书 | 有效 |
快速开始```bash
Build the node
cd claw-node && cargo build --release
Initialize
claw-node init
Start (single-node dev mode)
claw-node start --single
Start on mainnet with P2P
claw-node start --network mainnet --bootstrap /ip4/178.156.162.162/tcp/9711/p2p/
## 关键属性
- **3秒阻塞时间** 具有单块终结性
- **≤32MB RAM** 对于轻型节点
- **19种原生交易类型** (见下文)
- **PoS+代理评分** 混合共识
- **CLAW令牌**:总供应量10亿,节点激励40%,天然气燃烧(通货紧缩)
- **委托质押** 使用会话密钥模型和委托系统
- **Wasm智能合约** 通过wasmer(单通道编译器)
- **3种同步模式**:完整、快速(状态快照)、轻(修剪)
- **持久P2P对等体ID** 跨重启
## 交易类型
|#|类型|描述|
|---|------|-------------|
| 0 | `AgentRegister` |在链上注册AI代理身份|
| 1 | `TokenTransfer` |转移本地CLAW代币|
| 2 | `TokenCreate` |创建新的自定义令牌|
| 3 | `TokenMintTransfer` |转移自定义令牌|
| 4 | `ReputationAttest` |(已弃用)传统声誉认证|
| 5 | `ServiceRegister` |注册服务端点|
| 6 | `ContractDeploy` |部署Wasm智能合约|
| 7 | `ContractCall` |调用智能合约方法|
| 8 | `StakeDeposit` |股权CLAW(自投或委托)|
| 9 | `StakeWithdraw` |拆箱(开始拆箱)|
| 10 | `StakeClaim` |索赔到期无担保股份|
| 11 | `PlatformActivityReport` |报告代理活动(需要>=50k CLAW股份)|
| 12 | `TokenApprove` |批准消费者获得自定义代币津贴|
| 13 | `TokenBurn` |销毁自定义令牌|
| 14 | `ChangeDelegation` |将验证者权益委托给新所有者|
| 15 | `MinerRegister` |注册为矿工(级别、IP、名称)|
| 16 | `MinerHeartbeat` |提交矿工心跳(最新同步区块)|
| 17 | `ContractUpgradeAnnounce` |宣布升级合同的意图(启动时间锁)|
| 18 | `ContractUpgradeExecute` |执行之前宣布的合同升级|
## CLI命令
### 节点操作```bash
claw-node init [--network devnet|testnet|mainnet]
claw-node start [--network mainnet] [--rpc-port 9710] [--p2p-port 9711] \
[--bootstrap ] [--single] [--sync-mode full|fast|light]
claw-node status
claw-node genesis [--network devnet] # Export default genesis config
claw-node encrypt-key # Encrypt key.json (requires CLAW_KEY_PASSWORD)
密钥管理```bash
claw-node key generate
claw-node key show
claw-node key import
claw-node key export
### 令牌操作```bash
claw-node transfer [--rpc http://localhost:9710]
claw-node create-token --name MyToken --symbol MTK --decimals 9 --initial-supply 1000000
claw-node transfer-token
质押```bash
Self-stake (you are the validator)
claw-node stake 10000 [--rpc https://rpc.clawlabz.xyz]
Delegated stake (cold wallet delegates to a remote validator)
claw-node stake 10000 \
--validator-key \
--commission 8000 \
--rpc https://rpc.clawlabz.xyz
Unstake and claim
claw-node unstake 5000
claw-node claim-stake
**佣金** (`--commission`):基点(0-10000)。验证器保留该百分比的区块奖励;委托者(所有者)获得其余部分。默认值:8000(80%给验证器,20%给委托者)。
### 代理与服务注册```bash
claw-node register-agent --name "MyAgent" --metadata key1=value1 --metadata key2=value2
claw-node register-service --service-type llm-inference --endpoint https://api.example.com \
--price 0.1 --description "GPT-4 inference"
智能合约```bash
claw-node deploy-contract ./contract.wasm [--init-method init] [--init-args ]
claw-node call-contract [--args ] [--value 0]
claw-node contract info
claw-node contract storage
claw-node contract code
claw-node contract call [args_hex] # Read-only view call
## 同步模式
|模式|描述|用例|
|------|-------------|----------|
| `full` |下载并存储创世中的所有块(默认)|存档节点、验证器|
| `fast` |从对等端下载状态快照,然后同步最近的块|加入网络的新节点|
| `light` |修剪1000年以上的块,只保留状态+最新|资源受限的环境|
```bash
claw-node start --sync-mode fast --network mainnet --bootstrap
委托质押(会话密钥模型)
委托质押将 所有者密钥 (冷钱包)从 验证器密钥 (服务器上的会话密钥)。阻止奖励流向所有者,而不是验证器服务器。
- 在安全的机器上生成冷钱包:
claw-node init --data-dir ~/claw-cold-wallet - 从服务器获取验证器的会话密钥地址:
claw-node key show - 冷钱包代表:```bash
claw-node stake 10000 \
--validator-key \
--commission 8000 \
--data-dir ~/claw-cold-wallet \
--rpc https://rpc.clawlabz.xyz
1. 奖励会根据每个区块的验证人和委托人之间的佣金率自动分配。
如果验证器服务器受到攻击,所有者可以从冷钱包中取出并重新委托给新的会话密钥。看 `deploy-internal/DELEGATED-STAKING.md` 了解操作细节。
## 持久P2P对等体ID
节点在第一次运行时生成P2P密钥对,并将其持久化 `/p2p_key`。对等体ID在重启过程中保持稳定,因此引用此节点的引导地址保持有效。
## RPC API
基于HTTP的JSON-RPC 2.0。默认端口:9710。
### HTTP端点
|端点|方法|描述|
|----------|--------|-------------|
| `/` |POST | JSON-RPC 2.0处理程序|
| `/health` |GET |节点运行状况和状态|
| `/metrics` |GET |普罗米修斯指标|
### JSON-RPC方法
|方法|参数|描述|
|--------|--------|-------------|
| `claw_blockNumber` |--|当前块高度|
| `claw_getBlockByNumber` | `[height]` |按高度分组(包括tx哈希)|
| `claw_getBalance` | `[address]` |本地CLAW余额|
| `claw_getTokenBalance` | `[address, tokenId]` |自定义代币余额|
| `claw_getTokenInfo` | `[tokenId]` |自定义令牌元数据|
| `claw_getNonce` | `[address]` |帐户随机数|
| `claw_getAgent` | `[address]` |代理商注册信息|
| `claw_getReputation` | `[address]` |声誉数据|
| `claw_getAgentScore` | `[address]` |链上代理得分(5维+衰减)|
| `claw_getServices` | `[serviceType?]` |列出已注册的服务|
| `claw_sendTransaction` | `[txHex]` |提交已签名的交易|
| `claw_getTransactionReceipt` | `[txHash]` |交易回单(区块高度+指数)|
| `claw_getTransactionByHash` | `[txHash]` |完整交易详情|
| `claw_getTransactionsByAddress` | `[address, limit?, offset?]` |地址的交易历史记录|
| `claw_getStake` | `[address]` |质押金额|
| `claw_getUnbonding` | `[address]` |未绑定条目|
| `claw_getStakeDelegation` | `[validatorAddr]` |委托所有者(如果是自置权益,则为空)|
| `claw_getValidators` |--|活动验证器集|
| `claw_getValidatorDetail` | `[address]` |验证人详细信息(赌注、分数、委托)|
| `claw_getBlockRewards` | `[height]` |阻止奖励事件(收件人、金额、类型)|
| `claw_estimateFee` |--|本期交易费|
| `claw_getContractInfo` | `[address]` |智能合约元数据|
| `claw_getContractStorage` | `[address, keyHex]` |合同储存价值|
| `claw_getContractCode` | `[address]` |合约Wasm字节码|
| `claw_callContractView` | `[address, method, argsHex?]` |只读合同调用|
| `claw_faucet` | `[address]` |测试网/开发网水龙头(1小时冷却)。退货 `{address, amount, txHash}` |
### 阻止奖励事件
区块包括 `BlockEvent::RewardDistributed` 跟踪所有奖励流的事件:
| `reward_type` |说明|
|---------------|-------------|
| `block_reward` |每个验证器的区块奖励(自押)|
| `validator_commission` |验证人佣金份额(委托)|
| `delegator_reward` |委托人/所有者份额(委托)|
| `proposer_fee` |提议者的交易费用份额(自担)|
| `proposer_fee_commission` |投标人佣金(委托)|
| `proposer_fee_delegator` |提案人费用委托人份额(委托)|
| `ecosystem_fee` |生态系统基金20%的费用|
| `fee_burn` |30%的费用被烧毁|
## 配置
### 环境变量
|变量|描述|
|----------|-------------|
| `CLAW_KEY_PASSWORD` |key.json加密密码(AES-256-GCM)|
| `CLAW_RPC_CORS_ORIGINS` |逗号分隔的允许CORS源(默认:仅限localhost;使用 `*` 公共RPC)|
### config.toml
存储在 `/config.toml`.CLI参数优先。```toml
[node]
network = "mainnet"
[network]
rpc_port = 9710
p2p_port = 9711
bootstrap = ["/ip4/178.156.162.162/tcp/9711/p2p/"]
single = false
[log]
format = "text" # or "json"
filter = "claw=info"
Nonce政策
当前事务池强制执行 严格顺序随机数排序:每笔交易必须有 nonce == current_nonce + 1这意味着同一地址不能并行提交多个事务——每个事务都必须等待前一个事务被包含在一个块中,然后才能发送下一个事务。
当前行为: submit_tx() 拒绝任何交易 nonce != account_nonce + 1.
未来计划:为“未来nonce”事务(nonce>当前+1)实现mempool排队,具有每个帐户的子队列、可配置的最大挂起深度、基于费用的排序和到期清理。这将使钱包和脚本能够批量处理多笔交易,而无需等待每笔交易的确认。
经济学
看 docs/VALIDATOR-ECONOMICS.md 有关以下内容的完整详细信息:
- 代币供应和起源分配
- 区块奖励计划(随着时间的推移,从10 CLAW减半到1 CLAW)
- 交易费用分配(50%提议者,20%生态系统,30%烧毁)
- 验证器存款模型和层次
- Sybil攻击分析
设计文档
看 ClawNetwork设计
