{"id":50745550,"url":"https://github.com/edycutjong/trewrap","last_synced_at":"2026-06-10T20:30:38.464Z","repository":{"id":356707040,"uuid":"1233737430","full_name":"edycutjong/trewrap","owner":"edycutjong","description":"Spotify Wrapped for crypto wallets. 5 Dune SQL signals → AI persona → shareable card.","archived":false,"fork":false,"pushed_at":"2026-05-09T11:32:03.000Z","size":4445,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-09T11:39:25.365Z","etag":null,"topics":["dune-analytics","nextjs","openai","react","tailwind","typescript","web3"],"latest_commit_sha":null,"homepage":"https://trewrap.edycu.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/edycutjong.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-09T09:45:21.000Z","updated_at":"2026-05-09T11:32:06.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/edycutjong/trewrap","commit_stats":null,"previous_names":["edycutjong/trewrap"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/edycutjong/trewrap","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edycutjong%2Ftrewrap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edycutjong%2Ftrewrap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edycutjong%2Ftrewrap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edycutjong%2Ftrewrap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/edycutjong","download_url":"https://codeload.github.com/edycutjong/trewrap/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edycutjong%2Ftrewrap/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34170162,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dune-analytics","nextjs","openai","react","tailwind","typescript","web3"],"created_at":"2026-06-10T20:30:36.267Z","updated_at":"2026-06-10T20:30:38.456Z","avatar_url":"https://github.com/edycutjong.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003eTrewrap 🚀\u003c/h1\u003e\n  \u003cp\u003e\u003cem\u003eSpotify Wrapped for crypto wallets. Live Dune SIM signals → AI persona → shareable card.\u003c/em\u003e\u003c/p\u003e\n  \u003cimg src=\"docs/readme-hero.png\" alt=\"Trewrap Hero\" width=\"100%\"\u003e\n  \n  \u003cbr/\u003e\n  \n  [![Live Demo](https://img.shields.io/badge/Live-Demo-brightgreen.svg?style=for-the-badge)](https://trewrap.edycu.dev)\n  [![Pitch Deck](https://img.shields.io/badge/Pitch-Deck-f59e0b.svg?style=for-the-badge)](https://trewrap.edycu.dev/pitch)\n  [![Pitch Video](https://img.shields.io/badge/Pitch-Video-red.svg?style=for-the-badge)](https://youtu.be/ftu2OR3uU0o)\n  [![Superteam Frontier](https://img.shields.io/badge/Superteam-Frontier_Hackathon-1E40AF?style=for-the-badge\u0026logo=solana\u0026logoColor=white)](https://superteam.fun/earn/listing/dune-analytics-x-superteam-earn-or-frontier-data-sidetrack)\n\n  \u003cbr/\u003e\n\n  ![Next.js](https://img.shields.io/badge/Next.js-000000?style=flat\u0026logo=next.js\u0026logoColor=white)\n  ![React](https://img.shields.io/badge/React-20232A?style=flat\u0026logo=react\u0026logoColor=61DAFB)\n  ![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-38B2AC?style=flat\u0026logo=tailwind-css\u0026logoColor=white)\n  ![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=flat\u0026logo=typescript\u0026logoColor=white)\n  ![Dune SIM](https://img.shields.io/badge/Dune_SIM-000000?style=flat\u0026logo=dune\u0026logoColor=white)\n  [![Trewrap CI](https://github.com/edycutjong/trewrap/actions/workflows/ci.yml/badge.svg)](https://github.com/edycutjong/trewrap/actions/workflows/ci.yml)\n\u003c/div\u003e\n\n---\n\n## 📸 See it in Action\n*(Demo GIF and UI screenshots can be found in the `public` directory)*\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"public/og-image.png\" alt=\"App Demo\" width=\"100%\"\u003e\n\u003c/div\u003e\n\n## 💡 The Problem \u0026 Solution\nWhile on-chain data is public, it's often too technical and dry for average users to engage with. \n**Trewrap** solves this by providing a Spotify Wrapped experience for crypto wallets. It queries the **Dune SIM API** (`api.sim.dune.com`) for real-time SVM balances and transactions to evaluate a user's on-chain behavior, generates a roasted AI persona, and delivers a shareable card.\n\n**Key Features:**\n- ⚡ **High Performance:** Real-time Solana wallet analysis via Dune SIM API (\u003c200ms).\n- 🔒 **Secure by Design:** Verifiable on-chain actions and robust data protection.\n- 🎨 **Intuitive UX:** Beautiful, user-centric interface built for scale.\n\n## 🏗️ Architecture \u0026 Tech Stack\n\n### Tech Stack\n| Component | Technology | Description |\n|-----------|------------|-------------|\n| **Frontend** | Next.js 16, React 19 | App Router, SSR, Server Components |\n| **Styling** | Tailwind CSS v4 | High-performance responsive UI |\n| **Language** | TypeScript | Strict type safety across the stack |\n| **Data Source** | Dune SIM API | Real-time SVM balances \u0026 transactions via `api.sim.dune.com` |\n| **AI Engine** | Algorithmic | Rule-based persona classifier driven by on-chain behavioral signals |\n| **Testing** | Vitest | Comprehensive unit and component testing |\n\nFor a detailed breakdown of our system architecture and data flow, please refer to the [Architecture Document](docs/ARCHITECTURE.md).\n\n## 🏆 Sponsor Tracks Targeted\n* **Dune SIM API Integration**: We use the Dune SIM API (`/beta/svm/balances` and `/beta/svm/transactions`) to fetch real-time Solana wallet data — portfolio value, token diversity, and transaction history.\n* **Frontend Infrastructure**: We deployed our high-performance edge application using Vercel. \n\n## 🚀 Run it Locally (For Judges)\n\n1. **Clone the repo:** `git clone https://github.com/edycutjong/trewrap.git`\n2. **Install dependencies:** `npm install`\n3. **Set up environment variables:**\n   ```bash\n   cp .env.example .env.local\n   ```\n   Then add your **Dune SIM API key**:\n   ```env\n   SIM_API_KEY=your_sim_api_key_here\n   ```\n   \u003e Get your SIM API key at **[sim.dune.com](https://sim.dune.com)** → Sign in → API Keys.\n4. **Run the app:** `npm run dev`\n\n\u003e **Note for Judges:**\n\u003e You can skip setting up the API key! We have built-in fallback demo data that simulates the full Dune SIM response so you can test the flow instantly without any keys.\n\n---\n\n## 📄 License\n\nThis project is licensed under the [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedycutjong%2Ftrewrap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fedycutjong%2Ftrewrap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedycutjong%2Ftrewrap/lists"}