Dune Echo Proxy

This repo hosts a one-click-deploy Cloudflare worker that proxies requests to Dune Echo. The proxy will allow you to keep your API key hidden from public requests made by clients. You will need both a Dune account and a Cloudflare account to deploy this. Dune offers 10RPS for free, and Cloudflare workers can execute 100k invocations each day for free. Most projects can easily get started within these free tiers.

Setup

Step 1

Press the button below to deploy this to your own Cloudflare account:

Step 2

Navigate to your newly deployed worker, and click "Settings" and then "Variables":

Step 3

Add a new variable with the key name DUNE_API_KEY and your Dune API key as the value:

NOTE: We recommend selecting "Encrypt". This will hide your key from the UI and API responses, and redact them from logs.

Step 4

Refresh the page and confirm that your key is now saved and encrypted:

You can now use your worker URL as an the base Dune API endpoint in all SDK and client side configurations without your API key leaking!

Additional Security Steps

This implementation is intentionally left in a less-than-ideal security state to facilitate easy deployment by anyone. If you would like to lock down your Dune Echo Proxy further, consider the following steps after you have successfully deployed the worker:

• Update the Access-Control-Allow-Origin header by adding a new variable with the key name CORS_ALLOW_ORIGIN to contain the host that your requests are coming from (usually your client application). For example, if you wanted to allow requests from https://example.com, you would change the header to https://example.com. To support multiple domains, set CORS_ALLOW_ORIGIN to a comma separated list of domains (e.g. https://example.com,https://beta.example.com).
• Cloudflare Web Application Firewall (WAF) - You can configure the WAF to inspect requests and allow/deny based on your own business logic.