All plugins

theta-edge-node

Run and monitor a Theta Edge Node from Hermes Desktop: install, launch, stop, track TFUEL rewards and node-wallet value, and export the node wallet locally. Disclosure — Windows only. First-run setup and Reinstall/Update download Theta's official Edge Node installer from theta-mkt-api.thetatoken.org (via assets.thetatoken.org or its S3 bucket) and run it silently after checking it against a SHA-256 and Theta Labs signing certificate pinned in the plugin, so a newer Theta build installs only after a catalog update. The pane launches and stops the node and, when Auto-launch is on, relaunches it at Desktop start if it was running when Desktop last closed. Wallet values come from eth-rpc-api.thetatoken.org and api.coingecko.com. The wallet export decrypts the node's keystore with your node password and shows the private key in the local pane only; the agent tools read status and the wallet address, never key material.

bonesnastyDesktopv0.3.0Updated 3 days ago

About

Run and monitor a Theta Edge Node from Hermes Desktop: install, launch, stop, track TFUEL rewards and node-wallet value, and export the node wallet locally. Disclosure — Windows only. First-run setup and Reinstall/Update download Theta's official Edge Node installer from theta-mkt-api.thetatoken.org (via assets.thetatoken.org or its S3 bucket) and run it silently after checking it against a SHA-256 and Theta Labs signing certificate pinned in the plugin, so a newer Theta build installs only after a catalog update. The pane launches and stops the node and, when Auto-launch is on, relaunches it at Desktop start if it was running when Desktop last closed. Wallet values come from eth-rpc-api.thetatoken.org and api.coingecko.com. The wallet export decrypts the node's keystore with your node password and shows the private key in the local pane only; the agent tools read status and the wallet address, never key material.

Theta Edge Node for Hermes Desktop

A Hermes Desktop plugin that runs and monitors a Theta Edge Node from a left-hand pane.

Built for the Nous Research Hermes Agent Plugin Hackathon (Nov 2026).
Not affiliated with or endorsed by Theta Labs.

What it does

  • Node — first-run setup downloads the official Theta Edge Node installer, verifies its
    pinned SHA-256 and Theta Labs Authenticode certificate, installs it, and launches it. After that: launch, stop,
    reinstall/update, version, holder address, sync/peer status, pending/paid TFUEL rewards, a
    7-day rewards sparkline, offline notification, node logs and a Copy diagnostics button.
  • Wallet — reads the Edge Node's own internal wallet (the wallet the app creates and funds
    with Cache/Compute rewards). Shows the address, liquid TFUEL balance and USD value. Exports the
    wallet two ways: the app's Info → Export Wallet as Keystore flow (recommended, with a
    verify step), or an advanced in-Hermes decrypt with the node password.
  • Agent tools — theta_node_status and theta_wallet_address, both read-only. They never
    return a private key.

The pane is Theta-skinned: dark navy surface, cyan-to-green gradient, text wordmark. The pane tab
strip and sash remain native Hermes chrome.

Requirements

  • Windows 10/11. The Edge Node app is Windows/macOS; this plugin targets the Windows build.
  • Hermes Desktop 0.21.5 or newer.
  • The Edge Node's minimum hardware: 4 CPU cores, 16 GB RAM, 64 GB free disk (256 GB+ recommended).
    A CUDA GPU is optional.

Install

From the catalog after the entry is merged:

hermes plugins install theta-edge-node

From this repo:

hermes plugins install https://github.com/bonesnasty/hermes-theta-edge-node

Then open Capabilities → Plugins and enable Theta Edge Node. The desktop half of a
unified package is opt-in; without that toggle the pane does not appear.

The first time the pane opens, it asks before downloading the ~230 MB installer. Nothing is
downloaded or executed at plugin install time.

How it reads the node

  • Local RPC: http://127.0.0.1:15888/rpc (edgelauncher.GetPastJobs) and
    http://127.0.0.1:17888/rpc (edgecore.GetVersion, GetStatus, GetPeers,
    GetEdgeNodeSummary).
  • Node wallet keystore: %APPDATA%\Theta Edge Node\ThetaEdgeNode\edgecore\key\encrypted
    (also checks %APPDATA%\Theta Edge Node\edgecore\key\encrypted and
    %USERPROFILE%\.edgelauncher\edgecore\key\encrypted).
  • TFUEL balance: https://eth-rpc-api.thetatoken.org/rpc (eth_getBalance, chain 361).
  • USD price: https://api.coingecko.com/api/v3/simple/price?ids=theta-fuel&vs_currencies=usd.

