Skip to content

50% OFF your first payment. Limited time!

Claim your 50% Discount

Start here

Authentication

Four mechanisms, combinable on one key, plus scoping and rotation that does not require a deploy window.

Mechanisms

  • Key in path. /v1/$KEY. Simplest, and fine server side.
  • Bearer token. Authorization: Bearer $TOKEN. Keeps the secret out of URLs, proxy logs and referrer headers.
  • Signed JWT. Short TTL tokens signed with your account key, for browser and agent clients that must not hold a long-lived secret.
  • IP allowlist. CIDR ranges enforced at the edge, before a request reaches a node.
bash
# key in path
curl https://rpc.arcrpc.com/v1/$KEY \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

# bearer token, same endpoint, secret stays out of the URL
curl https://rpc.arcrpc.com/v1 \
  -H "authorization: Bearer $TOKEN" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

Scoping

A key is scoped by network, by method namespace and by residency policy. A read-only key for a public frontend can carry eth_* and arcrpc_getUsdcBalance and nothing else, so a leaked key cannot submit a transaction or drain the allowance with trace_filter.

Rotation

Create the replacement, deploy it, retire the old key. Both are valid during the overlap and rotation is never billed. If a key leaks, mail [email protected] and we revoke immediately.