# 🎧 SynthFlow

**SynthFlow** is a decentralized music platform that connects artists and fans through blockchain technology.  
Fans can **tip artists directly** and **earn rewards** for listening to their favorite tracks β€” creating a fair, transparent, and engaging ecosystem for music.

---

## 🌟 Inspiration

I’ve always been passionate about music and technology.  
As a pianist and composer, I’ve seen how many talented artists struggle to get fair compensation from traditional streaming platforms.  
The idea behind SynthFlow was to **build a space where artists and listeners share value directly**, using the transparency and ownership that Web3 provides.

> β€œIf Spotify pays fractions of a cent per stream, what if fans could send full cents directly β€” instantly and fairly?”

---

## πŸ› οΈ How I Built It

The project was developed using:

- **React + Tailwind CSS** for the front-end interface.  
- **Wallet authentication** via **Ready** and **Braavos**, enabling direct login with Starknet wallets.  
- A **prototype smart contract** written for tip transactions and reward distribution (currently simulated in sandbox mode).  
- **Mock backend services** to manage artist data, audio playback, and listener stats.  
- IPFS integration (planned) for decentralized music storage.

From a math perspective, the reward system uses a simple proportional distribution formula:

$$
R_i = \frac{T_i}{\sum_j T_j} \cdot P
$$

Where:  
- \( R_i \) = reward for listener *i*  
- \( T_i \) = total listening time of listener *i*  
- \( P \) = total reward pool for a given period  

This ensures rewards scale fairly with user engagement.

---

## πŸ’‘ What I Learned

Building SynthFlow taught me how to:

- Integrate **Web3 wallet connections** into a React app.  
- Design **user experiences around blockchain** interactions (without scaring users away).  
- Prototype smart contract logic while keeping UX smooth and intuitive.  
- Balance design, code, and storytelling in a limited timeframe.

It also deepened my understanding of how **decentralization can reshape creative industries**.

---

## βš”οΈ Challenges I Faced

- **Smart contract deployment:** connecting the on-chain logic to the frontend in time for the hackathon.  
- **Audio streaming with decentralized storage:** performance vs. decentralization trade-offs.  
- **User onboarding:** making wallet login easy for non-crypto users.  
- **Time constraints:** integrating UI, blockchain, and music assets within the hackathon deadline.

Despite these challenges, the core experience β€” tipping artists, wallet login, and playback β€” is functional in this MVP.

---

## πŸš€ What’s Next

- Deploying the smart contract to **Starknet testnet**.  
- Finalizing **on-chain reward distribution**.  
- Integrating **IPFS** for decentralized track storage.  
- Expanding artist profiles and community features.

---

## πŸ™Œ Conclusion

SynthFlow represents a vision of **music beyond platforms** β€” where creativity, ownership, and community come together.  
It’s not just a demo; it’s the first step toward a fairer, Web3-powered music ecosystem.

> *Music deserves transparency. Artists deserve freedom. Fans deserve rewards.*


Built With

  • cairo
  • react
  • starknet.js
  • tailwind
Share this project:

Updates