Developers
Add self-sovereign data to any Express app.
Epistery is an open-source middleware that gives your web application blockchain-backed data wallets, cryptographic identity, and IPFS storage — in three lines of code.
Quick Integration
Three lines to blockchain-backed data.
Install
npm install epistery
Initialize Domain
npx epistery initialize mydomain.com
Creates a wallet and configuration in ~/.epistery/mydomain.com/
Attach to Express
import express from 'express';
import { Epistery } from 'epistery';
const app = express();
const epistery = await Epistery.connect();
await epistery.attach(app);
app.listen(3000);
Your site now has /.well-known/epistery endpoints, client wallets, and data operations.
Key Concepts
DataWallet
The basic contract — an immutable chain of events that can be attached to any digital object. Provides cryptographic proof of origin, tracks provenance, and enables ownership transfers.
Anonymous Ephemeral Wallets
Browser wallets in localStorage enable cryptographically signed interactions without requiring users to understand Web3. Each site sees a unique identity, domain-isolated per W3C standards.
IPFS Storage
Content is uploaded to IPFS — a globally shared directory of content-addressed files. Data is referenced by what it contains, not where it lives. Built-in redundancy and permanence.
Well-Known Endpoints
Epistery attaches behind /.well-known/epistery following RFC 8615. Standardized discovery lets any client find your site's blockchain capabilities automatically.
CLI Commands
epistery initialize <domain>
Initialize a domain with a new wallet. Creates config, generates keys, sets up provider.
epistery curl [options] <url>
Make authenticated HTTP requests. Performs key exchange automatically. Supports -X, -d, -H, --bot flags.
epistery info [domain]
Show domain information: wallet address, provider config, session status.
epistery set-default <domain>
Set the default domain for CLI operations.