feat(deploy): V4 authoriser clone-deploy + grants-mirror script

.github/workflows/git-clean.yaml

@@ -4,14 +4,16 @@ jobs:
   git-clean:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: nixbuild/nix-quick-install-action@v30
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+        with:
+          persist-credentials: false
+      - uses: nixbuild/nix-quick-install-action@5bb6a3b3abe66fd09bbf250dce8ada94f856a703 # v30
         with:
           nix_conf: |
             keep-env-derivations = true
             keep-outputs = true
       - name: Restore and save Nix store
-        uses: nix-community/cache-nix-action@v6
+        uses: nix-community/cache-nix-action@135667ec418502fa5a3598af6fb9eb733888ce6a # v6
         with:
           primary-key: nix-${{ runner.os }}-${{ hashFiles('**/*.nix', '**/flake.lock') }}
           restore-prefixes-first-match: nix-${{ runner.os }}-

.github/workflows/multisig-artifact.yaml

@@ -24,8 +24,10 @@ jobs:
   build-artifact:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: DeterminateSystems/nix-installer-action@v17
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+        with:
+          persist-credentials: false
+      - uses: DeterminateSystems/nix-installer-action@21a544727d0c62386e78b4befe52d19ad12692e3 # v17
       - name: Install Soldeer dependencies
         run: nix develop --command forge soldeer install
       - name: Build Tx Builder artifact (dry-run)
@@ -38,7 +40,7 @@ jobs:
               --no-storage-caching
           '
       - name: Upload Tx Builder JSON
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
         with:
           name: safe-threshold-tx-builder-json
           path: out/*.json

.github/workflows/run-script.yaml

@@ -0,0 +1,101 @@
+name: run-script
+on:
+  workflow_dispatch:
+    inputs:
+      script:
+        description: 'Operational script to dispatch'
+        required: true
+        type: choice
+        options:
+          # Append-only registry: add new entries at the bottom; never reorder
+          # or delete. Re-dispatching a historical (executed) script must
+          # remain possible — a signer/auditor may want to re-derive its
+          # bundle to verify what landed on-chain.
+          #
+          # Each entry is the date-prefixed filename (without `.s.sol`) of a
+          # script under `script/`. Convention: `YYYYMMDD-<kebab-name>`,
+          # where the date is the day the script was added to this dropdown.
+          # Execution status (PENDING / EXECUTED + SafeTxHash) lives in the
+          # script's file-level NatSpec — this dropdown is a registry of
+          # *which* scripts exist, not *whether* they've run.
+          - 20260619-deploy-v4-authoriser-clone
+      sig:
+        description: 'Entrypoint to dispatch (default: run())'
+        required: true
+        type: choice
+        default: 'run()'
+        options:
+          # Append-only registry of entrypoint signatures. The dispatcher does
+          # not validate that the selected script implements the selected
+          # signature — `forge script` will surface a clear revert if not.
+          #
+          # `verify(string)` is intentionally NOT listed: it is always a local
+          # signer-side check run against a downloaded artifact — it takes a
+          # JSON path argument this dispatcher can't supply and runs off-chain
+          # on the signer's machine, not in CI.
+          - 'run()'
+          - 'mirrorGrants()'
+# Manually dispatches an operational script from `script/` and uploads any
+# JSON it writes to `out/` as a build artifact.
+#
+# Operational scripts produce off-chain artifacts (Safe Tx Builder JSON,
+# signer briefs) under `out/`. They run a full on-chain pre-flight, simulate
+# the post-state, emit the artifact, and log the canonical hash that signers
+# must verify. The dry-run uses an unpinned Base head fork so any drift in
+# the underlying contracts trips the pre-flight here before a signer ever
+# sees the bundle.
+#
+# Why a single dispatcher rather than one workflow per script:
+# - The Actions sidebar stays tight as more scripts accumulate.
+# - Boilerplate (nix install, soldeer install, artifact upload) lives in
+#   one place.
+# - Adding a new script is a single yaml entry + a new file under
+#   `script/`, no new workflow file.
+#
+# The `sig` input lets a single script expose multiple entrypoints (e.g.
+# `run()` and `mirrorGrants()` on the V4 authoriser deploy) without
+# splitting them into separate dispatcher entries. `forge --sig` is the
+# canonical way to pick which function `forge script` calls.
+jobs:
+  run:
+    name: Run operational script
+    runs-on: ubuntu-latest
+    # Serialise dispatches of the same script+sig so overlapping runs don't
+    # race on the shared out/ artifacts; distinct entrypoints run in parallel.
+    concurrency:
+      group: run-script-${{ inputs.script }}-${{ inputs.sig }}
+      cancel-in-progress: false
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+        with:
+          persist-credentials: false
+      - uses: DeterminateSystems/nix-installer-action@21a544727d0c62386e78b4befe52d19ad12692e3 # v17
+      - name: Install Soldeer dependencies
+        run: nix develop --command forge soldeer install
+      - name: Run script
+        env:
+          BASE_RPC_URL: ${{ secrets.RPC_URL_BASE_FORK }}
+          # Pass the choice inputs via env rather than template-expanding them
+          # into the command, so a dispatch (even one crafted via the API) is
+          # used as a literal argument and cannot inject shell.
+          SCRIPT: ${{ inputs.script }}
+          SIG: ${{ inputs.sig }}
+        run: |
+          nix develop --command forge script "script/${SCRIPT}.s.sol" \
+            --sig "${SIG}" \
+            --rpc-url base \
+            --no-storage-caching
+      - name: Upload script output
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        with:
+          # Artifact name encodes both script + sig so the run() and
+          # mirrorGrants() outputs of the same script don't clobber each other
+          # if both are dispatched in the same operational window. The sig is
+          # used verbatim, parentheses included — GitHub artifact names permit
+          # them.
+          name: ${{ inputs.script }}-${{ inputs.sig }}-out
+          path: out/*.json
+          # `warn` instead of `error`: some operational scripts may not
+          # produce a JSON artifact (e.g. a pure verifier or a status
+          # printer). Falling back to a warning keeps the dispatcher generic.
+          if-no-files-found: warn