跳转至内容

🪙 在 Hummingbot 中使用 XRP Ledger

cover

📘 您将学到的内容

本分步指南将向您展示如何：

  1. 创建 XRPL 钱包（两种方法：初学者和开发者）。

  2. 将该钱包导入 Xaman（原 XUMM）。

  3. 将您的 XRPL 钱包链接到 Hummingbot，然后检查您的余额。

  4. 调整 XRPL 连接器文件（添加私有节点或自定义市场）。

  5. 在 XRPL DEX 上运行简单 PMM 策略。

无需之前的编码经验——命令都是即拷即用的。

🧾 创建 XRPL 钱包

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

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

使用水龙头网站生成钱包

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

从下拉列表中选择 Testnet 并点击 Generate Testnet Credentials。

Faucet Screenshot

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

⚠️ 请保持这两个值的私密性。 任何拥有这些信息的人都可以控制您的资金。 密钥 也称为 Seed，相当于您的私钥并提供对钱包的完全访问权限。


通过脚本生成钱包

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

运行以下命令：

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

脚本完成后，您将看到类似的输出：

Script Output

将所有四行复制到安全的位置（密码管理器、加密笔记等）。这包括您的钱包地址和 seed，后者充当您的私钥且不应共享。

遇到问题了吗？

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


安装 Xaman（手机钱包）

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

如果您需要有关如何安装的附加信息，请按照 此处 的指南操作：

将您的 XRPL 账户导入 Xaman

在 Xaman 的主屏幕上，按 设置 按钮，选择 账户，然后按 添加账户

import

按下 导入现有账户 按钮

import

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

  • 完全访问 - 如果您想能够与您的 XRPL 账户进行交互，请选择此选项。例如，如果您想创建信任线或将 XRP 发送到另一个账户。

  • 只读访问 - 如果您只想跟踪 XRPL 账户的活动，请选择此选项。此选项不允许您在账户上签名交易。

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

import

选择 Family Seed 然后按下一步。

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

import

输入您的家族种子，然后按"下一步"。

import

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

import

确定安全级别后，选择它并按"下一步"，然后输入账户标签并按"下一步"完成导入过程。

将您的钱包添加到 Hummingbot

  • 启动 Hummingbot。
  • 运行 connect xrpl。

提供：

  • 钱包密钥（以 s 开头的种子）。

  • XRPL 节点 URL—使用默认值或您自己的私有节点。

connect

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

符号 余额 RLUSD 23.4359 XRP 138.2416

修改 XRPL 配置文件

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

Conf Screenshot

此文件包含您的加密 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 脚本创建配置。

controller

这将在 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 您想要交易的交易所。
trading_pair XRP-RLUSD 您正在交易的代币对，采用基础-报价格式。
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

初始化可能需要几秒钟。请查看 日志窗格 以确认订单是否正在下达，或排查任何错误消息。

status

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