Sui Knowledge Base

Expert knowledge about Sui blockchain ecosystem. Use this skill to answer questions about Sui concepts, architecture, tokenomics, and ecosystem.

When to Use This Skill

Activate when users ask about:

• What is Sui? How does it work?

• Sui vs Ethereum/Solana/other chains

• SUI token, tokenomics, staking

• Validators, consensus, transactions

• Sui ecosystem, projects, wallets

• Object model, ownership concepts

• Performance, TPS, finality

For Move programming questions → use sui-move skill instead

Setup References

cd {baseDir}
chmod +x setup.sh && ./setup.sh

This clones:

• Sui official documentation

• Sui whitepaper and technical docs

Quick Search

# Search Sui docs
rg -i "keyword" {baseDir}/references/sui-docs/ --type md -C 2

# Search for specific concepts
rg -i "object|ownership|transfer" {baseDir}/references/ --type md

Core Concepts

What is Sui?

Sui is a Layer 1 blockchain designed for high throughput and low latency. Key innovations:

1. Object-Centric Model: Unlike account-based chains, Sui treats everything as objects with unique IDs

2. Parallel Execution: Independent transactions execute in parallel without global ordering

3. Move Language: Safe, resource-oriented smart contract language

4. Mysticeti Consensus: Fast finality (~390ms) for shared objects

Object Model

┌─────────────────────────────────────────┐
│              Object Types               │
├─────────────────────────────────────────┤
│ Owned Objects    → Single owner address │
│ Shared Objects   → Multiple can access  │
│ Immutable Objects→ Frozen, read-only    │
│ Wrapped Objects  → Nested in another    │
└─────────────────────────────────────────┘

• Every object has a unique ObjectID (32 bytes)

• Objects have version that increments on mutation

• Owned object transactions don't need consensus (fast path)

Transaction Types

SUI Token

• Ticker: SUI

• Total Supply: 10 billion SUI

• Uses: Gas fees, staking, governance

• Smallest Unit: MIST (1 SUI = 10^9 MIST)

Gas Model

• Gas price in MIST per computation unit

• Storage rebates: Get gas back when deleting objects

• Sponsored transactions: Third party pays gas

Validators & Staking

• Delegated Proof of Stake (DPoS)

• ~100+ active validators

• Stake SUI to validators to earn rewards

• Epoch: ~24 hours

Consensus: Mysticeti

• DAG-based consensus protocol

• Sub-second finality for shared objects

• Replaces Narwhal/Bullshark (used previously)

Sui vs Other Chains

Ecosystem

Wallets

• Sui Wallet (official)

• Suiet

• Ethos

• Martian

DEXs

• Cetus

• Turbos

• DeepBook (order book)

NFT Marketplaces

• BlueMove

• Clutchy

• Hyperspace

Developer Tools

• Sui CLI

• Sui Explorer

• Move Analyzer (VSCode)

Common Questions

"Is Sui EVM compatible?"

No. Sui uses Move, not EVM. However, bridges exist to transfer assets from EVM chains.

"How fast is Sui?"

• Owned object txs: ~200ms

• Shared object txs: ~390ms

• Theoretical TPS: 100,000+

"How do I stake SUI?"

1. Open Sui Wallet

2. Go to Staking tab

3. Choose a validator

4. Enter amount and confirm

"What's the difference between Sui Move and Aptos Move?"

• Sui uses object-centric storage

• Different standard library

• Sui has native object primitives

• Some syntax differences in Move 2024

Answering Workflow

1. Identify the question type:

   • General knowledge → Answer from this skill
   • Move programming → Refer to sui-move skill
   • Specific API/code → Search references

2. Search if needed: bash rg -i "question keywords" {baseDir}/references/

3. Provide clear answer with:

   • Direct answer first
   • Supporting details
   • Links to official docs if relevant

Official Resources

• Website: https://sui.io

• Docs: https://docs.sui.io

• GitHub: https://github.com/MystenLabs/sui

• Discord: https://discord.gg/sui

• Twitter: @SuiNetwork