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

chore: add docs for new CL logic #4918

Merged
merged 5 commits into from
Apr 16, 2023
Merged

chore: add docs for new CL logic #4918

merged 5 commits into from
Apr 16, 2023

Conversation

czarcas7ic
Copy link
Member

@czarcas7ic czarcas7ic commented Apr 14, 2023

Closes: #XXX

What is the purpose of the change

We added superfluid capabilities to full range concentrated liquidity positions. This required tweaking some logic in both lockup and superfluid (as well as CL itself).

This PR adds notes to all three module READMEs to document the respective changes.

Documentation and Release Note

  • Does this pull request introduce a new feature or user-facing behavior changes? (yes / no)
  • Is a relevant changelog entry added to the Unreleased section in CHANGELOG.md? (yes / no)
  • How is the feature or change documented? (not applicable / specification (x/<module>/spec/) / Osmosis docs repo / not documented)

@czarcas7ic czarcas7ic added the V:state/compatible/no_backport State machine compatible PR, depends on prior breaks label Apr 14, 2023
@czarcas7ic czarcas7ic marked this pull request as ready for review April 14, 2023 23:30
Copy link
Member

@p0mvn p0mvn left a comment

Choose a reason for hiding this comment

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

LGTM. Excellent job

Have you gotten a chance to port over the important details we were discussing in the reviews as well?

x/concentrated-liquidity/README.md Outdated Show resolved Hide resolved
x/concentrated-liquidity/README.md Outdated Show resolved Hide resolved

### Locked and Unlocked Balancer to Concentrated

The locked<>locked and unlocked<>unlocked migration is just a subset of the above-described migration. The Lockup module account that was holding the original GAMM shares sends them back to the user, deleting the GAMM lock in the process. These shares are used to claim the underlying two assets from the GAMM pool, which are then immediately put into a full range Concentrated Liquidity position in the canonical Concentrated Liquidity pool.
Copy link
Member

Choose a reason for hiding this comment

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

Not sure I'm getting the subset part. Above what migration? 2 were described

Copy link
Member Author

Choose a reason for hiding this comment

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

Clarified here e105eac


### Balancer to Concentrated with No Lock

This is an even smaller subset of the above described migration. The GAMM shares are claimed for the underlying two assets, which are then immediately put into a full range concentrated liquidity position in the canonical concentrated liquidity pool. No locks are involved in this migration.
Copy link
Member

Choose a reason for hiding this comment

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

I think I get what you mean by subset now but it really confused me above. Consider changing

Copy link
Member Author

Choose a reason for hiding this comment

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

Clarified here e105eac


### Locked and Unlocked Balancer to Concentrated

The locked<>locked and unlocked<>unlocked migration is just a subset of the above-described migration. The Lockup module account that was holding the original GAMM shares sends them back to the user, deleting the GAMM lock in the process. These shares are used to claim the underlying two assets from the GAMM pool, which are then immediately put into a full range Concentrated Liquidity position in the canonical Concentrated Liquidity pool.
Copy link
Member

Choose a reason for hiding this comment

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

To be clear, consider specifying that this is all happening within the same message

Copy link
Member Author

Choose a reason for hiding this comment

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

@czarcas7ic czarcas7ic merged commit d93d153 into main Apr 16, 2023
@czarcas7ic czarcas7ic deleted the adam/cl-sf-docs branch April 16, 2023 01:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
C:docs Improvements or additions to documentation C:x/concentrated-liquidity C:x/lockup C:x/superfluid V:state/compatible/no_backport State machine compatible PR, depends on prior breaks
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants