# Project export: icebreakers This document was generated by HackStack to give an AI agent context about a hackathon project. Sections are labeled with their provenance; content marked as truncated was cut to keep this document small. ## Project metadata - Hackathon: Cal Hacks 12.0 - Tagline: Break the ice, make new friends, and earn SUI for doing it. - Devpost: https://devpost.com/software/icebreakers-agzmov - GitHub: https://github.com/Pravesh-mansharamani/icebreaker - Demo: https://icebreaker-eta.vercel.app/ - Video: https://www.youtube.com/embed/DLgOAS4IV-4?enablejsapi=1&hl=en_US&rel=0&start=&version=3&wmode=transparent - Team: 1 GitHub contributor(s) — Pravesh Mansharamani (10 commits) ## Devpost submission (written by the team) ### Inspiration Meeting people at hackathons can be awkward — we wanted to make it fun, rewarding, and on-chain. ### What it does Gamifies networking: complete quests, share photos, and earn SUI rewards for meeting new people. ### How we built it Built with Next.js, Sui SDK, Move contracts, and IPFS for storing photos. Integrated Slush Wallets for smooth sponsored transactions and future reward automation. ### Challenges we ran into Originally planned to use Walrus, but it required too many WAL tokens and the faucet was unreliable — we couldn’t upload even one image. Switched to IPFS for speed and reliability. Accomplishments we're proud of Deployed a working on-chain reward pool, integrated Slush Wallets for sponsor-backed payouts, and made every user activity verifiable on-chain. ### What we learned How to build with the Sui Move framework, use sponsored transactions, and design on-chain UX that feels like a normal social app. ### What's next for Icebreaker Enable full reward verification, let sponsors create dynamic quests, move to mainnet, and power networking at real hackathons with on-chain social proofs. ## README (from the GitHub repository) # Icebreaker 🧊 **Break the ice, make new friends, and earn SUI for doing it.** Icebreaker is a social app where you can connect with others at events. Share photos, complete fun quests, and earn SUI rewards for every interaction! ## What is Icebreaker? Icebreaker helps you meet new people at events through photo sharing, quests, and challenges. Every time you participate, you earn SUI rewards (0.003 SUI per activity). It's gamified networking that makes meeting new people fun and rewarding! ## 🚀 Features - **Photo Sharing**: Take and share photos with the community - **Quests & Challenges**: Complete tasks to earn points and SUI - **Real Rewards**: Get 0.003 SUI for every upload (paid from our reward pool) - **Live Escrow Pool Balance**: See exactly how much SUI is left in the reward pool - **Leaderboards**: Track your points and level up ## 💰 Deployed Contracts & Pool Information ### Escrow Pool Contract - **Package ID**: [`0xcc55d1b3e2b8f5ad42aeba278ac680fdcc7d0ccb602971346e60177ca7d9b761`](https://suiexplorer.com/object/0xcc55d1b3e2b8f5ad42aeba278ac680fdcc7d0ccb602971346e60177ca7d9b761?network=testnet) - **Network**: Sui Testnet - **Type**: Shared Object (Pool for reward distribution) ### Reward Pool Object - **Object ID**: [`0x94bd6487e22a711507bd85144aca335e34996962065bbe9189c7aa7ac4c7447e`](https://suiexplorer.com/object/0x94bd6487e22a711507bd85144aca335e34996962065bbe9189c7aa7ac4c7447e?network=testnet) - **Current Balance**: Check the live balance in the app navigation - **Purpose**: Holds SUI for automatic rewards (0.003 SUI per upload) ### Sponsor Wallet - **Address**: `0x29c9ea26349d4fcd9cc41620fb29d5c7bcc1da93577887fb1981681212cf66d1` - **Purpose**: Funded wallet used to initialize and maintain the pool ## 🔄 How to Add More Money to the Pool You can add more SUI to the reward pool using one of these methods: ### Option 1: Using Sui CLI ```bash # Call the deposit_shared function directly sui client call \ --package 0xcc55d1b3e2b8f5ad42aeba278ac680fdcc7d0ccb602971346e60177ca7d9b761 \ --module escrow_pool \ --function deposit_shared \ --args 0x94bd6487e22a711507bd85144aca335e34996962065bbe9189c7aa7ac4c7447e \ --gas-budget 10000000 ``` ### Option 2: Send SUI to the Pool Object 1. Send SUI coins to the pool object address using any Sui wallet 2. The pool will automatically accept and store them ## 🏗️ Architecture - **Frontend**: Next.js 15 with TypeScript - **Blockchain**: Sui Network (Testnet) - **Smart Contracts**: Move language - **Rewards**: Automated via escrow pool smart contract - **Storage**: IPFS ## 📦 Project Structure ``` icebreaker/ ├── contracts/ # Sui Move smart contracts │ ├── sources/ │ │ └── escrow_pool.move │ └── Move.toml ├── app/ # Next.js app directory │ ├── api/ │ │ ├── transfer-sui/ # Reward distribution endpoint │ │ └── pool-balance/ # Pool balance checker │ ├── upload/ # Photo upload page │ └── ... ├── components/ # React components └── scripts/ # Deployment scripts ``` ## 🚀 Getting Started ### Prerequisites - Node.js 18+ - pnpm - Sui CLI (for deployment) ### Setup 1. **Clone and install**: ```bash git clone cd icebreaker pnpm install ``` 2. **Configure environment**: ```bash cp .env.example .env # Add your sponsor wallet and pool IDs ``` 3. **Run the app**: ```bash pnpm dev ``` Visit `http://localhost:3000` and start earning SUI! ## 🎯 How Rewards Work 1. User uploads a photo/participates in activity 2. App calls the escrow pool smart contract 3. Contract withdraws 0.003 SUI from the pool 4. SUI is transferred to the user's wallet 5. Pool balance updates in real-time 6. Everyone can see how much SUI is left ## 🔒 Security - Pool is password-protected - Only authorized withdrawals via sponsor wallet - All transactions on-chain and transparent - No private keys stored in the app ## 🤝 Built For This project was built for a hackathon as a proof of concept for: - Gamified social networking - Automated micro-rewards via smart contracts - Transparent reward distribution - On-chain pool management ## Detected evidence (automated analysis) Indexed codebase: 89 recognized source files, 480 KB. - CSS (language) — detected in the code - JavaScript (language) — detected in the code - Next.js (technology) — detected in the code - React (technology) — detected in the code - Tailwind CSS (technology) — detected in the code - TypeScript (language) — detected in the code ## Codebase structure (from repository index) ### Files (101 of 101) ``` .env.example .gitignore app/api/auth/callback/route.ts app/api/auth/logout/route.ts app/api/auth/status/route.ts app/api/pool-balance/route.ts app/api/transfer-sui/route.ts app/auth/page.tsx app/feed/page.tsx app/globals.css app/layout.tsx app/page.tsx app/profile/page.tsx app/providers.tsx app/quests/page.tsx app/share/page.tsx app/sw.ts app/upload/loading.tsx app/upload/page.tsx components.json components/AutoConnectSlush.tsx components/AutoConnectSlushWrapper.tsx components/cyber-navigation.tsx components/navigation.tsx components/points-animation.tsx components/theme-provider.tsx components/ui/accordion.tsx components/ui/alert-dialog.tsx components/ui/alert.tsx components/ui/aspect-ratio.tsx components/ui/avatar.tsx components/ui/badge.tsx components/ui/breadcrumb.tsx components/ui/button.tsx components/ui/calendar.tsx components/ui/card.tsx components/ui/carousel.tsx components/ui/chart.tsx components/ui/checkbox.tsx components/ui/collapsible.tsx components/ui/command.tsx components/ui/context-menu.tsx components/ui/dialog.tsx components/ui/drawer.tsx components/ui/dropdown-menu.tsx components/ui/form.tsx components/ui/hover-card.tsx components/ui/input-otp.tsx components/ui/input.tsx components/ui/label.tsx components/ui/menubar.tsx components/ui/navigation-menu.tsx components/ui/pagination.tsx components/ui/popover.tsx components/ui/progress.tsx components/ui/radio-group.tsx components/ui/resizable.tsx components/ui/scroll-area.tsx components/ui/select.tsx components/ui/separator.tsx components/ui/sheet.tsx components/ui/sidebar.tsx components/ui/skeleton.tsx components/ui/slider.tsx components/ui/sonner.tsx components/ui/switch.tsx components/ui/table.tsx components/ui/tabs.tsx components/ui/textarea.tsx components/ui/toast.tsx components/ui/toaster.tsx components/ui/toggle-group.tsx components/ui/toggle.tsx components/ui/tooltip.tsx components/ui/use-mobile.tsx components/ui/use-toast.ts contracts/escrow_pool.move contracts/Move.toml contracts/sources/escrow_pool.move hooks/use-mobile.tsx hooks/use-toast.ts lib/ipfs-helpers.ts lib/utils.ts middleware.ts Move.lock next-env.d.ts next.config.mjs package.json postcss.config.mjs public/manifest.json public/sw.js README.md scripts/deploy-contract.ts scripts/deposit-to-pool.ts scripts/fix-secret-key.ts scripts/get-wallet-key.ts scripts/initialize-pool.ts sources/escrow_pool.move styles/globals.css tailwind.config.ts tsconfig.json ``` ### Dependencies - package.json: @hookform/resolvers@^3.9.1, @mysten/dapp-kit@^0.19.6, @mysten/slush-wallet@^0.2.7, @mysten/sui@^1.43.1, @mysten/sui.js@^0.54.1, @mysten/wallet-kit@^0.8.6, @mysten/walrus@^0.8.1, @radix-ui/react-accordion@1.2.2, @radix-ui/react-alert-dialog@1.1.4, @radix-ui/react-aspect-ratio@1.1.1, @radix-ui/react-avatar@1.1.2, @radix-ui/react-checkbox@1.1.3, @radix-ui/react-collapsible@1.1.2, @radix-ui/react-context-menu@2.2.4, @radix-ui/react-dialog@1.1.4, @radix-ui/react-dropdown-menu@2.1.4, @radix-ui/react-hover-card@1.1.4, @radix-ui/react-label@2.1.1, @radix-ui/react-menubar@1.1.4, @radix-ui/react-navigation-menu@1.2.3, @radix-ui/react-popover@1.1.4, @radix-ui/react-progress@latest, @radix-ui/react-radio-group@1.2.2, @radix-ui/react-scroll-area@1.2.2, @radix-ui/react-select@2.1.4, @radix-ui/react-separator@1.1.1, @radix-ui/react-slider@1.2.2, @radix-ui/react-slot@1.1.1, @radix-ui/react-switch@1.1.2, @radix-ui/react-tabs@1.1.2, @radix-ui/react-toast@1.2.4, @radix-ui/react-toggle@1.1.1, @radix-ui/react-toggle-group@1.1.1, @radix-ui/react-tooltip@1.1.6, @tanstack/react-query@^5.90.5, @types/node@^22, @types/react@^19, @types/react-dom@^19, @vercel/analytics@^1.5.0, autoprefixer@^10.4.20, canvas-confetti@latest, class-variance-authority@^0.7.1, clsx@^2.1.1, cmdk@1.0.4, date-fns@latest, dotenv@^17.2.3, embla-carousel-react@8.5.1, input-otp@1.4.1, ipfs-http-client@^60.0.1, lucide-react@^0.454.0, multiformats@13, next@15.2.4, next-themes@^0.4.4, postcss@^8, react@^19, react-day-picker@9.5.1, react-dom@^19, react-hook-form@^7.54.1, react-resizable-panels@^2.1.7, recharts@2.15.0, sonner@^1.7.1, tailwind-merge@^2.5.5, tailwindcss@^3.4.17, tailwindcss-animate@^1.0.7, tsx@^4.7.0, typescript@^5, uint8arrays@^5.1.0, vaul@^1.1.2, zod@^3.24.1 ### Recent commits (newest first) - feat: ipfs - fix: pool component - contract - feat: escrow rewards pool contract - feat: analytics - feat: micro txs - fix: styling - fix: pwa mobile - fix: refactor - feat: slush login auth - feat: init version app ## Key source files (fetched from GitHub, selected and truncated for size) ### package.json ``` { "name": "icebreaker", "version": "0.1.0", "private": true, "scripts": { "dev": "next dev", "build": "next build", "start": "next start", "lint": "next lint", "deploy:contract": "tsx scripts/deploy-contract.ts", "init:pool": "tsx scripts/initialize-pool.ts", "generate:wallet": "tsx scripts/get-wallet-key.ts", "fix:key": "tsx scripts/fix-secret-key.ts", "add:funds": "tsx scripts/deposit-to-pool.ts" }, "dependencies": { "@hookform/resolvers": "^3.9.1", "@mysten/dapp-kit": "^0.19.6", "@mysten/slush-wallet": "^0.2.7", "@mysten/sui": "^1.43.1", "@mysten/sui.js": "^0.54.1", "@mysten/wallet-kit": "^0.8.6", "@mysten/walrus": "^0.8.1", "@radix-ui/react-accordion": "1.2.2", "@radix-ui/react-alert-dialog": "1.1.4", "@radix-ui/react-aspect-ratio": "1.1.1", "@radix-ui/react-avatar": "1.1.2", "@radix-ui/react-checkbox": "1.1.3", "@radix-ui/react-collapsible": "1.1.2", "@radix-ui/react-context-menu": "2.2.4", "@radix-ui/react-dialog": "1.1.4", "@radix-ui/react-dropdown-menu": "2.1.4", "@radix-ui/react-hover-card": "1.1.4", "@radix-ui/react-label": "2.1.1", "@radix-ui/react-menubar": "1.1.4", "@radix-ui/react-navigation-menu": "1.2.3", "@radix-ui/react-popover": "1.1.4", "@radix-ui/react-progress": "latest", "@radix-ui/react-radio-group": "1.2.2", "@radix-ui/react-scroll-area": "1.2.2", "@radix-ui/react-select": "2.1.4", "@radix-ui/react-separator": "1.1.1", "@radix-ui/react-slider": "1.2.2", "@radix-ui/react-slot": "1.1.1", "@radix-ui/react-switch": "1.1.2", "@radix-ui/react-tabs": "1.1.2", "@radix-ui/react-toast": "1.2.4", "@radix-ui/react-toggle": "1.1.1", "@radix-ui/react-toggle-group": "1.1.1", "@radix-ui/react-tooltip": "1.1.6", "@tanstack/react-query": "^5.90.5", "@vercel/analytics": "^1.5.0", "autoprefixer": "^10.4.20", "canvas-confetti": "latest", "class-variance-authority": "^0.7.1", "clsx": "^2.1.1", "cmdk": "1.0.4", "date-fns": "latest", "embla-carousel-react": "8.5.1", "input-otp": "1.4.1", "ipfs-http-client": "^60.0.1", "lucide-react": "^0.454.0", "multiformats": "13", "next": "15.2.4", "next-themes": "^0.4.4", "react": "^19", "react-day-picker": "9.5.1", "react-dom": "^19", "react-hook-form": "^7.54.1", "react-resizable-panels": "^2.1.7", "recharts": "2.15.0", "sonner": "^1.7.1", "tailwind-merge": "^2.5.5", "tailwindcss-animate": "^1.0.7", "uint8arrays": "^5.1.0", "vaul": "^1.1.2", "zod": "^3.24.1" }, "devDependencies": { "@types/node": "^22", "@types/react": "^19", "@types/react-dom": "^19", "dotenv": "^17.2.3", "postcss": "^8", "tailwindcss": "^3.4.17", "tsx": "^4.7.0", "typescript": "^5" } } ``` ### app/page.tsx ```typescript import { redirect } from "next/navigation" import { cookies } from "next/headers" export default async function RootPage() { const cookieStore = await cookies() const authToken = cookieStore.get("slush_auth_token")?.value if (authToken) { redirect("/feed") } else { redirect("/auth") } } ``` ### app/layout.tsx ```typescript import type React from "react" import type { Metadata, Viewport } from "next/dist/lib/metadata/types/metadata-interface" import { Inter } from "next/font/google" import "./globals.css" import "@mysten/dapp-kit/dist/index.css" import { Providers } from "./providers" import { AutoConnectSlushWrapper } from "@/components/AutoConnectSlushWrapper" import { Toaster } from "@/components/ui/sonner" const inter = Inter({ subsets: ["latin"] }) export const metadata: Metadata = { title: "Icebreaker", description: "Gamify your events with Icebreaker", manifest: "/manifest.json", appleWebApp: { capable: true, statusBarStyle: "black-translucent", title: "Icebreaker", }, } export const viewport: Viewport = { themeColor: "#000000", } export default function RootLayout({ children, }: Readonly<{ children: React.ReactNode }>) { return ( {children} ) } ``` ### app/share/page.tsx ```typescript "use client" import { useIcebreaker } from "../providers" import { Button } from "@/components/ui/button" import { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from "@/components/ui/card" import { Share2 } from "lucide-react" import Link from "next/link" import { useState } from "react" import { PointsAnimation } from "@/components/points-animation" import { useSearchParams } from "next/navigation" import { CyberNavigation } from "@/components/cyber-navigation" export default function SharePage() { const { userData, addPoints, completeQuest } = useIcebreaker() const searchParams = useSearchParams() const questId = searchParams.get("questId") const [showAnimation, setShowAnimation] = useState(false) const [shared, setShared] = useState(false) const handleShare = async () => { try { if (navigator.share) { await navigator.share({ title: "Check out Icebreaker!", text: `I've earned ${userData.points} points at this event using Icebreaker!`, url: window.location.origin, }) // Award points for sharing if (!shared) { addPoints(5) if (questId) { completeQuest(questId) } setShared(true) setShowAnimation(true) setTimeout(() => setShowAnimation(false), 1500) } } else { // Fallback for browsers that don't support the Web Share API alert(`Share this: I've earned ${userData.points} points at this event using Icebreaker!`) // Still award points if (!shared) { addPoints(5) if (questId) { completeQuest(questId) } setShared(true) setShowAnimation(true) setTimeout(() => setShowAnimation(false), 1500) } } } catch (error) { console.error("Error sharing:", error) } } return (
{showAnimation && } SHARE WITH FRIENDS Let others know about your achievements!

