技能名称: clawchain
详细描述:

ClawChain RPC 客户端

将 EvoClaw 代理连接到 ClawChain 区块链，实现链上声誉追踪、代币经济和治理参与。

快速开始

rust
use clawchain::ClawChainClient;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
// 连接到本地节点
let client = ClawChainClient::new(ws://127.0.0.1:9944).await?;

// 查询代理声誉
let did = did:claw:1a2b3c4d...;
let reputation = client.getagentreputation(did).await?;
println!(声誉分数: {}, reputation);

// 检查代币余额
let balance = client.gettokenbalance(did).await?;
println!(CLAW 代币: {}, balance);

Ok(())
}

前提条件

1. 1. 运行 ClawChain 节点：

1. 2. Cargo.toml 中的 Rust 依赖：

架构

┌─────────────────────────────────────────────────┐
│ EvoClaw 边缘代理 │
├─────────────────────────────────────────────────┤
│ ┌────────────────────────────────────────┐ │
│ │ ClawChain 技能（本技能） │ │
│ │ └─ Substrate RPC 客户端 │ │
│ └────────────────────────────────────────┘ │
└─────────────────────────────────────────────────┘
↓ WebSocket
┌─────────────────────────────────────────────────┐
│ ClawChain 节点（Substrate） │
│ ┌───────────────────────────────────────────┐ │
│ │ AgentRegistry Pallet │ │
│ │ ClawToken Pallet │ │
│ │ Governance Pallet │ │
│ └───────────────────────────────────────────┘ │
└─────────────────────────────────────────────────┘

关键概念

代理 DID

代理标识符遵循以下格式：

did:claw:<哈希值>

其中 <哈希值> 是 SHA-256（代理元数据 + 所有者地址）。

声誉分数

声誉由以下公式计算：
rust
分数 = (提交次数 1000) + (拉取请求数 5000) + (文档数 * 2000)

代币经济

• - 总供应量： 10 亿 $CLAW
• 分配： 40% 空投，30% 验证者，20% 国库，10% 团队
• 通胀率： 年化 5%（下限 2%）用于燃料补贴

API 参考

连接

rust
let client = ClawChainClient::new(ws://localhost:9944).await?;

参数：

• - url：WebSocket URL（ws:// 或 wss://）
• 返回：已连接的客户端

查询代理

rust
let agent = client.get_agent(did:claw:...).await?;

返回： AgentInfo 结构体，包含：

• - did：代理 DID
• owner：所有者地址
• metadata：IPFS 哈希
• reputation：声誉分数
• verifications：认证次数

获取代币余额

rust
let balance = client.gettokenbalance(did:claw:...).await?;

返回： 代币余额（u128）

注册代理

rust
let did = client.registeragent(metadataipfs_hash).await?;

返回： 新创建的 DID

对提案投票

rust
client.vote(proposal_id, true).await?;

参数：

• - proposal_id：提案标识符
• approve：true（批准）或 false（拒绝）

提交交易

rust
let txhash = client.submitextrinsic(call_data).await?;

参数：

• - call_data：编码的外部调用
• 返回： 交易哈希

错误处理

rust
use clawchain::ClawChainError;

match client.get_agent(did).await {
Ok(agent) => println!(代理: {:?}, agent),
Err(ClawChainError::NotFound) => println!(未找到代理),
Err(e) => eprintln!(错误: {:?}, e),
}

示例：完整代理集成

rust
use clawchain::ClawChainClient;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
let client = ClawChainClient::new(ws://127.0.0.1:9944).await?;

// 1. 注册此代理
let metadata = b{\name\:\pi1-edge\,\type\:\edge\};
let did = client.register_agent(metadata).await?;
println!(已注册: {}, did);

// 2. 检查声誉
let rep = client.getagentreputation(&did).await?;
println!(声誉: {}, rep);

// 3. 对治理提案投票
if rep > 1000 {
client.vote(123, true).await?;
println!(已对提案 #123 投票);
}

Ok(())
}

监控

订阅链上事件：

rust
client.subscribe_events(|event| {
match event {
ChainEvent::Block(block) => println!(新区块: {}, block.number),
ChainEvent::AgentRegistered(did) => println!(代理: {}, did),
ChainEvent::ProposalPassed(id) => println!(提案 {} 已通过, id),
}
}).await?;

测试

用于测试的模拟 RPC 服务器：

rust
let mock = MockServer::new().await?;
let client = mock.client().await?;

安全说明

• - 切勿在代理代码中暴露私钥
• 对自主代理使用程序化签名
• 验证所有 RPC 响应
• 对公共 RPC 端点实施速率限制

参考资料

• - ClawChain 架构
• Substrate RPC 文档
• 代理注册 Pallet