Monero原子互换CLI完整教程：BTC与XMR兑换操作全指南

原子互换（Atomic Swap）技术代表了加密货币领域去信任化交换的最高境界。它允许两种不同区块链上的加密货币在完全无需任何中间方介入的情况下进行直接交换，整个过程由密码学协议保证安全——交换要么完全成功，要么完全取消，绝不存在一方已付款而另一方未收到资产的情况。

对于门罗币（Monero/XMR）和比特币（Bitcoin/BTC）之间的互换而言，这项技术具有革命性意义。传统的中心化交易所要求用户通过KYC/AML认证，留下详细的交易记录，这与门罗币保护用户金融隐私的核心理念背道而驰。BTC-XMR原子互换彻底改变了这一状况，让任何人都能在不暴露身份的前提下完成两种主流加密货币之间的互换。

本教程将从零开始，手把手教你通过命令行界面（CLI）完成一次完整的BTC和XMR原子互换。内容涵盖技术原理、环境配置、实际操作步骤、安全注意事项以及常见问题解决方案，是目前最全面的中文BTC-XMR原子互换操作指南。

一、原子互换的核心技术原理

在深入操作步骤之前，理解原子互换的基本工作原理对于正确使用这项技术至关重要。特别是BTC-XMR原子互换，由于门罗币的技术特殊性，其实现方式与传统原子互换有显著不同。

1.1 哈希时间锁合约（HTLC）的局限

传统的原子互换依赖哈希时间锁合约（Hash Time-Locked Contracts，HTLC），这种方案在支持智能合约的区块链（如以太坊）或具备完整脚本语言的区块链（如比特币）上运作良好。基本流程是：

• Alice生成一个秘密值S，并计算其哈希H(S)
• Alice在比特币上创建一个合约：凭秘密值S可以取走资金，超时后Alice可退款
• Bob在另一条链上创建类似合约：凭同一秘密值S可取走资金
• Alice披露S，触发双方合约的执行

然而，门罗币不支持原生的智能合约或HTLC机制，因此无法直接应用这种方案。

1.2 适配器签名（Adaptor Signatures）方案

2020年，研究人员Joël Gugger在其论文中提出了基于适配器签名的BTC-XMR互换方案，解决了这一技术难题。该方案的核心思想：

适配器签名是一种特殊的数字签名，它将"某个承诺"（即秘密值的知识）与签名本身绑定在一起。具体而言：

• 签名者可以在不披露秘密值x的情况下，创建一个"预签名"
• 任何拥有x的人都可以将这个预签名转化为完整的有效签名
• 从完整签名中，可以提取出秘密值x

这个特性使得我们可以在门罗币链上实现类似HTLC的行为，而无需门罗币支持任何脚本功能。

1.3 完整的BTC-XMR互换流程

以Alice（BTC持有者，想换XMR）和Bob（XMR做市商，想换BTC）为例，完整流程如下：

协商阶段：

1. 双方通过加密通道（通常是Tor）建立连接
2. 交换公钥和互换参数（金额、汇率、超时时间）
3. Alice和Bob共同生成一个门罗币私钥（分布式密钥生成），双方各持一部分

锁定阶段：

1. Bob将约定数量的XMR锁定到一个双方合控的门罗币地址（Alice和Bob各持该地址私钥的一半）
2. Alice确认XMR已锁定后，将约定数量的BTC锁定到一个比特币脚本地址（该地址包含基于适配器签名的解锁条件）

执行阶段：

1. Alice学习Bob的适配器签名秘密，从而获得门罗币私钥的完整控制权
2. Alice扫描（sweep）门罗币到自己的钱包
3. Bob从Alice的扫描交易中提取秘密值，从而取走比特币

安全保证：整个过程通过超时机制保护双方——如果任何一方在规定时间内不行动，对方可以取回自己的资金。

二、环境准备与软件安装

完成BTC-XMR原子互换需要安装特定的软件环境。本节将详细介绍每个步骤。

2.1 系统要求

在开始之前，确认你的系统满足以下最低要求：

• 操作系统：Linux（Ubuntu 20.04 LTS或更高版本推荐）或macOS 11+；Windows需要通过WSL2
• 处理器：现代多核CPU，64位架构
• 内存：最少8GB RAM，推荐16GB或以上
• 存储空间：至少50GB可用空间（如果使用远程节点则不需要太多本地存储）
• 网络：稳定的宽带连接；强烈建议配置Tor以保护隐私

