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

{uvd_x402_sdk-0.5.1/src/uvd_x402_sdk.egg-info → uvd_x402_sdk-0.5.4}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.1
 Name: uvd-x402-sdk
-Version: 0.5.1
-Summary: Python SDK for x402 payments - gasless crypto payments across 16 blockchains with multi-stablecoin support (USDC, EURC, AUSD, PYUSD, USDT)
+Version: 0.5.4
+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
 Project-URL: Documentation, https://docs.ultravioletadao.xyz/x402-sdk
 Project-URL: Repository, https://github.com/UltravioletaDAO/uvd-x402-sdk-python
 Project-URL: Issues, https://github.com/UltravioletaDAO/uvd-x402-sdk-python/issues
-Keywords: x402,payments,crypto,usdc,eurc,stablecoin,web3,evm,solana,near,stellar,algorand,facilitator,gasless,eip-712,eip-3009
+Keywords: x402,payments,crypto,usdc,eurc,stablecoin,web3,evm,solana,near,stellar,algorand,sui,facilitator,gasless,eip-712,eip-3009
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -53,11 +53,13 @@ Requires-Dist: httpx>=0.24.0; extra == "dev"
 
 Python SDK for integrating **x402 cryptocurrency payments** via the Ultravioleta DAO facilitator.
 
-Accept **gasless stablecoin payments** across **14 blockchain networks** with a single integration. The SDK handles signature verification, on-chain settlement, and all the complexity of multi-chain payments.
+Accept **gasless stablecoin payments** across **16 blockchain networks** with a single integration. The SDK handles signature verification, on-chain settlement, and all the complexity of multi-chain payments.
+
+**New in v0.5.0+**: The SDK now includes embedded facilitator addresses - no manual configuration needed!
 
 ## Features
 
-- **14 Networks**: EVM chains (Base, Ethereum, Polygon, etc.), SVM chains (Solana, Fogo), NEAR, and Stellar
+- **16 Networks**: EVM chains (Base, Ethereum, Polygon, etc.), SVM chains (Solana, Fogo), NEAR, Stellar, and Algorand
 - **5 Stablecoins**: USDC, EURC, AUSD, PYUSD, USDT (EVM chains)
 - **x402 v1 & v2**: Full support for both protocol versions with auto-detection
 - **Framework Integrations**: Flask, FastAPI, Django, AWS Lambda
@@ -95,6 +97,8 @@ print(f"Paid by {result.payer_address}, tx: {result.transaction_hash}")
 | Fogo | SVM | - | `solana:fogo` | Active |
 | NEAR | NEAR | - | `near:mainnet` | Active |
 | Stellar | Stellar | - | `stellar:pubnet` | Active |
+| Algorand | Algorand | - | `algorand:mainnet` | Active |
+| Algorand Testnet | Algorand | - | `algorand:testnet` | Active |
 
 ### Supported Tokens (EVM Chains)
 
@@ -117,6 +121,7 @@ pip install uvd-x402-sdk[flask]      # Flask integration
 pip install uvd-x402-sdk[fastapi]    # FastAPI/Starlette integration
 pip install uvd-x402-sdk[django]     # Django integration
 pip install uvd-x402-sdk[aws]        # AWS Lambda helpers
+pip install uvd-x402-sdk[algorand]   # Algorand atomic group helpers
 
 # All integrations
 pip install uvd-x402-sdk[all]
