AI导哈

AI代理区块链

ClawNetwork是一个专为AI代理设计的轻量级区块链，支持代理身份、代币发行、信誉记录和服务发现等功能。

  • by clawlabz
  • Rust
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 clawlabz/claw-network

使用说明

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/ 协议规范和白皮书 有效

快速开始

# 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/<PEER_ID>

关键属性

  • 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命令

节点操作

claw-node init [--network devnet|testnet|mainnet]
claw-node start [--network mainnet] [--rpc-port 9710] [--p2p-port 9711] \
    [--bootstrap <multiaddr>] [--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)

密钥管理

claw-node key generate
claw-node key show
claw-node key import <private_key_hex>
claw-node key export

令牌操作

claw-node transfer <to_address> <amount> [--rpc http://localhost:9710]
claw-node create-token --name MyToken --symbol MTK --decimals 9 --initial-supply 1000000
claw-node transfer-token <token_id> <to_address> <amount>

质押

# 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 <validator_hex_address> \
    --commission 8000 \
    --rpc https://rpc.clawlabz.xyz

# Unstake and claim
claw-node unstake 5000
claw-node claim-stake

佣金 (--commission)：基点（0-10000）。验证器保留该百分比的区块奖励；委托者（所有者）获得其余部分。默认值：8000（80%给验证器，20%给委托者）。

代理与服务注册

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"

智能合约

claw-node deploy-contract ./contract.wasm [--init-method init] [--init-args <hex>]
claw-node call-contract <address> <method> [--args <hex>] [--value 0]
claw-node contract info <address>
claw-node contract storage <address> <key_hex>
claw-node contract code <address>
claw-node contract call <address> <method> [args_hex]    # Read-only view call

同步模式

模式 描述 用例
full 下载并存储创世中的所有块（默认） 存档节点、验证器
fast 从对等端下载状态快照，然后同步最近的块 加入网络的新节点
light 修剪1000年以上的块，只保留状态+最新 资源受限的环境 
claw-node start --sync-mode fast --network mainnet --bootstrap <multiaddr>

委托质押（会话密钥模型）

委托质押将 所有者密钥 （冷钱包）从 验证器密钥 （服务器上的会话密钥）。阻止奖励流向所有者，而不是验证器服务器。

  1. 在安全的机器上生成冷钱包： claw-node init --data-dir ~/claw-cold-wallet
  2. 从服务器获取验证器的会话密钥地址： claw-node key show
  3. 冷钱包代表：
    claw-node stake 10000 \
    --validator-key <session_key_address> \
    --commission 8000 \
    --data-dir ~/claw-cold-wallet \
    --rpc https://rpc.clawlabz.xyz
  4. 奖励会根据每个区块的验证人和委托人之间的佣金率自动分配。

如果验证器服务器受到攻击，所有者可以从冷钱包中取出并重新委托给新的会话密钥。看 deploy-internal/DELEGATED-STAKING.md 了解操作细节。

持久P2P对等体ID

节点在第一次运行时生成P2P密钥对，并将其持久化 <data_dir>/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

存储在 <data_dir>/config.toml.CLI参数优先。

[node]
network = "mainnet"

[network]
rpc_port = 9710
p2p_port = 9711
bootstrap = ["/ip4/178.156.162.162/tcp/9711/p2p/<PEER_ID>"]
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设计

相关 MCP