Gemini 3h guide updates

docker-compose-auto.yml

@@ -19,18 +19,17 @@ services:
       - "0.0.0.0:30433:30433/tcp"
     restart: unless-stopped
     command: [
-      "--chain", "gemini-3g",
+      "--chain", "gemini-3h",
       "--base-path", "/var/subspace",
       "--blocks-pruning", "256",
       "--state-pruning", "archive-canonical",
-      "--port", "30333",
+      "--listen-on", "30333",
       "--dsn-listen-on", "/ip4/0.0.0.0/udp/30433/quic-v1",
       "--dsn-listen-on", "/ip4/0.0.0.0/tcp/30433",
       "--rpc-cors", "all",
       "--rpc-methods", "unsafe",
-      "--rpc-external",
-      "--no-private-ipv4",
-      "--validator",
+      "--rpc-listen-on", "0.0.0.0:9944",
+      "--farmer",
 # Replace `INSERT_YOUR_ID` with your node ID (will be shown in telemetry)
       "--name", "INSERT_YOUR_ID"
     ]

docs/develop/nova/local_development.md

@@ -33,7 +33,7 @@ After downloading both files that suit your system, start a node using your pref
 You can do this with the following command:
 
 ```bash
-./your_subspace_node_path --dev --alice --rpc-port 9444 -- --domain-id 3 --dev --rpc-port 8545
+./your_subspace_node_path run --dev --rpc-listen-on 127.0.0.1:9944 -- --domain-id 3 --dev --rpc-listen-on 127.0.0.1:8545
 ```
 
 This will create a local RPC on port **8545**.

docs/farming-&-staking/farming/advanced-cli/cli-prerequisites.mdx

@@ -70,3 +70,4 @@ You can use any file system with default settings, we advise against their use f
 In order to disable **CoW** on **BTRFS**, run the command `chattr +C /your_farmer_directory/`.
 
 In case of **ZFS**, you can try adjusting the **recordsize** by running `zfs set recordsize=128K tank/dataset`, or creating a separate **dataset** for the farmer with adjusted **recordsize** parameters.
+

docs/farming-&-staking/farming/advanced-cli/cli-tips.mdx

@@ -54,46 +54,31 @@ Similarly, you can customize the replotting CPU cores using `--replotting-cpu-co
 
 Note that setting `--plotting-cpu-cores` requires `--replotting-cpu-cores` to be configured with the same number of CPU core groups. If the `--replotting-cpu-cores` setting is omitted, the node will default to using the same thread pool as for plotting.
 
-### Using a Custom Path
-You can set a custom path for your node & farmer to use if you want to use an external hard drive, or set a custom path from the default. You can set the node and farmer to different directories if you would like.
-
-<Tabs>
-<TabItem value="node" label="1.🚩 Node">
-
-#### Set Node Custom Path.
-To set your node to use a custom path all you will need to do is add the `--base-path` parameter.
-
-```bash
-# start node and store data in `NODE_DATA_PATH` instead of default location
-./NODE_FILE_NAME --base-path NODE_DATA_PATH --chain gemini-3g ...`
-```
-</TabItem>
-</Tabs>
 
 ### Switching to a new snapshot from older/different versions of Subspace
 
 :::info
-Unless specifically mentioned by the Development team you should **NOT** have to wipe & purge your configuration on new releases.
+Unless specifically mentioned by the Development team you should **NOT** have to wipe your configuration on new releases.
 :::
 
 In general you should be able to download the latest release, and re-start the Node & Farmer with the same commands as you started to prior version with no errors.
 
