@alchemy/aa-alchemy

@alchemy/aa-alchemy

This package contains AlchemySmartAccountClient, an implementation of SmartAccountClient interface defined in aa-core. It also contains middleware for accessing the Alchemy Gas Manager (an ERC-4337 Paymaster) for doing Fee Estimates according to the expectations of the Alchemy Rundler (an ERC-4337 Bundler). 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 @alchemy/aa-core package, you can simply install this package and start using the AlchemySmartAccountClient. If you are not using @alchemy/aa-core yet, you can install it and follow the instructions in the "Getting started" docs to get started.

yarn add @alchemy/aa-alchemy

npm i -s @alchemy/aa-alchemy

pnpm i @alchemy/aa-alchemy

Usage

You can create AlchemySmartAccountClient like so:

import {
  LightSmartContractAccount,
  getDefaultLightAccountFactoryAddress,
} from "@alchemy/aa-accounts";
import { AlchemyProvider } from "@alchemy/aa-alchemy";
import { LocalAccountSigner, type SmartAccountSigner } from "@alchemy/aa-core";
import { sepolia } from "@alchemy/aa-core";

const chain = sepolia;
const PRIVATE_KEY = "0xYourEOAPrivateKey";
const eoaSigner: SmartAccountSigner =
  LocalAccountSigner.privateKeyToAccountSigner(`0x${PRIVATE_KEY}`);

export const provider = new AlchemyProvider({
  apiKey: "ALCHEMY_API_KEY", // replace with your alchemy api key of the Alchemy app associated with the Gas Manager, get yours at https://dashboard.alchemy.com/
  chain,
}).connect(
  (rpcClient) =>
    new LightSmartContractAccount({
      chain,
      signer: eoaSigner,
      factoryAddress: getDefaultLightAccountFactoryAddress(chain),
      rpcClient,
    })
);

Changelog

4.0.0-beta.0 (2024-08-28)

Bug Fixes

• add missing react-remove-scroll dep (#804) (09d9217)
• add use client to a bunch of hooks that was misisng it (#829) (9be5834)
• await instance reset (#919) (10d5a95)
• core: initial state parsing and disconnect logic (#842) (d3e80ad)
• core: the reconnect method was causing an infinite loop (#808) (0d094e8)
• demo app not building (#733) (2bbf359)
• docs: broken build script for docs (e4ef3d2)
• exporting queryClient and typing uiConfig in example (#844) (f6cc40e)
• fix demo header links and update guide (#845) (817d0ab)
• fixing nav links (#848) (9ec5a40)
• lowercase strings in the UI components (#784) (58422c3)
• merge base into this (e41b396)
• passing gas manager to createConfig should use it (#836) (53b4e95)
• react: fix sign in header hiding itself (#851) (90b3e20)
• ui-demo app not building (e2cb348)
• ui-demo-app: fix the package json to include latest ak pkgs (#825) (78e95fd)
• ui-demo: add passkey toggle wasn't working (#843) (1c11f2d)
• ui-demo: signer state was being cleared when ui config changed (#838) (cc5db85)
• ui-modal: don't render ui modal if no ui config is passed in (#943) (65b1584)
• update CSS override url attempt 2 (#861) (4bd9c04)
• use updated package path in prettier config (#741) (918d65f)
• yarn.lock had wrong versions of alpha packages (fb3ae94)

Code Refactoring

• change the prefix for aa-sdk packages (#722) (02f2f16)

• move plugingen from aa-sdk to account-kit since it depends on smart-contracts (073e8f6)

• split aa-alchemy into account-kit packages (#704) (55e6632), closes #706

• refactor!: move chain definitions out of aa-sdk core (#772) (1385441), closes #772

Features

• aa-sdk/core: add default arguments for erc7677 middleware (#839) (848f316)
• aa-sdk/core: add erc7677 middleware (#823) (4a30808)
• aa: new chain (#835) (1e3b4b9)
• add ability to customize border radius in ui demo (#785) (2ce7d2d)
• add border radius to account kit theme config (#781) (dcd2ac1)
• add code preview snippets (#760) (7215e32)
• add color picker (#732) (f77344d)
• add custom theme switch component (#726) (ff0bc22)
• add doc generator for class methods (#806) (a389f65)
• add illustration styles option (#730) (3a2ec81)
• add injected wallets to the UX (#841) (9de08b3)
• add links (#765) (919e88f)
• add new logo (#762) (2ec34b6)
• add photo upload (ebcf76f)
• add skeleton for ui demo (38f797a)
• add stylize tab (59a3322)
• add tabs and passkey section to demo app (e4d624d)
• add toggle for code preview mode (#731) (3642161)
• add UI config defaults, better back navigation to auth UI (#827) (bf9157c)
• add wallet connect to injected wallet setup (e00166d)
• allow for passkey + email signup (#920) (651a60e)
• chains: add arbnova and shape (#937) (938181b)
• clean up UI state on log out (#832) (85548c8)
• color picker for dark mode (#777) (666d095), closes #778
• enable linting class methods from exported classes (1b87a51)
• erc7677: create a new middle ware for erc7677 to replace gasManager middleWare (#840) (4be87d3)
• hook up color and theme variables (#758) (1714070)
• icon animations (#717) (0368570)
• integrate shadcn and start on auth methods in demo app (723046e)
• logged in state (#763) (69d6c57)
• make it easier to start with account-kit/core (#933) (6d98643)
• new and improved auth modal (#761) (2296917)
• react: enable multi-owner la usage in core and react (#893) (43464da)
• read auth card props from context, simplify UI config (#789) (e7eae44)
• respect OS or root class for dark mode (#759) (66aade5)
• responsive styling for demo app (#810) (a4af327)
• smaller footer in UI components (#811) (ef89ccd)
• some UI component polish from sync with product (#831) (37a98c0)
• support different illustration styles (#767) (37296d3)
• surface descriptive session key errors (#718) (593e84c)
• update some demo app copy and UI for alpha testing (#830) (fd48725)
• updates to demo app UI from design feedback (#805) (c2d7f38)
• use brand accent color as icon colors (#780) (d3d62b3)

Reverts

• add base skeleton for docs refactor (e7663f6)

BREAKING CHANGES

• moves the chain definitions out of aa-sdk core and into account-kit/infra

• @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