# Igneum Miner for Mac (packaging/mac) A DMG a miner opens on an Apple silicon Mac: drag the app to Applications, open it, answer two questions, mine. Version 0.3.0 (4 October 2026) is the app: a branded window (no Terminal), the engine that runs the node and the miner, a menu-bar item, settings, an update check. 0.1.0 and 0.2.0 (3 and 4 October 2026) were the Terminal launchers; the 0.2.0 run script's command lines live on inside the engine (`app/igneum-app/src/engine.rs`). ## Build packaging/mac/build-dmg.sh Output: `packaging/mac/dist/Igneum-Miner-0.3.0.dmg` (about 20 MB, lzfse). The script compiles the engine (`app/igneum-app`, `cargo build --release`, nice 19 and 4 jobs because the devnet mines on this Mac), the window (`app/mac/IgneumMiner.swift`, `swiftc -target arm64-apple-macos11`) and the Metal worker (`proto-metal/main.swift`, same target), takes `igneumd` and `igneum-miner` from `vendor/igneum-node/target-integration/release` (the devnet-v4 integration build; `NODE=`, `MINER=`, `WORKER=`, `ENGINE=` override), strips and ad-hoc signs the copies, checks each one runs, writes `igneum-app.json` (below) and lays the image out with `dmgbuild` (`pip3 install dmgbuild`; without it a plain hdiutil image). The app icon is `brand/icons/igneum.icns` (the master mark, a plain black square), the volume icon `brand/icons/igneum-volume.icns` (its rounded variant), the DMG art `brand/icons/dmg-background.tiff` (`python3 brand/icons/make-icons.py`). `build/` and `dist/` are ignored by git. ## The bundle Igneum Miner.app/Contents/MacOS/Igneum Miner the window: WKWebView + NSStatusItem (app/mac/IgneumMiner.swift) Igneum Miner.app/Contents/MacOS/igneum-app the engine (app/igneum-app) Igneum Miner.app/Contents/Resources/bin/igneumd, igneum-miner, igneum-bench Igneum Miner.app/Contents/Resources/igneum-app.json packaged configuration (packaged-config.sh writes it) Igneum Miner.app/Contents/Resources/igneum.icns Igneum Miner.app/Contents/Info.plist app/Info.plist (CFBundleVersion = build stamp, LSMinimumSystemVersion 11.0) The window starts `igneum-app --wrapper`, reads `URL ...` and `STATE {...}` lines from its stdout, shows the URL in the web view and keeps the menu-bar title (hash rate, paused, syncing). Quit writes `quit` to the engine's stdin and waits for `EXIT` (up to 45 s): the miners stop first (8 s grace), then the node (30 s), then the last log upload. Closing the window hides it; the app lives on in the menu bar and the Dock. The engine serves the dashboard on `127.0.0.1:/t/<32-hex token>/`; nothing without the token answers. Links off 127.0.0.1 open in the default browser. `igneum-app.json` (never in the UI source): `update_manifest` = `https://dl.igneum.network/dl//igneum-app-latest.json` with the token read from `~/.config/igneum/dl-token` at build time (missing file = update check off), the log intake URL and key (the key only authorises uploads, as the 0.2.0 launchers shipped it), the live page. Over-the-air updates (4 October 2026, `packaging/ota/README.md`): the engine checks the signed manifest on start and hourly, downloads the newer DMG into `~/Library/Application Support/Igneum/app/updates`, verifies size, sha256 and the Ed25519 signature, stages the new bundle next to the running one, and at a safe moment (node synced, no hourly boundary within 3 minutes, no worker starting) stops the miners and the node, swaps the bundle (the old one stays as `Igneum Miner.app.previous`) and opens the new one. Publish with `packaging/ota/publish-manifest.sh --version --mac dist/Igneum-Miner-.dmg --notes "..."`. The 0.1.0 and 0.2.0 Terminal launchers are not auto-updated. Devnet vote keys are test keys derived from the miner's label (`--`); mainnet vote keys will be random and stored like the wallet (R4.3.12, devnet-only by design). Gatekeeper: the app is unsigned (ad hoc). Right-click > Open the first time. The engine strips `com.apple.quarantine` from the bundle's Contents on start, so the binaries inside are not refused one by one; that needs a writable volume, hence "drag to Applications first". ## What the engine does (app/igneum-app) Order: binaries next to the app > `igneum-app.json` > settings (`~/Library/Application Support/Igneum/app/settings.json`) > GPU detection (the Metal worker's `ready` line gives the device name; system_profiler the cores) > first run: cards (switch, identities) and the rewards address (a secp256k1 key made here, `app/wallet.json` mode 0600, shown once; or a pasted 0x address) > `igneumd --devnet --appdir ~/Library/Application Support/Igneum/devnet-v4 --rpclisten 127.0.0.1:26610 --listen 0.0.0.0:26611 --addpeer 188.245.5.161:26611 --addpeer 192.168.68.64:26611 --nodnsseed --disable-upnp --nologfiles --yes` (a node already answering on 26610 is used as is and never stopped) > `igneum-miner watch 1000000000` as one long-lived reader (a line every 10 s: blocks, headers, daa, peers, difficulty, blue, synced) > synced (the node's own flag with a peer, else the 0.2.0 rule) > per enabled card `igneum-miner mine grpc://127.0.0.1:26610 1 100000000 mac- --worker igneum-bench --status-secs 30 --exit-on-seed-change --evm-address [--identities N] [--no-vote] --payout-label mac-` > the loop: STATUS lines into hash rate (the v4 `now=` interval rate) and counts, ACCEPTED into blocks and the strip, `worker: prepared` into "next program compiled and ready", LOCK/VOTE into finality, a status line every 30 s, uploads every 60 s, restarts (exit 42 at once; crashes 5 to 60 s; the node 5 to 60 s with the miners held until it is synced again). Pause stops the miners and keeps the node. Settings restart only the affected worker. Tests: `IGNEUM_APP_NETWORK=devnet IGNEUM_APP_DEVNET_SUFFIX=7 IGNEUM_APP_RPC_PORT=29400 IGNEUM_APP_P2P_PORT=29401 IGNEUM_APP_PEERS= IGNEUM_APP_UNSYNCED=1 IGNEUM_APP_DATA= IGNEUM_APP_LOGS= igneum-app --print-url --no-open` runs a private devnet (its own genesis, no peers) with real mining; the window binary takes the same environment. Screenshots: `"Igneum Miner" --snapshot out.png --url ?screen=welcome|cards|address|key|dashboard|settings` (docs/design/app-screens). ## What is on the DMG | Item | What it is | |---|---| | `Igneum Miner.app` | the app | | `README.txt` | 8 lines for the miner (`dmg/README.txt`), with the seed line | | `Stop Igneum Miner.command` | asks a running copy to stop through its API, then ends leftovers (`app/Stop Igneum Miner.command`) | | `Applications` | symlink, for the drag |