Getting Started

Welcome to the Movement Network! This guide will help you start building on our blockchain quickly and efficiently. Whether you're a developer familiar with Aptos, EVM (Ethereum Virtual Machine), or Sui ecosystems, we've got you covered.

Choose Your Environment

info

• The Movement Network currently supports three development environments
• Select the environment that aligns with your preferred programming language or ecosystem.

Aptos Environment (Suzuka Testnet)

Install the Movement CLI

MacOs

Option 1: Install Movement CLI via build from source (Linux/MacOS)

info

• Prerequisites:
  • Install Rust Programming Language
  • Git
  • Cmake
  • LLVM
  • libssl-dev and libclang-dev

• Step 1: Clone the Aptos-core repo & go into the newly created directory
  Terminal

  git clone https://github.com/movementlabsxyz/aptos-core.git && cd aptos-core

Install all prerequites using automatic script

• Step 1: Using the Automatic Script to install prerequisites:
  Terminal

  ./scripts/dev_setup.sh
• Step 2: Update your current shell environment:
  Terminal

  source ~/.cargo/env
• Step 3: Ensure you have cargo installed by following this commands:
  Terminal

  cargo --version

• Step 2: Build the Aptos CLI tool:
  Terminal

  cargo build -p movement

  The binary will be available at target/debug/movement

• Step 3: Move this executable to a place in your path

  sudo cp target/debug/movement /opt/homebrew/bin/

Option 2: Install CLI via homebrew (Linux/MacOS)

• Ensure you have homebrew installed
• If not, you need to install through Homebrew or you can install it on terminal:

Install Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

• Following commands

Update Packages

brew update && brew upgrade -y

• Install Aptos CLI

Install Aptos CLI

brew install aptos
aptos --help

Linux

warning

Note: If you are using an ARM architecture, you will have to install using the steps here:

Option 1: Install Movement CLI via build from source (Linux/MacOS)

info

• Prerequisites:
  • Install Rust Programming Language
  • Git
  • Cmake
  • LLVM
  • libssl-dev and libclang-dev

• Step 1: Clone the Aptos-core repo & go into the newly created directory
  Terminal

  git clone https://github.com/movementlabsxyz/aptos-core.git && cd aptos-core

Install all prerequites using automatic script

• Step 1: Using the Automatic Script to install prerequisites:
  Terminal

  ./scripts/dev_setup.sh
• Step 2: Update your current shell environment:
  Terminal

  source ~/.cargo/env
• Step 3: Ensure you have cargo installed by following this commands:
  Terminal

  cargo --version

• Step 2: Build the Movement CLI tool:
  Terminal

  cargo build -p movement

  The binary will be available at target/debug/movement

• Step 3: Move this executable to a place in your path

  sudo cp target/debug/movement /usr/local/bin

---

Option 2: Install Aptos CLI ( If you familar with Aptos )

• Aptos CLI: Installation Guide

Option 3: Install via Python Script

For Linux, the easiest way to install the Aptos CLI tool is via Python script.

• Step 1: Ensure you have Python 3.6+ or install on python.org
• Step 2: Please enter one of the commands from the list below in the terminal to install Aptos CLI

  curl -fsSL "https://aptos.dev/scripts/install_cli.py" | python3
  or install by wget:

  wget -qO- "https://aptos.dev/scripts/install_cli.py" | python3
• Step 3: Verify Aptos CLI is installed

  aptos help

tip

If you would like to update the Aptos CLI to the latest version, you can run aptos update.

Windows

info

• Prerequisites:
  • Install Rust Programming Language
  • Git
  • LLVM
  • Install Microsoft Visual Studio Build Tools for Windows
  • If on Windows ARM, install Visual Studio
  • Cmake

• Step 1: Clone the Aptos-core repo & go into the newly created directory
  Terminal

  git clone https://github.com/movementlabsxyz/aptos-core.git && cd aptos-core

Install all prerequites using automatic script

• Open a Powershell terminal as an administrator.
  Terminal

  PowerShell -ExecutionPolicy Bypass -File ./scripts/windows_dev_setup.ps1

  Open a new PowerShell terminal after installing all dependencies

• Step 2: Build the Aptos CLI tool:
  Terminal

  cargo build -p movement

  The binary will be available at target\debug\movement.exe

• Step 3: (Optional) Move this executable to a place in your PATH

Address Network Endpoints

• Obtain the necessary endpoints from our Network Endpoints section to connect to the Suzuka Testnet.

Suzuka Testnet

Aptos Environment

The Aptos Environment is currently accessible through the Suzuka Testnet.

Service	URL
RPC	https://aptos.testnet.suzuka.movementlabs.xyz/v1
Faucet UI	https://faucet.movementlabs.xyz/?network=aptos
Faucet endpoint	https://faucet.testnet.suzuka.movementlabs.xyz/
Explorer	https://explorer.movementnetwork.xyz/?network=testnet

Aptos Devnet Environment

We often test updates on our Suzuka devnet before pushing to testnet, you can deploy your modules and test on our devnet with the details below.

