pub mod bip389;
#[cfg(feature = "bitbox")]
pub mod bitbox;
#[cfg(feature = "coldcard")]
pub mod coldcard;
#[cfg(feature = "jade")]
pub mod jade;
#[cfg(feature = "ledger")]
pub mod ledger;
#[cfg(feature = "specter")]
pub mod specter;
pub mod utils;
use async_trait::async_trait;
use bitcoin::{
bip32::{DerivationPath, Fingerprint, Xpub},
psbt::Psbt,
};
use std::{cmp::Ordering, fmt::Debug, str::FromStr};
#[derive(Debug, Clone)]
pub enum Error {
ParsingPolicy(bip389::ParseError),
MissingPolicy,
UnsupportedVersion,
UnsupportedInput,
InvalidParameter(&'static str, String),
UnimplementedMethod,
DeviceDisconnected,
DeviceNotFound,
DeviceDidNotSign,
Device(String),
Unexpected(&'static str),
UserRefused,
NetworkMismatch,
}
impl std::fmt::Display for Error {
fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
match self {
Error::ParsingPolicy(e) => write!(f, "{}", e),
Error::MissingPolicy => write!(f, "Missing policy"),
Error::UnsupportedVersion => write!(f, "Unsupported version"),
Error::UnsupportedInput => write!(f, "Unsupported input"),
Error::UnimplementedMethod => write!(f, "Unimplemented method"),
Error::DeviceDisconnected => write!(f, "Device disconnected"),
Error::DeviceNotFound => write!(f, "Device not found"),
Error::DeviceDidNotSign => write!(f, "Device did not sign"),
Error::Device(e) => write!(f, "{}", e),
Error::InvalidParameter(param, e) => write!(f, "Invalid parameter {}: {}", param, e),
Error::Unexpected(e) => write!(f, "{}", e),
Error::UserRefused => write!(f, "User refused operation"),
Error::NetworkMismatch => write!(f, "Device network is different"),
}
}
}
impl From<bip389::ParseError> for Error {
fn from(value: bip389::ParseError) -> Self {
Error::ParsingPolicy(value)
}
}
impl std::error::Error for Error {}
#[async_trait]
pub trait HWI: Debug {
fn device_kind(&self) -> DeviceKind;
async fn get_version(&self) -> Result<Version, Error>;
async fn get_master_fingerprint(&self) -> Result<Fingerprint, Error>;
async fn get_extended_pubkey(&self, path: &DerivationPath) -> Result<Xpub, Error>;
async fn register_wallet(&self, name: &str, policy: &str) -> Result<Option<[u8; 32]>, Error>;
async fn is_wallet_registered(&self, name: &str, policy: &str) -> Result<bool, Error>;
async fn display_address(&self, script: &AddressScript) -> Result<(), Error>;
async fn sign_tx(&self, tx: &mut Psbt) -> Result<(), Error>;
}
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum AddressScript {
P2TR(DerivationPath),
Miniscript { index: u32, change: bool },
}
#[derive(PartialEq, Eq, Debug, Clone, Default)]
pub struct Version {
pub major: u32,
pub minor: u32,
pub patch: u32,
pub prerelease: Option<String>,
}
#[cfg(feature = "regex")]
pub fn parse_version(s: &str) -> Result<Version, Error> {
let re = regex::Regex::new(r"^(0|[1-9]\d*)\.(0|[1-9]\d*)(?:\.(0|[1-9]\d*))?(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$").unwrap();
if let Some(captures) = re.captures(
s.trim_start_matches('v')
.trim_end_matches("QX")
.trim_end_matches('X'),
) {
let major = if let Some(s) = captures.get(1) {
u32::from_str(s.as_str()).map_err(|_| Error::UnsupportedVersion)?
} else {
0
};
let minor = if let Some(s) = captures.get(2) {
u32::from_str(s.as_str()).map_err(|_| Error::UnsupportedVersion)?
} else {
0
};
let patch = if let Some(s) = captures.get(3) {
u32::from_str(s.as_str()).map_err(|_| Error::UnsupportedVersion)?
} else {
0
};
Ok(Version {
major,
minor,
patch,
prerelease: captures.get(4).map(|s| s.as_str().to_string()),
})
} else {
Err(Error::UnsupportedVersion)
}
}
impl PartialOrd for Version {
fn partial_cmp(&self, other: &Self) -> Option<Ordering> {
match self.major.cmp(&other.major) {
Ordering::Equal => match self.minor.cmp(&other.minor) {
Ordering::Equal => match self.patch.cmp(&other.patch) {
Ordering::Equal => {
match (&self.prerelease, &other.prerelease) {
(Some(_), Some(_)) => None,
(Some(_), None) => Some(Ordering::Greater),
(None, Some(_)) => Some(Ordering::Less),
(None, None) => Some(Ordering::Equal),
}
}
other => Some(other),
},
other => Some(other),
},
other => Some(other),
}
}
}
impl std::fmt::Display for Version {
fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
if let Some(prerelease) = &self.prerelease {
write!(
f,
"{}.{}.{}-{}",
self.major, self.minor, self.patch, prerelease
)
} else {
write!(f, "{}.{}.{}", self.major, self.minor, self.patch)
}
}
}
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum DeviceKind {
BitBox02,
Coldcard,
Specter,
SpecterSimulator,
Ledger,
LedgerSimulator,
Jade,
}
impl std::fmt::Display for DeviceKind {
fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
match self {
DeviceKind::BitBox02 => write!(f, "bitbox02"),
DeviceKind::Coldcard => write!(f, "coldcard"),
DeviceKind::Specter => write!(f, "specter"),
DeviceKind::SpecterSimulator => write!(f, "specter-simulator"),
DeviceKind::Ledger => write!(f, "ledger"),
DeviceKind::LedgerSimulator => write!(f, "ledger-simulator"),
DeviceKind::Jade => write!(f, "jade"),
}
}
}
impl std::str::FromStr for DeviceKind {
type Err = ();
fn from_str(s: &str) -> Result<Self, Self::Err> {
match s {
"bitbox02" => Ok(DeviceKind::BitBox02),
"specter" => Ok(DeviceKind::Specter),
"specter-simulator" => Ok(DeviceKind::SpecterSimulator),
"ledger" => Ok(DeviceKind::Ledger),
"ledger-simulator" => Ok(DeviceKind::LedgerSimulator),
"jade" => Ok(DeviceKind::Jade),
_ => Err(()),
}
}
}
#[cfg(test)]
mod tests {
use super::*;
#[cfg(feature = "regex")]
#[test]
fn test_parse_version() {
let test_cases = [
(
"v2.1.0",
Version {
major: 2,
minor: 1,
patch: 0,
prerelease: None,
},
),
(
"v1.0",
Version {
major: 1,
minor: 0,
patch: 0,
prerelease: None,
},
),
(
"3.0-rc2",
Version {
major: 3,
minor: 0,
patch: 0,
prerelease: Some("rc2".to_string()),
},
),
(
"0.1.0-ALPHA",
Version {
major: 0,
minor: 1,
patch: 0,
prerelease: Some("ALPHA".to_string()),
},
),
(
"6.2.1X",
Version {
major: 6,
minor: 2,
patch: 1,
prerelease: None,
},
),
(
"6.3.3QX",
Version {
major: 6,
minor: 3,
patch: 3,
prerelease: None,
},
),
];
for (s, v) in test_cases {
assert_eq!(v, parse_version(s).unwrap());
}
}
#[cfg(feature = "regex")]
#[test]
fn test_partial_ord_version() {
let test_cases = [
("v2.1.0", "v3.1.0"),
("v0.0.1", "v0.1"),
("v0.1", "v1.0.1"),
("v2.0.1", "v2.1.0"),
("v2.1.1", "v3.0-rc1"),
("v3.0-rc1", "v3.0.1"),
("v3.0", "v3.0-rc1"),
];
for (l, r) in test_cases {
let v1 = parse_version(l).unwrap();
let v2 = parse_version(r).unwrap();
assert!(v1 < v2);
}
let v1 = parse_version("v2.0-rc1weirdstuff").unwrap();
let v2 = parse_version("v2.0-rc1weirderstuff").unwrap();
assert!(v1.partial_cmp(&v2).is_none());
}
}