The Manifest Format

The snfoundry.toml contains the project's manifest and allows specifying sncast settings. You can configure sncast settings and arguments instead of providing them in the CLI along with the commands. If snfoundry.toml is not found in the root directory, sncast will look for it in all parent directories. If it is not found, default values will be used.

snfoundry.toml Contents

[sncast.<profile-name>]

[sncast.myprofile]
# ...

All fields are optional and do not have to be provided. In case a field is not defined in a manifest file, it must be provided in CLI when executing a relevant sncast command. Profiles allow you to define different sets of configurations for various environments or use cases. For more details, see the profiles explanation.

The url field specifies the address of RPC provider.

[sncast.myprofile]
url = "http://example.com"

accounts_file

The accounts_file field specifies the path to a file containing account information. If not provided, the default path is ~/.starknet_accounts/starknet_open_zeppelin_accounts.json.

[sncast.myprofile]
accounts_file = "path/to/accounts.json"

account

The account field specifies which account from the accounts_file to use for transactions.

[sncast.myprofile]
account = "user-dev"

keystore

The keystore field specifies the path to the keystore file.

[sncast.myprofile]
keystore = "path/to/keystore"

wait_params

The wait_params field defines the waiting parameters for transactions. By default, timeout (in seconds) is set to 300 and retry_interval (in seconds) to 5. This means transactions will be checked every 5 seconds, with a total of 60 attempts before timing out.

[sncast.myprofile]
wait_params = { timeout = 300, retry-interval = 5 }

block_explorer

The block_explorer field specifies the block explorer service used to display links to transaction details.

[sncast.myprofile]
block_explorer = "StarkScan"

Complete Example of snfoundry.toml File

[sncast.myprofile1]
url = "http://127.0.0.1:5050/"
accounts_file = "../account-file"
account = "mainuser"
keystore = "~/keystore"
wait_params = { timeout = 500, retry_interval = 10 }
block_explorer = "StarkScan" 

[sncast.dev]
url = "http://127.0.0.1:5056/rpc"
account = "devuser"