Sleeve - A Gamified Crypto Portfolio App(Store Assets, Complete Quests, Win Prizes.)

Pyth Community Hackathon
1

Project Name: Sleeve

Team: yummyulack

Submitted: April 1, 2026

Answer Capsule

Sleeve is a gamified crypto portfolio app that transforms your on-chain holdings into a living underwater world. Users connect their wallet, watch their assets render as glowing weighted orbs in a dark aquarium scene, and earn Pearls through a daily quest system powered by Pyth Entropy for verifiable randomness. Real-time price feeds via Pyth Lazer Pro make the aquarium react live — orbs grow and shrink as markets move — deployed on Base mainnet.

What It Does

Most portfolio trackers are boring dashboards. Sleeve turns your wallet into a game world. Connect your wallet and your holdings instantly become floating orbs in a deep ocean aquarium — larger orbs for larger positions, glowing green when prices rise, dimming when they fall. Ambient fish, jellyfish, and bubbles populate the scene around your assets, making your portfolio feel alive.

On top of the visual layer sits a quest system. Every day, players can complete quests to earn Pearls — Sleeve’s reward currency. The Bonus Quest triggers Pyth Entropy on-chain, running a verifiable randomness roll that lands one of four tiers: no bonus, small, rare, or jackpot. The jackpot experience is a full stadium ovation — slot reels locking in one by one, confetti, and a fanfare sound sequence — all backed by a real on-chain entropy transaction on Base mainnet. A leaderboard tracks the top Pearl earners, adding a competitive layer on top of the daily loop.

The core loop is: connect wallet → watch your aquarium → complete quests → roll for bonus → climb the leaderboard.

Pyth Features Used

  • Pyth Lazer Pro (real-time price feeds)

  • Pyth Entropy (on-chain verifiable randomness)

  • Both

Price Feeds: Sleeve uses Pyth Lazer Pro via a server-side API route (/api/prices) that polls https://pyth-lazer.dourolabs.app every 10 seconds. The price map is merged with wallet balances from wagmi to calculate each orb’s size and USD value in real time. When a price moves up, the corresponding orb inflates and glows green with fish swimming toward it. When it drops, the orb deflates and dims. The PYTH_API_KEY is kept strictly server-side — never exposed to the client.

Entropy: All bonus reward randomness runs through Pyth Entropy on Base mainnet (contract address stored in NEXT_PUBLIC_ENTROPY_CONTRACT_ADDRESS). When a user completes the Bonus Quest, they sign an Entropy transaction from their wallet. The /api/entropy route resolves the result and maps it to a bonus tier: no bonus (0–60), small (61–90), rare (91–99), jackpot (100). Math.random() is never used in any reward logic — all outcomes are verifiable on-chain.

Links

Screenshots/Media

image
image1919×911 188 KB

Screenshot (246)
Screenshot (246)385×465 29.8 KB

Tech Stack

Layer Technology
Frontend Framework Next.js 16 App Router, React 19, TypeScript
Styling Tailwind CSS 4
Wallet RainbowKit 2, wagmi 2, viem
Database Supabase (PostgreSQL) — Pearls, quest cooldowns, rewards log
Pyth Integration Pyth Lazer Pro (price feeds), Pyth Entropy (randomness)
Blockchain Base mainnet (chain ID 8453)
Deployment Vercel

How It Works

  1. Connect your wallet — RainbowKit handles connection on Base mainnet. wagmi reads your token balances instantly.

  2. Your aquarium renders — Balances are merged with live Pyth Lazer prices. Each asset becomes a weighted orb, sized by portfolio value, floating in the scene.

  3. Prices update live — Every 10 seconds, /api/prices fetches fresh Pyth Lazer data. Orbs grow, shrink, and glow in real time.

  4. Complete the Daily Quest — A flat Pearl reward, no conditions. Just show up and claim. A 24-hour countdown starts independently after claiming.

  5. Roll the Bonus Quest — Sign an Entropy transaction. The slot machine spins for 30–40 seconds while the on-chain randomness resolves on Base. Status messages keep you informed: submitted → confirming → entropy resolving → result incoming. Reels lock in one by one. Your tier is revealed with sound and animation matched to the outcome.

  6. Climb the leaderboard — Pearl balances update in Supabase. The top 3 are always visible as a corner overlay on the aquarium.

Eligibility Confirmation

  • I am 18 years of age or older

  • I am not located in an OFAC-sanctioned territory

  • This is original work created during the hackathon period

  • I agree to the Terms & Conditions

Licensing

This project is licensed under Apache 2.0.