2.2 安装Rust编程环境

XMR-BTC swap工具使用Rust语言开发。如果你还没有Rust工具链，按以下步骤安装：

# 安装Rust（通用方法）
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 按照提示选择默认安装选项（按1继续）
# 安装完成后，配置当前shell的PATH
source $HOME/.cargo/env

# 更新到最新稳定版本
rustup update stable

# 验证安装成功
rustc --version
cargo --version

你应该看到类似 rustc 1.75.0 (82e1608df 2023-12-21) 的输出。

2.3 安装系统依赖

根据你的操作系统安装必要的依赖项：

Ubuntu/Debian系统：

sudo apt update && sudo apt upgrade -y
sudo apt install -y 
  build-essential 
  pkg-config 
  libssl-dev 
  libsqlite3-dev 
  tor 
  curl 
  git

Fedora/CentOS/RHEL系统：

sudo dnf install -y 
  gcc 
  gcc-c++ 
  make 
  openssl-devel 
  sqlite-devel 
  tor 
  curl 
  git

macOS（使用Homebrew）：

# 首先安装Homebrew（如果还没有）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装依赖
brew install openssl sqlite tor git

# 设置OpenSSL环境变量（Apple Silicon Mac可能需要）
export OPENSSL_DIR=$(brew --prefix openssl)
export PKG_CONFIG_PATH="$(brew --prefix openssl)/lib/pkgconfig"

2.4 配置Tor服务

强烈建议通过Tor网络进行原子互换，以保护你的IP地址不被泄露：

# 启动Tor服务
sudo systemctl start tor  # Linux
# 或
brew services start tor  # macOS

# 验证Tor正在运行
sudo systemctl status tor

# 确认Tor的SOCKS5端口（默认9050）正在监听
ss -tlnp | grep 9050

2.5 下载并编译swap工具

从官方GitHub仓库获取最新版本的swap工具：

# 克隆仓库
git clone https://github.com/comit-network/xmr-btc-swap.git
cd xmr-btc-swap

# 查看可用版本
git tag -l | sort -V | tail -10

# 切换到最新稳定版本（替换vX.X.X为最新版本号）
git checkout vX.X.X

# 编译（这可能需要10-30分钟）
cargo build --release

# 验证编译成功
./target/release/swap --version
./target/release/asb --version

编译成功后，主要的可执行文件有两个：

• swap：Alice角色使用，用BTC购买XMR
• asb（Automated Swap Backend）：Bob角色使用，即做市商程序

为了方便使用，建议将这两个文件复制到系统PATH中：

sudo cp target/release/swap /usr/local/bin/
sudo cp target/release/asb /usr/local/bin/

三、钱包准备

3.1 创建门罗币钱包（接收XMR用）

如果你还没有门罗币钱包，需要创建一个：

# 下载门罗币官方CLI（从getmonero.org获取最新版本链接）
wget https://downloads.getmonero.org/cli/linux64 -O monero-cli.tar.bz2
tar -xjf monero-cli.tar.bz2
cd monero-x86_64-linux-gnu-*/

# 创建新钱包
./monero-wallet-cli --generate-new-wallet ~/monero-wallet/my-wallet

# 输入密码并保存种子词（非常重要！）

钱包创建后，你会看到一串25个英文单词的种子短语，这是恢复钱包的唯一方法，务必在离线状态下妥善保存。

记下你的主地址（以4开头的95个字符串），你在原子互换时需要提供这个地址。

3.2 比特币钱包准备

进行BTC→XMR互换（Alice角色）时，你需要：

• 一个持有足够BTC余额的钱包
• 一个用于接收BTC找零的地址
• 钱包软件（推荐使用Electrum或Bitcoin Core）

注意：出于隐私考虑，建议使用与你真实身份没有关联的比特币地址。如果你的比特币来自KYC交易所，建议先通过CoinJoin混币再进行互换。

四、执行BTC→XMR互换（Alice角色详细操作）

4.1 启动Tor并验证连接

# 确认Tor正在运行
curl --socks5-hostname localhost:9050 https://check.torproject.org/api/ip

# 成功响应示例：{"IsTor":true,"IP":"185.xxx.xxx.xxx"}

