Skip to content

Introduce receive_via_jit_channel to UnifiedPayment#914

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.

Sign up for GitHub

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

Draft
chuksys wants to merge 1 commit into
base:main
Choose a base branch
from
Draft

Introduce receive_via_jit_channel to UnifiedPayment #914

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
83 changes: 82 additions & 1 deletion src/payment/unified.rs
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -32,7 +32,7 @@ use lightning_invoice::{Bolt11Invoice, Bolt11InvoiceDescription, Description};
use crate::config::HRN_RESOLUTION_TIMEOUT_SECS;
use crate::error::Error;
use crate::ffi::maybe_wrap;
use crate::logger::{log_error, LdkLogger, Logger};
use crate::logger::{log_error, log_info, LdkLogger, Logger};
use crate::payment::{Bolt11Payment, Bolt12Payment, OnchainPayment};
use crate::types::HRNResolver;
use crate::Config;
Expand DownExpand Up@@ -167,6 +167,87 @@ impl UnifiedPayment {
Ok(format_uri(uri))
}

/// Generates a unified BIP21 URI identical in structure to [`receive`], but uses a
/// JIT (Just-In-Time) BOLT 11 invoice via the configured LSP liquidity source for
/// the purpose of providing inbound liquidity on the fly.
///
/// This method is designed to be called when the node has insufficient inbound capacity
/// to receive the payment over standard Lightning routes. **Note that this method does not
/// automatically detect your current inbound capacity;** the determination of whether
/// inbound capacity is lacking, and the decision to invoke this JIT flow, is left entirely
/// to the discretion of the developer.
///
/// Like [`receive`], the resulting URI provides an on-chain fallback address and a BOLT 12
/// offer. However, the attached BOLT 11 invoice is provisioned through an External Liquidity
/// Provider (LSP) to dynamically open a JIT channel when the payer routes the payment. If no
/// LSP is configured or the JIT generation fails, it falls back to standard local invoice
/// generation.
///
/// # Parameters
/// - `amount_sats`: The amount to be received, specified in satoshis.
/// - `description`: A description or note associated with the payment.
/// This message is visible to the payer and can provide context or details about the payment.
/// - `expiry_sec`: The expiration time for the payment, specified in seconds.
/// - `max_total_lsp_fee_limit_msat`: An optional fee cap in millisatoshis defining the maximum
/// fee you are willing to allow the LSP to charge for opening the JIT liquidity channel.
///
/// # Warning
/// Because this method may require synchronous network negotiation with an external LSP,
/// it can block the calling thread. Mobile applications should ensure this is invoked
/// from a background thread to prevent UI freezing.
pub fn receive_via_jit_channel(
&self, amount_sats: u64, description: &str, expiry_sec: u32,
max_total_lsp_fee_limit_msat: Option<u64>,
) -> Result<String, Error> {
let onchain_address = self.onchain_payment.new_address()?;
let amount_msats = amount_sats * 1_000;

let bolt12_offer =
match self.bolt12_payment.receive_inner(amount_msats, description, None, None) {
Ok(offer) => Some(maybe_wrap(offer)),
Err(e) => {
log_error!(self.logger, "Failed to create offer: {}", e);
None
},
};

let invoice_description = Bolt11InvoiceDescription::Direct(
Description::new(description.to_string()).map_err(|_| Error::InvoiceCreationFailed)?,
);

let bolt11_invoice = match self.bolt11_invoice.receive_via_jit_channel(
amount_msats,
&invoice_description,
expiry_sec,
max_total_lsp_fee_limit_msat,
) {
Ok(invoice) => Some(invoice),
Err(Error::LiquiditySourceUnavailable) => {
log_info!(
self.logger,
"No LSP configured. Falling back to local invoice generation."
);
self.bolt11_invoice.receive(amount_msats, &invoice_description, expiry_sec).ok()
},
Err(e) => {
log_error!(
self.logger,
"LSP JIT invoice creation failed: {:?}. Falling back to local invoice.",
e
);
self.bolt11_invoice.receive(amount_msats, &invoice_description, expiry_sec).ok()
},
};

let extras = Extras { bolt11_invoice, bolt12_offer };

let mut uri = Uri::with_extras(onchain_address, extras);
uri.amount = Some(Amount::from_sat(amount_sats));
uri.message = Some(description.into());

Ok(format_uri(uri))
}

/// Sends a payment given a [BIP 21] URI or [BIP 353] Human-Readable Name.
///
/// This method parses the provided URI string and attempts to send the payment. If the URI
Expand Down
Loading
, '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" + '
Introduce receive_via_jit_channel to UnifiedPayment by chuksys · Pull Request #914 · lightningdevkit/ldk-node · GitHub
Skip to content
Introduce receive_via_jit_channel to UnifiedPayment#914

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.

 Sign up for GitHub

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

 Draft

chuksys
wants to merge
1
commit into

