https://github.com/edycutjong/trewrap
Spotify Wrapped for crypto wallets. 5 Dune SQL signals → AI persona → shareable card.
https://github.com/edycutjong/trewrap
dune-analytics nextjs openai react tailwind typescript web3
Last synced: 8 days ago
JSON representation
Spotify Wrapped for crypto wallets. 5 Dune SQL signals → AI persona → shareable card.
- Host: GitHub
- URL: https://github.com/edycutjong/trewrap
- Owner: edycutjong
- License: mit
- Created: 2026-05-09T09:45:21.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-09T11:32:03.000Z (about 1 month ago)
- Last Synced: 2026-05-09T11:39:25.365Z (about 1 month ago)
- Topics: dune-analytics, nextjs, openai, react, tailwind, typescript, web3
- Language: TypeScript
- Homepage: https://trewrap.edycu.dev
- Size: 4.24 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
Trewrap 🚀
Spotify Wrapped for crypto wallets. Live Dune SIM signals → AI persona → shareable card.
[](https://trewrap.edycu.dev)
[](https://trewrap.edycu.dev/pitch)
[](https://youtu.be/ftu2OR3uU0o)
[](https://superteam.fun/earn/listing/dune-analytics-x-superteam-earn-or-frontier-data-sidetrack)
[](https://github.com/edycutjong/trewrap/actions/workflows/ci.yml)
---
## 📸 See it in Action
*(Demo GIF and UI screenshots can be found in the `public` directory)*
## 💡 The Problem & Solution
While on-chain data is public, it's often too technical and dry for average users to engage with.
**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.
**Key Features:**
- ⚡ **High Performance:** Real-time Solana wallet analysis via Dune SIM API (<200ms).
- 🔒 **Secure by Design:** Verifiable on-chain actions and robust data protection.
- 🎨 **Intuitive UX:** Beautiful, user-centric interface built for scale.
## 🏗️ Architecture & Tech Stack
### Tech Stack
| Component | Technology | Description |
|-----------|------------|-------------|
| **Frontend** | Next.js 16, React 19 | App Router, SSR, Server Components |
| **Styling** | Tailwind CSS v4 | High-performance responsive UI |
| **Language** | TypeScript | Strict type safety across the stack |
| **Data Source** | Dune SIM API | Real-time SVM balances & transactions via `api.sim.dune.com` |
| **AI Engine** | Algorithmic | Rule-based persona classifier driven by on-chain behavioral signals |
| **Testing** | Vitest | Comprehensive unit and component testing |
For a detailed breakdown of our system architecture and data flow, please refer to the [Architecture Document](docs/ARCHITECTURE.md).
## 🏆 Sponsor Tracks Targeted
* **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.
* **Frontend Infrastructure**: We deployed our high-performance edge application using Vercel.
## 🚀 Run it Locally (For Judges)
1. **Clone the repo:** `git clone https://github.com/edycutjong/trewrap.git`
2. **Install dependencies:** `npm install`
3. **Set up environment variables:**
```bash
cp .env.example .env.local
```
Then add your **Dune SIM API key**:
```env
SIM_API_KEY=your_sim_api_key_here
```
> Get your SIM API key at **[sim.dune.com](https://sim.dune.com)** → Sign in → API Keys.
4. **Run the app:** `npm run dev`
> **Note for Judges:**
> 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.
---
## 📄 License
This project is licensed under the [MIT License](LICENSE).