Empowering creators through decentralized, instant, and fair tipping on Stellar Blockchain
Stellar Tipz is a next-generation Web3 tipping platform that revolutionizes how creators receive support from their audience. Built on Stellar's high-performance blockchain with Soroban smart contracts, Tipz combines lightning-fast transactions, minimal fees, and a unique credit score system to create the most creator-friendly tipping experience in the industry.
The current creator economy is broken:
- Traditional platforms charge 30-50% in fees
- Payment delays of 7-30 days are standard
- Geographic restrictions exclude millions of creators
- No transparency in how credibility is calculated
- Complex processes requiring multiple tools and platforms
Tipz delivers:
- ⚡ Instant settlements in 3-5 seconds (not weeks)
- 💰 Only 2% withdrawal fee (95% savings vs traditional platforms)
- 🌍 Global by default - no geographic restrictions
- 🏆 Transparent credit scores based on X (Twitter) metrics
- 🎨 Beautiful brutalist UI - fast, accessible, memorable
- 🔗 Simple URLs -
tipz.app/@usernamefor easy sharing - 🔒 Fully on-chain - complete transparency and security
| Feature | Benefit |
|---|---|
| Instant XLM Tips | Receive tips in seconds, not weeks |
| 2% Withdrawal Fee | Keep 98% of earnings (vs 50-70% on traditional platforms) |
| Credit Score System | Build reputation based on X followers, posts, and engagement |
| Personal Dashboard | Track earnings, tips, and leaderboard position in real-time |
| IPFS Profile Images | Decentralized storage for your brand |
| Share to X Integration | One-click sharing to grow your audience |
| Feature | Benefit |
|---|---|
| Simple @username URLs | Just visit tipz.app/@creator to tip |
| Transparent Fees | See exactly where your money goes |
| Credit Score Visibility | Support creators with proven track records |
| Optional Messages | Add personal notes with your tips |
| Instant Confirmation | 3-5 second transaction finality |
| Leaderboard Recognition | Get recognized as a top supporter |
Our unique credit score algorithm provides transparent creator credibility. For complete documentation including the formula, weights, examples, and update mechanisms, see docs/CREDIT_SCORE.md.
Quick Overview:
- Score range: 0–100
- Base score: 40 (all new creators start at Silver tier)
- Components: Tip volume (20%), X metrics (30%), Account age (10%), Streak bonus (uncapped)
- Maximum score: 100 (Diamond tier)
| Tier | Score Range | Badge | Description |
|---|---|---|---|
| 🥉 Bronze | 20-39 | Entry Level | Below base (not achievable via normal registration) |
| 🥈 Silver | 40-59 | Established | Default for all newly registered creators |
| 🥇 Gold | 60-79 | Proven | Growing tips, X presence, or account age |
| 💎 Diamond | 80-100 | Elite | Strong across all components |
Why Credit Scores Matter:
- Helps tippers discover quality creators
- Rewards genuine engagement over vanity metrics
- Fully transparent and verifiable on-chain
- Updates automatically as creators grow
- Network: Stellar Testnet (launching on Mainnet Q1 2026)
- Smart Contracts: Soroban (Rust)
- Transaction Speed: 3-5 seconds
- Transaction Cost: ~$0.0000001 per transaction
- Wallet: Freighter wallet integration
// Core contract operations
register_profile() // Register as a creator
send_tip() // Send XLM tip to creator
withdraw_tips() // Withdraw earnings (2% fee)
get_profile() // Query creator profile
get_leaderboard() // Fetch top creators
calculate_score() // Compute credit score- Framework: React 18 + TypeScript
- Build Tool: Webpack 5 (via Scaffold Stellar)
- Styling: TailwindCSS with brutalist design system
- State Management: Zustand + React Query
- Routing: React Router v6
- Animations: Framer Motion
- Icons: Lucide React
- Storage: IPFS via Web3.Storage
- Social Integration: X (Twitter) API
- Development: Scaffold Stellar framework
- Deployment: Vercel (frontend) + Stellar (contracts)
Primary: 2% Withdrawal Fee
- Creators pay 2% when withdrawing tips
- Example: $1,000 withdrawal = $20 platform fee
- 95% cheaper than traditional platforms (30-50% fees)
Future Revenue (Post-MVP):
- 💎 Premium creator badges ($10/month)
- 🚀 Sponsored leaderboard placements
- 📊 Advanced analytics dashboard
- 🔌 API access for integrations
- 🎨 Custom profile themes
| Metric | Month 1 | Month 6 | Month 12 |
|---|---|---|---|
| Creators | 50 | 1,000 | 10,000 |
| Avg Tips/Creator | $100 | $500 | $500 |
| Platform Revenue | $100 | $10,000 | $100,000 |
- Smart contract architecture designed
- Frontend design system created
- Scaffold Stellar integration
- Testnet deployment
- Beta testing with 50 creators
- Hackathon submission
- Stellar Mainnet deployment
- Security audit completion
- Mobile-responsive PWA
- Multi-token support (USDC, AQUA)
- Target: 1,000 active creators
- Recurring tips/subscriptions
- Creator badges & achievements
- Advanced analytics dashboard
- Email notifications
- Target: 10,000 active creators
- Mobile apps (iOS/Android)
- Browser extension
- Public API launch
- Multi-blockchain support
- Target: 50,000 active creators
Brutalist Minimalism: Bold, honest, and unapologetically functional.
- Colors: Pure black (#000000) and white (#FFFFFF)
- Typography: Space Grotesk / Inter (bold, clean sans-serif)
- Borders: Bold 2-3px black strokes
- Shadows: 4-6px offset black shadows for depth
- Layout: Grid-based, perfectly aligned
- Icons: Sharp, line-based (Lucide)
- Speed First: Every action completes in <5 seconds
- Transparency: All fees and processes visible
- Accessibility: WCAG AA compliant
- Mobile-First: Optimized for phones
- Progressive Enhancement: Works without JavaScript
Phase: MVP Development (Pre-Launch)
Target: Scaffold Stellar Hackathon Submission Q4 2025
- Smart contract architecture & data models
- Frontend design system (brutalist black/white)
- Scaffold Stellar integration
- Development environment setup
- Credit score algorithm design
- Complete technical documentation
- Soroban smart contract implementation (Rust)
- React component library (atoms → organisms)
- Freighter wallet integration
- IPFS storage configuration
- X (Twitter) API integration
- Testnet deployment preparation
- Deploy Tipz contract to Stellar Testnet
- Build & test core UI components
- Integrate wallet + IPFS + X API
- Onboard 50 beta creators
- Process first 1,000 test tips
- Submit hackathon entry
Current Sprint: Smart Contract Development (Week 1 of 5)
Brutalist Minimalism - Bold, honest, and unapologetically functional.
- Colors: Pure black (#000000) and white (#FFFFFF)
- Typography: Space Grotesk / Inter (bold, clean sans-serif)
- Borders: Bold 2-3px black strokes everywhere
- Shadows: 4-6px offset black shadows for depth
- Layout: Grid-based, perfectly aligned
- Icons: Sharp, line-based (Lucide React)
- Soroban (Rust) - Stellar's smart contract platform
- Stellar SDK - Blockchain interactions
- 3-5 second finality - Lightning-fast transactions
- ~$0.0000001 cost - Virtually free
- React 18 + Webpack (Scaffold Stellar)
- TypeScript - Type-safe development
- TailwindCSS - Utility-first styling
- Zustand - Lightweight state management
- React Query - Data fetching & caching
- Framer Motion - Smooth animations
- IPFS (Web3.Storage) - Decentralized image storage
- Freighter Wallet - Stellar wallet integration
- X (Twitter) API - Social metrics integration
- Scaffold Stellar - Development framework
- Vercel - Frontend deployment
✅ Connect wallet & link X account
✅ Automatic credit score calculation
✅ Personal profile page (tipz.app/@username)
✅ Real-time earnings dashboard
✅ Instant tip notifications
✅ Withdraw anytime (2% fee)
✅ Share to X with one click
✅ Simple @username URLs for tipping
✅ See creator credit scores
✅ Optional messages with tips
✅ 3-5 second confirmations
✅ Transparent fee structure
✅ Leaderboard recognition
Node.js 18+
Rust & Cargo
Soroban CLI
Freighter Wallet extension
Docker & Docker Compose (optional, for containerized dev)# Clone repository
git clone https://github.com/yourusername/stellar-tipz.git
cd stellar-tipz
# Install dependencies
npm install
# Start development server
npm run dev# Build and start all services
docker compose --profile dev up -d
# Frontend is available at http://localhost:3000
# Contract changes auto-reload via cargo watch
# View logs
docker compose logs -f
# Run contract tests inside container
docker compose exec contract cargo test
# Stop all services
docker compose down# Build contract
cd contracts/tipz
cargo build --target wasm32-unknown-unknown --release
# Deploy to Stellar Testnet
soroban contract deploy \
--wasm target/wasm32-unknown-unknown/release/tipz.wasm \
--network testnet| Metric | Traditional | Stellar Tipz |
|---|---|---|
| Fees | 30-50% | 2% (95% savings) |
| Settlement | 7-30 days | 3-5 seconds (10,000x faster) |
| Access | Regional | Global |
| Transparency | Hidden | On-chain |
| Metric | Other Web3 | Stellar Tipz |
|---|---|---|
| Speed | 15+ seconds | 3-5 seconds |
| Cost | $1-50 gas | <$0.001 |
| UX | Complex wallets | Simple @username |
Our Moat: First-mover on Stellar + Unique credit score IP + X integration
Creator Economy: $104B market, 50M+ creators, 20% YoY growth
Digital Tipping: $10B+ market, 100M+ active tippers
Stellar Ecosystem: 7M+ accounts, rapidly growing Soroban adoption
Our Vision: Become the default tipping layer for creators on Stellar, processing millions of tips monthly with 98% going directly to creators.
Smart Contract:
- ✅ Reentrancy protection
- ✅ Input validation on all functions
- ✅ Access control & permissions
- ✅ Safe math (overflow protection)
- 🔜 Third-party audit post-MVP
Platform:
- ✅ No private keys stored
- ✅ Local wallet signing only
- ✅ HTTPS encrypted
- ✅ Rate limiting
- ✅ 100% on-chain transparency
Currently in active hackathon development. Contributions welcome post-MVP launch!
Ways to Help Now:
- Star the repo ⭐
- Join as beta tester (link coming soon)
- Share feedback & ideas
- Report bugs via GitHub Issues
MIT License - Free to use, modify, and distribute with attribution.
- 🌐 Website: tipz.app (launching soon)
- 🐙 GitHub: github.com/yourusername/stellar-tipz
- 🐦 Twitter: @TipzApp
- 📧 Email: hello@tipz.app
Built on: Stellar | Soroban | Scaffold Stellar
Founder & Developer: Akan Nigeria
Support: Stellar Foundation · Scaffold Stellar Program · Stellar Community
Thanks to Stellar Foundation, Scaffold Stellar team, Soroban developers, and the entire Stellar community for making this possible.
Empowering Creators, One Tip at a Time
Built with ❤️ for the Scaffold Stellar Hackathon
Status: 🚧 In Active Development
Target Launch: Q4 2025 (Testnet) | Q1 2026 (Mainnet)
Documentation • Twitter • GitHub
Hackathon Submission: Scaffold Stellar Hackathon 2025
Project Started: November 10, 2025
⚡ Powered by Stellar | 🪐 Built with Soroban | 🛠️ Made with Scaffold Stellar
For common errors and their solutions, see docs/TROUBLESHOOTING.md.