# Sui Tools Guide

> Use during product design and stack selection — choosing between SUI ecosystem tools and official building blocks (Walrus vs Arweave, zkLogin vs Passkey, DeepBook vs AMM, Kiosk vs custom marketplace). Triggers on "which SUI stack", "compare Walrus and IPFS", "what tools are available", "best library for", "which auth method", "storage options on SUI", or any SUI tool/library selection decision. This is for CHOOSING tools, not designing contract architecture (that's sui-architect). Use when this capability is needed.

- Skill: `tomevault-io/sui-tools-guide` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/sui-tools-guide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/sui-tools-guide/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/sui-tools-guide

---


# SUI Tools Guide

**Navigate the SUI ecosystem and choose the right tools for your project.**

## Overview

This guide helps you:
- Understand available SUI ecosystem tools
- Choose the right tools for your use case
- Learn how to combine multiple tools
- Get started quickly with integration patterns

## Available Tools

### Storage & Data
- **Walrus** - Decentralized blob storage for NFT metadata, files, and media
- **Arweave** - Permanent storage alternative

### Identity & Auth
- **zkLogin** - OAuth-based authentication (Google, Facebook, Twitch)
- **Passkey** - WebAuthn passwordless login
- **Multi-sig** - Multi-signature wallets

### DeFi & Trading
- **DeepBook** - Decentralized order book DEX
- **Cetus** - AMM protocol
- **Turbos** - AMM with concentrated liquidity

### NFT Infrastructure
- **Kiosk** - NFT trading standard with transfer policies and royalties
- **OriginByte** - NFT protocol suite

### Domain & Identity
- **SuiNS** - SUI Name Service (human-readable addresses)

### Privacy & Off-Chain Compute
- **Seal** - Decentralized Secrets Management (threshold encryption + on-chain access policies)
- **Nautilus** - Verifiable off-chain computation (AWS Nitro Enclaves + on-chain signature verification)

### Data & Indexing
- **Indexer Framework** - Custom data pipelines for historical analytics, event aggregation, real-time derived data

## Decision Tree

### "I'm building..."

**NFT Marketplace**
→ Use: Kiosk (required), Walrus (metadata), SuiNS (optional)

**DeFi Protocol**
→ Use: DeepBook (orderbook) or Cetus/Turbos (AMM)

**GameFi**
→ Use: Kiosk (items), Walrus (assets), zkLogin (easy onboarding)

**DAO**
→ Use: Multi-sig, custom governance

**Social Platform**
→ Use: zkLogin (auth), Walrus (media), SuiNS (profiles)

**Analytics / Data Platform**
→ Use: Indexer Framework (historical data), GraphQL (frontend queries)

## Tool Combinations

### NFT Marketplace Stack
```
Kiosk (NFT standard)
  + Walrus (metadata storage)
  + zkLogin (user auth)
  + SuiNS (seller profiles)
```

### DeFi Trading Stack
```
DeepBook (orderbook)
  + Pyth/Switchboard (price feeds)
  + Multi-sig (treasury)
```

### GameFi Stack
```
Kiosk (in-game items)
  + Walrus (game assets)
  + zkLogin (player login)
  + Leaderboard (custom)
```

## Quick Start for Each Tool

For detailed integration, use the specific tool skills:
- `sui-walrus` - Walrus integration
- `sui-zklogin` - zkLogin integration
- `sui-deepbook` - DeepBook integration
- `sui-kiosk` - Kiosk integration
- `sui-passkey` - Passkey integration
- `sui-seal` - Secrets management / threshold encryption
- `sui-nautilus` - Verifiable off-chain compute integration
- `sui-suins` - SuiNS integration
- `sui-indexer` - Custom data pipeline integration

## Integration Complexity Matrix

| Tool | Complexity | Time to Integrate | Required For |
|------|-----------|-------------------|--------------|
| Kiosk | Medium | 1-2 days | NFT marketplaces |
| Walrus | Low | 2-4 hours | Decentralized storage |
| zkLogin | Medium | 1 day | OAuth authentication |
| DeepBook | High | 3-5 days | Orderbook DEX |
| SuiNS | Low | 1-2 hours | Name resolution |
| Passkey | Low | 2-4 hours | Passwordless auth |
| Seal | Medium | 1-2 days | Threshold encryption / secrets management |
| Nautilus | High | 3-7 days | Verifiable off-chain compute |
| Indexer | High | 2-5 days | Historical analytics, data pipelines |

## Common Patterns

### Pattern 1: NFT with Metadata
```move
// Store blob ID in NFT
public struct NFT has key, store {
    id: UID,
    name: String,
    walrus_blob_id: vector<u8>
}
```

### Pattern 2: User Identity
```move
// Support both zkLogin and traditional wallets
public fun authenticate(
    zklogin_proof: Option<ZkLoginProof>,
    ctx: &TxContext
) {
    let user = if (option::is_some(&zklogin_proof)) {
        // Verify zkLogin
        zklogin::verify(option::borrow(&zklogin_proof))
    } else {
        // Traditional wallet
        tx_context::sender(ctx)
    };
}
```

### Pattern 3: Trading with Royalties
```move
// Kiosk + custom royalty logic
use sui::kiosk;
use sui::transfer_policy;

public fun buy_with_royalty<T: key + store>(
    kiosk: &mut Kiosk,
    item_id: ID,
    payment: Coin<SUI>,
    policy: &TransferPolicy<T>,
    ctx: &mut TxContext
) {
    // Kiosk handles transfer policy enforcement
    kiosk::purchase(kiosk, item_id, payment, policy, ctx);
}
```

## Recommended Combinations

### Beginner Projects
Start simple:
- NFT collection → Just Kiosk
- Simple marketplace → Kiosk + basic UI
- DeFi token → Standard Coin module

### Intermediate Projects
Add one ecosystem tool:
- NFT marketplace → Kiosk + Walrus
- Social app → zkLogin + custom logic
- Trading app → DeepBook + price feeds

### Advanced Projects
Combine multiple tools:
- Full marketplace → Kiosk + Walrus + zkLogin + SuiNS
- DeFi protocol → DeepBook + Oracle + Multi-sig + Governance
- Cross-chain app → Nautilus + Kiosk + DeepBook
- Analytics dashboard → Indexer + GraphQL + custom frontend

## When NOT to Use Ecosystem Tools

**Don't over-engineer:**
- Simple NFT collection → Don't need zkLogin, SuiNS, etc.
- Internal tools → Don't need decentralized storage
- MVP/prototype → Start with core features only

**Build custom when:**
- Unique requirements not met by existing tools
- Performance is critical
- You need full control

## Common Mistakes

❌ **Using tools without understanding tradeoffs**
- **Problem:** Wrong tool for use case, technical debt
- **Fix:** Review tool complexity matrix, start simple

❌ **Integrating all tools at once**
- **Problem:** Overwhelming complexity, delays launch
- **Fix:** Start with core tool (e.g., Kiosk), add others later

❌ **Not checking tool maintenance status**
- **Problem:** Using deprecated/unmaintained tools
- **Fix:** Query GitHub activity, check latest docs before integrating

❌ **Skipping testnet before mainnet**
- **Problem:** Tool integration bugs discovered in production
- **Fix:** Test full stack on testnet for 48+ hours

❌ **Choosing tools based on hype**
- **Problem:** Tool doesn't fit your actual needs
- **Fix:** Use decision tree, focus on requirements not trends

❌ **Not reading tool-specific documentation**
- **Problem:** Incorrect implementation, missing features
- **Fix:** Use tool-specific skills (sui-walrus, sui-zklogin, etc.)

❌ **Over-relying on ecosystem tools for core logic**
- **Problem:** Locked into external dependencies
- **Fix:** Build core business logic in-house, use tools for infrastructure

## Getting Help

Each tool has its own skill for detailed integration:
```bash
# Example: Get Walrus integration help
sui-walrus

# Example: Get zkLogin help
sui-zklogin
```

Query latest tool updates:
```typescript
const toolInfo = await sui_docs_query({
  type: "docs",
  target: "walrus",
  query: "latest features and API updates"
});
```

---

**Choose the right tools, build faster, leverage the SUI ecosystem!**

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/first-mover-tw) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->