Docs / Getting Started / Install & Run

Install & Run

The web app is self-contained: the entire engine runs in your browser. There is nothing to install — open the app and the vault gate greets you.

The web app

No build step, no backend, no wallet extension:

  • Static hosting — the deployed site is the product.
  • The engine ships with the page as plain JS modules: JBCore (chain + Pons calldata), JBVault (the encrypted vault), JBFund (relay.link distribution), JBTerm (launch-day terminal).
  • ethers v6 is vendored under assets/js/vendor/ — no CDN, no npm.

The first run walks the Setup pipeline in order: seed phrase (shown once), wallet derivation, fund wallet 0, distribution window, relay distribution, launch.

Keep the tab open during the funding and auto-buy windows — execution happens in the page. If you close it, the funding plan is persisted and resumes where it stopped on the next open.

Optional: the standalone Python engine

Advanced users can still run the original engine from bundler/ — a CLI plus an optional local server. It is not required by the web app; the two share no state.

Requirements — Python 3.10+ and three packages:

pip install eth-account mnemonic pycryptodome

Generate the vault, then either drive the local server:

cd bundler
python3 wallets.py generate --count 25   # steps 1+2
python3 server.py                        # http://127.0.0.1:8787/app

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

Or skip the server entirely and use the terminal interface for direct control:

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

State

Everything the Python engine writes lives in bundler/out/:

FileContents
vault.jsonencrypted vault (seed + keys, AES-128-CTR)
addresses.csvderived bundle wallet addresses
funding-plan.jsonthe 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.

The browser engine keeps its own, separate state in the site's localStorage: the encrypted vault (jb:vault), the funding plan (jb:fundplan), and the terminal session (jb:term). Clearing site data is the browser equivalent of deleting out/ — same warning applies.