feat(mcp_common): add environment.resolve_environment with TDD

2026-04-27 17:39:52 +02:00
parent 888a3cde84
commit 37e5024acc
2 changed files with 147 additions and 0 deletions
@@ -0,0 +1,59 @@
+"""Resolver di ambiente (testnet/mainnet) per MCP exchange.
+
+Precedenza: env var > campo secret > default True (testnet).
+"""
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+from typing import Literal
+
+Environment = Literal["testnet", "mainnet"]
+Source = Literal["env", "credentials", "default"]
+
+TRUTHY = {"1", "true", "yes", "on"}
+
+
+@dataclass(frozen=True)
+class EnvironmentInfo:
+    exchange: str
+    environment: Environment
+    source: Source
+    env_value: str | None
+    base_url: str
+
+
+def resolve_environment(
+    creds: dict,
+    *,
+    env_var: str,
+    flag_key: str,
+    exchange: str,
+) -> EnvironmentInfo:
+    """Risolvi l'ambiente per un MCP exchange.
+
+    creds: dict letto dal secret JSON. Deve contenere base_url_live e base_url_testnet.
+    env_var: nome della env var di override (es. DERIBIT_TESTNET).
+    flag_key: chiave booleana nel secret JSON (es. "testnet" o "paper" per alpaca).
+    exchange: nome exchange per logging/info.
+    """
+    env_value = os.environ.get(env_var)
+    if env_value is not None:
+        is_test = env_value.strip().lower() in TRUTHY
+        environment: Environment = "testnet" if is_test else "mainnet"
+        source: Source = "env"
+    elif flag_key in creds:
+        environment = "testnet" if bool(creds[flag_key]) else "mainnet"
+        source = "credentials"
+    else:
+        environment = "testnet"
+        source = "default"
+
+    base_url = creds["base_url_testnet"] if environment == "testnet" else creds["base_url_live"]
+    return EnvironmentInfo(
+        exchange=exchange,
+        environment=environment,
+        source=source,
+        env_value=env_value,
+        base_url=base_url,
+    )