• Landing page

• Landing page explaining features

• After clicking wallet, Petra asks for confirmation to connect

• Dashboard

• VAT refund

• VAT refund approval

• Petra asking to confirm the transaction

• Transaction hash on Aptos Explorer

• VAT refund history

• Employee management

• Add employee either manually or via bulk CSV

• Bulk transfer

• AI assistant

On-chain VAT Refund Payment Protocol Infrastructure protecting users against time loss, missed claims in fear of missing flights, and payment failures, powered by Aptos.

Simply means "Helping users to claim VAT Refund Anytime Anywhere without hassling"

The Problem That Started It All:

• Travelled to Dubai, bought MAC and BALMAIN clothes worth 1000 AED VAT claim
• Reached DXB airport cutting it close due to Dubai Burj Khalifa traffic
• Saw a long queue at VAT refund counter, decided to wait - line wasn't moving
• Result: Missed flight, lost 5000 AED flight ticket = Net Loss 6000 Dirhams

This isn't just my problem - it's a global crisis.

$200 Billion in VAT Goes Unclaimed Annually due to:

• Long queues at VAT refund counters (Dubai, Planet, etc.)
• Fear of missing flights
• Forgotten claims or lost receipts
• Average refund processing time: 10+ days
• Complex paperwork and bureaucratic delays

These delays cause inconvenience, financial losses, and system failures worldwide.

Helping Masses to:

• ✅ Claim VAT Refund fully on-chain anytime, anywhere
• ✅ Super Simple, Super Efficient, Super Easy process
• ✅ Non-Intrusive: No additional parameters, code, or complex application processes
• ✅ Simple Configuration with maximum impact

Orbix is a comprehensive VAT Refund & Payroll Payment Infrastructure built on the Aptos blockchain that eliminates traditional pain points through:

• Aptos blockchain with Move smart contracts for secure, instant transactions
• Petra Wallet integration for seamless user experience
• AI orchestration (Google Gemini) for automated processing and validation
• Supabase for robust backend services and audit trails

• Tourist VAT Refunds are slow, manual, and often unclaimed due to airport delays.
• Global Payroll is plagued by high fees, delayed wires, hidden FX costs, and compliance overhead.
• Both processes rely on centralized, fragmented rails that fail in a borderless world.

Orbix provides a wallet-native payment infrastructure where:

• Tourists receive VAT refunds instantly through Petra Wallet integration.
• Employers manage payroll globally with AI-assisted calculations and bulk transfers.
• Aptos blockchain ensures fast finality (~3s) and low transaction costs.
• Smart contracts handle payment processing and audit trails automatically.

• Retailer issues digital invoice + tax-free tag → Orbix locks a claim box on Aptos
• Tourist departs → claim status flips to VALIDATED
• Protocol computes: refund = VAT × rate – fee (configurable: 85–87%)
• Executes instant payout in APT through Petra Wallet

• HR uploads payroll CSV → AI parses and applies jurisdiction-specific tax rules
• System snapshots FX rates and creates pay run ID anchored on-chain
• Funds disbursed through chunked atomic transfers (≤16 tx/group)
• Employees receive payments instantly with immutable audit trails

Both modules share unified protocol treasury and compliance guardrails.

• 🚀 Instant Refunds: Add info → Scan QR → Confirm in Petra Wallet → Receive APT instantly
• ✈️ No Missed Claims: Avoid kiosk queues and paperwork bottlenecks entirely
• 💎 Transparent Deductions: Refund percentage and fees displayed in-wallet before confirmation
• 🌍 Cross-Border Utility: Funds usable worldwide, not tied to local banking rails

• ⚡ Bulk Payroll in Seconds: Upload CSV → AI computes → One QR scan → Multiple employees paid
• 💰 Low Fees, Instant Finality: Aptos transfers confirm in ~4s with negligible costs
• 🤖 AI Compliance Layer: Jurisdiction-aware salary parsing, deductions, and FX conversions

• 📱 Wallet-Native UX: All approvals via Petra Wallet (scan + confirm)
• 📋 Auditability: Each refund/payrun anchored with metadata (claim_id, payrun_id)
• 🌐 Global Reach: Single infrastructure serving both tourists and enterprises