base:main
Choose a base branch

from

 Draft


Introduce receive_via_jit_channel to UnifiedPayment
#914
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


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


83 changes: 82 additions & 1 deletion
src/payment/unified.rs

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -32,7 +32,7 @@ use lightning_invoice::{Bolt11Invoice, Bolt11InvoiceDescription, Description};
use crate::config::HRN_RESOLUTION_TIMEOUT_SECS;
use crate::error::Error;
use crate::ffi::maybe_wrap;
use crate::logger::{log_error, LdkLogger, Logger};
use crate::logger::{log_error, log_info, LdkLogger, Logger};
use crate::payment::{Bolt11Payment, Bolt12Payment, OnchainPayment};
use crate::types::HRNResolver;
use crate::Config;
Expand DownExpand Up@@ -167,6 +167,87 @@ impl UnifiedPayment {
 Ok(format_uri(uri))
	}

	/// Generates a unified BIP21 URI identical in structure to [`receive`], but uses a
	/// JIT (Just-In-Time) BOLT 11 invoice via the configured LSP liquidity source for
	/// the purpose of providing inbound liquidity on the fly.
	///
	/// This method is designed to be called when the node has insufficient inbound capacity
	/// to receive the payment over standard Lightning routes. **Note that this method does not
	/// automatically detect your current inbound capacity;** the determination of whether
	/// inbound capacity is lacking, and the decision to invoke this JIT flow, is left entirely
	/// to the discretion of the developer.
	///
	/// Like [`receive`], the resulting URI provides an on-chain fallback address and a BOLT 12
	/// offer. However, the attached BOLT 11 invoice is provisioned through an External Liquidity
	/// Provider (LSP) to dynamically open a JIT channel when the payer routes the payment. If no
	/// LSP is configured or the JIT generation fails, it falls back to standard local invoice
	/// generation.
	///
	/// # Parameters
	/// - `amount_sats`: The amount to be received, specified in satoshis.
	/// - `description`: A description or note associated with the payment.
	/// This message is visible to the payer and can provide context or details about the payment.
	/// - `expiry_sec`: The expiration time for the payment, specified in seconds.
	/// - `max_total_lsp_fee_limit_msat`: An optional fee cap in millisatoshis defining the maximum
	/// fee you are willing to allow the LSP to charge for opening the JIT liquidity channel.
	///
	/// # Warning
	/// Because this method may require synchronous network negotiation with an external LSP,
	/// it can block the calling thread. Mobile applications should ensure this is invoked
	/// from a background thread to prevent UI freezing.
	pub fn receive_via_jit_channel(
 &self, amount_sats: u64, description: &str, expiry_sec: u32,
 max_total_lsp_fee_limit_msat: Option<u64>,
	) -> Result<String, Error> {
 let onchain_address = self.onchain_payment.new_address()?;
 let amount_msats = amount_sats * 1_000;

 let bolt12_offer =
 match self.bolt12_payment.receive_inner(amount_msats, description, None, None) {
 Ok(offer) => Some(maybe_wrap(offer)),
 Err(e) => {
 log_error!(self.logger, "Failed to create offer: {}", e);
 None
 },
 };

 let invoice_description = Bolt11InvoiceDescription::Direct(
 Description::new(description.to_string()).map_err(|_| Error::InvoiceCreationFailed)?,
 );

 let bolt11_invoice = match self.bolt11_invoice.receive_via_jit_channel(
 amount_msats,
 &invoice_description,
 expiry_sec,
 max_total_lsp_fee_limit_msat,
 ) {
 Ok(invoice) => Some(invoice),
 Err(Error::LiquiditySourceUnavailable) => {
 log_info!(
 self.logger,
 "No LSP configured. Falling back to local invoice generation."
 );
 self.bolt11_invoice.receive(amount_msats, &invoice_description, expiry_sec).ok()
 },
 Err(e) => {
 log_error!(
 self.logger,
 "LSP JIT invoice creation failed: {:?}. Falling back to local invoice.",
 e
 );
 self.bolt11_invoice.receive(amount_msats, &invoice_description, expiry_sec).ok()
 },
 };

 let extras = Extras { bolt11_invoice, bolt12_offer };

 let mut uri = Uri::with_extras(onchain_address, extras);
 uri.amount = Some(Amount::from_sat(amount_sats));
 uri.message = Some(description.into());

 Ok(format_uri(uri))
	}

	/// Sends a payment given a [BIP 21] URI or [BIP 353] Human-Readable Name.
	///
	/// This method parses the provided URI string and attempts to send the payment. If the URI
Expand Down
Loading

, '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('^' + ".*" + '
Introduce receive_via_jit_channel to UnifiedPayment by chuksys · Pull Request #914 · lightningdevkit/ldk-node · GitHub
Skip to content
Introduce receive_via_jit_channel to UnifiedPayment#914

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.

 Sign up for GitHub

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

 Draft

