#hd-wallet

no-std slip-10

SLIP10 implementation in Rust

5 releases (3 breaking)

0.4.1 Oct 17, 2024
0.4.0 Jun 20, 2024
0.3.0 May 17, 2024
0.2.0 Mar 1, 2024
0.1.0 Feb 16, 2024

#1772 in Cryptography

Download history 72/week @ 2024-07-17 84/week @ 2024-07-24 56/week @ 2024-07-31 11/week @ 2024-08-07 31/week @ 2024-08-14 61/week @ 2024-08-21 43/week @ 2024-08-28 5/week @ 2024-09-04 32/week @ 2024-09-11 35/week @ 2024-09-18 23/week @ 2024-09-25 594/week @ 2024-10-02 1644/week @ 2024-10-09 1586/week @ 2024-10-16 381/week @ 2024-10-23 359/week @ 2024-10-30

4,427 downloads per month

MIT/Apache

31KB
436 lines

SLIP-10: Deterministic key generation

Warning

slip-10 crate has been restructured and renamed into hd-wallet. slip-10 is not likely to receive any future updates. Please, consider switching to successor library.

In order to migrate to the successor hd-wallet v0.5, include it into Cargo.toml:

hd-wallet = "0.5"

Then you'll need to change slip_10:: references in your code to hd_wallet::. For instance, slip_10::HardenedIndex becomes hd_wallet::HardenedIndex.

The functions for child wallet derivation has been moved. Derivation algorithm that is used in slip_10 crate corresponds to hd_wallet::slip10_like. E.g. if you were deriving a child key using slip_10::derive_child_public_key, now you need to use hd_wallet::slip10_like::derive_child_public_key instead.

If you have any problems with migration, don't hesitate to reach out to us in Discord #lockness room.

SLIP10 is a specification for implementing HD wallets. It aims at supporting many curves while being compatible with BIP32.

The implementation is based on generic-ec library that provides generic elliptic curve arithmetic. The crate is no_std and no_alloc friendly.

Curves support

Implementation currently does not support ed25519 curve. All other curves are supported: both secp256k1 and secp256r1. In fact, implementation may work with any curve, but only those are covered by the SLIP10 specs.

The crate also re-exports supported curves in supported_curves module (requires enabling a feature), but any other curve implementation will work with the crate.

Features

  • std: enables std library support (mainly, it just implements Error trait for the error types)
  • curve-secp256k1 and curve-secp256r1 add curve implementation into the crate supported_curves module

Examples

Derive a master key from the seed, and then derive a child key m/1H/10:

use slip_10::supported_curves::Secp256k1;

let seed = b"16-64 bytes of high entropy".as_slice();
let master_key = slip_10::derive_master_key::<Secp256k1>(seed)?;
let master_key_pair = slip_10::ExtendedKeyPair::from(master_key);

let child_key_pair = slip_10::derive_child_key_pair_with_path(
    &master_key_pair,
    [1 + slip_10::H, 10],
);

Dependencies

~2.7–3.5MB
~75K SLoC