@biconomy/paymaster

中文文档
3.1.4发布于 2024/10/11MITTypeScriptCommonJS近 30 天下载 2060

Bicoomy Paymaster 与 Paymaster Services 互动, 与 (vriy and sorry ) 的 Paymaster 服务互动

中文使用文档

付费主管

ERC4337,账户抽象,引入了付费主的概念. 这些专门实体在改造EVM交易中的传统天然气支付系统方面发挥着关键作用。 作为第三方中介的付费主管具备担保某一账户的燃气费的能力,条件是满足具体预先确定的条件.

安装

使用 npm 软件包管理器

npm i @biconomy/paymaster

或

使用 yarn 软件包管理器

yarn add @biconomy/paymaster

使用量

// This is how you create paymaster instance in your dapp's
import { IPaymaster, BiconomyPaymaster } from "@biconomy/paymaster";

// Currently this package only exports Biconomy Paymaster which acts as a Hybrid paymaster for gas abstraction. You can sponsor user transactions but can also make users pay gas in supported ERC20 tokens.

const paymaster = new BiconomyPaymaster({
  paymasterUrl: "", // you can get this value from biconomy dashboard. https://dashboard.biconomy.io
});

付费管理者Url 您可以从双相仪表板获得这个值.

下面是可以向付费人求助的方法

export interface IHybridPaymaster<T> extends IPaymaster {
  getPaymasterAndData(userOp: Partial<UserOperation>, paymasterServiceData?: T): Promise<PaymasterAndDataResponse>;
  buildTokenApprovalTransaction(tokenPaymasterRequest: BiconomyTokenPaymasterRequest, provider: Provider): Promise<Transaction>;
  getPaymasterFeeQuotesOrData(userOp: Partial<UserOperation>, paymasterServiceData: FeeQuotesOrDataDto): Promise<FeeQuotesOrDataResponse>;
}

也可以建立自己的Paymaster API类,并提交 PR 或仅在账户包中提供实例 / 单独使用生成Paymaster AndData

它应该遵循界面下面.

export interface IPaymaster {
  // Implementing class may add extra parameter (for example paymasterServiceData with it's own type) in below function signature
  getPaymasterAndData(userOp: Partial<UserOperation>): Promise<PaymasterAndDataResponse>;
  getDummyPaymasterAndData(userOp: Partial<UserOperation>): Promise<string>;
}

API 方法下方可用于 Biconomy 混合付费

获取 Paymaster 安达塔

此函数接受 a Partial<UserOperation> 对象,包括所有属性 userOp 除外 signature 财务报告和审定财务报表 paymasterAndData 字段。 它回来了 paymasterAndData 作为《京都议定书》 PaymasterAndDataResponse

构建 Token 核准交易

此功能专门用于象征性的付费赞助. 此功能的主要目的是为付费人创建一个批准交易, 并随其他交易进行批发.

注:您不需要调用此函数 。 它会自动被调用为 buildTokenPaymasterUserOp 函数调用.

获取 PaymasterFee 引用 OrData

此功能用于根据提供的用户操作和付费主服务数据获取引用信息或付费主数据. 如果未提供明确的模式,它首先尝试赞助,然后回到支持/请求的代号的服务费报价

说明: 此函数可以返回 付费主AndData 也以防所有政策检查都通过.

版本与发布记录

@biconomy/paymaster 共发布 15 个版本,首次发布于 2023/07/13;过去 12 个月发布了 0 个版本。

版本发布日期距今
3.1.4latest2024/10/112 年前
4.1.12024/03/072 年前
4.1.02024/03/062 年前
4.0.22024/02/272 年前
4.0.12024/02/222 年前
4.0.02024/02/122 年前

关于 @biconomy/paymaster 的常见问题

@biconomy/paymaster 是什么?

Bicoomy Paymaster 与 Paymaster Services 互动, 与 (vriy and sorry ) 的 Paymaster 服务互动

如何安装 @biconomy/paymaster?

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

@biconomy/paymaster 支持 TypeScript 吗?

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

@biconomy/paymaster 支持 ESM 还是 CommonJS?

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

@biconomy/paymaster 可以商用吗?

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

@biconomy/paymaster 的下载量有多少?

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

@biconomy/paymaster 还在维护吗?

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