chuksys
wants to merge
1
commit into

base:main
Choose a base branch

from

 Draft


Introduce receive_via_jit_channel to UnifiedPayment
#914
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


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


83 changes: 82 additions & 1 deletion
src/payment/unified.rs

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -32,7 +32,7 @@ use lightning_invoice::{Bolt11Invoice, Bolt11InvoiceDescription, Description};
use crate::config::HRN_RESOLUTION_TIMEOUT_SECS;
use crate::error::Error;
use crate::ffi::maybe_wrap;
use crate::logger::{log_error, LdkLogger, Logger};
use crate::logger::{log_error, log_info, LdkLogger, Logger};
use crate::payment::{Bolt11Payment, Bolt12Payment, OnchainPayment};
use crate::types::HRNResolver;
use crate::Config;
Expand DownExpand Up@@ -167,6 +167,87 @@ impl UnifiedPayment {
 Ok(format_uri(uri))
	}

	/// Generates a unified BIP21 URI identical in structure to [`receive`], but uses a
	/// JIT (Just-In-Time) BOLT 11 invoice via the configured LSP liquidity source for
	/// the purpose of providing inbound liquidity on the fly.
	///
	/// This method is designed to be called when the node has insufficient inbound capacity
	/// to receive the payment over standard Lightning routes. **Note that this method does not
	/// automatically detect your current inbound capacity;** the determination of whether
	/// inbound capacity is lacking, and the decision to invoke this JIT flow, is left entirely
	/// to the discretion of the developer.
	///
	/// Like [`receive`], the resulting URI provides an on-chain fallback address and a BOLT 12
	/// offer. However, the attached BOLT 11 invoice is provisioned through an External Liquidity
	/// Provider (LSP) to dynamically open a JIT channel when the payer routes the payment. If no
	/// LSP is configured or the JIT generation fails, it falls back to standard local invoice
	/// generation.
	///
	/// # Parameters
	/// - `amount_sats`: The amount to be received, specified in satoshis.
	/// - `description`: A description or note associated with the payment.
	/// This message is visible to the payer and can provide context or details about the payment.
	/// - `expiry_sec`: The expiration time for the payment, specified in seconds.
	/// - `max_total_lsp_fee_limit_msat`: An optional fee cap in millisatoshis defining the maximum
	/// fee you are willing to allow the LSP to charge for opening the JIT liquidity channel.
	///
	/// # Warning
	/// Because this method may require synchronous network negotiation with an external LSP,
	/// it can block the calling thread. Mobile applications should ensure this is invoked
	/// from a background thread to prevent UI freezing.
	pub fn receive_via_jit_channel(
 &self, amount_sats: u64, description: &str, expiry_sec: u32,
 max_total_lsp_fee_limit_msat: Option<u64>,
	) -> Result<String, Error> {
 let onchain_address = self.onchain_payment.new_address()?;
 let amount_msats = amount_sats * 1_000;

 let bolt12_offer =
 match self.bolt12_payment.receive_inner(amount_msats, description, None, None) {
 Ok(offer) => Some(maybe_wrap(offer)),
 Err(e) => {
 log_error!(self.logger, "Failed to create offer: {}", e);
 None
 },
 };

 let invoice_description = Bolt11InvoiceDescription::Direct(
 Description::new(description.to_string()).map_err(|_| Error::InvoiceCreationFailed)?,
 );

 let bolt11_invoice = match self.bolt11_invoice.receive_via_jit_channel(
 amount_msats,
 &invoice_description,
 expiry_sec,
 max_total_lsp_fee_limit_msat,
 ) {
 Ok(invoice) => Some(invoice),
 Err(Error::LiquiditySourceUnavailable) => {
 log_info!(
 self.logger,
 "No LSP configured. Falling back to local invoice generation."
 );
 self.bolt11_invoice.receive(amount_msats, &invoice_description, expiry_sec).ok()
 },
 Err(e) => {
 log_error!(
 self.logger,
 "LSP JIT invoice creation failed: {:?}. Falling back to local invoice.",
 e
 );
 self.bolt11_invoice.receive(amount_msats, &invoice_description, expiry_sec).ok()
 },
 };

 let extras = Extras { bolt11_invoice, bolt12_offer };

 let mut uri = Uri::with_extras(onchain_address, extras);
 uri.amount = Some(Amount::from_sat(amount_sats));
 uri.message = Some(description.into());

 Ok(format_uri(uri))
	}

	/// Sends a payment given a [BIP 21] URI or [BIP 353] Human-Readable Name.
	///
	/// This method parses the provided URI string and attempts to send the payment. If the URI
Expand Down
Loading

, '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('^' + ".*" + '
Introduce receive_via_jit_channel to UnifiedPayment by chuksys · Pull Request #914 · lightningdevkit/ldk-node · GitHub
Skip to content
Introduce receive_via_jit_channel to UnifiedPayment#914

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.

 Sign up for GitHub

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

 Draft

