1 pub mod bitcoind_client;
7 use crate::bitcoind_client::BitcoindClient;
8 use crate::disk::FilesystemLogger;
9 use bitcoin::blockdata::constants::genesis_block;
10 use bitcoin::blockdata::transaction::Transaction;
11 use bitcoin::consensus::encode;
12 use bitcoin::hashes::sha256::Hash as Sha256;
13 use bitcoin::hashes::Hash;
14 use bitcoin::network::constants::Network;
15 use bitcoin::secp256k1::Secp256k1;
16 use bitcoin::BlockHash;
17 use bitcoin_bech32::WitnessProgram;
19 use lightning::chain::chaininterface::{BroadcasterInterface, ConfirmationTarget, FeeEstimator};
20 use lightning::chain::chainmonitor;
21 use lightning::chain::keysinterface::{InMemorySigner, KeysInterface, KeysManager};
22 use lightning::chain::{BestBlock, Filter, Watch};
23 use lightning::ln::channelmanager;
24 use lightning::ln::channelmanager::{
25 ChainParameters, ChannelManagerReadArgs, SimpleArcChannelManager,
27 use lightning::ln::peer_handler::{MessageHandler, SimpleArcPeerManager};
28 use lightning::ln::{PaymentHash, PaymentPreimage, PaymentSecret};
29 use lightning::routing::network_graph::NetGraphMsgHandler;
30 use lightning::util::config::UserConfig;
31 use lightning::util::events::{Event, PaymentPurpose};
32 use lightning::util::ser::ReadableArgs;
33 use lightning_background_processor::BackgroundProcessor;
34 use lightning_block_sync::init;
35 use lightning_block_sync::poll;
36 use lightning_block_sync::SpvClient;
37 use lightning_block_sync::UnboundedCache;
38 use lightning_net_tokio::SocketDescriptor;
39 use lightning_persister::FilesystemPersister;
40 use rand::{thread_rng, Rng};
41 use std::collections::hash_map::Entry;
42 use std::collections::HashMap;
50 use std::sync::{Arc, Mutex};
51 use std::time::{Duration, SystemTime};
53 pub(crate) enum HTLCStatus {
59 pub(crate) struct MillisatAmount(Option<u64>);
61 impl fmt::Display for MillisatAmount {
62 fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
64 Some(amt) => write!(f, "{}", amt),
65 None => write!(f, "unknown"),
70 pub(crate) struct PaymentInfo {
71 preimage: Option<PaymentPreimage>,
72 secret: Option<PaymentSecret>,
74 amt_msat: MillisatAmount,
77 pub(crate) type PaymentInfoStorage = Arc<Mutex<HashMap<PaymentHash, PaymentInfo>>>;
79 type ChainMonitor = chainmonitor::ChainMonitor<
81 Arc<dyn Filter + Send + Sync>,
84 Arc<FilesystemLogger>,
85 Arc<FilesystemPersister>,
88 pub(crate) type PeerManager = SimpleArcPeerManager<
93 dyn chain::Access + Send + Sync,
97 pub(crate) type ChannelManager =
98 SimpleArcChannelManager<ChainMonitor, BitcoindClient, BitcoindClient, FilesystemLogger>;
100 async fn handle_ldk_events(
101 channel_manager: Arc<ChannelManager>, bitcoind_client: Arc<BitcoindClient>,
102 keys_manager: Arc<KeysManager>, inbound_payments: PaymentInfoStorage,
103 outbound_payments: PaymentInfoStorage, network: Network, event: Event,
106 Event::FundingGenerationReady {
107 temporary_channel_id,
108 channel_value_satoshis,
112 // Construct the raw transaction with one output, that is paid the amount of the
114 let addr = WitnessProgram::from_scriptpubkey(
117 Network::Bitcoin => bitcoin_bech32::constants::Network::Bitcoin,
118 Network::Testnet => bitcoin_bech32::constants::Network::Testnet,
119 Network::Regtest => bitcoin_bech32::constants::Network::Regtest,
120 Network::Signet => panic!("Signet unsupported"),
123 .expect("Lightning funding tx should always be to a SegWit output")
125 let mut outputs = vec![HashMap::with_capacity(1)];
126 outputs[0].insert(addr, channel_value_satoshis as f64 / 100_000_000.0);
127 let raw_tx = bitcoind_client.create_raw_transaction(outputs).await;
129 // Have your wallet put the inputs into the transaction such that the output is
131 let funded_tx = bitcoind_client.fund_raw_transaction(raw_tx).await;
132 let change_output_position = funded_tx.changepos;
133 assert!(change_output_position == 0 || change_output_position == 1);
135 // Sign the final funding transaction and broadcast it.
136 let signed_tx = bitcoind_client.sign_raw_transaction_with_wallet(funded_tx.hex).await;
137 assert_eq!(signed_tx.complete, true);
138 let final_tx: Transaction =
139 encode::deserialize(&hex_utils::to_vec(&signed_tx.hex).unwrap()).unwrap();
140 // Give the funding transaction back to LDK for opening the channel.
142 .funding_transaction_generated(&temporary_channel_id, final_tx)
146 "\nERROR: Channel went away before we could fund it. The peer disconnected or refused the channel.");
148 io::stdout().flush().unwrap();
151 Event::PaymentReceived { payment_hash, purpose, amt, .. } => {
152 let mut payments = inbound_payments.lock().unwrap();
153 let (payment_preimage, payment_secret) = match purpose {
154 PaymentPurpose::InvoicePayment { payment_preimage, payment_secret, .. } => {
155 (payment_preimage, Some(payment_secret))
157 PaymentPurpose::SpontaneousPayment(preimage) => (Some(preimage), None),
159 let status = match channel_manager.claim_funds(payment_preimage.unwrap()) {
162 "\nEVENT: received payment from payment hash {} of {} millisatoshis",
163 hex_utils::hex_str(&payment_hash.0),
167 io::stdout().flush().unwrap();
168 HTLCStatus::Succeeded
170 _ => HTLCStatus::Failed,
172 match payments.entry(payment_hash) {
173 Entry::Occupied(mut e) => {
174 let payment = e.get_mut();
175 payment.status = status;
176 payment.preimage = payment_preimage;
177 payment.secret = payment_secret;
179 Entry::Vacant(e) => {
180 e.insert(PaymentInfo {
181 preimage: payment_preimage,
182 secret: payment_secret,
184 amt_msat: MillisatAmount(Some(amt)),
189 Event::PaymentSent { payment_preimage } => {
190 let hashed = PaymentHash(Sha256::hash(&payment_preimage.0).into_inner());
191 let mut payments = outbound_payments.lock().unwrap();
192 for (payment_hash, payment) in payments.iter_mut() {
193 if *payment_hash == hashed {
194 payment.preimage = Some(payment_preimage);
195 payment.status = HTLCStatus::Succeeded;
197 "\nEVENT: successfully sent payment of {} millisatoshis from \
198 payment hash {:?} with preimage {:?}",
200 hex_utils::hex_str(&payment_hash.0),
201 hex_utils::hex_str(&payment_preimage.0)
204 io::stdout().flush().unwrap();
208 Event::PaymentFailed { payment_hash, rejected_by_dest } => {
210 "\nEVENT: Failed to send payment to payment hash {:?}: ",
211 hex_utils::hex_str(&payment_hash.0)
213 if rejected_by_dest {
214 println!("re-attempting the payment will not succeed");
216 println!("payment may be retried");
219 io::stdout().flush().unwrap();
221 let mut payments = outbound_payments.lock().unwrap();
222 if payments.contains_key(&payment_hash) {
223 let payment = payments.get_mut(&payment_hash).unwrap();
224 payment.status = HTLCStatus::Failed;
227 Event::PendingHTLCsForwardable { time_forwardable } => {
228 let forwarding_channel_manager = channel_manager.clone();
229 tokio::spawn(async move {
230 let min = time_forwardable.as_millis() as u64;
231 let millis_to_sleep = thread_rng().gen_range(min, min * 5) as u64;
232 tokio::time::sleep(Duration::from_millis(millis_to_sleep)).await;
233 forwarding_channel_manager.process_pending_htlc_forwards();
236 Event::SpendableOutputs { outputs } => {
237 let destination_address = bitcoind_client.get_new_address().await;
238 let output_descriptors = &outputs.iter().map(|a| a).collect::<Vec<_>>();
240 bitcoind_client.get_est_sat_per_1000_weight(ConfirmationTarget::Normal);
241 let spending_tx = keys_manager
242 .spend_spendable_outputs(
245 destination_address.script_pubkey(),
250 bitcoind_client.broadcast_transaction(&spending_tx);
255 async fn start_ldk() {
256 let args = match cli::parse_startup_args() {
257 Ok(user_args) => user_args,
261 // Initialize the LDK data directory if necessary.
262 let ldk_data_dir = format!("{}/.ldk", args.ldk_storage_dir_path);
263 fs::create_dir_all(ldk_data_dir.clone()).unwrap();
265 // Initialize our bitcoind client.
266 let bitcoind_client = match BitcoindClient::new(
267 args.bitcoind_rpc_host.clone(),
268 args.bitcoind_rpc_port,
269 args.bitcoind_rpc_username.clone(),
270 args.bitcoind_rpc_password.clone(),
274 Ok(client) => Arc::new(client),
276 println!("Failed to connect to bitcoind client: {}", e);
281 // Check that the bitcoind we've connected to is running the network we expect
282 let bitcoind_chain = bitcoind_client.get_blockchain_info().await.chain;
284 != match args.network {
285 bitcoin::Network::Bitcoin => "main",
286 bitcoin::Network::Testnet => "test",
287 bitcoin::Network::Regtest => "regtest",
288 bitcoin::Network::Signet => "signet",
291 "Chain argument ({}) didn't match bitcoind chain ({})",
292 args.network, bitcoind_chain
298 // Step 1: Initialize the FeeEstimator
300 // BitcoindClient implements the FeeEstimator trait, so it'll act as our fee estimator.
301 let fee_estimator = bitcoind_client.clone();
303 // Step 2: Initialize the Logger
304 let logger = Arc::new(FilesystemLogger::new(ldk_data_dir.clone()));
306 // Step 3: Initialize the BroadcasterInterface
308 // BitcoindClient implements the BroadcasterInterface trait, so it'll act as our transaction
310 let broadcaster = bitcoind_client.clone();
312 // Step 4: Initialize Persist
313 let persister = Arc::new(FilesystemPersister::new(ldk_data_dir.clone()));
315 // Step 5: Initialize the ChainMonitor
316 let chain_monitor: Arc<ChainMonitor> = Arc::new(chainmonitor::ChainMonitor::new(
320 fee_estimator.clone(),
324 // Step 6: Initialize the KeysManager
326 // The key seed that we use to derive the node privkey (that corresponds to the node pubkey) and
327 // other secret key material.
328 let keys_seed_path = format!("{}/keys_seed", ldk_data_dir.clone());
329 let keys_seed = if let Ok(seed) = fs::read(keys_seed_path.clone()) {
330 assert_eq!(seed.len(), 32);
331 let mut key = [0; 32];
332 key.copy_from_slice(&seed);
335 let mut key = [0; 32];
336 thread_rng().fill_bytes(&mut key);
337 match File::create(keys_seed_path.clone()) {
339 f.write_all(&key).expect("Failed to write node keys seed to disk");
340 f.sync_all().expect("Failed to sync node keys seed to disk");
343 println!("ERROR: Unable to create keys seed file {}: {}", keys_seed_path, e);
349 let cur = SystemTime::now().duration_since(SystemTime::UNIX_EPOCH).unwrap();
350 let keys_manager = Arc::new(KeysManager::new(&keys_seed, cur.as_secs(), cur.subsec_nanos()));
352 // Step 7: Read ChannelMonitor state from disk
353 let mut channelmonitors = persister.read_channelmonitors(keys_manager.clone()).unwrap();
355 // Step 8: Initialize the ChannelManager
356 let mut user_config = UserConfig::default();
357 user_config.peer_channel_config_limits.force_announced_channel_preference = false;
358 let mut restarting_node = true;
359 let (channel_manager_blockhash, mut channel_manager) = {
360 if let Ok(mut f) = fs::File::open(format!("{}/manager", ldk_data_dir.clone())) {
361 let mut channel_monitor_mut_references = Vec::new();
362 for (_, channel_monitor) in channelmonitors.iter_mut() {
363 channel_monitor_mut_references.push(channel_monitor);
365 let read_args = ChannelManagerReadArgs::new(
366 keys_manager.clone(),
367 fee_estimator.clone(),
368 chain_monitor.clone(),
372 channel_monitor_mut_references,
374 <(BlockHash, ChannelManager)>::read(&mut f, read_args).unwrap()
376 // We're starting a fresh node.
377 restarting_node = false;
378 let getinfo_resp = bitcoind_client.get_blockchain_info().await;
380 let chain_params = ChainParameters {
381 network: args.network,
382 best_block: BestBlock::new(
383 getinfo_resp.latest_blockhash,
384 getinfo_resp.latest_height as u32,
387 let fresh_channel_manager = channelmanager::ChannelManager::new(
388 fee_estimator.clone(),
389 chain_monitor.clone(),
392 keys_manager.clone(),
396 (getinfo_resp.latest_blockhash, fresh_channel_manager)
400 // Step 9: Sync ChannelMonitors and ChannelManager to chain tip
401 let mut chain_listener_channel_monitors = Vec::new();
402 let mut cache = UnboundedCache::new();
403 let mut chain_tip: Option<poll::ValidatedBlockHeader> = None;
405 let mut chain_listeners =
406 vec![(channel_manager_blockhash, &mut channel_manager as &mut dyn chain::Listen)];
408 for (blockhash, channel_monitor) in channelmonitors.drain(..) {
409 let outpoint = channel_monitor.get_funding_txo().0;
410 chain_listener_channel_monitors.push((
412 (channel_monitor, broadcaster.clone(), fee_estimator.clone(), logger.clone()),
417 for monitor_listener_info in chain_listener_channel_monitors.iter_mut() {
418 chain_listeners.push((
419 monitor_listener_info.0,
420 &mut monitor_listener_info.1 as &mut dyn chain::Listen,
424 init::synchronize_listeners(
425 &mut bitcoind_client.deref(),
435 // Step 10: Give ChannelMonitors to ChainMonitor
436 for item in chain_listener_channel_monitors.drain(..) {
437 let channel_monitor = item.1 .0;
438 let funding_outpoint = item.2;
439 chain_monitor.watch_channel(funding_outpoint, channel_monitor).unwrap();
442 // Step 11: Optional: Initialize the NetGraphMsgHandler
443 let genesis = genesis_block(args.network).header.block_hash();
444 let network_graph_path = format!("{}/network_graph", ldk_data_dir.clone());
445 let network_graph = disk::read_network(Path::new(&network_graph_path), genesis);
446 let router = Arc::new(NetGraphMsgHandler::from_net_graph(
447 None::<Arc<dyn chain::Access + Send + Sync>>,
451 let router_persist = Arc::clone(&router);
452 tokio::spawn(async move {
453 let mut interval = tokio::time::interval(Duration::from_secs(600));
455 interval.tick().await;
456 if disk::persist_network(
457 Path::new(&network_graph_path),
458 &*router_persist.network_graph.read().unwrap(),
462 // Persistence errors here are non-fatal as we can just fetch the routing graph
463 // again later, but they may indicate a disk error which could be fatal elsewhere.
465 "Warning: Failed to persist network graph, check your disk and permissions"
471 // Step 12: Initialize the PeerManager
472 let channel_manager: Arc<ChannelManager> = Arc::new(channel_manager);
473 let mut ephemeral_bytes = [0; 32];
474 rand::thread_rng().fill_bytes(&mut ephemeral_bytes);
475 let lightning_msg_handler =
476 MessageHandler { chan_handler: channel_manager.clone(), route_handler: router.clone() };
477 let peer_manager: Arc<PeerManager> = Arc::new(PeerManager::new(
478 lightning_msg_handler,
479 keys_manager.get_node_secret(),
485 // Step 13: Initialize networking
487 let peer_manager_connection_handler = peer_manager.clone();
488 let listening_port = args.ldk_peer_listening_port;
489 tokio::spawn(async move {
490 let listener = tokio::net::TcpListener::bind(format!("0.0.0.0:{}", listening_port))
492 .expect("Failed to bind to listen port - is something else already listening on it?");
494 let peer_mgr = peer_manager_connection_handler.clone();
495 let tcp_stream = listener.accept().await.unwrap().0;
496 tokio::spawn(async move {
497 lightning_net_tokio::setup_inbound(
499 tcp_stream.into_std().unwrap(),
506 // Step 14: Connect and Disconnect Blocks
507 if chain_tip.is_none() {
509 Some(init::validate_best_block_header(&mut bitcoind_client.deref()).await.unwrap());
511 let channel_manager_listener = channel_manager.clone();
512 let chain_monitor_listener = chain_monitor.clone();
513 let bitcoind_block_source = bitcoind_client.clone();
514 let network = args.network;
515 tokio::spawn(async move {
516 let mut derefed = bitcoind_block_source.deref();
517 let chain_poller = poll::ChainPoller::new(&mut derefed, network);
518 let chain_listener = (chain_monitor_listener, channel_manager_listener);
520 SpvClient::new(chain_tip.unwrap(), chain_poller, &mut cache, &chain_listener);
522 spv_client.poll_best_tip().await.unwrap();
523 tokio::time::sleep(Duration::from_secs(1)).await;
527 // Step 15: Handle LDK Events
528 let channel_manager_event_listener = channel_manager.clone();
529 let keys_manager_listener = keys_manager.clone();
530 // TODO: persist payment info to disk
531 let inbound_payments: PaymentInfoStorage = Arc::new(Mutex::new(HashMap::new()));
532 let outbound_payments: PaymentInfoStorage = Arc::new(Mutex::new(HashMap::new()));
533 let inbound_pmts_for_events = inbound_payments.clone();
534 let outbound_pmts_for_events = outbound_payments.clone();
535 let network = args.network;
536 let bitcoind_rpc = bitcoind_client.clone();
537 let handle = tokio::runtime::Handle::current();
538 let event_handler = move |event| {
539 handle.block_on(handle_ldk_events(
540 channel_manager_event_listener.clone(),
541 bitcoind_rpc.clone(),
542 keys_manager_listener.clone(),
543 inbound_pmts_for_events.clone(),
544 outbound_pmts_for_events.clone(),
549 // Step 16: Persist ChannelManager
550 let data_dir = ldk_data_dir.clone();
551 let persist_channel_manager_callback =
552 move |node: &ChannelManager| FilesystemPersister::persist_manager(data_dir.clone(), &*node);
553 // Step 17: Background Processing
554 BackgroundProcessor::start(
555 persist_channel_manager_callback,
557 chain_monitor.clone(),
558 channel_manager.clone(),
559 peer_manager.clone(),
563 // Reconnect to channel peers if possible.
564 let peer_data_path = format!("{}/channel_peer_data", ldk_data_dir.clone());
565 match disk::read_channel_peer_data(Path::new(&peer_data_path)) {
567 for (pubkey, peer_addr) in info.drain() {
568 for chan_info in channel_manager.list_channels() {
569 if pubkey == chan_info.counterparty.node_id {
571 cli::connect_peer_if_necessary(pubkey, peer_addr, peer_manager.clone())
577 Err(e) => println!("ERROR: errored reading channel peer info from disk: {:?}", e),
580 // Regularly broadcast our node_announcement. This is only required (or possible) if we have
581 // some public channels, and is only useful if we have public listen address(es) to announce.
582 // In a production environment, this should occur only after the announcement of new channels
583 // to avoid churn in the global network graph.
584 let chan_manager = Arc::clone(&channel_manager);
585 let network = args.network;
586 if !args.ldk_announced_listen_addr.is_empty() {
587 tokio::spawn(async move {
588 let mut interval = tokio::time::interval(Duration::from_secs(60));
590 interval.tick().await;
591 chan_manager.broadcast_node_announcement(
593 args.ldk_announced_node_name,
594 args.ldk_announced_listen_addr.clone(),
601 cli::poll_for_user_input(
602 peer_manager.clone(),
603 channel_manager.clone(),
604 keys_manager.clone(),
608 ldk_data_dir.clone(),
616 pub async fn main() {