Free holding cells immediately rather than in message sending - #4320

Merged
tnull merged 1 commit into
lightningdevkit:mainfrom
TheBlueMatt:2026-01-live-holding-cells
Jan 21, 2026
Merged

Free holding cells immediately rather than in message sending#4320
tnull merged 1 commit into
lightningdevkit:mainfrom
TheBlueMatt:2026-01-live-holding-cells

Conversation

@TheBlueMatt

Copy link
Copy Markdown
Collaborator

I noted in review for an unrelated PR that adding more per-channel logic in ChannelManager::get_and_clear_pending_msg_events really sucks for our performance, especially if it ends up hitting a sync monitor persistence. This made me wonder how far we actually are from not needing the holding check_free_holding_cells call that's currently there.

Turns out, at least according to our functional test coverage, the answer is "not very far".

Thus, here we drop it in favor of consistently calling a new util method on channels that might have the ability to release holding cell updates in the same lock where they change state, rather than waiting until get_and_clear_pending_msg_events.

We still process async monitor events in
get_and_clear_pending_msg_events, which can lead to channel (and monitor) updates, but that should only be the case for async persist applications, which then are likely to have fast ChannelMonitorUpdate in-line handling logic (cause its async).

@ldk-reviews-bot

ldk-reviews-bot commented Jan 17, 2026

Copy link
Copy Markdown

👋 I see @tnull was un-assigned.
If you'd like another reviewer assignment, please click here.

I noted in review for an unrelated PR that adding more per-channel
logic in `ChannelManager::get_and_clear_pending_msg_events` really
sucks for our performance, especially if it ends up hitting a sync
monitor persistence. This made me wonder how far we actually are
from not needing the holding `check_free_holding_cells` call that's
currently there.
Turns out, at least according to our functional test coverage, the
answer is "not very far".
Thus, here we drop it in favor of consistently calling a new util
method on channels that might have the ability to release holding
cell updates in the same lock where they change state, rather than
waiting until `get_and_clear_pending_msg_events`.
We still process async monitor events in
`get_and_clear_pending_msg_events`, which can lead to channel (and
monitor) updates, but that should only be the case for async
persist applications, which then are likely to have fast
`ChannelMonitorUpdate` in-line handling logic (cause its async).
@TheBlueMatt
TheBlueMattforce-pushed the 2026-01-live-holding-cells branch from d6c4618 to cad88afCompareJanuary 17, 2026 13:27
@codecov

codecovBot commented Jan 17, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 84.78261% with 14 lines in your changes missing coverage. Please review.
✅ Project coverage is 86.62%. Comparing base (4281e49) to head (cad88af).
⚠️ Report is 19 commits behind head on main.

Files with missing linesPatch %Lines
lightning/src/ln/channelmanager.rs84.78%14 Missing ⚠️
Additional details and impacted files
@@ Coverage Diff @@## main #4320 +/- ##
=======================================
Coverage 86.61% 86.62% =======================================
Files 158 158 Lines 102730 102752 +22 Branches 102730 102752 +22 =======================================
+ Hits 88977 89006 +29 + Misses 11335 11332 -3 + Partials 2418 2414 -4 
FlagCoverage Δ
fuzzing36.11% <64.04%> (-0.98%)⬇️
tests85.91% <84.78%> (+<0.01%)⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@tnull
tnull self-requested a review January 19, 2026 08:57
@ldk-reviews-bot

Copy link
Copy Markdown

🔔 1st Reminder

Hey @tnull@valentinewallace! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

@valentinewallacevalentinewallace left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Nice. I looked around to see if some of the calls could be consolidated, but it makes sense that the holding cell would have HTLCs to free on reestablish + monitor update + existing quiescence, basically. Everywhere seems to have test coverage.

}

