uvd-x402-sdk 0.2.3__tar.gz → 0.3.0__tar.gz

{uvd_x402_sdk-0.2.3/src/uvd_x402_sdk.egg-info → uvd_x402_sdk-0.3.0}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.1
 Name: uvd-x402-sdk
-Version: 0.2.3
-Summary: Python SDK for integrating x402 payments via the Ultravioleta DAO facilitator
+Version: 0.3.0
+Summary: Python SDK for x402 payments - gasless crypto payments across 14 blockchains with multi-stablecoin support (USDC, EURC, AUSD, PYUSD, GHO, crvUSD)
 Author-email: Ultravioleta DAO <dev@ultravioletadao.xyz>
 Project-URL: Homepage, https://github.com/UltravioletaDAO/uvd-x402-sdk-python
 Project-URL: Documentation, https://docs.ultravioletadao.xyz/x402-sdk
 Project-URL: Repository, https://github.com/UltravioletaDAO/uvd-x402-sdk-python
 Project-URL: Issues, https://github.com/UltravioletaDAO/uvd-x402-sdk-python/issues
-Keywords: x402,payments,crypto,usdc,web3,evm,solana,near,stellar,facilitator
+Keywords: x402,payments,crypto,usdc,eurc,stablecoin,web3,evm,solana,near,stellar,facilitator,gasless,eip-712,eip-3009
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -51,17 +51,18 @@ Requires-Dist: httpx>=0.24.0; extra == "dev"
 
 Python SDK for integrating **x402 cryptocurrency payments** via the Ultravioleta DAO facilitator.
 
-Accept USDC payments across **14 blockchain networks** with a single integration. The SDK handles signature verification, on-chain settlement, and all the complexity of multi-chain payments.
+Accept **gasless stablecoin payments** across **14 blockchain networks** with a single integration. The SDK handles signature verification, on-chain settlement, and all the complexity of multi-chain payments.
 
 ## Features
 
 - **14 Networks**: EVM chains (Base, Ethereum, Polygon, etc.), SVM chains (Solana, Fogo), NEAR, and Stellar
+- **6 Stablecoins**: USDC, EURC, AUSD, PYUSD, GHO, crvUSD (EVM chains)
 - **x402 v1 & v2**: Full support for both protocol versions with auto-detection
 - **Framework Integrations**: Flask, FastAPI, Django, AWS Lambda
-- **Gasless Payments**: Users sign authorizations, facilitator pays all network fees
+- **Gasless Payments**: Users sign EIP-712/EIP-3009 authorizations, facilitator pays all network fees
 - **Simple API**: Decorators and middleware for quick integration
 - **Type Safety**: Full Pydantic models and type hints
-- **Extensible**: Register custom networks easily
+- **Extensible**: Register custom networks and tokens easily
 
 ## Quick Start (5 Lines)
 
@@ -93,6 +94,17 @@ print(f"Paid by {result.payer_address}, tx: {result.transaction_hash}")
 | NEAR | NEAR | - | `near:mainnet` | Active |
 | Stellar | Stellar | - | `stellar:pubnet` | Active |
 
+### Supported Tokens (EVM Chains)
+
+| Token | Networks | Decimals |
+|-------|----------|----------|
+| USDC | All EVM chains | 6 |
+| EURC | Ethereum, Base, Avalanche | 6 |
+| AUSD | Ethereum, Arbitrum, Avalanche, Polygon, Monad | 6 |
+| PYUSD | Ethereum | 6 |
+| GHO | Ethereum, Base, Arbitrum | 18 |
+| crvUSD | Ethereum, Arbitrum | 18 |
+
 ## Installation
 
 ```bash
@@ -610,6 +622,92 @@ config = X402Config(
 
 ---
 
+## Multi-Token Support
+
+The SDK supports 6 stablecoins on EVM chains. Use the token helper functions to query and work with different tokens.
+
+### Querying Token Support
+
+```python
+from uvd_x402_sdk import (
+    TokenType,
+    get_token_config,
+    get_supported_tokens,
+    is_token_supported,
+    get_networks_by_token,
+)
+
+# Check which tokens a network supports
+tokens = get_supported_tokens("ethereum")
+print(tokens)  # ['usdc', 'eurc', 'ausd', 'pyusd', 'gho', 'crvusd']
+
+tokens = get_supported_tokens("base")
+print(tokens)  # ['usdc', 'eurc', 'gho']
+
+# Check if a specific token is supported
+if is_token_supported("ethereum", "eurc"):
+    print("EURC is available on Ethereum!")
+
+# Get token configuration
+config = get_token_config("ethereum", "eurc")
+if config:
+    print(f"EURC address: {config.address}")
+    print(f"Decimals: {config.decimals}")
+    print(f"EIP-712 name: {config.name}")
+    print(f"EIP-712 version: {config.version}")
+
+# Find all networks that support a token
+networks = get_networks_by_token("gho")
+for network in networks:
+    print(f"GHO available on: {network.display_name}")
+# Output: GHO available on: Ethereum, Base, Arbitrum One
+```
+
+### Token Configuration
+
+Each token has specific EIP-712 domain parameters required for signing:
+
+```python
+from uvd_x402_sdk import TokenConfig, get_token_config
+
+# TokenConfig structure
+# - address: Contract address
+# - decimals: Token decimals (6 for most, 18 for GHO/crvUSD)
+# - name: EIP-712 domain name (e.g., "USD Coin", "EURC", "Gho Token")
+# - version: EIP-712 domain version
+
+# Example: Get EURC config on Base
+eurc = get_token_config("base", "eurc")
+# TokenConfig(
+#     address="0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42",
+#     decimals=6,
+#     name="EURC",
+#     version="2"
+# )
+
+# Example: Get GHO config on Ethereum (note: 18 decimals)
+gho = get_token_config("ethereum", "gho")
+# TokenConfig(
+#     address="0x40D16FC0246aD3160Ccc09B8D0D3A2cD28aE6C2f",
+#     decimals=18,
+#     name="Gho Token",
+#     version="1"
+# )
+```
+
+### Available Tokens
+
+| Token | Description | Decimals | Issuer |
+|-------|-------------|----------|--------|
+| `usdc` | USD Coin | 6 | Circle |
+| `eurc` | Euro Coin | 6 | Circle |
+| `ausd` | Agora USD | 6 | Agora Finance |
+| `pyusd` | PayPal USD | 6 | PayPal/Paxos |
+| `gho` | GHO Stablecoin | 18 | Aave |
+| `crvusd` | Curve USD | 18 | Curve Finance |
+
+---
+
 ## Error Handling
 
 ```python
