Interfacing with common libraries

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({
    account: wallet.address as Hex,
    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.

​

Integrating with viem

First, import the necessary methods, objects, and networks from viem:

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

Next, get an EIP-1193 provider for the user’s embedded wallet, and switch its network to your desired network:

const provider = await wallet.getProvider();
await provider.request({
    method: 'wallet_switchEthereumChain',
    // Replace '0x1' with the chain ID of your desired network
    params: [{chainId: '0x1'}],
});

Lastly, initialize a viem Wallet Client from the EIP-1193 provider:

const walletClient = createWalletClient({
    // Replace this with your desired network that you imported from viem
    chain: mainnet,
    transport: custom(provider),
});

You can now use methods implemented by viem’s Wallet Client, including signMessage, signTypedData, and sendTransaction!

​

Integrating with ethers

First, import ethers:

import {ethers} from 'ethers';

Next, get an EIP-1193 provider for the user’s embedded wallet, and switch its network to your desired network:

await provider.request({
    method: 'wallet_switchEthereumChain',
    // Replace '0x1' with the chain ID of your desired network
    params: [{chainId: '0x1'}],
});

Lastly, initialize an ethers provider and signer from this EIP-1193 provider:

const ethersProvider = new ethers.providers.Web3Provider(provider);
const ethersSigner = ethersProvider.getSigner();

You can then use methods implemented by ethers’ providers and signers, including signMessage and sendTransaction.

​

Integrating with web3.js

First, import web3:

import {Web3} from 'web3';

Next, get an EIP-1193 provider for the user’s embedded wallet, and switch its network to your desired network:

await provider.request({
    method: 'wallet_switchEthereumChain',
    // Replace '0x1' with the chain ID of your desired network
    params: [{chainId: '0x1'}],
});

Lastly, initialize an ethers provider and signer from this EIP-1193 provider:

const web3 = new Web3(provider);
const ethersSigner = ethersProvider.getSigner();

You can then use interfaces by web3.js for signing messages, sending transactions, and more.