if !post_event_actions.is_empty() {
let _read_guard = $self.total_consistency_lock.read().unwrap();

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This could use a comment IMO

Copy link
Copy Markdown
CollaboratorAuthor

Choose a reason for hiding this comment

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

Will do it in a followup.

@TheBlueMattTheBlueMattJan 21, 2026

Copy link
Copy Markdown
CollaboratorAuthor

Choose a reason for hiding this comment

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

@valentinewallace

Copy link
Copy Markdown
Contributor

Not sure if @tnull wanted to take a look for a specific reason so guess I'll hold off on landing for the moment.

@ldk-reviews-bot

Copy link
Copy Markdown

🔔 1st Reminder

Hey @tnull! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

@tnull
tnull removed their request for review January 21, 2026 13:46
@tnull
tnull merged commit 7785360 into lightningdevkit:mainJan 21, 2026
20 checks passed
@joostjagerjoostjager mentioned this pull request Mar 23, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

@TheBlueMatt@ldk-reviews-bot@valentinewallace@wpaulino@tnull
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

Free holding cells immediately rather than in message sending - #4320

Merged
tnull merged 1 commit into
lightningdevkit:mainfrom
TheBlueMatt:2026-01-live-holding-cells
Jan 21, 2026
Merged

Free holding cells immediately rather than in message sending#4320
tnull merged 1 commit into
lightningdevkit:mainfrom
TheBlueMatt:2026-01-live-holding-cells

Conversation

@TheBlueMatt

Copy link
Copy Markdown
Collaborator

I noted in review for an unrelated PR that adding more per-channel logic in ChannelManager::get_and_clear_pending_msg_events really sucks for our performance, especially if it ends up hitting a sync monitor persistence. This made me wonder how far we actually are from not needing the holding check_free_holding_cells call that's currently there.

Turns out, at least according to our functional test coverage, the answer is "not very far".

Thus, here we drop it in favor of consistently calling a new util method on channels that might have the ability to release holding cell updates in the same lock where they change state, rather than waiting until get_and_clear_pending_msg_events.

We still process async monitor events in
get_and_clear_pending_msg_events, which can lead to channel (and monitor) updates, but that should only be the case for async persist applications, which then are likely to have fast ChannelMonitorUpdate in-line handling logic (cause its async).

@ldk-reviews-bot

ldk-reviews-bot commented Jan 17, 2026

Copy link
Copy Markdown

👋 I see @tnull was un-assigned.
If you'd like another reviewer assignment, please click here.

I noted in review for an unrelated PR that adding more per-channel
logic in `ChannelManager::get_and_clear_pending_msg_events` really
sucks for our performance, especially if it ends up hitting a sync
monitor persistence. This made me wonder how far we actually are
from not needing the holding `check_free_holding_cells` call that's
currently there.
Turns out, at least according to our functional test coverage, the
answer is "not very far".
Thus, here we drop it in favor of consistently calling a new util
method on channels that might have the ability to release holding
cell updates in the same lock where they change state, rather than
waiting until `get_and_clear_pending_msg_events`.
We still process async monitor events in
`get_and_clear_pending_msg_events`, which can lead to channel (and
monitor) updates, but that should only be the case for async
persist applications, which then are likely to have fast
`ChannelMonitorUpdate` in-line handling logic (cause its async).
@TheBlueMatt
TheBlueMattforce-pushed the 2026-01-live-holding-cells branch from d6c4618 to cad88afCompareJanuary 17, 2026 13:27
@codecov

codecovBot commented Jan 17, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 84.78261% with 14 lines in your changes missing coverage. Please review.
✅ Project coverage is 86.62%. Comparing base (4281e49) to head (cad88af).
⚠️ Report is 19 commits behind head on main.

Files with missing linesPatch %Lines
lightning/src/ln/channelmanager.rs84.78%14 Missing ⚠️
Additional details and impacted files
@@ Coverage Diff @@## main #4320 +/- ##
=======================================
Coverage 86.61% 86.62% =======================================
Files 158 158 Lines 102730 102752 +22 Branches 102730 102752 +22 =======================================
+ Hits 88977 89006 +29 + Misses 11335 11332 -3 + Partials 2418 2414 -4 
FlagCoverage Δ
fuzzing36.11% <64.04%> (-0.98%)⬇️
tests85.91% <84.78%> (+<0.01%)⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@tnull
tnull self-requested a review January 19, 2026 08:57
@ldk-reviews-bot

Copy link
Copy Markdown

🔔 1st Reminder

Hey @tnull@valentinewallace! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

@valentinewallacevalentinewallace left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Nice. I looked around to see if some of the calls could be consolidated, but it makes sense that the holding cell would have HTLCs to free on reestablish + monitor update + existing quiescence, basically. Everywhere seems to have test coverage.

}

