openclaw-basecred-sdk

🛡️ 多维度链上声誉智能评估

基于 basecred-sdk 聚合 Ethos、Talent Protocol 与 Farcaster 三大平台数据,提供中立无偏见的链上声誉查询与身份验证服务。

收藏
21k
安装
4.4k
版本
0.6.2
CLS 安全性认证2026-05-06
点击查看完整报告 >

使用说明

openclaw-basecred-sdk 是一款专为 Web3 生态设计的链上声誉查询工具,通过集成 Ethos Network、Talent Protocol 和 Farcaster 三大身份平台,为用户提供全面、中立的声誉数据评估服务。该技能基于 @basecred/sdk 构建,采用 CLI 接口设计,能够获取可组合的原始声誉数据,包括社交可信度评分、构建者/创作者分数以及账户质量指标,适用于身份验证、信任评估和自动化声誉管理场景。

核心用法方面,用户可通过简单的命令行指令查询任意以太坊地址的声誉数据。基础命令 ./scripts/check-reputation.mjs <address> 即可返回 JSON 格式的摘要信息,包含各数据源可用性状态、原始分数和语义等级。工具支持多种输出格式(JSON、人类可读文本、完整配置文件),并提供 --full--human 等选项满足不同场景需求。对于开发者,还可直接导入 ES 模块在自定义脚本中调用 checkReputation 等函数,实现深度集成。

显著优点体现在其架构设计的多个维度。首先是多源数据聚合能力,无需 API 密钥即可访问 Ethos Network 数据,同时支持通过可选密钥启用 Talent Protocol 和 Farcaster 查询,实现 graceful degradation(优雅降级)。其次是中性设计理念,工具仅返回原始分数和等级(如 Builder Score、Credibility Level),不做信任裁决或排名比较,将判断权完全交给用户。第三是完善的安全设计,采用硬编码路径加载凭证(~/.openclaw/.env),无目录遍历风险,且仅执行只读 API 访问。此外,完善的输入验证(以太坊地址正则校验)和错误处理机制确保工具在面对无效输入或网络异常时稳定运行。

潜在缺点与局限性主要包括对第三方 API 的依赖。由于数据源自外部平台,查询存在 1-3 秒的延迟,且受限于上游 API 的可用性和速率限制。此外,部分功能需要用户自行申请并配置 API 密钥(Talent Protocol 和 Neynar),增加了使用门槛。数据来源方面,尽管代码通过安全审计,但作者 teeclaw 为个人开发者(T3 来源),非官方组织维护,长期维护稳定性需持续关注。历史安全问题(v1.0.4 版本的密钥泄露事件)虽已修复,但提示用户需重视密钥管理。

适合的目标群体包括:Web3 项目方和 DAO 组织者,需要验证成员身份可信度;招聘团队,评估候选人的链上构建者声誉;DeFi 协议开发者,集成声誉数据进行风险评分;以及研究人员,分析 Web3 社交图谱和身份验证模式。任何需要自动化查询以太坊地址声誉数据,且希望保持数据中立性的场景均适用。

使用该技能可能存在的常规风险涉及网络依赖和 API 管理。工具需要访问外部网络服务,存在因网络中断或 API 服务宕机导致查询失败的风险。用户需妥善管理存储在本地环境文件中的 API 密钥,避免权限泄露(建议设置 600 文件权限并定期轮换)。此外,虽然工具本身不收集敏感数据,但查询行为会向第三方 API 暴露用户 IP 和查询的地址信息,在高度敏感场景下需考虑隐私保护。性能方面,并发查询多个数据源可能受限于最慢 API 的响应时间。

安全解读

核心用法

openclaw-basecred-sdk 是一个OpenClaw技能,通过 @basecred/sdk 提供命令行接口,用于查询Web3身份提供者的声誉数据。支持三种数据源:

  • Ethos Network(无需API Key):社交信誉分数(0-2800)、担保数、评价(正面/中立/负面)
  • Talent Protocol(需API Key):Builder分数(技术能力)、Creator分数(内容创作)、排名数据
  • Farcaster via Neynar(需API Key):账户质量分数(0-1)、质量阈值判定

基础用法:./scripts/check-reputation.mjs <以太坊地址>,支持 --full--human--json 三种输出格式。

显著优点

1. 设计哲学中立:明确区分"数据呈现"与"主观评判",仅返回原始分数和信号,不做排名、百分位或信任裁决
2. 防御性编程:缺失数据返回not_found状态而非崩溃,支持部分数据场景下的优雅降级

3. 依赖最小化:仅依赖2个运行时包(@basecred/sdk@0.6.2 + dotenv),供应链攻击面极小

4. 安全读取设计:API密钥仅从~/.openclaw/.env硬编码路径读取,无目录遍历风险;无文件写入、无子进程创建

5. 输出结构化:JSON格式包含availabilitydatarecency等明确字段,便于程序化集成

潜在缺点与局限性

1. T3来源可信度:由个人开发者teeclaw维护,非知名组织,历史上曾发生v1.0.3版本API密钥泄露事件(已修复)
2. 功能依赖外部API:Ethos虽无需密钥但服务稳定性不可控;Talent/Neynar需自行申请API Key

3. 数据时效性:仅返回原始更新时间戳,不做实时性保证;recency字段仅为粗略分桶(30天/90天阈值)

4. 覆盖范围有限:仅支持以太坊地址查询,不支持其他链或传统身份系统

5. 非评判性设计的代价:需调用方自行解读分数含义,无统一信任评分标准

适合人群

  • DAO治理参与者:需要快速验证提案者或投票者的链上声誉背景
  • Web3招聘方/投资人:批量筛查候选人或项目方的Builder/Creator分数
  • 社交协议开发者:集成多源声誉数据构建自己的信任算法
  • 安全研究员:审计目标地址的社交图谱可信度(需结合其他工具)

常规风险

  • API密钥管理:需手动配置TALENT_API_KEYNEYNAR_API_KEY至本地.env文件,建议设置文件权限为600
  • 数据解读偏差:原始分数不直接等同于可信度,高Builder分不代表人格可靠
  • 上游服务中断:任一API故障会导致对应数据源返回error状态
  • 隐私考量:查询行为本身会暴露至Ethos/Talent/Neynar服务器(虽为公开数据)

安全审计摘要

自动化安全检测评分80分(S级),静态分析92分、动态行为88分。v1.0.3版本的密钥泄露事件已通过git历史清理和密钥轮换完全修复,当前v1.0.4版本无残留风险。代码无eval/exec/system调用,仅执行HTTPS GET请求获取公开数据。

openclaw-basecred-sdk 内容

examples文件夹
scripts文件夹
lib文件夹
手动下载zip · 24.6 kB
example-response.jsonapplication/json
请选择文件