Mint desk

A local website for the OpenSea mint bot. Same engine as the command-line sniper — generate wallets, watch the public sale, simulate, then arm a mint — with buttons instead of Terminal.

It only listens on 127.0.0.1. Do not put this on a public server. Private keys never leave your computer.

Works on Windows, macOS, and Linux.

---

What you need

• Node.js 20+
• For Simulate: Foundry (anvil)
• A little ETH on the drop’s chain (HoodBirds public is 0.001 ETH per wallet)

---

Start it

git clone https://github.com/reallyshadydev/opensea-mint-ui.git
cd opensea-mint-ui
npm install
npm run dev

Then open http://127.0.0.1:5173

The first launch copies .env.example to .env when you save settings or fetch a key.

Computer	How to open a terminal in the folder
Windows	Shift+right-click the folder → Open in Terminal
macOS	Right-click → New Terminal at Folder, or cd in Terminal
Linux	Open Terminal and cd into the folder

---

Using the page

1. Get OpenSea key — one click, saved to .env.
2. Settings — collection slug, contract, chain, RPC. Same fields as the CLI bot.
3. Generate — creates wallets in wallets.csv. Addresses show in the table; keys stay in the file.
4. Send 0.0012 ETH to each address (or use Preview fund / Fund live if you pasted a funding key).
5. Refresh until wallets say ready.
6. Simulate — forks the live chain and tries fake mints. No real money.
7. Dry-run snipe — waits for public open, does not send.
8. Arm live snipe — waits, then mints from every ready wallet.

Stop kills a running job.

---

How this uses the sniper bot

This repo depends on reallyshadydev/opensea-mint-bot. Status, wallet checks, and settings call that package directly. Simulate / fund / snipe run the same CLI (npx tsx src/index.ts …) with MINT_ROOT pointed at this folder, so .env and wallets.csv live here.

To point at a local checkout of the bot instead:

export BOT_DIR=/path/to/hoodbirds-mint-bot
npm run dev

---

Production-style local run

npm run build
npm start

Opens on http://127.0.0.1:4173 (still localhost only).

---

Safety

• wallets.csv and .env are gitignored. Do not upload them.
• Live snipe spends real ETH.
• If someone else can open http://127.0.0.1:5173 on your machine, they can trigger mints. Close the tab when you are done.