From 62aa0239995f95c2d861e7f836a8df8de739e142 Mon Sep 17 00:00:00 2001 From: Josh Hardy Date: Sat, 20 Jun 2026 13:34:56 +0000 Subject: [PATCH] chore(deploy): placeholder for post-Bundle-1 clone-pin hydration MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Held empty until #209's clone-deploy bundle has executed on Base. At that point this PR's diff lands as: - LibProdDeployV4.STOX_PROD_AUTHORISER_V4_CLONE = address() - LibProdDeployV4.STOX_PROD_AUTHORISER_V4_CLONE_CODEHASH = Existence of this slot in the stack makes the pin-before-modify dependency edge visible in Graphite: #209's mirrorGrants() reverts with V4AuthoriserCloneNotPinned() until this PR merges; #197's V4 upgrade pre-flight similarly trips on the unpinned clone until then. See docs/OPERATIONAL_SCRIPTS.md § Pin before modify for the full rationale. --- src/lib/LibProdDeployV4.sol | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/src/lib/LibProdDeployV4.sol b/src/lib/LibProdDeployV4.sol index 89951eba..0ac35c10 100644 --- a/src/lib/LibProdDeployV4.sol +++ b/src/lib/LibProdDeployV4.sol @@ -126,6 +126,16 @@ library LibProdDeployV4 { /// post-deploy edit hand-writes the real literal in place of /// `address(0)` here. /// + /// @dev Hydration of this constant + `STOX_PROD_AUTHORISER_V4_CLONE_CODEHASH` + /// below happens in the post-Bundle-1 clone-pin PR. That PR is the + /// "pin before modify" gate between the clone-deploy script's + /// `run()` (Bundle 1) and its `mirrorGrants()` (Bundle 2): until the + /// pin lands, `mirrorGrants()` reverts with `V4AuthoriserCloneNotPinned()` + /// in pre-flight, so a grant-mirror bundle cannot be authored against + /// an arbitrary contract. See `docs/OPERATIONAL_SCRIPTS.md` § + /// "Pin before modify" for the full rationale and the field-by-field + /// hydration checklist. + /// /// Lives in this lib (the deploy artifacts pin) rather than in /// `LibAuthoriserInvariants` because it's a deploy target, not a /// current-state invariant. Post-swap, `LibAuthoriserInvariants.STOX_PROD_AUTHORISER`