memwallisted

# MemWal — Privacy-First AI Memory SDK MemWal is a TypeScript SDK for persistent, encrypted AI memory. It stores memories on Walrus (decentralized storage), encrypts them with SEAL, enforces ownership onchain via Sui smart contracts, and retrieves them with semantic (vector) search. Memories are scoped by `owner + namespace` — each namespace is an isolated memory space. --- ## When to Use Use MemWal when your app or agent needs: - **Persistent memory** across sessions, devices, or restarts - **Encrypted storage** — end-to-end encryption, only the owner and authorized delegates can decrypt - **Semantic recall** — retrieve memories by meaning, not just keywords - **Decentralized storage** — no single point of failure, stored on Walrus - **Onchain ownership** — cryptographically enforced access control on Sui - **Cross-app memory** — share memory between apps via delegate keys --- ## When NOT to Use - Temporary conversation context that only matters in the current session - Large file storage (MemWal is optimized for text memories) - Use cases that don't need encryption or decentralization --- ## Installation ```bash # Install the SDK pnpm add @mysten-incubation/memwal # Optional: for Vercel AI SDK integration pnpm add ai zod # Optional: for manual client (client-side SEAL encryption) pnpm add @mysten/sui @mysten/seal @mysten/walrus ``` --- ## Quick Start ### 1. Get Your Credentials You need a **delegate key** (Ed25519 private key) and **account ID** (MemWalAcco