NodeCache EVM Documentation

What is NodeCache EVM?

NodeCache sits in front of a real upstream RPC provider (Ethereum mainnet today) and caches successful responses per-method, with a TTL matched to how fast each method's answer actually goes stale — eth_chainId is cached for an hour since it never changes, eth_blockNumber for a few seconds since it changes constantly.

It's read-only by design: writes (transactions) aren't cached or proxied specially — send those to your RPC provider directly. NodeCache is for the read traffic that dominates most dApp and backend workloads.

Sign Up (Free)

Getting started takes under a minute — no password required:

Step 1: Click "Try Free Tier"

On oculix.io, click "Try Free Tier" or "Get Started" to open the signup form.

Step 2: Enter Your Name and Email

No credit card, no password. Just your name and email.

Step 3: Verify Your Email

We'll send a verification link to your inbox. Click it to activate your account — no password to set.

Step 4: Copy Your API Key

Your key is shown once on the verification page — copy it right away. Use it as the x-api-key header on every request.

Your First Cached Query

You can also just use the live widget below instead of calling the API directly.

Step 1: The Request Shape

NodeCache isn't a transparent RPC URL swap — it's a POST endpoint that wraps a standard JSON-RPC call. Send the method and params exactly as you would to any EVM RPC provider:

curl -X POST https://nodecache-api-885208777871.us-central1.run.app/v1/rpc-edge \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": 1
  }'
    

Step 2: The Response

Same JSON-RPC envelope back, plus a cached flag so you can see whether it was served from cache or forwarded upstream:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x1862e29",
  "cached": false
}
    

Step 3: Call It Again

Send the exact same request again within the method's TTL window (a few seconds for eth_blockNumber) and you'll get "cached": true back — no upstream call made, no latency hit.

Supported Chains

Ethereum mainnet today. Other EVM chains are on the roadmap — not live yet.

Pricing

Plan	Cached Requests/Month	Cost	Best For
Free	100,000	$0	Testing, small dApps
Developer	2,000,000	$49/month	Production dApps
Scale	20,000,000	$199/month	High-traffic applications

FAQ

Q: Does NodeCache modify blockchain state?

A: No. NodeCache is read-only. It caches only query responses (balances, contract state, block numbers, etc.). Send writes (transactions) directly to your RPC provider.

Q: What if the cache is stale?

A: Each method has its own TTL matched to how fast its answer actually changes — see the request/response example above. For critical queries requiring the absolute latest data, call your RPC provider directly instead.

Q: Can I use NodeCache for contract calls?

A: Yes — any read-only JSON-RPC method (eth_call, eth_getBalance, eth_getCode, eth_getLogs, and more) is cached the same way. State-changing methods aren't proxied specially.

Q: What happens if the upstream RPC provider is down?

A: A cache miss during a provider outage returns a 502 with the upstream error detail — NodeCache doesn't fail over to a backup provider automatically today.

Q: How do I monitor usage?

A: Call GET /v1/usage on the auth service with your x-api-key header — it returns your remaining quota plus a call-count breakdown by endpoint. A full self-serve dashboard (cache hit rate, cost savings) is still on the roadmap.

Troubleshooting

Q: "Unauthorized" Error

A: Re-copy the key from your original verification email — it's only shown once and there's no Settings page to view it again yet.

Q: How Do I Update My API Key?

A: Key rotation isn't self-serve yet — contact support to have your key reissued.

Next Steps

Multi-chain support: on the roadmap — not live yet. Ethereum mainnet only today.
Usage tracking: a self-serve usage dashboard is planned but not live yet — contact support if you need your current usage.
Upgrade to Developer or Scale tier when you're ready to move past the free tier.

Ready to try it? Start with 100,000 free cached requests/month. No credit card. Upgrade when you're ready.

Subscribe: Growth $49/mo → Subscribe: Scale $199/mo →

← Back to Home

⚙️ NodeCache EVM Getting Started