xache 5.0.0__py3-none-any.whl → 5.1.0__py3-none-any.whl

xache/services/facilitator.py

@@ -1,5 +1,7 @@
 """
 Facilitator Service - x402 v2 facilitator selection and management
+
+Fetches facilitator configuration from the API for network-agnostic operation.
 """
 
 from typing import List, Optional, Dict, Any, Literal
@@ -19,19 +21,20 @@ class FacilitatorConfig:
     id: str
     name: str
     chains: List[ChainType]
-    networks: List[NetworkId]
+    networks: List[str]
     schemes: List[PaymentScheme]
     priority: int
     healthy: bool = True
     avg_latency_ms: Optional[int] = None
     last_health_check: Optional[int] = None
+    pay_to: Optional[Dict[str, Dict[str, str]]] = None
 
 
 @dataclass
 class FacilitatorPreferences:
     """User preferences for facilitator selection"""
     preferred_facilitators: List[str] = field(default_factory=list)
-    avoid_networks: List[NetworkId] = field(default_factory=list)
+    avoid_networks: List[str] = field(default_factory=list)
     max_latency_ms: Optional[int] = None
     preferred_chain: Optional[ChainType] = None
 
@@ -49,13 +52,15 @@ class FacilitatorService:
     Facilitator service for x402 v2 payment facilitator selection
 
     Manages facilitator preferences and selection for payment processing.
-    Uses a hardcoded registry of available facilitators.
+    Fetches configuration from the API for network-agnostic operation.
     """
 
     def __init__(self, client):
         self.client = client
         self._preferences = FacilitatorPreferences()
         self._cached_facilitators: List[FacilitatorConfig] = []
+        self._cached_environment: str = 'testnet'
+        self._cached_default_network: str = 'base-sepolia'
         self._last_fetch_time: int = 0
         self._cache_duration_ms = 300000  # 5 minutes
 
@@ -96,10 +101,20 @@ class FacilitatorService:
         """Clear facilitator preferences"""
         self._preferences = FacilitatorPreferences()
 
-    def get_default_facilitator(self) -> FacilitatorConfig:
+    async def get_environment(self) -> str:
+        """Get the current environment (testnet or mainnet)"""
+        await self.list()  # Ensure cache is populated
+        return self._cached_environment
+
+    async def get_default_network(self) -> str:
+        """Get the default network for the current environment"""
+        await self.list()  # Ensure cache is populated
+        return self._cached_default_network
+
+    def _get_default_facilitator(self) -> FacilitatorConfig:
         """
-        Get the default CDP facilitator configuration
-        This is the built-in facilitator for Coinbase Developer Platform
+        Get the default CDP facilitator configuration (fallback)
+        This is used only if API is unavailable
         """
         return FacilitatorConfig(
             id='cdp',
@@ -114,10 +129,10 @@ class FacilitatorService:
     async def list(self, force_refresh: bool = False) -> List[FacilitatorConfig]:
         """
         List all available facilitators
-        Returns the default CDP facilitator. Cached for performance.
+        Fetches from API and caches for performance.
 
         Args:
-            force_refresh: Force refresh (ignored - using hardcoded registry)
+            force_refresh: Force refresh from API
 
         Returns:
             List of facilitator configurations
@@ -140,10 +155,39 @@ class FacilitatorService:
         ):
             return self._cached_facilitators
 
-        # Return default facilitator (CDP)
-        # In future, this could fetch from a /v1/facilitators endpoint
-        self._cached_facilitators = [self.get_default_facilitator()]
-        self._last_fetch_time = now
+        try:
+            # Fetch from API
+            response = await self.client._request('GET', '/v1/facilitators')
+            data = response.data
+
+            if data and 'facilitators' in data:
+                self._cached_facilitators = [
+                    FacilitatorConfig(
+                        id=f['id'],
+                        name=f['name'],
+                        chains=f['chains'],
+                        networks=f['networks'],
+                        schemes=f['schemes'],
+                        priority=f['priority'],
+                        healthy=f.get('healthy', True),
+                        avg_latency_ms=f.get('avgLatencyMs'),
+                        last_health_check=f.get('lastHealthCheck'),
+                        pay_to=f.get('payTo'),
+                    )
+                    for f in data['facilitators']
+                ]
+                self._cached_environment = data.get('environment', 'testnet')
+                self._cached_default_network = data.get('defaultNetwork', 'base-sepolia')
+                self._last_fetch_time = now
+                return self._cached_facilitators
+
+        except Exception as e:
+            print(f"[FacilitatorService] Failed to fetch facilitators from API, using fallback: {e}")
+
+        # Fallback to default if API fails
+        if not self._cached_facilitators:
+            self._cached_facilitators = [self._get_default_facilitator()]
+            self._last_fetch_time = now
 
         return self._cached_facilitators
 
