docs: backfill v4.2.0 migration notes (backport #22612)#22616
Open
AztecBot wants to merge 2 commits into
Open
Conversation
## Summary Move four breaking-change migration notes from the unreleased area into the `## 4.2.0` section of the live developer docs, and add them to the v4.2.0 versioned snapshot: - `GasSettings.default()` renamed to `GasSettings.fallback()` (plus removal of `DEFAULT_GAS_LIMIT` / `DEFAULT_TEARDOWN_GAS_LIMIT`) - `simulateTx` / `executeUtility` / `profileTx` / `proveTx` no longer accept `scopes: 'ALL_SCOPES'` - PXE now scope-enforces capsule operations - `EphemeralArray` replaces `CapsuleArray` in PXE oracle interfaces These notes were written after the v4.2.0 cut but document breaking changes that shipped in 4.2.0, so they belong in the 4.2.0 section of both the live and versioned docs. ## Test plan - [ ] Migration notes render correctly on the docs site - [ ] v4.2.0 versioned docs show the backfilled entries under `## 4.2.0` - [ ] Live developer docs no longer list these entries as unreleased # Conflicts: # docs/developer_versioned_docs/version-v4.1.0-rc.2/docs/resources/migration_notes.md # docs/docs-developers/docs/resources/migration_notes.md
Keep HEAD content for both migration notes files: - version-v4.1.0-rc.2 snapshot is a locked published doc, do not modify - v4.2.0 versioned snapshot does not exist on v4-next yet Add only the missing EphemeralArray migration note to the ## TBD section of the live developer migration notes. The other three notes the PR moves (GasSettings.default, simulateTx scopes, capsule scope enforcement) are already present in ## TBD on v4-next (see commit 42ecd02).
AztecBot
added
ci-draft
critesjosh
approved these changes
Apr 16, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Backport of #22612 to
v4-next.The upstream PR moves four v4.2.0 breaking-change migration notes from
## Unreleased (v5)into a## 4.2.0section of the live docs and adds them todeveloper_versioned_docs/version-v4.2.0/. Neither target exists on v4-next yet — v4.2.0 has not been cut, and the v4.2.0 versioned snapshot does not exist. The established convention on v4-next (see42ecd02a34) is to accumulate new breaking-change notes under## TBDuntil the release is cut.Three of the four notes (GasSettings.default→fallback, simulateTx scopes, capsule scope enforcement) are already present in
## TBDon v4-next. Only theEphemeralArraynote was missing; it has been added to the end of## TBDin the live developer migration notes.No changes to any
developer_versioned_docs/version-*snapshot — published versioned docs are locked perdocs/CLAUDE.md.Full analysis: https://gist.github.com/AztecBot/1ccd427c97cfa82285cee44fb2935937
Commit structure
[Aztec.nr] Ephemeral arrays replace capsule arrays in PXE oracle interfacesentry to## TBDindocs-developers/docs/resources/migration_notes.md.Test plan
yarn buildunderdocs/)yarn spellcheckunderdocs/)## TBDin the live developer migration notesClaudeBox log: https://claudebox.work/s/8123d27b3c4276e4?run=1