Metadata-Version: 2.4
Name: alphatrack-os-eligibility-checker
Version: 0.1.1
Summary: AlphaTrack OpenSea OS eligibility checker — private keys stay local
Author: AlphaTrack
License-Expression: MIT
Project-URL: Homepage, https://alphatrack.xyz/
Project-URL: Documentation, https://alphatrack.xyz/dashboard/os-eligibility-checker
Keywords: alphatrack,opensea,eligibility,nft,presale
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28.0
Requires-Dist: eth-account>=0.10.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: tqdm>=4.66.0

# AlphaTrack OS Eligibility Checker

Thin local client for OpenSea drop/presale eligibility.

**Private keys never leave your computer.** Signing happens locally. AlphaTrack only receives an auth token, wallet addresses, and SIWE signatures needed to check eligibility.

## Install

Use a virtual environment (pick one), then install the package.

**Option A — venv (built into Python, no conda needed):**

```bash
# If .venv already exists from an older folder name, remove it first:
# rm -rf .venv

python3 -m venv .venv
source .venv/bin/activate          # macOS / Linux
# .venv\Scripts\activate           # Windows
pip install alphatrack-os-eligibility-checker
```

**Option B — conda:**

```bash
conda create -n alphatrack-os-eligibility python=3.11 -y
conda activate alphatrack-os-eligibility
pip install alphatrack-os-eligibility-checker
```

Dependencies (`requests`, `eth-account`, `python-dotenv`, `tqdm`) install automatically with the package.

## Setup

1. Create a free [AlphaTrack](https://alphatrack.xyz/) account  
2. Open **Dashboard → OS Eligibility Checker** → **Generate token** → copy it  
3. In a working folder:

```bash
mkdir my-os-eligibility-check && cd my-os-eligibility-check
```

Create `.env`:

```
ALPHATRACK_TOKEN=at_your_token_here
# ALCHEMY_API_KEY=optional_for_balances
```

Create `wallets.txt` — one private key per line. Lines starting with `#` are group labels (shown in the summary next to eligible wallets). Keys never leave your computer.

```
# main
0xabc1111111111111111111111111111111111111111111111111111111111111

# burner1
0xabc2222222222222222222222222222222222222222222222222222222222222
0xabc3333333333333333333333333333333333333333333333333333333333333

# burner2
0xabc4444444444444444444444444444444444444444444444444444444444444

# account1
0xabc5555555555555555555555555555555555555555555555555555555555555
```

Replace the `0x…` values with your real private keys. You can use any group names you like (`main`, `burner1`, `farm`, etc.). Keys under a `#` label belong to that group until the next `#` line.

## Run

```bash
alphatrack-os-eligibility-checker -c todd-nft
# or
alphatrack-os-eligibility-checker -c https://opensea.io/collection/todd-nft/overview
# or
python -m alphatrack_os_eligibility_checker -c todd-nft
```

## What is sent to AlphaTrack

| Sent | Not sent |
|------|----------|
| API token | Private keys |
| Wallet address | Alchemy key |
| SIWE signature + message | Full wallets.txt |

## Staging / local API

```
ALPHATRACK_API_BASE=http://localhost:8888
```
