# @blackpool/cli 中文文档

规范地址：https://npmcn.com/package/%40blackpool/cli/

版本：0\.4\.4
npm 元数据更新时间：2026-11-06T02:03:49.884Z
中文译文更新时间：2026-11-08T05:56:54.672Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40blackpool/cli
原文对照：https://npmcn.com/package/%40blackpool/cli/?lang=original
项目主页：https://blackpool.cash/
源码仓库：https://github.com/blackpooldev/blackpool

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

- 包体积（解压后）：167 kB，8 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：3 个
- 首次发布：2026-11-03T02:09:13.871Z
- 最新版本发布：2026-11-06T02:03:49.712Z
- 近 30 天下载量：2196（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

私人支付链上代理。 BLACKPOOL的CLI - 屏蔽,发送,互换,桥由Base,Robinhood Chain,Arbitrum和BNB Smart chain提供零知识隐私.

## 安装

```sh
npm install @blackpool/cli
```

也可以使用：`pnpm add @blackpool/cli`、`yarn add @blackpool/cli`、`bun add @blackpool/cli`

## README

# @blackpool/ cli (英语)

私人支付链上代理。 一个env var 或一个隐藏的提示, 然后屏蔽 / 发送 / 互换 / 桥的零知识隐私 **基础**, (中文(简体) ), **罗宾链**, (中文(简体) ), **坐标**,以及 **BNB 智能链**. 证据是建在您的机器上, 和网络应用一样; 完整的代理指南是 [一般事务人员(其他职等)](https://blackpool.cash/AGENTS.md)。 。 。 .

每个命令都有一个选项 `--chain base|robinhood|arbitrum|bsc` 旗帜( 默认) `base`) (中文(简体) ). 在Base和Arbitrum上,马来币是USDC;在Robinhood上,马来币是USDG;在BSC上,马来币是USDC和USDT(Binance-Peg,18个小数),本地资产是BNB.

## 安装

```bash
npm i -g @blackpool/cli
# or
npx @blackpool/cli help
```

## 设置

两种方式提供你的钥匙,取决于谁运行它.

### 交互式( 人/ 本地演示) - 密钥从未显示

```bash
blackpool login
#   private key: ●●●●●●●●●●   <- hidden input, like sudo password
# ✓ wallet stored at ~/.blackpool/wallet.json (chmod 600)
```

密钥被提示 **隐藏输入** (没有回音,从未输入外壳历史),然后储存在本地 `~/.blackpool/wallet.json` 与 `chmod 600` (只拥有者). 它从未被传送过,签名也没有: 密钥和证明在你的机器上计算.

### Env var (代理/ CI) - 无快捷键

```bash
export BLACKPOOL_KEY=0xyour_agent_private_key
blackpool login   # detects env var, skips the prompt, stores nothing to disk
```

特工们把钥匙从他们自己的 秘密经理/金库里拉入 `BLACKPOOL_KEY`。CLI直接读取,不将其写入磁盘.

### 注销

```bash
blackpool logout   # removes ~/.blackpool/wallet.json + config.json
```

**密钥解析顺序 :** `BLACKPOOL_KEY` (原始内容存档于2018-10-21) (中文(简体) ). env var `~/.blackpool/wallet.json` ——错误.

## 图标

