💸 InstantSplit

🚀 Revolutionary expense splitting on Stellar - because your friends shouldn't wait 3 days to get paid back!

InstantSplit reimagines expense splitting using Stellar's lightning-fast blockchain. No more awkward "I'll pay you back later" moments - settle debts in 5 seconds with fees under a penny, anywhere in the world.

🌟 LIVE ON STELLAR TESTNET: Experience the future of peer-to-peer payments with real blockchain speeds and costs - no simulation here!

Table of Contents

🚀 Features

  • ⚡ Lightning-Fast Settlement: 5-second transaction finality on Stellar vs 3-day bank transfers
  • 💰 Ultra-Low Fees: $0.001 per transaction vs 3% traditional fees ($3.60 savings on $120!)
  • 🌍 True Global Reach: Split expenses with anyone, anywhere in the world
  • 📱 Mobile-First Design: Perfect responsive experience on all devices
  • 🔒 Bank-Grade Security: Built on Stellar's battle-tested blockchain
  • 📊 Real-Time Tracking: Live expense history and settlement status
  • 🎯 Smart Split Calculator: Equal, custom, and percentage-based splitting
  • 💼 Multi-Currency Support: Handle expenses in any Stellar asset
  • 🔗 QR Code Sharing: Instantly share expense groups via QR codes
  • 📈 Fee Transparency: See exactly how much you save vs traditional apps

📊 Cost Comparison

Scenario Traditional Apps (Venmo/Zelle) InstantSplit (Stellar) Savings
$120 Dinner Split $3.60 fee + 2-3 days $0.003 fee + 5 seconds $3.597 (99.9%)
$50 Concert Tickets $1.50 fee + 2-3 days $0.001 fee + 5 seconds $1.499 (99.9%)
$200 Hotel Room $6.00 fee + 2-3 days $0.004 fee + 5 seconds $5.996 (99.9%)
Annual Savings $500+ in fees $0.50 in fees $499.50+

🎬 Demo

🌟 Try InstantSplit Live →

Demo Features:

  • 💳 Create a Stellar testnet wallet in seconds
  • 🎯 Split a sample expense with demo participants
  • ⚡ Watch real transactions settle in 5 seconds
  • 📊 Compare costs with traditional apps side-by-side
  • 🌍 Experience global, borderless payments

🎯 The Problem We're Solving

Traditional expense splitting is broken:

  • 💸 High Fees: Venmo charges 3% for instant transfers ($3.60 on a $120 dinner!)
  • ⏳ Slow Settlement: Bank transfers take 2-3 business days
  • 🌍 Limited Global Access: Most apps don't work internationally
  • 📱 Fragmented Experience: Multiple apps, multiple accounts, multiple headaches

Real-world scenario: You're traveling in Tokyo with friends. Dinner costs $120. With traditional apps, you either wait 3 days for settlement or pay $3.60 in fees. With InstantSplit? 5 seconds, $0.003 fee. 🎌

💡 Our Solution

InstantSplit harnesses Stellar's revolutionary blockchain technology to create the world's fastest, cheapest expense splitting experience:

  • ⚡ 5-second global settlement vs 3-day bank transfers
  • 💰 $0.001 fees vs 3% traditional charges
  • 🌍 Works anywhere with internet connection
  • 🔒 Bank-grade security with blockchain transparency

🛠️ Technical Stack

Frontend Excellence:

  • 🎨 SvelteKit: Lightning-fast, reactive UI framework
  • 💄 Tailwind CSS: Modern, utility-first styling
  • 📱 Responsive Design: Mobile-first approach with perfect cross-device experience

Blockchain Power:

  • ⭐ Stellar Network: 5-second finality, $0.00001 base fees
  • 🔧 Stellar SDK: Full blockchain integration
  • 🔐 SEP Standards: SEP-1, SEP-6, SEP-10, SEP-24 implementations

Infrastructure:

  • ☁️ Cloudflare Pages: Global CDN deployment
  • 🗄️ Local Storage: Client-side data persistence
  • 🔄 Real-time Updates: Live transaction status tracking

⚡ Quick Start

Option 1: Try the Live Demo

# Visit the live application
https://instantsplit.pages.dev

Option 2: Run Locally

# Clone and run locally
git clone https://github.com/[username]/instantsplit.git
cd instantsplit
yarn install
yarn dev
# Visit http://localhost:5173

Option 3: Test on Stellar Testnet

# Get testnet lumens from Friendbot
curl "https://friendbot.stellar.org?addr=YOUR_STELLAR_ADDRESS"

🔧 Architecture

graph TD
    A[User Interface] --> B[SvelteKit Frontend]
    B --> C[Stellar SDK]
    C --> D[Stellar Testnet]
    B --> E[Local Storage]
    B --> F[QR Code Generator]
    D --> G[Horizon API]
    D --> H[SEP Anchors]

Core Components:

  • Split Calculator: Smart expense division logic
  • Stellar Integration: Direct blockchain transactions
  • Contact Management: Address book with Stellar addresses
  • Transaction History: Complete audit trail
  • Fee Comparison: Real-time cost analysis

🎯 Live Demo

Try it live: instantsplit.pages.dev

💻 Development Instructions

Clone the repository:

git clone https://github.com/[username]/instantsplit.git
cd instantsplit
yarn install
yarn dev

You can now visit the local development site in your browser at http://localhost:5173

📖 How It Works

InstantSplit leverages Stellar's ultra-low transaction fees and fast settlement to revolutionize expense splitting:

  1. Create an Expense: Enter details about what you're splitting
  2. Add Participants: Add friends by Stellar addresses
  3. Choose Split Method: Equal, custom amounts, or percentage-based
  4. Send Payments: Instantly send each participant their share
  5. Track History: Keep a record of all your split expenses

