fedimint_load_test_tool/

main.rs

#![deny(clippy::pedantic)]
#![allow(clippy::cast_possible_truncation)]
#![allow(clippy::cast_precision_loss)]
#![allow(clippy::missing_errors_doc)]
#![allow(clippy::ref_option)]
#![allow(clippy::too_many_lines)]
#![allow(clippy::large_futures)]

use std::collections::{BTreeMap, HashMap};
use std::path::PathBuf;
use std::str::FromStr;
use std::time::Duration;
use std::vec;

use anyhow::{Context, anyhow, bail};
use clap::{Args, Parser, Subcommand, ValueEnum};
use common::{
    gateway_pay_invoice, get_note_summary, ldk_create_invoice, ldk_pay_invoice,
    ldk_wait_invoice_payment, parse_gateway_id, reissue_notes,
};
use devimint::cmd;
use devimint::util::GatewayLndCli;
use devimint::version_constants::VERSION_0_10_0_ALPHA;
use fedimint_api_client::download_from_invite_code;
use fedimint_client::ClientHandleArc;
use fedimint_connectors::ConnectorRegistry;
use fedimint_core::Amount;
use fedimint_core::endpoint_constants::SESSION_COUNT_ENDPOINT;
use fedimint_core::invite_code::InviteCode;
use fedimint_core::module::ApiRequestErased;
use fedimint_core::runtime::spawn;
use fedimint_core::util::{BoxFuture, SafeUrl};
use fedimint_ln_client::{LightningClientModule, LnReceiveState};
use fedimint_ln_common::LightningGateway;
use fedimint_mint_client::OOBNotes;
use futures::StreamExt;
use lightning_invoice::{Bolt11Invoice, Bolt11InvoiceDescription, Description};
use serde::{Deserialize, Serialize};
use tokio::fs::OpenOptions;
use tokio::io::{AsyncBufReadExt, AsyncWriteExt, BufWriter};
use tokio::sync::mpsc;
use tracing::{debug, info, warn};

use crate::common::{
    build_client, do_spend_notes, get_invite_code_cli, remint_denomination, try_get_notes_cli,
};
pub mod common;
#[cfg(test)]
mod tests;

#[derive(Parser, Clone)]
#[command(version)]
struct Opts {
    #[arg(
        long,
        default_value = "10",
        help = "Number of users. Each user will work in parallel"
    )]
    users: u16,

    #[arg(long, help = "Output with the metrics results in JSON format")]
    metrics_json_output: Option<PathBuf>,

    #[arg(
        long,
        help = "If given, will be used to store and retrieve past metrics for comparison purposes"
    )]
    archive_dir: Option<PathBuf>,

    #[clap(subcommand)]
    command: Command,
}

#[derive(Debug, Clone, Copy, ValueEnum)]
enum LnInvoiceGeneration {
    LdkLightningCli,
}

#[derive(Subcommand, Clone)]
enum Command {
    #[command(about = "Keep many websocket connections to a federation for a duration of time")]
    TestConnect {
        #[arg(long, help = "Federation invite code")]
        invite_code: String,
        #[arg(
            long,
            default_value = "60",
            help = "How much time to keep the connections open, in seconds"
        )]
        duration_secs: u64,
        #[arg(
            long,
            default_value = "120",
            help = "Timeout for connection attempt and for each request, in secnods"
        )]
        timeout_secs: u64,
        #[arg(
            long,
            help = "If given, will limit the number of endpoints (guardians) to connect to"
        )]
        limit_endpoints: Option<usize>,
    },
    #[command(about = "Try to download the client config many times.")]
    TestDownload {
        #[arg(long, help = "Federation invite code")]
        invite_code: String,
    },
    #[command(
        about = "Run a load test where many users in parallel will try to reissue notes and pay invoices through the gateway"
    )]
    LoadTest(LoadTestArgs),
    /// Run a load test where many users in parallel will receive then send a
    /// payment through lightning.
    /// It's 'circular' because the funds always come back to the same user then
    /// we can keep making the payments in a loop
    #[command()]
    LnCircularLoadTest(LnCircularLoadTestArgs),
}

#[derive(Args, Clone)]
struct LoadTestArgs {
    #[arg(
        long,
        help = "Federation invite code. If none given, we assume the client already has a config downloaded in DB"
    )]
    invite_code: Option<InviteCode>,

    #[arg(
        long,
        help = "Notes for the test. If none and no funds on archive, will call fedimint-cli spend"
    )]
    initial_notes: Option<OOBNotes>,

    #[arg(
        long,
        help = "Gateway Id. If none, retrieve one according to --generate-invoice-with"
    )]
    gateway_id: Option<String>,

    #[arg(
        long,
        help = "The method used to generate invoices to be paid through the gateway. If none and no --invoices-file provided, no gateway/LN tests will be run. Note that you can't generate an invoice using the same lightning node used by the gateway (i.e self payment is forbidden)"
    )]
    generate_invoice_with: Option<LnInvoiceGeneration>,

    #[arg(
        long,
        default_value = "1",
        help = "How many invoices will be created for each user. Only applicable if --generate-invoice-with is provided"
    )]
    invoices_per_user: u16,

    #[arg(
        long,
        default_value = "0",
        help = "How many seconds to sleep between LN payments"
    )]
    ln_payment_sleep_secs: u64,

    #[arg(
        long,
        help = "A text file with one invoice per line. If --generate-invoice-with is provided, these will be additional invoices to be paid"
    )]
    invoices_file: Option<PathBuf>,

    #[arg(
        long,
        help = "How many notes to distribute to each user",
        default_value = "2"
    )]
    notes_per_user: u16,

    #[arg(
        long,
        help = "Note denomination to use for the test",
        default_value = "1024"
    )]
    note_denomination: Amount,

    #[arg(
        long,
        help = "Invoice amount when generating one",
        default_value = "1000"
    )]
    invoice_amount: Amount,
}

