Skip to content

feat(transactions): add EIP-2718 envelope examples - #255

Merged
mattsse merged 2 commits into
mainfrom
mattsse/transaction-envelope-guide
Jul 26, 2026
Merged

feat(transactions): add EIP-2718 envelope examples#255
mattsse merged 2 commits into
mainfrom
mattsse/transaction-envelope-guide

Conversation

@mattsse

@mattsse mattsse commented Jul 26, 2026

Copy link
Copy Markdown
Member

Summary

  • replace the narrow EIP-1559 sample with TxEnvelope round trips for legacy, EIP-2930, EIP-1559, EIP-4844, and EIP-7702 transactions
  • demonstrate extracting a consensus envelope from an Ethereum JSON-RPC transaction response, recovering its signer, reading its hash, and using both EIP-2718 encoding APIs
  • add ReceiptEnvelope round trips for every supported Ethereum receipt variant and register both examples in the catalog

Why

Issue #44 remained only partially addressed: the existing example constructed one EIP-1559 transaction but did not demonstrate EIP-2718 encoding, decoding, RPC conversion, or receipt envelopes. These examples make the envelope-first workflow explicit and runnable offline.

Closes #44

@mattsse
mattsse merged commit 4e58c21 into main Jul 26, 2026
6 checks passed
@github-project-automation github-project-automation Bot moved this to Done in Alloy Jul 26, 2026
mattsse added a commit to alloy-rs/docs that referenced this pull request Jul 26, 2026
## Summary

- add a task-focused EIP-2718 guide covering representation boundaries,
current Ethereum type bytes, exact and streaming decoders, RPC
conversion, hashes, signer recovery, receipt envelopes, and blob
sidecars
- sync generated runnable pages and snippets for the new transaction and
receipt envelope examples
- update navigation and the examples submodule to the examples PR commit

## Why

The docs previously mentioned `TxEnvelope` and `ReceiptEnvelope` only
incidentally, leaving no end-to-end guide for alloy-rs/examples#44. This
guide makes the envelope-first workflow explicit and points readers to
verified offline examples.

Depends on alloy-rs/examples#255.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

[Transactions]: Show encoding and decoding of various tx types.

1 participant