Add sierra for predeployed contracts

.github/actions/restore-predeployed-contracts/action.yml

@@ -0,0 +1,40 @@
+name: Restore predeployed contracts
+description: Download generated predeployed contract artifacts into the location expected by cheatnet.
+
+inputs:
+  artifact-name:
+    description: Name of the uploaded artifact containing predeployed contracts.
+    required: false
+    default: predeployed-contracts
+  path:
+    description: Destination directory for restored predeployed contracts.
+    required: false
+    default: crates/cheatnet/src/data/predeployed_contracts
+
+runs:
+  using: composite
+  steps:
+    - uses: actions/download-artifact@v6
+      with:
+        name: ${{ inputs.artifact-name }}
+        path: ${{ inputs.path }}
+
+    - name: Validate restored predeployed contracts
+      shell: bash
+      run: |
+        set -euo pipefail
+
+        required_files=(
+          "ERC20Lockable/casm.json.gz"
+          "ERC20Lockable/sierra.json.gz"
+          "ERC20Mintable/casm.json.gz"
+          "ERC20Mintable/sierra.json.gz"
+        )
+
+        for relative_path in "${required_files[@]}"; do
+          full_path="${{ inputs.path }}/${relative_path}"
+          if [[ ! -f "${full_path}" ]]; then
+            echo "Missing restored predeployed contract artifact: ${full_path}" >&2
+            exit 1
+          fi
+        done

.github/workflows/_build-binaries-native.yml

@@ -14,9 +14,13 @@ on:
         type: string
 
 jobs:
+  prepare-predeployed-contracts:
+    uses: ./.github/workflows/_prepare-predeployed-contracts.yml
+
   build-binaries:
     name: Build ${{ matrix.target }}
     runs-on: ${{ matrix.os }}
+    needs: prepare-predeployed-contracts
 
     env:
       # Cross-compiled targets will override this to `cross`.
@@ -67,6 +71,8 @@ jobs:
         if: inputs.ref == ''
         uses: actions/checkout@v6
 
+      - uses: ./.github/actions/restore-predeployed-contracts
+
       - name: Setup rust
         run: |
           rustup target add ${{ matrix.target }}

.github/workflows/_build-binaries.yml

@@ -12,9 +12,13 @@ on:
         type: string
 
 jobs:
+  prepare-predeployed-contracts:
+    uses: ./.github/workflows/_prepare-predeployed-contracts.yml
+
   build-binaries:
     name: Build ${{ matrix.target }}
     runs-on: ${{ matrix.os }}
+    needs: prepare-predeployed-contracts
 
     env:
       # Cross-compiled targets will override this to `cross`.
@@ -57,6 +61,8 @@ jobs:
         if: inputs.ref == ''
         uses: actions/checkout@v6
 
+      - uses: ./.github/actions/restore-predeployed-contracts
+
       - name: Setup rust
         run: |
           rustup target add ${{ matrix.target }}

.github/workflows/_prepare-predeployed-contracts.yml

@@ -0,0 +1,36 @@
+name: Prepare predeployed contracts
+
+on:
+  workflow_call:
+    inputs:
+      artifact-name:
+        required: false
+        type: string
+        default: predeployed-contracts
+
+jobs:
+  prepare-predeployed-contracts:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: asdf-vm/actions/setup@b7bcd026f18772e44fe1026d729e1611cc435d47
+
+      - name: Restore predeployed contracts cache
+        id: cache-predeployed-contracts
+        uses: actions/cache@v4
+        with:
+          path: crates/cheatnet/src/data/predeployed_contracts
+          key: predeployed-contracts-${{ runner.os }}-${{ hashFiles('scripts/setup_predeployed_contracts.sh') }}
+
+      - name: Generate predeployed contracts
+        if: steps.cache-predeployed-contracts.outputs.cache-hit != 'true'
+        run: ./scripts/setup_predeployed_contracts.sh
+
+      - name: Upload predeployed contracts
+        uses: actions/upload-artifact@v5
+        with:
+          name: ${{ inputs.artifact-name }}
+          path: crates/cheatnet/src/data/predeployed_contracts
+          if-no-files-found: error
+          compression-level: 0

.github/workflows/ci.yml

@@ -34,31 +34,39 @@ jobs:
           echo ${scarb_versions[@]}
           echo "versions=[${scarb_versions[@]}]" >> "$GITHUB_OUTPUT"
 
+  prepare-predeployed-contracts:
+    name: Prepare predeployed contracts
+    uses: ./.github/workflows/_prepare-predeployed-contracts.yml
+
   test-workspace:
     # Runs tests from all crates across the workspace, except:
     # - `sncast` tests
     # - `forge` integration and e2e tests
     # `native-api` is also excluded as there are no tests and it requires extra setup to compile.
     name: Workspace Tests
     runs-on: ubuntu-latest
