Wafra Documentation

Welcome to Wafra - a sophisticated fiat-to-fiat yield optimization platform that abstracts away DeFi complexity while maximizing returns for users.

Platform Overview

Wafra enables users to deposit USD and automatically earn yield through carefully selected DeFi strategies, all while maintaining the simplicity of traditional savings accounts. The platform bridges traditional finance with decentralized finance through a user-friendly interface that requires no blockchain knowledge.

Key Features

Fiat-to-Fiat Experience: Deposit USD, earn yield, withdraw USD with no cryptocurrency exposure
Bank-Grade Security: Gnosis Safe multisig wallets combined with WebAuthn passkey authentication
Automated Yield Optimization: Professional strategy management across multiple DeFi protocols
Real-Time Monitoring: Live blockchain data synchronization with instant notifications
Unified KYC/Payment: Seamless onboarding across multiple compliance and payment providers

🗺️ Development Status & Roadmap

Current implementation status, completed features, and development timeline covering payment infrastructure, yield strategies, specialized investment products, and mobile applications.

🏗️ Core Architecture

Technical implementation details:

Authentication & Security
API Architecture
Multisig Wallet System
Transaction Processing
Task Management
Gas Optimization
Blockchain Integration

💼 Business Logic

Business systems and integrations:

Payment Providers
KYC Architecture
Referrals System

System Overview

🔐 Platform Overview

High-level business and technical overview:

Introduction - Platform vision and value proposition
System Overview - Architecture and components
Money Flow - How funds move through the system
Technology Stack - Technical foundation and tools
Security Framework - Security model and compliance

📜 Smart Contracts

Blockchain implementation:

Smart Contracts Overview - Contract architecture and yield strategies

Quick Start

For Developers

# Clone the monorepo
git clone https://github.com/wafra/wafra
cd wafra
 
# Install dependencies
yarn install
 
# Start development servers
yarn workspace server run dev
yarn workspace web run web

For Different Audiences

Business Stakeholders: Start with Development Status & Roadmap → Money Flow → Security Framework

Developers: Begin with Technology Stack → Core Architecture → Business Logic

Security Teams: Review Security Framework → KYC Architecture → Smart Contracts

Architecture Philosophy

UX First: User experience drives all decisions - maximize delight and minimize friction at every touchpoint
No Crypto: Users never see blockchain complexity - complete abstraction from cryptocurrency mechanics
No Delays: Everything happens instantly through async processing - users never wait for slow operations
Abstract Everything: Unified interfaces across all services - consistent patterns regardless of underlying complexity

This documentation reflects the current state of the Wafra platform and is continuously updated with the latest implementation details.

Introduction