uvd-x402-sdk 0.3.1__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.1"
+__version__ = "0.3.2"
 __author__ = "Ultravioleta DAO"
 
 from uvd_x402_sdk.client import X402Client

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: uvd-x402-sdk
-Version: 0.3.1
+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
@@ -702,6 +702,55 @@ pyusd = get_token_config("ethereum", "pyusd")
 | `ausd` | Agora USD | 6 | Agora Finance |
 | `pyusd` | PayPal USD | 6 | PayPal/Paxos |
 
+### 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.
+
 ---
 
 ## Error Handling
@@ -877,6 +926,13 @@ 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)

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

@@ -1,4 +1,4 @@
-uvd_x402_sdk/__init__.py,sha256=3i3Xt655wgqBUNgNNodbsaMf9yJtt0qR9ZwraFoJScc,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
@@ -16,8 +16,8 @@ uvd_x402_sdk/networks/evm.py,sha256=ezgZ0MHX6iWsb0VoleOJHJoMB7dF9evQxeLCGD-aEbs,
 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.1.dist-info/LICENSE,sha256=OcLzB_iSgMbvk7b0dlyvleY_IbL2WUaPxvn1CHw2uAc,1073
-uvd_x402_sdk-0.3.1.dist-info/METADATA,sha256=kulw5We1SUMsjRXERdVFK3amOflHfwfAFkc2oTdhH0U,26788
-uvd_x402_sdk-0.3.1.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-uvd_x402_sdk-0.3.1.dist-info/top_level.txt,sha256=Exyjj_Kl7CDAGFMi72lT9oFPOYiRNZb3l8tr906mMmc,13
-uvd_x402_sdk-0.3.1.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,,