Import a wallet

Privy enables your users to import a private key into their embedded wallet.

This allows users to bring an existing wallet into your application, enabling them to manage their assets directly within your app. For example, a user can import their MetaMask wallet private key to access and manage their assets within your app seamlessly. This method can also be used by developers to migrate users from a different embedded wallet provider to Privy.

Wallet import is only available via Privy’s React SDK, for EVM networks and Solana. Support for additional SDKs and chains is under active development.

Importing a wallet by private key

To have your user import a private key into their embedded wallet, use the importWallet method from the useImportWallet hook. As a parameter to this method, pass an object containing the user’s privateKey as a string.

import {usePrivy, useImportWallet} from '@privy-io/react-auth';

function ImportWalletButton() {
  const {ready, authenticated} = usePrivy();
  const {importWallet} = useImportWallet();
  const [privateKey, setPrivateKey] = useState('');

  const handleImport = async () => {
    try {
      const wallet = await importWallet({privateKey: privateKey});
      console.log('Wallet imported successfully:', wallet);
    } catch (error) {
      console.error('Failed to import wallet:', error);
    }
  };

  // Check that your user is authenticated
  const isAuthenticated = ready && authenticated;

  return (
    <div>
      <input
        type="text"
        value={privateKey}
        onChange={(e) => setPrivateKey(e.target.value)}
        placeholder="Enter your private key"
      />
      <button onClick={handleImport} disabled={!isAuthenticated}>
        Import my wallet
      </button>
    </div>
  );
}

import {usePrivy, useImportWallet} from '@privy-io/react-auth';

function ImportWalletButton() {
  const {ready, authenticated} = usePrivy();
  const {importWallet} = useImportWallet();
  const [privateKey, setPrivateKey] = useState('');

  const handleImport = async () => {
    try {
      const wallet = await importWallet({privateKey: privateKey});
      console.log('Wallet imported successfully:', wallet);
    } catch (error) {
      console.error('Failed to import wallet:', error);
    }
  };

  // Check that your user is authenticated
  const isAuthenticated = ready && authenticated;

  return (
    <div>
      <input
        type="text"
        value={privateKey}
        onChange={(e) => setPrivateKey(e.target.value)}
        placeholder="Enter your private key"
      />
      <button onClick={handleImport} disabled={!isAuthenticated}>
        Import my wallet
      </button>
    </div>
  );
}

import {usePrivy} from '@privy-io/react-auth';
import {useImportWallet} from '@privy-io/react-auth/solana';

function ImportWalletButton() {
  const {ready, authenticated} = usePrivy();
  const {importWallet} = useImportWallet();
  const [privateKey, setPrivateKey] = useState('');

  const handleImport = async () => {
    try {
      const wallet = await importWallet({privateKey: privateKey});
      console.log('Wallet imported successfully:', wallet);
    } catch (error) {
      console.error('Failed to import wallet:', error);
    }
  };

  // Check that your user is authenticated
  const isAuthenticated = ready && authenticated;

  return (
    <div>
      <input
        type="text"
        value={privateKey}
        onChange={(e) => setPrivateKey(e.target.value)}
        placeholder="Enter your private key"
      />
      <button onClick={handleImport} disabled={!isAuthenticated}>
        Import my wallet
      </button>
    </div>
  );
}

If importWallet succeeds, the imported wallet will be added to the user’s linkedAccounts and the wallets array returned by the useWallets hook, with an imported field that is marked true. As an example, you can find the imported wallet like so:

import {useWallets} from '@privy-io/react-auth';

function ImportedWalletInfo() {
  const {wallets} = useWallets();
  const importedWallet = wallets.find((wallet) => wallet.imported);
  return (
    <div>
      <h3>Imported Wallet</h3>
      {importedWallet ? <p>Address: {importedWallet.address}</p> : <p>No imported wallet found</p>}
    </div>
  );
}

import {useWallets} from '@privy-io/react-auth';

function ImportedWalletInfo() {
  const {wallets} = useWallets();
  const importedWallet = wallets.find((wallet) => wallet.imported);
  return (
    <div>
      <h3>Imported Wallet</h3>
      {importedWallet ? <p>Address: {importedWallet.address}</p> : <p>No imported wallet found</p>}
    </div>
  );
}

import {useSolanaWallets} from '@privy-io/react-auth/solana';