chuksys
wants to merge
1
commit into

base:main
Choose a base branch

from

 Draft


Introduce receive_via_jit_channel to UnifiedPayment
#914
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


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


83 changes: 82 additions & 1 deletion
src/payment/unified.rs

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -32,7 +32,7 @@ use lightning_invoice::{Bolt11Invoice, Bolt11InvoiceDescription, Description};
use crate::config::HRN_RESOLUTION_TIMEOUT_SECS;
use crate::error::Error;
use crate::ffi::maybe_wrap;
use crate::logger::{log_error, LdkLogger, Logger};
use crate::logger::{log_error, log_info, LdkLogger, Logger};
use crate::payment::{Bolt11Payment, Bolt12Payment, OnchainPayment};
use crate::types::HRNResolver;
use crate::Config;
Expand DownExpand Up@@ -167,6 +167,87 @@ impl UnifiedPayment {
 Ok(format_uri(uri))
	}

	/// Generates a unified BIP21 URI identical in structure to [`receive`], but uses a
	/// JIT (Just-In-Time) BOLT 11 invoice via the configured LSP liquidity source for
	/// the purpose of providing inbound liquidity on the fly.
	///
	/// This method is designed to be called when the node has insufficient inbound capacity
	/// to receive the payment over standard Lightning routes. **Note that this method does not
	/// automatically detect your current inbound capacity;** the determination of whether
	/// inbound capacity is lacking, and the decision to invoke this JIT flow, is left entirely
	/// to the discretion of the developer.
	///
	/// Like [`receive`], the resulting URI provides an on-chain fallback address and a BOLT 12
	/// offer. However, the attached BOLT 11 invoice is provisioned through an External Liquidity
	/// Provider (LSP) to dynamically open a JIT channel when the payer routes the payment. If no
	/// LSP is configured or the JIT generation fails, it falls back to standard local invoice
	/// generation.
	///
	/// # Parameters
	/// - `amount_sats`: The amount to be received, specified in satoshis.
	/// - `description`: A description or note associated with the payment.
	/// This message is visible to the payer and can provide context or details about the payment.
	/// - `expiry_sec`: The expiration time for the payment, specified in seconds.
	/// - `max_total_lsp_fee_limit_msat`: An optional fee cap in millisatoshis defining the maximum
	/// fee you are willing to allow the LSP to charge for opening the JIT liquidity channel.
	///
	/// # Warning
	/// Because this method may require synchronous network negotiation with an external LSP,
	/// it can block the calling thread. Mobile applications should ensure this is invoked
	/// from a background thread to prevent UI freezing.
	pub fn receive_via_jit_channel(
 &self, amount_sats: u64, description: &str, expiry_sec: u32,
 max_total_lsp_fee_limit_msat: Option<u64>,
	) -> Result<String, Error> {
 let onchain_address = self.onchain_payment.new_address()?;
 let amount_msats = amount_sats * 1_000;

 let bolt12_offer =
 match self.bolt12_payment.receive_inner(amount_msats, description, None, None) {
 Ok(offer) => Some(maybe_wrap(offer)),
 Err(e) => {
 log_error!(self.logger, "Failed to create offer: {}", e);
 None
 },
 };

 let invoice_description = Bolt11InvoiceDescription::Direct(
 Description::new(description.to_string()).map_err(|_| Error::InvoiceCreationFailed)?,
 );

 let bolt11_invoice = match self.bolt11_invoice.receive_via_jit_channel(
 amount_msats,
 &invoice_description,
 expiry_sec,
 max_total_lsp_fee_limit_msat,
 ) {
 Ok(invoice) => Some(invoice),
 Err(Error::LiquiditySourceUnavailable) => {
 log_info!(
 self.logger,
 "No LSP configured. Falling back to local invoice generation."
 );
 self.bolt11_invoice.receive(amount_msats, &invoice_description, expiry_sec).ok()
 },
 Err(e) => {
 log_error!(
 self.logger,
 "LSP JIT invoice creation failed: {:?}. Falling back to local invoice.",
 e
 );
 self.bolt11_invoice.receive(amount_msats, &invoice_description, expiry_sec).ok()
 },
 };

 let extras = Extras { bolt11_invoice, bolt12_offer };

 let mut uri = Uri::with_extras(onchain_address, extras);
 uri.amount = Some(Amount::from_sat(amount_sats));
 uri.message = Some(description.into());

 Ok(format_uri(uri))
	}

	/// Sends a payment given a [BIP 21] URI or [BIP 353] Human-Readable Name.
	///
	/// This method parses the provided URI string and attempts to send the payment. If the URI
Expand Down
Loading

, '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" + '
Introduce receive_via_jit_channel to UnifiedPayment by chuksys · Pull Request #914 · lightningdevkit/ldk-node · GitHub
Skip to content
Introduce receive_via_jit_channel to UnifiedPayment#914

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.

 Sign up for GitHub

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

 Draft

