From 3dbee66bc3c17b3aca4e9489c286599443a6bd72 Mon Sep 17 00:00:00 2001
From: serinko <97586125+serinko@users.noreply.github.com>
Date: Mon, 5 Aug 2024 14:27:44 +0200
Subject: [PATCH] add ascii reward flow

---
 .../operators/src/tokenomics/fair-mixnet.md   |  2 +-
 .../src/tokenomics/mixnet-rewards.md          | 56 +++++++++++++++----
 2 files changed, 47 insertions(+), 11 deletions(-)

diff --git a/documentation/operators/src/tokenomics/fair-mixnet.md b/documentation/operators/src/tokenomics/fair-mixnet.md
index 3619a8c376..fee04ce72a 100644
--- a/documentation/operators/src/tokenomics/fair-mixnet.md
+++ b/documentation/operators/src/tokenomics/fair-mixnet.md
@@ -4,7 +4,7 @@
 **The data on this page were last time updated on <!--cmdrun cd ../../../scripts/cmdrun && ./api_targets.py time_now-->.**
 ```
 
-Nym Network is composed of two main elements, the Mixnet represented by [Nym Nodes](../nodes/nym-node.md) routing and mixing the data packets, and Nyx blockchain based on [validator set](validator-rewards.md), using smart contracts (based on [cosmwasm]()) to monitor and reward Nym Nodes by querying API endpoints and distributing NYM token to operators from Mixmining pool.
+Nym Network is composed of two main elements, the Mixnet represented by [Nym Nodes](../nodes/nym-node.md) routing and mixing the data packets, and Nyx blockchain based on [validator set](validator-rewards.md), using smart contracts (based on [cosmwasm]()) to monitor and reward Nym Nodes by querying API endpoints and distributing NYM token to operators from Mixmining pool. All Nym nodes and validators are run by decentralised community of operators.
 
 * Nym tokenomics are based on the research paper [*Reward Sharing for Mixnets*](https://nymtech.net/nym-cryptoecon-paper.pdf)
 * For a more comprehensive overview, live data and supply graphs, cisit [nymtech.net/about/token](https://nymtech.net/about/token)
diff --git a/documentation/operators/src/tokenomics/mixnet-rewards.md b/documentation/operators/src/tokenomics/mixnet-rewards.md
index be79fbd6fe..d419cc98c9 100644
--- a/documentation/operators/src/tokenomics/mixnet-rewards.md
+++ b/documentation/operators/src/tokenomics/mixnet-rewards.md
@@ -1,22 +1,58 @@
 # Nym Operators Rewards
 
-```admonish info
+```admonish info title="\*Info"
 **The data on this page were last time updated on <!--cmdrun cd ../../../scripts/cmdrun && ./api_targets.py time_now-->.**
 ```
-<!--
-ADD:
 
-PAGE: https://nymtech.net/about/token
-WP: https://nymtech.net/nym-cryptoecon-paper.pdf
+* Nym tokenomics are based on the research paper [*Reward Sharing for Mixnets*](https://nymtech.net/nym-cryptoecon-paper.pdf)
+* For a more comprehensive overview, live data and supply graphs, cisit [nymtech.net/about/token](https://nymtech.net/about/token)
+
+## Overview
+
+* The operators of `nym-node` get rewarded from Mixmining pool, which emits around 6000 NYM per hour.
+* An active set of `nym-nodes` selected for Nym network routing and mixing is 240 nodes in total and it's selected for each new epoch (60 min)
+* `nym-nodes` can run in mode `entry-gateway`, `exit-gateway` and `mixnode`, active set selection is composed of
+  	- `mixnode`: 120
+	- `entry-gateway`:
+	- `exit-gateway`:
+* Nym network can be used in two ways, both using the same active set:
+	- Mixnet: 5 layers routing and mixing - full privacy
+	- Wireguard: 2 layers routing (skipping mixnodes) - fast mode
+* The rewards arew distributed between the layers according to a [decision made by the operators](https://forum.nymtech.net/t/poll-what-should-be-the-split-of-mixmining-rewards-among-the-layers-of-the-nym-mixnet/407) as follows:
+	- 5-hop: 16%-16%-16%-16%
+	- 2-hop: 33%-67%
+
+~~~admonish tip title="Nym network active set distribution"
+```ascii
+
+ Network
+ layer:           1.           2.           3.           4.           5.
 
 
-Rewards split:
-16-16-16-16-36
-33-67
-https://forum.nymtech.net/t/poll-what-should-be-the-split-of-mixmining-rewards-among-the-layers-of-the-nym-mixnet/407
--->
+                            ┌► mixnode ─┐   mixnode      mixnode
+                            │           │
+ Node             entry     │           │                             exit
+ type:            gateway ──┘  mixnode  │   mixnode  ┌─► mixnode ───► gateway
+                                        │            │
+                                        │            │
+                               mixnode  └─► mixnode ─┘   mixnode
 
 
+ Active set
+ selection:       60           40           40           40           60
+
+
+ Rewards
+ distribution     16%          16%          16%          16%          36%
+ 5-hop mode:
+
+
+ Rewards
+ distribution     33%          skip         skip         skip         67%
+ 2-hop mode:
+
+```
+~~~
 
 ## Supply