uvd-x402-sdk 0.2.0__tar.gz → 0.2.2__tar.gz

{uvd_x402_sdk-0.2.0/src/uvd_x402_sdk.egg-info → uvd_x402_sdk-0.2.2}/PKG-INFO

@@ -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: httpx>=0.24.0; extra == "dev"
 
 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 → uvd_x402_sdk-0.2.2}/README.md

@@ -2,11 +2,11 @@
 
 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
@@ -39,14 +39,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
@@ -640,7 +637,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"**
@@ -707,6 +704,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
@@ -717,11 +720,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 → uvd_x402_sdk-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "uvd-x402-sdk"
-version = "0.2.0"
+version = "0.2.2"
 description = "Python SDK for integrating x402 payments via the Ultravioleta DAO facilitator"
 readme = "README.md"
 requires-python = ">=3.9"

{uvd_x402_sdk-0.2.0 → uvd_x402_sdk-0.2.2}/src/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-0.2.0 → uvd_x402_sdk-0.2.2}/src/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-0.2.0 → uvd_x402_sdk-0.2.2}/src/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-0.2.0 → uvd_x402_sdk-0.2.2}/src/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-0.2.0 → uvd_x402_sdk-0.2.2}/src/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-0.2.0 → uvd_x402_sdk-0.2.2}/src/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 → uvd_x402_sdk-0.2.2/src/uvd_x402_sdk.egg-info}/PKG-INFO

@@ -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: httpx>=0.24.0; extra == "dev"
 
 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