chuksys
wants to merge
1
commit into

base:main
Choose a base branch

from

 Draft


Introduce receive_via_jit_channel to UnifiedPayment
#914
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


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


83 changes: 82 additions & 1 deletion
src/payment/unified.rs

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -32,7 +32,7 @@ use lightning_invoice::{Bolt11Invoice, Bolt11InvoiceDescription, Description};
use crate::config::HRN_RESOLUTION_TIMEOUT_SECS;
use crate::error::Error;
use crate::ffi::maybe_wrap;
use crate::logger::{log_error, LdkLogger, Logger};
use crate::logger::{log_error, log_info, LdkLogger, Logger};
use crate::payment::{Bolt11Payment, Bolt12Payment, OnchainPayment};
use crate::types::HRNResolver;
use crate::Config;
Expand DownExpand Up@@ -167,6 +167,87 @@ impl UnifiedPayment {
 Ok(format_uri(uri))
	}

	/// Generates a unified BIP21 URI identical in structure to [`receive`], but uses a
	/// JIT (Just-In-Time) BOLT 11 invoice via the configured LSP liquidity source for
	/// the purpose of providing inbound liquidity on the fly.
	///
	/// This method is designed to be called when the node has insufficient inbound capacity
	/// to receive the payment over standard Lightning routes. **Note that this method does not
	/// automatically detect your current inbound capacity;** the determination of whether
	/// inbound capacity is lacking, and the decision to invoke this JIT flow, is left entirely
	/// to the discretion of the developer.
	///
	/// Like [`receive`], the resulting URI provides an on-chain fallback address and a BOLT 12
	/// offer. However, the attached BOLT 11 invoice is provisioned through an External Liquidity
	/// Provider (LSP) to dynamically open a JIT channel when the payer routes the payment. If no
	/// LSP is configured or the JIT generation fails, it falls back to standard local invoice
	/// generation.
	///
	/// # Parameters
	/// - `amount_sats`: The amount to be received, specified in satoshis.
	/// - `description`: A description or note associated with the payment.
	/// This message is visible to the payer and can provide context or details about the payment.
	/// - `expiry_sec`: The expiration time for the payment, specified in seconds.
	/// - `max_total_lsp_fee_limit_msat`: An optional fee cap in millisatoshis defining the maximum
	/// fee you are willing to allow the LSP to charge for opening the JIT liquidity channel.
	///
	/// # Warning
	/// Because this method may require synchronous network negotiation with an external LSP,
	/// it can block the calling thread. Mobile applications should ensure this is invoked
	/// from a background thread to prevent UI freezing.
	pub fn receive_via_jit_channel(
 &self, amount_sats: u64, description: &str, expiry_sec: u32,
 max_total_lsp_fee_limit_msat: Option<u64>,
	) -> Result<String, Error> {
 let onchain_address = self.onchain_payment.new_address()?;
 let amount_msats = amount_sats * 1_000;

 let bolt12_offer =
 match self.bolt12_payment.receive_inner(amount_msats, description, None, None) {
 Ok(offer) => Some(maybe_wrap(offer)),
 Err(e) => {
 log_error!(self.logger, "Failed to create offer: {}", e);
 None
 },
 };

 let invoice_description = Bolt11InvoiceDescription::Direct(
 Description::new(description.to_string()).map_err(|_| Error::InvoiceCreationFailed)?,
 );

 let bolt11_invoice = match self.bolt11_invoice.receive_via_jit_channel(
 amount_msats,
 &invoice_description,
 expiry_sec,
 max_total_lsp_fee_limit_msat,
 ) {
 Ok(invoice) => Some(invoice),
 Err(Error::LiquiditySourceUnavailable) => {
 log_info!(
 self.logger,
 "No LSP configured. Falling back to local invoice generation."
 );
 self.bolt11_invoice.receive(amount_msats, &invoice_description, expiry_sec).ok()
 },
 Err(e) => {
 log_error!(
 self.logger,
 "LSP JIT invoice creation failed: {:?}. Falling back to local invoice.",
 e
 );
 self.bolt11_invoice.receive(amount_msats, &invoice_description, expiry_sec).ok()
 },
 };

 let extras = Extras { bolt11_invoice, bolt12_offer };

 let mut uri = Uri::with_extras(onchain_address, extras);
 uri.amount = Some(Amount::from_sat(amount_sats));
 uri.message = Some(description.into());

 Ok(format_uri(uri))
	}

	/// Sends a payment given a [BIP 21] URI or [BIP 353] Human-Readable Name.
	///
	/// This method parses the provided URI string and attempts to send the payment. If the URI
Expand Down
Loading

, '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('^' + ".*" + '
Introduce receive_via_jit_channel to UnifiedPayment by chuksys · Pull Request #914 · lightningdevkit/ldk-node · GitHub
Skip to content
Introduce receive_via_jit_channel to UnifiedPayment#914

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.

 Sign up for GitHub

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

 Draft

