Agent Reputation

中文 | English

---

中文说明

📋 Skill 简介

Agent Reputation 是一个区块链智能体信用评分系统，为自主 AI Agent 提供链上信用评分和灵魂绑定身份（Soulbound Token）。

Tagline: 链上信用评分与灵魂绑定身份，为自主智能体构建信任基础

🎯 核心功能

1. 1. 创建 Agent 身份 (create_agent_identity)

- 为 AI Agent 铸造灵魂绑定代币（SBT） - 不可转让的永久链上身份 - 绑定到控制者钱包地址

1. 2. 查询 Agent 身份 (query_identity)

- 通过地址或 Token ID 查询身份信息 - 获取 Agent 名称、类型、创建时间等 - 查看身份激活状态

1. 3. 获取信用评分 (get_credit_score)

- 查询 Agent 信用分（300-850 分，类似 FICO） - 查看详细评分维度指标 - 获取历史评分趋势

1. 4. 记录证明 (record_attestation)

- 为 Agent 记录正面或负面证明 - 社区驱动的信任验证 - 直接影响信用评分

1. 5. 对比 Agents (compare_agents)

- 同时对比多个 Agent 的信用分 - 查看相对排名 - 辅助选择决策

1. 6. 生成报告 (generate_report)

- 生成完整的信用评估报告 - 支持文本、JSON、Markdown 格式 - 包含所有评分维度详情

📊 信用评分算法

评分范围: 300-850 分（借鉴 FICO 信用评分体系）

评分维度（5 个加权指标）：

维度	权重	说明
任务成功率	30%	完成任务数 / 总任务数
运行时长

20% | Agent 累计在线时间 |
| 安全性 | 20% | 安全事件数量（越少越好）|
| 社区证明 | 15% | 正面证明数 - 负面举报数 |
| 经济活动 | 15% | 交易量 + 质押金额 |

评级标准：

• - 800-850: 优秀（Excellent）
• 740-799: 很好（Very Good）
• 670-739: 良好（Good）
• 580-669: 一般（Fair）
• 300-579: 较差（Poor）

🔧 使用场景

1. AI Agent 市场

CODEBLOCK0

2. 自主交易机器人

CODEBLOCK1

3. Agent 协作网络

CODEBLOCK2

4. 风险评估

CODEBLOCK3

💡 使用示例

示例 1：创建 Agent 身份

用户输入：
CODEBLOCK4

Agent 响应：
CODEBLOCK5

示例 2：查询信用评分

用户输入：
CODEBLOCK6

Agent 响应：
CODEBLOCK7

示例 3：对比多个 Agents

用户输入：
CODEBLOCK8

Agent 响应：
CODEBLOCK9

🌐 技术规格

区块链网络: Base（Coinbase L2）

• - 主网: Base Mainnet (Chain ID: 8453)
• 测试网: Base Sepolia (Chain ID: 84532)

智能合约:

• - AgentSBT: 灵魂绑定代币（不可转让的 ERC-721）
• ReputationScore: 信用评分引擎
• BehaviorRegistry: 行为记录存储

数据存储:

• - 链上: 身份信息、评分数据、行为记录
• 不可篡改: 所有数据永久保存
• 透明可验证: 任何人都可查询验证

🔐 安全说明

1. 1. 灵魂绑定: SBT 不可转让、不可售卖
2. 权限控制: 只有控制者可以管理 Agent 身份
3. 数据永久: 链上数据不可删除或修改
4. 隐私保护: 未来支持零知识证明

📦 工具参数说明

1. createagentidentity

创建 Agent 身份（铸造 SBT）

参数：

• - agent_address (必填): Agent 的以太坊地址
• INLINECODE7 (必填): Agent 的名称
• INLINECODE8 (必填): Agent 类型（如 gpt-4, claude-3 等）
• INLINECODE9 (可选): 网络选择，默认 baseSepolia

返回：Token ID 和交易哈希

2. query_identity

查询 Agent 身份信息

参数：

• - identifier (必填): Agent 地址（0x...）或 Token ID
• INLINECODE11 (可选): 网络选择，默认 baseSepolia

返回：完整身份信息

3. getcreditscore

获取信用评分和详细指标

参数：

• - token_id (必填): Agent 的 Token ID
• INLINECODE13 (可选): 网络选择，默认 baseSepolia

返回：信用分和所有评分维度数据

4. record_attestation

记录证明（正面/负面）

参数：