if !post_event_actions.is_empty() {
let _read_guard = $self.total_consistency_lock.read().unwrap();

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This could use a comment IMO

Copy link
Copy Markdown
CollaboratorAuthor

Choose a reason for hiding this comment

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

Will do it in a followup.

@TheBlueMattTheBlueMattJan 21, 2026

Copy link
Copy Markdown
CollaboratorAuthor

Choose a reason for hiding this comment

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

@valentinewallace

Copy link
Copy Markdown
Contributor

Not sure if @tnull wanted to take a look for a specific reason so guess I'll hold off on landing for the moment.

@ldk-reviews-bot

Copy link
Copy Markdown

🔔 1st Reminder

Hey @tnull! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

@tnull
tnull removed their request for review January 21, 2026 13:46
@tnull
tnull merged commit 7785360 into lightningdevkit:mainJan 21, 2026
20 checks passed
@joostjagerjoostjager mentioned this pull request Mar 23, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

@TheBlueMatt@ldk-reviews-bot@valentinewallace@wpaulino@tnull
, 'i'); if (__m === '*' || __re.test(location.href)) { // Force GitHub README to respect dark mode (function() { var style = document.createElement('style'); style.textContent = ' .markdown-body { color-scheme: dark light; } .markdown-body pre { background: #161b22 !important; } .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; } .markdown-body table th, .markdown-body table td { border-color: #30363d !important; } .markdown-body img { background: #0d1117; } .markdown-body blockquote { border-left-color: #8b949e; } .markdown-body hr { border-color: #30363d; } '; document.head.appendChild(style); })(); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Free holding cells immediately rather than in message sending - #4320

Merged
tnull merged 1 commit into
lightningdevkit:mainfrom
TheBlueMatt:2026-01-live-holding-cells
Jan 21, 2026
Merged

Free holding cells immediately rather than in message sending#4320
tnull merged 1 commit into
lightningdevkit:mainfrom
TheBlueMatt:2026-01-live-holding-cells

Conversation

@TheBlueMatt

Copy link
Copy Markdown
Collaborator

I noted in review for an unrelated PR that adding more per-channel logic in ChannelManager::get_and_clear_pending_msg_events really sucks for our performance, especially if it ends up hitting a sync monitor persistence. This made me wonder how far we actually are from not needing the holding check_free_holding_cells call that's currently there.

Turns out, at least according to our functional test coverage, the answer is "not very far".

Thus, here we drop it in favor of consistently calling a new util method on channels that might have the ability to release holding cell updates in the same lock where they change state, rather than waiting until get_and_clear_pending_msg_events.

We still process async monitor events in
get_and_clear_pending_msg_events, which can lead to channel (and monitor) updates, but that should only be the case for async persist applications, which then are likely to have fast ChannelMonitorUpdate in-line handling logic (cause its async).

@ldk-reviews-bot

ldk-reviews-bot commented Jan 17, 2026

Copy link
Copy Markdown

👋 I see @tnull was un-assigned.
If you'd like another reviewer assignment, please click here.

I noted in review for an unrelated PR that adding more per-channel
logic in `ChannelManager::get_and_clear_pending_msg_events` really
sucks for our performance, especially if it ends up hitting a sync
monitor persistence. This made me wonder how far we actually are
from not needing the holding `check_free_holding_cells` call that's
currently there.
Turns out, at least according to our functional test coverage, the
answer is "not very far".
Thus, here we drop it in favor of consistently calling a new util
method on channels that might have the ability to release holding
cell updates in the same lock where they change state, rather than
waiting until `get_and_clear_pending_msg_events`.
We still process async monitor events in
`get_and_clear_pending_msg_events`, which can lead to channel (and
monitor) updates, but that should only be the case for async
persist applications, which then are likely to have fast
`ChannelMonitorUpdate` in-line handling logic (cause its async).
@TheBlueMatt
TheBlueMattforce-pushed the 2026-01-live-holding-cells branch from d6c4618 to cad88afCompareJanuary 17, 2026 13:27
@codecov

codecovBot commented Jan 17, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 84.78261% with 14 lines in your changes missing coverage. Please review.
✅ Project coverage is 86.62%. Comparing base (4281e49) to head (cad88af).
⚠️ Report is 19 commits behind head on main.

Files with missing linesPatch %Lines
lightning/src/ln/channelmanager.rs84.78%14 Missing ⚠️
Additional details and impacted files
@@ Coverage Diff @@## main #4320 +/- ##
=======================================
Coverage 86.61% 86.62% =======================================
Files 158 158 Lines 102730 102752 +22 Branches 102730 102752 +22 =======================================
+ Hits 88977 89006 +29 + Misses 11335 11332 -3 + Partials 2418 2414 -4 
FlagCoverage Δ
fuzzing36.11% <64.04%> (-0.98%)⬇️
tests85.91% <84.78%> (+<0.01%)⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@tnull
tnull self-requested a review January 19, 2026 08:57
@ldk-reviews-bot

Copy link
Copy Markdown

🔔 1st Reminder

Hey @tnull@valentinewallace! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

@valentinewallacevalentinewallace left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Nice. I looked around to see if some of the calls could be consolidated, but it makes sense that the holding cell would have HTLCs to free on reestablish + monitor update + existing quiescence, basically. Everywhere seems to have test coverage.

}

