sui-walruslisted
Install: claude install-skill widnyana/eyay-toolkits
# Walrus Skill
Integrate [Walrus](https://docs.wal.app) — Mysten Labs' decentralized blob storage layer. Walrus stores immutable byte arrays ("blobs"); Sui handles coordination, payments, metadata, and object ownership. Storage is provided by erasure-coded slivers across ~1000 shards with Byzantine fault tolerance up to 1/3 malicious nodes. Follow these rules precisely.
> **Critical**: All blobs on Walrus are **public and discoverable by anyone**. Deletion does not remove cached copies. If the data is sensitive, **encrypt before uploading** (see the `sui-seal` skill for the canonical pattern).
---
## 1. Mental model (read first)
A successful Walrus upload is **three Sui transactions plus distributed storage work**:
1. **Register** the blob on Sui (reserve storage, mint a `Blob` object).
2. **Upload** slivers (erasure-coded fragments) to ~2/3 of storage nodes — roughly 2200 HTTP requests direct.
3. **Certify** availability on Sui once enough nodes have acknowledged — this is the "Point of Availability" (PoA).
Reading a blob is ~335 requests to reconstruct from slivers. These numbers are why most apps **do not call storage nodes directly** — they use one of:
- **Publishers / Aggregators** (public or self-hosted HTTP gateways) — simplest; a single HTTP PUT/GET.
- **Upload relay** — the SDK writes via one request to a relay that fans out to nodes. Recommended for browsers and mobile.
- **Direct SDK** (`@mysten/walrus`) — full control; carries the request overhead. Best fo