Skip to content

Commit

Permalink
feat: Resend last outbound dlc messages on connect
Browse files Browse the repository at this point in the history
Upon connecting to the peer, the last send dlc message is looked up from the database (`last_outbvound_dlc_messages`) and is naively resend to the counterparty (this is applicable for both sides).

Once the counterparty receives the last message, it will check if it has already processed that message looking up the hash of the dlc message in the `dlc_messages` table.

If it has alrady seen the message it will simply ignore it if not, it will continue processing it as it appears it must have missed it the first time, thus continuing an interrupted protocol.

- All dlc messages are stored into the `dlc_messages` table once successfully processed
- The last outbound dlc message is stored to the `last_outbound_dlc_messages` table. Note, that since a dlc message can get quite large we are only keeping the last message around so to not waste space.

In order to keep track of all outbound dlc messages I had to introduce the `SendDlcMessage` Event, which re-routes the sending over the app / coordinator layer who is then able to store the message firstly into the `dlc_messages` and `last_outbound_dlc_messages` before actually sending the message to the counter party. This way we ensure we are always able to resend the last message.

Note, since we are using different data sources with independet transactional systems it can happen that we are persting things into the sled database (dlc), but not into the sqlite database (10101). This should get addressed eventually. e.g. by also storing the dlc data structures into the same sqlite database.
  • Loading branch information
holzeis committed Jan 15, 2024
1 parent 16cff08 commit d8694b6
Show file tree
Hide file tree
Showing 27 changed files with 1,631 additions and 101 deletions.
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- Chore: don't allow multiple dlc-channels per user
- Feat: show dlc-channel opening transaction in transaction history
- Feat: allow force-close a DLC channel
- Feat: resend last outbound dlc message on connect

## [1.7.4] - 2023-12-20

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
-- This file should undo anything in `up.sql`
DROP TABLE "last_outbound_dlc_messages";
DROP TABLE "dlc_messages";

DROP TYPE "Message_Sub_Type_Type";
DROP TYPE "Message_Type_Type";

39 changes: 39 additions & 0 deletions coordinator/migrations/2024-01-10-105231_add_dlc_messages/up.sql
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
CREATE TYPE "Message_Type_Type" AS ENUM (
'OnChain',
'Channel'
);

CREATE TYPE "Message_Sub_Type_Type" AS ENUM (
'Offer',
'Accept',
'Sign',
'SettleOffer',
'SettleAccept',
'SettleConfirm',
'SettleFinalize',
'RenewOffer',
'RenewAccept',
'RenewConfirm',
'RenewFinalize',
'RenewRevoke',
'CollaborativeCloseOffer',
'Reject'
);

CREATE TABLE "dlc_messages" (
-- We need to store the hash as TEXT as the BIGINT type overflows on some u64 values breaking the hash value.
message_hash TEXT PRIMARY KEY NOT NULL,
inbound BOOLEAN NOT NULL,
peer_id TEXT NOT NULL,
message_type "Message_Type_Type" NOT NULL,
message_sub_type "Message_Sub_Type_Type" NOT NULL,
timestamp TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT CURRENT_TIMESTAMP
);

CREATE TABLE "last_outbound_dlc_messages" (
peer_id TEXT PRIMARY KEY NOT NULL,
message_hash TEXT REFERENCES dlc_messages(message_hash) NOT NULL,
message TEXT NOT NULL,
timestamp TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT CURRENT_TIMESTAMP
);

12 changes: 12 additions & 0 deletions coordinator/src/bin/coordinator.rs
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@ use anyhow::Result;
use bitcoin::XOnlyPublicKey;
use coordinator::backup::SledBackup;
use coordinator::cli::Opts;
use coordinator::dlc_handler;
use coordinator::dlc_handler::DlcHandler;
use coordinator::logger;
use coordinator::message::spawn_delivering_messages_to_authenticated_users;
use coordinator::message::NewUserMessage;
Expand All @@ -28,6 +30,7 @@ use diesel::r2d2;
use diesel::r2d2::ConnectionManager;
use diesel::PgConnection;
use lightning::events::Event;
use ln_dlc_node::node::event::NodeEventHandler;
use ln_dlc_node::scorer;
use ln_dlc_node::seed::Bip39Seed;
use ln_dlc_node::CoordinatorEventHandler;
Expand Down Expand Up @@ -139,6 +142,15 @@ async fn main() -> Result<()> {
node_event_handler.clone(),
)?);