#[derive(Args, Clone)]
struct LnCircularLoadTestArgs {
    #[arg(
        long,
        help = "Federation invite code. If none given, we assume the client already has a config downloaded in DB"
    )]
    invite_code: Option<InviteCode>,

    #[arg(
        long,
        help = "Notes for the test. If none and no funds on archive, will call fedimint-cli spend"
    )]
    initial_notes: Option<OOBNotes>,

    #[arg(
        long,
        default_value = "60",
        help = "For how many seconds to run the test"
    )]
    test_duration_secs: u64,

    #[arg(
        long,
        default_value = "0",
        help = "How many seconds to sleep between LN payments"
    )]
    ln_payment_sleep_secs: u64,

    #[arg(
        long,
        help = "How many notes to distribute to each user",
        default_value = "1"
    )]
    notes_per_user: u16,

    #[arg(
        long,
        help = "Note denomination to use for the test",
        default_value = "1024"
    )]
    note_denomination: Amount,

    #[arg(
        long,
        help = "Invoice amount when generating one",
        default_value = "1000"
    )]
    invoice_amount: Amount,

    #[arg(long)]
    strategy: LnCircularStrategy,
}

#[derive(Debug, Clone, Copy, ValueEnum)]
enum LnCircularStrategy {
    /// The user will pay its own invoice
    SelfPayment,
    /// One gateway will pay/receive to/from the other, then they will swap
    /// places
    TwoGateways,
    /// Two clients will pay to each other using the same gateway
    PartnerPingPong,
}

#[derive(Debug, Clone)]
pub struct MetricEvent {
    name: String,
    duration: Duration,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
struct EventMetricSummary {
    name: String,
    users: u64,
    n: u64,
    avg_ms: u128,
    median_ms: u128,
    max_ms: u128,
    min_ms: u128,
    timestamp_seconds: u64,
}

#[derive(Debug, Serialize, Deserialize)]
struct EventMetricComparison {
    avg_ms_gain: f64,
    median_ms_gain: f64,
    max_ms_gain: f64,
    min_ms_gain: f64,
    current: EventMetricSummary,
    previous: EventMetricSummary,
}

impl std::fmt::Display for EventMetricComparison {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        fn to_percent(gain: f64) -> String {
            if gain >= 1.0 {
                format!("+{:.2}%", (gain - 1.0) * 100.0)
            } else {
                format!("-{:.2}%", (1.0 - gain) * 100.0)
            }
        }
        f.write_str(&format!(
            "avg: {}, median: {}, max: {}, min: {}",
            to_percent(self.avg_ms_gain),
            to_percent(self.median_ms_gain),
            to_percent(self.max_ms_gain),
            to_percent(self.min_ms_gain),
        ))
    }
}

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    fedimint_logging::TracingSetup::default().init()?;
    let opts = Opts::parse();
    validate_total_notes(&opts)?;
    let (event_sender, event_receiver) = tokio::sync::mpsc::unbounded_channel();
    let summary_handle = spawn("handle metrics summary", {
        let opts = opts.clone();
        async { handle_metrics_summary(opts, event_receiver).await }
    });
    let futures = match opts.command.clone() {
        Command::TestConnect {
            invite_code,
            duration_secs,
            timeout_secs,
            limit_endpoints,
        } => {
            let connectors = ConnectorRegistry::build_from_client_env().bind().await;
            let invite_code = InviteCode::from_str(&invite_code).context("invalid invite code")?;
            test_connect_raw_client(
                &connectors,
                invite_code,
                opts.users,
                Duration::from_secs(duration_secs),
                Duration::from_secs(timeout_secs),
                limit_endpoints,
                event_sender.clone(),
            )
            .await?
        }
        Command::TestDownload { invite_code } => {
            let connectors = ConnectorRegistry::build_from_client_env().bind().await;
            let invite_code = InviteCode::from_str(&invite_code).context("invalid invite code")?;
            test_download_config(&connectors, &invite_code, opts.users, &event_sender.clone())
        }
        Command::LoadTest(args) => {
            let invite_code = invite_code_or_fallback(args.invite_code).await;

            let gateway_id = if let Some(gateway_id) = args.gateway_id {
                Some(gateway_id)
            } else if let Some(generate_invoice_with) = args.generate_invoice_with {
                Some(get_gateway_id(generate_invoice_with).await?)
            } else {
                None
            };
            let invoices = if let Some(invoices_file) = args.invoices_file {
                let display_path = invoices_file.display();
                let invoices_file = tokio::fs::File::open(&invoices_file)
                    .await
                    .with_context(|| format!("Failed to open {display_path}"))?;
                let mut lines = tokio::io::BufReader::new(invoices_file).lines();
                let mut invoices = vec![];
                while let Some(line) = lines.next_line().await? {
                    let invoice = Bolt11Invoice::from_str(&line)?;
                    invoices.push(invoice);
                }
                invoices
            } else {
                vec![]
            };
            if args.generate_invoice_with.is_none() && invoices.is_empty() {
                info!(
                    "No --generate-invoice-with given no invoices on --invoices-file, not LN/gateway tests will be run"
                );
            }
            run_load_test(
                opts.archive_dir,
                opts.users,
                invite_code,
                args.initial_notes,
                args.generate_invoice_with,
                args.invoices_per_user,
                Duration::from_secs(args.ln_payment_sleep_secs),
                invoices,
                gateway_id,
                args.notes_per_user,
                args.note_denomination,
                args.invoice_amount,
                event_sender.clone(),
            )
            .await?
        }
        Command::LnCircularLoadTest(args) => {
            let invite_code = invite_code_or_fallback(args.invite_code).await;
            run_ln_circular_load_test(
                opts.archive_dir,
                opts.users,
                invite_code,
                args.initial_notes,
                Duration::from_secs(args.test_duration_secs),
                Duration::from_secs(args.ln_payment_sleep_secs),
                args.notes_per_user,
                args.note_denomination,
                args.invoice_amount,
                args.strategy,
                event_sender.clone(),
            )
            .await?
        }
    };

    let result = futures::future::join_all(futures).await;
    drop(event_sender);
    summary_handle.await??;
    let len_failures = result.iter().filter(|r| r.is_err()).count();
    eprintln!("{} results, {len_failures} failures", result.len());
    for r in result {
        if let Err(e) = r {
            warn!("Task failed: {:?}", e);
        }
    }
    if len_failures > 0 {
        bail!("Finished with failures");
    }
    info!("Finished successfully");
    Ok(())
}

