Skip to content

docs: cover reliable provider workflows#179

Merged
mattsse merged 1 commit into
mainfrom
mattsse/docs-provider-workflows
Jul 16, 2026
Merged

docs: cover reliable provider workflows#179
mattsse merged 1 commit into
mainfrom
mattsse/docs-provider-workflows

Conversation

@mattsse

@mattsse mattsse commented Jul 16, 2026

Copy link
Copy Markdown
Member

Summary

  • compare live subscriptions, JSON-RPC filter polling, and resumable historical streams
  • document canonical block and log streams, reorg handling, pubsub reconnection, and backfill responsibilities
  • separate connection retries, request backoff, endpoint fallback, call timeouts, and transaction confirmation timeouts
  • map optional RPC namespaces to provider extension traits and feature flags, including direct alloy-provider extensions

Why

Provider pages currently explain how to construct HTTP, WebSocket, and IPC clients but stop before production behavior. They do not tell readers how to resume an indexer, handle reorgs, configure retry boundaries, or discover non-eth RPC methods.

Impact

Applications can choose an event-delivery model explicitly, implement gap and reorg recovery, and configure retries without conflating different failure boundaries. The namespace map gives users and agents the exact feature and trait vocabulary needed to find debug, trace, txpool, engine, admin, Anvil, MEV, and other APIs.

@mattsse
mattsse requested a review from grandizzy July 16, 2026 11:07
@mattsse
mattsse force-pushed the mattsse/docs-information-architecture branch from 43e212c to b091bb9 Compare July 16, 2026 14:44
@mattsse
mattsse changed the base branch from mattsse/docs-information-architecture to main July 16, 2026 14:45
@mattsse
mattsse force-pushed the mattsse/docs-provider-workflows branch from be5c376 to e1408e5 Compare July 16, 2026 14:45
@mattsse
mattsse merged commit 8d9c5b1 into main Jul 16, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant