16 releases (10 breaking)

0.12.2 May 24, 2024
0.12.1 Feb 4, 2024
0.12.0 Jan 31, 2024
0.9.0 Nov 28, 2023
0.3.0 Jun 13, 2022

#17 in #connected

Download history 116/week @ 2024-07-26 117/week @ 2024-08-02 72/week @ 2024-08-09 140/week @ 2024-08-16 124/week @ 2024-08-23 267/week @ 2024-08-30 500/week @ 2024-09-06 200/week @ 2024-09-13 109/week @ 2024-09-20 118/week @ 2024-09-27 117/week @ 2024-10-04 142/week @ 2024-10-11 274/week @ 2024-10-18 148/week @ 2024-10-25 334/week @ 2024-11-01 190/week @ 2024-11-08

987 downloads per month
Used in 5 crates (3 directly)

MIT license

76KB
2K SLoC

Coldcard Interface Library

coldcard is a library for interfacing with the Coldcard hardware wallet over USB.

Usage

use coldcard::protocol;

// create an API instance
let mut api = coldcard::Api::new()?;

// detect all connected Coldcards
let serials = api.detect()?;

// get the first serial and open it
let (mut cc, master_xpub) = api.open(&serials[0], None)?;

// set a passphrase
cc.set_passphrase(protocol::Passphrase::new("secret")?)?;

// after the user confirms
let xpub = cc.get_passphrase_done()?;

if let Some(xpub) = xpub {
    println!("The new XPUB is: {}", xpub);
}

// secure logout
cc.logout()?;

Linux Specific Instructions

In order to be able to detect a Coldcard device on a Linux system, 51-coinkite.rules must be placed in /etc/udev/rules.d/. This can be installed using the CLI tool.

Two mutually exclusive HID backends are supported and can be turned on using the following features:

Logging

The log feature enables logging using the log crate. Disabled by default. Use judiciously as logging can leak details into the environment.

CLI

This project also offers a CLI tool. See the crate's own README for more information.

Install it with:

$ cargo install coldcard-cli

Contributing

Contributions are welcome. Before making large changes, please open an issue first.

Disclaimer

This is not an official project and comes with no warranty whatsoever.

Dependencies

~4–14MB
~129K SLoC