function ImportedWalletInfo() {
  const {wallets} = useSolanaWallets();
  const importedWallet = wallets.find((wallet) => wallet.imported);
  return (
    <div>
      <h3>Imported Wallet</h3>
      {importedWallet ? <p>Address: {importedWallet.address}</p> : <p>No imported wallet found</p>}
    </div>
  );
}

This method will error if the provided private key is not valid or if the user has previously imported a wallet by private key.

Using imported EVM embedded wallets

You can request signatures and transactions from imported wallets using Privy’s native methods, the wallet’s EIP1193 provider, or a third-party library like viem or ethers.

Using Privy’s native signature and transaction methods

To use Privy’s native signMessage, signTypedData, and sendTransaction methods with an imported wallet, simply pass the address for the imported wallet as the final optional parameter to these methods:

const {signMessage} = useSignMessage();
const signature = await signMessage(
  {
    message: 'insert-message-to-sign'
  },
  {
    uiOptions: insertOptionalUIConfigOrUndefined,
    address: 'insert-imported-wallet-address' // Replace with the imported wallet address in EIP55 format
  }
);

const {signMessage} = useSignMessage();
const signature = await signMessage(
  {
    message: 'insert-message-to-sign'
  },
  {
    uiOptions: insertOptionalUIConfigOrUndefined,
    address: 'insert-imported-wallet-address' // Replace with the imported wallet address in EIP55 format
  }
);

const {signTypedData} = useSignTypedData();
const signature = await signTypedData(insertTypedDataObject, {
  uiOptions: insertOptionalUIConfigOrUndefined,
  address: 'insert-imported-wallet-address' // Replace with the imported wallet address in EIP55 format
});

const {sendTransaction} = useSendTransaction();
const signature = await sendTransaction(insertTransactionRequest, {
  address: 'insert-imported-wallet-address', // Replace with the imported wallet address in EIP55 format
  uiOptions: insertOptionalUIConfigOrUndefined,
  fundWalletConfig: insertOptionalFundWalletConfigOrUndefined
});

Using the EIP1193 provider, viem, and ethers

You can also request signatures and transactions from an imported wallet using the wallet’s EIP1193 provider or a library like viem or ethers.

To get the EIP1193 provider for the imported wallet, first find the corresponding ConnectedWallet object from the useWallets array:

const {wallets} = useWallets();
// `ConnectedWallet.imported` is set to `true` for imported wallets
const importedWallet = wallets.find(
  (wallet) => wallet.walletClientType === 'privy' && wallet.imported
);

Then, call the object’s getEthereumProvider method to get an EIP1193 provider for that wallet:

const provider = await importedWallet.getEthereumProvider();

You can then easily pass that EIP1193 provider to a library like viem or ethers to use those libraries’ interfaces to send requests to the wallet.

Using imported Solana embedded wallets

You can request signatures and send transactions using your imported Solana wallet just like with regular embedded Solana wallets.

const {wallets} = useSolanaWallets();
// `ConnectedWallet.imported` is set to `true` for imported wallets
const importedWallet = wallets.find(
  (wallet) => wallet.walletClientType === 'privy' && wallet.imported
);

Then, call the object’s signMessage method to sign.

const signature = await importedWallet.sign('Sign this message!');

Exporting imported embedded wallets

Privy enables your users to export the full private key for their embedded wallet, even if it was imported. This allows them to use their embedded wallet address with another wallet client, such as MetaMask in any application.

To have your user export their embedded wallet’s private key, use the exportWallet method from the usePrivy hook. As a parameter to this method, you must pass an object containing an address field with the user’s imported wallet address as a string.

As an example, you might have an export wallet button in your app like so:

import {usePrivy, useWallets} from '@privy-io/react-auth';

function ExportWalletButton() {
  const {ready, authenticated, exportWallet} = usePrivy();
  const {wallets} = useWallets();
  // Check that your user is authenticated
  const isAuthenticated = ready && authenticated;
  // Find your user's imported wallet
  const importedWallet = wallets.find(
    (wallet) => wallet.walletClientType === 'privy' && wallet.imported
  );

  const exportImportedWallet = async () => {
    if (!importedWallet) return;
    await exportWallet({address: importedWallet.address});
  };

  return (
    <button onClick={exportImportedWallet} disabled={!isAuthenticated || !importedWallet}>
      Export my wallet
    </button>
  );
}

