sui-knowledge

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

Type	Consensus	Speed	Use Case
Owned Object	No (fast path)	~200ms	Transfers, simple ops
Shared Object	Yes (Mysticeti)	~390ms	DEX, auctions, games

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

Feature	Sui	Ethereum	Solana
Model	Object-centric	Account-based	Account-based
Language	Move	Solidity	Rust
TPS	100k+	~15	~65k
Finality	<1s	~12min	~400ms
Parallel Exec	Yes (objects)	Limited	Yes

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:

   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