Install & Run

The engine is plain Python 3 — no build step, no containers.

Requirements

• Python 3.10+
• eth-account, mnemonic, pycryptodome

pip install eth-account mnemonic pycryptodome

Start

cd bundler
python3 server.py

Then open http://127.0.0.1:8787/app. The app detects the engine automatically — the sidebar shows ● engine live and the Setup pipeline becomes interactive.

The server binds to 127.0.0.1 only. It serves the same frontend as the public site plus the /api/* endpoints the engine drives.

First run

On first launch, the Setup view walks you through the pipeline in order. If you prefer the CLI, the same steps exist as scripts:

python3 wallets.py generate --count 25   # steps 1+2

The terminal interface is also available for direct control:

python3 pons_terminal.py                 # token / auto / holders / sell / dump

State

Everything the engine writes lives in bundler/out/:

File	Contents
vault.json	encrypted vault (seed + keys, AES-128-CTR)
addresses.csv	derived bundle wallet addresses
funding-plan.json	the distribution plan and per-transfer status

out/ is git-ignored and never deployed. Delete it to start completely fresh — the seed cannot be recovered afterwards.