Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Important: If you're upgrading snforge to version 0.48.0 or later, please read the 0.48.0 Migration Guide.

declare

Declare a contract by fetching it from a different Starknet instance.

Required Common Arguments — Passed By CLI or Specified in snfoundry.toml

--class-hash, -c <CLASS_HASH>

Required.

Class hash of contract declared on a different network.

--url, -u <RPC_URL>

Optional.

Starknet RPC node url address.

Overrides url from snfoundry.toml.

--network <NETWORK>

Optional.

Use predefined network with public provider

Possible values: mainnet, sepolia.

--source-url, -u <RPC_URL>

Optional.

Starknet RPC node url address of the source network where the contract is already declared.

--source-network <NETWORK>

Optional.

Use predefined network with public provider where the contract is already declared.

Possible values: mainnet, sepolia.

--max-fee, -m <MAX_FEE>

Optional.

Maximum fee for the declare denoted in FRI. Must be greater than zero. If provided, it is not possible to use any of the following fee related flags: --l1-gas, --l1-data-price, --l2-gas, --l2-gas-price, --l1-data-gas, --l1-data-gas-price.

--l1-gas <L1_GAS>

Optional.

Maximum L1 gas for the declare transaction. When not used, defaults to auto-estimation.

--l1-gas-price <l1_gas_price>

Optional.

Maximum L1 gas unit price for the declare transaction. When not used, defaults to auto-estimation.

--l2-gas <L2_GAS>

Optional.

Maximum L2 gas for the declare transaction. When not used, defaults to auto-estimation.

--l2-gas-price <L2_GAS_PRICE>

Optional.

Maximum L2 gas unit price for the declare transaction. When not used, defaults to auto-estimation.

--l1-data-gas <L1_DATA_GAS>

Optional.

Maximum L1 data gas for the declare transaction. When not used, defaults to auto-estimation.

--l1-data-gas-price <l1_data_gas_price>

Optional.

Maximum L1 data gas unit price for the declare transaction. When not used, defaults to auto-estimation.

--tip <TIP>

Optional. Conflicts with: --estimate-tip

Tip for the transaction. Tip for the transaction. When not provided, defaults to 0 unless --estimate-tip is used.

--estimate-tip <ESTIMATE_TIP>

Optional. Conflicts with: --tip

If passed, an estimated tip will be added to pay for the transaction. The tip is estimated based on the current network conditions and added to the transaction fee.

--nonce, -n <NONCE>

Optional.

Nonce for transaction. If not provided, nonce will be set automatically.

--block-id, -b <BLOCK_ID>

Optional.

Block identifier on which class of declared contract should be fetched. Possible values: pending, latest, block hash (0x prefixed string), and block number (u64). pending is used as a default value.