Password Timelock Crypto

A hybrid encryption system combining password-based encryption with time-lock cryptography using drand randomness beacons.

How it works

Figure: Overview of the hybrid encryption flow — local password-derived key + drand time-lock beacon for timed decryption. Replace the path with your image file as needed.

Setup

Install Dependencies

pnpm install

Environment Variables

Copy the example file:

cp .env.example .env

Generate the required drand network variables by visiting the drand networks page and selecting a network.

# .env
DRAND_CHAIN_URL=
DRAND_CHAIN_HASH=
DRAND_PUBLIC_KEY=

Usage

Build and run:

pnpm run dev

Or separately:

pnpm run build
pnpm start

How It Works

Encrypts data with both a password and a time-lock. The encrypted data can only be decrypted after:

1. Providing the correct password
2. The time-lock period has elapsed (verified via drand beacon)