Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
3446b64
ci,op-deployer: publish release binaries from GitHub Actions (#23907)
sebastianst Nov 5, 2026
9931ba2
ci,op-deployer,op-up: remove goreleaser and op-up releases (#23914)
sebastianst Nov 5, 2026
be2667d
release-notes: tag PRs that change go:embed'ed files as LINKED (#23949)
sebastianst Nov 5, 2026
98c789c
Fix translation drift (#23950)
mintlify[bot] Nov 5, 2026
4056e1b
rust: use underscore lint names in workspace lint tables (#23955)
Inphi Nov 5, 2026
50115fa
ci: pin SOURCE_DATE_EPOCH for sccache and drop rust-binaries-for-sysg…
mds1 Nov 5, 2026
b8492fd
contracts-bedrock: Use the real ETHLiquidity balance in tests and doc…
ajsutton Nov 5, 2026
fdf142b
op-reth: keep endpoint.up on out-of-scope interop filter answers (#23…
sebastianst Nov 6, 2026
4ebd27f
contracts-bedrock: compare the messenger balance to its start in rela…
nonsense Nov 6, 2026
4617ee2
op-core/superchain,op-node: carry genesis system config params from t…
donoso-eth Nov 6, 2026
a71a7db
op-deployer: run the forge package tests in CI (#23643)
nonsense Nov 6, 2026
446b187
op-acceptance-tests: run each test in its own go test (#23974)
mds1 Nov 6, 2026
c8473ba
op-deployer: add a hidden receipt poll interval and use 50ms in integ…
mds1 Nov 6, 2026
c88c904
op-deployer: deploy OP Private private chains on their settlement cha…
karlfloersch Nov 6, 2026
fa3efe5
op-node,op-deployer,kona: add settlement_chain_id to the rollup confi…
karlfloersch Nov 6, 2026
0fb0ffb
ci: run 32 fault-proof tests at once in op-e2e-cannon-tests (#23985)
mds1 Nov 8, 2026
34625bb
kona-gossip: make block timestamp bound tests clock-safe (#23981)
teddyknox Nov 8, 2026
969931c
op-reth: test that pool admission and the payload builder agree (#23994)
geoknee Nov 9, 2026
5d7d3e9
Merge op-reth/v2.8.2 into release/op-reth-2.x
Nov 10, 2026
3e9cd4b
Refresh ACTIVATIONS.md for op-reth v2.8.2
Nov 10, 2026
03770f3
Pin reth and alloy-evm by commit
Nov 10, 2026
f69d24d
Add the op-reth-v2.8.2-fh3.1 changelog entry
Nov 10, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 0 additions & 5 deletions .circleci/continue/helpers.yml
Original file line number Diff line number Diff line change
Expand Up @@ -195,15 +195,10 @@ commands:
mise-cache-checksum:
type: string
default: '{{ checksum "mise.toml" }}'
fresh-install:
description: Skip every mise cache and install mise and all tools fresh. See install-mise's fresh_install.
type: boolean
default: false
steps:
- github-checkout:
method: << parameters.checkout-method >>
- utils/install-mise:
enable_mise_cache: << parameters.enable-mise-cache >>
mise_cache_key_prefix: << parameters.mise-cache-key-prefix >>
mise_cache_checksum: << parameters.mise-cache-checksum >>
fresh_install: << parameters.fresh-install >>
310 changes: 82 additions & 228 deletions .circleci/continue/main.yml

Large diffs are not rendered by default.

24 changes: 19 additions & 5 deletions .claude/skills/release-notes/scripts/pr-facts.sh
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,8 @@
# Output, one row per PR in draft order, tab-separated:
# <tag> #<number> <author> <n> files <title> <paths>
#
# LINKED changed a package compiled into one of the component's binaries; <paths> lists
# LINKED changed a package compiled into one of the component's binaries, or a file such
# a package embeds (//go:embed); <paths> lists
# just those packages — that is the reason the PR may belong in the notes
# CONFIG moved the embedded superchain registry (submodule pin, generated archive
# checksum, or kona's registry snapshots); read it by hand, a new activation time
Expand Down Expand Up @@ -53,20 +54,28 @@ trap 'rm -rf "$workdir"' EXIT
: > "$workdir/deps"
: > "$workdir/pkgmap"
: > "$workdir/scripts"
: > "$workdir/embeds"
have_go=0
have_rust=0
contracts=0

# --- dependency sets -------------------------------------------------------------------
# Which units of code end up in the component's binaries. Empty leaves every row tagged '?'.

# The first of <targets> whose dependency set is non-empty.
# The first of <targets> whose dependency set is non-empty. Also records the files those
# packages embed (//go:embed) in $workdir/embeds as "<path>\t<package dir>": they ship in
# the binary without being Go source.
resolve_go() {
local out=$1 target
shift
for target in "$@"; do
if (cd "$root" && go list -deps "$target" 2> /dev/null) \
| sed -n "s|^$MODULE/||p" | sort -u > "$out" && [ -s "$out" ]; then
if (cd "$root" && go list -deps \
-f '{{.ImportPath}}{{range .EmbedFiles}}{{"\n"}}embed {{$.ImportPath}} {{.}}{{end}}' \
"$target" 2> /dev/null) > "$workdir/golist" \
&& sed -n "s|^$MODULE/||p" "$workdir/golist" | sort -u > "$out" && [ -s "$out" ]; then
awk -v m="$MODULE/" '$1 == "embed" && index($2, m) == 1 {
d = substr($2, length(m) + 1); print d "/" $3 "\t" d
}' "$workdir/golist" >> "$workdir/embeds"
return 0
fi
done
Expand Down Expand Up @@ -236,12 +245,16 @@ fi
xargs -P "$JOBS" -n 2 bash -c 'fetch "$0" "$1"' < "$workdir/work"

for f in "$workdir"/pr-*; do
awk -F'\t' -v depfile="$workdir/deps" -v pkgfile="$workdir/pkgmap" \
awk -F'\t' -v depfile="$workdir/deps" -v pkgfile="$workdir/pkgmap" -v embedfile="$workdir/embeds" \
-v scriptfile="$workdir/scripts" -v have_go="$have_go" -v have_rust="$have_rust" \
-v contracts="$contracts" '
BEGIN {
while ((getline dep < depfile) > 0) linked[dep] = 1
while ((getline line < scriptfile) > 0) scripts[line] = 1
while ((getline line < embedfile) > 0) {
split(line, kv, "\t")
embedded[kv[1]] = kv[2]
}
while ((getline line < pkgfile) > 0) {
split(line, kv, "\t")
pkgdir[kv[1]] = kv[2]
Expand Down Expand Up @@ -285,6 +298,7 @@ for f in "$workdir"/pr-*; do
}
}
if (have_go == 1) {
if (path in embedded) return embedded[path]
# Test files are not compiled into the binary, so a PR that only adds
# coverage to a linked package does not change what ships.
if (path !~ /\.go$/ || path ~ /_test\.go$/) return ""
Expand Down
54 changes: 54 additions & 0 deletions .dev/todo/update-to-op-reth-v2.8.2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
# op-reth bump to upstream `op-reth/v2.8.2` (op-reth-v2.8.2-fh3.1)

## Branch layout

- `release/op-reth-2.x` at `op-reth-v2.8.1-fh3.1` (`05c87505`). Work branch: `bump/op-reth-2.8.2`.
- `op-reth/v2.8.1` is an ancestor of `op-reth/v2.8.2`: 18 upstream commits, merged with no
conflicts.
- Tag `op-reth-v2.8.2-fh3.1`: the newest tag on the branch with its upstream version replaced.
The Firehose block model is unchanged, so `fh3.1` stays.

## Dependencies

Upstream changes no reth, revm, alloy-evm or op-alloy version in this range (`rust/Cargo.lock`
only gains test dependencies), so neither `streamingfast/reth` nor `streamingfast/evm` needs a
new release.

The reth and `alloy-evm` pins move from tags to the commits they point to, with the tag in a
comment:
- `streamingfast/reth` `op-reth-v2.8.1-fh3.1` -> `93fb772a` (the merge commit of reth#90). The
lock used to resolve the PR head `1d4c8b49`; both commits have the same tree.
- `streamingfast/evm` `v0.39.0-sf` -> `52afebec` (unchanged commit).
- `firehose-tracer` stays on 5.5.0.

Nothing else in StreamingFast pins this fork except the sf-operator deployment.

## Upstream changes that touch op-reth

- `fdf142b5` interop filter metrics: `endpoint.up` stays up on `-321100` answers. Transaction
pool only.
- `969931cd` and the gas limit commits: `OpGasLimitConfig` moves from `reth-optimism-payload` to
`reth-optimism-txpool` (re-exported from the payload crate) and is shared with the pool, which
now rejects transactions above the operator gas limit and starts with the chain's block gas
limit. Pool and payload builder only; the Firehose code does not use `OpGasLimitConfig`.
- `L1_BLOCK_JOVIAN_SELECTOR` becomes `pub`. No behavior change.
- kona changes (`settlement_chain_id` in the rollup config, gossip test) are outside the op-reth
binary.

## Firehose bug patterns

1. Serial order: none found. No change to block execution, prewarming or the engine validator.
2. Emission after acceptance: none found. No new header field or post-execution check.
3. Activations: no `OpHardfork` added, `superchain-registry` stays at `13907b9b`, and
`alloy-op-hardforks` is unchanged, so no timestamp moved. Lagoon is still unscheduled in the
code but Optimism now targets mid-December 2026 for OP Mainnet and Unichain; the `0x7D`
post-exec transaction is still unsupported by `firehose-tracer` 5.5.0 and the reth mapper
(`ACTIVATIONS.md`).
4. Fields and enums: `OpTxEnvelope`, `OpTxType`, `OpReceipt` and the header are unchanged.
`op-revm` and the fee vault formulas are unchanged.
5. Transactions without a hash: not affected.

## Status

- Merge, CHANGELOG, ACTIVATIONS refresh: done.
- Build, unit tests, Battlefield: see the PR description.
186 changes: 186 additions & 0 deletions .github/workflows/release-op-deployer.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,186 @@
# Builds the op-deployer binaries for a tag and attaches them to a draft GitHub release, which a
# release manager publishes after adding the notes. Releases are immutable once published, so the
# assets must be in place first. netchef and the superchain-registry download these assets by name.
#
# A tag push only runs this workflow if the tagged commit contains it. For any other tag, dispatch
# it from develop: the workflow then comes from develop and the source from the tag, so the build
# may only use just recipes and tools that also exist on that tag.
name: release-op-deployer

on:
push:
tags:
- "op-deployer/v*"
workflow_dispatch:
inputs:
tag:
description: Existing tag to release, e.g. op-deployer/v1.2.3-rc.1
required: true
type: string

permissions: {}

concurrency:
group: ${{ github.workflow }}-${{ inputs.tag || github.ref_name }}
cancel-in-progress: false

env:
TAG: ${{ inputs.tag || github.ref_name }}

jobs:
build:
runs-on: ubuntu-24.04
timeout-minutes: 45
permissions:
contents: read
outputs:
version: ${{ steps.version.outputs.version }}
steps:
- name: Harden the runner
uses: step-security/harden-runner@9af89fc71515a100421586dfdb3dc9c984fbf411 # v2.19.4
with:
egress-policy: audit

- name: Check the tag
id: version
shell: bash
run: |
set -euo pipefail
if [[ ! "$TAG" =~ ^op-deployer/v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.-]+)?$ ]]; then
echo "::error::The tag is not op-deployer/vMAJOR.MINOR.PATCH[-PRERELEASE]."
exit 1
fi
echo "version=${TAG#op-deployer/v}" >> "$GITHUB_OUTPUT"

- name: Checkout
uses: actions/checkout@71cf2267d89c5cb81562390fa70a37fa40b1305e # v6
with:
ref: refs/tags/${{ env.TAG }}
submodules: recursive
persist-credentials: false

# No cache anywhere in this job: the release must depend only on the tagged source.
- name: Install tools
uses: jdx/mise-action@c1ecc8f748cd28cdeabf76dab3cccde4ce692fe4 # v4.0.0
with:
version: 2026.10.21
install_args: go just forge jq yq
cache: false

- name: Build contracts
working-directory: packages/contracts-bedrock
env:
FOUNDRY_PROFILE: ci
run: just forge-build --skip test

- name: Pack the embedded contract artifacts
working-directory: op-deployer
run: just copy-contract-artifacts

- name: Build the superchain bundle
run: just build-superchain-go

- name: Build the release assets
shell: bash
env:
VERSION: ${{ steps.version.outputs.version }}
run: |
set -euo pipefail
commit=$(git rev-parse HEAD)
commit_time=$(git show -s --format=%ct)
commit_date=$(TZ=UTC git show -s --date=format-local:%Y-%m-%dT%H:%M:%SZ --format=%cd)
version_pkg=github.com/ethereum-optimism/optimism/op-deployer/pkg/deployer/version
ldflags="-X $version_pkg.GitCommit=$commit -X $version_pkg.GitDate=$commit_date -X $version_pkg.Version=$VERSION -X $version_pkg.Meta="

mkdir dist
for target in linux/amd64 linux/arm64 darwin/amd64 darwin/arm64 windows/amd64; do
os=${target%/*}
arch=${target#*/}
name=op-deployer-$VERSION-$os-$arch
binary=op-deployer
if [ "$os" = windows ]; then
binary=op-deployer.exe
fi

mkdir "dist/$name"
CGO_ENABLED=0 GOOS=$os GOARCH=$arch go build -trimpath -ldflags "$ldflags" \
-o "dist/$name/$binary" ./op-deployer/cmd/op-deployer
cp op-deployer/README.md "dist/$name/"
chmod 755 "dist/$name/$binary"
chmod 644 "dist/$name/README.md"
touch -d "@$commit_time" "dist/$name"/*

if [ "$os" = windows ]; then
(cd dist && zip -qX "$name.zip" "$name/README.md" "$name/$binary")
else
tar -C dist --owner=0 --group=0 --numeric-owner -cf - "$name/README.md" "$name/$binary" \
| gzip -n > "dist/$name.tar.gz"
fi
done

"dist/op-deployer-$VERSION-linux-amd64/op-deployer" --version | grep -F "$VERSION-${commit:0:8}-"

rm -r dist/op-deployer-*/
(cd dist && sha256sum ./*.tar.gz ./*.zip | sed 's# \./# #' > "op-deployer_${VERSION}_checksums.txt")

- name: Upload the release assets
uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
with:
name: release-assets
path: dist/
if-no-files-found: error
retention-days: 7

# Holds the write token, so it must not check out or run any repository code.
publish:
needs: build
runs-on: ubuntu-24.04
timeout-minutes: 10
permissions:
contents: write
steps:
- name: Harden the runner
uses: step-security/harden-runner@9af89fc71515a100421586dfdb3dc9c984fbf411 # v2.19.4
with:
egress-policy: audit

- name: Download the release assets
uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
with:
name: release-assets
path: dist

- name: Attach the assets to a draft release
shell: bash
env:
GH_REPO: ${{ github.repository }}
GH_TOKEN: ${{ github.token }}
VERSION: ${{ needs.build.outputs.version }}
run: |
set -euo pipefail
# Lists releases instead of using gh release view, which reports an API failure as "not found".
drafts=$(gh api --paginate "repos/$GH_REPO/releases" --jq '.[] | [.tag_name, .draft] | @tsv' \
| awk -F'\t' -v tag="$TAG" '$1 == tag { print $2 }')
case "$drafts" in
"")
prerelease=()
if [[ "$VERSION" == *-* ]]; then
prerelease=(--prerelease)
fi
gh release create "$TAG" --draft --verify-tag --latest=false "${prerelease[@]}" \
--title "op-deployer v$VERSION" --notes ""
;;
true) ;;
*)
echo "::error::$TAG is already published, so its assets can't change, or has several drafts. Found: $drafts"
exit 1
;;
esac
gh release upload "$TAG" dist/* --clobber

expected=$(find dist -type f | wc -l)
attached=$(gh release view "$TAG" --json assets --jq '.assets | length')
if [ "$attached" -ne "$expected" ]; then
echo "::error::$TAG has $attached assets, expected $expected."
exit 1
fi
6 changes: 3 additions & 3 deletions ACTIVATIONS.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@ Every `OpHardfork` the op-reth of this fork defines, with its status on the netw
op-reth image serves and its effect on the Firehose block. Review the entries that are new or whose
status changed at every upstream bump, and when an activation is announced between bumps.

Statuses come from the timestamps compiled into `op-reth-v2.8.1-fh3.1`: OP Mainnet from
Statuses come from the timestamps compiled into `op-reth-v2.8.2-fh3.1`: OP Mainnet from
`rust/alloy-op-hardforks/src/optimism/mainnet.rs`, Unichain from the `superchain-registry`
submodule (`13907b9b`) that the chainspec embeds at build time. Checked 2026-11-06. "Not scheduled"
submodule (`13907b9b`) that the chainspec embeds at build time. Checked 2026-11-10. "Not scheduled"
means the fork has no timestamp in the code: it reaches the tracer only once a later release, or a
registry update picked up by a later release, schedules it.

Expand All @@ -19,4 +19,4 @@ World Chain runs from the `release/world-chain-2.x` line and is not covered here
| Isthmus | Active (2025-05-09) | Active (2025-05-09) | EIP-2935 parent hash system call; EIP-7702 transactions; the OperatorFeeVault (`0x4200…001b`) credit, emitted by `OpPostTxExtras` through upstream `operator_fee_charge`. |
| Jovian | Active (2025-12-02) | Active (2025-12-02) | Operator fee formula change, followed because `OpPostTxExtras` calls upstream `operator_fee_charge` with the active spec rather than a copy. Header `blobGasUsed` carries the DA footprint and is mapped as any header value. |
| Karst | Active (2026-07-08) | Active (2026-07-08) | Osaka EVM rules (EIP-7825 transaction gas cap with deposits exempt, MODEXP and P256VERIFY changes, BN254 pairing input cap). No new transaction type, fee vault or system call. |
| Lagoon | Not scheduled | Not scheduled | **Blocker before activation.** Enables the trailing `0x7D` post-exec transaction (`OpTxEnvelope::PostExec`). `firehose-tracer` 5.5.0 `TxType` has no value 125, and the reth mapper converts with `expect("All transaction types handled for now")` (`streamingfast/reth` `crates/firehose/src/mapper.rs`), so the first such transaction panics the node. Lagoon also turns on post-exec gas refunds, which make receipt `gas_used` differ from EVM gas: check the gas passed to `OpPostTxExtras` against what the handler charges the fee vaults. v2.8.1 can read `lagoon_time` from the superchain registry and adds BLS12-381 MSM and pairing input caps. |
| Lagoon | Not scheduled in the code. Optimism's [interop preparation notice](https://docs.optimism.io/notices/interop-prep) targets mid-December 2026, pending governance, with no timestamp published | Not scheduled in the code; same notice and target as OP Mainnet | **Blocker before activation.** Enables the trailing `0x7D` post-exec transaction (`OpTxEnvelope::PostExec`). `firehose-tracer` 5.5.0 `TxType` has no value 125, and the reth mapper converts with `expect("All transaction types handled for now")` (`streamingfast/reth` `crates/firehose/src/mapper.rs`), so the first such transaction panics the node. Lagoon also turns on post-exec gas refunds, which make receipt `gas_used` differ from EVM gas: check the gas passed to `OpPostTxExtras` against what the handler charges the fee vaults. v2.8.1 can read `lagoon_time` from the superchain registry and adds BLS12-381 MSM and pairing input caps. |
16 changes: 16 additions & 0 deletions CHANGELOG.sf.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,22 @@ The `sf-release.yml` workflow publishes the top-most version section here as the
GitHub release notes (via `sfreleaser changelog extract-section`), so keep the
most recent release at the top.

## op-reth-v2.8.2-fh3.1

Bumps the SF op-reth fork to upstream `op-reth/v2.8.2` (18 upstream commits on top of
`op-reth/v2.8.1`).

### Changed

* Merged upstream `op-reth/v2.8.2`, which keeps the interop transaction pool's `endpoint.up` gauge
up when a filter answers `-321100` (out of scope) and shares the operator gas limit with the
transaction pool. Block execution, the fork schedule and the reth and alloy-evm versions are
unchanged.
* Reth and `alloy-evm` are pinned by commit instead of by tag, still on `streamingfast/reth`
`op-reth-v2.8.1-fh3.1` and `streamingfast/evm` `v0.39.0-sf`.
* `ACTIVATIONS.md` records Optimism's mid-December 2026 target for Lagoon, which still has no
timestamp in the code and still needs Firehose support for the `0x7D` post-exec transaction.

## op-reth-v2.8.1-fh3.1

Bumps the SF op-reth fork to upstream `op-reth/v2.8.1` (307 upstream commits on top of
Expand Down
14 changes: 8 additions & 6 deletions docs/ai/acceptance-tests.md
Original file line number Diff line number Diff line change
Expand Up @@ -92,9 +92,9 @@ You can also run `just build-deps` directly to pre-build without running tests.
## Tuning Parallelism (`acceptance-test` only)

When using `just acceptance-test`, the runner sets:
- `ACCEPTANCE_TEST_JOBS` — number of packages to test in parallel (default: 12)
- `ACCEPTANCE_TEST_PARALLEL` — `go test -parallel` value per package (default: 1)
- `ACCEPTANCE_TEST_TIMEOUT` — per-package timeout (default: 30m)
- `ACCEPTANCE_TEST_JOBS` — number of tests to run at once (default: 8)
- `ACCEPTANCE_TEST_PARALLEL` — `go test -parallel` value per test (default: 1)
- `ACCEPTANCE_TEST_TIMEOUT` — per-test timeout (default: 30m)

Override with environment variables:

Expand All @@ -105,11 +105,13 @@ cd op-acceptance-tests && ACCEPTANCE_TEST_PARALLEL=2 ACCEPTANCE_TEST_TIMEOUT=1h
## Log Output (`acceptance-test` only)

When using `just acceptance-test`, logs are written to `op-acceptance-tests/logs/testrun-<timestamp>/`:
- `all.log` — full test output
- `raw_go_events.log` — JSON test events
- `all.log` — console output
- `raw_go_events-<node>-<package>.<test>.log` — JSON test events, one file per top-level test
- `per-test/<dotted package>/<test>.log` — each test's own output
- `failed/<node>-<package>.<test>.log` — console output of each test that failed, plus any still running if the run was cut off
- `flaky-tests.txt` — tests marked with `MarkFlaky()`

Results XML goes to `op-acceptance-tests/results/results.xml`.
Results XML goes to `op-acceptance-tests/results/results-<node>-<package>.<test>.xml`, one file per top-level test.

When using `just test`, output goes to stdout only.

Expand Down
Loading
Loading