fn validate_total_notes(opts: &Opts) -> anyhow::Result<()> {
    match &opts.command {
        Command::LoadTest(args) => {
            checked_total(opts.users, args.notes_per_user)?;
        }
        Command::LnCircularLoadTest(args) => {
            checked_total(opts.users, args.notes_per_user)?;
        }
        Command::TestConnect { .. } | Command::TestDownload { .. } => {}
    }
    Ok(())
}

fn checked_total(users: u16, notes_per_user: u16) -> anyhow::Result<u16> {
    users.checked_mul(notes_per_user).ok_or_else(|| {
        anyhow!(
            "--users {users} multiplied by --notes-per-user {notes_per_user} exceeds the maximum supported combined note count of {}",
            u16::MAX
        )
    })
}

async fn invite_code_or_fallback(invite_code: Option<InviteCode>) -> Option<InviteCode> {
    if let Some(invite_code) = invite_code {
        Some(invite_code)
    } else {
        // Try to get an invite code through cli in a best effort basis
        match get_invite_code_cli(0.into()).await {
            Ok(invite_code) => Some(invite_code),
            Err(e) => {
                info!(
                    "No invite code provided and failed to get one with '{e}' error, will try to proceed without one..."
                );
                None
            }
        }
    }
}

#[allow(clippy::too_many_arguments)]
async fn run_load_test(
    archive_dir: Option<PathBuf>,
    users: u16,
    invite_code: Option<InviteCode>,
    initial_notes: Option<OOBNotes>,
    generate_invoice_with: Option<LnInvoiceGeneration>,
    generated_invoices_per_user: u16,
    ln_payment_sleep: Duration,
    invoices_from_file: Vec<Bolt11Invoice>,
    gateway_id: Option<String>,
    notes_per_user: u16,
    note_denomination: Amount,
    invoice_amount: Amount,
    event_sender: mpsc::UnboundedSender<MetricEvent>,
) -> anyhow::Result<Vec<BoxFuture<'static, anyhow::Result<()>>>> {
    let minimum_notes = checked_total(users, notes_per_user)?;
    let db_path = get_db_path(&archive_dir);
    let (coordinator, invite_code) = get_coordinator_client(&db_path, &invite_code).await?;
    let minimum_amount_required = note_denomination * u64::from(minimum_notes);

    reissue_initial_notes(initial_notes, &coordinator, &event_sender).await?;
    get_required_notes(&coordinator, minimum_amount_required, &event_sender).await?;
    print_coordinator_notes(&coordinator).await?;
    info!(
        "Reminting {minimum_notes} notes of denomination {note_denomination} for {users} users, {notes_per_user} notes per user (this may take a while if the number of users/notes is high)"
    );
    remint_denomination(&coordinator, note_denomination, minimum_notes).await?;
    print_coordinator_notes(&coordinator).await?;

    let users_clients = get_users_clients(users, db_path, invite_code).await?;

    let mut users_notes =
        get_notes_for_users(users, notes_per_user, coordinator, note_denomination).await?;
    let mut users_invoices = HashMap::new();
    let mut user = 0;
    // Distribute invoices to users in a round robin fashion
    for invoice in invoices_from_file {
        users_invoices
            .entry(user)
            .or_insert_with(Vec::new)
            .push(invoice);
        user = (user + 1) % users;
    }

    info!("Starting user tasks");
    let futures = users_clients
        .into_iter()
        .enumerate()
        .map(|(u, client)| {
            let u = u as u16;
            let oob_notes = users_notes.remove(&u).unwrap();
            let invoices = users_invoices.remove(&u).unwrap_or_default();
            let event_sender = event_sender.clone();
            let f: BoxFuture<_> = Box::pin(do_load_test_user_task(
                format!("User {u}:"),
                client,
                oob_notes,
                generated_invoices_per_user,
                ln_payment_sleep,
                invoice_amount,
                invoices,
                generate_invoice_with,
                event_sender,
                gateway_id.clone(),
            ));
            f
        })
        .collect::<Vec<_>>();

    Ok(futures)
}

async fn get_notes_for_users(
    users: u16,
    notes_per_user: u16,
    coordinator: ClientHandleArc,
    note_denomination: Amount,
) -> anyhow::Result<HashMap<u16, Vec<OOBNotes>>> {
    let mut users_notes = HashMap::new();
    for u in 0..users {
        users_notes.insert(u, Vec::with_capacity(notes_per_user.into()));
        for _ in 0..notes_per_user {
            let (_, oob_notes) = do_spend_notes(&coordinator, note_denomination).await?;
            let user_amount = oob_notes.total_amount();
            info!("Giving {user_amount} to user {u}");
            users_notes.get_mut(&u).unwrap().push(oob_notes);
        }
    }
    Ok(users_notes)
}

async fn get_users_clients(
    n: u16,
    db_path: Option<PathBuf>,
    invite_code: Option<InviteCode>,
) -> anyhow::Result<Vec<ClientHandleArc>> {
    let mut users_clients = Vec::with_capacity(n.into());
    for u in 0..n {
        let (client, _) = get_user_client(u, &db_path, &invite_code).await?;
        users_clients.push(client);
    }
    Ok(users_clients)
}

