Hummingbot 网关¶

什么是网关？¶

Hummingbot 网关是一个基于 TypeScript 的 API 服务器，它标准化了与区块链网络和去中心化交易所（DEX）的交互。它充当中间件层，提供统一的接口来执行诸如检查余额、执行交易和管理钱包等操作，支持不同的协议。

网关是 Python 基于的 Hummingbot 客户端 的配套服务，它公开了标准化的 REST API 端点，用于在 DEX 上进行交易和流动性相关的功能。这使得 Hummingbot 能够无缝运行同时跨越中心化（CEX）和去中心化交易所的策略。

本章节内容¶

• 安装与设置：完整的源码和 Docker 安装指南
• 配置：如何配置链、连接器和设置
• 命令：所有与网关相关 Hummingbot 命令的完整参考
• 链：支持的链的详细信息
• DEX 连接器：网关中所有支持的 DEX 指南
• 策略与脚本：在 Hummingbot 策略中使用网关

主要功能¶

• 标准化 REST API：用于与区块链（以太坊、Solana）和 DEX 交互的一致端点
• DEX SDK 集成：与 TypeScript/JavaScript DEX SDK 接口，为不同协议提供标准化端点
• 连接器子类型：路由器（DEX 聚合器）、AMM（V2 风格池）和 CLMM（V3 风格集中流动性）
• 模块化架构：在链、连接器、配置和钱包管理之间有清晰的职责分离
• 硬件钱包支持：内置硬件钱包支持和常规钱包的加密存储
• 可扩展性：可轻松扩展以支持新的链和连接器

支持的链和网络¶

支持的 DEX¶

连接器模式¶

• 路由器：DEX 聚合器，通过多个流动性来源寻找最佳的交换路径，通过将交易拆分到多个池和协议中，最大化执行质量
• AMM（自动做市商）：传统的 V2 风格常数乘积池，使用 x*y=k 公式，流动性均匀分布在整个价格范围内，使其更简单但资本效率较低
• CLMM（集中流动性市场制造者）：V3 风格池，允许流动性提供者在自定义价格范围内集中其资本，显著提高资本效率，让交易者获得更好的定价

有关每种模式的详细实现指南和示例，请参见 DEX 连接器。

安装¶

网关可以与 Hummingbot 一起安装，以启用在 AMM DEX 上进行交易，或者作为独立的 API 服务器运行。详细的安装说明请参见 安装与设置。

当以 DEV 模式运行网关时，访问交互式 Swagger API 文档： http://localhost:15888/docs

架构¶

网关遵循模块化架构，职责分离明确：

/src
├── chains/               # 区块链特定实现
│   └── {chain}/         # 每个区块链（ethereum, solana 等）
├── connectors/           # DEX 特定实现
│   ├── {dex}/           # 每个 DEX 连接器目录
│   │   ├── router-routes/   # DEX 聚合器操作
│   │   ├── amm-routes/      # AMM 池操作
│   │   └── clmm-routes/     # 集中流动性操作
├── services/             # 核心服务（配置、日志、代币）
├── schemas/              # API 请求/响应模式
├── templates/            # 连接器的基类和接口
├── tokens/               # 代币列表和元数据
├── pools/                # 流动性池配置
└── wallet/               # 钱包管理

治理与维护¶

与其他连接器一样，网关 DEX 连接器需要持续维护：修复错误，解决用户问题，并跟上交易所/区块链 API 以及 Hummingbot 连接器标准的改进。

Hummingbot 基金会维护某些参考连接器作为标准，并使用社区维护流程。我们将 悬赏 分配给社区开发者，以升级和修复代码库中每个交易所连接器的错误。

每个季度，交易所连接器投票 将 HBOT 悬赏分配给顶级 CEX 连接器，并确定哪些交易所连接器应包含在代码库中。此过程还决定了网关支持的区块链和网络。

请参阅 HBOT 跟踪器 中的 连接器池 标签，了解当前每个交易所的分配情况。

贡献¶

网关是开源 Hummingbot 项目的一部分。贡献方式：

• 构建新连接器：参见 DEX 连接器 了解实现指南
• 提交问题：在 GitHub Issues 报告错误
• 提交拉取请求：在 GitHub 贡献代码
• 编辑文档：在 GitHub 改进文档
• 参与投票：参与 投票 投票决定哪些 DEX 将被支持

历史¶

有关网关历史和架构决策的更多信息，请参见：

• Hummingbot 网关 V2 架构 - 第一部分
• Hummingbot 网关 V2 架构 - 第二部分