MemWal is currently in beta and actively evolving. While fully usable today, we continue to refine the developer experience and operational guidance. We welcome feedback from early builders as we continue to improve the product.
End-to-End Encrypted
Client-side encryption — nobody sees your data but you
Decentralized Storage
Stored on Walrus — no single point of failure
AI-Agent Ready
Give agents scoped access to memory via delegate keys
Onchain Ownership
Sui smart contracts enforce who can read and write
Motivation
AI agents today lose context between sessions — every conversation starts from scratch. When memory does exist, it’s locked inside platform-specific databases that the user doesn’t control. MemWal solves this by giving agents:- Persistent memory — context that carries across sessions and apps
- Decentralized, highly available storage — with end-to-end encryption baked in
- Provable ownership — cryptographically enforced, not just a policy promise
- Fine-grained access control — users decide who can read, write, or delegate access
Features
Memory Operations
Remember
Store memories with semantic understanding. The relayer generates vector embeddings so your data is searchable by meaning, not just keywords.
Recall
Retrieve relevant memories using natural language queries. Finds the closest matches based on meaning, scoped to your memory space.
Analyze
Extract structured facts from text automatically. Each fact is stored as a separate memory for more precise recall later.
Ask
Query your memories and get an AI-generated answer with the relevant context attached. Combines recall with LLM reasoning.
Security & Access Control
End-to-End Encryption
All content is encrypted via SEAL before it reaches Walrus. Only the owner and authorized delegates can decrypt it.
Decentralized Storage
Encrypted blobs stored on Walrus — no single point of failure, no central operator holding your data.
Onchain Ownership
Ownership and access enforced by Sui smart contracts. Cryptographic and tamper-proof.
Delegate Access
Grant scoped access to other users, agents, or services — all managed onchain by the owner.
Infrastructure
Restore
Rebuild your index from Walrus if it’s ever lost. Rediscovers blobs by owner and namespace, re-embeds only missing entries.
AI Middleware
Drop-in memory for Vercel AI SDK apps. Automatically saves and recalls context around AI conversations.
What’s Included
- TypeScript SDK: integrate memory into any app with a few lines of code
- Relayer: handles encryption, storage, and retrieval behind a simple API
- Smart Contract: enforces ownership and delegate access onchain
- Indexer: keeps onchain state synced for fast lookups
- Dashboard: manage accounts, memory, and delegate keys visually
Use Cases
MemWal fits any app that needs to store, retrieve, and update memory persistently:- AI chat apps — capture valuable knowledge from conversations so agents remember context across sessions
- Note-taking and knowledge tools — save user insights, summaries, and references as persistent, encrypted memory
- Multi-agent workflows — share a common data layer between agents for task lists, knowledge bases, and coordination state
- Personal AI assistants — build agents that learn and adapt over time without losing what they’ve learned
- Cross-app memory — let users carry their memory between different apps and services, owned by them
Example Apps
The repo ships with ready-to-run apps in the/apps directory:
- Playground — dashboard demo for MemWal
- Chatbot — AI chat app with persistent memory across sessions
- Noter — note-taking tool that stores knowledge as encrypted memory
- Researcher — research assistant that builds and recalls a knowledge base
Explore the Docs
Concepts
Memory spaces, ownership and delegates
Architecture
System overview, component responsibilities, core flows, data flow security
SDK
Quickstart, usage patterns, AI integration, and examples
Relayer
Managed relayer, installation and setup, self-hosting
Smart Contract
Onchain ownership model, delegate key management, permissions
Indexer
Event indexing, onchain events, database sync
Reference
SDK API, relayer API, configuration, environment variables