As an example, you might have an export wallet button in your app like so:

import {usePrivy, useWallets} from '@privy-io/react-auth';

function ExportWalletButton() {
  const {ready, authenticated, exportWallet} = usePrivy();
  const {wallets} = useWallets();
  // Check that your user is authenticated
  const isAuthenticated = ready && authenticated;
  // Find your user's imported wallet
  const importedWallet = wallets.find(
    (wallet) => wallet.walletClientType === 'privy' && wallet.imported
  );

  const exportImportedWallet = async () => {
    if (!importedWallet) return;
    await exportWallet({address: importedWallet.address});
  };

  return (
    <button onClick={exportImportedWallet} disabled={!isAuthenticated || !importedWallet}>
      Export my wallet
    </button>
  );
}

To have your user export their embedded wallet’s private key, use the exportWallet method from the useSolanaWallets hook. As a parameter to this method, you must pass an object containing an address field with the user’s imported wallet address as a string.

As an example, you might have an export wallet button in your app like so:

import {usePrivy} from '@privy-io/react-auth';
import {useSolanaWallets} from '@privy-io/react-auth/solana';

function ExportWalletButton() {
  const {ready, authenticated} = usePrivy();
  const {wallets, exportWallet} = useSolanaWallets();
  // Check that your user is authenticated
  const isAuthenticated = ready && authenticated;
  // Find your user's imported wallet
  const importedWallet = wallets.find(
    (wallet) => wallet.walletClientType === 'privy' && wallet.imported
  );

  const exportImportedWallet = async () => {
    if (!importedWallet) return;
    await exportWallet({address: importedWallet.address});
  };

  return (
    <button onClick={exportImportedWallet} disabled={!isAuthenticated || !importedWallet}>
      Export my wallet
    </button>
  );
}

On this page

Importing a wallet by private key
Using imported EVM embedded wallets
Using Privy’s native signature and transaction methods
Using the EIP1193 provider, viem, and ethers
Using imported Solana embedded wallets
Exporting imported embedded wallets

Privy enables your users to import a private key into their embedded wallet.

Wallet import is only available via Privy’s React SDK, for EVM networks and Solana. Support for additional SDKs and chains is under active development.

Importing a wallet by private key

import {usePrivy, useImportWallet} from '@privy-io/react-auth';

function ImportWalletButton() {
  const {ready, authenticated} = usePrivy();
  const {importWallet} = useImportWallet();
  const [privateKey, setPrivateKey] = useState('');

  const handleImport = async () => {
    try {
      const wallet = await importWallet({privateKey: privateKey});
      console.log('Wallet imported successfully:', wallet);
    } catch (error) {
      console.error('Failed to import wallet:', error);
    }
  };

  // Check that your user is authenticated
  const isAuthenticated = ready && authenticated;

  return (
    <div>
      <input
        type="text"
        value={privateKey}
        onChange={(e) => setPrivateKey(e.target.value)}
        placeholder="Enter your private key"
      />
      <button onClick={handleImport} disabled={!isAuthenticated}>
        Import my wallet
      </button>
    </div>
  );
}

import {usePrivy, useImportWallet} from '@privy-io/react-auth';

function ImportWalletButton() {
  const {ready, authenticated} = usePrivy();
  const {importWallet} = useImportWallet();
  const [privateKey, setPrivateKey] = useState('');

  const handleImport = async () => {
    try {
      const wallet = await importWallet({privateKey: privateKey});
      console.log('Wallet imported successfully:', wallet);
    } catch (error) {
      console.error('Failed to import wallet:', error);
    }
  };

  // Check that your user is authenticated
  const isAuthenticated = ready && authenticated;

  return (
    <div>
      <input
        type="text"
        value={privateKey}
        onChange={(e) => setPrivateKey(e.target.value)}
        placeholder="Enter your private key"
      />
      <button onClick={handleImport} disabled={!isAuthenticated}>
        Import my wallet
      </button>
    </div>
  );
}

import {usePrivy} from '@privy-io/react-auth';
import {useImportWallet} from '@privy-io/react-auth/solana';

