内容
<!--
robinhood-toolkit · 项目 README
作者：nirholas · https://github.com/nirholas/robinhood-toolkit
许可证：所有权利保留 (c) 2026 nirholas
-->
<h1 align="center">robinhood-toolkit</h1>
<p align="center"><strong>基于 Robinhood Chain 和 Robinhood Crypto 的构建工具、示例和 64 个构建提示。</strong></p>
<p align="center">
<a href="#快速开始">快速开始</a> ·
<a href="prompts/">构建提示</a> ·
<a href="examples/">示例</a> ·
<a href="#网络参数">网络</a> ·
<a href="#部署">部署</a>
</p>
---
Robinhood 在两个方面向开发者开放：**Robinhood Chain**，一个 Arbitrum Orbit L2，于 2026-07-01 公开上线，支持无许可合约部署；以及 **Robinhood Crypto REST API**，用于编程交易。第三个方面，基于 MCP 的代理交易，目前涵盖股票和期权，宣布将支持加密货币。
本仓库是建立在以上三个方面的实用层：可信的网络常量、可以直接运行的代码，以及可以交给编码代理构建的提示库。
## 为什么存在这个项目
官方文档告诉你有哪些端点，但并没有告诉你如何将数据流连接到蜡烛图，如何构建不会在凌晨 4 点被清算的策略循环，或者如何将相同的代码库部署到五个不同的主机。这个项目正是填补了这一空白。
这里的每一个事实都经过了实时来源的验证。网络参数通过直接 RPC 调用确认，而不是从文档中复制。任何无法验证的信息都标有 `未验证`，并附有自行验证的说明。
## 网络参数
| | 主网 | 测试网 |
|---|---|---|
| 链 ID | `4663` | `46630` |
| RPC | `https://rpc.mainnet.chain.robinhood.com` | `https://rpc.testnet.chain.robinhood.com` |
| 浏览器 | [robinhoodchain.blockscout.com](https://robinhoodchain.blockscout.com) | [explorer.testnet.chain.robinhood.com](https://explorer.testnet.chain.robinhood.com) |
| Sequencer feed | `wss://feed.mainnet.chain.robinhood.com` | `wss://feed.testnet.chain.robinhood.com` |
| Gas 代币 | ETH | ETH |
| 水龙头 | n/a | [faucet.testnet.chain.robinhood.com](https://faucet.testnet.chain.robinhood.com) |
技术栈：Arbitrum Orbit (Nitro)，结算到以太坊，以太坊数据可用 blob。观察到约 101ms 的区块时间和约 0.055 gwei 的 gas。Solidity 和 Vyper 部署无需修改；部署是无许可的。
核心合约：WETH `0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73` ·
USDG `0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168`
## 快速开始
```sh
git clone https://github.com/nirholas/robinhood-toolkit
cd robinhood-toolkit
npm install
```
确认可以连接到链：
```sh
cast chain-id --rpc-url https://rpc.mainnet.chain.robinhood.com
# 4663
```
或不使用 Foundry：
```sh
curl -s https://rpc.mainnet.chain.robinhood.com \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'
# {"jsonrpc":"2.0","id":1,"result":"0x1237"}
```
然后从 [`prompts/`](prompts/) 中选择一个轨道。
## 软件包
| 软件包 | 安装 | 描述 |
|---|---|---|
| [`robinhood-chain`](packages/robinhood-chain/) | `npm i robinhood-chain viem` | 链 SDK：viem 链定义，声明 Multicall3，验证代币常量，格式化从不猜测小数，链上地址验证防止 ticker 冲突，自适应 `eth_getLogs` 扫描 |
| [`robinhood-chain-mcp`](packages/robinhood-chain-mcp/) | `npx robinhood-chain-mcp` | 只读 MCP 服务器。赋予 Claude Code、Claude Desktop、Cursor 或任何 MCP 主机读取 Robinhood Chain 的能力：网络状态、余额、代币元数据、交易、DEX 对和反诈骗代币地址验证器。不持有密钥，无法签名或发送 |
使用以下命令将 MCP 服务器连接到代理：
```sh
claude mcp add robinhood-chain -- npx -y robinhood-chain-mcp
```
在自定义常量之前，请使用 `robinhood-chain`。它编码了这里最耗时的陷阱：USDG 有 **6** 位小数而不是 18，主网上的两个代币都响应符号 `USDG`，viem 的 `multicall()` 在没有 `contracts.multicall3` 条目时直接抛出异常，而 `eth_getLogs` 强制执行两个独立的上限，其中一个错误地将自身报告为参数错误。
## 构建提示
九个轨道中有 64 个自包含的构建任务。每个任务都说明了其目标、前提条件、验证的参考事实、步骤、可交付成果和验证程序。可以将其中一个任务交给编码代理或自己完成。
| 轨道 | 文件 | 涵盖内容 |
|---|---|---|
| [00-foundations](prompts/00-foundations/) | 6 | 网络设置、钱包、桥接、信任假设 |
| [10-chain](prompts/10-chain/) | 10 | 合约部署、股票代币、Uniswap、Morpho、Chainlink、索引 |
| [20-crypto-api](prompts/20-crypto-api/) | 8 | REST API 认证、市场数据、订单、流 |
| [30-agentic-mcp](prompts/30-agentic-mcp/) | 7 | 连接代理、枚举工具、适配器 |
| [40-charting](prompts/40-charting/) | 8 | DexScreener 数据、TradingView 图表、自定义数据流 |
| [50-autonomous](prompts/50-autonomous/) | 8 | 策略循环、回测、纸上交易、执行 |
| [60-site](prompts/60-site/) | 6 | 文档站点 |
| [70-deploy](prompts/70-deploy/) | 6 | Cloudflare、Vercel、Railway、Cloud Run、GitHub Pages |
| [80-safety](prompts/80-safety/) | 5 | 密钥、防护措施、模拟、审计日志、事件 |
## 部署
[`site/`](site/) 中的站点是一个单一的代码库，可以部署到 Cloudflare Pages、Vercel、Railway、Google Cloud Run 和 GitHub Pages。请参阅 [prompts/70-deploy](prompts/70-deploy/) 获取每个目标所需的配置和一个会破坏它们之间直接移植的陷阱。
## 构建前需要知道的事情
**目前链是中心化的。** Robinhood 操作 Sequencer 和 Proposer，[L2BEAT](https://l2beat.com/scaling/projects/robinhood) 评估其风险等级，认为少于五个外部参与者可以提交欺诈挑战。这是年轻 L2 的正常状态，也是现实的信任假设。考虑规模定位。
**规范桥接提现需要约 7 天。** 这是标准的乐观挑战期，而不是错误。合作伙伴路线（LayerZero、Chainlink CCIP、Relay、Across、LiFi）需要付费即可更快退出。
**桥接代币地址与其以太坊对应地址不同。** 在您实际所在的链上解析地址。
**股票代币地址来自实时注册表。** 它们是由 Robinhood Assets (Jersey) Limited 发行的代币化债务证券，不授予底层资产的任何法律或受益权利。Robinhood 明确警告说，在不同地址匹配 ticker 的代币不是规范的。在运行时查询注册表；永远不要硬编码。
**链上余额不是经纪余额。** 自我托管钱包服务通过 Robinhood Non-Custodial, Ltd. 运行，这是一个与 Robinhood Financial LLC 和 Robinhood Crypto, LLC 分开的法律实体。同一家公司，故意整合产品，不同托管。
**没有人监督您的代理。** Robinhood 表示它不控制、监督、监控、推荐或审计连接的代理。在您的任何代码未经监督下发出订单之前，请阅读 [prompts/80-safety](prompts/80-safety/)。
## 贡献
欢迎提出问题和 PR。两条规则：每个代码示例必须按原样运行，不得发明地址、端点或 API 形状。如果您无法验证，请标记为 `未验证` 并说明读者如何检查。
源文件带有署名头。请参阅 [ATTRIBUTION.md](ATTRIBUTION.md)。
## 免责声明
与 Robinhood Markets, Inc. 或其任何子公司无关、未获得其认可或赞助。“Robinhood”仅用于识别此工具包所针对的平台。
这里没有任何内容是财务建议。交易加密货币存在完全损失的风险。自主交易软件可能会比您反应更快地损失资金。您对您的代码使用您的资金负责。
## 许可证
所有权利保留 © 2026 [nirholas](https://github.com/nirholas)。请参阅 [LICENSE](LICENSE)。
