MetaMask / Rabby 自定义 RPC 设置：URL 与 Chain ID

在 MetaMask 或 Rabby 中填写 RPC URL、Chain ID 与原生币符号，需要认证时使用钱包专用 key。

• 第一步：查看支持链网络参数对照表，在钱包中填写对应字段；认证 RPC 使用 /v1/{chain}/{api_key}。
• 完成标准：在 MetaMask 保存后，网络已添加并切换到该网络；填写的链 ID 与端点返回的 ID 一致。

链参数与接入方式。

1. 为什么要使用自定义 RPC

各区块链生态通常会提供默认的公共 RPC 端点供开发者与用户测试，但官方文档中均明确声明了公共端点的限速与使用范围：

• Robinhood Chain： Robinhood Chain 官方文档 Connecting to Robinhood Chain 明确注明，公共端点 https://rpc.mainnet.chain.robinhood.com 存在调用频次限制，官方不建议在生产环境中使用（The following public endpoints are available but are rate-limited and not recommended for production use. For production, use a provider）。
• HyperEVM： Hyperliquid 官方文档 Rate limits and user limits 明确规定，针对公共端点 rpc.hyperliquid.xyz/evm，每个 IP 地址每分钟最多允许 100 次 EVM JSON-RPC 请求（Maximum of 100 EVM JSON-RPC requests per minute for rpc.hyperliquid.xyz/evm）。

2. 钱包所需字段与网络参数

主流 EVM 钱包在添加自定义网络时需要填写以下参数：

1. 网络名称（Network Name）：在钱包界面中显示的名称。
2. RPC URL：节点通信端点。必须将 API key 放在 URL 路径中，在 api.blockvectra.com 上使用路径：

   复制文字

   /v1/{chain}/{api_key}

   重要说明：MetaMask 与 Rabby 等钱包仅支持输入标准的 HTTP(S) URL 字符串，不支持自定义请求头（无法传入 x-api-key: {api_key} 头）。因此钱包中必须使用路径携带 Key 的端点形式。URL 末尾不要带斜杠，未知链标识将返回 HTTP 404。

3. 链 ID（Chain ID）：EIP-155 标准整数链 ID。
4. 货币符号（Currency Symbol）：该链原生 Gas 代币符号（如 ETH、HYPE）。
5. 区块浏览器 URL（Block Explorer URL）：区块链浏览器主页地址。

支持链网络参数对照表

HyperEVM 发送方法边界：带密钥的 BlockVectra HyperEVM 端点在 methods.allow 中列出 eth_sendRawTransaction；公共免密钥端点未列出。从钱包发送前，请确认所选端点允许 eth_sendRawTransaction 且 chain ID 一致。（详见 HyperEVM 回填与部署指南中的广播说明。）

API key 适用于上方所有支持的链，只需将 URL 路径中的 {chain} 替换为对应的链标识。关于跨链共用余额与限流机制，请参阅一个 key 切链指南。

3. 钱包操作步骤

MetaMask 操作步骤

按照 MetaMask 官方帮助文档 How to add a custom network RPC 的说明进行配置：

1. 打开 MetaMask 浏览器插件或移动端应用。
2. 点击应用顶部的网络选择器下拉菜单（或进入「设置」>「网络」）。
3. 选择「添加网络」（Add network），随后选择「手动添加网络」（Add a network manually）。
4. 对照上表填写对应链的参数：
   • 网络名称：填入上表中对应链的名称。
   • 新的 RPC URL：填入包含你的 Key 的路径 URL，例如 https://api.blockvectra.com/v1/robinhood_mainnet/{api_key}（将 {api_key} 替换为你实际的 Key）。
   • 链 ID：填入上表中对应链的整数链 ID。
   • 货币符号：填入上表中对应链的原生代币符号。
   • 区块浏览器 URL：填入官方浏览器地址（可选）。
5. 点击「保存」（Save）完成添加，钱包将自动切换到该网络。

在 HyperEVM 上发送交易：带密钥的 BlockVectra HyperEVM 端点在 methods.allow 中列出 eth_sendRawTransaction；公共免密钥端点未列出。从钱包发送前，请确认所选端点允许 eth_sendRawTransaction 且 chain ID 一致。（参见 HyperEVM 回填与部署指南中的广播说明。）

修改已有网络的 RPC：如需替换现有网络的 RPC 提供商，可进入 MetaMask「设置」>「网络」，点击目标网络名称，在「RPC URL」列表中添加或修改端点地址并保存。

Rabby Wallet 操作步骤

在 Rabby 的自定义网络或自定义 RPC 设置中填入上表参数：网络名称、RPC URL（路径携带 Key：https://api.blockvectra.com/v1/{chain}/{api_key}）、链 ID、货币符号以及区块浏览器地址。

提示：添加自定义网络或测试网时，务必保证 Chain ID 与端点返回的真实 ID 一致，否则钱包会提示链 ID 不匹配。

4. 安全提示与用量管理

在钱包中使用专有 RPC 服务时，需要注意以下安全与计费规则：

[!WARNING] API Key 泄露防护：RPC URL 路径中包含了你的 API key 明文。切勿将包含该 URL 的钱包网络设置界面截图分享到公共社区，也不要将含有真实 Key 的 RPC URL 提交至公开代码仓库或配置文件中。

1. 钱包请求会计入用量： 钱包打开、切换标签页或刷新资产时发起的所有读取方法（如 eth_blockNumber、eth_getBalance、eth_call）均会作为真实请求发送至 BlockVectra 节点，并根据所调用方法的 CU 权重（详见定价页）扣减账户额度或计入速率上限。
2. 为钱包单独创建专用 API Key： 建议在控制台中为钱包创建一把独立的 API key（例如添加标签 wallet-metamask 或 wallet-rabby），与开发脚本、后端服务器及 AI Agent 使用的 Key 分开管理。
3. 独立吊销与泄露应急： 若怀疑钱包端点配置发生泄露，可直接在控制台的密钥管理列表中单独吊销该 Key，无需废弃整个账户或影响其他正在运行的应用。 若会话或 Key 丢失，可参考程序化开户指南中的「会话或 key 丢了怎么办」小节，通过开户钱包重新签名恢复控制权。

5. 相关资源

• 历史状态限制：查询过去的余额或合约值前，核对认证状态窗口与免 key 历史；日志查询跨度是另一种限制。
• 一个 key 切链指南：了解多链 URL 规范、公开链发现端点与跨链共享额度。
• 查看免费额度与定价：了解各套餐的方法权重、速率补充以及充值升级规则。

下一步

• 浏览数据集目录，查看 BlockVectra 索引的全部数据集。
• 查看免费额度与定价，确认账户可用的方案。
• 登录控制台创建 API key。