# bip32-path

> Bitcoin BIP32 ('HD Wallet') path helpers.

Latest version **0.4.2** (published 2016-04-25) · MIT license · 0 weekly downloads

## Install

```sh
npm install bip32-path
pnpm add bip32-path
yarn add bip32-path
bun add bip32-path
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.4.2 |
| Published | 2016-04-25 |
| First published | 2016-04-25 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 16 |
| Author | Alex Beregszaszi |
| Maintainers | axic |
| Keywords | bitcoin, bip32, hdwallet, trezor |

## Links

- npm: https://www.npmjs.com/package/bip32-path
- Repository: https://github.com/axic/bip32-path
- Issues: https://github.com/axic/bip32-path/issues
- npm.io page: https://npm.io/package/bip32-path

## Recent versions

- 0.4.2 (latest) — 2016-04-25

## README

# BIP32 Path

Bitcoin BIP32 ("HD Wallet") path helpers.

There are multiple path representations being used by different implementations. These includes:
- `m/44'/0'/0'/0/0` where the apostrophe means hardened key
- `m/44h/0h/0h/0/0` where the letter `h` means hardened key
- and a binary representation predominantly used by Trezor & compatible wallets and some software tools, such as [bitcoinjs-lib](https://github.com/bitcoinjs/bitcoinjs-lib)

Some useful links:
- [BIP32 specification](https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki)
- [BIP44 specification](https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki)
- [BIP39, an online tool to convert/derive keys](https://dcpos.github.io/bip39/)
- [BIP32JP, an online tool to convert/derive keys](https://bip32jp.github.io/english/index.html)


### API

- `BIPPath.fromString(path, reqRoot)` - creates an instance from a path written as text. Set `reqRoot` to true if the `m/` prefix is mandatory.
- `BIPPath.fromPathArray(path)` - creates an instance from a binary path array
- `new BIPPath(path)` - alias for `BIPPath.fromPathArray(path)`
- `<bippath>.toString(noRoot, oldStyle)` - returns a text encoded path. Set to `noRoot` to true to omit the `m/` prefix. Set `oldStyle` true to use `h` instead of `'` for marking hardened nodes.
- `<bippath>.toPathArray()` - returns a binary path array
- `BIPPath.validateString(path, reqRoot)` - returns true if the input is a valid path string
- `BIPPath.validatePathArray(path)` - returns true if the input is a valid binary path array

Binary path arrays contain each node as a separate number, where hardened nodes are marked by setting the 32th bit: `m/44'/1/1/0` corresponds to `[ 0x8000002c, 1, 1, 0 ]`


### Examples

```js
var bippath = require('bip32-path')

bippath.fromPathArray([0x8000002c, 1, 1, 0]).toString() // m/44'/1/1/0

bippath.fromString("m/44'/0'/0'").toString(false, true) // m/44h/0h/0h

bippath.fromString("m/44h/0h/0'").toString(true) // 44'/0'/0'

bippath.fromString("m/44'/0'/0'").toPathArray() // [ 0x8000002c, 0x80000000, 0x80000000 ]
```

---
_Source: https://npm.io/package/bip32-path · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._