What "Online data" fetches, and what it never does

By default, subnera reads local files and makes one anonymous update check a day, which you can turn off (see "The update check" below). It reads the log file Train at Home writes on your Mac and, read-only, two small update files of the official app (see below). Online data is an opt-in setting that adds a few public numbers to the menu, such as your run tier, occupancy and rewards. This page explains exactly what happens when you turn it on. For the app itself, see the install guide.

Off by default

With Online data off, the app reads ~/Library/Logs/IOTA Train at Home/ and, read-only, the official app's ShipItState.plist and the version in the downloaded update's Info.plist — nothing else, never writes to them, sends none of it anywhere, and never connects to the official app's local control port (127.0.0.1:8010). Your queue position, ETA, registration status and training stats all work without any of that leaving your Mac.

What happens when you turn it on

Tick Online data (Macrocosmos) in the menu. From then on the app:

1. Reads your public hotkey from ~/.bittensor/wallets/iota/hotkeys/iota_minerpub.txt. This is the public half of your miner's identity, the address visible on-chain. The code refuses any file whose name doesn't end in pub.txt, so private key files are never opened, and it reads nothing else from your wallet folder.
2. Sends anonymous read requests to Macrocosmos's public API (iota-web.api.macrocosmos.ai) for public information: run metadata and tier, occupancy, the next payout time, and the rewards totals tied to your hotkey.
3. Shows the results as extra rows in the menu.

It refreshes at most once a minute while the setting is on.

What never leaves your Mac

Your password, your private keys and seed phrase, and your log files. The app doesn't log in anywhere: there is no account and no API key.

The update check

Separately from Online data, subnera asks at start-up, and then at most once a day once a check succeeds, whether a newer version exists. It is an anonymous GET of https://downloads.subnera.com/latest.json and of its signature latest.json.sig, with a User-Agent that carries only the version, and no identifier, cookie or query string. The host, Cloudflare, sees your IP address like any web server. The check itself only informs you: the release is downloaded only when you ask for it ("Update to subnera X…", subnera-agent update) or have turned on automatic installs, which are off by default. Turn the check off in the app (Options, Check for subnera Updates) or with subnera-agent update-check off. Details in the updates guide.

What Macrocosmos can see

• Your public hotkey, because the rewards request carries it in the URL. It is public anyway, but the request ties it to your IP address.
• Your IP address, like any web request.

Requests use an ephemeral session, so no cookies and nothing stored between requests, with a 10-second timeout per request.

Offline or API down?

If a request fails, the last good values stay visible and the menu shows an error row such as "Online: offline". The local part (queue, state, training) is unaffected because it doesn't depend on the network.

How to turn it off

Untick Online data (Macrocosmos). In-flight requests are cancelled, the stored values are forgotten and the online rows disappear from the menu.

Why it's opt-in

The monitor is read-only and local first: a tool that watches your miner shouldn't add risk to it. Online data is useful, but it is a choice, not a default. For the same public rewards data at fleet scale, see the rewards guide.

Checklist

1. Leave Online data off unless you want the tier and rewards rows.
2. If you turn it on, only your public hotkey and IP address are visible to the request.
3. Untick it from the menu at any time.