• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

payjoin / rust-payjoin / 23953420148

03 Apr 2026 04:25PM UTC coverage: 84.381% (+0.04%) from 84.34%
23953420148

Pull #1376

github

web-flow
Merge 4d37434a9 into 9ed621f78
Pull Request #1376: Guard concurrent sends with exclusive DB lock and URI/RK checks

65 of 71 new or added lines in 4 files covered. (91.55%)

7 existing lines in 1 file now uncovered.

10859 of 12869 relevant lines covered (84.38%)

410.36 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

53.92
/payjoin-cli/src/app/v2/mod.rs
1
use std::fmt;
2
use std::sync::{Arc, Mutex};
3

4
use anyhow::{anyhow, Context, Result};
5
use payjoin::bitcoin::consensus::encode::serialize_hex;
6
use payjoin::bitcoin::{Amount, FeeRate};
7
use payjoin::persist::{OptionalTransitionOutcome, SessionPersister};
8
use payjoin::receive::v2::{
9
    replay_event_log as replay_receiver_event_log, HasReplyableError, Initialized,
10
    MaybeInputsOwned, MaybeInputsSeen, Monitor, OutputsUnknown, PayjoinProposal,
11
    ProvisionalProposal, ReceiveSession, Receiver, ReceiverBuilder,
12
    SessionOutcome as ReceiverSessionOutcome, UncheckedOriginalPayload, WantsFeeRange, WantsInputs,
13
    WantsOutputs,
14
};
15
use payjoin::send::v2::{
16
    replay_event_log as replay_sender_event_log, PollingForProposal, SendSession, Sender,
17
    SenderBuilder, SessionOutcome as SenderSessionOutcome, WithReplyKey,
18
};
19
use payjoin::{ImplementationError, PjParam, Uri};
20
use tokio::sync::watch;
21

22
use super::config::Config;
23
use super::wallet::BitcoindWallet;
24
use super::App as AppTrait;
25
use crate::app::v2::ohttp::{unwrap_ohttp_keys_or_else_fetch, RelayManager};
26
use crate::app::{handle_interrupt, http_agent};
27
use crate::db::v2::{ReceiverPersister, SenderPersister, SessionId};
28
use crate::db::Database;
29

30
mod ohttp;
31

32
const W_ID: usize = 12;
33
const W_ROLE: usize = 25;
34
const W_DONE: usize = 15;
35
const W_STATUS: usize = 15;
36

37
#[derive(Clone)]
38
pub(crate) struct App {
39
    config: Config,
40
    db: Arc<Database>,
41
    wallet: BitcoindWallet,
42
    interrupt: watch::Receiver<()>,
43
    relay_manager: Arc<Mutex<RelayManager>>,
44
}
45

46
trait StatusText {
47
    fn status_text(&self) -> &'static str;
48
}
49

50
impl StatusText for SendSession {
51
    fn status_text(&self) -> &'static str {
×
52
        match self {
×
53
            SendSession::WithReplyKey(_) | SendSession::PollingForProposal(_) =>
54
                "Waiting for proposal",
×
55
            SendSession::Closed(session_outcome) => match session_outcome {
×
56
                SenderSessionOutcome::Failure => "Session failure",
×
57
                SenderSessionOutcome::Success(_) => "Session success",
×
58
                SenderSessionOutcome::Cancel => "Session cancelled",
×
59
            },
60
        }
61
    }
×
62
}
63

64
impl StatusText for ReceiveSession {
65
    fn status_text(&self) -> &'static str {
×
66
        match self {
×
67
            ReceiveSession::Initialized(_) => "Waiting for original proposal",
×
68
            ReceiveSession::UncheckedOriginalPayload(_)
69
            | ReceiveSession::MaybeInputsOwned(_)
70
            | ReceiveSession::MaybeInputsSeen(_)
71
            | ReceiveSession::OutputsUnknown(_)
72
            | ReceiveSession::WantsOutputs(_)
73
            | ReceiveSession::WantsInputs(_)
74
            | ReceiveSession::WantsFeeRange(_)
75
            | ReceiveSession::ProvisionalProposal(_) => "Processing original proposal",
×
76
            ReceiveSession::PayjoinProposal(_) => "Payjoin proposal sent",
×
77
            ReceiveSession::HasReplyableError(_) =>
78
                "Session failure, waiting to post error response",
×
79
            ReceiveSession::Monitor(_) => "Monitoring payjoin proposal",
×
80
            ReceiveSession::Closed(session_outcome) => match session_outcome {
×
81
                ReceiverSessionOutcome::Failure => "Session failure",
×
82
                ReceiverSessionOutcome::Success(_) => "Session success, Payjoin proposal was broadcasted",
×
83
                ReceiverSessionOutcome::Cancel => "Session cancelled",
×
84
                ReceiverSessionOutcome::FallbackBroadcasted => "Fallback broadcasted",
×
85
                ReceiverSessionOutcome::PayjoinProposalSent =>
86
                    "Payjoin proposal sent, skipping monitoring as the sender is spending non-SegWit inputs",
×
87
            },
88
        }
89
    }