4.2 查找可用的做市商

# 通过Tor网络搜索正在运行的做市商节点
swap --testnet list-sellers 
  --rendezvous-point /dnsaddr/rendezvous.coblox.tech 
  --tor-socks5-port 9050

# 或在主网上查找（实盘交易）
swap list-sellers 
  --rendezvous-point /dnsaddr/rendezvous.coblox.tech 
  --tor-socks5-port 9050

输出示例：

[2024-01-15T10:30:00Z] Connecting to rendezvous point...
[2024-01-15T10:30:02Z] Found peer: 12D3KooWAbCdEfGh...
  Multiaddr: /onion3/exampleonionaddress:8888/p2p/12D3KooW...
  Status: Online
  Price: 0.00654 BTC/XMR (≈ 152.9 XMR/BTC)
  Min. BTC: 0.001
  Max. BTC: 0.10

记下你想使用的做市商的完整多重地址（multiaddr）。

4.3 获取互换报价

# 在实际发送资金之前，可以先获取报价
swap buy-xmr 
  --receive-address 你的XMR钱包地址 
  --change-address 你的BTC找零地址 
  --seller /onion3/做市商地址:端口/p2p/做市商PeerID 
  --tor-socks5-port 9050 
  --dry-run  # 仅获取报价，不实际执行

4.4 执行实际互换

# 执行互换（去掉 --dry-run 选项）
swap buy-xmr 
  --receive-address 4AbCdEfGhIjKlMnOpQrStUvWxYz... 
  --change-address bc1q例子地址 
  --seller /onion3/做市商地址.onion:8888/p2p/12D3KooW... 
  --tor-socks5-port 9050

程序启动后会显示互换详情，请仔细确认：

============ Swap Details ============
You will send:    0.01 BTC
You will receive: ~1.528 XMR
Exchange rate:    0.00654 BTC/XMR
Network fees:     ~0.0002 BTC

Send 0.01 BTC to: bc1q临时地址...
Time limit:       30 minutes

Press Enter to confirm or Ctrl+C to cancel...

确认后，程序会生成一个临时的比特币地址，你需要在30分钟内向该地址发送指定金额的BTC。

4.5 发送比特币

使用你的比特币钱包向显示的地址发送指定金额。注意：

• 发送的金额必须精确匹配（不能多也不能少）
• 必须在30分钟时间窗口内完成发送
• 比特币交易需要确认，建议设置足够高的矿工费以确保快速确认

4.6 等待完成

发送比特币后，swap程序会自动监控流程：

[状态更新]
✓ 比特币交易已广播 (txid: abc123...)
⏳ 等待比特币确认 (0/2)...
✓ 比特币已确认 (2/2)
⏳ 做市商正在发送XMR...
✓ XMR交易已广播
⏳ 等待XMR确认 (0/10)...
✓ 互换完成！收到 1.528 XMR

整个过程通常需要40-90分钟，主要取决于比特币和门罗币的确认时间。

五、中断与恢复机制

网络不稳定或意外情况导致互换中断时，swap工具提供了完善的恢复机制：

5.1 查看历史互换

# 显示所有互换记录及当前状态
swap history

# 查看特定互换的详细信息
swap history --swap-id [互换ID]

5.2 恢复中断的互换

# 恢复特定互换
swap resume 
  --swap-id [互换ID] 
  --seller /onion3/做市商地址:端口/p2p/PeerID 
  --tor-socks5-port 9050

5.3 取消和退款

如果互换超时或需要取消，可以触发退款机制：

# 取消互换（需要在比特币退款超时后执行）
swap cancel --swap-id [互换ID]

# 退款操作
swap refund --swap-id [互换ID]

退款机制有时间锁保护，确保即使做市商下线，用户也能取回自己的比特币。典型的退款等待时间为12-24小时。

六、安全最佳实践

6.1 操作系统安全

• 使用专用设备：建议使用专门用于加密货币操作的设备，与日常使用的设备分离
• 全盘加密：确保设备的磁盘已加密（Linux使用LUKS，macOS使用FileVault）
• 及时更新：保持操作系统和所有软件的最新版本
• 防病毒检查：在运行原子互换前，确保系统没有恶意软件

6.2 网络安全

