Skip to content

README.md

Latest commit

 

History

History
42 lines (29 loc) · 3.41 KB

README.md

File metadata and controls

42 lines (29 loc) · 3.41 KB
Raw

Common EVM Scripts

Reusable EVM operation scripts live here. A script belongs in this directory when it is expected to be reused across tasks, networks, or task templates. Keep one-off task glue outside this directory.

How To Use

Reference common scripts by explicit Forge target path from active/evm:

ADDRESSES_JSON="tasks/<task-id>/config/<network>/addresses.json" \
  mise exec -- forge script --rpc-url "$L1_RPC_URL" script/common/verifier-update/UpdateVerifierHashes.s.sol:UpdateVerifierHashes

In Makefiles, prefer the same explicit path:

SCRIPT_NAME = script/common/verifier-update/UpdateVerifierHashes.s.sol:UpdateVerifierHashes

This keeps validation JSON portable and avoids ambiguity when different files define similarly named contracts.

Script Inventory

Folder Script Purpose Required task files
verifier-update/ DeployAggregateVerifier.s.sol Deploys a replacement AggregateVerifier by copying immutable constructor inputs from the live implementation and replacing verifier hashes. tasks/<task-id>/config/<network>/.env, ADDRESSES_JSON=tasks/<task-id>/config/<network>/addresses.json
verifier-update/ UpdateVerifierHashes.s.sol Multisig script that updates DisputeGameFactory.gameImpls(gameType) to a deployed AggregateVerifier. ADDRESSES_JSON=tasks/<task-id>/config/<network>/addresses.json containing aggregateVerifier
funding/ Fund.s.sol Sends native token from a Safe to recipients listed in funding.json. funding.json
gas/ IncreaseEip1559ElasticityAndIncreaseGasLimit.s.sol Updates gas limit, EIP-1559 elasticity, and DA footprint gas scalar on SystemConfig. config env values
bridge/ PauseBridge.s.sol Deposits an L2 transaction through the portal to pause or unpause the L2 bridge. config env values
bridge/ SetThreshold.s.sol Deposits an L2 transaction through the portal to update bridge partner threshold. config env values
superchain/ PauseSuperchainConfig.s.sol Pauses the chain through SuperchainConfig. config env values
safe/ UpdateSigners.s.sol Adds and removes Safe owners while preserving threshold. OwnerDiff.json
ownership/ TransferSystemConfigOwnership.s.sol Multisig script that transfers SystemConfig ownership from the current owner to a new owner. PROXY_ADMIN_OWNER, INCIDENT_MULTISIG, SYSTEM_CONFIG env values

Adding Scripts

Use exact Solidity pragmas based on the contracts they import; preserve a script's original exact pragma when moving it here. Load config from environment variables into immutable variables where possible. Keep scalar task-specific values in tasks/<task-id>/config/<network>/.env, or use the script-documented JSON input when structured data is required, rather than hardcoding values in common scripts.

Network-specific deployment address artifacts belong under tasks/<task-id>/config/<network>/addresses.json. Common verifier scripts must require ADDRESSES_JSON explicitly instead of defaulting to the shared project or task root. Forge broadcast records remain at task scope because Foundry separates them by script and chain ID.

If a script needs task-specific behavior, prefer a small task-local wrapper or Makefile target that passes environment variables into a common script. Move the underlying Solidity into this directory only when the operation itself is reusable.