🏦 Zorah

Crypto Banking Without Complexity

Decentralized banking protocol on Polkadot-Moonbeam

Wallet abstraction · Smart escrow · Cross-chain deposits

🎥 Demo Video · 📖 Documentation · 🚀 Quick Start

💡 What is Zorah?

⚠️ Under Development — Use Only For Testing
This project is under active development and expected to launch by March 2026. Do not use real funds or production assets here until the official launch. Use this repository only for development and testing purposes.

Zorah is a global banking protocol that makes crypto feel like traditional banking—simple, secure, and familiar—while delivering the power of blockchain underneath.

🎯 In Simple Terms:

Imagine if Venmo had a baby with Wise (formerly TransferWise), and that baby ran on blockchain but felt like a normal banking app. That's Zorah. So we can say that, Zorah is an hybrid offspring for next generation payments. Its the future of banking.

What you can do with Zorah:

🏦  Open an account with a simple 11-digit number (like 12345-678901)
    → No scary "0x..." addresses
    → No seed phrases to memorize
    → Just a familiar account number

💸  Send money to anyone, anywhere, instantly
    → 1% fee (capped at $10) vs 6-8% traditional banks
    → Settle in seconds, not days
    → No forex markups or hidden fees

🔒  Create secure escrow for P2P/B2B deals
    → Buy/sell without trust
    → Automated dispute resolution
    → Smart contracts handle the rest

🌉  Deposit from any blockchain
    → Bridge funds from Ethereum, Avalanche, Polygon, etc.
    → Everything settles as stablecoins on Moonbeam
    → You see USD balance, not crypto complexity

💰  Earn yield on your balance
    → 60% yield goes to you, 40% to Zorah
    → No lock-up periods
    → Withdraw anytime

🛍️  Accept global payments (for businesses)
    → 0.25% processing fee (vs 2.9% Stripe)
    → Instant settlement
    → No chargebacks

🧠 The Core Innovation:

You interact with account numbers. The blockchain handles everything else.

✅ Your wallet? Encrypted and hidden behind your account number.
✅ Gas fees? Abstracted. Moonbeam's $0.01 costs are invisible.
✅ Bridging? Automatic. Axelar/Stargate works behind the scenes.
✅ Smart contracts? Silent. They settle transactions trustlessly.

Result: Banking UX + Blockchain power + Zero complexity

🌍 Who is Zorah for?

💼 Individuals:

Freelancers receiving international payments
Migrants sending remittances home
Crypto users tired of confusing wallets
Anyone needing low-cost global transfers
Savers seeking better yield than banks

🏢 Businesses:

E-commerce stores accepting global payments
B2B companies needing escrow for deals
Startups paying remote contractors
Merchants tired of 3% Stripe/PayPal fees
Cross-border traders needing fast settlement

🎬 Quick Example:

Traditional Bank:

"I want to send $100 from Nigeria to Kenya"

Fee: $8 (8%)

Time: 3-5 days

Recipient gets: $92

Crypto Wallet (MetaMask):

"I want to bridge USDC from Ethereum to Polygon"

Gas fee: $15

Bridge fee: $2

Confusing addresses: 0x7a2f...3d9e

Time: 30 minutes

Recipient confusion: "What's a wallet?"

Zorah:

"I want to send $100 to account 98765-432109"

Fee: $1 (1%, capped at $10)

Time: 10 seconds

Recipient gets: $99

UX: Just like Venmo

🎯 The Problem We're Solving

🌍 The Global Payment Crisis

Cross-border payments, digital escrow, and global business transactions remain:

💔 Traditional Banking is Broken

💸 6-8% fees for cross-border transfers
⏱️ 3-5 days settlement time (sometimes weeks)
🔒 Trust required in multiple intermediaries
🌍 2 billion people remain underbanked
🏦 Limited hours - closed on weekends
📍 Geographic restrictions on accounts
💰 High minimum balances required

🔐 Crypto Hasn't Solved UX

😵 Confusing 0x... addresses scare users
⛽ Unpredictable gas fees eat into transfers
🤯 Intimidating for non-technical users
📱 No familiar banking interface
🔑 Seed phrase anxiety - one mistake = funds lost
🌉 Complex bridging between chains
🚫 Poor customer support in most dApps

📊 Market Opportunity

The numbers are massive:

💵 $700B+ global remittance market (and growing)
🚀 Rising stablecoin adoption across emerging markets
🏪 E-commerce merchants need simple global payment rails
💼 Freelancers in Africa and Asia need low-cost cross-border payments
🌐 Businesses adopting blockchain-powered settlement
⚖️ Growing demand for decentralized escrow in P2P/B2B trades