@@ -172,7 +216,7 @@ class FacilitatorService:
     async def select(
         self,
         chain: ChainType,
-        network: Optional[NetworkId] = None,
+        network: Optional[str] = None,
         scheme: PaymentScheme = 'exact',
     ) -> Optional[FacilitatorSelection]:
         """
@@ -200,11 +244,18 @@ class FacilitatorService:
         """
         facilitators = await self.list()
 
+        # Default network based on environment
+        if network is None:
+            if chain == 'solana':
+                network = 'solana' if self._cached_environment == 'mainnet' else 'solana-devnet'
+            else:
+                network = self._cached_default_network
+
         # Filter by requirements
         candidates = [
             f for f in facilitators
             if chain in f.chains
-            and (network is None or network in f.networks)
+            and network in f.networks
             and scheme in f.schemes
             and f.healthy is not False
         ]
@@ -264,7 +315,7 @@ class FacilitatorService:
         self,
         facilitator_id: str,
         chain: ChainType,
-        network: NetworkId,
+        network: str,
         scheme: PaymentScheme = 'exact',
     ) -> bool:
         """

{xache-5.0.0.dist-info → xache-5.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xache
-Version: 5.0.0
+Version: 5.1.0
 Summary: Official Python SDK for Xache Protocol
 Home-page: https://github.com/xache-ai/xache-protocol
 Author: Xache Protocol

{xache-5.0.0.dist-info → xache-5.1.0.dist-info}/RECORD

@@ -11,7 +11,7 @@ xache/services/__init__.py,sha256=ERuZXa7R-Iv0oFBknxJiBO5nJC-oCtIut_4VITw_uOE,77
 xache/services/budget.py,sha256=6sZ3nojb888a3k774XPnJHfdkqIC2Y1BxJKt8zy76V0,10599
 xache/services/collective.py,sha256=utYLIHv3tuOYHbdYJYXqIy1hS-aYIRems744CsCUIUw,6229
 xache/services/extraction.py,sha256=5KElr4ldBR3kcOofvz4d3NwAuTvKVskZ-NTQ7BI2ChY,5317
-xache/services/facilitator.py,sha256=ikZNTqEkmcQixGSMJYGlspmbKfivMBFO3sg5Tzy7si8,9412
+xache/services/facilitator.py,sha256=FlJh6YvPd1xiCdt6Y8Y9NpbmJI0o92Dcp3ZgzeR14bM,11512
 xache/services/identity.py,sha256=gOs5fN9juyoBfXQVm-G4whyUMJ6Oha2VmP_i3mQw0G0,13478
 xache/services/memory.py,sha256=ng9_cwL4jE4c3gdlwQDZyqaBdQgwtqApEwj0LkZYWRY,13290
 xache/services/owner.py,sha256=2ASJFjApS3AiQEpoS2oM9M3sisi0Y6xSjmU1fwUM0rA,8912
@@ -24,7 +24,7 @@ xache/utils/__init__.py,sha256=8VrQm0QnyqxdplpCG7BDRiAVdBGWrjUs9ipH2zsJOBM,106
 xache/utils/cache.py,sha256=9zhE9dIXFTofj7jz1TX-FkAqmclqoYXTe4FwwGLeKT4,5479
 xache/utils/http.py,sha256=rIQCYvYrziNrNfEbOnIKbCOGGf7bcdTvZrrU_W6CcZA,6547
 xache/utils/retry.py,sha256=OJYBGozKIoteCvKw50dqd4ThhOo-WisorcKa8Tr6mnE,2860
-xache-5.0.0.dist-info/METADATA,sha256=Xk9jdBWRacl2aVkn89dGbdLr9xHNmi8FWbK-B2BHyQg,8469
-xache-5.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-xache-5.0.0.dist-info/top_level.txt,sha256=FBWE4IVb7zoLS9arsdrl97QVETlwFvYGAx6xEJZOEUU,6
-xache-5.0.0.dist-info/RECORD,,
+xache-5.1.0.dist-info/METADATA,sha256=Epfq9BxGeZ913xE5fWrvMoiBaJvesUQ-fVJEX5FcAdA,8469
+xache-5.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+xache-5.1.0.dist-info/top_level.txt,sha256=FBWE4IVb7zoLS9arsdrl97QVETlwFvYGAx6xEJZOEUU,6
+xache-5.1.0.dist-info/RECORD,,