Integrating with EIP-7702

EIP-7702 is an upgrade to EVM blockchains that enables externally owned accounts (EOAs) to set their code to that of a smart contract. In practical terms, this means that EOA wallets will gain AA (account abstraction) capabilities such as transaction bundling, gas sponsorship, and custom permissions.

Privy supports all low level interfaces required by 7702 - signing authorizations and sending type 4 transactions, allowing you to use any implementation of EIP-7702. Use the following guides to get started with EIP-7702 in your application:

Signing EIP-7702 authorizations

Privy provides methods to sign EIP-7702 authorizations using the user’s embedded wallet. This authorization is a cryptographic signature that allows an EOA to set its code to that of a smart contract, enabling the EOA to behave like a smart account.

Learn more about signing EIP-7702 authorizations in our dedicated guide.

Learn more about using the signed authorization in the integration guides below!

Using EIP-7702 capabilities

In this guide, we will transform your Privy embedded wallet into a smart wallet with features like gas sponsorship, batch transactions, granular permissions, and more using EIP-7702 support from Alchemy.

0. Install dependencies

In your app’s repository, install the required dependencies from Privy, Alchemy, and viem:

The Alchemy SDK currently requires viem to be pinned to 2.22.6

npm i @privy-io/react-auth @account-kit/smart-contracts @account-kit/infra @aa-sdk/core [email protected]

1. Create an Alchemy account and get your API key

Create an app: visit the Alchemy dashboard to create a new app, if you don’t already have one.
- Make sure to enable networks that support EIP-7702 such as Ethereum Mainnet or Sepolia.
- Save the app’s API Key that will be used later.
Enable gas sponsorship: visit the Gas Manager dashboard and create a new sponsorship policy for the app you created in step 1. This policy will be used to set rules on how much of user’s gas you want to sponsor.
- Make sure to enable gas sponsorship on a chain that support EIP-7702 such as Ethereum Mainnet or Sepolia.
- Save the Policy ID that will be used later.

Now that you have your API key and Policy ID, you can set up your smart wallets.

2. Configure Privy settings

If you’re already using a Privy embedded wallet, update your configuration to support EIP-7702 with embedded wallets. If you don’t yet have authentication configured, you can follow this guide to get set up.

Make sure your PrivyProvider has the following embeddedWallets settings and ensure you set the defaultChain and supportedChains to the 7702 supported chain you chose in step 1.

import { sepolia } from "@account-kit/infra";
<PrivyProvider
	appId={process.env.NEXT_PUBLIC_PRIVY_APP_ID || ""}
	config={{
	  embeddedWallets: {
	    showWalletUIs: false,
	    createOnLogin: "all-users",
	  },
	  defaultChain: sepolia,
	  supportedChains: [sepolia],
	}}
>

3. Adapt Privy signer to a smart account signer

Now that you have authentication working, adapt the Privy signer to be able to sign 7702 authorizations to upgrade to smart accounts.

1. Get the Privy embedded wallet

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

const {wallets} = useWallets();
const embeddedWallet = wallets.find((x) => x.walletClientType === 'privy');

2. Create a SmartAccountSigner instance

import {sepolia, alchemy} from '@account-kit/infra'; // make sure to import your chain from account-kit, not viem
import {useSign7702Authorization} from '@privy-io/react-auth';
import {SmartAccountSigner, WalletClientSigner} from '@aa-sdk/core';
import {createWalletClient, custom, Hex} from 'viem';
import {Authorization} from 'viem/experimental';

const {signAuthorization} = useSign7702Authorization();

async function create7702signer() {
  const baseSigner = new WalletClientSigner(
    createWalletClient({
      account: embeddedWallet!.address as Hex,
      chain: sepolia,
      transport: custom(await embeddedWallet!.getEthereumProvider())
    }),
    'privy'
  );

  const signer: SmartAccountSigner = {
    getAddress: baseSigner.getAddress,
    signMessage: baseSigner.signMessage,
    signTypedData: baseSigner.signTypedData,
    signerType: baseSigner.signerType,
    inner: baseSigner.inner,
    signAuthorization: async (
      unsignedAuth: Authorization<number, false>
    ): Promise<Authorization<number, true>> => {
      const signature = await signAuthorization(unsignedAuth);

      return {
        ...unsignedAuth,
        ...{
          r: signature.r!,
          s: signature.s!,
          v: signature.v!
        }
      };
    }
  };

  return signer;
}

