From 2111df1ee52e45c56732600de8b18b26e04cb69c Mon Sep 17 00:00:00 2001 From: Andreas Bigger Date: Fri, 9 Jan 2026 18:23:19 -0500 Subject: [PATCH 1/4] chore(workspace): move spec into docs/ --- crates/client/flashblocks/spec.md => docs/flashblocks.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename crates/client/flashblocks/spec.md => docs/flashblocks.md (100%) diff --git a/crates/client/flashblocks/spec.md b/docs/flashblocks.md similarity index 100% rename from crates/client/flashblocks/spec.md rename to docs/flashblocks.md From 4e5aa7e8bc5e1cb18b408eaee489f134c5a4c709 Mon Sep 17 00:00:00 2001 From: Andreas Bigger Date: Fri, 9 Jan 2026 18:24:39 -0500 Subject: [PATCH 2/4] chore(docs): cleanup layout --- docs/README.md | 6 ++++++ docs/{ => specs}/flashblocks.md | 0 2 files changed, 6 insertions(+) create mode 100644 docs/README.md rename docs/{ => specs}/flashblocks.md (100%) diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 00000000..f104ca6c --- /dev/null +++ b/docs/README.md @@ -0,0 +1,6 @@ +## Documents + +### Specs + +- [Flashblocks Spec](./specs/flashblocks.md) + diff --git a/docs/flashblocks.md b/docs/specs/flashblocks.md similarity index 100% rename from docs/flashblocks.md rename to docs/specs/flashblocks.md From c6b54139a8b758a4872ceb9209db10c4055261f9 Mon Sep 17 00:00:00 2001 From: Andreas Bigger Date: Fri, 9 Jan 2026 18:31:36 -0500 Subject: [PATCH 3/4] chore(docs): move access-lists spec --- crates/shared/access-lists/README.md | 2 ++ docs/README.md | 1 + .../shared/access-lists/SPEC.md => docs/specs/access-lists.md | 0 3 files changed, 3 insertions(+) rename crates/shared/access-lists/SPEC.md => docs/specs/access-lists.md (100%) diff --git a/crates/shared/access-lists/README.md b/crates/shared/access-lists/README.md index 8366c9b8..8a6a22dc 100644 --- a/crates/shared/access-lists/README.md +++ b/crates/shared/access-lists/README.md @@ -2,6 +2,8 @@ A library to build and process Flashblock-level Access Lists (FBALs). +See the [spec](https://github.com/base/node-reth/blob/main/docs/specs/access-lists.md) for more details. + ## Overview This crate provides types and utilities for tracking account and storage changes during EVM transaction execution, producing access lists that can be used by downstream consumers to understand exactly what state was read or modified. diff --git a/docs/README.md b/docs/README.md index f104ca6c..104027bb 100644 --- a/docs/README.md +++ b/docs/README.md @@ -2,5 +2,6 @@ ### Specs +- [Access Lists Spec](./specs/access-lists.md) - [Flashblocks Spec](./specs/flashblocks.md) diff --git a/crates/shared/access-lists/SPEC.md b/docs/specs/access-lists.md similarity index 100% rename from crates/shared/access-lists/SPEC.md rename to docs/specs/access-lists.md From 8fce426135271d465143db4b94c7c57632273a78 Mon Sep 17 00:00:00 2001 From: Andreas Bigger Date: Fri, 9 Jan 2026 19:31:50 -0500 Subject: [PATCH 4/4] fix(docs): use relative path for access-lists spec link Update the spec link in access-lists README to use a relative path instead of an absolute GitHub URL, fixing the lychee link check. --- crates/shared/access-lists/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/crates/shared/access-lists/README.md b/crates/shared/access-lists/README.md index 8a6a22dc..19021b79 100644 --- a/crates/shared/access-lists/README.md +++ b/crates/shared/access-lists/README.md @@ -2,7 +2,7 @@ A library to build and process Flashblock-level Access Lists (FBALs). -See the [spec](https://github.com/base/node-reth/blob/main/docs/specs/access-lists.md) for more details. +See the [spec](../../../docs/specs/access-lists.md) for more details. ## Overview