Using smart wallets - Privy docs

Follow the smart wallets setup guide to configure smart wallets for your application.

Get the smart wallet address

Once a smart wallet has been created for a user, you can get the address for the smart wallet by finding the account of type: 'smart_wallet' from the user’s linkedAccounts array.

const {user} = usePrivy();
const smartWallet = user.linkedAccounts.find((account) => account.type === 'smart_wallet');
console.log(smartWallet.address);
// Logs the smart wallet's address
console.log(smartWallet.type);
// Logs the smart wallet type (e.g. 'safe', 'kernel', 'light_account', 'biconomy', 'thirdweb', 'coinbase_smart_wallet')

Sign a message

Use the signMessage function from the client returned by useSmartWallets hook in your React component to sign a message using the user’s smart wallet.

signMessage: (input: {message: SignableMessage}, opts?: {uiOptions?: SignMessageModalUIOptions}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/react-auth/smart-wallets';
const {client} = useSmartWallets();
const uiOptions = {
    title: 'Sample title text',
    description: 'Sample description text',
    buttonText: 'Sample button text'
};
client.signMessage({message: 'Hello, world!'}, {uiOptions}).then((signature) => {
    console.log(signature);
});

Parameters

The signMessage method accepts the following parameters:

input.message

string | {raw: Hex | ByteArray}

required

The message to sign by the smart account.

opts.uiOptions

SignMessageModalUIOptions

Optional UI customization options for the signature prompt.

Returns

signature

Hex

The signed message by the smart wallet.

Sign typed data

Use the signTypedData function from the client returned by useSmartWallets hook in your React component to sign structured data using the user’s smart wallet.

signTypedData: (input: SignTypedDataParameters, opts?: {uiOptions?: SignMessageModalUIOptions}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/react-auth/smart-wallets';
const {client} = useSmartWallets();
const uiOptions = {
    title: 'Sample title text',
    description: 'Sample description text',
    buttonText: 'Sample button text'
};
client.signTypedData(typedDataRequestParams, {uiOptions}).then((signature) => {
    console.log(signature);
});

Parameters

The signTypedData method accepts the following parameters:

input

SignTypedDataParameters

required

The typed data to sign by the smart account.

opts.uiOptions

SignMessageModalUIOptions

Optional UI customization options for the signature prompt.

Returns

signature

Hex

The signed message by the smart wallet.

Send a transaction

Use the sendTransaction function from the client returned by useSmartWallets hook in your React component to send a transaction using the user’s smart wallet.

sendTransaction: (input: SendTransactionParameters, opts?: {uiOptions?: SendTransactionModalUIOptions}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/react-auth/smart-wallets';
const {client} = useSmartWallets();
const uiOptions = {
    title: 'Sample title text',
    description: 'Sample description text',
    buttonText: 'Sample button text'
};
client.sendTransaction({
    chain: base,
    to: 'insert-recipient-address',
    value: 0.1
}, {uiOptions}).then((txHash) => {
    console.log(txHash);
});

Parameters

The sendTransaction method accepts the following parameters:

input

SendTransactionParameters

required

The transaction to send by the smart account.

opts.uiOptions

SendTransactionModalUIOptions

Optional UI customization options for the transaction prompt.

Returns

txHash

Hex

The transaction hash of the sent transaction.

Batch transactions

Smart wallets support sending a batch of transactions in a single, atomic submission to the network.

sendTransaction: (input: {calls: Array<{to: string, value?: bigint, data?: string}>}, opts?: {uiOptions?: SendTransactionModalUIOptions}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/react-auth/smart-wallets';
const {client} = useSmartWallets();
client.sendTransaction({
    calls: [
        // Approve transaction
        {
            to: USDC_ADDRESS,
            data: encodeFunctionData({
                abi: USDC_ABI,
                functionName: 'approve',
                args: ['insert-spender-address', BigInt(1e6)]
            })
        },
        // Transfer transaction
        {
            to: USDC_ADDRESS,
            data: encodeFunctionData({
                abi: USDC_ABI,
                functionName: 'transfer',
                args: ['insert-recipient-address', BigInt(1e6)]
            })
        }
    ]
}).then((txHash) => {
    console.log(txHash);
});

Parameters

The sendTransaction method for batching accepts the following parameters:

input.calls

Array<{to: string, value?: bigint, data?: string}>

required

Array of transactions to batch together.

opts.uiOptions

SendTransactionModalUIOptions

Optional UI customization options for the transaction prompt.

Returns

txHash

Hex

The transaction hash of the batched transaction.

Switch chains

Use the getClientForChain method to create a new smart wallet client for a specific chain.

getClientForChain: ({id: number}) => Promise<SmartWalletClient>

Usage

import {base} from 'viem/chains';
const {getClientForChain} = useSmartWallets();
const baseClient = await getClientForChain({
    id: base.id,
});
// Client will send transaction on Base
baseClient.sendTransaction({
    ...
});

Parameters

The getClientForChain method accepts the following parameters:

number

required

The chain ID to create a client for.

Returns

client

SmartWalletClient

A new smart wallet client configured for the specified chain.

If configured defaultChain does not have a smart wallet network configuration, the smart wallet client will default to using the first configured chain that has a smart wallet network configuration.

Follow the smart wallets setup guide to configure smart wallets for your application.

Get the smart wallet address

Once a smart wallet has been created for a user, you can get the address for the smart wallet by finding the account of type: 'smart_wallet' from the user’s linkedAccounts array.

const {user} = usePrivy();
const smartWallet = user.linkedAccounts.find((account) => account.type === 'smart_wallet');
console.log(smartWallet.address);
// Logs the smart wallet's address
console.log(smartWallet.type);
// Logs the smart wallet type (e.g. 'safe', 'kernel', 'light_account', 'biconomy', 'thirdweb', 'coinbase_smart_wallet')

Sign a message

Use the signMessage function from the client returned by useSmartWallets hook in your React component to sign a message using the user’s smart wallet.

signMessage: (input: {message: SignableMessage}, opts?: {uiOptions?: SignMessageModalUIOptions}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/react-auth/smart-wallets';
const {client} = useSmartWallets();
const uiOptions = {
    title: 'Sample title text',
    description: 'Sample description text',
    buttonText: 'Sample button text'
};
client.signMessage({message: 'Hello, world!'}, {uiOptions}).then((signature) => {
    console.log(signature);
});

Parameters

The signMessage method accepts the following parameters:

input.message

string | {raw: Hex | ByteArray}

required

The message to sign by the smart account.

opts.uiOptions

SignMessageModalUIOptions

Optional UI customization options for the signature prompt.

Returns

signature

Hex

The signed message by the smart wallet.

Sign typed data

Use the signTypedData function from the client returned by useSmartWallets hook in your React component to sign structured data using the user’s smart wallet.

signTypedData: (input: SignTypedDataParameters, opts?: {uiOptions?: SignMessageModalUIOptions}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/react-auth/smart-wallets';
const {client} = useSmartWallets();
const uiOptions = {
    title: 'Sample title text',
    description: 'Sample description text',
    buttonText: 'Sample button text'
};
client.signTypedData(typedDataRequestParams, {uiOptions}).then((signature) => {
    console.log(signature);
});

Parameters

The signTypedData method accepts the following parameters:

input

SignTypedDataParameters

required

The typed data to sign by the smart account.

opts.uiOptions

SignMessageModalUIOptions

Optional UI customization options for the signature prompt.

Returns

signature

Hex

The signed message by the smart wallet.

Send a transaction

Use the sendTransaction function from the client returned by useSmartWallets hook in your React component to send a transaction using the user’s smart wallet.

sendTransaction: (input: SendTransactionParameters, opts?: {uiOptions?: SendTransactionModalUIOptions}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/react-auth/smart-wallets';
const {client} = useSmartWallets();
const uiOptions = {
    title: 'Sample title text',
    description: 'Sample description text',
    buttonText: 'Sample button text'
};
client.sendTransaction({
    chain: base,
    to: 'insert-recipient-address',
    value: 0.1
}, {uiOptions}).then((txHash) => {
    console.log(txHash);
});

Parameters

The sendTransaction method accepts the following parameters:

input

SendTransactionParameters

required

The transaction to send by the smart account.

opts.uiOptions

SendTransactionModalUIOptions

Optional UI customization options for the transaction prompt.

Returns

txHash

Hex

The transaction hash of the sent transaction.

Batch transactions

Smart wallets support sending a batch of transactions in a single, atomic submission to the network.

sendTransaction: (input: {calls: Array<{to: string, value?: bigint, data?: string}>}, opts?: {uiOptions?: SendTransactionModalUIOptions}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/react-auth/smart-wallets';
const {client} = useSmartWallets();
client.sendTransaction({
    calls: [
        // Approve transaction
        {
            to: USDC_ADDRESS,
            data: encodeFunctionData({
                abi: USDC_ABI,
                functionName: 'approve',
                args: ['insert-spender-address', BigInt(1e6)]
            })
        },
        // Transfer transaction
        {
            to: USDC_ADDRESS,
            data: encodeFunctionData({
                abi: USDC_ABI,
                functionName: 'transfer',
                args: ['insert-recipient-address', BigInt(1e6)]
            })
        }
    ]
}).then((txHash) => {
    console.log(txHash);
});

Parameters

The sendTransaction method for batching accepts the following parameters:

input.calls

Array<{to: string, value?: bigint, data?: string}>

required

Array of transactions to batch together.

opts.uiOptions

SendTransactionModalUIOptions

Optional UI customization options for the transaction prompt.

Returns

txHash

Hex

The transaction hash of the batched transaction.

Switch chains

Use the getClientForChain method to create a new smart wallet client for a specific chain.

getClientForChain: ({id: number}) => Promise<SmartWalletClient>

Usage

import {base} from 'viem/chains';
const {getClientForChain} = useSmartWallets();
const baseClient = await getClientForChain({
    id: base.id,
});
// Client will send transaction on Base
baseClient.sendTransaction({
    ...
});

Parameters

The getClientForChain method accepts the following parameters:

number

required

The chain ID to create a client for.

Returns

client

SmartWalletClient

A new smart wallet client configured for the specified chain.

Follow the React Native setup guide to configure smart wallets for your React Native application.

Get the smart wallet address

Once a smart wallet has been created for a user, you can get the address for the smart wallet by finding the account of type: 'smart_wallet' from the user’s linked_accounts array.

const {user} = usePrivy();
const smartWallet = user.linked_accounts.find((account) => account.type === 'smart_wallet');
console.log(smartWallet.address);
// Logs the smart wallet's address
console.log(smartWallet.type);
// Logs the smart wallet type (e.g. 'safe', 'kernel', 'light_account', 'biconomy', 'thirdweb', 'coinbase_smart_wallet')

Sign a message

Use the signMessage function from the client returned by useSmartWallets hook in your React Native component to sign a message using the user’s smart wallet.

signMessage: ({message: SignableMessage}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/expo/smart-wallets';
const {client} = useSmartWallets();
client.signMessage({message: 'Hello, world!'}).then((signature) => {
    console.log(signature);
});

Parameters

The signMessage method accepts the following parameters:

input.message

string | {raw: Hex | ByteArray}

required

The message to sign by the smart account.

Returns

signature

Hex

The signed message by the smart wallet.

Sign typed data

Use the signTypedData function from the client returned by useSmartWallets hook in your React Native component to sign structured data using the user’s smart wallet.

signTypedData: (input: SignTypedDataParameters) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/expo/smart-wallets';
const {client} = useSmartWallets();
client.signTypedData(...).then((signature) => {
    console.log(signature);
});

Parameters

The signTypedData method accepts the following parameters:

input

SignTypedDataParameters

required

The typed data to sign by the smart account.

Returns

signature

Hex

The signed message by the smart wallet.

Send a transaction

Use the sendTransaction function from the client returned by useSmartWallets hook in your React Native component to send a transaction using the user’s smart wallet.

sendTransaction: (input: SendTransactionParameters) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/expo/smart-wallets';
const {client} = useSmartWallets();
client.sendTransaction({
    account: client.account,
    chain: base,
    to: 'insert-recipient-address',
    value: 0.1
}).then((txHash) => {
    console.log(txHash);
});

Parameters

The sendTransaction method accepts the following parameters:

input

SendTransactionParameters

required

The transaction to send by the smart account.

Returns

txHash

Hex

The transaction hash of the sent transaction.

Batch transactions

Smart wallets support sending a batch of transactions in a single, atomic submission to the network.

sendTransaction: (input: {calls: Array<{to: string, value?: bigint, data?: string}>}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/expo/smart-wallets';
const {client} = useSmartWallets();
client.sendTransaction({
    account: client.account,
    calls: [
        // Approve transaction
        {
            to: USDC_ADDRESS,
            data: encodeFunctionData({
                abi: USDC_ABI,
                functionName: 'approve',
                args: ['insert-spender-address', BigInt(1e6)]
            })
        },
        // Transfer transaction
        {
            to: USDC_ADDRESS,
            data: encodeFunctionData({
                abi: USDC_ABI,
                functionName: 'transfer',
                args: ['insert-recipient-address', BigInt(1e6)]
            })
        }
    ]
}).then((txHash) => {
    console.log(txHash);
});

Parameters

The sendTransaction method for batching accepts the following parameters:

input.calls

Array<{to: string, value?: bigint, data?: string}>

required

Array of transactions to batch together.

Returns

txHash

Hex

The transaction hash of the batched transaction.

The smart wallet client will default to using the first configured chain that has a smart wallet network configuration.

Follow the smart wallets setup guide to configure smart wallets for your application.

Get the smart wallet address

Once a smart wallet has been created for a user, you can get the address for the smart wallet by finding the account of type: 'smart_wallet' from the user’s linkedAccounts array.

const {user} = usePrivy();
const smartWallet = user.linkedAccounts.find((account) => account.type === 'smart_wallet');
console.log(smartWallet.address);
// Logs the smart wallet's address
console.log(smartWallet.type);
// Logs the smart wallet type (e.g. 'safe', 'kernel', 'light_account', 'biconomy', 'thirdweb', 'coinbase_smart_wallet')

Sign a message

Use the signMessage function from the client returned by useSmartWallets hook in your React component to sign a message using the user’s smart wallet.

signMessage: (input: {message: SignableMessage}, opts?: {uiOptions?: SignMessageModalUIOptions}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/react-auth/smart-wallets';
const {client} = useSmartWallets();
const uiOptions = {
    title: 'Sample title text',
    description: 'Sample description text',
    buttonText: 'Sample button text'
};
client.signMessage({message: 'Hello, world!'}, {uiOptions}).then((signature) => {
    console.log(signature);
});

Parameters

The signMessage method accepts the following parameters:

input.message

string | {raw: Hex | ByteArray}

required

The message to sign by the smart account.

opts.uiOptions

SignMessageModalUIOptions

Optional UI customization options for the signature prompt.

Returns

signature

Hex

The signed message by the smart wallet.

Sign typed data

Use the signTypedData function from the client returned by useSmartWallets hook in your React component to sign structured data using the user’s smart wallet.

signTypedData: (input: SignTypedDataParameters, opts?: {uiOptions?: SignMessageModalUIOptions}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/react-auth/smart-wallets';
const {client} = useSmartWallets();
const uiOptions = {
    title: 'Sample title text',
    description: 'Sample description text',
    buttonText: 'Sample button text'
};
client.signTypedData(typedDataRequestParams, {uiOptions}).then((signature) => {
    console.log(signature);
});

Parameters

The signTypedData method accepts the following parameters:

input

SignTypedDataParameters

required

The typed data to sign by the smart account.

opts.uiOptions

SignMessageModalUIOptions

Optional UI customization options for the signature prompt.

Returns

signature

Hex

The signed message by the smart wallet.

Send a transaction

Use the sendTransaction function from the client returned by useSmartWallets hook in your React component to send a transaction using the user’s smart wallet.

sendTransaction: (input: SendTransactionParameters, opts?: {uiOptions?: SendTransactionModalUIOptions}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/react-auth/smart-wallets';
const {client} = useSmartWallets();
const uiOptions = {
    title: 'Sample title text',
    description: 'Sample description text',
    buttonText: 'Sample button text'
};
client.sendTransaction({
    chain: base,
    to: 'insert-recipient-address',
    value: 0.1
}, {uiOptions}).then((txHash) => {
    console.log(txHash);
});

Parameters

The sendTransaction method accepts the following parameters:

input

SendTransactionParameters

required

The transaction to send by the smart account.

opts.uiOptions

SendTransactionModalUIOptions

Optional UI customization options for the transaction prompt.

Returns

txHash

Hex

The transaction hash of the sent transaction.

Batch transactions

Smart wallets support sending a batch of transactions in a single, atomic submission to the network.

sendTransaction: (input: {calls: Array<{to: string, value?: bigint, data?: string}>}, opts?: {uiOptions?: SendTransactionModalUIOptions}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/react-auth/smart-wallets';
const {client} = useSmartWallets();
client.sendTransaction({
    calls: [
        // Approve transaction
        {
            to: USDC_ADDRESS,
            data: encodeFunctionData({
                abi: USDC_ABI,
                functionName: 'approve',
                args: ['insert-spender-address', BigInt(1e6)]
            })
        },
        // Transfer transaction
        {
            to: USDC_ADDRESS,
            data: encodeFunctionData({
                abi: USDC_ABI,
                functionName: 'transfer',
                args: ['insert-recipient-address', BigInt(1e6)]
            })
        }
    ]
}).then((txHash) => {
    console.log(txHash);
});

Parameters

The sendTransaction method for batching accepts the following parameters:

input.calls

Array<{to: string, value?: bigint, data?: string}>

required

Array of transactions to batch together.

opts.uiOptions

SendTransactionModalUIOptions

Optional UI customization options for the transaction prompt.

Returns

txHash

Hex

The transaction hash of the batched transaction.

Switch chains

Use the getClientForChain method to create a new smart wallet client for a specific chain.

getClientForChain: ({id: number}) => Promise<SmartWalletClient>

Usage

import {base} from 'viem/chains';
const {getClientForChain} = useSmartWallets();
const baseClient = await getClientForChain({
    id: base.id,
});
// Client will send transaction on Base
baseClient.sendTransaction({
    ...
});

Parameters

The getClientForChain method accepts the following parameters:

number

required

The chain ID to create a client for.

Returns

client

SmartWalletClient

A new smart wallet client configured for the specified chain.

Follow the smart wallets setup guide to configure smart wallets for your application.

Get the smart wallet address

Once a smart wallet has been created for a user, you can get the address for the smart wallet by finding the account of type: 'smart_wallet' from the user’s linkedAccounts array.

const {user} = usePrivy();
const smartWallet = user.linkedAccounts.find((account) => account.type === 'smart_wallet');
console.log(smartWallet.address);
// Logs the smart wallet's address
console.log(smartWallet.type);
// Logs the smart wallet type (e.g. 'safe', 'kernel', 'light_account', 'biconomy', 'thirdweb', 'coinbase_smart_wallet')

Sign a message

Use the signMessage function from the client returned by useSmartWallets hook in your React component to sign a message using the user’s smart wallet.

signMessage: (input: {message: SignableMessage}, opts?: {uiOptions?: SignMessageModalUIOptions}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/react-auth/smart-wallets';
const {client} = useSmartWallets();
const uiOptions = {
    title: 'Sample title text',
    description: 'Sample description text',
    buttonText: 'Sample button text'
};
client.signMessage({message: 'Hello, world!'}, {uiOptions}).then((signature) => {
    console.log(signature);
});

Parameters

The signMessage method accepts the following parameters:

input.message

string | {raw: Hex | ByteArray}

required

The message to sign by the smart account.

opts.uiOptions

SignMessageModalUIOptions

Optional UI customization options for the signature prompt.

Returns

signature

Hex

The signed message by the smart wallet.

Sign typed data

Use the signTypedData function from the client returned by useSmartWallets hook in your React component to sign structured data using the user’s smart wallet.

signTypedData: (input: SignTypedDataParameters, opts?: {uiOptions?: SignMessageModalUIOptions}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/react-auth/smart-wallets';
const {client} = useSmartWallets();
const uiOptions = {
    title: 'Sample title text',
    description: 'Sample description text',
    buttonText: 'Sample button text'
};
client.signTypedData(typedDataRequestParams, {uiOptions}).then((signature) => {
    console.log(signature);
});

Parameters

The signTypedData method accepts the following parameters:

input

SignTypedDataParameters

required

The typed data to sign by the smart account.

opts.uiOptions

SignMessageModalUIOptions

Optional UI customization options for the signature prompt.

Returns

signature

Hex

The signed message by the smart wallet.

Send a transaction

Use the sendTransaction function from the client returned by useSmartWallets hook in your React component to send a transaction using the user’s smart wallet.

sendTransaction: (input: SendTransactionParameters, opts?: {uiOptions?: SendTransactionModalUIOptions}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/react-auth/smart-wallets';
const {client} = useSmartWallets();
const uiOptions = {
    title: 'Sample title text',
    description: 'Sample description text',
    buttonText: 'Sample button text'
};
client.sendTransaction({
    chain: base,
    to: 'insert-recipient-address',
    value: 0.1
}, {uiOptions}).then((txHash) => {
    console.log(txHash);
});

Parameters

The sendTransaction method accepts the following parameters:

input

SendTransactionParameters

required

The transaction to send by the smart account.

opts.uiOptions

SendTransactionModalUIOptions

Optional UI customization options for the transaction prompt.

Returns

txHash

Hex

The transaction hash of the sent transaction.

Batch transactions

Smart wallets support sending a batch of transactions in a single, atomic submission to the network.

sendTransaction: (input: {calls: Array<{to: string, value?: bigint, data?: string}>}, opts?: {uiOptions?: SendTransactionModalUIOptions}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/react-auth/smart-wallets';
const {client} = useSmartWallets();
client.sendTransaction({
    calls: [
        // Approve transaction
        {
            to: USDC_ADDRESS,
            data: encodeFunctionData({
                abi: USDC_ABI,
                functionName: 'approve',
                args: ['insert-spender-address', BigInt(1e6)]
            })
        },
        // Transfer transaction
        {
            to: USDC_ADDRESS,
            data: encodeFunctionData({
                abi: USDC_ABI,
                functionName: 'transfer',
                args: ['insert-recipient-address', BigInt(1e6)]
            })
        }
    ]
}).then((txHash) => {
    console.log(txHash);
});

Parameters

The sendTransaction method for batching accepts the following parameters:

input.calls

Array<{to: string, value?: bigint, data?: string}>

required

Array of transactions to batch together.

opts.uiOptions

SendTransactionModalUIOptions

Optional UI customization options for the transaction prompt.

Returns

txHash

Hex

The transaction hash of the batched transaction.

Switch chains

Use the getClientForChain method to create a new smart wallet client for a specific chain.

getClientForChain: ({id: number}) => Promise<SmartWalletClient>

Usage

import {base} from 'viem/chains';
const {getClientForChain} = useSmartWallets();
const baseClient = await getClientForChain({
    id: base.id,
});
// Client will send transaction on Base
baseClient.sendTransaction({
    ...
});

Parameters

The getClientForChain method accepts the following parameters:

number

required

The chain ID to create a client for.

Returns

client

SmartWalletClient

A new smart wallet client configured for the specified chain.

Follow the React Native setup guide to configure smart wallets for your React Native application.

Get the smart wallet address

Once a smart wallet has been created for a user, you can get the address for the smart wallet by finding the account of type: 'smart_wallet' from the user’s linked_accounts array.

const {user} = usePrivy();
const smartWallet = user.linked_accounts.find((account) => account.type === 'smart_wallet');
console.log(smartWallet.address);
// Logs the smart wallet's address
console.log(smartWallet.type);
// Logs the smart wallet type (e.g. 'safe', 'kernel', 'light_account', 'biconomy', 'thirdweb', 'coinbase_smart_wallet')

Sign a message

Use the signMessage function from the client returned by useSmartWallets hook in your React Native component to sign a message using the user’s smart wallet.

signMessage: ({message: SignableMessage}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/expo/smart-wallets';
const {client} = useSmartWallets();
client.signMessage({message: 'Hello, world!'}).then((signature) => {
    console.log(signature);
});

Parameters

The signMessage method accepts the following parameters:

input.message

string | {raw: Hex | ByteArray}

required

The message to sign by the smart account.

Returns

signature

Hex

The signed message by the smart wallet.

Sign typed data

Use the signTypedData function from the client returned by useSmartWallets hook in your React Native component to sign structured data using the user’s smart wallet.

signTypedData: (input: SignTypedDataParameters) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/expo/smart-wallets';
const {client} = useSmartWallets();
client.signTypedData(...).then((signature) => {
    console.log(signature);
});

Parameters

The signTypedData method accepts the following parameters:

input

SignTypedDataParameters

required

The typed data to sign by the smart account.

Returns

signature

Hex

The signed message by the smart wallet.

Send a transaction

Use the sendTransaction function from the client returned by useSmartWallets hook in your React Native component to send a transaction using the user’s smart wallet.

sendTransaction: (input: SendTransactionParameters) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/expo/smart-wallets';
const {client} = useSmartWallets();
client.sendTransaction({
    account: client.account,
    chain: base,
    to: 'insert-recipient-address',
    value: 0.1
}).then((txHash) => {
    console.log(txHash);
});

Parameters

The sendTransaction method accepts the following parameters:

input

SendTransactionParameters

required

The transaction to send by the smart account.

Returns

txHash

Hex

The transaction hash of the sent transaction.

Batch transactions

Smart wallets support sending a batch of transactions in a single, atomic submission to the network.

sendTransaction: (input: {calls: Array<{to: string, value?: bigint, data?: string}>}) => Promise<Hex>

Usage

import {useSmartWallets} from '@privy-io/expo/smart-wallets';
const {client} = useSmartWallets();
client.sendTransaction({
    account: client.account,
    calls: [
        // Approve transaction
        {
            to: USDC_ADDRESS,
            data: encodeFunctionData({
                abi: USDC_ABI,
                functionName: 'approve',
                args: ['insert-spender-address', BigInt(1e6)]
            })
        },
        // Transfer transaction
        {
            to: USDC_ADDRESS,
            data: encodeFunctionData({
                abi: USDC_ABI,
                functionName: 'transfer',
                args: ['insert-recipient-address', BigInt(1e6)]
            })
        }
    ]
}).then((txHash) => {
    console.log(txHash);
});

Parameters

The sendTransaction method for batching accepts the following parameters:

input.calls

Array<{to: string, value?: bigint, data?: string}>

required

Array of transactions to batch together.

Returns

txHash

Hex

The transaction hash of the batched transaction.

The smart wallet client will default to using the first configured chain that has a smart wallet network configuration.

​Get the smart wallet address

​Sign a message

​Usage

​Parameters

​Returns

​Sign typed data

​Usage

​Parameters

​Returns

​Send a transaction

​Usage

​Parameters

​Returns

​Batch transactions

​Usage

​Parameters

​Returns

​Switch chains

​Usage

​Parameters

​Returns

​Get the smart wallet address

​Sign a message

​Usage

​Parameters

​Returns

​Sign typed data

​Usage

​Parameters

​Returns

​Send a transaction

​Usage

​Parameters

​Returns

​Batch transactions

​Usage

​Parameters

​Returns

​Switch chains

​Usage

​Parameters

​Returns

​Get the smart wallet address

​Sign a message

​Usage

​Parameters

​Returns

​Sign typed data

​Usage

​Parameters

​Returns

​Send a transaction

​Usage

​Parameters

​Returns

​Batch transactions

​Usage

​Parameters

​Returns

API reference

Wallets

Account funding

Policies

Transactions

Key quorums

Users

​Get the smart wallet address

​Sign a message

​Usage

​Parameters

​Returns

​Sign typed data

​Usage

​Parameters

​Returns

​Send a transaction

​Usage

​Parameters

​Returns

​Batch transactions

Get the smart wallet address

Sign a message

Usage

Parameters

Returns

Sign typed data

Usage

Parameters

Returns

Send a transaction

Usage

Parameters

Returns

Batch transactions

Usage

Parameters

Returns

Switch chains

Usage

Parameters

Returns

Get the smart wallet address

Sign a message

Usage

Parameters

Returns

Sign typed data

Usage

Parameters

Returns

Send a transaction

Usage

Parameters

Returns

Batch transactions

Usage

Parameters

Returns

Switch chains

Usage

Parameters

Returns

Get the smart wallet address

Sign a message

Usage

Parameters

Returns

Sign typed data

Usage

Parameters

Returns

Send a transaction

Usage

Parameters

Returns

Batch transactions

Usage

Parameters

Returns

Get the smart wallet address

Sign a message

Usage

Parameters

Returns

Sign typed data

Usage

Parameters

Returns

Send a transaction

Usage

Parameters

Returns

Batch transactions

Usage

Parameters

Returns

Switch chains

Usage

Parameters

Returns