From 1d1352c029683f4e8a9a94cf303b52bae0a7f183 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mart=C3=ADn?= Date: Thu, 9 Jan 2025 00:09:38 -0300 Subject: [PATCH 1/2] Removing references to detect _missing_libraries --- src/reference/cli/cast/storage.md | 5 - src/reference/cli/forge/bind-json.md | 5 - src/reference/cli/forge/bind.md | 5 - src/reference/cli/forge/build.md | 5 - src/reference/cli/forge/config.md | 5 - src/reference/cli/forge/coverage.md | 135 ++++++++--------- src/reference/cli/forge/create.md | 111 +++++++------- src/reference/cli/forge/debug.md | 91 ++++++----- src/reference/cli/forge/eip712.md | 49 +++--- src/reference/cli/forge/inspect.md | 51 +++---- src/reference/cli/forge/script.md | 143 +++++++++--------- .../cli/forge/selectors/collision.md | 49 +++--- src/reference/cli/forge/snapshot.md | 135 ++++++++--------- src/reference/cli/forge/test.md | 127 ++++++++-------- .../limitations/compilation.md | 2 +- 15 files changed, 424 insertions(+), 494 deletions(-) diff --git a/src/reference/cli/cast/storage.md b/src/reference/cli/cast/storage.md index 6ed182623..30e226803 100644 --- a/src/reference/cli/cast/storage.md +++ b/src/reference/cli/cast/storage.md @@ -240,11 +240,6 @@ ZKSync configuration: [aliases: fallback-oz] [possible values: true, false] - --zk-detect-missing-libraries - Detect missing libraries, instead of erroring - - Currently unused - -O, --zk-optimizer-mode Set the LLVM optimization parameter `-O[0 | 1 | 2 | 3 | s | z]`. Use `3` for best performance and `z` for minimal size diff --git a/src/reference/cli/forge/bind-json.md b/src/reference/cli/forge/bind-json.md index 015d8719d..b796ffb31 100644 --- a/src/reference/cli/forge/bind-json.md +++ b/src/reference/cli/forge/bind-json.md @@ -184,11 +184,6 @@ ZKSync configuration: [aliases: fallback-oz] [possible values: true, false] - --zk-detect-missing-libraries - Detect missing libraries, instead of erroring - - Currently unused - -O, --zk-optimizer-mode Set the LLVM optimization parameter `-O[0 | 1 | 2 | 3 | s | z]`. Use `3` for best performance and `z` for minimal size diff --git a/src/reference/cli/forge/bind.md b/src/reference/cli/forge/bind.md index c05864b16..dcb3d8187 100644 --- a/src/reference/cli/forge/bind.md +++ b/src/reference/cli/forge/bind.md @@ -240,11 +240,6 @@ ZKSync configuration: [aliases: fallback-oz] [possible values: true, false] - --zk-detect-missing-libraries - Detect missing libraries, instead of erroring - - Currently unused - -O, --zk-optimizer-mode Set the LLVM optimization parameter `-O[0 | 1 | 2 | 3 | s | z]`. Use `3` for best performance and `z` for minimal size diff --git a/src/reference/cli/forge/build.md b/src/reference/cli/forge/build.md index fa7f78097..1423289d7 100644 --- a/src/reference/cli/forge/build.md +++ b/src/reference/cli/forge/build.md @@ -193,11 +193,6 @@ ZKSync configuration: [aliases: fallback-oz] [possible values: true, false] - --zk-detect-missing-libraries - Detect missing libraries, instead of erroring - - Currently unused - -O, --zk-optimizer-mode Set the LLVM optimization parameter `-O[0 | 1 | 2 | 3 | s | z]`. Use `3` for best performance and `z` for minimal size diff --git a/src/reference/cli/forge/config.md b/src/reference/cli/forge/config.md index 3e039d5b7..b801613ca 100644 --- a/src/reference/cli/forge/config.md +++ b/src/reference/cli/forge/config.md @@ -202,11 +202,6 @@ ZKSync configuration: [aliases: fallback-oz] [possible values: true, false] - --zk-detect-missing-libraries - Detect missing libraries, instead of erroring - - Currently unused - -O, --zk-optimizer-mode Set the LLVM optimization parameter `-O[0 | 1 | 2 | 3 | s | z]`. Use `3` for best performance and `z` for minimal size diff --git a/src/reference/cli/forge/coverage.md b/src/reference/cli/forge/coverage.md index 8ad716d96..972e2b2c4 100644 --- a/src/reference/cli/forge/coverage.md +++ b/src/reference/cli/forge/coverage.md @@ -12,21 +12,21 @@ Usage: forge coverage [OPTIONS] Options: --report The report type to use for coverage. - + This flag can be used multiple times. - + [default: summary] [possible values: summary, lcov, debug, bytecode] --ir-minimum Enable viaIR with minimum optimization - + This can fix most of the "stack too deep" errors while resulting a relatively accurate source map. -r, --report-file The path to output the report. - + If not specified, the report will be stored in the root of the project. @@ -39,33 +39,33 @@ Options: Test options: --debug [] Run a single test in the debugger. - + The matching test will be opened in the debugger regardless of the outcome of the test. - + If the matching test is a fuzz test, then it will open the debugger on the first failure case. If the fuzz test does not fail, it will open the debugger on the last fuzz case. --flamegraph Generate a flamegraph for a single test. Implies `--decode-internal`. - + A flame graph is used to visualize which functions or operations within the smart contract are consuming the most gas overall in a sorted manner. --flamechart Generate a flamechart for a single test. Implies `--decode-internal`. - + A flame chart shows the gas usage over time, illustrating when each function is called (execution order) and how much gas it consumes at each point in the timeline. --decode-internal [] Identify internal functions in traces. - + This will trace internal functions and decode stack parameters. - + Parameters stored in memory (such as bytes or arrays) are currently decoded only when a single function is matched, similarly to `--debug`, for performance reasons. @@ -75,12 +75,12 @@ Test options: --gas-report Print a gas report - + [env: FORGE_GAS_REPORT=] --allow-failure Exit with code 0 even if a test fails - + [env: FORGE_ALLOW_FAILURE=] --fail-fast @@ -88,7 +88,7 @@ Test options: --etherscan-api-key The Etherscan (or equivalent) API key - + [env: ETHERSCAN_API_KEY=] --fuzz-seed @@ -103,7 +103,7 @@ Test options: -j, --threads Max concurrent threads to use. Default value is the number of available CPUs - + [aliases: jobs] --show-progress @@ -139,40 +139,40 @@ Display options: Test filtering: --match-test Only run test functions matching the specified regex pattern - + [aliases: mt] --no-match-test Only run test functions that do not match the specified regex pattern - + [aliases: nmt] --match-contract Only run tests in contracts matching the specified regex pattern - + [aliases: mc] --no-match-contract Only run tests in contracts that do not match the specified regex pattern - + [aliases: nmc] --match-path Only run tests in source files matching the specified glob pattern - + [aliases: mp] --no-match-path Only run tests in source files that do not match the specified glob pattern - + [aliases: nmp] --no-match-coverage Only show coverage for files that do not match the specified regex pattern - + [aliases: nmco] --rerun @@ -183,34 +183,34 @@ EVM options: -f, --fork-url Fetch state over a remote endpoint instead of starting from an empty state. - + If you want to fetch state from a specific block number, see --fork-block-number. - + [aliases: rpc-url] --fork-block-number Fetch state from a specific block number over a remote endpoint. - + See --fork-url. --fork-retries Number of retries. - + See --fork-url. --fork-retry-backoff Initial retry backoff on encountering errors. - + See --fork-url. --no-storage-caching Explicitly disables the use of RPC caching. - + All storage slots are read entirely from the endpoint. - + This flag overrides the project's configuration file. - + See --fork-url. --initial-balance @@ -228,9 +228,9 @@ EVM options: -v, --verbosity... Verbosity of the EVM. - + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). - + Verbosity levels: - 2: Print logs for all tests - 3: Print execution traces for failing tests @@ -242,18 +242,18 @@ Fork config: --compute-units-per-second Sets the number of assumed available compute units per second for this provider - + default value: 330 - + See also --fork-url and --no-rpc-rate-limit Disables rate limiting for this node's provider. - + See also --fork-url and - + [aliases: no-rate-limit] Executor environment config: @@ -266,7 +266,7 @@ Executor environment config: --chain The chain name or EIP-155 chain ID - + [aliases: chain-id] --gas-price @@ -274,7 +274,7 @@ Executor environment config: --block-base-fee-per-gas The base fee in a block - + [aliases: base-fee] --tx-origin
@@ -301,12 +301,12 @@ Executor environment config: --memory-limit The memory limit per EVM execution in bytes. If this limit is exceeded, a `MemoryLimitOOG` result is thrown. - + The default is 128MiB. --disable-block-gas-limit Whether to disable the block gas limit checks - + [aliases: no-gas-limit] --isolate @@ -326,19 +326,19 @@ Build options: --eof Use EOF-enabled solc binary. Enables via-ir and sets EVM version to Prague. Requires Docker to be installed. - + Note that this is a temporary solution until the EOF support is merged into the main solc release. --skip ... Skip building files whose names contain the given filter. - + `test` and `script` are aliases for `.t.sol` and `.s.sol`. Linker options: --libraries Set pre-linked libraries - + [env: DAPP_LIBRARIES=] Compiler options: @@ -353,13 +353,13 @@ Compiler options: --use Specify the solc version, or a path to a local solc, to build with. - + Valid values are in the format `x.y.z`, `solc:x.y.z` or `path/to/solc`. --offline Do not access the network. - + Missing solc versions will not be installed. --via-ir @@ -367,7 +367,7 @@ Compiler options: --no-metadata Do not append any metadata to the bytecode. - + This is equivalent to setting `bytecode_hash` to `none` and `cbor_metadata` to `false`. @@ -379,7 +379,7 @@ Compiler options: --optimize [] Activate the Solidity optimizer - + [possible values: true, false] --optimizer-runs @@ -387,15 +387,15 @@ Compiler options: --extra-output ... Extra output to include in the contract's artifact. - + Example keys: evm.assembly, ewasm, ir, irOptimized, metadata - + For a full description, see --extra-output-files ... Extra output to write to separate files. - + Valid values: metadata, ir, irOptimized, ewasm, evm.assembly Project options: @@ -404,7 +404,7 @@ Project options: --revert-strings Revert string configuration. - + Possible values are "default", "strip" (remove), "debug" (Solidity-generated revert strings) and "verboseDebug" @@ -416,7 +416,7 @@ Project options: --root The project's root path. - + By default root of the Git repository, if in one, or the current working directory. @@ -437,10 +437,10 @@ Project options: --hardhat Use the Hardhat-style project layout. - + This is the same as using: `--contracts contracts --lib-paths node_modules`. - + [aliases: hh] --config-path @@ -449,13 +449,13 @@ Project options: ZKSync configuration: --zk-startup[=] Enable zkVM at startup - + [aliases: zksync] [possible values: true, false] --zk-compile[=] Compile for zkVM - + [possible values: true, false] --zk-solc-path @@ -463,13 +463,13 @@ ZKSync configuration: --zk-enable-eravm-extensions[=] Enable the system contract compilation mode. - + [aliases: enable-eravm-extensions, system-mode] [possible values: true, false] --zk-force-evmla[=] Forcibly switch to the EVM legacy assembly pipeline. - + [aliases: force-evmla] [possible values: true, false] @@ -478,19 +478,14 @@ ZKSync configuration: --zk-fallback-oz[=] Try to recompile with -Oz if the bytecode is too large - + [aliases: fallback-oz] [possible values: true, false] - --zk-detect-missing-libraries - Detect missing libraries, instead of erroring - - Currently unused - -O, --zk-optimizer-mode Set the LLVM optimization parameter `-O[0 | 1 | 2 | 3 | s | z]`. Use `3` for best performance and `z` for minimal size - + [aliases: zk-optimization] --zk-optimizer @@ -498,13 +493,13 @@ ZKSync configuration: --zk-avoid-contracts Contracts to avoid compiling on zkSync - + [aliases: avoid-contracts] Watch options: -w, --watch [...] Watch the given files or directories for changes. - + If no paths are provided, the source and test directories of the project are watched. @@ -513,21 +508,21 @@ Watch options: --run-all Explicitly re-run all tests when a change is made. - + By default, only the tests of the last modified test file are executed. --watch-delay File update debounce delay. - + During the delay, incoming change events are accumulated and only once the delay has passed, is an action taken. Note that this does not mean a command will be started: if --no-restart is given and a command is already running, the outcome of the action will be to do nothing. - + Defaults to 50ms. Parses as decimal seconds by default, but using an integer with the `ms` suffix may be more convenient. - + When using --poll mode, you'll want a larger duration, or risk overloading disk I/O. ``` diff --git a/src/reference/cli/forge/create.md b/src/reference/cli/forge/create.md index e342d278d..f11bbc95e 100644 --- a/src/reference/cli/forge/create.md +++ b/src/reference/cli/forge/create.md @@ -29,7 +29,7 @@ Options: --show-standard-json-input Prints the standard json compiler input if `--verify` is provided. - + The standard json compiler input can be used to manually submit contract verification in the browser. @@ -65,19 +65,19 @@ Build options: --eof Use EOF-enabled solc binary. Enables via-ir and sets EVM version to Prague. Requires Docker to be installed. - + Note that this is a temporary solution until the EOF support is merged into the main solc release. --skip ... Skip building files whose names contain the given filter. - + `test` and `script` are aliases for `.t.sol` and `.s.sol`. Linker options: --libraries Set pre-linked libraries - + [env: DAPP_LIBRARIES=] Compiler options: @@ -92,13 +92,13 @@ Compiler options: --use Specify the solc version, or a path to a local solc, to build with. - + Valid values are in the format `x.y.z`, `solc:x.y.z` or `path/to/solc`. --offline Do not access the network. - + Missing solc versions will not be installed. --via-ir @@ -106,7 +106,7 @@ Compiler options: --no-metadata Do not append any metadata to the bytecode. - + This is equivalent to setting `bytecode_hash` to `none` and `cbor_metadata` to `false`. @@ -118,7 +118,7 @@ Compiler options: --optimize [] Activate the Solidity optimizer - + [possible values: true, false] --optimizer-runs @@ -126,15 +126,15 @@ Compiler options: --extra-output ... Extra output to include in the contract's artifact. - + Example keys: evm.assembly, ewasm, ir, irOptimized, metadata - + For a full description, see --extra-output-files ... Extra output to write to separate files. - + Valid values: metadata, ir, irOptimized, ewasm, evm.assembly Project options: @@ -143,7 +143,7 @@ Project options: --revert-strings Revert string configuration. - + Possible values are "default", "strip" (remove), "debug" (Solidity-generated revert strings) and "verboseDebug" @@ -155,7 +155,7 @@ Project options: --root The project's root path. - + By default root of the Git repository, if in one, or the current working directory. @@ -176,10 +176,10 @@ Project options: --hardhat Use the Hardhat-style project layout. - + This is the same as using: `--contracts contracts --lib-paths node_modules`. - + [aliases: hh] --config-path @@ -188,13 +188,13 @@ Project options: ZKSync configuration: --zk-startup[=] Enable zkVM at startup - + [aliases: zksync] [possible values: true, false] --zk-compile[=] Compile for zkVM - + [possible values: true, false] --zk-solc-path @@ -202,13 +202,13 @@ ZKSync configuration: --zk-enable-eravm-extensions[=] Enable the system contract compilation mode. - + [aliases: enable-eravm-extensions, system-mode] [possible values: true, false] --zk-force-evmla[=] Forcibly switch to the EVM legacy assembly pipeline. - + [aliases: force-evmla] [possible values: true, false] @@ -217,19 +217,14 @@ ZKSync configuration: --zk-fallback-oz[=] Try to recompile with -Oz if the bytecode is too large - + [aliases: fallback-oz] [possible values: true, false] - --zk-detect-missing-libraries - Detect missing libraries, instead of erroring - - Currently unused - -O, --zk-optimizer-mode Set the LLVM optimization parameter `-O[0 | 1 | 2 | 3 | s | z]`. Use `3` for best performance and `z` for minimal size - + [aliases: zk-optimization] --zk-optimizer @@ -237,30 +232,30 @@ ZKSync configuration: --zk-avoid-contracts Contracts to avoid compiling on zkSync - + [aliases: avoid-contracts] Transaction options: --gas-limit Gas limit for the transaction - + [env: ETH_GAS_LIMIT=] --gas-price Gas price for legacy transactions, or max fee per gas for EIP1559 transactions - + [env: ETH_GAS_PRICE=] --priority-gas-price Max priority fee per gas for EIP1559 transactions - + [env: ETH_PRIORITY_GAS_PRICE=] --value Ether to send in the transaction, either specified in wei, or as a string with a unit type. - + Examples: 1ether, 10gwei, 0.01ether --nonce @@ -268,7 +263,7 @@ Transaction options: --legacy Send a legacy transaction instead of an EIP1559 transaction. - + This is automatically enabled for common networks without EIP1559. --blob @@ -276,62 +271,62 @@ Transaction options: --blob-gas-price Gas price for EIP-4844 blob transaction - + [env: ETH_BLOB_GAS_PRICE=] Ethereum options: -r, --rpc-url The RPC endpoint - + [env: ETH_RPC_URL=] --flashbots Use the Flashbots RPC URL with fast mode (). - + This shares the transaction privately with all registered builders. - + See: --jwt-secret JWT Secret for the RPC endpoint. - + The JWT secret will be used to create a JWT for a RPC. For example, the following can be used to simulate a CL `engine_forkchoiceUpdated` call: - + cast rpc --jwt-secret engine_forkchoiceUpdatedV2 '["0x6bb38c26db65749ab6e472080a3d20a2f35776494e72016d1e339593f21c59bc", "0x6bb38c26db65749ab6e472080a3d20a2f35776494e72016d1e339593f21c59bc", "0x6bb38c26db65749ab6e472080a3d20a2f35776494e72016d1e339593f21c59bc"]' - + [env: ETH_RPC_JWT_SECRET=] --rpc-timeout Timeout for the RPC request in seconds. - + The specified timeout will be used to override the default timeout for RPC requests. - + Default value: 45 - + [env: ETH_RPC_TIMEOUT=] -e, --etherscan-api-key The Etherscan (or equivalent) API key - + [env: ETHERSCAN_API_KEY=] -c, --chain The chain name or EIP-155 chain ID - + [env: CHAIN=] Wallet options - raw: -f, --from
The sender account - + [env: ETH_FROM=] -i, --interactive @@ -348,48 +343,48 @@ Wallet options - raw: --mnemonic-derivation-path The wallet derivation path. - + Works with both --mnemonic-path and hardware wallets. --mnemonic-index Use the private key from the given mnemonic index. - + Used with --mnemonic-path. - + [default: 0] --retries Number of attempts for retrying verification - + [default: 5] --delay Optional delay to apply in between verification attempts, in seconds - + [default: 5] Wallet options - keystore: --keystore Use the keystore in the given folder or file - + [env: ETH_KEYSTORE=] --account Use a keystore from the default keystores folder (~/.foundry/keystores) by its filename - + [env: ETH_KEYSTORE_ACCOUNT=] --password The keystore password. - + Used with --keystore. --password-file The keystore password file path. - + Used with --keystore. - + [env: ETH_PASSWORD=] Wallet options - hardware wallet: @@ -402,12 +397,12 @@ Wallet options - hardware wallet: Verifier options: --verifier The contract verification provider to use - + [default: etherscan] [possible values: etherscan, sourcify, blockscout, oklink] --verifier-url The verifier URL, if using a custom provider - + [env: VERIFIER_URL=] -``` \ No newline at end of file +``` diff --git a/src/reference/cli/forge/debug.md b/src/reference/cli/forge/debug.md index 107f08ad2..b45df35b2 100644 --- a/src/reference/cli/forge/debug.md +++ b/src/reference/cli/forge/debug.md @@ -12,7 +12,7 @@ Usage: forge debug [OPTIONS] [ARGS]... Arguments: The contract you want to run. Either the file path or contract name. - + If multiple contracts exist in the same file you must specify the target contract with --target-contract. @@ -22,13 +22,13 @@ Arguments: Options: --target-contract The name of the contract you want to run - + [aliases: tc] -s, --sig The signature of the function you want to call in the contract, or raw calldata - + [default: run()] --debug @@ -51,19 +51,19 @@ Build options: --eof Use EOF-enabled solc binary. Enables via-ir and sets EVM version to Prague. Requires Docker to be installed. - + Note that this is a temporary solution until the EOF support is merged into the main solc release. --skip ... Skip building files whose names contain the given filter. - + `test` and `script` are aliases for `.t.sol` and `.s.sol`. Linker options: --libraries Set pre-linked libraries - + [env: DAPP_LIBRARIES=] Compiler options: @@ -78,13 +78,13 @@ Compiler options: --use Specify the solc version, or a path to a local solc, to build with. - + Valid values are in the format `x.y.z`, `solc:x.y.z` or `path/to/solc`. --offline Do not access the network. - + Missing solc versions will not be installed. --via-ir @@ -92,7 +92,7 @@ Compiler options: --no-metadata Do not append any metadata to the bytecode. - + This is equivalent to setting `bytecode_hash` to `none` and `cbor_metadata` to `false`. @@ -104,7 +104,7 @@ Compiler options: --optimize [] Activate the Solidity optimizer - + [possible values: true, false] --optimizer-runs @@ -112,15 +112,15 @@ Compiler options: --extra-output ... Extra output to include in the contract's artifact. - + Example keys: evm.assembly, ewasm, ir, irOptimized, metadata - + For a full description, see --extra-output-files ... Extra output to write to separate files. - + Valid values: metadata, ir, irOptimized, ewasm, evm.assembly Project options: @@ -129,7 +129,7 @@ Project options: --revert-strings Revert string configuration. - + Possible values are "default", "strip" (remove), "debug" (Solidity-generated revert strings) and "verboseDebug" @@ -141,7 +141,7 @@ Project options: --root The project's root path. - + By default root of the Git repository, if in one, or the current working directory. @@ -162,10 +162,10 @@ Project options: --hardhat Use the Hardhat-style project layout. - + This is the same as using: `--contracts contracts --lib-paths node_modules`. - + [aliases: hh] --config-path @@ -174,13 +174,13 @@ Project options: ZKSync configuration: --zk-startup[=] Enable zkVM at startup - + [aliases: zksync] [possible values: true, false] --zk-compile[=] Compile for zkVM - + [possible values: true, false] --zk-solc-path @@ -188,13 +188,13 @@ ZKSync configuration: --zk-enable-eravm-extensions[=] Enable the system contract compilation mode. - + [aliases: enable-eravm-extensions, system-mode] [possible values: true, false] --zk-force-evmla[=] Forcibly switch to the EVM legacy assembly pipeline. - + [aliases: force-evmla] [possible values: true, false] @@ -203,19 +203,14 @@ ZKSync configuration: --zk-fallback-oz[=] Try to recompile with -Oz if the bytecode is too large - + [aliases: fallback-oz] [possible values: true, false] - --zk-detect-missing-libraries - Detect missing libraries, instead of erroring - - Currently unused - -O, --zk-optimizer-mode Set the LLVM optimization parameter `-O[0 | 1 | 2 | 3 | s | z]`. Use `3` for best performance and `z` for minimal size - + [aliases: zk-optimization] --zk-optimizer @@ -223,41 +218,41 @@ ZKSync configuration: --zk-avoid-contracts Contracts to avoid compiling on zkSync - + [aliases: avoid-contracts] EVM options: -f, --fork-url Fetch state over a remote endpoint instead of starting from an empty state. - + If you want to fetch state from a specific block number, see --fork-block-number. - + [aliases: rpc-url] --fork-block-number Fetch state from a specific block number over a remote endpoint. - + See --fork-url. --fork-retries Number of retries. - + See --fork-url. --fork-retry-backoff Initial retry backoff on encountering errors. - + See --fork-url. --no-storage-caching Explicitly disables the use of RPC caching. - + All storage slots are read entirely from the endpoint. - + This flag overrides the project's configuration file. - + See --fork-url. --initial-balance @@ -275,9 +270,9 @@ EVM options: -v, --verbosity... Verbosity of the EVM. - + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). - + Verbosity levels: - 2: Print logs for all tests - 3: Print execution traces for failing tests @@ -289,18 +284,18 @@ Fork config: --compute-units-per-second Sets the number of assumed available compute units per second for this provider - + default value: 330 - + See also --fork-url and --no-rpc-rate-limit Disables rate limiting for this node's provider. - + See also --fork-url and - + [aliases: no-rate-limit] Executor environment config: @@ -313,7 +308,7 @@ Executor environment config: --chain The chain name or EIP-155 chain ID - + [aliases: chain-id] --gas-price @@ -321,7 +316,7 @@ Executor environment config: --block-base-fee-per-gas The base fee in a block - + [aliases: base-fee] --tx-origin
@@ -348,12 +343,12 @@ Executor environment config: --memory-limit The memory limit per EVM execution in bytes. If this limit is exceeded, a `MemoryLimitOOG` result is thrown. - + The default is 128MiB. --disable-block-gas-limit Whether to disable the block gas limit checks - + [aliases: no-gas-limit] --isolate @@ -379,4 +374,4 @@ Display options: --verbose Use verbose output -``` \ No newline at end of file +``` diff --git a/src/reference/cli/forge/eip712.md b/src/reference/cli/forge/eip712.md index 1c7cd20e2..166867e05 100644 --- a/src/reference/cli/forge/eip712.md +++ b/src/reference/cli/forge/eip712.md @@ -28,19 +28,19 @@ Build options: --eof Use EOF-enabled solc binary. Enables via-ir and sets EVM version to Prague. Requires Docker to be installed. - + Note that this is a temporary solution until the EOF support is merged into the main solc release. --skip ... Skip building files whose names contain the given filter. - + `test` and `script` are aliases for `.t.sol` and `.s.sol`. Linker options: --libraries Set pre-linked libraries - + [env: DAPP_LIBRARIES=] Compiler options: @@ -55,13 +55,13 @@ Compiler options: --use Specify the solc version, or a path to a local solc, to build with. - + Valid values are in the format `x.y.z`, `solc:x.y.z` or `path/to/solc`. --offline Do not access the network. - + Missing solc versions will not be installed. --via-ir @@ -69,7 +69,7 @@ Compiler options: --no-metadata Do not append any metadata to the bytecode. - + This is equivalent to setting `bytecode_hash` to `none` and `cbor_metadata` to `false`. @@ -81,7 +81,7 @@ Compiler options: --optimize [] Activate the Solidity optimizer - + [possible values: true, false] --optimizer-runs @@ -89,15 +89,15 @@ Compiler options: --extra-output ... Extra output to include in the contract's artifact. - + Example keys: evm.assembly, ewasm, ir, irOptimized, metadata - + For a full description, see --extra-output-files ... Extra output to write to separate files. - + Valid values: metadata, ir, irOptimized, ewasm, evm.assembly Project options: @@ -106,7 +106,7 @@ Project options: --revert-strings Revert string configuration. - + Possible values are "default", "strip" (remove), "debug" (Solidity-generated revert strings) and "verboseDebug" @@ -118,7 +118,7 @@ Project options: --root The project's root path. - + By default root of the Git repository, if in one, or the current working directory. @@ -139,10 +139,10 @@ Project options: --hardhat Use the Hardhat-style project layout. - + This is the same as using: `--contracts contracts --lib-paths node_modules`. - + [aliases: hh] --config-path @@ -151,13 +151,13 @@ Project options: ZKSync configuration: --zk-startup[=] Enable zkVM at startup - + [aliases: zksync] [possible values: true, false] --zk-compile[=] Compile for zkVM - + [possible values: true, false] --zk-solc-path @@ -165,13 +165,13 @@ ZKSync configuration: --zk-enable-eravm-extensions[=] Enable the system contract compilation mode. - + [aliases: enable-eravm-extensions, system-mode] [possible values: true, false] --zk-force-evmla[=] Forcibly switch to the EVM legacy assembly pipeline. - + [aliases: force-evmla] [possible values: true, false] @@ -180,19 +180,14 @@ ZKSync configuration: --zk-fallback-oz[=] Try to recompile with -Oz if the bytecode is too large - + [aliases: fallback-oz] [possible values: true, false] - --zk-detect-missing-libraries - Detect missing libraries, instead of erroring - - Currently unused - -O, --zk-optimizer-mode Set the LLVM optimization parameter `-O[0 | 1 | 2 | 3 | s | z]`. Use `3` for best performance and `z` for minimal size - + [aliases: zk-optimization] --zk-optimizer @@ -200,7 +195,7 @@ ZKSync configuration: --zk-avoid-contracts Contracts to avoid compiling on zkSync - + [aliases: avoid-contracts] Display options: @@ -217,4 +212,4 @@ Display options: --verbose Use verbose output -``` \ No newline at end of file +``` diff --git a/src/reference/cli/forge/inspect.md b/src/reference/cli/forge/inspect.md index 4feeb079e..48095f98c 100644 --- a/src/reference/cli/forge/inspect.md +++ b/src/reference/cli/forge/inspect.md @@ -16,7 +16,7 @@ Arguments: The contract artifact field to inspect - + [possible values: abi, bytecode, deployedBytecode, assembly, legacyAssembly, assemblyOptimized, methodIdentifiers, gasEstimates, storageLayout, devdoc, ir, irOptimized, metadata, userdoc, ewasm, @@ -40,19 +40,19 @@ Build options: --eof Use EOF-enabled solc binary. Enables via-ir and sets EVM version to Prague. Requires Docker to be installed. - + Note that this is a temporary solution until the EOF support is merged into the main solc release. --skip ... Skip building files whose names contain the given filter. - + `test` and `script` are aliases for `.t.sol` and `.s.sol`. Linker options: --libraries Set pre-linked libraries - + [env: DAPP_LIBRARIES=] Compiler options: @@ -67,13 +67,13 @@ Compiler options: --use Specify the solc version, or a path to a local solc, to build with. - + Valid values are in the format `x.y.z`, `solc:x.y.z` or `path/to/solc`. --offline Do not access the network. - + Missing solc versions will not be installed. --via-ir @@ -81,7 +81,7 @@ Compiler options: --no-metadata Do not append any metadata to the bytecode. - + This is equivalent to setting `bytecode_hash` to `none` and `cbor_metadata` to `false`. @@ -93,7 +93,7 @@ Compiler options: --optimize [] Activate the Solidity optimizer - + [possible values: true, false] --optimizer-runs @@ -101,15 +101,15 @@ Compiler options: --extra-output ... Extra output to include in the contract's artifact. - + Example keys: evm.assembly, ewasm, ir, irOptimized, metadata - + For a full description, see --extra-output-files ... Extra output to write to separate files. - + Valid values: metadata, ir, irOptimized, ewasm, evm.assembly Project options: @@ -118,7 +118,7 @@ Project options: --revert-strings Revert string configuration. - + Possible values are "default", "strip" (remove), "debug" (Solidity-generated revert strings) and "verboseDebug" @@ -130,7 +130,7 @@ Project options: --root The project's root path. - + By default root of the Git repository, if in one, or the current working directory. @@ -151,10 +151,10 @@ Project options: --hardhat Use the Hardhat-style project layout. - + This is the same as using: `--contracts contracts --lib-paths node_modules`. - + [aliases: hh] --config-path @@ -163,13 +163,13 @@ Project options: ZKSync configuration: --zk-startup[=] Enable zkVM at startup - + [aliases: zksync] [possible values: true, false] --zk-compile[=] Compile for zkVM - + [possible values: true, false] --zk-solc-path @@ -177,13 +177,13 @@ ZKSync configuration: --zk-enable-eravm-extensions[=] Enable the system contract compilation mode. - + [aliases: enable-eravm-extensions, system-mode] [possible values: true, false] --zk-force-evmla[=] Forcibly switch to the EVM legacy assembly pipeline. - + [aliases: force-evmla] [possible values: true, false] @@ -192,19 +192,14 @@ ZKSync configuration: --zk-fallback-oz[=] Try to recompile with -Oz if the bytecode is too large - + [aliases: fallback-oz] [possible values: true, false] - --zk-detect-missing-libraries - Detect missing libraries, instead of erroring - - Currently unused - -O, --zk-optimizer-mode Set the LLVM optimization parameter `-O[0 | 1 | 2 | 3 | s | z]`. Use `3` for best performance and `z` for minimal size - + [aliases: zk-optimization] --zk-optimizer @@ -212,7 +207,7 @@ ZKSync configuration: --zk-avoid-contracts Contracts to avoid compiling on zkSync - + [aliases: avoid-contracts] Display options: @@ -229,4 +224,4 @@ Display options: --verbose Use verbose output -``` \ No newline at end of file +``` diff --git a/src/reference/cli/forge/script.md b/src/reference/cli/forge/script.md index 455147280..a61bb22eb 100644 --- a/src/reference/cli/forge/script.md +++ b/src/reference/cli/forge/script.md @@ -12,7 +12,7 @@ Usage: forge script [OPTIONS] [ARGS]... Arguments: The contract you want to run. Either the file path or contract name. - + If multiple contracts exist in the same file you must specify the target contract with --target-contract. @@ -22,23 +22,23 @@ Arguments: Options: --target-contract The name of the contract you want to run - + [aliases: tc] -s, --sig The signature of the function you want to call in the contract, or raw calldata - + [default: run()] --priority-gas-price Max priority fee per gas for EIP1559 transactions - + [env: ETH_PRIORITY_GAS_PRICE=] --legacy Use legacy transactions instead of EIP1559 ones. - + This is auto-enabled for common networks without EIP1559. --broadcast @@ -46,10 +46,10 @@ Options: --batch-size Batch size of transactions. - + This is ignored and set to 1 if batching is not available or `--slow` is enabled. - + [default: 100] --skip-simulation @@ -57,7 +57,7 @@ Options: -g, --gas-estimate-multiplier Relative percentage to multiply gas estimates by - + [default: 130] --unlocked @@ -66,10 +66,10 @@ Options: --resume Resumes submitting transactions that failed or timed-out previously. - + It DOES NOT simulate the script again and it expects nonces to have remained the same. - + Example: If transaction N has a nonce of 22, then the account should have a nonce of 22, otherwise it fails. @@ -79,7 +79,7 @@ Options: --debug Open the script in the debugger. - + Takes precedence over broadcast. --dump @@ -92,13 +92,13 @@ Options: --non-interactive Disables interactive prompts that might appear when deploying big contracts. - + For more info on the contract size limit, see EIP-170: --etherscan-api-key The Etherscan (or equivalent) API key - + [env: ETHERSCAN_API_KEY=] --verify @@ -110,7 +110,7 @@ Options: --with-gas-price Gas price for legacy transactions, or max fee per gas for EIP1559 transactions - + [env: ETH_GAS_PRICE=] -h, --help @@ -127,19 +127,19 @@ Build options: --eof Use EOF-enabled solc binary. Enables via-ir and sets EVM version to Prague. Requires Docker to be installed. - + Note that this is a temporary solution until the EOF support is merged into the main solc release. --skip ... Skip building files whose names contain the given filter. - + `test` and `script` are aliases for `.t.sol` and `.s.sol`. Linker options: --libraries Set pre-linked libraries - + [env: DAPP_LIBRARIES=] Compiler options: @@ -154,13 +154,13 @@ Compiler options: --use Specify the solc version, or a path to a local solc, to build with. - + Valid values are in the format `x.y.z`, `solc:x.y.z` or `path/to/solc`. --offline Do not access the network. - + Missing solc versions will not be installed. --via-ir @@ -168,7 +168,7 @@ Compiler options: --no-metadata Do not append any metadata to the bytecode. - + This is equivalent to setting `bytecode_hash` to `none` and `cbor_metadata` to `false`. @@ -180,7 +180,7 @@ Compiler options: --optimize [] Activate the Solidity optimizer - + [possible values: true, false] --optimizer-runs @@ -188,15 +188,15 @@ Compiler options: --extra-output ... Extra output to include in the contract's artifact. - + Example keys: evm.assembly, ewasm, ir, irOptimized, metadata - + For a full description, see --extra-output-files ... Extra output to write to separate files. - + Valid values: metadata, ir, irOptimized, ewasm, evm.assembly Project options: @@ -205,7 +205,7 @@ Project options: --revert-strings Revert string configuration. - + Possible values are "default", "strip" (remove), "debug" (Solidity-generated revert strings) and "verboseDebug" @@ -217,7 +217,7 @@ Project options: --root The project's root path. - + By default root of the Git repository, if in one, or the current working directory. @@ -238,10 +238,10 @@ Project options: --hardhat Use the Hardhat-style project layout. - + This is the same as using: `--contracts contracts --lib-paths node_modules`. - + [aliases: hh] --config-path @@ -250,13 +250,13 @@ Project options: ZKSync configuration: --zk-startup[=] Enable zkVM at startup - + [aliases: zksync] [possible values: true, false] --zk-compile[=] Compile for zkVM - + [possible values: true, false] --zk-solc-path @@ -264,13 +264,13 @@ ZKSync configuration: --zk-enable-eravm-extensions[=] Enable the system contract compilation mode. - + [aliases: enable-eravm-extensions, system-mode] [possible values: true, false] --zk-force-evmla[=] Forcibly switch to the EVM legacy assembly pipeline. - + [aliases: force-evmla] [possible values: true, false] @@ -279,19 +279,14 @@ ZKSync configuration: --zk-fallback-oz[=] Try to recompile with -Oz if the bytecode is too large - + [aliases: fallback-oz] [possible values: true, false] - --zk-detect-missing-libraries - Detect missing libraries, instead of erroring - - Currently unused - -O, --zk-optimizer-mode Set the LLVM optimization parameter `-O[0 | 1 | 2 | 3 | s | z]`. Use `3` for best performance and `z` for minimal size - + [aliases: zk-optimization] --zk-optimizer @@ -299,20 +294,20 @@ ZKSync configuration: --zk-avoid-contracts Contracts to avoid compiling on zkSync - + [aliases: avoid-contracts] Wallet options - raw: -a, --froms [...] The sender accounts - + [env: ETH_FROM=] -i, --interactives Open an interactive prompt to enter your private key. - + Takes a value for the number of keys to enter. - + [default: 0] --private-keys @@ -329,40 +324,40 @@ Wallet options - raw: --mnemonic-derivation-paths The wallet derivation path. - + Works with both --mnemonic-path and hardware wallets. --mnemonic-indexes Use the private key from the given mnemonic index. - + Can be used with --mnemonics, --ledger, --aws and --trezor. - + [default: 0] Wallet options - keystore: --keystore Use the keystore by its filename in the given folder - + [env: ETH_KEYSTORE=] [aliases: keystores] --account Use a keystore from the default keystores folder (~/.foundry/keystores) by its filename - + [env: ETH_KEYSTORE_ACCOUNT=] [aliases: accounts] --password The keystore password. - + Used with --keystore. --password-file The keystore password file path. - + Used with --keystore. - + [env: ETH_PASSWORD=] Wallet options - hardware wallet: @@ -376,34 +371,34 @@ EVM options: -f, --fork-url Fetch state over a remote endpoint instead of starting from an empty state. - + If you want to fetch state from a specific block number, see --fork-block-number. - + [aliases: rpc-url] --fork-block-number Fetch state from a specific block number over a remote endpoint. - + See --fork-url. --fork-retries Number of retries. - + See --fork-url. --fork-retry-backoff Initial retry backoff on encountering errors. - + See --fork-url. --no-storage-caching Explicitly disables the use of RPC caching. - + All storage slots are read entirely from the endpoint. - + This flag overrides the project's configuration file. - + See --fork-url. --initial-balance @@ -421,9 +416,9 @@ EVM options: -v, --verbosity... Verbosity of the EVM. - + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). - + Verbosity levels: - 2: Print logs for all tests - 3: Print execution traces for failing tests @@ -435,18 +430,18 @@ Fork config: --compute-units-per-second Sets the number of assumed available compute units per second for this provider - + default value: 330 - + See also --fork-url and --no-rpc-rate-limit Disables rate limiting for this node's provider. - + See also --fork-url and - + [aliases: no-rate-limit] Executor environment config: @@ -459,7 +454,7 @@ Executor environment config: --chain The chain name or EIP-155 chain ID - + [aliases: chain-id] --gas-price @@ -467,7 +462,7 @@ Executor environment config: --block-base-fee-per-gas The base fee in a block - + [aliases: base-fee] --tx-origin
@@ -494,12 +489,12 @@ Executor environment config: --memory-limit The memory limit per EVM execution in bytes. If this limit is exceeded, a `MemoryLimitOOG` result is thrown. - + The default is 128MiB. --disable-block-gas-limit Whether to disable the block gas limit checks - + [aliases: no-gas-limit] --isolate @@ -510,24 +505,24 @@ Executor environment config: --retries Number of attempts for retrying verification - + [default: 5] --delay Optional delay to apply in between verification attempts, in seconds - + [default: 5] Verifier options: --verifier The contract verification provider to use - + [default: etherscan] [possible values: etherscan, sourcify, blockscout, oklink] --verifier-url The verifier URL, if using a custom provider - + [env: VERIFIER_URL=] Display options: @@ -544,4 +539,4 @@ Display options: --verbose Use verbose output -``` \ No newline at end of file +``` diff --git a/src/reference/cli/forge/selectors/collision.md b/src/reference/cli/forge/selectors/collision.md index 516016c55..3573e285c 100644 --- a/src/reference/cli/forge/selectors/collision.md +++ b/src/reference/cli/forge/selectors/collision.md @@ -33,19 +33,19 @@ Build options: --eof Use EOF-enabled solc binary. Enables via-ir and sets EVM version to Prague. Requires Docker to be installed. - + Note that this is a temporary solution until the EOF support is merged into the main solc release. --skip ... Skip building files whose names contain the given filter. - + `test` and `script` are aliases for `.t.sol` and `.s.sol`. Linker options: --libraries Set pre-linked libraries - + [env: DAPP_LIBRARIES=] Compiler options: @@ -60,13 +60,13 @@ Compiler options: --use Specify the solc version, or a path to a local solc, to build with. - + Valid values are in the format `x.y.z`, `solc:x.y.z` or `path/to/solc`. --offline Do not access the network. - + Missing solc versions will not be installed. --via-ir @@ -74,7 +74,7 @@ Compiler options: --no-metadata Do not append any metadata to the bytecode. - + This is equivalent to setting `bytecode_hash` to `none` and `cbor_metadata` to `false`. @@ -86,7 +86,7 @@ Compiler options: --optimize [] Activate the Solidity optimizer - + [possible values: true, false] --optimizer-runs @@ -94,15 +94,15 @@ Compiler options: --extra-output ... Extra output to include in the contract's artifact. - + Example keys: evm.assembly, ewasm, ir, irOptimized, metadata - + For a full description, see --extra-output-files ... Extra output to write to separate files. - + Valid values: metadata, ir, irOptimized, ewasm, evm.assembly Project options: @@ -111,7 +111,7 @@ Project options: --revert-strings Revert string configuration. - + Possible values are "default", "strip" (remove), "debug" (Solidity-generated revert strings) and "verboseDebug" @@ -123,7 +123,7 @@ Project options: --root The project's root path. - + By default root of the Git repository, if in one, or the current working directory. @@ -144,10 +144,10 @@ Project options: --hardhat Use the Hardhat-style project layout. - + This is the same as using: `--contracts contracts --lib-paths node_modules`. - + [aliases: hh] --config-path @@ -156,13 +156,13 @@ Project options: ZKSync configuration: --zk-startup[=] Enable zkVM at startup - + [aliases: zksync] [possible values: true, false] --zk-compile[=] Compile for zkVM - + [possible values: true, false] --zk-solc-path @@ -170,13 +170,13 @@ ZKSync configuration: --zk-enable-eravm-extensions[=] Enable the system contract compilation mode. - + [aliases: enable-eravm-extensions, system-mode] [possible values: true, false] --zk-force-evmla[=] Forcibly switch to the EVM legacy assembly pipeline. - + [aliases: force-evmla] [possible values: true, false] @@ -185,19 +185,14 @@ ZKSync configuration: --zk-fallback-oz[=] Try to recompile with -Oz if the bytecode is too large - + [aliases: fallback-oz] [possible values: true, false] - --zk-detect-missing-libraries - Detect missing libraries, instead of erroring - - Currently unused - -O, --zk-optimizer-mode Set the LLVM optimization parameter `-O[0 | 1 | 2 | 3 | s | z]`. Use `3` for best performance and `z` for minimal size - + [aliases: zk-optimization] --zk-optimizer @@ -205,7 +200,7 @@ ZKSync configuration: --zk-avoid-contracts Contracts to avoid compiling on zkSync - + [aliases: avoid-contracts] Display options: @@ -222,4 +217,4 @@ Display options: --verbose Use verbose output -``` \ No newline at end of file +``` diff --git a/src/reference/cli/forge/snapshot.md b/src/reference/cli/forge/snapshot.md index 14fa3b689..4ef6615da 100644 --- a/src/reference/cli/forge/snapshot.md +++ b/src/reference/cli/forge/snapshot.md @@ -12,20 +12,20 @@ Usage: forge snapshot [OPTIONS] Options: --diff [] Output a diff against a pre-existing gas snapshot. - + By default, the comparison is done with .gas-snapshot. --check [] Compare against a pre-existing gas snapshot, exiting with code 1 if they do not match. - + Outputs a diff if the gas snapshots do not match. - + By default, the comparison is done with .gas-snapshot. --snap Output file for the gas snapshot - + [default: .gas-snapshot] --tolerance @@ -37,33 +37,33 @@ Options: Test options: --debug [] Run a single test in the debugger. - + The matching test will be opened in the debugger regardless of the outcome of the test. - + If the matching test is a fuzz test, then it will open the debugger on the first failure case. If the fuzz test does not fail, it will open the debugger on the last fuzz case. --flamegraph Generate a flamegraph for a single test. Implies `--decode-internal`. - + A flame graph is used to visualize which functions or operations within the smart contract are consuming the most gas overall in a sorted manner. --flamechart Generate a flamechart for a single test. Implies `--decode-internal`. - + A flame chart shows the gas usage over time, illustrating when each function is called (execution order) and how much gas it consumes at each point in the timeline. --decode-internal [] Identify internal functions in traces. - + This will trace internal functions and decode stack parameters. - + Parameters stored in memory (such as bytes or arrays) are currently decoded only when a single function is matched, similarly to `--debug`, for performance reasons. @@ -73,12 +73,12 @@ Test options: --gas-report Print a gas report - + [env: FORGE_GAS_REPORT=] --allow-failure Exit with code 0 even if a test fails - + [env: FORGE_ALLOW_FAILURE=] --fail-fast @@ -86,7 +86,7 @@ Test options: --etherscan-api-key The Etherscan (or equivalent) API key - + [env: ETHERSCAN_API_KEY=] --fuzz-seed @@ -101,7 +101,7 @@ Test options: -j, --threads Max concurrent threads to use. Default value is the number of available CPUs - + [aliases: jobs] --show-progress @@ -137,40 +137,40 @@ Display options: Test filtering: --match-test Only run test functions matching the specified regex pattern - + [aliases: mt] --no-match-test Only run test functions that do not match the specified regex pattern - + [aliases: nmt] --match-contract Only run tests in contracts matching the specified regex pattern - + [aliases: mc] --no-match-contract Only run tests in contracts that do not match the specified regex pattern - + [aliases: nmc] --match-path Only run tests in source files matching the specified glob pattern - + [aliases: mp] --no-match-path Only run tests in source files that do not match the specified glob pattern - + [aliases: nmp] --no-match-coverage Only show coverage for files that do not match the specified regex pattern - + [aliases: nmco] --rerun @@ -181,34 +181,34 @@ EVM options: -f, --fork-url Fetch state over a remote endpoint instead of starting from an empty state. - + If you want to fetch state from a specific block number, see --fork-block-number. - + [aliases: rpc-url] --fork-block-number Fetch state from a specific block number over a remote endpoint. - + See --fork-url. --fork-retries Number of retries. - + See --fork-url. --fork-retry-backoff Initial retry backoff on encountering errors. - + See --fork-url. --no-storage-caching Explicitly disables the use of RPC caching. - + All storage slots are read entirely from the endpoint. - + This flag overrides the project's configuration file. - + See --fork-url. --initial-balance @@ -226,9 +226,9 @@ EVM options: -v, --verbosity... Verbosity of the EVM. - + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). - + Verbosity levels: - 2: Print logs for all tests - 3: Print execution traces for failing tests @@ -240,18 +240,18 @@ Fork config: --compute-units-per-second Sets the number of assumed available compute units per second for this provider - + default value: 330 - + See also --fork-url and --no-rpc-rate-limit Disables rate limiting for this node's provider. - + See also --fork-url and - + [aliases: no-rate-limit] Executor environment config: @@ -264,7 +264,7 @@ Executor environment config: --chain The chain name or EIP-155 chain ID - + [aliases: chain-id] --gas-price @@ -272,7 +272,7 @@ Executor environment config: --block-base-fee-per-gas The base fee in a block - + [aliases: base-fee] --tx-origin
@@ -299,12 +299,12 @@ Executor environment config: --memory-limit The memory limit per EVM execution in bytes. If this limit is exceeded, a `MemoryLimitOOG` result is thrown. - + The default is 128MiB. --disable-block-gas-limit Whether to disable the block gas limit checks - + [aliases: no-gas-limit] --isolate @@ -324,19 +324,19 @@ Build options: --eof Use EOF-enabled solc binary. Enables via-ir and sets EVM version to Prague. Requires Docker to be installed. - + Note that this is a temporary solution until the EOF support is merged into the main solc release. --skip ... Skip building files whose names contain the given filter. - + `test` and `script` are aliases for `.t.sol` and `.s.sol`. Linker options: --libraries Set pre-linked libraries - + [env: DAPP_LIBRARIES=] Compiler options: @@ -351,13 +351,13 @@ Compiler options: --use Specify the solc version, or a path to a local solc, to build with. - + Valid values are in the format `x.y.z`, `solc:x.y.z` or `path/to/solc`. --offline Do not access the network. - + Missing solc versions will not be installed. --via-ir @@ -365,7 +365,7 @@ Compiler options: --no-metadata Do not append any metadata to the bytecode. - + This is equivalent to setting `bytecode_hash` to `none` and `cbor_metadata` to `false`. @@ -377,7 +377,7 @@ Compiler options: --optimize [] Activate the Solidity optimizer - + [possible values: true, false] --optimizer-runs @@ -385,15 +385,15 @@ Compiler options: --extra-output ... Extra output to include in the contract's artifact. - + Example keys: evm.assembly, ewasm, ir, irOptimized, metadata - + For a full description, see --extra-output-files ... Extra output to write to separate files. - + Valid values: metadata, ir, irOptimized, ewasm, evm.assembly Project options: @@ -402,7 +402,7 @@ Project options: --revert-strings Revert string configuration. - + Possible values are "default", "strip" (remove), "debug" (Solidity-generated revert strings) and "verboseDebug" @@ -414,7 +414,7 @@ Project options: --root The project's root path. - + By default root of the Git repository, if in one, or the current working directory. @@ -435,10 +435,10 @@ Project options: --hardhat Use the Hardhat-style project layout. - + This is the same as using: `--contracts contracts --lib-paths node_modules`. - + [aliases: hh] --config-path @@ -447,13 +447,13 @@ Project options: ZKSync configuration: --zk-startup[=] Enable zkVM at startup - + [aliases: zksync] [possible values: true, false] --zk-compile[=] Compile for zkVM - + [possible values: true, false] --zk-solc-path @@ -461,13 +461,13 @@ ZKSync configuration: --zk-enable-eravm-extensions[=] Enable the system contract compilation mode. - + [aliases: enable-eravm-extensions, system-mode] [possible values: true, false] --zk-force-evmla[=] Forcibly switch to the EVM legacy assembly pipeline. - + [aliases: force-evmla] [possible values: true, false] @@ -476,19 +476,14 @@ ZKSync configuration: --zk-fallback-oz[=] Try to recompile with -Oz if the bytecode is too large - + [aliases: fallback-oz] [possible values: true, false] - --zk-detect-missing-libraries - Detect missing libraries, instead of erroring - - Currently unused - -O, --zk-optimizer-mode Set the LLVM optimization parameter `-O[0 | 1 | 2 | 3 | s | z]`. Use `3` for best performance and `z` for minimal size - + [aliases: zk-optimization] --zk-optimizer @@ -496,13 +491,13 @@ ZKSync configuration: --zk-avoid-contracts Contracts to avoid compiling on zkSync - + [aliases: avoid-contracts] Watch options: -w, --watch [...] Watch the given files or directories for changes. - + If no paths are provided, the source and test directories of the project are watched. @@ -511,21 +506,21 @@ Watch options: --run-all Explicitly re-run all tests when a change is made. - + By default, only the tests of the last modified test file are executed. --watch-delay File update debounce delay. - + During the delay, incoming change events are accumulated and only once the delay has passed, is an action taken. Note that this does not mean a command will be started: if --no-restart is given and a command is already running, the outcome of the action will be to do nothing. - + Defaults to 50ms. Parses as decimal seconds by default, but using an integer with the `ms` suffix may be more convenient. - + When using --poll mode, you'll want a larger duration, or risk overloading disk I/O. diff --git a/src/reference/cli/forge/test.md b/src/reference/cli/forge/test.md index 5ed092cb3..d503af930 100644 --- a/src/reference/cli/forge/test.md +++ b/src/reference/cli/forge/test.md @@ -16,33 +16,33 @@ Options: Test options: --debug [] Run a single test in the debugger. - + The matching test will be opened in the debugger regardless of the outcome of the test. - + If the matching test is a fuzz test, then it will open the debugger on the first failure case. If the fuzz test does not fail, it will open the debugger on the last fuzz case. --flamegraph Generate a flamegraph for a single test. Implies `--decode-internal`. - + A flame graph is used to visualize which functions or operations within the smart contract are consuming the most gas overall in a sorted manner. --flamechart Generate a flamechart for a single test. Implies `--decode-internal`. - + A flame chart shows the gas usage over time, illustrating when each function is called (execution order) and how much gas it consumes at each point in the timeline. --decode-internal [] Identify internal functions in traces. - + This will trace internal functions and decode stack parameters. - + Parameters stored in memory (such as bytes or arrays) are currently decoded only when a single function is matched, similarly to `--debug`, for performance reasons. @@ -52,12 +52,12 @@ Test options: --gas-report Print a gas report - + [env: FORGE_GAS_REPORT=] --allow-failure Exit with code 0 even if a test fails - + [env: FORGE_ALLOW_FAILURE=] --fail-fast @@ -65,7 +65,7 @@ Test options: --etherscan-api-key The Etherscan (or equivalent) API key - + [env: ETHERSCAN_API_KEY=] --fuzz-seed @@ -80,7 +80,7 @@ Test options: -j, --threads Max concurrent threads to use. Default value is the number of available CPUs - + [aliases: jobs] --show-progress @@ -116,40 +116,40 @@ Display options: Test filtering: --match-test Only run test functions matching the specified regex pattern - + [aliases: mt] --no-match-test Only run test functions that do not match the specified regex pattern - + [aliases: nmt] --match-contract Only run tests in contracts matching the specified regex pattern - + [aliases: mc] --no-match-contract Only run tests in contracts that do not match the specified regex pattern - + [aliases: nmc] --match-path Only run tests in source files matching the specified glob pattern - + [aliases: mp] --no-match-path Only run tests in source files that do not match the specified glob pattern - + [aliases: nmp] --no-match-coverage Only show coverage for files that do not match the specified regex pattern - + [aliases: nmco] --rerun @@ -160,34 +160,34 @@ EVM options: -f, --fork-url Fetch state over a remote endpoint instead of starting from an empty state. - + If you want to fetch state from a specific block number, see --fork-block-number. - + [aliases: rpc-url] --fork-block-number Fetch state from a specific block number over a remote endpoint. - + See --fork-url. --fork-retries Number of retries. - + See --fork-url. --fork-retry-backoff Initial retry backoff on encountering errors. - + See --fork-url. --no-storage-caching Explicitly disables the use of RPC caching. - + All storage slots are read entirely from the endpoint. - + This flag overrides the project's configuration file. - + See --fork-url. --initial-balance @@ -205,9 +205,9 @@ EVM options: -v, --verbosity... Verbosity of the EVM. - + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). - + Verbosity levels: - 2: Print logs for all tests - 3: Print execution traces for failing tests @@ -219,18 +219,18 @@ Fork config: --compute-units-per-second Sets the number of assumed available compute units per second for this provider - + default value: 330 - + See also --fork-url and --no-rpc-rate-limit Disables rate limiting for this node's provider. - + See also --fork-url and - + [aliases: no-rate-limit] Executor environment config: @@ -243,7 +243,7 @@ Executor environment config: --chain The chain name or EIP-155 chain ID - + [aliases: chain-id] --gas-price @@ -251,7 +251,7 @@ Executor environment config: --block-base-fee-per-gas The base fee in a block - + [aliases: base-fee] --tx-origin
@@ -278,12 +278,12 @@ Executor environment config: --memory-limit The memory limit per EVM execution in bytes. If this limit is exceeded, a `MemoryLimitOOG` result is thrown. - + The default is 128MiB. --disable-block-gas-limit Whether to disable the block gas limit checks - + [aliases: no-gas-limit] --isolate @@ -303,19 +303,19 @@ Build options: --eof Use EOF-enabled solc binary. Enables via-ir and sets EVM version to Prague. Requires Docker to be installed. - + Note that this is a temporary solution until the EOF support is merged into the main solc release. --skip ... Skip building files whose names contain the given filter. - + `test` and `script` are aliases for `.t.sol` and `.s.sol`. Linker options: --libraries Set pre-linked libraries - + [env: DAPP_LIBRARIES=] Compiler options: @@ -330,13 +330,13 @@ Compiler options: --use Specify the solc version, or a path to a local solc, to build with. - + Valid values are in the format `x.y.z`, `solc:x.y.z` or `path/to/solc`. --offline Do not access the network. - + Missing solc versions will not be installed. --via-ir @@ -344,7 +344,7 @@ Compiler options: --no-metadata Do not append any metadata to the bytecode. - + This is equivalent to setting `bytecode_hash` to `none` and `cbor_metadata` to `false`. @@ -356,7 +356,7 @@ Compiler options: --optimize [] Activate the Solidity optimizer - + [possible values: true, false] --optimizer-runs @@ -364,15 +364,15 @@ Compiler options: --extra-output ... Extra output to include in the contract's artifact. - + Example keys: evm.assembly, ewasm, ir, irOptimized, metadata - + For a full description, see --extra-output-files ... Extra output to write to separate files. - + Valid values: metadata, ir, irOptimized, ewasm, evm.assembly Project options: @@ -381,7 +381,7 @@ Project options: --revert-strings Revert string configuration. - + Possible values are "default", "strip" (remove), "debug" (Solidity-generated revert strings) and "verboseDebug" @@ -393,7 +393,7 @@ Project options: --root The project's root path. - + By default root of the Git repository, if in one, or the current working directory. @@ -414,10 +414,10 @@ Project options: --hardhat Use the Hardhat-style project layout. - + This is the same as using: `--contracts contracts --lib-paths node_modules`. - + [aliases: hh] --config-path @@ -426,13 +426,13 @@ Project options: ZKSync configuration: --zk-startup[=] Enable zkVM at startup - + [aliases: zksync] [possible values: true, false] --zk-compile[=] Compile for zkVM - + [possible values: true, false] --zk-solc-path @@ -440,13 +440,13 @@ ZKSync configuration: --zk-enable-eravm-extensions[=] Enable the system contract compilation mode. - + [aliases: enable-eravm-extensions, system-mode] [possible values: true, false] --zk-force-evmla[=] Forcibly switch to the EVM legacy assembly pipeline. - + [aliases: force-evmla] [possible values: true, false] @@ -455,19 +455,14 @@ ZKSync configuration: --zk-fallback-oz[=] Try to recompile with -Oz if the bytecode is too large - + [aliases: fallback-oz] [possible values: true, false] - --zk-detect-missing-libraries - Detect missing libraries, instead of erroring - - Currently unused - -O, --zk-optimizer-mode Set the LLVM optimization parameter `-O[0 | 1 | 2 | 3 | s | z]`. Use `3` for best performance and `z` for minimal size - + [aliases: zk-optimization] --zk-optimizer @@ -475,13 +470,13 @@ ZKSync configuration: --zk-avoid-contracts Contracts to avoid compiling on zkSync - + [aliases: avoid-contracts] Watch options: -w, --watch [...] Watch the given files or directories for changes. - + If no paths are provided, the source and test directories of the project are watched. @@ -490,21 +485,21 @@ Watch options: --run-all Explicitly re-run all tests when a change is made. - + By default, only the tests of the last modified test file are executed. --watch-delay File update debounce delay. - + During the delay, incoming change events are accumulated and only once the delay has passed, is an action taken. Note that this does not mean a command will be started: if --no-restart is given and a command is already running, the outcome of the action will be to do nothing. - + Defaults to 50ms. Parses as decimal seconds by default, but using an integer with the `ms` suffix may be more convenient. - + When using --poll mode, you'll want a larger duration, or risk overloading disk I/O. ``` diff --git a/src/zksync-specifics/limitations/compilation.md b/src/zksync-specifics/limitations/compilation.md index be983af0d..c9f61ae00 100644 --- a/src/zksync-specifics/limitations/compilation.md +++ b/src/zksync-specifics/limitations/compilation.md @@ -104,6 +104,6 @@ Please refer to [official docs](https://docs.zksync.io/build/developer-reference #### Listing missing libraries -To scan missing non-inlinable libraries, you can build the project using the `--zk-detect-missing-libraries` flag. This will list the libraries that must be deployed and their addresses provided via the `libraries` option for the contracts to compile. Metadata about the libraries will be saved in `.zksolc-libraries-cache/missing_library_dependencies.json`. +To scan missing non-inlinable libraries, you can build the project using the `--json` flag. This will list the libraries that must be deployed and their addresses provided via the `libraries` option for the contracts to compile. From e5744720a08b41cc5a50e97e6c411cfe40ac8ffc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mart=C3=ADn?= Date: Thu, 9 Jan 2025 11:08:17 -0300 Subject: [PATCH 2/2] running ./scripts/gen_output.sh --- src/output/cheatcodes/forge-test-cheatcodes | 8 +- .../forge-test-cheatcodes-expectrevert | 6 +- .../cheatcodes/forge-test-cheatcodes-tracing | 10 +- src/output/cheatcodes/forge-test-simple | 10 +- src/output/deps/forge-install | 2 +- src/output/deps/tree | 2 +- src/output/foundry-template/forge-build | 4 +- src/output/foundry-template/forge-test | 16 +- src/output/fuzz_testing/forge-test-fail-fuzz | 15 +- src/output/fuzz_testing/forge-test-no-fuzz | 12 +- src/output/hello_foundry/forge-build | 4 +- src/output/hello_foundry/forge-init | 10 +- src/output/hello_foundry/forge-test | 10 +- src/output/hello_foundry/tree | 2 +- src/output/hello_foundry/tree-with-files | 26 +- .../forge-test-match-contract-and-test | 8 +- src/output/test_filters/forge-test-match-path | 8 +- src/reference/cli/SUMMARY.md | 19 +- src/reference/cli/cast.md | 197 ++++++------ src/reference/cli/cast/4byte-decode.md | 32 +- src/reference/cli/cast/4byte-event.md | 27 +- src/reference/cli/cast/4byte.md | 27 +- src/reference/cli/cast/abi-encode.md | 27 +- src/reference/cli/cast/access-list.md | 74 +++-- src/reference/cli/cast/address-zero.md | 27 +- src/reference/cli/cast/admin.md | 32 +- src/reference/cli/cast/age.md | 32 +- src/reference/cli/cast/artifact.md | 117 +++++++ src/reference/cli/cast/balance.md | 32 +- src/reference/cli/cast/base-fee.md | 32 +- src/reference/cli/cast/bind.md | 27 +- src/reference/cli/cast/block-number.md | 32 +- src/reference/cli/cast/block.md | 35 ++- src/reference/cli/cast/call.md | 82 +++-- src/reference/cli/cast/call/--create.md | 27 +- src/reference/cli/cast/calldata.md | 27 +- src/reference/cli/cast/chain-id.md | 32 +- src/reference/cli/cast/chain.md | 32 +- src/reference/cli/cast/client.md | 32 +- src/reference/cli/cast/code.md | 34 ++- src/reference/cli/cast/codehash.md | 32 +- src/reference/cli/cast/codesize.md | 32 +- src/reference/cli/cast/completions.md | 27 +- src/reference/cli/cast/compute-address.md | 32 +- src/reference/cli/cast/concat-hex.md | 27 +- src/reference/cli/cast/constructor-args.md | 32 +- src/reference/cli/cast/create2.md | 27 +- src/reference/cli/cast/creation-code.md | 32 +- src/reference/cli/cast/decode-abi.md | 62 ++++ src/reference/cli/cast/decode-calldata.md | 58 ++++ src/reference/cli/cast/decode-eof.md | 27 +- src/reference/cli/cast/decode-error.md | 61 ++++ src/reference/cli/cast/decode-event.md | 61 ++++ src/reference/cli/cast/decode-string.md | 55 ++++ src/reference/cli/cast/decode-transaction.md | 27 +- src/reference/cli/cast/disassemble.md | 35 ++- src/reference/cli/cast/estimate.md | 53 +++- src/reference/cli/cast/estimate/--create.md | 27 +- src/reference/cli/cast/etherscan-source.md | 27 +- src/reference/cli/cast/find-block.md | 32 +- .../cli/cast/format-bytes32-string.md | 27 +- src/reference/cli/cast/format-units.md | 27 +- src/reference/cli/cast/from-bin.md | 27 +- src/reference/cli/cast/from-fixed-point.md | 27 +- src/reference/cli/cast/from-rlp.md | 27 +- src/reference/cli/cast/from-utf8.md | 27 +- src/reference/cli/cast/from-wei.md | 27 +- src/reference/cli/cast/gas-price.md | 32 +- src/reference/cli/cast/generate-fig-spec.md | 27 +- src/reference/cli/cast/hash-message.md | 27 +- src/reference/cli/cast/hash-zero.md | 27 +- src/reference/cli/cast/implementation.md | 32 +- src/reference/cli/cast/index-erc7201.md | 27 +- src/reference/cli/cast/index.md | 27 +- src/reference/cli/cast/interface.md | 46 ++- src/reference/cli/cast/keccak.md | 27 +- src/reference/cli/cast/logs.md | 57 ++-- src/reference/cli/cast/lookup-address.md | 34 ++- src/reference/cli/cast/max-int.md | 27 +- src/reference/cli/cast/max-uint.md | 27 +- src/reference/cli/cast/min-int.md | 27 +- src/reference/cli/cast/mktx.md | 53 +++- src/reference/cli/cast/mktx/--create.md | 27 +- src/reference/cli/cast/namehash.md | 27 +- src/reference/cli/cast/nonce.md | 32 +- .../cli/cast/parse-bytes32-address.md | 27 +- .../cli/cast/parse-bytes32-string.md | 27 +- src/reference/cli/cast/parse-units.md | 27 +- src/reference/cli/cast/pretty-calldata.md | 27 +- src/reference/cli/cast/proof.md | 32 +- src/reference/cli/cast/publish.md | 32 +- src/reference/cli/cast/receipt.md | 35 ++- src/reference/cli/cast/resolve-name.md | 34 ++- src/reference/cli/cast/rpc.md | 32 +- src/reference/cli/cast/run.md | 54 +++- src/reference/cli/cast/selectors.md | 33 +- src/reference/cli/cast/send.md | 88 ++++-- src/reference/cli/cast/send/--create.md | 27 +- src/reference/cli/cast/shl.md | 27 +- src/reference/cli/cast/shr.md | 27 +- src/reference/cli/cast/sig-event.md | 27 +- src/reference/cli/cast/sig.md | 27 +- src/reference/cli/cast/storage-root.md | 32 +- src/reference/cli/cast/storage.md | 69 ++++- src/reference/cli/cast/to-ascii.md | 27 +- src/reference/cli/cast/to-base.md | 27 +- src/reference/cli/cast/to-bytes32.md | 27 +- .../cli/cast/to-check-sum-address.md | 27 +- src/reference/cli/cast/to-dec.md | 27 +- src/reference/cli/cast/to-fixed-point.md | 27 +- src/reference/cli/cast/to-hex.md | 27 +- src/reference/cli/cast/to-hexdata.md | 27 +- src/reference/cli/cast/to-int256.md | 27 +- src/reference/cli/cast/to-rlp.md | 27 +- src/reference/cli/cast/to-uint256.md | 27 +- src/reference/cli/cast/to-unit.md | 27 +- src/reference/cli/cast/to-utf8.md | 27 +- src/reference/cli/cast/to-wei.md | 27 +- src/reference/cli/cast/tx.md | 35 ++- src/reference/cli/cast/upload-signature.md | 27 +- src/reference/cli/cast/wallet.md | 39 ++- src/reference/cli/cast/wallet/address.md | 31 +- .../cli/cast/wallet/decrypt-keystore.md | 27 +- src/reference/cli/cast/wallet/import.md | 27 +- src/reference/cli/cast/wallet/list.md | 30 +- src/reference/cli/cast/wallet/new-mnemonic.md | 30 +- src/reference/cli/cast/wallet/new.md | 30 +- src/reference/cli/cast/wallet/private-key.md | 33 +- src/reference/cli/cast/wallet/sign-auth.md | 36 ++- src/reference/cli/cast/wallet/sign.md | 31 +- src/reference/cli/cast/wallet/vanity.md | 27 +- src/reference/cli/cast/wallet/verify.md | 27 +- src/reference/cli/forge.md | 67 ++-- src/reference/cli/forge/bind-json.md | 61 +++- src/reference/cli/forge/bind.md | 61 +++- src/reference/cli/forge/build.md | 65 +++- src/reference/cli/forge/cache.md | 27 +- src/reference/cli/forge/cache/clean.md | 27 +- src/reference/cli/forge/cache/ls.md | 27 +- src/reference/cli/forge/clean.md | 27 +- src/reference/cli/forge/clone.md | 30 +- src/reference/cli/forge/compiler.md | 27 +- src/reference/cli/forge/compiler/resolve.md | 39 ++- src/reference/cli/forge/completions.md | 27 +- src/reference/cli/forge/config.md | 93 ++++-- src/reference/cli/forge/coverage.md | 288 +++++++++++------- src/reference/cli/forge/create.md | 235 +++++++++----- src/reference/cli/forge/debug.md | 166 ++++++---- src/reference/cli/forge/doc.md | 63 +++- src/reference/cli/forge/eip712.md | 103 +++++-- src/reference/cli/forge/flatten.md | 27 +- src/reference/cli/forge/fmt.md | 27 +- src/reference/cli/forge/geiger.md | 36 ++- src/reference/cli/forge/generate-fig-spec.md | 27 +- src/reference/cli/forge/generate.md | 27 +- src/reference/cli/forge/generate/test.md | 27 +- src/reference/cli/forge/init.md | 30 +- src/reference/cli/forge/inspect.md | 105 +++++-- src/reference/cli/forge/install.md | 30 +- src/reference/cli/forge/remappings.md | 27 +- src/reference/cli/forge/remove.md | 27 +- src/reference/cli/forge/script.md | 269 +++++++++------- src/reference/cli/forge/selectors.md | 30 +- src/reference/cli/forge/selectors/cache.md | 84 +++++ .../cli/forge/selectors/collision.md | 103 +++++-- src/reference/cli/forge/selectors/find.md | 27 +- src/reference/cli/forge/selectors/list.md | 27 +- src/reference/cli/forge/selectors/upload.md | 27 +- src/reference/cli/forge/snapshot.md | 277 ++++++++++------- src/reference/cli/forge/soldeer.md | 38 ++- src/reference/cli/forge/soldeer/init.md | 37 ++- src/reference/cli/forge/soldeer/install.md | 37 ++- src/reference/cli/forge/soldeer/login.md | 33 +- src/reference/cli/forge/soldeer/push.md | 27 +- src/reference/cli/forge/soldeer/uninstall.md | 27 +- src/reference/cli/forge/soldeer/update.md | 37 ++- src/reference/cli/forge/soldeer/version.md | 27 +- src/reference/cli/forge/test.md | 269 +++++++++------- src/reference/cli/forge/tree.md | 27 +- src/reference/cli/forge/update.md | 27 +- src/reference/cli/forge/verify-bytecode.md | 76 +++-- src/reference/cli/forge/verify-check.md | 42 ++- src/reference/cli/forge/verify-contract.md | 50 ++- 183 files changed, 6082 insertions(+), 1557 deletions(-) create mode 100644 src/reference/cli/cast/artifact.md create mode 100644 src/reference/cli/cast/decode-abi.md create mode 100644 src/reference/cli/cast/decode-calldata.md create mode 100644 src/reference/cli/cast/decode-error.md create mode 100644 src/reference/cli/cast/decode-event.md create mode 100644 src/reference/cli/cast/decode-string.md create mode 100644 src/reference/cli/forge/selectors/cache.md diff --git a/src/output/cheatcodes/forge-test-cheatcodes b/src/output/cheatcodes/forge-test-cheatcodes index 61b11b7d0..c0ef267c9 100644 --- a/src/output/cheatcodes/forge-test-cheatcodes +++ b/src/output/cheatcodes/forge-test-cheatcodes @@ -8,10 +8,10 @@ No files changed, compilation skipped No files changed, compilation skipped Ran 2 tests for test/OwnerUpOnly.t.sol:OwnerUpOnlyTest -[PASS] testFail_IncrementAsNotOwner() (gas: 216319) -[PASS] test_IncrementAsOwner() (gas: 734680) -Suite result: ok. 2 passed; 0 failed; 0 skipped; finished in 35.53ms (27.31ms CPU time) +[PASS] testFail_IncrementAsNotOwner() (gas: 120313) +[PASS] test_IncrementAsOwner() (gas: 350662) +Suite result: ok. 2 passed; 0 failed; 0 skipped; finished in 26.27ms (22.38ms CPU time) -Ran 1 test suite in 36.34ms (35.53ms CPU time): 2 tests passed, 0 failed, 0 skipped (2 total tests) +Ran 1 test suite in 26.75ms (26.27ms 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 31f8bfaeb..2eb46c24c 100644 --- a/src/output/cheatcodes/forge-test-cheatcodes-expectrevert +++ b/src/output/cheatcodes/forge-test-cheatcodes-expectrevert @@ -8,9 +8,9 @@ No files changed, compilation skipped No files changed, compilation skipped Ran 1 test for test/OwnerUpOnly.t.sol:OwnerUpOnlyTest -[PASS] test_IncrementAsOwner() (gas: 734680) -Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 34.49ms (19.06ms CPU time) +[PASS] test_IncrementAsOwner() (gas: 350662) +Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 25.34ms (15.66ms CPU time) -Ran 1 test suite in 35.33ms (34.49ms CPU time): 1 tests passed, 0 failed, 0 skipped (1 total tests) +Ran 1 test suite in 25.82ms (25.34ms 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 edbf264b5..0848e8c47 100644 --- a/src/output/cheatcodes/forge-test-cheatcodes-tracing +++ b/src/output/cheatcodes/forge-test-cheatcodes-tracing @@ -8,17 +8,17 @@ No files changed, compilation skipped No files changed, compilation skipped Ran 1 test for test/OwnerUpOnly.t.sol:OwnerUpOnlyTest -[PASS] testFail_IncrementAsNotOwner() (gas: 216319) +[PASS] testFail_IncrementAsNotOwner() (gas: 120313) Traces: - [216319] OwnerUpOnlyTest::testFail_IncrementAsNotOwner() + [120313] OwnerUpOnlyTest::testFail_IncrementAsNotOwner() ├─ [0] VM::prank(0x0000000000000000000000000000000000000000) │ └─ ← [Return] - ├─ [208252] OwnerUpOnly::increment() + ├─ [112246] OwnerUpOnly::increment() │ └─ ← [Revert] Unauthorized() └─ ← [Revert] Unauthorized() -Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 21.84ms (6.47ms CPU time) +Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 16.20ms (5.89ms CPU time) -Ran 1 test suite in 22.73ms (21.84ms CPU time): 1 tests passed, 0 failed, 0 skipped (1 total tests) +Ran 1 test suite in 16.91ms (16.20ms 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 5a433bcbe..db4c3d5aa 100644 --- a/src/output/cheatcodes/forge-test-simple +++ b/src/output/cheatcodes/forge-test-simple @@ -4,17 +4,17 @@ $ forge test --zksync --match-test test_IncrementAsOwner // ANCHOR_END: command // ANCHOR: output Compiling 24 files with Solc 0.8.10 -Solc 0.8.10 finished in 801.67ms +Solc 0.8.10 finished in 978.00ms Compiler run successful! Compiling 24 files with zksolc and solc 0.8.10 -zksolc and solc 0.8.10 finished in 5.98s +zksolc and solc 0.8.10 finished in 4.83s Compiler run successful! Ran 1 test for test/OwnerUpOnly.t.sol:OwnerUpOnlyTest -[PASS] test_IncrementAsOwner() (gas: 734680) -Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 34.55ms (19.27ms CPU time) +[PASS] test_IncrementAsOwner() (gas: 350662) +Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 25.51ms (15.46ms CPU time) -Ran 1 test suite in 35.22ms (34.55ms CPU time): 1 tests passed, 0 failed, 0 skipped (1 total tests) +Ran 1 test suite in 26.01ms (25.51ms 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 348827f22..34458ca30 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.ECnnuozGYk/deps/lib/solmate (url: Some("https://github.com/transmissions11/solmate"), tag: None) +Installing solmate in /private/var/folders/6j/32rm_n4s37x_wmkgds7r8hqw0000gn/T/tmp.s9T2EZ913p/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 abb51fcf6..cac595a49 100644 --- a/src/output/deps/tree +++ b/src/output/deps/tree @@ -8,6 +8,6 @@ lib ├── solmate └── weird-erc20 -3 directories, 0 files +4 directories, 0 files // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/output/foundry-template/forge-build b/src/output/foundry-template/forge-build index 863c1ffb6..abd7ddf61 100644 --- a/src/output/foundry-template/forge-build +++ b/src/output/foundry-template/forge-build @@ -4,8 +4,8 @@ $ forge build --zksync // ANCHOR_END: command // ANCHOR: output -Compiling 28 files with zksolc and solc 0.8.25 -zksolc and solc 0.8.25 finished in 6.15s +Compiling 28 files with zksolc and solc 0.8.28 +zksolc and solc 0.8.28 finished in 3.32s Compiler run successful! // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/output/foundry-template/forge-test b/src/output/foundry-template/forge-test index 606b485a6..b9d0212b7 100644 --- a/src/output/foundry-template/forge-test +++ b/src/output/foundry-template/forge-test @@ -3,18 +3,18 @@ $ forge test --zksync // ANCHOR_END: command // ANCHOR: output -Compiling 25 files with Solc 0.8.25 -Solc 0.8.25 finished in 925.41ms +Compiling 25 files with Solc 0.8.28 +Solc 0.8.28 finished in 891.16ms Compiler run successful! No files changed, compilation skipped -Ran 3 tests for test/Foo.t.sol:FooTest -[PASS] testFork_Example() (gas: 3779) -[PASS] testFuzz_Example(uint256) (runs: 1000, μ: 213166, ~: 213166) -[PASS] test_Example() (gas: 215916) -Suite result: ok. 3 passed; 0 failed; 0 skipped; finished in 6.51s (6.51s CPU time) +Ran 3 tests for tests/Foo.t.sol:FooTest +[PASS] testFork_Example() (gas: 3755) +[PASS] testFuzz_Example(uint256) (runs: 1000, μ: 117160, ~: 117160) +[PASS] test_Example() (gas: 119910) +Suite result: ok. 3 passed; 0 failed; 0 skipped; finished in 5.23s (5.23s CPU time) -Ran 1 test suite in 6.52s (6.51s CPU time): 3 tests passed, 0 failed, 0 skipped (3 total tests) +Ran 1 test suite in 5.23s (5.23s 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 c03a876c0..3b8bf3342 100644 --- a/src/output/fuzz_testing/forge-test-fail-fuzz +++ b/src/output/fuzz_testing/forge-test-fail-fuzz @@ -4,7 +4,7 @@ $ forge test --zksync --allow-failure // ANCHOR_END: command // ANCHOR: output Compiling 1 files with Solc 0.8.10 -Solc 0.8.10 finished in 819.99ms +Solc 0.8.10 finished in 941.22ms Compiler run successful with warnings: Warning (9302): Return value of low-level calls not used. --> test/Safe.t.sol:11:9: @@ -20,7 +20,7 @@ Warning (9302): Return value of low-level calls not used. Compiling 1 files with zksolc and solc 0.8.10 -zksolc and solc 0.8.10 finished in 5.79s +zksolc and solc 0.8.10 finished in 5.14s Compiler run successful with warnings: Warning (9302) Warning: Return value of low-level calls not used. @@ -36,12 +36,15 @@ Warning: Return value of low-level calls not used. 30 | payable(address(safe)).call{value: amount}(""); | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -2024-10-06T00:06:15.308856Z ERROR foundry_zksync_core::vm::tracers::cheatcode: call may fail or behave unexpectedly due to empty code target=0x7fa9385be102ac3eac297483dd6233d62b3e1496 calldata="" +2025-01-09T13:58:44.187764Z ERROR foundry_zksync_core::vm::tracers::cheatcode: call may fail or behave unexpectedly due to empty code target=0x7fa9385be102ac3eac297483dd6233d62b3e1496 calldata="" +2025-01-09T13:58:44.200605Z ERROR foundry_zksync_core::vm::tracers::cheatcode: call may fail or behave unexpectedly due to empty code target=0x7fa9385be102ac3eac297483dd6233d62b3e1496 calldata="" +2025-01-09T13:58:44.206499Z ERROR foundry_zksync_core::vm::inspect: tx execution halted: Account validation error: Error function_selector = 0x4e487b71, data = 0x4e487b710000000000000000000000000000000000000000000000000000000000000011 +2025-01-09T13:58:44.212336Z ERROR foundry_zksync_core::vm::tracers::cheatcode: call may fail or behave unexpectedly due to empty code target=0x7fa9385be102ac3eac297483dd6233d62b3e1496 calldata="" Ran 1 test for test/Safe.t.sol:SafeTest -[FAIL. Reason: assertion failed; counterexample: calldata=0x29facca700000000000000000000000000000000000001e35e0786a154ba56aa29228e12 args=[38296303183566758584479465508370 [3.829e31]]] testFuzz_Withdraw(uint256) (runs: 0, μ: 0, ~: 0) -Suite result: FAILED. 0 passed; 1 failed; 0 skipped; finished in 29.00ms (13.46ms CPU time) +[FAIL: panic: arithmetic underflow or overflow (0x11); counterexample: calldata=0x29facca7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffd args=[115792089237316195423570985008687907853269984665640564039457584007913129639933 [1.157e77]]] testFuzz_Withdraw(uint256) (runs: 2, μ: 254285, ~: 254285) +Suite result: FAILED. 0 passed; 1 failed; 0 skipped; finished in 47.57ms (37.50ms CPU time) -Ran 1 test suite in 29.74ms (29.00ms CPU time): 0 tests passed, 1 failed, 0 skipped (1 total tests) +Ran 1 test suite in 48.20ms (47.57ms 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 6d5618549..6b4c875fb 100644 --- a/src/output/fuzz_testing/forge-test-no-fuzz +++ b/src/output/fuzz_testing/forge-test-no-fuzz @@ -4,7 +4,7 @@ $ forge test --zksync // ANCHOR_END: command // ANCHOR: output Compiling 24 files with Solc 0.8.10 -Solc 0.8.10 finished in 1.11s +Solc 0.8.10 finished in 932.46ms Compiler run successful with warnings: Warning (9302): Return value of low-level calls not used. --> test/Safe.t.sol:11:9: @@ -20,7 +20,7 @@ Warning (9302): Return value of low-level calls not used. Compiling 24 files with zksolc and solc 0.8.10 -zksolc and solc 0.8.10 finished in 5.81s +zksolc and solc 0.8.10 finished in 4.84s Compiler run successful with warnings: Warning (9302) Warning: Return value of low-level calls not used. @@ -36,12 +36,12 @@ Warning: Return value of low-level calls not used. 27 | payable(address(safe)).call{value: 1 ether}(""); | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -2024-10-06T00:06:07.481112Z ERROR foundry_zksync_core::vm::tracers::cheatcode: call may fail or behave unexpectedly due to empty code target=0x7fa9385be102ac3eac297483dd6233d62b3e1496 calldata="" +2025-01-09T13:58:37.379545Z ERROR foundry_zksync_core::vm::tracers::cheatcode: call may fail or behave unexpectedly due to empty code target=0x7fa9385be102ac3eac297483dd6233d62b3e1496 calldata="" Ran 1 test for test/Safe.t.sol:SafeTest -[PASS] test_Withdraw() (gas: 1199829) -Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 28.85ms (13.44ms CPU time) +[PASS] test_Withdraw() (gas: 303811) +Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 21.51ms (11.75ms CPU time) -Ran 1 test suite in 29.66ms (28.85ms CPU time): 1 tests passed, 0 failed, 0 skipped (1 total tests) +Ran 1 test suite in 21.94ms (21.51ms 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 f564f10b4..5ba0dd78d 100644 --- a/src/output/hello_foundry/forge-build +++ b/src/output/hello_foundry/forge-build @@ -4,8 +4,8 @@ $ forge build --zksync // ANCHOR_END: command // ANCHOR: output -Compiling 27 files with zksolc and solc 0.8.26 -zksolc and solc 0.8.26 finished in 3.97s +Compiling 27 files with zksolc and solc 0.8.27 +zksolc and solc 0.8.27 finished in 2.94s 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 5eec0ca5d..434d87ed8 100644 --- a/src/output/hello_foundry/forge-init +++ b/src/output/hello_foundry/forge-init @@ -1,11 +1,13 @@ // ANCHOR: all // ANCHOR: command -$ forge init hello_foundry +$ forge init --zksync hello_foundry // ANCHOR_END: command // ANCHOR: output -Initializing /tmp/tmp.v1NmqnC8e5/hello_foundry... -Installing forge-std in /tmp/tmp.v1NmqnC8e5/hello_foundry/lib/forge-std (url: Some("https://github.com/foundry-rs/forge-std"), tag: None) - Installed forge-std v1.9.3 +Initializing /private/var/folders/6j/32rm_n4s37x_wmkgds7r8hqw0000gn/T/tmp.ZDB04pl4A0/hello_foundry... +Installing forge-std in /private/var/folders/6j/32rm_n4s37x_wmkgds7r8hqw0000gn/T/tmp.ZDB04pl4A0/hello_foundry/lib/forge-std (url: Some("https://github.com/foundry-rs/forge-std"), tag: None) + Installed forge-std v1.9.5 +Installing forge-zksync-std in /private/var/folders/6j/32rm_n4s37x_wmkgds7r8hqw0000gn/T/tmp.ZDB04pl4A0/hello_foundry/lib/forge-zksync-std (url: Some("https://github.com/Moonsong-Labs/forge-zksync-std"), tag: None) + Installed forge-zksync-std Initialized forge project // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/output/hello_foundry/forge-test b/src/output/hello_foundry/forge-test index 997789530..57c667bd4 100644 --- a/src/output/hello_foundry/forge-test +++ b/src/output/hello_foundry/forge-test @@ -4,16 +4,16 @@ $ forge test --zksync // ANCHOR_END: command // ANCHOR: output Compiling 25 files with Solc 0.8.27 -Solc 0.8.27 finished in 902.81ms +Solc 0.8.27 finished in 769.11ms Compiler run successful! No files changed, compilation skipped Ran 2 tests for test/Counter.t.sol:CounterTest -[PASS] testFuzz_SetNumber(uint256) (runs: 256, μ: 31210, ~: 31288) -[PASS] test_Increment() (gas: 31303) -Suite result: ok. 2 passed; 0 failed; 0 skipped; finished in 5.75ms (5.36ms CPU time) +[PASS] testFuzz_SetNumber(uint256) (runs: 256, μ: 248949, ~: 245684) +[PASS] test_Increment() (gas: 238615) +Suite result: ok. 2 passed; 0 failed; 0 skipped; finished in 2.68s (2.68s CPU time) -Ran 1 test suite in 10.34ms (5.75ms CPU time): 2 tests passed, 0 failed, 0 skipped (2 total tests) +Ran 1 test suite in 2.68s (2.68s CPU time): 2 tests passed, 0 failed, 0 skipped (2 total tests) // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/output/hello_foundry/tree b/src/output/hello_foundry/tree index 9ca6a65ac..32d3e06b2 100644 --- a/src/output/hello_foundry/tree +++ b/src/output/hello_foundry/tree @@ -9,6 +9,6 @@ $ tree . -d -L 1 ├── src └── test -4 directories +5 directories // ANCHOR_END: output // ANCHOR_END: all diff --git a/src/output/hello_foundry/tree-with-files b/src/output/hello_foundry/tree-with-files index c27e13dc1..aea3a443f 100644 --- a/src/output/hello_foundry/tree-with-files +++ b/src/output/hello_foundry/tree-with-files @@ -4,18 +4,24 @@ $ tree . -L 3 -I output // ANCHOR_END: command // ANCHOR: output . +├── README.md ├── foundry.toml ├── lib -│   └── forge-std -│   ├── foundry.toml -│   ├── LICENSE-APACHE -│   ├── LICENSE-MIT -│   ├── package.json +│   ├── forge-std +│   │   ├── CONTRIBUTING.md +│   │   ├── LICENSE-APACHE +│   │   ├── LICENSE-MIT +│   │   ├── README.md +│   │   ├── foundry.toml +│   │   ├── package.json +│   │   ├── scripts +│   │   ├── src +│   │   └── test +│   └── forge-zksync-std +│   ├── LICENSE │   ├── README.md -│   ├── scripts -│   ├── src -│   └── test -├── README.md +│   ├── foundry.toml +│   └── src ├── script │   └── Counter.s.sol ├── src @@ -23,6 +29,6 @@ $ tree . -L 3 -I output └── test └── Counter.t.sol -8 directories, 11 files +11 directories, 14 files // 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 88b846930..12128c688 100644 --- a/src/output/test_filters/forge-test-match-contract-and-test +++ b/src/output/test_filters/forge-test-match-contract-and-test @@ -4,18 +4,18 @@ $ forge test --zksync --match-contract ComplicatedContractTest --match-test test // ANCHOR_END: command // ANCHOR: output Compiling 24 files with Solc 0.8.10 -Solc 0.8.10 finished in 1.14s +Solc 0.8.10 finished in 908.20ms Compiler run successful! Compiling 24 files with zksolc and solc 0.8.10 -zksolc and solc 0.8.10 finished in 5.54s +zksolc and solc 0.8.10 finished in 6.14s 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.28ms (1.39ms CPU time) +Suite result: ok. 2 passed; 0 failed; 0 skipped; finished in 649.00µs (670.50µs CPU time) -Ran 1 test suite in 5.27ms (1.28ms CPU time): 2 tests passed, 0 failed, 0 skipped (2 total tests) +Ran 1 test suite in 2.02ms (649.00µs 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 a37611cc3..1d6fb7af1 100644 --- a/src/output/test_filters/forge-test-match-path +++ b/src/output/test_filters/forge-test-match-path @@ -4,17 +4,17 @@ $ forge test --zksync --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.08s +Solc 0.8.10 finished in 897.98ms Compiler run successful! Compiling 1 files with zksolc and solc 0.8.10 -zksolc and solc 0.8.10 finished in 5.17s +zksolc and solc 0.8.10 finished in 4.33s 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 397.78µs (61.04µs CPU time) +Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 240.04µs (52.92µs CPU time) -Ran 1 test suite in 4.86ms (397.78µs CPU time): 1 tests passed, 0 failed, 0 skipped (1 total tests) +Ran 1 test suite in 4.83ms (240.04µ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/SUMMARY.md b/src/reference/cli/SUMMARY.md index cd96727a3..93089c170 100644 --- a/src/reference/cli/SUMMARY.md +++ b/src/reference/cli/SUMMARY.md @@ -32,13 +32,17 @@ - [`forge selectors collision`](./forge/selectors/collision.md) - [`forge selectors upload`](./forge/selectors/upload.md) - [`forge selectors list`](./forge/selectors/list.md) + - [`forge selectors find`](./forge/selectors/find.md) + - [`forge selectors cache`](./forge/selectors/cache.md) - [`forge snapshot`](./forge/snapshot.md) - [`forge soldeer`](./forge/soldeer.md) + - [`forge soldeer init`](./forge/soldeer/init.md) - [`forge soldeer install`](./forge/soldeer/install.md) - [`forge soldeer update`](./forge/soldeer/update.md) - [`forge soldeer login`](./forge/soldeer/login.md) - [`forge soldeer push`](./forge/soldeer/push.md) - - [`forge soldeer version-dry-run`](./forge/soldeer/version-dry-run.md) + - [`forge soldeer uninstall`](./forge/soldeer/uninstall.md) + - [`forge soldeer version`](./forge/soldeer/version.md) - [`forge test`](./forge/test.md) - [`forge tree`](./forge/tree.md) - [`forge update`](./forge/update.md) @@ -49,12 +53,12 @@ - [`cast 4byte`](./cast/4byte.md) - [`cast 4byte-decode`](./cast/4byte-decode.md) - [`cast 4byte-event`](./cast/4byte-event.md) - - [`cast abi-decode`](./cast/abi-decode.md) - [`cast abi-encode`](./cast/abi-encode.md) - [`cast access-list`](./cast/access-list.md) - [`cast address-zero`](./cast/address-zero.md) - [`cast admin`](./cast/admin.md) - [`cast age`](./cast/age.md) + - [`cast artifact`](./cast/artifact.md) - [`cast balance`](./cast/balance.md) - [`cast base-fee`](./cast/base-fee.md) - [`cast bind`](./cast/bind.md) @@ -63,11 +67,11 @@ - [`cast call`](./cast/call.md) - [`cast call --create`](./cast/call/--create.md) - [`cast calldata`](./cast/calldata.md) - - [`cast calldata-decode`](./cast/calldata-decode.md) - [`cast chain`](./cast/chain.md) - [`cast chain-id`](./cast/chain-id.md) - [`cast client`](./cast/client.md) - [`cast code`](./cast/code.md) + - [`cast codehash`](./cast/codehash.md) - [`cast codesize`](./cast/codesize.md) - [`cast completions`](./cast/completions.md) - [`cast compute-address`](./cast/compute-address.md) @@ -75,7 +79,12 @@ - [`cast constructor-args`](./cast/constructor-args.md) - [`cast create2`](./cast/create2.md) - [`cast creation-code`](./cast/creation-code.md) + - [`cast decode-abi`](./cast/decode-abi.md) + - [`cast decode-calldata`](./cast/decode-calldata.md) - [`cast decode-eof`](./cast/decode-eof.md) + - [`cast decode-error`](./cast/decode-error.md) + - [`cast decode-event`](./cast/decode-event.md) + - [`cast decode-string`](./cast/decode-string.md) - [`cast decode-transaction`](./cast/decode-transaction.md) - [`cast disassemble`](./cast/disassemble.md) - [`cast estimate`](./cast/estimate.md) @@ -91,6 +100,7 @@ - [`cast from-wei`](./cast/from-wei.md) - [`cast gas-price`](./cast/gas-price.md) - [`cast generate-fig-spec`](./cast/generate-fig-spec.md) + - [`cast hash-message`](./cast/hash-message.md) - [`cast hash-zero`](./cast/hash-zero.md) - [`cast implementation`](./cast/implementation.md) - [`cast index`](./cast/index.md) @@ -125,7 +135,6 @@ - [`cast sig-event`](./cast/sig-event.md) - [`cast storage`](./cast/storage.md) - [`cast storage-root`](./cast/storage-root.md) - - [`cast string-decode`](./cast/string-decode.md) - [`cast to-ascii`](./cast/to-ascii.md) - [`cast to-base`](./cast/to-base.md) - [`cast to-bytes32`](./cast/to-bytes32.md) @@ -148,8 +157,10 @@ - [`cast wallet vanity`](./cast/wallet/vanity.md) - [`cast wallet address`](./cast/wallet/address.md) - [`cast wallet sign`](./cast/wallet/sign.md) + - [`cast wallet sign-auth`](./cast/wallet/sign-auth.md) - [`cast wallet verify`](./cast/wallet/verify.md) - [`cast wallet import`](./cast/wallet/import.md) - [`cast wallet list`](./cast/wallet/list.md) - [`cast wallet private-key`](./cast/wallet/private-key.md) - [`cast wallet decrypt-keystore`](./cast/wallet/decrypt-keystore.md) + diff --git a/src/reference/cli/cast.md b/src/reference/cli/cast.md index 00e39c2ad..fb35caffb 100644 --- a/src/reference/cli/cast.md +++ b/src/reference/cli/cast.md @@ -10,45 +10,40 @@ $ cast --help Usage: cast [OPTIONS] Commands: - 4byte Get the function signatures for the given selector - from https://openchain.xyz [aliases: 4, 4b] - 4byte-decode Decode ABI-encoded calldata using - https://openchain.xyz [aliases: 4d, 4bd] + 4byte Get the function signatures for the given selector from + https://openchain.xyz [aliases: 4, 4b] + 4byte-decode Decode ABI-encoded calldata using https://openchain.xyz + [aliases: 4d, 4bd] 4byte-event Get the event signature for a given topic 0 from - https://openchain.xyz [aliases: 4e, 4be, - topic0-event, t0e] - abi-decode Decode ABI-encoded input or output data [aliases: - ad, --abi-decode] - abi-encode ABI encode the given function argument, excluding - the selector [aliases: ae] - access-list Create an access list for a transaction [aliases: - ac, acl] - address-zero Prints the zero address [aliases: --address-zero, - az] + https://openchain.xyz [aliases: 4e, 4be, topic0-event, + t0e] + abi-encode ABI encode the given function argument, excluding the + selector [aliases: ae] + access-list Create an access list for a transaction [aliases: ac, + acl] + address-zero Prints the zero address [aliases: --address-zero, az] admin Fetch the EIP-1967 admin account [aliases: adm] age Get the timestamp of a block [aliases: a] + artifact Generate an artifact file, that can be used to deploy a + contract locally [aliases: ar] balance Get the balance of an account in wei [aliases: b] - base-fee Get the basefee of a block [aliases: ba, fee, - basefee] - bind Generate a rust binding from a given ABI [aliases: - bi] + base-fee Get the basefee of a block [aliases: ba, fee, basefee] + bind Generate a rust binding from a given ABI [aliases: bi] block Get information about a block [aliases: bl] block-number Get the latest block number [aliases: bn] call Perform a call on an account without publishing a - transaction [aliases: c] + transaction [aliases: c] calldata ABI-encode a function with arguments [aliases: cd] - calldata-decode Decode ABI-encoded input data [aliases: - --calldata-decode, cdd] chain Get the symbolic name of the current chain chain-id Get the Ethereum chain ID [aliases: ci, cid] client Get the current client version [aliases: cl] - code Get the runtime bytecode of a contract [aliases: - co] - codesize Get the runtime bytecode size of a contract - [aliases: cs] + code Get the runtime bytecode of a contract [aliases: co] + codehash Get the codehash for an account + codesize Get the runtime bytecode size of a contract [aliases: + cs] completions Generate shell completions script [aliases: com] compute-address Compute the contract address from a given nonce and - deployer address [aliases: ca] + deployer address [aliases: ca] concat-hex Concatenate hex strings [aliases: --concat-hex, ch] constructor-args Display constructor arguments used for the contract initialization [aliases: cra] @@ -56,16 +51,26 @@ Commands: [aliases: c2] creation-code Download a contract creation code from Etherscan and RPC [aliases: cc] + decode-abi Decode ABI-encoded input or output data [aliases: + abi-decode, --abi-decode, ad] + decode-calldata Decode ABI-encoded input data [aliases: + calldata-decode, --calldata-decode, cdd] decode-eof Decodes EOF container bytes + decode-error Decode custom error data [aliases: error-decode, + --error-decode, erd] + decode-event Decode event data [aliases: event-decode, + --event-decode, ed] + decode-string Decode ABI-encoded string [aliases: string-decode, + --string-decode, sd] decode-transaction Decodes a raw signed EIP 2718 typed transaction - [aliases: dt, decode-tx] - disassemble Disassembles hex encoded bytecode into individual / - human readable opcodes [aliases: da] + [aliases: dt, decode-tx] + disassemble Disassembles a hex-encoded bytecode into a + human-readable representation [aliases: da] estimate Estimate the gas cost of a transaction [aliases: e] etherscan-source Get the source code of a contract from Etherscan - [aliases: et, src] - find-block Get the block number closest to the provided - timestamp [aliases: f] + [aliases: et, src] + find-block Get the block number closest to the provided timestamp + [aliases: f] format-bytes32-string Formats a string into bytes32 encoding [aliases: --format-bytes32-string] format-units Format a number from smallest unit to decimal with @@ -76,122 +81,140 @@ Commands: --from-fix, ff] from-rlp Decodes RLP hex-encoded data [aliases: --from-rlp] from-utf8 Convert UTF8 text to hex [aliases: --from-ascii, - --from-utf8, from-ascii, fu, fa] - from-wei Convert wei into an ETH amount [aliases: - --from-wei, fw] + --from-utf8, from-ascii, fu, fa] + from-wei Convert wei into an ETH amount [aliases: --from-wei, + fw] gas-price Get the current gas price [aliases: g] generate-fig-spec Generate Fig autocompletion spec [aliases: fig] + hash-message Hash a message according to EIP-191 [aliases: + --hash-message, hm] hash-zero Prints the zero hash [aliases: --hash-zero, hz] help Print this message or the help of the given - subcommand(s) + subcommand(s) implementation Fetch the EIP-1967 implementation account [aliases: - impl] + impl] index Compute the storage slot for an entry in a mapping - [aliases: in] + [aliases: in] index-erc7201 Compute storage slots as specified by `ERC-7201: - Namespaced Storage Layout` [aliases: index7201, - in7201] + Namespaced Storage Layout` [aliases: index7201, in7201] interface Generate a Solidity interface from a given ABI - [aliases: i] + [aliases: i] keccak Hash arbitrary data using Keccak-256 [aliases: k, - keccak256] + keccak256] logs Get logs by signature or topic [aliases: l] lookup-address Perform an ENS reverse lookup [aliases: la] max-int Prints the maximum value of the given integer type - [aliases: --max-int, maxi] + [aliases: --max-int, maxi] max-uint Prints the maximum value of the given integer type - [aliases: --max-uint, maxu] + [aliases: --max-uint, maxu] min-int Prints the minimum value of the given integer type - [aliases: --min-int, mini] + [aliases: --min-int, mini] mktx Build and sign a transaction [aliases: m] - namehash Calculate the ENS namehash of a name [aliases: na, - nh] + namehash Calculate the ENS namehash of a name [aliases: na, nh] nonce Get the nonce for an account [aliases: n] parse-bytes32-address Parses a checksummed address from bytes32 encoding. - [aliases: --parse-bytes32-address] + [aliases: --parse-bytes32-address] parse-bytes32-string Parses a string from bytes32 encoding [aliases: --parse-bytes32-string] parse-units Convert a number from decimal to smallest unit with arbitrary decimals [aliases: --parse-units, pun] pretty-calldata Pretty print calldata [aliases: pc] proof Generate a storage proof for a given storage slot - [aliases: pr] - publish Publish a raw transaction to the network [aliases: - p] - receipt Get the transaction receipt for a transaction - [aliases: re] + [aliases: pr] + publish Publish a raw transaction to the network [aliases: p] + receipt Get the transaction receipt for a transaction [aliases: + re] resolve-name Perform an ENS lookup [aliases: rn] rpc Perform a raw JSON-RPC request [aliases: rp] - run Runs a published transaction in a local environment - and prints the trace [aliases: r] - selectors Extracts function selectors and arguments from - bytecode [aliases: sel] + run Runs a published transaction in a local environment and + prints the trace [aliases: r] + selectors Extracts function selectors and arguments from bytecode + [aliases: sel] send Sign and publish a transaction [aliases: s] shl Perform a left shifting operation shr Perform a right shifting operation sig Get the selector for a function [aliases: si] - sig-event Generate event signatures from event string - [aliases: se] + sig-event Generate event signatures from event string [aliases: + se] storage Get the raw value of a contract's storage slot [aliases: st] storage-root Get the storage root for an account [aliases: sr] - string-decode Decode ABI-encoded string [aliases: --string-decode, - sd] to-ascii Convert hex data to an ASCII string [aliases: - --to-ascii, tas, 2as] + --to-ascii, tas, 2as] to-base Converts a number of one base to another [aliases: - --to-base, --to-radix, to-radix, tr, 2r] - to-bytes32 Right-pads hex data to 32 bytes [aliases: - --to-bytes32, tb, 2b] + --to-base, --to-radix, to-radix, tr, 2r] + to-bytes32 Right-pads hex data to 32 bytes [aliases: --to-bytes32, + tb, 2b] to-check-sum-address Convert an address to a checksummed format (EIP-55) - [aliases: --to-checksum-address, --to-checksum, - to-checksum, ta, 2a] + [aliases: --to-checksum-address, --to-checksum, + to-checksum, ta, 2a] to-dec Converts a number of one base to decimal [aliases: - --to-dec, td, 2d] - to-fixed-point Convert an integer into a fixed point number - [aliases: --to-fix, tf, 2f] + --to-dec, td, 2d] + to-fixed-point Convert an integer into a fixed point number [aliases: + --to-fix, tf, 2f] to-hex Converts a number of one base to another [aliases: - --to-hex, th, 2h] + --to-hex, th, 2h] to-hexdata Normalize the input to lowercase, 0x-prefixed hex - [aliases: --to-hexdata, thd, 2hd] + [aliases: --to-hexdata, thd, 2hd] to-int256 Convert a number to a hex-encoded int256 [aliases: - --to-int256, ti, 2i] - to-rlp RLP encodes hex data, or an array of hex data - [aliases: --to-rlp] + --to-int256, ti, 2i] + to-rlp RLP encodes hex data, or an array of hex data [aliases: + --to-rlp] to-uint256 Convert a number to a hex-encoded uint256 [aliases: - --to-uint256, tu, 2u] - to-unit Convert an ETH amount into another unit (ether, - gwei or wei) [aliases: --to-unit, tun, 2un] - to-utf8 Convert hex data to a utf-8 string [aliases: - --to-utf8, tu8, 2u8] - to-wei Convert an ETH amount to wei [aliases: --to-wei, - tw, 2w] + --to-uint256, tu, 2u] + to-unit Convert an ETH amount into another unit (ether, gwei or + wei) [aliases: --to-unit, tun, 2un] + to-utf8 Convert hex data to a utf-8 string [aliases: --to-utf8, + tu8, 2u8] + to-wei Convert an ETH amount to wei [aliases: --to-wei, tw, + 2w] tx Get information about a transaction [aliases: t] - upload-signature Upload the given signatures to - https://openchain.xyz [aliases: ups] + upload-signature Upload the given signatures to https://openchain.xyz + [aliases: ups] wallet Wallet management utilities [aliases: w] Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + -V, --version Print version Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. Find more information in the book: http://book.getfoundry.sh/reference/cast/cast.html diff --git a/src/reference/cli/cast/4byte-decode.md b/src/reference/cli/cast/4byte-decode.md index 4736d8757..f07f220a5 100644 --- a/src/reference/cli/cast/4byte-decode.md +++ b/src/reference/cli/cast/4byte-decode.md @@ -7,7 +7,7 @@ $ cast 4byte-decode --help ``` ```txt -Usage: cast 4byte-decode [CALLDATA] +Usage: cast 4byte-decode [OPTIONS] [CALLDATA] Arguments: [CALLDATA] @@ -17,21 +17,39 @@ Options: -h, --help Print help (see a summary with '-h') -Display options: - -j, --json - Print the decoded calldata as JSON + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] +Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/4byte-event.md b/src/reference/cli/cast/4byte-event.md index ec5aad07f..3285f9008 100644 --- a/src/reference/cli/cast/4byte-event.md +++ b/src/reference/cli/cast/4byte-event.md @@ -17,18 +17,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/4byte.md b/src/reference/cli/cast/4byte.md index 76df84704..6e7e5cfe6 100644 --- a/src/reference/cli/cast/4byte.md +++ b/src/reference/cli/cast/4byte.md @@ -17,18 +17,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/abi-encode.md b/src/reference/cli/cast/abi-encode.md index 0ee3590cf..8f6ca2ba9 100644 --- a/src/reference/cli/cast/abi-encode.md +++ b/src/reference/cli/cast/abi-encode.md @@ -23,18 +23,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/access-list.md b/src/reference/cli/cast/access-list.md index 6f0ca1024..d7359233b 100644 --- a/src/reference/cli/cast/access-list.md +++ b/src/reference/cli/cast/access-list.md @@ -28,23 +28,11 @@ Options: -h, --help Print help (see a summary with '-h') -Display options: - -j, --json - Print the access list as JSON - - --color - Log messages coloring - - Possible values: - - auto: Intelligently guess whether to use color output (default) - - always: Force color output - - never: Force disable color output - - -q, --quiet - Do not print log messages - - --verbose - Use verbose output + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] Transaction options: --gas-limit @@ -54,7 +42,10 @@ Transaction options: --gas-price Gas price for legacy transactions, or max fee per gas for EIP1559 - transactions + transactions, either specified in wei, or as a string with a unit + type. + + Examples: 1ether, 10gwei, 0.01ether [env: ETH_GAS_PRICE=] @@ -85,6 +76,18 @@ Transaction options: [env: ETH_BLOB_GAS_PRICE=] + --auth + EIP-7702 authorization list. + + 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 @@ -124,6 +127,11 @@ Ethereum options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -e, --etherscan-api-key The Etherscan (or equivalent) API key @@ -194,4 +202,34 @@ Wallet options - hardware wallet: -t, --trezor Use a Trezor hardware wallet + +Display options: + --color + The color of the log messages + + Possible values: + - auto: Intelligently guess whether to use color output (default) + - always: Force color output + - never: Force disable color output + + --json + Format log messages as JSON + + -q, --quiet + Do not print log messages + + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/address-zero.md b/src/reference/cli/cast/address-zero.md index 2963bf311..6d5aed9a5 100644 --- a/src/reference/cli/cast/address-zero.md +++ b/src/reference/cli/cast/address-zero.md @@ -13,18 +13,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/admin.md b/src/reference/cli/cast/admin.md index 2d7d7496b..0df6c5886 100644 --- a/src/reference/cli/cast/admin.md +++ b/src/reference/cli/cast/admin.md @@ -57,21 +57,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/age.md b/src/reference/cli/cast/age.md index bde5823cf..ed0d5243b 100644 --- a/src/reference/cli/cast/age.md +++ b/src/reference/cli/cast/age.md @@ -54,21 +54,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/artifact.md b/src/reference/cli/cast/artifact.md new file mode 100644 index 000000000..d51257907 --- /dev/null +++ b/src/reference/cli/cast/artifact.md @@ -0,0 +1,117 @@ +# cast artifact + +Generate an artifact file, that can be used to deploy a contract locally + +```bash +$ cast artifact --help +``` + +```txt +Usage: cast artifact [OPTIONS] + +Arguments: + + An Ethereum address, for which the artifact will be produced + +Options: + --abi-path + Path to file containing the contract's JSON ABI. It's necessary if the + target contract is not verified on Etherscan + + -o, --output + The path to the output file. + + If not specified, the artifact will be output to stdout. + + -e, --etherscan-api-key + The Etherscan (or equivalent) API key + + [env: ETHERSCAN_API_KEY=] + + -c, --chain + The chain name or EIP-155 chain ID + + [env: CHAIN=] + + -r, --rpc-url + The RPC endpoint + + [env: ETH_RPC_URL=] + + --flashbots + Use the Flashbots RPC URL with fast mode + (). + + This shares the transaction privately with all registered builders. + + See: + + + --jwt-secret + JWT Secret for the RPC endpoint. + + The JWT secret will be used to create a JWT for a RPC. For example, + the following can be used to simulate a CL `engine_forkchoiceUpdated` + call: + + cast rpc --jwt-secret engine_forkchoiceUpdatedV2 + '["0x6bb38c26db65749ab6e472080a3d20a2f35776494e72016d1e339593f21c59bc", + "0x6bb38c26db65749ab6e472080a3d20a2f35776494e72016d1e339593f21c59bc", + "0x6bb38c26db65749ab6e472080a3d20a2f35776494e72016d1e339593f21c59bc"]' + + [env: ETH_RPC_JWT_SECRET=] + + --rpc-timeout + Timeout for the RPC request in seconds. + + The specified timeout will be used to override the default timeout for + RPC requests. + + Default value: 45 + + [env: ETH_RPC_TIMEOUT=] + + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + + -h, --help + Print help (see a summary with '-h') + + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + +Display options: + --color + The color of the log messages + + Possible values: + - auto: Intelligently guess whether to use color output (default) + - always: Force color output + - never: Force disable color output + + --json + Format log messages as JSON + + -q, --quiet + Do not print log messages + + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. +``` \ No newline at end of file diff --git a/src/reference/cli/cast/balance.md b/src/reference/cli/cast/balance.md index 31806d151..b7265967d 100644 --- a/src/reference/cli/cast/balance.md +++ b/src/reference/cli/cast/balance.md @@ -60,6 +60,11 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + --erc20 erc20 address to query, with the method `balanceOf(address) return (uint256)`, alias with '--erc721' @@ -67,18 +72,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/base-fee.md b/src/reference/cli/cast/base-fee.md index 15fe0e401..e5044243e 100644 --- a/src/reference/cli/cast/base-fee.md +++ b/src/reference/cli/cast/base-fee.md @@ -54,21 +54,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/bind.md b/src/reference/cli/cast/bind.md index 42bd039c1..22c4a4181 100644 --- a/src/reference/cli/cast/bind.md +++ b/src/reference/cli/cast/bind.md @@ -51,18 +51,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/block-number.md b/src/reference/cli/cast/block-number.md index 8557020df..ff6349b3f 100644 --- a/src/reference/cli/cast/block-number.md +++ b/src/reference/cli/cast/block-number.md @@ -53,21 +53,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/block.md b/src/reference/cli/cast/block.md index b79d15dcf..a54926628 100644 --- a/src/reference/cli/cast/block.md +++ b/src/reference/cli/cast/block.md @@ -60,24 +60,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') -Display options: - -j, --json - Print the block as JSON + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] +Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/call.md b/src/reference/cli/cast/call.md index 3e4228205..f97167124 100644 --- a/src/reference/cli/cast/call.md +++ b/src/reference/cli/cast/call.md @@ -49,26 +49,17 @@ Options: Can also be the tags earliest, finalized, safe, latest, or pending. + --odyssey + Enable Odyssey features + -h, --help Print help (see a summary with '-h') -Display options: - -j, --json - Print the decoded output as JSON - - --color - Log messages coloring - - Possible values: - - auto: Intelligently guess whether to use color output (default) - - always: Force color output - - never: Force disable color output - - -q, --quiet - Do not print log messages - - --verbose - Use verbose output + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] Transaction options: --gas-limit @@ -78,7 +69,10 @@ Transaction options: --gas-price Gas price for legacy transactions, or max fee per gas for EIP1559 - transactions + transactions, either specified in wei, or as a string with a unit + type. + + Examples: 1ether, 10gwei, 0.01ether [env: ETH_GAS_PRICE=] @@ -109,6 +103,18 @@ Transaction options: [env: ETH_BLOB_GAS_PRICE=] + --auth + EIP-7702 authorization list. + + 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 @@ -148,6 +154,11 @@ Ethereum options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -e, --etherscan-api-key The Etherscan (or equivalent) API key @@ -188,6 +199,11 @@ Wallet options - raw: [default: 0] + --with-local-artifacts + Use current project artifacts for trace decoding + + [aliases: la] + Wallet options - keystore: --keystore Use the keystore in the given folder or file @@ -218,4 +234,34 @@ Wallet options - hardware wallet: -t, --trezor Use a Trezor hardware wallet + +Display options: + --color + The color of the log messages + + Possible values: + - auto: Intelligently guess whether to use color output (default) + - always: Force color output + - never: Force disable color output + + --json + Format log messages as JSON + + -q, --quiet + Do not print log messages + + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/call/--create.md b/src/reference/cli/cast/call/--create.md index 5c3a9f657..caa107558 100644 --- a/src/reference/cli/cast/call/--create.md +++ b/src/reference/cli/cast/call/--create.md @@ -30,18 +30,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/calldata.md b/src/reference/cli/cast/calldata.md index 62272b7d0..01e4041b1 100644 --- a/src/reference/cli/cast/calldata.md +++ b/src/reference/cli/cast/calldata.md @@ -20,18 +20,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/chain-id.md b/src/reference/cli/cast/chain-id.md index 4c752b35f..ba7d32dbc 100644 --- a/src/reference/cli/cast/chain-id.md +++ b/src/reference/cli/cast/chain-id.md @@ -48,21 +48,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/chain.md b/src/reference/cli/cast/chain.md index 40e6d567b..c8689c99b 100644 --- a/src/reference/cli/cast/chain.md +++ b/src/reference/cli/cast/chain.md @@ -48,21 +48,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/client.md b/src/reference/cli/cast/client.md index 81de5a3e3..514d7ddf8 100644 --- a/src/reference/cli/cast/client.md +++ b/src/reference/cli/cast/client.md @@ -48,21 +48,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/code.md b/src/reference/cli/cast/code.md index f1b325080..2c7872570 100644 --- a/src/reference/cli/cast/code.md +++ b/src/reference/cli/cast/code.md @@ -20,7 +20,7 @@ Options: Can also be the tags earliest, finalized, safe, latest, or pending. -d, --disassemble - Disassemble bytecodes into individual opcodes + Disassemble bytecodes -r, --rpc-url The RPC endpoint @@ -60,21 +60,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/codehash.md b/src/reference/cli/cast/codehash.md index ef57fe48f..e01da552a 100644 --- a/src/reference/cli/cast/codehash.md +++ b/src/reference/cli/cast/codehash.md @@ -60,21 +60,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/codesize.md b/src/reference/cli/cast/codesize.md index 1e7ae902f..407937fe6 100644 --- a/src/reference/cli/cast/codesize.md +++ b/src/reference/cli/cast/codesize.md @@ -57,21 +57,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/completions.md b/src/reference/cli/cast/completions.md index 99a1b7cd7..c7e3e4bec 100644 --- a/src/reference/cli/cast/completions.md +++ b/src/reference/cli/cast/completions.md @@ -17,18 +17,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/compute-address.md b/src/reference/cli/cast/compute-address.md index c111f1b10..583e608e6 100644 --- a/src/reference/cli/cast/compute-address.md +++ b/src/reference/cli/cast/compute-address.md @@ -55,21 +55,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/concat-hex.md b/src/reference/cli/cast/concat-hex.md index 752c696cd..f4e6dfc7a 100644 --- a/src/reference/cli/cast/concat-hex.md +++ b/src/reference/cli/cast/concat-hex.md @@ -17,18 +17,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/constructor-args.md b/src/reference/cli/cast/constructor-args.md index a027c8a3d..c2abfc414 100644 --- a/src/reference/cli/cast/constructor-args.md +++ b/src/reference/cli/cast/constructor-args.md @@ -66,21 +66,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/create2.md b/src/reference/cli/cast/create2.md index 3d20d9b71..b4e1561d6 100644 --- a/src/reference/cli/cast/create2.md +++ b/src/reference/cli/cast/create2.md @@ -37,9 +37,11 @@ Options: --init-code-hash Init code hash of the contract to be deployed - -j, --jobs - Number of threads to use. Defaults to and caps at the number of + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of logical cores + + [aliases: jobs] --caller
Address of the caller. Used for the first 20 bytes of the salt @@ -56,16 +58,31 @@ Options: Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/creation-code.md b/src/reference/cli/cast/creation-code.md index b455603d6..9d059097c 100644 --- a/src/reference/cli/cast/creation-code.md +++ b/src/reference/cli/cast/creation-code.md @@ -75,21 +75,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/decode-abi.md b/src/reference/cli/cast/decode-abi.md new file mode 100644 index 000000000..1d490b95c --- /dev/null +++ b/src/reference/cli/cast/decode-abi.md @@ -0,0 +1,62 @@ +# cast decode-abi + +Decode ABI-encoded input or output data. + +```bash +$ cast decode-abi --help +``` + +```txt +Usage: cast decode-abi [OPTIONS] + +Arguments: + + The function signature in the format `()()` + + + The ABI-encoded calldata + +Options: + -h, --help + Print help (see a summary with '-h') + + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + +Decode input data instead of output data: + -i, --input + Whether to decode the input or output data + +Display options: + --color + The color of the log messages + + Possible values: + - auto: Intelligently guess whether to use color output (default) + - always: Force color output + - never: Force disable color output + + --json + Format log messages as JSON + + -q, --quiet + Do not print log messages + + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. +``` \ No newline at end of file diff --git a/src/reference/cli/cast/decode-calldata.md b/src/reference/cli/cast/decode-calldata.md new file mode 100644 index 000000000..ac0abdad7 --- /dev/null +++ b/src/reference/cli/cast/decode-calldata.md @@ -0,0 +1,58 @@ +# cast decode-calldata + +Decode ABI-encoded input data. + +```bash +$ cast decode-calldata --help +``` + +```txt +Usage: cast decode-calldata [OPTIONS] + +Arguments: + + The function signature in the format `()()` + + + The ABI-encoded calldata + +Options: + -h, --help + Print help (see a summary with '-h') + + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + +Display options: + --color + The color of the log messages + + Possible values: + - auto: Intelligently guess whether to use color output (default) + - always: Force color output + - never: Force disable color output + + --json + Format log messages as JSON + + -q, --quiet + Do not print log messages + + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. +``` \ No newline at end of file diff --git a/src/reference/cli/cast/decode-eof.md b/src/reference/cli/cast/decode-eof.md index c6c2e3f1f..fdc99e772 100644 --- a/src/reference/cli/cast/decode-eof.md +++ b/src/reference/cli/cast/decode-eof.md @@ -17,18 +17,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/decode-error.md b/src/reference/cli/cast/decode-error.md new file mode 100644 index 000000000..637838a81 --- /dev/null +++ b/src/reference/cli/cast/decode-error.md @@ -0,0 +1,61 @@ +# cast decode-error + +Decode custom error data + +```bash +$ cast decode-error --help +``` + +```txt +Usage: cast decode-error [OPTIONS] + +Arguments: + + The error data to decode + +Options: + --sig + The error signature. If none provided then tries to decode from local + cache or `https://api.openchain.xyz` + + [aliases: error-sig] + + -h, --help + Print help (see a summary with '-h') + + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + +Display options: + --color + The color of the log messages + + Possible values: + - auto: Intelligently guess whether to use color output (default) + - always: Force color output + - never: Force disable color output + + --json + Format log messages as JSON + + -q, --quiet + Do not print log messages + + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. +``` \ No newline at end of file diff --git a/src/reference/cli/cast/decode-event.md b/src/reference/cli/cast/decode-event.md new file mode 100644 index 000000000..625465aea --- /dev/null +++ b/src/reference/cli/cast/decode-event.md @@ -0,0 +1,61 @@ +# cast decode-event + +Decode event data + +```bash +$ cast decode-event --help +``` + +```txt +Usage: cast decode-event [OPTIONS] + +Arguments: + + The event data to decode + +Options: + --sig + The event signature. If none provided then tries to decode from local + cache or `https://api.openchain.xyz` + + [aliases: event-sig] + + -h, --help + Print help (see a summary with '-h') + + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + +Display options: + --color + The color of the log messages + + Possible values: + - auto: Intelligently guess whether to use color output (default) + - always: Force color output + - never: Force disable color output + + --json + Format log messages as JSON + + -q, --quiet + Do not print log messages + + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. +``` \ No newline at end of file diff --git a/src/reference/cli/cast/decode-string.md b/src/reference/cli/cast/decode-string.md new file mode 100644 index 000000000..0acf2ce7e --- /dev/null +++ b/src/reference/cli/cast/decode-string.md @@ -0,0 +1,55 @@ +# cast decode-string + +Decode ABI-encoded string. + +```bash +$ cast decode-string --help +``` + +```txt +Usage: cast decode-string [OPTIONS] + +Arguments: + + The ABI-encoded string + +Options: + -h, --help + Print help (see a summary with '-h') + + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + +Display options: + --color + The color of the log messages + + Possible values: + - auto: Intelligently guess whether to use color output (default) + - always: Force color output + - never: Force disable color output + + --json + Format log messages as JSON + + -q, --quiet + Do not print log messages + + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. +``` \ No newline at end of file diff --git a/src/reference/cli/cast/decode-transaction.md b/src/reference/cli/cast/decode-transaction.md index 748471d26..07eb92b5b 100644 --- a/src/reference/cli/cast/decode-transaction.md +++ b/src/reference/cli/cast/decode-transaction.md @@ -17,18 +17,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/disassemble.md b/src/reference/cli/cast/disassemble.md index 886faa2ad..7c9cc8d4e 100644 --- a/src/reference/cli/cast/disassemble.md +++ b/src/reference/cli/cast/disassemble.md @@ -1,34 +1,55 @@ # cast disassemble -Disassembles hex encoded bytecode into individual / human readable opcodes +Disassembles a hex-encoded bytecode into a human-readable representation ```bash $ cast disassemble --help ``` ```txt -Usage: cast disassemble [OPTIONS] +Usage: cast disassemble [OPTIONS] [BYTECODE] Arguments: - - The hex encoded bytecode + [BYTECODE] + The hex-encoded bytecode Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/estimate.md b/src/reference/cli/cast/estimate.md index 511135995..87e172d38 100644 --- a/src/reference/cli/cast/estimate.md +++ b/src/reference/cli/cast/estimate.md @@ -32,6 +32,12 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Transaction options: --gas-limit Gas limit for the transaction @@ -40,7 +46,10 @@ Transaction options: --gas-price Gas price for legacy transactions, or max fee per gas for EIP1559 - transactions + transactions, either specified in wei, or as a string with a unit + type. + + Examples: 1ether, 10gwei, 0.01ether [env: ETH_GAS_PRICE=] @@ -71,6 +80,18 @@ Transaction options: [env: ETH_BLOB_GAS_PRICE=] + --auth + EIP-7702 authorization list. + + 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 @@ -110,6 +131,11 @@ Ethereum options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -e, --etherscan-api-key The Etherscan (or equivalent) API key @@ -181,22 +207,33 @@ Wallet options - hardware wallet: -t, --trezor Use a Trezor hardware wallet -Wallet options - remote: - --aws - Use AWS Key Management Service - Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/estimate/--create.md b/src/reference/cli/cast/estimate/--create.md index 87d55804f..46a9556bf 100644 --- a/src/reference/cli/cast/estimate/--create.md +++ b/src/reference/cli/cast/estimate/--create.md @@ -30,18 +30,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/etherscan-source.md b/src/reference/cli/cast/etherscan-source.md index 39f3fdd2b..6956a2960 100644 --- a/src/reference/cli/cast/etherscan-source.md +++ b/src/reference/cli/cast/etherscan-source.md @@ -33,18 +33,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/find-block.md b/src/reference/cli/cast/find-block.md index 2698c3fab..965600409 100644 --- a/src/reference/cli/cast/find-block.md +++ b/src/reference/cli/cast/find-block.md @@ -52,21 +52,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/format-bytes32-string.md b/src/reference/cli/cast/format-bytes32-string.md index e83b2e2a6..94f953a64 100644 --- a/src/reference/cli/cast/format-bytes32-string.md +++ b/src/reference/cli/cast/format-bytes32-string.md @@ -17,18 +17,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/format-units.md b/src/reference/cli/cast/format-units.md index 44eebc541..64355661e 100644 --- a/src/reference/cli/cast/format-units.md +++ b/src/reference/cli/cast/format-units.md @@ -22,18 +22,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/from-bin.md b/src/reference/cli/cast/from-bin.md index 2136124cf..15c7df38a 100644 --- a/src/reference/cli/cast/from-bin.md +++ b/src/reference/cli/cast/from-bin.md @@ -13,18 +13,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/from-fixed-point.md b/src/reference/cli/cast/from-fixed-point.md index 340c72358..3824dbbe8 100644 --- a/src/reference/cli/cast/from-fixed-point.md +++ b/src/reference/cli/cast/from-fixed-point.md @@ -20,18 +20,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/from-rlp.md b/src/reference/cli/cast/from-rlp.md index 0c6584a7d..54fa20a41 100644 --- a/src/reference/cli/cast/from-rlp.md +++ b/src/reference/cli/cast/from-rlp.md @@ -20,18 +20,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/from-utf8.md b/src/reference/cli/cast/from-utf8.md index bca4f65a6..d421bf263 100644 --- a/src/reference/cli/cast/from-utf8.md +++ b/src/reference/cli/cast/from-utf8.md @@ -17,18 +17,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/from-wei.md b/src/reference/cli/cast/from-wei.md index d25c065af..2a8b8f7e3 100644 --- a/src/reference/cli/cast/from-wei.md +++ b/src/reference/cli/cast/from-wei.md @@ -22,18 +22,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/gas-price.md b/src/reference/cli/cast/gas-price.md index 6bc4c1419..9c21a85b9 100644 --- a/src/reference/cli/cast/gas-price.md +++ b/src/reference/cli/cast/gas-price.md @@ -48,21 +48,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/generate-fig-spec.md b/src/reference/cli/cast/generate-fig-spec.md index 3ad322018..b9f28659c 100644 --- a/src/reference/cli/cast/generate-fig-spec.md +++ b/src/reference/cli/cast/generate-fig-spec.md @@ -13,18 +13,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/hash-message.md b/src/reference/cli/cast/hash-message.md index cc9704248..270a7586f 100644 --- a/src/reference/cli/cast/hash-message.md +++ b/src/reference/cli/cast/hash-message.md @@ -17,18 +17,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/hash-zero.md b/src/reference/cli/cast/hash-zero.md index 39d3563ea..01447d11f 100644 --- a/src/reference/cli/cast/hash-zero.md +++ b/src/reference/cli/cast/hash-zero.md @@ -13,18 +13,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/implementation.md b/src/reference/cli/cast/implementation.md index 4a87b1ce6..26f6db608 100644 --- a/src/reference/cli/cast/implementation.md +++ b/src/reference/cli/cast/implementation.md @@ -57,21 +57,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/index-erc7201.md b/src/reference/cli/cast/index-erc7201.md index 617d95717..5d896e239 100644 --- a/src/reference/cli/cast/index-erc7201.md +++ b/src/reference/cli/cast/index-erc7201.md @@ -22,18 +22,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/index.md b/src/reference/cli/cast/index.md index 55a0064ab..c2c2eac81 100644 --- a/src/reference/cli/cast/index.md +++ b/src/reference/cli/cast/index.md @@ -23,18 +23,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/interface.md b/src/reference/cli/cast/interface.md index bb6238d52..f33c36e48 100644 --- a/src/reference/cli/cast/interface.md +++ b/src/reference/cli/cast/interface.md @@ -7,17 +7,20 @@ $ cast interface --help ``` ```txt -Usage: cast interface [OPTIONS] +Usage: cast interface [OPTIONS] Arguments: - - The contract address, or the path to an ABI file. - - If an address is specified, then the ABI is fetched from Etherscan. + + The target contract, which can be one of: - A file path to an ABI JSON + file. - A contract identifier in the form `:` or + just ``. - An Ethereum address, for which the ABI will + be fetched from Etherscan Options: -n, --name - The name to use for the generated interface + The name to use for the generated interface. + + Only relevant when retrieving the ABI from a file. -p, --pragma Solidity pragma version @@ -29,10 +32,6 @@ Options: If not specified, the interface will be output to stdout. - -j, --json - If specified, the interface will be output as JSON rather than - Solidity - -e, --etherscan-api-key The Etherscan (or equivalent) API key @@ -46,18 +45,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/keccak.md b/src/reference/cli/cast/keccak.md index dcceab66d..41baac96f 100644 --- a/src/reference/cli/cast/keccak.md +++ b/src/reference/cli/cast/keccak.md @@ -17,18 +17,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/logs.md b/src/reference/cli/cast/logs.md index 2e2d0a4a0..438dfd21b 100644 --- a/src/reference/cli/cast/logs.md +++ b/src/reference/cli/cast/logs.md @@ -40,23 +40,11 @@ Options: -h, --help Print help (see a summary with '-h') -Display options: - -j, --json - Print the logs as JSON.s - - --color - Log messages coloring - - Possible values: - - auto: Intelligently guess whether to use color output (default) - - always: Force color output - - never: Force disable color output - - -q, --quiet - Do not print log messages - - --verbose - Use verbose output + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] Ethereum options: -r, --rpc-url @@ -97,6 +85,11 @@ Ethereum options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -e, --etherscan-api-key The Etherscan (or equivalent) API key @@ -167,4 +160,34 @@ Wallet options - hardware wallet: -t, --trezor Use a Trezor hardware wallet + +Display options: + --color + The color of the log messages + + Possible values: + - auto: Intelligently guess whether to use color output (default) + - always: Force color output + - never: Force disable color output + + --json + Format log messages as JSON + + -q, --quiet + Do not print log messages + + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/lookup-address.md b/src/reference/cli/cast/lookup-address.md index 40962454a..ce7e5588b 100644 --- a/src/reference/cli/cast/lookup-address.md +++ b/src/reference/cli/cast/lookup-address.md @@ -14,7 +14,7 @@ Arguments: The account to perform the lookup for Options: - -v, --verify + --verify Perform a normal lookup to verify that the address is correct -r, --rpc-url @@ -55,21 +55,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/max-int.md b/src/reference/cli/cast/max-int.md index 12b2decdc..96b3117a2 100644 --- a/src/reference/cli/cast/max-int.md +++ b/src/reference/cli/cast/max-int.md @@ -19,18 +19,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/max-uint.md b/src/reference/cli/cast/max-uint.md index e820eeac6..1a822bb7b 100644 --- a/src/reference/cli/cast/max-uint.md +++ b/src/reference/cli/cast/max-uint.md @@ -19,18 +19,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/min-int.md b/src/reference/cli/cast/min-int.md index 356959a26..ad7e1e0bb 100644 --- a/src/reference/cli/cast/min-int.md +++ b/src/reference/cli/cast/min-int.md @@ -19,18 +19,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/mktx.md b/src/reference/cli/cast/mktx.md index 4b0419358..114734de0 100644 --- a/src/reference/cli/cast/mktx.md +++ b/src/reference/cli/cast/mktx.md @@ -29,6 +29,12 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Transaction options: --gas-limit Gas limit for the transaction @@ -37,7 +43,10 @@ Transaction options: --gas-price Gas price for legacy transactions, or max fee per gas for EIP1559 - transactions + transactions, either specified in wei, or as a string with a unit + type. + + Examples: 1ether, 10gwei, 0.01ether [env: ETH_GAS_PRICE=] @@ -68,6 +77,18 @@ Transaction options: [env: ETH_BLOB_GAS_PRICE=] + --auth + EIP-7702 authorization list. + + 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 @@ -110,6 +131,11 @@ Ethereum options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -e, --etherscan-api-key The Etherscan (or equivalent) API key @@ -181,22 +207,33 @@ Wallet options - hardware wallet: -t, --trezor Use a Trezor hardware wallet -Wallet options - remote: - --aws - Use AWS Key Management Service - Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/mktx/--create.md b/src/reference/cli/cast/mktx/--create.md index d3d853ce0..bd291a571 100644 --- a/src/reference/cli/cast/mktx/--create.md +++ b/src/reference/cli/cast/mktx/--create.md @@ -23,18 +23,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/namehash.md b/src/reference/cli/cast/namehash.md index 1ac3aba9f..f7bdb943c 100644 --- a/src/reference/cli/cast/namehash.md +++ b/src/reference/cli/cast/namehash.md @@ -17,18 +17,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/nonce.md b/src/reference/cli/cast/nonce.md index 46f6643fd..b8ff98ea4 100644 --- a/src/reference/cli/cast/nonce.md +++ b/src/reference/cli/cast/nonce.md @@ -57,21 +57,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/parse-bytes32-address.md b/src/reference/cli/cast/parse-bytes32-address.md index f8fe44e35..f8641fc0b 100644 --- a/src/reference/cli/cast/parse-bytes32-address.md +++ b/src/reference/cli/cast/parse-bytes32-address.md @@ -17,18 +17,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/parse-bytes32-string.md b/src/reference/cli/cast/parse-bytes32-string.md index 9f30e676a..a61585812 100644 --- a/src/reference/cli/cast/parse-bytes32-string.md +++ b/src/reference/cli/cast/parse-bytes32-string.md @@ -17,18 +17,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/parse-units.md b/src/reference/cli/cast/parse-units.md index 33712b0ae..78e23d192 100644 --- a/src/reference/cli/cast/parse-units.md +++ b/src/reference/cli/cast/parse-units.md @@ -22,18 +22,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/pretty-calldata.md b/src/reference/cli/cast/pretty-calldata.md index 89e168062..5e667d0b2 100644 --- a/src/reference/cli/cast/pretty-calldata.md +++ b/src/reference/cli/cast/pretty-calldata.md @@ -20,18 +20,39 @@ Options: -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/proof.md b/src/reference/cli/cast/proof.md index 4b2b69cce..97982a8bb 100644 --- a/src/reference/cli/cast/proof.md +++ b/src/reference/cli/cast/proof.md @@ -60,21 +60,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/publish.md b/src/reference/cli/cast/publish.md index c84db5b76..e150f0644 100644 --- a/src/reference/cli/cast/publish.md +++ b/src/reference/cli/cast/publish.md @@ -57,21 +57,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/receipt.md b/src/reference/cli/cast/receipt.md index 31439ba7f..6defca796 100644 --- a/src/reference/cli/cast/receipt.md +++ b/src/reference/cli/cast/receipt.md @@ -65,24 +65,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') -Display options: - -j, --json - Print as JSON + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] +Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/resolve-name.md b/src/reference/cli/cast/resolve-name.md index 084b94aca..dd8f14098 100644 --- a/src/reference/cli/cast/resolve-name.md +++ b/src/reference/cli/cast/resolve-name.md @@ -14,7 +14,7 @@ Arguments: The name to lookup Options: - -v, --verify + --verify Perform a reverse lookup to verify that the name is correct -r, --rpc-url @@ -55,21 +55,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/rpc.md b/src/reference/cli/cast/rpc.md index 79ae7e7dd..907854b03 100644 --- a/src/reference/cli/cast/rpc.md +++ b/src/reference/cli/cast/rpc.md @@ -69,21 +69,47 @@ Options: [env: ETH_RPC_TIMEOUT=] + --rpc-headers + Specify custom headers for RPC requests + + [env: ETH_RPC_HEADERS=] + -h, --help Print help (see a summary with '-h') + -j, --threads + Number of threads to use. Specifying 0 defaults to the number of + logical cores + + [aliases: jobs] + Display options: --color - Log messages coloring + The color of the log messages Possible values: - auto: Intelligently guess whether to use color output (default) - always: Force color output - never: Force disable color output + --json + Format log messages as JSON + -q, --quiet Do not print log messages - --verbose - Use verbose output + -v, --verbosity... + Verbosity level of the log messages. + + Pass multiple times to increase the verbosity (e.g. -v, -vv, -vvv). + + Depending on the context the verbosity levels have different meanings. + + For example, the verbosity levels of the EVM are: + - 2 (-vv): Print logs for all tests. + - 3 (-vvv): Print execution traces for failing tests. + - 4 (-vvvv): Print execution traces for all tests, and setup traces + for failing tests. + - 5 (-vvvvv): Print execution and setup traces for all tests, + including storage changes. ``` \ No newline at end of file diff --git a/src/reference/cli/cast/run.md b/src/reference/cli/cast/run.md index a3430731b..b56df728e 100644 --- a/src/reference/cli/cast/run.md +++ b/src/reference/cli/cast/run.md @@ -28,14 +28,21 @@ Options: May result in different results than the live execution! - -v, --verbose - Prints the full address of the contract - -l, --label