@@ -375,6 +380,65 @@ from uvd_x402_sdk.networks.near import validate_near_payload
 validate_near_payload(payload.payload)  # Raises ValueError if invalid
 ```
 
+### Algorand
+
+Algorand uses atomic groups with ASA (Algorand Standard Assets) transfers.
+
+```python
+from uvd_x402_sdk import X402Client, X402Config
+
+config = X402Config(
+    recipient_algorand="NCDSNUQ2QLXDMJXRALAW4CRUSSKG4IS37MVOFDQQPC45SE4EBZO42U6ZX4",
+    supported_networks=["algorand"],
+)
+
+client = X402Client(config=config)
+result = client.process_payment(x_payment_header, Decimal("1.00"))
+
+# Algorand uses atomic groups: [fee_tx, payment_tx]
+from uvd_x402_sdk.networks.algorand import (
+    validate_algorand_payload,
+    get_algorand_fee_payer,
+    build_atomic_group,
+)
+
+# Get the facilitator fee payer address
+fee_payer = get_algorand_fee_payer("algorand")
+print(f"Fee payer: {fee_payer}")  # KIMS5H6Q...
+
+# Validate payload structure
+payload = client.extract_payload(x_payment_header)
+validate_algorand_payload(payload.payload)  # Raises ValueError if invalid
+```
+
+#### Building Algorand Payments (requires `pip install uvd-x402-sdk[algorand]`)
+
+```python
+from uvd_x402_sdk.networks.algorand import (
+    build_atomic_group,
+    build_x402_payment_request,
+    get_algorand_fee_payer,
+)
+from algosdk.v2client import algod
+
+# Connect to Algorand node
+client = algod.AlgodClient("", "https://mainnet-api.algonode.cloud")
+
+# Build atomic group
+payload = build_atomic_group(
+    sender_address="YOUR_ADDRESS...",
+    recipient_address="MERCHANT_ADDRESS...",
+    amount=1000000,  # 1 USDC (6 decimals)
+    asset_id=31566704,  # USDC ASA ID on mainnet
+    facilitator_address=get_algorand_fee_payer("algorand"),
+    sign_transaction=lambda txn: txn.sign(private_key),
+    algod_client=client,
+)
+
+# Build x402 payment request
+request = build_x402_payment_request(payload, network="algorand")
+```
+
 ---
 
 ## x402 v1 vs v2
@@ -593,6 +657,94 @@ config = X402Config.from_env()
 
 ---
 
+## Facilitator Addresses
+
+The SDK includes all facilitator addresses as embedded constants. You don't need to configure them manually.
+
+### Fee Payer Addresses (Non-EVM)
+
+Non-EVM chains require a fee payer address for gasless transactions:
+
+```python
+from uvd_x402_sdk import (
+    # Algorand
+    ALGORAND_FEE_PAYER_MAINNET,  # KIMS5H6QLCUDL65L5UBTOXDPWLMTS7N3AAC3I6B2NCONEI5QIVK7LH2C2I
+    ALGORAND_FEE_PAYER_TESTNET,  # 5DPPDQNYUPCTXRZWRYSF3WPYU6RKAUR25F3YG4EKXQRHV5AUAI62H5GXL4
+
+    # Solana
+    SOLANA_FEE_PAYER_MAINNET,    # F742C4VfFLQ9zRQyithoj5229ZgtX2WqKCSFKgH2EThq
+    SOLANA_FEE_PAYER_DEVNET,     # 6xNPewUdKRbEZDReQdpyfNUdgNg8QRc8Mt263T5GZSRv
+
+    # Fogo
+    FOGO_FEE_PAYER_MAINNET,      # F742C4VfFLQ9zRQyithoj5229ZgtX2WqKCSFKgH2EThq
+    FOGO_FEE_PAYER_TESTNET,      # 6xNPewUdKRbEZDReQdpyfNUdgNg8QRc8Mt263T5GZSRv
+
+    # NEAR
+    NEAR_FEE_PAYER_MAINNET,      # uvd-facilitator.near
+    NEAR_FEE_PAYER_TESTNET,      # uvd-facilitator.testnet
+
+    # Stellar
+    STELLAR_FEE_PAYER_MAINNET,   # GCHPGXJT2WFFRFCA5TV4G4E3PMMXLNIDUH27PKDYA4QJ2XGYZWGFZNHB
+    STELLAR_FEE_PAYER_TESTNET,   # GBBFZMLUJEZVI32EN4XA2KPP445XIBTMTRBLYWFIL556RDTHS2OWFQ2Z
+
+    # Helper function
+    get_fee_payer,               # Get fee payer for any network
+)
+
+# Get fee payer for any network
+fee_payer = get_fee_payer("algorand")  # Returns KIMS5H6Q...
+fee_payer = get_fee_payer("solana")    # Returns F742C4VfF...
+fee_payer = get_fee_payer("base")      # Returns None (EVM doesn't need fee payer)
+```
+
+### EVM Facilitator Addresses
+
+EVM chains use EIP-3009 transferWithAuthorization (gasless by design), but the facilitator wallet addresses are available for reference:
+
+```python
+from uvd_x402_sdk import (
+    EVM_FACILITATOR_MAINNET,  # 0x103040545AC5031A11E8C03dd11324C7333a13C7
+    EVM_FACILITATOR_TESTNET,  # 0x34033041a5944B8F10f8E4D8496Bfb84f1A293A8
+)
+```
+
+### Helper Functions
+
+```python
+from uvd_x402_sdk import (
+    get_fee_payer,           # Get fee payer address for a network
+    requires_fee_payer,      # Check if network needs fee payer
+    get_all_fee_payers,      # Get all registered fee payers
+    build_payment_info,      # Build payment info with auto feePayer
+    DEFAULT_FACILITATOR_URL, # https://facilitator.ultravioletadao.xyz
+)
+
+# Check if network needs fee payer
+requires_fee_payer("algorand")  # True
+requires_fee_payer("base")      # False
+
+# Build payment info with automatic fee payer
+info = build_payment_info(
+    network="algorand",
+    pay_to="MERCHANT_ADDRESS...",
+    max_amount_required="1000000",
+    description="API access"
+)
+# info = {
+#     'network': 'algorand',
+#     'payTo': 'MERCHANT_ADDRESS...',
+#     'maxAmountRequired': '1000000',
+#     'description': 'API access',
+#     'asset': '31566704',
+#     'extra': {
+#         'token': 'usdc',
+#         'feePayer': 'KIMS5H6QLCUDL65L5UBTOXDPWLMTS7N3AAC3I6B2NCONEI5QIVK7LH2C2I'
+#     }
+# }
+```
+
+---
+
 ## Registering Custom Networks
 
 ```python