@@ -655,7 +753,7 @@ except X402Error as e:
 
 ## How x402 Works
 
-The x402 protocol enables gasless USDC payments:
+The x402 protocol enables gasless stablecoin payments (USDC, EURC, AUSD, PYUSD, GHO, crvUSD):
 
 ```
 1. User Request     -->  Client sends request without payment
@@ -698,13 +796,14 @@ The facilitator (https://facilitator.ultravioletadao.xyz) handles all on-chain i
 ## Security
 
 - Users **NEVER** pay gas or submit transactions directly
-- **EVM**: Users sign EIP-712 structured messages only (no transaction broadcast)
+- **EVM**: Users sign EIP-712 structured messages for any supported stablecoin (USDC, EURC, AUSD, PYUSD, GHO, crvUSD)
 - **Solana/Fogo**: Users sign partial transactions (facilitator co-signs and submits)
 - **Stellar**: Users sign Soroban authorization entries only
 - **NEAR**: Users sign NEP-366 meta-transactions (DelegateAction)
 - The facilitator submits and pays for all on-chain transactions
 - All signatures include expiration timestamps (`validBefore`) for replay protection
 - Nonces prevent double-spending of authorizations
+- Each token has verified contract addresses and EIP-712 domain parameters
 
 ---
 
@@ -782,6 +881,20 @@ MIT License - see LICENSE file.
 
 ## Changelog
 
+### v0.3.0 (2025-12-20)
+
+- **Multi-Stablecoin Support**: Added support for 6 stablecoins on EVM chains
+  - USDC (all EVM chains)
+  - EURC (Ethereum, Base, Avalanche)
+  - AUSD (Ethereum, Arbitrum, Avalanche, Polygon, Monad)
+  - PYUSD (Ethereum)
+  - GHO (Ethereum, Base, Arbitrum)
+  - crvUSD (Ethereum, Arbitrum)
+- Added `TokenType` literal type and `TokenConfig` dataclass
+- Added token helper functions: `get_token_config()`, `get_supported_tokens()`, `is_token_supported()`, `get_networks_by_token()`
+- Added `tokens` field to `NetworkConfig` for multi-token configurations
+- Updated EVM network configurations with token contract addresses and EIP-712 domain parameters
+
 ### v0.2.2 (2025-12-16)
 
 - Added Security section to documentation

{uvd_x402_sdk-0.2.3 → uvd_x402_sdk-0.3.0}/README.md

@@ -2,17 +2,18 @@
 
 Python SDK for integrating **x402 cryptocurrency payments** via the Ultravioleta DAO facilitator.
 
-Accept USDC payments across **14 blockchain networks** with a single integration. The SDK handles signature verification, on-chain settlement, and all the complexity of multi-chain payments.
+Accept **gasless stablecoin payments** across **14 blockchain networks** with a single integration. The SDK handles signature verification, on-chain settlement, and all the complexity of multi-chain payments.
 
 ## Features
 
 - **14 Networks**: EVM chains (Base, Ethereum, Polygon, etc.), SVM chains (Solana, Fogo), NEAR, and Stellar
+- **6 Stablecoins**: USDC, EURC, AUSD, PYUSD, GHO, crvUSD (EVM chains)
 - **x402 v1 & v2**: Full support for both protocol versions with auto-detection
 - **Framework Integrations**: Flask, FastAPI, Django, AWS Lambda
-- **Gasless Payments**: Users sign authorizations, facilitator pays all network fees
+- **Gasless Payments**: Users sign EIP-712/EIP-3009 authorizations, facilitator pays all network fees
 - **Simple API**: Decorators and middleware for quick integration
 - **Type Safety**: Full Pydantic models and type hints
-- **Extensible**: Register custom networks easily
+- **Extensible**: Register custom networks and tokens easily
 
 ## Quick Start (5 Lines)
 
@@ -44,6 +45,17 @@ print(f"Paid by {result.payer_address}, tx: {result.transaction_hash}")
 | NEAR | NEAR | - | `near:mainnet` | Active |
 | Stellar | Stellar | - | `stellar:pubnet` | Active |
 
+### Supported Tokens (EVM Chains)
+
+| Token | Networks | Decimals |
+|-------|----------|----------|
+| USDC | All EVM chains | 6 |
+| EURC | Ethereum, Base, Avalanche | 6 |
+| AUSD | Ethereum, Arbitrum, Avalanche, Polygon, Monad | 6 |
+| PYUSD | Ethereum | 6 |
+| GHO | Ethereum, Base, Arbitrum | 18 |
+| crvUSD | Ethereum, Arbitrum | 18 |
+
 ## Installation
 
 ```bash
