✓ Verified 📁 File Management ✓ Enhanced Data

Sui Move

Sui blockchain and Move smart contract development.

Rating: 4.8 (263 reviews)
Downloads: 40,454 downloads
Version: 1.0.0

Overview

Sui blockchain and Move smart contract development.

Complete Documentation

View Source →

Sui Move Development

Comprehensive knowledge base for Sui blockchain and Move smart contract development.

GitHub:

Setup References

Clone the official documentation:

bash

# Create skill directory
mkdir -p {baseDir}/references && cd {baseDir}/references

# Clone Move Book (The Move Language Bible)
git clone --depth 1 https://github.com/MystenLabs/move-book.git

# Clone Sui docs (sparse checkout)
git clone --depth 1 --filter=blob:none --sparse https://github.com/MystenLabs/sui.git
cd sui && git sparse-checkout set docs

# Clone Awesome Move (curated examples and resources)
# Note: Some code examples may be outdated
git clone --depth 1 https://github.com/MystenLabs/awesome-move.git

Additional Resources

Awesome Move (`references/awesome-move/`)

A curated list of Move resources, including:

Example projects and code snippets
Libraries and frameworks
Tools and utilities
Learning resources

⚠️ Note: Some code examples in awesome-move may be outdated as the Move language and Sui platform evolve. Always verify against the latest Move Book and Sui documentation.

Reference Structure

Move Book (`references/move-book/book/`)

Directory	Content
your-first-move/	Hello World, Hello Sui tutorials
move-basics/	Variables, functions, structs, abilities, generics
concepts/	Packages, manifest, addresses, dependencies
storage/	Object storage, UID, transfer functions
object/	Object model, ownership, dynamic fields
programmability/	Events, witness, publisher, display
move-advanced/	BCS, PTB, cryptography
guides/	Testing, debugging, upgrades, BCS
appendix/	Glossary, reserved addresses

Sui Docs (`references/sui/docs/content/`)

Concepts, guides, standards, references

Quick Search

bash

# Search Move Book for a topic
rg -i "keyword" {baseDir}/references/move-book/book/ --type md

# Search Sui docs
rg -i "keyword" {baseDir}/references/sui/docs/ --type md

# Find all files about a topic
find {baseDir}/references -name "*.md" | xargs grep -l "topic"

Key Concepts

Move Language Basics

Abilities - Type capabilities:

copy - Can be copied
drop - Can be dropped (destroyed)
store - Can be stored in objects
key - Can be used as a key in global storage (objects)

move

public struct MyStruct has key, store {
    id: UID,
    value: u64
}

Object Model:

Every object has a unique UID
Objects can be owned (address), shared, or immutable
Transfer functions: transfer::transfer, transfer::share_object, transfer::freeze_object

Common Patterns

Create and Transfer Object:

move

public fun create(ctx: &mut TxContext) {
    let obj = MyObject {
        id: object::new(ctx),
        value: 0
    };
    transfer::transfer(obj, tx_context::sender(ctx));
}

Shared Object:

move

public fun create_shared(ctx: &mut TxContext) {
    let obj = SharedObject {
        id: object::new(ctx),
        counter: 0
    };
    transfer::share_object(obj);
}

Entry Functions:

move

public entry fun do_something(obj: &mut MyObject, value: u64) {
    obj.value = value;
}

CLI Commands

bash

# Create new project
sui move new my_project

# Build
sui move build

# Test
sui move test

# Publish
sui client publish --gas-budget 100000000

# Call function
sui client call --package <PACKAGE_ID> --module <MODULE> --function <FUNCTION> --args <ARGS>

# Get object
sui client object <OBJECT_ID>

Workflow

When answering Sui/Move questions:

Search references first:

bash

rg -i "topic" {baseDir}/references/move-book/book/ -l

Read relevant files:

bash

cat {baseDir}/references/move-book/book/<path>/<file>.md

Provide code examples from the references
Link to official docs when helpful:
Move Book: https://move-book.com
Sui Docs: https://docs.sui.io

Topics Index

Topic	Location
Hello World	move-book/book/your-first-move/hello-world.md
Hello Sui	move-book/book/your-first-move/hello-sui.md
Primitives	move-book/book/move-basics/primitive-types.md
Structs	move-book/book/move-basics/struct.md
Abilities	move-book/book/move-basics/abilities-introduction.md
Generics	move-book/book/move-basics/generics.md
Object Model	move-book/book/object/
Storage	move-book/book/storage/
Events	move-book/book/programmability/events.md
Testing	move-book/book/guides/testing.md
Upgrades	move-book/book/guides/upgradeability.md
PTB	move-book/book/move-advanced/ptb/
BCS	move-book/book/move-advanced/bcs.md

