# @biconomy/abstractjs 中文文档 规范地址：https://npmcn.com/package/%40biconomy/abstractjs/ 版本：2\.0\.2 npm 元数据更新时间：2026-09-01T17:50:35.960Z 中文译文更新时间：2026-11-08T01:36:10.504Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40biconomy/abstractjs 原文对照：https://npmcn.com/package/%40biconomy/abstractjs/?lang=original 项目主页：https://biconomy.io/ 源码仓库：https://github.com/bcnmy/abstractjs ## 关键信息（来自 npm 元数据） - 包体积（解压后）：4.7 MB，1289 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - 运行依赖：0 个 - peer 依赖：@safe-global/types-kit 3\.0\.0，@noble/curves 2\.0\.1，@openzeppelin/merkle-tree 1\.0\.8，@metamask/delegation-toolkit ^0\.11\.0，@rhinestone/module-sdk 0\.4\.0，typescript ^5\.8\.2，viem ^2\.26\.2 - 首次发布：2025-01-20T11:22:51.889Z - 最新版本发布：2026-09-01T17:50:35.695Z - 近 30 天下载量：52886（2026-10-08 至 2026-11-06，npm 官方下载统计） - 已发布版本数：69（近 12 个月 14 个） ## 中文简介 SDK为 Biconomy 集成,支持账户抽象,智能账户,ERC-4337. ## 安装 ```sh npm install @biconomy/abstractjs ``` 也可以使用：`pnpm add @biconomy/abstractjs`、`yarn add @biconomy/abstractjs`、`bun add @biconomy/abstractjs` ## README [![Biconomy](https://img.shields.io/badge/Made_with_%F0%9F%8D%8A_by-Biconomy-ff4e17?style=flat)](https://biconomy.io/) [![Build](https://github.com/bcnmy/abstractjs/actions/workflows/build.yml/badge.svg)](https://github.com/bcnmy/abstractjs/actions) [![License MIT](https://img.shields.io/badge/License-MIT-blue?&style=flat)](https://npmcn.com/package/%40biconomy/abstractjs/LICENSE) [![codecov](https://codecov.io/github/bcnmy/abstractjs/graph/badge.svg?token=DTdIR5aBDA)](https://codecov.io/github/bcnmy/abstractjs) [![install size](https://packagephobia.com/badge?p=@biconomy/abstractjs)](https://packagephobia.com/result?p=@biconomy/abstractjs) # 缩写 [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/bcnmy/abstractjs) Biconomy SDK是用于构建分散应用程序(dApps)的全能工具箱 **ERC4337 账户摘要** 财务报告和审定财务报表 **智能账户**它旨在提供无缝用户体验,为用户登机、发送交易(用户Ops)、天然气赞助等提供非封闭性解决方案. ## 目录 - [(原始内容存档于2019-09-21) (英语). SDK QQ](https://npmcn.com/package/%40biconomy/abstractjs/#readme-sdk-) - [目录](https://npmcn.com/package/%40biconomy/abstractjs/#readme--table-of-contents) - [QQ 快速启动](https://npmcn.com/package/%40biconomy/abstractjs/#readme--quickstart) - [安装](https://npmcn.com/package/%40biconomy/abstractjs/#readme-installation) - [测试](https://npmcn.com/package/%40biconomy/abstractjs/#readme-testing) - [文件和资源](https://npmcn.com/package/%40biconomy/abstractjs/#readme--documentation-and-resources) - [实例](https://npmcn.com/package/%40biconomy/abstractjs/#readme--examples) - [许可证](https://npmcn.com/package/%40biconomy/abstractjs/#readme-license) - [连接 Biconomy QQ](https://npmcn.com/package/%40biconomy/abstractjs/#readme-connect-with-biconomy-) ## QQ 快速启动 ### 安装 1. **添加软件包 :** ```bash bun add @biconomy/abstractjs viem @rhinestone/module-sdk ``` 2. **基本用途:** ```typescript import { toMultichainNexusAccount, mcUSDC, createMeeClient, getMEEVersion, MEEVersion } from "@biconomy/abstractjs"; import { base, optimism } from "viem/chains"; import { privateKeyToAccount } from "viem/accounts"; import { http } from "viem"; const eoaAccount = privateKeyToAccount(`0x${process.env.PRIVATE_KEY}`) const mcNexus = await toMultichainNexusAccount({ signer: eoaAccount, chainConfigurations: [ { chain: base, transport: http(), version: getMEEVersion(MEEVersion.V2_1_0) }, { chain: optimism, transport: http(), version: getMEEVersion(MEEVersion.V2_1_0) } ] }) const meeClient = await createMeeClient({ account: mcNexus }) const quote = await meeClient.getQuote({ instructions: [{ calls: [{ to: "0x...", value: 1n, gasLimit: 100000n }], chainId: base.id }], feeToken: { address: mcUSDC.addressOn(base.id), chainId: base.id } }) // Execute the quote and get back a transaction hash // This sends the transaction to the network const { hash } = await meeClient.executeQuote({ quote }) ``` ### 测试 **先决条件:** - [节点.js](https://nodejs.org/en/download/package-manager) _(v22或以上)_ - [阿宝](https://bun.sh/) 软件包管理器 - [创建](https://book.getfoundry.sh/getting-started/installation) - [雅伦](https://www.npmjs.com/package/yarn) _(必须是1.1.x,而不是3.x)_。这是必要的,因为关系合同重接依赖于线条. **设置 :** ```bash bun install --frozen-lockfile ``` **供资测试账户:** ```bash # Fund test nexus accounts with native tokens and USDC, using a funded PRIVATE_KEY master account bun run fund:nexus ``` **运行测试 :** ```bash # Run all tests bun run test # Run tests in watch mode for a specific subset of tests (by test description) bun run test:watch -t=mee ``` 关于测试框架、网络配置和调试准则的详细信息,请参见我们 [测试文档](https://npmcn.com/package/%40biconomy/abstractjs/src/test/README.md)。 。 。 . ## 文件和资源 为了全面了解我们的项目并作出有效贡献,请参考以下资源: - [**双曲线文档**](https://docs.biconomy.io/) - [**双曲线板**](https://dashboard.biconomy.io/) - [**API 文档**](https://bcnmy.github.io/abstractjs) - [**贡献准则**](https://npmcn.com/package/%40biconomy/abstractjs/CONTRIBUTING.md):学习如何为我们的项目做出贡献,从代码贡献到文件的改进. - [**行为守则**](https://npmcn.com/package/%40biconomy/abstractjs/CODE_OF_CONDUCT.md):我们致力于营造一个开放和受欢迎的环境. - [**安全政策**](https://npmcn.com/package/%40biconomy/abstractjs/SECURITY.md)报告安全脆弱性的准则. - [**更改日志**](https://npmcn.com/package/%40biconomy/abstractjs/CHANGELOG.md): 随修改和版本而不断更新 ## 许可证 这个项目根据麻省理工学院的许可证获得许可。 见 [自由主义](https://npmcn.com/package/%40biconomy/abstractjs/LICENSE) 详细文件 ## 连接 Biconomy QQ [![Website](https://img.shields.io/badge/%F0%9F%8D%8A-Website-ff4e17?style=for-the-badge&logoColor=white)](https://biconomy.io/) [![Telegram](https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/biconomy) [![Twitter](https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white)](https://twitter.com/biconomy) [![LinkedIn](https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/company/biconomy) [![Discord](https://img.shields.io/badge/Discord-7289DA?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/biconomy) [![YouTube](https://img.shields.io/badge/YouTube-FF0000?style=for-the-badge&logo=youtube&logoColor=white)](https://www.youtube.com/channel/UC0CtA-Dw9yg-ENgav_VYjRw) [![GitHub](https://img.shields.io/badge/GitHub-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/bcnmy/) ## 常见问题 ### @biconomy/abstractjs 是什么？ SDK为 Biconomy 集成,支持账户抽象,智能账户,ERC-4337\. ### 如何安装 @biconomy/abstractjs？ 在项目目录运行 npm install @biconomy/abstractjs，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@safe-global/types-kit（3\.0\.0）、@noble/curves（2\.0\.1）、@openzeppelin/merkle-tree（1\.0\.8）、@metamask/delegation-toolkit（^0\.11\.0）、@rhinestone/module-sdk（0\.4\.0）、typescript（^5\.8\.2）、viem（^2\.26\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @biconomy/abstractjs 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @biconomy/abstractjs 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @biconomy/abstractjs 可以商用吗？ @biconomy/abstractjs 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @biconomy/abstractjs 的下载量有多少？ 根据 npm 官方下载统计，@biconomy/abstractjs 在 2026/10/08 – 2026/11/06 这 30 天内被下载 52,886 次，日均约 1,763 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @biconomy/abstractjs 还在维护吗？ 最新版本 2\.0\.2 发布于 2026/09/02（2 个月前）；至今共发布 69 个版本，其中过去 12 个月发布了 14 个；首次发布于 2025/01/20。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。