+    needs: prepare-predeployed-contracts
     steps:
       - uses: actions/checkout@v6
       - uses: ./.github/actions/setup-tools
         with:
           save-cache: 'true'
+      - uses: ./.github/actions/restore-predeployed-contracts
       - run: cargo test --profile ci --workspace --exclude sncast --exclude forge --exclude native-api
       - run: cargo test --profile ci --lib -p forge
 
   build-test-forge-nextest-archive:
     name: Build Nextest Archive (Forge)
     runs-on: ubuntu-latest
+    needs: prepare-predeployed-contracts
     steps:
       - uses: actions/checkout@v6
       - uses: ./.github/actions/setup-tools
         with:
           setup-scarb: 'false'
           setup-usc: 'false'
           save-cache: 'true'
+      - uses: ./.github/actions/restore-predeployed-contracts
       - name: Install nextest
         uses: taiki-e/install-action@055f5df8c3f65ea01cd41e9dc855becd88953486 # 2.75.18
         with:
@@ -74,11 +82,14 @@ jobs:
   build-test-forge-nextest-archive-native:
     name: Build Nextest Archive (Forge Native)
     runs-on: ubuntu-latest
+    needs: prepare-predeployed-contracts
     steps:
       - uses: actions/checkout@v6
       - uses: ./.github/actions/setup-tools
         with:
           install-llvm: 'true'
+      - uses: ./.github/actions/restore-predeployed-contracts
+        with:
           setup-scarb: 'false'
           setup-usc: 'false'
           cache-key: 'native'
@@ -251,7 +262,7 @@ jobs:
     if: github.event_name == 'merge_group'
     name: Test Forge / E2E Snap (Scarb ${{ matrix.version }})
     runs-on: ubuntu-latest
-    needs: get-scarb-versions
+    needs: [get-scarb-versions, prepare-predeployed-contracts]
     strategy:
       fail-fast: false
       matrix:
@@ -293,18 +304,21 @@ jobs:
       - uses: ./.github/actions/setup-tools
         with:
           scarb-version: ${{ matrix.version }}
+      - uses: ./.github/actions/restore-predeployed-contracts
       - name: Run snap E2E tests
         run: cargo test --profile ci -p forge --test main snap_
 
   test-special-conditions:
     name: Test special conditions
     runs-on: ubuntu-latest
+    needs: prepare-predeployed-contracts
     steps:
       - uses: actions/checkout@v6
       - uses: ./.github/actions/setup-tools
         # Scarb is installed manually below to control the version
         with:
           setup-scarb: 'false'
+      - uses: ./.github/actions/restore-predeployed-contracts
 
       - run: cargo test --profile ci --package forge --features no_scarb_installed --lib compatibility_check::tests::failing_tool_not_installed
 
@@ -332,8 +346,10 @@ jobs:
   build-test-cast-nextest-archive:
     name: Build Nextest Archive (Cast)
     runs-on: ubuntu-latest
+    needs: prepare-predeployed-contracts
     steps:
       - uses: actions/checkout@v6
+      - uses: ./.github/actions/restore-predeployed-contracts
       - uses: asdf-vm/actions/install@b7bcd026f18772e44fe1026d729e1611cc435d47
       - uses: ./.github/actions/setup-tools
         with:
@@ -382,16 +398,19 @@ jobs:
       - uses: actions/checkout@v6
       - uses: asdf-vm/actions/install@b7bcd026f18772e44fe1026d729e1611cc435d47
       - uses: ./.github/actions/setup-tools
+      - uses: ./.github/actions/restore-predeployed-contracts
       - name: Run doctests
         run: cargo test --profile ci -p sncast --doc
 
   test-ledger:
     name: Test Ledger
     runs-on: ubuntu-latest
     container: ghcr.io/ledgerhq/ledger-app-builder/ledger-app-dev-tools
+    needs: prepare-predeployed-contracts
 
     steps:
       - uses: actions/checkout@v6
+      - uses: ./.github/actions/restore-predeployed-contracts
       - uses: asdf-vm/actions/install@b7bcd026f18772e44fe1026d729e1611cc435d47
       - uses: ./.github/actions/setup-tools
         with:
@@ -406,6 +425,7 @@ jobs:
   fmt-lint-typos:
     name: Lint and Format
     runs-on: ubuntu-latest
+    needs: prepare-predeployed-contracts
     env:
       # Make sure CI fails on all warnings - including Clippy lints.
       RUSTFLAGS: "-Dwarnings"
@@ -417,6 +437,7 @@ jobs:
           setup-usc: 'false'
           cache-key: 'lint'
           save-cache: 'true'
+      - uses: ./.github/actions/restore-predeployed-contracts
       - run: rustup component add rustfmt
 
       - name: Check formatting