function ImportWalletButton() {
  const {ready, authenticated} = usePrivy();
  const {importWallet} = useImportWallet();
  const [privateKey, setPrivateKey] = useState('');

  const handleImport = async () => {
    try {
      const wallet = await importWallet({privateKey: privateKey});
      console.log('Wallet imported successfully:', wallet);
    } catch (error) {
      console.error('Failed to import wallet:', error);
    }
  };

  // Check that your user is authenticated
  const isAuthenticated = ready && authenticated;

  return (
    <div>
      <input
        type="text"
        value={privateKey}
        onChange={(e) => setPrivateKey(e.target.value)}
        placeholder="Enter your private key"
      />
      <button onClick={handleImport} disabled={!isAuthenticated}>
        Import my wallet
      </button>
    </div>
  );
}

import {useWallets} from '@privy-io/react-auth';

function ImportedWalletInfo() {
  const {wallets} = useWallets();
  const importedWallet = wallets.find((wallet) => wallet.imported);
  return (
    <div>
      <h3>Imported Wallet</h3>
      {importedWallet ? <p>Address: {importedWallet.address}</p> : <p>No imported wallet found</p>}
    </div>
  );
}

import {useWallets} from '@privy-io/react-auth';

function ImportedWalletInfo() {
  const {wallets} = useWallets();
  const importedWallet = wallets.find((wallet) => wallet.imported);
  return (
    <div>
      <h3>Imported Wallet</h3>
      {importedWallet ? <p>Address: {importedWallet.address}</p> : <p>No imported wallet found</p>}
    </div>
  );
}

import {useSolanaWallets} from '@privy-io/react-auth/solana';

function ImportedWalletInfo() {
  const {wallets} = useSolanaWallets();
  const importedWallet = wallets.find((wallet) => wallet.imported);
  return (
    <div>
      <h3>Imported Wallet</h3>
      {importedWallet ? <p>Address: {importedWallet.address}</p> : <p>No imported wallet found</p>}
    </div>
  );
}

This method will error if the provided private key is not valid or if the user has previously imported a wallet by private key.

Using imported EVM embedded wallets

You can request signatures and transactions from imported wallets using Privy’s native methods, the wallet’s EIP1193 provider, or a third-party library like viem or ethers.

Using Privy’s native signature and transaction methods

const {signMessage} = useSignMessage();
const signature = await signMessage(
  {
    message: 'insert-message-to-sign'
  },
  {
    uiOptions: insertOptionalUIConfigOrUndefined,
    address: 'insert-imported-wallet-address' // Replace with the imported wallet address in EIP55 format
  }
);

const {signMessage} = useSignMessage();
const signature = await signMessage(
  {
    message: 'insert-message-to-sign'
  },
  {
    uiOptions: insertOptionalUIConfigOrUndefined,
    address: 'insert-imported-wallet-address' // Replace with the imported wallet address in EIP55 format
  }
);

const {signTypedData} = useSignTypedData();
const signature = await signTypedData(insertTypedDataObject, {
  uiOptions: insertOptionalUIConfigOrUndefined,
  address: 'insert-imported-wallet-address' // Replace with the imported wallet address in EIP55 format
});

const {sendTransaction} = useSendTransaction();
const signature = await sendTransaction(insertTransactionRequest, {
  address: 'insert-imported-wallet-address', // Replace with the imported wallet address in EIP55 format
  uiOptions: insertOptionalUIConfigOrUndefined,
  fundWalletConfig: insertOptionalFundWalletConfigOrUndefined
});

Using the EIP1193 provider, viem, and ethers

You can also request signatures and transactions from an imported wallet using the wallet’s EIP1193 provider or a library like viem or ethers.

To get the EIP1193 provider for the imported wallet, first find the corresponding ConnectedWallet object from the useWallets array:

const {wallets} = useWallets();
// `ConnectedWallet.imported` is set to `true` for imported wallets
const importedWallet = wallets.find(
  (wallet) => wallet.walletClientType === 'privy' && wallet.imported
);

Then, call the object’s getEthereumProvider method to get an EIP1193 provider for that wallet:

const provider = await importedWallet.getEthereumProvider();

You can then easily pass that EIP1193 provider to a library like viem or ethers to use those libraries’ interfaces to send requests to the wallet.

Using imported Solana embedded wallets

You can request signatures and send transactions using your imported Solana wallet just like with regular embedded Solana wallets.

const {wallets} = useSolanaWallets();
// `ConnectedWallet.imported` is set to `true` for imported wallets
const importedWallet = wallets.find(
  (wallet) => wallet.walletClientType === 'privy' && wallet.imported
);