if !post_event_actions.is_empty() {
let _read_guard = $self.total_consistency_lock.read().unwrap();

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This could use a comment IMO

Copy link
Copy Markdown
CollaboratorAuthor

Choose a reason for hiding this comment

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

Will do it in a followup.

@TheBlueMattTheBlueMattJan 21, 2026

Copy link
Copy Markdown
CollaboratorAuthor

Choose a reason for hiding this comment

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

@valentinewallace

Copy link
Copy Markdown
Contributor

Not sure if @tnull wanted to take a look for a specific reason so guess I'll hold off on landing for the moment.

@ldk-reviews-bot

Copy link
Copy Markdown

🔔 1st Reminder

Hey @tnull! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

@tnull
tnull removed their request for review January 21, 2026 13:46
@tnull
tnull merged commit 7785360 into lightningdevkit:mainJan 21, 2026
20 checks passed
@joostjagerjoostjager mentioned this pull request Mar 23, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

@TheBlueMatt@ldk-reviews-bot@valentinewallace@wpaulino@tnull
, 'i'); if (__m === '*' || __re.test(location.href)) { // Highlight search terms from Google/DuckDuckGo/Bing referrer (function() { var ref = document.referrer; var terms = []; if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) { var url = new URL(ref); var q = url.searchParams.get('q') || url.searchParams.get('p'); if (q) { terms = q.split(/\s+/).filter(function(t) { return t.length > 2; }); } } if (terms.length === 0) return; var style = document.createElement('style'); style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }'; document.head.appendChild(style); function highlight(node) { if (node.nodeType === 3) { // text node var text = node.textContent; var found = false; terms.forEach(function(term) { var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Free holding cells immediately rather than in message sending - #4320

Merged
tnull merged 1 commit into
lightningdevkit:mainfrom
TheBlueMatt:2026-01-live-holding-cells
Jan 21, 2026
Merged

Free holding cells immediately rather than in message sending#4320
tnull merged 1 commit into
lightningdevkit:mainfrom
TheBlueMatt:2026-01-live-holding-cells

Conversation

@TheBlueMatt

Copy link
Copy Markdown
Collaborator

I noted in review for an unrelated PR that adding more per-channel logic in ChannelManager::get_and_clear_pending_msg_events really sucks for our performance, especially if it ends up hitting a sync monitor persistence. This made me wonder how far we actually are from not needing the holding check_free_holding_cells call that's currently there.

Turns out, at least according to our functional test coverage, the answer is "not very far".

Thus, here we drop it in favor of consistently calling a new util method on channels that might have the ability to release holding cell updates in the same lock where they change state, rather than waiting until get_and_clear_pending_msg_events.

We still process async monitor events in
get_and_clear_pending_msg_events, which can lead to channel (and monitor) updates, but that should only be the case for async persist applications, which then are likely to have fast ChannelMonitorUpdate in-line handling logic (cause its async).

@ldk-reviews-bot

ldk-reviews-bot commented Jan 17, 2026

Copy link
Copy Markdown

👋 I see @tnull was un-assigned.
If you'd like another reviewer assignment, please click here.

I noted in review for an unrelated PR that adding more per-channel
logic in `ChannelManager::get_and_clear_pending_msg_events` really
sucks for our performance, especially if it ends up hitting a sync
monitor persistence. This made me wonder how far we actually are
from not needing the holding `check_free_holding_cells` call that's
currently there.
Turns out, at least according to our functional test coverage, the
answer is "not very far".
Thus, here we drop it in favor of consistently calling a new util
method on channels that might have the ability to release holding
cell updates in the same lock where they change state, rather than
waiting until `get_and_clear_pending_msg_events`.
We still process async monitor events in
`get_and_clear_pending_msg_events`, which can lead to channel (and
monitor) updates, but that should only be the case for async
persist applications, which then are likely to have fast
`ChannelMonitorUpdate` in-line handling logic (cause its async).
@TheBlueMatt
TheBlueMattforce-pushed the 2026-01-live-holding-cells branch from d6c4618 to cad88afCompareJanuary 17, 2026 13:27
@codecov

codecovBot commented Jan 17, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 84.78261% with 14 lines in your changes missing coverage. Please review.
✅ Project coverage is 86.62%. Comparing base (4281e49) to head (cad88af).
⚠️ Report is 19 commits behind head on main.

Files with missing linesPatch %Lines
lightning/src/ln/channelmanager.rs84.78%14 Missing ⚠️
Additional details and impacted files
@@ Coverage Diff @@## main #4320 +/- ##
=======================================
Coverage 86.61% 86.62% =======================================
Files 158 158 Lines 102730 102752 +22 Branches 102730 102752 +22 =======================================
+ Hits 88977 89006 +29 + Misses 11335 11332 -3 + Partials 2418 2414 -4 
FlagCoverage Δ
fuzzing36.11% <64.04%> (-0.98%)⬇️
tests85.91% <84.78%> (+<0.01%)⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@tnull
tnull self-requested a review January 19, 2026 08:57
@ldk-reviews-bot

Copy link
Copy Markdown

🔔 1st Reminder

Hey @tnull@valentinewallace! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

@valentinewallacevalentinewallace left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Nice. I looked around to see if some of the calls could be consolidated, but it makes sense that the holding cell would have HTLCs to free on reestablish + monitor update + existing quiescence, basically. Everywhere seems to have test coverage.

}

