Skip to main content
Most JSON-RPC providers embed the API key in the URL path. GoldRush uses an Authorization header instead, so keys never appear in URLs, server logs, or screenshots. This means migrating involves two steps:
  1. Swap the URL.
  2. Add the Authorization: Bearer <key> header.
Below are concrete diffs for the most common providers.

​
From Infura

- https://mainnet.infura.io/v3/{INFURA_PROJECT_ID}
+ https://rpc.goldrushdata.com/v1/eth-mainnet

+ Authorization: Bearer <GOLDRUSH_API_KEY>
For libraries that take a URL string only, you’ll need to switch to the custom-headers pattern: 
const provider = new ethers.JsonRpcProvider(
  `https://mainnet.infura.io/v3/${process.env.INFURA_PROJECT_ID}`
);

​
From Alchemy

Alchemy embeds the API key at the end of the URL path: 
- https://eth-mainnet.g.alchemy.com/v2/{ALCHEMY_API_KEY}
+ https://rpc.goldrushdata.com/v1/eth-mainnet

+ Authorization: Bearer <GOLDRUSH_API_KEY>
debug_* and trace_* continue to work. See debug and trace for the per-chain support matrix.

​
From Ankr

- https://rpc.ankr.com/eth/{ANKR_API_KEY}
+ https://rpc.goldrushdata.com/v1/eth-mainnet

+ Authorization: Bearer <GOLDRUSH_API_KEY>

​
Chain slug mapping

Most providers use short chain names. GoldRush uses the canonical chain slugs from the supported chains list.
Common nameInfura/QuickNode subdomainGoldRush slug
Ethereummainneteth-mainnet
Polygonpolygon-mainnetmatic-mainnet
BNB Smart Chainbnb-mainnetbsc-mainnet
Arbitrumarb-mainnetarbitrum-mainnet
Basebase-mainnetbase-mainnet
HyperEVMn/ahyperevm-mainnet
MegaETHn/amegaeth-mainnet
Monadn/amonad-mainnet
Tempon/atempo-mainnet

​
Provider extensions are not supported

GoldRush JSON-RPC implements the standard eth_*, net_*, web3_*, debug_*, and trace_* methods. Provider-specific extensions are intentionally not supported:
Extension namespaceProviderGoldRush equivalent
qn_*QuickNodeFoundational API
Token balance / transfer enrichmentvariousFoundational API: token balances and transfers
bor_*Polygon (Bor)n/a
If you depend on a provider extension, use the GoldRush Foundational API (decoded, typed REST) or the Streaming API (real-time event streams) instead.

Authentication

Header reference and per-library setup.

Quickstart

Copy-paste examples for every library.