Merge branch 'main' into jade/ton-support-testcontainers-go

Author: jadepark-dev

.github/workflows/test.yaml

@@ -13,6 +13,9 @@ jobs:
       fail-fast: false
       matrix:
         test:
+          - path: framework
+            vm: ubuntu-latest
+            regex: TestStorageMutations
           - path: framework
             vm: ubuntu-latest
             regex: TestSmoke
@@ -78,6 +81,10 @@ jobs:
           restore-keys: |
             go-modules-${{ matrix.test.path }}-${{ runner.os }}-test
             go-modules-${{ matrix.test.path }}-${{ runner.os }}
+      - name: Install Foundry
+        uses: foundry-rs/foundry-toolchain@82dee4ba654bd2146511f85f0d013af94670c4de # v1.4.0
+        with:
+          version: stable
       - uses: extractions/setup-just@dd310ad5a97d8e7b41793f8ef055398d51ad4de6 # v2.0.0
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}

book/src/SUMMARY.md

@@ -62,6 +62,7 @@
   - [Performance]()
   - [Chaos](./framework/chaos/chaos.md)
   - [Fork Testing](./framework/fork.md)
+  - [Fork Testing (Mutating Storage)](./framework/fork_storage.md)
 - [Libraries](./libraries.md)
   - [Seth](./libs/seth.md)
   - [WASP](./libs/wasp/overview.md)

book/src/framework/fork_storage.md

@@ -0,0 +1,26 @@
+# Fork Testing (Mutating Storage)
+
+We provide API to use `anvil_setStorageAt` more easily so in case you can't edit EVM smart contracts code you can still mutate your contract values.
+
+You need to build your contract layout first
+```
+forge build || forge inspect Counter storageLayout --json > layout.json
+```
+
+And then you can use `AnvilSetStorageAt` to override contract's storage data
+```
+		r := rpc.New(rpcURL, nil)
+		err = r.AnvilSetStorageAt([]interface{}{contractAddr, slot, data})
+```
+See [examples](https://github.com/smartcontractkit/chainlink-testing-framework/blob/main/framework/evm_storage/layout_api_test.go) of how you can use API to encode/mutate different values.
+
+Keep in mind that values <32 bytes are packed together, see `encodeCustomStructFunc` example and `offset` example to understnad how to change them properly.
+
+```
+cd framework/evm_storage
+./setup.sh
+go test -v -run TestLayoutAPI
+./teardown.sh
+```
+
+Read more about Solidity storage layout [here](https://docs.soliditylang.org/en/latest/internals/layout_in_storage.html#)

devbox.json

@@ -5,7 +5,7 @@
     "[email protected]",
     "[email protected]",
     "git@latest",
-    "go@latest",
+    "go@1.24.0",
     "goreleaser@latest",
     "postgresql@15",
     "python@latest",