@@ -451,9 +472,11 @@ jobs:
   build-docs:
     name: Test Building Docs
     runs-on: ubuntu-latest
+    needs: prepare-predeployed-contracts
     steps:
       - uses: actions/checkout@v6
       - uses: ./.github/actions/setup-tools
+      - uses: ./.github/actions/restore-predeployed-contracts
       - uses: taiki-e/install-action@055f5df8c3f65ea01cd41e9dc855becd88953486 # 2.75.18
         with:
           # TODO(#3970): Upgrade mdbook-variables after resolving issue

.github/workflows/scheduled.yml

@@ -33,17 +33,22 @@ jobs:
           echo ${scarb_versions[@]}
           echo "versions=[${scarb_versions[@]}]" >> "$GITHUB_OUTPUT"
 
+  prepare-predeployed-contracts:
+    if: github.event.repository.fork == false
+    uses: ./.github/workflows/_prepare-predeployed-contracts.yml
+
   test-forge-unit-and-integration:
     if: github.event.repository.fork == false
     runs-on: ubuntu-latest
-    needs: get-scarb-versions
+    needs: [get-scarb-versions, prepare-predeployed-contracts]
     strategy:
       fail-fast: false
       matrix:
         version: ${{ fromJSON(needs.get-scarb-versions.outputs.versions) }}
 
     steps:
       - uses: actions/checkout@v6
+      - uses: ./.github/actions/restore-predeployed-contracts
       - uses: dtolnay/rust-toolchain@stable
       - uses: software-mansion/setup-scarb@v1
         with:
@@ -56,7 +61,7 @@ jobs:
   test-forge-e2e:
     if: github.event.repository.fork == false
     runs-on: ubuntu-latest
-    needs: get-scarb-versions
+    needs: [get-scarb-versions, prepare-predeployed-contracts]
     strategy:
       fail-fast: false
       matrix:
@@ -80,6 +85,7 @@ jobs:
         run: echo "REPO_NAME=$(echo ${{ github.event.pull_request.head.repo.full_name }}.git)" >> $GITHUB_ENV
 
       - uses: actions/checkout@v6
+      - uses: ./.github/actions/restore-predeployed-contracts
       - uses: dtolnay/rust-toolchain@stable
       - uses: software-mansion/setup-scarb@v1
         with:
@@ -101,14 +107,15 @@ jobs:
   test-cast:
     if: github.event.repository.fork == false
     runs-on: ubuntu-latest
-    needs: get-scarb-versions
+    needs: [get-scarb-versions, prepare-predeployed-contracts]
     strategy:
       fail-fast: false
       matrix:
         version: ${{ fromJSON(needs.get-scarb-versions.outputs.versions) }}
 
     steps:
       - uses: actions/checkout@v6
+      - uses: ./.github/actions/restore-predeployed-contracts
       - uses: dtolnay/rust-toolchain@stable
       - uses: software-mansion/setup-scarb@v1
         with:

.gitignore

@@ -12,6 +12,7 @@ Scarb.lock
 .spr.yml
 .snfoundry_cache/
 .snfoundry_versioned_programs/
+crates/cheatnet/src/data/predeployed_contracts/
 snfoundry_trace/
 coverage/
 **/.forge_e2e_cache/

CHANGELOG.md

@@ -9,9 +9,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Forge
 
+#### Added
+
+- Predeployed contracts are now supported in debugging traces and backtrace
+
 #### Fixed
 
 - Bug in forge debugging and `--gas-report` that caused panic in case of a call to non-existent selector
+- Permitted minter storage value of ETH predeployed contract, has now the same value as on mainnet
 
 ## [0.60.0] - 2026-04-27
 
@@ -44,7 +49,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 #### Changed
 
 - In JSON output for `sncast utils` commands, the `"command"` field now includes the `utils` prefix (e.g. `"serialize"` -> `"utils serialize"`).
-- Reworked profile layering in `snfoundry.toml`: `[sncast.default]` is always the base layer, and global-only profiles can work without a local config. Read more [here](https://foundry-rs.github.io/starknet-foundry/projects/configuration.html#interaction-between-local-and-global-profiles).
+- Reworked profile layering in `snfoundry.toml`: `[sncast.default]` is always the base layer, and global-only profiles can work without a local config. Read more [here](https://foundry-rs.github.io/starknet-foundry/projects/configuration.html#interaction-between-local-and-global-profiles).
 - Improved `snfoundry.toml` config error reporting.
 - `--profile` now only determines `snfoundry.toml` profile. For Scarb profile, use `--scarb-profile` flag or `scarb-profile` from `snfoundry.toml` instead. Defaults to `release` if unspecified.
 

crates/cheatnet/Cargo.toml

@@ -2,6 +2,7 @@
 name = "cheatnet"
 version.workspace = true
 edition.workspace = true
+build = "build.rs"
 
 [features]
 testing = []