chuksys
wants to merge
1
commit into

base:main
Choose a base branch

from

 Draft


Introduce receive_via_jit_channel to UnifiedPayment
#914
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


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


83 changes: 82 additions & 1 deletion
src/payment/unified.rs

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -32,7 +32,7 @@ use lightning_invoice::{Bolt11Invoice, Bolt11InvoiceDescription, Description};
use crate::config::HRN_RESOLUTION_TIMEOUT_SECS;
use crate::error::Error;
use crate::ffi::maybe_wrap;
use crate::logger::{log_error, LdkLogger, Logger};
use crate::logger::{log_error, log_info, LdkLogger, Logger};
use crate::payment::{Bolt11Payment, Bolt12Payment, OnchainPayment};
use crate::types::HRNResolver;
use crate::Config;
Expand DownExpand Up@@ -167,6 +167,87 @@ impl UnifiedPayment {
 Ok(format_uri(uri))
	}

	/// Generates a unified BIP21 URI identical in structure to [`receive`], but uses a
	/// JIT (Just-In-Time) BOLT 11 invoice via the configured LSP liquidity source for
	/// the purpose of providing inbound liquidity on the fly.
	///
	/// This method is designed to be called when the node has insufficient inbound capacity
	/// to receive the payment over standard Lightning routes. **Note that this method does not
	/// automatically detect your current inbound capacity;** the determination of whether
	/// inbound capacity is lacking, and the decision to invoke this JIT flow, is left entirely
	/// to the discretion of the developer.
	///
	/// Like [`receive`], the resulting URI provides an on-chain fallback address and a BOLT 12
	/// offer. However, the attached BOLT 11 invoice is provisioned through an External Liquidity
	/// Provider (LSP) to dynamically open a JIT channel when the payer routes the payment. If no
	/// LSP is configured or the JIT generation fails, it falls back to standard local invoice
	/// generation.
	///
	/// # Parameters
	/// - `amount_sats`: The amount to be received, specified in satoshis.
	/// - `description`: A description or note associated with the payment.
	/// This message is visible to the payer and can provide context or details about the payment.
	/// - `expiry_sec`: The expiration time for the payment, specified in seconds.
	/// - `max_total_lsp_fee_limit_msat`: An optional fee cap in millisatoshis defining the maximum
	/// fee you are willing to allow the LSP to charge for opening the JIT liquidity channel.
	///
	/// # Warning
	/// Because this method may require synchronous network negotiation with an external LSP,
	/// it can block the calling thread. Mobile applications should ensure this is invoked
	/// from a background thread to prevent UI freezing.
	pub fn receive_via_jit_channel(
 &self, amount_sats: u64, description: &str, expiry_sec: u32,
 max_total_lsp_fee_limit_msat: Option<u64>,
	) -> Result<String, Error> {
 let onchain_address = self.onchain_payment.new_address()?;
 let amount_msats = amount_sats * 1_000;

 let bolt12_offer =
 match self.bolt12_payment.receive_inner(amount_msats, description, None, None) {
 Ok(offer) => Some(maybe_wrap(offer)),
 Err(e) => {
 log_error!(self.logger, "Failed to create offer: {}", e);
 None
 },
 };

 let invoice_description = Bolt11InvoiceDescription::Direct(
 Description::new(description.to_string()).map_err(|_| Error::InvoiceCreationFailed)?,
 );

 let bolt11_invoice = match self.bolt11_invoice.receive_via_jit_channel(
 amount_msats,
 &invoice_description,
 expiry_sec,
 max_total_lsp_fee_limit_msat,
 ) {
 Ok(invoice) => Some(invoice),
 Err(Error::LiquiditySourceUnavailable) => {
 log_info!(
 self.logger,
 "No LSP configured. Falling back to local invoice generation."
 );
 self.bolt11_invoice.receive(amount_msats, &invoice_description, expiry_sec).ok()
 },
 Err(e) => {
 log_error!(
 self.logger,
 "LSP JIT invoice creation failed: {:?}. Falling back to local invoice.",
 e
 );
 self.bolt11_invoice.receive(amount_msats, &invoice_description, expiry_sec).ok()
 },
 };

 let extras = Extras { bolt11_invoice, bolt12_offer };

 let mut uri = Uri::with_extras(onchain_address, extras);
 uri.amount = Some(Amount::from_sat(amount_sats));
 uri.message = Some(description.into());

 Ok(format_uri(uri))
	}

	/// Sends a payment given a [BIP 21] URI or [BIP 353] Human-Readable Name.
	///
	/// This method parses the provided URI string and attempts to send the payment. If the URI
Expand Down
Loading