💡 The Gap: Banking Power + Blockchain Security + Zero Complexity

Existing crypto solutions lack simplicity. Traditional fintech lacks global reach.

Zorah bridges this gap with a hybrid system that retains the power of blockchain while hiding the complexity from end users.

✨ Our Solution

Zorah brings traditional banking UX to Polkadot-Moonbeam with Web3 power underneath

Feature	Traditional Banks	Crypto Wallets	🎯 Zorah
Easy UX	✅	❌	✅
Low Fees	❌	⚠️	✅
Self-Custody	❌	✅	✅
Cross-Chain	❌	⚠️	✅
Fast Settlement	❌	✅	✅

🎨 Core Features

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│  🏦  WALLET ABSTRACTION                                         │
│  → Users get familiar 11-digit account numbers                  │
│  → Behind the scenes: Encrypted EVM wallets on Moonbeam         │
│  → Non-custodial - users own their keys (encrypted)             │
│                                                                 │
│  💰  MULTIPLE DEPOSIT METHODS                                   │
│  → Direct account-to-account (A2A) transfers                    │
│  → Bank transfer via P2P escrow with liquidity partners         │
│  → Cross-chain deposits via Axelar (dev) / Stargate (prod)      │
│  → Merchant payment collections for businesses                  │
│                                                                 │
│  🔒  SMART ESCROW SYSTEM                                        │
│  → Trustless P2P and B2B transactions                           │
│  → Automated dispute resolution with juror voting               │
│  → 0.5% escrow fee (capped at $10)                              │
│  → Time-locked contracts with expiry protection                 │
│                                                                 │
│  💸  ULTRA-LOW FEES                                             │
│  → 1% transfer fee (capped at $10) vs 6-8% banks                │
│  → 0.25% merchant processing (capped at $10)                    │
│  → Powered by Moonbeam's ~$0.01 gas costs                       │
│  → No hidden fees, full transparency                            │
│                                                                 │
│  📊  REAL-TIME BALANCES                                         │
│  → Backend reads directly from Moonbeam smart contracts         │
│  → No custodial risk, full transparency                         │
│  → Stablecoin-based (USD-equivalent)                            │
│                                                                 │
│  💎  SAVINGS & YIELD                                            │
│  → Users earn 60% of generated yield                            │
│  → Zorah retains 40% for sustainability                         │
│  → Optional feature for passive income                          │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

⚡ What's Working NOW

Hackathon Phase 1 - Live Features

Feature	Status	Description
🎫 Account Creation	✅ Live	Users create accounts with 11-digit IDs
👤 Wallet Abstraction	✅ Live	EVM wallets hidden behind account numbers
🌉 Cross-Chain Deposits	✅ Live	Axelar bridge (aUSDC) → Moonbeam testnet
💵 Balance Tracking	✅ Live	Real-time updates from Moonbeam contracts
📜 Smart Escrow Contract	✅ Deployed	Verified on Moonbeam testnet
🎨 Deposit UI	✅ Live	4 tabs: Direct, Bank Transfer, Bridge, Payment
⚖️ Escrow UI	🚧 50% Complete	Contract deployed, UI wiring in progress
💸 Withdrawals	📋 Planned	P2P escrow method (Phase 2)
🔄 P2P Transfers	📋 Planned	Account-to-account (Phase 2)

🎬 Try it live - Watch Demo Video

🛠️ Tech Stack

Backend Architecture

┌────────────────────────────────────────────────────────────┐
│                    🖥️  APPLICATION LAYER                   │
├────────────────────────────────────────────────────────────┤
│  PHP 8.3         │  Modern PHP with JIT, typed properties  │
│  MongoDB         │  Document DB for accounts & history     │
│  Redis           │  High-performance caching layer         │
│  Web3.php        │  Ethereum JSON-RPC client for Moonbeam  │
└────────────────────────────────────────────────────────────┘
                              ↓
┌────────────────────────────────────────────────────────────┐
│                   ⛓️  SETTLEMENT LAYER                     │
├────────────────────────────────────────────────────────────┤
│  Moonbeam        │  EVM-compatible Polkadot parachain      │
│  Solidity        │  Smart contracts (Escrow, Deposits)     │
│  Axelar          │  Cross-chain bridge protocol            │
└────────────────────────────────────────────────────────────┘

🎨 Frontend Stack

JavaScript - Vanilla JS with modern ES6+ features
Tailwind CSS - Utility-first styling with custom black/purple theme
Web3.js / Ethers.js - Wallet connection and transaction signing
Responsive Design - Mobile-first banking interface