Service	URL
RPC	https://devnet.suzuka.movementnetwork.xyz/v1
Faucet endpoint	https://faucet.devnet.suzuka.movementnetwork.xyz/
Explorer	https://explorer.suzuka.movementnetwork.xyz/?network=devnet

Learn and Build on Aptos Move

Utilize your favorite Solidity tools to start building and deploying smart contracts First Your Smart Contract

Obtain Testnet Tokens

info

Visit our Aptos Faucets page to request tokens for your chosen environment.

MEVM Environment (Imola Testnet)

Foundry and Fractal

Install the Foundry

Option 1: Using Foundryup

• Foundryup is the official installer for the Foundry toolchain.
• To install Foundryup, open your terminal and run the following command:

Terminal

curl -L https://foundry.paradigm.xyz | bash

note

If you’re using Windows, you’ll need to install and use Git BASH or WSL as your terminal, since Foundryup currently doesn’t support Powershell or Command Prompt (Cmd).

Option 2: Building from Source

info

• Prerequisites
  • Install Rust Programming Language
  • Git
  • Install Microsoft Visual Studio Build Tools for Windows
  • If on Windows ARM, install Visual Studio

• Step 1: Building

  You can either use the various flags provided by Foundryup:

  Terminal

  foundryup --branch master
  foundryup --path path/to/foundry

  Or, you can install via Cargo with the following command: (Recommendation)

  Terminal

  cargo install --git https://github.com/foundry-rs/foundry --profile release --locked forge cast chisel anvil

Github Actions & Docker (Advanced)

CI Installation with GitHub Actions

For instructions on setting up Foundry in a CI pipeline, refer to the foundry-rs/foundry-toolchain GitHub Action.

Using Foundry with Docker

Foundry can also be run inside a Docker container. If you don’t have Docker installed, you can download it from Docker’s website.

• Once Docker is installed, you can pull the latest Foundry release by running:

Terminal

docker pull ghcr.io/foundry-rs/foundry:latest

• You can also build the Docker image locally by running the following command from the Foundry repository:

Terminal

docker build -t foundry .

note

Some systems, including those with M1 chips, may experience issues when building the Docker image locally. This is a known issue.

Address Network Endpoints

• Obtain the necessary endpoints from our Network Endpoints section to connect to the Suzuka Testnet.

MEVM Environment - Imola Testnet

EVM Environment

The MEVM environment is currently accessible through the Imola Devnet.

Service	URL
RPC	https://mevm.devnet.imola.movementlabs.xyz
Faucet UI	https://faucet.movementlabs.xyz/?network=mevm
Chain ID	30732
Explorer	https://explorer.devnet.imola.movementlabs.xyz
Indexer	https://aptos.devnet.imola.movementlabs.xyz/indexer/v1/graphql
Subgraph RPC	https://mevm2.devnet.imola.movementlabs.xyz/

Build and Deploy first your Smart Contract on Movement

Utilize your favorite Solidity tools to start building and deploying smart contracts First Your Solidity Smart Contract on Movement

Hardhat and Fractal

Install the Hardhat

info

• Prerequisites
  • Node.js
  • Git

Hardhat is used through a local installation in your project. This way your environment will be reproducible, and you will avoid future version conflicts.

To install it, you need to create an npm project by going to an empty folder, running npm init, and following its instructions. You can use another package manager, like yarn, but we recommend you use npm 7 or later, as it makes installing Hardhat plugins simpler.

Once your project is ready, you should run

Terminal

npm install --save-dev hardhat

tip

If you are using Windows, we strongly recommend using WSL 2 to follow this guide.

Address Network Endpoints

• Obtain the necessary endpoints from our Network Endpoints section to connect to the Suzuka Testnet.

MEVM Environment - Imola Testnet

EVM Environment

The MEVM environment is currently accessible through the Imola Devnet.

Service	URL
RPC	https://mevm.devnet.imola.movementlabs.xyz
Faucet UI	https://faucet.movementlabs.xyz/?network=mevm
Chain ID	30732
Explorer	https://explorer.devnet.imola.movementlabs.xyz
Indexer	https://aptos.devnet.imola.movementlabs.xyz/indexer/v1/graphql
Subgraph RPC	https://mevm2.devnet.imola.movementlabs.xyz/

Build and Deploy first your Smart Contract on Movement

Utilize your favorite Solidity tools to start building and deploying smart contracts First Your Solidity Smart Contract on Movement

Obtain Testnet Tokens

info

Visit our MEVM Faucets page to request tokens for your chosen environment.

---

Learn Move

New to the Move programming language? Start learning here:

• Hack Movement: A crash course on developing for the Movement Network.
• Move Language Book: Comprehensive guide to understanding the basics of Move.

Tutorials and Resources

Ready to expand your skills?

• Tutorials: Explore various tutorials to deepen your understanding and start hacking on the Movement Network.
• Community Support: Join our discord and engage in discussions with our developer community for support and updates.

---

By following this guide, you should have a clear path to start developing on the Movement Network using the environment that best suits your expertise. Happy building!