Fliq 💸

Flip the script on crypto payments. Just Fliq it!

Say hello to the Venmo of crypto—blazing-fast peer-to-peer payments on Starknet with the vibe of your favorite social app. Simple. Social. Secure.

🎯 Why Crypto Payments Need a Glow-Up

Crypto payments? Kinda clunky for the average Joe:

Tech Overload: Seed phrases, gas fees, and those endless 42-character addresses? Yawn.
No Social Vibes: Venmo showed us money is social. Crypto apps? They’re giving spreadsheet energy.
Gen Z Says Nope: The TikTok generation wants speed and ease, but crypto UX is stuck in the dial-up era.

The Big Miss? Crypto’s got the goods—lightning-fast settlements, global reach, no middleman—but most folks still vibe with Venmo, Cash App, or old-school bank transfers.

💡 Enter Fliq: Your Crypto BFF

Fliq makes crypto payments feel as smooth as sending a DM:

✅ Sign in with Gmail or Farcaster — ditch the seed phrase drama
✅ @usernames, not addresses — send cash to @ada, not 0x1234...
✅ USDC zaps in <3 seconds — powered by Starknet’s speed
✅ Social feed with flair — flex your coffee run payment (or keep it private)
✅ Split bills like a pro — no more “I’ll Venmo you later” excuses

🚀 Why Fliq’s the Hottest Ticket in Town

The Money-Making Moment

Metric	Value	Source
Venmo users (US)	90M+	Statista 2024
Global P2P payments	$3.2T annually	McKinsey
Gen Z crypto fans	44% own crypto	Pew Research
Average Venmo transaction	$50-200	Company data

Our Secret Sauce: Stablecoins like USDC give you crypto’s speed without the rollercoaster price swings. It’s the perfect bridge to everyday payments.

Why Starknet’s the GOAT

Account Abstraction Magic — wallets created behind the scenes with Chipi SDK
Blink-and-You-Miss-It Speed — payments settle faster than you can say “Fliq it”
Pennies for Fees — transactions cost less than your coffee spill
Fort Knox Security — STARK proofs keep your money locked tight

🏗️ Technical Architecture

System Architecture Flowchart

graph TB
    subgraph "User Interface"
        A[Mobile/Web App<br/>React + Tailwind]
    end
    
    subgraph "Authentication Layer"
        B[Gmail OAuth]
        C[Farcaster Auth]
        D[Chipi SDK<br/>Account Abstraction]
    end
    
    subgraph "Backend API"
        E[Node.js + Express<br/>REST API]
    end
    
    subgraph "Starknet Blockchain"
        F[Username Registry<br/>Contract]
        G[Split Bill Manager<br/>Contract]
        H[Transaction Metadata<br/>Contract]
        I[USDC Token<br/>Contract]
    end
    
    subgraph "External Services"
        J[Ramp Network<br/>Fiat On-ramp]
        K[Starknet RPC<br/>Provider]
    end
    
    A -->|Login| B
    A -->|Login| C
    B --> D
    C --> D
    D -->|Create Wallet| E
    A -->|API Calls| E
    E -->|Query/Transact| K
    K --> F
    K --> G
    K --> H
    K --> I
    A -->|Buy USDC| J
    J -->|Deposit| I
    
    style A fill:#8b5cf6,stroke:#7c3aed,color:#fff
    style E fill:#ec4899,stroke:#db2777,color:#fff
    style F fill:#06b6d4,stroke:#0891b2,color:#fff
    style G fill:#06b6d4,stroke:#0891b2,color:#fff
    style H fill:#06b6d4,stroke:#0891b2,color:#fff
    style I fill:#10b981,stroke:#059669,color:#fff

User Flow: Send Money

sequenceDiagram
    participant U as User (@ada)
    participant F as Frontend
    participant B as Backend
    participant R as Username Registry
    participant USDC as USDC Contract
    participant F2 as Friend (@dami)
    
    U->>F: Enter @dami + $20
    F->>B: POST /api/payment/send
    B->>R: get_address("dami")
    R-->>B: 0x1234...
    B->>USDC: transfer(0x1234, $20)
    USDC-->>B: Transaction Hash
    B->>B: Wait for confirmation
    B-->>F: Success + txHash
    F-->>U: Payment sent! ✅
    F-->>F2: New transaction in feed