×
90
}
91

92
fn print_header() {
×
93
    println!(
×
94
        "{:<W_ID$} {:<W_ROLE$} {:<W_DONE$} {:<W_STATUS$}",
95
        "Session ID", "Sender/Receiver", "Completed At", "Status"
96
    );
97
}
×
98

99
enum Role {
100
    Sender,
101
    Receiver,
102
}
103
impl Role {
104
    fn as_str(&self) -> &'static str {
×
105
        match self {
×
106
            Role::Sender => "Sender",
×
107
            Role::Receiver => "Receiver",
×
108
        }
109
    }
×
110
}
111

112
struct SessionHistoryRow<Status> {
113
    session_id: SessionId,
114
    role: Role,
115
    status: Status,
116
    completed_at: Option<u64>,
117
    error_message: Option<String>,
118
}
119

120
impl<Status: StatusText> fmt::Display for SessionHistoryRow<Status> {
121
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
×
122
        write!(
×
123
            f,
×
124
            "{:<W_ID$} {:<W_ROLE$} {:<W_DONE$} {:<W_STATUS$}",
125
            self.session_id.to_string(),
×
126
            self.role.as_str(),
×
127
            match self.completed_at {
×
128
                None => "Not Completed".to_string(),
×
129
                Some(secs) => {
×
130
                    // TODO: human readable time
131
                    secs.to_string()
×
132
                }
133
            },
134
            self.error_message.as_deref().unwrap_or(self.status.status_text())
×
135
        )
136
    }
×
137
}
138

