@aa-sdk/ethers

@aa-sdk/ethers

This package contains EthersProviderAdapter and AccountSigner, respective extensions of the JsonRpcProvider and Signer classes defined in ethers.js external library.

If you currently rely ethers.js for web3 development, you can use these ethers.js-compatible JsonRpcProvider and Signer to integrate Account Abstraction into your dApp. You may also find the util methods helpful.

This repo is community maintained and we welcome contributions!

Getting started

If you are already using the @aa-sdk/core package, you can simply install this package and start using the EthersProviderAdapter and AccountSigner. If you are not using @aa-sdk/core, you can install it and follow the instructions in the "Getting started" docs to get started.

yarn add @aa-sdk/ethers

npm i -s @aa-sdk/ethers

pnpm i @aa-sdk/ethers

Usage

You can create a provider and connect it to a signer account like so:

import {
  LightSmartContractAccount,
  getDefaultLightAccountFactoryAddress,
} from "@alchemy/aa-accounts";
import { EthersProviderAdapter } from "@aa-sdk/ethers";
import { LocalAccountSigner, SmartAccountSigner } from "@aa-sdk/core";
import { Alchemy, Network } from "alchemy-sdk";
import { polygonMumbai } from "@aa-sdk/core";

const chain = polygonMumbai;

// 1. Create a provider using EthersProviderAdapter
const alchemy = new Alchemy({
  apiKey: process.env.API_KEY!,
  network: Network.MATIC_MUMBAI,
});
const ethersProvider = await alchemy.config.getProvider();

const provider = EthersProviderAdapter.fromEthersProvider(ethersProvider);

const signer: SmartAccountSigner = LocalAccountSigner.mnemonicToAccountSigner(
  process.env.YOUR_OWNER_MNEMONIC!
);

// 2. Connect the provider to the smart account signer
export const signer = provider.connectToAccount(
  (rpcClient) =>
    new LightSmartContractAccount({
      chain,
      factoryAddress: getDefaultLightAccountFactoryAddress(chain),
      rpcClient,
      signer,
    })
);

Changelog

4.0.0-alpha.1 (2024-06-26)

Bug Fixes

• demo app not building (#733) (b2c229c)
• lowercase strings in the UI components (#784) (1bd922c)
• ui-demo app not building (d308bcf)
• use updated package path in prettier config (#741) (420b9ee)
• yarn.lock had wrong versions of alpha packages (024e9bc)

Code Refactoring

• change the prefix for aa-sdk packages (#722) (9d81aaf)
• move plugingen from aa-sdk to account-kit since it depends on smart-contracts (09e4f33)
• split aa-alchemy into account-kit packages (#704) (c92a07f), closes #706

Features

• adaptive icons for light and dark UI (#713) (61a2960)
• add border radius to account kit theme config (#781) (49d869c)
• add code preview snippets (#760) (c3d3554)
• add color picker (#732) (635933f)
• add custom theme switch component (#726) (a0a7422)
• add illustration styles option (#730) (d4f7dd3)
• add links (#765) (1a3892c)
• add new logo (#762) (a9f4fe1)
• add passkey success state (#711) (a99460d)
• add photo upload (b82bdbf)
• add showBack prop and auto determine navigation (#712) (7b1e68c)
• add skeleton for ui demo (9aac15e)
• add stylize tab (b7173e1)
• add tabs and passkey section to demo app (de59cfa)
• add toggle for code preview mode (#731) (ba276b9)
• add updated error UI + custom error rendering (#705) (0b23625)
• bring the rest of the auth flow inline with the designs (#708) (993f6e2)
• change email validation rule (#710) (f869f5e)
• color picker for dark mode (#777) (3ba3e0b), closes #778
• fix state override parameter type (#720) (6c9c720)
• hook up color and theme variables (#758) (897a136)
• icon animations (#717) (dab1237)
• integrate shadcn and start on auth methods in demo app (b850166)
• logged in state (#763) (59ff217)
• new and improved auth modal (#761) (2795e69)
• pull strings out to their own file for future localization (#715) (5c0d516)
• respect OS or root class for dark mode (#759) (ecd5b01)
• start to bring auth modal styles inline with designs (#702) (6e3502b)
• support different illustration styles (#767) (278e478)
• surface descriptive session key errors (#718) (082d363)
• use brand accent color as icon colors (#780) (10fd04d)

Reverts

• add base skeleton for docs refactor (6d1dea9)

BREAKING CHANGES

• @alchemy/plugingen has been moved to @account-kit/plugingen

• @alchemy/aa-_ packages have been renamed to @aa-sdk/_

• this removes the @alchemy/aa-alchemy package in favor of @account-kit/*

• @alchemy/aa-accounts was deleted in favor of @account-kit/accounts

• refactor: further rename packages