Viem
Learn how to use the Viem library to build applications on Abstract.
The Viem library has first-class support for Abstract by providing a set of extensions to interact with paymasters, smart contract wallets, and more. This page will walk through how to configure Viem to utilize Abstract’s features.
1. Installation
Install the viem package.
npm install viem
2. Client Configuration
Configure your Viem client using abstractTestnet
as the chain and extend it with
eip712WalletActions.
import { createPublicClient, createWalletClient, custom, http } from 'viem'
import { abstractTestnet } from 'viem/chains'
import { eip712WalletActions } from 'viem/zksync'
// Create a client from a wallet
const walletClient = createWalletClient({
chain: abstractTestnet,
transport: custom(window.ethereum!),
}).extend(eip712WalletActions()) ;
// Create a client without a wallet
const publicClient = createPublicClient({
chain: abstractTestnet,
transport: http()
}).extend(eip712WalletActions());
Learn more on the official viem documentation.
Reading Blockchain Data
Use a public client to fetch data from the blockchain via an RPC.
const balance = await publicClient.getBalance({
address: "0x8e729E23CDc8bC21c37a73DA4bA9ebdddA3C8B6d",
});
Sending Transactions
Use a wallet client to send transactions to the blockchain.
const transactionHash = await walletClient.sendTransaction({
to: "0x8e729E23CDc8bC21c37a73DA4bA9ebdddA3C8B6d",
data: "0x69",
});
Paymasters
Viem has native support for Abstract paymasters.
Provide the paymaster and paymasterInput fields when sending a transaction.
const hash = await walletClient.sendTransaction({
to: "0x8e729E23CDc8bC21c37a73DA4bA9ebdddA3C8B6d",
paymaster: "0xFD9aE5ebB0F6656f4b77a0E99dCbc5138d54b0BA", // Your paymaster contract address
paymasterInput: "0x", // Any additional data to be sent to the paymaster
});
Smart Contract Wallets
Viem also has native support for using smart contract wallets.
This means you can submit transactions from a smart contract wallet by providing
a smart wallet account as the account field to the client.
import { toSmartAccount, eip712WalletActions } from "viem/zksync";
import { createWalletClient, http } from "viem";
import { abstractTestnet } from "viem/chains";
const account = toSmartAccount({
address: CONTRACT_ADDRESS,
async sign({ hash }) {
// ... signing logic here for your smart contract account
},
});
// Create a client from a smart contract wallet
const walletClient = createWalletClient({
chain: abstractTestnet,
transport: http(),
account: account, // <-- Provide the smart contract wallet account
}).extend(eip712WalletActions());
// ... Continue using the wallet client as usual (will send transactions from the smart contract wallet)