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

#68 in Magic Beans

Download history 217/week @ 2024-02-21 190/week @ 2024-02-28 196/week @ 2024-03-06 192/week @ 2024-03-13 359/week @ 2024-03-20 221/week @ 2024-03-27 115/week @ 2024-04-03 57/week @ 2024-04-10 29/week @ 2024-04-17 96/week @ 2024-04-24 81/week @ 2024-05-01 9/week @ 2024-05-08 61/week @ 2024-05-15 269/week @ 2024-05-22 97/week @ 2024-05-29 108/week @ 2024-06-05

539 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

~3–14MB
~132K SLoC