Idara Etim
Back to work

NFT Marketplace

In progressBlockchain

Decentralized 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

Tech stack

ReactTypeScriptTailwind CSSSolidityHardhatEthers.jsWagmiViemNode.jsExpressMongoDBIPFS / Pinata