⛓️ Blockchain Infrastructure

Polkadot-Moonbeam - EVM-compatible parachain with shared security
Solidity 0.8.30 - Smart contract language with latest security features
Axelar Testnet - Cross-chain bridge (currently supports aUSDC)
OpenZeppelin - Battle-tested contract libraries

📍 Deployed Contracts

🌕 Moonbase Alpha Testnet (Deployed)

Escrow Contract (Moonbase Alpha Testnet):

Contract Address: 0x9cA862b170Bd235Dd1A396b2da6b36A15108A3BB
Network: Moonbase Alpha (Chain ID: 1287)
Explorer: https://moonbase.moonscan.io/address/0x9cA862b170Bd235Dd1A396b2da6b36A15108A3BB

Network Details:

RPC URL: https://rpc.api.moonbase.moonbeam.network
Chain ID: 1287
Symbol: DEV
Block Explorer: https://moonbase.moonscan.io

Block Explorer: https://moonbase.moonscan.io


### 📘 Smart Contract Documentation

**For comprehensive smart contract details, including:**
- ✅ Full architecture and features
- ✅ Step-by-step deployment guide for Moonbeam
- ✅ Configuration instructions
- ✅ Security features and audit checklist
- ✅ Testing setup
- ✅ Contract interaction examples

**→ [Read the Complete Contract README](./contract/README.md)**

> The contract README includes production-ready deployment scripts, Hardhat configuration for all Moonbeam networks (Mainnet, Moonriver, Moonbase Alpha), and detailed API documentation for integrating with the escrow system.

</div>

---

## 🚀 Quick Start

### 📋 Prerequisites