• 全程使用Tor：这是最重要的隐私保护措施，防止你的真实IP地址被做市商或网络观察者获取
• 避免公共WiFi：即使使用Tor，公共网络也可能存在额外风险
• VPN的局限性：VPN不能替代Tor，因为VPN提供商知道你的真实IP

6.3 钱包安全

• 种子词离线保存：将门罗币和比特币的种子词写在纸上，存放在安全的物理位置
• 小额测试：第一次使用原子互换时，用最小金额进行测试
• 不共享私钥：永远不要将私钥或种子词分享给任何人，包括所谓的"技术支持"

6.4 资金管理

• 分散风险：不要将全部资金集中在一次互换中
• 了解手续费：确认你有足够的比特币余额支付网络手续费
• 汇率风险：浮动汇率下，从开始到完成期间价格可能变化

七、做市商节点运营指南

如果你持有大量门罗币并希望为社区提供互换服务，可以运行自己的做市商节点（ASB，Automated Swap Backend）：

7.1 配置ASB

# 首次运行会引导你完成配置
asb --testnet start

# 或使用配置文件
asb start --config /path/to/config.toml

典型的配置文件结构：

[maker]
min_buy_btc = 0.001
max_buy_btc = 0.25
# 价差比例（1.5%意味着你的报价比市价高1.5%）
ask_spread = 0.015

[bitcoin]
electrum_rpc_url = "ssl://electrum.server.com:50002"
target_block = 3

[monero]
monero_daemon_url = "http://127.0.0.1:18081"
monero_wallet_rpc_url = "http://127.0.0.1:18083"

[tor]
register_hidden_service = true
socks5_port = 9050

7.2 资金要求和运营考量

• 初始XMR储备：建议至少准备相当于max_buy_btc × 2倍汇率的XMR储备
• 再平衡策略：随着互换进行，你需要定期将积累的BTC换回XMR以维持做市能力
• 监控和报警：设置系统监控，确保ASB服务持续运行

八、原子互换与其他兑换方式的综合比较

理解原子互换在更广泛兑换方式中的位置，有助于你选择最适合的工具：

与中心化交易所对比

中心化交易所提供最佳的速度（通常几秒内完成）和流动性，但代价是完全放弃隐私——你必须通过KYC认证，每笔交易都被记录和监控。对于大多数门罗币用户来说，这正是他们想避免的。

与即时兑换服务对比

ChangeNow、SimpleSwap等即时兑换服务无需注册，但需要信任第三方平台，且通常收取1-2%的手续费。这些服务在技术上保留了追踪用户的可能性。

与原子互换对比

原子互换是三者中隐私性最强的，无需信任任何第三方，但操作复杂度最高，完成时间最长（40-90分钟），且需要技术知识。

九、前沿发展与未来展望

BTC-XMR原子互换技术仍在快速发展中，以下是值得关注的未来方向：

性能优化

研究人员正在优化互换协议，目标是：

• 减少所需的链上交易次数
• 利用闪电网络加速比特币端的处理
• 改进门罗币扫描性能

用户界面改善

命令行工具正在被图形界面所补充：

• 基于Web的前端已有多个开源实现
• 移动端应用正在开发中
• 与现有门罗币钱包的集成计划

闪电网络集成

通过将比特币端与闪电网络结合，理论上可以实现：

• 近实时的小额BTC-XMR互换
• 更低的比特币端手续费
• 更好的用户体验

十、总结

BTC-XMR原子互换代表了去中心化金融的前沿实践，它将比特币的广泛流动性与门罗币卓越的隐私保护完美结合，创造了一种真正无需信任、保护隐私的跨链价值交换方式。

虽然当前的技术门槛较高，操作流程较为复杂，但对于真正重视金融隐私的用户来说，这是目前获取门罗币的最佳方式之一。随着工具的持续改进和用户界面的优化，未来这一过程将会变得越来越简单。

如果你在操作过程中遇到问题，可以参考以下资源：

