TornadoCash CLI 命令行工具使用指南

这是一个关于如何使用命令行界面(CLI)工具与Tornado Cash经典版交互的指南,适用于前端应用程序无法访问或因RPC受限而无法正常工作的情况。本文档面向技术知识较少的用户。

Windows 用户的简要指南

步骤一:下载 CLI 工具

访问 Tornado CLI代码仓库页面,下载最新版本的程序。
在页面中找到最新发布版本并下载,如下图高亮部分所示:

打开下载的压缩包文件所在位置,解压压缩包。

步骤二: 准备工作环境

在tornado-cli文件夹中打开命令行窗口(cmd),然后就可以在命令行窗口输入tornado-cli.exe --help来查看可用的命令和参数:
打开CLI命令行窗口

步骤三: CLI的使用

从现在开始,你可以按照git代码仓库的说明,在上一步的窗口中进行存款取款操作。
Tornado CLI Git

快速存款与取款指南:

存款

首先,准备你的钱包私钥。你可以从助记词中获取私钥参考此处;或者查看如何从MetaMask复制私钥的指南

在cmd终端中粘贴以下命令进行存款:tornado-cli.exe deposit <currency> <amount> <chain id> --private-key <private key>
当然,你需要将<>中的所有参数值替换为真实的值,例如:

tornado-cli.exe deposit BNB 0.1 56 --private-key 0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff

您可以在网站chainlist.org 上找到您的网络的链ID。对于以太坊主网,链ID为1,对于币安智能链(BSC),链ID为56。

当程序要求确认存款交易时,您应该通过在控制台中输入Yyes来确认。cmd界面会将创建的存款凭证打印在控制台,将其复制并保存在安全的地方。确保存款成功 - 您可以使用 tornado-cli. exe compliance命令检查你的存款凭证状态。
向Tornado Cash存款

注意:示例中我将私钥保存在.env文件中以避免泄露。建议你在命令中通过--private-key参数直接提供私钥。

取款

准备好您的存款凭证和收款地址。

在 CLI 目录中打开Powershell或cmd终端(您已经知道如何操作)并运行以下命令:tornado-cli.exe withdraw <your note> <your address>

例如:tornado-cli.exe withdraw tornado-eth-0.1-5-0xf73dd6833ccbcc046c44228c8e2aa312bf49e08389dadc7c65e6a73239867b7ef49c705c4db227e2fadd8489a494b6880bdcb6016047e019d1abec1c7652 0x8589427373D6D84E98730D7795D8f6f8731FDA16

如果链上没有活跃的中继器或您想使用私钥取款,请首先确保:

  1. 私钥是您收款钱包的私钥
  2. 您的钱包中有足够余额用于支付取款交易的gas

当获取完成存款事件数据并生成SNARK取款证明时,您将看到确认提示:

如果对gas和中继器手续费满意,输入Y并按“回车”。

交易发送后,命令行界面会显示区块链浏览器中的交易链接:
图片说明:通过 CLI 取款结果(1609×316 15.6 KB)

注意事项

如果您不喜欢config.js中的默认RPC,您可以在chainlist.org上找到RPC链接,或者检查README中的推荐RPC链接
如果您不喜欢自动选择的中继器,您可以使用命令tornado-cli.exe listRelayers <chain_id>检查可用的中继器列表,然后在取款命令中指定中继器。

验证可执行文件(适合审计员和细心用户)

如何确保tornado-cli.exe文件仅包含 CLI 源代码而无恶意添加?方法很简单:
该 .exe 文件使用pkg npm包构建,支持生成确定性可执行文件(类似 IPFS,相同源代码和命令生成的文件完全一致且哈希相同)。

createDeterministicExecutable.js脚本中可查看生成过程,甚至可以自行重建。
使用verifyExecutable.js脚本验证当前代码仓库版本的 .exe 文件与从源代码新构建的文件哈希是否一致。

在如Windows 10上创建文件夹(例如 cli-verification),在其中打开cmd,使用命令git clone https://git.tornado.ws/tornadocash/tornado-cli克隆CLI git代码库,使用npm i安装依赖项并运行验证:npm run verifyExe

高级指南:从源代码运行

如果你熟悉git和cmd命令行操作,可按以下步骤从源代码运行CLI,请单击此处
  1. 安装 git(如果尚未安装)
  2. 安装最新的 nvm 此处
  3. 以管理员身份打开 cmd
  4. git clone https://git.tornado.ws/tornadocash/tornado-cli
  5. nvm install 14.21.3
  6. 安装 node-gyp 依赖项 [可选]
  7. npm install

根据 文档 使用。

步骤一:安装NVM

NVM(Node Version Manager)是一个开源工具,便于安装和管理Node.js版本。

Windows

访问nvm-windows代码仓库发布页面,下载最新版本。

解压下载的.zip文件,双击其中的.exe文件开始安装。


安装完成后,在任务栏搜索 “PowerShell”,右键选择“以管理员身份运行”。

输入

nvm

若显示版本和帮助页面,安装成功。

Linux

打开“终端”,运行以下任一命令:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash

OR

wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash

安装完成后,输入nvm -v,若显示版本号,安装成功。

步骤二: 安装NodeJS

CLI 工具需使用 Node.js 14 或更低版本。
运行以下命令:

nvm install 14.21.3
nvm use 14.21.3

测试node和npm是否安装成功:

node -v

应返回版本号v14.21.3

设置node版本

若显示类似“node 未识别命令”,请“以管理员身份运行”重新打开终端。

步骤三: 下载CLI工具

访问Tornado CLI代码仓库页面,下载最新版本。

解压文件,确保以管理员身份打开“终端”或“PowerShell”。

输入以下命令进入CLI文件夹: cd <path-to-cli>
<path-to-cli>替换为实际文件平目录路径,可从文件资源管理器复制。
GIF示例:
更改目录到CLI文件夹

最后一步是安装软件包。

npm install

若提示权限错误,Windows系统以管理员身份重开PowerShell,Linux则在命令前加sudo。忽略警告或漏洞提示,这是正常现象。

如果npm安装失败(真的实在安装不了,才非得这么做)

下载node-gyp编译器及其依赖项

在打开的Powershell或终端窗口上运行:npm i -g node-gyp

Windows
官方网站 安装最新的Python(只需单击下载按钮即可)。

安装最新的 Visual Studio Build Tools:打开 此链接,下载将自动开始。上传名为 vs_BuildTools.exe 的文件后,只需运行它并按照相应窗口中的说明进行操作,选择 `.

步骤四:使用CLI工具

按照官方仓库说明,在同一窗口中进行存款取款操作。
Tornado CLI Git

1 Like