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

docs: Liquid staking ADR #13239

Merged
merged 21 commits into from
Sep 23, 2022
Merged

docs: Liquid staking ADR #13239

merged 21 commits into from
Sep 23, 2022

Conversation

zmanian
Copy link
Member

@zmanian zmanian commented Sep 12, 2022

ADR to upgrade the staking/distr/slashing module to support the liquid staking design from #12917

@zmanian zmanian requested a review from a team as a code owner September 12, 2022 08:13
docs/architecture/adr-061-liquid-staking.md Show resolved Hide resolved
docs/architecture/adr-061-liquid-staking.md Outdated Show resolved Hide resolved
docs/architecture/adr-061-liquid-staking.md Outdated Show resolved Hide resolved
docs/architecture/adr-061-liquid-staking.md Outdated Show resolved Hide resolved
docs/architecture/adr-061-liquid-staking.md Outdated Show resolved Hide resolved
docs/architecture/adr-061-liquid-staking.md Outdated Show resolved Hide resolved
docs/architecture/adr-061-liquid-staking.md Outdated Show resolved Hide resolved
docs/architecture/adr-061-liquid-staking.md Outdated Show resolved Hide resolved
docs/architecture/adr-061-liquid-staking.md Outdated Show resolved Hide resolved
docs/architecture/adr-061-liquid-staking.md Outdated Show resolved Hide resolved
Copy link
Contributor

@alexanderbez alexanderbez left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@marbar3778 @hxrts @okwme any interest in taking a look at this?

Copy link
Member

@tac0turtle tac0turtle left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks good to me, there doesn't seem to be substantial changes for users other than min self bond correct?


A new governance parameter is introduced that defines the ratio of exempt to issued tokenized shares. This is called the exemption factor.

Min self delegation is removed from the staking system with the expectation that it will be replaced by the exempt delegations sytem. The exempt delegation system allows multiple accounts to demonstrate economic alignment with the validator operator as team members, partners etc without co-mingling funds. The exempt delegation will likely be required to grow the validators business under widespread adoption of liquid staking and where governence sets the exemption factor.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I keep forgetting if a larger exemption factor means more exempt delegations are required to issue delegation shares or if it's the other way around. Can we get a sentence that states that clearly?

Copy link
Member

@tac0turtle tac0turtle left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@zmanian could you address sam's comments then we can merge

@alexanderbez alexanderbez changed the title Liquid staking ADR docs: Liquid staking ADR Sep 21, 2022
Copy link
Contributor

@likhita-809 likhita-809 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

just nits

docs/architecture/adr-061-liquid-staking.md Outdated Show resolved Hide resolved
docs/architecture/adr-061-liquid-staking.md Outdated Show resolved Hide resolved
docs/architecture/adr-061-liquid-staking.md Outdated Show resolved Hide resolved
docs/architecture/adr-061-liquid-staking.md Outdated Show resolved Hide resolved
@tac0turtle tac0turtle enabled auto-merge (squash) September 23, 2022 19:30
@tac0turtle tac0turtle merged commit ddf1dd4 into main Sep 23, 2022
@tac0turtle tac0turtle deleted the zaki-liquid-staking-adr branch September 23, 2022 19:35

### `MsgTokenizeShares`

The MsgTokenizeShares message is used to create tokenize delegated tokens. This message can be executed by any delegator who has positive amount of delegation and after execution the specific amount of delegation disappear from the account and share tokens are provided. Share tokens are denominated in the validator and record id of the underlying delegation.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Share tokens are denominated in the validator and record id of the underlying delegation.

It's not clear what the record id is here

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

9 participants