How It Works
Four steps. One SDK call.
Encryption, decentralised storage, and on-chain coordination — all triggered by a single dStorage.store(data) call.
Smart contracts on Midnight store cryptographic references — linking on-chain logic directly to off-chain data. Only the data owner can decrypt. App providers and operators never see raw content.
dstorage-example.ts
// 1. Configure once — swap adapters without changing app code
const sdk = new DStorage({
storageAdapter: new ArweaveStorageAdapter(), // permanent decentralised storage
chainAdapter: new MidnightChainAdapter(), // on-chain references
});
// 2. Store — encrypted client-side, stored on Arweave, ref written on Midnight
const { chainRefId } = await sdk.store(data);
// 3. Your Midnight contract stores chainRefId — linking on-chain logic to off-chain data
// 4. Retrieve — looks up chain ref, fetches from Arweave, decrypts on user device
const data = await sdk.retrieveByRefId(chainRefId);
const sdk = new DStorage({
storageAdapter: new ArweaveStorageAdapter(), // permanent decentralised storage
chainAdapter: new MidnightChainAdapter(), // on-chain references
});
// 2. Store — encrypted client-side, stored on Arweave, ref written on Midnight
const { chainRefId } = await sdk.store(data);
// 3. Your Midnight contract stores chainRefId — linking on-chain logic to off-chain data
// 4. Retrieve — looks up chain ref, fetches from Arweave, decrypts on user device
const data = await sdk.retrieveByRefId(chainRefId);
