内容
# r0x 操作系统
**r0x** 的官方软件开发工具包、Claude 代码 / MCP 插件和促进者文档，
这是一个为 AI 代理构建的、基于 Robinhood Chain 的原生 USDG 操作系统。
r0x 运行在 Robinhood Chain 的官方 x402 促进者上。AI 代理可以立即使用它：
发现定价能力、授权 USDG 支付并调用它，所有操作都在一个不间断的调用中完成。
无需 API 密钥，无需订阅，也无需人工在中间审批任何内容。
在线站点：<a href="https://projectr0x.dev">projectr0x.dev</a> · 促进者文档：<a href="./docs/facilitator.md">docs/facilitator.md</a> · 技能参考：<a href="./docs/skills.md">docs/skills.md</a>
## 本仓库包含的内容
- **软件开发工具包** (`src/client`)：一个 TypeScript 客户端 (`R0xClient`)，自动处理 x402 挑战/签名/重试循环。作为 `r0x-os` 发布在 npm 上。
- **Claude 代码 / MCP 插件** (`src/plugin`)：将完整的技能目录公开为 MCP 工具，以及本地钱包设置和支出限制守护进程。
- **文档** (`docs/`)：促进者工作原理和完整的技能参考。
- **示例** (`examples/`)：一个最小化、依赖轻量的参考客户端。
## 安装
```bash
npm install r0x-os
```
```ts
import { R0xClient } from 'r0x-os';
const client = new R0xClient({ privateKey: process.env.R0X_PRIVATE_KEY });
// 每次调用 0.01 USDG，自动结算
const { data } = await client.price('ETH');
console.log(data.priceUSD);
const balance = await client.balance('0x...');
console.log(balance.data.balances);
```
参见 <a href="./docs/skills.md">docs/skills.md</a> 以获取客户端公开的每个方法。
## Claude 代码插件
```
/plugin marketplace add nhevers/project-r0x
/plugin install r0x-os
```
或直接将其添加为 MCP 服务器：
```bash
claude mcp add r0x -- npx r0x-os
```
不需要预先提供私钥，代理在首次使用时调用 `r0x_setup` 以导入现有钱包或生成新钱包。之后，将提供十种工具：`r0x_setup`、`balance`、`tx`、`price`、`wallet`、`chat`、`send`、`fund`、`broadcast` 和 `spend_limit`。（`trade` 被故意排除，因为目前没有 DEX 聚合器索引 Robinhood Chain。）
## 从源代码构建
```bash
git clone https://github.com/nhevers/project-r0x.git
cd project-r0x
npm install
npm run build # 编译 src/ -> dist/
npm run example:tx # 运行参考测试事务脚本
```
## 促进者工作原理
阅读 <a href="./docs/facilitator.md">docs/facilitator.md</a> 以获取完整的协议演练，
或直接跳转到 <a href="./examples/test-transaction.js">examples/test-transaction.js</a> 以获取一个可行的约 80 行客户端。
## 许可证
MIT，参见 <a href="./LICENSE">LICENSE</a>。
