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

{uvd_x402_sdk-0.5.4/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.4
+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.4 → 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.4"
+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.4 → 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.4"
+__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.4 → 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.4 → 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.4 → uvd_x402_sdk-0.5.6}/src/uvd_x402_sdk/networks/sui.py

@@ -7,6 +7,7 @@ This module supports Sui blockchain for x402 payments using sponsored transactio
 
 Supported Tokens:
 - USDC: Native Sui USDC
+- AUSD: Agora USD (mainnet only)
 
 All Sui chains use the same payment flow:
 1. User creates a programmable transaction for token transfer
@@ -59,6 +60,9 @@ except ImportError:
 SUI_USDC_COIN_TYPE_MAINNET = "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC"
 SUI_USDC_COIN_TYPE_TESTNET = "0xa1ec7fc00a6f40db9693ad1415d0c193ad3906494428cf252621037bd7117e29::usdc::USDC"
 
+# AUSD (Agora USD) coin types on Sui
+SUI_AUSD_COIN_TYPE_MAINNET = "0x2053d08c1e2bd02791056171aab0fd12bd7cd7efad2ab8f6b9c8902f14df2ff2::ausd::AUSD"
+
 # Sui Mainnet
 SUI = NetworkConfig(
     name="sui",
@@ -78,10 +82,18 @@ SUI = NetworkConfig(
             name="",  # Not applicable for Sui
             version="",
         ),
+        "ausd": TokenConfig(
+            address=SUI_AUSD_COIN_TYPE_MAINNET,
+            decimals=6,
+            name="",  # Not applicable for Sui
+            version="",
+        ),
     },
     extra_config={
         # Coin type for USDC (package::module::type format)
         "usdc_coin_type": SUI_USDC_COIN_TYPE_MAINNET,
+        # Coin type for AUSD (Agora USD)
+        "ausd_coin_type": SUI_AUSD_COIN_TYPE_MAINNET,
         # Fee payer (facilitator) address
         "fee_payer": SUI_FEE_PAYER_MAINNET,
         # Block explorer
@@ -247,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
@@ -254,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")
@@ -291,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
 
 
@@ -345,6 +364,31 @@ def get_sui_usdc_coin_type(network_name: str = "sui") -> str:
     return SUI_USDC_COIN_TYPE_MAINNET
 
 
+def get_sui_ausd_coin_type(network_name: str = "sui") -> Optional[str]:
+    """
+    Get the AUSD (Agora USD) coin type for a Sui network.
+
+    Note: AUSD is only available on Sui mainnet.
+
+    Args:
+        network_name: Network name ('sui', 'sui-mainnet', 'sui-testnet')
+
+    Returns:
+        AUSD coin type in package::module::type format, or None if not available
+
+    Example:
+        >>> get_sui_ausd_coin_type("sui")
+        '0x2053d08c1e2bd02791056171aab0fd12bd7cd7efad2ab8f6b9c8902f14df2ff2::ausd::AUSD'
+        >>> get_sui_ausd_coin_type("sui-testnet")
+        None
+    """
+    network_lower = network_name.lower()
+    # AUSD is only available on Sui mainnet
+    if "testnet" in network_lower:
+        return None
+    return SUI_AUSD_COIN_TYPE_MAINNET
+
+
 # =============================================================================
 # Sui Transaction Building Utilities (for reference)
 # =============================================================================

{uvd_x402_sdk-0.5.4 → 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.4
+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