async fn get_user_client(
    user_index: u16,
    db_path: &Option<PathBuf>,
    invite_code: &Option<InviteCode>,
) -> anyhow::Result<(ClientHandleArc, Option<InviteCode>)> {
    let user_db = db_path
        .as_ref()
        .map(|db_path| db_path.join(format!("user_{user_index}.db")));
    let user_invite_code = if user_db.as_ref().is_some_and(|db| db.exists()) {
        None
    } else {
        invite_code.clone()
    };
    let (client, invite_code) = build_client(user_invite_code, user_db.as_ref()).await?;
    // if lightning module is present, update the gateway cache
    if let Ok(ln_client) = client.get_first_module::<LightningClientModule>() {
        let _ = ln_client.update_gateway_cache().await;
    }
    Ok((client, invite_code))
}

async fn print_coordinator_notes(coordinator: &ClientHandleArc) -> anyhow::Result<()> {
    info!("Note summary:");
    let summary = get_note_summary(coordinator).await?;
    for (k, v) in summary.iter() {
        info!("{k}: {v}");
    }
    Ok(())
}

async fn get_required_notes(
    coordinator: &ClientHandleArc,
    minimum_amount_required: Amount,
    event_sender: &mpsc::UnboundedSender<MetricEvent>,
) -> anyhow::Result<()> {
    let current_balance = coordinator.get_balance_for_btc().await?;

    if current_balance < minimum_amount_required {
        let diff = minimum_amount_required.saturating_sub(current_balance);
        info!(
            "Current balance {current_balance} on coordinator not enough, trying to get {diff} more through fedimint-cli"
        );
        match try_get_notes_cli(&diff, 5).await {
            Ok(notes) => {
                info!("Got {} more notes, reissuing them", notes.total_amount());
                reissue_notes(coordinator, notes, event_sender).await?;
            }
            Err(e) => {
                info!("Unable to get more notes: '{e}', will try to proceed without them");
            }
        }
    } else {
        info!(
            "Current balance of {current_balance} already covers the minimum required of {minimum_amount_required}"
        );
    }
    Ok(())
}

async fn reissue_initial_notes(
    initial_notes: Option<OOBNotes>,
    coordinator: &ClientHandleArc,
    event_sender: &mpsc::UnboundedSender<MetricEvent>,
) -> anyhow::Result<()> {
    if let Some(notes) = initial_notes {
        let amount = notes.total_amount();
        info!("Reissuing initial notes, got {amount}");
        reissue_notes(coordinator, notes, event_sender).await?;
    }
    Ok(())
}

async fn get_coordinator_client(
    db_path: &Option<PathBuf>,
    invite_code: &Option<InviteCode>,
) -> anyhow::Result<(ClientHandleArc, Option<InviteCode>)> {
    let (client, invite_code) = if let Some(db_path) = db_path {
        let coordinator_db = db_path.join("coordinator.db");
        if coordinator_db.exists() {
            build_client(invite_code.clone(), Some(&coordinator_db)).await?
        } else {
            tokio::fs::create_dir_all(db_path).await?;
            build_client(
                Some(invite_code.clone().context(
                    "Running on this archive dir for the first time, an invite code is required",
                )?),
                Some(&coordinator_db),
            )
            .await?
        }
    } else {
        build_client(
            Some(
                invite_code
                    .clone()
                    .context("No archive dir given, an invite code is strictly required")?,
            ),
            None,
        )
        .await?
    };
    Ok((client, invite_code))
}

fn get_db_path(archive_dir: &Option<PathBuf>) -> Option<PathBuf> {
    archive_dir.as_ref().map(|p| p.join("db"))
}

async fn get_lightning_gateway(
    client: &ClientHandleArc,
    gateway_id: Option<String>,
) -> Option<LightningGateway> {
    let gateway_id = parse_gateway_id(gateway_id.or(None)?.as_str()).expect("Invalid gateway id");
    let ln_module = client
        .get_first_module::<LightningClientModule>()
        .expect("Must have ln client module");
    ln_module.select_gateway(&gateway_id).await
}

#[allow(clippy::too_many_arguments)]
async fn do_load_test_user_task(
    prefix: String,
    client: ClientHandleArc,
    oob_notes: Vec<OOBNotes>,
    generated_invoices_per_user: u16,
    ln_payment_sleep: Duration,
    invoice_amount: Amount,
    additional_invoices: Vec<Bolt11Invoice>,
    generate_invoice_with: Option<LnInvoiceGeneration>,
    event_sender: mpsc::UnboundedSender<MetricEvent>,
    gateway_id: Option<String>,
) -> anyhow::Result<()> {
    let ln_gateway = get_lightning_gateway(&client, gateway_id).await;
    for oob_note in oob_notes {
        let amount = oob_note.total_amount();
        reissue_notes(&client, oob_note, &event_sender)
            .await
            .map_err(|e| anyhow!("while reissuing initial {amount}: {e}"))?;
    }
    let mut generated_invoices_per_user_iterator = (0..generated_invoices_per_user).peekable();
    while let Some(_) = generated_invoices_per_user_iterator.next() {
        let total_amount = get_note_summary(&client).await?.total_amount();
        if invoice_amount > total_amount {
            warn!("Can't pay invoice, not enough funds: {invoice_amount} > {total_amount}");
        } else {
            match generate_invoice_with {
                Some(LnInvoiceGeneration::LdkLightningCli) => {
                    let invoice = ldk_create_invoice(invoice_amount).await?;
                    gateway_pay_invoice(
                        &prefix,
                        "LND",
                        &client,
                        invoice.clone(),
                        &event_sender,
                        ln_gateway.clone(),
                    )
                    .await?;
                    ldk_wait_invoice_payment(&invoice).await?;
                }
                None if additional_invoices.is_empty() => {
                    debug!(
                        "No method given to generate an invoice and no invoices on file, will not test the gateway"
                    );
                    break;
                }
                None => {
                    break;
                }
            }
            if generated_invoices_per_user_iterator.peek().is_some() {
                // Only sleep while there are more invoices to pay
                fedimint_core::task::sleep(ln_payment_sleep).await;
            }
        }
    }
    let mut additional_invoices = additional_invoices.into_iter().peekable();
    while let Some(invoice) = additional_invoices.next() {
        let total_amount = get_note_summary(&client).await?.total_amount();
        let invoice_amount =
            Amount::from_msats(invoice.amount_milli_satoshis().unwrap_or_default());
        if invoice_amount > total_amount {
            warn!("Can't pay invoice, not enough funds: {invoice_amount} > {total_amount}");
        } else if invoice_amount == Amount::ZERO {
            warn!("Can't pay invoice {invoice}, amount is zero");
        } else {
            gateway_pay_invoice(
                &prefix,
                "unknown",
                &client,
                invoice,
                &event_sender,
                ln_gateway.clone(),
            )
            .await?;
            if additional_invoices.peek().is_some() {
                // Only sleep while there are more invoices to pay
                fedimint_core::task::sleep(ln_payment_sleep).await;
            }
        }
    }
    Ok(())
}

