uvd-x402-sdk 0.2.0__py3-none-any.whl → 0.2.2__py3-none-any.whl

uvd_x402_sdk/__init__.py

@@ -2,7 +2,7 @@
 uvd-x402-sdk: Python SDK for x402 payments via Ultravioleta DAO facilitator.
 
 This SDK enables developers to easily integrate x402 cryptocurrency payments
-into their Python applications with support for 15 blockchain networks across
+into their Python applications with support for 14 blockchain networks across
 4 network types (EVM, SVM, NEAR, Stellar).
 
 Supports both x402 v1 and v2 protocols:
@@ -29,15 +29,15 @@ Example usage:
     def protected_endpoint():
         return {"message": "Payment verified!"}
 
-Supported Networks (15 total, 14 enabled):
-- EVM (11): Base, Ethereum, Polygon, Arbitrum, Optimism, Avalanche, Celo,
-           HyperEVM, Unichain, Monad, BSC (disabled)
+Supported Networks (14 total):
+- EVM (10): Base, Ethereum, Polygon, Arbitrum, Optimism, Avalanche, Celo,
+           HyperEVM, Unichain, Monad
 - SVM (2): Solana, Fogo
 - NEAR (1): NEAR Protocol
 - Stellar (1): Stellar
 """
 
-__version__ = "0.2.0"
+__version__ = "0.2.2"
 __author__ = "Ultravioleta DAO"
 
 from uvd_x402_sdk.client import X402Client

uvd_x402_sdk/config.py

@@ -84,17 +84,16 @@ class X402Config:
     verify_timeout: float = 30.0
     settle_timeout: float = 55.0  # Must be < Lambda timeout (60s)
 
-    # Network configuration - All 15 networks (14 enabled by default)
+    # Network configuration - All 14 networks
     supported_networks: List[str] = field(default_factory=lambda: [
-        # EVM chains (11 total, 10 enabled)
+        # EVM chains (10)
         "base", "ethereum", "polygon", "arbitrum", "optimism",
         "avalanche", "celo", "hyperevm", "unichain", "monad",
-        # bsc disabled: Binance-Peg USDC doesn't support ERC-3009
-        # SVM chains (2 total, 2 enabled)
+        # SVM chains (2)
         "solana", "fogo",
-        # NEAR (1 total, 1 enabled)
+        # NEAR (1)
         "near",
-        # Stellar (1 total, 1 enabled)
+        # Stellar (1)
         "stellar",
     ])
 

uvd_x402_sdk/networks/__init__.py

@@ -4,9 +4,9 @@ Network configurations for x402 payments.
 This module provides configuration for all supported blockchain networks,
 including USDC contract addresses, RPC URLs, and network-specific parameters.
 
-The SDK supports 15 mainnet networks out of the box:
-- 11 EVM chains: Base, Ethereum, Polygon, Arbitrum, Optimism, Avalanche,
-                 Celo, HyperEVM, Unichain, BSC (disabled), Monad
+The SDK supports 14 mainnet networks out of the box:
+- 10 EVM chains: Base, Ethereum, Polygon, Arbitrum, Optimism, Avalanche,
+                 Celo, HyperEVM, Unichain, Monad
 - 2 SVM chains: Solana, Fogo
 - 1 NEAR: NEAR Protocol
 - 1 Stellar: Stellar

uvd_x402_sdk/networks/base.py

@@ -48,7 +48,7 @@ class NetworkConfig:
         network_type: Type of network (EVM, SOLANA, NEAR, STELLAR)
         chain_id: EVM chain ID (0 for non-EVM networks)
         usdc_address: USDC contract/token address
-        usdc_decimals: Number of decimals for USDC (usually 6, BSC=18, Stellar=7)
+        usdc_decimals: Number of decimals for USDC (6 for EVM/SVM, 7 for Stellar)
         usdc_domain_name: EIP-712 domain name for USDC (EVM only)
         usdc_domain_version: EIP-712 domain version (EVM only)
         rpc_url: Default RPC endpoint
@@ -234,7 +234,6 @@ _NETWORK_TO_CAIP2 = {
     "hyperevm": "eip155:999",
     "unichain": "eip155:130",
     "monad": "eip155:143",
-    "bsc": "eip155:56",
     # SVM chains (solana:genesisHash first 32 chars)
     "solana": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
     "fogo": "solana:fogo",  # Placeholder - update when known

uvd_x402_sdk/networks/evm.py

@@ -7,7 +7,6 @@ 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
-- BSC USDC uses 18 decimals (not standard 6)
 """
 
 from uvd_x402_sdk.networks.base import (
@@ -164,22 +163,6 @@ MONAD = NetworkConfig(
     enabled=True,
 )
 
-# BNB Smart Chain (BSC)
-# NOTE: BSC USDC uses 18 decimals (not 6 like other chains)
-# NOTE: Binance-Peg USDC doesn't support ERC-3009 - DISABLED
-BSC = NetworkConfig(
-    name="bsc",
-    display_name="BNB Smart Chain",
-    network_type=NetworkType.EVM,
-    chain_id=56,
-    usdc_address="0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
-    usdc_decimals=18,  # Different from other chains!
-    usdc_domain_name="USD Coin",
-    usdc_domain_version="2",
-    rpc_url="https://binance.llamarpc.com",
-    enabled=False,  # Disabled: Binance-Peg USDC doesn't support ERC-3009
-)
-
 # =============================================================================
 # Register all EVM networks
 # =============================================================================
@@ -195,7 +178,6 @@ _EVM_NETWORKS = [
     HYPEREVM,
     UNICHAIN,
     MONAD,
-    BSC,
 ]
 
 for network in _EVM_NETWORKS:
@@ -228,8 +210,6 @@ def get_token_decimals(network_name: str) -> int:
         network_name: Network identifier
 
     Returns:
-        Number of decimals (6 for most chains, 18 for BSC)
+        Number of decimals (6 for all supported chains)
     """
-    if network_name.lower() == "bsc":
-        return 18
     return 6

uvd_x402_sdk/networks/solana.py

@@ -11,12 +11,17 @@ All SVM chains use the same payment flow:
 3. Facilitator is fee payer (user pays ZERO SOL/tokens)
 4. Facilitator co-signs and submits transaction
 
-Transaction Structure (REQUIRED by facilitator):
-- Instruction 0: SetComputeUnitLimit (units: 20,000)
-- Instruction 1: SetComputeUnitPrice (microLamports: 1)
-- Instruction 2: TransferChecked (USDC transfer)
-
-The facilitator validates this exact structure in src/chain/solana.rs.
+Transaction Structure (flexible, facilitator v1.9.4+):
+- SetComputeUnitLimit instruction (recommended: 20,000 units)
+- SetComputeUnitPrice instruction (recommended: 100,000 microLamports)
+- TransferChecked (USDC transfer)
+- Optional: CreateAssociatedTokenAccount (if recipient ATA doesn't exist)
+- Additional instructions may be added by wallets (e.g., Phantom memo)
+
+The facilitator scans for the transfer instruction rather than requiring
+fixed positions, allowing wallets like Phantom to add extra instructions.
+The full signed transaction is sent to the facilitator, which uses it
+exactly as signed (no reconstruction).
 """
 
 import base64
@@ -52,8 +57,8 @@ SOLANA = NetworkConfig(
         "ata_program_id": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL",
         # Default compute units for transfer
         "compute_units": 20000,
-        # Default priority fee in microLamports
-        "priority_fee_microlamports": 1,
+        # Priority fee in microLamports (100k for fast landing on mainnet)
+        "priority_fee_microlamports": 100_000,
         # Block explorer
         "explorer_url": "https://solscan.io",
         # Genesis hash (first 32 chars for CAIP-2)
@@ -82,8 +87,8 @@ FOGO = NetworkConfig(
         "ata_program_id": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL",
         # Default compute units for transfer
         "compute_units": 20000,
-        # Default priority fee in microLamports
-        "priority_fee_microlamports": 1,
+        # Priority fee in microLamports (100k for fast landing)
+        "priority_fee_microlamports": 100_000,
         # Block explorer (placeholder - update when available)
         "explorer_url": "https://explorer.fogo.nightly.app",
         # Network type identifier
@@ -165,11 +170,17 @@ def validate_svm_transaction_structure(transaction_base64: str) -> bool:
     """
     Validate that an SVM transaction has the correct structure for x402.
 
-    The facilitator expects:
-    - VersionedTransaction with exactly 3 instructions
-    - Instruction 0: SetComputeUnitLimit
-    - Instruction 1: SetComputeUnitPrice
-    - Instruction 2: TransferChecked (SPL token)
+    The facilitator expects (flexible order, Dec 2024+):
+    - VersionedTransaction with at least 3 instructions
+    - SetComputeUnitLimit instruction (any position)
+    - SetComputeUnitPrice instruction (any position)
+    - TransferChecked instruction (SPL token)
+    - Optional: CreateAssociatedTokenAccount instruction
+    - Optional: Additional instructions from wallet (e.g., Phantom memo)
+
+    Note: Wallets like Phantom may add extra instructions during signing.
+    The facilitator v1.9.4+ handles this by scanning for the transfer
+    instruction rather than requiring fixed positions.
 
     Args:
         transaction_base64: Base64-encoded serialized transaction
@@ -266,4 +277,6 @@ SET_COMPUTE_UNIT_PRICE_DISCRIMINATOR = 3
 
 # Default values for x402 transactions
 DEFAULT_COMPUTE_UNITS = 20000
-DEFAULT_PRIORITY_FEE_MICROLAMPORTS = 1
+# Use 100k microlamports/CU for fast landing on mainnet
+# Lower values (like 1) cause transactions to be deprioritized and time out
+DEFAULT_PRIORITY_FEE_MICROLAMPORTS = 100_000

{uvd_x402_sdk-0.2.0.dist-info → uvd_x402_sdk-0.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: uvd-x402-sdk
-Version: 0.2.0
+Version: 0.2.2
 Summary: Python SDK for integrating x402 payments via the Ultravioleta DAO facilitator
 Author-email: Ultravioleta DAO <dev@ultravioletadao.xyz>
 Project-URL: Homepage, https://github.com/UltravioletaDAO/uvd-x402-sdk-python
@@ -51,11 +51,11 @@ Requires-Dist: eth-account>=0.10.0; extra == "web3"
 
 Python SDK for integrating **x402 cryptocurrency payments** via the Ultravioleta DAO facilitator.
 
-Accept USDC payments across **15 blockchain networks** with a single integration. The SDK handles signature verification, on-chain settlement, and all the complexity of multi-chain payments.
+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.
 
 ## Features
 
-- **15 Networks**: EVM chains (Base, Ethereum, Polygon, etc.), SVM chains (Solana, Fogo), NEAR, and Stellar
+- **14 Networks**: EVM chains (Base, Ethereum, Polygon, etc.), SVM chains (Solana, Fogo), NEAR, and Stellar
 - **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
@@ -88,14 +88,11 @@ print(f"Paid by {result.payer_address}, tx: {result.transaction_hash}")
 | HyperEVM | EVM | 999 | `eip155:999` | Active |
 | Unichain | EVM | 130 | `eip155:130` | Active |
 | Monad | EVM | 143 | `eip155:143` | Active |
-| BSC | EVM | 56 | `eip155:56` | Disabled* |
 | Solana | SVM | - | `solana:5eykt...` | Active |
 | Fogo | SVM | - | `solana:fogo` | Active |
 | NEAR | NEAR | - | `near:mainnet` | Active |
 | Stellar | Stellar | - | `stellar:pubnet` | Active |
 
-*BSC's USDC doesn't support ERC-3009 TransferWithAuthorization
-
 ## Installation
 
 ```bash
@@ -689,7 +686,7 @@ The facilitator (https://facilitator.ultravioletadao.xyz) handles all on-chain i
 
 **"Unsupported network"**
 - Check that the network is in `supported_networks`
-- Verify the network is enabled (BSC is disabled by default)
+- Verify the network is enabled
 - For v2, ensure CAIP-2 format is correct
 
 **"Payment verification failed"**
@@ -756,6 +753,12 @@ MIT License - see LICENSE file.
 
 ## Changelog
 
+### v0.2.1 (2025-12-16)
+
+- Removed BSC network (doesn't support ERC-3009)
+- Added GitHub Actions workflow for PyPI publishing
+- Updated to 14 supported networks
+
 ### v0.2.0 (2025-12-15)
 
 - Added **NEAR Protocol** support with NEP-366 meta-transactions
@@ -766,11 +769,10 @@ MIT License - see LICENSE file.
 - Added CAIP-2 parsing utilities (`parse_caip2_network`, `to_caip2_network`)
 - Added `MultiPaymentConfig` for multi-network recipient configuration
 - Added `Payment402BuilderV2` for v2 response construction
-- Updated to 15 supported networks (14 enabled)
 
 ### v0.1.0 (2025-12-01)
 
 - Initial release
-- 14 network support (EVM, Solana, Stellar)
+- EVM, Solana, Stellar network support
 - Flask, FastAPI, Django, Lambda integrations
 - Full Pydantic models

{uvd_x402_sdk-0.2.0.dist-info → uvd_x402_sdk-0.2.2.dist-info}/RECORD

@@ -1,6 +1,6 @@
-uvd_x402_sdk/__init__.py,sha256=b-k8ngOXA6hEeHKzf7O5Mhb2Y8DZJhoYuaWKk1whKeo,4690
+uvd_x402_sdk/__init__.py,sha256=Z_q46CqoCRpvkm_czDHeGHSkJKczlGfaS0JYjfvYzeM,4662
 uvd_x402_sdk/client.py,sha256=oWPnm7uKeIrIx4hD_NCopDDDaKU0dP8E8SGHvzwByew,18916
-uvd_x402_sdk/config.py,sha256=oTVhJw1G0D0JHBzu6iw6rBzBtICvWhptPuvX6SzM5KI,9052
+uvd_x402_sdk/config.py,sha256=UEQC9Cnk2Q7MLPebqjog7ucTyMJkGw8-OhL7v8JEJww,8892
 uvd_x402_sdk/decorators.py,sha256=dojuSHXdJ029aMC3IVTqQtZAy_Z9FJlY-Lm23qtlJUw,10092
 uvd_x402_sdk/exceptions.py,sha256=LltNzpnwV0FLCYPb-gQgvlZTueudiFRE2x8i5sv8cFk,6781
 uvd_x402_sdk/models.py,sha256=LBQErb5Po27BOYyWgyzQhPzx_1TKA3zCwbjuB3MevIE,14679
@@ -10,14 +10,14 @@ uvd_x402_sdk/integrations/django_integration.py,sha256=0NwUncWuTF9ejeeZEP54lgfZY
 uvd_x402_sdk/integrations/fastapi_integration.py,sha256=TfXFjtDSJ9nTCKElLJj7joxAAhduiauvl97lEhFH2tw,10535
 uvd_x402_sdk/integrations/flask_integration.py,sha256=8bV8DpiXNJyhS8_yrweaPCqxBke2Tkbybb_dGPiC94M,9084
 uvd_x402_sdk/integrations/lambda_integration.py,sha256=B6dFvxpdhgviiaZf7qFK--LMa8Fh7ITgEhLRp6iwyqE,10504
-uvd_x402_sdk/networks/__init__.py,sha256=0TMPws5C8jLChFYxW5TVH8vjTc1S-TcZZ9HR4AnlQ1U,1478
-uvd_x402_sdk/networks/base.py,sha256=4sIepZTqKzxnNW0oGi1ENkUL8IdEi9vdvqoc5OMifNk,10289
-uvd_x402_sdk/networks/evm.py,sha256=vWFuJBNMYrA4gJWA6xfkInfR3QhVwLL5Lpi7yS1HNwA,6568
+uvd_x402_sdk/networks/__init__.py,sha256=mBspQT3gtN6qRCmk-2Qa1I70d9BURk6po2OCCJE3LsA,1462
+uvd_x402_sdk/networks/base.py,sha256=HU5ca8Lp6x5QHEZxtHUkp1qM7F1t84kgxCAROyEOMaI,10264
+uvd_x402_sdk/networks/evm.py,sha256=hSAkQAu537lQWWZn2iO_o33N5Qmqe7ZtzbghjP42N7Y,5866
 uvd_x402_sdk/networks/near.py,sha256=R88fxEDE0W6buUrs_Hlc1LyJ4OSXTZlmCf393-CxjAg,12005
-uvd_x402_sdk/networks/solana.py,sha256=sY3gkYGvmC3NSj3bjl2fCWvbl_0wVIIlte4BvdRkWKE,8702
+uvd_x402_sdk/networks/solana.py,sha256=pWdwUe3N08bCu75CUn_8UzjMFfygMPeNhB1Hf0J2vac,9633
 uvd_x402_sdk/networks/stellar.py,sha256=luXKdqUwJHRa8N0hfOoMEpny3u1PS7nNtU6c8VGqpIY,3663
-uvd_x402_sdk-0.2.0.dist-info/LICENSE,sha256=_FxTbuGgcgrco5ZjC_8o-NhyoPGYuF8B86m02LavkCA,1094
-uvd_x402_sdk-0.2.0.dist-info/METADATA,sha256=zn8s_lM8-sjf36hR_UI1r-9PULelXn3TC-ihZkenoUI,22706
-uvd_x402_sdk-0.2.0.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-uvd_x402_sdk-0.2.0.dist-info/top_level.txt,sha256=Exyjj_Kl7CDAGFMi72lT9oFPOYiRNZb3l8tr906mMmc,13
-uvd_x402_sdk-0.2.0.dist-info/RECORD,,
+uvd_x402_sdk-0.2.2.dist-info/LICENSE,sha256=_FxTbuGgcgrco5ZjC_8o-NhyoPGYuF8B86m02LavkCA,1094
+uvd_x402_sdk-0.2.2.dist-info/METADATA,sha256=tofqPIOfpHE-ZWOvayGvD1fXJsqFJKLPtlEUTYwbAr0,22679
+uvd_x402_sdk-0.2.2.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
+uvd_x402_sdk-0.2.2.dist-info/top_level.txt,sha256=Exyjj_Kl7CDAGFMi72lT9oFPOYiRNZb3l8tr906mMmc,13
+uvd_x402_sdk-0.2.2.dist-info/RECORD,,