let dlc_handler = DlcHandler::new(pool.clone(), node.clone());
let _handle =
// this handles sending outbound dlc messages as well as keeping track of what
// dlc messages have already been processed and what was the last outbound dlc message
// so it can be resend on reconnect.
//
// this does not handle the incoming dlc messages!
dlc_handler::spawn_handling_dlc_messages(dlc_handler, node_event_handler.subscribe());

let event_handler = CoordinatorEventHandler::new(node.clone(), Some(node_event_sender));
let running = node.start(event_handler, false)?;
let node = Node::new(node, running, pool.clone(), settings.to_node_settings());
Expand Down
68 changes: 68 additions & 0 deletions coordinator/src/db/custom_types.rs
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,14 @@ use crate::db::payments::HtlcStatus;
use crate::db::payments::PaymentFlow;
use crate::db::positions::ContractSymbol;
use crate::db::positions::PositionState;
use crate::db::dlc_messages::MessageSubType;
use crate::db::dlc_messages::MessageType;
use crate::schema::sql_types::ChannelStateType;
use crate::schema::sql_types::ContractSymbolType;
use crate::schema::sql_types::DirectionType;
use crate::schema::sql_types::HtlcStatusType;
use crate::schema::sql_types::MessageSubTypeType;
use crate::schema::sql_types::MessageTypeType;
use crate::schema::sql_types::PaymentFlowType;
use crate::schema::sql_types::PositionStateType;
use diesel::deserialize;
Expand Down Expand Up @@ -159,3 +163,67 @@ impl FromSql<DirectionType, Pg> for Direction {
}
}
}

impl ToSql<MessageTypeType, Pg> for MessageType {
fn to_sql<'b>(&'b self, out: &mut Output<'b, '_, Pg>) -> serialize::Result {
match *self {
MessageType::OnChain => out.write_all(b"OnChain")?,
MessageType::Channel => out.write_all(b"Channel")?,
}
Ok(IsNull::No)
}
}

impl FromSql<MessageTypeType, Pg> for MessageType {
fn from_sql(bytes: PgValue<'_>) -> deserialize::Result<Self> {
match bytes.as_bytes() {
b"OnChain" => Ok(MessageType::OnChain),
b"Channel" => Ok(MessageType::Channel),
_ => Err("Unrecognized enum variant".into()),
}
}
}

impl ToSql<MessageSubTypeType, Pg> for MessageSubType {
fn to_sql<'b>(&'b self, out: &mut Output<'b, '_, Pg>) -> serialize::Result {
match *self {
MessageSubType::Offer => out.write_all(b"Offer")?,
MessageSubType::Accept => out.write_all(b"Accept")?,
MessageSubType::Sign => out.write_all(b"Sign")?,
MessageSubType::SettleOffer => out.write_all(b"SettleOffer")?,
MessageSubType::SettleAccept => out.write_all(b"SettleAccept")?,
MessageSubType::SettleConfirm => out.write_all(b"SettleConfirm")?,
MessageSubType::SettleFinalize => out.write_all(b"SettleFinalize")?,
MessageSubType::RenewOffer => out.write_all(b"RenewOffer")?,
MessageSubType::RenewAccept => out.write_all(b"RenewAccept")?,
MessageSubType::RenewConfirm => out.write_all(b"RenewConfirm")?,
MessageSubType::RenewFinalize => out.write_all(b"RenewFinalize")?,
MessageSubType::RenewRevoke => out.write_all(b"RenewRevoke")?,
MessageSubType::CollaborativeCloseOffer => out.write_all(b"CollaborativeCloseOffer")?,
MessageSubType::Reject => out.write_all(b"Reject")?,
}
Ok(IsNull::No)
}
}

