added ip safety guidelines

Signed-off-by: ravaga <trueravaga@gmail.com>
This commit is contained in:
ravaga 2025-06-20 19:08:52 +04:00
parent 029526b3fb
commit 401dd1f3c6
No known key found for this signature in database
GPG key ID: 995E84818B97A2F0
11 changed files with 220 additions and 112 deletions

View file

@ -0,0 +1,8 @@
{
"label": "Staking",
"position": 3,
"link": {
"type": "generated-index",
"description": "Learn how to stake Zano and earn rewards through Proof-of-Stake mining."
}
}

View file

@ -0,0 +1,8 @@
{
"label": "Advanced Setup",
"position": 3,
"link": {
"type": "generated-index",
"description": "Advanced staking configurations for servers and automated setups."
}
}

View file

@ -1,5 +1,5 @@
---
sidebar_position: 3
sidebar_position: 1
---
# Server/Console mode Staking

View file

@ -6,11 +6,11 @@ sidebar_position: 2
## Introduction
Staking is an important aspect of Zano, users should be able to effortlessly stake their Zano upon system startup without any intervention, for this well use PM2. PM2 makes it possible to daemonize applications so that they will run in the background as a service.
Staking is an important aspect of Zano, users should be able to effortlessly stake their Zano upon system startup without any intervention, for this we'll use PM2. PM2 makes it possible to daemonize applications so that they will run in the background as a service.
## Install Node.js & NPM
Well also need Node.js, Installing Node.js and NPM is super easy, simply head over to the download page and download the relevant version, their website allows you to download Node.js the way you want.
We'll also need Node.js, Installing Node.js and NPM is super easy, simply head over to the download page and download the relevant version, their website allows you to download Node.js the way you want.
### Windows
@ -36,7 +36,7 @@ sudo apt install nodejs npm
sudo pacman -S npm nodejs
```
You can now type the following to ensure theyre installed and check version:
You can now type the following to ensure they're installed and check version:
```
node -v
@ -90,7 +90,7 @@ Which will then show you a temp mountpoint, this will look something like:
`/tmp/.mount_zano-lHATDRi`
2.  Navigate to this folder, (you may need to check **show hidden files**) then go to the  `usr > bin` folder and copy zanod and simplewallet to a folder of your choosing.
2. Navigate to this folder, (you may need to check **'show hidden files'**) then go to the `usr > bin` folder and copy zanod and simplewallet to a folder of your choosing.
![](/img/stake/stake-on-boot-guide/extracted-zano-binaries.png)
@ -153,7 +153,7 @@ The error: `Script not found: ...\start` is expected, you can ignore it.
#### Linux
```
pm2 start simplewallet -- --wallet-file example.wallet  --password <password> --rpc-bind-ip 127.0.0.1  --rpc-bind-port 11212  --daemon-address 127.0.0.1:11211 --do-pos-mining
pm2 start simplewallet -- --wallet-file example.wallet --password <password> --rpc-bind-ip 127.0.0.1 --rpc-bind-port 11212 --daemon-address 127.0.0.1:11211 --do-pos-mining
```
### PM2 tips
@ -255,4 +255,4 @@ pm2 start <ID>
## Conclusion
Youre now staking your Zano, on system startup automatically.
You're now staking your Zano, on system startup automatically.

View file

@ -0,0 +1,8 @@
{
"label": "Getting Started",
"position": 2,
"link": {
"type": "generated-index",
"description": "Learn the basics of staking Zano and start earning rewards."
}
}

View file

