Privy + ZeroDev smart wallets on Aeneid

1 · ZeroDev dashboard

1. Open dashboard.zerodev.app → Create Project.
2. Enable Show Testnets and tick DATA Foundation Aeneid (1315). Save.
3. Open the project → Gas Policies → chain Aeneid → toggle Sponsor all transactions → confirm Enable.
4. Copy the Bundler URL and Paymaster URL from the project's RPC tab — you'll paste them into Privy.

2 · Privy dashboard — enable smart wallets

1. Open dashboard.privy.io → your app → Wallet infrastructure → Smart wallets.
2. Click Enable smart wallets for your app and pick Kernel (ZeroDev) as the provider.

3 · Configure chains → Add new chain → Custom chain

Aeneid isn't in Privy's preset list, so add it as a Custom chain and fill in exactly:

NAME         DATA Foundation Aeneid
ID (chainId) 1315
RPC URL      https://aeneid.storyrpc.io   (or your Alchemy endpoint)
BUNDLER URL  From ZeroDev dashboard → project → RPC tab
PAYMASTER    From ZeroDev dashboard → project → RPC tab
EXPLORER     https://aeneid.datanetscan.io

4 · Client wiring

Wrap the app in SmartWalletsProvider so useSmartWallets() is available. Privy reads the provider + custom chain from the dashboard, so no bundler/paymaster URL belongs in code. Mount this file behind <ClientOnly> + lazy() — @privy-io/react-auth is not SSR-safe.

// src/components/privy-client-entry.tsx
import { PrivyProvider } from "@privy-io/react-auth";
import { SmartWalletsProvider } from "@privy-io/react-auth/smart-wallets";
import { defineChain } from "viem";

export const aeneid = defineChain({
  id: 1315,
  name: "DATA Foundation Aeneid",
  nativeCurrency: { name: "IP", symbol: "IP", decimals: 18 },
  rpcUrls: { default: { http: [
    import.meta.env.VITE_AENEID_RPC_URL || "https://aeneid.storyrpc.io",
  ] } },
  blockExplorers: { default: {
    name: "DataNetScan",
    url: "https://aeneid.datanetscan.io",
  } },
  testnet: true,
});

<PrivyProvider
  appId={import.meta.env.VITE_PRIVY_APP_ID}
  config={{
    loginMethods: ["google", "email"],
    embeddedWallets: { ethereum: { createOnLogin: "users-without-wallets" } },
    defaultChain: aeneid,
    supportedChains: [aeneid],
    appearance: { theme: "dark" },
  }}
>
  <SmartWalletsProvider>
    <App />
  </SmartWalletsProvider>
</PrivyProvider>

5 · Send a sponsored transaction

// Sponsored tx via the ZeroDev-backed Kernel smart wallet
import { useSmartWallets } from "@privy-io/react-auth/smart-wallets";
import { encodeFunctionData } from "viem";
import ledger from "@/data/choreo-ledger.json";

const { client } = useSmartWallets();

const hash = await client!.sendTransaction({
  to: ledger.address as `0x${string}`,
  data: encodeFunctionData({
    abi: ledger.abi,
    functionName: "record",
    args: ["choreo:plie"],
  }),
});
// Gas is sponsored by the ZeroDev paymaster — Privy popup reads US$0.00.

The user signs a UserOp with their embedded EOA; ZeroDev's bundler submits it and the paymaster covers gas. Estimated fee in the Privy popup reads US$0.00.