🎨 Mood NFT - Transform Your Emotions Into Art

Generate AI-powered artwork from your mood descriptions and mint them as unique NFTs on the Arbitrum network.

🐛 Challenge: Fix the Bugs!

This project contains 5 intentional bugs for learning purposes. Your task is to find and fix them all to make the app work!

Hints

#	Hint	Difficulty
1	Check if the AI model name actually exists	🟢 Easy
2	Look at URLs character by character... something looks Cyrillic 👀	🔴 Hard
3	JavaScript is case-sensitive. Check function names match the contract	🟡 Medium
4	Config file path has a typo	🟢 Easy
5	Solidity functions that only read data need a special keyword	🟡 Medium

Error Messages You'll See

❌ Image generation failed: Invalid model
❌ Failed to upload to IPFS: Network error
❌ Minting failed: Function not found
❌ Configuration validation failed
⚠️ Contract compilation warning

Good luck! 🍀

---

✨ Features

• 🎨 AI Image Generation: Uses DALL-E 3 to create stunning artwork from your mood descriptions
• 🔗 IPFS Storage: Decentralized storage via Pinata for images and metadata
• ⛓️ Arbitrum Network: Low gas fees and fast transactions on Ethereum L2
• 📱 Interactive CLI: User-friendly command-line interface
• 🔐 ERC-721 Standard: Fully compliant NFT smart contract

📋 Prerequisites

• Node.js 18+
• An Ethereum wallet with some ETH on Arbitrum (or Arbitrum Sepolia for testing)
• API keys for:
  • OpenAI - for DALL-E image generation
  • Pinata - for IPFS storage

🚀 Quick Start

1. Clone and Install

git clone <your-repo>
cd mood-nft-arbitrum
npm install

2. Configure Environment

Copy the example environment file and fill in your credentials:

# Windows
copy config.env.example config.env

# Mac/Linux
cp config.env.example config.env

Edit config.env with your settings:

# Your wallet private key (without 0x prefix)
PRIVATE_KEY=your_private_key_here

# OpenAI API key
OPENAI_API_KEY=sk-your-openai-key

# Pinata credentials
PINATA_API_KEY=your_pinata_key
PINATA_SECRET_KEY=your_pinata_secret

# Contract address (after deployment)
CONTRACT_ADDRESS=your_contract_address

3. Compile the Smart Contract

npm run compile

4. Deploy the Contract

For testnet (Arbitrum Sepolia):

npm run deploy:sepolia

For mainnet (Arbitrum One):

npm run deploy

After deployment, copy the contract address to your .env file.

5. Create Your First Mood NFT

npm run mint

🎮 Usage

Run the interactive CLI:

npm run mint

Available Actions:

1. 🎨 Create new Mood NFT - Describe your mood and generate unique artwork
2. 📊 View my NFTs - See all your minted Mood NFTs
3. 💰 Check wallet balance - View your ETH balance and current gas prices
4. 🚪 Exit - Close the application

Example Mood Descriptions:

• "Peaceful Sunday morning with coffee, watching rain through the window"
• "Excited about new possibilities, like the first day of spring"
• "Nostalgic memories of childhood summers at the beach"
• "Focused determination, pushing through challenges"

📁 Project Structure

mood-nft-arbitrum/
├── contracts/
│   └── MoodNFT.sol          # ERC-721 NFT smart contract
├── scripts/
│   └── deploy.js            # Deployment script
├── src/
│   ├── index.js             # Main CLI application
│   └── services/
│       ├── imageGenerator.js # DALL-E image generation
│       ├── ipfsUploader.js   # Pinata IPFS upload
│       └── nftMinter.js      # Blockchain interactions
├── test/
│   └── MoodNFT.test.cjs     # Contract tests
├── generated_images/         # Locally saved images
├── hardhat.config.cjs        # Hardhat configuration
├── package.json
└── README.md

🧪 Running Tests

npm test

🌐 Networks

Arbitrum Sepolia (Testnet)

• Chain ID: 421614
• RPC: https://sepolia-rollup.arbitrum.io/rpc
• Explorer: https://sepolia.arbiscan.io
• Faucet: https://faucet.quicknode.com/arbitrum/sepolia

Arbitrum One (Mainnet)

• Chain ID: 42161
• RPC: https://arb1.arbitrum.io/rpc
• Explorer: https://arbiscan.io

💡 Getting Test ETH

1. Get Sepolia ETH from a faucet:

   • https://sepoliafaucet.com/
   • https://faucet.quicknode.com/ethereum/sepolia

2. Bridge to Arbitrum Sepolia:

   • https://bridge.arbitrum.io/

Or use the Arbitrum Sepolia faucet directly:

• https://faucet.quicknode.com/arbitrum/sepolia

🔧 Troubleshooting

"Contract artifact not found"

Run npm run compile to compile the smart contract.

"Insufficient funds"

Make sure your wallet has enough ETH on the selected network.

"OPENAI_API_KEY is not set"

Check that your .env file contains valid API keys.

Image generation fails

• Check your OpenAI API key
• Ensure you have API credits
• Try simplifying your mood description

📄 Smart Contract

The MoodNFT contract is an ERC-721 compliant NFT with additional features:

• mintMoodNFT: Mint a new NFT with mood description and metadata URI
• getMood: Get the mood description for any token
• getMintTimestamp: Get when a token was minted
• getTokensByOwner: Get all tokens owned by an address
• getTotalMinted: Get total number of NFTs minted

🔗 Useful Links

• Arbitrum Documentation
• OpenAI DALL-E API
• Pinata Documentation
• OpenZeppelin Contracts
• Hardhat Documentation

⚠️ Security Notice

• NEVER share your private key
• NEVER commit your .env file to git
• Use a dedicated wallet for testing
• Start with testnet before using mainnet

📜 License

MIT License - feel free to use this project for learning and personal use!

---

Made with ❤️ for the Web3 community