Integrating with web3 libraries

Privy's ConnectedWallet object is fully compatible with popular web3 libraries for interfacing wallets, including viem, wagmi, ethers, and web3js.

Read below to learn how to best integrate Privy alongside these libraries.

Viem

Viem represents connected wallets as a wallet client object, which you can use to get information about the current wallet or the request signatures and transactions.

To get a viem wallet client for a user's connected wallet, first import your desired network from the viem/chains package and import the createWalletClient method and custom transport from viem:

import {createWalletClient, custom} from 'viem';
// Replace `sepolia` with your desired network
import {sepolia} from 'viem/chains';

Then, find your desired wallet from the wallets array and switch its network to the chain you imported, using the wallet's switchChain method:

const {wallets} = useWallets();
const wallet = wallets[0]; // Replace this with your desired wallet
await wallet.switchChain(sepolia.id);

Lastly, get the wallet's EIP1193 provider using the wallet's getEthereumProvider method and pass it to viem's createWalletClient method like so:

const provider = await wallet.getEthereumProvider();
const walletClient = createWalletClient({
  chain: sepolia,
  transport: custom(provider),
});

You can then use the wallet client to get information about the wallet or request signatures and transactions.

Wagmi

Privy is fully compatible with wagmi. Please see our wagmi guide for setting up the integration.

Ethers

Ethers v5

const privyProvider = await wallet.getEthereumProvider();
const provider = new ethers.providers.Web3Provider(privyProvider);

Ethers v6

const provider = await wallet.getEthereumProvider();
const ethersProvider = new ethers.BrowserProvider(provider);
const signer = ethersProvider.getSigner();

Web3.js

Web3.js represents connected wallets as a Web3 object, which you can use to get information about the current wallet or the request signatures and transactions.

To get a Web3js provider for a user's connected wallet, first find your desired wallet from the wallets array and switch it to your desired network, using the wallet's switchChain method:

const {wallets} = useWallets();
const wallet = wallets[0]; // Replace this with your desired wallet
await wallet.switchChain(sepolia.id);

Then, get the wallet's EIP1193 provider using the wallet's getEthereumProvider method and pass it to Web3js's Web3 constructor like so:

const provider = await wallet.getEthereumProvider();
const web3 = new Web3(provider);

You can then use the Web3 provider to get information about the wallet or request signatures and transactions.