Where to Start in this Repository?

We've worked to document everything in this repo, so start exploring wherever you like. We'd suggest looking into the following areas:

Stellar Integration

The heart and soul of this application is interacting with the Stellar network.

SEPs

Most of the Stellar interactions take place through the use of SEPs (Stellar Ecosystem Proposals). These interactions are coded in the /src/lib/stellar/sep*.js files.

Other Stellar Functionality

More generic Stellar functionality are located in the same directory:

  • /src/lib/stellar/horizonQueries.js for querying information from the network
  • /src/lib/stellar/transactions.js for building different kinds of Stellar transactions

SvelteKit Framework

This application is built using SvelteKit. We don't want to make this much of a "SvelteKit Tutorial," but here's what you may want to explore:

Pages and Routes

We primarily use SvelteKit for its routing capability. You can begin exploring the SvelteKit components by reading the comments in the /src/routes/dashboard/+page.svelte file.

Stores

We also have implemented a few custom stores to keep track of contact names and addresses, user KYC information, a list of anchor transfers, etc. A good place to start exploring these stores is the /src/lib/stores/contactsStore.js file.

🌟 Stellar Integration Deep Dive

SEPs Implementation

InstantSplit leverages multiple Stellar Ecosystem Proposals (SEPs) for maximum compatibility:

  • SEP-1 (stellar.toml): Asset discovery and anchor information
  • SEP-6: Direct payment/deposit integration
  • SEP-10: Stellar Web Authentication for secure anchor interactions
  • SEP-24: Interactive anchor transfers with popup UX

Transaction Flow

sequenceDiagram
    participant U as User
    participant IS as InstantSplit
    participant S as Stellar Network
    participant A as Anchor (SEP-24)
    
    U->>IS: Create expense split
    IS->>IS: Calculate individual amounts
    U->>IS: Confirm payment details
    IS->>S: Submit payment transactions
    S->>S: Validate & settle (5 seconds)
    S->>IS: Transaction confirmation
    IS->>U: Settlement complete notification
    
    Note over S: All transactions settle simultaneously
    Note over IS,A: SEP integrations for fiat on/off ramps

💻 Development Guide

Project Structure

src/
├── lib/
│   ├── stellar/           # Stellar SDK integrations
│   │   ├── sep1.js       # stellar.toml parsing
│   │   ├── sep6.js       # Direct transfers
│   │   ├── sep10.js      # Web authentication
│   │   └── transactions.js # Payment building
│   ├── stores/           # Svelte stores
│   │   ├── walletStore.js
│   │   ├── contactsStore.js
│   │   └── expenseStore.js
│   └── components/       # Reusable UI components
├── routes/
│   ├── dashboard/       # Main app interface
│   ├── split/          # Expense splitting pages
│   └── transfers/      # Asset transfer pages
└── app.html            # SvelteKit app shell

Key Development Features

  • 🔧 Hot Reloading: Instant development feedback
  • 🧪 Testnet Integration: Safe testing environment
  • 📱 Responsive Testing: Mobile-first development
  • 🔍 Stellar Explorer: Direct blockchain inspection
  • 💾 Local Storage: Persistent user data

🏆 Hackathon Journey

🎯 Challenge Tackled

"How can blockchain technology revolutionize everyday financial interactions?"

💡 Our Approach

  1. Identified Pain Point: Expensive, slow expense splitting
  2. Researched Solutions: Stellar's sub-second finality + micro-fees
  3. Built MVP: Core splitting functionality in 48 hours
  4. Enhanced UX: Mobile-first design with real-time feedback
  5. Integrated SEPs: Full Stellar ecosystem compatibility

🏅 Achievements

  • ⚡ 5-second settlement (vs 3-day traditional)
  • 💰 99.9% fee reduction (vs traditional apps)
  • 🌍 Global accessibility (works anywhere)
  • 📱 Mobile-optimized (responsive design)
  • 🔗 Full SEP integration (production-ready)

🚧 Technical Challenges Overcome

  • Stellar SDK Integration: Built robust transaction handling
  • SEP Implementation: Full compliance with Stellar standards
  • Mobile UX: Perfect responsive design across devices
  • Real-time Updates: Live transaction status tracking
  • Error Handling: Graceful failure recovery

🚀 Future Roadmap

Phase 1: Core Enhancements

  • 🎯 Smart Contracts: Automated recurring splits
  • 💱 Multi-Asset Support: Split expenses in any Stellar asset
  • 🔔 Push Notifications: Real-time payment alerts
  • 📊 Analytics Dashboard: Spending insights and trends

Phase 2: Social Features

  • 👥 Group Management: Persistent expense groups
  • 💬 In-App Chat: Communicate about expenses
  • 🏷️ Expense Categories: Organize spending by type
  • 📸 Receipt Scanning: Auto-populate expense details

Phase 3: Enterprise Features

  • 🏢 Business Integration: Corporate expense management
  • 🔗 API Access: Third-party integrations
  • 📈 Advanced Analytics: Detailed financial reporting
  • 🌐 Mainnet Deployment: Production-ready launch

Phase 4: DeFi Integration

  • 🌟 Liquidity Pools: Earn yield on balances
  • 🔄 Cross-Chain: Bridge to other blockchains
  • 💎 NFT Integration: Split NFT purchases and royalties
  • 🤖 AI Insights: Smart spending recommendations

📄 License

MIT License - Built with ❤️ for the Stellar ecosystem


Made with 🌟 by Team InstantSplit for [Hackathon Name]

Reimagining peer-to-peer payments, one split at a time.

Description
Languages
JavaScript 57.7%
Svelte 41.4%
Shell 0.5%
CSS 0.2%
HTML 0.2%