createAbstractClient

Use the createAbstractClient function to initialize an AbstractClient instance, which provides a set of actions and methods to make use of the Abstract Global Wallet. This is useful if you need to create a new AbstractClient instance when you already have a signer, such as in the server-side environment of your application.

Import

import { createAbstractClient } from "@abstract-foundation/agw-client";
import type { AbstractClient } from "@abstract-foundation/agw-client"; // Optional

Usage

import { createAbstractClient } from "@abstract-foundation/agw-client";
import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
import { abstractTestnet } from "viem/chains";

// As an example, we are creating a new dummy account here for the signer.
const randomPrivateKey = generatePrivateKey(); // Make a random private key
const account = privateKeyToAccount(randomPrivateKey); // Use that to create a signer

const agwClient = await createAbstractClient({
  chain: abstractTestnet,
  signer: account, // The "owner" (initial approved signer) of the AGW smart contract wallet.
});

const hash = await agwClient.sendTransaction({
  to: "0x273B3527BF5b607dE86F504fED49e1582dD2a1C6",
  data: "0x69",
});

console.log("Transaction sent:", `https://sepolia.abscan.org/tx/${hash}`);

Parameters

Account

required

The EOA account that owns the AGW smart contract wallet.

If this account has not yet created an Abstract Global Wallet, the first transaction they send will first deploy one, set the account as the owner and then continue with the transaction.
If the account has already created an Abstract Global Wallet, it will use the existing AGW.

ChainEIP712

required

A valid EIP712 chain such as abstractTestnet.

ChainEIP712

A viem Transport. Defaults to http().

Returns

Returns an AbstractClient instance. This is an extension of the Viem wallet client with additional methods and properties specific to the Abstract Global Wallet.

Show methods

Account

Returns the Abstract Global Wallet account created using the createClient function.The account has the address of the AGW smart contract wallet using getSmartAccountAddressFromInitialSigner.

{ multicall?: boolean | MulticallBatchOptions }

Configuration for batch operations. It includes an optional multicall property which can be:

boolean: To enable/disable eth_call multicall aggregation.
MulticallBatchOptions: An object to fine-tune multicall behavior with properties:
- batchSize: The maximum size (in bytes) for each calldata chunk. Default is 1024.
- wait: The maximum number of milliseconds to wait before sending a batch. Default is 0.

number

Time (in ms) that cached data will remain in memory.

Function

CCIP Read configuration.If set to false, the client will not support offchain CCIP lookups.

ChainEIP712

Returns the current chain configuration.

Function

Deploys a new smart contract from the AGW smart contract wallet. See deployContract.

Function

Extends the client with additional functionality.

string

A unique identifier for the client instance.

string

The name of the client.

number

Frequency (in ms) for polling enabled actions & events. Defaults to 4000 milliseconds.

Function

Request function wrapped with friendly error handling.

Function

Sends a transaction to the network from the AGW smart contract wallet. See sendTransaction.

Function

Sends multiple transactions in a single call from the AGW smart contract wallet. See sendTransactionBatch.

Transport

The RPC transport.

string

The type of the client.

string

A unique identifier for the client.

Function

Call a function on a smart contract from the AGW smart contract wallet. See writeContract.

Abstract Global Wallet

Library Integrations

Abstract Client

Wallet Actions

Session Keys

FIAT On-ramp

Utils

createAbstractClient

Import

Usage

Parameters

Returns

​Import

​Usage

​Parameters

​Returns

Import

Usage

Parameters

Returns