From 401dd1f3c6091b3839784cb1184fdf7b6863bdcc Mon Sep 17 00:00:00 2001 From: ravaga Date: Fri, 20 Jun 2025 19:08:52 +0400 Subject: [PATCH] added ip safety guidelines Signed-off-by: ravaga --- docs/stake/_category_.json | 8 ++ docs/stake/advanced-setup/_category_.json | 8 ++ .../{ => advanced-setup}/remote-server-pos.md | 2 +- .../stake-zano-on-boot.mdx | 12 +-- docs/stake/getting-started/_category_.json | 8 ++ .../getting-started/estimating-pos-rewards.md | 41 +++++++++ .../getting-started/proof-of-stake-mining.md | 60 ++++++++++++ docs/stake/overview.md | 49 ++++++++++ docs/stake/proof-of-stake-mining.md | 92 ------------------- docs/stake/security/_category_.json | 8 ++ .../proof-of-stake-recommendations.md} | 44 ++++++--- 11 files changed, 220 insertions(+), 112 deletions(-) create mode 100644 docs/stake/_category_.json create mode 100644 docs/stake/advanced-setup/_category_.json rename docs/stake/{ => advanced-setup}/remote-server-pos.md (99%) rename docs/stake/{ => advanced-setup}/stake-zano-on-boot.mdx (86%) create mode 100644 docs/stake/getting-started/_category_.json create mode 100644 docs/stake/getting-started/estimating-pos-rewards.md create mode 100644 docs/stake/getting-started/proof-of-stake-mining.md create mode 100644 docs/stake/overview.md delete mode 100644 docs/stake/proof-of-stake-mining.md create mode 100644 docs/stake/security/_category_.json rename docs/stake/{_proof-of-stake-recommendations.md => security/proof-of-stake-recommendations.md} (56%) diff --git a/docs/stake/_category_.json b/docs/stake/_category_.json new file mode 100644 index 0000000..71f19c8 --- /dev/null +++ b/docs/stake/_category_.json @@ -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." + } +} \ No newline at end of file diff --git a/docs/stake/advanced-setup/_category_.json b/docs/stake/advanced-setup/_category_.json new file mode 100644 index 0000000..f23fc9f --- /dev/null +++ b/docs/stake/advanced-setup/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Advanced Setup", + "position": 3, + "link": { + "type": "generated-index", + "description": "Advanced staking configurations for servers and automated setups." + } +} \ No newline at end of file diff --git a/docs/stake/remote-server-pos.md b/docs/stake/advanced-setup/remote-server-pos.md similarity index 99% rename from docs/stake/remote-server-pos.md rename to docs/stake/advanced-setup/remote-server-pos.md index 142eb67..d621fca 100644 --- a/docs/stake/remote-server-pos.md +++ b/docs/stake/advanced-setup/remote-server-pos.md @@ -1,5 +1,5 @@ --- -sidebar_position: 3 +sidebar_position: 1 --- # Server/Console mode Staking diff --git a/docs/stake/stake-zano-on-boot.mdx b/docs/stake/advanced-setup/stake-zano-on-boot.mdx similarity index 86% rename from docs/stake/stake-zano-on-boot.mdx rename to docs/stake/advanced-setup/stake-zano-on-boot.mdx index 4471a96..46f9107 100644 --- a/docs/stake/stake-zano-on-boot.mdx +++ b/docs/stake/advanced-setup/stake-zano-on-boot.mdx @@ -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 we’ll 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 -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. +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 they’re 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 --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 --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 ## Conclusion -You’re now staking your Zano, on system startup automatically. +You're now staking your Zano, on system startup automatically. diff --git a/docs/stake/getting-started/_category_.json b/docs/stake/getting-started/_category_.json new file mode 100644 index 0000000..3cd75d5 --- /dev/null +++ b/docs/stake/getting-started/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Getting Started", + "position": 2, + "link": { + "type": "generated-index", + "description": "Learn the basics of staking Zano and start earning rewards." + } +} \ No newline at end of file diff --git a/docs/stake/getting-started/estimating-pos-rewards.md b/docs/stake/getting-started/estimating-pos-rewards.md new file mode 100644 index 0000000..55330cf --- /dev/null +++ b/docs/stake/getting-started/estimating-pos-rewards.md @@ -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. +``` \ No newline at end of file diff --git a/docs/stake/getting-started/proof-of-stake-mining.md b/docs/stake/getting-started/proof-of-stake-mining.md new file mode 100644 index 0000000..52869c4 --- /dev/null +++ b/docs/stake/getting-started/proof-of-stake-mining.md @@ -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 +
+