Move Runner - a dev tool to manage move project and run move script on local

Hello. Move developers!

Are you looking for a tool manage your Move project?

  • Move Runner is a NPM/Cargo like tool that help you to manage your Move project.
  • Move Runner is also a simulator that allows you to run Move script/modules on local.
  • Move Runner make Move developing very easy, No blockchain, No module publish, No pre-compile.

Here is layout of Move project.

├── Move.toml
├── genesis.blob
├── src
│   ├── modules
│   └── scripts
└── target
  • Modules in src/modules directory are compiled and loaded/published.
  • Scripts in src/scripts directory can be executed directly.
  • All compiled modules/scripts and source code maps will be generated into target directory. and you can publish them to your blockchain.

Are you interested in? Here are some information for you.

It’s query new. Please help us to make a better tool, feedbacks are very appreciate.


Quick Start

1. Download the lastest version.

Please visit the release page:

Mac OS:

cd /usr/local/bin
wget -O move
chmod 755 move


cd /usr/local/bin
wget -O move
chmod 755 move



make sure move in your path:

iMac:sample liangping$ move --help
move 0.0.1
Move local runner, allows developers to compile and run Move script/modules on local

    move <SUBCOMMAND>

    -h, --help       Prints help information
    -V, --version    Prints version information

    build      Build all modules and scripts in src directory
    compile    Compile script/module only
    help       Prints this message or the help of the given subcommand(s)
    new        New a move project
    run        Compile and run script

2. Create Move project


$ move new
$ ls
Move.toml	genesis.blob	src		target


$ move.exe new
$ dir
Move.toml	genesis.blob	src		target

3. Create Hello World Move Script

Create a source file in src/scripts, named hello_world_script.mvir

main(a: u64, b: bool, c: address ) {
    // /*d: vector<u8>*/

4. Run Hello World Script.

Note: make sure that your current dir is project root dir

move run hello_world_script.mvir 64 true, 0x123

You can see output like this:

     Loading config from "./Move.toml"
   Preparing  Current address: 0xcf1fe4b268ee11f5eb2cfbd7279cd789
   Preparing  Data store: Empty
     Loading modules from ./src/modules
   Compiling "../src/modules/hello_world.mvir"
   Compiling "../src/scripts/hello_world_script.mvir"
     Running Script: "hello_world_script.mvir" Args: ["1", "true", "0x123"]
      Output 0 WriteSet was generated

1 Like