Skip to content

oumaoumag/artcrate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

196 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎨 ArtCrate - NFT Platform with Creator Rewards

A Decentralized NFT platform built on Lisk Sepolia where creators earn tokens when users mint their NFTs. Built with modern Web3 technologies and best practices.

🚀 Live Deployment

Frontend: https://artcrate-frontend-5ek5.vercel.app/

Smart Contract: 0xC11a4C0bbC828173FB39909C0E81e9251b07B880 Smart Contract-v1 0x8BFadD14aA52762CE38DAaeA3538Dcadf126d4D8

Network: Lisk Sepolia Testnet

Explorer: View Contract


🚀 Features

  • ERC721 NFT Collection Mint NFTs with metadata and assign creator attribution.

  • 💰 ERC20 Token Rewards Creators earn a fixed amount of tokens for every NFT minted by others.

  • 🌐 IPFS Integration Metadata and images are stored on IPFS using Pinata or NFT.Storage.

  • 👛 Web3 Wallet Support Connect MetaMask and interact with smart contracts directly from the UI.

  • 🖼️ NFT Gallery Browse all minted NFTs with creator addresses and token IDs.

  • 📊 Reward Dashboard Track token balances and minting events in real time.


🧱 Smart Contracts

ArtNFT.sol

  • ERC721-compatible NFT contract.
  • Public minting with metadata URI.
  • Tracks original creator of each NFT.
  • Emits NFTMinted event on mint.
  • Calls rewardCreator() from ERC20 token.

CreatorToken.sol

  • ERC20-compatible token.
  • Minted internally by the contract to reward creators.
  • Functions: rewardCreator, balanceOf, transfer, approve, transferFrom, allowance.

🖥 Frontend

Built with React + ethers.js:

  • Connect to MetaMask
  • Upload image & metadata to IPFS
  • Mint NFTs and get confirmation
  • Display token balance and mint logs
  • Browse NFT gallery with metadata and creator info

🛠️ Getting Started

Prerequisites

  • Node.js (v16+)
  • MetaMask wallet
  • Lisk Sepolia testnet account
  • IPFS key for Pinata or NFT.Storage

Clone the Repository

git clone https://github.com/oumaoumag/artcrate.git
cd artcrate

Install Dependencies

# Install smart contract tools
cd contracts
forge install

# Compile & deploy contracts (using Foundry)
forge build
forge script scripts/deploy.js --rpc-url liskSepolia

# Install frontend
cd ../frontend
npm install

Run the App

npm start

📄 License

MIT License. See LICENSE file for details.


🤝 Contributing

Pull requests are welcome! For major changes, open an issue first to discuss what you'd like to change or add.

About

ArtCrate is a decentralized application (dApp) where users can mint and collect unique digital artworks as NFTs. Every time an NFT is minted, the original creator earns ERC20 token rewards automatically. Built on Solidity and React, ArtCrate combines the power of blockchain, creator incentives, and a seamless Web3 experience.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors