In this lecture, we will learn about types and abilities.

We will start with creating our Hello World demo contract step by step and explain fundamental concepts in Sui Move as they come up, such as custom types and abilities.

(If you skipped the previous section) You can initialize a Hello World Sui package with the following command in the command line after installing Sui binaries:

sui move new hello_world

Use an editor of your choice to create a Move smart contract source file called hello.move under the sources subfolder.

And create the empty module as following:

module hello_world::hello { 
   // module contents 
}

Import Statements

You can directly import modules in Move by their address, but to make code easier to read, we can organize imports with the keyword use.

use <Address/Alias>::<ModuleName>; 

In our example, we need to import the following modules:

use std::string; 
use sui::object::{Self, UID}; 
use sui::transfer; 
use sui::tx_context::{Self, TxContext};

Custom Types

A structure in Sui Move is a custom type that contains key-value pairs, where the key is the name of a property and the value is what's stored. Defined using keyword struct, a structure can have up to 4 abilities.

Abilities are keywords in Sui Move that define how types behave at the compiler level.

Abilities are crucial to defining how object behave in Sui Move at the language level. Each unique combination of abilities in Sui Move is its own design pattern. We will study abitilies and how to use them in Sui Move throughout the course.

For now, just know that there are four abilities in Sui Move:

• Copy: value can be copied (or cloned by value)

• Drop: value can be dropped by the end of scope

• Key: value can be used as a key for global storage operations

• Store: value can be stored inside global storage

Custom types that have the abilities key and store are considered to be assets in Sui Move. Assets are stored in global storage and can be transferred between accounts.

We define the object in our Hello World example as the following:

/// An object that contains an arbitrary string
struct HelloWorldObject has key, store {
      id: UID,
      /// A string contained in the object
      text: string::String
}

UID here is a Sui Framework type (sui::object::UID) that defines the globally unique ID of an object. Any custom type with the key ability is required to have an ID field.

example

https://github.com/seapad-fund/sui-contracts/blob/1d062984acdc53916001bcedc7b103f577a6112b/nft/sources/nftbox.move#L147

Rederence

https://github.com/sui-foundation/sui-move-intro-course/blob/main/unit-one/lessons/3_custom_types_and_abilities.md

In this lecture, we will learn about types and abilities.

We will start with creating our Hello World demo contract step by step and explain fundamental concepts in Sui Move as they come up, such as custom types and abilities.

(If you skipped the previous section) You can initialize a Hello World Sui package with the following command in the command line after installing Sui binaries:

sui move new hello_world

Use an editor of your choice to create a Move smart contract source file called hello.move under the sources subfolder.

And create the empty module as following:

module hello_world::hello { 
   // module contents 
}

Import Statements

You can directly import modules in Move by their address, but to make code easier to read, we can organize imports with the keyword use.

use <Address/Alias>::<ModuleName>; 

In our example, we need to import the following modules:

use std::string; 
use sui::object::{Self, UID}; 
use sui::transfer; 
use sui::tx_context::{Self, TxContext};

Custom Types

A structure in Sui Move is a custom type that contains key-value pairs, where the key is the name of a property and the value is what's stored. Defined using keyword struct, a structure can have up to 4 abilities.

Abilities are keywords in Sui Move that define how types behave at the compiler level.

Abilities are crucial to defining how object behave in Sui Move at the language level. Each unique combination of abilities in Sui Move is its own design pattern. We will study abitilies and how to use them in Sui Move throughout the course.

For now, just know that there are four abilities in Sui Move:

• Copy: value can be copied (or cloned by value)

• Drop: value can be dropped by the end of scope

• Key: value can be used as a key for global storage operations

• Store: value can be stored inside global storage

Custom types that have the abilities key and store are considered to be assets in Sui Move. Assets are stored in global storage and can be transferred between accounts.

We define the object in our Hello World example as the following:

/// An object that contains an arbitrary string
struct HelloWorldObject has key, store {
      id: UID,
      /// A string contained in the object
      text: string::String
}

UID here is a Sui Framework type (sui::object::UID) that defines the globally unique ID of an object. Any custom type with the key ability is required to have an ID field.

example

https://github.com/seapad-fund/sui-contracts/blob/1d062984acdc53916001bcedc7b103f577a6112b/nft/sources/nftbox.move#L147

Rederence

https://github.com/sui-foundation/sui-move-intro-course/blob/main/unit-one/lessons/3_custom_types_and_abilities.md