• 💥 The Problem
• 💡 The Solution
• ✨ Key Features
• 🏗 Architecture & Tech Stack
• 🔥 How It Works (The Flow)
• 📜 Deployed Contracts
• 🛠 Getting Started
• 👥 Authors
• 📄 License

The music industry value chain is broken.

• Artists often give up 90% of their future revenue to labels just to get funded.
• Fans are the ones discovering talent, but they remain passive consumers.
• The Reality: With 12M+ artists on Spotify, less than 0.2% earn a living wage.

MelodyBond is a DeFi protocol that removes the intermediaries. It allows artists to raise capital directly from fans in exchange for equity in their future revenue.

It’s not just crowdfunding; it’s tokenized ownership.

• For Artists: Instant funding without predatory contracts.
• For Fans: Become the label. Vote on decisions and earn a share of the profits.

Every funded project automatically mints a Real-World Asset (RWA) NFT and deploys a unique RWAGovernor (DAO) contract. This ensures that governance is granular—investors only manage the specific songs they funded.

"DeFi is not everywhere if it costs gas." We implemented a custom VotingPaymaster using ERC-4337 (Pimlico).

• Gasless Investing: Users pay 0 ETH transaction fees.
• Gasless Voting: Governance participation is 100% free.

We utilize ERC-6551 to give every RWA NFT its own smart contract wallet (Treasury).

• The funds sit inside the NFT, not in a central pool.
• The DAO controls the NFT, and the NFT controls the funds.
• Enables automated, proportional profit distribution to all shareholders.

The system is built on a robust stack ensuring security and scalability.

• Frontend: Next.js 14, TypeScript, TailwindCSS
• Blockchain Interaction: viem, wagmi, Pimlico (Bundler/Paymaster)
• Smart Contracts: Solidity, Foundry
• Standards: ERC-721 (NFT), ERC-20 (GovToken), ERC-4337 (AA), ERC-6551 (TBA), OpenZeppelin Governor.

graph LR
    User((Fan)) -->|Invest USDC| DAO[Main DAO Contract]
    DAO -->|Finalize| Mint[Mint RWA NFT]
    
    subgraph "Per-Project Ecosystem"
    Mint --> NFT[RWA NFT]
    Mint --> Gov[RWAGovernor Clone]
    Mint --> TBA[Token Bound Account]
    
    NFT -.->|Owns| TBA
    Gov -.->|Controls| TBA
    end
    
    TBA -->|Distribute Revenue| Dist[Distributor Contract]
    Dist -->|Payout| User

Fans browse projects on the dashboard. They sign a transaction to invest USDC using our custom VotingPaymaster.

• User Action: Sign message (No ETH required).
• On-Chain: The Paymaster sponsors the gas, and the DAO records the user's contribution as Shares.

Once a project is fully funded, the DAO.sol triggers a single atomic transaction that establishes the entire governance structure:

1. Mints the RWA NFT: Represents the intellectual property on-chain.
2. Deploys the Governor: A clone of RWAGovernor.sol specific to this NFT.
3. Creates the TBA Treasury: An ERC-6551 Token Bound Account that belongs to the NFT.

Investors view their portfolio. Their Shares = Voting Power.

• Proposals: Investors can propose to change metadata (e.g., fix a typo), update artwork, or distribute revenue.
• Voting: Voting is weighted by shares and is also 100% gasless.

This is our proprietary profit distribution engine:

1. Revenue Accumulation: Streaming royalties (USDC) are sent to the NFT's TBA address.
2. Proposal: An investor proposes "Withdraw Funds".
3. Execution: Upon passing, the Governor instructs the TBA to approve the Distributor contract.
4. Distribution: The Distributor contract pulls the funds and automatically airdrops the exact proportional share to every single investor's wallet in one loop.

All contracts are deployed and verified on Sepolia Testnet.

To run the project locally, follow these steps.

• Node.js (v18 or higher)
• Foundry (Forge, Cast, Anvil)
• Git

git clone [https://github.com/MilanSazdov/Melody-Bond.git](https://github.com/MilanSazdov/Melody-Bond.git)
cd Melody-Bond

Navigate to the frontend directory and install dependencies:

cd frontend
npm install
# Create .env.local file with your Privy/Alchemy keys (see .env.example)
npm run dev

Create a .env.local file in the frontend/ directory. You can copy the structure below, which includes the live Sepolia contract addresses.
Note: You will need to provide your own API keys (Infura/Alchemy, Privy, Pimlico) and a Relayer Private Key (a wallet with some Sepolia ETH).

# RPC and API Configuration
# You can use Infura, Alchemy, or any other provider
NEXT_PUBLIC_RPC_URL=YOUR_SEPOLIA_URL
NEXT_PUBLIC_PRIVY_APP_ID=YOUR_PRIVY_API_KEY
ETHERSCAN_API_KEY=ETHERSCAN_API_KEY

# ERC-4337 Account Abstraction (Pimlico)
NEXT_PUBLIC_ENTRYPOINT=0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789
NEXT_PUBLIC_BUNDLER_URL=YOUR_BOUNDLER_URL
NEXT_PUBLIC_PIMLICO_API_KEY=YOUR_PIMLICO_API_KEY

# Deployed Contract Addresses (Sepolia)
NEXT_PUBLIC_DAO_ADDRESS=0x83300448E361038816368C9683D61dCF2d60954E
NEXT_PUBLIC_GOVTOKEN_ADDRESS=0xD546E8a7f37dB24dE9B637cb79B10f1c5885A51d
NEXT_PUBLIC_TIMELOCK_ADDRESS=0x5F42C1C914F671394478646740Bd6d59b4F86Ce5
NEXT_PUBLIC_RWA_NFT_ADDRESS=0xAC2935e31C097eFB7Ea20A64163751FFD5870860
NEXT_PUBLIC_RWAGOVERNOR_LOGIC_ADDRESS=0xc1328380074Dc46e35F3A8bb577Fba43b450d03b
NEXT_PUBLIC_DISTRIBUTOR_ADDRESS=0x679fddD3Ce087B15645D8fCb840AaE99a4aE9615
NEXT_PUBLIC_VOTING_PAYMASTER_ADDRESS=0x3207EEcBE70f58C3b553b683Aa3827B216f88314
NEXT_PUBLIC_DAO_TREASURY_ADDRESS=0xf7bB047581E3B6FD5B2c744a533Abd1846ED09Ee

# Backend Relayer (Must have Sepolia ETH)
RELAYER_PRIVATE_KEY=YOUR_RELAYER_PK

# Testnet Token Addresses
NEXT_PUBLIC_USDC_ADDRESS=0x832144D002bB8F32AbDCc576Aaaa8c2F3a3B1c95
NEXT_PUBLIC_ERC6551_REGISTRY_ADDRESS=0x000000006551c19487814612e58FE06813775758

# Chain Configuration
NEXT_PUBLIC_CHAIN_ID=11155111
NEXT_PUBLIC_CHAIN_NAME=Sepolia
# Tip: set to the block where DAO was deployed to speed up logs. Keep 0 if unsure.
NEXT_PUBLIC_DEPLOY_BLOCK=9630914

Run the development server:

npm run dev

Open http://localhost:3000 with your browser.

Navigate to the backend directory:

cd backend
forge install
forge build

To run tests:

forge test

Project developed by:

• Lazar Sazdov - LinkedIn | Email
• Milan Sazdov - LinkedIn | Email

All Rights Reserved.

This project is proprietary software. The code, design, and concepts within this repository are the exclusive property of the authors. Unauthorized copying, modification, distribution, or use of this software is strictly prohibited.

See the LICENSE file for details.