t402 1.1.0__py3-none-any.whl → 1.3.0__py3-none-any.whl

t402/__init__.py

@@ -7,6 +7,7 @@ from t402.common import (
 )
 from t402.networks import (
     is_ton_network,
+    is_tron_network,
     is_evm_network,
     get_network_type,
 )
@@ -17,6 +18,8 @@ from t402.types import (
     SettleResponse,
     TonAuthorization,
     TonPaymentPayload,
+    TronAuthorization,
+    TronPaymentPayload,
 )
 from t402.facilitator import FacilitatorClient, FacilitatorConfig
 from t402.exact import (
@@ -40,11 +43,54 @@ from t402.ton import (
     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,
 )
+from t402.erc4337 import (
+    # Constants
+    ENTRYPOINT_V07_ADDRESS,
+    ENTRYPOINT_V06_ADDRESS,
+    SAFE_4337_ADDRESSES,
+    SUPPORTED_CHAINS as ERC4337_SUPPORTED_CHAINS,
+    # Types
+    UserOperation,
+    PackedUserOperation,
+    PaymasterData,
+    GasEstimate,
+    UserOperationReceipt,
+    # Bundlers
+    GenericBundlerClient,
+    PimlicoBundlerClient,
+    AlchemyBundlerClient,
+    create_bundler_client,
+    # Paymasters
+    PimlicoPaymaster,
+    BiconomyPaymaster,
+    StackupPaymaster,
+    create_paymaster,
+    # Accounts
+    SafeSmartAccount,
+    SafeAccountConfig,
+    create_smart_account,
+)
 
 def hello() -> str:
     return "Hello from t402!"
@@ -60,6 +106,7 @@ __all__ = [
     "find_matching_payment_requirements",
     # Network utilities
     "is_ton_network",
+    "is_tron_network",
     "is_evm_network",
     "get_network_type",
     # Types
@@ -69,6 +116,8 @@ __all__ = [
     "SettleResponse",
     "TonAuthorization",
     "TonPaymentPayload",
+    "TronAuthorization",
+    "TronPaymentPayload",
     # Facilitator
     "FacilitatorClient",
     "FacilitatorConfig",
@@ -91,8 +140,44 @@ __all__ = [
     "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",
+    # ERC-4337 Account Abstraction
+    "ENTRYPOINT_V07_ADDRESS",
+    "ENTRYPOINT_V06_ADDRESS",
+    "SAFE_4337_ADDRESSES",
+    "ERC4337_SUPPORTED_CHAINS",
+    "UserOperation",
+    "PackedUserOperation",
+    "PaymasterData",
+    "GasEstimate",
+    "UserOperationReceipt",
+    "GenericBundlerClient",
+    "PimlicoBundlerClient",
+    "AlchemyBundlerClient",
+    "create_bundler_client",
+    "PimlicoPaymaster",
+    "BiconomyPaymaster",
+    "StackupPaymaster",
+    "create_paymaster",
+    "SafeSmartAccount",
+    "SafeAccountConfig",
+    "create_smart_account",
 ]

t402/common.py

@@ -8,7 +8,7 @@ from t402.chains import (
     get_token_version,
     get_default_token_address,
 )
-from t402.networks import is_ton_network
+from t402.networks import is_ton_network, is_tron_network
 from t402.types import Price, TokenAmount, PaymentRequirements, PaymentPayload
 
 
@@ -27,6 +27,10 @@ def parse_money(amount: str | int, address: str, network: str) -> int:
         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)
@@ -81,6 +85,27 @@ def process_price_to_atomic_amount(
 
                 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)

t402/erc4337/__init__.py

@@ -0,0 +1,188 @@
+"""
+ERC-4337 Account Abstraction Module for T402
+
+This module provides complete ERC-4337 v0.7 support including:
+- UserOperation building and signing
+- Bundler clients (generic, Pimlico, Alchemy)
+- Paymaster integration (Pimlico, Biconomy, Stackup)
+- Smart account implementations (Safe)
+
+Example usage:
+
+    from t402.erc4337 import (
+        UserOperation,
+        create_bundler_client,
+        create_paymaster,
+        SafeSmartAccount,
+        SafeAccountConfig,
+    )
+
+    # Create a Safe smart account
+    account = SafeSmartAccount(SafeAccountConfig(
+        owner_private_key="0x...",
+        chain_id=84532,  # Base Sepolia
+    ))
+
+    # Create a bundler client
+    bundler = create_bundler_client(
+        provider="pimlico",
+        api_key="your-api-key",
+        chain_id=84532,
+    )
+
+    # Create a paymaster
+    paymaster = create_paymaster(
+        provider="pimlico",
+        api_key="your-api-key",
+        chain_id=84532,
+    )
+
+    # Build and submit a UserOperation
+    user_op = UserOperation(
+        sender=account.get_address(),
+        call_data=account.encode_execute(
+            target="0x...",
+            value=0,
+            data=b"...",
+        ),
+    )
+
+    # Get gas estimates and paymaster data
+    gas = bundler.estimate_user_operation_gas(user_op)
+    pm_data = paymaster.get_paymaster_data(user_op, 84532, ENTRYPOINT_V07_ADDRESS)
+
+    # Update user_op with estimates and sign
+    user_op.verification_gas_limit = gas.verification_gas_limit
+    user_op.call_gas_limit = gas.call_gas_limit
+    user_op.pre_verification_gas = gas.pre_verification_gas
+    user_op.paymaster_and_data = pm_data.to_bytes()
+    user_op.signature = account.sign_user_op_hash(user_op_hash)
+
+    # Submit
+    user_op_hash = bundler.send_user_operation(user_op)
+    receipt = bundler.wait_for_receipt(user_op_hash)
+"""
+
+# Types
+from .types import (
+    # Constants
+    ENTRYPOINT_V07_ADDRESS,
+    ENTRYPOINT_V06_ADDRESS,
+    SAFE_4337_ADDRESSES,
+    SUPPORTED_CHAINS,
+    ALCHEMY_NETWORKS,
+    PIMLICO_NETWORKS,
+    DEFAULT_GAS_LIMITS,
+    BUNDLER_METHODS,
+    # Enums
+    PaymasterType,
+    # Dataclasses
+    UserOperation,
+    PackedUserOperation,
+    PaymasterData,
+    GasEstimate,
+    UserOperationReceipt,
+    BundlerConfig,
+    PaymasterConfig,
+    TokenQuote,
+    AssetChange,
+    SimulationResult,
+    # Functions
+    pack_account_gas_limits,
+    unpack_account_gas_limits,
+    pack_gas_fees,
+    unpack_gas_fees,
+    is_supported_chain,
+    get_alchemy_network,
+    get_pimlico_network,
+    get_dummy_signature,
+)
+
+# Bundlers
+from .bundlers import (
+    BundlerError,
+    GenericBundlerClient,
+    PimlicoBundlerClient,
+    PimlicoGasPrice,
+    AlchemyBundlerClient,
+    AlchemyPolicyConfig,
+    GasAndPaymasterResult,
+    create_bundler_client,
+)
+
+# Paymasters
+from .paymasters import (
+    PaymasterError,
+    PaymasterClient,
+    PimlicoPaymaster,
+    BiconomyPaymaster,
+    StackupPaymaster,
+    UnifiedPaymaster,
+    create_paymaster,
+)
+
+# Accounts
+from .accounts import (
+    SmartAccountError,
+    SmartAccountSigner,
+    SafeSmartAccount,
+    SafeAccountConfig,
+    create_smart_account,
+)
+
+__all__ = [
+    # Constants
+    "ENTRYPOINT_V07_ADDRESS",
+    "ENTRYPOINT_V06_ADDRESS",
+    "SAFE_4337_ADDRESSES",
+    "SUPPORTED_CHAINS",
+    "ALCHEMY_NETWORKS",
+    "PIMLICO_NETWORKS",
+    "DEFAULT_GAS_LIMITS",
+    "BUNDLER_METHODS",
+    # Enums
+    "PaymasterType",
+    # Types
+    "UserOperation",
+    "PackedUserOperation",
+    "PaymasterData",
+    "GasEstimate",
+    "UserOperationReceipt",
+    "BundlerConfig",
+    "PaymasterConfig",
+    "TokenQuote",
+    "AssetChange",
+    "SimulationResult",
+    # Functions
+    "pack_account_gas_limits",
+    "unpack_account_gas_limits",
+    "pack_gas_fees",
+    "unpack_gas_fees",
+    "is_supported_chain",
+    "get_alchemy_network",
+    "get_pimlico_network",
+    "get_dummy_signature",
+    # Bundlers
+    "BundlerError",
+    "GenericBundlerClient",
+    "PimlicoBundlerClient",
+    "PimlicoGasPrice",
+    "AlchemyBundlerClient",
+    "AlchemyPolicyConfig",
+    "GasAndPaymasterResult",
+    "create_bundler_client",
+    # Paymasters
+    "PaymasterError",
+    "PaymasterClient",
+    "PimlicoPaymaster",
+    "BiconomyPaymaster",
+    "StackupPaymaster",
+    "UnifiedPaymaster",
+    "create_paymaster",
+    # Accounts
+    "SmartAccountError",
+    "SmartAccountSigner",
+    "SafeSmartAccount",
+    "SafeAccountConfig",
+    "create_smart_account",
+]