139
#[async_trait::async_trait]
140
impl AppTrait for App {
141
    async fn new(config: Config) -> Result<Self> {
8✔
142
        let db = Arc::new(Database::create(&config.db_path)?);
143
        let relay_manager = Arc::new(Mutex::new(RelayManager::new()));
144
        let (interrupt_tx, interrupt_rx) = watch::channel(());
145
        tokio::spawn(handle_interrupt(interrupt_tx));
146
        let wallet = BitcoindWallet::new(&config.bitcoind).await?;
147
        let app = Self { config, db, wallet, interrupt: interrupt_rx, relay_manager };
148
        app.wallet()
149
            .network()
150
            .context("Failed to connect to bitcoind. Check config RPC connection.")?;
151
        Ok(app)
152
    }
8✔
153

154
    fn wallet(&self) -> BitcoindWallet { self.wallet.clone() }
23✔
155

156
    #[allow(clippy::incompatible_msrv)]
157
    async fn send_payjoin(&self, bip21: &str, fee_rate: FeeRate) -> Result<()> {
3✔
158
        use payjoin::UriExt;
159
        let uri = Uri::try_from(bip21)
160
            .map_err(|e| anyhow!("Failed to create URI from BIP21: {}", e))?
×
161
            .assume_checked()
162
            .check_pj_supported()
163
            .map_err(|_| anyhow!("URI does not support Payjoin"))?;
×
164
        let address = uri.address;
165
        let amount = uri.amount.ok_or_else(|| anyhow!("please specify the amount in the Uri"))?;
×
166
        match uri.extras.pj_param() {
167
            #[cfg(feature = "v1")]
168
            PjParam::V1(pj_param) => {
169
                use std::str::FromStr;
170

171
                let psbt = self.create_original_psbt(&address, amount, fee_rate)?;
172
                let (req, ctx) = payjoin::send::v1::SenderBuilder::from_parts(
173
                    psbt,
174
                    pj_param,
175
                    &address,
176
                    Some(amount),
177
                )
178
                .build_recommended(fee_rate)
179
                .with_context(|| "Failed to build payjoin request")?
180
                .create_v1_post_request();
181
                let http = http_agent(&self.config)?;
182
                let body = String::from_utf8(req.body.clone()).unwrap();
183
                println!("Sending fallback request to {}", &req.url);
184
                let response = http
185
                    .post(req.url)
186
                    .header("Content-Type", req.content_type)
187
                    .body(body.clone())
188
                    .send()
189
                    .await
190
                    .with_context(|| "HTTP request failed")?;
191
                let fallback_tx = payjoin::bitcoin::Psbt::from_str(&body)
192
                    .map_err(|e| anyhow!("Failed to load PSBT from base64: {}", e))?
×
193
                    .extract_tx()?;
194
                println!("Sent fallback transaction txid: {}", fallback_tx.compute_txid());
195
                println!(
196
                    "Sent fallback transaction hex: {:#}",
197
                    payjoin::bitcoin::consensus::encode::serialize_hex(&fallback_tx)
198
                );
199
                let psbt = ctx.process_response(&response.bytes().await?).map_err(|e| {
×
200
                    tracing::debug!("Error processing response: {e:?}");
×
201
                    anyhow!("Failed to process response {e}")
×
202
                })?;
×
203

204
                self.process_pj_response(psbt)?;
205
                Ok(())
206
            }
207
            PjParam::V2(pj_param) => {
208
                let receiver_pubkey = pj_param.receiver_pubkey();
209
                let sender_state =
210
                    self.db.get_send_session_ids()?.into_iter().find_map(|session_id| {
1✔
211
                        let session_receiver_pubkey = self
1✔
212
                            .db
1✔
213
                            .get_send_session_receiver_pk(&session_id)
1✔
214
                            .expect("Receiver pubkey should exist if session id exists");
1✔
215
                        if session_receiver_pubkey == *receiver_pubkey {
1✔
216
                            let sender_persister =
1✔
217
                                SenderPersister::from_id(self.db.clone(), session_id);
1✔
218
                            let (send_session, _) = replay_sender_event_log(&sender_persister)
1✔
219
                                .map_err(|e| anyhow!("Failed to replay sender event log: {:?}", e))
1✔
220
                                .ok()?;
1✔
221

222
                            Some((send_session, sender_persister))
1✔
223
                        } else {
224
                            None
×
225
                        }
226
                    });
1✔
227

228
                let (sender_state, persister) = match sender_state {
229
                    Some((sender_state, persister)) => (sender_state, persister),
230
                    None => {
231
                        let persister =
232
                            SenderPersister::new(self.db.clone(), bip21, receiver_pubkey)?;
233
                        let psbt = self.create_original_psbt(&address, amount, fee_rate)?;
234
                        let sender =
235
                            SenderBuilder::from_parts(psbt, pj_param, &address, Some(amount))
236
                                .build_recommended(fee_rate)?
237
                                .save(&persister)?;
238

239
                        (SendSession::WithReplyKey(sender), persister)
240
                    }
241
                };
242
                let mut interrupt = self.interrupt.clone();
243
                tokio::select! {
244
                    _ = self.process_sender_session(sender_state, &persister) => return Ok(()),
245
                    _ = interrupt.changed() => {
246
                        println!("Interrupted. Call `send` with the same arguments to resume this session or `resume` to resume all sessions.");
247
                        return Err(anyhow!("Interrupted"))
248
                    }
249
                }
250
            }
251
            _ => unimplemented!("Unrecognized payjoin version"),
252
        }
253
    }
3✔
254

255
    async fn receive_payjoin(&self, amount: Amount) -> Result<()> {
1✔
256
        let address = self.wallet().get_new_address()?;
257
        let ohttp_keys =
258
            unwrap_ohttp_keys_or_else_fetch(&self.config, None, self.relay_manager.clone())
259
                .await?
260
                .ohttp_keys;
261
        let persister = ReceiverPersister::new(self.db.clone())?;
262
        let session =
263
            ReceiverBuilder::new(address, self.config.v2()?.pj_directory.as_str(), ohttp_keys)?
264
                .with_amount(amount)
265
                .with_max_fee_rate(self.config.max_fee_rate.unwrap_or(FeeRate::BROADCAST_MIN))
266
                .build()
267
                .save(&persister)?;
268

269
        println!("Receive session established");
270
        let pj_uri = session.pj_uri();
271
        println!("Request Payjoin by sharing this Payjoin Uri:");
272
        println!("{pj_uri}");
273

274
        self.process_receiver_session(ReceiveSession::Initialized(session.clone()), &persister)
275
            .await?;
276
        Ok(())
277
    }
1✔
278

279
    #[allow(clippy::incompatible_msrv)]
280
    async fn resume_payjoins(&self) -> Result<()> {
4✔
281
        let recv_session_ids = self.db.get_recv_session_ids()?;
282
        let send_session_ids = self.db.get_send_session_ids()?;
283

284
        if recv_session_ids.is_empty() && send_session_ids.is_empty() {
285
            println!("No sessions to resume.");
286
            return Ok(());
287
        }
288

289
        let mut tasks = Vec::new();
290

291
        // Process receiver sessions
292
        for session_id in recv_session_ids {
293
            let self_clone = self.clone();
294
            let recv_persister = ReceiverPersister::from_id(self.db.clone(), session_id.clone());
295
            match replay_receiver_event_log(&recv_persister) {
296
                Ok((receiver_state, _)) => {
297
                    tasks.push(tokio::spawn(async move {
2✔
298
                        self_clone.process_receiver_session(receiver_state, &recv_persister).await
2✔
299
                    }));
1✔
300
                }
301
                Err(e) => {
302
                    tracing::error!("An error {:?} occurred while replaying receiver session", e);
303
                    Self::close_failed_session(&recv_persister, &session_id, "receiver");
304
                }
305
            }
306
        }
307

308
        // Process sender sessions
309
        for session_id in send_session_ids {
310
            let sender_persister = SenderPersister::from_id(self.db.clone(), session_id.clone());
311
            match replay_sender_event_log(&sender_persister) {
312
                Ok((sender_state, _)) => {
313
                    let self_clone = self.clone();
314
                    tasks.push(tokio::spawn(async move {
×
NEW
315
                        self_clone.process_sender_session(sender_state, &sender_persister).await
×
316
                    }));
×
317
                }
318
                Err(e) => {
319
                    tracing::error!("An error {:?} occurred while replaying Sender session", e);
320
                    Self::close_failed_session(&sender_persister, &session_id, "sender");
321
                }
322
            }
323
        }
324

325
        let mut interrupt = self.interrupt.clone();
326
        tokio::select! {
327
            _ = async {
2✔
328
                for task in tasks {
2✔
329
                    let _ = task.await;
2✔
330
                }
331
            } => {
1✔
332
                println!("All resumed sessions completed.");
333
            }
334
            _ = interrupt.changed() => {
335
                println!("Resumed sessions were interrupted.");
336
            }
337
        }
338
        Ok(())
339
    }
4✔
340

341
    #[cfg(feature = "v2")]
342
    async fn history(&self) -> Result<()> {
×
343
        print_header();
344
        let mut send_rows = vec![];
345
        let mut recv_rows = vec![];
346
        self.db.get_send_session_ids()?.into_iter().for_each(|session_id| {
×
347
            let persister = SenderPersister::from_id(self.db.clone(), session_id.clone());
×
348
            match replay_sender_event_log(&persister) {
×
349
                Ok((sender_state, _)) => {
×
350
                    let row = SessionHistoryRow {
×
351
                        session_id,
×
352
                        role: Role::Sender,
×
353
                        status: sender_state.clone(),
×
354
                        completed_at: None,
×
355
                        error_message: None,
×
356
                    };
×
357
                    send_rows.push(row);
×
358
                }
×
359
                Err(e) => {
×
360
                    let row = SessionHistoryRow {
×
361
                        session_id,
×
362
                        role: Role::Sender,
×
363
                        status: SendSession::Closed(SenderSessionOutcome::Failure),
×
364
                        completed_at: None,
×
365
                        error_message: Some(e.to_string()),
×
366
                    };
×
367
                    send_rows.push(row);
×
368
                }
×
369
            }
370
        });
×
371

372
        self.db.get_recv_session_ids()?.into_iter().for_each(|session_id| {
×
373
            let persister = ReceiverPersister::from_id(self.db.clone(), session_id.clone());
×
374
            match replay_receiver_event_log(&persister) {
×
375
                Ok((receiver_state, _)) => {
×
376
                    let row = SessionHistoryRow {
×
377
                        session_id,
×
378
                        role: Role::Receiver,
×
379
                        status: receiver_state.clone(),
×
380
                        completed_at: None,
×
381
                        error_message: None,
×
382
                    };
×
383
                    recv_rows.push(row);
×
384
                }
×
385
                Err(e) => {
×
386
                    let row = SessionHistoryRow {
×
387
                        session_id,
×
388
                        role: Role::Receiver,
×
389
                        status: ReceiveSession::Closed(ReceiverSessionOutcome::Failure),
×
390
                        completed_at: None,
×
391
                        error_message: Some(e.to_string()),
×
392
                    };
×
393
                    recv_rows.push(row);
×
394
                }
×
395
            }
396
        });
×
397

398
        self.db.get_inactive_send_session_ids()?.into_iter().for_each(
399
            |(session_id, completed_at)| {
×
400
                let persister = SenderPersister::from_id(self.db.clone(), session_id.clone());
×
401
                match replay_sender_event_log(&persister) {
×
402
                    Ok((sender_state, _)) => {
×
403
                        let row = SessionHistoryRow {
×
404
                            session_id,
×
405
                            role: Role::Sender,
×
406
                            status: sender_state.clone(),
×
407
                            completed_at: Some(completed_at),
×
408
                            error_message: None,
×
409
                        };
×
410
                        send_rows.push(row);
×
411
                    }
×
412
                    Err(e) => {
×
413
                        let row = SessionHistoryRow {
×
414
                            session_id,
×
415
                            role: Role::Sender,
×
416
                            status: SendSession::Closed(SenderSessionOutcome::Failure),
×
417
                            completed_at: Some(completed_at),
×
418
                            error_message: Some(e.to_string()),
×
419
                        };
×
420
                        send_rows.push(row);
×
421
                    }
×
422
                }
423
            },
×
424
        );
425

426
        self.db.get_inactive_recv_session_ids()?.into_iter().for_each(
427
            |(session_id, completed_at)| {
×
428
                let persister = ReceiverPersister::from_id(self.db.clone(), session_id.clone());
×
429
                match replay_receiver_event_log(&persister) {
×
430
                    Ok((receiver_state, _)) => {
×
431
                        let row = SessionHistoryRow {
×
432
                            session_id,
×
433
                            role: Role::Receiver,
×
434
                            status: receiver_state.clone(),
×
435
                            completed_at: Some(completed_at),
×
436
                            error_message: None,
×
437
                        };
×
438
                        recv_rows.push(row);
×
439
                    }
×
440
                    Err(e) => {
×
441
                        let row = SessionHistoryRow {
×
442
                            session_id,
×
443
                            role: Role::Receiver,
×
444
                            status: ReceiveSession::Closed(ReceiverSessionOutcome::Failure),
×
445
                            completed_at: Some(completed_at),
×
446
                            error_message: Some(e.to_string()),
×
447
                        };
×
448
                        recv_rows.push(row);
×
449
                    }
×
450
                }
451
            },
×
452
        );
453

454
        // Print receiver and sender rows separately
455
        for row in send_rows {
456
            println!("{row}");
457
        }
458
        for row in recv_rows {
459
            println!("{row}");
460
        }
461

462
        Ok(())
463
    }
×
464
}
465

