lea-vm-exec Command-Line Usage#

This guide provides detailed instructions for using the lea-vm-exec command-line tool to execute smart contracts in the Lea-chain VM shim.

Installation#

For one-off commands, you can use npx without any installation:

npx @leachain/vm-exec <path/to/module.wasm> <entry_point> [flag] [value]

Alternatively, you can install it globally to use the lea-vm-exec command directly:

npm install -g @leachain/vm-exec
lea-vm-exec <path/to/module.wasm> <entry_point> [flag] [value]

Command Reference#

The lea-vm-exec tool executes a WebAssembly smart contract by specifying the module path and an entry point function.

exec#

Executes a function within a WebAssembly module, passing arguments as specified by the flags.

Synopsis#

lea-vm-exec <path/to/module.wasm> <entry_point> [options]

• <path/to/module.wasm>: The path to the WebAssembly module to execute.
• <entry_point>: The name of the exported function to call.

Options#

• --string <value>: Pass a string to the entry point. The string is encoded and written into the Wasm memory.
• --number <value>: Pass a number to the entry point.
• --file <path>: Pass the contents of a file to the entry point. The file content is read as bytes and written into the Wasm memory.

Examples#

1. Execute with a string argument

Command:

npx @leachain/vm-exec ./contract.wasm run_test --string "hello world"

Output:

2. Execute with a file as an argument

Command:

npx @leachain/vm-exec ./contract.wasm process_data --file ./data.json

Output:

License#

This project is licensed under the MIT License. See the LICENSE file for details.