Scarb execute

The scarb execute command executes a function from a local package. It does automatically compile the Cairo code within the package so using scarb build beforehand is not necessary. If scarb build or scarb execute has been previously used and the package hasn't changed since, this automatic build can be optionally skipped with the --no-build flag. Only packages defining the executable target can be executed.

Choosing a function to run

If your package defines multiple main functions (see choosing the main function), you need to specify which executable target should be run.

This can be achieved through one of two flags:

• --executable-name to choose the target by its name.
• --executable-function to choose the target by the main function it defines.

Those flags are mutually exclusive.

Saving the execution information

The execution will be carried out for one of two execution targets: standalone or bootloader. You can choose the target with the --target flag:

• Standalone: executes program as-is, execution is intended to be directly proven with scarb prove.
• Bootloader: program’s execution is expected to be wrapped by the bootloader’s execution, which itself will be proven via Stwo.

See more on proving and verifying execution page.

Resource usage and program output

To print the Cairo program output, you can use the --print-program-output flag. Otherwise, the output will be discarded.

To print detailed execution resources usage, you can use the --print-resource-usage flag. This will show information about:

• n_steps
• n_memory_holes
• builtin_instance_counter
• syscalls

In case your Cairo program panics, the panic reason will be shown on the output, and the program will exit with a non-zero exit code.

Program arguments

The executable function may accept arguments. They can be passed to the scarb execute command via either --arguments or --arguments-file flag.

The expected input with --arguments is a comma-separated list of integers. This list should correspond to the Cairo’s Serde of main’s arguments, for example:

main’s signature	valid arguments example	valid arguments file contents example
fn main(num: u8)	1	["0x1"]
fn main(num1: u8, num2: u16)	1,27	["0x1", "0x1b"]
fn main(num1: u8, tuple: (u16, u16))	1,2,27	["0x1", "0x2", "0x1b"]
fn main(num1: u8, num2: u256)	1,2,27	["0x1", "0x2", "0x1b"]
fn main(num1: u8, arr: Array<u8>)	1,2,1,2	["0x1", "0x2", "0x1", "0x2"]

Note that when using --arguments-file, the expected input is an array of felts represented as hex string. See the documentation for more information about Cairo’s Serde.