4. Upgrade to smart accounts and send sponsored transactions

Now that you have a SmartAccountSigner instance, follow this guide to create a smart account client (createModularAccountV2Client ) and start sending sponsored transactions. You’ll need:

the SmartAccountSigner instance defined in step 3
the API key and the policy ID from step 1

Once you define the client, you can send sponsored transactions with your embedded EOA and access other advanced smart account features! This client will handle all of the logic of delegating to a new smart account, if not already, and signing transactions. If you don’t yet have a signer, follow this guide to get set up.

Next steps

You just upgraded your EOA and sent your first sponsored transaction using EIP-7702!

If you want to leverage other smart account capabilities such as batching and permissions, check out the Alchemy docs.

0. Install dependencies

In your app’s repository, install the required dependencies from Privy, Alchemy, and viem:

The Alchemy SDK currently requires viem to be pinned to 2.22.6

npm i @privy-io/react-auth @account-kit/smart-contracts @account-kit/infra @aa-sdk/core [email protected]

1. Create an Alchemy account and get your API key

Create an app: visit the Alchemy dashboard to create a new app, if you don’t already have one.
- Make sure to enable networks that support EIP-7702 such as Ethereum Mainnet or Sepolia.
- Save the app’s API Key that will be used later.
Enable gas sponsorship: visit the Gas Manager dashboard and create a new sponsorship policy for the app you created in step 1. This policy will be used to set rules on how much of user’s gas you want to sponsor.
- Make sure to enable gas sponsorship on a chain that support EIP-7702 such as Ethereum Mainnet or Sepolia.
- Save the Policy ID that will be used later.

Now that you have your API key and Policy ID, you can set up your smart wallets.

2. Configure Privy settings

Make sure your PrivyProvider has the following embeddedWallets settings and ensure you set the defaultChain and supportedChains to the 7702 supported chain you chose in step 1.

import { sepolia } from "@account-kit/infra";
<PrivyProvider
	appId={process.env.NEXT_PUBLIC_PRIVY_APP_ID || ""}
	config={{
	  embeddedWallets: {
	    showWalletUIs: false,
	    createOnLogin: "all-users",
	  },
	  defaultChain: sepolia,
	  supportedChains: [sepolia],
	}}
>

3. Adapt Privy signer to a smart account signer

Now that you have authentication working, adapt the Privy signer to be able to sign 7702 authorizations to upgrade to smart accounts.

1. Get the Privy embedded wallet

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

const {wallets} = useWallets();
const embeddedWallet = wallets.find((x) => x.walletClientType === 'privy');

2. Create a SmartAccountSigner instance

import {sepolia, alchemy} from '@account-kit/infra'; // make sure to import your chain from account-kit, not viem
import {useSign7702Authorization} from '@privy-io/react-auth';
import {SmartAccountSigner, WalletClientSigner} from '@aa-sdk/core';
import {createWalletClient, custom, Hex} from 'viem';
import {Authorization} from 'viem/experimental';

const {signAuthorization} = useSign7702Authorization();

async function create7702signer() {
  const baseSigner = new WalletClientSigner(
    createWalletClient({
      account: embeddedWallet!.address as Hex,
      chain: sepolia,
      transport: custom(await embeddedWallet!.getEthereumProvider())
    }),
    'privy'
  );

  const signer: SmartAccountSigner = {
    getAddress: baseSigner.getAddress,
    signMessage: baseSigner.signMessage,
    signTypedData: baseSigner.signTypedData,
    signerType: baseSigner.signerType,
    inner: baseSigner.inner,
    signAuthorization: async (
      unsignedAuth: Authorization<number, false>
    ): Promise<Authorization<number, true>> => {
      const signature = await signAuthorization(unsignedAuth);

      return {
        ...unsignedAuth,
        ...{
          r: signature.r!,
          s: signature.s!,
          v: signature.v!
        }
      };
    }
  };

  return signer;
}

4. Upgrade to smart accounts and send sponsored transactions

