Skip to main content

Smart Wallets

Use engine to deploy, manage, and transact with smart wallets on behalf of your users.

Deploy an account factory​

To deploy smart wallet accounts (referred to as "accounts" from here on), deploy an AccountFactory contract. This contract handles deploying individual Account contracts for your users.

Endpoint: POST /deploy/<chain>/deployer.thirdweb.eth/AccountFactory

Payload:

{
  "constructorParams": ["0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789"]
}

Deploy user accounts​

Once the factory is set up, deploy accounts for your users.

Endpoint: POST /contract/<chain>/<account_factory_address>/account-factory/create-account

Body:

{
  "adminAddress": "0x..." // The user's wallet address to deploy a smart wallet for
}

This adds the adminAddress as the primary admin that can act on behalf of the newly deployed account.

To control the account with a backend wallet, specify the backend wallet in the adminAddress field.

Grant permissions and sessions​

Grant & revoke admins on an account with the /contract/<chain>/<account_address>/account/admins endpoints.

Grant & revoke sessions on an account which allow specific wallets to interact with specified contracts for a given period of time with the /contract/<chain>/<account_address>/account/sessions endpoints.

Transact with an account​

Make write calls with a smart account by calling a write endpoint and specify the x-backend-wallet-address and x-account-address headers.

The x-backend-wallet-address should be set to the engine backend wallet that is an admin over the account.

The x-account-address should be set to the deployed account address itself.

Write calls made using these headers will initiate a UserOperation sent from the specified account.