Robinhood Chain 测试网 RPC 地址与链 ID:免 key 读数据、WebSocket 订阅、水龙头

Robinhood Chain 测试网 RPC 地址 https://api.blockvectra.com/v1/robinhood_testnet/public,链 ID 46630:免 key 读取、带 key 的 WebSocket 订阅、水龙头领取,以及把同一把 key 切到主网。

Robinhood Chain 测试网的 RPC 地址是 https://api.blockvectra.com/v1/robinhood_testnet/public,链 ID 是 46630:免 key 的 HTTP JSON-RPC 每 IP 每秒 3 次请求,WebSocket 日志订阅需要 API key。测试 ETH 见测试网水龙头指南。核对于 。

本指南中的 RPC 端点由 BlockVectra 提供;Robinhood 自己的公共 RPC 与网络参数见官方连接文档。

BlockVectra 为 Robinhood Chain 测试网(链 ID 46630)提供 JSON-RPC 与 WebSocket 访问,同一把 API key 也能用于 Robinhood Chain 主网。本指南按 Robinhood Chain 测试网入门模板 的三步走:免 key 读测试网、程序化开户并订阅 logs、再把同一把 key 切到主网。端点参数、方法策略与代币化股票数据见 Robinhood Chain 指南。

运行模板

git clone https://github.com/blockvectra/robinhood-testnet-starter
cd robinhood-testnet-starter
npm install
npm run typecheck

需要 Node.js 18 及以上。三个脚本分别是 npm run step1、npm run step2 和 npm run step3。可选变量(BLOCKVECTRA_API_KEY、WALLET_PRIVATE_KEY)从 shell 读取(模板不自动加载 .env)。

连续运行完整流程

npm run walkthrough

这条命令先免 key 读取测试网,再订阅带过滤的日志 30 秒,随后用同一把 API key 读取主网 RPC 和 Data API。BLOCKVECTRA_API_KEY 非空时会复用该 key,跳过登录和 key 创建;否则,若未提供 WALLET_PRIVATE_KEY,首次运行会在 .agent-wallet.json 中保存一个专用登录钱包,之后重跑会复用该账户,而没有 key 时每次运行仍会新建服务端 key。订阅前,请先替换 src/step2-key-and-logs.ts 中的示例合约地址。

连续命令直接将 key 交给主网读取,无需从打码输出复制。免 key 读取失败时不继续开户;订阅报告错误时会在主网读取前退出;窗口内没有匹配事件本身不代表失败。

第 1 步:免 key 读测试网

公开端点 https://api.blockvectra.com/v1/robinhood_testnet/public 提供钱包类 JSON-RPC 方法,无需账户与 API key。直接查询 EIP-155 链 ID:

curl -s "https://api.blockvectra.com/v1/robinhood_testnet/public" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

返回为 {"jsonrpc":"2.0","id":1,"result":"0xb626"};0xb626 是十六进制链 ID,即十进制的 46630。

模板从 GET /v1/chains 读取链信息并据此构造 viem 客户端,链名与链 ID 都不写死。src/shared.ts:

import { createPublicClient, defineChain, http, webSocket } from "viem";

export const API_BASE = "https://api.blockvectra.com/v1";

export interface ChainEntry {
  chain: string;
  name: string;
  chain_id: number;
  data: boolean;
  ws: boolean;
  subscriptions: string[];
  public?: { url: string };
}

export async function getChain(slug: string): Promise<ChainEntry> {
  const res = await fetch(`${API_BASE}/chains`);
  if (!res.ok) throw new Error(`GET /v1/chains failed: ${res.status}`);
  const { chains } = (await res.json()) as { chains: ChainEntry[] };
  const entry = chains.find((c) => c.chain === slug);
  if (!entry) throw new Error(`${slug} not found in /v1/chains`);
  return entry;
}

export function toViemChain(entry: ChainEntry, rpcUrl: string) {
  return defineChain({
    id: entry.chain_id,
    name: entry.name,
    nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
    rpcUrls: { default: { http: [rpcUrl] } },
  });
}

export function httpClient(entry: ChainEntry, url: string, apiKey?: string) {
  return createPublicClient({
    chain: toViemChain(entry, url),
    transport: http(url, apiKey ? { fetchOptions: { headers: { "x-api-key": apiKey } } } : undefined),
  });
}

export function wsClient(entry: ChainEntry, apiKey: string) {
  const base = "wss://api.blockvectra.com/v1";
  const url = `${base}/${entry.chain}/${apiKey}`;
  return createPublicClient({ chain: toViemChain(entry, url), transport: webSocket(url) });
}

模板的 src/step1-public-read.ts 先验证目录中的链 ID,再与 eth_chainId 比对,通过后才读取最新区块与地址余额。目录数据无效或网络不匹配时,第 1 步以非 0 退出,npm run walkthrough 随即停止,不会进入开户阶段:

import { formatEther, type Address } from "viem";
import { API_BASE, getChain, httpClient } from "./shared.js";

// Step 1: no account, no key. Read Robinhood Chain Testnet through the public endpoint.
const SLUG = "robinhood_testnet";
// Any address works; override with the first CLI argument.
const address = (process.argv[2] ?? "0x0000000000000000000000000000000000000000") as Address;

const chain = await getChain(SLUG);

if (!Number.isSafeInteger(chain.chain_id) || chain.chain_id <= 0) {
  throw new Error(
    `invalid catalog chain_id for ${SLUG}: expected a positive safe integer, got ${String(chain.chain_id)}`,
  );
}