I've earned {userData.points} POINTS at this event using Icebreaker!

Share your progress with friends and earn 5 bonus points!
) } ``` ### app/auth/page.tsx ```typescript "use client" import { useEffect } from "react" import Image from "next/image" import { useRouter } from "next/navigation" import { Button } from "@/components/ui/button" import { ConnectModal, useCurrentWallet, useCurrentAccount } from "@mysten/dapp-kit" import { toast } from "sonner" export default function LoginPage() { const router = useRouter() const { currentWallet, connectionStatus } = useCurrentWallet() const currentAccount = useCurrentAccount() useEffect(() => { // Check if user is already connected if (currentAccount && connectionStatus === "connected") { // Call API to set auth cookie and redirect fetch("/api/auth/callback", { method: "POST", headers: { "Content-Type": "application/json", }, body: JSON.stringify({ address: currentAccount.address }), }) .then(() => { router.push("/feed") }) .catch((error) => { console.error("Failed to authenticate:", error) toast.error("Failed to authenticate") }) } }, [currentAccount, connectionStatus, router]) return (
Icebreaker Logo

ICEBREAKER

Welcome Back!

Sign in to continue your adventure.

Connect with Slush } />

Sign in with Slush to create or access your Sui wallet. First-time users will have a wallet created automatically.

Gamify Your Events

) } ``` ### app/quests/page.tsx ```typescript "use client" import { useIcebreaker } from "../providers" import { Button } from "@/components/ui/button" import { Camera, MessageSquare, Share2, Smile } from "lucide-react" import Link from "next/link" import { useState } from "react" import { PointsAnimation } from "@/components/points-animation" import { CyberNavigation } from "@/components/cyber-navigation" const quests = [ { id: "selfie", title: "Take a Selfie", description: "Snap a selfie at the event", icon: , points: 10, link: "/upload?type=photo&questId=selfie", }, { id: "hot-take", title: "Share a Hot Take", description: "Post your spicy opinion about the event", icon: , points: 15, link: "/upload?type=text&questId=hot-take", }, { id: "meme", title: "Create a Meme", description: "Make a meme about the event", icon: , points: 15, link: "/upload?type=meme&questId=meme", }, { id: "share", title: "Share with Friends", description: "Share your content with friends", icon: , points: 5, link: "/share?questId=share", }, ] export default function QuestsPage() { const { userData } = useIcebreaker() const [showAnimation, setShowAnimation] = useState(null) return (

QUESTS

{userData.points} POINTS

Complete these challenges to earn points!

{quests.map((quest) => { const isCompleted = userData.completedQuests.includes(quest.id) return (
{showAnimation === quest.id && }
{quest.icon}

{quest.title}

{quest.description}

{quest.points} POINTS
{isCompleted ? ( ) : ( )}
) })}
) } ``` ### app/feed/page.tsx ```typescript "use client" import Link from "next/link" import { useIcebreaker } from "../providers" import { Button } from "@/components/ui/button" import { Heart, MessageSquare, Share2 } from "lucide-react" import { useState } from "react" import { formatDistanceToNow } from "date-fns" import { CyberNavigation } from "@/components/cyber-navigation" export default function FeedPage() { const { userData } = useIcebreaker() const [likedPosts, setLikedPosts] = useState>({}) const handleLike = (id: string) => { setLikedPosts((prev) => ({ ...prev, [id]: !prev[id], })) } const renderMedia = (item: (typeof userData.media)[0]) => { if (item.type === "photo" || item.type === "meme") { return User content } if (item.type === "video") { return