impl FromSql<MessageSubTypeType, Pg> for MessageSubType {
fn from_sql(bytes: PgValue<'_>) -> deserialize::Result<Self> {
match bytes.as_bytes() {
b"Offer" => Ok(MessageSubType::Offer),
b"Accept" => Ok(MessageSubType::Accept),
b"Sign" => Ok(MessageSubType::Sign),
b"SettleOffer" => Ok(MessageSubType::SettleOffer),
b"SettleAccept" => Ok(MessageSubType::SettleAccept),
b"SettleConfirm" => Ok(MessageSubType::SettleConfirm),
b"SettleFinalize" => Ok(MessageSubType::SettleFinalize),
b"RenewOffer" => Ok(MessageSubType::RenewOffer),
b"RenewAccept" => Ok(MessageSubType::RenewAccept),
b"RenewConfirm" => Ok(MessageSubType::RenewConfirm),
b"RenewFinalize" => Ok(MessageSubType::RenewFinalize),
b"RenewRevoke" => Ok(MessageSubType::RenewRevoke),
b"CollaborativeCloseOffer" => Ok(MessageSubType::CollaborativeCloseOffer),
b"Reject" => Ok(MessageSubType::Reject),
_ => Err("Unrecognized enum variant".into()),
}
}
}
209 changes: 209 additions & 0 deletions coordinator/src/db/dlc_messages.rs
Original file line number Diff line number Diff line change
@@ -0,0 +1,209 @@
use crate::schema;
use crate::schema::dlc_messages;
use crate::schema::sql_types::MessageSubTypeType;
use crate::schema::sql_types::MessageTypeType;
use anyhow::ensure;
use anyhow::Result;
use bitcoin::secp256k1::PublicKey;
use diesel::query_builder::QueryId;
use diesel::AsChangeset;
use diesel::AsExpression;
use diesel::ExpressionMethods;
use diesel::FromSqlRow;
use diesel::Insertable;
use diesel::OptionalExtension;
use diesel::PgConnection;
use diesel::QueryDsl;
use diesel::QueryResult;
use diesel::Queryable;
use diesel::QueryableByName;
use diesel::RunQueryDsl;
use std::any::TypeId;
use std::str::FromStr;
use time::OffsetDateTime;

#[derive(Debug, Clone, Copy, PartialEq, FromSqlRow, AsExpression)]
#[diesel(sql_type = MessageTypeType)]
pub(crate) enum MessageType {
OnChain,
Channel,
}

impl QueryId for MessageTypeType {
type QueryId = MessageTypeType;
const HAS_STATIC_QUERY_ID: bool = false;

fn query_id() -> Option<TypeId> {
None
}
}

#[derive(Debug, Clone, Copy, PartialEq, FromSqlRow, AsExpression)]
#[diesel(sql_type = MessageSubTypeType)]
pub(crate) enum MessageSubType {
Offer,
Accept,
Sign,
SettleOffer,
SettleAccept,
SettleConfirm,
SettleFinalize,
RenewOffer,
RenewAccept,
RenewConfirm,
RenewFinalize,
RenewRevoke,
CollaborativeCloseOffer,
Reject,
}

impl QueryId for MessageSubTypeType {
type QueryId = MessageSubTypeType;
const HAS_STATIC_QUERY_ID: bool = false;

fn query_id() -> Option<TypeId> {
None
}
}

#[derive(Insertable, QueryableByName, Queryable, Debug, Clone, PartialEq, AsChangeset)]
#[diesel(table_name = dlc_messages)]
pub(crate) struct DlcMessage {
pub message_hash: String,
pub inbound: bool,
pub peer_id: String,
pub message_type: MessageType,
pub message_sub_type: MessageSubType,
pub timestamp: OffsetDateTime,
}

pub(crate) fn get(conn: &mut PgConnection, message_hash: u64) -> QueryResult<Option<DlcMessage>> {
dlc_messages::table
.filter(dlc_messages::message_hash.eq(message_hash.to_string()))
.first::<DlcMessage>(conn)
.optional()
}

pub(crate) fn insert(
conn: &mut PgConnection,
dlc_message: ln_dlc_node::dlc_message::DlcMessage,
) -> Result<()> {
let affected_rows = diesel::insert_into(schema::dlc_messages::table)
.values(DlcMessage::from(dlc_message))
.execute(conn)?;

ensure!(affected_rows > 0, "Could not insert dlc message");

Ok(())
}

impl From<ln_dlc_node::dlc_message::DlcMessage> for DlcMessage {
fn from(value: ln_dlc_node::dlc_message::DlcMessage) -> Self {
Self {
message_hash: value.message_hash.to_string(),
peer_id: value.peer_id.to_string(),
message_type: MessageType::from(value.clone().message_type),
message_sub_type: MessageSubType::from(value.message_type),
timestamp: value.timestamp,
inbound: value.inbound,
}
}
}

impl From<ln_dlc_node::dlc_message::DlcMessageType> for MessageType {
fn from(value: ln_dlc_node::dlc_message::DlcMessageType) -> Self {
match value {
ln_dlc_node::dlc_message::DlcMessageType::OnChain(_) => Self::OnChain,
ln_dlc_node::dlc_message::DlcMessageType::Channel(_) => Self::Channel,
}
}
}

impl From<ln_dlc_node::dlc_message::DlcMessageType> for MessageSubType {
fn from(value: ln_dlc_node::dlc_message::DlcMessageType) -> Self {
let message_sub_type = match value {
ln_dlc_node::dlc_message::DlcMessageType::OnChain(message_sub_type) => message_sub_type,
ln_dlc_node::dlc_message::DlcMessageType::Channel(message_sub_type) => message_sub_type,
};
MessageSubType::from(message_sub_type)
}
}

