back to portfolio

Walrus-SDK

Type-safe TypeScript SDK for Walrus decentralized storage on Sui.

Problem

Walrus exposes raw HTTP Publisher/Aggregator endpoints — boilerplate, weak types, awkward error handling.

Mechanism

A thin, type-safe wrapper over the Walrus HTTP API: upload, retrieve, and verify blobs with proper TS types.

Outcome

Drop-in storage for AI datasets, NFT media, and encrypted user content — published on npm as `walrus-sdk`.

How it works

01Install

Add walrus-sdk to any TS / Node project.

02Upload

Pass a Buffer/file → returns a Walrus blob ID.

03Retrieve

Query the aggregator by blob ID to get bytes back.

Stack

TypeScriptWalrus HTTP APISuinpm

Run it

npm install walrus-sdk
// in your code:
import { WalrusClient } from 'walrus-sdk';
const client = new WalrusClient({ publisher, aggregator });
const { blobId } = await client.upload(fileBuffer);
const bytes = await client.retrieve(blobId);
Live demo