# @alchemy/smart-accounts 中文文档

规范地址：https://npmcn.com/package/%40alchemy/smart-accounts/

版本：5\.3\.0
npm 元数据更新时间：2026-10-05T17:38:45.025Z
中文译文更新时间：2026-11-05T21:47:23.924Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40alchemy/smart-accounts
原文对照：https://npmcn.com/package/%40alchemy/smart-accounts/?lang=original
项目主页：https://github.com/alchemyplatform/aa-sdk#readme
源码仓库：https://github.com/alchemyplatform/aa-sdk

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3.4 MB，405 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：viem ^2\.45\.0
- 首次发布：2025-11-24T16:28:45.513Z
- 最新版本发布：2026-10-05T17:38:44.845Z
- 近 30 天下载量：15996（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：71（近 12 个月 71 个）

## 中文简介

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

## 安装

```sh
npm install @alchemy/smart-accounts
```

也可以使用：`pnpm add @alchemy/smart-accounts`、`yarn add @alchemy/smart-accounts`、`bun add @alchemy/smart-accounts`

## README

# @ alchemy/ smart- 账户

此软件包替换 `@account-kit/smart-contracts`。这是一个低级软件包。 多数用户应使用 [`@alchemy/wallet-apis`](https://www.alchemy.com/docs/wallets/reference/wallet-apis) 除非您需要通过viem直接使用智能账户的接口.

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

## 安装

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

## 示例使用

```ts
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 是什么？

这个软件包包含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 和提交记录判断。