, '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('^' + ".*" + '
Introduce receive_via_jit_channel to UnifiedPayment by chuksys · Pull Request #914 · lightningdevkit/ldk-node · GitHub
Skip to content
Introduce receive_via_jit_channel to UnifiedPayment#914

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.

 Sign up for GitHub

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

 Draft

chuksys
wants to merge
1
commit into

base:main
Choose a base branch

from

 Draft


Introduce receive_via_jit_channel to UnifiedPayment
#914
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


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


83 changes: 82 additions & 1 deletion
src/payment/unified.rs

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -32,7 +32,7 @@ use lightning_invoice::{Bolt11Invoice, Bolt11InvoiceDescription, Description};
use crate::config::HRN_RESOLUTION_TIMEOUT_SECS;
use crate::error::Error;
use crate::ffi::maybe_wrap;
use crate::logger::{log_error, LdkLogger, Logger};
use crate::logger::{log_error, log_info, LdkLogger, Logger};
use crate::payment::{Bolt11Payment, Bolt12Payment, OnchainPayment};
use crate::types::HRNResolver;
use crate::Config;
Expand DownExpand Up@@ -167,6 +167,87 @@ impl UnifiedPayment {
 Ok(format_uri(uri))
	}

	/// Generates a unified BIP21 URI identical in structure to [`receive`], but uses a
	/// JIT (Just-In-Time) BOLT 11 invoice via the configured LSP liquidity source for
	/// the purpose of providing inbound liquidity on the fly.
	///
	/// This method is designed to be called when the node has insufficient inbound capacity
	/// to receive the payment over standard Lightning routes. **Note that this method does not
	/// automatically detect your current inbound capacity;** the determination of whether
	/// inbound capacity is lacking, and the decision to invoke this JIT flow, is left entirely
	/// to the discretion of the developer.
	///
	/// Like [`receive`], the resulting URI provides an on-chain fallback address and a BOLT 12
	/// offer. However, the attached BOLT 11 invoice is provisioned through an External Liquidity
	/// Provider (LSP) to dynamically open a JIT channel when the payer routes the payment. If no
	/// LSP is configured or the JIT generation fails, it falls back to standard local invoice
	/// generation.
	///
	/// # Parameters
	/// - `amount_sats`: The amount to be received, specified in satoshis.
	/// - `description`: A description or note associated with the payment.
	/// This message is visible to the payer and can provide context or details about the payment.
	/// - `expiry_sec`: The expiration time for the payment, specified in seconds.
	/// - `max_total_lsp_fee_limit_msat`: An optional fee cap in millisatoshis defining the maximum
	/// fee you are willing to allow the LSP to charge for opening the JIT liquidity channel.
	///
	/// # Warning
	/// Because this method may require synchronous network negotiation with an external LSP,
	/// it can block the calling thread. Mobile applications should ensure this is invoked
	/// from a background thread to prevent UI freezing.
	pub fn receive_via_jit_channel(
 &self, amount_sats: u64, description: &str, expiry_sec: u32,
 max_total_lsp_fee_limit_msat: Option<u64>,
	) -> Result<String, Error> {
 let onchain_address = self.onchain_payment.new_address()?;
 let amount_msats = amount_sats * 1_000;

 let bolt12_offer =
 match self.bolt12_payment.receive_inner(amount_msats, description, None, None) {
 Ok(offer) => Some(maybe_wrap(offer)),
 Err(e) => {
 log_error!(self.logger, "Failed to create offer: {}", e);
 None
 },
 };

 let invoice_description = Bolt11InvoiceDescription::Direct(
 Description::new(description.to_string()).map_err(|_| Error::InvoiceCreationFailed)?,
 );

 let bolt11_invoice = match self.bolt11_invoice.receive_via_jit_channel(
 amount_msats,
 &invoice_description,
 expiry_sec,
 max_total_lsp_fee_limit_msat,
 ) {
 Ok(invoice) => Some(invoice),
 Err(Error::LiquiditySourceUnavailable) => {
 log_info!(
 self.logger,
 "No LSP configured. Falling back to local invoice generation."
 );
 self.bolt11_invoice.receive(amount_msats, &invoice_description, expiry_sec).ok()
 },
 Err(e) => {
 log_error!(
 self.logger,
 "LSP JIT invoice creation failed: {:?}. Falling back to local invoice.",
 e
 );
 self.bolt11_invoice.receive(amount_msats, &invoice_description, expiry_sec).ok()
 },
 };

 let extras = Extras { bolt11_invoice, bolt12_offer };

 let mut uri = Uri::with_extras(onchain_address, extras);
 uri.amount = Some(Amount::from_sat(amount_sats));
 uri.message = Some(description.into());

 Ok(format_uri(uri))
	}

	/// Sends a payment given a [BIP 21] URI or [BIP 353] Human-Readable Name.
	///
	/// This method parses the provided URI string and attempts to send the payment. If the URI
Expand Down
Loading