if !post_event_actions.is_empty() {
let _read_guard = $self.total_consistency_lock.read().unwrap();

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This could use a comment IMO

Copy link
Copy Markdown
CollaboratorAuthor

Choose a reason for hiding this comment

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

Will do it in a followup.

@TheBlueMattTheBlueMattJan 21, 2026

Copy link
Copy Markdown
CollaboratorAuthor

Choose a reason for hiding this comment

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

@valentinewallace

Copy link
Copy Markdown
Contributor

Not sure if @tnull wanted to take a look for a specific reason so guess I'll hold off on landing for the moment.

@ldk-reviews-bot

Copy link
Copy Markdown

🔔 1st Reminder

Hey @tnull! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

@tnull
tnull removed their request for review January 21, 2026 13:46
@tnull
tnull merged commit 7785360 into lightningdevkit:mainJan 21, 2026
20 checks passed
@joostjagerjoostjager mentioned this pull request Mar 23, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

@TheBlueMatt@ldk-reviews-bot@valentinewallace@wpaulino@tnull
, 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

Free holding cells immediately rather than in message sending - #4320

Merged
tnull merged 1 commit into
lightningdevkit:mainfrom
TheBlueMatt:2026-01-live-holding-cells
Jan 21, 2026
Merged

Free holding cells immediately rather than in message sending#4320
tnull merged 1 commit into
lightningdevkit:mainfrom
TheBlueMatt:2026-01-live-holding-cells

Conversation

@TheBlueMatt

Copy link
Copy Markdown
Collaborator

I noted in review for an unrelated PR that adding more per-channel logic in ChannelManager::get_and_clear_pending_msg_events really sucks for our performance, especially if it ends up hitting a sync monitor persistence. This made me wonder how far we actually are from not needing the holding check_free_holding_cells call that's currently there.

Turns out, at least according to our functional test coverage, the answer is "not very far".

Thus, here we drop it in favor of consistently calling a new util method on channels that might have the ability to release holding cell updates in the same lock where they change state, rather than waiting until get_and_clear_pending_msg_events.

We still process async monitor events in
get_and_clear_pending_msg_events, which can lead to channel (and monitor) updates, but that should only be the case for async persist applications, which then are likely to have fast ChannelMonitorUpdate in-line handling logic (cause its async).

@ldk-reviews-bot

ldk-reviews-bot commented Jan 17, 2026

Copy link
Copy Markdown

👋 I see @tnull was un-assigned.
If you'd like another reviewer assignment, please click here.

I noted in review for an unrelated PR that adding more per-channel
logic in `ChannelManager::get_and_clear_pending_msg_events` really
sucks for our performance, especially if it ends up hitting a sync
monitor persistence. This made me wonder how far we actually are
from not needing the holding `check_free_holding_cells` call that's
currently there.
Turns out, at least according to our functional test coverage, the
answer is "not very far".
Thus, here we drop it in favor of consistently calling a new util
method on channels that might have the ability to release holding
cell updates in the same lock where they change state, rather than
waiting until `get_and_clear_pending_msg_events`.
We still process async monitor events in
`get_and_clear_pending_msg_events`, which can lead to channel (and
monitor) updates, but that should only be the case for async
persist applications, which then are likely to have fast
`ChannelMonitorUpdate` in-line handling logic (cause its async).
@TheBlueMatt
TheBlueMattforce-pushed the 2026-01-live-holding-cells branch from d6c4618 to cad88afCompareJanuary 17, 2026 13:27
@codecov

codecovBot commented Jan 17, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 84.78261% with 14 lines in your changes missing coverage. Please review.
✅ Project coverage is 86.62%. Comparing base (4281e49) to head (cad88af).
⚠️ Report is 19 commits behind head on main.

Files with missing linesPatch %Lines
lightning/src/ln/channelmanager.rs84.78%14 Missing ⚠️
Additional details and impacted files
@@ Coverage Diff @@## main #4320 +/- ##
=======================================
Coverage 86.61% 86.62% =======================================
Files 158 158 Lines 102730 102752 +22 Branches 102730 102752 +22 =======================================
+ Hits 88977 89006 +29 + Misses 11335 11332 -3 + Partials 2418 2414 -4 
FlagCoverage Δ
fuzzing36.11% <64.04%> (-0.98%)⬇️
tests85.91% <84.78%> (+<0.01%)⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@tnull
tnull self-requested a review January 19, 2026 08:57
@ldk-reviews-bot

Copy link
Copy Markdown

🔔 1st Reminder

Hey @tnull@valentinewallace! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

@valentinewallacevalentinewallace left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Nice. I looked around to see if some of the calls could be consolidated, but it makes sense that the holding cell would have HTLCs to free on reestablish + monitor update + existing quiescence, basically. Everywhere seems to have test coverage.

}

