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 encountering any problem declaring contracts, please read the Blake Hash Support information.

contract-address

Calculate the address of a not yet deployed contract.

--class-hash, -g <CLASS_HASH>

Optional. Conflicts with: --contract-name

The class hash of the contract to deploy. It can be either:

  • Felt in hex (prefixed with 0x) or decimal representation.
  • @alias defined in [sncast.<profile>.aliases] in snfoundry.toml. See aliases.

--contract-name <CONTRACT_NAME>

Optional. Conflicts with: --class-hash

The name of the contract. The contract name is the part after the mod keyword in your contract file. The class hash is derived from the locally built artifact. This argument also accepts a module tree path, for example hello_sncast::contracts::HelloSncast or contracts::HelloSncast.

--constructor-calldata <CONSTRUCTOR_CALLDATA>

Optional. Conflicts with: --arguments

Constructor calldata as a series of felts. Each token may be:

  • Felt in hex (prefixed with 0x) or decimal representation.
  • @alias defined in [sncast.<profile>.aliases] in snfoundry.toml. See aliases.

Requires --url or --network to fetch the contract ABI when used together with --class-hash.

--arguments <ARGUMENTS>

Optional. Conflicts with: --constructor-calldata

Constructor arguments as a comma-separated string of Cairo expressions. For example: --arguments '1, 2, MyStruct { x: 1, y: 2 }'

Requires --url or --network to fetch the contract ABI when used together with --class-hash.

For more information on supported expressions and syntax, see Calldata Transformation.

--salt, -s <SALT>

Optional.

Salt for the address. If not provided, a random salt is generated and included in the response.

--unique

Optional.

If set, the salt is modified with the deployer account address, making the address unique per deployer.

--deployer-address <DEPLOYER_ADDRESS>

Optional.

The deployer account address used to modify the salt when --unique is set. It can be either:

  • Felt in hex (prefixed with 0x) or decimal representation.
  • @alias defined in [sncast.<profile>.aliases] in snfoundry.toml. See aliases.

Defaults to zero.

--package <PACKAGE>

Optional. Conflicts with: --class-hash

Specifies the Scarb package to use when looking up the contract by name.

--url, -u <RPC_URL>

Optional.

Starknet RPC node url address. Required when using --arguments or --constructor-calldata together with --class-hash.

Overrides url from snfoundry.toml.

--network <NETWORK>

Optional.

Use predefined network with public provider.

Possible values: mainnet, sepolia, devnet.

Overrides network from snfoundry.toml.