Reference Implementation
A living record of building EIP-8141 "Frame Transaction" support into EthereumJS — from first read of the spec to working code.
Reference implementation documentation — from the EthereumJS team, powered by Feel Your Protocol.
🤖 Beep Boop — You Are Reading AI-Generated Documentation
These docs are fully AI-generated as part of an experimental human-AI collaboration workflow. A human (@hdrewes) steers the ship and reviews the output, but the actual prose, analysis, and structure you see here were produced by an AI assistant.
This means:
Think of this as a live lab notebook, not a polished reference manual. You have been warned. 🧪
📌 EIP Version Reference
This documentation and implementation are based on EIP-8141 as of commit ee66073 (March 13, 2026).
Snapshot link: EIP-8141 at ee66073
The EIP is in Draft status and evolving quickly. If you're reading this and the spec has moved on, some of our analysis may be outdated. We will update as we go, but check the commit hash above against the latest version to gauge how current things are.
This documentation accompanies the EIP-8141 "Frame Transaction" reference implementation in the EthereumJS monorepo, built as a Feel Your Protocol project.
EIP-8141 introduces a fundamentally new transaction type for Ethereum — one where validation, execution, and gas payment are no longer hard-wired to a single ECDSA signature but can be defined abstractly through EVM code. This is a big deal: it realizes the original vision of account abstraction and opens a native path toward post-quantum security.
The EIP is in an early draft stage. The spec is extensive, introduces several new concepts (frames, approval scopes, new opcodes, default code for EOAs), and touches multiple layers of the protocol stack. Building a reference implementation at this stage is not just about writing code — it is about stress-testing the spec itself.
This documentation serves multiple audiences:
| Section | What you'll find |
|---|---|
| Spec Overview | A structured walkthrough of EIP-8141, broken into digestible pieces — transaction structure, frame modes, new opcodes, execution flow, gas model. |
| Implementation Journal | Chronological notes from the implementation effort — what we worked on, what questions came up, what we learned. |
| Design Decisions | The architectural and design choices we made, with rationale and discussion of alternatives. |
| Spec Feedback | Our assessment of the spec's clarity, completeness, protocol alignment, and strategic fit within the Ethereum roadmap. |
Living Document
These docs are updated continuously as the implementation progresses. Check back for new journal entries, updated feedback, and refined analysis.