From 055f498a5d3c1196b833732712f73acf1375c4d1 Mon Sep 17 00:00:00 2001 From: hinto-janaiyo Date: Thu, 15 Dec 2022 11:21:17 -0500 Subject: [PATCH] Add to `Advanced` README --- README.md | 166 ++++++++++++++++++++++++++++++++++++++++++++++++-- src/README.md | 18 +----- src/disk.rs | 12 ++-- src/main.rs | 2 +- src/p2pool.rs | 2 +- src/update.rs | 6 +- 6 files changed, 172 insertions(+), 34 deletions(-) diff --git a/README.md b/README.md index 679a2ce..91c6cb9 100644 --- a/README.md +++ b/README.md @@ -34,8 +34,9 @@ Gupax is a (Windows|macOS|Linux) GUI for mining [**Monero**](https://github.com/ * [FAQ](#FAQ) - [Where are updates downloaded from?](#where-are-updates-downloaded-from) - [Can I quit mid-update?](#can-i-quit-mid-update) + - [Bundled vs Standalone](#bundled-vs-standalone) - [How much memory does Gupax use?](#how-much-memory-does-gupax-use) - - [How is sudo handled? (on macOS/Linux)](#how-is-sudo-handled-on-macos-linux) + - [How is sudo handled? (on macOS/Linux)](#how-is-sudo-handled-on-macoslinux) - [Why does Gupax need to be Admin? (on Windows)](#why-does-gupax-need-to-be-admin-on-windows) ## What is Monero/P2Pool/XMRig/Gupax? @@ -84,6 +85,19 @@ By default, though, Gupax will use a [Community Monero Node](#community-monero-n ## How-To ### Video ### Text +1. [Download the bundled version of Gupax for your OS here](https://github.com/hinto-janaiyo/gupax/releases) or from [gupax.io](https://gupax.io/downloads) +2. Extract somewhere (Desktop, Documents, etc) +3. Launch Gupax +4. Input your Monero address in the `[P2Pool]` tab +5. Select a [`Community Monero Node`](#community-monero-nodes) that you trust +5. Start P2Pool +6. Start XMRig + +You are now mining to your own instance of P2Pool, welcome to the world of decentralized peer-to-peer mining! + +_Notes:_ +- _[What is bundled? What is standalone?](#bundled-vs-standalone)_ +- _If you'd like to get deeper into the settings, see [Advanced.](#advanced)_ ## Simple ### Gupax @@ -98,26 +112,163 @@ By default, though, Gupax will use a [Community Monero Node](#community-monero-n ## Advanced ### Verifying +It is recommended to verify the hash and PGP signature of the download before using Gupax. +Download the [`SHA256SUM`](https://github.com/hinto-janaiyo/gupax/releases/latest) file, download and import my [`PGP key`](https://github.com/hinto-janaiyo/gupax/blob/main/pgp/hinto-janaiyo.asc), and verify: +```bash +sha256sum -c SHA256SUM +gpg --import hinto-janaiyo.asc +gpg --verify SHA256SUM +``` + +Q: How can I be sure the P2Pool/XMRig bundled with Gupax hasn't been tampered with? +A: Verify the hash. + +You can always compare the hash of the `P2Pool/XMRig` bundled with Gupax with the official hashes found here: +- https://github.com/SChernykh/p2pool/releases +- https://github.com/xmrig/xmrig/releases + +Make sure the _version_ you are comparing against is correct. If they match, you can be sure they are the exact same. Verifying the PGP signature is also recommended: +- P2Pool - [`SChernykh.asc`](https://github.com/monero-project/gitian.sigs/blob/master/gitian-pubkeys/SChernykh.asc) +- XMRig - [`xmrig.asc`](https://github.com/xmrig/xmrig/blob/master/doc/gpg_keys/xmrig.asc) + --- ### Command Line +Gupax comes with some command line options: +``` +USAGE: ./gupax [--flag] + + --help Print this help message + --version Print version and build info + --state Print Gupax state + --nodes Print the manual node list + --no-startup Disable all auto-startup settings for this instance + --reset-state Reset all Gupax state (your settings) + --reset-nodes Reset the manual node list in the [P2Pool] tab + --reset-pools Reset the manual pool list in the [XMRig] tab + --reset-all Reset the state, the manual node list, and the manual pool list + --ferris Print an extremely cute crab +``` + +By default, Gupax has `auto-update` & `auto-ping` enabled. This can only be turned off in the GUI which causes a chicken-and-egg problem. To get around this, start Gupax with `--no-startup`. This will disable all `auto` features for that instance. + +--- + +### Resolution +The default resolution of Gupax is `1280x960` which is a `4:3` aspect ratio. + +This can be changed by dragging the corner of the window itself or by using the resolution sliders in the `Gupax Advanced` tab. After a resolution change, Gupax will fade-in/out of black and will take a second to resize all the UI elements to scale correctly to the new resolution. + +If you have changed your OS's pixel scaling, you may need to resize Gupax to see all UI correctly. + +The minimum window size is: `640x480` +The maximum window size is: `2560x1920` +Fullscreen mode can also be entered by pressing `F11`. --- ### Tor/Arti +By default, Gupax updates via Tor. In particular, it uses [`Arti`](https://gitlab.torproject.org/tpo/core/arti), the official Rust implementation of Tor. ---- +Instead of bootstrapping onto the Tor network every time, Arti saves state/cache about the Tor network (circuits, guards, etc) for later reuse onto the disk: -### Logs +State: +| OS | Data Folder | +|----------|---------------------------------------------------------------| +| Windows | `C:\Users\USER\AppData\Local\torproject\Arti\data` | +| macOS | `/Users/USER/Library/Application Support/org.torproject.Arti` | +| Linux | `/home/USER/.local/share/arti` | + +Cache: +| OS | Data Folder | +|----------|---------------------------------------------------------------| +| Windows | `C:\Users\USER\AppData\Local\torproject\Arti\cache` | +| macOS | `/Users/USER/Library/Caches/org.torproject.Arti` | +| Linux | `/home/USER/.cache/arti` | --- ### Disk +Long-term state is saved onto the disk in the "OS data folder", using the [TOML](https://github.com/toml-lang/toml) format. If not found, default files will be created. + +Given a slightly corrupted `state.toml` file, Gupax will attempt to merge it with a new default one. This will most likely happen if the internal data structure of `state.toml` is changed in the future (e.g removing an outdated setting). The node/pool database cannot be merged. + +If Gupax can't read/write to disk at all, or if there are any other big issues, it will show an un-recoverable error screen. + +| OS | Data Folder | Example | +|----------|------------------------------------------|-------------------------------------------------| +| Windows | `{FOLDERID_RoamingAppData}` | `C:\Users\USER\AppData\Roaming\Gupax` | +| macOS | `$HOME`/Library/Application Support | `/Users/USER/Library/Application Support/Gupax` | +| Linux | `$XDG_DATA_HOME` or `$HOME`/.local/share | `/home/USER/.local/share/gupax` | + +The current files saved to disk: +* `state.toml` Gupax state/settings +* `node.toml` The manual node database used for P2Pool advanced +* `pool.toml` The manual pool database used for XMRig advanced + +--- + +### Logs +Gupax has console logs that show with increasing detail, what exactly it is is doing. + +There are multiple log filter levels but by default, `INFO` and above are enabled. +To view more detailed console debug information, start Gupax with the environment variable `RUST_LOG` set to a log level like so: +```bash +RUST_LOG=(trace|debug|info|warn|error) ./gupax +``` +For example: +```bash +RUST_LOG=debug ./gupax +``` + +In general: +- `ERROR` means something has gone wrong and that something will likely break +- `WARN` means something has gone wrong, but things will likely be fine +- `INFO` logs are general info about what Gupax (the GUI thread) is currently doing +- `DEBUG` logs are much more verbose and include what EVERY thread is doing (not just the main GUI thread) +- `TRACE` logs are insanely verbose and shows the logs of the libraries Gupax uses (HTTP connections, GUI polling, etc) --- ### Swapping P2Pool/XMRig +If you downloaded Gupax standalone and want to use your own `P2Pool/XMRig` binaries and/or want to swap them, you can: +- Edit the PATH in `Gupax Advanced` to point at the new binaries +- Change the binary itself + +By default, Gupax will look for `P2Pool/XMRig` in folders next to itself: + +Windows: +``` +Gupax\ +├─ Gupax.exe +├─ P2Pool\ +│ ├─ p2pool.exe +├─ XMRig\ + ├─ xmrig.exe +``` + +macOS (Gupax is packaged as an `.app` on macOS): +``` +Gupax.app/Contents/MacOS/ +├─ gupax +├─ p2pool/ +│ ├─ p2pool +├─ xmrig/ + ├─ xmrig +``` + +Linux: +``` +gupax/ +├─ gupax +├─ p2pool/ +│ ├─ p2pool +├─ xmrig/ + ├─ xmrig +``` + +Be warned: Gupax will use your custom PATH/binary and will replace them if you use `Check for updates` in the `[Gupax]` tab. --- @@ -137,8 +288,8 @@ For transparency, here's all the connections Gupax makes: | Domain | Why | When | Where | |--------------------|-------------------------------------------------------|------|-------| | https://github.com | Fetching metadata information on packages + download | `[Gupax]` tab -> `Check for updates` | [`update.rs`](https://github.com/hinto-janaiyo/gupax/blob/main/src/update.rs) | -| DNS | DNS connections will usually be handled by your OS (or whatever custom DNS setup you have). If using Tor, DNS requests [*should*](https://tpo.pages.torproject.net/core/doc/rust/arti/) be routed through the Tor network automatically | Same as above | Same as above | | Community Monero Nodes | Connecting to with P2Pool, measuring ping latency | `[P2Pool Simple]` tab | [`node.rs`](https://github.com/hinto-janaiyo/gupax/blob/main/src/node.rs) | +| DNS | DNS connections will usually be handled by your OS (or whatever custom DNS setup you have). If using Tor, DNS requests for updates [*should*](https://tpo.pages.torproject.net/core/doc/rust/arti/) be routed through the Tor network automatically | All of the above | All of the above | ## Community Monero Nodes | Name | IP/Domain | RPC Port | ZMQ Port | @@ -222,6 +373,13 @@ Although Gupax uses a temporary folder (`gupax_update_[A-Za-z0-9]`) to store tem --- +### Bundled vs Standalone +`Bundled` Gupax comes the latest version of P2Pool/XMRig already in the `zip/tar`. + +`Standlone` only contains the Gupax executable. + +--- + ### How much memory does Gupax use? Gupax itself uses around 100-300 megabytes of memory. diff --git a/src/README.md b/src/README.md index 944e153..9e7aa7d 100644 --- a/src/README.md +++ b/src/README.md @@ -65,22 +65,6 @@ This is how Gupax works internally when starting up: - If `ask_before_quit` == `true`, ask before quitting - Kill processes, kill connections, exit -## Disk -Long-term state is saved onto the disk in the "OS data folder", using the [TOML](https://github.com/toml-lang/toml) format. If not found, default files will be created. Given a slightly corrupted state file, Gupax will attempt to merge it with a new default one. This will most likely happen if the internal data structure of `state.toml` is changed in the future (e.g removing an outdated setting). Merging silently in the background is a good non-interactive way to handle this. The node/pool database cannot be merged, and if given a corrupted file, Gupax will show an un-recoverable error screen. If Gupax can't read/write to disk at all, or if there are any other big issues, it will show an un-recoverable error screen. - -| OS | Data Folder | Example | -|----------|----------------------------------------- |------------------------------------------------| -| Windows | `{FOLDERID_LocalAppData}` | C:\Users\Alice\AppData\Roaming\Gupax | -| macOS | `$HOME`/Library/Application Support | /Users/Alice/Library/Application Support/Gupax | -| Linux | `$XDG_DATA_HOME` or `$HOME`/.local/share | /home/alice/.local/share/gupax | - -The current files saved to disk: -* `state.toml` Gupax state/settings -* `node.toml` The manual node database used for P2Pool advanced -* `pool.toml` The manual pool database used for XMRig advanced - -Arti (Tor) also needs to save cache and state. It uses the same file/folder conventions. - ## Scale Every frame, the max available `[width, height]` are calculated, and those are used as a baseline for the Top/Bottom bars, containing the tabs and status bar. After that, all available space is given to the middle ui elements. The scale is calculated every frame so that all elements can scale immediately as the user adjusts it; this doesn't take as much CPU as you might think since frames are only rendered on user interaction. Some elements are subtracted a fixed number because the `ui.seperator()`'s add some fixed space which needs to be accounted for. @@ -100,7 +84,7 @@ Windows: - XMRig: `XMRig\xmrig.exe` macOS: -- Gupax: `Gupax.app/.../Gupax` (Gupax is packaged as an `.app` on macOS) +- Gupax: `Gupax.app/Contents/MacOS/gupax` (Gupax is packaged as an `.app` on macOS) - P2Pool: `p2pool/p2pool` - XMRig: `xmrig/xmrig` diff --git a/src/disk.rs b/src/disk.rs index fab033c..be0c943 100644 --- a/src/disk.rs +++ b/src/disk.rs @@ -154,7 +154,6 @@ impl State { gupax: Gupax { simple: true, auto_update: true, - auto_node: true, auto_p2pool: false, auto_xmrig: false, ask_before_quit: true, @@ -175,7 +174,7 @@ impl State { p2pool: P2pool { simple: true, mini: true, - auto_node: true, + auto_ping: true, auto_select: true, out_peers: 10, in_peers: 10, @@ -200,13 +199,13 @@ impl State { arguments: String::with_capacity(300), address: String::with_capacity(96), name: "Local P2Pool".to_string(), - rig: "Gupax".to_string(), + rig: GUPAX_VERSION_UNDERSCORE.to_string(), ip: "localhost".to_string(), port: "3333".to_string(), selected_index: 0, selected_name: "Local P2Pool".to_string(), selected_ip: "localhost".to_string(), - selected_rig: "Gupax".to_string(), + selected_rig: GUPAX_VERSION_UNDERSCORE.to_string(), selected_port: "3333".to_string(), api_ip: "localhost".to_string(), api_port: "18088".to_string(), @@ -436,7 +435,7 @@ impl Node { impl Pool { pub fn p2pool() -> Self { Self { - rig: "Gupax".to_string(), + rig: GUPAX_VERSION_UNDERSCORE.to_string(), ip: "localhost".to_string(), port: "3333".to_string(), } @@ -593,7 +592,6 @@ pub struct State { pub struct Gupax { pub simple: bool, pub auto_update: bool, - pub auto_node: bool, pub auto_p2pool: bool, pub auto_xmrig: bool, pub ask_before_quit: bool, @@ -613,7 +611,7 @@ pub struct Gupax { pub struct P2pool { pub simple: bool, pub mini: bool, - pub auto_node: bool, + pub auto_ping: bool, pub auto_select: bool, pub out_peers: u16, pub in_peers: u16, diff --git a/src/main.rs b/src/main.rs index 3a74a00..c165eea 100644 --- a/src/main.rs +++ b/src/main.rs @@ -704,7 +704,7 @@ fn init_auto(app: &mut App) { } // [Auto-Ping] - if app.state.p2pool.auto_node && app.state.p2pool.simple { + if app.state.p2pool.auto_ping && app.state.p2pool.simple { Ping::spawn_thread(&app.ping) } else { info!("Skipping auto-ping..."); diff --git a/src/p2pool.rs b/src/p2pool.rs index 44a75ca..b4ccae7 100644 --- a/src/p2pool.rs +++ b/src/p2pool.rs @@ -203,7 +203,7 @@ impl P2pool { // [Auto-node] + [Auto-select] ui.add_sized([width, height], Checkbox::new(&mut self.auto_select, "Auto-select")).on_hover_text(P2POOL_AUTO_SELECT); ui.separator(); - ui.add_sized([width, height], Checkbox::new(&mut self.auto_node, "Auto-node")).on_hover_text(P2POOL_AUTO_NODE); + ui.add_sized([width, height], Checkbox::new(&mut self.auto_ping, "Auto-ping")).on_hover_text(P2POOL_AUTO_NODE); })}); //---------------------------------------------------------------------------------------------------- Advanced diff --git a/src/update.rs b/src/update.rs index 0495e06..fa39538 100644 --- a/src/update.rs +++ b/src/update.rs @@ -25,7 +25,7 @@ //---------------------------------------------------------------------------------------------------- Imports use anyhow::{anyhow,Error}; -use arti_client::{TorClient}; +use arti_client::TorClient; use arti_hyper::*; use crate::{ constants::GUPAX_VERSION, @@ -106,9 +106,7 @@ const XMRIG_EXTENSION: &str = "-linux-static-x64.tar.gz"; #[cfg(target_os = "windows")] const GUPAX_BINARY: &str = "Gupax.exe"; -#[cfg(target_os = "macos")] -const GUPAX_BINARY: &str = "Gupax"; -#[cfg(target_os = "linux")] +#[cfg(target_family = "unix")] const GUPAX_BINARY: &str = "gupax"; #[cfg(target_os = "windows")]