skills update; USER ACCOUNT system! Alpha!

packages/tracker/meshnet_tracker/billing.py

@@ -20,6 +20,7 @@ import uuid
 
 DEFAULT_PRICE_PER_1K_TOKENS = 0.02  # USDT
 DEFAULT_STARTING_CREDIT = 1.0  # USDT of Caller Credit for a new API key
+DEFAULT_BILLING_DB_PATH = "billing.sqlite"
 NODE_REVENUE_SHARE = 0.90  # nodes 90% / protocol cut 10% (ADR-0015)
 
 
@@ -364,6 +365,34 @@ class BillingLedger:
         with self._lock:
             return self._node_pending.get(wallet, 0.0)
 
+    def usage_for(self, api_keys: list[str], *, recent_limit: int = 20) -> dict:
+        """Aggregate charge history for a set of API keys (dashboard view)."""
+        keys = set(api_keys)
+        requests = 0
+        total_tokens = 0
+        total_cost = 0.0
+        recent: list[dict] = []
+        with self._lock:
+            for event in self._event_log:
+                if event.get("type") != "charge" or event.get("api_key") not in keys:
+                    continue
+                requests += 1
+                total_tokens += int(event.get("total_tokens", 0))
+                total_cost += float(event.get("cost", 0.0))
+                recent.append({
+                    "api_key": event["api_key"],
+                    "model": event.get("model"),
+                    "total_tokens": event.get("total_tokens", 0),
+                    "cost": event.get("cost", 0.0),
+                    "ts": event.get("ts", 0.0),
+                })
+        return {
+            "requests": requests,
+            "total_tokens": total_tokens,
+            "total_cost": total_cost,
+            "recent": recent[-recent_limit:],
+        }
+
     def snapshot(self) -> dict:
         with self._lock:
             return {