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

{uvd_x402_sdk-0.2.1/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.1
+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

{uvd_x402_sdk-0.2.1 → 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.1"
+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.1 → uvd_x402_sdk-0.2.2}/src/uvd_x402_sdk/__init__.py

@@ -37,7 +37,7 @@ Supported Networks (14 total):
 - Stellar (1): Stellar
 """
 
-__version__ = "0.2.1"
+__version__ = "0.2.2"
 __author__ = "Ultravioleta DAO"
 
 from uvd_x402_sdk.client import X402Client

{uvd_x402_sdk-0.2.1 → 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.1 → 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.1
+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