🏆 Hackathon Submission for DCL Regenesis Labs Vibe Coding Hackathon
LoveLock Bridge brings the romantic tradition of love locks into the metaverse, creating an eternal testament to love on the blockchain. Couples can place virtual love locks on a beautiful bridge in Decentraland, with each lock minted as an NFT on Polygon. When they "throw away the key," the associated ERC20 tokens are burned, sealing their love forever on the immutable blockchain.
- 🔒 Dual-Token System: ERC721 NFT for the lock + ERC20 token for the key
- 💝 Emotional Experience: Beautiful visual effects, romantic atmosphere
- 📊 On-Chain Statistics: Real-time display of love metrics
- ♾️ Eternal Commitment: Burn mechanism makes love permanent
- 🎨 Customization: Multiple lock styles (Gold, Silver, Rose Gold, Crystal)
- Node.js v16+
- MetaMask wallet
- MATIC tokens for gas fees
- Decentraland SDK
# Clone the repository
git clone https://github.com/yourusername/lovelock-bridge.git
cd lovelock-bridge
# Install dependencies
npm install
# Set up environment variables
cp .env.example .env
# Edit .env with your private key and RPC URLs
# Compile smart contracts
npm run compile
# Deploy to Mumbai testnet
npm run deploy:mumbai
# Start Decentraland scene locally
npm run dcl:startgraph TB
A[Decentraland Scene] -->|Web3 Provider| B[Smart Contracts]
B --> C[LoveLockNFT - ERC721]
B --> D[LoveLockToken - ERC20]
C -->|Mint| E[Love Lock NFT]
D -->|Mint| F[Key Token]
D -->|Burn| G[0x000...dead]
A -->|IPFS| H[Metadata Storage]
A -->|UI| I[React Components]
| Component | Technology |
|---|---|
| Blockchain | Polygon (MATIC) |
| Smart Contracts | Solidity 0.8.19 |
| Token Standards | ERC721 + ERC20 |
| Metaverse Platform | Decentraland SDK 7 |
| Frontend | TypeScript, React-ECS |
| Storage | IPFS (Pinata) |
| Development | Hardhat, Ethers.js |
| Testing | Chai, Waffle |
- Represents the love lock on the bridge
- Stores couples' names, messages, and dates
- Tracks key status (thrown/not thrown)
- Represents the key to the lock
- 1:1 ratio with NFT (1 token per lock)
- Burned to 0x000...dead when thrown away
Deployed Contracts (Polygon Mumbai)
- LoveLockNFT:
0x...View on Polygonscan - LoveLockToken:
0x...View on Polygonscan
- Connect Wallet → MetaMask connection
- Create Lock → Input names & message → Mint NFT + Token
- Place on Bridge → Visual representation appears
- Throw Key (Optional) → Burn token → Eternal commitment
- View Stats → See total locks and eternal loves
- 🌅 Sunset lighting for romantic atmosphere
- ✨ Particle effects when placing locks
- 💕 Heart animations when throwing keys
- 🎵 Romantic background music
- 🎊 Special effects for milestones
- 🏆 Achievement system for milestones
- 📊 Leaderboard for most romantic couples
- 🎁 Special editions for holidays (Valentine's, Anniversary)
- 🌟 Rare lock designs for special token IDs
- Digital Permanence: Creating lasting digital memories in virtual worlds
- Emotional Connection: Bridging traditional romance with Web3
- Accessibility: Global access to romantic traditions
- Dual-token mechanism for interactive storytelling
- Burn-to-commit model for permanent decisions
- Metaverse-blockchain integration for immersive experience
- On-chain emotions - storing feelings permanently
- Phase 1 - Launch on Polygon Mainnet
- Phase 2 - AR mobile app for real-world viewing
- Phase 3 - Cross-metaverse compatibility
- Phase 4 - Virtual wedding ceremonies
- Phase 5 - Anniversary reminders & rewards
| Role | Name | X |
|---|---|---|
| Lead AI-supported Developer | Yudai | @x |
| Product Manager | Yuki | @x |
- Fully functional smart contracts deployed on testnet
- Interactive Decentraland scene
- Web3 integration with MetaMask
- IPFS metadata storage
- Novel dual-token system
- Permanent commitment mechanism
- Emotional blockchain use case
- Intuitive UI/UX
- Beautiful visual effects
- Emotional storytelling
- Clear monetization model (fees on special editions)
- Partnership opportunities (wedding planners, dating apps)
- Scalable to other metaverses
- 🎥 Demo Video - 3-minute walkthrough
- 🎮 Live Scene - Try it yourself!
- 📊 Presentation Slides - Pitch deck
- 📝 Technical Documentation - Deep dive
- 🖼️ Screenshots - Visual gallery
MIT License - see LICENSE file
We welcome contributions! Please see our Contributing Guidelines
Built with ❤️ for LoveLock Bridge 2025
Love is forever, especially on the blockchain