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

DynComms Development Branch #8755

Conversation

ProofOfKeags
Copy link
Collaborator

@ProofOfKeags ProofOfKeags commented May 14, 2024

Change Description

Depends on #8270.
Depends on #8981

This is a series of single responsibility commits that improve the state of affairs within the channel state machine. The ultimate goal here in service of the Dynamic Commitments project is to make it such that we no longer have the updateLogs contain paymentDescriptors as the fundamentally tracked unit of update. This is unfortunately a long road which requires a number of changes which on their face do not seem necessary. I assure you that every one of these commits is ultimately in service of that goal, though.

It is highly recommended that you review commits one by one and in order. One of the consequences of having atomic, semantics-invariant commits is that some subsequent commits may ultimately make prior commits partially or fully obsolete. This is the price of making commit-by-commit review easy.

There is no specific requirement that every commit in this PR go in at once. This PR is mergeable at every commit and will be semantics-invariant.

Godspeed 🫡

Steps to Test

make unit pkg=lnwallet

Pull Request Checklist

Testing

  • Your PR passes all CI checks.
  • Tests covering the positive and negative (error paths) are included.
  • Bug fixes contain tests triggering the bug to prevent regressions.

Code Style and Documentation

📝 Please see our Contribution Guidelines for further guidance.

Copy link
Contributor

coderabbitai bot commented May 14, 2024

Important

Review skipped

Auto reviews are limited to specific labels.

Labels to auto review (1)
  • llm-review

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.


Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

Share
Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>.
    • Generate unit testing code for this file.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai generate interesting stats about this repository and render them as a table.
    • @coderabbitai show all the console.log statements in this repository.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@ProofOfKeags ProofOfKeags force-pushed the refactor/lnwallet-channel branch 4 times, most recently from 2778680 to a4ee3cd Compare May 25, 2024 01:45
@ProofOfKeags ProofOfKeags force-pushed the refactor/lnwallet-channel branch 3 times, most recently from 54d6de0 to 27860c7 Compare June 12, 2024 23:04
@ProofOfKeags ProofOfKeags force-pushed the refactor/lnwallet-channel branch 2 times, most recently from b2b0307 to 9a1a6a0 Compare June 15, 2024 00:58
@GeorgeTsagk GeorgeTsagk self-requested a review June 15, 2024 09:45
@ProofOfKeags ProofOfKeags force-pushed the refactor/lnwallet-channel branch 3 times, most recently from 4f9cab7 to 8113434 Compare July 11, 2024 00:07
@ProofOfKeags ProofOfKeags force-pushed the refactor/lnwallet-channel branch 4 times, most recently from cf02b81 to aaaaa3a Compare July 19, 2024 23:59
@ProofOfKeags ProofOfKeags marked this pull request as ready for review July 20, 2024 00:04
This commit begins the process of moving towards a more principled
means of state tracking. We eliminate the mutateState argument from
processAddEntry and processRemoveEntry and move the responsibility
of mutating said state to the call-sites.

The current call-sites of these functions still have their *own*
mutateState argument which will be eliminated during upcoming commits.
However, following the principle of micro-commits I opted to break
these changes up to make review simpler.
This commit redoes the API and semantics of processFeeUpdate to make
it consistent with the semantics of it's sister functions. This is
part of an ongoing series of commits to remove mutateState arguments
pervasively from the codebase.

As with the previous commit this makes state mutation the caller's
responsibility. This temporarily increases code duplication at the
call-sites, but this will unlock other refactor opportunities.
In this commit we observe that the previous commit reduced the role
of this function to a single assignment statement with numerous newly
irrelevant parameters. This commit makes the choice of inlining it at
the two call-sites within evaluateHTLCView and removing the funciton
definition entirely. This also allows us to drop a huge portion of
newly irrelevant test code.
This commit makes the observation that the nextHeight parameter of
these two functions is no longer used by those funcitons themselves
as a result of extracting the state mutation to the call-sites.
This removes the parameter entirely.
In line with previous commits we are progressively removing the
mutateState argument from this call stack for a more principled
software design approach.

NOTE FOR REVIEWERS:
We take a naive approach to updating the tests here and simply
take the functionality we are removing from evaluateHTLCView and
run it directly after the function in the test suite.

It's possible that we should instead remove this from the test
suite altogether but I opted to take a more conservative approach
with respect to reducing the scope of tests. If you have opinions
here, please make them known.
This commit removes another raw boolean value and replaces it with
a more clear type/name. This will also assist us when we later try
and consolidate the logic of evaluateHTLCView into a single
coherent computation.
This commit moves the collection of updates behind a Dual structure.
This allows us in a later commit to index into it via a ChannelParty
parameter which will simplify the loops in evaluateHTLCView.
This commit simplifies how we compute the commitment fee rate based
off of the live updates. Prior to this commit we processed all of
the FeeUpdate paymentDescriptors of both ChannelParty's. Now we only
process the last FeeUpdate of the OpeningParty
We had four for-loops in evaluateHTLCView that were exact mirror
images of each other. By making use of the new ChannelParty and
Dual facilities introduced in prior commits, we consolidate these
into two for-loops.
This further reduces loop complexity in evaluateHTLCView by using
explicit filter steps rather than loop continue statements.
This commit observes that processAddEntry and processRemoveEntry
are only invoked at a single call-site. Here we inline them at their
call-sites, which will unlock further simplifications of the code
that will allow us to remove pointer mutations in favor of explicit
expression oriented programming.

We also delete the tests associated with these functions, the overall
functionality is implicitly tested by the TestEvaluateHTLCView tests.
Here we return the balance deltas from evaluateHTLCView rather than
passing in references to variables that will be modified. It is a
far cleaner and compositional approach which allows readers of this
code to more effectively reason about the code without having to
keep the whole codebase in their head.
This commit takes the CommitChainEpochHistory defined in the last
commit and adds it to the OpenChannel structure. As of this commit
it is essentially redundant with the ChanCfgs but it will capture
the history of the ChanCfgs when we add the ability to update them.
…each

This commit changes the way we create breach retributions to use the
CsvDelay we compute from the CommitChainEpochHistory so as to account
for the possibility that the channel parameters have changed since
opening.
@lightninglabs-deploy
Copy link

@ProofOfKeags, remember to re-request review from reviewers when ready

@carlaKC
Copy link
Collaborator

carlaKC commented Sep 13, 2024

Completed a high level pass on this, great refactor with really nice commit structure 🙏
Noticed that a lot of this is pulled out into #9097 - is that what we should review?

@ProofOfKeags ProofOfKeags marked this pull request as draft September 13, 2024 22:22
@ProofOfKeags ProofOfKeags changed the title DynComms [2/n]: Refactor Channel State Machine DynComms Staging Branch Oct 1, 2024
@ProofOfKeags ProofOfKeags changed the title DynComms Staging Branch DynComms Development Branch Oct 1, 2024
@ProofOfKeags
Copy link
Collaborator Author

Closing this as it is superseded by #9158 and #9097

@saubyk saubyk removed this from the v0.19.0 milestone Oct 15, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
dynamic commitments incomplete WIP PR, not fully finalized, but light review possible
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants