uvd-x402-sdk 0.2.1__py3-none-any.whl → 0.2.2__py3-none-any.whl

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

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

@@ -1,4 +1,4 @@
-uvd_x402_sdk/__init__.py,sha256=_L-Fm3bmc6rpGk2ekCr4s5rDww2sQOBSCgpZYIqV-yM,4662
+uvd_x402_sdk/__init__.py,sha256=Z_q46CqoCRpvkm_czDHeGHSkJKczlGfaS0JYjfvYzeM,4662
 uvd_x402_sdk/client.py,sha256=oWPnm7uKeIrIx4hD_NCopDDDaKU0dP8E8SGHvzwByew,18916
 uvd_x402_sdk/config.py,sha256=UEQC9Cnk2Q7MLPebqjog7ucTyMJkGw8-OhL7v8JEJww,8892
 uvd_x402_sdk/decorators.py,sha256=dojuSHXdJ029aMC3IVTqQtZAy_Z9FJlY-Lm23qtlJUw,10092
@@ -14,10 +14,10 @@ uvd_x402_sdk/networks/__init__.py,sha256=mBspQT3gtN6qRCmk-2Qa1I70d9BURk6po2OCCJE
 uvd_x402_sdk/networks/base.py,sha256=HU5ca8Lp6x5QHEZxtHUkp1qM7F1t84kgxCAROyEOMaI,10264
 uvd_x402_sdk/networks/evm.py,sha256=hSAkQAu537lQWWZn2iO_o33N5Qmqe7ZtzbghjP42N7Y,5866
 uvd_x402_sdk/networks/near.py,sha256=R88fxEDE0W6buUrs_Hlc1LyJ4OSXTZlmCf393-CxjAg,12005
-uvd_x402_sdk/networks/solana.py,sha256=sY3gkYGvmC3NSj3bjl2fCWvbl_0wVIIlte4BvdRkWKE,8702
+uvd_x402_sdk/networks/solana.py,sha256=pWdwUe3N08bCu75CUn_8UzjMFfygMPeNhB1Hf0J2vac,9633
 uvd_x402_sdk/networks/stellar.py,sha256=luXKdqUwJHRa8N0hfOoMEpny3u1PS7nNtU6c8VGqpIY,3663
-uvd_x402_sdk-0.2.1.dist-info/LICENSE,sha256=_FxTbuGgcgrco5ZjC_8o-NhyoPGYuF8B86m02LavkCA,1094
-uvd_x402_sdk-0.2.1.dist-info/METADATA,sha256=b4-YsKLDEr6c6Bn5Idq1zvTaQzE1bM4EY34K1-gB4JY,22679
-uvd_x402_sdk-0.2.1.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-uvd_x402_sdk-0.2.1.dist-info/top_level.txt,sha256=Exyjj_Kl7CDAGFMi72lT9oFPOYiRNZb3l8tr906mMmc,13
-uvd_x402_sdk-0.2.1.dist-info/RECORD,,
+uvd_x402_sdk-0.2.2.dist-info/LICENSE,sha256=_FxTbuGgcgrco5ZjC_8o-NhyoPGYuF8B86m02LavkCA,1094
+uvd_x402_sdk-0.2.2.dist-info/METADATA,sha256=tofqPIOfpHE-ZWOvayGvD1fXJsqFJKLPtlEUTYwbAr0,22679
+uvd_x402_sdk-0.2.2.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
+uvd_x402_sdk-0.2.2.dist-info/top_level.txt,sha256=Exyjj_Kl7CDAGFMi72lT9oFPOYiRNZb3l8tr906mMmc,13
+uvd_x402_sdk-0.2.2.dist-info/RECORD,,