• - token_id (必填): Agent 的 Token ID
• INLINECODE15 (可选): true 为正面，false 为负面，默认 true
• INLINECODE16 (可选): 网络选择，默认 baseSepolia

返回：交易哈希

5. compare_agents

对比多个 Agents 的信用分

参数：

• - token_ids (必填): Agent Token ID 数组
• INLINECODE18 (可选): 网络选择，默认 baseSepolia

返回：对比结果表格

6. generate_report

生成详细信用报告

参数：

• - token_id (必填): Agent 的 Token ID
• INLINECODE20 (可选): 格式 text/json/markdown，默认 text
• INLINECODE21 (可选): 网络选择，默认 baseSepolia

返回：格式化的报告内容

⚙️ 环境要求

必需的环境变量:

• - PRIVATE_KEY (必填): 以太坊钱包私钥（用于签署区块链交易）

- ⚠️ 警告：请妥善保管私钥，切勿泄露
- 建议使用测试网钱包私钥，不要使用主网真实资产钱包

网络访问:

• - ✅ 连接到 Base 区块链网络（Mainnet 或 Sepolia Testnet）
• ✅ 所有交易上链，数据公开透明
• ✅ 不连接其他外部服务器

前置条件:

• - Node.js >= 18.0.0
• 以太坊钱包地址和私钥
• 测试币（Base Sepolia）或主网 ETH

🚀 快速开始

1. 1. 安装 Skill

CODEBLOCK10

1. 2. 配置环境变量

CODEBLOCK11

1. 3. 准备测试 ETH

- 访问 Base Sepolia 水龙头获取测试币 - 或使用主网 ETH（需要真实资产）

1. 4. 开始使用

- 自然语言与 Agent 对话 - Agent 会自动调用相关工具函数 - 查看链上执行结果

📚 相关资源

• - npm 包: INLINECODE23
• GitHub: https://github.com/ZhenRobotics/openclaw-agent-reputation
• 文档: 完整的 API 文档和架构说明
• 智能合约: 已开源在 GitHub

💰 成本说明

• - Gas 费用: 根据 Base 网络实时 Gas 价格
• 创建身份: 约 0.0001-0.0005 ETH
• 查询数据: 免费（只读操作）
• 记录证明: 约 0.00005-0.0002 ETH

🤝 支持

• - GitHub Issues: 报告问题或建议
• 文档: 查看详细使用指南
• 社区: 加入 Discord 讨论

---

English

📋 Skill Overview

Agent Reputation is a blockchain-based credit scoring system providing on-chain credit scores and soulbound identity (Soulbound Token) for autonomous AI Agents.

Tagline: On-chain credit scoring and soulbound identity for autonomous agents

🎯 Core Functions

1. 1. Create Agent Identity (create_agent_identity)

- Mint Soulbound Token (SBT) for AI Agents - Non-transferable permanent on-chain identity - Bound to controller wallet address

1. 2. Query Agent Identity (query_identity)

- Query identity by address or Token ID - Get Agent name, type, creation time, etc. - Check identity activation status

1. 3. Get Credit Score (get_credit_score)

- Query Agent credit score (300-850, similar to FICO) - View detailed scoring dimensions - Get historical scoring trends

1. 4. Record Attestation (record_attestation)

- Record positive or negative attestations for Agents - Community-driven trust verification - Directly impacts credit score

1. 5. Compare Agents (compare_agents)

- Compare multiple Agents' credit scores simultaneously - View relative rankings - Assist in selection decisions

1. 6. Generate Report (generate_report)

- Generate complete credit assessment report - Support text, JSON, Markdown formats - Include all scoring dimension details

📊 Credit Scoring Algorithm

Score Range: 300-850 (inspired by FICO credit scoring system)

Scoring Dimensions (5 weighted metrics):

Dimension	Weight	Description
Task Success Rate	30%	Completed tasks / Total tasks
Uptime

20% | Agent cumulative online time |
| Security | 20% | Number of security incidents (fewer is better) |
| Community Attestations | 15% | Positive attestations - Negative reports |
| Economic Activity | 15% | Transaction volume + Staking amount |

Rating Standards:

• - 800-850: Excellent
• 740-799: Very Good
• 670-739: Good
• 580-669: Fair
• 300-579: Poor

🔧 Use Cases

1. AI Agent Marketplace

CODEBLOCK12

2. Autonomous Trading Bots

CODEBLOCK13

3. Agent Collaboration Network

CODEBLOCK14

4. Risk Assessment

CODEBLOCK15

