Hierarchical-deterministic (HD) wallets generator library for dHealth Network.
NOTE: The author of this package cannot be held responsible for any loss of money or any malintentioned usage forms of this package. Please use this package with caution.
- Node.js 12 LTS
npm install @dhealth/hd-wallets
// examples/GeneratingAMnemonicPassPhrase.ts
import {MnemonicPassPhrase} from "@dhealth/hd-wallets";
// random 24-words mnemonic
MnemonicPassPhrase.createRandom();
// random 12-words mnemonic
MnemonicPassPhrase.createRandom('english', 128);
// random 24-words mnemonic with french wordlist
MnemonicPassPhrase.createRandom('french');
// random 24-words mnemonic with japanese wordlist
MnemonicPassPhrase.createRandom('japanese');
// examples/GeneratePasswordProtectedSeedForRandomPassPhrase.ts
import {MnemonicPassPhrase} from "@dhealth/hd-wallets";
const mnemonic = MnemonicPassPhrase.createRandom();
const secureSeedHex = mnemonic.toSeed('your-password');
// examples/GeneratePasswordProtectedSeedForRandomPassPhraseEmptyPassword.ts
import {MnemonicPassPhrase} from "@dhealth/hd-wallets";
// Example 2: empty password for password-protected seed
const mnemonic = MnemonicPassPhrase.createRandom();
const secureSeedHex = mnemonic.toSeed(); // omit password means empty password: ''
// examples/GeneratingARootMasterExtendedKeyForKnownPassPhrase.ts
import {MnemonicPassPhrase} from "@dhealth/hd-wallets";
// Example 2: generate BIP32 master seed for known pass phrase
const words = 'alpha pattern real admit vacuum wall ready code '
+ 'correct program depend valid focus basket whisper firm '
+ 'tray fit rally day dance demise engine mango';
const mnemonic = new MnemonicPassPhrase(words);
// the following seed can be used with `ExtendedKey.createFromSeed()`
const bip32Seed = mnemonic.toSeed(); // using empty password
// examples/GeneratingARootMasterExtendedKeyForRandomPassPhrase.ts
import {MnemonicPassPhrase} from "@dhealth/hd-wallets";
// Example 1: generate BIP32 master seed for random pass phrase
const mnemonic = MnemonicPassPhrase.createRandom();
const bip32Seed = mnemonic.toSeed();
// examples/GeneratingAHDWalletPrivateNetworkCompatible.ts
import {NetworkType} from '@dhealth/sdk';
import {ExtendedKey, Network, Wallet} from "@dhealth/hd-wallets";
const xkey = ExtendedKey.createFromSeed('000102030405060708090a0b0c0d0e0f', Network.SYMBOL);
const wallet = new Wallet(xkey);
// get master account
const masterAccount = wallet.getAccount();
// get DEFAULT ACCOUNT
const defaultAccount = wallet.getChildAccount();
// derive specific child path
const childAccount = wallet.getChildAccount('m/44\'/4343\'/0\'/0\'/0\'', NetworkType.MIJIN_TEST);
// get read-only wallet
const readOnlyWallet = new Wallet(xkey.getPublicNode());
const readOnlyAccount = readOnlyWallet.getPublicAccount(NetworkType.MIJIN_TEST);
// get read-only DEFAULT ACCOUNT
const readOnlyDefaultAccount = readOnlyWallet.getChildPublicAccount();
// examples/GeneratingAHDWalletPublicNetworkCompatible.ts
import {NetworkType} from '@dhealth/sdk';
import {ExtendedKey, Network, Wallet} from "@dhealth/hd-wallets";
const xkey = ExtendedKey.createFromSeed('000102030405060708090a0b0c0d0e0f', Network.SYMBOL);
const wallet = new Wallet(xkey);
// get master account
const masterAccount = wallet.getAccount();
// get DEFAULT ACCOUNT
const defaultAccount = wallet.getChildAccount();
// derive specific child path
const childAccount = wallet.getChildAccount('m/44\'/4343\'/0\'/0\'/0\'', NetworkType.TEST_NET);
// get read-only wallet
const readOnlyWallet = new Wallet(xkey.getPublicNode());
const readOnlyAccount = readOnlyWallet.getPublicAccount(NetworkType.TEST_NET);
// get read-only DEFAULT ACCOUNT
const readOnlyDefaultAccount = readOnlyWallet.getChildPublicAccount();
// examples/SigningWithAHDWalletPrivateNetworkCompatible.ts
import {Account, Deadline, EmptyMessage, NetworkType, TransferTransaction} from "@dhealth/sdk";
import {ExtendedKey, Network, Wallet} from "@dhealth/hd-wallets";
const xkey = ExtendedKey.createFromSeed('000102030405060708090a0b0c0d0e0f', Network.SYMBOL);
const wallet = new Wallet(xkey);
// derive specific child path
const childAccount = wallet.getChildAccount('m/44\'/4343\'/0\'/0\'/0\'', NetworkType.TEST_NET);
// create a transfer object
const transfer = TransferTransaction.create(
Deadline.create(),
Account.generateNewAccount(NetworkType.TEST_NET).address,
[],
EmptyMessage,
NetworkType.TEST_NET);
// sign the transaction with derived account
const generationHash = ''; // replace with network generation hash
const signedTx = childAccount.sign(transfer, generationHash);
Use the following available resources to get help:
- dHealth Documentation
- Package Documentation
- Join the community on Discord
- If you found a bug, open a new issue
Contributions are welcome and appreciated. Check CONTRIBUTING for information on how to contribute.
Copyright (c) 2019-2020, Grégory Saive for NEM. Copyright (c) 2021-present, Grégory Saive for dHealth Network, All rights reserved.
Licensed under the BSD-2 License.