Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
20 changes: 16 additions & 4 deletions Cargo.lock

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

13 changes: 13 additions & 0 deletions contrib/ldk-server-config.toml
Original file line number Diff line number Diff line change
Expand Up @@ -103,3 +103,16 @@ poll_metrics_interval = 60 # The polling interval for metrics in seconds.
[tor]
# Only connections to OnionV3 peers will be made via this proxy; other connections (IPv4 peers, Electrum server) will not be routed over Tor.
#proxy_address = "127.0.0.1:9050" # Tor daemon SOCKS proxy address.

# Human-Readable Names (BIP 353) resolution
[hrn]
# Resolution method: "dns" (resolve locally via a DNS server) or "blip32" (ask other
# nodes to resolve for us via bLIP-32). Defaults to "dns".
#mode = "dns"
# DNS server used when `mode = "dns"`. Defaults to 8.8.8.8:53 (Google Public DNS). The
# port defaults to 53 if omitted (e.g., "1.1.1.1" is treated as "1.1.1.1:53").
#dns_server_address = "8.8.8.8:53"
# When set to true (and `mode = "dns"`), also offer HRN resolution to the rest of the
# network over Onion Messages. Requires the node to be announceable so resolution
# requests can be routed to us. Defaults to false.
#enable_resolution_service = false
17 changes: 17 additions & 0 deletions docs/configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -123,6 +123,23 @@ are not proxied. This does not set up inbound connections, to make your node rea
hidden service, you need to configure Tor separately. See the [Tor guide](tor.md) for the
full setup.

### `[hrn]`

Configures how the node resolves [BIP 353](https://github.com/bitcoin/bips/blob/master/bip-0353.mediawiki)
Human-Readable Names (e.g., `₿alice@example.com`) to Lightning payment destinations.

Two resolution methods are supported via the `mode` field:

- **`"dns"`** (default) - Resolve names locally using a DNS server. The server is set via
`dns_server_address` (default: `8.8.8.8:53`, Google Public DNS). The port defaults to
`53` if omitted. When `enable_resolution_service = true`, the node additionally offers
HRN resolution to the rest of the network over Onion Messages. This requires the node
to be announceable so resolution requests can be routed to it, and is therefore
disabled by default.
- **`"blip32"`** - Ask other nodes to resolve names on our behalf via
[bLIP-32](https://github.com/lightning/blips/blob/master/blip-0032.md). `dns_server_address`
and `enable_resolution_service` only apply in `"dns"` mode and are rejected here.

## Storage Layout

```
Expand Down
2 changes: 1 addition & 1 deletion ldk-server/Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ version = "0.1.0"
edition = "2021"

[dependencies]
ldk-node = { git = "https://github.com/lightningdevkit/ldk-node", rev = "c754e2fe85c70741b5e370334cd16856c615265e" }
ldk-node = { git = "https://github.com/lightningdevkit/ldk-node", rev = "21eea8c881790db7a90bcad4f7f45f341c72222b" }
serde = { version = "1.0.203", default-features = false, features = ["derive"] }
hyper = { version = "1", default-features = false, features = ["server", "http2"] }
http-body-util = { version = "0.1", default-features = false }
Expand Down
1 change: 1 addition & 0 deletions ldk-server/src/main.rs
Original file line number Diff line number Diff line change
Expand Up @@ -141,6 +141,7 @@ fn main() {
ldk_node_config.listening_addresses = config_file.listening_addrs;
ldk_node_config.announcement_addresses = config_file.announcement_addrs;
ldk_node_config.network = config_file.network;
ldk_node_config.hrn_config = config_file.hrn_config;

let mut builder = Builder::from_config(ldk_node_config);
builder.set_log_facade_logger();
Expand Down
Loading