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