How It Works
Four steps. One SDK call.
Encryption, decentralised storage, and on-chain coordination — all triggered by a single dStorage.upload(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 DStorageSDK({
storage: new ArweaveAdapter(), // permanent decentralised storage
chain: new MidnightAdapter(), // on-chain references
payment: new ManagedPaymentAdapter() // or LocalWalletAdapter()
});
// 2. Upload — encrypted client-side, stored on Arweave, ref written on Midnight
const { refId } = await sdk.upload(data);
// 3. Your Midnight contract stores refId — 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(refId);
const sdk = new DStorageSDK({
storage: new ArweaveAdapter(), // permanent decentralised storage
chain: new MidnightAdapter(), // on-chain references
payment: new ManagedPaymentAdapter() // or LocalWalletAdapter()
});
// 2. Upload — encrypted client-side, stored on Arweave, ref written on Midnight
const { refId } = await sdk.upload(data);
// 3. Your Midnight contract stores refId — 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(refId);
