YieldVault - Stellar RWA

YieldVault is a decentralized vault platform built specifically for the Stellar network. It bridges the gap between complex Real-World Asset (RWA) infrastructure and retail adoption by allowing users to deposit USDC and earn yield generated by tokenized real-world assets (like tokenized Korean bonds or other sovereign debt instruments) via Stellar's Soroban smart contracts.

Project Structure

This project is structured as a monorepo containing both the Stellar Soroban smart contracts and the frontend web application.

• /contracts/vault/: Contains the Rust Soroban smart contract for handling the vault logic, fractional share minting (yvUSDC), scaling withdrawals, and simulated yield accrual.
• /frontend/: Contains the React + Vite frontend application, integrating @stellar/freighter-api for seamless user wallet connections and a premium UI to interact with the protocol.
• /docs/: Contains the Product Requirements Document (PRD), Architecture Document, and tracked GitHub issues.

Technology Stack

• Network: Stellar (Testnet/Mainnet)
• Smart Contracts: Soroban (Rust, WebAssembly)
• Frontend: Vite, React, TypeScript, Vanilla CSS
• Wallet Connection: Freighter

Getting Started

1. Smart Contracts

Ensure you have Rust and the wasm32-unknown-unknown target installed.

cd contracts/vault
cargo test
cargo build --target wasm32-unknown-unknown --release

2. Frontend Application

Ensure you have Node.js installed.

cd frontend
npm install
npm run dev

Navigate to http://localhost:5173 to interact with the local UI.

3. Custom Soroban RPC Configuration

Create a frontend environment file from the example:

cd frontend
cp .env.example .env

Set:

• VITE_SOROBAN_RPC_URL (custom RPC endpoint, optional)
• VITE_STELLAR_NETWORK_PASSPHRASE (network passphrase)
• VITE_VAULT_CONTRACT_ID (deployed vault contract ID)

If VITE_SOROBAN_RPC_URL is not set, the app defaults to Stellar testnet RPC.

API Documentation

Generate contract and frontend API docs:

cargo doc -p vault --no-deps
cd frontend
npm install
npm run docs:api

See docs/api/README.md for output locations.

Roadmap (Phases)

• Phase 1: Planning, Documentation, and Frontend UI Baseline (Completed)
• Phase 2: Soroban Smart Contract Implementation in Rust (Completed)
• Phase 3: Stellar Testnet Deployment and Frontend Integration (Up next)
• Phase 4: Security Audit and Mainnet Launch