#[allow(clippy::too_many_arguments)]
async fn run_ln_circular_load_test(
    archive_dir: Option<PathBuf>,
    users: u16,
    invite_code: Option<InviteCode>,
    initial_notes: Option<OOBNotes>,
    test_duration: Duration,
    ln_payment_sleep: Duration,
    notes_per_user: u16,
    note_denomination: Amount,
    invoice_amount: Amount,
    strategy: LnCircularStrategy,
    event_sender: mpsc::UnboundedSender<MetricEvent>,
) -> anyhow::Result<Vec<BoxFuture<'static, anyhow::Result<()>>>> {
    let minimum_notes = checked_total(users, notes_per_user)?;
    let db_path = get_db_path(&archive_dir);
    let (coordinator, invite_code) = get_coordinator_client(&db_path, &invite_code).await?;
    let minimum_amount_required = note_denomination * u64::from(minimum_notes);

    reissue_initial_notes(initial_notes, &coordinator, &event_sender).await?;
    get_required_notes(&coordinator, minimum_amount_required, &event_sender).await?;

    info!(
        "Reminting {minimum_notes} notes of denomination {note_denomination} for {users} users, {notes_per_user} notes per user (this may take a while if the number of users/notes is high)"
    );
    remint_denomination(&coordinator, note_denomination, minimum_notes).await?;

    print_coordinator_notes(&coordinator).await?;

    let users_clients = get_users_clients(users, db_path, invite_code.clone()).await?;

    let mut users_notes =
        get_notes_for_users(users, notes_per_user, coordinator, note_denomination).await?;

    info!("Starting user tasks");
    let futures = users_clients
        .into_iter()
        .enumerate()
        .map(|(u, client)| {
            let u = u as u16;
            let oob_notes = users_notes.remove(&u).unwrap();
            let event_sender = event_sender.clone();
            let f: BoxFuture<_> = Box::pin(do_ln_circular_test_user_task(
                format!("User {u}:"),
                client,
                invite_code.clone(),
                oob_notes,
                test_duration,
                ln_payment_sleep,
                invoice_amount,
                strategy,
                event_sender,
            ));
            f
        })
        .collect::<Vec<_>>();

    Ok(futures)
}

#[allow(clippy::too_many_arguments)]
async fn do_ln_circular_test_user_task(
    prefix: String,
    client: ClientHandleArc,
    invite_code: Option<InviteCode>,
    oob_notes: Vec<OOBNotes>,
    test_duration: Duration,
    ln_payment_sleep: Duration,
    invoice_amount: Amount,
    strategy: LnCircularStrategy,
    event_sender: mpsc::UnboundedSender<MetricEvent>,
) -> anyhow::Result<()> {
    for oob_note in oob_notes {
        let amount = oob_note.total_amount();
        reissue_notes(&client, oob_note, &event_sender)
            .await
            .map_err(|e| anyhow!("while reissuing initial {amount}: {e}"))?;
    }
    let initial_time = fedimint_core::time::now();
    let still_ontime = || async {
        fedimint_core::time::now()
            .duration_since(initial_time)
            .expect("time to work")
            <= test_duration
    };
    let sleep_a_bit = || async {
        if still_ontime().await {
            fedimint_core::task::sleep(ln_payment_sleep).await;
        }
    };
    match strategy {
        LnCircularStrategy::TwoGateways => {
            let invoice_generation = LnInvoiceGeneration::LdkLightningCli;
            while still_ontime().await {
                let gateway_id = get_gateway_id(invoice_generation).await?;
                let ln_gateway = get_lightning_gateway(&client, Some(gateway_id)).await;
                run_two_gateways_strategy(
                    &prefix,
                    &invoice_generation,
                    &invoice_amount,
                    &event_sender,
                    &client,
                    ln_gateway,
                )
                .await?;
                sleep_a_bit().await;
            }
        }
        LnCircularStrategy::SelfPayment => {
            while still_ontime().await {
                do_self_payment(&prefix, &client, invoice_amount, &event_sender).await?;
                sleep_a_bit().await;
            }
        }
        LnCircularStrategy::PartnerPingPong => {
            let (partner, _) = build_client(invite_code, None).await?;
            while still_ontime().await {
                do_partner_ping_pong(&prefix, &client, &partner, invoice_amount, &event_sender)
                    .await?;
                sleep_a_bit().await;
            }
        }
    }
    Ok(())
}

const GATEWAY_CREATE_INVOICE: &str = "gateway_create_invoice";