💡 Usage Examples

Example 1: Create Agent Identity

User Input:
CODEBLOCK16

Agent Response:
CODEBLOCK17

Example 2: Query Credit Score

User Input:
CODEBLOCK18

Agent Response:
CODEBLOCK19

Example 3: Compare Multiple Agents

User Input:
CODEBLOCK20

Agent Response:
CODEBLOCK21

🌐 Technical Specifications

Blockchain Network: Base (Coinbase L2)

• - Mainnet: Base Mainnet (Chain ID: 8453)
• Testnet: Base Sepolia (Chain ID: 84532)

Smart Contracts:

• - AgentSBT: Soulbound Token (non-transferable ERC-721)
• ReputationScore: Credit scoring engine
• BehaviorRegistry: Behavior record storage

Data Storage:

• - On-chain: Identity info, scoring data, behavior records
• Immutable: All data permanently saved
• Transparent & Verifiable: Anyone can query and verify

🔐 Security Notes

1. 1. Soulbound: SBT is non-transferable, non-sellable
2. Access Control: Only controller can manage Agent identity
3. Data Permanence: On-chain data cannot be deleted or modified
4. Privacy Protection: Future support for zero-knowledge proofs

📦 Tool Parameters

1. createagentidentity

Create Agent identity (mint SBT)

Parameters:

• - agent_address (required): Agent's Ethereum address
• INLINECODE31 (required): Agent's name
• INLINECODE32 (required): Agent type (e.g., gpt-4, claude-3)
• INLINECODE33 (optional): Network choice, default baseSepolia

Returns: Token ID and transaction hash

2. query_identity

Query Agent identity information

Parameters:

• - identifier (required): Agent address (0x...) or Token ID
• INLINECODE35 (optional): Network choice, default baseSepolia

Returns: Complete identity information

3. getcreditscore

Get credit score and detailed metrics

Parameters:

• - token_id (required): Agent's Token ID
• INLINECODE37 (optional): Network choice, default baseSepolia

Returns: Credit score and all scoring dimension data

4. record_attestation

Record attestation (positive/negative)

Parameters:

• - token_id (required): Agent's Token ID
• INLINECODE39 (optional): true for positive, false for negative, default true
• INLINECODE40 (optional): Network choice, default baseSepolia

Returns: Transaction hash

5. compare_agents

Compare credit scores of multiple Agents

Parameters:

• - token_ids (required): Array of Agent Token IDs
• INLINECODE42 (optional): Network choice, default baseSepolia

Returns: Comparison result table

6. generate_report

Generate detailed credit report

Parameters:

• - token_id (required): Agent's Token ID
• INLINECODE44 (optional): Format text/json/markdown, default text
• INLINECODE45 (optional): Network choice, default baseSepolia

Returns: Formatted report content

⚙️ Environment Requirements

Required Environment Variables:

• - PRIVATE_KEY (required): Ethereum wallet private key (for signing blockchain transactions)

- ⚠️ Warning: Keep your private key secure, never expose it
- Recommend using testnet wallet private key, not mainnet wallets with real assets

Network Access:

• - ✅ Connects to Base blockchain network (Mainnet or Sepolia Testnet)
• ✅ All transactions on-chain, data publicly transparent
• ✅ No other external servers

Prerequisites:

• - Node.js >= 18.0.0
• Ethereum wallet address and private key
• Test tokens (Base Sepolia) or mainnet ETH

🚀 Quick Start

1. 1. Install Skill

CODEBLOCK22

1. 2. Configure Environment

CODEBLOCK23

1. 3. Get Test ETH

- Visit Base Sepolia faucet for test tokens - Or use mainnet ETH (requires real assets)

1. 4. Start Using

- Chat with Agent in natural language - Agent automatically calls relevant tool functions - View on-chain execution results

📚 Resources

• - npm Package: INLINECODE47
• GitHub: https://github.com/ZhenRobotics/openclaw-agent-reputation
• Documentation: Complete API docs and architecture guide
• Smart Contracts: Open-sourced on GitHub

💰 Cost Information

• - Gas Fees: Based on Base network real-time gas prices
• Create Identity: ~0.0001-0.0005 ETH
• Query Data: Free (read-only operations)
• Record Attestation: ~0.00005-0.0002 ETH

🤝 Support

• - GitHub Issues: Report issues or suggestions
• Documentation: View detailed usage guides
• Community: Join Discord for discussions

---

Version: 0.1.0 Last Updated: 2026-03-12