flowchart LR
  subgraph Client
    W["Web Interface<br/>(React/TypeScript)"]
    P["Petra Wallet<br/>(Aptos Integration)"]
  end

  subgraph Backend
    API["Supabase<br/>(API/Auth/DB)"]
    AI["Google Gemini<br/>(AI Processing)"]
  end

  subgraph Blockchain
    APTOS["Aptos Network<br/>(Move Contracts)"]
    SC["Smart Contracts<br/>(VAT + Payment)"]
  end

  W <--> API
  W <--> P
  API <--> AI
  P <--> APTOS
  APTOS <--> SC
  API <--> APTOS

sequenceDiagram
  participant User as Tourist
  participant Web as Web Interface
  participant AI as Google Gemini
  participant Petra as Petra Wallet
  participant Supabase as Supabase DB
  participant Aptos as Aptos Network
  participant Contract as VAT Contract

  User->>Web: Upload documents & details
  Web->>AI: Validate eligibility & amount
  AI-->>Web: Validation result
  Web->>Supabase: Store claim data
  Web->>User: Show refund preview
  User->>Petra: Connect wallet
  Petra->>Contract: Submit VAT refund claim
  Contract->>Aptos: Process transaction
  Aptos-->>Petra: Transaction confirmed
  Petra-->>User: Refund received
  Contract->>Supabase: Update claim status

sequenceDiagram
  participant HR as HR/Employer
  participant Dashboard as Web Dashboard
  participant AI as Google Gemini
  participant Supabase as Supabase DB
  participant Petra as Petra Wallet
  participant Aptos as Aptos Network
  participant Contract as Payment Contract

  HR->>Dashboard: Manage employees & salaries
  Dashboard->>AI: Calculate payments & taxes
  AI-->>Dashboard: Payment breakdown
  Dashboard->>Supabase: Store payroll data
  Dashboard-->>HR: Preview payments
  HR->>Petra: Connect wallet & authorize
  Petra->>Contract: Execute bulk payment
  Contract->>Aptos: Process batch transactions
  Aptos-->>Contract: Transactions confirmed
  Contract-->>Petra: Bulk payment complete
  Contract->>Supabase: Update payment records
  Dashboard-->>HR: Payment confirmation

• Node.js (v18 or higher)
• PNPM package manager
• Petra Wallet browser extension
• Supabase account
• Google AI API key

1. Clone the repository

   git clone https://github.com/somewherelostt/Orbix.git
   cd Orbix

2. Install dependencies

   pnpm install

3. Environment Setup Create a .env file in the root directory:

   VITE_SUPABASE_URL=your_supabase_url
   VITE_SUPABASE_ANON_KEY=your_supabase_anon_key
   VITE_GEMINI_API_KEY=your_google_ai_api_key

4. Start the development server

   pnpm dev

5. Deploy Smart Contracts

   cd contracts
   aptos move compile
   aptos move publish

1. Connect Petra Wallet through the web interface
2. For VAT Refunds: Upload receipts and documentation
3. For Payroll: Add employees and configure payments
4. Monitor transactions through the dashboard

src/
├── components/          # React components
├── hooks/              # Custom React hooks
├── services/           # External service integrations
├── utils/              # Utility functions and Aptos helpers
├── contexts/           # React context providers
├── ui/                 # UI component library
└── lib/                # Library configurations

contracts/
├── sources/            # Move smart contracts
└── Move.toml          # Contract configuration

• Direct payment transactions with Move smart contracts
• Atomic groups (≤16 transfers at once) for efficient batching
• Payout notes include metadata: claim_id or payrun_id for auditability

• Core interaction layer for tourists, employers, and employees
• Deep linking & QR scanning for seamless UX
• In-app transfer confirmation with transparent fee display

• Payroll: Salary parsing, FX rate lookup, OCR processing
• VAT: Validation checks and eligibility verification
• Outputs human-readable & blockchain-ready transfer instructions

• Stores receipts, payruns, validation logs, and AI outputs
• Transfer hash storage for regulatory compliance
• Real-time database with authentication and authorization