impl From<ln_dlc_node::dlc_message::DlcMessageSubType> for MessageSubType {
fn from(value: ln_dlc_node::dlc_message::DlcMessageSubType) -> Self {
match value {
ln_dlc_node::dlc_message::DlcMessageSubType::Offer => Self::Offer,
ln_dlc_node::dlc_message::DlcMessageSubType::Accept => Self::Accept,
ln_dlc_node::dlc_message::DlcMessageSubType::Sign => Self::Sign,
ln_dlc_node::dlc_message::DlcMessageSubType::SettleOffer => Self::SettleOffer,
ln_dlc_node::dlc_message::DlcMessageSubType::SettleAccept => Self::SettleAccept,
ln_dlc_node::dlc_message::DlcMessageSubType::SettleConfirm => Self::SettleConfirm,
ln_dlc_node::dlc_message::DlcMessageSubType::SettleFinalize => Self::SettleFinalize,
ln_dlc_node::dlc_message::DlcMessageSubType::RenewOffer => Self::RenewOffer,
ln_dlc_node::dlc_message::DlcMessageSubType::RenewAccept => Self::RenewAccept,
ln_dlc_node::dlc_message::DlcMessageSubType::RenewConfirm => Self::RenewConfirm,
ln_dlc_node::dlc_message::DlcMessageSubType::RenewFinalize => Self::RenewFinalize,
ln_dlc_node::dlc_message::DlcMessageSubType::RenewRevoke => Self::RenewRevoke,
ln_dlc_node::dlc_message::DlcMessageSubType::CollaborativeCloseOffer => {
Self::CollaborativeCloseOffer
}
ln_dlc_node::dlc_message::DlcMessageSubType::Reject => Self::Reject,
}
}
}

impl From<DlcMessage> for ln_dlc_node::dlc_message::DlcMessage {
fn from(value: DlcMessage) -> Self {
let dlc_message_sub_type =
ln_dlc_node::dlc_message::DlcMessageSubType::from(value.clone().message_sub_type);
let dlc_message_type = match &value.message_type {
MessageType::OnChain => {
ln_dlc_node::dlc_message::DlcMessageType::OnChain(dlc_message_sub_type)
}
MessageType::Channel => {
ln_dlc_node::dlc_message::DlcMessageType::Channel(dlc_message_sub_type)
}
};

Self {
message_hash: u64::from_str(&value.message_hash).expect("valid u64"),
inbound: value.inbound,
message_type: dlc_message_type,
peer_id: PublicKey::from_str(&value.peer_id).expect("valid public key"),
timestamp: value.timestamp,
}
}
}

impl From<MessageSubType> for ln_dlc_node::dlc_message::DlcMessageSubType {
fn from(value: MessageSubType) -> Self {
match value {
MessageSubType::Offer => ln_dlc_node::dlc_message::DlcMessageSubType::Offer,
MessageSubType::Accept => ln_dlc_node::dlc_message::DlcMessageSubType::Accept,
MessageSubType::Sign => ln_dlc_node::dlc_message::DlcMessageSubType::Sign,
MessageSubType::SettleOffer => ln_dlc_node::dlc_message::DlcMessageSubType::SettleOffer,
MessageSubType::SettleAccept => {
ln_dlc_node::dlc_message::DlcMessageSubType::SettleAccept
}
MessageSubType::SettleConfirm => {
ln_dlc_node::dlc_message::DlcMessageSubType::SettleConfirm
}
MessageSubType::SettleFinalize => {
ln_dlc_node::dlc_message::DlcMessageSubType::SettleFinalize
}
MessageSubType::RenewOffer => ln_dlc_node::dlc_message::DlcMessageSubType::RenewOffer,
MessageSubType::RenewAccept => ln_dlc_node::dlc_message::DlcMessageSubType::RenewAccept,
MessageSubType::RenewConfirm => {
ln_dlc_node::dlc_message::DlcMessageSubType::RenewConfirm
}
MessageSubType::RenewFinalize => {
ln_dlc_node::dlc_message::DlcMessageSubType::RenewFinalize
}
MessageSubType::RenewRevoke => ln_dlc_node::dlc_message::DlcMessageSubType::RenewRevoke,
MessageSubType::CollaborativeCloseOffer => {
ln_dlc_node::dlc_message::DlcMessageSubType::CollaborativeCloseOffer
}
MessageSubType::Reject => ln_dlc_node::dlc_message::DlcMessageSubType::Reject,
}
}
}
Loading

0 comments on commit d8694b6

Please sign in to comment.