async fn run_two_gateways_strategy(
    prefix: &str,
    invoice_generation: &LnInvoiceGeneration,
    invoice_amount: &Amount,
    event_sender: &mpsc::UnboundedSender<MetricEvent>,
    client: &ClientHandleArc,
    ln_gateway: Option<LightningGateway>,
) -> Result<(), anyhow::Error> {
    let create_invoice_time = fedimint_core::time::now();
    match *invoice_generation {
        LnInvoiceGeneration::LdkLightningCli => {
            let invoice = ldk_create_invoice(*invoice_amount).await?;
            let elapsed = create_invoice_time.elapsed()?;
            info!("Created invoice using LDK in {elapsed:?}");
            event_sender.send(MetricEvent {
                name: GATEWAY_CREATE_INVOICE.into(),
                duration: elapsed,
            })?;
            gateway_pay_invoice(
                prefix,
                "LND",
                client,
                invoice.clone(),
                event_sender,
                ln_gateway.clone(),
            )
            .await?;
            ldk_wait_invoice_payment(&invoice).await?;
            let (operation_id, invoice) =
                client_create_invoice(client, *invoice_amount, event_sender, ln_gateway).await?;
            let pay_invoice_time = fedimint_core::time::now();
            ldk_pay_invoice(invoice).await?;
            wait_invoice_payment(
                prefix,
                "LND",
                client,
                operation_id,
                event_sender,
                pay_invoice_time,
            )
            .await?;
        }
    }
    Ok(())
}

async fn do_self_payment(
    prefix: &str,
    client: &ClientHandleArc,
    invoice_amount: Amount,
    event_sender: &mpsc::UnboundedSender<MetricEvent>,
) -> anyhow::Result<()> {
    let (operation_id, invoice) =
        client_create_invoice(client, invoice_amount, event_sender, None).await?;
    let pay_invoice_time = fedimint_core::time::now();
    let lightning_module = client.get_first_module::<LightningClientModule>()?;
    //let gateway = lightning_module.select_active_gateway_opt().await;
    lightning_module
        .pay_bolt11_invoice(None, invoice, ())
        .await?;
    wait_invoice_payment(
        prefix,
        "gateway",
        client,
        operation_id,
        event_sender,
        pay_invoice_time,
    )
    .await?;
    Ok(())
}

async fn do_partner_ping_pong(
    prefix: &str,
    client: &ClientHandleArc,
    partner: &ClientHandleArc,
    invoice_amount: Amount,
    event_sender: &mpsc::UnboundedSender<MetricEvent>,
) -> anyhow::Result<()> {
    // Ping (partner creates invoice, client pays)
    let (operation_id, invoice) =
        client_create_invoice(partner, invoice_amount, event_sender, None).await?;
    let pay_invoice_time = fedimint_core::time::now();
    let lightning_module = client.get_first_module::<LightningClientModule>()?;
    // TODO: Select random gateway?
    //let gateway = lightning_module.select_active_gateway_opt().await;
    lightning_module
        .pay_bolt11_invoice(None, invoice, ())
        .await?;
    wait_invoice_payment(
        prefix,
        "gateway",
        partner,
        operation_id,
        event_sender,
        pay_invoice_time,
    )
    .await?;
    // Pong (client creates invoice, partner pays)
    let (operation_id, invoice) =
        client_create_invoice(client, invoice_amount, event_sender, None).await?;
    let pay_invoice_time = fedimint_core::time::now();
    let partner_lightning_module = partner.get_first_module::<LightningClientModule>()?;
    //let gateway = partner_lightning_module.select_active_gateway_opt().await;
    // TODO: Select random gateway?
    partner_lightning_module
        .pay_bolt11_invoice(None, invoice, ())
        .await?;
    wait_invoice_payment(
        prefix,
        "gateway",
        client,
        operation_id,
        event_sender,
        pay_invoice_time,
    )
    .await?;
    Ok(())
}

async fn wait_invoice_payment(
    prefix: &str,
    gateway_name: &str,
    client: &ClientHandleArc,
    operation_id: fedimint_core::core::OperationId,
    event_sender: &mpsc::UnboundedSender<MetricEvent>,
    pay_invoice_time: std::time::SystemTime,
) -> anyhow::Result<()> {
    let elapsed = pay_invoice_time.elapsed()?;
    info!("{prefix} Invoice payment receive started using {gateway_name} in {elapsed:?}");
    event_sender.send(MetricEvent {
        name: format!("gateway_{gateway_name}_payment_received_started"),
        duration: elapsed,
    })?;
    let lightning_module = client.get_first_module::<LightningClientModule>()?;
    let mut updates = lightning_module
        .subscribe_ln_receive(operation_id)
        .await?
        .into_stream();
    wait_invoice_payment_updates(
        prefix,
        gateway_name,
        operation_id,
        event_sender,
        pay_invoice_time,
        &mut updates,
    )
    .await
}

async fn wait_invoice_payment_updates(
    prefix: &str,
    gateway_name: &str,
    operation_id: fedimint_core::core::OperationId,
    event_sender: &mpsc::UnboundedSender<MetricEvent>,
    pay_invoice_time: std::time::SystemTime,
    updates: &mut (impl futures::Stream<Item = LnReceiveState> + Unpin),
) -> anyhow::Result<()> {
    while let Some(update) = updates.next().await {
        debug!(%prefix, ?update, "Invoice payment update");
        match update {
            LnReceiveState::Claimed => {
                let elapsed: Duration = pay_invoice_time.elapsed()?;
                info!("{prefix} Invoice payment received on {gateway_name} in {elapsed:?}");
                event_sender.send(MetricEvent {
                    name: "gateway_payment_received_success".into(),
                    duration: elapsed,
                })?;
                event_sender.send(MetricEvent {
                    name: format!("gateway_{gateway_name}_payment_received_success"),
                    duration: elapsed,
                })?;
                return Ok(());
            }
            LnReceiveState::Canceled { reason } => {
                let elapsed: Duration = pay_invoice_time.elapsed()?;
                info!(
                    "{prefix} Invoice payment receive was canceled on {gateway_name}: {reason} in {elapsed:?}"
                );
                event_sender.send(MetricEvent {
                    name: "gateway_payment_received_canceled".into(),
                    duration: elapsed,
                })?;
                bail!(
                    "Invoice payment receive for operation {operation_id:?} was canceled on \
                     {gateway_name}: {reason}"
                );
            }
            _ => {}
        }
    }
    bail!(
        "Invoice payment receive stream ended before operation {operation_id:?} was claimed on \
         {gateway_name}"
    )
}