@@ -823,6 +975,7 @@ The facilitator (https://facilitator.ultravioletadao.xyz) handles all on-chain i
 | SVM | Partial transaction | Co-signs + submits transaction |
 | NEAR | DelegateAction (Borsh) | Wraps in `Action::Delegate` |
 | Stellar | Auth entry (XDR) | Wraps in fee-bump transaction |
+| Algorand | ASA transfer tx | Signs fee tx + submits atomic group |
 
 ---
 
@@ -929,6 +1082,46 @@ MIT License - see LICENSE file.
 
 ## Changelog
 
+### v0.5.2 (2025-12-26)
+
+- Added EVM facilitator addresses for reference
+  - `EVM_FACILITATOR_MAINNET`: 0x103040545AC5031A11E8C03dd11324C7333a13C7
+  - `EVM_FACILITATOR_TESTNET`: 0x34033041a5944B8F10f8E4D8496Bfb84f1A293A8
+
+### v0.5.1 (2025-12-26)
+
+- Changed default Algorand mainnet network name from `algorand-mainnet` to `algorand`
+- Aligns with facilitator v1.9.5+ which now uses `algorand` as the primary network identifier
+
+### v0.5.0 (2025-12-26)
+
+- **Facilitator Module**: Added `facilitator.py` with all fee payer addresses embedded as constants
+- SDK users no longer need to configure facilitator addresses manually
+- Added constants: `ALGORAND_FEE_PAYER_MAINNET`, `SOLANA_FEE_PAYER_MAINNET`, `NEAR_FEE_PAYER_MAINNET`, `STELLAR_FEE_PAYER_MAINNET`, etc.
+- Added helper functions: `get_fee_payer()`, `requires_fee_payer()`, `build_payment_info()`
+- Network-specific helpers: `get_algorand_fee_payer()`, `get_svm_fee_payer()`, `get_near_fee_payer()`, `get_stellar_fee_payer()`
+
+### v0.4.2 (2025-12-26)
+
+- **Algorand Atomic Group Fix**: Rewrote Algorand payload format to use GoPlausible x402-avm atomic group spec
+- New `AlgorandPaymentPayload` dataclass with `paymentIndex` and `paymentGroup` fields
+- Added `build_atomic_group()` helper for constructing two-transaction atomic groups
+- Added `validate_algorand_payload()` for payload validation
+- Added `build_x402_payment_request()` for building complete x402 requests
+
+### v0.4.1 (2025-12-26)
+
+- Added AUSD (Agora USD) support on Solana using Token2022 program
+- Added `TOKEN_2022_PROGRAM_ID` constant
+- Added `get_token_program_id()` and `is_token_2022()` helpers
+
+### v0.4.0 (2025-12-26)
+
+- **Algorand Support**: Added Algorand mainnet and testnet networks
+- Added `ALGORAND` NetworkType
+- Added `algorand` optional dependency (`py-algorand-sdk>=2.0.0`)
+- SDK now supports 16 blockchain networks
+
 ### v0.3.4 (2025-12-22)
 
 - Added USDT support (USDT0 omnichain via LayerZero) on Ethereum, Arbitrum, Optimism, Avalanche, Polygon

{uvd_x402_sdk-0.5.1 → uvd_x402_sdk-0.5.4}/README.md

@@ -2,11 +2,13 @@
 
 Python SDK for integrating **x402 cryptocurrency payments** via the Ultravioleta DAO facilitator.
 
-Accept **gasless stablecoin payments** across **14 blockchain networks** with a single integration. The SDK handles signature verification, on-chain settlement, and all the complexity of multi-chain payments.
+Accept **gasless stablecoin payments** across **16 blockchain networks** with a single integration. The SDK handles signature verification, on-chain settlement, and all the complexity of multi-chain payments.
+
+**New in v0.5.0+**: The SDK now includes embedded facilitator addresses - no manual configuration needed!
 
 ## Features
 
-- **14 Networks**: EVM chains (Base, Ethereum, Polygon, etc.), SVM chains (Solana, Fogo), NEAR, and Stellar
+- **16 Networks**: EVM chains (Base, Ethereum, Polygon, etc.), SVM chains (Solana, Fogo), NEAR, Stellar, and Algorand
 - **5 Stablecoins**: USDC, EURC, AUSD, PYUSD, USDT (EVM chains)
 - **x402 v1 & v2**: Full support for both protocol versions with auto-detection
 - **Framework Integrations**: Flask, FastAPI, Django, AWS Lambda
@@ -44,6 +46,8 @@ print(f"Paid by {result.payer_address}, tx: {result.transaction_hash}")
 | Fogo | SVM | - | `solana:fogo` | Active |
 | NEAR | NEAR | - | `near:mainnet` | Active |
 | Stellar | Stellar | - | `stellar:pubnet` | Active |
+| Algorand | Algorand | - | `algorand:mainnet` | Active |
+| Algorand Testnet | Algorand | - | `algorand:testnet` | Active |
 
 ### Supported Tokens (EVM Chains)
 
@@ -66,6 +70,7 @@ pip install uvd-x402-sdk[flask]      # Flask integration
 pip install uvd-x402-sdk[fastapi]    # FastAPI/Starlette integration
 pip install uvd-x402-sdk[django]     # Django integration
 pip install uvd-x402-sdk[aws]        # AWS Lambda helpers
+pip install uvd-x402-sdk[algorand]   # Algorand atomic group helpers
 
 # All integrations
 pip install uvd-x402-sdk[all]
@@ -324,6 +329,65 @@ from uvd_x402_sdk.networks.near import validate_near_payload
 validate_near_payload(payload.payload)  # Raises ValueError if invalid
 ```
 
+### Algorand
+
+Algorand uses atomic groups with ASA (Algorand Standard Assets) transfers.
+
+```python
+from uvd_x402_sdk import X402Client, X402Config
+
+config = X402Config(
+    recipient_algorand="NCDSNUQ2QLXDMJXRALAW4CRUSSKG4IS37MVOFDQQPC45SE4EBZO42U6ZX4",
+    supported_networks=["algorand"],
+)
+
+client = X402Client(config=config)
+result = client.process_payment(x_payment_header, Decimal("1.00"))
+
+# Algorand uses atomic groups: [fee_tx, payment_tx]
+from uvd_x402_sdk.networks.algorand import (
+    validate_algorand_payload,
+    get_algorand_fee_payer,
+    build_atomic_group,
+)
+
+# Get the facilitator fee payer address
+fee_payer = get_algorand_fee_payer("algorand")
+print(f"Fee payer: {fee_payer}")  # KIMS5H6Q...
+
+# Validate payload structure
+payload = client.extract_payload(x_payment_header)
+validate_algorand_payload(payload.payload)  # Raises ValueError if invalid
+```
+
+#### Building Algorand Payments (requires `pip install uvd-x402-sdk[algorand]`)
+
+```python
+from uvd_x402_sdk.networks.algorand import (
+    build_atomic_group,
+    build_x402_payment_request,
+    get_algorand_fee_payer,
+)
+from algosdk.v2client import algod
+
+# Connect to Algorand node
+client = algod.AlgodClient("", "https://mainnet-api.algonode.cloud")
+
+# Build atomic group
+payload = build_atomic_group(
+    sender_address="YOUR_ADDRESS...",
+    recipient_address="MERCHANT_ADDRESS...",
+    amount=1000000,  # 1 USDC (6 decimals)
+    asset_id=31566704,  # USDC ASA ID on mainnet
+    facilitator_address=get_algorand_fee_payer("algorand"),
+    sign_transaction=lambda txn: txn.sign(private_key),
+    algod_client=client,
+)
+
+# Build x402 payment request
+request = build_x402_payment_request(payload, network="algorand")
+```
+
 ---
 
 ## x402 v1 vs v2
@@ -542,6 +606,94 @@ config = X402Config.from_env()
 
 ---
 
+## Facilitator Addresses
+
+The SDK includes all facilitator addresses as embedded constants. You don't need to configure them manually.
+
+### Fee Payer Addresses (Non-EVM)
+
+Non-EVM chains require a fee payer address for gasless transactions:
+
+```python
+from uvd_x402_sdk import (
+    # Algorand
+    ALGORAND_FEE_PAYER_MAINNET,  # KIMS5H6QLCUDL65L5UBTOXDPWLMTS7N3AAC3I6B2NCONEI5QIVK7LH2C2I
+    ALGORAND_FEE_PAYER_TESTNET,  # 5DPPDQNYUPCTXRZWRYSF3WPYU6RKAUR25F3YG4EKXQRHV5AUAI62H5GXL4
+
+    # Solana
+    SOLANA_FEE_PAYER_MAINNET,    # F742C4VfFLQ9zRQyithoj5229ZgtX2WqKCSFKgH2EThq
+    SOLANA_FEE_PAYER_DEVNET,     # 6xNPewUdKRbEZDReQdpyfNUdgNg8QRc8Mt263T5GZSRv
+
+    # Fogo
+    FOGO_FEE_PAYER_MAINNET,      # F742C4VfFLQ9zRQyithoj5229ZgtX2WqKCSFKgH2EThq
+    FOGO_FEE_PAYER_TESTNET,      # 6xNPewUdKRbEZDReQdpyfNUdgNg8QRc8Mt263T5GZSRv
+
+    # NEAR
+    NEAR_FEE_PAYER_MAINNET,      # uvd-facilitator.near
+    NEAR_FEE_PAYER_TESTNET,      # uvd-facilitator.testnet
+
+    # Stellar
+    STELLAR_FEE_PAYER_MAINNET,   # GCHPGXJT2WFFRFCA5TV4G4E3PMMXLNIDUH27PKDYA4QJ2XGYZWGFZNHB
+    STELLAR_FEE_PAYER_TESTNET,   # GBBFZMLUJEZVI32EN4XA2KPP445XIBTMTRBLYWFIL556RDTHS2OWFQ2Z
+
+    # Helper function
+    get_fee_payer,               # Get fee payer for any network
+)
+
+# Get fee payer for any network
+fee_payer = get_fee_payer("algorand")  # Returns KIMS5H6Q...
+fee_payer = get_fee_payer("solana")    # Returns F742C4VfF...
+fee_payer = get_fee_payer("base")      # Returns None (EVM doesn't need fee payer)
+```
+
+### EVM Facilitator Addresses
+
+EVM chains use EIP-3009 transferWithAuthorization (gasless by design), but the facilitator wallet addresses are available for reference:
+
+```python
+from uvd_x402_sdk import (
+    EVM_FACILITATOR_MAINNET,  # 0x103040545AC5031A11E8C03dd11324C7333a13C7
+    EVM_FACILITATOR_TESTNET,  # 0x34033041a5944B8F10f8E4D8496Bfb84f1A293A8
+)
+```
+
+### Helper Functions
+
+```python
+from uvd_x402_sdk import (
+    get_fee_payer,           # Get fee payer address for a network
+    requires_fee_payer,      # Check if network needs fee payer
+    get_all_fee_payers,      # Get all registered fee payers
+    build_payment_info,      # Build payment info with auto feePayer
+    DEFAULT_FACILITATOR_URL, # https://facilitator.ultravioletadao.xyz
+)
+
+# Check if network needs fee payer
+requires_fee_payer("algorand")  # True
+requires_fee_payer("base")      # False
+
+# Build payment info with automatic fee payer
+info = build_payment_info(
+    network="algorand",
+    pay_to="MERCHANT_ADDRESS...",
+    max_amount_required="1000000",
+    description="API access"
+)
+# info = {
+#     'network': 'algorand',
+#     'payTo': 'MERCHANT_ADDRESS...',
+#     'maxAmountRequired': '1000000',
+#     'description': 'API access',
+#     'asset': '31566704',
+#     'extra': {
+#         'token': 'usdc',
+#         'feePayer': 'KIMS5H6QLCUDL65L5UBTOXDPWLMTS7N3AAC3I6B2NCONEI5QIVK7LH2C2I'
+#     }
+# }
+```
+
+---
+
 ## Registering Custom Networks
 
 ```python
@@ -772,6 +924,7 @@ The facilitator (https://facilitator.ultravioletadao.xyz) handles all on-chain i
 | SVM | Partial transaction | Co-signs + submits transaction |
 | NEAR | DelegateAction (Borsh) | Wraps in `Action::Delegate` |
 | Stellar | Auth entry (XDR) | Wraps in fee-bump transaction |
+| Algorand | ASA transfer tx | Signs fee tx + submits atomic group |
 
 ---
 
@@ -878,6 +1031,46 @@ MIT License - see LICENSE file.
 
 ## Changelog
 
+### v0.5.2 (2025-12-26)
+
+- Added EVM facilitator addresses for reference
+  - `EVM_FACILITATOR_MAINNET`: 0x103040545AC5031A11E8C03dd11324C7333a13C7
+  - `EVM_FACILITATOR_TESTNET`: 0x34033041a5944B8F10f8E4D8496Bfb84f1A293A8
+
+### v0.5.1 (2025-12-26)
+
+- Changed default Algorand mainnet network name from `algorand-mainnet` to `algorand`
+- Aligns with facilitator v1.9.5+ which now uses `algorand` as the primary network identifier
+
+### v0.5.0 (2025-12-26)
+
+- **Facilitator Module**: Added `facilitator.py` with all fee payer addresses embedded as constants
+- SDK users no longer need to configure facilitator addresses manually
+- Added constants: `ALGORAND_FEE_PAYER_MAINNET`, `SOLANA_FEE_PAYER_MAINNET`, `NEAR_FEE_PAYER_MAINNET`, `STELLAR_FEE_PAYER_MAINNET`, etc.
+- Added helper functions: `get_fee_payer()`, `requires_fee_payer()`, `build_payment_info()`
+- Network-specific helpers: `get_algorand_fee_payer()`, `get_svm_fee_payer()`, `get_near_fee_payer()`, `get_stellar_fee_payer()`
+
+### v0.4.2 (2025-12-26)
+
+- **Algorand Atomic Group Fix**: Rewrote Algorand payload format to use GoPlausible x402-avm atomic group spec
+- New `AlgorandPaymentPayload` dataclass with `paymentIndex` and `paymentGroup` fields
+- Added `build_atomic_group()` helper for constructing two-transaction atomic groups
+- Added `validate_algorand_payload()` for payload validation
+- Added `build_x402_payment_request()` for building complete x402 requests
+
+### v0.4.1 (2025-12-26)
+
+- Added AUSD (Agora USD) support on Solana using Token2022 program
+- Added `TOKEN_2022_PROGRAM_ID` constant
+- Added `get_token_program_id()` and `is_token_2022()` helpers
+
+### v0.4.0 (2025-12-26)
+
+- **Algorand Support**: Added Algorand mainnet and testnet networks
+- Added `ALGORAND` NetworkType
+- Added `algorand` optional dependency (`py-algorand-sdk>=2.0.0`)
+- SDK now supports 16 blockchain networks
+
 ### v0.3.4 (2025-12-22)
 
 - Added USDT support (USDT0 omnichain via LayerZero) on Ethereum, Arbitrum, Optimism, Avalanche, Polygon

{uvd_x402_sdk-0.5.1 → uvd_x402_sdk-0.5.4}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "uvd-x402-sdk"
-version = "0.5.1"
-description = "Python SDK for x402 payments - gasless crypto payments across 16 blockchains with multi-stablecoin support (USDC, EURC, AUSD, PYUSD, USDT)"
+version = "0.5.4"
+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"
 authors = [
@@ -24,6 +24,7 @@ keywords = [
     "near",
     "stellar",
     "algorand",
+    "sui",
     "facilitator",
     "gasless",
     "eip-712",

{uvd_x402_sdk-0.5.1 → uvd_x402_sdk-0.5.4}/src/uvd_x402_sdk/__init__.py

@@ -32,16 +32,17 @@ Example usage:
     def protected_endpoint():
         return {"message": "Payment verified!"}
 
-Supported Networks (16 total):
+Supported Networks (18 total):
 - EVM (10): Base, Ethereum, Polygon, Arbitrum, Optimism, Avalanche, Celo,
            HyperEVM, Unichain, Monad
 - SVM (2): Solana, Fogo
 - NEAR (1): NEAR Protocol
 - Stellar (1): Stellar
 - Algorand (2): Algorand mainnet, Algorand testnet
+- Sui (2): Sui mainnet, Sui testnet
 """
 
-__version__ = "0.5.1"
+__version__ = "0.5.4"
 __author__ = "Ultravioleta DAO"
 
 from uvd_x402_sdk.client import X402Client
@@ -128,6 +129,11 @@ from uvd_x402_sdk.facilitator import (
     NEAR_FEE_PAYER_TESTNET,
     STELLAR_FEE_PAYER_MAINNET,
     STELLAR_FEE_PAYER_TESTNET,
+    SUI_FEE_PAYER_MAINNET,
+    SUI_FEE_PAYER_TESTNET,
+    # EVM facilitator addresses (for reference)
+    EVM_FACILITATOR_MAINNET,
+    EVM_FACILITATOR_TESTNET,
     # Helper functions
     get_fee_payer,
     get_facilitator_address,
@@ -221,6 +227,10 @@ __all__ = [
     "NEAR_FEE_PAYER_TESTNET",
     "STELLAR_FEE_PAYER_MAINNET",
     "STELLAR_FEE_PAYER_TESTNET",
+    "SUI_FEE_PAYER_MAINNET",
+    "SUI_FEE_PAYER_TESTNET",
+    "EVM_FACILITATOR_MAINNET",
+    "EVM_FACILITATOR_TESTNET",
     "get_fee_payer",
     "get_facilitator_address",
     "requires_fee_payer",

{uvd_x402_sdk-0.5.1 → uvd_x402_sdk-0.5.4}/src/uvd_x402_sdk/facilitator.py

@@ -58,6 +58,19 @@ NEAR_FEE_PAYER_TESTNET = "uvd-facilitator.testnet"
 STELLAR_FEE_PAYER_MAINNET = "GCHPGXJT2WFFRFCA5TV4G4E3PMMXLNIDUH27PKDYA4QJ2XGYZWGFZNHB"
 STELLAR_FEE_PAYER_TESTNET = "GBBFZMLUJEZVI32EN4XA2KPP445XIBTMTRBLYWFIL556RDTHS2OWFQ2Z"
 
+# Sui fee payer addresses (sponsor wallets)
+SUI_FEE_PAYER_MAINNET = "0xe7bbf2b13f7d72714760aa16e024fa1b35a978793f9893d0568a4fbf356a764a"
+SUI_FEE_PAYER_TESTNET = "0xabbd16a2fab2a502c9cfe835195a6fc7d70bfc27cffb40b8b286b52a97006e67"
+
+
+# =============================================================================
+# EVM Facilitator Addresses (for reference - EVM uses EIP-3009, no fee payer needed)
+# =============================================================================
+
+# EVM facilitator wallet addresses (used for settlement, not fee payment)
+EVM_FACILITATOR_MAINNET = "0x103040545AC5031A11E8C03dd11324C7333a13C7"
+EVM_FACILITATOR_TESTNET = "0x34033041a5944B8F10f8E4D8496Bfb84f1A293A8"
+
 
 # =============================================================================
 # Network to Fee Payer Mapping
@@ -86,6 +99,10 @@ _FEE_PAYER_BY_NETWORK: Dict[str, str] = {
     "stellar": STELLAR_FEE_PAYER_MAINNET,
     "stellar-mainnet": STELLAR_FEE_PAYER_MAINNET,
     "stellar-testnet": STELLAR_FEE_PAYER_TESTNET,
+    # Sui
+    "sui": SUI_FEE_PAYER_MAINNET,
+    "sui-mainnet": SUI_FEE_PAYER_MAINNET,
+    "sui-testnet": SUI_FEE_PAYER_TESTNET,
 }
 
 # CAIP-2 format mappings (x402 v2)
@@ -105,6 +122,9 @@ _FEE_PAYER_BY_CAIP2: Dict[str, str] = {
     # Stellar
     "stellar:pubnet": STELLAR_FEE_PAYER_MAINNET,
     "stellar:testnet": STELLAR_FEE_PAYER_TESTNET,
+    # Sui
+    "sui:mainnet": SUI_FEE_PAYER_MAINNET,
+    "sui:testnet": SUI_FEE_PAYER_TESTNET,
 }
 
 

{uvd_x402_sdk-0.5.1 → uvd_x402_sdk-0.5.4}/src/uvd_x402_sdk/networks/__init__.py

@@ -48,7 +48,7 @@ from uvd_x402_sdk.networks.base import (
 )
 
 # Import all default network configurations
-from uvd_x402_sdk.networks import evm, solana, near, stellar, algorand
+from uvd_x402_sdk.networks import evm, solana, near, stellar, algorand, sui
 
 __all__ = [
     # Core

{uvd_x402_sdk-0.5.1 → uvd_x402_sdk-0.5.4}/src/uvd_x402_sdk/networks/base.py

@@ -57,6 +57,7 @@ class NetworkType(Enum):
     - NEAR: NEP-366 SignedDelegateAction (meta-transaction)
     - STELLAR: Soroban Authorization Entry XDR
     - ALGORAND: ASA (Algorand Standard Assets) transfer via signed transaction
+    - SUI: Sui sponsored transactions (Move-based programmable transactions)
 
     Note: SOLANA is deprecated, use SVM instead for Solana-compatible chains.
     """
@@ -67,12 +68,18 @@ class NetworkType(Enum):
     NEAR = "near"
     STELLAR = "stellar"
     ALGORAND = "algorand"  # Algorand ASA transfers
+    SUI = "sui"  # Sui Move VM chains (sponsored transactions)
 
     @classmethod
     def is_svm(cls, network_type: "NetworkType") -> bool:
         """Check if network type is SVM-compatible (Solana, Fogo, etc.)."""
         return network_type in (cls.SVM, cls.SOLANA)
 
+    @classmethod
+    def is_sui(cls, network_type: "NetworkType") -> bool:
+        """Check if network type is Sui-based."""
+        return network_type == cls.SUI
+
 
 @dataclass
 class NetworkConfig:
@@ -372,6 +379,7 @@ _CAIP2_NAMESPACE_MAP = {
     "near": NetworkType.NEAR,
     "stellar": NetworkType.STELLAR,
     "algorand": NetworkType.ALGORAND,
+    "sui": NetworkType.SUI,
 }
 
 # Network name to CAIP-2 format
@@ -397,6 +405,9 @@ _NETWORK_TO_CAIP2 = {
     # Algorand
     "algorand": "algorand:mainnet",
     "algorand-testnet": "algorand:testnet",
+    # Sui
+    "sui": "sui:mainnet",
+    "sui-testnet": "sui:testnet",
 }
 
 # CAIP-2 to network name mapping (reverse of above)
@@ -455,6 +466,11 @@ def parse_caip2_network(caip2_id: str) -> Optional[str]:
             return "algorand"
         if reference == "testnet":
             return "algorand-testnet"
+    if namespace == "sui":
+        if reference == "mainnet":
+            return "sui"
+        if reference == "testnet":
+            return "sui-testnet"
 
     return None