uvd-x402-sdk 0.5.5__py3-none-any.whl → 0.5.6__py3-none-any.whl

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/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/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/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.dist-info → uvd_x402_sdk-0.5.6.dist-info}/METADATA

@@ -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.dist-info → uvd_x402_sdk-0.5.6.dist-info}/RECORD

@@ -1,26 +1,26 @@
-uvd_x402_sdk/__init__.py,sha256=mn1GGLPDTxhjVvgJqp04z8lAnGdGoElPM0b64LAGBFk,6577
+uvd_x402_sdk/__init__.py,sha256=sloZp8MsMuj1ocHAUcbw-xGoaOLU0Ns29HXwnBIJ6oQ,6625
 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
 uvd_x402_sdk/exceptions.py,sha256=kzYNHFn41dSOZ5HaBDrbf4tdwJYQs1YcU9YybTrGZxo,6527
 uvd_x402_sdk/facilitator.py,sha256=OgmB-4GDu9HvG-C6DprMd4h-3neSwsxVuC5-NffVwVI,12776
-uvd_x402_sdk/models.py,sha256=nfA8Ak0pyIveiNpstjqxnQ6-aPQ8TRJzJq2LJwlJc-E,14282
+uvd_x402_sdk/models.py,sha256=J5qL8CFCrc2UOpnKILi3FXJLNFLDOO0pclrDK4BaLEA,16190
 uvd_x402_sdk/response.py,sha256=4wxH4kWg1F8pokKEbN1kDvDF55cQxmQUN88HTxXht8g,13608
 uvd_x402_sdk/integrations/__init__.py,sha256=Hq1Y0YIMYWBAtmbOLXDC40KQuCrbSpQVjAqEsbjH56s,1912
 uvd_x402_sdk/integrations/django_integration.py,sha256=e3xaV1Yz3HHI7zZBNcyTmV0JsHImkiIEv6PxDvqv0ok,8234
 uvd_x402_sdk/integrations/fastapi_integration.py,sha256=j5h1IJwFLBBoWov7ANLCFaxeCa8pugn-XU9ibrzIL0Y,10205
 uvd_x402_sdk/integrations/flask_integration.py,sha256=0iQKO5-WRxE76Pv-1jEl4lYhjCLmq_R-jxR5g9xIcKw,8825
 uvd_x402_sdk/integrations/lambda_integration.py,sha256=nRf4o3nS6Syx-d5P0kEhz66y7jb_S4w-mwaIazgiA9c,10184
-uvd_x402_sdk/networks/__init__.py,sha256=3cGi6v9mVa1NyDasB2JS1AdsRxidr8za9qGYg06kW_M,2097
+uvd_x402_sdk/networks/__init__.py,sha256=Ky_PZvBMgpuP6Z5JgIM8LevfxYp4r9JK5dnQ4Xo5KuM,2160
 uvd_x402_sdk/networks/algorand.py,sha256=kyet3mu8Uf454QAM6PHQ1FWuQetpPQ7D0jtj7dfojsc,19433
 uvd_x402_sdk/networks/base.py,sha256=P-wTw3LnLZnd_Gv2NPsdcCZZMQb_yDY_NdEMvnstRhY,15421
 uvd_x402_sdk/networks/evm.py,sha256=4IbeaMH2I1c9DYCijghys0qYNeL2Nl92IMKLwq-b0Zg,10065
 uvd_x402_sdk/networks/near.py,sha256=HMMWJr-Jckj3YQTbSXkavlJWZB7ZV8OQX0bq8DuVxIg,12990
 uvd_x402_sdk/networks/solana.py,sha256=GVUeh0O2W6f8Vbgoom2UQSGI8joZV68Pnpzhh87Bnqg,13640
 uvd_x402_sdk/networks/stellar.py,sha256=ZuF-crx41N9MxSsgf2kAy88fsM-xvDyXY_D2ND6M71Y,5142
-uvd_x402_sdk/networks/sui.py,sha256=vADFOC6Q8GcUWCjnx4f9C-uyegmR9uPlUiFRTQv_qJc,12578
-uvd_x402_sdk-0.5.5.dist-info/LICENSE,sha256=OcLzB_iSgMbvk7b0dlyvleY_IbL2WUaPxvn1CHw2uAc,1073
-uvd_x402_sdk-0.5.5.dist-info/METADATA,sha256=lyMKCBnLve4xUhk1MQQMEwvBZzPLQ1AX7wTKNgp1Jys,36537
-uvd_x402_sdk-0.5.5.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-uvd_x402_sdk-0.5.5.dist-info/top_level.txt,sha256=Exyjj_Kl7CDAGFMi72lT9oFPOYiRNZb3l8tr906mMmc,13
-uvd_x402_sdk-0.5.5.dist-info/RECORD,,
+uvd_x402_sdk/networks/sui.py,sha256=PNKTLIY9q3Ku_s5ZIePLA9rhhZkMwwIgToUQ4Wzb8bw,13026
+uvd_x402_sdk-0.5.6.dist-info/LICENSE,sha256=OcLzB_iSgMbvk7b0dlyvleY_IbL2WUaPxvn1CHw2uAc,1073
+uvd_x402_sdk-0.5.6.dist-info/METADATA,sha256=3PwYHg6CeD7f1bJl-6_s7AjCAM78g57ihHU7ta3zLKw,36537
+uvd_x402_sdk-0.5.6.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
+uvd_x402_sdk-0.5.6.dist-info/top_level.txt,sha256=Exyjj_Kl7CDAGFMi72lT9oFPOYiRNZb3l8tr906mMmc,13
+uvd_x402_sdk-0.5.6.dist-info/RECORD,,