blackpaper

docs/blackpaper/3_emissions.md

@@ -25,3 +25,16 @@ Trust Score = (Number of Modules that voted for you) / (Total Number of Modules)
 This allows for a flexible system where the network can decide to be more stake weighted or trust weighted. This allows for a more flexible network that can adapt to different use cases.
 
 
+**yumaswap**
+
+The yumaswap protocal uses the uniswap protocal to incentivize early stakers more than later stakers. This is done by using a bonding curve to calculate the rewards. The bonding curve is defined as the following:
+
+```python
+reward = emission * (1 - delegation_fee) * (stake / total_stake)
+```
+
+The reward is then added to the stake of the module. The total stake is the sum of all stakes on the module. The delegation_fee is the fee the module takes from the reward. The emission is the total emission of the module.
+
+
+
+

docs/blackpaper/5_staking.md

@@ -3,17 +3,38 @@ Staking
 
 To stake to a module you need to convert your tokens into stake onto a module. This stake can then be used by the module to vote. The delegation_fee is the percentage the module gets from the dividends only. If alice has a validator with 10 tokens with a fee of 20 and bob comes in and puts 100 tokens onto alice, alice will recieve 20% + (10 Alice Tokens / 110 Total Tokens) * 80% of the emission. Alice can raise the fee between 5 and 100 percent. Please note that the fee is only taken from the dividends, and not the total emission. 
 
+
 ```python
-c.stake('5E2SmnsAiciqU67pUT3PcpdUL623HccjarKeRv2NhZA2zNES', 100, netuid=10)
+c.stake(module='5E2SmnsAiciqU67pUT3PcpdUL623HccjarKeRv2NhZA2zNES', amount=100, netuid=10)
 ```
+
+![Alt text](image_stake_single.png)
+
 or to stake multiple amounts to multiple keys, you can do so like this
 
 ```python
 c.stake_multiple(modules=['5E2SmnsAiciqU67pUT3PcpdUL623HccjarKeRv2NhZA2zNES', '5ERLrXrrKPg9k99yp8DuGhop6eajPEgzEED8puFzmtJfyJES'], amounts=[100, 100], netuid=10)
 ```
 
+![Alt text](image_stake_multiple.png)
+
+
 to transfer 100 between two registered modules you can do so like this.
 
 ```python
 c.transfer_stake('5E2SmnsAiciqU67pUT3PcpdUL623HccjarKeRv2NhZA2zNES', '5ERLrXrrKPg9k99yp8DuGhop6eajPEgzEED8puFzmtJfyJES', 100, netuid=10)
 ```
+
+
+
+Staking Rewards
+
+The staking rewards are calculated by the following formula:
+
+```python
+reward = emission * (1 - delegation_fee) * (stake / total_stake)
+```
+
+The reward is then added to the stake of the module. The total stake is the sum of all stakes on the module. The delegation_fee is the fee the module takes from the reward. The emission is the total emission of the module.
+
+![Alt text](image_staking_rewards.png)