概述

什么是网关？¶

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

网关是基于 Python 的 Hummingbot 客户端的配套服务，为 DEX 上的交易和流动性相关功能暴露标准化的 REST API 端点，使 Hummingbot 能够无缝运行同时覆盖中心化交易所（CEX）和去中心化交易所的策略。

本节内容¶

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

核心功能¶

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

连接器模式¶

路由器：DEX 聚合器，可在多个流动性来源中寻找最优兑换路径，通过在多个池和协议间拆分交易来最大化执行质量
AMM（自动化做市商）：采用 x*y=k 公式的传统 V2 类型恒定乘积池，流动性在整个价格范围内均匀分布，结构简单但资本效率较低
CLMM（集中流动性做市商）：V3 类型池，允许流动性提供者将资本集中于自定义价格区间，显著提升资本效率，并为交易者提供更优定价

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

安装¶

网关可与 Hummingbot 一同安装，以支持在 AMM DEX 上交易，也可作为独立的 API 服务器运行。详细安装说明请参阅安装与设置。

在 DEV 模式下运行网关时，可通过以下地址访问交互式 Swagger API 文档：http://localhost:15888/docs

架构¶

网关采用模块化架构，关注点清晰分离：

/src
├── chains/               # Blockchain-specific implementations
│   └── {chain}/         # Each blockchain (ethereum, solana, etc.)
├── connectors/           # DEX-specific implementations
│   ├── {dex}/           # Each DEX connector directory
│   │   ├── router-routes/   # DEX aggregator operations
│   │   ├── amm-routes/      # AMM pool operations
│   │   └── clmm-routes/     # Concentrated liquidity operations
├── services/             # Core services (config, logging, tokens)
├── schemas/              # API request/response schemas
├── templates/            # Base classes and interfaces for connectors
├── tokens/               # Token lists and metadata
├── pools/                # Liquidity pool configurations
└── wallet/               # Wallet management

治理与维护¶

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

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

每个季度，交易所连接器投票会将 HBOT 悬赏分配给顶级 CEX 连接器，并决定哪些交易所连接器应继续保留在代码库中。该流程同时也会确定 Gateway 所支持的区块链和网络。

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

贡献¶

Gateway 是开源 Hummingbot 项目的一部分。参与方式包括：

构建新连接器：参见 DEX 连接器获取实现指南
提交问题：在 GitHub 问题中报告漏洞
提交拉取请求：在 GitHub 上贡献代码
编辑文档：在 GitHub 上改进文档
参与投票：参与投票，决定支持哪些 DEX

历史¶

有关 Gateway 的历史与架构决策的更多信息，请参阅：