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
- The Movement Network currently supports three development environments
- Select the environment that aligns with your preferred programming language or ecosystem.
- Aptos Environment (Suzuka Testnet)
- MEVM Environment (Imola Testnet)
- MacOs
- Linux
- Windows
- 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:Terminalcargo --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/
- Ensure you have
homebrew
installed - If not, you need to install through Homebrew or you can install it on terminal:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- Following commands
brew update && brew upgrade -y
- Install Aptos CLI
brew install aptos
aptos --help
Note: If you are using an ARM architecture, you will have to install using the steps here:
- 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:Terminalcargo --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
- Aptos CLI: Installation Guide
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
or install by wget:
curl -fsSL "https://aptos.dev/scripts/install_cli.py" | python3
wget -qO- "https://aptos.dev/scripts/install_cli.py" | python3
- Step 3: Verify Aptos CLI is installed
aptos help
If you would like to update the Aptos CLI to the latest version, you can run aptos update
.
- 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
- Obtain the necessary endpoints from our Network Endpoints section to connect to the Suzuka Testnet.
Suzuka Testnet
The Aptos Environment is currently accessible through the Suzuka Testnet.
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 |
Utilize your favorite Solidity tools to start building and deploying smart contracts First Your Smart Contract
Visit our Aptos Faucets page to request tokens for your chosen environment.
- Foundry and Fractal
- Hardhat and Fractal
Option 1: Using Foundryup
- Foundryup is the official installer for the Foundry toolchain.
- To install Foundryup, open your terminal and run the following command:
curl -L https://foundry.paradigm.xyz | bash
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
- 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:
Terminalfoundryup --branch master
foundryup --path path/to/foundryOr, you can install via Cargo with the following command: (Recommendation)
Terminalcargo 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:
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:
docker build -t foundry .
Some systems, including those with M1 chips, may experience issues when building the Docker image locally. This is a known issue.
- 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/ |
Utilize your favorite Solidity tools to start building and deploying smart contracts First Your Solidity Smart Contract on Movement
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
npm install --save-dev hardhat
If you are using Windows, we strongly recommend using WSL 2 to follow this guide.
- 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/ |
Utilize your favorite Solidity tools to start building and deploying smart contracts First Your Solidity Smart Contract on Movement
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!