1. User Input

   • VAT Refunds: Document uploads, receipt images, eligibility information
   • Payroll: Employee management, salary data, payment configurations

2. AI Processing

   • Google Gemini validates documents and calculates eligible amounts
   • Automated tax calculations and compliance checks

3. Database Operations

   • Supabase stores user profiles, payment history, and transaction logs
   • Real-time updates for dashboard synchronization

4. Blockchain Execution

   • Petra Wallet handles user authentication and transaction signing
   • Move smart contracts process payments and maintain audit trails
   • Aptos network provides fast finality and low transaction costs

5. Audit & Reporting

   • Transaction hashes stored for immutable proof
   • Dashboard provides real-time payment tracking and history

• Petra Wallet Integration: Secure key management through Aptos ecosystem
• Smart Contract Security: Move language provides memory safety and resource protection
• Supabase Auth: Row-level security and JWT-based authentication
• AI Processing: Document validation without storing sensitive personal data
• Audit Trail: Immutable transaction records on Aptos blockchain
• Input Validation: Comprehensive address and amount validation before processing

• Taking a 0.5% platform fee on each refund/payroll payout

• Employers pay monthly SaaS fees for:
  • Advanced payroll dashboard and analytics
  • Compliance tools and automated reporting
  • Audit exports and regulatory documentation

• VAT Operator Integration: Revenue-sharing with Dubai VAT Refund Authorities, Planet, FTA
• API Licensing: Package deals for fintechs/DAOs wanting to use Orbix infrastructure

• Earn yield on treasury idle balances
• Capture micro-spreads on in-app FX conversions

• Partner with approved VAT Operators in UAE
• Deploy at Dubai International Airport as "fast-track refunds via Petra Wallet"
• Onboard tourists via signage, airline check-in, and in-airport promotions
• Why Dubai? Comparatively easy country to start with and has existing agreements with Aptos

• Target remote-first startups, DAOs, and SMEs in India, Africa, LATAM, and Asia
• Offer APT payroll rails for distributed global teams
• Collaborate with accelerators and Web3 communities for rapid adoption

• Partner with multinationals for cross-border salary disbursement
• Offer API + compliance dashboards for HR SaaS integrations
• Add more VAT geographies: EU, UK, Singapore, Saudi Arabia

• Transition governance to a decentralized DAO
• Community votes on fee splits, refund % rates, and expansion markets
• Tokenize access: Loyalty incentives for employers and tourists using Orbix infrastructure

• Add EU, UK, and Asia VAT refund partners for global coverage

• Jurisdiction-specific payroll tax modules → auto-deduct & calculate net pay
• Treasury Automation: Auto-scheduling payroll runs based on company preferences

• Enable fintechs, DAOs, and global SMBs to plug Orbix rails into their HR/payments stack
• White-label solutions for existing payment processors

• Automated KYC hooks and AML screening for regulatory compliance
• PDF audit reports for enterprises and regulators
• Real-time compliance monitoring and alerting

• Refund % fees, payroll fee splits, and expansion markets managed by Orbix DAO
• Community-driven product roadmap and feature prioritization

• ✅ Real Problem: $200B+ VAT goes unclaimed annually - massive market opportunity
• ✅ Proven Solution: Started with founder's personal pain point in Dubai
• ✅ Strategic Location: Dubai as launch market with Aptos partnerships
• ✅ Technical Excellence: Built on fast, low-cost Aptos infrastructure
• ✅ User Experience: Wallet-native flows eliminate friction completely

⚡ Orbix will be killing it!!

Orbix leverages the unique advantages of the Aptos blockchain:

• Lightning-Fast Finality: ~3 second transaction finality enables real-time payments
• Low Transaction Costs: Minimal fees make micro-transactions economically viable
• Move Smart Contracts: Memory-safe, resource-oriented programming for secure DeFi
• Parallel Execution: High throughput supports enterprise-scale payment volumes
• Petra Wallet Ecosystem: Seamless integration with Aptos's premier wallet
• Developer Experience: Intuitive APIs and comprehensive TypeScript SDK
• Sustainable Consensus: Energy-efficient proof-of-stake mechanism

We welcome contributions to Orbix! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Built with ❤️ for the future of global payments