edge

Name: edge
Author: goldsky-io

github.com/goldsky-ioクラウド・DevOps124.1k 回インストール今日更新

edge について

edgeは、EVMチェーン向けのマネージドRPCエンドポイントサービスであるGoldsky Edgeを利用するためのスキルです。エンドポイントの設定・管理に加え、ルーティング、キャッシュ、フェイルオーバー、レート制限、監視について説明します。

主な機能

01マネージドEVM JSON-RPCエンドポイント
02ルーティング、キャッシュ、上流のフェイルオーバー
03リクエストの重複排除とレート制限
04エンドポイントのログとメトリクス
05FlashblocksとHyperEVMノードプールの選択肢

活用シーン

01アプリケーションをEVMチェーンRPCに接続
02RPCの遅延、エラー、リクエスト量を監視
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）。

認証

次の 3 つの方法があります。

ヘッダー（推奨）：X-ERPC-Secret-Token: YOUR_SECRET — プロキシ、CDN、サーバーのアクセスログによく記録される URL にシークレットが含まれないようにします。
クエリパラメーター：?secret=YOUR_SECRET — 簡単なテストには便利ですが、URL 全体を記録するログにはシークレットが残ります。本番トラフィックではヘッダーを使用してください。以下の例では簡潔にするため、クエリパラメーターを使用しています。
x402（リクエストごとの従量課金）：シークレットを持たないクライアントには、支払い要件を含む HTTP 402 レスポンスが返されます。x402 対応クライアントは USDC 支払いに署名して再試行します。Edge はリクエストを上流に転送する前に、ファシリテーターを介して決済します。支払いは Base（チェーン 8453）上で USDC により決済されます。料金はリクエスト 1 件あたり $0.000005 です（標準の「100 万件あたり $5」と同じ料金）。プロトコル仕様については 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"
);

Web アプリでの Edge エンドポイントの管理

Edge エンドポイントは、Goldsky Web アプリの /dashboard/rpc-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）。

Budget 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 における、1 秒あたりの最大リクエスト数
IP ごとの RPS = 単一のクライアント IP からの、1 秒あたりの最大リクエスト数

レート制限の予算では、内部的に次のルールを定義します。

method — 制限を適用する RPC メソッド（ワイルドカードに対応）
maxCount — リクエストの最大数
period — 時間枠（例：1 秒あたり、1 分あたり）

対応ネットワーク

ライブレジストリ（権威ある情報源です。チェーンを推奨する前に必ず確認してください）：GET https://edge.goldsky.com/

Edge が提供するすべてのネットワークを含む standard 配列を持つ JSON を返します。各エントリには次の情報が含まれます。

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 には、用途の異なる 2 つのノードプールがあります。

use-upstream=systx* — システムトランザクションを含むアーカイブノード（インデックス作成用）
use-upstream=standard* — システムトランザクションを含まないリアルタイムノード（フロントエンドの dApp 用）

料金

100 万リクエストあたり 5 ドル — すべての RPC メソッドの料金は同じです（eth_getLogs やトレースメソッドの追加料金はありません）
月間最大 5 億リクエストまで、100 万リクエストあたり 5 ドル
5 億リクエスト超：ボリュームディスカウントを利用できます（営業にお問い合わせください）

モニタリング

各エンドポイントには、次の情報を表示する Grafana ダッシュボードが組み込まれています。

RPC リクエストの合計数と 1 秒あたりのリクエスト数
ネットワーク別およびメソッド別の使用状況
応答時間のパーセンタイル（P50/P90/P99）
エラー率と詳細なエラーログ
レート制限されたリクエストの追跡
多重化リクエストおよびヘッジリクエストのメトリクス

エラーコード

Edge はアップストリームプロバイダーからのエラーを正規化します。

コード	意味
-32005	レート制限を超過しました
-32012	範囲が大きすぎます（eth_getLogs）
-32014	データがありません
-32015	ノードがタイムアウトしました
-32016	認証されていません

標準の JSON-RPC エラー（-32700、-32600、-32601、-32602、-32603）と EVM 固有のエラー（-32000、-32003、3）もあります。

対応 RPC メソッド

5 つの名前空間にわたる、標準 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 は、オープンソースのフォールトトレラントな EVM RPC プロキシである eRPC を基盤としています。セルフホスト、カスタムキャッシュドライバー、カスタム選択ポリシー、複数プロバイダーのフェイルオーバーなど、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 スター: 12

問題を報告