edge

Name: edge
Author: goldsky-io

github.com/goldsky-io云与 DevOps124.1k 次安装今天更新

代码仓库

关于 edge

edge 是介绍 Goldsky Edge 的技能；Edge 是面向 EVM 链的托管 RPC 端点服务。内容涵盖端点设置与管理，以及路由、缓存、故障切换、限流和监控，适用于需要区块链 RPC 访问的应用。

主要功能

01托管 EVM JSON-RPC 端点
02路由、缓存与上游故障切换
03请求去重和速率限制
04端点日志与指标
05Flashblocks 与 HyperEVM 节点池选项

适用场景

01让应用连接 EVM 链 RPC
02监控 RPC 延迟、错误和请求量
03配置端点速率限制
04为支持的网络选择专用上游

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/goldsky-io/goldsky-agent --skill edge

安装后在 Claude Code 中输入/edge确认已加载。

详细介绍

Goldsky Edge（RPC 端点）

Goldsky Edge 是一项面向 EVM 区块链的托管高性能 RPC 端点服务，基于开源的容错 EVM RPC 代理 eRPC 构建。它通过智能路由、缓存、故障转移和内置可观测性，提供全球分布式、低延迟的 RPC 访问。

Edge 的功能

Edge 位于你的应用与区块链 RPC 提供商之间，并提供以下功能：

性能：覆盖 8 个以上区域的全球边缘基础设施、低于 100 毫秒的延迟、针对链顶端数据的 CDN 缓存
弹性：在多个提供商之间自动故障转移，实现 99.9% 的正常运行时间，并行发送备用请求
数据完整性：交叉验证多个节点的响应、跟踪区块高度、强制执行共识检查
成本控制：请求去重、智能路由、可配置的速率限制
索引优化：自动拆分大型 eth_getLogs 请求，将历史查询路由至归档节点

快速入门

端点格式

https://edge.goldsky.com/standard/evm/{chainId}?secret=YOUR_SECRET

将 {chainId} 替换为链 ID（例如，Ethereum 的 1、Base 的 8453、Arbitrum 的 42161）。

身份验证

有三种方式：

请求头（推荐）：X-ERPC-Secret-Token: YOUR_SECRET — 避免将密钥放在 URL 中，因为代理、CDN 和服务器访问日志通常会记录 URL。
查询参数：?secret=YOUR_SECRET — 适合快速测试，但任何记录完整 URL 的日志都会包含该密钥。生产流量建议使用请求头。为简洁起见，以下示例使用查询参数。
x402（按请求付费）：没有密钥的客户端会收到包含付款要求的 HTTP 402 响应。兼容 x402 的客户端会签署 USDC 付款并重试；Edge 会先通过结算代理完成结算，再将请求转发至上游。付款以 USDC 在 Base（链 8453）上结算。价格为每个请求 $0.000005（与标准费率 $5 per million 相同）。协议规范请参阅 https://www.x402.org/。

示例（curl）

curl -s "https://edge.goldsky.com/standard/evm/1?secret=YOUR_SECRET" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

示例（viem）

import { createPublicClient, http } from "viem";
import { mainnet } from "viem/chains";

const client = createPublicClient({
  chain: mainnet,
  transport: http("https://edge.goldsky.com/standard/evm/1?secret=YOUR_SECRET"),
});

示例（ethers.js）

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider(
  "https://edge.goldsky.com/standard/evm/1?secret=YOUR_SECRET"
);

在 Webapp 中管理 Edge 端点

可在 Goldsky Webapp 的 /dashboard/rpc-edge 页面创建和管理 Edge 端点。

创建端点

前往 Edge RPC 页面（/dashboard/rpc-edge）
点击“Create endpoint”
输入名称（小写字母、数字和连字符；必须以字母开头；长度为 3–50 个字符）
可选：选择速率限制预算
系统会自动生成 API 密钥（格式：gs_edge_...）

端点管理

查看指标：在端点详情页查看请求数、错误率和响应时间
查看日志：可搜索、筛选的日志，便于调试
显示 API 密钥：查看你的密钥（点击即可复制）
速率限制：更新端点的速率限制预算
暂停/恢复：切换端点的启用或停用状态
删除：永久移除端点

套餐限制

Free（Starter）：1 个端点，受免费套餐请求限额约束
Scale：多个端点，按使用量付费
Enterprise：端点数量不限

速率限制

速率限制在 Goldsky Dashboard 中按密钥配置。选择以下命名层级之一（来源：https://docs.goldsky.com/edge-rpc/platform/security#rate-limiting）：

