Module msgs

Wire messages, traits representing wire message handlers, and a few error types live here.

For a normal node you probably don’t need to use anything here, however, if you wish to split a node into an internet-facing route/message socket handling daemon and a separate daemon (or server entirely) which handles only channel-related messages you may wish to implement ChannelMessageHandler yourself and use it to re-serialize messages and pass them across daemons/servers.

Note that if you go with such an architecture (instead of passing raw socket events to a non-internet-facing system) you trust the frontend internet-facing system to not lie about the source node_id of the message, however this does allow you to significantly reduce bandwidth between the systems as routing messages can represent a significant chunk of bandwidth usage (especially for non-channel-publicly-announcing nodes). As an alternate design which avoids this issue, if you have sufficient bidirectional bandwidth between your systems, you may send raw socket events into your non-internet-facing system and then send routing events back to track the network on the less-secure system.

Structs

AcceptChannel

An accept_channel message to be sent to or received from a peer.

AcceptChannelV2

An accept_channel2 message to be sent by or received from the channel accepter.

AnnouncementSignatures

An announcement_signatures message to be sent to or received from a peer.

ChannelAnnouncement

A channel_announcement message to be sent to or received from a peer.

ChannelReady

A channel_ready message to be sent to or received from a peer.

ChannelReestablish

A channel_reestablish message to be sent to or received from a peer.

ChannelUpdate

A channel_update message to be sent to or received from a peer.

ClosingSigned

A closing_signed message to be sent to or received from a peer.

ClosingSignedFeeRange

The minimum and maximum fees which the sender is willing to place on the closing transaction.

CommitmentSigned

A commitment_signed message to be sent to or received from a peer.

CommitmentUpdate

Struct used to return values from RevokeAndACK messages, containing a bunch of commitment transaction updates if they were pending.

CommonAcceptChannelFields

Contains fields that are both common to accept_channel and accept_channel2 messages.

CommonOpenChannelFields

Contains fields that are both common to open_channel and open_channel2 messages.

ErrorMessage

An error message to be sent to or received from a peer.

FinalOnionHopData

Information communicated in the onion to the recipient for multi-part tracking and proof that the payment is associated with an invoice.

FundingCreated

A funding_created message to be sent to or received from a peer.

FundingSigned

A funding_signed message to be sent to or received from a peer.

GossipTimestampFilter

A gossip_timestamp_filter message is used by a node to request gossip relay for messages in the requested time range when the gossip_queries feature has been negotiated.

Init

An init message to be sent to or received from a peer.

LightningError

An Err type for failure to process messages.

NodeAnnouncement

A node_announcement message to be sent to or received from a peer.

OnionMessage

An onion message to be sent to or received from a peer.

OnionPacket

BOLT 4 onion packet including hop data for the next peer.

OpenChannel

An open_channel message to be sent to or received from a peer.

OpenChannelV2

An open_channel2 message to be sent by or received from the channel initiator.

Ping

A ping message to be sent to or received from a peer.

Pong

A pong message to be sent to or received from a peer.

QueryChannelRange

A query_channel_range message is used to query a peer for channel UTXOs in a range of blocks. The recipient of a query makes a best effort to reply to the query using one or more ReplyChannelRange messages.

QueryShortChannelIds

A query_short_channel_ids message is used to query a peer for routing gossip messages related to one or more short_channel_ids.

ReplyChannelRange

A reply_channel_range message is a reply to a QueryChannelRange message.

ReplyShortChannelIdsEnd

A reply_short_channel_ids_end message is sent as a reply to a message. The query recipient makes a best effort to respond based on their local network view which may not be a perfect view of the network.

RevokeAndACK

A revoke_and_ack message to be sent to or received from a peer.

Shutdown

A shutdown message to be sent to or received from a peer.

Splice

A splice message to be sent by or received from the stfu initiator (splice initiator).

SpliceAck

A splice_ack message to be received by or sent to the splice initiator.

SpliceLocked

A splice_locked message to be sent to or received from a peer.

Stfu

An stfu (quiescence) message to be sent by or received from the stfu initiator.

TrampolineOnionPacket

BOLT 4 onion packet including hop data for the next peer.

TxAbort

A tx_abort message which signals the cancellation of an in-progress transaction negotiation.

TxAckRbf

A tx_ack_rbf message which acknowledges replacement of the transaction after it’s been completed.

TxAddInput

A tx_add_input message for adding an input during interactive transaction construction

TxAddOutput

A tx_add_output message for adding an output during interactive transaction construction.

TxComplete

A tx_complete message signalling the conclusion of a peer’s transaction contributions during interactive transaction construction.

TxInitRbf

A tx_init_rbf message which initiates a replacement of the transaction after it’s been completed.

TxRemoveInput

A tx_remove_input message for removing an input during interactive transaction construction.

TxRemoveOutput

A tx_remove_output message for removing an output during interactive transaction construction.

TxSignatures

A tx_signatures message containing the sender’s signatures for a transaction constructed with interactive transaction construction.

UnsignedChannelAnnouncement

The unsigned part of a channel_announcement message.

UnsignedChannelUpdate

The unsigned part of a channel_update message.

UnsignedNodeAnnouncement

The unsigned part of a node_announcement message.

UpdateAddHTLC

An update_add_htlc message to be sent to or received from a peer.

UpdateFailHTLC

An update_fail_htlc message to be sent to or received from a peer.

UpdateFailMalformedHTLC

An update_fail_malformed_htlc message to be sent to or received from a peer.

UpdateFee

An update_fee message to be sent to or received from a peer

UpdateFulfillHTLC

An update_fulfill_htlc message to be sent to or received from a peer.

WarningMessage

A warning message to be sent to or received from a peer.

Enums

DecodeError

An error in decoding a message or struct.

ErrorAction

Used to put an error message in a LightningError.

SocketAddress

An address which can be used to connect to a remote peer.

SocketAddressParseError

SocketAddress error variants

UnsignedGossipMessage

Represents the set of gossip messages that require a signature from a node’s identity key.

Traits

ChannelMessageHandler

A trait to describe an object which can receive channel messages.

OnionMessageHandler

A handler for received OnionMessages and for providing generated ones to send.

RoutingMessageHandler

A trait to describe an object which can receive routing messages.

Functions

parse_onion_address

Parses an OnionV3 host and port into a SocketAddress::OnionV3.

Type Aliases

SerialId

A randomly chosen number that is used to identify inputs within an interactive transaction construction.