async fn client_create_invoice(
    client: &ClientHandleArc,
    invoice_amount: Amount,
    event_sender: &mpsc::UnboundedSender<MetricEvent>,
    ln_gateway: Option<LightningGateway>,
) -> anyhow::Result<(fedimint_core::core::OperationId, Bolt11Invoice)> {
    let create_invoice_time = fedimint_core::time::now();
    let lightning_module = client.get_first_module::<LightningClientModule>()?;
    let desc = Description::new("test".to_string())?;
    let (operation_id, invoice, _) = lightning_module
        .create_bolt11_invoice(
            invoice_amount,
            Bolt11InvoiceDescription::Direct(desc),
            None,
            (),
            ln_gateway,
        )
        .await?;
    let elapsed = create_invoice_time.elapsed()?;
    info!("Created invoice using gateway in {elapsed:?}");
    event_sender.send(MetricEvent {
        name: GATEWAY_CREATE_INVOICE.into(),
        duration: elapsed,
    })?;
    Ok((operation_id, invoice))
}

fn test_download_config(
    endpoints: &ConnectorRegistry,
    invite_code: &InviteCode,
    users: u16,
    event_sender: &mpsc::UnboundedSender<MetricEvent>,
) -> Vec<BoxFuture<'static, anyhow::Result<()>>> {
    (0..users)
        .map(move |_| {
            let invite_code = invite_code.clone();
            let event_sender = event_sender.clone();
            let endpoints = endpoints.clone();
            let f: BoxFuture<_> = Box::pin(async move {
                let m = fedimint_core::time::now();
                let _ = download_from_invite_code(&endpoints, &invite_code).await?;
                event_sender.send(MetricEvent {
                    name: "download_client_config".into(),
                    duration: m.elapsed()?,
                })?;
                Ok(())
            });
            f
        })
        .collect()
}

async fn test_connect_raw_client(
    endpoints: &ConnectorRegistry,
    invite_code: InviteCode,
    users: u16,
    duration: Duration,
    timeout: Duration,
    limit_endpoints: Option<usize>,
    event_sender: mpsc::UnboundedSender<MetricEvent>,
) -> anyhow::Result<Vec<BoxFuture<'static, anyhow::Result<()>>>> {
    use jsonrpsee_core::client::ClientT;
    use jsonrpsee_ws_client::WsClientBuilder;

    let (mut cfg, _) = download_from_invite_code(endpoints, &invite_code).await?;

    if let Some(limit_endpoints) = limit_endpoints {
        cfg.global.api_endpoints = cfg
            .global
            .api_endpoints
            .into_iter()
            .take(limit_endpoints)
            .collect();
        info!("Limiting endpoints to {:?}", cfg.global.api_endpoints);
    }

    info!("Connecting to {users} clients");
    let clients = (0..users)
        .flat_map(|_| {
            cfg.global.api_endpoints.values().map(|url| async {
                let ws_client = WsClientBuilder::default()
                    .request_timeout(timeout)
                    .connection_timeout(timeout)
                    .build(url_to_string_with_default_port(&url.url))
                    .await?;
                Ok::<_, anyhow::Error>(ws_client)
            })
        })
        .collect::<Vec<_>>();
    let clients = futures::future::try_join_all(clients).await?;
    info!("Keeping {users} clients connected for {duration:?}");
    Ok(clients
        .into_iter()
        .map(|client| {
            let event_sender = event_sender.clone();
            let f: BoxFuture<_> = Box::pin(async move {
                let initial_time = fedimint_core::time::now();
                while initial_time.elapsed()? < duration {
                    let m = fedimint_core::time::now();
                    let _epoch: u64 = client
                        .request::<_, _>(SESSION_COUNT_ENDPOINT, vec![ApiRequestErased::default()])
                        .await?;
                    event_sender.send(MetricEvent {
                        name: SESSION_COUNT_ENDPOINT.into(),
                        duration: m.elapsed()?,
                    })?;
                    fedimint_core::task::sleep(Duration::from_secs(1)).await;
                }
                Ok(())
            });
            f
        })
        .collect())
}

fn url_to_string_with_default_port(url: &SafeUrl) -> String {
    format!(
        "{}://{}:{}{}",
        url.scheme(),
        url.host().expect("Asserted on construction"),
        url.port_or_known_default()
            .expect("Asserted on construction"),
        url.path()
    )
}

