# Stones Database

A database application for collecting Ethereum addresses and contact information for the Farcastle $Stones token launch.

## Project Overview

This application provides:
- A database to store Ethereum addresses, ENS names, and contact information
- Data collection scripts to gather information from various sources (NFT holders, ERC20 holders, Moloch DAO members)
- A web interface for accessing and managing the database at stones.boilerhaus.org

## Tech Stack

- **Backend**: Node.js with Express
- **Frontend**: Next.js with App Router, React, Shadcn UI, and Tailwind CSS
- **Database**: PostgreSQL
- **Data Collection**: Python scripts for blockchain data scraping
- **Deployment**: Docker for containerization

## Project Structure

```
/
├── src/                      # Source code
│   ├── app/                  # Next.js app router pages
│   ├── components/           # React components
│   ├── lib/                  # Shared utilities
│   └── server/               # Server-side code
├── scripts/                  # Python scripts for data collection
│   ├── nft_holders/          # Scripts to collect NFT holder data
│   ├── erc20_holders/        # Scripts to collect ERC20 token holder data
│   ├── moloch_dao/           # Scripts to collect Moloch DAO member data
│   └── utils/                # Shared utilities for scripts
├── prisma/                   # Database schema and migrations
├── public/                   # Static assets
└── docker/                   # Docker configuration
```

## Getting Started

1. Clone the repository
2. Install dependencies: `npm install`
3. Set up environment variables
4. Run the development server: `npm run dev`
5. Access the application at http://localhost:3000

## Data Collection

The application includes various Python scripts to collect data from:
- NFT holders
- ERC20 token holders
- Moloch DAO members (Raid Guild, DAOhaus, Metacartel)
- ENS resolution for contact information

## Deployment

The application is deployed at stones.boilerhaus.org