Zendvo

Zendvo is an expense, savings, and gifting platform that transforms digital money transfers into memorable experiences. It enables users to send cash gifts that remain completely hidden and locked until a predetermined date and time, save toward a specific item or goal, and track daily expenses accurately.

Features

• Time-Locked Gifting: Funds are locked in Soroban smart contracts and only released after a specified date and time, enforced entirely on-chain.
• Stablecoin Preservation: Uses USDC on Stellar to keep gift value stable from creation to reveal, eliminating volatility risk.
• Yield on Savings: Idle savings earn yield through Stellar's AMM liquidity pools or Blend Protocol lending, so balances grow while waiting.
• Bank Integration: Seamless on/off-ramps connecting stablecoin liquidity to local bank accounts, with Paystack powering Nigerian NGN payouts.
• Surprise Experience: UI/UX built around anticipation, revealing gifts only at the exact unlock moment.
• Low-Cost Global Transfers: Stellar's 3–5 second finality and near-zero fees make cross-border gifting practical at any amount.
• Expense Tracking: Accurate daily expense calculation with categorization and spending summaries.

Stack

• Framework: Next.js 15 (App Router)
• Language: TypeScript 5
• Database: PostgreSQL with Drizzle ORM
• Smart Contracts: Stellar Soroban (Rust)
• Styling: Tailwind CSS 4
• Blockchain: Stellar SDK, Soroban SDK
• Payments: Stripe, Paystack

Stellar Integration

Zendvo uses the Stellar ecosystem for its core financial primitives:

Feature	Stellar Primitive
Time-locked gifts	Soroban smart contracts with time_lock logic
Stable transfers	USDC (Circle) on Stellar
Savings yield	Stellar AMM pools / Blend Protocol
Low-fee settlement	Stellar Consensus Protocol (SCP)
On/off-ramp	Anchor-compatible deposit/withdrawal

Stellar does not have native proof-of-stake staking. Yield on savings is earned through liquidity provision in Stellar's built-in AMM or via the Blend Protocol lending market — both non-custodial and on-chain.

Quick Start

1. Clone and prepare:

   git clone https://github.com/codeze-us/zendvo.git
   cd zendvo
   cp .env.example .env

2. Install dependencies:

   npm install

3. Database setup:

   npm run db:push

4. Run in development:

   npm run dev

Project Structure

src/
├── app/                  # Next.js App Router (pages & API routes)
├── server/               # Backend business logic & services
├── components/           # Modular UI component library
├── lib/                  # Blockchain & payment integrations
├── types/                # Global TypeScript definitions
└── styles/               # Design system & styling

Documentation

• Documentation Index
• Architecture Overview
• Project Vision
• Smart Contract Logic

Use Cases

Surprise Birthdays

Send a cash gift weeks in advance that only unlocks at exactly 12:00 AM on the recipient's birthday.

Graduation Gifts

Lock funds until a graduation date, ensuring the gift lands at the right moment.

Cross-Border Gifting

Send USDC from anywhere in the world to Nigerian recipients with local bank payout and time-locked reveal logic.

Goal Savings

Set a savings target for an item or date, earn yield while saving, and withdraw when ready.

Contributing

We welcome contributions. See CONTRIBUTING.md for guidelines.

License

MIT — see LICENSE.

Support

• Issues: GitHub Issues
• Website: www.zendvo.com

Maintainers

Emrys02 GitHub

codeZe-us GitHub

Decentralizing the art of surprise on Stellar

---