lumi-web-core v1.9.3
LumiCore
The LumiCore library is an implementation of tools for working with Bitcoin, Ethereum, Bitcoin Cash, Bitcoin Vault, Dogecoin, Litecoin, Binance and Xinfin Network. It allows to create and work with mnemonic following the BIP39 standard, to run the private/public keys derivation tree following the BIP44 standard and sign transactions.
Work of this module has been tested in applications at the Vue.js. You can find it here.
Note: Node version >= 10.19.0
Installation
You can install the package via npm
npm install lumi-web-core
Or via yarn:
yarn add lumi-web-core
Usage
Warning! Do not use the mnemonic, keys, and addresses provided in this readme for real transactions!
Create/import
Import the module and create a new class:
// typical import import Wallet from 'lumi-web-core'
const WALLET = new Wallet()
You can create a new wallet by calling the method `createNew(count)`. Count is the number of words for the new mnemonic.
By default it is 12. It can be also 12, 15, 18, 21, and 24 words.
``` js
// Create a new wallet
const CORE = await WALLET.createNew(15)
You can create a wallet based on an existing mnemonic, where mnemonic is a string consisting of words and spaces:
// Create wallet by new mnemonic
const CORE = await WALLET.createByMnemonic('ramp grief anger ... olive main into throw')
Or xprv key:
// Create wallet by xprv key
const CORE = await WALLET.createByKey('xprv9s21ZrQH143K49Xa838YbhNq...VtL5sLB9JsijRG51jHjuUSDVfDXPh5PFYNTqQ')
Example of the returned core:
{
mnemonic: "ramp grief anger ... olive main into throw",
xprv: "xprv9s21ZrQH143K49Xa838YbhNq...VtL5sLB9JsijRG51jHjuUSDVfDXPh5PFYNTqQ",
from: "mnemonic",
hdkey: Object,
seed: Uint8Array(64),
seedInHex: "1f53c65842ed3d0c54052f7f7315dbd9dcb...4af426ffb27234a0a571c44e29c1f4d1b181082e62d0a39"
}
After that, call the createCoinsCores()
method to create cores for specific currencies.
const coins = [
{coin: 'BTC', type: 'p2pkh'},
{coin: 'BTC', type: 'p2wpkh'},
{coin: 'ETH', type: 0},
{coin: 'BCH'},
{coin: 'BTCV'},
{coin: 'DOGE'},
{coin: 'LTC'},
{coin: 'BNB'}
]
const CORES = await WALLET.createCoins(coins)
=> {
BTC: {
p2pkh: {
externalNode: Object,
internalNode: Object,
externalAddress: "1PtMtCbtgb...bivNJU5Ww3bvF3",
internalAddress: "1LvXQnwCeq...GyfMNtxpyEd3Hx",
dp: {external: "m/44'/0'/0'/0", internal: "m/44'/0'/0'/1"}
},
p2wpkh: {
externalNode: Object,
internalNode: Object,
externalAddress: "bc1qyluu9yjfw6...xjfjy0ht8hszx",
internalAddress: "bc1qnk6r09q97m...w9vme4zjvpct0",
dp: {external: "m/84'/0'/0'/0", internal: "m/84'/0'/0'/1"}
}
},
ETH: {
0: {
dp: "m/44'/60'/0'/0/0",
externalAddress: "0xcf06fa556d8ad...cc285e2b7bdf58c58",
node: Object,
privateKey: Buffer,
privateKeyHex: "0xb1f8f5df78d5a00d...6b222e54ee8abbfe6af",
publicKey: Buffer,
}
},
BTCV: {
p2wpkh: {
dp: {external: "m/84'/440'/0'/0", internal: "m/84'/440'/0'/1"},
externalAddress: "royale1q2cy79nu...am6t5svnvt9d62",
externalNode: Object,
internalAddress: "royale1qe9286wc4...tlqxj9sz0t7m9dg5q",
internalNode: Object
}
},
BCH: {
p2pkh: {
dp: {external: "m/44'/145'/0'/0", internal: "m/44'/145'/0'/1"},
externalAddress: "1Nbi1Roep9...SeJKwQTdFESB",
externalNode: Object,
internalAddress: "1135Eji7Yoop...rKJmGFi2RyX",
internalNode: Object
}
},
DOGE: {
p2pkh: {
dp: {external: "m/44'/3'/0'/0", internal: "m/44'/3'/0'/1"},
externalAddress: "DLXryK9F7k...BMrcqFMci",
externalNode: Object,
internalAddress: "DKqyuCkSYJXt...PxnYcUxM'",
internalNode: Object
}
},
LTC: {
p2wpkh: {
dp: {external: "m/84'/2'/0'/0", internal: "m/84'/2'/0'/1"},
externalAddress: "ltc1q35...tdk8nme",
externalNode: Object,
internalAddress: "ltc1qcjs2w...jh06jac",
internalNode: Object
}
},
BNB: {
p2pkh: {
node: Object,
privateKey: Buffer,
privateKeyHex: '036852f55d1b759...2de02c72a47fea1c592',
publicKey: Buffer,
publicKeyHex: '03ec67b0636efb9e543e..4d7b458e52d9dd301da99',
externalAddress: 'bnb1kd4kt7x505l...9qlxp7x365ld8fkt',
dp: 'm/44\'/714\'/0\'/0/0'
}
}
For BTC and ETH coins, the type parameter is required. For BTC, it can take the values p2pkh or p2wpkh (p2pkh by default). For ETH, the type parameter is set to the account number (0 by default).
Derivation
You can get information about a child node using the method getChildNodes
.
const data = {
path: "m/44'/0'/0'/0",
from: 0,
to: 20,
coins: [
{coin: 'BTC', type: 'p2pkh'},
{coin: 'BTC', type: 'p2wpkh'},
{coin: 'ETH', type: 0},
{coin: 'BCH'},
{coin: 'BTCV'},
{coin: 'DOGE'},
{coin: 'LTC'}
{coin: 'BNB'}
]
}
const info = await WALLET.getChildNodes(data)
=> {
node: {
privateExtendedKey: "xprvA1CHKT9koKiKuhkeZ6XJxWXEQ1r...va4RtZfFmdYaQeNW72vX9q2DjMo3fsJwxCtkrVXyo2QP8",
publicExtendedKey: "xpub6EBdixgedhGd8Bq7f84KKeTxx3gYWQ...bn9YVZ8PVXb6tTnCWTorLQPKqRggvdzyHH1TkoR7vuz"
},
list: [
{
path: "m/44'/0'/0'/0/0",
privateKey: "KzwMNQ93Dt96Qg...mRpaBCmEXGH2Lpgr2dGZsV",
publicKey: "023b693fa7fa22e505...4cc450a463c024ab1e3ec526ba",
bchAddress: "bitcoincash:qqtne...l889v5ee6nawwvvx6t7mvkp",
btcvAddress: "royale1qzu70e44r...8eeet9xww5ltnnr6akytm",
ethAddress: "0xdd6f3cc0ed5f9...b09481090536e446ebd3",
p2pkhAddress: "137sbugaaqw3H...LZzNX3nTk1LDgCYd",
p2wpkhAddress: "bc1qzu70e44r...eet9xww5ltnnrm5mjxk",
dogeAddress: 'DS58JVRHdU...zuBNNVLFo4UaTn',
ltcAddress: 'ltc1...07g',
bnbAddress: 'bnb1hvw4qlty...7xm9g3fdsrcqzzkh'
},
...
]
}
path
this is a string with a derivation path. The path should begin with m/44'
.
from
is top of the range derivation
to
is end of the range derivation
coins
is a list of currencies for which you need to generate addresses
- BCH transaction
- BNB transaction
- BTC transaction
- BTCV transaction
- DOGE transaction
- ETH transaction
- LTC transaction
- XDC transaction
Nist testing
Testing documentation.
Created using
- bip39
- bip39-checker
- bitcoinjs-lib
- @ethereumjs/tx
- ethereumjs-util
- hdkey
- wif
- worker-loader
- bitcore-lib-cash
- bchaddrjs
License
LumiCore is available under the MIT license. See the LICENSE file for more info.
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago