LuxuryAuthNFT

💎 LuxuryAuthNFT is a decentralized luxury authentication and ownership verification ecosystem that bridges real-world luxury goods with blockchain technology. Each physical item — whether a designer bag, watch, or sneaker — is paired with a unique Ethereum NFT certificate, ensuring tamper-proof authenticity, transparent provenance, and secure digital ownership.

Built using Solidity, Foundry, and a modern Next.js + TailwindCSS frontend, LuxuryAuthNFT empowers verified brands to mint NFTs for genuine products, while customers can effortlessly validate authenticity by scanning a QR code or entering a product hash. Every NFT stores immutable metadata on IPFS, linking the item’s details, images, and minting brand on-chain.

The platform features an admin dashboard for brand verification, a minting portal for authenticated product issuance, a public verification page for anyone to check legitimacy, and a My NFTs view for collectors or owners. Designed with security, transparency, and elegance in mind, LuxuryAuthNFT creates a trust layer for the luxury industry — combating counterfeits and redefining product authenticity in the Web3 era.

🧠 How We Built LuxuryAuthNFT — The Technical Deep Dive

LuxuryAuthNFT was built as a full-stack Web3 project that connects physical luxury goods to on-chain NFT certificates of authenticity. The project combines Solidity, Foundry, Next.js, and IPFS, with a focus on simplicity, security, and elegant user experience.

🔐 Smart Contracts (Authentication Core)

Written in Solidity 0.8.x, using OpenZeppelin’s ERC721URIStorage and Ownable for safe and modular design.

A verified brand system is implemented using a mapping(address => bool) to restrict minting privileges.

mintProduct() automatically links each product hash to a new NFT and emits a ProductMinted event for easy tracking.

verifyProduct() allows public verification of product authenticity, returning brand and ownership data.

Contracts were deployed via Foundry’s Forge scripts using Infura Sepolia RPC and verified on Etherscan.

🧱 DevOps & Tooling

Foundry handled compilation, testing, and deployments (forge test, forge script).

Broadcast JSON files store deployed addresses for smooth reuse across scripts.

.env variables manage RPC URLs, private keys, and API keys for a secure workflow.

A custom Makefile simplifies routine commands like make deploy, make mint, and make verify.

🌐 Frontend (Web3 Interface)

Built with Next.js 16 (App Router) and TailwindCSS for a polished, modern UI.

Ethers.js v6 powers contract interactions, reading token data, minting NFTs, and checking authenticity.

Integrated WalletConnect and MetaMask for user wallet management.

A QR scanner (via react-qr-reader) lets users verify physical products instantly by scanning their unique codes.

🗂 Storage & Metadata

NFT metadata and media are stored on IPFS via Pinata or NFT.Storage, generating permanent content URIs.

Metadata JSON includes product hash, brand, image, verification status, and mint date.

Smart contracts expose these URIs through the tokenURI() function, enabling frontend data retrieval.

📊 Partner Technologies & Integrations

Infura → Stable RPC for deployment and read/write operations.

Etherscan API → Enabled verified smart contract publishing directly via Foundry.

OpenZeppelin → Provided secure, audited token standards.

IPFS (Pinata/NFT.Storage) → Guaranteed metadata persistence and decentralization.

⚙️ Hacky / Innovative Details

Implemented a JSON-based deployment tracker (stdJson) to automatically fetch the latest deployed contract for interactions.

Created an on-chain brand whitelist system to manage verified minting privileges — no off-chain DB required.

QR codes generated at mint time link directly to /verify/<hash> pages.

Added lightweight local caching in the verification flow to reduce RPC rate-limit errors during testing.

🧑‍💻 Personal Note

This is my first-ever hackathon project, created as part of my ongoing journey into Web3 development. I’m still in the learning phase, exploring Solidity, Foundry, and full-stack blockchain engineering. While the project is functional, I know there’s still huge room for improvement — like automating IPFS uploads, optimizing contract gas efficiency, and refining the brand dashboard.

I also used AI tools for minor troubleshooting and documentation polishing, which helped me debug faster and stay focused on learning the core concepts myself.

Building LuxuryAuthNFT taught me a lot about smart contracts, decentralized storage, Web3 tooling, and real-world blockchain usability. It’s been an incredibly rewarding experience — both as a learning milestone and as a step toward building transparent, trustworthy luxury authentication in the Web3 space.