Metadata-Version: 2.4
Name: alphatrack
Version: 0.1.0
Summary: AlphaTrack open-source local toolkit — NFT drop eligibility checkers (keys stay on your machine)
Author: AlphaTrack
License: MIT
Project-URL: Homepage, https://alphatrack.xyz/
Project-URL: Documentation, https://github.com/alphatrack/alphatrack
Keywords: alphatrack,opensea,eligibility,nft,presale
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
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
Requires-Dist: PyYAML>=6.0
Provides-Extra: dev
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Dynamic: license-file

# AlphaTrack

Open-source **local** toolkit for NFT drop eligibility checks.

Private keys stay on your machine. This repo is separate from the hosted AlphaTrack platform.

## Install

```bash
# from PyPI (once published)
pip install alphatrack

# or from this folder
pip install -e .
```

## Quick start

```bash
cp wallets.example.txt wallets.txt
# add burner private keys to wallets.txt

cp config.example.yaml config.yaml
# edit `checks:` — one block per platform, many collections each

cp .env.example .env
# optional: set ALCHEMY_API_KEY for balance checks

alphatrack platforms

# run every platform/collection block in config.yaml
alphatrack check

# or pass collections on the CLI (single platform per invocation)
alphatrack check -p opensea -c your-collection-slug -c another-slug
alphatrack check -c https://opensea.io/collection/your-collection/overview --balances
```

Example `config.yaml` with multiple platforms:

```yaml
wallets: wallets.txt
balances: false
checks:
  - platform: opensea
    collections:
      - deadmood-42226579
      - the-gh0sts
  - platform: launchmynft   # when adapter is available
    collections:
      - some-lmnft-slug
```

Or without installing the script entrypoint:

```bash
python -m alphatrack check
```

## What this does

1. Loads wallets from a local file
2. Signs in to the marketplace locally (OpenSea SIWE today)
3. Reports which wallets are eligible for which mint stages
4. Optionally checks whether eligible wallets can afford the mint (Alchemy)

It does **not** mint, submit transactions, or upload private keys to AlphaTrack servers.

## Supported platforms

| Platform | Status |
|----------|--------|
| OpenSea  | ✅ v0.1 |
| LaunchMyNFT | planned |
| Transient | planned |

## Security

- Use **burner wallets** when possible
- Never commit `wallets.txt` or `.env`
- Network calls go to the marketplace (and optionally Alchemy) — not to AlphaTrack
- v1 only signs SIWE login messages, not mint transactions

## License

MIT
