Skip to content

feat: add configurable route hints to BOLT11 receive APIs #2

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

Merged
kaloudis merged 4 commits into from
Jul 29, 2026
Merged

feat: add configurable route hints to BOLT11 receive APIs #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
ffce1d0
feat: add configurable route hints to BOLT11 receive APIs
ajaysehwal Jul 15, 2026
e70a3c6
fix(bolt11): fail fast on invalid custom route hints
ajaysehwal Jul 16, 2026
2c52073
refactor(bolt11): use LDK route_hints_override and RouteHints enum
ajaysehwal Jul 28, 2026
206155e
fix(bolt11): rustfmt and document MAX_CUSTOM_ROUTE_HINTS on receive APIs
ajaysehwal Jul 29, 2026
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
24 changes: 12 additions & 12 deletions Cargo.lock
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

16 changes: 16 additions & 0 deletions bindings/ldk_node.udl
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -212,6 +212,14 @@ interface Bolt11InvoiceDescription {
Direct(string description);
};

// Custom accepts at most 3 UserChannelId values; invalid or unusable IDs fail with InvalidChannelId.
[Enum]
interface RouteHints {
None();
Automatic();
Custom(sequence<UserChannelId> user_channel_ids);
};

interface Bolt11Payment {
[Throws=NodeError]
PaymentId send([ByRef]Bolt11Invoice invoice, RouteParametersConfig? route_parameters, u64? payment_timeout_secs);
Expand All @@ -232,6 +240,14 @@ interface Bolt11Payment {
[Throws=NodeError]
Bolt11Invoice receive_variable_amount([ByRef]Bolt11InvoiceDescription description, u32 expiry_secs);
[Throws=NodeError]
Bolt11Invoice receive_with_route_hints(u64 amount_msat, [ByRef]Bolt11InvoiceDescription description, u32 expiry_secs, RouteHints route_hints);
[Throws=NodeError]
Bolt11Invoice receive_for_hash_with_route_hints(u64 amount_msat, [ByRef]Bolt11InvoiceDescription description, u32 expiry_secs, PaymentHash payment_hash, RouteHints route_hints);
[Throws=NodeError]
Bolt11Invoice receive_variable_amount_with_route_hints([ByRef]Bolt11InvoiceDescription description, u32 expiry_secs, RouteHints route_hints);
[Throws=NodeError]
Bolt11Invoice receive_variable_amount_for_hash_with_route_hints([ByRef]Bolt11InvoiceDescription description, u32 expiry_secs, PaymentHash payment_hash, RouteHints route_hints);
[Throws=NodeError]
Bolt11Invoice receive_variable_amount_for_hash([ByRef]Bolt11InvoiceDescription description, u32 expiry_secs, PaymentHash payment_hash);
[Throws=NodeError]
Bolt11Invoice receive_via_jit_channel(u64 amount_msat, [ByRef]Bolt11InvoiceDescription description, u32 expiry_secs, u64? max_lsp_fee_limit_msat);
Expand Down
2 changes: 1 addition & 1 deletion src/ffi/types.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ pub use crate::logger::{LogLevel, LogRecord, LogWriter};
pub use crate::payment::store::{
ConfirmationStatus, LSPFeeLimits, PaymentDirection, PaymentKind, PaymentStatus,
};
pub use crate::payment::QrPaymentResult;
pub use crate::payment::{QrPaymentResult, RouteHints};
use crate::{hex_utils, SocketAddress, UniffiCustomTypeConverter, UserChannelId};

impl UniffiCustomTypeConverter for PublicKey {
Expand Down
Loading
Loading