Skip to main content
This quickstart configures one upstream, makes an eligible historical read, and confirms whether Boost or your provider answered.

Prerequisites

A verified Goldsky organization has at least one Owner, Admin, or Editor whose email uses a company domain. Generic email providers such as Gmail, Outlook, and Proton Mail do not qualify. Verification is required to use Boost.
1

Configure an upstream

Open Boost in the dashboard. Choose one of two setup paths:
  • Connect a QuickNode, Alchemy, Chainstack, or dRPC account. Boost creates dedicated resources in QuickNode, Alchemy, and Chainstack; with dRPC, it uses an unrestricted key already in your account.
  • Paste an HTTPS RPC URL and any authentication headers it needs.
Enabling Boost creates one Boost API key for the project. Copy it from the Boost dashboard; the same key works across every network you enable.
Run the interactive configuration flow:
The setup wizard asks for a provider account, its management credential, and the networks to enable. See the goldsky boost CLI reference for non-interactive provider and endpoint management commands.
2

Make an eligible historical read

Boost endpoints use this format:
Use a network name or chain ID. For example, /boost/ethereum and /boost/1 identify the same network.Enter your key, choose a network, and copy the generated command:
The first request for a range that has not been served recently can return x-cache: MISS while Boost warms the reader from storage. Run the request again before treating the method as ineligible.
3

Confirm who answered

Include -i in the curl request so the response headers are visible. A single request served by Boost looks like this:
x-edge-billable is the number of request items Boost served. The name predates Boost’s early-access pricing; it is a count, not a charge.
4

Compare a forwarded request

Make a state read at latest, which remains with your provider:
A forwarded response includes:

Update an existing client

Change the transport URL and send all your requests through Boost. The rest of the client configuration stays the same.

Next steps

Understand routing

Check method eligibility, block-tag behavior, and batch semantics.

Measure served requests

Count served and forwarded requests from response headers.