Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update docs about staking #141

Merged
merged 10 commits into from
Feb 6, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
85 changes: 85 additions & 0 deletions docs/basics/content-staking/Overview.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
---
id: content-staking
title: Content Staking
description: Content Staking allows you to lock 2,000 SUB and get SUB rewards by actively using Subsocial and interacting with the best content.
keywords: [Subsocial, Staking, Rewards, Creators, Content, Polkadot]
---
*Content Staking is currently in beta and subject to change.*

The Content Staking system has two main objectives: grow the network, and improve curation. Here, we will look at how the system functions.

Heavy inspiration was taken from the Dapp Staking system implemented on Astar Network,
aimed at incentivizing developers to build applications on the network.
Content Staking incentivizes creators to make posts, and users to like, share, and comment on posts that they think are high quality.
This gives the network a signal about what content is high quality, and provides rewards for creators, which will help attract creators to Subsocial.

To participate in Content Staking, users need to lock at least 2,000 SUB [here](https://sub.id/creators).
Once tokens are locked, a user can start liking posts
on Subsocial, and they will receive rewards every week. Creators of the posts that a user likes will also receive rewards,
thanking them for their great content. The more tokens a user locks, the higher their rewards will be.

Locked tokens will be subject to a roughly 7 day unlocking period.
After the unlocking period, another transaction will be required to claim the unlocked the tokens.

## Rewards
Users with locked tokens will receive SUB rewards for each post or comment that they like in a day,
up to a maximum of 10 per day (for a weekly total of 70, as rewards are calculated weekly).
The creators of those liked posts will also receive rewards. Past 10 likes, a user's rewards will not increase,
and neither will the total amount of rewards for creators. As a simple example, if Alice receives 100 SUB for liking 10 posts from 10 different creators,
each creator will receive 10 SUB (100/10). If Alice likes 20 posts from 20 different creators, she will still receive 100 SUB,
but each creator will only get 5 SUB (100/20).

At the moment, total staking rewards are 1,242,000 SUB per month. 45% of these rewards are allocated for stakers, 50% for creators, and 5% for applications.
These rewards are currently taken from the treasury, but may come from inflation in the future.

Rewards for creators depend on how many likes they get, and how many tokens each liker has locked.
Likewise, rewards for applications depend on how many tokens each user has locked.

# Reward Splitting

In some circumstances, rewards may be split between multiple users.

If Alice posts in her own space, she will receive 100% of the rewards given to her post.

If Alice posts in Bob's space, Alice will receive 80% of the rewards given to her post, and Bob will receive 20%. In this case,
maybe Bob's space has a huge amount of followers, and will provide Alice with extra exposure, ultimately rewarding her more, even though she only gets 80%.

Likewise, rewards will be split for comments and shared posts.

- For comments, the author of the comment will receive 80%, and 20% of the rewards for the comment will go to the creator of the original post.

- For shared posts, 50% of the reward will go to the user that shared a post (and maybe added some additional text or info along with it),
and 50% will go to the original poster.

The reward splitting mechanism will help to further reward great creators, and those who increase network activity and engagement among users.

# Reward Multiplier

Staking rewards are inversely correlated to the percent of users with locked SUB that liked posts or comments during the previous week.
For example, if there are 100 users that each lock 5,000 SUB, there will be 500,000 SUB locked. If 50 users like 10 posts per day, every day during the week,
and the other 50 users like 0 posts, then only 50% of the users liked posts. This will result in a 2x reward boost for the users that did like posts (1/50%).

This multplier caps at 4x, or 25%. Using the above example, if only 20 users liked posts, and 80 did not, that would be 20%,
yielding a multipler of 5x. However, it caps at 4x, and the users that liked posts would only receive a 4x boost to their rewards.

In reality, the multiplier is based on SUB locked, not users, as users are likely to lock different amounts of SUB, and like different amounts of posts.
If Alice locks 10,000 SUB and likes 70 posts during the week, and Bob locks 90,000 SUB and only likes 10 posts during the week,
the calculation will look like this:

Total amount of points possible = (10,000 + 90,000) x 70 = 7,000,000

Alice's points = 10,000 x 70 = 70,000

Bob's points = 90,000 x 10 = 900,000

Combined, Alice and Bob used 970,000 points, out of a possible 7,000,000. This is only 13.85% of the total possible,
which will give them both a 4x boost to their rewards. In this example, Alice ends up benefiting because Bob did not like a full 70 posts. Note that if Bob had liked a full 70 posts, the multiplier would be 1x, and Alice's rewards would be lower, but Bob's would be higher, even without the multiplier.

![](../../../static/img/StakingRewardMultiplier.png)

---

While Subsocial does not need staking for network validation (as it is secured by Polkadot),
the implementation of Creator Staking will still positively benefit the network,
by transferring token share from those are not participating in network growth,
to those that are, as well as aiding in network curation and incentiving high quality creators.
2 changes: 1 addition & 1 deletion docs/basics/faq/Overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -113,7 +113,7 @@ check out this [article](https://polkaverse.com/@cryptoswim/how-ipfs-fits-into-t
SUB tokens are the native token of the Subsocial blockchain, and can be used to interact with the network.
You can use your SUB tokens to create a space, make posts, and interact with others on Subsocial,
by following them, or commenting and voting on their posts. Currently, you can also tip other users using your SUB tokens,
or stake towards your favorite creators to earn rewards for yourself and them.
or lock them to take part in [Content Staking](/docs/basics/content-staking/content-staking).

You can also burn SUB to generate energy, allowing you to complete transations with reduced fees.

Expand Down
7 changes: 3 additions & 4 deletions docs/basics/glossary/Overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -146,10 +146,9 @@ Tipping is the simplest way to reward someone for the content they have created,
or simply a joke that made you laugh. Tips will go directly to the account that created the post or comment,
with no intermediary skimming some off of the top, like what happens on existing content monetization platforms.

## Creator Staking
[Creator Staking](https://docs.subsocial.network/docs/tutorials/how-to-stake) allows token holders to lock up tokens for 7+ days
by staking towards specific Registered Creators.
Stakers earn SUB rewards based on how many tokens they stake, and Creators earn rewards based on how many SUB tokens are staked towards them.
## Content Staking
[Content Staking](/docs/basics/content-staking/content-staking) allows token holders to lock up tokens for 7+ days and earn rewards for creating, liking,
sharing, or commenting on posts.

## Subscriptions
Subscriptions will allow you to set up recurring payments for access to a creator’s Space or other unique content.
Expand Down
11 changes: 4 additions & 7 deletions docs/basics/tokenomics/Token-distribution.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,17 +26,14 @@ The only way to use tokens from the treasury is to submit a treasury proposal th

## Inflation

In the future, token supply inflation will begin, and each block produced will mint more tokens as a reward for important participants of the network.
Initial inflation will be set at 1.58% annually, and can be changed later via on-chain governance.
At the time of writing, 90% of inflation is allocated towards Creator Staking rewards, and 10% towards the treasury.
These values can be changed in the future via on-chain governance.
Token supply inflation will likely begin in the future, and each block produced will mint more tokens as a reward for important participants of the network.
Inflation was previously set at 1.58% annually, during the Creator Staking beta, and was later removed.

The parameters may be adjusted to reflect market conditions.
The network needs to ensure that inflation doesn’t negatively impact the utility of existing tokens,
but is sufficient to reward certain important participants, such as collators, for performing necessary functions.

Before inflation begins, a distribution split will be determined, to decide what percentage of inflation goes to collators, dapp stakers, etc.
Before inflation begins, a distribution split will be determined, to decide what percentage of inflation goes to collators, applications, creators, etc.
This distribution split will be under the control of on-chain governance and will be able to be changed.

It is important to note that as long as token holders can beat inflation by staking,
inflation is not a problem, and is actually beneficial, as it incentivizes network security.
inflation is not a problem, and is actually beneficial, as it can incentivize network growth.
2 changes: 1 addition & 1 deletion docs/basics/tokenomics/Treasury.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,5 +6,5 @@ title: Treasury
Subsocial will follow the lead of Polkadot by implementing an on-chain treasury
which is controlled by token holders.

We have not made a final decision on when on-chain governance (and hence the treasury) will
A final decision has not been made on when on-chain governance (and hence the treasury) will
be initiated.
7 changes: 1 addition & 6 deletions sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -54,12 +54,8 @@ module.exports = {
'basics/tokenomics/token-distribution',
'basics/tokenomics/treasury',
],
"Creator Staking": [
'basics/creator-staking/creator-staking',
'basics/creator-staking/lazy-staking',
'basics/creator-staking/active-staking',
],
},
'basics/content-staking/content-staking',
'basics/faq/overview',
'basics/glossary/overview'
],
Expand Down Expand Up @@ -92,7 +88,6 @@ module.exports = {
"tutorials/GetSUB/stellaswap",
]
},
"tutorials/how-to-stake",
"tutorials/mobile-tutorial",
"tutorials/usernames",
"tutorials/grill-faq",
Expand Down
Loading