You use the
clarity-cli command to work with smart contracts within the Blockstack virtual environment. This command has the following subcommands:
clarity-cli initialize [vm-state.db]
Initializes a local VM state database. If the database exists, this command throws an error.
clarity-cli mine_block [block time] [vm-state.db]
Simulates mining a new block.
clarity-cli get_block_height [vm-state.db]
Prints the simulated block height.
clarity-cli check [program-file.scm] (vm-state.db)
Type checks a potential contract definition.
clarity-cli launch [contract-name] [contract-definition.scm] [vm-state.db]
Launches a new contract in the local VM state database.
clarity-cli eval [context-contract-name] (program.scm) [vm-state.db]
Evaluates, in read-only mode, a program in a given contract context.
Type check and evaluate an expression for validity inside of a function’s source. It does not evaluate within a contract or database context.
Type check and evaluate expressions in a stdin/stdout loop.
clarity-cli execute [vm-state.db] [contract-name] [public-function-name] [sender-address] [args...]
Executes a public function of a defined contract.
Generates a random Stacks public address for testing purposes.