Integrating with web3 libraries

Privy's ConnectedWallet object is fully compatible with popular web3 libraries for interfacing wallets, including ethers, viem, wagmi, 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.

Ethers

Ethers represents connected wallets as a provider, which can be used to take read-only actions with the wallet, and a signer, which can be used to take write actions (signatures and transactions).

To get an ethers provider and signer for a user's 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(11155111); // Replace this with your desired chain ID

Then, call the wallet's getEthersProvider method to get a provider:

const provider = await wallet.getEthersProvider();

Then, call the provider's getSigner method to get the corresponding signer:

const signer = provider.getSigner();

You can then use the provider and signer 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.

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.