# @black-market/sdk 中文文档 规范地址：https://npmcn.com/package/%40black-market/sdk/ 版本：0\.16\.2 npm 元数据更新时间：2026-10-30T04:10:32.390Z 中文译文更新时间：2026-11-08T05:38:39.053Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40black-market/sdk 原文对照：https://npmcn.com/package/%40black-market/sdk/?lang=original 项目主页：https://github.com/abysshopper/black-market-node-sdk#readme 源码仓库：https://github.com/abysshopper/black-market-node-sdk ## 关键信息（来自 npm 元数据） - 包体积（解压后）：3.9 MB，259 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=20 - 运行依赖：1 个 - 首次发布：2026-09-07T00:30:55.538Z - 最新版本发布：2026-10-30T04:10:31.894Z - 近 30 天下载量：4200（2026-10-08 至 2026-11-06，npm 官方下载统计） - 已发布版本数：29（近 12 个月 29 个） ## 中文简介 TypeScript SDK用于Abyss代号的发射,互换和出借. ## 安装 ```sh npm install @black-market/sdk ``` 也可以使用：`pnpm add @black-market/sdk`、`yarn add @black-market/sdk`、`bun add @black-market/sdk` ## README ![Abyss](https://raw.githubusercontent.com/abysshopper/black-market-node-sdk/main/assets/abyss-ziggurat-v3-pale-text-1500x500.png) # Abys 类型脚本 SDK 使用 `@black-market/sdk` 与 [维姆](https://viem.sh/) 发行代币,互换,读出出借市场. 此指南针对 SDK **0.16.2 (中文(简体) )** 罗宾汉链主网**第4663条**) (中文(简体) ). 软件包支持节点 20+; 运行退出的 TypeScript 示例需要 **节点24+**。 。 。 . ## 安装 ```sh pnpm add @black-market/sdk@0.16.2 viem ``` 要运行示例,请使用一个检出: ```sh git clone https://github.com/abysshopper/black-market-node-sdk.git cd black-market-node-sdk pnpm install --frozen-lockfile pnpm build ``` ## 先检查部署 ```sh pnpm examples # To load configuration from an existing working-directory .env explicitly: node --env-file=.env examples/quickstart.ts ``` `pnpm examples` 构建和运行 [`examples/quickstart.ts`](https://npmcn.com/package/%40black-market/sdk/examples/quickstart.ts)。 。 。 . 它读取了链式身份,管弦乐手的注册,以及当前概况的收录. 它不需要钱包,也不需要写作。 它读取过程环境;它确实 **没有** 装入 `.env` 自己来. 导出 `RPC_URL` 在你的外壳或使用中 `--env-file` 如所示. `CHAIN_ID` 默认为 `4663`。 。 。 . ## 运行一个单市场 ERC20 发布会 开始 [`launch-erc20-abyss.ts`](https://npmcn.com/package/%40black-market/sdk/examples/launch-erc20-abyss.ts)一个Abyss/WETH市场, 一个常设职位,一个公开购买, 没有持有者奖赏, 原子处决. ```sh cp -n examples/.env.example .env chmod 600 .env ``` 设定 `LAUNCH_API_URL=https://api.abyss.trading` 还有一个签名来源: `PRIVATE_KEY`,或 `EXAMPLE_KEYSTORE_PATH` 可选 `EXAMPLE_KEYSTORE_PASSWORD`。 。 。 . 使用你自己的资金账户。 保守秘密和收回文件 离Git远点. 发射包装工作指南 `.env`;现有环境值获胜. 可选 `RPC_URL` 选择另一个 Robinhood RPC. 远程端点需要HTTPS. ```sh # Unsigned planning; no chain transactions, uploads, or publication. node examples/launch-erc20-abyss.ts # Authorizes spending and publication, with no further prompt. node examples/launch-erc20-abyss.ts --broadcast # After partial execution, use the ORIGINAL run directory. node examples/launch-erc20-abyss.ts --resume "launch-results/" ``` **广播制定新的计划**,包括新的无色和象征性身份;它不签署干燥计划. 审查广播的印刷经济学也. `--resume` 可以花钱出版; 它继续保存身份,不需要 `--broadcast`。 。 。 . 干跑仍然需要一个签注来源、充足的资金和实时RPC/API的输入和气体预算检查。 它从来不执行发射呼叫数据. ### 理解默认 - ERC20 供应: **1 000 000个令牌**目标FDV: **5 000美元**,或 **0.005美元按键** 在勾选对齐之前. - FDV是一种估价,不是存入的现金。 初始位置仅包含发射符. - 开始购买 : **每次购买0.00001 ETH**.ETH包入WETH;USDG病例通过Kyber转换. - 乙烷是额外的气体。 买入的出价取决于收费,幅度和对齐的开出价. - `EXAMPLE_TARGET_MARKET_CAP_USD` 财务报告和审定财务报表 `EXAMPLE_BUY_AMOUNT_WEI` 更改目标并购买输入. 这些缺省是实例,不是推荐的估价或反狙击的保证. 使用 [有效的定价指南](https://npmcn.com/package/%40black-market/sdk/docs/launch-lifecycle.md#price-the-launch) 在改变供应或范围之前. ## 选择示例 下面每个文件名都在 `examples/`V4案件采用固定收费集合情况; 除非列出USDG,引文为WETH。 位置被永久锁定 . | 文件 | 托肯/奖励 | 市场/位置计数 | 模式/ 购买 | | --- | --- | --- | --- | | `launch-erc20-abyss.ts` | ERC20 / 无 | 地平线:1 | 原子 / 1 | | `launch-erc20-v4.ts` | ERC20 / 无 | V4:1级 | 原子 / 1 | | `launch-erc404-v4.ts` | ERC404 / 无 | V4:1级 | 阶段 / 1 | | `launch-erc404-abyss.ts` | ERC404 / 无 | 地平线:1 | 原子 / 1 | | `launch-erc20-staking-v4.ts` | ERC20 / 摄入 | V4: 2个 | 阶段 / 2 | | `launch-erc20-dividends-abyss.ts` | ERC20 / 红利 | 阿比斯:3个 | 阶段 / 1 | | `launch-erc20-burn-mixed.ts` | ERC20 / 30% 象征性收费燃烧 | V4:2;Abys:1 (英语) | 阶段 / 2 | | `launch-erc404-dividends-mixed.ts` | ERC404 / 红利 | V4: 2; Abys: 3 (英语) | 阶段 / 2 | | `launch-erc20-multi-quote.ts` | ERC20 / 无 | V4 WETH:1;V4 UDG: 1;Abys WETH: 1 | 阶段 / 3 | | `launch-erc20-depth-v4.ts` | ERC20 / 无 | V4:4,早期稀缺 | 阶段 / 1 | | `launch-erc20-dividends-multiquote-mixed.ts` | ERC20 / 红利 | V4 WETH: 2;V4 USDG: 2;Abys WETH: 3 | 阶段 / 3 | ## 为您的整合选择献礼 使用 `listKnownLifecycleProfiles` 提供和部署电线. 规划批次标出当前状态,检查自有上限能力预算,并计算准确的本地开销报价. 它从不模拟发射交易,包括转换. 多个市场总是选择分阶段;一个已知的市场在增加预算时仍可保持原子状态,包括每个交换供资条目2M计算,加上海报分配。 明相相相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相会相相相会相会相会相会相会相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 On4663 每一个发射步骤都使用32M的总气体,包括海报;批准时将气体留给了钱包. 经验转换储备不是任意路由器代码的证据. 保留返回 `planned.mode` 检查 `planned.assessment.ready`,不删除模拟/防字段. | 提供 | 选择它 | 指南 | | --- | --- | --- | | 坎诺克环形山 | 标准/标准 ORACLE / QUOTE ORACLE 池 | [选择献礼](https://npmcn.com/package/%40black-market/sdk/docs/launch-lifecycle.md#choose-an-offering) | | 固定 V4 | 每个游泳池一个钩子,固定钩子费,可选的LP费 | [制定计划](https://npmcn.com/package/%40black-market/sdk/docs/launch-lifecycle.md#build-the-plan) | | 动态 V4 | Oracle - 速度钩费用介于您的最低和最高之间; LP费 0 | [收费配置](https://npmcn.com/package/%40black-market/sdk/docs/reference.md#pool-bound-v4-version-6) | | HMM V2 导弹 | 收费资助的辅助投标/任务;LP和开发商费 | [配置 HMM V2](https://npmcn.com/package/%40black-market/sdk/docs/launch-lifecycle.md#configure-hmm-v2) | | UFG 调制组 | 引用费国库和持有者赎回;仅免酬劳 ERC20 | [发射UFG金库](https://npmcn.com/package/%40black-market/sdk/docs/launch-lifecycle.md#launch-a-ufg-treasury) | | 自动拼接 | 固定/动态接钩费基金永久锁定全程流动资金;LP和开发商费 | [配置自动组合](https://npmcn.com/package/%40black-market/sdk/docs/launch-lifecycle.md#configure-auto-compounding) | | 莱多 | 与Raeto共享固定/动态报价费;仅WETH/USDG,5/10/25/50/75%的共享率,LP和开发商收费0 | [配置雷多](https://npmcn.com/package/%40black-market/sdk/docs/launch-lifecycle.md#configure-raeto) | 11个发射包不发射HMM、UFG、自动装配或Raeto。 开始HMM/UFG集成 [`hmm-launch-config.ts`](https://npmcn.com/package/%40black-market/sdk/examples/hmm-launch-config.ts) 或者说 [`ufg-launch-config.ts`](https://npmcn.com/package/%40black-market/sdk/examples/ufg-launch-config.ts)· ; 用于自动拼接/Raeto,在链接指南中使用已键入的配置6示例。 两者现在都有测量的发射能力简介。 这些是配置路径,而不是部署命令. ## 回收和整合 中断发送后, 检查保存的交易散列并使用 `--resume` 在原始目录中. 如果市场已经活跃,但出版失败,请恢复出版;不要部署其他符号. 跑者把文物保存在下面 `launch-results/`; 保留其唯一所有者的恢复文件. - [发射指南](https://npmcn.com/package/%40black-market/sdk/docs/launch-lifecycle.md)• 收费和回收. - [运行引用](https://npmcn.com/package/%40black-market/sdk/examples/README.md)环境 11个病例 文物 恢复行为. - [SDK 参考](https://npmcn.com/package/%40black-market/sdk/docs/reference.md):地址,代码,限制,硝气,以及作者API. - [天然气和RPC证据](https://npmcn.com/package/%40black-market/sdk/docs/lifecycle-gas-profiles.md):本土上限,确定容量/预算,准确的本地购买数学和0.15.1迁移. - [更改日志](https://npmcn.com/package/%40black-market/sdk/CHANGELOG.md) • 妇女 [麻省理工学院许可证](https://npmcn.com/package/%40black-market/sdk/LICENSE) ## 常见问题 ### @black-market/sdk 是什么？ TypeScript SDK用于Abyss代号的发射,互换和出借\. ### 如何安装 @black-market/sdk？ 在项目目录运行 npm install @black-market/sdk，或使用 pnpm add / yarn add / bun add。 ### @black-market/sdk 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @black-market/sdk 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @black-market/sdk 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @black-market/sdk 可以商用吗？ @black-market/sdk 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @black-market/sdk 的下载量有多少？ 根据 npm 官方下载统计，@black-market/sdk 在 2026/10/08 – 2026/11/06 这 30 天内被下载 4,200 次，日均约 140 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @black-market/sdk 还在维护吗？ 最新版本 0\.16\.2 发布于 2026/10/30（9 天前）；至今共发布 29 个版本，其中过去 12 个月发布了 29 个；首次发布于 2026/09/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。