Related Skills

This skill is part of the Sui development skill suite:

Skill	Description
sui-decompile	Fetch and read on-chain contract source code
sui-move	Write and deploy Move smart contracts
sui-coverage	Analyze test coverage with security analysis
sui-agent-wallet	Build and test DApps frontend

Workflow:

text

sui-decompile → sui-move → sui-coverage → sui-agent-wallet
    Study        Write      Test & Audit   Build DApps

All skills:

Notes

Move 2024 edition introduces new features (enums, method syntax, etc.)
Sui uses a unique object-centric model different from other blockchains
Gas is paid in SUI tokens
Testnet/Devnet available for development

Installation

Terminal bash


openclaw install sui-move

Copied!

💻Code Examples

git clone --depth 1 https://github.com/MystenLabs/awesome-move.git

git-clone---depth-1-httpsgithubcommystenlabsawesome-movegit.txt

## Additional Resources

### Awesome Move (`references/awesome-move/`)
A curated list of Move resources, including:
- Example projects and code snippets
- Libraries and frameworks
- Tools and utilities
- Learning resources

⚠️ **Note**: Some code examples in awesome-move may be outdated as the Move language and Sui platform evolve. Always verify against the latest Move Book and Sui documentation.

## Reference Structure

### Move Book (`references/move-book/book/`)
| Directory | Content |
|-----------|---------|
| `your-first-move/` | Hello World, Hello Sui tutorials |
| `move-basics/` | Variables, functions, structs, abilities, generics |
| `concepts/` | Packages, manifest, addresses, dependencies |
| `storage/` | Object storage, UID, transfer functions |
| `object/` | Object model, ownership, dynamic fields |
| `programmability/` | Events, witness, publisher, display |
| `move-advanced/` | BCS, PTB, cryptography |
| `guides/` | Testing, debugging, upgrades, BCS |
| `appendix/` | Glossary, reserved addresses |

### Sui Docs (`references/sui/docs/content/`)
- Concepts, guides, standards, references

## Quick Search

find {baseDir}/references -name "*.md" | xargs grep -l "topic"

find-basedirreferences--name-md--xargs-grep--l-topic.txt

## Key Concepts

### Move Language Basics

**Abilities** - Type capabilities:
- `copy` - Can be copied
- `drop` - Can be dropped (destroyed)
- `store` - Can be stored in objects
- `key` - Can be used as a key in global storage (objects)

}

.txt

**Object Model**:
- Every object has a unique `UID`
- Objects can be owned (address), shared, or immutable
- Transfer functions: `transfer::transfer`, `transfer::share_object`, `transfer::freeze_object`

### Common Patterns

**Create and Transfer Object**:

sui client object <OBJECT_ID>

sui-client-object-objectid.txt

## Workflow

When answering Sui/Move questions:

1. **Search references first**:

Workflow:

workflow.txt

sui-decompile → sui-move → sui-coverage → sui-agent-wallet
    Study        Write      Test & Audit   Build DApps

example.sh

# Create skill directory
mkdir -p {baseDir}/references && cd {baseDir}/references

# Clone Move Book (The Move Language Bible)
git clone --depth 1 https://github.com/MystenLabs/move-book.git

# Clone Sui docs (sparse checkout)
git clone --depth 1 --filter=blob:none --sparse https://github.com/MystenLabs/sui.git
cd sui && git sparse-checkout set docs

# Clone Awesome Move (curated examples and resources)
# Note: Some code examples may be outdated
git clone --depth 1 https://github.com/MystenLabs/awesome-move.git

example.sh

# Search Move Book for a topic
rg -i "keyword" {baseDir}/references/move-book/book/ --type md

# Search Sui docs
rg -i "keyword" {baseDir}/references/sui/docs/ --type md

# Find all files about a topic
find {baseDir}/references -name "*.md" | xargs grep -l "topic"

example.txt

public struct MyStruct has key, store {
    id: UID,
    value: u64
}

example.txt

public fun create(ctx: &mut TxContext) {
    let obj = MyObject {
        id: object::new(ctx),
        value: 0
    };
    transfer::transfer(obj, tx_context::sender(ctx));
}

example.txt

public fun create_shared(ctx: &mut TxContext) {
    let obj = SharedObject {
        id: object::new(ctx),
        counter: 0
    };
    transfer::share_object(obj);
}