Metadata-Version: 2.4
Name: alphatrack-os-eligibility-checker
Version: 0.2.0
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 are never stored as plaintext.** You import each key once into an encrypted keystore (password-protected, same idea as MetaMask/geth). Signing happens on your machine; AlphaTrack only receives an auth token, wallet **addresses**, and SIWE **signatures**.

Prefer **burner wallets** with no (or minimal) funds for this tool.

## 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
# ALPHATRACK_KEYSTORE_PASSWORD=optional_for_noninteractive_runs
```

## Import wallets (encrypted)

Import each key once. Input is hidden; the key is encrypted to `./keystores/` and never written as plaintext.

```bash
alphatrack-os-eligibility-checker import-wallet --label main
alphatrack-os-eligibility-checker import-wallet --label burner1
alphatrack-os-eligibility-checker import-wallet --label burner2
alphatrack-os-eligibility-checker list-wallets
```

Use a **burner / delegate wallet** when you can — not your primary cold wallet.

## Run

You will be prompted for the keystore password (or set `ALPHATRACK_KEYSTORE_PASSWORD` for automation).

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

## What is sent to AlphaTrack

| Sent | Not sent |
|------|----------|
| API token | Private keys |
| Wallet address | Keystore passwords |
| SIWE signature + message | Encrypted keystore files |

## Staging / local API

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