cdk-mint-rpc 0.17.5

CDK mintd mint management RPC client and server
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
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

use anyhow::Result;
use clap::Args;
use tonic::Request;

use crate::wallet::{GetBalanceRequest, ListAddressesRequest, ListTransactionsRequest};
use crate::InterceptedWalletServiceClient;

/// Pagination arguments for wallet list commands.
#[derive(Debug, Args)]
pub struct WalletPaginationCommand {
    /// Maximum records to return; zero uses the server default.
    #[arg(long, default_value_t = 0)]
    limit: u32,
    /// Records to skip.
    #[arg(long, default_value_t = 0)]
    offset: u32,
}

/// Prints the BDK on-chain wallet balance.
pub async fn get_wallet_balance(client: &mut InterceptedWalletServiceClient) -> Result<()> {
    let balance = client
        .get_balance(Request::new(GetBalanceRequest {}))
        .await?
        .into_inner();

    println!("network:                {}", balance.network);
    println!("synced height:          {}", balance.synced_height);
    println!("confirmed:              {} sat", balance.confirmed_sat);
    println!(
        "trusted pending:        {} sat",
        balance.trusted_pending_sat
    );
    println!(
        "untrusted pending:      {} sat",
        balance.untrusted_pending_sat
    );
    println!("immature:               {} sat", balance.immature_sat);
    println!(
        "trusted spendable:      {} sat",
        balance.trusted_spendable_sat
    );
    println!("total:                  {} sat", balance.total_sat);

    Ok(())
}

/// Prints a page of BDK on-chain wallet transactions.
pub async fn list_wallet_transactions(
    client: &mut InterceptedWalletServiceClient,
    command: &WalletPaginationCommand,
) -> Result<()> {
    let response = client
        .list_transactions(Request::new(ListTransactionsRequest {
            limit: command.limit,
            offset: command.offset,
        }))
        .await?
        .into_inner();

    println!("total: {}", response.total);
    for transaction in response.transactions {
        println!(
            "txid: {}, received: {} sat, sent: {} sat, fee: {}, delta: {} sat, height: {}, confirmation_time: {}, first_seen: {}",
            transaction.txid,
            transaction.received_sat,
            transaction.sent_sat,
            transaction
                .fee_sat
                .map(|fee| format!("{fee} sat"))
                .unwrap_or_else(|| "unknown".to_string()),
            transaction.balance_delta_sat,
            transaction
                .confirmation_height
                .map(|height| height.to_string())
                .unwrap_or_else(|| "unconfirmed".to_string()),
            transaction
                .confirmation_time
                .map(|timestamp| timestamp.to_string())
                .unwrap_or_else(|| "none".to_string()),
            transaction
                .first_seen
                .map(|timestamp| timestamp.to_string())
                .unwrap_or_else(|| "none".to_string()),
        );
    }

    Ok(())
}

/// Prints a page of addresses revealed by the BDK on-chain wallet.
pub async fn list_wallet_addresses(
    client: &mut InterceptedWalletServiceClient,
    command: &WalletPaginationCommand,
) -> Result<()> {
    let response = client
        .list_addresses(Request::new(ListAddressesRequest {
            limit: command.limit,
            offset: command.offset,
        }))
        .await?
        .into_inner();

    println!("total: {}", response.total);
    for address in response.addresses {
        println!(
            "address: {}, keychain: {}, index: {}, used: {}, balance: {} sat, confirmed: {} sat",
            address.address,
            address.keychain().as_str_name(),
            address.derivation_index,
            address.used,
            address.balance_sat,
            address.confirmed_balance_sat,
        );
    }

    Ok(())
}