预算 ID	总 RPS	每 IP RPS	用例
`None (Unlimited)`	不限	不限	不限制速率
`edge-tier-6krpm-total-unlimited-per-ip`	~100	不限	低流量
`edge-tier-60krpm-total-unlimited-per-ip`	~1,000	不限	中等流量
`edge-tier-180krpm-total-unlimited-per-ip`	~3,000	不限	高流量
`edge-tier-360krpm-total-unlimited-per-ip`	~6,000	不限	非常高的流量
`edge-tier-600krpm-total-unlimited-per-ip`	~10,000	不限	企业级流量
`edge-tier-6krpm-total-500rpm-per-ip`	~100	~8	低流量 + 每 IP 保护
`edge-tier-60krpm-total-500rpm-per-ip`	~1,000	~8	中等流量 + 每 IP 保护
`edge-tier-180krpm-total-500rpm-per-ip`	~3,000	~8	高流量 + 每 IP 保护
`edge-tier-360krpm-total-500rpm-per-ip`	~6,000	~8	非常高的流量 + 每 IP 保护
`edge-tier-600krpm-total-500rpm-per-ip`	~10,000	~8	企业级流量 + 每 IP 保护
`edge-tier-unlimited-total-100rpm-per-ip`	不限	~1.7	仅严格限制每 IP
`edge-tier-unlimited-total-500rpm-per-ip`	不限	~8	仅适度限制每 IP

总 RPS = 使用此密钥的所有 IP 每秒可发出的最大请求数
每 IP RPS = 单个客户端 IP 每秒可发出的最大请求数

速率限制预算在内部定义以下规则：

method — 限制适用的 RPC 方法（支持通配符）
maxCount — 最大请求数
period — 时间窗口（例如，每秒、每分钟）

支持的网络

实时注册表（权威来源 — 推荐链前务必先查看）：GET https://edge.goldsky.com/

返回包含 standard 数组的 JSON，其中列出 Edge 服务的所有网络。每个条目包含：

id — 例如 evm:1（前缀 + 链 ID）
alias — 易读名称（例如 mainnet、base、polygon）
blockTimeMs — 平均区块时间
state — 正常运行时为 OK

# List all supported chain IDs
curl -s https://edge.goldsky.com/ | jq '.standard[].id'

# Find a specific chain
curl -s https://edge.goldsky.com/ | jq '.standard[] | select(.id=="evm:8453")'

重点网络包括 Ethereum、Arbitrum One、Base、Optimism、Polygon zkEVM、BSC、Avalanche、Berachain、HyperEVM、Monad、Sei、Sonic、Unichain、zkSync 及其测试网。不过，上方的注册表才是准确信息来源，其中还包含更多网络。

易读版文档页面：https://docs.goldsky.com/chains/supported-networks

特殊功能

Flashblocks

加快 OP Stack 链（Base、Optimism、Unichain 及其测试网）的区块确认速度。通过以下方式启用：

查询参数：use-upstream=flashblocks*
或请求头：X-ERPC-Use-Upstream: flashblocks*

HyperEVM 系统交易

HyperEVM 有两种不同的节点池：

use-upstream=systx* — 包含系统交易的归档节点（用于索引）
use-upstream=standard* — 不包含系统交易的实时节点（用于前端 dApp）

定价

每百万次请求 $5 — 所有 RPC 方法价格相同（eth_getLogs 或 trace 方法不收取附加费用）
每月最多 500M 次请求，每百万次 $5
超过 500M 次：可享受批量折扣（联系销售团队）

监控

每个端点都内置 Grafana 仪表板，显示：

RPC 请求总数和每秒请求数
网络和方法使用情况细分
响应时间百分位数（P50/P90/P99）
错误率和详细错误日志
受速率限制的请求追踪
多路复用和对冲请求指标

错误代码

Edge 会规范化上游提供商返回的错误：

代码	含义
-32005	超出速率限制
-32012	范围过大（eth_getLogs）
-32014	缺少数据
-32015	节点超时
-32016	未授权

此外还包括标准 JSON-RPC 错误（-32700、-32600、-32601、-32602、-32603）和 EVM 特定错误（-32000、-32003、3）。

支持的 RPC 方法

全面支持五个命名空间中的标准 EVM JSON-RPC 方法（60 多种方法）。每种方法都有单独的文档页面，网址为 https://docs.goldsky.com/edge-rpc/evm/methods/{method_name} — 构造调用前，请先查看文档以确认参数、返回格式以及任何 Edge 特定行为。

方法索引：https://docs.goldsky.com/edge-rpc/evm/methods

`eth_*` — 核心链查询和交易

