Interact with a Package

Create and deploy your first move module.

Interacting with your module

The hello_blockchain module stores a string at an account within the MessageHolder resource of the calling account that can later be retrieved. To try interacting with the contract we will:

Call set_message to store a string on-chain
Call get_message to view the stored message on-chain

Store a string/message on-chain

Replace the place holder values denoted by <> with your account address before executing the commands.

replace & execute me!


supra move tool run --function-id '<hello_blockchain>::message::set_message' --args string:"Hello world!" --rpc-url https://rpc-testnet.supra.com

View the string/message stored on-chain

replace & execute me!


supra move tool view --function-id '<hello_blockchain>::message::get_message' --args address:<hello_blockchain> --rpc-url https://rpc-testnet.supra.com

Final step: Join our Discord !

Commands used to interact with modules

Calling a view function: `supra move tool view`

The view command is used to call view functions, which do not change the state of the VM in any way. View functions are denoted with #[view] above the function declaration.

Expects the two following arguments:
--function-id which designates the function to be called. The format is as follows: MODULE_ADR::MODULE_NAME::FUNCTION_NAME

--args which designates the arguments to be passed to the function. If multiple parameters must be passed, they are separated by spaces. The format is as follows: TYPE:VALUE

Execute the following command to better understand the arguments of the command.


supra move tool view --help

Executing an entry function: `supra move tool run`

The run command is used to call entry functions, which result in some transaction. Entry functions are your gateway to interacting with modules. We are unable to call functions without the entry declaration.