Skip to content

docs: cover protocol types and PeerDAS#181

Merged
mattsse merged 1 commit into
mainfrom
mattsse/docs-protocol-reference
Jul 16, 2026
Merged

docs: cover protocol types and PeerDAS#181
mattsse merged 1 commit into
mainfrom
mattsse/docs-protocol-reference

Conversation

@mattsse

@mattsse mattsse commented Jul 16, 2026

Copy link
Copy Markdown
Member

Summary

  • map primitives, consensus, EIP, network, RPC, genesis, trie, and serde types to their intended boundaries
  • explain how RPC responses embed consensus values and which conversions preserve or discard metadata
  • document network-associated types, chain-specific implementations, persistence choices, and constrained builds
  • add EIP-7594 PeerDAS sidecar coverage to the transaction guide and navigation

Why

The site documents primitives and provider calls but does not explain the protocol and data-model crates that make up much of Alloy. Users must infer when to use consensus versus RPC types, how Network changes associated types, and where genesis, trie, and serialization helpers fit. The examples include EIP-7594, but the transaction guide omits it.

Impact

Infrastructure and library authors get a boundary-oriented type map instead of a crate-name inventory. Application developers can convert RPC responses without JSON round trips and select the correct network representation. PeerDAS users can find the existing runnable flow and its node, fork, and KZG requirements.

@mattsse
mattsse requested a review from grandizzy July 16, 2026 11:13
@mattsse
mattsse force-pushed the mattsse/docs-signers-testing branch from 2296818 to 8df17bb Compare July 16, 2026 14:46
@mattsse
mattsse changed the base branch from mattsse/docs-signers-testing to main July 16, 2026 14:48
@mattsse
mattsse force-pushed the mattsse/docs-protocol-reference branch from bd5b4bd to a40f25c Compare July 16, 2026 14:48
@mattsse
mattsse merged commit df0a839 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