Guide

Six guides that gradually introduce new concepts — each one swaps in a more realistic set of storage/chain adapters than the last (except Passkey Encryption, which swaps the encryption adapter instead), while the core init() / store() / retrieveByRefId() call pattern stays the same throughout.

Every guide can also be followed hands-on against a ready-to-run starter app instead of building from scratch — clone dstorage-starter-template and swap in each guide's adapters as you go.

Working with an AI coding agent? Each guide starts with a ready-made prompt for it — see Build with AI for those and for pointing your agent at these docs.

• Mock Adapters — fully in-memory, zero external dependencies. Your first encrypted upload and retrieval, in a few minutes.
• Core Concepts — how your data gets encrypted, storageId vs refId, and how the three adapter slots compose. Conceptual, not hands-on — read this before or after Mock Adapters.
• Local & Simulator Adapters — real circuit behavior and real local storage, still with no live wallet or Docker proof server.
• Managed Payments Service — route storage and chain payments through dStorage Pro's TEST sandbox service, still on arlocal and the simulator.
• Midnight Network Adapter — a real Midnight network, a real wallet, and a live proof server.
• Passkey Encryption — swap in WebAuthnPrfEncryptionAdapter to unlock uploads with a platform passkey instead of a password.
• Managed Payments on Midnight — a real Midnight network with DUST fees sponsored via dStorage Pro's managed service, so the wallet needs no DUST or NIGHT.