## forge create Deploy a smart contract :::terminal ```bash $ forge create --help ``` ```txt Usage: forge create [OPTIONS] Arguments: The contract identifier in the form `:` Options: --constructor-args ... The constructor arguments --constructor-args-path The path to a file containing the constructor arguments --broadcast Broadcast the transaction --verify Verify contract after creation --unlocked Send via `eth_sendTransaction` using the `--from` argument or `$ETH_FROM` as sender --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. --timeout Timeout to use for broadcasting transactions [env: ETH_TIMEOUT=] -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] Cache options: --force Clear the cache and artifacts folder and recompile Build options: --no-cache Disable the cache --dynamic-test-linking Enable dynamic test linking --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: --ignored-error-codes Ignore solc warnings by error code -D, --deny A compiler error will be triggered at the specified diagnostic level. Replaces the deprecated `--deny-warnings` flag. Possible values: - `never`: Do not treat any diagnostics as errors. - `warnings`: Treat warnings as errors. - `notes`: Treat both, warnings and notes, as errors. Possible values: - never: Always exit with zero code - warnings: Exit with a non-zero code if any warnings are found - notes: Exit with a non-zero code if any notes or warnings are found --no-auto-detect Do not auto-detect the `solc` version --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 Use the Yul intermediate representation compilation pipeline --use-literal-content Changes compilation to only use literal content and not URLs --no-metadata Do not append any metadata to the bytecode. This is equivalent to setting `bytecode_hash` to `none` and `cbor_metadata` to `false`. --ast Includes the AST as JSON in the compiler output --evm-version The target EVM version --optimize [] Activate the Solidity optimizer [possible values: true, false] --optimizer-runs The number of runs specifies roughly how often each opcode of the deployed code will be executed across the life-time of the contract. This means it is a trade-off parameter between code size (deploy cost) and code execution cost (cost after deployment). An `optimizer_runs` parameter of `1` will produce short but expensive code. In contrast, a larger `optimizer_runs` parameter will produce longer but more gas efficient code --extra-output ... Extra output to include in the contract's artifact. Example keys: evm.assembly, ewasm, ir, irOptimized, metadata For a full description, see [https://docs.soliditylang.org/en/v0.8.13/using-the-compiler.html#input-description](https://docs.soliditylang.org/en/v0.8.13/using-the-compiler.html#input-description) --extra-output-files ... Extra output to write to separate files. Valid values: metadata, ir, irOptimized, ewasm, evm.assembly Project options: -o, --out The path to the contract artifacts folder --revert-strings Revert string configuration. Possible values are "default", "strip" (remove), "debug" (Solidity-generated revert strings) and "verboseDebug" --build-info Generate build info files --build-info-path Output path to directory that build info files will be written to --root The project's root path. By default root of the Git repository, if in one, or the current working directory. -C, --contracts The contracts source directory -R, --remappings The project's remappings --remappings-env The project's remappings from the environment --cache-path The path to the compiler cache --lib-paths The path to the library folder --hardhat Use the Hardhat-style project layout. This is the same as using: `--contracts contracts --lib-paths node_modules`. [aliases: --hh] --config-path Path to the config file 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, either specified in wei, or as a string with a unit type. Examples: 1ether, 10gwei, 0.01ether [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 Nonce for the transaction --legacy Send a legacy transaction instead of an EIP1559 transaction. This is automatically enabled for common networks without EIP1559. --blob Send a blob transaction using EIP-7594 (PeerDAS) format. Note: Use with `--eip4844` for the legacy EIP-4844 format. --eip4844 Send a blob transaction using EIP-4844 (legacy) format instead of EIP-7594. Must be used with `--blob` --blob-gas-price Gas price for EIP-7594/EIP-4844 blob transaction [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. Tempo: --tempo.fee-token Fee token address for Tempo transactions. When set, builds a Tempo (type 0x76) transaction that pays gas fees in the specified token. If this is not set, the fee token is chosen according to network rules. See the Tempo docs for more information. --tempo.seq Nonce sequence key for Tempo transactions. When set, builds a Tempo (type 0x76) transaction with the specified nonce sequence key. If this is not set, the protocol sequence key (0) will be used. For more information see [https://docs.tempo.xyz/protocol/transactions/spec-tempo-transaction#parallelizable-nonces](https://docs.tempo.xyz/protocol/transactions/spec-tempo-transaction#parallelizable-nonces). --tempo.sponsor-sig Sponsor (fee payer) signature for Tempo sponsored transactions. The sponsor signs the `fee_payer_signature_hash` to commit to paying gas fees on behalf of the sender. Provide as a hex-encoded signature. --tempo.print-sponsor-hash Print the sponsor signature hash and exit. Computes the `fee_payer_signature_hash` for the transaction so that a sponsor knows what hash to sign. The transaction is not sent. --tempo.key-id Access key ID for Tempo Keychain signature transactions. Used during gas estimation to override the key_id that would normally be recovered from the signature. --tempo.expiring-nonce Enable expiring nonce mode for Tempo transactions. Sets nonce to 0 and nonce_key to U256::MAX, enabling time-bounded transaction validity via `--tempo.valid-before` and `--tempo.valid-after`. --tempo.valid-before Upper bound timestamp for Tempo expiring nonce transactions. The transaction is only valid before this unix timestamp. Requires `--tempo.expiring-nonce`. --tempo.valid-after Lower bound timestamp for Tempo expiring nonce transactions. The transaction is only valid after this unix timestamp. Requires `--tempo.expiring-nonce`. Rpc options: -r, --rpc-url The RPC endpoint, default value is http://localhost:8545 [env: ETH_RPC_URL=] -k, --insecure Allow insecure RPC connections (accept invalid HTTPS certificates). When the provider's inner runtime transport variant is HTTP, this configures the reqwest client to accept invalid certificates. --no-proxy Disable automatic proxy detection. Use this in sandboxed environments (e.g., Cursor IDE sandbox, macOS App Sandbox) where system proxy detection causes crashes. When enabled, HTTP_PROXY/HTTPS_PROXY environment variables and system proxy settings will be ignored. --flashbots Use the Flashbots RPC URL with fast mode ([https://rpc.flashbots.net/fast](https://rpc.flashbots.net/fast)). This shares the transaction privately with all registered builders. See: [https://docs.flashbots.net/flashbots-protect/quick-start#faster-transactions](https://docs.flashbots.net/flashbots-protect/quick-start#faster-transactions) --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=] --curl Print the equivalent curl command instead of making the RPC request -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 Open an interactive prompt to enter your private key --private-key Use the provided private key --mnemonic Use the mnemonic phrase of mnemonic file at the specified path --mnemonic-passphrase Use a BIP39 passphrase for the mnemonic --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: -l, --ledger Use a Ledger hardware wallet -t, --trezor Use a Trezor hardware wallet Wallet options - remote: --aws Use AWS Key Management Service. Ensure the AWS_KMS_KEY_ID environment variable is set. --gcp Use Google Cloud Key Management Service. Ensure the following environment variables are set: GCP_PROJECT_ID, GCP_LOCATION, GCP_KEY_RING, GCP_KEY_NAME, GCP_KEY_VERSION. See: [https://cloud.google.com/kms/docs](https://cloud.google.com/kms/docs) --turnkey Use Turnkey. Ensure the following environment variables are set: TURNKEY_API_PRIVATE_KEY, TURNKEY_ORGANIZATION_ID, TURNKEY_ADDRESS. See: [https://docs.turnkey.com/getting-started/quickstart](https://docs.turnkey.com/getting-started/quickstart) Verifier options: --verifier The contract verification provider to use Possible values: - etherscan - sourcify - blockscout - oklink - custom: Custom verification provider, requires compatibility with the Etherscan API [default: sourcify] --verifier-api-key The verifier API KEY, if using a custom provider [env: VERIFIER_API_KEY=] --verifier-url The verifier URL, if using a custom provider [env: VERIFIER_URL=] 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 --md Format log messages as Markdown -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 and backtraces with line numbers. ``` :::