Sui Move Development

Sui Move Development

Provides expert guidance for developing smart contracts on Sui using the Move programming language. This skill covers Move syntax, Sui-specific patterns, module structure, testing, and deployment workflows.

Overview

Sui Move is a variant of the Move programming language designed specifically for the Sui blockchain. It emphasizes safety, composability, and expressiveness for defining digital assets and their behavior.

Key concepts:

• Objects - The fundamental unit of storage on Sui, owned by addresses or shared
• Abilities - Type properties (copy, drop, store, key) that control how types can be used
• Generics - Parameterized types for reusable, type-safe code
• One-time witnesses - Pattern for creating unique types for initialization
• Transfer policies - Programmable rules for asset transfers

Module Structure

A typical Sui Move package follows this structure:

my-package/
├── Move.toml           # Package manifest
├── sources/            # Move source files
│   ├── my_module.move
│   └── helpers.move
├── tests/              # Test files
│   └── my_module_tests.move
└── examples/           # Example transactions (optional)

Move.toml Configuration

The package manifest defines dependencies and metadata:

[package]
name = "MyPackage"
version = "0.0.1"
edition = "2024.beta"

[dependencies]
Sui = { git = "https://github.com/MystenLabs/sui.git", subdir = "crates/sui-framework/packages/sui-framework", rev = "framework/mainnet" }

[addresses]
my_package = "0x0"

Important fields:

• edition - Use "2024.beta" for latest features
• dependencies - Always include Sui framework
• addresses - Named addresses for the package (0x0 for templates, replaced at publish)

Module Declaration

Every Move file starts with a module declaration:

module my_package::my_module {
    use sui::object::{Self, UID};
    use sui::tx_context::{Self, TxContext};
    use sui::transfer;

    // Module contents
}