Now that you have a SmartAccountSigner instance, follow this guide to create a smart account client (createModularAccountV2Client ) and start sending sponsored transactions. You’ll need:

the SmartAccountSigner instance defined in step 3
the API key and the policy ID from step 1

Next steps

You just upgraded your EOA and sent your first sponsored transaction using EIP-7702!

If you want to leverage other smart account capabilities such as batching and permissions, check out the Alchemy docs.

In this guide we’ll see a quick example of using the Biconomy’s Modular Execution Environment (MEE) stack with Privy!

To keep things short, this guide will show you a simple example of single-chain orchestration with cross-chain gas. However, the Biconomy MEE stack supports multi-chain orchestration cases. If you’re looking to build a multi-chain DeFi strategy - read the Biconomy Docs

Project Setup

Create your project using Vite:

bun create vite biconomy-mee-embedded-example --template react-ts
cd biconomy-mee-embedded-example

Add the following to your package.json:

"dependencies": {
  "@biconomy/abstractjs": "^1.0.17",
  "@privy-io/react-auth": "^2.14.2",
  "@privy-io/wagmi": "^1.0.4",
  "@tanstack/react-query": "^5.80.7",
  "react": "^19.1.0",
  "react-dom": "^19.1.0",
  "viem": "^2.31.3",
  "wagmi": "^2.15.6"
}

Install dependencies:

bun install

Set up your main.tsx:

import React from 'react';
import ReactDOM from 'react-dom/client';
import App from './App.tsx';
import './index.css';

import {PrivyProvider} from '@privy-io/react-auth';
import {WagmiProvider} from 'wagmi';
import {wagmiConfig} from './wagmi.ts';
import {QueryClient, QueryClientProvider} from '@tanstack/react-query';

const appId = 'your-privy-app-id';
const queryClient = new QueryClient();

ReactDOM.createRoot(document.getElementById('root')!).render(
  <React.StrictMode>
    <PrivyProvider
      appId={appId}
      config={{
        embeddedWallets: {
          ethereum: {
            createOnLogin: 'all-users'
          }
        }
      }}
    >
      <QueryClientProvider client={queryClient}>
        <WagmiProvider config={wagmiConfig}>
          <App />
        </WagmiProvider>
      </QueryClientProvider>
    </PrivyProvider>
  </React.StrictMode>
);

In wagmi.ts:

import {createConfig} from '@privy-io/wagmi';
import {http} from 'wagmi';
import {baseSepolia, optimismSepolia} from 'viem/chains';

export const wagmiConfig = createConfig({
  chains: [optimismSepolia, baseSepolia],
  transports: {
    [optimismSepolia.id]: http(),
    [baseSepolia.id]: http()
  }
});

⬇Get the Embedded Wallet Instance

After logging in the user with Privy, you can find the embedded wallet as follows:

const wallet = wallets.find((wallet) => wallet.walletClientType === 'privy');

Authorizing with EIP-7702

To install the Biconomy Nexus 1.2.0 smart account on the address of your Privy embedded wallet EOA, you need to sign the following authorization. Note: This is using the signAuthorization method exposed by the useSignAuthorization Privy hook.

const authorization = await signAuthorization({
  contractAddress: NEXUS_V120,
  chainId: baseSepolia.id, // or 0 for universal
  nonce: 0
});

Execute a Cross-Chain Gas Abstracted Transaction

After signing, you can submit a transaction through Biconomy MEE Relayers. Notice few things for this transaction:

Gas is paid with USDC
Gas is paid on a different chain than the instruction being executed
The amount arg in the ERC-20 transfer call is not fixed to a value, but uses runtimeERC20BalanceOf which will inject the full amount of USDC available.

This demonstrates few key points of MEE:

Gas abstraction / gas sponsorship
Multi-chain execution/orchestration
Runtime parameter injection enabling multi-transaction composability

const orchestrator = await toMultichainNexusAccount({
  chains: [optimismSepolia, baseSepolia],
  transports: [http(), http()],
  signer: await wallet.getEthereumProvider(),
  accountAddress: wallet.address as Address
});

const meeClient = await createMeeClient({account: orchestrator});

