Concepts

Architecture

Networks

Sui operates multiple networks including Mainnet for production, Testnet for staging, Devnet for developing new features, and Localnet for local development.

Storage

Historical data and storage pricing provide insights into the cost of operations on the Sui network.

Consensus

Overview of the Sui consensus mechanism.

Epochs and Reconfiguration

Epochs define time periods on Sui where the validator set remains unchanged. Equivocation occurs when objects are used incorrectly across transactions. Reconfiguration adjusts network parameters at epoch boundaries.

Security

Assets on Sui, including coins and tokens, are types of objects, and can only be used by their owners unless otherwise defined according to predefined logic in a smart contract.

Protocol Upgrades

The Sui protocol, framework, and execution engine are frequently extended to include new functionality and bug fixes. The upgrade process ensures all clients use the same source.

Transactions

Transaction Lifecycle

The life of a transaction on the Sui network has some differences compared to those from other blockchains.

Programmable Transaction Blocks

Programmable transaction blocks are a group of commands that complete a transaction on Sui.

Sponsored Transactions

A sponsored transaction is when one Sui address pays the gas fee for a transaction submitted by another address. Sponsored transactions can help facilitate user onboarding and simplified asset management.

Gas Smashing

Sui optimizes coin management by combining multiple coins into a single object to pay for gas fees.

Coin Management

Because Sui uses coins as owned objects for transactions, you need to explicitly manage them in your programmable transaction block development.

Transaction Authentication

Understanding cryptographic keys, addresses, and signatures on Sui. Sui supports multiple cryptography algorithms and primitives with rapid switching between them.

Tokenomics

SUI Tokenomics

Sui's tokenomics is designed to support the long-term financial needs of Web3. It uses the native SUI token as the currency of the network and to pay for the network's gas fees.

Staking and Unstaking

Staking and unstaking SUI with validators earns a percentage of rewards they receive from gas fees.

SUI Bridging

Moving tokens from one blockchain to another is called bridging. To bridge tokens from another blockchain to Sui, you can use the Sui Bridge, Wormhole Connect, Wormhole Portal Bridge, or ZetaChain.

Gas Fees

A Sui transaction must pay for both the computational cost of execution and the long-term cost of storing the objects a transaction creates or mutates.

Move

Move Concepts

Move is an open source language for writing safe packages to manipulate on-chain objects.

Packages

A Move package on Sui includes one or more modules that define that package's interaction with on-chain objects. Upgrading packages lets you improve code or add features without breaking packages that depend on them.

Conventions

Recommended Move 2024 best practices for Sui development.

Move 2024 Migration

New features are becoming available to Move in 2024. These features are opt-in, so existing code will continue to function as expected. If you want to use these features in code you've already written, however, there are some steps you must take and breaking changes to be aware of to migrate to Move 2024.

Accessing data

Accessing Data

Overview of the types of data access mechanisms available in Sui.

GraphQL Indexer

The GraphQL RPC Beta service offers a structured way for your clients to interact with data on the Sui blockchain. It accesses data processed by a general-purpose indexer and can connect to an archival store for historical network state.

GraphQL RPC

Use GraphQL to make Sui RPC calls. This feature is currently in Beta.

Cryptography

Cryptography

Sui supports multiple cryptography algorithms and primitives, while also defining its own such as public keys, signatures, aggregated signatures, and hash functions.

zkLogin

zkLogin is a Sui primitive that enables you to send transactions from a Sui address using an OAuth credential without publicly linking the two.

Passkeys

Sui supports the passkey signature scheme that enables you to sign in to apps and sign transactions using a private key stored securely on a passkey authenticator. It uses the WebAuthn standard.

Nautilus

Overview of the design aspects of Nautilus, including its trust model.

Checkpoint Verification

On the Sui network, checkpoints define the history of the blockchain. Checkpoint verification is how full nodes and other clients guarantee their state is exactly the same as the Sui network.

Additional resources

Gaming on Sui

Sui offers features like dynamic NFTs, Kiosk, soulbound assets, and on-chain randomness to provide builders with the tools to create immersive, transparent, and fair gaming experiences.

Research Papers

Research papers that are relevant to Sui and that one or more Sui team members have co-authored.