uvd-x402-sdk 0.3.0__py3-none-any.whl → 0.3.2__py3-none-any.whl

uvd_x402_sdk/__init__.py

@@ -37,7 +37,7 @@ Supported Networks (14 total):
 - Stellar (1): Stellar
 """
 
-__version__ = "0.3.0"
+__version__ = "0.3.2"
 __author__ = "Ultravioleta DAO"
 
 from uvd_x402_sdk.client import X402Client

uvd_x402_sdk/networks/__init__.py

@@ -16,8 +16,6 @@ Multi-token support (EVM chains only):
 - 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()`.
 """

uvd_x402_sdk/networks/base.py

@@ -22,12 +22,10 @@ from typing import Dict, List, Literal, Optional, Any
 # - 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"]
+TokenType = Literal["usdc", "eurc", "ausd", "pyusd"]
 
 # All supported token types
-ALL_TOKEN_TYPES: List[TokenType] = ["usdc", "eurc", "ausd", "pyusd", "gho", "crvusd"]
+ALL_TOKEN_TYPES: List[TokenType] = ["usdc", "eurc", "ausd", "pyusd"]
 
 
 @dataclass
@@ -37,7 +35,7 @@ class TokenConfig:
 
     Attributes:
         address: Contract address of the token
-        decimals: Number of decimals (6 for most stablecoins, 18 for GHO/crvUSD)
+        decimals: Number of decimals (6 for all supported stablecoins)
         name: Token name for EIP-712 domain (e.g., "USD Coin" or "USDC")
         version: Token version for EIP-712 domain
     """
@@ -300,7 +298,7 @@ def get_supported_tokens(network_name: str) -> List[TokenType]:
 
     Example:
         >>> tokens = get_supported_tokens('ethereum')
-        >>> print(tokens)  # ['usdc', 'eurc', 'ausd', 'pyusd', 'gho', 'crvusd']
+        >>> print(tokens)  # ['usdc', 'eurc', 'ausd', 'pyusd']
     """
     network = get_network(network_name)
     if not network:

uvd_x402_sdk/networks/evm.py

@@ -13,8 +13,6 @@ Multi-token support:
 - 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 (
@@ -28,7 +26,7 @@ from uvd_x402_sdk.networks.base import (
 # EVM Networks Configuration
 # =============================================================================
 
-# Base (Layer 2) - supports USDC, EURC, GHO
+# Base (Layer 2) - supports USDC, EURC
 BASE = NetworkConfig(
     name="base",
     display_name="Base",
@@ -53,16 +51,10 @@ BASE = NetworkConfig(
             name="EURC",
             version="2",
         ),
-        "gho": TokenConfig(
-            address="0x6Bb7a212910682DCFdbd5BCBb3e28FB4E8da10Ee",
-            decimals=18,
-            name="Gho Token",
-            version="1",
-        ),
     },
 )
 
-# Ethereum Mainnet (supports all 6 stablecoins)
+# Ethereum Mainnet - supports USDC, EURC, AUSD, PYUSD
 ETHEREUM = NetworkConfig(
     name="ethereum",
     display_name="Ethereum",
@@ -99,18 +91,6 @@ ETHEREUM = NetworkConfig(
             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",
-        ),
     },
 )
 
@@ -142,7 +122,7 @@ POLYGON = NetworkConfig(
     },
 )
 
-# Arbitrum One - supports USDC, AUSD, GHO, crvUSD
+# Arbitrum One - supports USDC, AUSD
 ARBITRUM = NetworkConfig(
     name="arbitrum",
     display_name="Arbitrum One",
@@ -167,18 +147,6 @@ ARBITRUM = NetworkConfig(
             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",
-        ),
     },
 )
 

{uvd_x402_sdk-0.3.0.dist-info → uvd_x402_sdk-0.3.2.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: uvd-x402-sdk
-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)
+Version: 0.3.2
+Summary: Python SDK for x402 payments - gasless crypto payments across 14 blockchains with multi-stablecoin support (USDC, EURC, AUSD, PYUSD)
 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