const sendUSDCBase = await orchestrator.buildComposable({
  type: 'default',
  data: {
    abi: erc20Abi,
    chainId: baseSepolia.id,
    to: usdcAddresses[baseSepolia.id],
    functionName: 'transfer',
    args: [
      wallet.address,
      runtimeERC20BalanceOf({
        tokenAddress: usdcAddresses[baseSepolia.id],
        targetAddress: orchestrator.addressOn(baseSepolia.id, true),
        constraints: [greaterThanOrEqualTo(1n)]
      })
    ]
  }
});

const quote = await meeClient.getQuote({
  instructions: [sendUSDCBase],
  authorization,
  delegate: true,

  // Paying for gas with USDC on Optimism, while
  // executing a transaction on Base!
  feeToken: {
    address: usdcAddresses[optimismSepolia.id],
    chainId: optimismSepolia.id
  }
});

const {hash} = await meeClient.executeQuote({quote});

You can then link the user to MEE Scan to track:

const link = getMeeScanLink(hash);

Storing the Authorization

If you’ve used the chainId === 0 for your authorization you can store it (e.g. in localStorage or DB) and replay it for other chains in the future. This gives your users an even more seamless UX.

In this guide, we’ll demonstrate how to use Pimlico, a bundler and paymaster service for ERC-4337 accounts, to enable your users to send gasless transactions using EIP-7702 authorization.

Want to see a full end to end example? Check out our starter repo here

0. Install dependencies

In your app’s repository, install the required dependencies from Permissionless and Viem:

npm i @privy-io/wagmi permissionless viem wagmi

Head to the Pimlico dashboard here and create an account. Generate an API key and create a sponsorship policy for the network you plan to use (optional). Make note of your API key and sponsorship policy ID.

2. Configure Privy settings

Configure your app to create embedded wallets for all users.

<PrivyProvider
  config={{
    embeddedWallets: {
      createOnLogin: 'all-users'
      showWalletUIs: false
    }
  }}
>
  ...
</PrivyProvider>

3. Create a simple smart account with Permissionless SDK

Permissionless provides a simple way to create a smart account client that can send user operations with EIP-7702 authorization. All you need is the user’s embedded wallet and the Pimlico API key.

import {usePrivy, useSign7702Authorization, useWallets} from '@privy-io/react-auth';
import {useSetActiveWallet} from '@privy-io/wagmi';
import {useWalletClient} from 'wagmi';
import {createPublicClient, createWalletClient, http, zeroAddress} from 'viem';
import {sepolia} from 'viem/chains';
import {createSmartAccountClient} from 'permissionless';
import {createPimlicoClient} from 'permissionless/clients/pimlico';
import {entryPoint08Address} from 'viem/account-abstraction';
import {toSimpleSmartAccount} from 'permissionless/accounts';

// Get the Privy embedded wallet
const {wallets} = useWallets();
const {data: walletClient} = useWalletClient();
const embeddedWallet = wallets.find((wallet) => wallet.walletClientType === 'privy');

// Set the embedded wallet as active
const {setActiveWallet} = useSetActiveWallet();
useEffect(() => {
  if (embeddedWallet) {
    setActiveWallet(embeddedWallet);
  }
}, [embeddedWallet, setActiveWallet]);

// Create a public client for the chain
const publicClient = createPublicClient({
  chain: sepolia,
  transport: http(process.env.NEXT_PUBLIC_SEPOLIA_RPC_URL)
});

// Create a Pimlico client
const pimlicoApiKey = process.env.NEXT_PUBLIC_PIMLICO_API_KEY;
const pimlicoUrl = `https://api.pimlico.io/v2/sepolia/rpc?apikey=${pimlicoApiKey}`;
const pimlicoClient = createPimlicoClient({
  transport: http(pimlicoUrl)
});

// Create a simple smart account
const simpleSmartAccount = await toSimpleSmartAccount({
  owner: walletClient,
  entryPoint: {
    address: entryPoint08Address,
    version: '0.8'
  },
  client: publicClient,
  address: walletClient.account.address
});

// Create the smart account client
const smartAccountClient = createSmartAccountClient({
  account: simpleSmartAccount,
  chain: sepolia,
  bundlerTransport: http(pimlicoUrl),
  paymaster: pimlicoClient,
  userOperation: {
    estimateFeesPerGas: async () => {
      return (await pimlicoClient.getUserOperationGasPrice()).fast;
    }
  }
});

