index.md

title
Learning Sui

Sui: pronounced "sweet" without the "T" - with Transactions (loads of them), things are SWEET indeed. :-)

Welcome to the documentation for the Sui platform. Sui is built on the core Move programming language. This documentation assumes that you have a basic working knowledge of Move. To learn more about the differences between core Move and Sui Move, see How Sui Move differs from core Move.

For a deep dive into Sui technology, see the Sui Smart Contracts Platform white paper. Find answers to common questions about our roadmap and more in our FAQ.

Important: This site is built from the upstream main branch and therefore contains updates not yet available on devnet.

See what's new

The following list includes the recent updates to Sui and the documentation:

• You can now register to participate in Sui Incentivized Testnet as a validator!
• This site is now available in two versions in the menu at top left: the default and stable Devnet branch and the Latest build upstream main branch. Use the devnet version for app development on top of Sui. Use the Latest build main branch for contributing to the Sui blockchain itself. Always check and submit fixes to the main branch.
• Sui now supports development using Microsoft Windows 11, macOS, and Linux. See install Sui for the prerequisites of each operating system.
• sui::id is now sui::object and VersionedID is now Info. Use the Object module that has replaced the former ID.move.
• Find a list of single-writer apps that would benefit from Sui's advantages in handling simple transactions.
• Sui version 0.6.1 released to DevNet. See the #sui-release-notes channel in Discord for details on this and prior releases.
• Install the Sui Wallet Browser Extension to create NFTs, transfer coins, and carry out common transactions in a Chrome tab.

For a complete view of all changes in the Sui devnet branch, see: https://github.com/MystenLabs/sui/commits/devnet

For upstream updates in the main branch, see: https://github.com/MystenLabs/sui/commits/main

See the Sui doc/src history for a complete changelog of updates to this site.

Kickstart development

The links in the section point to information to help you start working with Sui.

Write Smart Contracts with Move

Go to the Move Quick Start for information about installation, defining custom objects, object operations (create/destroy/update/transfer/freeze), publishing, and invoking your published code.

Start the Sui network with Sui CLI client

See the Sui CLI client Quick Start for information about installation, querying the chain, client setup, sending transfer transactions, and viewing the effects.

Take the end-to-end tutorial

Proceed to the Sui Tutorial for a summary view of setting up your environment, starting a Sui network, gathering accounts and gas, and publishing and playing a game in Sui.

Program with Objects

Finish with the detailed Programming with objects tutorial series offering detailed guidance on manipulating Sui objects, from creation and storage through wrapping and using child objects.

Navigate this site

Navigate and search this site however you see fit. If you're new to Sui, we recommend that you review the following content in this order:

Learn - includes information to help you learn:

• About Sui
• How Sui works
• Sui compared to other blockchains

Build - includes information about how to:

• Install Sui
• Create smart contracts with Move
• Set up and configure a local Sui network
• Start a local JSON-RPC Gateway server

Explore - includes more in-depth information about:

• Sui Wallet
• Devnet
• Sui tutorials
• Sui prototypes
• Sui examples

Contribute - includes the following:

• Frequently Asked Questions
• Logging, Tracing, Metrics, and Observability
• Research Papers
• Sui Code of Conduct

Additional resources - lets you:

• Employ the Sui API Reference files for the Sui JSON-RPC API.
• View the Mysten Labs YouTube channel for introductory videos on technology and partners.