2020-08-10 15:00:09 -04:00
// This file is Copyright its original authors, visible in version control
// history.
//
// This file is licensed under the Apache License, Version 2.0 <LICENSE-APACHE
// or http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your option.
// You may not use this file except in accordance with one or both of these
// licenses.
2020-05-02 15:05:04 -04:00
//! The top-level network map tracking logic lives here.
use bitcoin ::secp256k1 ::key ::PublicKey ;
use bitcoin ::secp256k1 ::Secp256k1 ;
use bitcoin ::secp256k1 ;
use bitcoin ::hashes ::sha256d ::Hash as Sha256dHash ;
use bitcoin ::hashes ::Hash ;
use bitcoin ::blockdata ::script ::Builder ;
2020-07-17 22:08:34 -07:00
use bitcoin ::blockdata ::transaction ::TxOut ;
2020-05-02 15:05:04 -04:00
use bitcoin ::blockdata ::opcodes ;
2020-10-22 10:51:54 -04:00
use bitcoin ::hash_types ::BlockHash ;
2020-05-02 15:05:04 -04:00
2020-07-17 22:08:34 -07:00
use chain ;
use chain ::Access ;
2020-05-02 15:05:04 -04:00
use ln ::features ::{ ChannelFeatures , NodeFeatures } ;
2020-05-30 23:20:17 -04:00
use ln ::msgs ::{ DecodeError , ErrorAction , LightningError , RoutingMessageHandler , NetAddress , MAX_VALUE_MSAT } ;
use ln ::msgs ::{ ChannelAnnouncement , ChannelUpdate , NodeAnnouncement , OptionalField } ;
2020-10-22 10:51:54 -04:00
use ln ::msgs ::{ QueryChannelRange , ReplyChannelRange , QueryShortChannelIds , ReplyShortChannelIdsEnd } ;
2020-05-02 15:05:04 -04:00
use ln ::msgs ;
2020-05-06 18:34:37 -04:00
use util ::ser ::{ Writeable , Readable , Writer } ;
2020-05-02 15:05:04 -04:00
use util ::logger ::Logger ;
2020-10-22 10:51:54 -04:00
use util ::events ;
2020-05-02 15:05:04 -04:00
2020-06-11 15:32:23 -04:00
use std ::{ cmp , fmt } ;
2020-08-24 14:14:05 -04:00
use std ::sync ::{ RwLock , RwLockReadGuard } ;
2020-05-02 15:05:04 -04:00
use std ::sync ::atomic ::{ AtomicUsize , Ordering } ;
2020-10-22 10:51:54 -04:00
use std ::sync ::Mutex ;
2020-05-02 15:05:04 -04:00
use std ::collections ::BTreeMap ;
use std ::collections ::btree_map ::Entry as BtreeEntry ;
2020-03-02 12:55:53 -05:00
use std ::ops ::Deref ;
2020-07-13 13:16:32 +09:00
use bitcoin ::hashes ::hex ::ToHex ;
2020-05-02 15:05:04 -04:00
2020-06-11 15:34:28 -04:00
/// Represents the network as nodes and channels between them
#[ derive(PartialEq) ]
pub struct NetworkGraph {
2020-11-29 15:20:35 -05:00
genesis_hash : BlockHash ,
2020-06-11 15:34:28 -04:00
channels : BTreeMap < u64 , ChannelInfo > ,
nodes : BTreeMap < PublicKey , NodeInfo > ,
}
2020-08-24 14:14:05 -04:00
/// A simple newtype for RwLockReadGuard<'a, NetworkGraph>.
/// This exists only to make accessing a RwLock<NetworkGraph> possible from
/// the C bindings, as it can be done directly in Rust code.
pub struct LockedNetworkGraph < ' a > ( pub RwLockReadGuard < ' a , NetworkGraph > ) ;
2020-05-06 19:04:44 -04:00
/// Receives and validates network updates from peers,
/// stores authentic and relevant data as a network graph.
/// This network graph is then used for routing payments.
/// Provides interface to help with initial routing sync by
/// serving historical announcements.
2020-07-17 22:08:34 -07:00
pub struct NetGraphMsgHandler < C : Deref , L : Deref > where C ::Target : chain ::Access , L ::Target : Logger {
2020-05-02 15:05:04 -04:00
secp_ctx : Secp256k1 < secp256k1 ::VerifyOnly > ,
/// Representation of the payment channel network
pub network_graph : RwLock < NetworkGraph > ,
2020-07-17 22:08:34 -07:00
chain_access : Option < C > ,
2020-05-02 15:05:04 -04:00
full_syncs_requested : AtomicUsize ,
2020-10-22 10:51:54 -04:00
pending_events : Mutex < Vec < events ::MessageSendEvent > > ,
2020-03-02 12:55:53 -05:00
logger : L ,
2020-05-02 15:05:04 -04:00
}
2020-07-17 22:08:34 -07:00
impl < C : Deref , L : Deref > NetGraphMsgHandler < C , L > where C ::Target : chain ::Access , L ::Target : Logger {
2020-05-06 18:34:37 -04:00
/// Creates a new tracker of the actual state of the network of channels and nodes,
2020-05-06 19:04:44 -04:00
/// assuming a fresh network graph.
/// Chain monitor is used to make sure announced channels exist on-chain,
/// channel data is correct, and that the announcement is signed with
/// channel owners' keys.
2020-11-29 15:20:35 -05:00
pub fn new ( genesis_hash : BlockHash , chain_access : Option < C > , logger : L ) -> Self {
2020-05-02 15:05:04 -04:00
NetGraphMsgHandler {
secp_ctx : Secp256k1 ::verification_only ( ) ,
2020-11-29 15:20:35 -05:00
network_graph : RwLock ::new ( NetworkGraph ::new ( genesis_hash ) ) ,
2020-05-02 15:05:04 -04:00
full_syncs_requested : AtomicUsize ::new ( 0 ) ,
2020-07-17 22:08:34 -07:00
chain_access ,
2020-10-22 10:51:54 -04:00
pending_events : Mutex ::new ( vec! [ ] ) ,
2020-03-02 12:55:53 -05:00
logger ,
2020-05-02 15:05:04 -04:00
}
}
2020-05-06 18:34:37 -04:00
/// Creates a new tracker of the actual state of the network of channels and nodes,
/// assuming an existing Network Graph.
2020-07-17 22:08:34 -07:00
pub fn from_net_graph ( chain_access : Option < C > , logger : L , network_graph : NetworkGraph ) -> Self {
2020-05-06 18:34:37 -04:00
NetGraphMsgHandler {
secp_ctx : Secp256k1 ::verification_only ( ) ,
2020-06-11 15:23:35 -04:00
network_graph : RwLock ::new ( network_graph ) ,
2020-05-06 18:34:37 -04:00
full_syncs_requested : AtomicUsize ::new ( 0 ) ,
2020-07-17 22:08:34 -07:00
chain_access ,
2020-10-22 10:51:54 -04:00
pending_events : Mutex ::new ( vec! [ ] ) ,
2020-03-02 12:55:53 -05:00
logger ,
2020-05-06 18:34:37 -04:00
}
}
2020-08-24 14:14:05 -04:00
/// Take a read lock on the network_graph and return it in the C-bindings
/// newtype helper. This is likely only useful when called via the C
/// bindings as you can call `self.network_graph.read().unwrap()` in Rust
/// yourself.
pub fn read_locked_graph < ' a > ( & ' a self ) -> LockedNetworkGraph < ' a > {
LockedNetworkGraph ( self . network_graph . read ( ) . unwrap ( ) )
}
}
impl < ' a > LockedNetworkGraph < ' a > {
/// Get a reference to the NetworkGraph which this read-lock contains.
pub fn graph ( & self ) -> & NetworkGraph {
& * self . 0
}
2020-05-02 15:05:04 -04:00
}
macro_rules ! secp_verify_sig {
( $secp_ctx : expr , $msg : expr , $sig : expr , $pubkey : expr ) = > {
match $secp_ctx . verify ( $msg , $sig , $pubkey ) {
Ok ( _ ) = > { } ,
2020-07-13 13:16:32 +09:00
Err ( _ ) = > return Err ( LightningError { err : " Invalid signature from remote node " . to_owned ( ) , action : ErrorAction ::IgnoreError } ) ,
2020-05-02 15:05:04 -04:00
}
} ;
}
2020-07-17 22:08:34 -07:00
impl < C : Deref + Sync + Send , L : Deref + Sync + Send > RoutingMessageHandler for NetGraphMsgHandler < C , L > where C ::Target : chain ::Access , L ::Target : Logger {
2020-05-02 15:05:04 -04:00
fn handle_node_announcement ( & self , msg : & msgs ::NodeAnnouncement ) -> Result < bool , LightningError > {
2020-11-24 13:38:39 -05:00
self . network_graph . write ( ) . unwrap ( ) . update_node_from_announcement ( msg , & self . secp_ctx ) ? ;
Ok ( msg . contents . excess_data . is_empty ( ) & & msg . contents . excess_address_data . is_empty ( ) )
2020-05-02 15:05:04 -04:00
}
fn handle_channel_announcement ( & self , msg : & msgs ::ChannelAnnouncement ) -> Result < bool , LightningError > {
2020-11-24 13:38:39 -05:00
self . network_graph . write ( ) . unwrap ( ) . update_channel_from_announcement ( msg , & self . chain_access , & self . secp_ctx ) ? ;
2020-03-02 12:55:53 -05:00
log_trace! ( self . logger , " Added channel_announcement for {}{} " , msg . contents . short_channel_id , if ! msg . contents . excess_data . is_empty ( ) { " with excess uninterpreted data! " } else { " " } ) ;
2020-11-24 13:38:39 -05:00
Ok ( msg . contents . excess_data . is_empty ( ) )
2020-05-02 15:05:04 -04:00
}
fn handle_htlc_fail_channel_update ( & self , update : & msgs ::HTLCFailChannelUpdate ) {
match update {
& msgs ::HTLCFailChannelUpdate ::ChannelUpdateMessage { ref msg } = > {
2020-11-24 13:38:39 -05:00
let _ = self . network_graph . write ( ) . unwrap ( ) . update_channel ( msg , & self . secp_ctx ) ;
2020-05-02 15:05:04 -04:00
} ,
2020-06-11 15:33:20 -04:00
& msgs ::HTLCFailChannelUpdate ::ChannelClosed { short_channel_id , is_permanent } = > {
self . network_graph . write ( ) . unwrap ( ) . close_channel_from_update ( short_channel_id , is_permanent ) ;
2020-05-02 15:05:04 -04:00
} ,
2020-06-11 15:33:20 -04:00
& msgs ::HTLCFailChannelUpdate ::NodeFailure { ref node_id , is_permanent } = > {
self . network_graph . write ( ) . unwrap ( ) . fail_node ( node_id , is_permanent ) ;
2020-05-02 15:05:04 -04:00
} ,
}
}
fn handle_channel_update ( & self , msg : & msgs ::ChannelUpdate ) -> Result < bool , LightningError > {
2020-11-24 13:38:39 -05:00
self . network_graph . write ( ) . unwrap ( ) . update_channel ( msg , & self . secp_ctx ) ? ;
Ok ( msg . contents . excess_data . is_empty ( ) )
2020-05-02 15:05:04 -04:00
}
2020-05-30 23:20:17 -04:00
fn get_next_channel_announcements ( & self , starting_point : u64 , batch_amount : u8 ) -> Vec < ( ChannelAnnouncement , Option < ChannelUpdate > , Option < ChannelUpdate > ) > {
2020-05-02 15:05:04 -04:00
let network_graph = self . network_graph . read ( ) . unwrap ( ) ;
let mut result = Vec ::with_capacity ( batch_amount as usize ) ;
let mut iter = network_graph . get_channels ( ) . range ( starting_point .. ) ;
while result . len ( ) < batch_amount as usize {
if let Some ( ( _ , ref chan ) ) = iter . next ( ) {
if chan . announcement_message . is_some ( ) {
2020-05-03 16:06:59 -04:00
let chan_announcement = chan . announcement_message . clone ( ) . unwrap ( ) ;
let mut one_to_two_announcement : Option < msgs ::ChannelUpdate > = None ;
let mut two_to_one_announcement : Option < msgs ::ChannelUpdate > = None ;
if let Some ( one_to_two ) = chan . one_to_two . as_ref ( ) {
one_to_two_announcement = one_to_two . last_update_message . clone ( ) ;
}
if let Some ( two_to_one ) = chan . two_to_one . as_ref ( ) {
two_to_one_announcement = two_to_one . last_update_message . clone ( ) ;
}
result . push ( ( chan_announcement , one_to_two_announcement , two_to_one_announcement ) ) ;
2020-05-02 15:05:04 -04:00
} else {
// TODO: We may end up sending un-announced channel_updates if we are sending
// initial sync data while receiving announce/updates for this channel.
}
} else {
return result ;
}
}
result
}
2020-05-30 23:20:17 -04:00
fn get_next_node_announcements ( & self , starting_point : Option < & PublicKey > , batch_amount : u8 ) -> Vec < NodeAnnouncement > {
2020-05-02 15:05:04 -04:00
let network_graph = self . network_graph . read ( ) . unwrap ( ) ;
let mut result = Vec ::with_capacity ( batch_amount as usize ) ;
let mut iter = if let Some ( pubkey ) = starting_point {
let mut iter = network_graph . get_nodes ( ) . range ( ( * pubkey ) .. ) ;
iter . next ( ) ;
iter
} else {
network_graph . get_nodes ( ) . range ( .. )
} ;
while result . len ( ) < batch_amount as usize {
if let Some ( ( _ , ref node ) ) = iter . next ( ) {
2020-05-04 13:53:44 -04:00
if let Some ( node_info ) = node . announcement_info . as_ref ( ) {
if node_info . announcement_message . is_some ( ) {
result . push ( node_info . announcement_message . clone ( ) . unwrap ( ) ) ;
}
2020-05-02 15:05:04 -04:00
}
} else {
return result ;
}
}
result
}
fn should_request_full_sync ( & self , _node_id : & PublicKey ) -> bool {
//TODO: Determine whether to request a full sync based on the network map.
const FULL_SYNCS_TO_REQUEST : usize = 5 ;
if self . full_syncs_requested . load ( Ordering ::Acquire ) < FULL_SYNCS_TO_REQUEST {
self . full_syncs_requested . fetch_add ( 1 , Ordering ::AcqRel ) ;
true
} else {
false
}
}
2020-10-22 10:51:54 -04:00
2020-11-18 13:32:55 -05:00
/// Initiates a stateless sync of routing gossip information with a peer
/// by calling query_channel_range. The default strategy used by this
/// implementation is to sync for the full block range with several peers.
/// We should expect one or more reply_channel_range messages in response
/// to our query. Each reply will enqueue a query_scid message to request
/// gossip messages for each channel. The sync is considered complete when
/// the final reply_scids_end message is received, though we are not
/// tracking this directly.
fn sync_routing_table ( & self , their_node_id : & PublicKey ) {
let first_blocknum = 0 ;
let number_of_blocks = 0xffffffff ;
2020-10-22 12:44:53 -04:00
log_debug! ( self . logger , " Sending query_channel_range peer={}, first_blocknum={}, number_of_blocks={} " , log_pubkey! ( their_node_id ) , first_blocknum , number_of_blocks ) ;
let mut pending_events = self . pending_events . lock ( ) . unwrap ( ) ;
pending_events . push ( events ::MessageSendEvent ::SendChannelRangeQuery {
node_id : their_node_id . clone ( ) ,
msg : QueryChannelRange {
2020-11-18 13:32:55 -05:00
chain_hash : self . network_graph . read ( ) . unwrap ( ) . genesis_hash ,
2020-10-22 12:44:53 -04:00
first_blocknum ,
number_of_blocks ,
} ,
} ) ;
2020-10-22 10:51:54 -04:00
}
2020-11-18 13:32:55 -05:00
/// Statelessly processes a reply to a channel range query by immediately
/// sending an SCID query with SCIDs in the reply. To keep this handler
/// stateless, it does not validate the sequencing of replies for multi-
/// reply ranges. It does not validate whether the reply(ies) cover the
/// queried range. It also does not filter SCIDs to only those in the
2020-12-03 11:52:54 -05:00
/// original query range.
fn handle_reply_channel_range ( & self , their_node_id : & PublicKey , msg : ReplyChannelRange ) -> Result < ( ) , LightningError > {
2020-10-22 12:44:53 -04:00
log_debug! ( self . logger , " Handling reply_channel_range peer={}, first_blocknum={}, number_of_blocks={}, full_information={}, scids={} " , log_pubkey! ( their_node_id ) , msg . first_blocknum , msg . number_of_blocks , msg . full_information , msg . short_channel_ids . len ( ) , ) ;
// Validate that the remote node maintains up-to-date channel
// information for chain_hash. Some nodes use the full_information
// flag to indicate multi-part messages so we must check whether
2020-11-18 13:32:55 -05:00
// we received SCIDs as well.
2020-10-22 12:44:53 -04:00
if ! msg . full_information & & msg . short_channel_ids . len ( ) = = 0 {
return Err ( LightningError {
err : String ::from ( " Received reply_channel_range with no information available " ) ,
action : ErrorAction ::IgnoreError ,
} ) ;
}
2020-12-03 11:52:54 -05:00
log_debug! ( self . logger , " Sending query_short_channel_ids peer={}, batch_size={} " , log_pubkey! ( their_node_id ) , msg . short_channel_ids . len ( ) ) ;
2020-11-18 13:32:55 -05:00
let mut pending_events = self . pending_events . lock ( ) . unwrap ( ) ;
pending_events . push ( events ::MessageSendEvent ::SendShortIdsQuery {
node_id : their_node_id . clone ( ) ,
msg : QueryShortChannelIds {
2020-12-03 11:52:54 -05:00
chain_hash : msg . chain_hash ,
short_channel_ids : msg . short_channel_ids ,
2020-10-22 12:44:53 -04:00
}
2020-11-18 13:32:55 -05:00
} ) ;
2020-10-22 12:44:53 -04:00
Ok ( ( ) )
2020-10-22 10:51:54 -04:00
}
2020-11-18 13:32:55 -05:00
/// When an SCID query is initiated the remote peer will begin streaming
2020-10-22 12:44:53 -04:00
/// gossip messages. In the event of a failure, we may have received
/// some channel information. Before trying with another peer, the
/// caller should update its set of SCIDs that need to be queried.
2020-12-03 11:52:54 -05:00
fn handle_reply_short_channel_ids_end ( & self , their_node_id : & PublicKey , msg : ReplyShortChannelIdsEnd ) -> Result < ( ) , LightningError > {
2020-10-22 12:44:53 -04:00
log_debug! ( self . logger , " Handling reply_short_channel_ids_end peer={}, full_information={} " , log_pubkey! ( their_node_id ) , msg . full_information ) ;
// If the remote node does not have up-to-date information for the
// chain_hash they will set full_information=false. We can fail
// the result and try again with a different peer.
if ! msg . full_information {
return Err ( LightningError {
err : String ::from ( " Received reply_short_channel_ids_end with no information " ) ,
action : ErrorAction ::IgnoreError
} ) ;
}
Ok ( ( ) )
2020-10-22 10:51:54 -04:00
}
2020-12-03 11:52:54 -05:00
fn handle_query_channel_range ( & self , _their_node_id : & PublicKey , _msg : QueryChannelRange ) -> Result < ( ) , LightningError > {
2020-10-22 10:51:54 -04:00
// TODO
Err ( LightningError {
err : String ::from ( " Not implemented " ) ,
action : ErrorAction ::IgnoreError ,
} )
}
2020-12-03 11:52:54 -05:00
fn handle_query_short_channel_ids ( & self , _their_node_id : & PublicKey , _msg : QueryShortChannelIds ) -> Result < ( ) , LightningError > {
2020-10-22 10:51:54 -04:00
// TODO
Err ( LightningError {
err : String ::from ( " Not implemented " ) ,
action : ErrorAction ::IgnoreError ,
} )
}
}
impl < C : Deref , L : Deref > events ::MessageSendEventsProvider for NetGraphMsgHandler < C , L >
where
C ::Target : chain ::Access ,
L ::Target : Logger ,
{
fn get_and_clear_pending_msg_events ( & self ) -> Vec < events ::MessageSendEvent > {
let mut ret = Vec ::new ( ) ;
let mut pending_events = self . pending_events . lock ( ) . unwrap ( ) ;
std ::mem ::swap ( & mut ret , & mut pending_events ) ;
ret
}
2020-05-02 15:05:04 -04:00
}
2020-05-03 16:06:59 -04:00
#[ derive(PartialEq, Debug) ]
2020-05-06 19:04:44 -04:00
/// Details about one direction of a channel. Received
/// within a channel update.
2020-05-02 15:05:04 -04:00
pub struct DirectionalChannelInfo {
2020-05-06 19:04:44 -04:00
/// When the last update to the channel direction was issued.
/// Value is opaque, as set in the announcement.
2020-05-02 15:05:04 -04:00
pub last_update : u32 ,
2020-05-06 19:04:44 -04:00
/// Whether the channel can be currently used for payments (in this one direction).
2020-05-02 15:05:04 -04:00
pub enabled : bool ,
2020-05-06 19:04:44 -04:00
/// The difference in CLTV values that you must have when routing through this channel.
2020-05-02 15:05:04 -04:00
pub cltv_expiry_delta : u16 ,
/// The minimum value, which must be relayed to the next hop via the channel
pub htlc_minimum_msat : u64 ,
2020-06-28 14:43:10 +03:00
/// The maximum value which may be relayed to the next hop via the channel.
pub htlc_maximum_msat : Option < u64 > ,
2020-05-02 15:05:04 -04:00
/// Fees charged when the channel is used for routing
pub fees : RoutingFees ,
/// Most recent update for the channel received from the network
2020-05-11 21:08:11 -04:00
/// Mostly redundant with the data we store in fields explicitly.
/// Everything else is useful only for sending out for initial routing sync.
/// Not stored if contains excess data to prevent DoS.
2020-09-10 21:37:08 -04:00
pub last_update_message : Option < ChannelUpdate > ,
2020-05-02 15:05:04 -04:00
}
2020-06-11 15:32:23 -04:00
impl fmt ::Display for DirectionalChannelInfo {
fn fmt ( & self , f : & mut fmt ::Formatter ) -> Result < ( ) , fmt ::Error > {
2020-05-03 16:06:59 -04:00
write! ( f , " last_update {}, enabled {}, cltv_expiry_delta {}, htlc_minimum_msat {}, fees {:?} " , self . last_update , self . enabled , self . cltv_expiry_delta , self . htlc_minimum_msat , self . fees ) ? ;
2020-05-02 15:05:04 -04:00
Ok ( ( ) )
}
}
impl_writeable! ( DirectionalChannelInfo , 0 , {
last_update ,
enabled ,
cltv_expiry_delta ,
htlc_minimum_msat ,
2020-06-28 14:43:10 +03:00
htlc_maximum_msat ,
2020-05-02 15:05:04 -04:00
fees ,
last_update_message
} ) ;
#[ derive(PartialEq) ]
2020-05-06 19:04:44 -04:00
/// Details about a channel (both directions).
/// Received within a channel announcement.
2020-05-02 15:05:04 -04:00
pub struct ChannelInfo {
/// Protocol features of a channel communicated during its announcement
pub features : ChannelFeatures ,
2020-05-03 16:06:59 -04:00
/// Source node of the first direction of a channel
pub node_one : PublicKey ,
/// Details about the first direction of a channel
pub one_to_two : Option < DirectionalChannelInfo > ,
/// Source node of the second direction of a channel
pub node_two : PublicKey ,
/// Details about the second direction of a channel
pub two_to_one : Option < DirectionalChannelInfo > ,
2020-06-28 15:18:33 +03:00
/// The channel capacity as seen on-chain, if chain lookup is available.
pub capacity_sats : Option < u64 > ,
2020-05-02 15:05:04 -04:00
/// An initial announcement of the channel
2020-05-06 19:04:44 -04:00
/// Mostly redundant with the data we store in fields explicitly.
/// Everything else is useful only for sending out for initial routing sync.
/// Not stored if contains excess data to prevent DoS.
2020-09-10 21:37:08 -04:00
pub announcement_message : Option < ChannelAnnouncement > ,
2020-05-02 15:05:04 -04:00
}
2020-06-11 15:32:23 -04:00
impl fmt ::Display for ChannelInfo {
fn fmt ( & self , f : & mut fmt ::Formatter ) -> Result < ( ) , fmt ::Error > {
2020-05-03 16:06:59 -04:00
write! ( f , " features: {}, node_one: {}, one_to_two: {:?}, node_two: {}, two_to_one: {:?} " ,
log_bytes! ( self . features . encode ( ) ) , log_pubkey! ( self . node_one ) , self . one_to_two , log_pubkey! ( self . node_two ) , self . two_to_one ) ? ;
2020-05-02 15:05:04 -04:00
Ok ( ( ) )
}
}
impl_writeable! ( ChannelInfo , 0 , {
features ,
2020-05-03 16:06:59 -04:00
node_one ,
2020-05-02 15:05:04 -04:00
one_to_two ,
2020-05-03 16:06:59 -04:00
node_two ,
2020-05-02 15:05:04 -04:00
two_to_one ,
2020-06-28 15:18:33 +03:00
capacity_sats ,
2020-05-02 15:05:04 -04:00
announcement_message
} ) ;
/// Fees for routing via a given channel or a node
#[ derive(Eq, PartialEq, Copy, Clone, Debug) ]
pub struct RoutingFees {
2020-05-06 19:04:44 -04:00
/// Flat routing fee in satoshis
2020-05-02 15:05:04 -04:00
pub base_msat : u32 ,
2020-05-06 19:04:44 -04:00
/// Liquidity-based routing fee in millionths of a routed amount.
/// In other words, 10000 is 1%.
2020-05-02 15:05:04 -04:00
pub proportional_millionths : u32 ,
}
impl Readable for RoutingFees {
fn read < R : ::std ::io ::Read > ( reader : & mut R ) -> Result < RoutingFees , DecodeError > {
let base_msat : u32 = Readable ::read ( reader ) ? ;
let proportional_millionths : u32 = Readable ::read ( reader ) ? ;
Ok ( RoutingFees {
base_msat ,
proportional_millionths ,
} )
}
}
impl Writeable for RoutingFees {
fn write < W : Writer > ( & self , writer : & mut W ) -> Result < ( ) , ::std ::io ::Error > {
self . base_msat . write ( writer ) ? ;
self . proportional_millionths . write ( writer ) ? ;
Ok ( ( ) )
}
}
2020-05-04 13:53:44 -04:00
#[ derive(PartialEq, Debug) ]
/// Information received in the latest node_announcement from this node.
pub struct NodeAnnouncementInfo {
2020-05-02 15:05:04 -04:00
/// Protocol features the node announced support for
2020-05-11 21:12:23 -04:00
pub features : NodeFeatures ,
2020-05-06 19:04:44 -04:00
/// When the last known update to the node state was issued.
/// Value is opaque, as set in the announcement.
2020-05-11 21:12:23 -04:00
pub last_update : u32 ,
2020-05-02 15:05:04 -04:00
/// Color assigned to the node
pub rgb : [ u8 ; 3 ] ,
2020-05-06 19:04:44 -04:00
/// Moniker assigned to the node.
/// May be invalid or malicious (eg control chars),
/// should not be exposed to the user.
2020-05-02 15:05:04 -04:00
pub alias : [ u8 ; 32 ] ,
/// Internet-level addresses via which one can connect to the node
pub addresses : Vec < NetAddress > ,
/// An initial announcement of the node
2020-05-06 19:04:44 -04:00
/// Mostly redundant with the data we store in fields explicitly.
/// Everything else is useful only for sending out for initial routing sync.
/// Not stored if contains excess data to prevent DoS.
2020-09-10 21:37:08 -04:00
pub announcement_message : Option < NodeAnnouncement >
2020-05-02 15:05:04 -04:00
}
2020-05-04 13:53:44 -04:00
impl Writeable for NodeAnnouncementInfo {
2020-05-02 15:05:04 -04:00
fn write < W : Writer > ( & self , writer : & mut W ) -> Result < ( ) , ::std ::io ::Error > {
self . features . write ( writer ) ? ;
self . last_update . write ( writer ) ? ;
self . rgb . write ( writer ) ? ;
self . alias . write ( writer ) ? ;
( self . addresses . len ( ) as u64 ) . write ( writer ) ? ;
for ref addr in & self . addresses {
addr . write ( writer ) ? ;
}
self . announcement_message . write ( writer ) ? ;
Ok ( ( ) )
}
}
2020-05-04 13:53:44 -04:00
impl Readable for NodeAnnouncementInfo {
fn read < R : ::std ::io ::Read > ( reader : & mut R ) -> Result < NodeAnnouncementInfo , DecodeError > {
2020-05-02 15:05:04 -04:00
let features = Readable ::read ( reader ) ? ;
let last_update = Readable ::read ( reader ) ? ;
let rgb = Readable ::read ( reader ) ? ;
let alias = Readable ::read ( reader ) ? ;
let addresses_count : u64 = Readable ::read ( reader ) ? ;
let mut addresses = Vec ::with_capacity ( cmp ::min ( addresses_count , MAX_ALLOC_SIZE / 40 ) as usize ) ;
for _ in 0 .. addresses_count {
match Readable ::read ( reader ) {
Ok ( Ok ( addr ) ) = > { addresses . push ( addr ) ; } ,
Ok ( Err ( _ ) ) = > return Err ( DecodeError ::InvalidValue ) ,
Err ( DecodeError ::ShortRead ) = > return Err ( DecodeError ::BadLengthDescriptor ) ,
_ = > unreachable! ( ) ,
}
}
let announcement_message = Readable ::read ( reader ) ? ;
2020-05-04 13:53:44 -04:00
Ok ( NodeAnnouncementInfo {
2020-05-02 15:05:04 -04:00
features ,
last_update ,
rgb ,
alias ,
addresses ,
announcement_message
} )
}
}
2020-05-04 13:53:44 -04:00
#[ derive(PartialEq) ]
2020-05-06 19:04:44 -04:00
/// Details about a node in the network, known from the network announcement.
2020-05-04 13:53:44 -04:00
pub struct NodeInfo {
/// All valid channels a node has announced
pub channels : Vec < u64 > ,
2020-05-11 21:09:44 -04:00
/// Lowest fees enabling routing via any of the enabled, known channels to a node.
/// The two fields (flat and proportional fee) are independent,
2020-05-06 19:04:44 -04:00
/// meaning they don't have to refer to the same channel.
2020-05-04 13:53:44 -04:00
pub lowest_inbound_channel_fees : Option < RoutingFees > ,
2020-05-06 19:04:44 -04:00
/// More information about a node from node_announcement.
/// Optional because we store a Node entry after learning about it from
/// a channel announcement, but before receiving a node announcement.
2020-05-04 13:53:44 -04:00
pub announcement_info : Option < NodeAnnouncementInfo >
}
2020-06-11 15:32:23 -04:00
impl fmt ::Display for NodeInfo {
fn fmt ( & self , f : & mut fmt ::Formatter ) -> Result < ( ) , fmt ::Error > {
2020-05-04 13:53:44 -04:00
write! ( f , " lowest_inbound_channel_fees: {:?}, channels: {:?}, announcement_info: {:?} " ,
self . lowest_inbound_channel_fees , & self . channels [ .. ] , self . announcement_info ) ? ;
Ok ( ( ) )
}
}
impl Writeable for NodeInfo {
fn write < W : Writer > ( & self , writer : & mut W ) -> Result < ( ) , ::std ::io ::Error > {
( self . channels . len ( ) as u64 ) . write ( writer ) ? ;
for ref chan in self . channels . iter ( ) {
chan . write ( writer ) ? ;
}
self . lowest_inbound_channel_fees . write ( writer ) ? ;
self . announcement_info . write ( writer ) ? ;
Ok ( ( ) )
}
}
const MAX_ALLOC_SIZE : u64 = 64 * 1024 ;
impl Readable for NodeInfo {
fn read < R : ::std ::io ::Read > ( reader : & mut R ) -> Result < NodeInfo , DecodeError > {
let channels_count : u64 = Readable ::read ( reader ) ? ;
let mut channels = Vec ::with_capacity ( cmp ::min ( channels_count , MAX_ALLOC_SIZE / 8 ) as usize ) ;
for _ in 0 .. channels_count {
channels . push ( Readable ::read ( reader ) ? ) ;
}
let lowest_inbound_channel_fees = Readable ::read ( reader ) ? ;
let announcement_info = Readable ::read ( reader ) ? ;
Ok ( NodeInfo {
channels ,
lowest_inbound_channel_fees ,
announcement_info ,
} )
}
}
2020-05-02 15:05:04 -04:00
impl Writeable for NetworkGraph {
fn write < W : Writer > ( & self , writer : & mut W ) -> Result < ( ) , ::std ::io ::Error > {
2020-11-29 15:20:35 -05:00
self . genesis_hash . write ( writer ) ? ;
2020-05-02 15:05:04 -04:00
( self . channels . len ( ) as u64 ) . write ( writer ) ? ;
for ( ref chan_id , ref chan_info ) in self . channels . iter ( ) {
( * chan_id ) . write ( writer ) ? ;
chan_info . write ( writer ) ? ;
}
( self . nodes . len ( ) as u64 ) . write ( writer ) ? ;
for ( ref node_id , ref node_info ) in self . nodes . iter ( ) {
node_id . write ( writer ) ? ;
node_info . write ( writer ) ? ;
}
Ok ( ( ) )
}
}
impl Readable for NetworkGraph {
fn read < R : ::std ::io ::Read > ( reader : & mut R ) -> Result < NetworkGraph , DecodeError > {
2020-11-29 15:20:35 -05:00
let genesis_hash : BlockHash = Readable ::read ( reader ) ? ;
2020-05-02 15:05:04 -04:00
let channels_count : u64 = Readable ::read ( reader ) ? ;
let mut channels = BTreeMap ::new ( ) ;
for _ in 0 .. channels_count {
let chan_id : u64 = Readable ::read ( reader ) ? ;
let chan_info = Readable ::read ( reader ) ? ;
channels . insert ( chan_id , chan_info ) ;
}
let nodes_count : u64 = Readable ::read ( reader ) ? ;
let mut nodes = BTreeMap ::new ( ) ;
for _ in 0 .. nodes_count {
let node_id = Readable ::read ( reader ) ? ;
let node_info = Readable ::read ( reader ) ? ;
nodes . insert ( node_id , node_info ) ;
}
Ok ( NetworkGraph {
2020-11-29 15:20:35 -05:00
genesis_hash ,
2020-05-02 15:05:04 -04:00
channels ,
nodes ,
} )
}
}
2020-06-11 15:32:23 -04:00
impl fmt ::Display for NetworkGraph {
fn fmt ( & self , f : & mut fmt ::Formatter ) -> Result < ( ) , fmt ::Error > {
2020-10-08 15:46:43 -07:00
writeln! ( f , " Network map \n [Channels] " ) ? ;
2020-05-02 15:05:04 -04:00
for ( key , val ) in self . channels . iter ( ) {
2020-10-08 15:46:43 -07:00
writeln! ( f , " {}: {} " , key , val ) ? ;
2020-05-02 15:05:04 -04:00
}
2020-10-08 15:46:43 -07:00
writeln! ( f , " [Nodes] " ) ? ;
2020-05-02 15:05:04 -04:00
for ( key , val ) in self . nodes . iter ( ) {
2020-10-08 15:46:43 -07:00
writeln! ( f , " {}: {} " , log_pubkey! ( key ) , val ) ? ;
2020-05-02 15:05:04 -04:00
}
Ok ( ( ) )
}
}
impl NetworkGraph {
2020-05-06 19:04:44 -04:00
/// Returns all known valid channels' short ids along with announced channel info.
2020-05-12 13:48:07 -04:00
///
/// (C-not exported) because we have no mapping for `BTreeMap`s
2020-05-02 15:05:04 -04:00
pub fn get_channels < ' a > ( & ' a self ) -> & ' a BTreeMap < u64 , ChannelInfo > { & self . channels }
2020-05-06 19:04:44 -04:00
/// Returns all known nodes' public keys along with announced node info.
2020-05-12 13:48:07 -04:00
///
/// (C-not exported) because we have no mapping for `BTreeMap`s
2020-05-02 15:05:04 -04:00
pub fn get_nodes < ' a > ( & ' a self ) -> & ' a BTreeMap < PublicKey , NodeInfo > { & self . nodes }
2020-05-11 21:07:02 -04:00
/// Get network addresses by node id.
/// Returns None if the requested node is completely unknown,
/// or if node announcement for the node was never received.
2020-05-12 13:48:07 -04:00
///
/// (C-not exported) as there is no practical way to track lifetimes of returned values.
2020-05-11 21:07:02 -04:00
pub fn get_addresses < ' a > ( & ' a self , pubkey : & PublicKey ) -> Option < & ' a Vec < NetAddress > > {
if let Some ( node ) = self . nodes . get ( pubkey ) {
if let Some ( node_info ) = node . announcement_info . as_ref ( ) {
return Some ( & node_info . addresses )
}
}
None
}
2020-06-11 15:33:20 -04:00
/// Creates a new, empty, network graph.
2020-11-29 15:20:35 -05:00
pub fn new ( genesis_hash : BlockHash ) -> NetworkGraph {
2020-06-11 15:33:20 -04:00
Self {
2020-11-29 15:20:35 -05:00
genesis_hash ,
2020-06-11 15:33:20 -04:00
channels : BTreeMap ::new ( ) ,
nodes : BTreeMap ::new ( ) ,
}
}
2020-11-24 13:38:39 -05:00
/// For an already known node (from channel announcements), update its stored properties from a
/// given node announcement.
2020-11-12 17:16:14 -05:00
///
/// You probably don't want to call this directly, instead relying on a NetGraphMsgHandler's
/// RoutingMessageHandler implementation to call it indirectly. This may be useful to accept
2020-11-24 13:38:39 -05:00
/// routing messages from a source using a protocol other than the lightning P2P protocol.
pub fn update_node_from_announcement < T : secp256k1 ::Verification > ( & mut self , msg : & msgs ::NodeAnnouncement , secp_ctx : & Secp256k1 < T > ) -> Result < ( ) , LightningError > {
let msg_hash = hash_to_message! ( & Sha256dHash ::hash ( & msg . contents . encode ( ) [ .. ] ) [ .. ] ) ;
secp_verify_sig! ( secp_ctx , & msg_hash , & msg . signature , & msg . contents . node_id ) ;
self . update_node_from_announcement_intern ( & msg . contents , Some ( & msg ) )
}
/// For an already known node (from channel announcements), update its stored properties from a
/// given node announcement without verifying the associated signatures. Because we aren't
/// given the associated signatures here we cannot relay the node announcement to any of our
/// peers.
pub fn update_node_from_unsigned_announcement ( & mut self , msg : & msgs ::UnsignedNodeAnnouncement ) -> Result < ( ) , LightningError > {
self . update_node_from_announcement_intern ( msg , None )
}
2020-05-02 15:05:04 -04:00
2020-11-24 13:38:39 -05:00
fn update_node_from_announcement_intern ( & mut self , msg : & msgs ::UnsignedNodeAnnouncement , full_msg : Option < & msgs ::NodeAnnouncement > ) -> Result < ( ) , LightningError > {
match self . nodes . get_mut ( & msg . node_id ) {
2020-07-13 13:16:32 +09:00
None = > Err ( LightningError { err : " No existing channels for node_announcement " . to_owned ( ) , action : ErrorAction ::IgnoreError } ) ,
2020-05-02 15:05:04 -04:00
Some ( node ) = > {
2020-05-04 13:53:44 -04:00
if let Some ( node_info ) = node . announcement_info . as_ref ( ) {
2020-11-24 13:38:39 -05:00
if node_info . last_update > = msg . timestamp {
2020-07-13 13:16:32 +09:00
return Err ( LightningError { err : " Update older than last processed update " . to_owned ( ) , action : ErrorAction ::IgnoreError } ) ;
2020-05-04 13:53:44 -04:00
}
2020-05-02 15:05:04 -04:00
}
2020-11-24 13:38:39 -05:00
let should_relay = msg . excess_data . is_empty ( ) & & msg . excess_address_data . is_empty ( ) ;
2020-05-04 13:53:44 -04:00
node . announcement_info = Some ( NodeAnnouncementInfo {
2020-11-24 13:38:39 -05:00
features : msg . features . clone ( ) ,
last_update : msg . timestamp ,
rgb : msg . rgb ,
alias : msg . alias ,
addresses : msg . addresses . clone ( ) ,
announcement_message : if should_relay { full_msg . cloned ( ) } else { None } ,
2020-05-04 13:53:44 -04:00
} ) ;
2020-11-24 13:38:39 -05:00
Ok ( ( ) )
2020-05-02 15:05:04 -04:00
}
}
}
2020-11-12 17:16:14 -05:00
/// Store or update channel info from a channel announcement.
///
/// You probably don't want to call this directly, instead relying on a NetGraphMsgHandler's
/// RoutingMessageHandler implementation to call it indirectly. This may be useful to accept
2020-11-24 13:38:39 -05:00
/// routing messages from a source using a protocol other than the lightning P2P protocol.
2020-11-12 17:16:14 -05:00
///
2020-11-24 12:40:11 -05:00
/// If a `chain::Access` object is provided via `chain_access`, it will be called to verify
/// the corresponding UTXO exists on chain and is correctly-formatted.
pub fn update_channel_from_announcement < T : secp256k1 ::Verification , C : Deref >
2020-11-24 13:38:39 -05:00
( & mut self , msg : & msgs ::ChannelAnnouncement , chain_access : & Option < C > , secp_ctx : & Secp256k1 < T > )
-> Result < ( ) , LightningError >
2020-11-24 12:40:11 -05:00
where C ::Target : chain ::Access {
2020-11-24 13:38:39 -05:00
let msg_hash = hash_to_message! ( & Sha256dHash ::hash ( & msg . contents . encode ( ) [ .. ] ) [ .. ] ) ;
secp_verify_sig! ( secp_ctx , & msg_hash , & msg . node_signature_1 , & msg . contents . node_id_1 ) ;
secp_verify_sig! ( secp_ctx , & msg_hash , & msg . node_signature_2 , & msg . contents . node_id_2 ) ;
secp_verify_sig! ( secp_ctx , & msg_hash , & msg . bitcoin_signature_1 , & msg . contents . bitcoin_key_1 ) ;
secp_verify_sig! ( secp_ctx , & msg_hash , & msg . bitcoin_signature_2 , & msg . contents . bitcoin_key_2 ) ;
self . update_channel_from_unsigned_announcement_intern ( & msg . contents , Some ( msg ) , chain_access )
}
/// Store or update channel info from a channel announcement without verifying the associated
/// signatures. Because we aren't given the associated signatures here we cannot relay the
/// channel announcement to any of our peers.
///
/// If a `chain::Access` object is provided via `chain_access`, it will be called to verify
/// the corresponding UTXO exists on chain and is correctly-formatted.
pub fn update_channel_from_unsigned_announcement < C : Deref >
( & mut self , msg : & msgs ::UnsignedChannelAnnouncement , chain_access : & Option < C > )
-> Result < ( ) , LightningError >
where C ::Target : chain ::Access {
self . update_channel_from_unsigned_announcement_intern ( msg , None , chain_access )
}
2020-11-12 17:16:14 -05:00
2020-11-24 13:38:39 -05:00
fn update_channel_from_unsigned_announcement_intern < C : Deref >
( & mut self , msg : & msgs ::UnsignedChannelAnnouncement , full_msg : Option < & msgs ::ChannelAnnouncement > , chain_access : & Option < C > )
-> Result < ( ) , LightningError >
where C ::Target : chain ::Access {
if msg . node_id_1 = = msg . node_id_2 | | msg . bitcoin_key_1 = = msg . bitcoin_key_2 {
return Err ( LightningError { err : " Channel announcement node had a channel with itself " . to_owned ( ) , action : ErrorAction ::IgnoreError } ) ;
2020-05-02 15:05:04 -04:00
}
2020-11-24 12:40:11 -05:00
let utxo_value = match & chain_access {
& None = > {
// Tentatively accept, potentially exposing us to DoS attacks
None
} ,
& Some ( ref chain_access ) = > {
2020-11-24 13:38:39 -05:00
match chain_access . get_utxo ( & msg . chain_hash , msg . short_channel_id ) {
2020-11-24 12:40:11 -05:00
Ok ( TxOut { value , script_pubkey } ) = > {
let expected_script = Builder ::new ( ) . push_opcode ( opcodes ::all ::OP_PUSHNUM_2 )
2020-11-24 13:38:39 -05:00
. push_slice ( & msg . bitcoin_key_1 . serialize ( ) )
. push_slice ( & msg . bitcoin_key_2 . serialize ( ) )
2020-11-24 12:40:11 -05:00
. push_opcode ( opcodes ::all ::OP_PUSHNUM_2 )
. push_opcode ( opcodes ::all ::OP_CHECKMULTISIG ) . into_script ( ) . to_v0_p2wsh ( ) ;
if script_pubkey ! = expected_script {
return Err ( LightningError { err : format ! ( " Channel announcement key ({}) didn't match on-chain script ({}) " , script_pubkey . to_hex ( ) , expected_script . to_hex ( ) ) , action : ErrorAction ::IgnoreError } ) ;
}
//TODO: Check if value is worth storing, use it to inform routing, and compare it
//to the new HTLC max field in channel_update
Some ( value )
} ,
Err ( chain ::AccessError ::UnknownChain ) = > {
2020-11-24 13:38:39 -05:00
return Err ( LightningError { err : format ! ( " Channel announced on an unknown chain ({}) " , msg . chain_hash . encode ( ) . to_hex ( ) ) , action : ErrorAction ::IgnoreError } ) ;
2020-11-24 12:40:11 -05:00
} ,
Err ( chain ::AccessError ::UnknownTx ) = > {
return Err ( LightningError { err : " Channel announced without corresponding UTXO entry " . to_owned ( ) , action : ErrorAction ::IgnoreError } ) ;
} ,
}
} ,
} ;
2020-05-02 15:05:04 -04:00
let chan_info = ChannelInfo {
2020-11-24 13:38:39 -05:00
features : msg . features . clone ( ) ,
node_one : msg . node_id_1 . clone ( ) ,
2020-05-03 16:06:59 -04:00
one_to_two : None ,
2020-11-24 13:38:39 -05:00
node_two : msg . node_id_2 . clone ( ) ,
2020-05-03 16:06:59 -04:00
two_to_one : None ,
2020-06-28 15:18:33 +03:00
capacity_sats : utxo_value ,
2020-11-24 13:38:39 -05:00
announcement_message : if msg . excess_data . is_empty ( ) { full_msg . cloned ( ) } else { None } ,
2020-05-02 15:05:04 -04:00
} ;
2020-11-24 13:38:39 -05:00
match self . channels . entry ( msg . short_channel_id ) {
2020-05-02 15:05:04 -04:00
BtreeEntry ::Occupied ( mut entry ) = > {
//TODO: because asking the blockchain if short_channel_id is valid is only optional
//in the blockchain API, we need to handle it smartly here, though it's unclear
//exactly how...
2020-06-28 15:18:33 +03:00
if utxo_value . is_some ( ) {
2020-05-02 15:05:04 -04:00
// Either our UTXO provider is busted, there was a reorg, or the UTXO provider
// only sometimes returns results. In any case remove the previous entry. Note
// that the spec expects us to "blacklist" the node_ids involved, but we can't
// do that because
// a) we don't *require* a UTXO provider that always returns results.
// b) we don't track UTXOs of channels we know about and remove them if they
// get reorg'd out.
// c) it's unclear how to do so without exposing ourselves to massive DoS risk.
2020-11-24 13:38:39 -05:00
Self ::remove_channel_in_nodes ( & mut self . nodes , & entry . get ( ) , msg . short_channel_id ) ;
2020-05-02 15:05:04 -04:00
* entry . get_mut ( ) = chan_info ;
} else {
2020-07-13 13:16:32 +09:00
return Err ( LightningError { err : " Already have knowledge of channel " . to_owned ( ) , action : ErrorAction ::IgnoreError } )
2020-05-02 15:05:04 -04:00
}
} ,
BtreeEntry ::Vacant ( entry ) = > {
entry . insert ( chan_info ) ;
}
} ;
macro_rules ! add_channel_to_node {
( $node_id : expr ) = > {
match self . nodes . entry ( $node_id ) {
BtreeEntry ::Occupied ( node_entry ) = > {
2020-11-24 13:38:39 -05:00
node_entry . into_mut ( ) . channels . push ( msg . short_channel_id ) ;
2020-05-02 15:05:04 -04:00
} ,
BtreeEntry ::Vacant ( node_entry ) = > {
node_entry . insert ( NodeInfo {
2020-11-24 13:38:39 -05:00
channels : vec ! ( msg . short_channel_id ) ,
2020-05-02 15:05:04 -04:00
lowest_inbound_channel_fees : None ,
2020-05-04 13:53:44 -04:00
announcement_info : None ,
2020-05-02 15:05:04 -04:00
} ) ;
}
}
} ;
}
2020-11-24 13:38:39 -05:00
add_channel_to_node! ( msg . node_id_1 ) ;
add_channel_to_node! ( msg . node_id_2 ) ;
2020-05-02 15:05:04 -04:00
2020-11-24 13:38:39 -05:00
Ok ( ( ) )
2020-05-02 15:05:04 -04:00
}
2020-05-03 11:01:55 -04:00
/// Close a channel if a corresponding HTLC fail was sent.
/// If permanent, removes a channel from the local storage.
/// May cause the removal of nodes too, if this was their last channel.
/// If not permanent, makes channels unavailable for routing.
2020-06-11 15:33:20 -04:00
pub fn close_channel_from_update ( & mut self , short_channel_id : u64 , is_permanent : bool ) {
if is_permanent {
if let Some ( chan ) = self . channels . remove ( & short_channel_id ) {
Self ::remove_channel_in_nodes ( & mut self . nodes , & chan , short_channel_id ) ;
2020-05-02 15:05:04 -04:00
}
} else {
if let Some ( chan ) = self . channels . get_mut ( & short_channel_id ) {
2020-05-03 16:06:59 -04:00
if let Some ( one_to_two ) = chan . one_to_two . as_mut ( ) {
one_to_two . enabled = false ;
}
if let Some ( two_to_one ) = chan . two_to_one . as_mut ( ) {
two_to_one . enabled = false ;
}
2020-05-02 15:05:04 -04:00
}
}
}
2020-06-11 15:33:20 -04:00
fn fail_node ( & mut self , _node_id : & PublicKey , is_permanent : bool ) {
if is_permanent {
2020-05-02 15:05:04 -04:00
// TODO: Wholly remove the node
} else {
// TODO: downgrade the node
}
}
2020-11-24 13:38:39 -05:00
/// For an already known (from announcement) channel, update info about one of the directions
/// of the channel.
2020-11-12 17:16:14 -05:00
///
/// You probably don't want to call this directly, instead relying on a NetGraphMsgHandler's
/// RoutingMessageHandler implementation to call it indirectly. This may be useful to accept
2020-11-24 13:38:39 -05:00
/// routing messages from a source using a protocol other than the lightning P2P protocol.
pub fn update_channel < T : secp256k1 ::Verification > ( & mut self , msg : & msgs ::ChannelUpdate , secp_ctx : & Secp256k1 < T > ) -> Result < ( ) , LightningError > {
self . update_channel_intern ( & msg . contents , Some ( & msg ) , Some ( ( & msg . signature , secp_ctx ) ) )
}
/// For an already known (from announcement) channel, update info about one of the directions
/// of the channel without verifying the associated signatures. Because we aren't given the
/// associated signatures here we cannot relay the channel update to any of our peers.
pub fn update_channel_unsigned ( & mut self , msg : & msgs ::UnsignedChannelUpdate ) -> Result < ( ) , LightningError > {
self . update_channel_intern ( msg , None , None ::< ( & secp256k1 ::Signature , & Secp256k1 < secp256k1 ::VerifyOnly > ) > )
}
fn update_channel_intern < T : secp256k1 ::Verification > ( & mut self , msg : & msgs ::UnsignedChannelUpdate , full_msg : Option < & msgs ::ChannelUpdate > , sig_info : Option < ( & secp256k1 ::Signature , & Secp256k1 < T > ) > ) -> Result < ( ) , LightningError > {
2020-05-02 15:05:04 -04:00
let dest_node_id ;
2020-11-24 13:38:39 -05:00
let chan_enabled = msg . flags & ( 1 < < 1 ) ! = ( 1 < < 1 ) ;
2020-05-02 15:05:04 -04:00
let chan_was_enabled ;
2020-11-24 13:38:39 -05:00
match self . channels . get_mut ( & msg . short_channel_id ) {
2020-07-13 13:16:32 +09:00
None = > return Err ( LightningError { err : " Couldn't find channel for update " . to_owned ( ) , action : ErrorAction ::IgnoreError } ) ,
2020-05-02 15:05:04 -04:00
Some ( channel ) = > {
2020-11-24 13:38:39 -05:00
if let OptionalField ::Present ( htlc_maximum_msat ) = msg . htlc_maximum_msat {
2020-06-29 21:28:15 +03:00
if htlc_maximum_msat > MAX_VALUE_MSAT {
return Err ( LightningError { err : " htlc_maximum_msat is larger than maximum possible msats " . to_owned ( ) , action : ErrorAction ::IgnoreError } ) ;
}
if let Some ( capacity_sats ) = channel . capacity_sats {
// It's possible channel capacity is available now, although it wasn't available at announcement (so the field is None).
// Don't query UTXO set here to reduce DoS risks.
2020-11-12 18:59:06 -05:00
if capacity_sats > MAX_VALUE_MSAT / 1000 | | htlc_maximum_msat > capacity_sats * 1000 {
return Err ( LightningError { err : " htlc_maximum_msat is larger than channel capacity or capacity is bogus " . to_owned ( ) , action : ErrorAction ::IgnoreError } ) ;
2020-06-29 21:28:15 +03:00
}
}
}
2020-05-02 15:05:04 -04:00
macro_rules ! maybe_update_channel_info {
2020-05-03 16:06:59 -04:00
( $target : expr , $src_node : expr ) = > {
if let Some ( existing_chan_info ) = $target . as_ref ( ) {
2020-11-24 13:38:39 -05:00
if existing_chan_info . last_update > = msg . timestamp {
2020-07-13 13:16:32 +09:00
return Err ( LightningError { err : " Update older than last processed update " . to_owned ( ) , action : ErrorAction ::IgnoreError } ) ;
2020-05-03 16:06:59 -04:00
}
chan_was_enabled = existing_chan_info . enabled ;
} else {
chan_was_enabled = false ;
2020-05-02 15:05:04 -04:00
}
2020-05-03 16:06:59 -04:00
2020-11-24 13:38:39 -05:00
let last_update_message = if msg . excess_data . is_empty ( ) { full_msg . cloned ( ) } else { None } ;
2020-05-03 16:06:59 -04:00
let updated_channel_dir_info = DirectionalChannelInfo {
enabled : chan_enabled ,
2020-11-24 13:38:39 -05:00
last_update : msg . timestamp ,
cltv_expiry_delta : msg . cltv_expiry_delta ,
htlc_minimum_msat : msg . htlc_minimum_msat ,
htlc_maximum_msat : if let OptionalField ::Present ( max_value ) = msg . htlc_maximum_msat { Some ( max_value ) } else { None } ,
2020-05-03 16:06:59 -04:00
fees : RoutingFees {
2020-11-24 13:38:39 -05:00
base_msat : msg . fee_base_msat ,
proportional_millionths : msg . fee_proportional_millionths ,
2020-05-03 16:06:59 -04:00
} ,
last_update_message
} ;
$target = Some ( updated_channel_dir_info ) ;
2020-05-02 15:05:04 -04:00
}
}
2020-05-03 16:06:59 -04:00
2020-11-24 13:38:39 -05:00
let msg_hash = hash_to_message! ( & Sha256dHash ::hash ( & msg . encode ( ) [ .. ] ) [ .. ] ) ;
if msg . flags & 1 = = 1 {
2020-05-03 16:06:59 -04:00
dest_node_id = channel . node_one . clone ( ) ;
2020-11-24 13:38:39 -05:00
if let Some ( ( sig , ctx ) ) = sig_info {
secp_verify_sig! ( ctx , & msg_hash , & sig , & channel . node_two ) ;
2020-05-02 15:05:04 -04:00
}
2020-05-03 16:06:59 -04:00
maybe_update_channel_info! ( channel . two_to_one , channel . node_two ) ;
2020-05-02 15:05:04 -04:00
} else {
2020-05-03 16:06:59 -04:00
dest_node_id = channel . node_two . clone ( ) ;
2020-11-24 13:38:39 -05:00
if let Some ( ( sig , ctx ) ) = sig_info {
secp_verify_sig! ( ctx , & msg_hash , & sig , & channel . node_one ) ;
2020-05-02 15:05:04 -04:00
}
2020-05-03 16:06:59 -04:00
maybe_update_channel_info! ( channel . one_to_two , channel . node_one ) ;
2020-05-02 15:05:04 -04:00
}
}
}
if chan_enabled {
let node = self . nodes . get_mut ( & dest_node_id ) . unwrap ( ) ;
2020-11-24 13:38:39 -05:00
let mut base_msat = msg . fee_base_msat ;
let mut proportional_millionths = msg . fee_proportional_millionths ;
2020-05-02 15:05:04 -04:00
if let Some ( fees ) = node . lowest_inbound_channel_fees {
base_msat = cmp ::min ( base_msat , fees . base_msat ) ;
proportional_millionths = cmp ::min ( proportional_millionths , fees . proportional_millionths ) ;
}
node . lowest_inbound_channel_fees = Some ( RoutingFees {
base_msat ,
proportional_millionths
} ) ;
} else if chan_was_enabled {
2020-03-02 12:55:53 -05:00
let node = self . nodes . get_mut ( & dest_node_id ) . unwrap ( ) ;
2020-05-11 21:09:44 -04:00
let mut lowest_inbound_channel_fees = None ;
for chan_id in node . channels . iter ( ) {
let chan = self . channels . get ( chan_id ) . unwrap ( ) ;
let chan_info_opt ;
if chan . node_one = = dest_node_id {
chan_info_opt = chan . two_to_one . as_ref ( ) ;
} else {
chan_info_opt = chan . one_to_two . as_ref ( ) ;
}
if let Some ( chan_info ) = chan_info_opt {
if chan_info . enabled {
let fees = lowest_inbound_channel_fees . get_or_insert ( RoutingFees {
base_msat : u32 ::max_value ( ) , proportional_millionths : u32 ::max_value ( ) } ) ;
fees . base_msat = cmp ::min ( fees . base_msat , chan_info . fees . base_msat ) ;
fees . proportional_millionths = cmp ::min ( fees . proportional_millionths , chan_info . fees . proportional_millionths ) ;
2020-05-02 15:05:04 -04:00
}
}
}
2020-05-11 21:09:44 -04:00
node . lowest_inbound_channel_fees = lowest_inbound_channel_fees ;
2020-05-02 15:05:04 -04:00
}
2020-11-24 13:38:39 -05:00
Ok ( ( ) )
2020-05-02 15:05:04 -04:00
}
fn remove_channel_in_nodes ( nodes : & mut BTreeMap < PublicKey , NodeInfo > , chan : & ChannelInfo , short_channel_id : u64 ) {
macro_rules ! remove_from_node {
( $node_id : expr ) = > {
if let BtreeEntry ::Occupied ( mut entry ) = nodes . entry ( $node_id ) {
entry . get_mut ( ) . channels . retain ( | chan_id | {
short_channel_id ! = * chan_id
} ) ;
if entry . get ( ) . channels . is_empty ( ) {
entry . remove_entry ( ) ;
}
} else {
panic! ( " Had channel that pointed to unknown node (ie inconsistent network map)! " ) ;
}
}
}
2020-05-03 16:06:59 -04:00
remove_from_node! ( chan . node_one ) ;
remove_from_node! ( chan . node_two ) ;
2020-05-02 15:05:04 -04:00
}
}
#[ cfg(test) ]
mod tests {
2020-07-17 22:08:34 -07:00
use chain ;
2020-05-02 15:05:04 -04:00
use ln ::features ::{ ChannelFeatures , NodeFeatures } ;
use routing ::network_graph ::{ NetGraphMsgHandler , NetworkGraph } ;
2020-06-28 14:43:10 +03:00
use ln ::msgs ::{ OptionalField , RoutingMessageHandler , UnsignedNodeAnnouncement , NodeAnnouncement ,
2020-06-29 21:28:15 +03:00
UnsignedChannelAnnouncement , ChannelAnnouncement , UnsignedChannelUpdate , ChannelUpdate , HTLCFailChannelUpdate ,
2020-10-22 12:44:53 -04:00
ReplyChannelRange , ReplyShortChannelIdsEnd , QueryChannelRange , QueryShortChannelIds , MAX_VALUE_MSAT } ;
2020-05-02 15:05:04 -04:00
use util ::test_utils ;
use util ::logger ::Logger ;
use util ::ser ::{ Readable , Writeable } ;
2020-10-22 12:44:53 -04:00
use util ::events ::{ MessageSendEvent , MessageSendEventsProvider } ;
2020-05-02 15:05:04 -04:00
use bitcoin ::hashes ::sha256d ::Hash as Sha256dHash ;
use bitcoin ::hashes ::Hash ;
use bitcoin ::network ::constants ::Network ;
use bitcoin ::blockdata ::constants ::genesis_block ;
use bitcoin ::blockdata ::script ::Builder ;
2020-07-17 22:08:34 -07:00
use bitcoin ::blockdata ::transaction ::TxOut ;
2020-05-02 15:05:04 -04:00
use bitcoin ::blockdata ::opcodes ;
use hex ;
use bitcoin ::secp256k1 ::key ::{ PublicKey , SecretKey } ;
use bitcoin ::secp256k1 ::{ All , Secp256k1 } ;
use std ::sync ::Arc ;
2020-07-17 22:08:34 -07:00
fn create_net_graph_msg_handler ( ) -> ( Secp256k1 < All > , NetGraphMsgHandler < Arc < test_utils ::TestChainSource > , Arc < test_utils ::TestLogger > > ) {
2020-05-02 15:05:04 -04:00
let secp_ctx = Secp256k1 ::new ( ) ;
2020-03-02 12:55:53 -05:00
let logger = Arc ::new ( test_utils ::TestLogger ::new ( ) ) ;
2020-11-29 15:20:35 -05:00
let genesis_hash = genesis_block ( Network ::Testnet ) . header . block_hash ( ) ;
let net_graph_msg_handler = NetGraphMsgHandler ::new ( genesis_hash , None , Arc ::clone ( & logger ) ) ;
2020-05-02 15:05:04 -04:00
( secp_ctx , net_graph_msg_handler )
}
#[ test ]
fn request_full_sync_finite_times ( ) {
let ( secp_ctx , net_graph_msg_handler ) = create_net_graph_msg_handler ( ) ;
let node_id = PublicKey ::from_secret_key ( & secp_ctx , & SecretKey ::from_slice ( & hex ::decode ( " 0202020202020202020202020202020202020202020202020202020202020202 " ) . unwrap ( ) [ .. ] ) . unwrap ( ) ) ;
assert! ( net_graph_msg_handler . should_request_full_sync ( & node_id ) ) ;
assert! ( net_graph_msg_handler . should_request_full_sync ( & node_id ) ) ;
assert! ( net_graph_msg_handler . should_request_full_sync ( & node_id ) ) ;
assert! ( net_graph_msg_handler . should_request_full_sync ( & node_id ) ) ;
assert! ( net_graph_msg_handler . should_request_full_sync ( & node_id ) ) ;
assert! ( ! net_graph_msg_handler . should_request_full_sync ( & node_id ) ) ;
}
#[ test ]
fn handling_node_announcements ( ) {
let ( secp_ctx , net_graph_msg_handler ) = create_net_graph_msg_handler ( ) ;
let node_1_privkey = & SecretKey ::from_slice ( & [ 42 ; 32 ] ) . unwrap ( ) ;
let node_2_privkey = & SecretKey ::from_slice ( & [ 41 ; 32 ] ) . unwrap ( ) ;
let node_id_1 = PublicKey ::from_secret_key ( & secp_ctx , node_1_privkey ) ;
let node_id_2 = PublicKey ::from_secret_key ( & secp_ctx , node_2_privkey ) ;
let node_1_btckey = & SecretKey ::from_slice ( & [ 40 ; 32 ] ) . unwrap ( ) ;
let node_2_btckey = & SecretKey ::from_slice ( & [ 39 ; 32 ] ) . unwrap ( ) ;
let zero_hash = Sha256dHash ::hash ( & [ 0 ; 32 ] ) ;
let first_announcement_time = 500 ;
let mut unsigned_announcement = UnsignedNodeAnnouncement {
features : NodeFeatures ::known ( ) ,
timestamp : first_announcement_time ,
node_id : node_id_1 ,
rgb : [ 0 ; 3 ] ,
alias : [ 0 ; 32 ] ,
addresses : Vec ::new ( ) ,
excess_address_data : Vec ::new ( ) ,
excess_data : Vec ::new ( ) ,
} ;
let mut msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_announcement . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_announcement = NodeAnnouncement {
signature : secp_ctx . sign ( & msghash , node_1_privkey ) ,
contents : unsigned_announcement . clone ( )
} ;
match net_graph_msg_handler . handle_node_announcement ( & valid_announcement ) {
Ok ( _ ) = > panic! ( ) ,
Err ( e ) = > assert_eq! ( " No existing channels for node_announcement " , e . err )
} ;
{
// Announce a channel to add a corresponding node.
let unsigned_announcement = UnsignedChannelAnnouncement {
features : ChannelFeatures ::known ( ) ,
2020-08-25 17:12:00 -04:00
chain_hash : genesis_block ( Network ::Testnet ) . header . block_hash ( ) ,
2020-05-02 15:05:04 -04:00
short_channel_id : 0 ,
node_id_1 ,
node_id_2 ,
bitcoin_key_1 : PublicKey ::from_secret_key ( & secp_ctx , node_1_btckey ) ,
bitcoin_key_2 : PublicKey ::from_secret_key ( & secp_ctx , node_2_btckey ) ,
excess_data : Vec ::new ( ) ,
} ;
let msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_announcement . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_announcement = ChannelAnnouncement {
node_signature_1 : secp_ctx . sign ( & msghash , node_1_privkey ) ,
node_signature_2 : secp_ctx . sign ( & msghash , node_2_privkey ) ,
bitcoin_signature_1 : secp_ctx . sign ( & msghash , node_1_btckey ) ,
bitcoin_signature_2 : secp_ctx . sign ( & msghash , node_2_btckey ) ,
contents : unsigned_announcement . clone ( ) ,
} ;
match net_graph_msg_handler . handle_channel_announcement ( & valid_announcement ) {
Ok ( res ) = > assert! ( res ) ,
_ = > panic! ( )
} ;
}
match net_graph_msg_handler . handle_node_announcement ( & valid_announcement ) {
Ok ( res ) = > assert! ( res ) ,
Err ( _ ) = > panic! ( )
} ;
let fake_msghash = hash_to_message! ( & zero_hash ) ;
match net_graph_msg_handler . handle_node_announcement (
& NodeAnnouncement {
signature : secp_ctx . sign ( & fake_msghash , node_1_privkey ) ,
contents : unsigned_announcement . clone ( )
} ) {
Ok ( _ ) = > panic! ( ) ,
Err ( e ) = > assert_eq! ( e . err , " Invalid signature from remote node " )
} ;
unsigned_announcement . timestamp + = 1000 ;
unsigned_announcement . excess_data . push ( 1 ) ;
msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_announcement . encode ( ) [ .. ] ) [ .. ] ) ;
let announcement_with_data = NodeAnnouncement {
signature : secp_ctx . sign ( & msghash , node_1_privkey ) ,
contents : unsigned_announcement . clone ( )
} ;
// Return false because contains excess data.
match net_graph_msg_handler . handle_node_announcement ( & announcement_with_data ) {
Ok ( res ) = > assert! ( ! res ) ,
Err ( _ ) = > panic! ( )
} ;
unsigned_announcement . excess_data = Vec ::new ( ) ;
// Even though previous announcement was not relayed further, we still accepted it,
// so we now won't accept announcements before the previous one.
unsigned_announcement . timestamp - = 10 ;
msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_announcement . encode ( ) [ .. ] ) [ .. ] ) ;
let outdated_announcement = NodeAnnouncement {
signature : secp_ctx . sign ( & msghash , node_1_privkey ) ,
contents : unsigned_announcement . clone ( )
} ;
match net_graph_msg_handler . handle_node_announcement ( & outdated_announcement ) {
Ok ( _ ) = > panic! ( ) ,
Err ( e ) = > assert_eq! ( e . err , " Update older than last processed update " )
} ;
}
#[ test ]
fn handling_channel_announcements ( ) {
let secp_ctx = Secp256k1 ::new ( ) ;
let logger : Arc < Logger > = Arc ::new ( test_utils ::TestLogger ::new ( ) ) ;
let node_1_privkey = & SecretKey ::from_slice ( & [ 42 ; 32 ] ) . unwrap ( ) ;
let node_2_privkey = & SecretKey ::from_slice ( & [ 41 ; 32 ] ) . unwrap ( ) ;
let node_id_1 = PublicKey ::from_secret_key ( & secp_ctx , node_1_privkey ) ;
let node_id_2 = PublicKey ::from_secret_key ( & secp_ctx , node_2_privkey ) ;
let node_1_btckey = & SecretKey ::from_slice ( & [ 40 ; 32 ] ) . unwrap ( ) ;
let node_2_btckey = & SecretKey ::from_slice ( & [ 39 ; 32 ] ) . unwrap ( ) ;
let good_script = Builder ::new ( ) . push_opcode ( opcodes ::all ::OP_PUSHNUM_2 )
. push_slice ( & PublicKey ::from_secret_key ( & secp_ctx , node_1_btckey ) . serialize ( ) )
. push_slice ( & PublicKey ::from_secret_key ( & secp_ctx , node_2_btckey ) . serialize ( ) )
. push_opcode ( opcodes ::all ::OP_PUSHNUM_2 )
. push_opcode ( opcodes ::all ::OP_CHECKMULTISIG ) . into_script ( ) . to_v0_p2wsh ( ) ;
let mut unsigned_announcement = UnsignedChannelAnnouncement {
features : ChannelFeatures ::known ( ) ,
2020-08-25 17:12:00 -04:00
chain_hash : genesis_block ( Network ::Testnet ) . header . block_hash ( ) ,
2020-05-02 15:05:04 -04:00
short_channel_id : 0 ,
node_id_1 ,
node_id_2 ,
bitcoin_key_1 : PublicKey ::from_secret_key ( & secp_ctx , node_1_btckey ) ,
bitcoin_key_2 : PublicKey ::from_secret_key ( & secp_ctx , node_2_btckey ) ,
excess_data : Vec ::new ( ) ,
} ;
let mut msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_announcement . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_announcement = ChannelAnnouncement {
node_signature_1 : secp_ctx . sign ( & msghash , node_1_privkey ) ,
node_signature_2 : secp_ctx . sign ( & msghash , node_2_privkey ) ,
bitcoin_signature_1 : secp_ctx . sign ( & msghash , node_1_btckey ) ,
bitcoin_signature_2 : secp_ctx . sign ( & msghash , node_2_btckey ) ,
contents : unsigned_announcement . clone ( ) ,
} ;
// Test if the UTXO lookups were not supported
2020-11-29 15:20:35 -05:00
let mut net_graph_msg_handler = NetGraphMsgHandler ::new ( genesis_block ( Network ::Testnet ) . header . block_hash ( ) , None , Arc ::clone ( & logger ) ) ;
2020-05-02 15:05:04 -04:00
match net_graph_msg_handler . handle_channel_announcement ( & valid_announcement ) {
Ok ( res ) = > assert! ( res ) ,
_ = > panic! ( )
} ;
{
let network = net_graph_msg_handler . network_graph . read ( ) . unwrap ( ) ;
match network . get_channels ( ) . get ( & unsigned_announcement . short_channel_id ) {
None = > panic! ( ) ,
Some ( _ ) = > ( )
}
}
// If we receive announcement for the same channel (with UTXO lookups disabled),
// drop new one on the floor, since we can't see any changes.
match net_graph_msg_handler . handle_channel_announcement ( & valid_announcement ) {
Ok ( _ ) = > panic! ( ) ,
Err ( e ) = > assert_eq! ( e . err , " Already have knowledge of channel " )
} ;
// Test if an associated transaction were not on-chain (or not confirmed).
2020-07-17 22:08:34 -07:00
let chain_source = Arc ::new ( test_utils ::TestChainSource ::new ( Network ::Testnet ) ) ;
* chain_source . utxo_ret . lock ( ) . unwrap ( ) = Err ( chain ::AccessError ::UnknownTx ) ;
2020-11-29 15:20:35 -05:00
net_graph_msg_handler = NetGraphMsgHandler ::new ( chain_source . clone ( ) . genesis_hash , Some ( chain_source . clone ( ) ) , Arc ::clone ( & logger ) ) ;
2020-05-02 15:05:04 -04:00
unsigned_announcement . short_channel_id + = 1 ;
msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_announcement . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_announcement = ChannelAnnouncement {
node_signature_1 : secp_ctx . sign ( & msghash , node_1_privkey ) ,
node_signature_2 : secp_ctx . sign ( & msghash , node_2_privkey ) ,
bitcoin_signature_1 : secp_ctx . sign ( & msghash , node_1_btckey ) ,
bitcoin_signature_2 : secp_ctx . sign ( & msghash , node_2_btckey ) ,
contents : unsigned_announcement . clone ( ) ,
} ;
match net_graph_msg_handler . handle_channel_announcement ( & valid_announcement ) {
Ok ( _ ) = > panic! ( ) ,
Err ( e ) = > assert_eq! ( e . err , " Channel announced without corresponding UTXO entry " )
} ;
// Now test if the transaction is found in the UTXO set and the script is correct.
unsigned_announcement . short_channel_id + = 1 ;
2020-07-17 22:08:34 -07:00
* chain_source . utxo_ret . lock ( ) . unwrap ( ) = Ok ( TxOut { value : 0 , script_pubkey : good_script . clone ( ) } ) ;
2020-05-02 15:05:04 -04:00
msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_announcement . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_announcement = ChannelAnnouncement {
node_signature_1 : secp_ctx . sign ( & msghash , node_1_privkey ) ,
node_signature_2 : secp_ctx . sign ( & msghash , node_2_privkey ) ,
bitcoin_signature_1 : secp_ctx . sign ( & msghash , node_1_btckey ) ,
bitcoin_signature_2 : secp_ctx . sign ( & msghash , node_2_btckey ) ,
contents : unsigned_announcement . clone ( ) ,
} ;
match net_graph_msg_handler . handle_channel_announcement ( & valid_announcement ) {
Ok ( res ) = > assert! ( res ) ,
_ = > panic! ( )
} ;
{
let network = net_graph_msg_handler . network_graph . read ( ) . unwrap ( ) ;
match network . get_channels ( ) . get ( & unsigned_announcement . short_channel_id ) {
None = > panic! ( ) ,
Some ( _ ) = > ( )
}
}
// If we receive announcement for the same channel (but TX is not confirmed),
// drop new one on the floor, since we can't see any changes.
2020-07-17 22:08:34 -07:00
* chain_source . utxo_ret . lock ( ) . unwrap ( ) = Err ( chain ::AccessError ::UnknownTx ) ;
2020-05-02 15:05:04 -04:00
match net_graph_msg_handler . handle_channel_announcement ( & valid_announcement ) {
Ok ( _ ) = > panic! ( ) ,
Err ( e ) = > assert_eq! ( e . err , " Channel announced without corresponding UTXO entry " )
} ;
// But if it is confirmed, replace the channel
2020-07-17 22:08:34 -07:00
* chain_source . utxo_ret . lock ( ) . unwrap ( ) = Ok ( TxOut { value : 0 , script_pubkey : good_script } ) ;
2020-05-02 15:05:04 -04:00
unsigned_announcement . features = ChannelFeatures ::empty ( ) ;
msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_announcement . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_announcement = ChannelAnnouncement {
node_signature_1 : secp_ctx . sign ( & msghash , node_1_privkey ) ,
node_signature_2 : secp_ctx . sign ( & msghash , node_2_privkey ) ,
bitcoin_signature_1 : secp_ctx . sign ( & msghash , node_1_btckey ) ,
bitcoin_signature_2 : secp_ctx . sign ( & msghash , node_2_btckey ) ,
contents : unsigned_announcement . clone ( ) ,
} ;
match net_graph_msg_handler . handle_channel_announcement ( & valid_announcement ) {
Ok ( res ) = > assert! ( res ) ,
_ = > panic! ( )
} ;
{
let network = net_graph_msg_handler . network_graph . read ( ) . unwrap ( ) ;
match network . get_channels ( ) . get ( & unsigned_announcement . short_channel_id ) {
Some ( channel_entry ) = > {
assert_eq! ( channel_entry . features , ChannelFeatures ::empty ( ) ) ;
} ,
_ = > panic! ( )
}
}
// Don't relay valid channels with excess data
unsigned_announcement . short_channel_id + = 1 ;
unsigned_announcement . excess_data . push ( 1 ) ;
msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_announcement . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_announcement = ChannelAnnouncement {
node_signature_1 : secp_ctx . sign ( & msghash , node_1_privkey ) ,
node_signature_2 : secp_ctx . sign ( & msghash , node_2_privkey ) ,
bitcoin_signature_1 : secp_ctx . sign ( & msghash , node_1_btckey ) ,
bitcoin_signature_2 : secp_ctx . sign ( & msghash , node_2_btckey ) ,
contents : unsigned_announcement . clone ( ) ,
} ;
match net_graph_msg_handler . handle_channel_announcement ( & valid_announcement ) {
Ok ( res ) = > assert! ( ! res ) ,
_ = > panic! ( )
} ;
unsigned_announcement . excess_data = Vec ::new ( ) ;
let invalid_sig_announcement = ChannelAnnouncement {
node_signature_1 : secp_ctx . sign ( & msghash , node_1_privkey ) ,
node_signature_2 : secp_ctx . sign ( & msghash , node_2_privkey ) ,
bitcoin_signature_1 : secp_ctx . sign ( & msghash , node_1_btckey ) ,
bitcoin_signature_2 : secp_ctx . sign ( & msghash , node_1_btckey ) ,
contents : unsigned_announcement . clone ( ) ,
} ;
match net_graph_msg_handler . handle_channel_announcement ( & invalid_sig_announcement ) {
Ok ( _ ) = > panic! ( ) ,
Err ( e ) = > assert_eq! ( e . err , " Invalid signature from remote node " )
} ;
unsigned_announcement . node_id_1 = PublicKey ::from_secret_key ( & secp_ctx , node_2_privkey ) ;
msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_announcement . encode ( ) [ .. ] ) [ .. ] ) ;
let channel_to_itself_announcement = ChannelAnnouncement {
2020-11-24 13:38:39 -05:00
node_signature_1 : secp_ctx . sign ( & msghash , node_2_privkey ) ,
node_signature_2 : secp_ctx . sign ( & msghash , node_2_privkey ) ,
2020-05-02 15:05:04 -04:00
bitcoin_signature_1 : secp_ctx . sign ( & msghash , node_1_btckey ) ,
bitcoin_signature_2 : secp_ctx . sign ( & msghash , node_2_btckey ) ,
contents : unsigned_announcement . clone ( ) ,
} ;
match net_graph_msg_handler . handle_channel_announcement ( & channel_to_itself_announcement ) {
Ok ( _ ) = > panic! ( ) ,
Err ( e ) = > assert_eq! ( e . err , " Channel announcement node had a channel with itself " )
} ;
}
#[ test ]
fn handling_channel_update ( ) {
2020-06-29 21:28:15 +03:00
let secp_ctx = Secp256k1 ::new ( ) ;
let logger : Arc < Logger > = Arc ::new ( test_utils ::TestLogger ::new ( ) ) ;
2020-07-17 22:08:34 -07:00
let chain_source = Arc ::new ( test_utils ::TestChainSource ::new ( Network ::Testnet ) ) ;
2020-11-29 15:20:35 -05:00
let net_graph_msg_handler = NetGraphMsgHandler ::new ( genesis_block ( Network ::Testnet ) . header . block_hash ( ) , Some ( chain_source . clone ( ) ) , Arc ::clone ( & logger ) ) ;
2020-06-29 21:28:15 +03:00
2020-05-02 15:05:04 -04:00
let node_1_privkey = & SecretKey ::from_slice ( & [ 42 ; 32 ] ) . unwrap ( ) ;
let node_2_privkey = & SecretKey ::from_slice ( & [ 41 ; 32 ] ) . unwrap ( ) ;
let node_id_1 = PublicKey ::from_secret_key ( & secp_ctx , node_1_privkey ) ;
let node_id_2 = PublicKey ::from_secret_key ( & secp_ctx , node_2_privkey ) ;
let node_1_btckey = & SecretKey ::from_slice ( & [ 40 ; 32 ] ) . unwrap ( ) ;
let node_2_btckey = & SecretKey ::from_slice ( & [ 39 ; 32 ] ) . unwrap ( ) ;
let zero_hash = Sha256dHash ::hash ( & [ 0 ; 32 ] ) ;
let short_channel_id = 0 ;
2020-08-25 17:12:00 -04:00
let chain_hash = genesis_block ( Network ::Testnet ) . header . block_hash ( ) ;
2020-06-29 21:28:15 +03:00
let amount_sats = 1000_000 ;
2020-05-02 15:05:04 -04:00
{
// Announce a channel we will update
2020-06-29 21:28:15 +03:00
let good_script = Builder ::new ( ) . push_opcode ( opcodes ::all ::OP_PUSHNUM_2 )
. push_slice ( & PublicKey ::from_secret_key ( & secp_ctx , node_1_btckey ) . serialize ( ) )
. push_slice ( & PublicKey ::from_secret_key ( & secp_ctx , node_2_btckey ) . serialize ( ) )
. push_opcode ( opcodes ::all ::OP_PUSHNUM_2 )
. push_opcode ( opcodes ::all ::OP_CHECKMULTISIG ) . into_script ( ) . to_v0_p2wsh ( ) ;
2020-07-17 22:08:34 -07:00
* chain_source . utxo_ret . lock ( ) . unwrap ( ) = Ok ( TxOut { value : amount_sats , script_pubkey : good_script . clone ( ) } ) ;
2020-05-02 15:05:04 -04:00
let unsigned_announcement = UnsignedChannelAnnouncement {
features : ChannelFeatures ::empty ( ) ,
chain_hash ,
short_channel_id ,
node_id_1 ,
node_id_2 ,
bitcoin_key_1 : PublicKey ::from_secret_key ( & secp_ctx , node_1_btckey ) ,
bitcoin_key_2 : PublicKey ::from_secret_key ( & secp_ctx , node_2_btckey ) ,
excess_data : Vec ::new ( ) ,
} ;
let msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_announcement . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_channel_announcement = ChannelAnnouncement {
node_signature_1 : secp_ctx . sign ( & msghash , node_1_privkey ) ,
node_signature_2 : secp_ctx . sign ( & msghash , node_2_privkey ) ,
bitcoin_signature_1 : secp_ctx . sign ( & msghash , node_1_btckey ) ,
bitcoin_signature_2 : secp_ctx . sign ( & msghash , node_2_btckey ) ,
contents : unsigned_announcement . clone ( ) ,
} ;
match net_graph_msg_handler . handle_channel_announcement ( & valid_channel_announcement ) {
Ok ( _ ) = > ( ) ,
Err ( _ ) = > panic! ( )
} ;
}
let mut unsigned_channel_update = UnsignedChannelUpdate {
chain_hash ,
short_channel_id ,
timestamp : 100 ,
flags : 0 ,
cltv_expiry_delta : 144 ,
htlc_minimum_msat : 1000000 ,
2020-06-28 14:43:10 +03:00
htlc_maximum_msat : OptionalField ::Absent ,
2020-05-02 15:05:04 -04:00
fee_base_msat : 10000 ,
fee_proportional_millionths : 20 ,
excess_data : Vec ::new ( )
} ;
let msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_channel_update . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_channel_update = ChannelUpdate {
signature : secp_ctx . sign ( & msghash , node_1_privkey ) ,
contents : unsigned_channel_update . clone ( )
} ;
match net_graph_msg_handler . handle_channel_update ( & valid_channel_update ) {
Ok ( res ) = > assert! ( res ) ,
_ = > panic! ( )
} ;
{
let network = net_graph_msg_handler . network_graph . read ( ) . unwrap ( ) ;
match network . get_channels ( ) . get ( & short_channel_id ) {
None = > panic! ( ) ,
Some ( channel_info ) = > {
2020-05-03 16:06:59 -04:00
assert_eq! ( channel_info . one_to_two . as_ref ( ) . unwrap ( ) . cltv_expiry_delta , 144 ) ;
assert! ( channel_info . two_to_one . is_none ( ) ) ;
2020-05-02 15:05:04 -04:00
}
}
}
unsigned_channel_update . timestamp + = 100 ;
unsigned_channel_update . excess_data . push ( 1 ) ;
let msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_channel_update . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_channel_update = ChannelUpdate {
signature : secp_ctx . sign ( & msghash , node_1_privkey ) ,
contents : unsigned_channel_update . clone ( )
} ;
// Return false because contains excess data
match net_graph_msg_handler . handle_channel_update ( & valid_channel_update ) {
Ok ( res ) = > assert! ( ! res ) ,
_ = > panic! ( )
} ;
2020-06-29 20:48:01 +03:00
unsigned_channel_update . timestamp + = 10 ;
2020-05-02 15:05:04 -04:00
unsigned_channel_update . short_channel_id + = 1 ;
let msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_channel_update . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_channel_update = ChannelUpdate {
signature : secp_ctx . sign ( & msghash , node_1_privkey ) ,
contents : unsigned_channel_update . clone ( )
} ;
match net_graph_msg_handler . handle_channel_update ( & valid_channel_update ) {
Ok ( _ ) = > panic! ( ) ,
Err ( e ) = > assert_eq! ( e . err , " Couldn't find channel for update " )
} ;
unsigned_channel_update . short_channel_id = short_channel_id ;
2020-06-29 21:28:15 +03:00
unsigned_channel_update . htlc_maximum_msat = OptionalField ::Present ( MAX_VALUE_MSAT + 1 ) ;
let msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_channel_update . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_channel_update = ChannelUpdate {
signature : secp_ctx . sign ( & msghash , node_1_privkey ) ,
contents : unsigned_channel_update . clone ( )
} ;
match net_graph_msg_handler . handle_channel_update ( & valid_channel_update ) {
Ok ( _ ) = > panic! ( ) ,
Err ( e ) = > assert_eq! ( e . err , " htlc_maximum_msat is larger than maximum possible msats " )
} ;
unsigned_channel_update . htlc_maximum_msat = OptionalField ::Absent ;
unsigned_channel_update . htlc_maximum_msat = OptionalField ::Present ( amount_sats * 1000 + 1 ) ;
let msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_channel_update . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_channel_update = ChannelUpdate {
signature : secp_ctx . sign ( & msghash , node_1_privkey ) ,
contents : unsigned_channel_update . clone ( )
} ;
match net_graph_msg_handler . handle_channel_update ( & valid_channel_update ) {
Ok ( _ ) = > panic! ( ) ,
2020-11-12 18:59:06 -05:00
Err ( e ) = > assert_eq! ( e . err , " htlc_maximum_msat is larger than channel capacity or capacity is bogus " )
2020-06-29 21:28:15 +03:00
} ;
unsigned_channel_update . htlc_maximum_msat = OptionalField ::Absent ;
2020-05-02 15:05:04 -04:00
// Even though previous update was not relayed further, we still accepted it,
// so we now won't accept update before the previous one.
unsigned_channel_update . timestamp - = 10 ;
let msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_channel_update . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_channel_update = ChannelUpdate {
signature : secp_ctx . sign ( & msghash , node_1_privkey ) ,
contents : unsigned_channel_update . clone ( )
} ;
match net_graph_msg_handler . handle_channel_update ( & valid_channel_update ) {
Ok ( _ ) = > panic! ( ) ,
Err ( e ) = > assert_eq! ( e . err , " Update older than last processed update " )
} ;
unsigned_channel_update . timestamp + = 500 ;
let fake_msghash = hash_to_message! ( & zero_hash ) ;
let invalid_sig_channel_update = ChannelUpdate {
signature : secp_ctx . sign ( & fake_msghash , node_1_privkey ) ,
contents : unsigned_channel_update . clone ( )
} ;
match net_graph_msg_handler . handle_channel_update ( & invalid_sig_channel_update ) {
Ok ( _ ) = > panic! ( ) ,
Err ( e ) = > assert_eq! ( e . err , " Invalid signature from remote node " )
} ;
}
#[ test ]
fn handling_htlc_fail_channel_update ( ) {
let ( secp_ctx , net_graph_msg_handler ) = create_net_graph_msg_handler ( ) ;
let node_1_privkey = & SecretKey ::from_slice ( & [ 42 ; 32 ] ) . unwrap ( ) ;
let node_2_privkey = & SecretKey ::from_slice ( & [ 41 ; 32 ] ) . unwrap ( ) ;
let node_id_1 = PublicKey ::from_secret_key ( & secp_ctx , node_1_privkey ) ;
let node_id_2 = PublicKey ::from_secret_key ( & secp_ctx , node_2_privkey ) ;
let node_1_btckey = & SecretKey ::from_slice ( & [ 40 ; 32 ] ) . unwrap ( ) ;
let node_2_btckey = & SecretKey ::from_slice ( & [ 39 ; 32 ] ) . unwrap ( ) ;
let short_channel_id = 0 ;
2020-08-25 17:12:00 -04:00
let chain_hash = genesis_block ( Network ::Testnet ) . header . block_hash ( ) ;
2020-05-02 15:05:04 -04:00
{
// There is no nodes in the table at the beginning.
let network = net_graph_msg_handler . network_graph . read ( ) . unwrap ( ) ;
assert_eq! ( network . get_nodes ( ) . len ( ) , 0 ) ;
}
{
// Announce a channel we will update
let unsigned_announcement = UnsignedChannelAnnouncement {
features : ChannelFeatures ::empty ( ) ,
chain_hash ,
short_channel_id ,
node_id_1 ,
node_id_2 ,
bitcoin_key_1 : PublicKey ::from_secret_key ( & secp_ctx , node_1_btckey ) ,
bitcoin_key_2 : PublicKey ::from_secret_key ( & secp_ctx , node_2_btckey ) ,
excess_data : Vec ::new ( ) ,
} ;
let msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_announcement . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_channel_announcement = ChannelAnnouncement {
node_signature_1 : secp_ctx . sign ( & msghash , node_1_privkey ) ,
node_signature_2 : secp_ctx . sign ( & msghash , node_2_privkey ) ,
bitcoin_signature_1 : secp_ctx . sign ( & msghash , node_1_btckey ) ,
bitcoin_signature_2 : secp_ctx . sign ( & msghash , node_2_btckey ) ,
contents : unsigned_announcement . clone ( ) ,
} ;
match net_graph_msg_handler . handle_channel_announcement ( & valid_channel_announcement ) {
Ok ( _ ) = > ( ) ,
Err ( _ ) = > panic! ( )
} ;
2020-05-03 16:06:59 -04:00
let unsigned_channel_update = UnsignedChannelUpdate {
chain_hash ,
short_channel_id ,
timestamp : 100 ,
flags : 0 ,
cltv_expiry_delta : 144 ,
htlc_minimum_msat : 1000000 ,
2020-06-28 14:43:10 +03:00
htlc_maximum_msat : OptionalField ::Absent ,
2020-05-03 16:06:59 -04:00
fee_base_msat : 10000 ,
fee_proportional_millionths : 20 ,
excess_data : Vec ::new ( )
} ;
let msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_channel_update . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_channel_update = ChannelUpdate {
signature : secp_ctx . sign ( & msghash , node_1_privkey ) ,
contents : unsigned_channel_update . clone ( )
} ;
match net_graph_msg_handler . handle_channel_update ( & valid_channel_update ) {
Ok ( res ) = > assert! ( res ) ,
_ = > panic! ( )
} ;
}
// Non-permanent closing just disables a channel
{
let network = net_graph_msg_handler . network_graph . read ( ) . unwrap ( ) ;
match network . get_channels ( ) . get ( & short_channel_id ) {
None = > panic! ( ) ,
Some ( channel_info ) = > {
assert! ( channel_info . one_to_two . is_some ( ) ) ;
}
}
2020-05-02 15:05:04 -04:00
}
let channel_close_msg = HTLCFailChannelUpdate ::ChannelClosed {
short_channel_id ,
is_permanent : false
} ;
net_graph_msg_handler . handle_htlc_fail_channel_update ( & channel_close_msg ) ;
// Non-permanent closing just disables a channel
{
let network = net_graph_msg_handler . network_graph . read ( ) . unwrap ( ) ;
match network . get_channels ( ) . get ( & short_channel_id ) {
None = > panic! ( ) ,
Some ( channel_info ) = > {
2020-05-03 16:06:59 -04:00
assert! ( ! channel_info . one_to_two . as_ref ( ) . unwrap ( ) . enabled ) ;
2020-05-02 15:05:04 -04:00
}
}
}
let channel_close_msg = HTLCFailChannelUpdate ::ChannelClosed {
short_channel_id ,
is_permanent : true
} ;
net_graph_msg_handler . handle_htlc_fail_channel_update ( & channel_close_msg ) ;
// Permanent closing deletes a channel
{
let network = net_graph_msg_handler . network_graph . read ( ) . unwrap ( ) ;
assert_eq! ( network . get_channels ( ) . len ( ) , 0 ) ;
// Nodes are also deleted because there are no associated channels anymore
assert_eq! ( network . get_nodes ( ) . len ( ) , 0 ) ;
}
// TODO: Test HTLCFailChannelUpdate::NodeFailure, which is not implemented yet.
}
#[ test ]
fn getting_next_channel_announcements ( ) {
let ( secp_ctx , net_graph_msg_handler ) = create_net_graph_msg_handler ( ) ;
let node_1_privkey = & SecretKey ::from_slice ( & [ 42 ; 32 ] ) . unwrap ( ) ;
let node_2_privkey = & SecretKey ::from_slice ( & [ 41 ; 32 ] ) . unwrap ( ) ;
let node_id_1 = PublicKey ::from_secret_key ( & secp_ctx , node_1_privkey ) ;
let node_id_2 = PublicKey ::from_secret_key ( & secp_ctx , node_2_privkey ) ;
let node_1_btckey = & SecretKey ::from_slice ( & [ 40 ; 32 ] ) . unwrap ( ) ;
let node_2_btckey = & SecretKey ::from_slice ( & [ 39 ; 32 ] ) . unwrap ( ) ;
let short_channel_id = 1 ;
2020-08-25 17:12:00 -04:00
let chain_hash = genesis_block ( Network ::Testnet ) . header . block_hash ( ) ;
2020-05-02 15:05:04 -04:00
// Channels were not announced yet.
let channels_with_announcements = net_graph_msg_handler . get_next_channel_announcements ( 0 , 1 ) ;
assert_eq! ( channels_with_announcements . len ( ) , 0 ) ;
{
// Announce a channel we will update
let unsigned_announcement = UnsignedChannelAnnouncement {
features : ChannelFeatures ::empty ( ) ,
chain_hash ,
short_channel_id ,
node_id_1 ,
node_id_2 ,
bitcoin_key_1 : PublicKey ::from_secret_key ( & secp_ctx , node_1_btckey ) ,
bitcoin_key_2 : PublicKey ::from_secret_key ( & secp_ctx , node_2_btckey ) ,
excess_data : Vec ::new ( ) ,
} ;
let msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_announcement . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_channel_announcement = ChannelAnnouncement {
node_signature_1 : secp_ctx . sign ( & msghash , node_1_privkey ) ,
node_signature_2 : secp_ctx . sign ( & msghash , node_2_privkey ) ,
bitcoin_signature_1 : secp_ctx . sign ( & msghash , node_1_btckey ) ,
bitcoin_signature_2 : secp_ctx . sign ( & msghash , node_2_btckey ) ,
contents : unsigned_announcement . clone ( ) ,
} ;
match net_graph_msg_handler . handle_channel_announcement ( & valid_channel_announcement ) {
Ok ( _ ) = > ( ) ,
Err ( _ ) = > panic! ( )
} ;
}
// Contains initial channel announcement now.
let channels_with_announcements = net_graph_msg_handler . get_next_channel_announcements ( short_channel_id , 1 ) ;
assert_eq! ( channels_with_announcements . len ( ) , 1 ) ;
if let Some ( channel_announcements ) = channels_with_announcements . first ( ) {
let & ( _ , ref update_1 , ref update_2 ) = channel_announcements ;
assert_eq! ( update_1 , & None ) ;
assert_eq! ( update_2 , & None ) ;
} else {
panic! ( ) ;
}
{
// Valid channel update
let unsigned_channel_update = UnsignedChannelUpdate {
chain_hash ,
short_channel_id ,
timestamp : 101 ,
flags : 0 ,
cltv_expiry_delta : 144 ,
htlc_minimum_msat : 1000000 ,
2020-06-28 14:43:10 +03:00
htlc_maximum_msat : OptionalField ::Absent ,
2020-05-02 15:05:04 -04:00
fee_base_msat : 10000 ,
fee_proportional_millionths : 20 ,
excess_data : Vec ::new ( )
} ;
let msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_channel_update . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_channel_update = ChannelUpdate {
signature : secp_ctx . sign ( & msghash , node_1_privkey ) ,
contents : unsigned_channel_update . clone ( )
} ;
match net_graph_msg_handler . handle_channel_update ( & valid_channel_update ) {
Ok ( _ ) = > ( ) ,
Err ( _ ) = > panic! ( )
} ;
}
// Now contains an initial announcement and an update.
let channels_with_announcements = net_graph_msg_handler . get_next_channel_announcements ( short_channel_id , 1 ) ;
assert_eq! ( channels_with_announcements . len ( ) , 1 ) ;
if let Some ( channel_announcements ) = channels_with_announcements . first ( ) {
let & ( _ , ref update_1 , ref update_2 ) = channel_announcements ;
assert_ne! ( update_1 , & None ) ;
assert_eq! ( update_2 , & None ) ;
} else {
panic! ( ) ;
}
{
// Channel update with excess data.
let unsigned_channel_update = UnsignedChannelUpdate {
chain_hash ,
short_channel_id ,
timestamp : 102 ,
flags : 0 ,
cltv_expiry_delta : 144 ,
htlc_minimum_msat : 1000000 ,
2020-06-28 14:43:10 +03:00
htlc_maximum_msat : OptionalField ::Absent ,
2020-05-02 15:05:04 -04:00
fee_base_msat : 10000 ,
fee_proportional_millionths : 20 ,
excess_data : [ 1 ; 3 ] . to_vec ( )
} ;
let msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_channel_update . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_channel_update = ChannelUpdate {
signature : secp_ctx . sign ( & msghash , node_1_privkey ) ,
contents : unsigned_channel_update . clone ( )
} ;
match net_graph_msg_handler . handle_channel_update ( & valid_channel_update ) {
Ok ( _ ) = > ( ) ,
Err ( _ ) = > panic! ( )
} ;
}
// Test that announcements with excess data won't be returned
let channels_with_announcements = net_graph_msg_handler . get_next_channel_announcements ( short_channel_id , 1 ) ;
assert_eq! ( channels_with_announcements . len ( ) , 1 ) ;
if let Some ( channel_announcements ) = channels_with_announcements . first ( ) {
let & ( _ , ref update_1 , ref update_2 ) = channel_announcements ;
assert_eq! ( update_1 , & None ) ;
assert_eq! ( update_2 , & None ) ;
} else {
panic! ( ) ;
}
// Further starting point have no channels after it
let channels_with_announcements = net_graph_msg_handler . get_next_channel_announcements ( short_channel_id + 1000 , 1 ) ;
assert_eq! ( channels_with_announcements . len ( ) , 0 ) ;
}
#[ test ]
fn getting_next_node_announcements ( ) {
let ( secp_ctx , net_graph_msg_handler ) = create_net_graph_msg_handler ( ) ;
let node_1_privkey = & SecretKey ::from_slice ( & [ 42 ; 32 ] ) . unwrap ( ) ;
let node_2_privkey = & SecretKey ::from_slice ( & [ 41 ; 32 ] ) . unwrap ( ) ;
let node_id_1 = PublicKey ::from_secret_key ( & secp_ctx , node_1_privkey ) ;
let node_id_2 = PublicKey ::from_secret_key ( & secp_ctx , node_2_privkey ) ;
let node_1_btckey = & SecretKey ::from_slice ( & [ 40 ; 32 ] ) . unwrap ( ) ;
let node_2_btckey = & SecretKey ::from_slice ( & [ 39 ; 32 ] ) . unwrap ( ) ;
let short_channel_id = 1 ;
2020-08-25 17:12:00 -04:00
let chain_hash = genesis_block ( Network ::Testnet ) . header . block_hash ( ) ;
2020-05-02 15:05:04 -04:00
// No nodes yet.
let next_announcements = net_graph_msg_handler . get_next_node_announcements ( None , 10 ) ;
assert_eq! ( next_announcements . len ( ) , 0 ) ;
{
// Announce a channel to add 2 nodes
let unsigned_announcement = UnsignedChannelAnnouncement {
features : ChannelFeatures ::empty ( ) ,
chain_hash ,
short_channel_id ,
node_id_1 ,
node_id_2 ,
bitcoin_key_1 : PublicKey ::from_secret_key ( & secp_ctx , node_1_btckey ) ,
bitcoin_key_2 : PublicKey ::from_secret_key ( & secp_ctx , node_2_btckey ) ,
excess_data : Vec ::new ( ) ,
} ;
let msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_announcement . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_channel_announcement = ChannelAnnouncement {
node_signature_1 : secp_ctx . sign ( & msghash , node_1_privkey ) ,
node_signature_2 : secp_ctx . sign ( & msghash , node_2_privkey ) ,
bitcoin_signature_1 : secp_ctx . sign ( & msghash , node_1_btckey ) ,
bitcoin_signature_2 : secp_ctx . sign ( & msghash , node_2_btckey ) ,
contents : unsigned_announcement . clone ( ) ,
} ;
match net_graph_msg_handler . handle_channel_announcement ( & valid_channel_announcement ) {
Ok ( _ ) = > ( ) ,
Err ( _ ) = > panic! ( )
} ;
}
// Nodes were never announced
let next_announcements = net_graph_msg_handler . get_next_node_announcements ( None , 3 ) ;
assert_eq! ( next_announcements . len ( ) , 0 ) ;
{
let mut unsigned_announcement = UnsignedNodeAnnouncement {
features : NodeFeatures ::known ( ) ,
timestamp : 1000 ,
node_id : node_id_1 ,
rgb : [ 0 ; 3 ] ,
alias : [ 0 ; 32 ] ,
addresses : Vec ::new ( ) ,
excess_address_data : Vec ::new ( ) ,
excess_data : Vec ::new ( ) ,
} ;
let msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_announcement . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_announcement = NodeAnnouncement {
signature : secp_ctx . sign ( & msghash , node_1_privkey ) ,
contents : unsigned_announcement . clone ( )
} ;
match net_graph_msg_handler . handle_node_announcement ( & valid_announcement ) {
Ok ( _ ) = > ( ) ,
Err ( _ ) = > panic! ( )
} ;
unsigned_announcement . node_id = node_id_2 ;
let msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_announcement . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_announcement = NodeAnnouncement {
signature : secp_ctx . sign ( & msghash , node_2_privkey ) ,
contents : unsigned_announcement . clone ( )
} ;
match net_graph_msg_handler . handle_node_announcement ( & valid_announcement ) {
Ok ( _ ) = > ( ) ,
Err ( _ ) = > panic! ( )
} ;
}
let next_announcements = net_graph_msg_handler . get_next_node_announcements ( None , 3 ) ;
assert_eq! ( next_announcements . len ( ) , 2 ) ;
// Skip the first node.
let next_announcements = net_graph_msg_handler . get_next_node_announcements ( Some ( & node_id_1 ) , 2 ) ;
assert_eq! ( next_announcements . len ( ) , 1 ) ;
{
// Later announcement which should not be relayed (excess data) prevent us from sharing a node
let unsigned_announcement = UnsignedNodeAnnouncement {
features : NodeFeatures ::known ( ) ,
timestamp : 1010 ,
node_id : node_id_2 ,
rgb : [ 0 ; 3 ] ,
alias : [ 0 ; 32 ] ,
addresses : Vec ::new ( ) ,
excess_address_data : Vec ::new ( ) ,
excess_data : [ 1 ; 3 ] . to_vec ( ) ,
} ;
let msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_announcement . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_announcement = NodeAnnouncement {
signature : secp_ctx . sign ( & msghash , node_2_privkey ) ,
contents : unsigned_announcement . clone ( )
} ;
match net_graph_msg_handler . handle_node_announcement ( & valid_announcement ) {
Ok ( res ) = > assert! ( ! res ) ,
Err ( _ ) = > panic! ( )
} ;
}
let next_announcements = net_graph_msg_handler . get_next_node_announcements ( Some ( & node_id_1 ) , 2 ) ;
assert_eq! ( next_announcements . len ( ) , 0 ) ;
}
#[ test ]
fn network_graph_serialization ( ) {
let ( secp_ctx , net_graph_msg_handler ) = create_net_graph_msg_handler ( ) ;
let node_1_privkey = & SecretKey ::from_slice ( & [ 42 ; 32 ] ) . unwrap ( ) ;
let node_2_privkey = & SecretKey ::from_slice ( & [ 41 ; 32 ] ) . unwrap ( ) ;
let node_1_btckey = & SecretKey ::from_slice ( & [ 40 ; 32 ] ) . unwrap ( ) ;
let node_2_btckey = & SecretKey ::from_slice ( & [ 39 ; 32 ] ) . unwrap ( ) ;
// Announce a channel to add a corresponding node.
let node_id_1 = PublicKey ::from_secret_key ( & secp_ctx , node_1_privkey ) ;
let node_id_2 = PublicKey ::from_secret_key ( & secp_ctx , node_2_privkey ) ;
let unsigned_announcement = UnsignedChannelAnnouncement {
features : ChannelFeatures ::known ( ) ,
2020-08-25 17:12:00 -04:00
chain_hash : genesis_block ( Network ::Testnet ) . header . block_hash ( ) ,
2020-05-02 15:05:04 -04:00
short_channel_id : 0 ,
node_id_1 ,
node_id_2 ,
bitcoin_key_1 : PublicKey ::from_secret_key ( & secp_ctx , node_1_btckey ) ,
bitcoin_key_2 : PublicKey ::from_secret_key ( & secp_ctx , node_2_btckey ) ,
excess_data : Vec ::new ( ) ,
} ;
let msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_announcement . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_announcement = ChannelAnnouncement {
node_signature_1 : secp_ctx . sign ( & msghash , node_1_privkey ) ,
node_signature_2 : secp_ctx . sign ( & msghash , node_2_privkey ) ,
bitcoin_signature_1 : secp_ctx . sign ( & msghash , node_1_btckey ) ,
bitcoin_signature_2 : secp_ctx . sign ( & msghash , node_2_btckey ) ,
contents : unsigned_announcement . clone ( ) ,
} ;
match net_graph_msg_handler . handle_channel_announcement ( & valid_announcement ) {
Ok ( res ) = > assert! ( res ) ,
_ = > panic! ( )
} ;
let node_id = PublicKey ::from_secret_key ( & secp_ctx , node_1_privkey ) ;
let unsigned_announcement = UnsignedNodeAnnouncement {
features : NodeFeatures ::known ( ) ,
timestamp : 100 ,
node_id ,
rgb : [ 0 ; 3 ] ,
alias : [ 0 ; 32 ] ,
addresses : Vec ::new ( ) ,
excess_address_data : Vec ::new ( ) ,
excess_data : Vec ::new ( ) ,
} ;
let msghash = hash_to_message! ( & Sha256dHash ::hash ( & unsigned_announcement . encode ( ) [ .. ] ) [ .. ] ) ;
let valid_announcement = NodeAnnouncement {
signature : secp_ctx . sign ( & msghash , node_1_privkey ) ,
contents : unsigned_announcement . clone ( )
} ;
match net_graph_msg_handler . handle_node_announcement ( & valid_announcement ) {
Ok ( _ ) = > ( ) ,
Err ( _ ) = > panic! ( )
} ;
let network = net_graph_msg_handler . network_graph . write ( ) . unwrap ( ) ;
let mut w = test_utils ::TestVecWriter ( Vec ::new ( ) ) ;
assert! ( ! network . get_nodes ( ) . is_empty ( ) ) ;
assert! ( ! network . get_channels ( ) . is_empty ( ) ) ;
network . write ( & mut w ) . unwrap ( ) ;
assert! ( < NetworkGraph > ::read ( & mut ::std ::io ::Cursor ::new ( & w . 0 ) ) . unwrap ( ) = = * network ) ;
}
2020-10-22 12:44:53 -04:00
#[ test ]
2020-11-18 13:32:55 -05:00
fn calling_sync_routing_table ( ) {
2020-10-22 12:44:53 -04:00
let ( secp_ctx , net_graph_msg_handler ) = create_net_graph_msg_handler ( ) ;
let node_privkey_1 = & SecretKey ::from_slice ( & [ 42 ; 32 ] ) . unwrap ( ) ;
let node_id_1 = PublicKey ::from_secret_key ( & secp_ctx , node_privkey_1 ) ;
let chain_hash = genesis_block ( Network ::Testnet ) . header . block_hash ( ) ;
let first_blocknum = 0 ;
let number_of_blocks = 0xffff_ffff ;
2020-11-18 13:32:55 -05:00
net_graph_msg_handler . sync_routing_table ( & node_id_1 ) ;
// It should send a query_channel_message with the correct information
let events = net_graph_msg_handler . get_and_clear_pending_msg_events ( ) ;
assert_eq! ( events . len ( ) , 1 ) ;
match & events [ 0 ] {
MessageSendEvent ::SendChannelRangeQuery { node_id , msg } = > {
assert_eq! ( node_id , & node_id_1 ) ;
assert_eq! ( msg . chain_hash , chain_hash ) ;
assert_eq! ( msg . first_blocknum , first_blocknum ) ;
assert_eq! ( msg . number_of_blocks , number_of_blocks ) ;
} ,
_ = > panic! ( " Expected MessageSendEvent::SendChannelRangeQuery " )
} ;
2020-10-22 12:44:53 -04:00
}
#[ test ]
fn handling_reply_channel_range ( ) {
let ( secp_ctx , net_graph_msg_handler ) = create_net_graph_msg_handler ( ) ;
let node_privkey_1 = & SecretKey ::from_slice ( & [ 42 ; 32 ] ) . unwrap ( ) ;
let node_id_1 = PublicKey ::from_secret_key ( & secp_ctx , node_privkey_1 ) ;
let chain_hash = genesis_block ( Network ::Testnet ) . header . block_hash ( ) ;
2020-11-18 13:32:55 -05:00
// Test receipt of a single reply that should enqueue an SCID query
// matching the SCIDs in the reply
2020-10-22 12:44:53 -04:00
{
// Handle a single successful reply that encompasses the queried channel range
2020-12-03 11:52:54 -05:00
let result = net_graph_msg_handler . handle_reply_channel_range ( & node_id_1 , ReplyChannelRange {
2020-10-22 12:44:53 -04:00
chain_hash ,
full_information : true ,
first_blocknum : 0 ,
number_of_blocks : 2000 ,
short_channel_ids : vec ! [
0x0003e0_000000_0000 , // 992x0x0
0x0003e8_000000_0000 , // 1000x0x0
0x0003e9_000000_0000 , // 1001x0x0
0x0003f0_000000_0000 , // 1008x0x0
0x00044c_000000_0000 , // 1100x0x0
0x0006e0_000000_0000 , // 1760x0x0
] ,
} ) ;
assert! ( result . is_ok ( ) ) ;
2020-11-18 13:32:55 -05:00
// We expect to emit a query_short_channel_ids message with the received scids
2020-10-22 12:44:53 -04:00
let events = net_graph_msg_handler . get_and_clear_pending_msg_events ( ) ;
assert_eq! ( events . len ( ) , 1 ) ;
match & events [ 0 ] {
MessageSendEvent ::SendShortIdsQuery { node_id , msg } = > {
assert_eq! ( node_id , & node_id_1 ) ;
assert_eq! ( msg . chain_hash , chain_hash ) ;
2020-11-18 13:32:55 -05:00
assert_eq! ( msg . short_channel_ids , vec! [
0x0003e0_000000_0000 , // 992x0x0
0x0003e8_000000_0000 , // 1000x0x0
0x0003e9_000000_0000 , // 1001x0x0
0x0003f0_000000_0000 , // 1008x0x0
0x00044c_000000_0000 , // 1100x0x0
0x0006e0_000000_0000 , // 1760x0x0
] ) ;
2020-10-22 12:44:53 -04:00
} ,
_ = > panic! ( " expected MessageSendEvent::SendShortIdsQuery " ) ,
}
}
// Test receipt of a reply that indicates the remote node does not maintain up-to-date
// information for the chain_hash. Because of discrepancies in implementation we use
2020-11-18 13:32:55 -05:00
// full_information=false and short_channel_ids=[] as the signal.
2020-10-22 12:44:53 -04:00
{
// Handle the reply indicating the peer was unable to fulfill our request.
2020-12-03 11:52:54 -05:00
let result = net_graph_msg_handler . handle_reply_channel_range ( & node_id_1 , ReplyChannelRange {
2020-10-22 12:44:53 -04:00
chain_hash ,
full_information : false ,
first_blocknum : 1000 ,
number_of_blocks : 100 ,
short_channel_ids : vec ! [ ] ,
} ) ;
assert! ( result . is_err ( ) ) ;
assert_eq! ( result . err ( ) . unwrap ( ) . err , " Received reply_channel_range with no information available " ) ;
}
}
#[ test ]
fn handling_reply_short_channel_ids ( ) {
let ( secp_ctx , net_graph_msg_handler ) = create_net_graph_msg_handler ( ) ;
let node_privkey = & SecretKey ::from_slice ( & [ 41 ; 32 ] ) . unwrap ( ) ;
let node_id = PublicKey ::from_secret_key ( & secp_ctx , node_privkey ) ;
let chain_hash = genesis_block ( Network ::Testnet ) . header . block_hash ( ) ;
2020-11-18 13:32:55 -05:00
// Test receipt of a successful reply
2020-10-22 12:44:53 -04:00
{
2020-12-03 11:52:54 -05:00
let result = net_graph_msg_handler . handle_reply_short_channel_ids_end ( & node_id , ReplyShortChannelIdsEnd {
2020-10-22 12:44:53 -04:00
chain_hash ,
full_information : true ,
} ) ;
assert! ( result . is_ok ( ) ) ;
}
// Test receipt of a reply that indicates the peer does not maintain up-to-date information
2020-11-18 13:32:55 -05:00
// for the chain_hash requested in the query.
2020-10-22 12:44:53 -04:00
{
2020-12-03 11:52:54 -05:00
let result = net_graph_msg_handler . handle_reply_short_channel_ids_end ( & node_id , ReplyShortChannelIdsEnd {
2020-10-22 12:44:53 -04:00
chain_hash ,
full_information : false ,
} ) ;
assert! ( result . is_err ( ) ) ;
assert_eq! ( result . err ( ) . unwrap ( ) . err , " Received reply_short_channel_ids_end with no information " ) ;
}
}
#[ test ]
fn handling_query_channel_range ( ) {
let ( secp_ctx , net_graph_msg_handler ) = create_net_graph_msg_handler ( ) ;
let node_privkey = & SecretKey ::from_slice ( & [ 41 ; 32 ] ) . unwrap ( ) ;
let node_id = PublicKey ::from_secret_key ( & secp_ctx , node_privkey ) ;
let chain_hash = genesis_block ( Network ::Testnet ) . header . block_hash ( ) ;
2020-12-03 11:52:54 -05:00
let result = net_graph_msg_handler . handle_query_channel_range ( & node_id , QueryChannelRange {
2020-10-22 12:44:53 -04:00
chain_hash ,
first_blocknum : 0 ,
number_of_blocks : 0xffff_ffff ,
} ) ;
assert! ( result . is_err ( ) ) ;
}
#[ test ]
fn handling_query_short_channel_ids ( ) {
let ( secp_ctx , net_graph_msg_handler ) = create_net_graph_msg_handler ( ) ;
let node_privkey = & SecretKey ::from_slice ( & [ 41 ; 32 ] ) . unwrap ( ) ;
let node_id = PublicKey ::from_secret_key ( & secp_ctx , node_privkey ) ;
let chain_hash = genesis_block ( Network ::Testnet ) . header . block_hash ( ) ;
2020-12-03 11:52:54 -05:00
let result = net_graph_msg_handler . handle_query_short_channel_ids ( & node_id , QueryShortChannelIds {
2020-10-22 12:44:53 -04:00
chain_hash ,
short_channel_ids : vec ! [ 0x0003e8_000000_0000 ] ,
} ) ;
assert! ( result . is_err ( ) ) ;
}
2020-05-02 15:05:04 -04:00
}