What is TradeTrackr? A decentralized application that lets you track your crypto portfolio performance, compete with friends in trading groups, and prove you're a real person to prevent fake accounts. Think of it as "Fantasy Football for Crypto Trading" with real money and verified players.
- Connect Your Wallet - Use Openfort (no installation needed) or MetaMask
- Verify Your Identity - Optional Concordium verification to unlock premium features
- Join or Create a Group - Find trading friends or start your own competition
- Track Your Performance - See real-time portfolio metrics and compete for the top spot
- Dashboard: Your portfolio value, win rate, and trading activity
- Groups: Join trading competitions with verified participants
- Challenges: Participate in time-limited trading tournaments
- Profile: Your trading achievements and verification status
- Fake Performance: Easy to fake screenshots and performance claims
- Multiple Accounts: Users create fake accounts to manipulate competitions
- Scattered Data: No unified view across different blockchain networks
- No Social Element: Trading is often lonely and lacks community
- ✅ Real Blockchain Data: All performance comes directly from on-chain transactions
- ✅ Identity Verification: Concordium integration prevents duplicate accounts
- ✅ Multi-Chain Support: Track Ethereum, Polygon, Base, and Arbitrum in one place
- ✅ Social Competition: Group-based challenges with verified participants
- Openfort: Create a wallet instantly (no downloads needed)
- MetaMask: Use your existing wallet
- Both: Switch between embedded and external wallets seamlessly
- Click "Verify Identity with Concordium"
- Prove you're a unique human (no personal data required)
- Unlock verified badges and premium group features
- Prevent others from creating fake accounts
- Browse Public Groups: Join existing trading communities
- Create Private Group: Start your own competition with friends
- Use Group Codes: Share codes to invite specific people
- See Live Performance: Real-time data from blockchain transactions
- Dashboard: Monitor your portfolio performance
- Group Page: See how you rank against other members
- Challenges: Join time-limited trading tournaments
- Profile: View your achievements and trading history
What you'll see: Welcome screen with app overview
- Hero Section: "Track, Compete, Verify" - explains what TradeTrackr does
- Key Features: Real-time tracking, group competitions, identity verification
- Get Started Button: Takes you to the Groups page to connect wallet
What you'll do: Connect wallet and join/create trading groups
- Connect Wallet: Choose Openfort (instant) or MetaMask (existing wallet)
- Verify Identity: Optional step to prove you're a real person
- Browse Groups: See public groups with live performance data
- Create Group: Start your own private competition
- Join Group: Use group codes to join specific groups
Why it matters: This is where you start your trading journey and find your community
What you'll see: Your personal trading performance overview
- Portfolio Value: Total worth across all chains (Ethereum, Polygon, Base, Arbitrum)
- Performance: 7-day gain/loss percentage
- Trading Stats: Number of trades, win rate, trading volume
- Your Groups: All groups you're in with member counts
- Top Performers: Best traders in your groups
Why it matters: Your command center for tracking trading success
What you'll see: Detailed competition within a specific group
- Group Info: Name, description, member count, group code for sharing
- Performance Charts: See how the group performs over time
- Leaderboard: Ranked list of all members with their performance
- Portfolio Distribution: Visual breakdown of who has the most value
- Verification Badges: See which members are verified humans
Why it matters: See how you stack up against your trading friends
What you'll see: Your personal trading achievements and stats
- Trading Stats: Total trades, win rate, challenges won, how long you've been trading
- Portfolio Performance: Total value, all-time gains, best single trade
- Achievements: Unlockable badges for trading milestones
- Verification Status: Your Concordium identity verification
Why it matters: Track your progress and show off your trading skills
What you'll see: Time-limited trading competitions
- Active Challenges: Live competitions you can join
- Challenge Details: Rules, number of participants, time remaining, prizes
- Difficulty Levels: Easy, Medium, Hard, Expert - choose your level
- Prize Pools: Real rewards for top performers
Why it matters: Test your skills against other traders for prizes
- Modern web browser (Chrome, Firefox, Safari, Edge)
- No crypto experience needed - we'll guide you through everything!
# Clone the repository
git clone https://github.com/your-username/tradetrackr.git
cd tradetrackr
# Install dependencies
npm install
# Start development server
npm run dev# Copy environment template
cp .env.example .env
# Configure environment variables (if you have API keys)
VITE_ENVIO_ENDPOINT=your_envio_graphql_endpoint
VITE_ENVIO_API_KEY=your_envio_api_key
VITE_OPENFORT_PUBLIC_KEY=your_openfort_key- Development:
npm run dev- Starts local server at http://localhost:5173 - Build:
npm run build- Creates production build - Preview:
npm run preview- Preview production build
- No Fake Screenshots: All performance data comes directly from blockchain transactions
- Multi-Chain Support: Track Ethereum, Polygon, Base, and Arbitrum in one place
- Real-Time Updates: See your portfolio change as you trade
- Transparent Metrics: Win rate, PnL, and trading volume calculated from actual trades
- Concordium Integration: Prove you're a unique human without sharing personal data
- Anti-Sybil Protection: Prevents users from creating multiple accounts
- Verified Badges: Show off your verified status to other traders
- Fair Competition: Ensures one-person-one-account in all groups
- Group Competitions: Compete with friends in private or public groups
- Live Leaderboards: See real-time rankings of group members
- Trading Challenges: Join time-limited competitions with prizes
- Community Building: Find like-minded traders and learn together
- No Downloads: Create wallets instantly with Openfort
- MetaMask Support: Use your existing wallet if you prefer
- No Crypto Knowledge Required: We guide you through everything
- Mobile Friendly: Works on all devices
- What it does: Lets you create a crypto wallet instantly without downloading anything
- Why it's great: No need to install MetaMask or other wallet software
- How it works: Click "Connect Wallet" and you're ready to go
- For developers: Provides embedded wallet infrastructure and account abstraction
- What it does: Proves you're a real person without sharing personal information
- Why it's important: Prevents fake accounts and ensures fair competition
- How it works: Click "Verify Identity" and follow the simple process
- Privacy: Only proves uniqueness, no personal data is shared
- What it does: Tracks all your trading activity across multiple blockchains
- Why it's accurate: Gets data directly from blockchain transactions
- How it works: Automatically updates your performance as you trade
- Chains supported: Ethereum, Polygon, Base, Arbitrum
- Solana Support: Track Solana wallets and DeFi protocols
- Cross-Chain Swaps: Trade between different blockchains
- Layer 2 Expansion: Support for Optimism, zkSync, and StarkNet
- AI Insights: Get personalized trading recommendations
- Copy Trading: Follow successful traders automatically
- Social Feed: Share trades and strategies with the community
- Team Management: Corporate trading team oversight
- API Access: Connect your own trading bots
- Advanced Analytics: Risk assessment and portfolio optimization
- What it shows: Total worth of all your crypto across all blockchains
- How it's calculated: Sum of all your token holdings × current prices
- Why it matters: Shows your overall trading success
- 7-Day Performance: How much you gained/lost in the past week
- All-Time Performance: Total gains since you started trading
- Win Rate: Percentage of profitable trades
- Why it matters: Shows if your trading strategy is working
- Transaction Count: Number of trades you've made
- Trading Volume: Total value of all your trades
- Active Chains: Which blockchains you trade on
- Why it matters: Shows how active you are as a trader
- Member Count: How many people are in your group
- Average Performance: How well your group is doing overall
- Top Performer: Who's winning in your group
- Verification Rate: How many members are verified humans
- Why it matters: Shows how competitive your group is
- Participation Count: How many people joined the challenge
- Prize Pool: Total rewards available
- Time Remaining: How much time is left
- Difficulty: Easy/Medium/Hard/Expert level
- Why it matters: Helps you choose the right challenge for your skill level
- Portfolio Value Cards: Show your total worth, performance, and trading stats
- Top Performers Grid: See the best traders in your groups with their stats
- Group Overview Cards: Summary of all your groups with member counts
- Performance Trend Chart: See how your group performs over time
- Portfolio Distribution Pie Chart: Visual breakdown of who has the most value
- Member Leaderboard Table: Ranked list of all group members
- Trading Statistics: Your personal achievements and stats
- Portfolio Performance: Key financial metrics
- Achievements Grid: Unlockable badges for trading milestones
- Challenge Statistics: Overall platform activity
- Challenge Cards: Individual challenge details with join buttons
- Green: Positive performance, gains, success
- Red: Negative performance, losses, errors
- Gold: First place, top performer
- Silver: Second place
- Bronze: Third place
- Blue: Neutral information, links
- ✅ Privacy-Preserving Identity: Concordium wallet integration for Sybil resistance
- ✅ Verified Groups: Verified-only groups with identity badges
- ✅ Seamless UX: Optional verification that enhances trust without friction
- ✅ Multi-Chain Indexing: Real-time data across Ethereum, Polygon, Base, Arbitrum
- ✅ GraphQL API: Efficient data querying with Apollo Client
- ✅ Performance Analytics: Live PnL calculations and win rate analysis
- ✅ Embedded Wallets: Seamless onboarding for non-crypto users
- ✅ Account Abstraction: Gasless transactions and smart wallet features
- ✅ Social Login: Email/password authentication alongside crypto wallets
- Frontend: React 18 + TypeScript + Vite
- UI: Tailwind CSS + shadcn/ui
- State Management: TanStack Query + React Router
- Charts: Recharts for data visualization
- Blockchain: Openfort + Wagmi + Viem
- Identity: Concordium SDK
- Data: Envio GraphQL API
src/
├── components/ # Reusable UI components
├── services/ # External service integrations
├── hooks/ # Custom React hooks
├── pages/ # Main application pages
├── types/ # TypeScript type definitions
└── lib/ # Utility libraries
- Openfort: Embedded wallet infrastructure
- Concordium: Privacy-preserving identity verification
- Envio: Multi-chain data indexing and GraphQL API
npm run dev # Start development server
npm run build # Create production build
npm run preview # Preview production buildWe welcome contributions! Please see our contributing guidelines for details on:
- Code style and standards
- Pull request process
- Issue reporting
- Feature requests
This project is licensed under the MIT License - see the LICENSE file for details.
- Concordium - Privacy-preserving identity verification
- Envio - Multi-chain data indexing platform
- Openfort - Embedded wallet infrastructure
- shadcn/ui - Beautiful component library
- Vite - Lightning-fast build tool
Built with ❤️ for the Encode London Hackathon 2025
TradeTrackr - Where Trust and Trading Meets Performance and Competitiveness