sui-foundation/sui-move-intro-course

Introductory Course to the Sui Move language

Move Intro Course

Introductory course to the Move language maintained by Sui Foundation.

Content

• Unit One: Environment Setup and Hello World
  • Set Up Environment
  • Sui Project Structure
  • Custom Types and Abilities
  • Functions
  • Contract Deployment
• Unit Two: Working with Sui Objects
  • Introduction
  • Ownership
  • Parameter Passing and Object Deletion
  • Object Wrapping
  • Object Wrapping by Example
  • Capability Design Pattern
  • Events
• Unit Three: Fungible Tokens
  • Sui Framework
  • Intro to Generics
  • Witness Design Pattern
  • The Coin Resource and create_currency Method
  • Managed Coin Example
  • Clock and Locked Coin
  • Unit Testing
• Unit Four: Marketplace
  • Homogeneous Collections
  • Dynamic Fields
  • Heterogeneous Collections
  • Marketplace Contract
  • Deployment and Testing
• Unit Five: Sui Kiosk
  • Programmable Transaction Block
  • Hot Potato Design Pattern
  • Sui Kiosk Basic Concepts
  • Sui Kiosk Basic Usage
  • Transfer Policy
• Advanced Topics
  • BCS Encoding

TODOs

• Write BCS lesson for advanced topics
• Create a multi-platform Docker image
• Create exercises for each unit
• Add content on Display.move
• Add content on clock and example on token unlocking
• Write advanced topic lesson on closed loop token standard
• Write advanced topic lesson on package upgrades
• Write new lesson on kiosks
• Check and update Unit One against latest version of Sui
• Check and update Unit Two against latest version of Sui
• Check and update Unit Three against latest version of Sui
• Check and update Unit Four against latest version of Sui
• Check and update Advanced Topics against latest version of Sui

General Developer Resources

• Sui Developer Documentation
• Sui Developer Portal
• Sui GitHub
• Sui Framework Documentation
• Sui Typescript SDK (official)
• Sui Typescript SDK (community)
• Sui Rust SDK (official)
• Sui Golang SDK (community)
• Sui Python SDK (community)
• Sui Java SDK (community)
• Sui Kotlin SDK (community)
• Sui C# SDK (community)
• Sui Dart SDK(community)
• Sui Explorer

Socials and Communities

If you want to join Sui's online communities, you can join via following links:

• Sui Network Twitter
• Sui Official Discord
• Sui Developer Forums

Repo Translations

• English
• Chinese
• Thai

Please get in touch if you want to help translate this into other languages.

Videos and Other Formats

• Encode Club Video Series (English) YouTube playlist | tutorial and code
• BuidlerDAO Video Series (Chinese)
• MoveBit Move on Sui Course (English) YouTube playlist | tutorial and code

FAQ

1. Can I use the content of this repo to produce other educational content related to Sui or Sui Move programming language?

   Yes. That is the original intention of this repo, to allow content creators and educational platforms to use and expand on the material within this repo to create different forms of media or technical content about Sui or the Sui Move language.

   This repo is licensed under the Creative Common License; CC-BY-SA-4.0 license, to be specific. This allows anyone to remix, transform, build or share the content in this repo for whatever purposes, but any content based on this repo also needs to be licensed under the same Creative Common License, and give an attribution to the source.

2. How can I contribute to this repo?

   Fork and open a PR against the upstream repo. We are open to community contributions.

sui-move-intro-course's Issues

Running hello world with error `InsufficientGas in command 0`

I was following the unit one class and published with default gas value 30000:

$ sui client publish --gas-budget 30000

but it said that:

Successfully verified dependencies on-chain against source.
Error executing transaction: Failure {
    error: "InsufficientGas in command 0",
}

这教程太牛了

简单易懂，但是把我自己研究当中遇到想不明白的问题全给说透彻了，可谓短小精干，star一下，以示尊重

We don't need to run docker if we install sui binary locally, right?

Thanks for making this intro, I've been looking for sui tutorials that is concise like this one!

In the env setup, docker image is only for running sui binary without install it locally, right? Could you also link the docker compose file of the image?

unit-one/lessons/3_custom_types_and_abilities.md

failed to compile `sui v1.18.0 (https://github.com/MystenLabs/sui.git?branch=testnet#673fcb2a)`

after following the steps on Sui Documentation i encounter this error, i´ve also seen the instalation video and installed nvm as he does even after i got this error, finally i tried again but same error comes out

create-example-nft subcommand

create-example-nft subcommand deprecated/no longer working?

error: Found argument 'create-example-nft' which wasn't expected, or isn't valid in this context

Sui docker Image's platform supports arm based machine but its not native to intel machines.

docker run --entrypoint /bin/sh -itd hyd628/sui-move-intro-course:latest
WARNING: The requested image's platform (linux/arm64/v8) does not match the detected host platform (linux/amd64) and no specific platform was requested

Suggest to make two different versions of docker image, seperated by tag, ex :arm, :intel and upload a intel machine compiled image.

Loops : Sui Move

How do I use loops in sui move ? didn't find any reference for that on the internet !
It would be helpful if the package includes a guide .

Sui wallet

error: failed to compile sui v1.18.0 (https://github.com/MystenLabs/sui.git?branch=testnet#673fcb2a), intermediate artifacts can be found at /tmp/cargo-installeVtYDN.

I was trying to install sui on my ubuntu,but repeated failed build has made it impossible just to install sui.My ubuntu version is
Distributor ID: Ubuntu
Description: Ubuntu 22.04.3 LTS
Release: 22.04
Codename: jammy

other necessary info:
cargo --version
cargo 1.75.0 (1d8b05cdd 2023-11-20)

rustup
rustup 1.26.0 (5af9b9484 2023-04-05)
The Rust toolchain installer

I am stuck here in this build failing message.How can I overcome this problem.Please help
Compiling diesel_migrations v2.1.0
error: rustc interrupted by SIGSEGV, printing backtrace
note: we would appreciate a report at https://github.com/rust-lang/rust
note: backtrace dumped due to SIGSEGV! resuming signal
error: could not compile arrow-select (lib)
arning: build failed, waiting for other jobs to finish...
error: failed to compile sui v1.18.0 (https://github.com/MystenLabs/sui.git?branch=testnet#673fcb2a), intermediate artifacts can be found at /tmp/cargo-installeVtYDN.

hello_world example display 403 Forbidden

https://intro.sui-book.com/unit-one/example_projects/hello_world/

RPC Error trying to publish the contract from unit one

Following the steps from this lesson I am trying to deploy the contract however I am getting the following error message.

RPC call failed: ErrorObject { code: ServerError(-32002), message: "Transaction execution failed due to issues with transaction inputs, please review the errors and try again: TransferObjects, MergeCoin, and Publish cannot have empty arguments. If MakeMoveVec has empty arguments, it must have a type specified.", data: None }

Caused by:
RPC call failed: ErrorObject { code: ServerError(-32002), message: "Transaction execution failed due to issues with transaction inputs, please review the errors and try again: TransferObjects, MergeCoin, and Publish cannot have empty arguments. If MakeMoveVec has empty arguments, it must have a type specified.", data: None }

Is there a missing step somewhere?

example of end to end test

Would it be a useful addition to write the end-to-end tests for 5_deployment_and_testing.md using the test_scenario module?

Is it best practice to write your e_to_e tests in move? I would think it saves you the hassle of publishing and making individual calls via the CLI.