@blackpool/ cli (英语)
私人支付链上代理。 一个env var 或一个隐藏的提示, 然后屏蔽 / 发送 / 互换 / 桥的零知识隐私 基础, (中文(简体) ), 罗宾链, (中文(简体) ), 坐标,以及 BNB 智能链. 证据是建在您的机器上, 和网络应用一样; 完整的代理指南是 一般事务人员(其他职等)。 。 。 .
每个命令都有一个选项 --chain base|robinhood|arbitrum|bsc 旗帜( 默认) base) (中文(简体) ). 在Base和Arbitrum上,马来币是USDC;在Robinhood上,马来币是USDG;在BSC上,马来币是USDC和USDT(Binance-Peg,18个小数),本地资产是BNB.
安装
npm i -g @blackpool/cli
# or
npx @blackpool/cli help
设置
两种方式提供你的钥匙,取决于谁运行它.
交互式( 人/ 本地演示) - 密钥从未显示
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) - 无快捷键
export BLACKPOOL_KEY=0xyour_agent_private_key
blackpool login # detects env var, skips the prompt, stores nothing to disk
特工们把钥匙从他们自己的 秘密经理/金库里拉入 BLACKPOOL_KEY。CLI直接读取,不将其写入磁盘.
注销
blackpool logout # removes ~/.blackpool/wallet.json + config.json
密钥解析顺序 : BLACKPOOL_KEY (原始内容存档于2018-10-21) (中文(简体) ). env var ~/.blackpool/wallet.json ——错误.
图标
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
如何运作
每个命令都遵循模式 一般事务人员(其他职等) 文档.
登录/ 余额/ 发送/ 桥 - 签名一次; CLI 扫描您的笔记, 并在本地构建 Groth16 验证( 20 MB 验证密钥被下载一次到 ~/.blackpool/zk/),然后中继器播放. 你没有付汽油。 中继器通过协议费(平价+每取出0.35%/互换/桥)得到补偿.
交存 - 公共钱包标志和广播屏蔽tx(这是你支付汽油的唯一步骤,因为游泳池必须看到来自公共地址的资金)。 ERC-20集合(USDC),a approve 首先运行;CLI在播报押金前先对链上津贴进行投票(与负载平衡RPC滞后的前端相同).
同链交换 - 镜像前端燃烧器完全流出:
- 在任何资金转移前,在回收登记簿上创建新的随机燃烧器钱包,并用您的签名加密其密钥.
- 私人从你的游泳池取出 – 燃烧器通过
/api/swap-private。 。 。 . - 关于USDC来源:中继器在燃烧器气体上通过
/api/burner-gas。 。 。 . - Burner在Uniswap V3(Swap Router02,0.01%收费级)上批准+互换.
- 如果ETH是目的地,则WETH被解封为ETH.
- 飞行前
eth_call模拟后盾(渔获物返回便宜). - 焚化器将已互换的输出恢复到 通过
/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.现金/代理人 网站: 黑池 现金
探员
运行任何命令 --json (或 BLACKPOOL_JSON=1)在 Stdout 上获取一个 JSON 对象,并在 stderr 上取得进展;退出代码为 0 好,你别这样, 1 失败, 2 用途. AGENTS.md (亦见 https://blackpool.cash/AGENTS.md (英语)记录每个命令的字段、最小值、重试规则和安全说明.
MCP 磁共振
blackpool mcp 在 stdio 上运行一个 Model Control 协议服务器,因此代理应用程序可以将 Blackpool 称为工具 :
{ "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节。 。 。 .