Tour Escrow

Automated escrow and revenue split system for tourism bookings using MNEE USD-backed stablecoin. Lock payments, auto-distribute to stakeholders, and eliminate payment delays.

Comment

Tour Escrow — MNEE Hackathon Submission

Inspiration

Tourism is a $9.6 trillion global industry, yet its payment infrastructure remains stuck in the past.
We witnessed recurring conflicts between travelers, hotels, tour operators, and local guides caused by:

  • Payment delays
  • Unclear revenue splits
  • Lack of transparency
  • Disputes over who gets paid, when, and how much

A traveler books a tour package—but:

  • Who gets paid first?
  • How much goes to the hotel vs. the guide?
  • What happens when disputes arise?

Traditional escrow services are slow, expensive, and dependent on trusted intermediaries.

We envisioned a programmable treasury where smart contracts automatically hold, verify, and distribute payments based on predefined rules—eliminating trust issues, delays, and manual reconciliation while ensuring every stakeholder gets their fair share instantly.

Tour Escrow was born from a simple belief:

Tourism transactions should be as transparent and automated as the blockchain technology that powers them.

What It Does

Tour Escrow is a decentralized escrow and revenue distribution platform purpose-built for the tourism industry.
It transforms complex multi-party transactions into simple, automated, and transparent workflows using blockchain technology.

Core Features

🔐 Smart Escrow System

  • Lock MNEE (USD-backed stablecoin) payments into smart contracts
  • Funds held securely until service completion
  • Check-in / check-out based verification
  • Automatic release when conditions are met

💸 Automated Revenue Splits

  • Configure stakeholder percentages once
    • Example: 70% hotel, 20% guide, 10% platform
  • Funds are auto-distributed instantly upon escrow release
  • Zero manual intervention, zero delays

📊 Real-Time Treasury Tracking

  • Live dashboard of all active escrows and completed splits
  • Full transaction history with on-chain verification
  • USD-stable values (1 MNEE = 1 USD) for predictable accounting

🤝 Stakeholder Coordination

  • Visual ecosystem map showing travelers, hotels, guides, and platforms
  • Real-time transaction status updates
  • Transparent and visible fee structures for all parties

🎥 Demo Mode

  • Fully populated with realistic transaction data
  • Demonstrates full platform capabilities without real funds
  • Ideal for onboarding, demos, and judge evaluation

How We Built It

Technology Stack

Frontend & Framework

  • Next.js 15 — App Router for optimal performance
  • React 19 + TypeScript — End-to-end type safety
  • Tailwind CSS — Responsive, mobile-first UI
  • shadcn/ui — Accessible and consistent component system

Blockchain Integration

  • Ethereum Mainnet — Production-grade smart contract execution
  • MNEE Token — USD-backed stablecoin (1 MNEE = $1 USD)
  • Ethers.js & Viem — Web3 interaction libraries
  • Wagmi — React hooks for wallet state management
  • OnchainKit (Base-ready) — Prepared for Base L2 expansion

Wallet & Authentication

  • MetaMask integration
  • WalletConnect for multi-wallet support
  • Smart Wallet Ready — Prepared for gasless UX on Base

APIs & Services

  • Infura — Ethereum node infrastructure
  • Custom Next.js API routes — Server-side transaction building & verification
  • Real-time state management — Live escrow lifecycle updates

Architecture Overview

  • Smart Contract Layer
    ERC-20 compliant MNEE transfers with verified ABI implementation

  • Transaction Builder
    Server-side routes construct and validate transactions with proper gas handling

  • State Management
    Client-side React hooks manage escrow states and UI synchronization

  • Demo System
    Realistic mock data generator simulating real tourism booking patterns

Challenges We Ran Into

1. Gas Fee Economics

Problem:
Ethereum gas fees ($5–$50 per transaction) made testing expensive and unsuitable for small payments.

Solution:

  • Built a comprehensive demo mode
  • Prepared migration to Base L2 where fees drop to ~$0.01

2. Transaction Error Handling

Problem:
MetaMask rejection caused unhandled promise rejections and React crashes.

Solution:

  • Implemented robust error boundaries
  • Differentiated user cancellation vs. actual failures
  • Friendly messages without breaking the UI

3. Smart Contract ABI Compatibility

Problem:
Custom ABIs caused encoding errors and failed transactions.

Solution:

  • Switched to standard ERC-20 ABI from Viem
  • Ensured compatibility with MNEE token contract

4. Demo Data Realism

Problem:
Empty states failed to communicate platform value.

Solution:

  • Built a sophisticated demo data generator
  • Realistic names, locations, amounts, and timelines

5. Multi-Stakeholder Coordination UI

Problem:
Complex relationships were hard to visualize intuitively.

Solution:

  • Interactive ecosystem map with Lucide React icons
  • Real-time flow visualization between all stakeholders

Accomplishments We're Proud Of

✅ Real Blockchain Transactions
Tour Escrow executes real MNEE transfers on Ethereum Mainnet with full on-chain verification.

✅ Production-Ready UX
Users interact with simple actions—not gas limits or nonces.

✅ Comprehensive Demo Mode

  • 75 active escrows
  • 70 completed splits
  • $192K simulated volume

✅ Error Resilience
Graceful handling of wallet rejections, network issues, and edge cases.

✅ Mobile-First Design
Optimized for both desktop judges and mobile devices.

✅ Scalable Architecture
Base L2-ready with no required code rewrite.

What We Learned

  1. Blockchain UX Is Hard—But Solvable
    Users need trust, not technical depth. Clear feedback and visual states matter.

  2. Gas Fees Change Everything
    L2s aren’t optional—they’re essential for real-world adoption.

  3. Demo Modes Drive Adoption
    No one wants to spend real ETH just to explore a product.

  4. Error States Matter More Than Happy Paths
    Production readiness is defined by how failures are handled.

  5. Stablecoins Enable Real Business
    Tourism needs price stability—MNEE makes that possible.

What's Next for Tour Escrow

🚀 Immediate Roadmap (Q2 2025)

  1. Base L2 Deployment

    • Gas reduction: $5–50 → $0.01–0.10
    • OnchainKit already prepared

  2. Multi-Chain Support

    • Polygon, Arbitrum, Optimism
    • Cross-chain settlement

  3. Enhanced Analytics

    • Revenue dashboards
    • Tax-ready exports
    • Historical trend analysis

🎯 Mid-Term Goals (Q3–Q4 2025)

  1. Mobile Native Apps

    • iOS & Android
    • Push notifications
    • QR-based payment flows

  2. Smart Escrow Upgrades

    • Dispute resolution
    • Partial releases
    • Refund policies
    • Multi-sig approvals

  3. AI-Powered Optimization

    • Revenue split recommendations
    • Booking trend prediction
    • Fraud detection

🌐 Long-Term Vision (2026+)

  1. Tourism DAO Governance
  2. Booking Platform Integrations
  3. Global Expansion & Compliance
  4. Sustainability & Carbon Tracking

Closing

Tour Escrow isn’t just a hackathon project.
It’s the foundation for a trustless, transparent, and efficient tourism payment infrastructure—built for the next decade of global travel.

Share this project:

Updates