@ -0,0 +1,41 @@
---
sidebar_position: 2
---
# Estimating PoS Rewards
Proof-of-stake earnings depend on the current PoS difficulty and the number of coins being staked. The more coins you stake, the better chance you have to "win" the right to sign the next PoS block. Of course, it's important to estimate your chances and predict how much you can earn in some way. **The most straightforward way to do so is to use the community-made [Staking Simulator](https://zanostats.com/staking).**
:::note
Please keep in mind that this is just an estimation and can vary heavily. Similarly to PoW, you only get a reward if your stake wins a block, and since block creation is probabilistic, your rewards are too.
:::
## Manual Calculation
You can calculate your estimation manually using the following approach:
First, we need to get the current PoS difficulty, which can be found in the [block explorer](https://explorer.zano.org/). This value is then divided by `1000000000000=10¹²`, which in the Zano network is one coin basis.
Second, we again divide it by 288. This operation lets us take the PoS mining timestamp frame into account. Without further details, this factor provides hash variety in PoS mining and can be somewhere between 256 and 320. It's reasonable to use the value of 288 here.
Now we have an estimation of how many coins participate in PoS mining currently as:
```mdx-code-block
$$
C = D_{PoS} \thinspace / \thinspace 288 \thinspace / \thinspace 10^{12} = D_{PoS} \cdot 2.88 \cdot 10^{-14}
$$
Where $C$ is the total amount of coins participating in PoS mining, and $D_{PoS} \thinspace$ is the current PoS difficulty.
```
As you may know, the Zano network emits an average of 1 coin each minute with a 50-50 spread between PoS and PoW. That makes it 720 potential PoS reward coins per day. So if you owned all the coins in PoS, that could be your total daily earnings. And if you divide C*C* by 720, you will get the number of coins you need to mine 1 Zano coin a day. Now, you can estimate the number of coins you will earn as:
```mdx-code-block
$$
E_{daily} = \frac{720 \cdot N}{C} \approx \frac{2.07 \cdot 10^{17} \cdot N}{D_{PoS}}
$$
Where $\thinspace E_{daily} \thinspace$ is the estimated number of coins you'll earn per day, and $N$ is the number of coins you're staking.
```

View file

@ -0,0 +1,60 @@
---
sidebar_position: 1
---
# Staking Zano
Proof-of-stake mining or staking is typically implemented in such a way that a random coin owner obtains the right to sign a new block. Zano PoS implementation keeps miners in full anonymity and is as simple as a push of a button.
## Benefits of Zano Staking
- 100% Anonymous: Your staked balance always remains hidden thanks to our [Zarcanum Technology.](https://docs.zano.org/docs/learn/zano-features/overview#zarcanum-anonymous-proof-of-stake)
- No lock-ups: Unstake your coins at any chosen time.
- No minimum amounts: Stake any amount of ZANO you want.
- Truly decentralized: Anyone can start staking. There are **no** validators or special nodes.
- No slashing.
- Easy-to-use: Flip the switch and start staking.
The only requirement is to run a Zano node (currently, this can only be done on a desktop device). The Zano desktop wallet automatically functions as a Zano node.
There is no "delegation" function in Zano Staking, as we believe that it goes against network decentralization, and running a Zano node takes very few resources.
## How to Stake Zano
Simply open the Zano desktop wallet, make sure the blockchain is synchronised, and turn on the `Staking` switch.
```mdx-code-block
<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0 }}>
<iframe
src="https://www.youtube.com/embed/VruRhPSasPU"
title="YouTube video player"
style={{
position: 'absolute',
top: 0,
left: 0,
width: '100%',
height: '100%'
}}
frameBorder="0"
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
allowFullScreen
/>
</div>
```
:::tip
You can observe your progress in the `Staking` tab of your staking wallet. The amount of earnings depends on the wallet balance. You can switch `Staking` on and off without any limitations.
:::
![Staking Tab on GUI wallet.](/img/stake/staking-zano/zano-staking.jpg)
## Estimating Your Rewards
To understand how much you can earn from staking, check out our guide on [Estimating PoS Rewards](./estimating-pos-rewards.md). This includes both a simple calculator tool and detailed mathematical formulas for manual calculations.

49
docs/stake/overview.md Normal file
View file

@ -0,0 +1,49 @@
---
sidebar_position: 1
---
# Staking Overview
Welcome to the Zano staking documentation! This section will guide you through everything you need to know about staking Zano and earning rewards through Proof-of-Stake mining.
## What is Staking?
Staking in Zano is a way to earn rewards by participating in the network's consensus mechanism. Unlike traditional Proof-of-Work mining that requires expensive hardware, staking allows you to earn rewards simply by keeping your Zano wallet running and connected to the network.
## Key Benefits
- **100% Anonymous**: Your staked balance remains hidden thanks to Zarcanum technology
- **No Lock-ups**: Unstake your coins at any time
- **No Minimum Amounts**: Stake any amount of ZANO
- **Truly Decentralized**: No validators or special nodes required
- **No Slashing**: No penalties for going offline
- **Easy to Use**: Just flip a switch to start staking
## Getting Started
If you're new to staking, start with our **[Getting Started](./getting-started/proof-of-stake-mining.md)** guide, which covers:
- How to stake using the desktop wallet
- Understanding your potential rewards
- Basic staking concepts
## Advanced Setup
For more advanced users, our **[Advanced Setup](./advanced-setup/)** section includes:
- Server/console mode staking
- Automated staking on system startup
- CLI wallet configurations
## Security & Best Practices
Before staking significant amounts, review our **[Security & Best Practices](./security/)** section for:
- Hardware requirements and recommendations
- Security best practices
- IP anonymization techniques
- Network configuration tips
## Ready to Start?
Begin your staking journey with our [Getting Started guide](./getting-started/proof-of-stake-mining.md)!

View file

@ -1,92 +0,0 @@
---
sidebar_position: 1
---
# Staking Zano
Proof-of-stake mining or staking is typically implemented in such a way that a random coin owner obtains the right to sign a new block. Zano PoS implementation keeps miners in full anonymity and is as simple as a push of a button.
## Benefits of Zano Staking
- 100% Anonymous: Your staked balance always remains hidden thanks to our [Zarcanum Technology.](https://docs.zano.org/docs/learn/zano-features/overview#zarcanum-anonymous-proof-of-stake)
- No lock-ups: Unstake your coins at any chosen time.
- No minimum amounts: Stake any amount of ZANO you want.
- Truly decentralized: Anyone can start staking. There are **no** validators or special nodes.
- No slashing.
- Easy-to-use: Flip the switch and start staking.
The only requirement is to run a Zano node (currently, this can only be done on a desktop device). The Zano desktop wallet automatically functions as a Zano node.
There is no "delegation" function in Zano Staking, as we believe that it goes against network decentralization, and running a Zano node takes very few resources.
## How to Stake Zano
Simply open the Zano desktop wallet, make sure the blockchain is synchronised, and turn on the `Staking` switch.
```mdx-code-block
<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0 }}>
<iframe
src="https://www.youtube.com/embed/VruRhPSasPU"
title="YouTube video player"
style={{
position: 'absolute',
top: 0,
left: 0,
width: '100%',
height: '100%'
}}
frameBorder="0"
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
allowFullScreen
/>
</div>
```
:::tip
You can observe your progress in the `Staking` tab of your staking wallet. The amount of earnings depends on the wallet balance. You can switch `Staking` on and off without any limitations.
:::
![Staking Tab on GUI wallet.](/img/stake/staking-zano/zano-staking.jpg)
## Estimating PoS Rewards
Proof-of-stake earnings depend on the current PoS difficulty and the number of coins being staked. The more coins you stake, the better chance you have to “win” the right to sign the next PoS block. Of course, its important to estimate your chances and predict how much you can earn in some way. **The most straightforward way to do so is to use the community-made [Staking Simulator](https://zanostats.com/staking).**
:::note
Please keep in mind that this is just an estimation and can vary heavily. Similarly to PoW, you only get a reward if your stake wins a block, and since block creation is probabilistic, your rewards are too.
:::
You can calculate your estimation manually using the following approach:
First, we need to get the current PoS difficulty, which can be found in the [block explorer](https://explorer.zano.org/). This value is then divided by `1000000000000=10¹²`, which in the Zano network is one coin basis.
Second, we again divide it by 288. This operation lets us take the PoS mining timestamp frame into account. Without further details, this factor provides hash variety in PoS mining and can be somewhere between 256 and 320. Its reasonable to use the value of 288 here.
Now we have an estimation of how many coins participate in PoS mining currently as:
```mdx-code-block
$$
C = D_{PoS} \thinspace / \thinspace 288 \thinspace / \thinspace 10^{12} = D_{PoS} \cdot 2.88 \cdot 10^{-14}
$$
Where $C$ is the total amount of coins participating in PoS mining, and $D_{PoS} \thinspace$ is the current PoS difficulty.
```
As you may know, the Zano network emits an average of 1 coin each minute with a 50-50 spread between PoS and PoW. That makes it 720 potential PoS reward coins per day. So if you owned all the coins in PoS, that could be your total daily earnings. And if you divide C*C* by 720, you will get the number of coins you need to mine 1 Zano coin a day. Now, you can estimate the number of coins you will earn as:
```mdx-code-block
$$
E_{daily} = \frac{720 \cdot N}{C} \approx \frac{2.07 \cdot 10^{17} \cdot N}{D_{PoS}}
$$
Where $\thinspace E_{daily} \thinspace$ is the estimated number of coins you'll earn per day, and $N$ is the number of coins you're staking.
```

View file

@ -0,0 +1,8 @@
{
"label": "Security & Best Practices",
"position": 4,
"link": {
"type": "generated-index",
"description": "Security recommendations and best practices for safe staking."
}
}

View file

@ -1,3 +1,7 @@
---
sidebar_position: 1
---
# Staking Recommendations
In this article we describe our recommendations for configuring secure Zano staking.
@ -6,13 +10,13 @@ In this article we describe our recommendations for configuring secure Zano stak
## Hardware Requirements
Although the daemon and wallet can run on relatively modest configurations, we strongly recommend using computers that meet at least the minimum requirements listed below. Running Zano on a weaker system will increase latency as network load grows and reduce staking efficiency. In some peakload situations, lack of resources may cause the operating system to forcibly terminate the daemon—for example, on Unixlike systems with little RAM the kernels OOM killer may stop the most resourcehungry process (Zano).
Although the daemon and wallet can run on relatively modest configurations, we strongly recommend using computers that meet at least the minimum requirements listed below. Running Zano on a weaker system will increase latency as network load grows and reduce staking efficiency. In some peakload situations, lack of resources may cause the operating system to forcibly terminate the daemon, for example, on Unixlike systems with little RAM the kernel's OOM killer may stop the most resourcehungry process (Zano).
**Requirements**
* **CPU:** modern CPU with 4+ cores
* **Disk:** SSD, 200GB+ free space
* **RAM:** 32GB+
* **CPU:** modern CPU with 4 + cores
* **Disk:** SSD, 200 GB + free space
* **RAM:** 32 GB +
---
@ -22,9 +26,9 @@ You can stake in one of two ways:
### 1. Using the Zano Desktop Application
Simply download the application from the official Zano website, launch it, open your wallet and set the **“Staking”** checkbox to **On**. Keep in mind that enabling staking inside the wallet does not mean staking continues if the application is closed, or the computer is turned off or put to sleep. Staking produces blocks (and revenue) only while the computer is powered on, the application is running, and the internet connection is stable. Pay special attention to your systems **Energy Saving** settings—we have often seen staking performance complaints trace back to logs showing that the computer regularly entered sleep.
Simply download the application from the official Zano website, launch it, open your wallet and set the **"Staking"** checkbox to **On**. Keep in mind that enabling staking inside the wallet does not mean staking continues if the application is closed, or the computer is turned off or put to sleep. Staking produces blocks (and revenue) only while the computer is powered on, the application is running, and the internet connection is stable. Pay special attention to your system's **Energy Saving** settings, we have often seen staking performance complaints trace back to logs showing that the computer regularly entered sleep.
### 2. Using the CLI Versions (`zanod` + `simplewallet`)
### 2. Using the CLI Versions (`zanod` + `simplewallet`)
This approach can be used both on a home computer and on a dedicated server at a hosting provider. In the simplest case you just start `zanod` in one terminal, wait for it to synchronise, and then in another terminal start `simplewallet`, giving it the path to your wallet file and the parameters that put it into staking mode. A minimal example looks like this:
@ -43,7 +47,7 @@ simplewallet --wallet-file=wallet_file.zan --rpc-bind-port=12345 --deaf --do-pos
As a staker, your node will generate blocks and broadcast them to the network. From the frequency of new blocks coming from your IP address, an observer can estimate how much money is being staked in the wallet(s) on that node (especially if you are connected to the internet via a public IP address). To anonymise your IP you can use several approaches:
* **Traditional VPN services.** You hide your real IP address, but because the VPN exit IP will relay your blocks in exactly the same way, an observer can still infer the amount of coins staked that are associated with that exit IP.
* **Restricting the node to trusted peers only.** You can configure your node so that it connects only to a set of peers that you choose and trust. As an example, below we show how to configure the node to connect only to the Zano networks seed nodes (servers maintained by the core team):
* **Restricting the node to trusted peers only.** You can configure your node so that it connects only to a set of peers that you choose and trust. As an example, below we show how to configure the node to connect only to the Zano network's seed nodes (servers maintained by the core team):
```bash
zanod --hide-my-port --use-only-priority-nodes \
@ -63,16 +67,30 @@ zanod --hide-my-port --use-only-priority-nodes \
* `--use-only-priority-nodes` instructs the network layer to connect only to peers specified with `--add-priority-node`.
* `--add-priority-node` adds a host to the prioritynode list.
When configured this way, to an external observer it will look as if all blocks are evenly distributed among the listed nodes. We are not urging users to use these particular servers; toy can setup your own exit nodes or configure to nodes of someone you trust; it should be a conscious choice. The parameters described work for both the daemon (`zanod`) and the Zano Desktop application.
When configured this way, to an external observer it will look as if all blocks are evenly distributed among the listed nodes. While we offer these nodes as part of our core infrastructure, anyone can run their own subset of nodes to accomplish the same result. You can set up your own exit nodes or configure connections to nodes of someone you trust, this should be a conscious choice based on your security requirements. The parameters described work for both the daemon (`zanod`) and the Zano Desktop application.
### Windows Configuration
To run the Zano Desktop application with the same privacy parameters on Windows, you need to create a CMD file with the following content:
```batch
"C:\Program Files\Zano\Zano.exe" --hide-my-port --use-only-priority-nodes --add-priority-node="95.217.43.225:11121" --add-priority-node="94.130.137.230:11121" --add-priority-node="95.217.42.247:11121" --add-priority-node="94.130.160.115:11121" --add-priority-node="195.201.107.230:11121" --add-priority-node="95.217.46.49:11121" --add-priority-node="159.69.76.144:11121" --add-priority-node="144.76.183.143:11121"
```
**Steps to create the CMD file:**
1. Open Notepad or any text editor
2. Copy and paste the command above
3. Save the file with a `.cmd` extension (e.g., `zano-privacy.cmd`)
4. Double-click the CMD file to run Zano with the privacy parameters
**Note:** Make sure to adjust the path to `Zano.exe` if you installed the application in a different location.
---
## General Security Issues
* **Use a firewall** to protect your machine, especially if you are running a server with a public IP address. We recommend blocking all incoming connections and allowing SSH access only from the few IP addresses you use.
* **Do not store the wallet on hosts where mining software is installed.** We have encountered several cases where miners contained malware and keyloggers that stole users wallet files and passwords. Ideally, if you have significant assets staking, set aside a **dedicated machine** with no other software installed.
* **Always watch for critical network updates;** do not miss important upgrades, especially those related to hard forks. We have created a dedicated Telegram channel that publishes only such critical updates: **@zano_critical**.
* **Do not store the wallet on hosts where mining software is installed.** We have encountered several cases where miners contained malware and keyloggers that stole users' wallet files and passwords. Ideally, if you have significant assets staking, set aside a **dedicated machine** with no other software installed.
* **Always watch for critical network updates,** do not miss important upgrades, especially those related to hard forks. We have created a dedicated Telegram channel that publishes only such critical updates: **[@zano_critical](https://t.me/zano_critical)**.
---
*End of guide.*