@@ -56,7 +56,7 @@ Accept **gasless stablecoin payments** across **14 blockchain networks** with a
 ## 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)
+- **4 Stablecoins**: USDC, EURC, AUSD, PYUSD (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 EIP-712/EIP-3009 authorizations, facilitator pays all network fees
@@ -102,8 +102,6 @@ print(f"Paid by {result.payer_address}, tx: {result.transaction_hash}")
 | 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
 
@@ -639,10 +637,10 @@ from uvd_x402_sdk import (
 
 # Check which tokens a network supports
 tokens = get_supported_tokens("ethereum")
-print(tokens)  # ['usdc', 'eurc', 'ausd', 'pyusd', 'gho', 'crvusd']
+print(tokens)  # ['usdc', 'eurc', 'ausd', 'pyusd']
 
 tokens = get_supported_tokens("base")
-print(tokens)  # ['usdc', 'eurc', 'gho']
+print(tokens)  # ['usdc', 'eurc']
 
 # Check if a specific token is supported
 if is_token_supported("ethereum", "eurc"):
@@ -657,10 +655,10 @@ if config:
     print(f"EIP-712 version: {config.version}")
 
 # Find all networks that support a token
-networks = get_networks_by_token("gho")
+networks = get_networks_by_token("eurc")
 for network in networks:
-    print(f"GHO available on: {network.display_name}")
-# Output: GHO available on: Ethereum, Base, Arbitrum One
+    print(f"EURC available on: {network.display_name}")
+# Output: EURC available on: Ethereum, Base, Avalanche C-Chain
 ```
 
 ### Token Configuration
@@ -672,7 +670,7 @@ from uvd_x402_sdk import TokenConfig, get_token_config
 
 # TokenConfig structure
 # - address: Contract address
-# - decimals: Token decimals (6 for most, 18 for GHO/crvUSD)
+# - decimals: Token decimals (6 for all supported stablecoins)
 # - name: EIP-712 domain name (e.g., "USD Coin", "EURC", "Gho Token")
 # - version: EIP-712 domain version
 
@@ -685,12 +683,12 @@ eurc = get_token_config("base", "eurc")
 #     version="2"
 # )
 
-# Example: Get GHO config on Ethereum (note: 18 decimals)
-gho = get_token_config("ethereum", "gho")
+# Example: Get PYUSD config on Ethereum
+pyusd = get_token_config("ethereum", "pyusd")
 # TokenConfig(
-#     address="0x40D16FC0246aD3160Ccc09B8D0D3A2cD28aE6C2f",
-#     decimals=18,
-#     name="Gho Token",
+#     address="0x6c3ea9036406852006290770BEdFcAbA0e23A0e8",
+#     decimals=6,
+#     name="PayPal USD",
 #     version="1"
 # )
 ```
@@ -703,8 +701,55 @@ gho = get_token_config("ethereum", "gho")
 | `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 |
+
+### Critical Implementation Notes
+
+#### EIP-712 Domain Names Vary by Chain
+
+The same token may use **different EIP-712 domain names on different chains**. This affects signature verification.
+
+| Token | Ethereum | Base | Avalanche |
+|-------|----------|------|-----------|
+| EURC | `"Euro Coin"` | `"EURC"` | `"Euro Coin"` |
+| USDC | `"USD Coin"` | `"USD Coin"` | `"USD Coin"` |
+| AUSD | `"AUSD"` | N/A | `"AUSD"` |
+| PYUSD | `"PayPal USD"` | N/A | N/A |
+
+**Important:** Always use `get_token_config()` to get the correct domain name. Never hardcode domain names.
+
+```python
+# CORRECT: Use get_token_config for each chain
+eurc_base = get_token_config("base", "eurc")
+# TokenConfig(name="EURC", version="2", ...)
+
+eurc_ethereum = get_token_config("ethereum", "eurc")
+# TokenConfig(name="Euro Coin", version="2", ...)
+```
+
+#### PYUSD Signature Format (PayPal USD)
+
+PYUSD uses the Paxos implementation which only supports the **v,r,s signature variant** of `transferWithAuthorization`. This is different from Circle's USDC/EURC which support both compact bytes and v,r,s variants.
+
+**Backend implications:**
+- The x402 facilitator (v1.9.0+) automatically handles this by detecting PYUSD and using `transferWithAuthorization_1(v,r,s)` instead of `transferWithAuthorization_0(bytes signature)`
+- If using a custom facilitator, ensure it supports the v,r,s variant for PYUSD
+
+#### Token Info Must Be Passed to Facilitator
+
+When using non-USDC tokens, your backend **must** pass the token info (including EIP-712 domain) to the facilitator. This is done via the `extra` field in `paymentRequirements`:
+
+```python
+# When building payment requirements for the facilitator
+payment_requirements = {
+    "asset": token_address,  # Use actual token address, NOT hardcoded USDC
+    "extra": {
+        "name": token_config.name,     # EIP-712 domain name
+        "version": token_config.version,  # EIP-712 domain version
+    }
+}
+```
+
+Without this, the facilitator will use wrong EIP-712 domain and signature verification will fail with "invalid signature" error.
 
 ---
 
@@ -753,7 +798,7 @@ except X402Error as e:
 
 ## How x402 Works
 
-The x402 protocol enables gasless stablecoin payments (USDC, EURC, AUSD, PYUSD, GHO, crvUSD):
+The x402 protocol enables gasless stablecoin payments (USDC, EURC, AUSD, PYUSD):
 
 ```
 1. User Request     -->  Client sends request without payment
@@ -796,7 +841,7 @@ 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 for any supported stablecoin (USDC, EURC, AUSD, PYUSD, GHO, crvUSD)
+- **EVM**: Users sign EIP-712 structured messages for any supported stablecoin (USDC, EURC, AUSD, PYUSD)
 - **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)
@@ -881,15 +926,25 @@ MIT License - see LICENSE file.
 
 ## Changelog
 
+### v0.3.2 (2025-12-21)
+
+- Added critical implementation notes for multi-token support:
+  - EIP-712 domain names vary by chain (e.g., EURC is "Euro Coin" on Ethereum but "EURC" on Base)
+  - PYUSD uses v,r,s signature variant (Paxos implementation)
+  - Token info must be passed to facilitator via `extra` field
+
+### v0.3.1 (2025-12-21)
+
+- Removed GHO and crvUSD token support (not EIP-3009 compatible)
+- SDK now supports 4 stablecoins: USDC, EURC, AUSD, PYUSD
+
 ### v0.3.0 (2025-12-20)
 
-- **Multi-Stablecoin Support**: Added support for 6 stablecoins on EVM chains
+- **Multi-Stablecoin Support**: Added support for 4 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

{uvd_x402_sdk-0.3.0.dist-info → uvd_x402_sdk-0.3.2.dist-info}/RECORD

@@ -1,4 +1,4 @@
-uvd_x402_sdk/__init__.py,sha256=0IwhkXv-aqP1TbTuoHtL91TeRp2JFVbH1q6AqAbqeWI,4901
+uvd_x402_sdk/__init__.py,sha256=13c09ZmjH-rO6p2JHpUVl0gr3JgyVK3LG15dhoUHlIs,4901
 uvd_x402_sdk/client.py,sha256=QbK22DtC3HmvvCezphQ-UsYX468vKrIN-M_wF4pv9cM,18389
 uvd_x402_sdk/config.py,sha256=BNGnX2RwZ_ELIcSKU7RkwTUcln4LMFZdCwG1ptASKN8,8644
 uvd_x402_sdk/decorators.py,sha256=XJ7V4554hsa-AVDrizF1oKmeTysg5zlkQRcaeGBI73E,9767
@@ -10,14 +10,14 @@ uvd_x402_sdk/integrations/django_integration.py,sha256=e3xaV1Yz3HHI7zZBNcyTmV0Js
 uvd_x402_sdk/integrations/fastapi_integration.py,sha256=j5h1IJwFLBBoWov7ANLCFaxeCa8pugn-XU9ibrzIL0Y,10205
 uvd_x402_sdk/integrations/flask_integration.py,sha256=0iQKO5-WRxE76Pv-1jEl4lYhjCLmq_R-jxR5g9xIcKw,8825
 uvd_x402_sdk/integrations/lambda_integration.py,sha256=nRf4o3nS6Syx-d5P0kEhz66y7jb_S4w-mwaIazgiA9c,10184
-uvd_x402_sdk/networks/__init__.py,sha256=cqTW4NCuEKhsOSRAQDsusu1m1PaHCf791drVXLCYxUU,2100
-uvd_x402_sdk/networks/base.py,sha256=3wrm2aAmMxxdeCqGBArKFXkpARwWtokkOM_jeg_gJNI,14505
-uvd_x402_sdk/networks/evm.py,sha256=Ua1Rq7YPC_t5ZxnLi2_MK0kloaZNYW5ykllfQshYWMg,9950
+uvd_x402_sdk/networks/__init__.py,sha256=5EECOYHl2OukNv55sIJlHlU4XI9s1Uv2ksoXnxkpduM,2039
+uvd_x402_sdk/networks/base.py,sha256=At8ujOr7snjWqdQQ2-vACQ4AshVvSn0FsennGF6BpQk,14347
+uvd_x402_sdk/networks/evm.py,sha256=ezgZ0MHX6iWsb0VoleOJHJoMB7dF9evQxeLCGD-aEbs,8890
 uvd_x402_sdk/networks/near.py,sha256=sxbxT1NqjcENh8ysFLDpAx5DGizf1EI0YjwgviLfqcY,11608
 uvd_x402_sdk/networks/solana.py,sha256=kVSHRi57eTJdBtgI8SUbHfQUxYzx-_YvI_bEB0HIvNg,9351
 uvd_x402_sdk/networks/stellar.py,sha256=c-6re-dVc2-6gJ5rL4krUTaFsPz5vkactOJD-0wowBA,3534
-uvd_x402_sdk-0.3.0.dist-info/LICENSE,sha256=OcLzB_iSgMbvk7b0dlyvleY_IbL2WUaPxvn1CHw2uAc,1073
-uvd_x402_sdk-0.3.0.dist-info/METADATA,sha256=Yrj2HBiKah89TNsI3liY-LQYMCirwJxWUTsKO2WpPJw,26948
-uvd_x402_sdk-0.3.0.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-uvd_x402_sdk-0.3.0.dist-info/top_level.txt,sha256=Exyjj_Kl7CDAGFMi72lT9oFPOYiRNZb3l8tr906mMmc,13
-uvd_x402_sdk-0.3.0.dist-info/RECORD,,
+uvd_x402_sdk-0.3.2.dist-info/LICENSE,sha256=OcLzB_iSgMbvk7b0dlyvleY_IbL2WUaPxvn1CHw2uAc,1073
+uvd_x402_sdk-0.3.2.dist-info/METADATA,sha256=B_s8VazTzB4gTi2bmKhQuzGH84Efoj0R-7VaE2fth6s,29150
+uvd_x402_sdk-0.3.2.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
+uvd_x402_sdk-0.3.2.dist-info/top_level.txt,sha256=Exyjj_Kl7CDAGFMi72lT9oFPOYiRNZb3l8tr906mMmc,13
+uvd_x402_sdk-0.3.2.dist-info/RECORD,,