Skip to content

Latest commit

 

History

History
85 lines (63 loc) · 3.73 KB

install.md

File metadata and controls

85 lines (63 loc) · 3.73 KB
title
Install Sui

Sui is written in Rust, and we are using Cargo to build and manage the dependencies. As a prerequisite, you will need to install Cargo version 1.60.0 or higher in order to build and install Sui on your machine. Also ensure you have cmake installed:

$ which cmake

Tip: Assuming you have Rust Cargo, the git command, and a GitHub account, you can download the sui-setup.sh script and run it to conduct all of the setup below, from a terminal like so:

$ curl https://raw.githubusercontent.com/MystenLabs/sui/main/doc/utils/sui-setup.sh -o sui-setup.sh
chmod 755 sui-setup.sh
./sui-setup.sh

Binaries

To develop in Sui, you will need the Sui binaries. After installing cargo, run:

$ cargo install --locked --git https://github.com/MystenLabs/sui.git --branch "devnet" sui

This will put these binaries in your PATH (ex. under ~/.cargo/bin) that provide these command line interfaces (CLIs):

  • sui-move - build and test Move packages
  • wallet - run a local Sui network and gateway service accessible via the wallet CLI. The wallet CLI manage keypairs to sign/send transactions
  • rpc-server - run a local Sui network and gateway service accessible via an RPC interface

Confirm the install with:

$ echo $PATH

And ensure the .cargo/bin directory appears.

Integrated Development Environment

For Move development, we recommend the Visual Studio Code (vscode) IDE with the Move Analyzer language server plugin installed:

$ cargo install --git https://github.com/move-language/move move-analyzer

Then follow the Visual Studio Marketplace instructions to install the Move Analyzer extension. (The cargo install command for the language server is broken there; hence, we include the correct command above.)

See more IDE options in the Awesome Move docs.

Source code

If you need to download and understand the Sui source code, clone the Sui repository:

$ git clone https://github.com/MystenLabs/sui.git

You can start exploring Sui's source code by looking into the following primary directories:

  • sui - the Sui binaries (wallet, sui-move, and more)
  • sui_programmability - Sui's Move language integration also including games and other Move code examples for testing and reuse
  • sui_core - authority server and Sui Gateway
  • sui-types - coins, gas, and other object types
  • explorer - object explorer for the Sui network
  • sui-network - networking interfaces

And see the Rust Crates in use at:

To contribute updates to Sui code, send pull requests our way.

Next steps

Continue your journey through: