perpl-cli 0.2.3

Perpl DEX CLI
Documentation 
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
68
69
70
71
72
73
74
75
76
77
78
79

use std::pin::pin;

use alloy::providers::Provider;
use colored::Colorize;
use fastnum::UD64;
use futures::StreamExt;
use perpl_sdk::{
    Chain, stream,
    types::{BuilderAttribution, StateInstant},
};
use tokio_util::sync::CancellationToken;

/// Renders the builder attribution of a fill, empty without a builder.
fn builder_suffix(builder: Option<BuilderAttribution>, builder_fee: UD64) -> String {
    builder
        .map(|b| format!(" [builder {}: {}]", b.builder_id(), builder_fee))
        .unwrap_or_default()
}

pub(crate) async fn render<P: Provider + Clone>(
    chain: Chain,
    provider: P,
    num_blocks: Option<u64>,
    cancellation_token: CancellationToken,
) -> anyhow::Result<()> {
    let block_num = provider.get_block_number().await?;

    let raw_events_stream =
        stream::raw(&chain, provider.clone(), StateInstant::new(block_num, 0), tokio::time::sleep);
    let trades_stream = stream::trade(&chain, provider, raw_events_stream).await?;
    let mut trades_stream = pin!(trades_stream);

    let mut blocks_left = num_blocks;

    while let Some(Ok(trades)) = trades_stream.next().await {
        if cancellation_token.is_cancelled() || blocks_left.is_some_and(|count| count == 0) {
            break;
        }

        if !trades.events().is_empty() {
            println!(
                "\n{}",
                format!("Block {} - {} trade(s):", trades.instant(), trades.events().len())
                    .bold()
                    .purple()
            );
            for event in trades.events() {
                let trade = event.event();
                println!(
                    "\n  Taker {} {:?} {} @ {} on perp={} (fee: {}){}",
                    trade.taker_account_id,
                    trade.taker_side,
                    trade.total_size(),
                    trade.avg_price().unwrap_or_default(),
                    trade.perpetual_id,
                    trade.taker_fee,
                    builder_suffix(trade.taker_builder, trade.taker_builder_fee),
                );
                for fill in &trade.maker_fills {
                    println!(
                        "    <- Maker {} order {} filled {} @ {} (fee: {}){}",
                        fill.maker_account_id,
                        fill.maker_order_id,
                        fill.size,
                        fill.price,
                        fill.fee,
                        builder_suffix(fill.builder, fill.builder_fee),
                    );
                }
            }
        }

        if let Some(ref mut count) = blocks_left {
            *count -= 1;
        }
    }

    Ok(())
}