multichain-wallet
Advanced tools
A Multichain crypto wallet library that supports Ethereum, Bitcoin, Solana, Waves and other EVM compatible blockchains E.g. Binance Smart Chain, Polygon, Avalanche etc.
A Multichain crypto wallet library that supports Ethereum, Bitcoin, Solana, Waves and other EVM compatible blockchains E.g. Binance Smart Chain, Polygon, Avalanche etc.
npm install multichain-wallet
Using yarn,
yarn add multichain-wallet
const multichainWallet = require('multichain-wallet');
import * as multichainWallet from 'multichain-wallet';
The following methods are available with this SDK:
This method is used to generate mnemonic. Default number of words is 12 but you can pass a number param if you want to generate more or less.
const mnemonic = multichainWallet.generateMnemonic();
// Note: Mnemonics with less than 12 words have low entropy and may be guessed by an attacker.
net idle lava mango another capable inhale portion blossom fluid discover cruise
This method creates a new wallet. The method accepts a payload object as the parameter. The parameter of this payload is:
// Creating an Ethereum wallet.
const wallet = multichainWallet.createWallet({
derivationPath: "m/44'/60'/0'/0/0", // Leave empty to use default derivation path
network: 'ethereum',
}); // NOTE - Address generated will work for EVM compatible blockchains E.g. Binance smart chain, Polygon etc
// Creating a Bitcoin wallet.
const wallet = multichainWallet.createWallet({
derivationPath: "m/44'/0'/0'/0/0", // Leave empty to use default derivation path
network: 'bitcoin', // 'bitcoin' or 'bitcoin-testnet'
});
// Creating a Solana wallet.
const wallet = multichainWallet.createWallet({
derivationPath: "m/44'/501'/0'/0'", // Leave empty to use default derivation path
network: 'solana',
});
// Creating a Waves wallet.
const wallet = await multichainWallet.createWallet({
cluster: 'testnet' // Can also be mainnet,
network: 'waves',
});
{
address: '0xfBE11AC0258cc8288cA24E818691Eb062f7042E9',
privateKey: '0xfdf745f45d1942feea79b4c0a3fc1ca67da366899f7e6cebaa06496806ca8127',
mnemonic: 'net idle lava mango another capable inhale portion blossom fluid discover cruise'
}
This gets the balance of the address passed in. The method accepts an object as the parameter. The parameters for this object depending on the kind of balance to be gotten is in the form:
// Get the ETH balance of an address.
const data = await multichainWallet.getBalance({
address: '0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22',
network: 'ethereum',
rpcUrl: 'https://rpc.ankr.com/eth_goerli',
}); // NOTE - For otherEVM compatible blockchains all you have to do is change the rpcUrl.
// Binance Smart chain
const data = await multichainWallet.getBalance({
address: '0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22',
network: 'ethereum',
rpcUrl: 'https://rpc.ankr.com/eth_goerli',
});
// Get the BTC balance of an address.
const data = await multichainWallet.getBalance({
address: '2NAhbS79dEUeqcnbC27UppwnjoVSwET5bat',
network: 'bitcoin-testnet', // 'bitcoin' or 'bitcoin-testnet'
});
// Get the SOL balance of an address.
const data = await multichainWallet.getBalance({
address: 'DYgLjazTY6kMqagbDMsNttRHKQj9o6pNS8D6jMjWbmP7',
network: 'solana',
rpcUrl: 'https://api.devnet.solana.com',
});
// Get the WAVES balance of an address.
const data = await multichainWallet.getBalance({
network: 'waves',
address: '3NBE5tjbQn9BHczjD6NSSuFDKVHKsBRzTv9',
rpcUrl: 'https://nodes-testnet.wavesnodes.com',
});
// Get the balance of an ERC20 token.
const data = await multichainWallet.getBalance({
address: '0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22',
network: 'ethereum',
rpcUrl: 'https://rpc.ankr.com/eth_goerli',
tokenAddress: '0xdac17f958d2ee523a2206206994597c13d831ec7',
}); // NOTE - For other EVM compatible blockchains all you have to do is change the rpcUrl.
// Get the balance of a token on Solana.
const data = await multichainWallet.getBalance({
address: '5PwN5k7hin2XxUUaXveur7jSe5qt2mkWinp1JEiv8xYu',
tokenAddress: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',
network: 'solana',
rpcUrl: 'https://rpc.ankr.com/solana',
});
// Get the balance of a token on Waves.
const data = await multichainWallet.getBalance({
network: 'waves',
address: '3NBE5tjbQn9BHczjD6NSSuFDKVHKsBRzTv9',
rpcUrl: 'https://nodes-testnet.wavesnodes.com',
tokenAddress: '39pnv8FVf3BX3xwtC6uhFxffy2sE3seXCPsf25eNn6qG',
});
{
balance: 2;
}
This generates a wallet from Mnemonic phrase. The method accepts an object as the parameter. The parameters that this object takes are:
// Generate an Ethereum wallet from mnemonic.
const wallet = multichainWallet.generateWalletFromMnemonic({
mnemonic:
'candy maple cake sugar pudding cream honey rich smooth crumble sweet treat',
derivationPath: "m/44'/60'/0'/0/0", // Leave empty to use default derivation path
network: 'ethereum',
}); // NOTE - Address generated will work for EVM compatible blockchains E.g. Binance smart chain, Polygon etc
// Generate a Bitcoin wallet from mnemonic.
const wallet = multichainWallet.generateWalletFromMnemonic({
mnemonic:
'excess quit spot inspire stereo scrap cave wife narrow era pizza typical',
derivationPath: "m/44'/0'/0'/0/0", // Leave empty to use default derivation path
network: 'bitcoin', // 'bitcoin' or 'bitcoin-testnet'
});
// Generate a Solana wallet from mnemonic.
const wallet = multichainWallet.generateWalletFromMnemonic({
mnemonic:
'base dry mango subject neither labor portion weekend range couple right document',
derivationPath: "m/44'/501'/0'/0'", // Leave empty to use default derivation path
network: 'solana',
});
// Generate a Waves wallet from mnemonic.
const wallet = multichainWallet.generateWalletFromMnemonic({
mnemonic:
'mushroom deliver work spray hire nuclear wrong deputy march six midnight outside motor differ adult',
cluster: 'testnet',
network: 'waves',
});
{
address: '0x627306090abaB3A6e1400e9345bC60c78a8BEf57',
privateKey: '0xc87509a1c067bbde78beb793e6fa76530b6382a4c0241e5e4a9ec0a0f44dc0d3',
mnemonic: 'candy maple cake sugar pudding cream honey rich smooth crumble sweet treat'
}
This gets the address from the private key passed in. The method accepts an object as the parameter. The parameters that this object takes are:
// Get the address from the private key on the Ethereum network.
const address = multichainWallet.getAddressFromPrivateKey({
privateKey:
'0f9e5c0bee6c7d06b95204ca22dea8d7f89bb04e8527a2c59e134d185d9af8ad',
network: 'ethereum',
});
// Get the address from the private key on the Bitcoin network.
const data = multichainWallet.getAddressFromPrivateKey({
privateKey: 'KxqTGtCMnX6oL9rxynDKCRJXt64Gm5ame4AEQcYncFhSSUxFBkeJ',
network: 'bitcoin', // 'bitcoin' or 'bitcoin-testnet'
});
// Get the address from the private key on the Solana network.
const address = multichainWallet.getAddressFromPrivateKey({
privateKey:
'bXXgTj2cgXMFAGpLHkF5GhnoNeUpmcJDsxXDhXQhQhL2BDpJumdwMGeC5Cs66stsN3GfkMH8oyHu24dnojKbtfp',
network: 'solana',
});
{
address: '0x1C082D1052fb44134a408651c01148aDBFcCe7Fe';
}
This gets the transaction receipt of a transaction from the transaction hash. The method accepts an object as the parameter. The parameters that this object takes are:
// Get the transaction receipt on Ethereum network.
const receipt = await multichainWallet.getTransaction({
hash: '0x5a90cea37e3a5dbee6e10190ff5a3769ad27a0c6f625458682104e26e0491055',
network: 'ethereum',
rpcUrl: 'https://rpc.ankr.com/eth_goerli',
}); // NOTE - For other EVM compatible blockchains all you have to do is change the rpcUrl.
// Get the transaction receipt on Bitcoin network.
const receipt = await getTransaction({
network: 'bitcoin-testnet', // 'bitcoin' or 'bitcoin-testnet'
hash: '4f6c3661e0e6d190dbdfb6c0791396fccee653c5bf4a5249b049341c2b539ee1',
});
// Get the transaction receipt on Solana network.
const receipt = await multichainWallet.getTransaction({
rpcUrl: 'https://api.devnet.solana.com',
hash:
'CkG1ynQ2vN8bmNsBUKG8ix3moUUfELWwd8K2f7mmqDd7LifFFfgyFhBux6t22AncbY4NR3PsEU3DbH7mDBMXWk7',
network: 'solana',
});
// Get the transaction receipt on Waves network.
const receipt = await multichainWallet.getTransaction({
rpcUrl: 'https://nodes-testnet.wavesnodes.com',
hash: 'Barwuj1gCiQ9wCfLQ1nbdz2CSyQXLnRxnDEubtdTwJpd',
network: 'waves',
});
{
object;
}
This transfers the amount of tokens from the source address to the destination address It takes in an object as the parameter. It allows for the transfer of the following:
Allows for the transfer of ETH, and overriding of transactions.
// Transferring ETH from one address to another.
const transfer = await multichainWallet.transfer({
recipientAddress: '0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22',
amount: 1,
network: 'ethereum',
rpcUrl: 'https://rpc.ankr.com/eth_goerli',
privateKey:
'0f9e5c0bee6c7d06b95204ca22dea8d7f89bb04e8527a2c59e134d185d9af8ad',
gasPrice: '10', // Gas price is in Gwei. Leave empty to use default gas price
data: 'Money for transportation', // Send a message
}); // NOTE - For other EVM compatible blockchains all you have to do is change the rpcUrl.
// Transferring ERC20 tokens from one address to another.
const transfer = await multichainWallet.transfer({
recipientAddress: '0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22',
amount: 10,
network: 'ethereum',
rpcUrl: 'https://rpc.ankr.com/eth_goerli',
privateKey:
'0f9e5c0bee6c7d06b95204ca22dea8d7f89bb04e8527a2c59e134d185d9af8ad',
gasPrice: '10', // Gas price is in Gwei. leave empty to use default gas price
tokenAddress: '0xdac17f958d2ee523a2206206994597c13d831ec7',
}); // NOTE - For other EVM compatible blockchains all you have to do is change the rpcUrl.
The optional parameters that the object takes in are: gas price, nonce, and data.
// Overriding pending ETH transaction.
const transfer = await multichainWallet.transfer({
recipientAddress: '0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22',
amount: 0,
network: 'ethereum',
rpcUrl: 'https://rpc.ankr.com/eth_goerli',
privateKey:
'0f9e5c0bee6c7d06b95204ca22dea8d7f89bb04e8527a2c59e134d185d9af8ad',
gasPrice: '10',
nonce: 1, // The pending transaction nonce
data: 'Money for feeding', // Send a message
});
// Overriding ERC20 token pending transaction.
const transfer = await multichainWallet.transfer({
recipientAddress: '0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22',
amount: 0,
network: 'ethereum',
rpcUrl: 'https://rpc.ankr.com/eth_goerli',
privateKey:
'0f9e5c0bee6c7d06b95204ca22dea8d7f89bb04e8527a2c59e134d185d9af8ad',
gasPrice: '10',
tokenAddress: '0xdac17f958d2ee523a2206206994597c13d831ec7',
nonce: 1, // The pending transaction nonce
});
{
object;
}
Allows for the transfer of BTC from one address to another.
// Transferring BTC from one address to another.
const response = await multichainWallet.transfer({
privateKey: 'L3tSvMViDit1GSp7mbV2xFCGv6M45kDNuSyNY9xyUxmUPBFrBkc4',
recipientAddress: '2NAhbS79dEUeqcnbC27UppwnjoVSwET5bat',
amount: 0.001,
network: 'bitcoin-testnet', // 'bitcoin' or 'bitcoin-testnet'
fee: 10000, // Optional param default value is 10000
subtractFee: false, // Optional param default value is false
});
{
object;
}
Allows for the transfer of SOL and tokens.
// Transferring SOL from one address to another.
const transfer = await multichainWallet.transfer({
recipientAddress: '9DSRMyr3EfxPzxZo9wMBPku7mvcazHTHfyjhcfw5yucA',
amount: 1,
network: 'solana',
rpcUrl: 'https://api.devnet.solana.com',
privateKey:
'bXXgTj2cgXMFAGpLHkF5GhnoNeUpmcJDsxXDhXQhQhL2BDpJumdwMGeC5Cs66stsN3GfkMH8oyHu24dnojKbtfp',
});
// Transferring a token from one address to another.
const transfer = await multichainWallet.transfer({
recipientAddress: '9DSRMyr3EfxPzxZo9wMBPku7mvcazHTHfyjhcfw5yucA',
tokenAddress: 'DV2exYApRFWEVb9oQkedLRYeSm8ccxNReLfEksEE5FZm',
amount: 1,
network: 'solana',
rpcUrl: 'https://api.devnet.solana.com',
privateKey:
'h5KUPKU4z8c9nhMCQsvCLq4q6Xn9XK1B1cKjC9bJVLQLgJDvknKCBtZdHKDoKBHuATnSYaHRvjJSDdBWN8P67hh',
});
{
hash: '3nGq2yczqCpm8bF2dyvdPtXpnFLJ1oGWkDfD6neLbRay8SjNqYNhWQBKE1ZFunxvFhJ47FyT6igNpYPP293jXCZk';
}
Allows for the transfer of WAVES and tokens.
// Transferring WAVES from one address to another.
const response = await multichainWallet.transfer({
recipientAddress: '3N4x4ML4D6fiU18Tpw86puRoN78FCTs9VQu',
amount: 0.0001,
network: 'waves',
rpcUrl: 'https://nodes-testnet.wavesnodes.com',
privateKey:
'mushroom deliver work spray hire nuclear wrong deputy march six midnight outside motor differ adult',
});
// Transferring a token from one address to another.
const transfer = await multichainWallet.transfer({
recipientAddress: '3N4x4ML4D6fiU18Tpw86puRoN78FCTs9VQu',
tokenAddress: '39pnv8FVf3BX3xwtC6uhFxffy2sE3seXCPsf25eNn6qG',
amount: 1,
network: 'waves',
rpcUrl: 'https://nodes-testnet.wavesnodes.com',
privateKey:
'mushroom deliver work spray hire nuclear wrong deputy march six midnight outside motor differ adult',
});
{
type: 4,
id: '9CbA3dsyEvbdf52gqeBvVkjEP5zBmCQPANjguNznHryf',
fee: 100000,
feeAssetId: null,
timestamp: 1661781621495,
version: 3,
chainId: 84,
sender: '3NBE5tjbQn9BHczjD6NSSuFDKVHKsBRzTv9',
senderPublicKey: '8JEFTsZfqp2Y7HpmaxqgGtiMLfsNAAq3bMkwZwGpUWPV',
proofs: [
'5m4DpkkYkVY4xkiMNyrNpiVUHNNAtyJrSH5UCkjWSnLTAabkCefLx6wWTFT1Xcb7K8C31H7ndZAX8mWrJLMrsqxr'
],
recipient: '3N4x4ML4D6fiU18Tpw86puRoN78FCTs9VQu',
assetId: '39pnv8FVf3BX3xwtC6uhFxffy2sE3seXCPsf25eNn6qG',
feeAsset: null,
amount: 100000000,
attachment: ''
}
It supports encryption of ethereum and other EVM compatible chains private keys.
// encrypt private key.
const encrypted = await multichainWallet.getEncryptedJsonFromPrivateKey({
network: 'ethereum',
privateKey:
'0f9e5c0bee6c7d06b95204ca22dea8d7f89bb04e8527a2c59e134d185d9af8ad',
password: 'walletpassword',
});
{
json: '{"address":"1c082d1052fb44134a408651c01148adbfcce7fe","id":"abfb9f10-165a-4b7a-935d-51729f10c310","version":3,"Crypto":{"cipher":"aes-128-ctr","cipherparams":{"iv":"f3fac53ee2d76c293977d1af3a7d73bb"},"ciphertext":"c5034579cdf32d7a612c9a83801aad899abfebb7436712f363ecf89546bbcbce","kdf":"scrypt","kdfparams":{"salt":"78ff80ece5d681b1aecd829526388472d1889da233229fa5c1416e8f2035b7a8","n":131072,"dklen":32,"p":1,"r":8},"mac":"0f70eca6138ffe60b174308b6ab7a8a81a0d2b662e2cf5d8727443cf12af766c"}}';
}
It supports decryption of encrypted JSONs (A.K.A keystore).
// decrypting encrypted JSON.
const decrypted = await multichainWallet.getWalletFromEncryptedJson({
network: 'ethereum',
json:
'{"address":"1c082d1052fb44134a408651c01148adbfcce7fe","id":"abfb9f10-165a-4b7a-935d-51729f10c310","version":3,"Crypto":{"cipher":"aes-128-ctr","cipherparams":{"iv":"f3fac53ee2d76c293977d1af3a7d73bb"},"ciphertext":"c5034579cdf32d7a612c9a83801aad899abfebb7436712f363ecf89546bbcbce","kdf":"scrypt","kdfparams":{"salt":"78ff80ece5d681b1aecd829526388472d1889da233229fa5c1416e8f2035b7a8","n":131072,"dklen":32,"p":1,"r":8},"mac":"0f70eca6138ffe60b174308b6ab7a8a81a0d2b662e2cf5d8727443cf12af766c"}}',
password: 'walletpassword',
});
{
privateKey: '0x0f9e5c0bee6c7d06b95204ca22dea8d7f89bb04e8527a2c59e134d185d9af8ad',
address: '0x1C082D1052fb44134a408651c01148aDBFcCe7Fe'
}
Allows for fetching ERC20 tokens info from compatible blockchains by the token address
// getting token info.
const info = await multichainWallet.getTokenInfo({
address: '0x7fe03a082fd18a80a7dbd55e9b216bcf540557e4',
network: 'ethereum',
rpcUrl: 'https://rpc.ankr.com/eth_goerli',
}); // NOTE - For other EVM compatible blockchains all you have to do is change the rpcUrl.
{
name: 'Mocked USDT',
symbol: 'USDT',
decimals: 6,
address: '0x7fe03a082fd18a80a7dbd55e9b216bcf540557e4',
totalSupply: 1000000000000
}
Allows for fetching SPL tokens info on the solana by the token address. Note: Token has to be available on the solana token list registry
// getting token info.
const info = await multichainWallet.getTokenInfo({
address: '7Xn4mM868daxsGVJmaGrYxg8CZiuqBnDwUse66s5ALmr',
network: 'solana',
rpcUrl: 'https://api.devnet.solana.com',
cluster: 'devnet',
});
{
object;
}
Allows for fetching Waves based asset info
// getting token info.
const info = await multichainWallet.getTokenInfo({
network: 'waves',
rpcUrl: 'https://nodes-testnet.wavesnodes.com',
address: '39pnv8FVf3BX3xwtC6uhFxffy2sE3seXCPsf25eNn6qG',
});
{
name: 'T-BTC',
symbol: 'T-BTC',
address: '39pnv8FVf3BX3xwtC6uhFxffy2sE3seXCPsf25eNn6qG',
decimals: 8,
totalSupply: 2100000000000000
}
This can be used to make custom smart contract interaction by specifying the contract ABI and function types.
// Calling a read smart contract function.
const data = await multichainWallet.smartContractCall({
rpcUrl: 'https://rpc.ankr.com/eth_goerli',
network: 'ethereum',
contractAddress: '0x5592EC0cfb4dbc12D3aB100b257153436a1f0FEa',
method: 'transfer',
methodType: 'write',
params: ['0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22', '1000000000000000000'],
contractAbi: [
{
constant: false,
inputs: [
{ name: '_to', type: 'address' },
{ name: '_value', type: 'uint256' },
],
name: 'transfer',
outputs: [{ name: '', type: 'bool' }],
payable: false,
stateMutability: 'nonpayable',
type: 'function',
},
],
privateKey:
'0f9e5c0bee6c7d06b95204ca22dea8d7f89bb04e8527a2c59e134d185d9af8ad',
}); // NOTE - For other EVM compatible blockchains all you have to do is change the rpcUrl.
// calling a write smart contract function.
const data = await multichainWallet.smartContractCall({
rpcUrl: 'https://rpc.ankr.com/eth_goerli',
network: 'ethereum',
contractAddress: '0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D',
method: 'factory',
methodType: 'read',
params: [],
contractAbi: [
{
inputs: [],
name: 'factory',
outputs: [{ internalType: 'address', name: '', type: 'address' }],
stateMutability: 'view',
type: 'function',
},
],
}); // NOTE - For other EVM compatible blockchains all you have to do is change the rpcUrl.
// calling a read smart contract function.
const data = await multichainWallet.smartContractCall({
network: 'waves',
methodType: 'read',
rpcUrl: 'https://nodes-testnet.wavesnodes.com',
contractAddress: '3N9uzrTiArce1h9VCqK3QUUZmFqBgg5rZSW',
method: '3N1gVpA5MVY4WsMpzQ6RfcscpDDdqBbLx6n_balance',
params: [],
});
// calling a write smart contract function.
const data = await multichainWallet.smartContractCall({
network: 'waves',
methodType: 'write',
rpcUrl: 'https://nodes-testnet.wavesnodes.com',
contractAddress: '3N9uzrTiArce1h9VCqK3QUUZmFqBgg5rZSW',
privateKey:
'mushroom deliver work spray hire nuclear wrong deputy march six midnight outside motor differ adult',
method: 'deposit',
payment: [{ assetId: null, amount: 1000 }],
params: [],
});
Some of the parameters available in this function are:
The optional parameters that the object takes in are: value, contractAbi, gas price, gas limit, nonce, and private key.
{
data: object;
}
Contributions are welcome! Kindly refer to the contribution guidelines.
FAQs
A Multichain crypto wallet library that supports Ethereum, Bitcoin, Solana, Waves and other EVM compatible blockchains E.g. Binance Smart Chain, Polygon, Avalanche etc.
We found that multichain-wallet demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
A malicious npm package disguised as a WhatsApp client is exploiting authentication flows with a remote kill switch to exfiltrate data and destroy files.
Security News
PyPI now supports digital attestations, enhancing security and trust by allowing package maintainers to verify the authenticity of Python packages.
Security News
GitHub removed 27 malicious pull requests attempting to inject harmful code across multiple open source repositories, in another round of low-effort attacks.