• 官方GitHub仓库的Issues和Discussions
• 门罗币社区Reddit (r/Monero)
• 门罗币官方Matrix聊天室 (#monero:monero.social)
• COMIT网络的官方文档

记住，金融隐私不是犯罪工具，而是每个人应有的基本权利。通过学习和使用原子互换技术，你正在为构建一个更私密、更自由的金融系统做出贡献。

十一、常见疑问与深度解答

Q1：原子互换与混币（CoinJoin）有什么区别？

混币（CoinJoin）是一种比特币隐私技术，通过将多人的交易合并在一起来混淆来源，但最终仍然是比特币。原子互换则是真正的跨链资产交换——你发出BTC，收回的是完全不同的区块链上的XMR。从隐私角度看，BTC→XMR原子互换之后，你持有的资产已经从比特币的透明账本切换到了门罗币的隐私账本，过去的交易历史被彻底切断。这是一种本质上更强的隐私保护。

Q2：原子互换需要双方同时在线吗？

不完全是。XMR-BTC swap工具的设计中，一旦Alice确认并发送了比特币，后续的步骤在很大程度上是自动化的。然而，为了安全起见，建议整个互换过程中保持程序运行，以便及时响应任何异常情况。做市商（Bob）的程序通常全天候运行，不需要人工干预。

Q3：如果做市商在互换中途失联怎么办？

这正是原子互换安全机制的核心价值所在。整个互换流程中内置了时间锁保护：如果做市商在规定时间（通常12-24小时）内没有完成操作，你的比特币会自动退还到你的找零地址。你可能会损失比特币网络手续费，但不会损失本金。这是"无需信任"承诺的技术实现。

Q4：我能用原子互换将XMR换回BTC吗？

目前，大多数公开的做市商是单向提供BTC→XMR的服务（即他们用XMR换BTC）。如果你想进行XMR→BTC，你需要：a) 寻找专门提供该方向的服务；b) 自己运行ASB（做市商节点），等待需要XMR的用户与你互换；c) 使用其他的非KYC即时兑换服务。

Q5：原子互换的汇率是否公平？

做市商通常会在市场价格的基础上加入一定的价差（spread），通常为1%-3%。这是他们承担流动性风险的回报。与中心化交易所（0.1%-0.5%手续费）相比较贵，但与其他无KYC即时兑换服务（1%-2%）相比具有竞争力，且隐私保护程度远高于任何中心化服务。

Q6：交易失败后，资金会不会消失？

不会。原子互换的"原子性"保证资金不会在中间状态下消失。失败的交易会触发超时退款机制，最终所有参与方都会收回自己的资金。唯一可能损失的是链上手续费（通常非常少量的BTC）。

十二、隐私保护的完整路径：原子互换之后

完成BTC→XMR原子互换后，你已经获得了门罗币的协议级隐私保护。但要最大化这种保护，还需要注意以下后续步骤：

12.1 等待足够长时间再使用XMR

刚收到的XMR输出年龄较新，如果立即花费，可能在统计上更容易被识别为"真实输出"（因为环中的诱骗输出大多是较旧的）。建议至少等待7天后再使用刚收到的XMR。

12.2 使用子地址分离不同用途的资金

如果你通过多次原子互换积累了XMR，为不同批次创建独立的子地址，避免在同一笔交易中混合使用不同来源的资金。

12.3 从源头提升BTC的隐私

即使你成功将BTC换成了XMR，如果原始BTC可以追溯到你的身份（如直接来自KYC交易所），监管机构仍然知道你曾经持有那些比特币。如果隐私需求很高，可以考虑先通过CoinJoin混币，再进行原子互换，进一步切断链接。

十三、版本兼容性说明与软件维护

XMR-BTC swap工具的版本更新较为频繁，不同版本之间可能不兼容。在进行互换时，请注意以下版本相关事项：

• 始终使用最新稳定版：定期检查GitHub仓库，及时升级到最新版本。旧版本可能存在安全漏洞或与当前网络的做市商不兼容。
• 检查做市商版本：在连接做市商之前，确认对方运行的版本与你的版本兼容。通常同一大版本号的工具是相互兼容的。
• 数据库升级注意：软件升级后有时需要迁移本地数据库（存储互换状态）。在升级前建议备份数据库文件（通常位于 ~/.local/share/xmr-btc-swap/）。
• 主网vs测试网：确保你使用的是正确的网络。测试网的资产没有价值，但用于练习和测试是理想的。生产环境的互换始终在主网进行。

如果遇到版本兼容性问题，可以在GitHub Issues页面搜索类似问题的解决方案，或在门罗币社区的技术频道寻求帮助。定期关注xmr-btc-swap的发布公告，了解最新变化和重要的安全更新。