uvd-x402-sdk 0.5.5__tar.gz → 0.5.6__tar.gz

{uvd_x402_sdk-0.5.5/src/uvd_x402_sdk.egg-info → uvd_x402_sdk-0.5.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: uvd-x402-sdk
-Version: 0.5.5
+Version: 0.5.6
 Summary: Python SDK for x402 payments - gasless crypto payments across 18 blockchains with multi-stablecoin support (USDC, EURC, AUSD, PYUSD, USDT)
 Author-email: Ultravioleta DAO <dev@ultravioletadao.xyz>
 Project-URL: Homepage, https://github.com/UltravioletaDAO/uvd-x402-sdk-python

{uvd_x402_sdk-0.5.5 → uvd_x402_sdk-0.5.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "uvd-x402-sdk"
-version = "0.5.5"
+version = "0.5.6"
 description = "Python SDK for x402 payments - gasless crypto payments across 18 blockchains with multi-stablecoin support (USDC, EURC, AUSD, PYUSD, USDT)"
 readme = "README.md"
 requires-python = ">=3.9"

{uvd_x402_sdk-0.5.5 → uvd_x402_sdk-0.5.6}/src/uvd_x402_sdk/__init__.py

@@ -42,7 +42,7 @@ Supported Networks (18 total):
 - Sui (2): Sui mainnet, Sui testnet
 """
 
-__version__ = "0.5.5"
+__version__ = "0.5.6"
 __author__ = "Ultravioleta DAO"
 
 from uvd_x402_sdk.client import X402Client
@@ -67,6 +67,7 @@ from uvd_x402_sdk.models import (
     SolanaPayloadContent,  # Alias for backward compatibility
     NEARPayloadContent,
     StellarPayloadContent,
+    SuiPayloadContent,
     # Requirements models (v1)
     PaymentRequirements,
     # Requirements models (v2)
@@ -172,6 +173,7 @@ __all__ = [
     "SolanaPayloadContent",
     "NEARPayloadContent",
     "StellarPayloadContent",
+    "SuiPayloadContent",
     # Requirements models
     "PaymentRequirements",
     "PaymentOption",

{uvd_x402_sdk-0.5.5 → uvd_x402_sdk-0.5.6}/src/uvd_x402_sdk/models.py

@@ -114,12 +114,59 @@ class StellarPayloadContent(BaseModel):
         populate_by_name = True
 
 
+class SuiPayloadContent(BaseModel):
+    """
+    Sui payment payload using sponsored transactions.
+
+    Contains a user-signed programmable transaction that the facilitator sponsors.
+    The facilitator pays gas (in SUI), user pays ZERO SUI.
+
+    Transaction Flow:
+    1. User creates a programmable transaction for token transfer
+    2. User signs the transaction (setSender + setGasOwner for sponsorship)
+    3. Transaction is sent to facilitator with sender signature
+    4. Facilitator adds sponsor signature and pays gas
+    5. Facilitator submits to Sui network
+
+    Required Fields (all mandatory for facilitator deserialization):
+    - transactionBytes: BCS-encoded TransactionData
+    - senderSignature: User's Ed25519 or Secp256k1 signature
+    - from: Sender Sui address (0x + 64 hex)
+    - to: Recipient Sui address (0x + 64 hex)
+    - amount: Transfer amount in base units
+    - coinObjectId: The Sui coin object ID used for the transfer (CRITICAL!)
+    """
+
+    transactionBytes: str = Field(
+        ..., description="Base64-encoded BCS serialized TransactionData"
+    )
+    senderSignature: str = Field(
+        ..., description="Base64-encoded user signature (Ed25519 or Secp256k1)"
+    )
+    from_address: str = Field(
+        ..., alias="from", description="Sender Sui address (0x + 64 hex chars)"
+    )
+    to: str = Field(
+        ..., description="Recipient Sui address (0x + 64 hex chars)"
+    )
+    amount: str = Field(
+        ..., description="Amount in token base units (e.g., '1000000' for 1 USDC)"
+    )
+    coinObjectId: str = Field(
+        ..., description="Sui coin object ID used for the transfer (REQUIRED by facilitator)"
+    )
+
+    class Config:
+        populate_by_name = True
+
+
 # Union type for all payload contents
 PayloadContent = Union[
     EVMPayloadContent,
     SVMPayloadContent,
     NEARPayloadContent,
     StellarPayloadContent,
+    SuiPayloadContent,
 ]
 
 
@@ -196,6 +243,10 @@ class PaymentPayload(BaseModel):
         """Parse payload as Stellar format."""
         return StellarPayloadContent(**self.payload)
 
+    def get_sui_payload(self) -> SuiPayloadContent:
+        """Parse payload as Sui format (sponsored transaction)."""
+        return SuiPayloadContent(**self.payload)
+
 
 class PaymentRequirements(BaseModel):
     """

{uvd_x402_sdk-0.5.5 → uvd_x402_sdk-0.5.6}/src/uvd_x402_sdk/networks/__init__.py

@@ -4,18 +4,21 @@ 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 16 mainnet networks out of the box:
+The SDK supports 17 mainnet networks across 6 blockchain families:
 - 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
-- 2 Algorand: Algorand mainnet and testnet
+- 1 Algorand: Algorand
+- 1 Sui: Sui (sponsored transactions)
 
-Multi-token support (EVM chains only):
++ 15 testnets for development and testing.
+
+Multi-token support:
 - USDC: All chains
 - EURC: Ethereum, Base, Avalanche
-- AUSD: Ethereum, Arbitrum, Avalanche, Polygon, Monad
+- AUSD: Ethereum, Arbitrum, Avalanche, Polygon, Monad, Sui
 - PYUSD: Ethereum
 
 You can register custom networks using `register_network()`.

{uvd_x402_sdk-0.5.5 → uvd_x402_sdk-0.5.6}/src/uvd_x402_sdk/networks/sui.py

@@ -259,6 +259,7 @@ def validate_sui_payload(payload: Dict[str, Any]) -> bool:
     - from: Sender address
     - to: Recipient address
     - amount: Transfer amount (string)
+    - coinObjectId: Sui coin object ID used for transfer (REQUIRED by facilitator)
 
     Args:
         payload: Payload dictionary from x402 payment
@@ -266,7 +267,8 @@ def validate_sui_payload(payload: Dict[str, Any]) -> bool:
     Returns:
         True if valid, raises ValueError if invalid
     """
-    required_fields = ["transactionBytes", "senderSignature", "from", "to", "amount"]
+    # CRITICAL: coinObjectId is REQUIRED by the facilitator for deserialization
+    required_fields = ["transactionBytes", "senderSignature", "from", "to", "amount", "coinObjectId"]
     for field in required_fields:
         if field not in payload:
             raise ValueError(f"Sui payload missing '{field}' field")
@@ -303,6 +305,11 @@ def validate_sui_payload(payload: Dict[str, Any]) -> bool:
     except (ValueError, TypeError) as e:
         raise ValueError(f"Invalid amount: {e}")
 
+    # Validate coinObjectId is a valid Sui object ID (66 chars: 0x + 64 hex)
+    coin_object_id = payload["coinObjectId"]
+    if not is_valid_sui_address(coin_object_id):
+        raise ValueError(f"Invalid coinObjectId: {coin_object_id} (expected 0x + 64 hex chars)")
+
     return True
 
 

{uvd_x402_sdk-0.5.5 → uvd_x402_sdk-0.5.6/src/uvd_x402_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: uvd-x402-sdk
-Version: 0.5.5
+Version: 0.5.6
 Summary: Python SDK for x402 payments - gasless crypto payments across 18 blockchains with multi-stablecoin support (USDC, EURC, AUSD, PYUSD, USDT)
 Author-email: Ultravioleta DAO <dev@ultravioletadao.xyz>
 Project-URL: Homepage, https://github.com/UltravioletaDAO/uvd-x402-sdk-python