ArtisanFlow: Tokenized Royalty Protocol ArtisanFlow is a decentralized platform that empowers local artisans by tokenizing their physical creations. By leveraging blockchain technology, we ensure that creators receive automated royalties every time their work is resold, solving the issue of secondary market exploitation.
🚀 The Problem Traditional artisans often sell their work once and never benefit from its increasing value in the secondary market. Current royalty systems are manual, opaque, and easily bypassed.
💡 Our Solution We use a Token-Based Royalty Protocol where each physical product is linked to a unique digital asset (NFT/Token).
Provenance: A permanent record of the artisan's authorship.
Smart Royalties: A coded agreement that automatically triggers a % payout to the artisan's wallet upon every secondary sale.
Transparency: All transactions are verifiable on-chain.
🛠 Tech Stack Blockchain: Ethereum / Polygon / Google Cloud Blockchain Node
Smart Contracts: Solidity (ERC-721 / ERC-2981 for Royalties)
Frontend: React.js / Next.js
Backend/Database: Firebase / Google Cloud Functions
Storage: IPFS (for metadata)
🏗 Project Architecture Code snippet graph TD A[Artisan Mints Product] --> B(Smart Contract + Metadata) B --> C{Secondary Sale?} C -- Yes --> D[Transfer Ownership] D --> E[Deduct Royalty %] E --> F[Payment to Artisan Wallet] E --> G[Remainder to Seller] C -- No --> H[Owner Retains Asset] 📖 Key Features On-Chain Royalty Standard: Implements ERC-2981 to ensure cross-marketplace royalty compatibility.
Artisan Dashboard: Track earnings, total sales, and active tokens in real-time.
QR-Code Integration: Physical products include a QR code that links directly to the digital proof of authenticity.
🏁 Getting Started Prerequisites Node.js v18+
Metamask Wallet
Hardhat / Foundry (for contract testing)
Installation Clone the repository:
Bash git clone https://github.com/robot1508/artisan-royalty-project.git Install dependencies:
Bash npm install Setup Environment Variables: Create a .env file and add your RPC URL and Private Key:
Code snippet RPC_URL=your_google_cloud_node_url PRIVATE_KEY=your_wallet_private_key Deploy Smart Contracts:
Bash npx hardhat run scripts/deploy.js --network mumbai 🤝 Contributing Contributions are welcome! If you find a bug or have a feature request, please open an issue or submit a PR.
Tip: If you're looking for a quick contribution, check our documentation for typos!
📜 License Distributed under the MIT License. See LICENSE for more information.