> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Sub Accounts
> Create and manage app-specific wallet accounts with Base Account
export const GithubRepoCard = ({title, githubUrl}) => {
return
;
};
Learn how to create and manage Sub Accounts that provide app-specific wallet accounts embedded directly in your application.
## Overview
Sub Accounts allow you to provision dedicated wallet accounts for your users within your application.
These accounts are controlled by the user's main Base Account and provide an enhanced user experience
as the user's interactions produce no passkey prompts or popups.
Users can manage all their Sub Accounts at [account.base.app](https://account.base.app).
If you would like to see a live demo of Sub Accounts in action, check out our [Sub Accounts Demo](https://sub-accounts-fc.vercel.app).
### What you'll achieve
By the end of this guide, you will:
* Understand how Sub Accounts work with Base Account
* Create new Sub Accounts for users
* Retrieve and manage existing Sub Accounts
* Implement Sub Account in your Privy project
The code snippets in this guide are based on the following example project:
## Setup
Follow the [Setup](/base-account/framework-integrations/privy/setup) guide to set up Privy with Base Account.
## Implementation
### Component Setup
```tsx Sub Accounts Component (components/sections/sub-accounts.tsx) expandable theme={null}
"use client";
import { useState, useMemo } from "react";
import { useWallets } from "@privy-io/react-auth";
const SubAccounts = () => {
const { wallets } = useWallets();
const [subAccounts, setSubAccounts] = useState<
{
address: string;
factory: string;
factoryData: string;
}[]
>([]);
const [isLoading, setIsLoading] = useState(false);
// Find the Base Account wallet
const baseAccount = useMemo(() => {
return wallets.find((wallet) => wallet.walletClientType === 'base_account');
}, [wallets]);
const handleGetSubAccounts = async () => {
if (!baseAccount) return;
setIsLoading(true);
try {
// Switch to Base Sepolia (or Base Mainnet - use 8453 for mainnet)
await baseAccount.switchChain(84532);
const provider = await baseAccount.getEthereumProvider();
// Get existing Sub Accounts
const response = await provider.request({
method: 'wallet_getSubAccounts',
params: [{
account: baseAccount.address,
domain: window.location.origin
}]
});
const { subAccounts: existingSubAccounts } = response;
setSubAccounts(existingSubAccounts || []);
} catch (error) {
console.error("Error getting Sub Accounts:", error);
} finally {
setIsLoading(false);
}
};
const handleAddSubAccount = async () => {
if (!baseAccount) return;
setIsLoading(true);
try {
// Switch to Base Sepolia (or Base Mainnet - use 8453 for mainnet)
await baseAccount.switchChain(84532);
const provider = await baseAccount.getEthereumProvider();
// Create new Sub Account
await provider.request({
method: 'wallet_addSubAccount',
params: [{
version: '1',
account: {
type: 'create',
keys: [{
type: 'address',
publicKey: baseAccount.address
}]
}
}]
});
// Refresh the Sub Accounts list
await handleGetSubAccounts();
} catch (error) {
console.error("Error creating Sub Account:", error);
} finally {
setIsLoading(false);
}
};
return (
{subAccounts.length > 0 && (
Existing Sub Accounts:
{subAccounts.map((subAccount, index) => (
Address: {subAccount.address}
Factory: {subAccount.factory}
Factory Data: {subAccount.factoryData}
))}
)}
);
};
```
### Key Methods
#### Getting Sub Accounts
Use `wallet_getSubAccounts` to retrieve existing Sub Accounts for a domain:
```tsx Get Sub Accounts (components/sections/sub-accounts.tsx) theme={null}
const response = await provider.request({
method: 'wallet_getSubAccounts',
params: [{
account: baseAccount.address,
domain: window.location.origin
}]
});
```
#### Creating Sub Accounts
Use `wallet_addSubAccount` to create new Sub Accounts:
```tsx Create Sub Account (components/sections/sub-accounts.tsx) theme={null}
await provider.request({
method: 'wallet_addSubAccount',
params: [{
version: '1',
account: {
type: 'create',
keys: [{
type: 'address',
publicKey: baseAccount.address
}]
}
}]
});
```
### Network Configuration
Sub accounts work on both Base Mainnet and Base Sepolia:
* **Base Mainnet**: Chain ID `8453`
* **Base Sepolia**: Chain ID `84532`
### Explore further
* [Sub Accounts Guide](/base-account/improve-ux/sub-accounts)
* [Privy Sub Accounts Recipe](https://docs.privy.io/recipes/react/external-wallets/base-sub-accounts)