diff --git a/src/output/cast/cast-call b/src/output/cast/cast-call index 11cb3adb6..ba9343ca8 100644 --- a/src/output/cast/cast-call +++ b/src/output/cast/cast-call @@ -3,6 +3,6 @@ $ cast call 0x6b175474e89094c44da98b954eedeac495271d0f "totalSupply()(uint256)" --rpc-url https://eth-mainnet.alchemyapi.io/v2/Lc7oIGYeL_QvInzI0Wiu_pOZZDEKBrdf // ANCHOR_END: command // ANCHOR: output -3174399289401489504386774821 [3.174e27] +3189192687344152474307155726 [3.189e27] // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/output/cheatcodes/forge-test-cheatcodes b/src/output/cheatcodes/forge-test-cheatcodes index 41e792272..75a58273e 100644 --- a/src/output/cheatcodes/forge-test-cheatcodes +++ b/src/output/cheatcodes/forge-test-cheatcodes @@ -8,8 +8,8 @@ No files changed, compilation skipped Ran 2 tests for test/OwnerUpOnly.t.sol:OwnerUpOnlyTest [PASS] testFail_IncrementAsNotOwner() (gas: 8314) [PASS] test_IncrementAsOwner() (gas: 29161) -Suite result: ok. 2 passed; 0 failed; 0 skipped; finished in 664.58µs (394.64µs CPU time) +Suite result: ok. 2 passed; 0 failed; 0 skipped; finished in 562.63µs (204.18µs CPU time) -Ran 1 test suite in 5.56ms (664.58µs CPU time): 2 tests passed, 0 failed, 0 skipped (2 total tests) +Ran 1 test suite in 5.33ms (562.63µs CPU time): 2 tests passed, 0 failed, 0 skipped (2 total tests) // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/output/cheatcodes/forge-test-cheatcodes-expectrevert b/src/output/cheatcodes/forge-test-cheatcodes-expectrevert index 7c2d23798..9f9ce3321 100644 --- a/src/output/cheatcodes/forge-test-cheatcodes-expectrevert +++ b/src/output/cheatcodes/forge-test-cheatcodes-expectrevert @@ -7,8 +7,8 @@ No files changed, compilation skipped Ran 1 test for test/OwnerUpOnly.t.sol:OwnerUpOnlyTest [PASS] test_IncrementAsOwner() (gas: 29161) -Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 432.83µs (73.34µs CPU time) +Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 440.77µs (73.08µs CPU time) -Ran 1 test suite in 5.24ms (432.83µs CPU time): 1 tests passed, 0 failed, 0 skipped (1 total tests) +Ran 1 test suite in 5.48ms (440.77µs CPU time): 1 tests passed, 0 failed, 0 skipped (1 total tests) // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/output/cheatcodes/forge-test-cheatcodes-tracing b/src/output/cheatcodes/forge-test-cheatcodes-tracing index a43086be4..1f727d2a0 100644 --- a/src/output/cheatcodes/forge-test-cheatcodes-tracing +++ b/src/output/cheatcodes/forge-test-cheatcodes-tracing @@ -15,8 +15,8 @@ Traces: │ └─ ← [Revert] Unauthorized() └─ ← [Revert] Unauthorized() -Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 472.94µs (85.28µs CPU time) +Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 513.84µs (79.04µs CPU time) -Ran 1 test suite in 6.85ms (472.94µs CPU time): 1 tests passed, 0 failed, 0 skipped (1 total tests) +Ran 1 test suite in 5.62ms (513.84µs CPU time): 1 tests passed, 0 failed, 0 skipped (1 total tests) // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/output/cheatcodes/forge-test-simple b/src/output/cheatcodes/forge-test-simple index 21e560c1a..80def449e 100644 --- a/src/output/cheatcodes/forge-test-simple +++ b/src/output/cheatcodes/forge-test-simple @@ -9,8 +9,8 @@ Compiler run successful! Ran 1 test for test/OwnerUpOnly.t.sol:OwnerUpOnlyTest [PASS] test_IncrementAsOwner() (gas: 29161) -Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 502.64µs (76.22µs CPU time) +Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 460.07µs (65.70µs CPU time) -Ran 1 test suite in 5.39ms (502.64µs CPU time): 1 tests passed, 0 failed, 0 skipped (1 total tests) +Ran 1 test suite in 5.16ms (460.07µs CPU time): 1 tests passed, 0 failed, 0 skipped (1 total tests) // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/output/deps/forge-install b/src/output/deps/forge-install index ac9fa0ad4..775eaf949 100644 --- a/src/output/deps/forge-install +++ b/src/output/deps/forge-install @@ -3,7 +3,7 @@ $ forge install transmissions11/solmate // ANCHOR_END: command // ANCHOR: output -Installing solmate in /tmp/tmp.ujUfkrt2cm/deps/lib/solmate (url: Some("https://github.com/transmissions11/solmate"), tag: None) +Installing solmate in /tmp/tmp.EeHRsNb8sO/deps/lib/solmate (url: Some("https://github.com/transmissions11/solmate"), tag: None) Installed solmate // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/output/deps/tree b/src/output/deps/tree index 630d7bd96..abb51fcf6 100644 --- a/src/output/deps/tree +++ b/src/output/deps/tree @@ -1,6 +1,6 @@ // ANCHOR: all // ANCHOR: command -$ tree lib +$ tree lib -L 1 // ANCHOR_END: command // ANCHOR: output lib diff --git a/src/output/foundry-template/forge-test b/src/output/foundry-template/forge-test index f404e58f5..dd7b358f2 100644 --- a/src/output/foundry-template/forge-test +++ b/src/output/foundry-template/forge-test @@ -9,8 +9,8 @@ Ran 3 tests for test/Foo.t.sol:FooTest [PASS] testFork_Example() (gas: 3779) [PASS] testFuzz_Example(uint256) (runs: 1000, μ: 9111, ~: 9111) [PASS] test_Example() (gas: 11861) -Suite result: ok. 3 passed; 0 failed; 0 skipped; finished in 21.39ms (21.15ms CPU time) +Suite result: ok. 3 passed; 0 failed; 0 skipped; finished in 23.36ms (22.98ms CPU time) -Ran 1 test suite in 22.80ms (21.39ms CPU time): 3 tests passed, 0 failed, 0 skipped (3 total tests) +Ran 1 test suite in 24.49ms (23.36ms CPU time): 3 tests passed, 0 failed, 0 skipped (3 total tests) // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/output/fuzz_testing/forge-test-fail-fuzz b/src/output/fuzz_testing/forge-test-fail-fuzz index 648ca9fc1..77f6c56ef 100644 --- a/src/output/fuzz_testing/forge-test-fail-fuzz +++ b/src/output/fuzz_testing/forge-test-fail-fuzz @@ -4,13 +4,13 @@ $ forge test --allow-failure // ANCHOR_END: command // ANCHOR: output Compiling 1 files with Solc 0.8.10 -Solc 0.8.10 finished in 1.11s +Solc 0.8.10 finished in 1.08s Compiler run successful! Ran 1 test for test/Safe.t.sol:SafeTest -[FAIL: EvmError: Revert; counterexample: calldata=0x29facca7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffd args=[115792089237316195423570985008687907853269984665640564039457584007913129639933 [1.157e77]]] testFuzz_Withdraw(uint256) (runs: 0, μ: 0, ~: 0) -Suite result: FAILED. 0 passed; 1 failed; 0 skipped; finished in 813.07µs (371.85µs CPU time) +[FAIL: EvmError: Revert; counterexample: calldata=0x29facca700000000000000000000000000000000f45663667f8ecfc2ec509a7f64736f6d args=[324780184580654050974171636162169630573 [3.247e38]]] testFuzz_Withdraw(uint256) (runs: 9, μ: 19531, ~: 19531) +Suite result: FAILED. 0 passed; 1 failed; 0 skipped; finished in 1.22ms (768.07µs CPU time) -Ran 1 test suite in 5.55ms (813.07µs CPU time): 0 tests passed, 1 failed, 0 skipped (1 total tests) +Ran 1 test suite in 5.61ms (1.22ms CPU time): 0 tests passed, 1 failed, 0 skipped (1 total tests) // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/output/fuzz_testing/forge-test-no-fuzz b/src/output/fuzz_testing/forge-test-no-fuzz index 4321af131..12c696392 100644 --- a/src/output/fuzz_testing/forge-test-no-fuzz +++ b/src/output/fuzz_testing/forge-test-no-fuzz @@ -4,13 +4,13 @@ $ forge test // ANCHOR_END: command // ANCHOR: output Compiling 24 files with Solc 0.8.10 -Solc 0.8.10 finished in 1.12s +Solc 0.8.10 finished in 1.14s Compiler run successful! Ran 1 test for test/Safe.t.sol:SafeTest [PASS] test_Withdraw() (gas: 19463) -Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 450.98µs (64.92µs CPU time) +Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 494.84µs (66.56µs CPU time) -Ran 1 test suite in 5.26ms (450.98µs CPU time): 1 tests passed, 0 failed, 0 skipped (1 total tests) +Ran 1 test suite in 5.26ms (494.84µs CPU time): 1 tests passed, 0 failed, 0 skipped (1 total tests) // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/output/fuzz_testing/forge-test-success-fuzz b/src/output/fuzz_testing/forge-test-success-fuzz index 735846e61..dca71dcbe 100644 --- a/src/output/fuzz_testing/forge-test-success-fuzz +++ b/src/output/fuzz_testing/forge-test-success-fuzz @@ -4,13 +4,13 @@ $ forge test // ANCHOR_END: command // ANCHOR: output Compiling 1 files with Solc 0.8.10 -Solc 0.8.10 finished in 1.08s +Solc 0.8.10 finished in 1.10s Compiler run successful! Ran 1 test for test/Safe.t.sol:SafeTest -[PASS] testFuzz_Withdraw(uint96) (runs: 257, μ: 19318, ~: 19631) -Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 5.00ms (4.63ms CPU time) +[PASS] testFuzz_Withdraw(uint96) (runs: 257, μ: 19370, ~: 19631) +Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 5.29ms (4.82ms CPU time) -Ran 1 test suite in 6.25ms (5.00ms CPU time): 1 tests passed, 0 failed, 0 skipped (1 total tests) +Ran 1 test suite in 6.28ms (5.29ms CPU time): 1 tests passed, 0 failed, 0 skipped (1 total tests) // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/output/hello_foundry/forge-build b/src/output/hello_foundry/forge-build index d53d96e61..d31f2ca2f 100644 --- a/src/output/hello_foundry/forge-build +++ b/src/output/hello_foundry/forge-build @@ -4,7 +4,7 @@ $ forge build // ANCHOR_END: command // ANCHOR: output Compiling 27 files with Solc 0.8.19 -Solc 0.8.19 finished in 1.13s +Solc 0.8.19 finished in 1.09s Compiler run successful! // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/output/hello_foundry/forge-init b/src/output/hello_foundry/forge-init index 5e37254f4..7b3c54fc0 100644 --- a/src/output/hello_foundry/forge-init +++ b/src/output/hello_foundry/forge-init @@ -3,8 +3,8 @@ $ forge init hello_foundry // ANCHOR_END: command // ANCHOR: output -Initializing /tmp/tmp.4sHKCeqDkn/hello_foundry... -Installing forge-std in /tmp/tmp.4sHKCeqDkn/hello_foundry/lib/forge-std (url: Some("https://github.com/foundry-rs/forge-std"), tag: None) +Initializing /tmp/tmp.l8BNexEdUb/hello_foundry... +Installing forge-std in /tmp/tmp.l8BNexEdUb/hello_foundry/lib/forge-std (url: Some("https://github.com/foundry-rs/forge-std"), tag: None) Installed forge-std v1.9.2 Initialized forge project // ANCHOR_END: output diff --git a/src/output/hello_foundry/forge-test b/src/output/hello_foundry/forge-test index bd9e417e5..9cdc4cb6c 100644 --- a/src/output/hello_foundry/forge-test +++ b/src/output/hello_foundry/forge-test @@ -6,10 +6,10 @@ $ forge test No files changed, compilation skipped Ran 2 tests for test/Counter.t.sol:CounterTest -[PASS] testFuzz_SetNumber(uint256) (runs: 256, μ: 31288, ~: 31288) +[PASS] testFuzz_SetNumber(uint256) (runs: 256, μ: 31132, ~: 31288) [PASS] test_Increment() (gas: 31303) -Suite result: ok. 2 passed; 0 failed; 0 skipped; finished in 5.74ms (5.33ms CPU time) +Suite result: ok. 2 passed; 0 failed; 0 skipped; finished in 8.32ms (7.95ms CPU time) -Ran 1 test suite in 6.65ms (5.74ms CPU time): 2 tests passed, 0 failed, 0 skipped (2 total tests) +Ran 1 test suite in 9.50ms (8.32ms CPU time): 2 tests passed, 0 failed, 0 skipped (2 total tests) // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/output/nft_tutorial/forge-test b/src/output/nft_tutorial/forge-test index 0f1ba6e7b..9cddfa2c3 100644 --- a/src/output/nft_tutorial/forge-test +++ b/src/output/nft_tutorial/forge-test @@ -5,17 +5,6 @@ $ forge test // ANCHOR: output No files changed, compilation skipped -Ran 8 tests for test/OpenZeppelinNft.t.sol:OpenZeppelinNftTests -[PASS] testBalanceIncremented() (gas: 217829) -[PASS] testFailMaxSupplyReached() (gas: 134524) -[PASS] testFailMintToZeroAddress() (gas: 34577) -[PASS] testFailNoMintPricePaid() (gas: 5568) -[PASS] testFailUnSafeContractReceiver() (gas: 3524) -[PASS] testMintPricePaid() (gas: 81554) -[PASS] testNewMintOwnerRegistered() (gas: 190956) -[PASS] testSafeContractReceiver() (gas: 273132) -Suite result: ok. 8 passed; 0 failed; 0 skipped; finished in 1.68ms (1.29ms CPU time) - Ran 8 tests for test/SolmateNft.sol:SolmateNftTests [PASS] testBalanceIncremented() (gas: 217400) [PASS] testFailMaxSupplyReached() (gas: 134524) @@ -25,8 +14,19 @@ Ran 8 tests for test/SolmateNft.sol:SolmateNftTests [PASS] testMintPricePaid() (gas: 81321) [PASS] testNewMintOwnerRegistered() (gas: 190741) [PASS] testSafeContractReceiver() (gas: 272636) -Suite result: ok. 8 passed; 0 failed; 0 skipped; finished in 1.68ms (1.45ms CPU time) +Suite result: ok. 8 passed; 0 failed; 0 skipped; finished in 1.60ms (1.38ms CPU time) + +Ran 8 tests for test/OpenZeppelinNft.t.sol:OpenZeppelinNftTests +[PASS] testBalanceIncremented() (gas: 217829) +[PASS] testFailMaxSupplyReached() (gas: 134524) +[PASS] testFailMintToZeroAddress() (gas: 34577) +[PASS] testFailNoMintPricePaid() (gas: 5568) +[PASS] testFailUnSafeContractReceiver() (gas: 3524) +[PASS] testMintPricePaid() (gas: 81554) +[PASS] testNewMintOwnerRegistered() (gas: 190956) +[PASS] testSafeContractReceiver() (gas: 273132) +Suite result: ok. 8 passed; 0 failed; 0 skipped; finished in 1.60ms (1.19ms CPU time) -Ran 2 test suites in 5.79ms (3.37ms CPU time): 16 tests passed, 0 failed, 0 skipped (16 total tests) +Ran 2 test suites in 5.36ms (3.20ms CPU time): 16 tests passed, 0 failed, 0 skipped (16 total tests) // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/output/test_filters/forge-test-match-contract-and-test b/src/output/test_filters/forge-test-match-contract-and-test index dac9f0883..bc3487a77 100644 --- a/src/output/test_filters/forge-test-match-contract-and-test +++ b/src/output/test_filters/forge-test-match-contract-and-test @@ -10,8 +10,8 @@ Compiler run successful! Ran 2 tests for test/ComplicatedContract.t.sol:ComplicatedContractTest [PASS] test_DepositERC20() (gas: 102193) [PASS] test_DepositETH() (gas: 61414) -Suite result: ok. 2 passed; 0 failed; 0 skipped; finished in 1.56ms (1.33ms CPU time) +Suite result: ok. 2 passed; 0 failed; 0 skipped; finished in 1.34ms (1.40ms CPU time) -Ran 1 test suite in 5.53ms (1.56ms CPU time): 2 tests passed, 0 failed, 0 skipped (2 total tests) +Ran 1 test suite in 5.44ms (1.34ms CPU time): 2 tests passed, 0 failed, 0 skipped (2 total tests) // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/output/test_filters/forge-test-match-path b/src/output/test_filters/forge-test-match-path index 0d34a57a7..34176b08e 100644 --- a/src/output/test_filters/forge-test-match-path +++ b/src/output/test_filters/forge-test-match-path @@ -4,13 +4,13 @@ $ forge test --match-path test/ContractB.t.sol // ANCHOR_END: command // ANCHOR: output Compiling 1 files with Solc 0.8.10 -Solc 0.8.10 finished in 1.05s +Solc 0.8.10 finished in 1.08s Compiler run successful! Ran 1 test for test/ContractB.t.sol:ContractBTest [PASS] testExample() (gas: 257) -Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 385.29µs (56.10µs CPU time) +Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 361.35µs (47.47µs CPU time) -Ran 1 test suite in 5.12ms (385.29µs CPU time): 1 tests passed, 0 failed, 0 skipped (1 total tests) +Ran 1 test suite in 5.06ms (361.35µs CPU time): 1 tests passed, 0 failed, 0 skipped (1 total tests) // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/reference/cli/anvil.md b/src/reference/cli/anvil.md index 3d53ee192..86562bbc5 100644 --- a/src/reference/cli/anvil.md +++ b/src/reference/cli/anvil.md @@ -105,6 +105,16 @@ Options: [default: 8545] + --preserve-historical-states + Preserve historical state snapshots when dumping the state. + + This will save the in-memory states of the chain at particular block + hashes. + + These historical states will be loaded into the memory when + `--load-state` / `--state`, and aids in RPC calls beyond the block at + which state was dumped. + --prune-history [] Don't keep full chain history. If a number argument is specified, at most this number of states is kept in memory. diff --git a/src/reference/cli/cast/access-list.md b/src/reference/cli/cast/access-list.md index add2b9acd..8cb269be6 100644 --- a/src/reference/cli/cast/access-list.md +++ b/src/reference/cli/cast/access-list.md @@ -79,6 +79,13 @@ Transaction options: Can be either a hex-encoded signed authorization or an address. + --access-list [] + EIP-2930 access list. + + Accepts either a JSON-encoded access list or an empty value to create + the access list via an RPC call to `eth_createAccessList`. To retrieve + only the access list portion, use the `cast access-list` command. + Ethereum options: -r, --rpc-url The RPC endpoint diff --git a/src/reference/cli/cast/call.md b/src/reference/cli/cast/call.md index 856e1d317..eed6ebe11 100644 --- a/src/reference/cli/cast/call.md +++ b/src/reference/cli/cast/call.md @@ -106,6 +106,13 @@ Transaction options: Can be either a hex-encoded signed authorization or an address. + --access-list [] + EIP-2930 access list. + + Accepts either a JSON-encoded access list or an empty value to create + the access list via an RPC call to `eth_createAccessList`. To retrieve + only the access list portion, use the `cast access-list` command. + Ethereum options: -r, --rpc-url The RPC endpoint diff --git a/src/reference/cli/cast/estimate.md b/src/reference/cli/cast/estimate.md index e37990083..13b3837f5 100644 --- a/src/reference/cli/cast/estimate.md +++ b/src/reference/cli/cast/estimate.md @@ -79,6 +79,13 @@ Transaction options: Can be either a hex-encoded signed authorization or an address. + --access-list [] + EIP-2930 access list. + + Accepts either a JSON-encoded access list or an empty value to create + the access list via an RPC call to `eth_createAccessList`. To retrieve + only the access list portion, use the `cast access-list` command. + Ethereum options: -r, --rpc-url The RPC endpoint diff --git a/src/reference/cli/cast/mktx.md b/src/reference/cli/cast/mktx.md index 17c7a475e..e8a91d207 100644 --- a/src/reference/cli/cast/mktx.md +++ b/src/reference/cli/cast/mktx.md @@ -76,6 +76,13 @@ Transaction options: Can be either a hex-encoded signed authorization or an address. + --access-list [] + EIP-2930 access list. + + Accepts either a JSON-encoded access list or an empty value to create + the access list via an RPC call to `eth_createAccessList`. To retrieve + only the access list portion, use the `cast access-list` command. + --path The path of blob data to be sent diff --git a/src/reference/cli/cast/send.md b/src/reference/cli/cast/send.md index dcfb087bd..67706c61e 100644 --- a/src/reference/cli/cast/send.md +++ b/src/reference/cli/cast/send.md @@ -99,6 +99,13 @@ Transaction options: Can be either a hex-encoded signed authorization or an address. + --access-list [] + EIP-2930 access list. + + Accepts either a JSON-encoded access list or an empty value to create + the access list via an RPC call to `eth_createAccessList`. To retrieve + only the access list portion, use the `cast access-list` command. + --path The path of blob data to be sent diff --git a/src/reference/cli/cast/storage.md b/src/reference/cli/cast/storage.md index 1d931a76b..2ee5cab13 100644 --- a/src/reference/cli/cast/storage.md +++ b/src/reference/cli/cast/storage.md @@ -125,7 +125,13 @@ Compiler options: Activate the Solidity optimizer --optimizer-runs - The number of optimizer runs + The number of runs specifies roughly how often each opcode of the + deployed code will be executed across the life-time of the contract. + This means it is a trade-off parameter between code size (deploy cost) + and code execution cost (cost after deployment). An `optimizer_runs` + parameter of `1` will produce short but expensive code. In contrast, a + larger `optimizer_runs` parameter will produce longer but more gas + efficient code --extra-output ... Extra output to include in the contract's artifact. diff --git a/src/reference/cli/chisel.md b/src/reference/cli/chisel.md index dd8323b30..204d837ed 100644 --- a/src/reference/cli/chisel.md +++ b/src/reference/cli/chisel.md @@ -99,7 +99,13 @@ Compiler options: Activate the Solidity optimizer --optimizer-runs - The number of optimizer runs + The number of runs specifies roughly how often each opcode of the + deployed code will be executed across the life-time of the contract. + This means it is a trade-off parameter between code size (deploy cost) + and code execution cost (cost after deployment). An `optimizer_runs` + parameter of `1` will produce short but expensive code. In contrast, a + larger `optimizer_runs` parameter will produce longer but more gas + efficient code --extra-output ... Extra output to include in the contract's artifact. diff --git a/src/reference/cli/forge/bind-json.md b/src/reference/cli/forge/bind-json.md index 1d4a2b1a0..ff59ebcd1 100644 --- a/src/reference/cli/forge/bind-json.md +++ b/src/reference/cli/forge/bind-json.md @@ -79,7 +79,13 @@ Compiler options: Activate the Solidity optimizer --optimizer-runs - The number of optimizer runs + The number of runs specifies roughly how often each opcode of the + deployed code will be executed across the life-time of the contract. + This means it is a trade-off parameter between code size (deploy cost) + and code execution cost (cost after deployment). An `optimizer_runs` + parameter of `1` will produce short but expensive code. In contrast, a + larger `optimizer_runs` parameter will produce longer but more gas + efficient code --extra-output ... Extra output to include in the contract's artifact. diff --git a/src/reference/cli/forge/bind.md b/src/reference/cli/forge/bind.md index 356e230e9..8d702a995 100644 --- a/src/reference/cli/forge/bind.md +++ b/src/reference/cli/forge/bind.md @@ -135,7 +135,13 @@ Compiler options: Activate the Solidity optimizer --optimizer-runs - The number of optimizer runs + The number of runs specifies roughly how often each opcode of the + deployed code will be executed across the life-time of the contract. + This means it is a trade-off parameter between code size (deploy cost) + and code execution cost (cost after deployment). An `optimizer_runs` + parameter of `1` will produce short but expensive code. In contrast, a + larger `optimizer_runs` parameter will produce longer but more gas + efficient code --extra-output ... Extra output to include in the contract's artifact. diff --git a/src/reference/cli/forge/build.md b/src/reference/cli/forge/build.md index 354461c3c..ff1b9b2a5 100644 --- a/src/reference/cli/forge/build.md +++ b/src/reference/cli/forge/build.md @@ -84,7 +84,13 @@ Compiler options: Activate the Solidity optimizer --optimizer-runs - The number of optimizer runs + The number of runs specifies roughly how often each opcode of the + deployed code will be executed across the life-time of the contract. + This means it is a trade-off parameter between code size (deploy cost) + and code execution cost (cost after deployment). An `optimizer_runs` + parameter of `1` will produce short but expensive code. In contrast, a + larger `optimizer_runs` parameter will produce longer but more gas + efficient code --extra-output ... Extra output to include in the contract's artifact. diff --git a/src/reference/cli/forge/config.md b/src/reference/cli/forge/config.md index 847ba23c5..c788c9802 100644 --- a/src/reference/cli/forge/config.md +++ b/src/reference/cli/forge/config.md @@ -93,7 +93,13 @@ Compiler options: Activate the Solidity optimizer --optimizer-runs - The number of optimizer runs + The number of runs specifies roughly how often each opcode of the + deployed code will be executed across the life-time of the contract. + This means it is a trade-off parameter between code size (deploy cost) + and code execution cost (cost after deployment). An `optimizer_runs` + parameter of `1` will produce short but expensive code. In contrast, a + larger `optimizer_runs` parameter will produce longer but more gas + efficient code --extra-output ... Extra output to include in the contract's artifact. diff --git a/src/reference/cli/forge/coverage.md b/src/reference/cli/forge/coverage.md index c904c0717..c97bdbdc0 100644 --- a/src/reference/cli/forge/coverage.md +++ b/src/reference/cli/forge/coverage.md @@ -376,7 +376,13 @@ Compiler options: Activate the Solidity optimizer --optimizer-runs - The number of optimizer runs + The number of runs specifies roughly how often each opcode of the + deployed code will be executed across the life-time of the contract. + This means it is a trade-off parameter between code size (deploy cost) + and code execution cost (cost after deployment). An `optimizer_runs` + parameter of `1` will produce short but expensive code. In contrast, a + larger `optimizer_runs` parameter will produce longer but more gas + efficient code --extra-output ... Extra output to include in the contract's artifact. diff --git a/src/reference/cli/forge/create.md b/src/reference/cli/forge/create.md index 3ecd62acc..e4d3d340d 100644 --- a/src/reference/cli/forge/create.md +++ b/src/reference/cli/forge/create.md @@ -107,7 +107,13 @@ Compiler options: Activate the Solidity optimizer --optimizer-runs - The number of optimizer runs + The number of runs specifies roughly how often each opcode of the + deployed code will be executed across the life-time of the contract. + This means it is a trade-off parameter between code size (deploy cost) + and code execution cost (cost after deployment). An `optimizer_runs` + parameter of `1` will produce short but expensive code. In contrast, a + larger `optimizer_runs` parameter will produce longer but more gas + efficient code --extra-output ... Extra output to include in the contract's artifact. @@ -217,6 +223,13 @@ Transaction options: Can be either a hex-encoded signed authorization or an address. + --access-list [] + EIP-2930 access list. + + Accepts either a JSON-encoded access list or an empty value to create + the access list via an RPC call to `eth_createAccessList`. To retrieve + only the access list portion, use the `cast access-list` command. + Ethereum options: -r, --rpc-url The RPC endpoint diff --git a/src/reference/cli/forge/debug.md b/src/reference/cli/forge/debug.md index 39c891a9e..f439660e9 100644 --- a/src/reference/cli/forge/debug.md +++ b/src/reference/cli/forge/debug.md @@ -99,7 +99,13 @@ Compiler options: Activate the Solidity optimizer --optimizer-runs - The number of optimizer runs + The number of runs specifies roughly how often each opcode of the + deployed code will be executed across the life-time of the contract. + This means it is a trade-off parameter between code size (deploy cost) + and code execution cost (cost after deployment). An `optimizer_runs` + parameter of `1` will produce short but expensive code. In contrast, a + larger `optimizer_runs` parameter will produce longer but more gas + efficient code --extra-output ... Extra output to include in the contract's artifact. diff --git a/src/reference/cli/forge/eip712.md b/src/reference/cli/forge/eip712.md index 3564695f7..9b14b1b5a 100644 --- a/src/reference/cli/forge/eip712.md +++ b/src/reference/cli/forge/eip712.md @@ -79,7 +79,13 @@ Compiler options: Activate the Solidity optimizer --optimizer-runs - The number of optimizer runs + The number of runs specifies roughly how often each opcode of the + deployed code will be executed across the life-time of the contract. + This means it is a trade-off parameter between code size (deploy cost) + and code execution cost (cost after deployment). An `optimizer_runs` + parameter of `1` will produce short but expensive code. In contrast, a + larger `optimizer_runs` parameter will produce longer but more gas + efficient code --extra-output ... Extra output to include in the contract's artifact. diff --git a/src/reference/cli/forge/inspect.md b/src/reference/cli/forge/inspect.md index b50664f72..efdb512aa 100644 --- a/src/reference/cli/forge/inspect.md +++ b/src/reference/cli/forge/inspect.md @@ -91,7 +91,13 @@ Compiler options: Activate the Solidity optimizer --optimizer-runs - The number of optimizer runs + The number of runs specifies roughly how often each opcode of the + deployed code will be executed across the life-time of the contract. + This means it is a trade-off parameter between code size (deploy cost) + and code execution cost (cost after deployment). An `optimizer_runs` + parameter of `1` will produce short but expensive code. In contrast, a + larger `optimizer_runs` parameter will produce longer but more gas + efficient code --extra-output ... Extra output to include in the contract's artifact. diff --git a/src/reference/cli/forge/script.md b/src/reference/cli/forge/script.md index a3a21ef04..1afbb819a 100644 --- a/src/reference/cli/forge/script.md +++ b/src/reference/cli/forge/script.md @@ -183,7 +183,13 @@ Compiler options: Activate the Solidity optimizer --optimizer-runs - The number of optimizer runs + The number of runs specifies roughly how often each opcode of the + deployed code will be executed across the life-time of the contract. + This means it is a trade-off parameter between code size (deploy cost) + and code execution cost (cost after deployment). An `optimizer_runs` + parameter of `1` will produce short but expensive code. In contrast, a + larger `optimizer_runs` parameter will produce longer but more gas + efficient code --extra-output ... Extra output to include in the contract's artifact. diff --git a/src/reference/cli/forge/selectors/collision.md b/src/reference/cli/forge/selectors/collision.md index 04cfcf8cf..f2d4b6156 100644 --- a/src/reference/cli/forge/selectors/collision.md +++ b/src/reference/cli/forge/selectors/collision.md @@ -84,7 +84,13 @@ Compiler options: Activate the Solidity optimizer --optimizer-runs - The number of optimizer runs + The number of runs specifies roughly how often each opcode of the + deployed code will be executed across the life-time of the contract. + This means it is a trade-off parameter between code size (deploy cost) + and code execution cost (cost after deployment). An `optimizer_runs` + parameter of `1` will produce short but expensive code. In contrast, a + larger `optimizer_runs` parameter will produce longer but more gas + efficient code --extra-output ... Extra output to include in the contract's artifact. diff --git a/src/reference/cli/forge/snapshot.md b/src/reference/cli/forge/snapshot.md index 32889b12a..4fa93ff0a 100644 --- a/src/reference/cli/forge/snapshot.md +++ b/src/reference/cli/forge/snapshot.md @@ -374,7 +374,13 @@ Compiler options: Activate the Solidity optimizer --optimizer-runs - The number of optimizer runs + The number of runs specifies roughly how often each opcode of the + deployed code will be executed across the life-time of the contract. + This means it is a trade-off parameter between code size (deploy cost) + and code execution cost (cost after deployment). An `optimizer_runs` + parameter of `1` will produce short but expensive code. In contrast, a + larger `optimizer_runs` parameter will produce longer but more gas + efficient code --extra-output ... Extra output to include in the contract's artifact. diff --git a/src/reference/cli/forge/test.md b/src/reference/cli/forge/test.md index 2b49e89cf..127611c88 100644 --- a/src/reference/cli/forge/test.md +++ b/src/reference/cli/forge/test.md @@ -353,7 +353,13 @@ Compiler options: Activate the Solidity optimizer --optimizer-runs - The number of optimizer runs + The number of runs specifies roughly how often each opcode of the + deployed code will be executed across the life-time of the contract. + This means it is a trade-off parameter between code size (deploy cost) + and code execution cost (cost after deployment). An `optimizer_runs` + parameter of `1` will produce short but expensive code. In contrast, a + larger `optimizer_runs` parameter will produce longer but more gas + efficient code --extra-output ... Extra output to include in the contract's artifact.