-There are some cases where version updates will cause issue with your Node & Farmer and you may have to wipe & purge your node, typically when errors occur. If you have any issues you can always check our [Forums](https://forums.subspace.network) and hop in our [Discord](https://discord.gg/subspace-network) Server to ask for help.
+There are some cases where version updates will cause issue with your Node & Farmer and you may have to wipe your node, typically when errors occur. If you have any issues you can always check our [Forums](https://forums.subspace.network) and hop in our [Discord](https://discord.gg/subspace-network) Server to ask for help.
 
-### Wipe & Purge
+### Wipe
 
 If you were running a node previously, and want to switch to a new network, please perform these steps and then follow the guide again:
 ```bash
 # Replace `FARMER_FILE_NAME` with the name of the farmer file you downloaded from releases
 ./FARMER_FILE_NAME wipe PATH_TO_FARM
 # Replace `NODE_FILE_NAME` with the name of the node file you downloaded from releases
-./NODE_FILE_NAME purge-chain --chain gemini-3g
+./NODE_FILE_NAME wipe NODE_DATA_PATH
 ```
-It does not matter if the node/farmer executable is the previous one or from the new snapshot, both will work :)
+It does not matter if the node/farmer executable is the previous one or from the new snapshot, both will work.
 
-Now follow installation guide.
+Now follow the installation guide from the beginning.
 
-### Docker Wipe & Purge
+### Docker Wipe
 
 In case of Docker setup run `docker compose down -v` (and manually delete custom directories if you have specified them).
 
@@ -137,8 +122,7 @@ For both the node and the farmer, here are some frequently used commands:
 - Display farm information: `./FARMER_FILE_NAME info PATH_TO_FARM`
 - Scrub the farm for errors: `./FARMER_FILE_NAME scrub PATH_TO_FARM`
 - Erase all farmer-related data: `./FARMER_FILE_NAME wipe PATH_TO_FARM`
-- Start the node with a custom data path: `./NODE_FILE_NAME --base-path NODE_DATA_PATH --chain gemini-3g`
-- Erase all node-related data: `./NODE_FILE_NAME purge-chain --base-path NODE_DATA_PATH --chain gemini-3g`
+- Erase all node-related data: `./NODE_FILE_NAME wipe NODE_DATA_PATH`
 
 ### Utilizing Multiple Disks
 
@@ -160,7 +144,6 @@ While it might be tempting to adjust certain parameters that seem related to DSN
 ```
 --out-peers
 --in-peers
---in-peers-light
 --dsn-target-connections
 --dsn-pending-in-connections
 --dsn-in-connections
@@ -182,4 +165,22 @@ Increasing the values of the farmer parameters could increase the plotting speed
 ```
 --out-connections
 --pending-out-connections
-```
+```
+
+
+### NUMA Support
+
+:::note
+NUMA support will benefit farmers with large, powerful CPUs and lots of RAM available. The required RAM amount depends on the processor and the number of threads.  
+:::
+
+Previously plotting/replotting thread pools were created for each farm separately even though only a configured number of them can be used at a time (by default just one).
+With the introduction of NUMA support, the farmer application has a thread pool manager that will create a necessary number of thread pools that will be allocated to currently plotting/replotting farms. 
+When a thread pool is created, it is assigned to a set of CPU cores and will only be able to use those cores. Pinning doesn’t pin threads to cores 1:1, instead, the OS is free to move threads between cores, but only within CPU cores allocated for the thread pool. This will ensure plotting for a particular sector only happens on a particular CPU/NUMA node.
+
+#### Enabling NUMA on Windows/Linux machines
+
+On Linux and Windows, the farmer will detect NUMA systems and create a number of thread pools that correspond to the number of NUMA nodes. This means the default behavior will change for large CPUs and consume more memory as a result, but that can be changed to the previous behavior with CLI options if desired.
+To use NUMA, you need to enable it via the BIOS of your motherboard for the farmer to know it exists. This option is present in motherboards for **Threadripper/Epyc processors** but might exist in others too. If you don’t enable it, both OS and farmer will think you have a single UMA processor and will not be able to apply optimizations.
+
+To read more about NUMA support and the benefits it provides for large CPUs read [this forum post](https://forum.subspace.network/t/numa-support-is-coming/2299?u=nazar-pc).

docs/farming-&-staking/farming/advanced-cli/platforms/_linux.mdx

@@ -94,13 +94,17 @@ import styles from '@site/src/pages/index.module.css';
   # Replace `INSERT_YOUR_ID` with a nickname you choose
   # Copy all of the lines below, they are all part of the same command
   ./subspace-node-ubuntu-x86_64-skylake-gemini-3g-2024-jan-31 \
-    --chain gemini-3g \
+    --chain gemini-3h \
     --blocks-pruning 256 \
     --state-pruning archive-canonical \
-    --no-private-ipv4 \
-    --validator \
+    --farmer \
     --name "INSERT_YOUR_ID"
 ```
+
+:::note
+Setting **--base-path** and specifying **--chain** became mandatory starting with Gemini 3h. 
+:::
+
 4. You should see something similar in the terminal:
 ```
 2022-02-03 10:52:23 Subspace
@@ -153,4 +157,4 @@ import styles from '@site/src/pages/index.module.css';
 2022-06-02T00:02:09.492868Z  INFO subspace_farmer::archiving: Plotted segment segment_index=5
 ```
 
-3. You are now Farming! Just wait for your node to fully sync, and for your farmer to fully plot.
+3. You are now farming! Just wait for your node to fully sync, and for your farmer to fully plot.

docs/farming-&-staking/farming/advanced-cli/platforms/_macos.mdx

@@ -64,14 +64,17 @@ After this, simply repeat the step you prompted for (step 4 or 6). This time, cl
 # Replace `INSERT_YOUR_ID` with a nickname you choose
 # Copy all of the lines below, they are all part of the same command
 ./subspace-node-macos-aarch64-gemini-3g-2024-jan-31 \
-  --chain gemini-3g \
+  --chain gemini-3h \
   --blocks-pruning 256 \
   --state-pruning archive-canonical \
-  --no-private-ipv4 \
-  --validator \
+  --farmer \
   --name "INSERT_YOUR_ID"
 ```
 
+:::note
+Setting **--base-path** and specifying **--chain** became mandatory starting with Gemini 3h. 
+:::
+
 4. You should see something similar in the terminal:
 ```
 2022-02-03 10:52:23 Subspace
@@ -124,4 +127,4 @@ After this, simply repeat the step you prompted for (step 4 or 6). This time, cl
 2022-06-02T00:02:09.492868Z  INFO subspace_farmer::archiving: Plotted segment segment_index=5
 ```
 
-3. You are now Farming! Just wait for your node to fully sync, and for your farmer to fully plot.
+3. You are now farming! Just wait for your node to fully sync, and for your farmer to fully plot.

docs/farming-&-staking/farming/advanced-cli/platforms/_windows.mdx

@@ -60,13 +60,16 @@ This is because the application is trying to access the internet. This is expect
 # Replace `INSERT_YOUR_ID` with a nickname you choose
 # Copy all of the lines below, they are all part of the same command
 .\subspace-node-windows-x86_64-skylake-gemini-3g-2024-jan-31.exe `
-  --chain gemini-3g `
+  --chain gemini-3h `
   --blocks-pruning 256 `
   --state-pruning archive-canonical `
-  --no-private-ipv4 `
-  --validator `
+  --farmer `
   --name "INSERT_YOUR_ID"
 ```
+
+:::note
+Setting **--base-path** and specifying **--chain** became mandatory starting with Gemini 3h. 
+:::
 
 4. You should see something similar in the terminal:
 ```text
@@ -120,4 +123,4 @@ This is because the application is trying to access the internet. This is expect
 2022-06-02T00:02:09.492868Z  INFO subspace_farmer::archiving: Plotted segment segment_index=5
 ```
 
-3. You are now Farming! Just wait for your node to fully sync, and for your farmer to fully plot.
+3. You are now farming! Just wait for your node to fully sync, and for your farmer to fully plot.

docs/farming-&-staking/staking/intro.md

@@ -63,29 +63,35 @@ Our suggested specs are not necessarily applicable to Stake Wars. We encourage a
 **Network**:
 - The minimum symmetric networking speed is set to 500 Mbit/s.
 
+### Folder structure
 
+Starting with Gemini 3h, **Subspace Node** will create the following directory structure:
+
+- subspace-node/db
+- subspace-node/domains/0/keystore
+- subspace-node/domains/0/db
+- subspace-node/domains/1/keystore
+- subspace-node/domains/1/db
+- subspace-node/network
+
+For operators it means that you can find your key pair under `NODE_DATA_PATH/domains/domainID/keystore`.
 
 ### Staking
 
 The Subspace Network relies on staking from both domain operators and farmers to secure the network and provide resources. Subspace implements a Nominated Proof-of-Stake algorithm where token holders endorse operators who execute transactions and produce blocks.
 
 Our staking model consists of two tiers:
 
-- Farmers earn rewards proportional to their pledged storage. Farmers can choose to nominate operators and back them with their own stake, increasing their chance of being elected as a slot leader. Farmers, who have earned storage rewards, nominate operators to execute transactions. This nomination system balances the power between farmers who nominate and operators and both parties share the rewards and the potential penalties (slashing). 
+- Farmers earn rewards proportional to their pledged storage. Farmers can choose to nominate operators and back them with their own stake, increasing their chance of being elected as a slot leader. Farmers, who have earned storage rewards, nominate operators to execute transactions. This nomination system balances the power between farmers who nominate and operators with both parties sharing the execution fees and the potential penalties (slashing). 
 
-- Operators stake to gain the right to produce bundles within a domain. They are responsible for validating and executing transactions, producing execution receipts, and applying state transitions and earn rewards for their work. The operator's chances to be elected as a slot leader and produce a bundle are weighted by their stake. Operators can be nominated by farmers or other SSC holders. 
+- Operators stake to gain the right to produce bundles within a domain. They are responsible for validating and executing transactions, producing execution receipts, applying state transitions, submitting a storage fee for bundle execution and earning fees for their work. The operator's chances to be elected as a slot leader and produce a bundle are weighted by their stake. Operators can be nominated by farmers or other SSC holders.
 
+The nomination pools in Subspace are "lazy": any fees earned by the operator are assigned to the pool and are not deposited to the nominators wallet unless they ask for a withdrawal. Unless withdrawn, the fees are "auto-staked" - they count towards the total stake of the pool, increasing its chance of being elected to produce bundles.
 
 ### Stake epoch
 
 Stake epoch is a designated period in domain blocks within a blockchain system that marks each stake allocation re-adjustment period. Occurring every `StakeEpochDuration` blocks (at the moment, it's set to every 100 blocks or ~10 minutes), an epoch transition triggers specific actions such as finalizing operator domain switches, deregistering operators, unlocking operators and their associated funds, and recalculating stake distribution for the Verifiable Random Function (VRF) election. These transitions are designed to adjust the stake distribution dynamically, finalize various staking-related operations, process rewards, and manage deposits and withdrawals. The uniform duration across all domains helps maintain consistency in the network, while the specific starting point for each domain's epoch transition may vary based on when it is registered, helping to amortize the load of these transitions.
 
 :::note
 Read [Subspace Subnomicon](https://subnomicon.subspace.network/docs/category/decoupled-execution) to get a full picture behind decoupled execution!
-:::
-
-
-
-
-
-
+:::

docs/farming-&-staking/staking/operators/deregister-operator.mdx

@@ -86,10 +86,8 @@ Alternatively, you can use the **PolkadotJS** portal to deregister operator.
 7. Select `domains` under `selected contant query` and choose `stakeWithdrawalLockingPeriod`. 
 8. Click on `+` to run the query. 
 
-![Staking-15](/img/doc-imgs/operators-staking/Staking-15.png)
-
 :::info
-Number 256 above corresponds to the number of the domain blocks, and not the consensus chain blocks. 
+The current locking period is set to 14_400 blocks, or 24 hours. 
 :::