VestRoll

VestRoll is a professional payroll and invoicing system built on the Stellar network. It enables businesses, contractors, and individuals to manage global payments with automated tax handling using both fiat and stablecoins.

Features

• Hybrid Payments: Full support for fiat and stablecoins (USDC) for global settlement.
• Payroll Management: Automated disbursement of payments to large teams in seconds.
• Invoice as a Service: Specialized infrastructure for generating and tracking invoices on Stellar.
• Tax Handling: Integrated tax calculations and reporting for every transaction.
• Multi-Account Support: Tailored experiences for Business, Contractor, and Individual accounts.

Tech Stack

• Framework: Next.js 15 (Frontend & API)
• Runtime: Node.js 20 LTS
• Database: PostgreSQL (via Drizzle ORM)
• Blockchain: Stellar Network (SEP-24, Passkey Kit)
• State Management: Redux Toolkit & Zustand

Quick Start

1. Clone and Prepare:

   git clone https://github.com/SafeVault/vestroll.git
   cd vestroll
   cp .env.example .env

2. Install Dependencies:

   pnpm install

3. Database Setup:

   pnpm drizzle-kit push

4. Run in Development:

   pnpm dev

Project Structure

vestroll/
├── src/
│   ├── app/                # Next.js App Router (Pages & API)
│   ├── components/         # UI Components (Shadcn UI)
│   ├── server/
│   │   ├── services/       # Business Logic (Payroll, Tax, Stellar)
│   │   └── db/             # Drizzle Schema & Migrations
│   └── lib/                # Shared utilities & SDK wrappers
├── docs/                   # Comprehensive documentation
├── public/                 # Static assets
└── scripts/                # Utility scripts for DB and Swagger

Documentation

Comprehensive documentation is available in the /docs folder:

Quick Start

• Main Documentation - Complete documentation index

Core Documentation

• Architecture Overview - System architecture
• Project Overview - Vision and goals
• User Personas - Account types and use cases

Use Cases

Business Payroll

Manage organizational payroll with ease:

1. Deposit funds via fiat or stablecoin.
2. Automate tax deductions based on jurisdiction.
3. Disburse payments to contractors and employees instantly.

Contractor Invoicing

Generate professional invoices and get paid:

1. Create invoices as a service on Stellar.
2. Receive payments in stablecoins for low-fee global settlement.
3. Track payment status and tax obligations.

Individual Payments

Simple and secure personal payment management:

1. Manage personal balances in fiat or stablecoins.
2. Secure onboarding with biometric Passkeys.

Contributing

We welcome contributions! Please see CONTRIBUTING.md for detailed guidelines.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

• Documentation: /docs
• Issues: GitHub Issues

👥 Maintainers

codeZe-us GitHub

---

Thanks to all the contributors who have made this project possible!

---

Empowering global payroll with Stellar

---