HD wallets - Privy Docs

Privy enables you to import HD wallets for use via the Privy API. This allows you to migrate wallets from external sources to Privy, including from a different wallet provider. Or, your app can enable users to bring an existing external wallet into your application in order to access and manage their assets within your app seamlessly.

Importing a wallet

To import an HD wallet, you’ll provide your 12 or 24 word BIP39 mnemonic and the specific address and index you’d like to import.

If you’d like to import multiple addresses for the same HD wallet, you can make multiple import calls with the same mnemonic and each index/address pair you’d like to import.

To import an HD wallet with the NodeJS SDK, use the import method from the Privy client’s wallets() interface. The Privy client will encrypt your mnemonic for secure transmission to the TEE. See architecture for more details.

Ethereum
Solana

import {PrivyClient} from '@privy-io/node';

const privy = new PrivyClient({
  appId: 'your-app-id',
  appSecret: 'your-app-secret'
});

try {
  const wallet = await privy.wallets().import({
    wallet: {
      entropy_type: 'hd',
      address: '<your-wallet-address>',
      chain_type: 'ethereum',
      private_key: '<your-bip39-mnemonic>',
      index: 0 // your wallet index, typically 0 for the first address
    }
  });
} catch (error) {
  console.error('Failed to import wallet:', error);
}

import {PrivyClient} from '@privy-io/node';

const privy = new PrivyClient({
  appId: 'your-app-id',
  appSecret: 'your-app-secret'
});

try {
  const wallet = await privy.wallets().import({
    wallet: {
      entropy_type: 'hd',
      address: '<your-wallet-address>',
      chain_type: 'solana',
      private_key: '<your-bip39-mnemonic>',
      index: 0 // your wallet index, typically 0 for the first address
    }
  });
} catch (error) {
  console.error('Failed to import wallet:', error);
}

The returned wallet is type Wallet. See get wallet by ID for type definition.When importing a wallet, it is also possible to provide an owner, policies, or signers.

import {PrivyClient} from '@privy-io/node';

const privy = new PrivyClient({
  appId: 'your-app-id',
  appSecret: 'your-app-secret'
});

const wallet = await privy.wallets().import({
  wallet: {
    entropy_type: 'hd',
    address: '<your-wallet-address>',
    chain_type: 'solana', // or "ethereum"
    private_key: '<your-bip39-mnemonic>',
    index: 0 // your wallet index, typically 0 for the first address
  },
  owner_id: '<your-owner-id>',
  additional_signers: [{signer_id: '<your-signer-id>'}],
  policy_ids: ['<your-policy-id>']
});

Using imported wallets

Imported wallets function the same way as Privy-generated wallets. See the API reference for Ethereum or Solana for information about how to send transactions and execute other wallet operations.

⌘I