```bash
blackpool balance                            # private + public balances (both pools), Base
blackpool balance --chain robinhood          # balances on Robinhood (ETH + USDG)
blackpool balance --chain arbitrum           # balances on Arbitrum (ETH + USDC)
blackpool balance --chain bsc                # balances on BSC (BNB + USDC + USDT)
blackpool balance --pool eth                 # just private ETH
blackpool deposit 25 --pool usdc             # shield 25 USDC from public to private (Base)
blackpool deposit 15 --pool usdg --chain robinhood  # shield 15 USDG on Robinhood
blackpool deposit 0.05 --pool bnb --chain bsc       # shield BNB (BSC native pool is 'bnb', not 'eth')
blackpool send 0xRECIPIENT 2.5               # send 2.5 USDC privately (no gas from you)
blackpool send 0xRECIPIENT 0.01 --pool eth   # send private ETH
blackpool send 0xRECIPIENT 2.5 --chain robinhood    # send 2.5 USDG privately on Robinhood
blackpool send 0xRECIPIENT max --pool usdt --chain bsc  # send the whole private USDT balance
blackpool send 0xRECIPIENT max --chain all   # empty every private pool on every chain into one address
blackpool swap 0.001 --from eth              # private same-chain swap ETH -> USDC (Uniswap V3)
blackpool swap 3 --from usdc                 # private same-chain swap USDC -> ETH
blackpool swap max --from eth --chain arbitrum      # swap as much private ETH as one swap can move
blackpool bridge arb_usdc 0xRECIPIENT 2.5    # bridge cross-chain privately to Arbitrum (1Click)
blackpool bridge bsc_usdt 0xRECIPIENT 5 --from bsc_usdc  # 1Click origin can be any shielded pool
blackpool bridge base_eth 0xRECIPIENT max --from hood_eth  # bridge as much as one bridge can move
blackpool assets                             # list all supported bridge destinations
blackpool recover                            # sweep any stranded funds from one-time burners
blackpool recover --to 0xADDR                # sweep to a different destination
```

## 如何运作

每个命令都遵循模式 [一般事务人员(其他职等)](https://blackpool.cash/AGENTS.md) 文档.

**登录/ 余额/ 发送/ 桥** - 签名一次; CLI 扫描您的笔记, 并在本地构建 Groth16 验证( 20 MB 验证密钥被下载一次到 `~/.blackpool/zk/`),然后中继器播放. 你没有付汽油。 中继器通过协议费(平价+每取出0.35%/互换/桥)得到补偿.

**交存** - 公共钱包标志和广播屏蔽tx(这是你支付汽油的唯一步骤,因为游泳池必须看到来自公共地址的资金)。 ERC-20集合(USDC),a `approve` 首先运行;CLI在播报押金前先对链上津贴进行投票(与负载平衡RPC滞后的前端相同).

**同链交换** - 镜像前端燃烧器完全流出:

1.  在任何资金转移前,在回收登记簿上创建新的随机燃烧器钱包,并用您的签名加密其密钥.
2.  私人从你的游泳池取出 – 燃烧器通过 `/api/swap-private`。 。 。 .
3.  关于USDC来源:中继器在燃烧器气体上通过 `/api/burner-gas`。 。 。 .
4.  Burner在Uniswap V3(Swap Router02,0.01%收费级)上批准+互换.
5.  如果ETH是目的地,则WETH被解封为ETH.
6.  飞行前 `eth_call` 模拟后盾(渔获物返回便宜).
7.  焚化器将已互换的输出恢复到 **** 通过 `/api/deposit/prepare`。 。 。 .

如果在(2)和(7)之间有任何步骤失败,资金仍留在燃烧器上;其钥匙在登记簿上,加密后只有您的签名才能读取. 运行 `blackpool recover` 把他们从任何设备上扫出.

**跨链桥** - 私人撤回到 NEAR Intents 1 Click 解决器通过 `/api/swap`然后进行民意测验 `/api/intent-status` 直至 `SUCCESS` (或 `REFUNDED`,在这种情况下,解答者自动返回您的资金。 桥梁没有燃烧器.

**回收** - 取回所有注册在您的钱包上的燃烧器, 解密本地的密钥, 并将被搁置的资金扫回您的公共钱包( 或) `--to <addr>`) (中文(简体) ). 处理钱包 `swap` 如果后一步复出,可能已经留下。 使用 Base- realistic gas params (0.05 gwei),因此燃烧器的微小的ETH上加法足以进行扫荡tx.

## 环境

-   `BLACKPOOL_KEY` - 私人密钥(0x-hex)。 如果你已经运行了可选择 `blackpool login`。 。 。 .
-   `BLACKPOOL_API` - API 基础 URL( 默认) `https://api.blackpool.cash`) (中文(简体) ).
-   `BLACKPOOL_RPC` 编号 : `BLACKPOOL_BASE_RPC` - 基础 RPC 终点( 默认) `https://mainnet.base.org`) (中文(简体) ). 设定为您自己的 Alchemy / QuickNode URL, 以更快 + 更可靠的气体在燃烧器- 重置交换流量上估计 .
-   `BLACKPOOL_ROBINHOOD_RPC` - Robinhood 链 RPC 端点( 默认) `https://rpc.mainnet.chain.robinhood.com`),当 `--chain robinhood`。 。 。 .

