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 ```bash cd {baseDir} chmod +x setup.sh && ./setup.sh ``` This clones: - Sui official documentation - Sui whitepaper and technical docs ## Quick Search ```bash # 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**: ```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