Skip to content

Didi-vi/vestroll

 
 

Repository files navigation

VestRoll: Payroll

VestRoll is a payroll and invoicing platform built for the 2026 financial ecosystem. Built with Next.js 15, React 19, and the Stellar Soroban stack, it offers a "No-Crypto" UX where privacy, speed, and biometric security are standard.


🏗️ The 2026 Technology Stack

Core Architecture

  • Framework: Next.js 15.5 (App Router & Turbopack)
  • Library: React 19
  • State: Redux Toolkit (UI) & Zustand (Store)

Identity & Privacy (ZK)

Finance & Fiat Bridge

  • Fiat Providers: Native integration for Monnify and Flutterwave (NGN On-ramps).
  • Stellar Bridge: SEP-24 via Stellar Wallet SDK for automated NGN-to-USDC settlement.
  • Gasless UX: Launchtube / Fee-Bumping infrastructure (Zero XLM required for users).

📂 Project Structure

vestroll/
├── src/
│   ├── api/                # ZK-Circuit logic & Service Orchestration
│   ├── app/                # Next.js App Router (Invisible Crypto UX)
│   ├── components/         # Biometric Auth & Shielded UI Components
│   ├── server/
│   │   ├── services/       # Monnify, Flutterwave & Blockchain Services
│   │   └── db/             # Drizzle Schema (Auth, Org, Fiat, ZK)
│   └── lib/                # Passkey & Smart Account SDK wrappers
└── brain/                  # Master Roadmaps & Technical Documentation

✨ Key Features

  • Invisible Onboarding: Users sign up with Email and Biometrics (Passkeys). No seed phrases, no private keys, no 12-word recovery.
  • Hybrid Recovery: A "Best of Both Worlds" security model—Biometric speed for daily use, Email recovery for account resets.
  • ZK-Shielded Payments: Payroll amounts are hidden from the public ledger using Zero-Knowledge proofs, providing enterprise-grade confidentiality.
  • Automated Fiat-Stable Bridge: Deposits in Naira (NGN) are automatically reflected as USDC in the Smart Wallet, enabling instant global payouts.
  • Atomic Batching: Disburse 100+ payroll entries in a single biometric signature using Soroban atomic transactions.
  • Invisible Gas: Transaction fees are sponsored (Launchtube) or paid in USDC, ensuring users never need to hold or know about XLM.

🎯 Target Audience & Ecosystem Impact

Who is this for?

  • Global Enterprises: Companies with distributed teams needing seamless cross-border payroll.
  • DAO & Web3 Organizations: Native crypto organizations requiring fiat and stablecoin payroll solutions.
  • Freelancers & Contractors: Individuals seeking transparent, instant, and low-fee payments.

Contribution to the Stellar Ecosystem

VestRoll plays a pivotal role in the Stellar ecosystem by:

  1. Driving Real-World Utility: Moving beyond speculation to practical, high-volume stablecoin use cases (Payroll).
  2. Highlighting Efficiency: Showcasing Stellar's speed and low fees for frequent, small-to-large value transactions.

🚀 Getting Started

Prerequisites

  • Node.js 20.x or higher
  • pnpm (preferred)
  • Stellar CLI (for local Soroban development)

Installation

  1. Clone the repository and install dependencies:
    pnpm install
  2. Configure Environment: Add STELLAR_RPC_URL and LAUNCHTUBE_API_KEY to your .env.local.
  3. Start development server:
    pnpm dev

🛡️ Roadmap & Strategy

VestRoll development is structured across 4 Strategic Tranches:

  1. Tranche 1: Foundation & Biometric Onboarding.
  2. Tranche 2: Fiat-Stable Bridge (NGN MVP).
  3. Tranche 3: Privacy Shield (Shielded Testnet).
  4. Tranche 4: Mainnet Launch & UX Audit.

📄 License

Commercial - All rights reserved to SafeVault/VestRoll.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 99.8%
  • Other 0.2%