## 配置文件

-   `~/.blackpool/wallet.json` - 存储的私人密钥(chmod 600,只有使用 `blackpool login` (互动).
-   `~/.blackpool/config.json` - 每一个钱包的缓存 BLACKPOOL 签名(chmod 600).
-   `~/.blackpool/zk/` - 公开证明关键文件,与公布的SHA-256核对.

## 验证为 Base 主网

此 CLI 中的每个命令都被执行到端对端 `api.blackpool.cash` 实际的链上交易:

-   `deposit` → `0x7ae2dde7…` (3个USDC屏蔽)
-   `send` → `0x2108ae58…` (1.49125美元)
-   `swap` → `0x1bd8d68d…` (0.001 ETH − 1.170797 USDC 私人,全回屏)
-   `bridge` → `0xdfc495fa…` (2.5 USDC Base − 1.484306 USDC交付Arbitrum)
-   `recover` ^ 1.9895 USDC 从被搁浅的燃烧器上冲回

## 跨链目的地

运行 `blackpool assets` 完整现场名单 目前: **基地、伊特鲁姆、BSC、Arbitrium** - ETH / WETH / USDC / USDT / cbBTC / ARB / BNB 取决于链条.

## 路线图

-   `@blackpool/sdk` - SDK类型,用于一种剂的内部程序.
-   授权限制 - 人签名的每个窗口支出上限(与"被监管的代理"模式相匹配).
-   休息时可选钱包加密 - 密码句保护 `wallet.json`。 。 。 .

## 支助

文档 : [文件.blackpool.现金/代理人](https://docs.blackpool.cash/agents) 网站: [黑池 现金](https://blackpool.cash/)

## 探员

运行任何命令 `--json` (或 `BLACKPOOL_JSON=1`)在 Stdout 上获取一个 JSON 对象,并在 stderr 上取得进展;退出代码为 `0` 好,你别这样, `1` 失败, `2` 用途. [`AGENTS.md`](https://npmcn.com/package/%40blackpool/cli/AGENTS.md) (亦见 [https://blackpool.cash/AGENTS.md (英语)](https://blackpool.cash/AGENTS.md)记录每个命令的字段、最小值、重试规则和安全说明.

## MCP 磁共振

`blackpool mcp` 在 stdio 上运行一个 Model Control 协议服务器,因此代理应用程序可以将 Blackpool 称为工具 :

```json
{ "mcpServers": { "blackpool": { "command": "npx", "args": ["-y", "@blackpool/cli@latest", "mcp"], "env": { "BLACKPOOL_KEY": "0x..." } } } }
```

`BLACKPOOL_MCP_TOOLS=balance,send` 限制工具, `BLACKPOOL_MCP_READONLY=1` 暴露只读的。 主机只读服务器(状态、费用、资产、报价、分析、指南)运行于 `https://mcp.blackpool.cash/mcp`细节 : [AGENTS.md 第9节](https://npmcn.com/package/%40blackpool/cli/AGENTS.md)。 。 。 .

## 常见问题

### @blackpool/cli 是什么？

私人支付链上代理。 BLACKPOOL的CLI - 屏蔽,发送,互换,桥由Base,Robinhood Chain,Arbitrum和BNB Smart chain提供零知识隐私\.

### 如何安装 @blackpool/cli？

在项目目录运行 npm install @blackpool/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 blackpool，可以用 npx blackpool 直接运行。

### @blackpool/cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/blackpool\_\_cli 是否存在。

### @blackpool/cli 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @blackpool/cli 可以商用吗？

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

### @blackpool/cli 的下载量有多少？

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

### @blackpool/cli 还在维护吗？

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