User Flow: Split Bill

flowchart TD
    Start([User creates split bill]) --> Input[Enter description & total]
    Input --> AddFriends[Add participants + amounts]
    AddFriends --> Validate{Amounts sum<br/>to total?}
    Validate -->|No| Error[Show error]
    Error --> AddFriends
    Validate -->|Yes| Resolve[Resolve usernames<br/>to addresses]
    Resolve --> Create[Create bill on-chain]
    Create --> Notify[Notify participants]
    Notify --> Wait[Wait for payments]
    
    Wait --> P1{Friend 1<br/>pays?}
    Wait --> P2{Friend 2<br/>pays?}
    Wait --> P3{Friend 3<br/>pays?}
    
    P1 -->|Yes| Track1[Mark paid]
    P2 -->|Yes| Track2[Mark paid]
    P3 -->|Yes| Track3[Mark paid]
    
    Track1 --> Check{All paid?}
    Track2 --> Check
    Track3 --> Check
    
    Check -->|Yes| Settle[Settle bill]
    Check -->|No| Wait
    Settle --> End([Bill complete ✅])
    
    style Start fill:#8b5cf6,color:#fff
    style End fill:#10b981,color:#fff
    style Error fill:#ef4444,color:#fff

Stack Overview

Frontend (React + Tailwind) → Sleek and snappy UI
    ↓
Backend (Node.js + Express) → Smooth server vibes
    ↓
Starknet Blockchain (Cairo Smart Contracts) → The heart of Fliq
    ↓
USDC Token Contract → Stablecoin goodness

Cairo Smart Contracts (The Cool Stuff)

Username Registry — Links @usernames to wallet addresses
Split Bill Wizard — Tracks who owes what, on-chain
Transaction Metadata — Adds social spice (messages, privacy options)

Power Tools

Starknet.js — Talks to the blockchain like a pro
Chipi SDK — Makes wallets invisible (in a good way)
Scarb — Keeps our Cairo code in check
Ramp Network — Buy USDC with your card or bank, easy-peasy

🎮 Try Fliq: A 2-Minute Joyride

Newbie Journey

Ada dives in → Clicks “Login with Gmail”
Wallet appears like magic → No seed phrase nonsense
Claims @ada → Username locked on-chain
Grabs $50 USDC → Via Ramp Network’s slick widget
Sends $20 to @dami → Done in 2 seconds flat
Flexes in the feed → “Ada paid Dami $20 for coffee ☕”

Split Bill Swagger

Dami sets up a bill → “Sushi Night - $120”
Tags the crew → @ada ($30), @kofi ($30), @zara ($30), Dami ($30)
Notifications pop off → “You owe Dami $30 for sushi”
One-tap payments → Everyone settles up instantly
Bill done — On-chain, stress-free

📊 How We’ll Cash In (Post-Hackathon)

Revenue Vibes

Interchange fees — 0.5% on cashouts ($0.25 per $50)
Premium perks — $2.99/month for bigger transactions
Global transfers — Tiny markup on currency swaps
Business accounts — $19/month for merchant swagger

Numbers That Pop

Average transaction: $75
Transactions per user/month: 8
Monthly revenue per user: $3.00
Customer Acquisition Cost (CAC): $15 (social referrals FTW)
Lifetime Value (LTV): $108 (3-year loyalty)
LTV:CAC ratio: 7.2x (we’re printing money!)

🎯 Hackathon Goals (We Nailed It)

Must-Haves (Done Deal ✅)

✅ Gmail/Farcaster login
✅ On-chain username registry
✅ Send USDC to @username
✅ Social feed (public/private toggle)
✅ Split bills with your squad

Metrics We’re Hyped About

Simplicity: First payment in <2 minutes ⏱️
Speed: Transactions settle in <3 seconds ⚡
Engagement: 30%+ of demo users try split bills 📊
Judge Love: “This is the Venmo of crypto!” 💬