const client = httpClient(chain, `${API_BASE}/${SLUG}/public`);

// Confirm the network before any other read.
const chainId = await client.getChainId();
if (chainId !== chain.chain_id) {
  throw new Error(
    `chain ID mismatch for ${SLUG}: expected ${chain.chain_id} (catalog), actual ${chainId} (eth_chainId)`,
  );
}

const [blockNumber, balance] = await Promise.all([
  client.getBlockNumber(),
  client.getBalance({ address }),
]);

console.log(`chain       : ${chain.name} (${SLUG})`);
console.log(`eth_chainId : ${chainId} (0x${chainId.toString(16)})`);
console.log(`block       : ${blockNumber}`);
console.log(`balance     : ${formatEther(balance)} ETH  (${address})`);

第 2 步:程序化开户并订阅 logs

src/step2-key-and-logs.ts 在 https://console-api.blockvectra.com/v1 用钱包签名(SIWE,EIP-191)登录。首次登录会自动开户,随后客户端创建 API key。新账户注册即得 30,000,000 CU,无需信用卡。

import { loadOrCreateWallet } from "./wallet.js";

const CONSOLE_API = "https://console-api.blockvectra.com/v1";
const REF = "gh-robinhood-testnet-starter";

async function post<T>(path: string, body: unknown, token?: string): Promise<T> {
  const res = await fetch(`${CONSOLE_API}${path}`, {
    method: "POST",
    headers: { "Content-Type": "application/json", ...(token ? { Authorization: `Bearer ${token}` } : {}) },
    body: JSON.stringify(body),
  });
  if (!res.ok) throw new Error(`${path} failed: ${res.status} ${await res.text()}`);
  return (await res.json()) as T;
}

async function provisionKey(): Promise<string> {
  const { account } = loadOrCreateWallet({
    walletFile: ".agent-wallet.json",
    privateKey: process.env.WALLET_PRIVATE_KEY,
  });
  console.log(`wallet: ${account.address}`);

  // SIWE:先取挑战消息,原样签名(EIP-191)后登录;首次登录会创建账户。
  const { message } = await post<{ message: string }>("/auth/siwe/challenge", {
    address: account.address,
    purpose: "login",
  });
  const signature = await account.signMessage({ message });
  const login = await post<{ session: { token: string }; account_created: boolean }>("/auth/siwe/login", {
    message,
    signature,
    ref: REF,
  });
  console.log(`account_created: ${login.account_created}`);

  const created = await post<{ api_key: string }>("/keys", { label: "robinhood-testnet-starter" }, login.session.token);
  return created.api_key;
}

const apiKey = process.env.BLOCKVECTRA_API_KEY?.trim() || (await provisionKey());

BLOCKVECTRA_API_KEY 非空时,第 2 步跳过登录,也不读取或创建钱包文件。否则优先使用 WALLET_PRIVATE_KEY;值无效时会直接停止,不会回退到钱包文件。未提供时,首次运行会在当前工作目录的 .agent-wallet.json 中保存专用登录钱包,之后在同一目录重跑会复用同一身份;该钱包首次登录时才开户。实现见 src/wallet.ts。

该文件保存明文私钥,首次以 POSIX 模式 0600 创建,且匹配 *wallet*.json,因此 Git 会忽略它。请保护并备份它,不要提交,不要把私钥放到命令行,也不要使用持有资金的钱包。身份损坏、无效、不可读或无法写入时,第 2 步会在 SIWE challenge 前停止,不覆写文件,也不换成新身份;walkthrough 仍会先执行第 1 步的公开读取。没有现有 API key 时,每次运行都会新建服务端 key,key 不会自动撤销,复用账户身份也不等于复用 key。

WebSocket URL 把 key 放在路径中:wss://api.blockvectra.com/v1/robinhood_testnet/{api_key}。模板在订阅前会检查 GET /v1/chains 返回的 ws 标记与 subscriptions 列表:

在此仓库中运行模板的订阅实现。只有 eth_subscribe 返回订阅 ID 后才开始 30 秒窗口,结束时还要求 eth_unsubscribe 返回 true。连接或订阅报错、取消订阅失败都会阻止连续流程进入主网;只有空日志窗口不能证明订阅成功。

npm run step2

每个 logs 订阅过滤器必须包含 address 或 topic0;请把示例地址替换成你要监听的合约。过滤规则、关闭码与重连策略见 WebSocket 订阅指南。

第 3 步:把同一把 key 切到主网

单独读取主网时,请先 export 一把已有 API key,再运行第 3 步。它无法继承已结束的第 2 步中的 key;自动交接请用 npm run walkthrough。脚本使用 robinhood_mainnet,通过主网读取模块读取区块高度和 Robinhood 股票代币 Data API。

export BLOCKVECTRA_API_KEY=YOUR_EXISTING_API_KEY
npm run step3

同一个榜单端点的 curl:

curl -s -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  "https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks"

主网提供 Data API,测试网没有:GET /v1/chains 中 robinhood_testnet 的 data 为 false,robinhood_mainnet 的 data 为 true。请求参数与响应外层结构见 代币化股票指南。

从接口读取限额与能力

用 GET /v1/chains 读取实时的 jsonrpc、data、ws、subscriptions 标记、开放的 JSON-RPC 方法、日志区块跨度、状态保留窗口以及各链的公开端点;用 GET /v1/plans 读取当前价格与方案限额。

curl -s "https://api.blockvectra.com/v1/chains"

相关指南

下一步

最后更新:

本页目录