4. Sign the EIP-7702 authorization

// Sign the EIP-7702 authorization
const authorization = await signAuthorization({
  contractAddress: '0xe6Cae83BdE06E4c305530e199D7217f42808555B', // Simple account implementation address
  chainId: sepolia.id,
  nonce: await publicClient.getTransactionCount({
    address: walletClient.account.address
  })
});

5. Send a gas-sponsored transaction

With the smart account client configured and the authorization signed, you can now send gasless UserOperations. Below we send an empty call to the zero address:

const txnHash = await smartAccountClient.sendTransaction({
  calls: [
    {
      to: zeroAddress,
      data: '0x',
      value: BigInt(0)
    }
  ],
  factory: '0x7702',
  factoryData: '0x',
  paymasterContext: {
    sponsorshipPolicyId: process.env.NEXT_PUBLIC_SPONSORSHIP_POLICY_ID
  },
  authorization
});

console.log(`Transaction hash: ${txnHash}`);
console.log(`View on Etherscan: https://sepolia.etherscan.io/tx/${txnHash}`);

Conclusion

That’s it! You’ve just executed a gasless transaction from a normal EOA upgraded with EIP-7702 using Pimlico as the bundler and paymaster service.

Explore the rest of the Pimlico docs to learn about advanced features like batching transactions, gas estimation, and more.

Want to see a full end to end example? Check out our starter repo here!

In this guide, we demonstrate using ZeroDev, a toolkit for creating smart accounts, together with Privy to enable your users to send gasless (sponsored) transactions.

Want to see a full end to end example? Check out our starter repo here!

0. Install dependencies

In your app’s repository, install the required dependencies from Privy, ZeroDev and viem:

npm i @privy-io/react-auth @zerodev/sdk viem

Head to the ZeroDev dashboard and create a project on a chain that supports EIP-7702.

Set up a gas sponsorship policy to enable sending sponsored transactions. Copy the Bundler RPC and Paymaster RPC for the network you plan to use.

2. Configure Privy settings

Configure your app to create embedded wallets for all users. Also configure Privy to not show its default wallet UIs. Instead, we recommend you use your own custom UIs for showing users the user operations they sign.

Update your PrivyProvider configuration to include the following properties:

<PrivyProvider
  config={{
    embeddedWallets: {
      showWalletUIs: false, 
      createOnLogin: 'all-users'
    }
  }}
>
  ...
</PrivyProvider>

3. Create a 7702 Kernel account with the ZeroDev SDK

ZeroDev exposes helper functions that take care of generating the 7702 authorization for you. All you need to provide is the signer for the user’s embedded wallet and the Kernel version you want to use.

import {
  createZeroDevPaymasterClient,
  createKernelAccountClient,
  createKernelAccount
} from '@zerodev/sdk';
import {KERNEL_V3_3} from '@zerodev/sdk/constants';
import {getEntryPoint} from '@zerodev/sdk/constants';
import {createWalletClient, createPublicClient, custom, http, zeroAddress, Hex} from 'viem';
import {odysseyTestnet} from 'viem/chains';

// Select the chain and Kernel version you want to use
const chain = odysseyTestnet;
const kernelVersion = KERNEL_V3_3;
const kernelAddresses = KernelVersionToAddressesMap[kernelVersion];

const entryPoint = getEntryPoint('0.7');

// Grab the embedded wallet created by Privy
const {wallets} = useWallets();
const embeddedWallet = wallets.find((wallet) => wallet.walletClientType === 'privy');

// Build viem clients for the wallet & public RPC
const walletClient = createWalletClient({
  account: embeddedWallet.address as Hex,
  chain,
  transport: custom(await embeddedWallet.getEthereumProvider())
});

const publicClient = createPublicClient({
  chain,
  transport: http()
});

// Sign the EIP-7702 authorization
const authorization = await signAuthorization({
  contractAddress: kernelAddresses.accountImplementationAddress,
  chainId: chain.id
});

// Create the 7702 Kernel account (no deployment occurs!)
const account = await createKernelAccount(publicClient, {
  eip7702Account: walletClient,
  entryPoint,
  kernelVersion,
  eip7702Auth: authorization
});