🛠️ Get Fliq Running

What You Need

Node.js 18+
Scarb (Cairo compiler)
Starknet testnet account

Let’s Roll

# 1. Grab the code
git clone https://github.com/somehowliving/fliq
cd fliq

# 2. Set up Cairo tools
curl --proto '=https' --tlsv1.2 -sSf https://docs.swmansion.com/scarb/install.sh | sh
curl https://get.starkli.sh | sh
starkliup

# 3. Deploy contracts
cd contracts
scarb build
starkli declare target/dev/fliq_UsernameRegistry.contract_class.json
starkli deploy <CLASS_HASH>

# 4. Fire up the backend
cd ../backend
npm install
cp .env.example .env  # Toss in your contract addresses
node server.js

# 5. Launch the frontend
cd ../frontend
npm install
npm start

Hop in: http://localhost:3000

🗺️ What’s Next for Fliq

Phase 1: MVP (Hackathon Win) ✅

Core payments with usernames
Bill splitting like a boss
Social feed for the flex

Phase 2: Fiat Frenzy (Months 1-2)

Ramp Network for USDC buys
Bank linking via Plaid
NGN off-ramp (Nigeria first)

Phase 3: Social Sauce (Months 3-4)

Find friends via contacts
Group savings pots
Payment nudges & reminders
In-app chat for the vibes

Phase 4: Global Domination (Months 5-6)

Multi-currency support (KES, GHS, USD)
Merchant tools (QR codes, payment links)
Debit card integration
Recurring payments

🌍 Why Fliq’s a Big Deal

Banking the Unbanked

2 billion adults globally don’t have bank accounts
Mobile-first markets (Nigeria, Kenya, Philippines) crave better payment options
Stablecoins skip shaky banking systems

Fixing Crypto’s UX Fumble

Only 3% of crypto holders use it for payments. That’s right—97% are just HODLing. Fliq’s here to make crypto usable.

Speed + Simplicity = 🚀

Venmo: 90M users by making payments fun
Cash App: $50B+ annual volume by cutting friction
Fliq: Crypto speed meets Venmo’s cool factor

👥 The Dream Team

Your Name — Full-stack wizard
Built at: [Hackathon Name] (October 2025)
Powered by: Starknet, Chipi SDK, Scarb

📚 Tech Docs (For the Nerds)

API Endpoints

Authentication

POST /api/username/register
GET  /api/username/check/:username
GET  /api/username/resolve/:username

Payments

POST /api/payment/send
GET  /api/balance/:address
GET  /api/transactions/:address

Split Bills

POST /api/bills/create
POST /api/bills/pay
GET  /api/bills/:billId

Full API swagger: Postman Collection

Smart Contract ABIs

Check /contracts/target/dev/ after scarb build for the juicy ABIs.

🔒 Keeping It Safe & Private

Private keys stay client-side — we don’t touch ‘em
End-to-end encryption — your data’s locked down
Privacy controls — you decide what’s public or private
Audits — Post-hackathon with Nethermind Security

🤝 Join the Fliq Squad

We’re building in public—jump in!

Fork the repo
Create a branch (git checkout -b feature/epic-stuff)
Commit your magic (git commit -m 'Added epic stuff')
Push it (git push origin feature/epic-stuff)
Open a Pull Request

📄 License

MIT License — check out LICENSE.md

🙏 Shoutouts

Starknet Foundation — for the dope dev tools
Chipi SDK Crew — for making wallets disappear (in a good way)
Ramp Network — for slick fiat on-ramps
Judges — for vibing with Fliq!

📞 Holler at Us

Demo: fliq.demo.app
Twitter: @fliq_app
Email: hello@fliq.app
Discord: Join the party

🎬 Catch the Vibe

Peep the 2-minute demo → [YouTube Link]

Just Fliq it. 💸

Built with ❤️ on Starknet

Website · Docs · Twitter

Name		Name	Last commit message	Last commit date
Latest commit History 8 Commits
abis		abis
contracts		contracts
docs		docs
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md

License

SomehowLiving/fliq

Folders and files

Latest commit

History

Repository files navigation