eth_accounts、eth_blobBaseFee、eth_blockNumber、eth_call、eth_chainId、eth_createAccessList、eth_estimateGas、eth_feeHistory、eth_gasPrice、eth_getBalance、eth_getBlockByHash、eth_getBlockByNumber、eth_getBlockReceipts、eth_getBlockTransactionCountByHash、eth_getBlockTransactionCountByNumber、eth_getCode、eth_getFilterChanges、eth_getFilterLogs、eth_getLogs、eth_getProof、eth_getStorageAt、eth_getTransactionByBlockHashAndIndex、eth_getTransactionByBlockNumberAndIndex、eth_getTransactionByHash、eth_getTransactionCount、eth_getTransactionReceipt、eth_getUncleByBlockHashAndIndex、eth_getUncleByBlockNumberAndIndex、eth_getUncleCountByBlockHash、eth_getUncleCountByBlockNumber、eth_maxPriorityFeePerGas、eth_newBlockFilter、eth_newFilter、eth_newPendingTransactionFilter、eth_pendingTransactions、eth_sendRawTransaction、eth_subscribe、eth_syncing、eth_uninstallFilter、eth_unsubscribe

`debug_*` — 原始区块／收据数据和 EVM 跟踪

debug_getRawBlock、debug_getRawHeader、debug_getRawReceipts、debug_getRawTransaction、debug_traceBlockByHash、debug_traceBlockByNumber、debug_traceCall、debug_traceTransaction

`trace_*` — OpenEthereum 风格的跟踪

trace_block、trace_call、trace_callMany、trace_filter、trace_get、trace_rawTransaction、trace_replayBlockTransactions、trace_replayTransaction、trace_transaction

`net_*` — 网络元数据

net_listening、net_peerCount、net_version

`web3_*` — 客户端元数据

web3_clientVersion、web3_sha3

请求格式

所有方法均使用标准 JSON-RPC 2.0 信封。以下是 eth_getLogs 的示例：

curl -s "https://edge.goldsky.com/standard/evm/1?secret=YOUR_SECRET" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_getLogs",
    "params": [{
      "fromBlock": "0x1000000",
      "toBlock": "0x1000064",
      "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
    }]
  }'

使用跟踪方法（debug_trace*、trace_*）前，请查看对应方法的文档页面 — 并非每条链都支持所有跟踪器，且某些方法存在特定于链的注意事项，文档中会对此进行说明。

eRPC（开源）

Edge 基于 eRPC 构建，这是一个开源、容错的 EVM RPC 代理。对于 Goldsky Edge 未提供的功能（自托管、自定义缓存驱动、自定义选择策略、多提供商故障转移等），用户可能会希望直接运行 eRPC。

如需完整的 eRPC 参考资料（功能、配置、API），请获取面向 LLM 优化的文档包：https://docs.erpc.cloud/llms.txt

选择 Edge 还是 Boost？

两者共用 edge.goldsky.com 主机名，因此经常被混淆：

Edge（本技能）是 Goldsky 自己管理的 RPC。用户购买它来替代某个提供商。它支持多条链、可配置的速率限制额度、请求对冲、故障转移和 x402。
Boost（/boost）是免费 CDN，位于用户已有的提供商之前。可缓存的读取请求由 Goldsky 的索引数据提供；其他请求则原样转发到用户的端点。仅支持有创世区块覆盖的链、仅支持 HTTP，并采用 Goldsky 管理的速率限制。

“我想减少在 Alchemy 上的支出”对应 Boost。“我想停止使用 Alchemy”对应 Edge。用户也可以将 Boost 的上游指向 Edge 端点。

Goldsky Documentation Links

Edge Introduction: https://docs.goldsky.com/edge-rpc/introduction
Edge Quickstart: https://docs.goldsky.com/edge-rpc/quickstart
Why Edge: https://docs.goldsky.com/edge-rpc/why-edge
Security & Rate Limiting: https://docs.goldsky.com/edge-rpc/platform/security
Monitoring: https://docs.goldsky.com/edge-rpc/platform/monitoring
Flashblocks: https://docs.goldsky.com/edge-rpc/capabilities/flashblocks
HyperEVM System Tx: https://docs.goldsky.com/edge-rpc/capabilities/hyperevm-system-transactions
Error Codes: https://docs.goldsky.com/edge-rpc/evm/error-codes
RPC Methods Index: https://docs.goldsky.com/edge-rpc/evm/methods
Pricing: https://docs.goldsky.com/pricing/summary
Supported Networks: https://docs.goldsky.com/chains/supported-networks

支持 Markdown

登录后评论

基本信息

作者: goldsky-io
仓库: goldsky-io/goldsky-agent
分类: 云与 DevOps
安装次数: 4,074
GitHub Stars: 12

报告问题