Wondering what’s next for npm?Check out our public roadmap! »

    TypeScript icon, indicating that this package has built-in type declarations

    1.0.41 • Public • Published


    This is a fork of the HD Wallet-enabled Web3 provider from @truffle/hdwallet-provider.

    This fork updates the web3 package and fixes typings.

    Use it to sign transactions for addresses derived from a 12 or 24 word mnemonic.


    npm install @switcheo/hdwallet-provider


    • Node >= 7.6
    • Web3 ^1.2.9

    General Usage

    You can use this provider wherever a Web3 provider is needed, not just in Truffle. For Truffle-specific usage, see next section.

    const HDWalletProvider = require("@switcheo/hdwallet-provider");
    const Web3 = require("web3");
    const mnemonic = "mountains supernatural bird..."; // 12 word mnemonic
    let provider = new HDWalletProvider(mnemonic, "http://localhost:8545");
    // Or, alternatively pass in a zero-based address index.
    provider = new HDWalletProvider(mnemonic, "http://localhost:8545", 5);
    // Or, use your own hierarchical derivation path
    provider = new HDWalletProvider(mnemonic, "http://localhost:8545", 5, 1, true, "m/44'/137'/0'/0/");
    // HDWalletProvider is compatible with Web3. Use it at Web3 constructor, just like any other Web3 Provider
    const web3 = new Web3(provider);
    // Or, if web3 is alreay initialized, you can call the 'setProvider' on web3, web3.eth, web3.shh and/or web3.bzz
    // ...
    // Write your code here.
    // ...
    // At termination, `provider.engine.stop()' should be called to finish the process elegantly.

    By default, the HDWalletProvider will use the address of the first address that's generated from the mnemonic. If you pass in a specific index, it'll use that address instead.


    Parameter Type Default Required Description
    mnemonic *string* null [x] 12 word mnemonic which addresses are created from.
    provider string\|object null [x] URI or Ethereum client to send all other non-transaction-related Web3 requests
    address_index number 0 [ ] If specified, will tell the provider to manage the address at the index specified
    num_addresses number 1 [ ] If specified, will create number addresses when instantiated
    shareNonce boolean true [ ] If false, a new WalletProvider will track its own nonce-state
    wallet_hdpath string "m/44'/60'/0'/0/" [ ] If specified, will tell the wallet engine what derivation path should use to derive addresses.

    Private Keys

    Instead of a mnemonic, you can alternatively provide a private key or array of private keys as the first parameter. When providing an array, address_index and num_addresses are fully supported.

    const HDWalletProvider = require("@switcheo/hdwallet-provider");
    //load single private key as string
    let provider = new HDWalletProvider("3f841bf589fdf83a521e55d51afddc34fa65351161eead24f064855fc29c9580", "http://localhost:8545");
    // Or, pass an array of private keys, and optionally use a certain subset of addresses
    const privateKeys = [
    provider = new HDWalletProvider(privateKeys, "http://localhost:8545", 0, 2); //start at address_index 0 and load both addresses

    NOTE: This is just an example. NEVER hard code production/mainnet private keys in your code or commit them to git. They should always be loaded from environment variables or a secure secret management system.

    Truffle Usage

    You can easily use this within a Truffle configuration. For instance:


    const HDWalletProvider = require("@switcheo/hdwallet-provider");
    const mnemonic = "mountains supernatural bird ...";
    module.exports = {
      networks: {
        development: {
          host: "localhost",
          port: 8545,
          network_id: "*" // Match any network id
        ropsten: {
          // must be a thunk, otherwise truffle commands may hang in CI
          provider: () =>
            new HDWalletProvider(mnemonic, "https://ropsten.infura.io/v3/YOUR-PROJECT-ID",
                0, 1, true, "m/44'/1'/0'/0/"
          network_id: '3',


    npm i @switcheo/hdwallet-provider

    DownloadsWeekly Downloads






    Unpacked Size

    24.4 kB

    Total Files


    Last publish


    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar