rust-cktap 0.1.0

A Rust implementation of the Coinkite Tap Protocol (cktap) for use with SATSCARD, TAPSIGNER, and SATSCHIP products.
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

// Copyright (c) 2025 rust-cktap contributors
// SPDX-License-Identifier: MIT OR Apache-2.0

extern crate core;

use crate::CkTapError;
use crate::error::StatusError;
use crate::shared::to_cktap;
use crate::{CkTapCard, CkTransport};
use async_trait::async_trait;
use pcsc::{Card, Context, MAX_BUFFER_SIZE, Protocols, Scope, ShareMode};
use std::sync::Arc;

pub async fn find_first() -> Result<CkTapCard, StatusError> {
    // Establish a PC/SC context.
    let ctx = Context::establish(Scope::User)?;

    // List available readers.
    let mut readers_buf = [0; 2048];
    let mut readers = ctx.list_readers(&mut readers_buf)?;

    // Use the first reader.
    let reader = match readers.next() {
        Some(reader) => Ok(reader),
        None => {
            //println!("No readers are connected.");
            Err(CkTapError::Transport(
                "No readers are connected.".to_string(),
            ))
        }
    }?;

    let card = ctx.connect(reader, ShareMode::Shared, Protocols::ANY)?;
    to_cktap(Arc::new(card)).await
}

#[async_trait]
impl CkTransport for Card {
    async fn transmit_apdu(&self, command_apdu: Vec<u8>) -> Result<Vec<u8>, CkTapError> {
        let mut receive_buffer = vec![0; MAX_BUFFER_SIZE];
        let rapdu = self.transmit(command_apdu.as_slice(), &mut receive_buffer)?;
        Ok(rapdu.to_vec())
    }
}