If the Windows build does not expose the local RPC ports, the pane shows process and keystore
state and says the RPC is offline. It does not invent reward numbers.

Security and privacy

Network calls

DestinationPurpose
https://theta-mkt-api.thetatoken.org/v1/downloads/edge-node/windowsOfficial installer download, user-initiated
https://s3.us-east-2.amazonaws.com/assets.thetatoken.org/...Installer redirect target; host is allowlisted
https://eth-rpc-api.thetatoken.org/rpcPublic TFUEL balance read
https://api.coingecko.com/api/v3/simple/pricePublic TFUEL/USD price
http://127.0.0.1:15888 / :17888Local Edge Node RPC

Data that leaves the machine: the public node wallet address in balance and price queries.
No private key, no telemetry, no analytics, no LLM calls.

Local state: %LOCALAPPDATA%\hermes\plugin-data\theta-edge-node\ (download progress, settings),
downloads\ThetaEdgeNodeSetup.exe, and verify_signature.ps1. The node keystore is read in place
and never copied by the plugin.

Processes: the plugin starts the downloaded installer and Theta Edge Node.exe only after an
explicit click. Stop node runs taskkill /IM "Theta Edge Node.exe" /F. No shell=True, no
user-controlled command strings.

Private key handling: the recommended export path uses the Edge Node app's own keystore
export; the plugin only verifies the exported file's address. The advanced path decrypts the node
keystore in memory with the node password, is loopback-only, rate-limits failures, and returns the
key only to the local pane. There is no agent tool for export, and the key is never logged.

Installer trust: the download must end on an allowlisted HTTPS host. The S3 redirect is accepted
only under the /assets.thetatoken.org/ path prefix. The installer is pinned in source by version
and SHA-256 (5.2.26 → 6acac6a905cdf74cce703d4b1ada0da18569b32781105ba1557003d10655f4eb) and must
carry the exact Theta Labs, Inc. Authenticode subject and certificate thumbprint
D5A10D49B0D0CCC53CDA4F3883AD7E23DB107001. A mismatch is refused and the downloaded file is
deleted; a new Theta build requires a catalog SHA bump, so /node/update only installs a reviewed
release. The installer is never bundled in this repository.

Legal / IP

  • This plugin is not affiliated with or endorsed by Theta Labs.
  • The Edge Node desktop app is distributed as a binary installer. This repository does not
    bundle, redistribute, repackage or reverse-engineer it. The installer is downloaded at runtime
    from Theta's official endpoint.
  • No Theta icons, fonts or screenshots are shipped in this repository. The pane uses a text
    wordmark and the brand gradient only.
  • This repository's MIT license covers the plugin code only. It grants no rights to Theta's
    software or trademarks.
  • License facts checked on 2026-11-09: thetatoken/theta-protocol-ledger is GPL-3.0,
    thetatoken/theta-wallet-web is GPL-3.0, thetatoken/theta-protocol-delivery-lib is MIT, the
    ledger explorer is MIT, and thetatoken/theta-eth-rpc-adaptor has no license file. There is no
    Edge Node source repository in the public thetatoken org.
  • Before a public release, read the installer's EULA and the thetatoken repository LICENSE
    files. They are authoritative; this section is a summary, not legal advice.

Development

python -m venv %LOCALAPPDATA%\venvs\theta-edge-node
%LOCALAPPDATA%\venvs\theta-edge-node\Scripts\python.exe -m pip install -r requirements-dev.txt

%LOCALAPPDATA%\venvs\theta-edge-node\Scripts\python.exe -m unittest discover -s tests -v
node --check desktop/plugin.js
node tests/desktop_smoke.mjs

hermes plugins validate . --install-deps
hermes plugins doctor . --ci

License

MIT. See LICENSE.

README from the reviewed commit 3634cd8; it updates when the author re-pins.

More by bonesnasty

2 plugins by bonesnasty in the catalog.

Developer Mode

Explore built-in Hermes toolsets and actions.

HermesAgent

Developer?

Create a Hermes extension for Desktop or agent workflows.

Developer Section