BlockReq
Back to all articles

Rpc Tutorials

Agave 6-week release watch: RPC compat self-check

Fill SOLANA_HTTPS / SOLANA_WSS when the node is ready and run: track Anza’s six-week stable cadence with tip/slot + key program/log diffs, one-page compat checklist (node capability / subscription health). Register for 3M free requests monthly.

BlockReq EngineeringSeptember 11, 20265 min read

Agave 6-week release watch: RPC compat self-check

Anza ships Agave on a six-week stable cadence: RPC providers and apps align tip/slot to the release window and diff key program / log shapes pre/post. This post pre-wires a one-page compat checklist (node capability / subscription health)—browser keeps SOLANA_HTTPS / SOLANA_WSS placeholders; once the node is ready, fill the endpoint into env and run.

Run on the public endpoint · blockreq.com register for 3M free requests monthly.

UseEndpoint (placeholder)
HTTPSprocess.env.SOLANA_HTTPS (fill when the node is ready)
WSSprocess.env.SOLANA_WSS (fill when the node is ready)
PrivateTrailing public{API_KEY} (keys stay local)

Chain: Solana / Agave. Recipe: tip/slot probe → key-program logsSubscribe → pre/post diff card → compat checklist. Browser demo ships UI + sample rows first; swap the real endpoint when ready and keep listening. Public endpoints · Plans · Register.

Hot source: anza_xyz six-week release post. Stack alongside the Changelog filter subscribe line: this post is release-window tip/slot + compat self-check; filters live at Changelog RPC filter subscribe.

1. Hook: watch the six-week beat

Tape feelOn-chain signalWatch
Release-window aligntip / slot crosses release anchortipSlot / releaseTag
Program diffkey program logs pre/postprogramDiff / logDelta
Sub healthlogsSubscribe heartbeat + lagsubLag / lastPushTs
Endpoint swapenv swap → keep listeningfill SOLANA_WSS and run

Feel: one beat every six weeks—pre-wire tip/slot plus key program diffs into a one-page checklist so the release window paints compat cards as soon as it opens.

2. Event: tip/slot + program/log diffs

Keep SOLANA_HTTPS / SOLANA_WSS / WATCH_PROGRAMS / RELEASE_ANCHOR_SLOT / COMPAT_CHECKS in env. When the node is ready, change the endpoint only—the probes and subscribe body stay the same.

Step A · Tip/slot probe

{
  "jsonrpc": "2.0", "id": 1, "method": "getSlot",
  "params": [{ "commitment": "confirmed" }]
}
  • HTTPS poll getSlot / getLatestBlockhash → write tipSlot / tipHash.
  • RELEASE_ANCHOR_SLOT = editable release-window anchor; tipSlot ≥ anchor → enter post window and flip the diff baseline.

Step B · Key-program logsSubscribe

{
  "jsonrpc": "2.0", "id": 2, "method": "logsSubscribe",
  "params": [
    { "mentions": ["WATCH_PROGRAMS"] },
    { "commitment": "confirmed" }
  ]
}
  • mentions = process.env.WATCH_PROGRAMS (editable key-program table).
  • Accumulate log fingerprints in the pre window; compare the same fingerprints post → programDiff / logDelta.
  • HTTPS getTransaction (encoding: "jsonParsed") fills instruction names and account diffs.

Step C · One-page compat checklist

COMPAT_CHECKS = [
  nodeCapability   → getVersion / getHealth shape OK
  tipAligned       → tipSlot tracked vs RELEASE_ANCHOR_SLOT
  subHealthy       → logsSubscribe lag within budget
  programDiffReady → pre/post fingerprints written
]
hit = all checks green  →  write compatState

Compat-card fields:

{ pad: "agave-compat", releaseTag, tipSlot, programDiff, subLag, checks, ts }

Dedupe on releaseTag / tipSlot; merge repeat pushes inside the same window.

3. Browser demo

Connect the SOLANA_WSS placeholder, fill WATCH_PROGRAMS + RELEASE_ANCHOR_SLOT + COMPAT_CHECKS, hit Start: UI streams sample tip/slot and pre/post diff rows beside the checklist; once the node is ready, swap the real endpoint and the same probes keep listening.

:::pages-demo https://blockreq.com/demos1/anza-agave-rpc-compat-watch/en/ title: Agave 6-week RPC compat watch height: 520 :::

env  → SOLANA_HTTPS · SOLANA_WSS · WATCH_PROGRAMS · RELEASE_ANCHOR_SLOT · COMPAT_CHECKS
WSS  → process.env.SOLANA_WSS
HTTPS→ process.env.SOLANA_HTTPS

Paths: /demos1/anza-agave-rpc-compat-watch/zh/ · /demos1/anza-agave-rpc-compat-watch/en/. For keyed: swap trailing public for {API_KEY}.

Quota: blockreq.com register for 3M free requests monthly.

4. Alert rhythm

  1. tip/slot crosses anchor → flip post window, outbound Agave release · tag=… · tip=….
  2. program/log diff ready → stack programDiff chip.
  3. Compat checklist all green → outbound compat OK · checks=… · lag=….
  4. Dedupe → one push per releaseTag / tipSlot.

On disconnect: reconnect and re-logsSubscribe; gap-fill with HTTPS getSlot + getSignaturesForAddress + getTransaction by slot range. POST → process.env.SOLANA_HTTPS.

5. Summary + CTA

  1. Grain: six-week watch = tip/slot align + key program/log diffs + compat checklist.
  2. Recipe: SOLANA_WSS + WATCH_PROGRAMS + RELEASE_ANCHOR_SLOT + COMPAT_CHECKS → compat card.
  3. Runnable: browser pre-wired with placeholders + sample rows; once the node is ready, fill the endpoint into env and run.
  4. Start: Public endpoints + blockreq.com register for 3M free requests monthly.

Next: pin the release-anchor table → webhook → stack beside Changelog filter subscribe. Docs · Pricing · Register.