@alchemy/smart-accounts

中文文档
5.3.0发布于 2026/10/06MITTypeScriptES Module近 30 天下载 1.6万

这个软件包包含Alchemy智能合同账户的所有viem接口

中文使用文档
文档目录7 节
  1. 安装
  2. 示例使用
  3. 密钥导出
  4. 光线账户
  5. 模块账户 v1 (ERC-6900)
  6. 模块账户 v2
  7. 许可证

@ alchemy/ smart- 账户

此软件包替换 @account-kit/smart-contracts。这是一个低级软件包。 多数用户应使用 @alchemy/wallet-apis 除非您需要通过viem直接使用智能账户的接口.

与Alchemy智能合同账户的相容智能账户实施. 用 EIP-7702 支持 Light Account, Modular Account v1, 和 Modular Account v2 .

安装

npm install @alchemy/smart-accounts @alchemy/common viem

示例使用

import { createPublicClient } from "viem";
import {
  createBundlerClient,
  createPaymasterClient,
} from "viem/account-abstraction";
import { sepolia } from "viem/chains";
import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
import { alchemyTransport } from "@alchemy/common";
import { estimateFeesPerGas } from "@alchemy/aa-infra";
import { toModularAccountV2 } from "@alchemy/smart-accounts";

const transport = alchemyTransport({ apiKey: "YOUR_API_KEY" });

// 1. Create a MAv2 smart account
const account = await toModularAccountV2({
  client: createPublicClient({ chain: sepolia, transport }),
  owner: privateKeyToAccount(generatePrivateKey()),
});

// 2. Create a bundler client with the account
const bundlerClient = createBundlerClient({
  account,
  chain: sepolia,
  transport,
  userOperation: {
    estimateFeesPerGas,
  },
  // Optional: sponsor gas with a paymaster
  paymaster: createPaymasterClient({ transport }),
  paymasterContext: { policyId: "YOUR_POLICY_ID" },
});

// 3. Send a user operation
const hash = await bundlerClient.sendUserOperation({
  calls: [{ to: "0x...", value: 0n, data: "0x" }],
});

const receipt = await bundlerClient.waitForUserOperationReceipt({ hash });

密钥导出

光线账户

  • toLightAccount - 单一所有人光明账户
  • toMultiOwnerLightAccount - 多所有者变体
  • predictLightAccountAddress 编号 : predictMultiOwnerLightAccountAddress - 反事实地址预测

模块账户 v1 (ERC-6900)

  • toMultiOwnerModularAccountV1 - 账户构建器
  • predictMultiOwnerModularAccountV1Address - 地址预测

模块账户 v2

  • toModularAccountV2 - 拥有EIP-7702支助的账户建造者
  • deferralActions 编号 : installValidationActions - 客户装饰器
  • 模块 - 说吧 AllowlistModule, (中文(简体) ), NativeTokenLimitModule, (中文(简体) ), PaymasterGuardModule, (中文(简体) ), SingleSignerValidationModule, (中文(简体) ), TimeRangeModule
  • PermissionBuilder - 会话密钥权限的流利构建器
  • 签字公用事业 - 说吧 packUOSignature, (中文(简体) ), pack1271Signature, (中文(简体) ), toReplaySafeTypedData

许可证

麻省理工学院

版本与发布记录

@alchemy/smart-accounts 共发布 71 个版本,首次发布于 2025/11/25;过去 12 个月发布了 71 个版本。

版本发布日期距今
5.3.0latest2026/10/061 个月前
5.2.72026/09/241 个月前
5.2.62026/09/161 个月前
5.2.52026/09/151 个月前
5.2.02026/08/182 个月前
5.1.12026/08/132 个月前

其他发布通道:alpha → 0.0.0-alpha.23。

关于 @alchemy/smart-accounts 的常见问题

@alchemy/smart-accounts 是什么?

这个软件包包含Alchemy智能合同账户的所有viem接口

如何安装 @alchemy/smart-accounts?

在项目目录运行 npm install @alchemy/smart-accounts,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:viem(^2.45.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@alchemy/smart-accounts 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@alchemy/smart-accounts 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@alchemy/smart-accounts 可以商用吗?

@alchemy/smart-accounts 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@alchemy/smart-accounts 的下载量有多少?

根据 npm 官方下载统计,@alchemy/smart-accounts 在 2026/10/06 – 2026/11/04 这 30 天内被下载 15,996 次,日均约 533 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@alchemy/smart-accounts 还在维护吗?

最新版本 5.3.0 发布于 2026/10/06(1 个月前);至今共发布 71 个版本,其中过去 12 个月发布了 71 个;首次发布于 2025/11/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。