466
impl App {
467
    fn close_failed_session<P>(persister: &P, session_id: &SessionId, role: &str)
×
468
    where
×
469
        P: SessionPersister,
×
470
    {
471
        if let Err(close_err) = SessionPersister::close(persister) {
×
472
            tracing::error!("Failed to close {} session {}: {:?}", role, session_id, close_err);
×
473
        } else {
474
            tracing::error!("Closed failed {} session: {}", role, session_id);
×
475
        }
476
    }
×
477

478
    async fn process_sender_session(
2✔
479
        &self,
2✔
480
        session: SendSession,
2✔
481
        persister: &SenderPersister,
2✔
482
    ) -> Result<()> {
2✔
483
        match session {
×
484
            SendSession::WithReplyKey(context) =>
1✔
485
                self.post_original_proposal(context, persister).await?,
1✔
486
            SendSession::PollingForProposal(context) =>
1✔
487
                self.get_proposed_payjoin_psbt(context, persister).await?,
1✔
488
            SendSession::Closed(SenderSessionOutcome::Success(proposal)) => {
×
489
                self.process_pj_response(proposal)?;
×
490
                return Ok(());
×
491
            }
492
            _ => return Err(anyhow!("Unexpected sender state")),
×
493
        }
494
        Ok(())
1✔
495
    }
1✔
496

497
    async fn post_original_proposal(
1✔
498
        &self,
1✔
499
        sender: Sender<WithReplyKey>,
1✔
500
        persister: &SenderPersister,
1✔
501
    ) -> Result<()> {
1✔
502
        let (req, ctx) = sender.create_v2_post_request(
1✔
503
            self.unwrap_relay_or_else_fetch(Some(&sender.endpoint())).await?.as_str(),
1✔
504
        )?;
×
505
        let response = self.post_request(req).await?;
1✔
506
        println!("Posted original proposal...");
1✔
507
        let sender = sender.process_response(&response.bytes().await?, ctx).save(persister)?;
1✔
508
        self.get_proposed_payjoin_psbt(sender, persister).await
1✔
509
    }
×
510

511
    async fn get_proposed_payjoin_psbt(
2✔
512
        &self,
2✔
513
        sender: Sender<PollingForProposal>,
2✔
514
        persister: &SenderPersister,
2✔
515
    ) -> Result<()> {
2✔
516
        let ohttp_relay = self.unwrap_relay_or_else_fetch(Some(&sender.endpoint())).await?;
2✔
517
        let mut session = sender.clone();
2✔
518
        // Long poll until we get a response
519
        loop {
520
            let (req, ctx) = session.create_poll_request(ohttp_relay.as_str())?;
3✔
521
            let response = self.post_request(req).await?;
3✔
522
            let res = session.process_response(&response.bytes().await?, ctx).save(persister);
2✔
523
            match res {
2✔
524
                Ok(OptionalTransitionOutcome::Progress(psbt)) => {
1✔
525
                    println!("Proposal received. Processing...");
1✔
526
                    self.process_pj_response(psbt)?;
1✔
527
                    return Ok(());
1✔
528
                }
529
                Ok(OptionalTransitionOutcome::Stasis(current_state)) => {
1✔
530
                    println!("No response yet.");
1✔
531
                    session = current_state;
1✔
532
                    continue;
1✔
533
                }
534
                Err(re) => {
×
535
                    println!("{re}");
×
536
                    tracing::debug!("{re:?}");
×
537
                    return Err(anyhow!("Response error").context(re));
×
538
                }
539
            }
540
        }
541
    }
1✔
542

543
    async fn long_poll_fallback(
2✔
544
        &self,
2✔
545
        session: Receiver<Initialized>,
2✔
546
        persister: &ReceiverPersister,
2✔
547
    ) -> Result<Receiver<UncheckedOriginalPayload>> {
2✔
548
        let ohttp_relay =
2✔
549
            self.unwrap_relay_or_else_fetch(Some(&session.pj_uri().extras.endpoint())).await?;
2✔
550

551
        let mut session = session;
2✔
552
        loop {
553
            let (req, context) = session.create_poll_request(ohttp_relay.as_str())?;
2✔
554
            println!("Polling receive request...");
2✔
555
            let ohttp_response = self.post_request(req).await?;
2✔
556
            let state_transition = session
1✔
557
                .process_response(ohttp_response.bytes().await?.to_vec().as_slice(), context)
1✔
558
                .save(persister);
1✔
559
            match state_transition {
1✔
560
                Ok(OptionalTransitionOutcome::Progress(next_state)) => {
1✔
561
                    println!("Got a request from the sender. Responding with a Payjoin proposal.");
1✔
562
                    return Ok(next_state);
1✔
563
                }
564
                Ok(OptionalTransitionOutcome::Stasis(current_state)) => {
×
565
                    session = current_state;
×
566
                    continue;
×
567
                }
568
                Err(e) => return Err(e.into()),
×
569
            }
570
        }
571
    }
1✔
572

573
    async fn process_receiver_session(
3✔
574
        &self,
3✔
575
        session: ReceiveSession,
3✔
576
        persister: &ReceiverPersister,
3✔
577
    ) -> Result<()> {
3✔
578
        let res = {
2✔
579
            match session {
3✔
580
                ReceiveSession::Initialized(proposal) =>
2✔
581
                    self.read_from_directory(proposal, persister).await,
2✔
582
                ReceiveSession::UncheckedOriginalPayload(proposal) =>
×
583
                    self.check_proposal(proposal, persister).await,
×
584
                ReceiveSession::MaybeInputsOwned(proposal) =>
×
585
                    self.check_inputs_not_owned(proposal, persister).await,
×
586
                ReceiveSession::MaybeInputsSeen(proposal) =>
×
587
                    self.check_no_inputs_seen_before(proposal, persister).await,
×
588
                ReceiveSession::OutputsUnknown(proposal) =>
×
589
                    self.identify_receiver_outputs(proposal, persister).await,
×
590
                ReceiveSession::WantsOutputs(proposal) =>
×
591
                    self.commit_outputs(proposal, persister).await,
×
592
                ReceiveSession::WantsInputs(proposal) =>
×
593
                    self.contribute_inputs(proposal, persister).await,
×
594
                ReceiveSession::WantsFeeRange(proposal) =>
×
595
                    self.apply_fee_range(proposal, persister).await,
×
596
                ReceiveSession::ProvisionalProposal(proposal) =>
×
597
                    self.finalize_proposal(proposal, persister).await,
×
598
                ReceiveSession::PayjoinProposal(proposal) =>
×
599
                    self.send_payjoin_proposal(proposal, persister).await,
×
600
                ReceiveSession::HasReplyableError(error) =>
×
601
                    self.handle_error(error, persister).await,
×
602
                ReceiveSession::Monitor(proposal) =>
1✔
603
                    self.monitor_payjoin_proposal(proposal, persister).await,
1✔
604
                ReceiveSession::Closed(_) => return Err(anyhow!("Session closed")),
×
605
            }
606
        };
607
        res
2✔
608
    }
2✔
609

610
    #[allow(clippy::incompatible_msrv)]
611
    async fn read_from_directory(
2✔
612
        &self,
2✔
613
        session: Receiver<Initialized>,
2✔
614
        persister: &ReceiverPersister,
2✔
615
    ) -> Result<()> {
2✔
616
        let mut interrupt = self.interrupt.clone();
2✔
617
        let receiver = tokio::select! {
2✔
618
            res = self.long_poll_fallback(session, persister) => res,
2✔
619
            _ = interrupt.changed() => {
2✔
620
                println!("Interrupted. Call the `resume` command to resume all sessions.");
1✔
621
                return Err(anyhow!("Interrupted"));
1✔
622
            }
623
        }?;
×
624
        self.check_proposal(receiver, persister).await
1✔
625
    }
1✔
626

627
    async fn check_proposal(
1✔
628
        &self,
1✔
629
        proposal: Receiver<UncheckedOriginalPayload>,
1✔
630
        persister: &ReceiverPersister,
1✔
631
    ) -> Result<()> {
1✔
632
        let wallet = self.wallet();
1✔
633
        let proposal = proposal
1✔
634
            .check_broadcast_suitability(None, |tx| {
1✔
635
                wallet
1✔
636
                    .can_broadcast(tx)
1✔
637
                    .map_err(|e| ImplementationError::from(e.into_boxed_dyn_error()))
1✔
638
            })
1✔
639
            .save(persister)?;
1✔
640

641
        println!("Fallback transaction received. Consider broadcasting this to get paid if the Payjoin fails:");
1✔
642
        println!("{}", serialize_hex(&proposal.extract_tx_to_schedule_broadcast()));
1✔
643
        self.check_inputs_not_owned(proposal, persister).await
1✔
644
    }
×
645

646
    async fn check_inputs_not_owned(
1✔
647
        &self,
1✔
648
        proposal: Receiver<MaybeInputsOwned>,
1✔
649
        persister: &ReceiverPersister,
1✔
650
    ) -> Result<()> {
1✔
651
        let wallet = self.wallet();
1✔
652
        let proposal = proposal
1✔
653
            .check_inputs_not_owned(&mut |input| {
1✔
654
                wallet
1✔
655
                    .is_mine(input)
1✔
656
                    .map_err(|e| ImplementationError::from(e.into_boxed_dyn_error()))
1✔
657
            })
1✔
658
            .save(persister)?;
1✔
659
        self.check_no_inputs_seen_before(proposal, persister).await
1✔
660
    }
×
661

662
    async fn check_no_inputs_seen_before(
1✔
663
        &self,
1✔
664
        proposal: Receiver<MaybeInputsSeen>,
1✔
665
        persister: &ReceiverPersister,
1✔
666
    ) -> Result<()> {
1✔
667
        let proposal = proposal
1✔
668
            .check_no_inputs_seen_before(&mut |input| {
1✔
669
                Ok(self.db.insert_input_seen_before(*input)?)
1✔
670
            })
1✔
671
            .save(persister)?;
1✔
672
        self.identify_receiver_outputs(proposal, persister).await
1✔
673
    }
×
674

675
    async fn identify_receiver_outputs(
1✔
676
        &self,
1✔
677
        proposal: Receiver<OutputsUnknown>,
1✔
678
        persister: &ReceiverPersister,
1✔
679
    ) -> Result<()> {
1✔
680
        let wallet = self.wallet();
1✔
681
        let proposal = proposal
1✔
682
            .identify_receiver_outputs(&mut |output_script| {
2✔
683
                wallet
2✔
684
                    .is_mine(output_script)
2✔
685
                    .map_err(|e| ImplementationError::from(e.into_boxed_dyn_error()))
2✔
686
            })
2✔
687
            .save(persister)?;
1✔
688
        self.commit_outputs(proposal, persister).await
1✔
689
    }
×
690

691
    async fn commit_outputs(
1✔
692
        &self,
1✔
693
        proposal: Receiver<WantsOutputs>,
1✔
694
        persister: &ReceiverPersister,
1✔
695
    ) -> Result<()> {
1✔
696
        let proposal = proposal.commit_outputs().save(persister)?;
1✔
697
        self.contribute_inputs(proposal, persister).await
1✔
698
    }
×
699

700
    async fn contribute_inputs(
1✔
701
        &self,
1✔
702
        proposal: Receiver<WantsInputs>,
1✔
703
        persister: &ReceiverPersister,
1✔
704
    ) -> Result<()> {
1✔
705
        let wallet = self.wallet();
1✔
706
        let candidate_inputs = wallet.list_unspent()?;
1✔
707

708
        if candidate_inputs.is_empty() {
1✔
709
            return Err(anyhow::anyhow!(
×
710
                "No spendable UTXOs available in wallet. Cannot contribute inputs to payjoin."
×
711
            ));
×
712
        }
1✔
713

714
        let selected_input = proposal.try_preserving_privacy(candidate_inputs)?;
1✔
715
        let proposal =
1✔
716
            proposal.contribute_inputs(vec![selected_input])?.commit_inputs().save(persister)?;
1✔
717
        self.apply_fee_range(proposal, persister).await
1✔
718
    }
×
719

720
    async fn apply_fee_range(
1✔
721
        &self,
1✔
722
        proposal: Receiver<WantsFeeRange>,
1✔
723
        persister: &ReceiverPersister,
1✔
724
    ) -> Result<()> {
1✔
725
        let proposal = proposal.apply_fee_range(None, self.config.max_fee_rate).save(persister)?;
1✔
726
        self.finalize_proposal(proposal, persister).await
1✔
727
    }
×
728

729
    async fn finalize_proposal(
1✔
730
        &self,
1✔
731
        proposal: Receiver<ProvisionalProposal>,
1✔
732
        persister: &ReceiverPersister,
1✔
733
    ) -> Result<()> {
1✔
734
        let wallet = self.wallet();
1✔
735
        let proposal = proposal
1✔
736
            .finalize_proposal(|psbt| {
1✔
737
                wallet
1✔
738
                    .process_psbt(psbt)
1✔
739
                    .map_err(|e| ImplementationError::from(e.into_boxed_dyn_error()))
1✔
740
            })
1✔
741
            .save(persister)?;
1✔
742
        self.send_payjoin_proposal(proposal, persister).await
1✔
743
    }
×
744

745
    async fn send_payjoin_proposal(
1✔
746
        &self,
1✔
747
        proposal: Receiver<PayjoinProposal>,
1✔
748
        persister: &ReceiverPersister,
1✔
749
    ) -> Result<()> {
1✔
750
        let (req, ohttp_ctx) = proposal
1✔
751
            .create_post_request(self.unwrap_relay_or_else_fetch(None::<&str>).await?.as_str())
1✔
752
            .map_err(|e| anyhow!("v2 req extraction failed {}", e))?;
1✔
753
        let res = self.post_request(req).await?;
1✔
754
        let payjoin_psbt = proposal.psbt().clone();
1✔
755
        let session = proposal.process_response(&res.bytes().await?, ohttp_ctx).save(persister)?;
1✔
756
        println!(
1✔
757
            "Response successful. Watch mempool for successful Payjoin. TXID: {}",
758
            payjoin_psbt.extract_tx_unchecked_fee_rate().compute_txid()
1✔
759
        );
760

761
        return self.monitor_payjoin_proposal(session, persister).await;
1✔
762
    }
×
763

764
    async fn monitor_payjoin_proposal(
2✔
765
        &self,
2✔
766
        proposal: Receiver<Monitor>,
2✔
767
        persister: &ReceiverPersister,
2✔
768
    ) -> Result<()> {
2✔
769
        // On a session resumption, the receiver will resume again in this state.
770
        let poll_interval = tokio::time::Duration::from_millis(200);
2✔
771
        let timeout_duration = tokio::time::Duration::from_secs(5);
2✔
772

773
        let mut interval = tokio::time::interval(poll_interval);
2✔
774
        interval.tick().await;
2✔
775

776
        tracing::debug!("Polling for payment confirmation");
2✔
777

778
        let result = tokio::time::timeout(timeout_duration, async {
2✔
779
            loop {
780
                interval.tick().await;
2✔
781
                let check_result = proposal
1✔
782
                    .check_payment(|txid| {
1✔
783
                        self.wallet()
1✔
784
                            .get_raw_transaction(&txid)
1✔
785
                            .map_err(|e| ImplementationError::from(e.into_boxed_dyn_error()))
1✔
786
                    })
1✔
787
                    .save(persister);
1✔
788

789
                match check_result {
1✔
790
                    Ok(_) => {
791
                        println!("Payjoin transaction detected in the mempool!");
1✔
792
                        return Ok(());
1✔
793
                    }
794
                    Err(_) => {
795
                        // keep polling
796

797
                        continue;
×
798
                    }
799
                }
800
            }
801
        })
1✔
802
        .await;
2✔
803

804
        match result {
1✔
805
            Ok(ok) => ok,
1✔
806
            Err(_) => Err(anyhow!(
×
807
                "Timeout waiting for payment confirmation after {:?}",
×
808
                timeout_duration
×
809
            )),
×
810
        }
811
    }
1✔
812

813
    async fn unwrap_relay_or_else_fetch(
6✔
814
        &self,
6✔
815
        directory: Option<impl payjoin::IntoUrl>,
6✔
816
    ) -> Result<url::Url> {
6✔
817
        let directory = directory.map(|url| url.into_url()).transpose()?;
6✔
818
        let selected_relay =
6✔
819
            self.relay_manager.lock().expect("Lock should not be poisoned").get_selected_relay();
6✔
820
        let ohttp_relay = match selected_relay {
6✔
821
            Some(relay) => relay,
3✔
822
            None =>
823
                unwrap_ohttp_keys_or_else_fetch(&self.config, directory, self.relay_manager.clone())
3✔
824
                    .await?
3✔
825
                    .relay_url,
826
        };
827
        Ok(ohttp_relay)
6✔
828
    }
6✔
829

830
    /// Handle error by attempting to send an error response over the directory
831
    async fn handle_error(
×
832
        &self,
×
833
        session: Receiver<HasReplyableError>,
×
834
        persister: &ReceiverPersister,
×
835
    ) -> Result<()> {
×
836
        let (err_req, err_ctx) = session
×
837
            .create_error_request(self.unwrap_relay_or_else_fetch(None::<&str>).await?.as_str())?;
×
838

839
        let err_response = match self.post_request(err_req).await {
×
840
            Ok(response) => response,
×
841
            Err(e) => return Err(anyhow!("Failed to post error request: {}", e)),
×
842
        };
843

844
        let err_bytes = match err_response.bytes().await {
×
845
            Ok(bytes) => bytes,
×
846
            Err(e) => return Err(anyhow!("Failed to get error response bytes: {}", e)),
×
847
        };
848

849
        if let Err(e) = session.process_error_response(&err_bytes, err_ctx).save(persister) {
×
850
            return Err(anyhow!("Failed to process error response: {}", e));
×
851
        }
×
852

853
        Ok(())
×
854
    }
×
855

856
    async fn post_request(&self, req: payjoin::Request) -> Result<reqwest::Response> {
7✔
857
        let http = http_agent(&self.config)?;
7✔
858
        http.post(req.url)
7✔
859
            .header("Content-Type", req.content_type)
7✔
860
            .body(req.body)
7✔
861
            .send()
7✔
862
            .await
7✔
863
            .map_err(map_reqwest_err)
5✔
864
    }
5✔
865
}
866

867
fn map_reqwest_err(e: reqwest::Error) -> anyhow::Error {
×
868
    match e.status() {
×
869
        Some(status_code) => anyhow!("HTTP request failed: {} {}", status_code, e),
×
870
        None => anyhow!("No HTTP response: {}", e),
×
871
    }
872
}
×
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc