Add GatewaySwap connector support for swap executor

- Create GatewaySwap connector for router-type connectors (e.g., jupiter/router)
- Update executor_service to ensure swap connector is loaded before execution
- Add database access documentation for debugging executors

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: fengtality

services/executor_service.py

@@ -354,14 +354,19 @@ async def create_executor(
         trading_pair = executor_config.get("trading_pair")
 
         if executor_type == "swap_executor":
-            # SwapExecutor uses network, not connector_name
+            # SwapExecutor requires connector_name (e.g., "jupiter/router") and network
+            swap_connector_name = executor_config.get("connector_name")
             network = executor_config.get("network")
+            if not swap_connector_name:
+                raise HTTPException(status_code=400, detail="connector_name is required for swap_executor")
             if not network:
                 raise HTTPException(status_code=400, detail="network is required for swap_executor")
             if not trading_pair:
                 raise HTTPException(status_code=400, detail="trading_pair is required in executor_config")
-            # Use network as connector_name for metadata tracking
-            connector_name = network
+            # Ensure the swap connector is loaded
+            await trading_interface.ensure_connector(swap_connector_name)
+            # Use connector_name for metadata tracking
+            connector_name = swap_connector_name
         elif executor_type == "lp_executor":
             # LPExecutor: trading_pair is optional (resolved from pool_address)
             if not connector_name:

services/unified_connector_service.py

@@ -23,6 +23,7 @@
 from hummingbot.connector.connector_metrics_collector import TradeVolumeMetricCollector
 from hummingbot.connector.exchange_py_base import ExchangePyBase
 from hummingbot.connector.gateway.gateway_lp import GatewayLp
+from hummingbot.connector.gateway.gateway_swap import GatewaySwap
 from hummingbot.connector.perpetual_derivative_py_base import PerpetualDerivativePyBase
 from hummingbot.core.data_type.common import OrderType, PositionAction, PositionMode, TradeType
 from hummingbot.core.data_type.in_flight_order import InFlightOrder, OrderState
@@ -643,17 +644,25 @@ def _create_trading_connector(
             secrets_manager=self.secrets_manager
         )
 
-        # Gateway connectors (e.g., 'meteora/clmm', 'raydium/clmm') are not in AllConnectorSettings
-        # They use GatewayLp which auto-detects chain/network from gateway config
+        # Gateway connectors (e.g., 'meteora/clmm', 'jupiter/router') are not in AllConnectorSettings
+        # Router connectors use GatewaySwap, LP connectors use GatewayLp
+        # Both auto-detect chain/network from gateway config
         if '/' in connector_name:
-            logger.info(f"Creating gateway connector: {connector_name}")
-            # GatewayLp handles chain/network auto-detection and default wallet lookup
-            # via start_network() call
-            return GatewayLp(
-                connector_name=connector_name,
-                trading_pairs=[],
-                trading_required=True,
-            )
+            _, connector_type = connector_name.split('/', 1)
+            if connector_type == 'router':
+                logger.info(f"Creating gateway swap connector: {connector_name}")
+                return GatewaySwap(
+                    connector_name=connector_name,
+                    trading_pairs=[],
+                    trading_required=True,
+                )
+            else:
+                logger.info(f"Creating gateway LP connector: {connector_name}")
+                return GatewayLp(
+                    connector_name=connector_name,
+                    trading_pairs=[],
+                    trading_required=True,
+                )
 
         conn_setting = self._conn_settings[connector_name]
         keys = BackendAPISecurity.api_keys(connector_name)