NFT Marketplace
In progressBlockchainDecentralized marketplace for trading NFTs with smart contract integration and wallet connectivity.
Role
Full-Stack Web3 Developer (Solo)
Status
In development
Category
Blockchain
Screenshots
Overview
A full-stack decentralized NFT marketplace built end-to-end. The system includes multiple Solidity smart contracts (an NFT collection factory, an ERC-721 collection contract, and a marketplace contract) deployed on the Sepolia testnet. Users can create collections, mint NFTs, list assets for fixed-price sale or auction, and interact with the marketplace through a wallet-connected React/Vite frontend. A custom Node.js/Express/MongoDB backend indexes contract events for fast querying, while NFT metadata and assets are stored on IPFS via Pinata.
The problem
Reading marketplace data straight from the blockchain is slow and awkward — you can't easily filter, sort, or search listings across collections by querying contracts alone.
The solution
An end-to-end marketplace with my own smart contracts for collections, minting, sales, and auctions, plus an off-chain indexer that listens to contract events and stores them in MongoDB, so the frontend can query listings instantly while the blockchain stays the source of truth.
What it does
Create collections
Users deploy their own ERC-721 collection from the dApp through a factory contract.
Mint, list & auction
Mint NFTs, list them for a fixed price or auction, and trade across collections.
Wallet connection
Connect with browser wallets or WalletConnect via Wagmi and Viem.
Decentralised storage
Images and metadata are pinned to IPFS via Pinata.
How it's built
- Three Solidity contracts (factory, ERC-721 collection, marketplace) developed and tested with Hardhat and deployed to Sepolia.
- React + Vite + TypeScript frontend using Ethers.js, Wagmi, and Viem for contract calls.
- Node.js + Express + MongoDB indexer that syncs contract events into queryable data.
- IPFS (Pinata) for NFT media and metadata.
Challenges & how I solved them
Fast queries on decentralised data
I built an event indexer that listens for contract events and writes them to MongoDB, giving the UI fast filtering and search without giving up on-chain ownership.
Key highlights
- Designed and implemented three Solidity contracts: collection factory, ERC-721 collection, and marketplace
- Enabled users to deploy new NFT collections directly from the dApp via the factory contract
- Implemented fixed-price listings, auctions, and cross-collection trading with role-based permissions
- Built a custom on-chain event indexer (Node.js + Express + MongoDB) to sync decentralized events with off-chain queries
- Integrated wallet connectivity using Hardhat, Ethers, WalletConnect, Wagmi, and Viem
- Stored NFT metadata and assets on IPFS via Pinata