Move Book and Move Language Reference

The Move Basics chapter provides a foundation in the Move language syntax, type system, and core concepts. This knowledge is applicable to any Move program, though specific Sui storage and object models are covered in subsequent chapters.

Key areas covered include:

• Code Organization: Modules, comments, primitive types, the address type, expressions, and functions.
• Custom Types: Structs and the Ability system (e.g., drop).
• Code Reuse: Importing modules and using the Standard Library (e.g., vector, Option, String).
• Logic & Control: Control flow, enums with pattern matching, struct methods, and visibility modifiers.
• Safety & Ownership: Ownership and scope, the copy ability, constants, aborting execution (assert and abort), and references.
• Abstraction: Generics, macro functions, internal permits, type reflection, and testing.

Advanced Move usage covers features that extend beyond the language fundamentals, including advanced programming techniques, extended build configurations, and specific language modifiers. Key areas of focus include:

• Compilation Modes: Managing different build modes, such as including unpublishable code in named build modes.
• Entry Functions: Using the entry modifier and understanding the static hot-potato guarantee, which ensures safe transaction boundaries.

The Move Book is a comprehensive guide designed for developers interested in learning the Move programming language and building smart contracts on the Sui blockchain. It covers a spectrum of topics ranging from introductory concepts to advanced patterns, storage, and programmability.

Note that Move and the Sui framework are evolving; the book is updated continuously to reflect new features. For technical specifications and language details, users should refer to The Move Reference.

This guide provides a foundational workflow for interacting with the Sui blockchain using the Sui CLI. It covers the end-to-end process of:

1. Creating and Building: Initializing a new Move package and compiling it.
2. Account Management: Setting up a Sui account and requesting testnet coins.
3. Publishing: Deploying a Move package to the blockchain.
4. Interacting: Using the CLI to create objects (e.g., a list), modify them (add/remove items), and execute multiple commands within a single transaction block.
5. Observing: Inspecting transaction data and transaction effects to verify execution.

The Move Book provides an overview of the fundamental building blocks required to write Move programs on the Sui blockchain. Key concepts include:

• Packages: The primary units of code organization in Move.
• Move.toml: The manifest file used to define package metadata and dependencies.
• Addresses and Accounts: The model for identity and ownership on Sui.
• Transactions: The mechanism for interacting with the blockchain and executing code.
• Data Storage: How data is persisted and managed on the Sui blockchain.

For a complete technical reference, developers should consult the official Sui Documentation.

The Move Book provides practical guides for common Sui Move development tasks, focusing on practical challenges and solutions. Available topics include:

• Token Creation: Creating fungible tokens.
• Marketplaces: Building NFT marketplaces.
• Package Management: Handling package upgrades.
• Security & Control: Implementing access control.
• Transactions: Working with programmable transactions.
• Best Practices: Error handling, code quality, and open-source best practices.

The repository is organized into the following directories:

• book/: Contains the main Move Book content.
• reference/: Contains the Move Language Reference content.
• packages/: Contains the code samples used throughout both books.
• site/: Contains the Docusaurus configuration and custom plugins used to build the website.