igneum-network/igneum
1
0
Fork 0
Code Issues Pull requests Releases Activity
igneum/packaging/mac
History
igneum-labs a0e092d109 Igneum Miner 0.3.7: the Windows runtime DLLs come from the toolchain that linked the exes, and a gate refuses a payload whose exe imports a symbol the shipped DLL lacks 
0.3.6 on both PCs: igneumd.exe (built on PC 1 with GCC 13's mingw) shipped with the Mac toolchain's GCC 16
libstdc++-6.dll, which no longer exports seven symbols the exe imports (std::codecvt_utf8_utf16 and a
stringbuf::seekpos); Windows refused the node with Entry Point Not Found. -C link-arg=-static had never removed
the libstdc++ import (0.3.5's Mac-built exe carries it too).
- packaging/windows/check-runtime-dlls.sh: objdump imports per DLL against the DLL's exports; shown to fail
  the 0.3.6 pairing (7 missing) and pass 0.3.5's; run by push-inputs.sh before signing and by make-payload.sh
- push-inputs.sh: DLLs next to the exes first, then the Mac toolchain
- jobbuild.rs: the PC's windows stage copies its own toolchain's three DLLs into the pack (unit test);
  build-job.mjs accepts the small DLL PE files and places them next to the exes
- cross-build.sh: -static-libstdc++ added as a try (measured on the 0.3.7 build)
- the six version files: 0.3.7
2026-10-05 09:46:49 +00:00
..
app Igneum Miner 0.3.7: the Windows runtime DLLs come from the toolchain that linked the exes, and a gate refuses a payload whose exe imports a symbol the shipped DLL lacks 2026-10-05 09:46:49 +00:00
dmg Brand: one master mark (black square, no circle) for every icon, favicon and profile picture 2026-10-04 11:39:55 +00:00
.gitignore Mac packaging: Igneum Devnet.app and DMG for Apple silicon miners 2026-10-03 21:54:22 +00:00
build-dmg.sh Ship tool: one command cuts an Igneum Miner version (tools/ship-app.mjs) 2026-10-04 18:29:21 +00:00
packaged-config.sh Rotation phase 2: packagers read the intake key and the downloads token from files (IGNEUM_INTAKE_KEY_FILE, IGNEUM_DL_TOKEN_FILE, .next by default), no key literal in the tree, app header line with fingerprints, ship-app --dl-both, logs --rotation, tools/repo/fresh-repo.sh with the dry run, docs/plans/rotation-phase-2.md 2026-10-05 07:43:44 +00:00
README.md Igneum Miner round-4 fixes: the dashboard token is never logged and token lines never upload (R4.3.8); every helper by absolute path and Program Files read-only, fallback worker build under the app data folder (R4.3.3); the download and the staged bundle re-verified right before the swap or the elevated run, quarantine stripped only after that (R4.3.5); mutating POSTs refused unless same-origin (R4.3.7); no rollback below min_supported_version and no automatic re-apply of a failed version (R4.3.6); the signed manifest's consensus.override written to override.json for --override-params-file with a safe-moment node restart and 'consensus switch at DAA N' on the node tile, an old node that rejects the file runs without it; devnet vote-key note in the key sheet and READMEs 2026-10-04 13:58:23 +00:00

README.md

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:<random port>/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/<token>/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 <v> --mac dist/Igneum-Miner-<v>.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 (<platform>-<machine id8>-<n>); 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-<host> --worker igneum-bench --status-secs 30 --exit-on-seed-change --evm-address <addr> [--identities N] [--no-vote] --payout-label mac-<host> > 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=<dir> IGNEUM_APP_LOGS=<dir> 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 <dashboard 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