# @biconomy/bundler 中文文档

规范地址：https://npmcn.com/package/%40biconomy/bundler/

版本：3\.1\.4
npm 元数据更新时间：2025-05-13T14:46:27.662Z
中文译文更新时间：2026-11-08T03:31:05.763Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：122 kB，23 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2023-07-13T09:31:03.139Z
- 最新版本发布：2024-10-11T14:34:33.582Z
- 近 30 天下载量：1908（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 0 个）

## 中文简介

Biconomy Bundler 软件包可以按照 ERC4337 标准与任何捆绑节点交互

## 安装

```sh
npm install @biconomy/bundler
```

也可以使用：`pnpm add @biconomy/bundler`、`yarn add @biconomy/bundler`、`bun add @biconomy/bundler`

## README

### 邦德勒语Name

在(ERC4337)方面,捆绑者在基础设施中起主要作用. 这一概念是使用Ethereum虚拟机(EVM)的任何网络中账户抽象操作的组成部分.

## 安装

使用 `npm` 软件包管理器

```bash
npm i @biconomy/bundler
```

或

使用 `yarn` 软件包管理器

```bash
yarn add @biconomy/bundler
```

## 配置

| 密钥 | 说明 |
| --- | --- |
| 捆绑者 | 代表 ERC4337 spec 已执行的捆绑器 URL 。 您可以从 bicoomy 仪表板中获取一个 。 或者,你可以提供任何你喜欢的 |
| 链路 | 这代表您的智能钱包交易将在网络上进行 。 查看 Link 所支持的链式 ID |
| 输入点地址 | 由于入口可以有不同的地址, 您可以在捆绑器中调用 GetApplied EntryPoints( ) , 以获取所支持的地址列表 |

```typescript
// This is how you create bundler instance in your dapp's
import { IBundler, Bundler } from "@biconomy/bundler";

// Make use of core-types package
import { ChainId } from "@biconomy/core-types";

const bundler: IBundler = new Bundler({
  bundlerUrl: "",
  chainId: ChainId.POLYGON_MAINNET,
  entryPointAddress: "",
});
```

可用 bongr 实例调用的方法如下

```typescript
export interface IBundler {
  estimateUserOpGas(userOp: Partial<UserOperation>): Promise<UserOpGasResponse>;
  sendUserOp(userOp: UserOperation): Promise<UserOpResponse>;
  getUserOpReceipt(userOpHash: string): Promise<UserOpReceipt>;
  getUserOpByHash(userOpHash: string): Promise<UserOpByHashResponse>;
}
```

**估计用户OpGas** 估计用户操作的气体值。 鉴于用户操作可选择无天然气限制和天然气价格,返回所需的天然气限制。 钱包忽略了签名字段,因此操作不需要用户的批准. 尽管如此,它仍可能需要放置"半有效"的签名(如在正确的长度上签名)

**返回值**

**验证前Gas** 此用户操作的燃气管理费 **校验GasLimit** 本用户操作验证所使用的实际气体 **调用 GasLimit** 用于执行 userop.callData 从 EntryPoint 调用到智能账户的限制

```
              --------------------------------
```

**发送用户Op** 它向客户端的用户操作池提交用户操作对象。 客户端 MUST 验证用户操作, 并相应返回结果 .

如果且只有在请求通过模拟并在客户端的用户操作池中被接受时,结果才应设定给用户OpHash. 如果验证、模拟或用户操作池包含失败,则不应返回结果 。 相反,客户应该归还失败的原因.

**返回值** 如果用户操作有效, 客户端 MUST 返回计算过的用户 OpHash

```
              --------------------------------
```

**获取用户OpByHash** 返回基于散列( userOpHash) 的用户操作( eth sendUser Operation)

**返回值**

如果用户操作尚未包含在块中, 或完整的用户操作中, 加上条目点、 块数、 块数、 块Hash 和 交易Hash, 则无效

```
              --------------------------------
```

**获取用户OpRecept**

返回 eth sendUser 操作返回的基于散列( userOpHash) 的用户操作收据

**返回值** 如果用户操作尚未包括在块中,则无效,或者:

**用户 OpHash** 请求散列 **条目点** **发送者** **无** **付费人** 用于此用户的支付符 Op( 或空) **实际数值** - 实际支付的金额(按账户或付款人分列) **实际使用量** - 用户操作所使用的气体总量(包括核查前、创建、验证和执行) **成功** boolean - 此执行未返回完成 **原因** 如果还原,这就是还原的原因 **日志** 此用户操作生成的日志( 不包括同一捆绑中其他用户操作的日志) **收据** 交易检索对象。 请注意, 返回的交易记录是针对整个捆绑, 不仅仅是针对此用户操作 .

```
              --------------------------------
```

## 常见问题

### @biconomy/bundler 是什么？

Biconomy Bundler 软件包可以按照 ERC4337 标准与任何捆绑节点交互

### 如何安装 @biconomy/bundler？

在项目目录运行 npm install @biconomy/bundler，或使用 pnpm add / yarn add / bun add。

### @biconomy/bundler 支持 TypeScript 吗？

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

### @biconomy/bundler 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @biconomy/bundler 可以商用吗？

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

### @biconomy/bundler 的下载量有多少？

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

### @biconomy/bundler 还在维护吗？

最新版本 3\.1\.4 发布于 2024/10/11（2 年前）；至今共发布 15 个版本，其中过去 12 个月发布了 0 个；首次发布于 2023/07/13。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。