xmr-btc-swap入门教程：从安装到完成首次原子交换的完整步骤

【免费下载链接】xmr-btc-swapBitcoin–Monero Cross-chain Atomic Swap项目地址: https://gitcode.com/gh_mirrors/xm/xmr-btc-swap

xmr-btc-swap是一个实现比特币（Bitcoin）和门罗币（Monero）跨链原子交换的工具，让用户无需通过中心化交易所即可安全地完成两种加密货币的直接兑换。本教程将带你从环境准备到完成首次原子交换的全过程，即使是新手也能轻松掌握！

📋 准备工作：环境与依赖安装

在开始原子交换前，需要确保你的系统满足以下要求：

1. 安装基础依赖

• Rust环境：xmr-btc-swap基于Rust开发，需安装Rust工具链
• Tor服务：用于匿名通信，可通过系统包管理器安装（如Debian/Ubuntu使用apt install tor）
• Bitcoin节点：推荐运行本地Electrum服务器或使用公共Electrum RPC
• Monero节点：可选择本地节点或指定远程节点地址

2. 获取项目源码

通过Git克隆官方仓库：

git clone https://gitcode.com/gh_mirrors/xm/xmr-btc-swap cd xmr-btc-swap

3. 编译项目

使用Cargo编译可执行文件：

cargo build --release

编译完成后，可执行文件将位于target/release/swap路径下。

⚙️ 配置与初始化

1. 命令行基础使用

xmr-btc-swap提供直观的命令行界面，基础语法为：

# 查看帮助 ./target/release/swap --help # 测试网模式（推荐新手先使用测试网） ./target/release/swap --testnet <子命令>

2. 钱包配置

首次使用需配置比特币和门罗币钱包：

导入比特币主私钥

在工具中导入你的比特币钱包BIP32主私钥，确保拥有足够的测试网BTC用于交换：

图：在xmr-btc-swap中输入比特币主私钥（BIP32）的界面

配置钱包参数

根据需求调整脚本策略和派生路径，推荐使用默认的Native SegWit（P2WPKH）格式：

图：xmr-btc-swap的钱包设置界面，显示策略类型和派生路径配置

🔍 发现交易对手

1. 列出可用卖家

使用list-sellers命令通过 rendezvous 点发现网络中的卖家：

./target/release/swap --testnet list-sellers \ --rendezvous-point /dns4/discover.unstoppableswap.net/tcp/8888/p2p/12D3KooWA6cnqJpVnreBVnoro8midDL9Lpzmg8oJPoAGi7YYaamE

命令将返回类似以下结果：

+----------------+----------------+----------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ | PRICE | MIN_QUANTITY | MAX_QUANTITY | STATUS | ADDRESS | +====================================================================================================================================================================================================+ | 0.00665754 BTC | 0.00010000 BTC | 0.00100000 BTC | Online | /dns4/ac4hgzmsmekwekjbdl77brufqqbylddugzze4tel6qsnlympgmr46iid.onion/tcp/8765/p2p/12D3KooWPZ69DRp4wbGB3wJsxxsg1XW1EVZ2evtVwcARCF3a1nrx | +----------------+----------------+----------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+

2. 选择合适的卖家

根据价格、交易限额和在线状态选择合适的卖家，记录其完整地址（包含/p2p/部分）。

🚀 执行原子交换

1. 发起交换命令

使用buy-xmr命令开始BTC到XMR的交换，需要指定以下核心参数：

./target/release/swap --testnet buy-xmr \ --seller <卖家地址> \ --receive-address <你的门罗币地址> \ --change-address <你的比特币找零地址>

2. 交换过程监控

交换过程中，工具会自动处理区块链确认和智能合约交互。你可以在交易界面查看实时状态：

图：xmr-btc-swap的交易记录界面，显示余额和交易历史

3. 完成交换

当所有步骤完成后，你将在指定的门罗币地址收到交换的XMR。可通过门罗币区块链浏览器验证交易。

⚠️ 常见问题与故障排除

1. 连接问题

• 确保Tor服务正常运行（默认端口9050）
• 检查防火墙设置，允许工具访问网络

2. 交易卡住

• 使用swap resume命令恢复中断的交换
• 确认比特币和门罗币节点同步完成

3. 退款操作

如遇问题需要取消交换，可使用：

# 取消交换（专家用户） ./target/release/swap --testnet cancel --swap-id <交换ID> # 退款操作 ./target/release/swap --testnet refund --swap-id <交换ID>

📚 进阶资源

• 官方文档：docs/
• 自动化脚本示例：docs/cli/discover_and_take.sh
• 配置选项：使用swap buy-xmr --help查看所有可用参数

通过本教程，你已掌握使用xmr-btc-swap进行原子交换的基本流程。记得在主网操作前，先在测试网充分练习，熟悉各项功能！

【免费下载链接】xmr-btc-swapBitcoin–Monero Cross-chain Atomic Swap项目地址: https://gitcode.com/gh_mirrors/xm/xmr-btc-swap