🪙 使用 Hummingbot 操作 XRP 分类账¶

cover

📘 您将学到的内容¶

本分步指南将教你如何：

创建 XRPL 钱包（两种方法：新手和开发者）。
将该钱包导入 Xaman（原 XUMM）。
将你的 XRPL 钱包链接到 Hummingbot，然后检查余额。
调整 XRPL 连接器文件（添加私有节点或自定义市场）。
在 XRPL DEX 上运行一个简单的 PMM 策略。

无需先前的编程经验——所有命令均可复制粘贴。

🧾 创建一个 XRPL 钱包¶

有两种方式可以生成您的 XRP 钱包凭证：

✅ 适合初学者：使用 XRPL 测试网水龙头
🛠️ 适合开发者：通过终端运行自动化钱包脚本

使用水龙头网站生成钱包¶

访问官方 XRPL 测试网水龙头：https://xrpl.org/xrp-testnet-faucet.html

从下拉菜单中选择 Testnet，然后点击 生成测试网凭证。

将 钱包地址 和密钥复制并保存到安全的地方。

⚠️ 请保密这两个值。 任何人只要拥有它们就可以控制您的资金。密钥也被称为 种子（Seed），相当于您的私钥，可完全访问您的钱包。

通过脚本生成钱包¶

打开您的终端（Linux、macOS 或 Windows 上的 WSL）。

运行以下命令：

curl -s https://gist.githubusercontent.com/david-hummingbot/a040f9af46b5d627f9437f04a04fc4ec/raw/1aab1f428b834eafcdc06a1c88d6dbd47afbf551/create_xrp_wallet.sh | bash

脚本完成后，您会看到类似以下的输出：

将全部四行内容复制并保存到安全位置（如密码管理器、加密笔记等）。其中包括您的钱包地址和种子（seed），该种子即为您的私钥，切勿分享给他人。

遇到问题？

该脚本会尝试自动安装其依赖项（Node.js、npm）。如果失败或您不确定操作，请改用水龙头方式。

安装 Xaman（移动钱包）¶

从以下链接下载并安装 Xaman 应用程序（原名 XUMM）：

如果需要有关如何安装的更多信息，请参考此指南此处：

将您的 XRPL 账户导入 Xaman¶

在 Xaman 主界面，点击设置按钮，选择账户，然后点击 添加账户

点击“导入现有账户”按钮

您可以通过以下两种模式之一导入 XRP Ledger 账户：

完全访问权限 - 如果您希望与您的 XRPL 账户进行交互（例如创建信任线或向其他账户发送 XRP），请选择此选项。
只读访问权限 - 如果您仅希望跟踪某个 XRPL 账户的活动，请选择此选项。此选项不允许您对账户交易进行签名。

目前请选择 完全访问权限，然后点击下一步按钮。

选择 家族种子，然后点击下一步。

🔐 家族种子 与您的钱包种子或私钥相同。它是一个以字母 s 开头的 29 个字符长的字符串。例如：s4rj7hy5vdth65f4fy89hg4ffh77hg。请安全保存且切勿分享。

输入您的家族种子，然后点击下一步。

请确保显示的 r 地址是您想要导入的地址。如果不正确，请点击返回按钮，仔细检查并重新输入您的家族种子。当显示正确的 r 地址后，点击确认按钮。

确定安全级别后，选择该级别并点击下一步，然后输入账户标签，再点击下一步完成导入过程。

将您的钱包添加到 Hummingbot¶

启动 Hummingbot。
运行 connect xrpl 命令。

提供以下信息：

钱包密钥（以 s 开头的种子）。
XRPL 节点 URL(s) —— 可使用默认值或您自己的私有节点。

之后运行 balance 命令。如果您的密钥正确且节点在线，您应该能看到您的 XRPL 余额：

Symbol Balance
    RLUSD  23.4359
    XRP    138.2416

修改 XRPL 配置文件¶

使用任意 IDE 或文本编辑器打开新创建的 /conf/connectors/xrpl.yml 文件

该文件包含您加密的 XRPL 凭据，以及其他针对 XRPL 连接器的配置设置：

custom_markets:
  XRP-RLUSD:
    base: XRP
    quote: RLUSD
    base_issuer: ""
    quote_issuer: "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq"
  XRP-iBTC:
    base: XRP
    quote: iBTC
    base_issuer: ""
    quote_issuer: "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59"

设置您的 XRPL 节点¶

Hummingbot 默认使用的 XRPL 节点为 wss://s1.ripple.com/

这是一个公共节点，可能容易受到速率限制，因此我们建议使用私有节点服务提供商。

常见的节点服务提供商包括：

有关公共节点列表，请参阅：https://xrpl.org/public-servers.html

运行 Simple PMM 策略¶

要求：

您的 XRPL 连接器已连接并已充值。
您已创建了一个 Simple PMM 配置文件。

创建配置¶

启动 Hummingbot，并使用 create --script-config simple_pmm 命令为您的 Simple PMM 脚本创建配置。

这将在 conf/controllers/ 文件夹下生成一个默认配置文件。您可以使用您喜欢的 IDE 或文本编辑器编辑此文件。

初始默认配置将与下面的不同——您可以使用以下值进行更新：

script_file_name: simple_pmm.py
exchange: xrpl
trading_pair: XRP-RLUSD
order_amount: 15
bid_spread: 0.001
ask_spread: 0.001
order_refresh_time: 120
price_type: mid

以下是配置字段的说明：

字段	数值	描述
`exchange`	`xrpl`	您希望交易的交易所。
`交易对`	`XRP-RLUSD`	您正在交易的交易对，采用 base-quote 格式。
`order_amount`	`15`	每个买入/卖出订单的基础代币（XRP）数量。
`bid_spread`	`0.001`（0.1%）	低于参考价格的百分比，用于放置您的买入订单。
`ask_spread`	`0.001`（0.1%）	高于参考价格的百分比，用于放置您的卖出订单。
`order_refresh_time`	`120`	在取消并替换现有订单前的时间（以秒为单位）。
`price_type`	`mid`	用于计算出价/要价的价格参考，通常为最佳买价和卖价之间的中点。

您在此处的操作是配置一个做市策略，即您将：

在中间市场价格下方 0.1% 处放置一个买入订单，以及
在中间市场价格上方 0.1% 处放置一个卖出订单。

这些订单每 120 秒刷新一次，以保持与市场的同步。

要查看链上的未结订单，您可以使用以下浏览器：

如果您需要更多帮助来了解 Hummingbot 的工作原理，或希望深入探索 Hummingbot，可以访问以下文档链接：

启动机器人¶

start --script simple_pmm.py --conf conf_simple_pmm_test-xrp-rlusd.yml

初始化可能需要几秒钟。请查看日志窗格，确认订单是否已成功下单，或排查任何错误信息。

祝您交易愉快！如果遇到问题，Hummingbot Discord 社区是提问的好地方。