agentswap 0.11.3

AgentSwap CLI for requesting quotes, inspecting tokens and pools, managing intents, and registering an API key against the AgentSwap service.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

// Human report: a Markdown table an agent can forward to the owner, then the summary and next
// steps. Amounts are shortened for reading; `--json` carries the exact raw values.
use super::models::{ReportOutput, ReportRow};
use comfy_table::{Table, presets::ASCII_MARKDOWN};
use std::fmt::Write;

/// `value` cut to `places` fractional digits; a nonzero value that would read as 0 keeps its digits.
fn short(value: &str, places: usize) -> String {
    let (whole, fraction) = value.split_once('.').unwrap_or((value, ""));
    let fraction = &fraction[..fraction.len().min(places)];
    let text = if fraction.trim_end_matches('0').is_empty() { whole.to_string() } else { format!("{whole}.{}", fraction.trim_end_matches('0')) };
    if text == "0" && value.bytes().any(|b| matches!(b, b'1'..=b'9')) { value.to_string() } else { text }
}

/// Dollars with exactly two cents digits, cut rather than rounded.
fn usd(value: Option<&str>) -> String {
    let Some(value) = value else { return "-".into() };
    let (whole, fraction) = value.split_once('.').unwrap_or((value, ""));
    format!("${whole}.{:0<2}", &fraction[..fraction.len().min(2)])
}

fn last_fill(row: &ReportRow) -> String {
    let Some(fill) = row.fills.last() else { return "-".into() };
    let hash = fill.tx_hash.as_deref().map_or_else(|| "unrecorded".into(), crate::display::short_addr);
    let extra = if row.fills.len() > 1 { format!(" (+{})", row.fills.len() - 1) } else { String::new() };
    format!("{hash} {}{extra}", fill.filled_at.as_deref().unwrap_or(""))
}

fn table(report: &ReportOutput) -> Table {
    let mut table = Table::new();
    table.load_preset(ASCII_MARKDOWN).set_header(vec!["Token", "Status", "Sold / cap", &format!("Received ({})", report.receive.symbol),
        "Value", "Discount", "Last fill"]);
    for row in &report.tokens {
        table.add_row(vec![row.symbol.clone(), row.status.replace('_', " "), format!("{} / {}", short(&row.sold, 6), short(&row.cap, 6)),
            row.received.as_deref().map_or_else(|| "-".into(), |r| short(r, 6)), usd(row.value_usd.as_deref()),
            row.discount_pct.as_deref().map_or_else(|| "-".into(), |d| format!("{d}%")), last_fill(row)]);
    }
    table
}

pub fn text(report: &ReportOutput) -> String {
    let s = &report.summary;
    let mut out = format!("Batch sale {} on {} ({}): receive {}, discount floor {}%\n{}\n\n", report.request,
        crate::tokens::chain_id_to_name(report.chain_id), report.chain_id, report.receive.symbol,
        super::rows::pct(i128::from(report.max_loss_bps)), table(report));
    let _ = writeln!(out, "Sold {}/{} tokens worth {} at independent prices.", s.tokens_sold, s.tokens_total, usd(Some(&s.sold_value_usd)));
    if s.known_proceeds_tokens > 0 {
        let _ = writeln!(out, "Received {} {} ({}) for {} sold with fill records.", short(&s.received, 6), report.receive.symbol,
            usd(s.received_usd.as_deref()), usd(Some(&s.known_proceeds_value_usd)));
    }
    if s.unknown_proceeds_tokens > 0 {
        let _ = writeln!(out, "Proceeds unknown for {} token{} ({} sold): no fill record.", s.unknown_proceeds_tokens,
            if s.unknown_proceeds_tokens == 1 { "" } else { "s" }, usd(Some(&s.unknown_proceeds_value_usd)));
    }
    if let (Some(average), Some(worst)) = (&s.average_discount_pct, &s.worst_discount_pct) {
        let _ = writeln!(out, "Discount vs market: average {average}%, worst {worst}% on {}.", s.worst_discount_token.as_deref().unwrap_or("-"));
    }
    let _ = writeln!(out, "Unsold value: {}. Grant {} {}.", usd(Some(&s.unsold_value_usd)),
        if report.grant.active { "expires" } else { "ended; expiry" }, report.grant.expires_at);
    let _ = writeln!(out, "Values use independent prices as of {}, not prices at fill time.", report.as_of);
    for (title, lines) in [("Next", &report.next), ("Warnings", &report.warnings)] {
        if lines.is_empty() { continue; }
        let _ = writeln!(out, "{title}:");
        for line in lines { let _ = writeln!(out, "- {line}"); }
    }
    out
}