```bash
✅ XAMPP or Laragon             # All-in-one PHP, MySQL, Apache
✅ MetaMask Wallet              # For testing cross-chain deposits
✅ Moonbeam Testnet Tokens      # From faucet (optional)

📦 Installation

Step 1: Clone Repository

# Clone into your XAMPP/Laragon www directory
cd C:\xampp\htdocs  # or C:\laragon\www
git clone https://github.com/mitmelon/Zorah.git zorah

Step 2: Install Dependencies

cd zorah
composer install

Step 3: Configure Environment

# Copy environment file
cp .env.example .env

# Edit .env with your database settings
# Most defaults work out of the box with XAMPP/Laragon

Step 4: Start & Access

# Start XAMPP/Laragon (Apache + MySQL)
# Then visit:
http://localhost/zorah

# Or use PHP built-in server:
php -S localhost:8000

That's it! 🎉

🎯 Usage Guide

📱 Step 1: Create Your Account

1. Visit http://localhost:8000
2. Click "Create Account"
3. Enter email and secure password
4. Receive your 11-digit account number (e.g., 12345-678901)

💡 Pro Tip: Your account number is like a traditional bank account - easy to share, easy to remember!

💰 Step 2: Get Testnet Tokens

1. Visit Axelar Faucet: https://faucet.axelar.dev/
2. Connect your MetaMask wallet
3. Select a source chain (e.g., Avalanche Fuji, Polygon Mumbai)
4. Request testnet aUSDC tokens
5. Confirm you received tokens in your wallet

🌉 Step 3: Deposit via Cross-Chain Bridge

1. In Zorah dashboard, click "Receive Funds"
2. Select the "Bridge" tab
3. Connect your wallet (MetaMask)
4. Choose:
   ✓ Source chain (where you have aUSDC)
   ✓ Asset (aUSDC)
   ✓ Amount to deposit
5. Review fees and confirm
6. Approve Axelar bridge transaction in wallet
7. Wait 2-5 minutes for cross-chain confirmation
8. Balance updates automatically in your Zorah account ✨

📊 Step 4: View Your Balance

Dashboard shows:
- Your USD balance on Moonbeam
- Transaction history

🎨 Deposit Methods

Method	Description	Status
🏦 Direct	Account-to-account transfers within Zorah	📋 Planned
🏛️ Bank Transfer	Via liquidity partner escrow (fiat on-ramp)	📋 Planned
🌉 Bridge	Cross-chain via Axelar (aUSDC testnet)	✅ Working
💳 Payment	Merchant payment collections	📋 Planned

💸 Withdrawal Methods

Primary: P2P fiat settlement via liquidity partners (zero bridging fees)
Optional: Direct crypto withdrawal to Moonbeam wallet, or bridge to other chains (user pays fees)

Design Philosophy: Default withdrawals avoid expensive bridging costs through LP network, while providing optional on-chain paths for crypto-native users.

💡 Why PHP 8.3 for Blockchain?

🚀 Modern PHP is a First-Class Blockchain Backend

"PHP can't handle blockchain!" - This is outdated thinking from the PHP 5 era.

⚡ Performance Advantages

✅ JIT Compiler       →  40% faster than PHP 7.4
✅ Preloading         →  Reduced latency for hot paths
✅ OPcache            →  Bytecode caching
✅ FFI Support        →  Direct C library calls
✅ Async I/O Ready    →  Non-blocking blockchain polling

🔒 Type Safety for Finance

// PHP 8.3 strict typing for blockchain amounts
readonly class TokenAmount {
    public function __construct(
        public readonly string $amount,
        public readonly int $decimals,
        public readonly TokenType $token
    ) {
        if (bccomp($amount, '0') <= 0) {
            throw new InvalidAmountException();
        }
    }
    
    public function toWei(): string {
        return bcmul($this->amount, bcpow('10', (string)$this->decimals));
    }
}

// Union types, enums, intersection types - perfect for blockchain state
enum TransactionStatus: string {
    case PENDING = 'pending';
    case CONFIRMED = 'confirmed';
    case FAILED = 'failed';
}

🌍 Real-World Integration

Metric	Value	Impact
Web Usage	77%	Easy integration with existing businesses
Developer Pool	5M+	Larger talent pool for hiring
Hosting Support	99%	Works on any shared hosting
Production Hardening	28 years	Battle-tested in high-traffic environments

🛠️ Libraries

✅ Web3.php          # Full Ethereum JSON-RPC client
✅ GMP Extension     # Big number arithmetic (essential for tokens)
✅ OpenSSL           # Cryptographic operations & key management
✅ MongoDB Driver    # High-performance NoSQL
✅ Predis            # Redis client for caching

🤔 Why NOT Node.js?

We considered Node.js but chose PHP because:

👥 Team Expertise - Faster development in familiar language
📚 Ecosystem Maturity - 28 years of production hardening
🚀 Deployment Simplicity - Works on any shared hosting
💾 Memory Efficiency - Request-scoped model uses less RAM
🔄 Process Isolation - Crashes don't affect other requests

🎯 The Real Reason: Building for Billions, Not Just Crypto Natives

"We chose PHP 8.3 because Zorah is designed for real-world adoption, not just crypto natives."

PHP powers 77% of the web—WordPress, Laravel, Shopify—because it's battle-tested for production. Our architecture separates business logic (PHP) from settlement logic (Moonbeam smart contracts), which means traditional businesses can integrate Zorah without learning Solidity.

Plus, PHP 8.3's JIT compiler and strict typing make it perfect for financial operations. We're not building for developers—we're building for 2 billion underbanked people. That requires pragmatic tech choices, not hype-driven ones.

Bottom Line: PHP 8.3 is a first-class citizen for blockchain backends. The language doesn't determine success—architecture does. Zorah's hybrid design puts user experience first, blockchain second.

🎥 Demo Video

🎬 Watch Zorah in Action (3 minutes)

What the video shows:

✅ Account creation with 11-digit number generation
✅ Wallet abstraction (user never sees 0x address)
✅ UI showing 4 deposit tabs: Direct, Bank Transfer, Bridge, Payment
✅ Cross-chain deposit via Axelar bridge (aUSDC)
✅ Real-time balance update from Moonbeam
✅ Smart escrow contract deployed on Moonbeam testnet

🎯 Technical Achievements

🌟 Innovation Highlights

🎨 UX Innovation

Wallet Abstraction

Users get familiar 11-digit account numbers.

Behind the scenes: Full EVM wallet on Moonbeam.

"Banking UX meets Web3 power"

⚡ Technical Depth

Modern PHP + Moonbeam

PHP 8.3 handles blockchain excellently.

Event-driven architecture with Redis caching.

"Sub-second balance queries"

🌉 Cross-Chain UX

Seamless Bridges

Users don't need to understand bridges.

Axelar integration abstracted away.

"Just works™"

🔐 Polkadot Integration

✅ Moonbeam EVM          →  Leverage Polkadot's shared security
✅ Low Gas Fees          →  ~$0.01 transactions enable micropayments
✅ Axelar Bridge         →  Cross-chain deposits (aUSDC testnet)
✅ Parachain-Ready       →  Architecture supports XCM in future
✅ Developer Experience  →  Familiar Solidity + EVM tooling

Full technical details: See Why Polkadot-Moonbeam section below.

🚧 Known Limitations

Hackathon Build - 6 Weeks

Limitation	Impact	Timeline
🎨 Escrow UI 50% complete	Contract deployed, UI wiring in progress	Week 1 post-hackathon
💸 No withdrawals yet	Users can deposit but not withdraw	Week 2 post-hackathon
🔄 P2P transfers planned	Account-to-account transfers coming	Week 3 post-hackathon
🧪 Testnet only	Mainnet requires security audit	Month 2 post-hackathon
💵 aUSDC only	Axelar testnet limitation, mainnet supports more	Mainnet migration

📈 Development Roadmap

What we're building: Full-featured decentralized banking protocol on Polkadot-Moonbeam

📅 Phase 1: Hackathon Build (Current - Nov 2025)

✅ Completed:

Core escrow smart contract (deployed on Moonbeam testnet)
Wallet abstraction with 11-digit account system
Cross-chain deposit UI (4 methods: Direct, Bank, Bridge, Payment)
Axelar bridge integration for aUSDC deposits
Basic balance tracking and transaction history
Account creation and authentication

🚧 In Progress (50%):

Escrow UI integration (contract ready, wiring UI)

🎯 Phase 2: Core Features (Q1 2026)

Backend:

Complete escrow UI integration with smart contract
P2P fiat withdrawal system (liquidity partner network)
Account-to-account internal transfers
Transaction history and export features
Enhanced security (2FA, withdrawal confirmations)

Smart Contracts:

Security audit (CertiK or Trail of Bits)
Multi-signature admin controls
Emergency pause mechanism improvements
Gas optimization

Frontend:

Mobile-responsive dashboard improvements
Real-time balance updates (WebSocket/SSE)
Transaction notifications
KYC integration UI

🚀 Phase 3: Advanced Features (Q2-Q3 2026)

Cross-Chain:

Migrate from Axelar to LayerZero Stargate (lower fees)
Support multiple stablecoins (USDC, USDT, DAI)
Multi-chain deposits (Ethereum, Polygon, Arbitrum, Avalanche)

Business Tools:

Payment gateway API for merchants
Merchant dashboard with analytics
Invoice generation and tracking
Webhook notifications for payments

DeFi Integration:

Yield generation for idle balances
Integration with Moonwell (Moonbeam lending)

Mobile:**

React Native mobile app development
Push notifications
Biometric authentication

🌟 Phase 4: Ecosystem Expansion (Q4 2026 - 2027)

Token Development:

Zorah Token ($ZORA) smart contract
Utility: Fee discounts, LP rewards, governance
Token audit and testing

Compliance:

KYC/KYB provider integration
AML transaction monitoring
Regulatory framework preparation

Parachain Bridge Development:

Begin proprietary Polkadot Parachain Bridge R&D
Focus: Stablecoin bridging across Polkadot parachains to Moonbeam
Support USDC, USDT, DAI from Acala, Parallel, Astar, Centrifuge
XCM (Cross-Consensus Messaging) integration
Performance optimization for scale
Advanced caching and database optimization

🔮 Phase 5: Long-Term Vision (2028+)

Proprietary Polkadot Parachain Bridge:

Zorah Parachain Bridge for stablecoin transfers
XCM-based routing between parachains and Moonbeam
Support stablecoins from: Acala, Parallel Finance, Astar, Centrifuge
Lower fees than Axelar/LayerZero for Polkadot ecosystem
Direct integration with Zorah account system
Gasless bridging for users (fees paid from balance)

Astar Network Deployment:

Deploy Zorah Escrow Protocol on Astar Network
Launch Yield Vaults on Astar (stablecoin yields via Astar DeFi)
Enable cross-parachain escrow (Moonbeam ↔ Astar)
Tap into Astar's dApp staking rewards

Polkadot Ecosystem Integration:

XCM channels with Acala, Parallel, Astar, Centrifuge
Phala Network for privacy-preserving KYC
Multi-parachain stablecoin liquidity pooling

Advanced Features:

Privacy-preserving transactions (Phala integration)
Business lending products (stablecoin collateral)
Treasury management tools
Debit card (physical + virtual)

📊 Roadmap Summary

Phase	Timeline	Key Deliverable
Phase 1	Nov 2025	🏗️ Hackathon MVP + Escrow Contract
Phase 2	Q1 2026	✅ Complete Core Banking Features
Phase 3	Q2-Q3 2026	🚀 Multi-Chain + Business Tools
Phase 4	Q4 2026-2027	💎 Token + Compliance Ready
Phase 5	2028+	🌐 Proprietary Bridge + Ecosystem

🏆 Why Polkadot-Moonbeam?

Zorah is built on Polkadot-Moonbeam to leverage the perfect combination of security, cost-efficiency, and interoperability for global fintech operations.