This clones:
- Sui official documentation
- Sui whitepaper and technical docs

## Quick Search

## 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

- 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**:

# 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

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