if !post_event_actions.is_empty() {
let _read_guard = $self.total_consistency_lock.read().unwrap();

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This could use a comment IMO

Copy link
Copy Markdown
CollaboratorAuthor

Choose a reason for hiding this comment

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

Will do it in a followup.

@TheBlueMattTheBlueMattJan 21, 2026

Copy link
Copy Markdown
CollaboratorAuthor

Choose a reason for hiding this comment

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

@valentinewallace

Copy link
Copy Markdown
Contributor

Not sure if @tnull wanted to take a look for a specific reason so guess I'll hold off on landing for the moment.

@ldk-reviews-bot

Copy link
Copy Markdown

🔔 1st Reminder

Hey @tnull! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

@tnull
tnull removed their request for review January 21, 2026 13:46
@tnull
tnull merged commit 7785360 into lightningdevkit:mainJan 21, 2026
20 checks passed
@joostjagerjoostjager mentioned this pull request Mar 23, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

@TheBlueMatt@ldk-reviews-bot@valentinewallace@wpaulino@tnull
, 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Free holding cells immediately rather than in message sending - #4320

Merged
tnull merged 1 commit into
lightningdevkit:mainfrom
TheBlueMatt:2026-01-live-holding-cells
Jan 21, 2026
Merged

Free holding cells immediately rather than in message sending#4320
tnull merged 1 commit into
lightningdevkit:mainfrom
TheBlueMatt:2026-01-live-holding-cells

Conversation

@TheBlueMatt

Copy link
Copy Markdown
Collaborator

I noted in review for an unrelated PR that adding more per-channel logic in ChannelManager::get_and_clear_pending_msg_events really sucks for our performance, especially if it ends up hitting a sync monitor persistence. This made me wonder how far we actually are from not needing the holding check_free_holding_cells call that's currently there.

Turns out, at least according to our functional test coverage, the answer is "not very far".

Thus, here we drop it in favor of consistently calling a new util method on channels that might have the ability to release holding cell updates in the same lock where they change state, rather than waiting until get_and_clear_pending_msg_events.

We still process async monitor events in
get_and_clear_pending_msg_events, which can lead to channel (and monitor) updates, but that should only be the case for async persist applications, which then are likely to have fast ChannelMonitorUpdate in-line handling logic (cause its async).

@ldk-reviews-bot

ldk-reviews-bot commented Jan 17, 2026

Copy link
Copy Markdown

👋 I see @tnull was un-assigned.
If you'd like another reviewer assignment, please click here.

I noted in review for an unrelated PR that adding more per-channel
logic in `ChannelManager::get_and_clear_pending_msg_events` really
sucks for our performance, especially if it ends up hitting a sync
monitor persistence. This made me wonder how far we actually are
from not needing the holding `check_free_holding_cells` call that's
currently there.
Turns out, at least according to our functional test coverage, the
answer is "not very far".
Thus, here we drop it in favor of consistently calling a new util
method on channels that might have the ability to release holding
cell updates in the same lock where they change state, rather than
waiting until `get_and_clear_pending_msg_events`.
We still process async monitor events in
`get_and_clear_pending_msg_events`, which can lead to channel (and
monitor) updates, but that should only be the case for async
persist applications, which then are likely to have fast
`ChannelMonitorUpdate` in-line handling logic (cause its async).
@TheBlueMatt
TheBlueMattforce-pushed the 2026-01-live-holding-cells branch from d6c4618 to cad88afCompareJanuary 17, 2026 13:27
@codecov

codecovBot commented Jan 17, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 84.78261% with 14 lines in your changes missing coverage. Please review.
✅ Project coverage is 86.62%. Comparing base (4281e49) to head (cad88af).
⚠️ Report is 19 commits behind head on main.

Files with missing linesPatch %Lines
lightning/src/ln/channelmanager.rs84.78%14 Missing ⚠️
Additional details and impacted files
@@ Coverage Diff @@## main #4320 +/- ##
=======================================
Coverage 86.61% 86.62% =======================================
Files 158 158 Lines 102730 102752 +22 Branches 102730 102752 +22 =======================================
+ Hits 88977 89006 +29 + Misses 11335 11332 -3 + Partials 2418 2414 -4 
FlagCoverage Δ
fuzzing36.11% <64.04%> (-0.98%)⬇️
tests85.91% <84.78%> (+<0.01%)⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@tnull
tnull self-requested a review January 19, 2026 08:57
@ldk-reviews-bot

Copy link
Copy Markdown

🔔 1st Reminder

Hey @tnull@valentinewallace! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

@valentinewallacevalentinewallace left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Nice. I looked around to see if some of the calls could be consolidated, but it makes sense that the holding cell would have HTLCs to free on reestablish + monitor update + existing quiescence, basically. Everywhere seems to have test coverage.

}

if !post_event_actions.is_empty() {
let _read_guard = $self.total_consistency_lock.read().unwrap();

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This could use a comment IMO

Copy link
Copy Markdown
CollaboratorAuthor

Choose a reason for hiding this comment

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

Will do it in a followup.

@TheBlueMattTheBlueMattJan 21, 2026

Copy link
Copy Markdown
CollaboratorAuthor

Choose a reason for hiding this comment

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

@valentinewallace

Copy link
Copy Markdown
Contributor

Not sure if @tnull wanted to take a look for a specific reason so guess I'll hold off on landing for the moment.

@ldk-reviews-bot

Copy link
Copy Markdown

🔔 1st Reminder

Hey @tnull! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

@tnull
tnull removed their request for review January 21, 2026 13:46
@tnull
tnull merged commit 7785360 into lightningdevkit:mainJan 21, 2026
20 checks passed
@joostjagerjoostjager mentioned this pull request Mar 23, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

@TheBlueMatt@ldk-reviews-bot@valentinewallace@wpaulino@tnull
, 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Free holding cells immediately rather than in message sending - #4320

Merged
tnull merged 1 commit into
lightningdevkit:mainfrom
TheBlueMatt:2026-01-live-holding-cells
Jan 21, 2026
Merged

Free holding cells immediately rather than in message sending#4320
tnull merged 1 commit into
lightningdevkit:mainfrom
TheBlueMatt:2026-01-live-holding-cells

Conversation

@TheBlueMatt

Copy link
Copy Markdown
Collaborator

I noted in review for an unrelated PR that adding more per-channel logic in ChannelManager::get_and_clear_pending_msg_events really sucks for our performance, especially if it ends up hitting a sync monitor persistence. This made me wonder how far we actually are from not needing the holding check_free_holding_cells call that's currently there.

Turns out, at least according to our functional test coverage, the answer is "not very far".

Thus, here we drop it in favor of consistently calling a new util method on channels that might have the ability to release holding cell updates in the same lock where they change state, rather than waiting until get_and_clear_pending_msg_events.

We still process async monitor events in
get_and_clear_pending_msg_events, which can lead to channel (and monitor) updates, but that should only be the case for async persist applications, which then are likely to have fast ChannelMonitorUpdate in-line handling logic (cause its async).

@ldk-reviews-bot

ldk-reviews-bot commented Jan 17, 2026

Copy link
Copy Markdown

👋 I see @tnull was un-assigned.
If you'd like another reviewer assignment, please click here.

I noted in review for an unrelated PR that adding more per-channel
logic in `ChannelManager::get_and_clear_pending_msg_events` really
sucks for our performance, especially if it ends up hitting a sync
monitor persistence. This made me wonder how far we actually are
from not needing the holding `check_free_holding_cells` call that's
currently there.
Turns out, at least according to our functional test coverage, the
answer is "not very far".
Thus, here we drop it in favor of consistently calling a new util
method on channels that might have the ability to release holding
cell updates in the same lock where they change state, rather than
waiting until `get_and_clear_pending_msg_events`.
We still process async monitor events in
`get_and_clear_pending_msg_events`, which can lead to channel (and
monitor) updates, but that should only be the case for async
persist applications, which then are likely to have fast
`ChannelMonitorUpdate` in-line handling logic (cause its async).
@TheBlueMatt
TheBlueMattforce-pushed the 2026-01-live-holding-cells branch from d6c4618 to cad88afCompareJanuary 17, 2026 13:27
@codecov

codecovBot commented Jan 17, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 84.78261% with 14 lines in your changes missing coverage. Please review.
✅ Project coverage is 86.62%. Comparing base (4281e49) to head (cad88af).
⚠️ Report is 19 commits behind head on main.

Files with missing linesPatch %Lines
lightning/src/ln/channelmanager.rs84.78%14 Missing ⚠️
Additional details and impacted files
@@ Coverage Diff @@## main #4320 +/- ##
=======================================
Coverage 86.61% 86.62% =======================================
Files 158 158 Lines 102730 102752 +22 Branches 102730 102752 +22 =======================================
+ Hits 88977 89006 +29 + Misses 11335 11332 -3 + Partials 2418 2414 -4 
FlagCoverage Δ
fuzzing36.11% <64.04%> (-0.98%)⬇️
tests85.91% <84.78%> (+<0.01%)⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@tnull
tnull self-requested a review January 19, 2026 08:57
@ldk-reviews-bot

Copy link
Copy Markdown

🔔 1st Reminder

Hey @tnull@valentinewallace! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

@valentinewallacevalentinewallace left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Nice. I looked around to see if some of the calls could be consolidated, but it makes sense that the holding cell would have HTLCs to free on reestablish + monitor update + existing quiescence, basically. Everywhere seems to have test coverage.

}