Then, call the object’s signMessage method to sign.

const signature = await importedWallet.sign('Sign this message!');

Exporting imported embedded wallets

As an example, you might have an export wallet button in your app like so:

import {usePrivy, useWallets} from '@privy-io/react-auth';

function ExportWalletButton() {
  const {ready, authenticated, exportWallet} = usePrivy();
  const {wallets} = useWallets();
  // Check that your user is authenticated
  const isAuthenticated = ready && authenticated;
  // Find your user's imported wallet
  const importedWallet = wallets.find(
    (wallet) => wallet.walletClientType === 'privy' && wallet.imported
  );

  const exportImportedWallet = async () => {
    if (!importedWallet) return;
    await exportWallet({address: importedWallet.address});
  };

  return (
    <button onClick={exportImportedWallet} disabled={!isAuthenticated || !importedWallet}>
      Export my wallet
    </button>
  );
}

As an example, you might have an export wallet button in your app like so:

import {usePrivy, useWallets} from '@privy-io/react-auth';

function ExportWalletButton() {
  const {ready, authenticated, exportWallet} = usePrivy();
  const {wallets} = useWallets();
  // Check that your user is authenticated
  const isAuthenticated = ready && authenticated;
  // Find your user's imported wallet
  const importedWallet = wallets.find(
    (wallet) => wallet.walletClientType === 'privy' && wallet.imported
  );

  const exportImportedWallet = async () => {
    if (!importedWallet) return;
    await exportWallet({address: importedWallet.address});
  };

  return (
    <button onClick={exportImportedWallet} disabled={!isAuthenticated || !importedWallet}>
      Export my wallet
    </button>
  );
}

As an example, you might have an export wallet button in your app like so:

import {usePrivy} from '@privy-io/react-auth';
import {useSolanaWallets} from '@privy-io/react-auth/solana';

function ExportWalletButton() {
  const {ready, authenticated} = usePrivy();
  const {wallets, exportWallet} = useSolanaWallets();
  // Check that your user is authenticated
  const isAuthenticated = ready && authenticated;
  // Find your user's imported wallet
  const importedWallet = wallets.find(
    (wallet) => wallet.walletClientType === 'privy' && wallet.imported
  );

  const exportImportedWallet = async () => {
    if (!importedWallet) return;
    await exportWallet({address: importedWallet.address});
  };

  return (
    <button onClick={exportImportedWallet} disabled={!isAuthenticated || !importedWallet}>
      Export my wallet
    </button>
  );
}

On this page

Importing a wallet by private key
Using imported EVM embedded wallets
Using Privy’s native signature and transaction methods
Using the EIP1193 provider, viem, and ethers
Using imported Solana embedded wallets
Exporting imported embedded wallets

Importing a wallet by private key

Using imported EVM embedded wallets

Using Privy’s native signature and transaction methods

Using the EIP1193 provider, viem, and ethers

Using imported Solana embedded wallets

Exporting imported embedded wallets

API reference

Wallets

Account funding

Policies

Transactions

Key quorums

Users

Import a wallet

Importing a wallet by private key

Using imported EVM embedded wallets

Using Privy’s native signature and transaction methods

Using the EIP1193 provider, viem, and ethers

Using imported Solana embedded wallets

Exporting imported embedded wallets

​Importing a wallet by private key

​Using imported EVM embedded wallets

​Using Privy’s native signature and transaction methods

​Using the EIP1193 provider, viem, and ethers

​Using imported Solana embedded wallets

​Exporting imported embedded wallets

API reference

Wallets

Account funding

Policies

Transactions

Key quorums

Users

​Importing a wallet by private key

​Using imported EVM embedded wallets

​Using Privy’s native signature and transaction methods

​Using the EIP1193 provider, viem, and ethers

​Using imported Solana embedded wallets

​Exporting imported embedded wallets

Importing a wallet by private key

Using imported EVM embedded wallets

Using Privy’s native signature and transaction methods

Using the EIP1193 provider, viem, and ethers

Using imported Solana embedded wallets

Exporting imported embedded wallets

Importing a wallet by private key

Using imported EVM embedded wallets

Using Privy’s native signature and transaction methods

Using the EIP1193 provider, viem, and ethers

Using imported Solana embedded wallets

Exporting imported embedded wallets