Skip to content
Zyper Docs Beta

RPC endpoints

Every onchain operation in Zyper AIO routes through the RPC page’s store. A good RPC list is the single biggest reliability lever you have.

How resolution works

For any chain, the runner builds a URL list in this order:

  1. User-pinned per task — explicit endpoint IDs you attach in the task config.
  2. User-configured for the chain — entries on this page, latency-sorted.
  3. Public defaults — baked into the chain registry as a safety net.

The runner uses the first one that answers and fails over to the next on network errors or revert-during-broadcast cases that hint at endpoint trouble.

Adding an endpoint

  1. Pick the chain in the group list (or + Add Group for a new chain).
  2. Click + Add Endpoint and paste the URL.
  3. The app calls eth_chainId against the URL. If the reply matches the group’s chain, you’ll see a green chip + a latency reading in ms.

If the probe fails or returns the wrong chain ID, the endpoint stays in the list but is marked unhealthy. Tasks will skip it.

Latency tracking

Each endpoint runs a periodic probe (small eth_blockNumber calls). The latency chip updates live. The runner uses latency as the tiebreaker between healthy endpoints — so the fastest one fires first.

How many do I need per chain?

  • Tasks-grade reliability: 2-3 paid endpoints per chain you fire on.
  • Casual minting: 1 paid + the public default is fine.
  • Spam / instant mode: more is better. The pool reuses connections, so there’s no real overhead to listing 5+.

Public RPC override

Per chain, Settings has a “Public RPC override” field. This replaces the chain registry’s built-in default for that chain only — useful if a baked-in public RPC has gone bad and you don’t want to add your own here.

Why pinned endpoints sometimes look filtered out

If you pin an endpoint to a task and the endpoint’s ChainID is 0 (never probed), the runner still uses it — it doesn’t filter unprobed endpoints. A zero chain ID means “we haven’t confirmed yet”, not “wrong chain”.

The chip just won’t be green until the first successful probe.