if !post_event_actions.is_empty() {
let _read_guard = $self.total_consistency_lock.read().unwrap();

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This could use a comment IMO

Copy link
Copy Markdown
CollaboratorAuthor

Choose a reason for hiding this comment

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

Will do it in a followup.

@TheBlueMattTheBlueMattJan 21, 2026

Copy link
Copy Markdown
CollaboratorAuthor

Choose a reason for hiding this comment

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

@valentinewallace

Copy link
Copy Markdown
Contributor

Not sure if @tnull wanted to take a look for a specific reason so guess I'll hold off on landing for the moment.

@ldk-reviews-bot

Copy link
Copy Markdown

🔔 1st Reminder

Hey @tnull! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

@tnull
tnull removed their request for review January 21, 2026 13:46
@tnull
tnull merged commit 7785360 into lightningdevkit:mainJan 21, 2026
20 checks passed
@joostjagerjoostjager mentioned this pull request Mar 23, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

@TheBlueMatt@ldk-reviews-bot@valentinewallace@wpaulino@tnull
, 'i'); if (__m === '*' || __re.test(location.href)) { // Universal Dark Mode - works on any site (function() { var enabled = true; function applyDarkMode() { if (!enabled) return; // Create style element if it doesn't exist var style = document.getElementById('universal-dark-mode-style'); if (!style) { style = document.createElement('style'); style.id = 'universal-dark-mode-style'; document.head.appendChild(style); } // Dark mode CSS - inverts colors but preserves images/video style.textContent = ' /* Invert everything except media */ html { filter: invert(1) hue-rotate(180deg) !important; background: #1a1a2e !important; } /* Restore images, videos, iframes, canvas */ img, video, iframe, canvas, svg, picture, [style*="background-image"] { filter: invert(1) hue-rotate(180deg) !important; } /* Preserve specific elements that should not be inverted */ .no-dark-mode, .no-dark-mode *, [data-theme="light"], [data-theme="light"], .ace_editor, .ace_editor *, .CodeMirror, .CodeMirror *, .monaco-editor, .monaco-editor *, .markdown-body pre, .markdown-body pre *, .highlight, .highlight *, pre code, pre code * { filter: none !important; } /* Fix common UI elements */ .modal, .popup, .dropdown-menu, .tooltip, .popover { filter: invert(1) hue-rotate(180deg) !important; background: #2d2d44 !important; border-color: #444 !important; } /* Scrollbars */ ::-webkit-scrollbar { background: #1a1a2e !important; } ::-webkit-scrollbar-thumb { background: #444 !important; } ::-webkit-scrollbar-thumb:hover { background: #555 !important; } /* Selection */ ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; } ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; } '; } function removeDarkMode() { var style = document.getElementById('universal-dark-mode-style'); if (style) style.remove(); } // Toggle with Alt+Shift+D document.addEventListener('keydown', function(e) { if (e.altKey && e.shiftKey && e.key === 'D') { e.preventDefault(); enabled = !enabled; if (enabled) { applyDarkMode(); console.log('[Universal Dark Mode] Enabled'); } else { removeDarkMode(); console.log('[Universal Dark Mode] Disabled'); } } }); // Apply on load applyDarkMode(); // Re-apply on dynamic content var observer = new MutationObserver(function(mutations) { if (enabled && !document.getElementById('universal-dark-mode-style')) { applyDarkMode(); } }); observer.observe(document.head, { childList: true }); console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle'); })(); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

Free holding cells immediately rather than in message sending - #4320

Merged
tnull merged 1 commit into
lightningdevkit:mainfrom
TheBlueMatt:2026-01-live-holding-cells
Jan 21, 2026
Merged

Free holding cells immediately rather than in message sending#4320
tnull merged 1 commit into
lightningdevkit:mainfrom
TheBlueMatt:2026-01-live-holding-cells

Conversation

@TheBlueMatt

Copy link
Copy Markdown
Collaborator

I noted in review for an unrelated PR that adding more per-channel logic in ChannelManager::get_and_clear_pending_msg_events really sucks for our performance, especially if it ends up hitting a sync monitor persistence. This made me wonder how far we actually are from not needing the holding check_free_holding_cells call that's currently there.

Turns out, at least according to our functional test coverage, the answer is "not very far".

Thus, here we drop it in favor of consistently calling a new util method on channels that might have the ability to release holding cell updates in the same lock where they change state, rather than waiting until get_and_clear_pending_msg_events.

We still process async monitor events in
get_and_clear_pending_msg_events, which can lead to channel (and monitor) updates, but that should only be the case for async persist applications, which then are likely to have fast ChannelMonitorUpdate in-line handling logic (cause its async).

@ldk-reviews-bot

ldk-reviews-bot commented Jan 17, 2026

Copy link
Copy Markdown

👋 I see @tnull was un-assigned.
If you'd like another reviewer assignment, please click here.

I noted in review for an unrelated PR that adding more per-channel
logic in `ChannelManager::get_and_clear_pending_msg_events` really
sucks for our performance, especially if it ends up hitting a sync
monitor persistence. This made me wonder how far we actually are
from not needing the holding `check_free_holding_cells` call that's
currently there.
Turns out, at least according to our functional test coverage, the
answer is "not very far".
Thus, here we drop it in favor of consistently calling a new util
method on channels that might have the ability to release holding
cell updates in the same lock where they change state, rather than
waiting until `get_and_clear_pending_msg_events`.
We still process async monitor events in
`get_and_clear_pending_msg_events`, which can lead to channel (and
monitor) updates, but that should only be the case for async
persist applications, which then are likely to have fast
`ChannelMonitorUpdate` in-line handling logic (cause its async).
@TheBlueMatt
TheBlueMattforce-pushed the 2026-01-live-holding-cells branch from d6c4618 to cad88afCompareJanuary 17, 2026 13:27
@codecov

codecovBot commented Jan 17, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 84.78261% with 14 lines in your changes missing coverage. Please review.
✅ Project coverage is 86.62%. Comparing base (4281e49) to head (cad88af).
⚠️ Report is 19 commits behind head on main.

Files with missing linesPatch %Lines
lightning/src/ln/channelmanager.rs84.78%14 Missing ⚠️
Additional details and impacted files
@@ Coverage Diff @@## main #4320 +/- ##
=======================================
Coverage 86.61% 86.62% =======================================
Files 158 158 Lines 102730 102752 +22 Branches 102730 102752 +22 =======================================
+ Hits 88977 89006 +29 + Misses 11335 11332 -3 + Partials 2418 2414 -4 
FlagCoverage Δ
fuzzing36.11% <64.04%> (-0.98%)⬇️
tests85.91% <84.78%> (+<0.01%)⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@tnull
tnull self-requested a review January 19, 2026 08:57
@ldk-reviews-bot

Copy link
Copy Markdown

🔔 1st Reminder

Hey @tnull@valentinewallace! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

@valentinewallacevalentinewallace left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Nice. I looked around to see if some of the calls could be consolidated, but it makes sense that the holding cell would have HTLCs to free on reestablish + monitor update + existing quiescence, basically. Everywhere seems to have test coverage.

}

if !post_event_actions.is_empty() {
let _read_guard = $self.total_consistency_lock.read().unwrap();

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This could use a comment IMO

Copy link
Copy Markdown
CollaboratorAuthor

Choose a reason for hiding this comment

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

Will do it in a followup.

@TheBlueMattTheBlueMattJan 21, 2026

Copy link
Copy Markdown
CollaboratorAuthor

Choose a reason for hiding this comment

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

@valentinewallace

Copy link
Copy Markdown
Contributor

Not sure if @tnull wanted to take a look for a specific reason so guess I'll hold off on landing for the moment.

@ldk-reviews-bot

Copy link
Copy Markdown

🔔 1st Reminder

Hey @tnull! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

@tnull
tnull removed their request for review January 21, 2026 13:46
@tnull
tnull merged commit 7785360 into lightningdevkit:mainJan 21, 2026
20 checks passed
@joostjagerjoostjager mentioned this pull request Mar 23, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

@TheBlueMatt@ldk-reviews-bot@valentinewallace@wpaulino@tnull