async fn handle_metrics_summary(
    opts: Opts,
    mut event_receiver: mpsc::UnboundedReceiver<MetricEvent>,
) -> anyhow::Result<()> {
    let timestamp_seconds = fedimint_core::time::duration_since_epoch().as_secs();
    let mut metrics_json_output_files = vec![];
    let mut previous_metrics = vec![];
    let mut comparison_output = None;
    if let Some(archive_dir) = opts.archive_dir {
        let mut archive_metrics = archive_dir.join("metrics");
        archive_metrics.push(opts.users.to_string());
        tokio::fs::create_dir_all(&archive_metrics).await?;
        let mut archive_comparisons = archive_dir.join("comparisons");
        archive_comparisons.push(opts.users.to_string());
        tokio::fs::create_dir_all(&archive_comparisons).await?;

        let latest_metrics_file = std::fs::read_dir(&archive_metrics)?
            .map(|entry| {
                let entry = entry.unwrap();
                let metadata = entry.metadata().unwrap();
                let created = metadata
                    .created()
                    .unwrap_or_else(|_| metadata.modified().unwrap());
                (entry, created)
            })
            .max_by_key(|(_entry, created)| created.to_owned())
            .map(|(entry, _)| entry.path());
        if let Some(latest_metrics_file) = latest_metrics_file {
            let display_path = latest_metrics_file.display();
            let latest_metrics_file = tokio::fs::File::open(&latest_metrics_file)
                .await
                .with_context(|| format!("Failed to open {display_path}"))?;
            let mut lines = tokio::io::BufReader::new(latest_metrics_file).lines();
            while let Some(line) = lines.next_line().await? {
                match serde_json::from_str::<EventMetricSummary>(&line) {
                    Ok(metric) => {
                        previous_metrics.push(metric);
                    }
                    Err(e) => {
                        warn!("Failed to parse previous metric: {e:?}");
                    }
                }
            }
        }
        let new_metric_output = archive_metrics.join(format!("{timestamp_seconds}.json",));
        let new_metric_output = BufWriter::new(
            OpenOptions::new()
                .write(true)
                .create(true)
                .truncate(true)
                .open(new_metric_output)
                .await?,
        );
        metrics_json_output_files.push(new_metric_output);
        if !previous_metrics.is_empty() {
            let new_comparison_output =
                archive_comparisons.join(format!("{timestamp_seconds}.json",));
            comparison_output = Some(BufWriter::new(
                OpenOptions::new()
                    .write(true)
                    .create(true)
                    .truncate(true)
                    .open(new_comparison_output)
                    .await?,
            ));
        }
    }
    if let Some(metrics_json_output) = opts.metrics_json_output {
        metrics_json_output_files.push(BufWriter::new(
            tokio::fs::OpenOptions::new()
                .write(true)
                .create(true)
                .truncate(true)
                .open(metrics_json_output)
                .await?,
        ));
    }
    let mut results = BTreeMap::new();
    while let Some(event) = event_receiver.recv().await {
        let entry = results.entry(event.name).or_insert_with(Vec::new);
        entry.push(event.duration);
    }
    let mut previous_metrics = previous_metrics
        .into_iter()
        .map(|metric| (metric.name.clone(), metric))
        .collect::<HashMap<_, _>>();
    for (k, mut v) in results {
        v.sort();
        let n = v.len();
        let max = v.iter().last().unwrap();
        let min = v.first().unwrap();
        let median = v[n / 2];
        let sum: Duration = v.iter().sum();
        let avg = sum / n as u32;
        let metric_summary = EventMetricSummary {
            name: k.clone(),
            users: u64::from(opts.users),
            n: n as u64,
            avg_ms: avg.as_millis(),
            median_ms: median.as_millis(),
            max_ms: max.as_millis(),
            min_ms: min.as_millis(),
            timestamp_seconds,
        };
        let comparison = if let Some(previous_metric) = previous_metrics.remove(&k) {
            if previous_metric.n == metric_summary.n {
                fn calculate_gain(current: u128, previous: u128) -> f64 {
                    current as f64 / previous as f64
                }
                let comparison = EventMetricComparison {
                    avg_ms_gain: calculate_gain(metric_summary.avg_ms, previous_metric.avg_ms),
                    median_ms_gain: calculate_gain(
                        metric_summary.median_ms,
                        previous_metric.median_ms,
                    ),
                    max_ms_gain: calculate_gain(metric_summary.max_ms, previous_metric.max_ms),
                    min_ms_gain: calculate_gain(metric_summary.min_ms, previous_metric.min_ms),
                    current: metric_summary.clone(),
                    previous: previous_metric,
                };
                if let Some(comparison_output) = &mut comparison_output {
                    let comparison_json =
                        serde_json::to_string(&comparison).expect("to be serializable");
                    comparison_output
                        .write_all(format!("{comparison_json}\n").as_bytes())
                        .await
                        .expect("to write on file");
                }
                Some(comparison)
            } else {
                info!(
                    "Skipping comparison for {k} because previous metric has different n ({} vs {})",
                    previous_metric.n, metric_summary.n
                );
                None
            }
        } else {
            None
        };
        if let Some(comparison) = comparison {
            println!(
                "{n} {k}: avg {avg:?}, median {median:?}, max {max:?}, min {min:?} (compared to previous: {comparison})"
            );
        } else {
            println!("{n} {k}: avg {avg:?}, median {median:?}, max {max:?}, min {min:?}");
        }
        let metric_summary_json =
            serde_json::to_string(&metric_summary).expect("to be serializable");
        for metrics_json_output_file in &mut metrics_json_output_files {
            metrics_json_output_file
                .write_all(format!("{metric_summary_json}\n").as_bytes())
                .await
                .expect("to write on file");
        }
    }
    for mut output in metrics_json_output_files {
        output.flush().await?;
    }
    if let Some(mut output) = comparison_output {
        output.flush().await?;
    }
    Ok(())
}

async fn get_gateway_id(generate_invoice_with: LnInvoiceGeneration) -> anyhow::Result<String> {
    let gateway_json = match generate_invoice_with {
        LnInvoiceGeneration::LdkLightningCli => {
            // If we are paying a lnd invoice, we use the LDK node
            cmd!(GatewayLndCli, "info").out_json().await
        }
    }?;

    let gatewayd_version = devimint::util::Gatewayd::version_or_default().await;
    let gateway_id = if gatewayd_version < *VERSION_0_10_0_ALPHA {
        gateway_json["gateway_id"]
            .as_str()
            .context("gateway_id must be a string")?
            .to_owned()
    } else {
        gateway_json["registrations"]["http"][1]
            .as_str()
            .context("gateway id must be a string")?
            .to_owned()
    };

    Ok(gateway_id)
}