A comprehensive, hands-on learning resource for building on the Sui blockchain using the Move programming language — from your first smart contract to full-stack decentralized applications and beyond.
- Getting Started
- How This Repository Works
- Learning Paths
- Module Reference
- Module A: Introduction to Sui
- Module B: Move Language Fundamentals
- Module C: Advanced Move Patterns
- Module D: Sui Client Interactions
- Module E: NFT Development
- Module F: Complete DApp Development
- Module G: Advanced Move Programming
- Module H: Upgrades and Security
- Module I: Token Standards and Marketplaces
- Module J: Infrastructure and Monitoring
- Module K: Advanced Topics
- Module R: SuiBotics — Blockchain Robotics
- Prerequisites
- Technology Stack
- Resources
- Install the Sui CLI — Follow the official installation guide.
- Clone this repository:
git clone https://github.com/MystenLabs/sui-move-bootcamp.git cd sui-move-bootcamp - Pick a learning path below and start with the first module.
- Follow the README inside each module folder for detailed instructions.
Each module includes a hands-on project with code examples demonstrating specific Sui and Move concepts.
- The
mainbranch provides scaffolded projects with intentionally incomplete code — learners implement the missing parts as they progress through the lessons. - For each module X, there is a corresponding
X-solutionbranch containing the fully completed source code (e.g.,B1-solution,G2-solution).
This approach encourages interactive learning: experiment, debug, and understand the development process step by step before reviewing the final implementation.
A structured curriculum covering the full spectrum of Sui development — from writing your first Move contract to deploying production DApps with monitoring.
A (Intro to Sui) → B (Move Basics) → C (Advanced Patterns) → D (Client SDK)
→ E (NFTs) → F (Full DApp) → G (Advanced Move) → H (Security)
→ I (Tokens & Marketplaces) → J (Infrastructure) → K (Advanced Topics)
Start with Module A if you are new to Sui and Move.
A progressive, project-based series that teaches Sui blockchain development through building a robot control platform — from a simple "Hello Robot" script to a complete rental marketplace with tokens, authentication, and multiplayer access.
R1 (Serial) → R2 (Move Basics) → R3 (WebSocket) → R4 (Blockchain + Robot)
→ R5 (Real-time Control) → R6 (Tunneling) → R7 (Auth & State Channels)
→ R8 (Tokenomics) → R9 (Multiplayer) → R10 (Full Platform)
Hardware: Most modules work in simulation mode. A physical Petoi Bittle X robot is required for the full experience in Modules R1, R4, R5+.
Choose based on your goals:
| Goal | Modules | Time |
|---|---|---|
| Control a robot from your browser | R1 → R5 → R6 | 4–6 hours |
| Learn Sui blockchain through projects | R2 → R7 → R8 → R9 | 8–12 hours |
| Full stack blockchain robotics | R1 → R2 → … → R10 | 25–35 hours |
Start with Module R1 or Module R2 depending on your interest.
- A1: Introduction to Decentralized Ledgers and Smart-Contracts
- A2: Description of the Sui ecosystem (Walrus, Enoki, Deepbook)
- A3: Intro to Sui & Move, Validators vs Fullnodes — Sui Infra
- A4: Creating a Sui Wallet from CLI and First Smart Contract
- B1: Packages, Modules, Move Compiler, and Objects
- B2: Numeric Types, Strings, and Pure Arguments
- B3: Copy ability, Events, Key/Store abilities, and Parameter Types
- C1: Capability Pattern and One Time Witness + Publisher
- C2: Object Display
- C3: PTBs Introduction
- C4: On-Chain Randomness
- D1: Sui Client initialization and Fullnode restrictions
- D2: Reading Objects from chain and Dynamic Fields
- D3: Paginated Reads
- D4: Transaction submission, Balance Changes, and Gas Profiling
- G1: Custom initializers and Test Transactions
- G2: Collections and Data Structures (Vector, ID, UID, VecMap, Bag, Option)
- G3: Dynamic Fields and Tables
- H1: Upgrade preconditions and Versioned Shared Objects
- H2: Advanced Patterns (Capability with Properties, Witness Pattern, Hot Potato)
- H3: General Security Concerns
- H4: Common vulnerability patterns
- I1: Creating Custom Coins and Coin Metadata
- I2: Treasury Cap Handling
- I3: Closed Loop Tokens
- I4: Kiosk
- I5: Custom Rules & Transfer Policies
- J1: Setting up and customizing an Indexer
- J2: Integrating Indexer in a DApp
- J3: Using Prometheus and Grafana for Monitoring
- K1: Sui Indexer Pro (Backend)
- K2: ZKLogin Demo (React Frontend)
- K4: Nautilus — Trusted Execution Environments
- K5: Seal — Encryption & Access Policies
A progressive, project-based series that teaches Sui development through building blockchain-controlled robotics — from a simple serial connection to a full rental platform with tokens, authentication, and multiplayer access. Most modules work in simulation mode; a physical Petoi Bittle X robot is optional.
- R1: Hello Bittle — Serial Basics Serial communication, baud rates, USB device detection, and the Bittle command protocol.
- R2: My First Move Contract — Blockchain Fundamentals Build a simple action queue on Sui. Objects, ownership, shared state, and the TypeScript SDK.
- R3: WebSocket Playground — Real-time Basics Real-time robot controller with WebSocket. Bidirectional communication and multi-client broadcasting.
- R4: Blockchain Robot — First Integration Connect Sui to a physical robot via polling architecture. Map on-chain actions to robot commands.
- R5: Live Control — WebSocket + Serial Real-time robot control over local network. Command queuing and latency optimization.
- R6: Open to the World — Tunneling 101 Control your robot from anywhere using Cloudflare Tunnel.
- R7: Secure the Channel — Authentication Ed25519 challenge-response auth (Part A) and on-chain state channels for trustless operation (Part B).
- R8: Pay to Play — Tokenomics Custom COOKIE token, rate-limited faucet, and pay-per-action system using Sui Coin modules and TreasuryCap.
- R9: Multiplayer Robot — Shared State
On-chain fairness queue, React dApp with wallet integration (
@mysten/dapp-kit-react), and WebSocket broadcast server. - R10: Robot Rental Platform — Capstone Complete platform: TREAT token escrow, robot registry, Ed25519 command signing, time-based billing, and rental receipts.
| Tool | Required for |
|---|---|
| Sui CLI | All Move modules |
| Node.js 18+ & npm/pnpm | TypeScript projects (D, E, F, K, R series) |
| Python 3 | Robot device detection (R1) |
| Petoi Bittle X | Physical robot experience (R1, R4, R5+) — optional, simulation available |
| Docker | J3 (Prometheus/Grafana monitoring) |
| Layer | Technologies |
|---|---|
| Blockchain | Sui, Move 2024 edition |
| Backend | Node.js, TypeScript |
| Frontend | React, Vite, @mysten/dapp-kit-react |
| Real-time | WebSocket (ws library) |
| Hardware | serialport library, Petoi Bittle X |
| Networking | Cloudflare Tunnel |
| Crypto | Ed25519 (@noble/ed25519) |
| Monitoring | Prometheus, Grafana, Docker Compose |
Each module contains detailed lessons, code examples, and exercises. Start exploring by clicking on any module above!