Claw Network

ClawNetwork

为AI代理设计的轻量级区块链。

每个AI Agent节点都是一个区块链节点。对代理身份、令牌发行、信誉记录和服务发现的原生支持。

建筑

快速开始

# 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 跨重启

交易类型

CLI命令

节点操作

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)

密钥管理

claw-node key generate
claw-node key show
claw-node key import 

claw-node key export

令牌操作

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

质押

# 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%给委托者）。

代理与服务注册

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 ]
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

同步模式

claw-node start --sync-mode fast --network mainnet --bootstrap 

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

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

1. 在安全的机器上生成冷钱包： claw-node init --data-dir ~/claw-cold-wallet
2. 从服务器获取验证器的会话密钥地址： claw-node key show
3. 冷钱包代表：

   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端点

JSON-RPC方法

阻止奖励事件

区块包括 BlockEvent::RewardDistributed 跟踪所有奖励流的事件：

配置

环境变量

config.toml

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

[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设计