Behind the scenes ZeroDev generates the EIP-7702 authorization and binds the Kernel implementation code to the EOA, giving it smart-account super-powers while keeping the same address.

4. Configure the ZeroDev client for sponsored transactions

const paymasterRpc = 'YOUR_PAYMASTER_RPC_URL';
const bundlerRpc = 'YOUR_BUNDLER_RPC_URL';

// Create a paymaster client so the user does not need ETH
const paymasterClient = createZeroDevPaymasterClient({
  chain,
  transport: http(paymasterRpc)
});

// Build a Kernel client that will create & submit UserOperations
const kernelClient = createKernelAccountClient({
  account,
  chain,
  bundlerTransport: http(bundlerRpc),
  paymaster: paymasterClient,
  client: publicClient
});

5. Send a gas-sponsored transaction

With the client configured, you can now send gasless UserOperations. Below we send an empty call then wait for it to be mined:

// Send a simple UserOperation
const userOpHash = await kernelClient.sendUserOperation({
  callData: await kernelClient.account.encodeCalls([
    {
      to: zeroAddress,
      value: BigInt(0),
      data: '0x'
    }
  ])
});

// Wait for the operation to be included
const {receipt} = await kernelClient.waitForUserOperationReceipt({
  hash: userOpHash
});

console.log(
  'UserOp completed',
  `${chain.blockExplorers.default.url}/tx/${receipt.transactionHash}`
);

Conclusion

That’s it! You’ve just executed a gasless transaction from a normal EOA upgraded with EIP-7702.

Explore the rest of the ZeroDev docs to learn about batching, session keys, cross-chain actions and more.

Recipes

​Signing EIP-7702 authorizations

​Using EIP-7702 capabilities

​0. Install dependencies

​1. Create an Alchemy account and get your API key

​2. Configure Privy settings

​3. Adapt Privy signer to a smart account signer

​4. Upgrade to smart accounts and send sponsored transactions

​Next steps

​0. Install dependencies

​1. Create an Alchemy account and get your API key

​2. Configure Privy settings

​3. Adapt Privy signer to a smart account signer

​4. Upgrade to smart accounts and send sponsored transactions

​Next steps

​Project Setup

​⬇Get the Embedded Wallet Instance

​Authorizing with EIP-7702

​Execute a Cross-Chain Gas Abstracted Transaction

​Storing the Authorization

​0. Install dependencies

​1. Sign up for a Pimlico account and get your API key

​2. Configure Privy settings

​3. Create a simple smart account with Permissionless SDK

​4. Sign the EIP-7702 authorization

​5. Send a gas-sponsored transaction

​Conclusion

​0. Install dependencies

​1. Sign up for a ZeroDev account and create a project

​2. Configure Privy settings

​3. Create a 7702 Kernel account with the ZeroDev SDK

​4. Configure the ZeroDev client for sponsored transactions

​5. Send a gas-sponsored transaction

​Conclusion

Signing EIP-7702 authorizations

Using EIP-7702 capabilities

0. Install dependencies

1. Create an Alchemy account and get your API key

2. Configure Privy settings

3. Adapt Privy signer to a smart account signer

4. Upgrade to smart accounts and send sponsored transactions

Next steps

0. Install dependencies

1. Create an Alchemy account and get your API key

2. Configure Privy settings

3. Adapt Privy signer to a smart account signer

4. Upgrade to smart accounts and send sponsored transactions

Next steps

Project Setup

⬇Get the Embedded Wallet Instance

Authorizing with EIP-7702

Execute a Cross-Chain Gas Abstracted Transaction

Storing the Authorization

0. Install dependencies

1. Sign up for a Pimlico account and get your API key

2. Configure Privy settings

3. Create a simple smart account with Permissionless SDK

4. Sign the EIP-7702 authorization

5. Send a gas-sponsored transaction

Conclusion

0. Install dependencies

1. Sign up for a ZeroDev account and create a project

2. Configure Privy settings

3. Create a 7702 Kernel account with the ZeroDev SDK

4. Configure the ZeroDev client for sponsored transactions

5. Send a gas-sponsored transaction

Conclusion