t402 1.0.0__tar.gz → 1.2.0__tar.gz

{t402-1.0.0 → t402-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: t402
-Version: 1.0.0
+Version: 1.2.0
 Summary: t402: An internet native payments protocol
 Author-email: T402 Team <dev@t402.io>
 License: Apache-2.0
@@ -25,6 +25,9 @@ Python package for the t402 payments protocol.
 
 ```bash
 pip install t402
+
+# or with uv
+uv add t402
 ```
 
 ## Overview
@@ -233,4 +236,4 @@ async def foo(req: request: Request):
         )
 ```
 
-For more examples and advanced usage patterns, check out our [examples directory](https://github.com/awesome-doge/t402/tree/main/examples/python).
+For more examples and advanced usage patterns, check out our [examples directory](https://github.com/t402-io/t402/tree/main/examples/python).

{t402-1.0.0 → t402-1.2.0}/README.md

@@ -6,6 +6,9 @@ Python package for the t402 payments protocol.
 
 ```bash
 pip install t402
+
+# or with uv
+uv add t402
 ```
 
 ## Overview
@@ -214,4 +217,4 @@ async def foo(req: request: Request):
         )
 ```
 
-For more examples and advanced usage patterns, check out our [examples directory](https://github.com/awesome-doge/t402/tree/main/examples/python).
+For more examples and advanced usage patterns, check out our [examples directory](https://github.com/t402-io/t402/tree/main/examples/python).

{t402-1.0.0 → t402-1.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "t402"
-version = "1.0.0"
+version = "1.2.0"
 description = "t402: An internet native payments protocol"
 readme = "README.md"
 license = { text = "Apache-2.0" }

t402-1.2.0/src/t402/__init__.py

@@ -0,0 +1,135 @@
+# Re-export commonly used items for convenience
+from t402.common import (
+    parse_money,
+    process_price_to_atomic_amount,
+    find_matching_payment_requirements,
+    t402_VERSION,
+)
+from t402.networks import (
+    is_ton_network,
+    is_tron_network,
+    is_evm_network,
+    get_network_type,
+)
+from t402.types import (
+    PaymentRequirements,
+    PaymentPayload,
+    VerifyResponse,
+    SettleResponse,
+    TonAuthorization,
+    TonPaymentPayload,
+    TronAuthorization,
+    TronPaymentPayload,
+)
+from t402.facilitator import FacilitatorClient, FacilitatorConfig
+from t402.exact import (
+    prepare_payment_header,
+    sign_payment_header,
+    encode_payment,
+    decode_payment,
+)
+from t402.ton import (
+    TON_MAINNET,
+    TON_TESTNET,
+    USDT_MAINNET_ADDRESS,
+    USDT_TESTNET_ADDRESS,
+    validate_ton_address,
+    get_usdt_address,
+    get_network_config as get_ton_network_config,
+    get_default_asset as get_ton_default_asset,
+    prepare_ton_payment_header,
+    parse_amount as parse_ton_amount,
+    format_amount as format_ton_amount,
+    validate_boc,
+    is_testnet as is_ton_testnet,
+)
+from t402.tron import (
+    TRON_MAINNET,
+    TRON_NILE,
+    TRON_SHASTA,
+    USDT_MAINNET_ADDRESS as TRON_USDT_MAINNET_ADDRESS,
+    USDT_NILE_ADDRESS as TRON_USDT_NILE_ADDRESS,
+    USDT_SHASTA_ADDRESS as TRON_USDT_SHASTA_ADDRESS,
+    validate_tron_address,
+    get_usdt_address as get_tron_usdt_address,
+    get_network_config as get_tron_network_config,
+    get_default_asset as get_tron_default_asset,
+    prepare_tron_payment_header,
+    parse_amount as parse_tron_amount,
+    format_amount as format_tron_amount,
+    is_testnet as is_tron_testnet,
+)
+from t402.paywall import (
+    get_paywall_html,
+    get_paywall_template,
+    is_browser_request,
+)
+
+def hello() -> str:
+    return "Hello from t402!"
+
+
+__all__ = [
+    # Core
+    "hello",
+    "t402_VERSION",
+    # Common utilities
+    "parse_money",
+    "process_price_to_atomic_amount",
+    "find_matching_payment_requirements",
+    # Network utilities
+    "is_ton_network",
+    "is_tron_network",
+    "is_evm_network",
+    "get_network_type",
+    # Types
+    "PaymentRequirements",
+    "PaymentPayload",
+    "VerifyResponse",
+    "SettleResponse",
+    "TonAuthorization",
+    "TonPaymentPayload",
+    "TronAuthorization",
+    "TronPaymentPayload",
+    # Facilitator
+    "FacilitatorClient",
+    "FacilitatorConfig",
+    # EVM payment
+    "prepare_payment_header",
+    "sign_payment_header",
+    "encode_payment",
+    "decode_payment",
+    # TON utilities
+    "TON_MAINNET",
+    "TON_TESTNET",
+    "USDT_MAINNET_ADDRESS",
+    "USDT_TESTNET_ADDRESS",
+    "validate_ton_address",
+    "get_usdt_address",
+    "get_ton_network_config",
+    "get_ton_default_asset",
+    "prepare_ton_payment_header",
+    "parse_ton_amount",
+    "format_ton_amount",
+    "validate_boc",
+    "is_ton_testnet",
+    # TRON utilities
+    "TRON_MAINNET",
+    "TRON_NILE",
+    "TRON_SHASTA",
+    "TRON_USDT_MAINNET_ADDRESS",
+    "TRON_USDT_NILE_ADDRESS",
+    "TRON_USDT_SHASTA_ADDRESS",
+    "validate_tron_address",
+    "get_tron_usdt_address",
+    "get_tron_network_config",
+    "get_tron_default_asset",
+    "prepare_tron_payment_header",
+    "parse_tron_amount",
+    "format_tron_amount",
+    "is_tron_testnet",
+    # Paywall
+    "get_paywall_html",
+    "get_paywall_template",
+    "is_browser_request",
+]

{t402-1.0.0 → t402-1.2.0}/src/t402/common.py

@@ -8,6 +8,7 @@ from t402.chains import (
     get_token_version,
     get_default_token_address,
 )
+from t402.networks import is_ton_network, is_tron_network
 from t402.types import Price, TokenAmount, PaymentRequirements, PaymentPayload
 
 
@@ -22,8 +23,18 @@ def parse_money(amount: str | int, address: str, network: str) -> int:
             amount = amount[1:]
         decimal_amount = Decimal(amount)
 
-        chain_id = get_chain_id(network)
-        decimals = get_token_decimals(chain_id, address)
+        # Handle TON networks differently
+        if is_ton_network(network):
+            from t402.ton import DEFAULT_DECIMALS
+            decimals = DEFAULT_DECIMALS  # USDT on TON uses 6 decimals
+        # Handle TRON networks
+        elif is_tron_network(network):
+            from t402.tron import DEFAULT_DECIMALS
+            decimals = DEFAULT_DECIMALS  # USDT on TRON uses 6 decimals
+        else:
+            chain_id = get_chain_id(network)
+            decimals = get_token_decimals(chain_id, address)
+
         decimal_amount = decimal_amount * Decimal(10**decimals)
         return int(decimal_amount)
     return amount
@@ -39,19 +50,63 @@ def process_price_to_atomic_amount(
         network: Network identifier
 
     Returns:
-        Tuple of (max_amount_required, asset_address, eip712_domain)
+        Tuple of (max_amount_required, asset_address, extra_info)
+        For EVM: extra_info contains EIP-712 domain (name, version)
+        For TON: extra_info contains Jetton metadata (name, symbol)
 
     Raises:
         ValueError: If price format is invalid
     """
     if isinstance(price, (str, int)):
-        # Money type - convert USD to USDC atomic units
+        # Money type - convert USD to atomic units
         try:
             if isinstance(price, str) and price.startswith("$"):
                 price = price[1:]
             amount = Decimal(str(price))
 
-            # Get USDC address for the network
+            # Handle TON networks
+            if is_ton_network(network):
+                from t402.ton import (
+                    get_usdt_address,
+                    get_default_asset,
+                    DEFAULT_DECIMALS,
+                )
+
+                asset_address = get_usdt_address(network)
+                decimals = DEFAULT_DECIMALS
+                atomic_amount = int(amount * Decimal(10**decimals))
+
+                # For TON, return Jetton metadata instead of EIP-712 domain
+                asset_info = get_default_asset(network)
+                extra_info = {
+                    "name": asset_info["name"] if asset_info else "Tether USD",
+                    "symbol": asset_info["symbol"] if asset_info else "USDT",
+                }
+
+                return str(atomic_amount), asset_address, extra_info
+
+            # Handle TRON networks
+            if is_tron_network(network):
+                from t402.tron import (
+                    get_usdt_address as get_tron_usdt_address,
+                    get_default_asset as get_tron_default_asset,
+                    DEFAULT_DECIMALS,
+                )
+
+                asset_address = get_tron_usdt_address(network)
+                decimals = DEFAULT_DECIMALS
+                atomic_amount = int(amount * Decimal(10**decimals))
+
+                # For TRON, return TRC20 metadata
+                asset_info = get_tron_default_asset(network)
+                extra_info = {
+                    "name": asset_info["name"] if asset_info else "Tether USD",
+                    "symbol": asset_info["symbol"] if asset_info else "USDT",
+                }
+
+                return str(atomic_amount), asset_address, extra_info
+
+            # Handle EVM networks
             chain_id = get_chain_id(network)
             asset_address = get_usdc_address(chain_id)
             decimals = get_token_decimals(chain_id, asset_address)

{t402-1.0.0 → t402-1.2.0}/src/t402/fastapi/middleware.py

@@ -1,7 +1,7 @@
 import base64
 import json
 import logging
-from typing import Any, Callable, Optional, get_args, cast
+from typing import Any, Callable, Optional, cast
 
 from fastapi import Request
 from fastapi.responses import JSONResponse, HTMLResponse
@@ -14,6 +14,7 @@ from t402.common import (
 )
 from t402.encoding import safe_base64_decode
 from t402.facilitator import FacilitatorClient, FacilitatorConfig
+from t402.networks import get_all_supported_networks, SupportedNetworks
 from t402.path import path_is_match
 from t402.paywall import is_browser_request, get_paywall_html
 from t402.types import (
@@ -22,7 +23,6 @@ from t402.types import (
     Price,
     t402PaymentRequiredResponse,
     PaywallConfig,
-    SupportedNetworks,
     HTTPInputSchema,
 )
 
@@ -73,7 +73,7 @@ def require_payment(
     """
 
     # Validate network is supported
-    supported_networks = get_args(SupportedNetworks)
+    supported_networks = get_all_supported_networks()
     if network not in supported_networks:
         raise ValueError(
             f"Unsupported network: {network}. Must be one of: {supported_networks}"

{t402-1.0.0 → t402-1.2.0}/src/t402/flask/middleware.py

@@ -1,15 +1,15 @@
 import base64
 import json
-from typing import Any, Dict, Optional, Union, get_args, cast
+from typing import Any, Dict, Optional, Union, cast
 from flask import Flask, request, g
 from t402.path import path_is_match
+from t402.networks import get_all_supported_networks, SupportedNetworks
 from t402.types import (
     Price,
     PaymentPayload,
     PaymentRequirements,
     t402PaymentRequiredResponse,
     PaywallConfig,
-    SupportedNetworks,
     HTTPInputSchema,
 )
 from t402.common import (
@@ -148,7 +148,7 @@ class PaymentMiddleware:
         """Create a WSGI middleware function for the given configuration."""
 
         # Validate network is supported
-        supported_networks = get_args(SupportedNetworks)
+        supported_networks = get_all_supported_networks()
         if config["network"] not in supported_networks:
             raise ValueError(
                 f"Unsupported network: {config['network']}. Must be one of: {supported_networks}"

t402-1.2.0/src/t402/networks.py

@@ -0,0 +1,88 @@
+from typing import Literal, Union, get_args
+
+
+# EVM Networks
+EVMNetworks = Literal["base", "base-sepolia", "avalanche-fuji", "avalanche"]
+
+# TON Networks (CAIP-2 format)
+TONNetworks = Literal["ton:mainnet", "ton:testnet"]
+
+# TRON Networks (CAIP-2 format)
+TRONNetworks = Literal["tron:mainnet", "tron:nile", "tron:shasta"]
+
+# All supported networks
+SupportedNetworks = Union[EVMNetworks, TONNetworks, TRONNetworks]
+
+
+def get_all_supported_networks() -> tuple[str, ...]:
+    """Get all supported network identifiers as a flat tuple of strings."""
+    evm = get_args(EVMNetworks)
+    ton = get_args(TONNetworks)
+    tron = get_args(TRONNetworks)
+    return evm + ton + tron
+
+EVM_NETWORK_TO_CHAIN_ID = {
+    "base-sepolia": 84532,
+    "base": 8453,
+    "avalanche-fuji": 43113,
+    "avalanche": 43114,
+}
+
+# TON Network configurations
+TON_NETWORKS = {
+    "ton:mainnet": {
+        "name": "TON Mainnet",
+        "endpoint": "https://toncenter.com/api/v2/jsonRPC",
+        "is_testnet": False,
+    },
+    "ton:testnet": {
+        "name": "TON Testnet",
+        "endpoint": "https://testnet.toncenter.com/api/v2/jsonRPC",
+        "is_testnet": True,
+    },
+}
+
+# TRON Network configurations
+TRON_NETWORKS = {
+    "tron:mainnet": {
+        "name": "TRON Mainnet",
+        "endpoint": "https://api.trongrid.io",
+        "is_testnet": False,
+    },
+    "tron:nile": {
+        "name": "TRON Nile Testnet",
+        "endpoint": "https://api.nileex.io",
+        "is_testnet": True,
+    },
+    "tron:shasta": {
+        "name": "TRON Shasta Testnet",
+        "endpoint": "https://api.shasta.trongrid.io",
+        "is_testnet": True,
+    },
+}
+
+
+def is_ton_network(network: str) -> bool:
+    """Check if a network is a TON network."""
+    return network.startswith("ton:")
+
+
+def is_tron_network(network: str) -> bool:
+    """Check if a network is a TRON network."""
+    return network.startswith("tron:")
+
+
+def is_evm_network(network: str) -> bool:
+    """Check if a network is an EVM network."""
+    return network in EVM_NETWORK_TO_CHAIN_ID
+
+
+def get_network_type(network: str) -> str:
+    """Get the network type (ton, tron, evm, or unknown)."""
+    if is_ton_network(network):
+        return "ton"
+    if is_tron_network(network):
+        return "tron"
+    if is_evm_network(network):
+        return "evm"
+    return "unknown"

{t402-1.0.0 → t402-1.2.0}/src/t402/paywall.py

@@ -5,12 +5,15 @@ from t402.types import PaymentRequirements, PaywallConfig
 from t402.common import t402_VERSION
 from t402.evm_paywall_template import EVM_PAYWALL_TEMPLATE
 from t402.svm_paywall_template import SVM_PAYWALL_TEMPLATE
+from t402.ton_paywall_template import TON_PAYWALL_TEMPLATE
 
 
 def get_paywall_template(network: str) -> str:
     """Get the appropriate paywall template for the given network."""
     if network.startswith("solana:"):
         return SVM_PAYWALL_TEMPLATE
+    if network.startswith("ton:"):
+        return TON_PAYWALL_TEMPLATE
     return EVM_PAYWALL_TEMPLATE