@@ -561,6 +573,92 @@ config = X402Config(
 
 ---
 
+## Multi-Token Support
+
+The SDK supports 6 stablecoins on EVM chains. Use the token helper functions to query and work with different tokens.
+
+### Querying Token Support
+
+```python
+from uvd_x402_sdk import (
+    TokenType,
+    get_token_config,
+    get_supported_tokens,
+    is_token_supported,
+    get_networks_by_token,
+)
+
+# Check which tokens a network supports
+tokens = get_supported_tokens("ethereum")
+print(tokens)  # ['usdc', 'eurc', 'ausd', 'pyusd', 'gho', 'crvusd']
+
+tokens = get_supported_tokens("base")
+print(tokens)  # ['usdc', 'eurc', 'gho']
+
+# Check if a specific token is supported
+if is_token_supported("ethereum", "eurc"):
+    print("EURC is available on Ethereum!")
+
+# Get token configuration
+config = get_token_config("ethereum", "eurc")
+if config:
+    print(f"EURC address: {config.address}")
+    print(f"Decimals: {config.decimals}")
+    print(f"EIP-712 name: {config.name}")
+    print(f"EIP-712 version: {config.version}")
+
+# Find all networks that support a token
+networks = get_networks_by_token("gho")
+for network in networks:
+    print(f"GHO available on: {network.display_name}")
+# Output: GHO available on: Ethereum, Base, Arbitrum One
+```
+
+### Token Configuration
+
+Each token has specific EIP-712 domain parameters required for signing:
+
+```python
+from uvd_x402_sdk import TokenConfig, get_token_config
+
+# TokenConfig structure
+# - address: Contract address
+# - decimals: Token decimals (6 for most, 18 for GHO/crvUSD)
+# - name: EIP-712 domain name (e.g., "USD Coin", "EURC", "Gho Token")
+# - version: EIP-712 domain version
+
+# Example: Get EURC config on Base
+eurc = get_token_config("base", "eurc")
+# TokenConfig(
+#     address="0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42",
+#     decimals=6,
+#     name="EURC",
+#     version="2"
+# )
+
+# Example: Get GHO config on Ethereum (note: 18 decimals)
+gho = get_token_config("ethereum", "gho")
+# TokenConfig(
+#     address="0x40D16FC0246aD3160Ccc09B8D0D3A2cD28aE6C2f",
+#     decimals=18,
+#     name="Gho Token",
+#     version="1"
+# )
+```
+
+### Available Tokens
+
+| Token | Description | Decimals | Issuer |
+|-------|-------------|----------|--------|
+| `usdc` | USD Coin | 6 | Circle |
+| `eurc` | Euro Coin | 6 | Circle |
+| `ausd` | Agora USD | 6 | Agora Finance |
+| `pyusd` | PayPal USD | 6 | PayPal/Paxos |
+| `gho` | GHO Stablecoin | 18 | Aave |
+| `crvusd` | Curve USD | 18 | Curve Finance |
+
+---
+
 ## Error Handling
 
 ```python
@@ -606,7 +704,7 @@ except X402Error as e:
 
 ## How x402 Works
 
-The x402 protocol enables gasless USDC payments:
+The x402 protocol enables gasless stablecoin payments (USDC, EURC, AUSD, PYUSD, GHO, crvUSD):
 
 ```
 1. User Request     -->  Client sends request without payment
@@ -649,13 +747,14 @@ The facilitator (https://facilitator.ultravioletadao.xyz) handles all on-chain i
 ## Security
 
 - Users **NEVER** pay gas or submit transactions directly
-- **EVM**: Users sign EIP-712 structured messages only (no transaction broadcast)
+- **EVM**: Users sign EIP-712 structured messages for any supported stablecoin (USDC, EURC, AUSD, PYUSD, GHO, crvUSD)
 - **Solana/Fogo**: Users sign partial transactions (facilitator co-signs and submits)
 - **Stellar**: Users sign Soroban authorization entries only
 - **NEAR**: Users sign NEP-366 meta-transactions (DelegateAction)
 - The facilitator submits and pays for all on-chain transactions
 - All signatures include expiration timestamps (`validBefore`) for replay protection
 - Nonces prevent double-spending of authorizations
+- Each token has verified contract addresses and EIP-712 domain parameters
 
 ---
 
@@ -733,6 +832,20 @@ MIT License - see LICENSE file.
 
 ## Changelog
 
+### v0.3.0 (2025-12-20)
+
+- **Multi-Stablecoin Support**: Added support for 6 stablecoins on EVM chains
+  - USDC (all EVM chains)
+  - EURC (Ethereum, Base, Avalanche)
+  - AUSD (Ethereum, Arbitrum, Avalanche, Polygon, Monad)
+  - PYUSD (Ethereum)
+  - GHO (Ethereum, Base, Arbitrum)
+  - crvUSD (Ethereum, Arbitrum)
+- Added `TokenType` literal type and `TokenConfig` dataclass
+- Added token helper functions: `get_token_config()`, `get_supported_tokens()`, `is_token_supported()`, `get_networks_by_token()`
+- Added `tokens` field to `NetworkConfig` for multi-token configurations
+- Updated EVM network configurations with token contract addresses and EIP-712 domain parameters
+
 ### v0.2.2 (2025-12-16)
 
 - Added Security section to documentation

{uvd_x402_sdk-0.2.3 → uvd_x402_sdk-0.3.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "uvd-x402-sdk"
-version = "0.2.3"
-description = "Python SDK for integrating x402 payments via the Ultravioleta DAO facilitator"
+version = "0.3.0"
+description = "Python SDK for x402 payments - gasless crypto payments across 14 blockchains with multi-stablecoin support (USDC, EURC, AUSD, PYUSD, GHO, crvUSD)"
 readme = "README.md"
 requires-python = ">=3.9"
 authors = [
@@ -16,12 +16,17 @@ keywords = [
     "payments",
     "crypto",
     "usdc",
+    "eurc",
+    "stablecoin",
     "web3",
     "evm",
     "solana",
     "near",
     "stellar",
     "facilitator",
+    "gasless",
+    "eip-712",
+    "eip-3009",
 ]
 classifiers = [
     "Development Status :: 4 - Beta",

{uvd_x402_sdk-0.2.3 → uvd_x402_sdk-0.3.0}/src/uvd_x402_sdk/__init__.py

@@ -37,7 +37,7 @@ Supported Networks (14 total):
 - Stellar (1): Stellar
 """
 
-__version__ = "0.2.3"
+__version__ = "0.3.0"
 __author__ = "Ultravioleta DAO"
 
 from uvd_x402_sdk.client import X402Client
@@ -83,6 +83,14 @@ from uvd_x402_sdk.networks import (
     get_supported_chain_ids,
     get_supported_network_names,
     NetworkType,
+    # Token types (multi-stablecoin support)
+    TokenType,
+    TokenConfig,
+    ALL_TOKEN_TYPES,
+    get_token_config,
+    get_supported_tokens,
+    is_token_supported,
+    get_networks_by_token,
     # CAIP-2 utilities (v2 support)
     parse_caip2_network,
     to_caip2_network,
@@ -151,6 +159,14 @@ __all__ = [
     "get_supported_chain_ids",
     "get_supported_network_names",
     "NetworkType",
+    # Token types (multi-stablecoin support)
+    "TokenType",
+    "TokenConfig",
+    "ALL_TOKEN_TYPES",
+    "get_token_config",
+    "get_supported_tokens",
+    "is_token_supported",
+    "get_networks_by_token",
     # CAIP-2 utilities
     "parse_caip2_network",
     "to_caip2_network",

{uvd_x402_sdk-0.2.3 → uvd_x402_sdk-0.3.0}/src/uvd_x402_sdk/networks/__init__.py

@@ -11,12 +11,24 @@ The SDK supports 14 mainnet networks out of the box:
 - 1 NEAR: NEAR Protocol
 - 1 Stellar: Stellar
 
+Multi-token support (EVM chains only):
+- USDC: All chains
+- EURC: Ethereum, Base, Avalanche
+- AUSD: Ethereum, Arbitrum, Avalanche, Polygon, Monad
+- PYUSD: Ethereum
+- GHO: Ethereum, Base, Arbitrum
+- crvUSD: Ethereum, Arbitrum
+
 You can register custom networks using `register_network()`.
 """
 
 from uvd_x402_sdk.networks.base import (
     NetworkConfig,
     NetworkType,
+    # Token types (multi-stablecoin support)
+    TokenType,
+    TokenConfig,
+    ALL_TOKEN_TYPES,
     get_network,
     get_network_by_chain_id,
     register_network,
@@ -24,6 +36,11 @@ from uvd_x402_sdk.networks.base import (
     get_supported_chain_ids,
     get_supported_network_names,
     SUPPORTED_NETWORKS,
+    # Token helper functions
+    get_token_config,
+    get_supported_tokens,
+    is_token_supported,
+    get_networks_by_token,
     # CAIP-2 utilities (x402 v2)
     parse_caip2_network,
     to_caip2_network,
@@ -38,6 +55,10 @@ __all__ = [
     # Core
     "NetworkConfig",
     "NetworkType",
+    # Token types (multi-stablecoin support)
+    "TokenType",
+    "TokenConfig",
+    "ALL_TOKEN_TYPES",
     # Registry functions
     "get_network",
     "get_network_by_chain_id",
@@ -46,6 +67,11 @@ __all__ = [
     "get_supported_chain_ids",
     "get_supported_network_names",
     "SUPPORTED_NETWORKS",
+    # Token helper functions
+    "get_token_config",
+    "get_supported_tokens",
+    "is_token_supported",
+    "get_networks_by_token",
     # CAIP-2 utilities (x402 v2)
     "parse_caip2_network",
     "to_caip2_network",

{uvd_x402_sdk-0.2.3 → uvd_x402_sdk-0.3.0}/src/uvd_x402_sdk/networks/base.py

@@ -4,12 +4,48 @@ Base network configuration and registry.
 This module provides the foundation for network configuration, including:
 - NetworkConfig dataclass for defining network parameters
 - NetworkType enum for categorizing networks
+- TokenType for multi-stablecoin support
 - Global registry for storing and retrieving network configurations
 """
 
 from dataclasses import dataclass, field
 from enum import Enum
-from typing import Dict, List, Optional, Any
+from typing import Dict, List, Literal, Optional, Any
+
+
+# =============================================================================
+# Token Type Definitions (Multi-Stablecoin Support)
+# =============================================================================
+
+# Supported stablecoin token types
+# - usdc: USD Coin (Circle) - 6 decimals
+# - eurc: Euro Coin (Circle) - 6 decimals
+# - ausd: Agora USD (Agora Finance) - 6 decimals
+# - pyusd: PayPal USD (PayPal/Paxos) - 6 decimals
+# - gho: GHO Stablecoin (Aave) - 18 decimals
+# - crvusd: Curve USD (Curve Finance) - 18 decimals
+TokenType = Literal["usdc", "eurc", "ausd", "pyusd", "gho", "crvusd"]
+
+# All supported token types
+ALL_TOKEN_TYPES: List[TokenType] = ["usdc", "eurc", "ausd", "pyusd", "gho", "crvusd"]
+
+
+@dataclass
+class TokenConfig:
+    """
+    Configuration for a stablecoin token on a specific network.
+
+    Attributes:
+        address: Contract address of the token
+        decimals: Number of decimals (6 for most stablecoins, 18 for GHO/crvUSD)
+        name: Token name for EIP-712 domain (e.g., "USD Coin" or "USDC")
+        version: Token version for EIP-712 domain
+    """
+
+    address: str
+    decimals: int
+    name: str
+    version: str
 
 
 class NetworkType(Enum):
@@ -53,6 +89,7 @@ class NetworkConfig:
         usdc_domain_version: EIP-712 domain version (EVM only)
         rpc_url: Default RPC endpoint
         enabled: Whether network is currently enabled
+        tokens: Multi-token configurations (EVM chains only, maps token type to config)
         extra_config: Additional network-specific configuration
     """
 
@@ -66,6 +103,7 @@ class NetworkConfig:
     usdc_domain_version: str = "2"
     rpc_url: str = ""
     enabled: bool = True
+    tokens: Dict[TokenType, TokenConfig] = field(default_factory=dict)
     extra_config: Dict[str, Any] = field(default_factory=dict)
 
     def __post_init__(self) -> None:
@@ -209,6 +247,119 @@ def get_supported_network_names() -> List[str]:
 SUPPORTED_NETWORKS = _NETWORK_REGISTRY
 
 
+# =============================================================================
+# Token Helper Functions (Multi-Stablecoin Support)
+# =============================================================================
+
+
+def get_token_config(network_name: str, token_type: TokenType = "usdc") -> Optional[TokenConfig]:
+    """
+    Get token configuration for a specific network and token type.
+
+    Args:
+        network_name: Network identifier (e.g., 'base', 'ethereum')
+        token_type: Token type (defaults to 'usdc')
+
+    Returns:
+        TokenConfig if the token is supported on this network, None otherwise
+
+    Example:
+        >>> config = get_token_config('ethereum', 'eurc')
+        >>> if config:
+        ...     print(f"EURC address: {config.address}")
+    """
+    network = get_network(network_name)
+    if not network:
+        return None
+
+    # Check tokens dict first (multi-token support)
+    if token_type in network.tokens:
+        return network.tokens[token_type]
+
+    # Fall back to USDC config for backward compatibility
+    if token_type == "usdc":
+        return TokenConfig(
+            address=network.usdc_address,
+            decimals=network.usdc_decimals,
+            name=network.usdc_domain_name,
+            version=network.usdc_domain_version,
+        )
+
+    return None
+
+
+def get_supported_tokens(network_name: str) -> List[TokenType]:
+    """
+    Get list of supported token types for a network.
+
+    Args:
+        network_name: Network identifier
+
+    Returns:
+        List of supported TokenType values
+
+    Example:
+        >>> tokens = get_supported_tokens('ethereum')
+        >>> print(tokens)  # ['usdc', 'eurc', 'ausd', 'pyusd', 'gho', 'crvusd']
+    """
+    network = get_network(network_name)
+    if not network:
+        return []
+
+    # Get tokens from the tokens dict
+    tokens: List[TokenType] = list(network.tokens.keys())
+
+    # Always include 'usdc' if the network has USDC configured
+    if "usdc" not in tokens and network.usdc_address:
+        tokens.insert(0, "usdc")
+
+    return tokens
+
+
+def is_token_supported(network_name: str, token_type: TokenType) -> bool:
+    """
+    Check if a specific token is supported on a network.
+
+    Args:
+        network_name: Network identifier
+        token_type: Token type to check
+
+    Returns:
+        True if token is supported, False otherwise
+
+    Example:
+        >>> is_token_supported('ethereum', 'eurc')
+        True
+        >>> is_token_supported('celo', 'eurc')
+        False
+    """
+    return get_token_config(network_name, token_type) is not None
+
+
+def get_networks_by_token(token_type: TokenType) -> List[NetworkConfig]:
+    """
+    Get all networks that support a specific token type.
+
+    Args:
+        token_type: Token type to search for
+
+    Returns:
+        List of NetworkConfig instances that support the token
+
+    Example:
+        >>> networks = get_networks_by_token('eurc')
+        >>> for n in networks:
+        ...     print(n.name)  # ethereum, base, avalanche
+    """
+    result = []
+    for network in _NETWORK_REGISTRY.values():
+        if not network.enabled:
+            continue
+        if is_token_supported(network.name, token_type):
+            result.append(network)
+    return result
+
+
 # =============================================================================
 # CAIP-2 Utilities (x402 v2 support)
 # =============================================================================

{uvd_x402_sdk-0.2.3 → uvd_x402_sdk-0.3.0}/src/uvd_x402_sdk/networks/evm.py

@@ -7,11 +7,20 @@ Each chain uses ERC-3009 TransferWithAuthorization for USDC transfers.
 Important EIP-712 domain considerations:
 - Most chains use 'USD Coin' as the domain name
 - Celo, HyperEVM, Unichain, Monad use 'USDC' as the domain name
+
+Multi-token support:
+- USDC: All chains (6 decimals)
+- EURC: Ethereum, Base, Avalanche (6 decimals)
+- AUSD: Ethereum, Arbitrum, Avalanche, Polygon, Monad (6 decimals)
+- PYUSD: Ethereum (6 decimals)
+- GHO: Ethereum, Base, Arbitrum (18 decimals)
+- crvUSD: Ethereum, Arbitrum (18 decimals)
 """
 
 from uvd_x402_sdk.networks.base import (
     NetworkConfig,
     NetworkType,
+    TokenConfig,
     register_network,
 )
 
@@ -19,7 +28,7 @@ from uvd_x402_sdk.networks.base import (
 # EVM Networks Configuration
 # =============================================================================
 
-# Base (Layer 2)
+# Base (Layer 2) - supports USDC, EURC, GHO
 BASE = NetworkConfig(
     name="base",
     display_name="Base",
@@ -31,9 +40,29 @@ BASE = NetworkConfig(
     usdc_domain_version="2",
     rpc_url="https://mainnet.base.org",
     enabled=True,
+    tokens={
+        "usdc": TokenConfig(
+            address="0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+            decimals=6,
+            name="USD Coin",
+            version="2",
+        ),
+        "eurc": TokenConfig(
+            address="0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42",
+            decimals=6,
+            name="EURC",
+            version="2",
+        ),
+        "gho": TokenConfig(
+            address="0x6Bb7a212910682DCFdbd5BCBb3e28FB4E8da10Ee",
+            decimals=18,
+            name="Gho Token",
+            version="1",
+        ),
+    },
 )
 
-# Ethereum Mainnet
+# Ethereum Mainnet (supports all 6 stablecoins)
 ETHEREUM = NetworkConfig(
     name="ethereum",
     display_name="Ethereum",
@@ -45,9 +74,47 @@ ETHEREUM = NetworkConfig(
     usdc_domain_version="2",
     rpc_url="https://eth.llamarpc.com",
     enabled=True,
+    tokens={
+        "usdc": TokenConfig(
+            address="0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+            decimals=6,
+            name="USD Coin",
+            version="2",
+        ),
+        "eurc": TokenConfig(
+            address="0x1aBaEA1f7C830bD89Acc67eC4af516284b1bC33c",
+            decimals=6,
+            name="EURC",
+            version="2",
+        ),
+        "ausd": TokenConfig(
+            address="0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+            decimals=6,
+            name="Agora USD",
+            version="1",
+        ),
+        "pyusd": TokenConfig(
+            address="0x6c3ea9036406852006290770BEdFcAbA0e23A0e8",
+            decimals=6,
+            name="PayPal USD",
+            version="1",
+        ),
+        "gho": TokenConfig(
+            address="0x40D16FC0246aD3160Ccc09B8D0D3A2cD28aE6C2f",
+            decimals=18,
+            name="Gho Token",
+            version="1",
+        ),
+        "crvusd": TokenConfig(
+            address="0xf939E0A03FB07F59A73314E73794Be0E57ac1b4E",
+            decimals=18,
+            name="Curve.Fi USD Stablecoin",
+            version="1",
+        ),
+    },
 )
 
-# Polygon (PoS)
+# Polygon (PoS) - supports USDC, AUSD
 POLYGON = NetworkConfig(
     name="polygon",
     display_name="Polygon",
@@ -59,9 +126,23 @@ POLYGON = NetworkConfig(
     usdc_domain_version="2",
     rpc_url="https://polygon-rpc.com",
     enabled=True,
+    tokens={
+        "usdc": TokenConfig(
+            address="0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+            decimals=6,
+            name="USD Coin",
+            version="2",
+        ),
+        "ausd": TokenConfig(
+            address="0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+            decimals=6,
+            name="Agora USD",
+            version="1",
+        ),
+    },
 )
 
-# Arbitrum One
+# Arbitrum One - supports USDC, AUSD, GHO, crvUSD
 ARBITRUM = NetworkConfig(
     name="arbitrum",
     display_name="Arbitrum One",
@@ -73,6 +154,32 @@ ARBITRUM = NetworkConfig(
     usdc_domain_version="2",
     rpc_url="https://arb1.arbitrum.io/rpc",
     enabled=True,
+    tokens={
+        "usdc": TokenConfig(
+            address="0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+            decimals=6,
+            name="USD Coin",
+            version="2",
+        ),
+        "ausd": TokenConfig(
+            address="0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+            decimals=6,
+            name="Agora USD",
+            version="1",
+        ),
+        "gho": TokenConfig(
+            address="0x7dfF72693f6A4149b17e7C6314655f6A9F7c8B33",
+            decimals=18,
+            name="Gho Token",
+            version="1",
+        ),
+        "crvusd": TokenConfig(
+            address="0x498Bf2B1e120FeD3ad3D42EA2165E9b73f99C1e5",
+            decimals=18,
+            name="Curve.Fi USD Stablecoin",
+            version="1",
+        ),
+    },
 )
 
 # Optimism
@@ -89,7 +196,7 @@ OPTIMISM = NetworkConfig(
     enabled=True,
 )
 
-# Avalanche C-Chain
+# Avalanche C-Chain - supports USDC, EURC, AUSD
 AVALANCHE = NetworkConfig(
     name="avalanche",
     display_name="Avalanche C-Chain",
@@ -101,6 +208,26 @@ AVALANCHE = NetworkConfig(
     usdc_domain_version="2",
     rpc_url="https://avalanche-c-chain-rpc.publicnode.com",
     enabled=True,
+    tokens={
+        "usdc": TokenConfig(
+            address="0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
+            decimals=6,
+            name="USD Coin",
+            version="2",
+        ),
+        "eurc": TokenConfig(
+            address="0xC891EB4cbdEFf6e073e859e987815Ed1505c2ACD",
+            decimals=6,
+            name="EURC",
+            version="2",
+        ),
+        "ausd": TokenConfig(
+            address="0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+            decimals=6,
+            name="Agora USD",
+            version="1",
+        ),
+    },
 )
 
 # Celo
@@ -148,7 +275,7 @@ UNICHAIN = NetworkConfig(
     enabled=True,
 )
 
-# Monad
+# Monad - supports USDC, AUSD
 # NOTE: Monad uses 'USDC' (not 'USD Coin') for EIP-712 domain name
 MONAD = NetworkConfig(
     name="monad",
@@ -161,6 +288,20 @@ MONAD = NetworkConfig(
     usdc_domain_version="2",
     rpc_url="https://rpc.monad.xyz",
     enabled=True,
+    tokens={
+        "usdc": TokenConfig(
+            address="0x754704bc059f8c67012fed69bc8a327a5aafb603",
+            decimals=6,
+            name="USDC",
+            version="2",
+        ),
+        "ausd": TokenConfig(
+            address="0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+            decimals=6,
+            name="Agora USD",
+            version="1",
+        ),
+    },
 )
 
 # =============================================================================

{uvd_x402_sdk-0.2.3 → uvd_x402_sdk-0.3.0/src/uvd_x402_sdk.egg-info}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.1
 Name: uvd-x402-sdk
-Version: 0.2.3
-Summary: Python SDK for integrating x402 payments via the Ultravioleta DAO facilitator
+Version: 0.3.0
+Summary: Python SDK for x402 payments - gasless crypto payments across 14 blockchains with multi-stablecoin support (USDC, EURC, AUSD, PYUSD, GHO, crvUSD)
 Author-email: Ultravioleta DAO <dev@ultravioletadao.xyz>
 Project-URL: Homepage, https://github.com/UltravioletaDAO/uvd-x402-sdk-python
 Project-URL: Documentation, https://docs.ultravioletadao.xyz/x402-sdk
 Project-URL: Repository, https://github.com/UltravioletaDAO/uvd-x402-sdk-python
 Project-URL: Issues, https://github.com/UltravioletaDAO/uvd-x402-sdk-python/issues
-Keywords: x402,payments,crypto,usdc,web3,evm,solana,near,stellar,facilitator
+Keywords: x402,payments,crypto,usdc,eurc,stablecoin,web3,evm,solana,near,stellar,facilitator,gasless,eip-712,eip-3009
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -51,17 +51,18 @@ Requires-Dist: httpx>=0.24.0; extra == "dev"
 
 Python SDK for integrating **x402 cryptocurrency payments** via the Ultravioleta DAO facilitator.
 
-Accept USDC payments across **14 blockchain networks** with a single integration. The SDK handles signature verification, on-chain settlement, and all the complexity of multi-chain payments.
+Accept **gasless stablecoin payments** across **14 blockchain networks** with a single integration. The SDK handles signature verification, on-chain settlement, and all the complexity of multi-chain payments.
 
 ## Features
 
 - **14 Networks**: EVM chains (Base, Ethereum, Polygon, etc.), SVM chains (Solana, Fogo), NEAR, and Stellar
+- **6 Stablecoins**: USDC, EURC, AUSD, PYUSD, GHO, crvUSD (EVM chains)
 - **x402 v1 & v2**: Full support for both protocol versions with auto-detection
 - **Framework Integrations**: Flask, FastAPI, Django, AWS Lambda
-- **Gasless Payments**: Users sign authorizations, facilitator pays all network fees
+- **Gasless Payments**: Users sign EIP-712/EIP-3009 authorizations, facilitator pays all network fees
 - **Simple API**: Decorators and middleware for quick integration
 - **Type Safety**: Full Pydantic models and type hints
-- **Extensible**: Register custom networks easily
+- **Extensible**: Register custom networks and tokens easily
 
 ## Quick Start (5 Lines)
 
@@ -93,6 +94,17 @@ print(f"Paid by {result.payer_address}, tx: {result.transaction_hash}")
 | NEAR | NEAR | - | `near:mainnet` | Active |
 | Stellar | Stellar | - | `stellar:pubnet` | Active |
 
+### Supported Tokens (EVM Chains)
+
+| Token | Networks | Decimals |
+|-------|----------|----------|
+| USDC | All EVM chains | 6 |
+| EURC | Ethereum, Base, Avalanche | 6 |
+| AUSD | Ethereum, Arbitrum, Avalanche, Polygon, Monad | 6 |
+| PYUSD | Ethereum | 6 |
+| GHO | Ethereum, Base, Arbitrum | 18 |
+| crvUSD | Ethereum, Arbitrum | 18 |
+
 ## Installation
 
 ```bash
@@ -610,6 +622,92 @@ config = X402Config(
 
 ---
 
+## Multi-Token Support
+
+The SDK supports 6 stablecoins on EVM chains. Use the token helper functions to query and work with different tokens.
+
+### Querying Token Support
+
+```python
+from uvd_x402_sdk import (
+    TokenType,
+    get_token_config,
+    get_supported_tokens,
+    is_token_supported,
+    get_networks_by_token,
+)
+
+# Check which tokens a network supports
+tokens = get_supported_tokens("ethereum")
+print(tokens)  # ['usdc', 'eurc', 'ausd', 'pyusd', 'gho', 'crvusd']
+
+tokens = get_supported_tokens("base")
+print(tokens)  # ['usdc', 'eurc', 'gho']
+
+# Check if a specific token is supported
+if is_token_supported("ethereum", "eurc"):
+    print("EURC is available on Ethereum!")
+
+# Get token configuration
+config = get_token_config("ethereum", "eurc")
+if config:
+    print(f"EURC address: {config.address}")
+    print(f"Decimals: {config.decimals}")
+    print(f"EIP-712 name: {config.name}")
+    print(f"EIP-712 version: {config.version}")
+
+# Find all networks that support a token
+networks = get_networks_by_token("gho")
+for network in networks:
+    print(f"GHO available on: {network.display_name}")
+# Output: GHO available on: Ethereum, Base, Arbitrum One
+```
+
+### Token Configuration
+
+Each token has specific EIP-712 domain parameters required for signing:
+
+```python
+from uvd_x402_sdk import TokenConfig, get_token_config
+
+# TokenConfig structure
+# - address: Contract address
+# - decimals: Token decimals (6 for most, 18 for GHO/crvUSD)
+# - name: EIP-712 domain name (e.g., "USD Coin", "EURC", "Gho Token")
+# - version: EIP-712 domain version
+
+# Example: Get EURC config on Base
+eurc = get_token_config("base", "eurc")
+# TokenConfig(
+#     address="0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42",
+#     decimals=6,
+#     name="EURC",
+#     version="2"
+# )
+
+# Example: Get GHO config on Ethereum (note: 18 decimals)
+gho = get_token_config("ethereum", "gho")
+# TokenConfig(
+#     address="0x40D16FC0246aD3160Ccc09B8D0D3A2cD28aE6C2f",
+#     decimals=18,
+#     name="Gho Token",
+#     version="1"
+# )
+```
+
+### Available Tokens
+
+| Token | Description | Decimals | Issuer |
+|-------|-------------|----------|--------|
+| `usdc` | USD Coin | 6 | Circle |
+| `eurc` | Euro Coin | 6 | Circle |
+| `ausd` | Agora USD | 6 | Agora Finance |
+| `pyusd` | PayPal USD | 6 | PayPal/Paxos |
+| `gho` | GHO Stablecoin | 18 | Aave |
+| `crvusd` | Curve USD | 18 | Curve Finance |
+
+---
+
 ## Error Handling
 
 ```python
@@ -655,7 +753,7 @@ except X402Error as e:
 
 ## How x402 Works
 
-The x402 protocol enables gasless USDC payments:
+The x402 protocol enables gasless stablecoin payments (USDC, EURC, AUSD, PYUSD, GHO, crvUSD):
 
 ```
 1. User Request     -->  Client sends request without payment
@@ -698,13 +796,14 @@ The facilitator (https://facilitator.ultravioletadao.xyz) handles all on-chain i
 ## Security
 
 - Users **NEVER** pay gas or submit transactions directly
-- **EVM**: Users sign EIP-712 structured messages only (no transaction broadcast)
+- **EVM**: Users sign EIP-712 structured messages for any supported stablecoin (USDC, EURC, AUSD, PYUSD, GHO, crvUSD)
 - **Solana/Fogo**: Users sign partial transactions (facilitator co-signs and submits)
 - **Stellar**: Users sign Soroban authorization entries only
 - **NEAR**: Users sign NEP-366 meta-transactions (DelegateAction)
 - The facilitator submits and pays for all on-chain transactions
 - All signatures include expiration timestamps (`validBefore`) for replay protection
 - Nonces prevent double-spending of authorizations
+- Each token has verified contract addresses and EIP-712 domain parameters
 
 ---
 
@@ -782,6 +881,20 @@ MIT License - see LICENSE file.
 
 ## Changelog
 
+### v0.3.0 (2025-12-20)
+
+- **Multi-Stablecoin Support**: Added support for 6 stablecoins on EVM chains
+  - USDC (all EVM chains)
+  - EURC (Ethereum, Base, Avalanche)
+  - AUSD (Ethereum, Arbitrum, Avalanche, Polygon, Monad)
+  - PYUSD (Ethereum)
+  - GHO (Ethereum, Base, Arbitrum)
+  - crvUSD (Ethereum, Arbitrum)
+- Added `TokenType` literal type and `TokenConfig` dataclass
+- Added token helper functions: `get_token_config()`, `get_supported_tokens()`, `is_token_supported()`, `get_networks_by_token()`
+- Added `tokens` field to `NetworkConfig` for multi-token configurations
+- Updated EVM network configurations with token contract addresses and EIP-712 domain parameters
+
 ### v0.2.2 (2025-12-16)
 
 - Added Security section to documentation