Quickstart

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"

cargo install --locked --git https://github.com/MystenLabs/sui.git --branch main sui

sui --version

sui client

sui client faucet

sui client balance

sui move new hello_world
cd hello_world

hello_world/
├── Move.toml
└── sources/
    └── hello_world.move

module hello_world::hello {
    use std::string::{Self, String};
    
    /// A simple object that holds a message
    public struct HelloWorld has key {
        id: UID,
        message: String,
    }
    
    /// Create a new HelloWorld object
    public fun create(message: vector<u8>, ctx: &mut TxContext) {
        let hello = HelloWorld {
            id: object::new(ctx),
            message: string::utf8(message),
        };
        transfer::share_object(hello);
    }
    
    /// Update the message
    public fun update(hello: &mut HelloWorld, message: vector<u8>) {
        hello.message = string::utf8(message);
    }
    
    /// Get the current message
    public fun get_message(hello: &HelloWorld): String {
        hello.message
    }
}

sui move build

BUILDING hello_world
Build Successful

sui client publish --gas-budget 100000000

╭──────────────────────────────────────────────────╮
│ Object Changes                                    │
├──────────────────────────────────────────────────┤
│ Published Objects:                                │
│  ┌──                                             │
│  │ PackageID: 0xabcd1234...                      │
│  └──                                             │
╰──────────────────────────────────────────────────╯

sui client call \
  --package PACKAGE_ID \
  --module hello \
  --function create \
  --args "Hello, Sui!" \
  --gas-budget 10000000

Created Objects:
  ┌──
  │ ObjectID: 0x5678abcd...
  │ Type: PACKAGE_ID::hello::HelloWorld
  └──

sui client call \
  --package PACKAGE_ID \
  --module hello \
  --function update \
  --args OBJECT_ID "Hello from Sui blockchain!" \
  --gas-budget 10000000

sui client object OBJECT_ID