, '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); }
})();
})();
Introduce receive_via_jit_channel to UnifiedPayment by chuksys · Pull Request #914 · lightningdevkit/ldk-node · GitHub
Skip to content
Introduce receive_via_jit_channel to UnifiedPayment#914

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.

 Sign up for GitHub

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

 Draft

chuksys
wants to merge
1
commit into

base:main
Choose a base branch

from

 Draft


Introduce receive_via_jit_channel to UnifiedPayment
#914
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


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


83 changes: 82 additions & 1 deletion
src/payment/unified.rs

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -32,7 +32,7 @@ use lightning_invoice::{Bolt11Invoice, Bolt11InvoiceDescription, Description};
use crate::config::HRN_RESOLUTION_TIMEOUT_SECS;
use crate::error::Error;
use crate::ffi::maybe_wrap;
use crate::logger::{log_error, LdkLogger, Logger};
use crate::logger::{log_error, log_info, LdkLogger, Logger};
use crate::payment::{Bolt11Payment, Bolt12Payment, OnchainPayment};
use crate::types::HRNResolver;
use crate::Config;
Expand DownExpand Up@@ -167,6 +167,87 @@ impl UnifiedPayment {
 Ok(format_uri(uri))
	}

	/// Generates a unified BIP21 URI identical in structure to [`receive`], but uses a
	/// JIT (Just-In-Time) BOLT 11 invoice via the configured LSP liquidity source for
	/// the purpose of providing inbound liquidity on the fly.
	///
	/// This method is designed to be called when the node has insufficient inbound capacity
	/// to receive the payment over standard Lightning routes. **Note that this method does not
	/// automatically detect your current inbound capacity;** the determination of whether
	/// inbound capacity is lacking, and the decision to invoke this JIT flow, is left entirely
	/// to the discretion of the developer.
	///
	/// Like [`receive`], the resulting URI provides an on-chain fallback address and a BOLT 12
	/// offer. However, the attached BOLT 11 invoice is provisioned through an External Liquidity
	/// Provider (LSP) to dynamically open a JIT channel when the payer routes the payment. If no
	/// LSP is configured or the JIT generation fails, it falls back to standard local invoice
	/// generation.
	///
	/// # Parameters
	/// - `amount_sats`: The amount to be received, specified in satoshis.
	/// - `description`: A description or note associated with the payment.
	/// This message is visible to the payer and can provide context or details about the payment.
	/// - `expiry_sec`: The expiration time for the payment, specified in seconds.
	/// - `max_total_lsp_fee_limit_msat`: An optional fee cap in millisatoshis defining the maximum
	/// fee you are willing to allow the LSP to charge for opening the JIT liquidity channel.
	///
	/// # Warning
	/// Because this method may require synchronous network negotiation with an external LSP,
	/// it can block the calling thread. Mobile applications should ensure this is invoked
	/// from a background thread to prevent UI freezing.
	pub fn receive_via_jit_channel(
 &self, amount_sats: u64, description: &str, expiry_sec: u32,
 max_total_lsp_fee_limit_msat: Option<u64>,
	) -> Result<String, Error> {
 let onchain_address = self.onchain_payment.new_address()?;
 let amount_msats = amount_sats * 1_000;

 let bolt12_offer =
 match self.bolt12_payment.receive_inner(amount_msats, description, None, None) {
 Ok(offer) => Some(maybe_wrap(offer)),
 Err(e) => {
 log_error!(self.logger, "Failed to create offer: {}", e);
 None
 },
 };

 let invoice_description = Bolt11InvoiceDescription::Direct(
 Description::new(description.to_string()).map_err(|_| Error::InvoiceCreationFailed)?,
 );

 let bolt11_invoice = match self.bolt11_invoice.receive_via_jit_channel(
 amount_msats,
 &invoice_description,
 expiry_sec,
 max_total_lsp_fee_limit_msat,
 ) {
 Ok(invoice) => Some(invoice),
 Err(Error::LiquiditySourceUnavailable) => {
 log_info!(
 self.logger,
 "No LSP configured. Falling back to local invoice generation."
 );
 self.bolt11_invoice.receive(amount_msats, &invoice_description, expiry_sec).ok()
 },
 Err(e) => {
 log_error!(
 self.logger,
 "LSP JIT invoice creation failed: {:?}. Falling back to local invoice.",
 e
 );
 self.bolt11_invoice.receive(amount_msats, &invoice_description, expiry_sec).ok()
 },
 };

 let extras = Extras { bolt11_invoice, bolt12_offer };

 let mut uri = Uri::with_extras(onchain_address, extras);
 uri.amount = Some(Amount::from_sat(amount_sats));
 uri.message = Some(description.into());

 Ok(format_uri(uri))
	}

	/// Sends a payment given a [BIP 21] URI or [BIP 353] Human-Readable Name.
	///
	/// This method parses the provided URI string and attempts to send the payment. If the URI
Expand Down
Loading