Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 40 additions & 0 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
@@ -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) 构建 ⚡*
50 changes: 50 additions & 0 deletions docs/README.zh-CN.md
Original file line number Diff line number Diff line change
@@ -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
117 changes: 117 additions & 0 deletions docs/how-to-attest.zh-CN.md
Original file line number Diff line number Diff line change
@@ -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)