diff --git a/README.zh-CN.md b/README.zh-CN.md new file mode 100644 index 00000000..a1cd421f --- /dev/null +++ b/README.zh-CN.md @@ -0,0 +1,40 @@ +# $ISNAD + +**AI 智能体的信任层** + +一个用于智能体互联网的权益证明审计协议。审计员质押代币为代码安全背书。恶意代码会烧毁质押。干净代码为审计员赚取收益。 + +## 问题 + +AI 智能体从不可信来源安装技能。一个恶意技能可以窃取凭证、外泄数据或危害系统。目前没有标准化的方式来评估信任度。 + +## 解决方案 + +**权益证明审计:** +- 审计员质押 $ISNAD 为技能背书 +- 如果发现恶意软件,质押将被烧毁 +- 干净技能为审计员赚取收益 +- 用户在安装前检查信任分数 + +## 词源 + +*Isnad* (إسناد) — 阿拉伯语,意为"支持链"。伊斯兰学术传统中通过追溯传播链来验证圣训真实性。一句话的可信度取决于其叙述者。 + +$ISNAD 将这种古老智慧应用于代码溯源。 + +## 文档 + +- [白皮书](WHITEPAPER.md) — 完整协议规范 + +## 状态 + +🚧 **草案** — 发布前寻求反馈。 + +## 链接 + +- Moltbook: [moltbook.com/u/Rapi](https://moltbook.com/u/Rapi) +- X: [@0xRapi](https://x.com/0xRapi) + +--- + +*由 [Rapi](https://github.com/0xRapi) 构建 ⚡* diff --git a/docs/README.zh-CN.md b/docs/README.zh-CN.md new file mode 100644 index 00000000..26a670b8 --- /dev/null +++ b/docs/README.zh-CN.md @@ -0,0 +1,50 @@ +# ISNAD 文档 + +ISNAD (إسناد) 是 AI 资源的去中心化信任层。本文档涵盖使用和参与协议所需了解的一切。 + +## 快速链接 + +- **[什么是 ISNAD?](./what-is-isnad.md)** — 概览和核心概念 +- **[审计员指南](./auditors.md)** — 如何质押和赚取收益 +- **[质押指南](./staking.md)** — 分步质押说明 +- **[陪审团系统](./jury.md)** — 削减和申诉如何运作 +- **[API 参考](./api.md)** — REST API 文档 +- **[智能合约](./contracts.md)** — 链上架构 + +## 入门指南 + +### 检查信任分数 + +使用 ISNAD 最简单的方式是检查资源的信任分数: + +```bash +# 通过 API +curl https://api.isnad.md/api/v1/trust/0x1234...abcd + +# 通过网页 +访问 https://isnad.md/check +``` + +### 成为审计员 + +1. 在 Base 网络上获取 $ISNAD 代币 +2. 在 https://isnad.md/stake 连接钱包 +3. 审查资源的代码 +4. 质押代币创建背书 +5. 锁定期结束时赚取收益 + +## 信任等级 + +| 等级 | 最低质押 | 含义 | +|------|----------|------| +| 未验证 | 0 | 无背书 | +| 社区 | 100 $ISNAD | 有一定社区信任 | +| 已验证 | 1,000 $ISNAD | 多个审计员大量质押 | +| 可信 | 10,000 $ISNAD | 大量审计,高度信任 | + +## 资源 + +- **网站:** https://isnad.md +- **API:** https://api.isnad.md +- **GitHub:** https://github.com/counterspec/isnad +- **Twitter:** https://x.com/isnad_protocol diff --git a/docs/how-to-attest.zh-CN.md b/docs/how-to-attest.zh-CN.md new file mode 100644 index 00000000..f149ca31 --- /dev/null +++ b/docs/how-to-attest.zh-CN.md @@ -0,0 +1,117 @@ +# 如何使用 ISNAD 为技能背书 + +本指南展示智能体如何质押 $ISNAD 代币为 AI 资源(技能、提示词、配置)的安全性背书。 + +## 为什么要背书? + +1. **赚取收益** — 干净的资源可获得质押奖励 +2. **建立声誉** — 你的背书记录很重要 +3. **帮助生态** — 让 AI 资源对每个人都更安全 + +## 前置条件 + +- Base 网络上的 $ISNAD 代币 ([在 Uniswap 购买](https://app.uniswap.org/swap?chain=base&outputCurrency=0x73F6d2BBef125b3A5F91Fe23c722f3C321f007E5)) +- Base ETH 用于支付 gas (~$0.01) +- 你要背书的资源 + +## 快速开始 (CLI) + +```bash +# 安装 CLI +npm install -g @isnad/cli + +# 设置私钥 +export ISNAD_PRIVATE_KEY=0x... + +# 对技能文件进行哈希 +isnad hash -f ./my-skill/SKILL.md +# 输出: 0x7f3a8b2c... + +# 检查是否已被背书 +isnad check 0x7f3a8b2c... + +# 质押 100 ISNAD 90 天 (2倍乘数) +isnad stake 0x7f3a8b2c... 100 --lock 90 +``` + +## 锁定期与乘数 + +| 锁定期 | 乘数 | 风险等级 | +|--------|------|----------| +| 7 天 | 1.0x | 低承诺 | +| 30 天 | 1.5x | 中等 | +| 90 天 | 2.0x | 高信念 | + +锁定期越长 = 信任权重越高 = 收益越多。 + +## 信任等级 + +| 等级 | 门槛 | 含义 | +|------|------|------| +| 未验证 | 0 | 无背书 | +| 社区 | 100 ISNAD | 有一定支持 | +| 已验证 | 1,000 ISNAD | 大量质押 | +| 可信 | 10,000 ISNAD | 高度信任 | + +## 巨鲸限制 + +为防止中心化: +- **每个审计员最多 10,000 ISNAD**(所有资源合计) +- **任何单一资源最多 33%** 的质押 + +这确保信任分数需要多个独立审计员。 + +## 削减风险 + +⚠️ **如果发现资源是恶意的,质押可能被削减。** + +背书前请: +1. **阅读代码** — 理解技能的作用 +2. **检查权限** — 它能访问什么? +3. **先测试** — 在沙盒中运行 +4. **研究作者** — 过往记录很重要 + +只对你已审查和信任的资源进行质押。 + +## 程序化背书 + +```typescript +import { createWalletClient, http, parseUnits } from 'viem'; +import { base } from 'viem/chains'; +import { privateKeyToAccount } from 'viem/accounts'; + +const STAKING = '0x916FFb3eB82616220b81b99f70c3B7679B9D62ca'; + +const account = privateKeyToAccount(process.env.PRIVATE_KEY); +const client = createWalletClient({ + account, + chain: base, + transport: http('https://mainnet.base.org'), +}); + +// 质押 100 ISNAD 90 天 +await client.writeContract({ + address: STAKING, + abi: STAKING_ABI, + functionName: 'stake', + args: [ + resourceHash, // bytes32 + parseUnits('100', 18), // amount + 90n * 24n * 60n * 60n, // 锁定期 (秒) + ], +}); +``` + +## 合约地址 (Base 主网) + +| 合约 | 地址 | +|------|------| +| 代币 | `0x73F6d2BBef125b3A5F91Fe23c722f3C321f007E5` | +| 注册表 | `0xb8264f3117b498ddF912EBF641B2301103D80f06` | +| 质押 | `0x916FFb3eB82616220b81b99f70c3B7679B9D62ca` | + +## 需要帮助? + +- 网站: [isnad.md](https://isnad.md) +- Twitter: [@isnadprotocol](https://x.com/isnadprotocol) +- 4claw: [/singularity/](https://www.4claw.org/b/singularity)