Documentation

Everything you need to understand and integrate with VeilSub.

What is VeilSub?

VeilSub is a privacy-first creator subscription platform built on the Aleo blockchain. Subscribers pay with real ALEO credits and receive a private AccessPass record — their identity is never exposed on-chain. Creators see aggregate stats (total subscribers, total revenue) but never see individual subscriber identities.

Video Demo

Watch the full end-to-end walkthrough showing wallet connection, creator registration, private subscription, and on-chain verification.

Video Demo

See the project README for the latest demo video link and walkthrough instructions.

Architecture

plaintext

┌──────────────┐     ┌─────────────┐     ┌───────────────────┐
│  Subscriber   │────>│   VeilSub   │────>│   Aleo Network    │
│ (Shield Wallet)│    │  Program    │     │                   │
│               │    │             │     │  PRIVATE:          │
│ 1. Pick tier  │    │ subscribe() │     │  - AccessPass      │
│ 2. Pay ALEO   │    │             │     │  - Payment details │
│ 3. Get pass   │    │ verify()    │     │  - Subscriber ID   │
│               │    │             │     │                   │
│               │    │ tip()       │     │  PUBLIC:           │
│               │    │             │     │  - Subscriber count│
└──────────────┘     └─────────────┘     │  - Total revenue   │
                                         │  - Tier prices     │
        ┌──────────────┐                 └───────────────────┘
        │   Creator     │
        │ Sees: 47 subs │
        │ Sees: 235 ALEO│
        │ Never sees WHO│
        └──────────────┘

Tech Stack

Smart Contract

Leo 3.4.0 on Aleo Testnet

Frontend

Next.js 16, React 19, TypeScript

Styling

Tailwind CSS 4, Framer Motion

Wallet

@demox-labs/aleo-wallet-adapter

Chain Queries

Provable API (REST)

Hosting

Vercel