t402 1.5.3__tar.gz → 1.6.0__tar.gz

t402-1.5.3/README.md → t402-1.6.0/PKG-INFO

@@ -1,3 +1,28 @@
+Metadata-Version: 2.4
+Name: t402
+Version: 1.6.0
+Summary: t402: An internet native payments protocol
+Author-email: T402 Team <dev@t402.io>
+License: Apache-2.0
+Keywords: crypto,payments,sdk,t402,tether,usdt,web3
+Requires-Python: >=3.10
+Requires-Dist: eth-account>=0.13.7
+Requires-Dist: eth-typing>=4.0.0
+Requires-Dist: eth-utils>=3.0.0
+Requires-Dist: fastapi[standard]>=0.115.12
+Requires-Dist: flask>=3.0.0
+Requires-Dist: pydantic-settings>=2.2.1
+Requires-Dist: pydantic>=2.10.3
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: web3>=6.0.0
+Provides-Extra: all
+Requires-Dist: solana>=0.35.0; extra == 'all'
+Requires-Dist: solders>=0.21.0; extra == 'all'
+Provides-Extra: svm
+Requires-Dist: solana>=0.35.0; extra == 'svm'
+Requires-Dist: solders>=0.21.0; extra == 'svm'
+Description-Content-Type: text/markdown
+
 # t402 Python
 
 Python SDK for the T402 HTTP-native stablecoin payments protocol.
@@ -260,6 +285,39 @@ is_valid = validate_tron_address("T...")
 config = get_tron_network_config(TRON_MAINNET)
 ```
 
+### Solana (SVM) Network
+
+```python
+from t402 import (
+    SOLANA_MAINNET,
+    SOLANA_DEVNET,
+    SOLANA_TESTNET,
+    validate_svm_address,
+    prepare_svm_payment_header,
+    get_svm_network_config,
+    get_svm_usdc_address,
+    is_svm_network,
+)
+
+# Validate address
+is_valid = validate_svm_address("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v")
+
+# Get network config
+config = get_svm_network_config(SOLANA_MAINNET)
+
+# Get USDC mint address
+usdc_mint = get_svm_usdc_address(SOLANA_MAINNET)
+
+# Check if network is Solana
+is_solana = is_svm_network("solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")
+```
+
+Install with optional Solana dependencies:
+
+```bash
+pip install t402[svm]
+```
+
 ## ERC-4337 Account Abstraction
 
 Gasless payments using smart accounts and paymasters:
@@ -383,6 +441,7 @@ signature = await signer.sign_payment(
 | `is_evm_network(network)` | Check if EVM network |
 | `is_ton_network(network)` | Check if TON network |
 | `is_tron_network(network)` | Check if TRON network |
+| `is_svm_network(network)` | Check if Solana SVM network |
 | `get_network_type(network)` | Get network type string |
 
 ### Facilitator Client

t402-1.5.3/PKG-INFO → t402-1.6.0/README.md

@@ -1,22 +1,3 @@
-Metadata-Version: 2.4
-Name: t402
-Version: 1.5.3
-Summary: t402: An internet native payments protocol
-Author-email: T402 Team <dev@t402.io>
-License: Apache-2.0
-Keywords: crypto,payments,sdk,t402,tether,usdt,web3
-Requires-Python: >=3.10
-Requires-Dist: eth-account>=0.13.7
-Requires-Dist: eth-typing>=4.0.0
-Requires-Dist: eth-utils>=3.0.0
-Requires-Dist: fastapi[standard]>=0.115.12
-Requires-Dist: flask>=3.0.0
-Requires-Dist: pydantic-settings>=2.2.1
-Requires-Dist: pydantic>=2.10.3
-Requires-Dist: python-dotenv>=1.0.1
-Requires-Dist: web3>=6.0.0
-Description-Content-Type: text/markdown
-
 # t402 Python
 
 Python SDK for the T402 HTTP-native stablecoin payments protocol.
@@ -279,6 +260,39 @@ is_valid = validate_tron_address("T...")
 config = get_tron_network_config(TRON_MAINNET)
 ```
 
+### Solana (SVM) Network
+
+```python
+from t402 import (
+    SOLANA_MAINNET,
+    SOLANA_DEVNET,
+    SOLANA_TESTNET,
+    validate_svm_address,
+    prepare_svm_payment_header,
+    get_svm_network_config,
+    get_svm_usdc_address,
+    is_svm_network,
+)
+
+# Validate address
+is_valid = validate_svm_address("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v")
+
+# Get network config
+config = get_svm_network_config(SOLANA_MAINNET)
+
+# Get USDC mint address
+usdc_mint = get_svm_usdc_address(SOLANA_MAINNET)
+
+# Check if network is Solana
+is_solana = is_svm_network("solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")
+```
+
+Install with optional Solana dependencies:
+
+```bash
+pip install t402[svm]
+```
+
 ## ERC-4337 Account Abstraction
 
 Gasless payments using smart accounts and paymasters:
@@ -402,6 +416,7 @@ signature = await signer.sign_payment(
 | `is_evm_network(network)` | Check if EVM network |
 | `is_ton_network(network)` | Check if TON network |
 | `is_tron_network(network)` | Check if TRON network |
+| `is_svm_network(network)` | Check if Solana SVM network |
 | `get_network_type(network)` | Get network type string |
 
 ### Facilitator Client

{t402-1.5.3 → t402-1.6.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "t402"
-version = "1.5.3"
+version = "1.6.0"
 description = "t402: An internet native payments protocol"
 readme = "README.md"
 license = { text = "Apache-2.0" }
@@ -24,6 +24,16 @@ dependencies = [
 [project.scripts]
 t402 = "t402.cli:main"
 
+[project.optional-dependencies]
+svm = [
+    "solana>=0.35.0",
+    "solders>=0.21.0",
+]
+all = [
+    "solana>=0.35.0",
+    "solders>=0.21.0",
+]
+
 [build-system]
 requires = ["hatchling"]
 build-backend = "hatchling.build"
@@ -33,6 +43,8 @@ dev = [
     "pytest>=8.3.5",
     "pytest-asyncio>=1.0.0",
     "ruff>=0.11.9",
+    "solana>=0.35.0",
+    "solders>=0.21.0",
 ]
 
 [tool.pytest.ini_options]

{t402-1.5.3 → t402-1.6.0}/src/t402/__init__.py

@@ -12,6 +12,7 @@ from t402.networks import (
     is_ton_network,
     is_tron_network,
     is_evm_network,
+    is_svm_network,
     get_network_type,
 )
 from t402.types import (
@@ -62,6 +63,24 @@ from t402.tron import (
     format_amount as format_tron_amount,
     is_testnet as is_tron_testnet,
 )
+from t402.svm import (
+    SOLANA_MAINNET,
+    SOLANA_DEVNET,
+    SOLANA_TESTNET,
+    USDC_MAINNET_ADDRESS as SVM_USDC_MAINNET_ADDRESS,
+    USDC_DEVNET_ADDRESS as SVM_USDC_DEVNET_ADDRESS,
+    validate_svm_address,
+    get_usdc_address as get_svm_usdc_address,
+    get_network_config as get_svm_network_config,
+    get_default_asset as get_svm_default_asset,
+    prepare_svm_payment_header,
+    parse_amount as parse_svm_amount,
+    format_amount as format_svm_amount,
+    is_testnet as is_svm_testnet,
+    validate_transaction as validate_svm_transaction,
+    normalize_network as normalize_svm_network,
+    get_rpc_url as get_svm_rpc_url,
+)
 from t402.paywall import (
     get_paywall_html,
     get_paywall_template,
@@ -168,6 +187,7 @@ __all__ = [
     "is_ton_network",
     "is_tron_network",
     "is_evm_network",
+    "is_svm_network",
     "get_network_type",
     # Types
     "PaymentRequirements",
@@ -215,6 +235,23 @@ __all__ = [
     "parse_tron_amount",
     "format_tron_amount",
     "is_tron_testnet",
+    # SVM (Solana) utilities
+    "SOLANA_MAINNET",
+    "SOLANA_DEVNET",
+    "SOLANA_TESTNET",
+    "SVM_USDC_MAINNET_ADDRESS",
+    "SVM_USDC_DEVNET_ADDRESS",
+    "validate_svm_address",
+    "get_svm_usdc_address",
+    "get_svm_network_config",
+    "get_svm_default_asset",
+    "prepare_svm_payment_header",
+    "parse_svm_amount",
+    "format_svm_amount",
+    "is_svm_testnet",
+    "validate_svm_transaction",
+    "normalize_svm_network",
+    "get_svm_rpc_url",
     # Paywall
     "get_paywall_html",
     "get_paywall_template",

t402-1.6.0/src/t402/mcp/__init__.py

@@ -0,0 +1,109 @@
+"""T402 MCP Server - Model Context Protocol server for AI agent integration.
+
+This module provides an MCP server that enables AI agents to interact with
+blockchain payments using the T402 protocol.
+
+Example:
+    ```python
+    from t402.mcp import T402McpServer, ServerConfig
+
+    config = ServerConfig(demo_mode=True)
+    server = T402McpServer(config)
+    await server.run()
+    ```
+
+Available Tools:
+    - t402/getBalance: Get token balances for a wallet on specific network
+    - t402/getAllBalances: Get balances across all supported networks
+    - t402/pay: Execute stablecoin payments (USDC, USDT, USDT0)
+    - t402/payGasless: ERC-4337 gasless payments
+    - t402/getBridgeFee: Get LayerZero bridge fee quotes
+    - t402/bridge: Bridge USDT0 between chains via LayerZero
+"""
+
+from .server import T402McpServer, run_server
+from .types import (
+    ServerConfig,
+    SupportedNetwork,
+    SupportedToken,
+    Tool,
+    ToolResult,
+    GetBalanceInput,
+    GetAllBalancesInput,
+    PayInput,
+    PayGaslessInput,
+    GetBridgeFeeInput,
+    BridgeInput,
+    BalanceInfo,
+    NetworkBalance,
+    PaymentResult,
+    BridgeFeeResult,
+    BridgeResultData,
+)
+from .constants import (
+    CHAIN_IDS,
+    NATIVE_SYMBOLS,
+    EXPLORER_URLS,
+    DEFAULT_RPC_URLS,
+    USDC_ADDRESSES,
+    USDT_ADDRESSES,
+    USDT0_ADDRESSES,
+    BRIDGEABLE_CHAINS,
+    GASLESS_NETWORKS,
+    ALL_NETWORKS,
+    is_valid_network,
+    is_bridgeable_chain,
+    is_gasless_network,
+    get_token_address,
+    get_explorer_tx_url,
+    get_rpc_url,
+    format_token_amount,
+    parse_token_amount,
+)
+from .tools import get_tool_definitions
+
+__all__ = [
+    # Server
+    "T402McpServer",
+    "run_server",
+    # Config and types
+    "ServerConfig",
+    "SupportedNetwork",
+    "SupportedToken",
+    "Tool",
+    "ToolResult",
+    # Input types
+    "GetBalanceInput",
+    "GetAllBalancesInput",
+    "PayInput",
+    "PayGaslessInput",
+    "GetBridgeFeeInput",
+    "BridgeInput",
+    # Result types
+    "BalanceInfo",
+    "NetworkBalance",
+    "PaymentResult",
+    "BridgeFeeResult",
+    "BridgeResultData",
+    # Constants
+    "CHAIN_IDS",
+    "NATIVE_SYMBOLS",
+    "EXPLORER_URLS",
+    "DEFAULT_RPC_URLS",
+    "USDC_ADDRESSES",
+    "USDT_ADDRESSES",
+    "USDT0_ADDRESSES",
+    "BRIDGEABLE_CHAINS",
+    "GASLESS_NETWORKS",
+    "ALL_NETWORKS",
+    # Functions
+    "is_valid_network",
+    "is_bridgeable_chain",
+    "is_gasless_network",
+    "get_token_address",
+    "get_explorer_tx_url",
+    "get_rpc_url",
+    "format_token_amount",
+    "parse_token_amount",
+    "get_tool_definitions",
+]

t402-1.6.0/src/t402/mcp/constants.py

@@ -0,0 +1,213 @@
+"""Constants for T402 MCP Server."""
+
+from typing import Optional
+
+from .types import ServerConfig, SupportedNetwork, SupportedToken
+
+# Chain IDs for supported networks
+CHAIN_IDS: dict[SupportedNetwork, int] = {
+    "ethereum": 1,
+    "base": 8453,
+    "arbitrum": 42161,
+    "optimism": 10,
+    "polygon": 137,
+    "avalanche": 43114,
+    "ink": 57073,
+    "berachain": 80094,
+    "unichain": 130,
+}
+
+# Native token symbols for each network
+NATIVE_SYMBOLS: dict[SupportedNetwork, str] = {
+    "ethereum": "ETH",
+    "base": "ETH",
+    "arbitrum": "ETH",
+    "optimism": "ETH",
+    "polygon": "MATIC",
+    "avalanche": "AVAX",
+    "ink": "ETH",
+    "berachain": "BERA",
+    "unichain": "ETH",
+}
+
+# Block explorer URLs for each network
+EXPLORER_URLS: dict[SupportedNetwork, str] = {
+    "ethereum": "https://etherscan.io",
+    "base": "https://basescan.org",
+    "arbitrum": "https://arbiscan.io",
+    "optimism": "https://optimistic.etherscan.io",
+    "polygon": "https://polygonscan.com",
+    "avalanche": "https://snowtrace.io",
+    "ink": "https://explorer.ink.xyz",
+    "berachain": "https://berascan.com",
+    "unichain": "https://uniscan.xyz",
+}
+
+# Default RPC URLs for each network
+DEFAULT_RPC_URLS: dict[SupportedNetwork, str] = {
+    "ethereum": "https://eth.llamarpc.com",
+    "base": "https://mainnet.base.org",
+    "arbitrum": "https://arb1.arbitrum.io/rpc",
+    "optimism": "https://mainnet.optimism.io",
+    "polygon": "https://polygon-rpc.com",
+    "avalanche": "https://api.avax.network/ext/bc/C/rpc",
+    "ink": "https://rpc-qnd.ink.xyz",
+    "berachain": "https://artio.rpc.berachain.com",
+    "unichain": "https://mainnet.unichain.org",
+}
+
+# USDC contract addresses by network
+USDC_ADDRESSES: dict[SupportedNetwork, str] = {
+    "ethereum": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+    "base": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+    "arbitrum": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+    "optimism": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
+    "polygon": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+    "avalanche": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
+    "ink": "0x0200C29006150606B650577BBE7B6248F58470c1",
+    "berachain": "0x779Ded0c9e1022225f8E0630b35a9b54bE713736",
+    "unichain": "0x588ce4F028D8e7B53B687865d6A67b3A54C75518",
+}
+
+# USDT contract addresses by network
+USDT_ADDRESSES: dict[SupportedNetwork, str] = {
+    "ethereum": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
+    "arbitrum": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
+    "optimism": "0x94b008aA00579c1307B0EF2c499aD98a8ce58e58",
+    "polygon": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
+    "avalanche": "0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7",
+}
+
+# USDT0 OFT contract addresses (LayerZero bridgeable)
+USDT0_ADDRESSES: dict[SupportedNetwork, str] = {
+    "ethereum": "0x6C96dE32CEa08842dcc4058c14d3aaAD7Fa41dee",
+    "arbitrum": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
+    "ink": "0x0200C29006150606B650577BBE7B6248F58470c1",
+    "berachain": "0x779Ded0c9e1022225f8E0630b35a9b54bE713736",
+    "unichain": "0x588ce4F028D8e7B53B687865d6A67b3A54C75518",
+}
+
+# Networks that support USDT0 bridging via LayerZero
+BRIDGEABLE_CHAINS: list[SupportedNetwork] = [
+    "ethereum",
+    "arbitrum",
+    "ink",
+    "berachain",
+    "unichain",
+]
+
+# Networks that support ERC-4337 gasless payments
+GASLESS_NETWORKS: list[SupportedNetwork] = [
+    "ethereum",
+    "base",
+    "arbitrum",
+    "optimism",
+    "polygon",
+    "avalanche",
+]
+
+# LayerZero endpoint IDs for bridging
+LAYERZERO_ENDPOINT_IDS: dict[SupportedNetwork, int] = {
+    "ethereum": 30101,
+    "arbitrum": 30110,
+    "ink": 30291,
+    "berachain": 30362,
+    "unichain": 30320,
+}
+
+# LayerZero Scan URL for tracking bridge messages
+LAYERZERO_SCAN_URL = "https://layerzeroscan.com/tx/"
+
+# All supported networks
+ALL_NETWORKS: list[SupportedNetwork] = [
+    "ethereum",
+    "base",
+    "arbitrum",
+    "optimism",
+    "polygon",
+    "avalanche",
+    "ink",
+    "berachain",
+    "unichain",
+]
+
+# Token decimals
+TOKEN_DECIMALS = 6
+NATIVE_DECIMALS = 18
+
+
+def is_valid_network(network: str) -> bool:
+    """Check if a network string is valid."""
+    return network in ALL_NETWORKS
+
+
+def is_bridgeable_chain(network: str) -> bool:
+    """Check if a network supports USDT0 bridging."""
+    return network in BRIDGEABLE_CHAINS
+
+
+def is_gasless_network(network: str) -> bool:
+    """Check if a network supports ERC-4337 gasless payments."""
+    return network in GASLESS_NETWORKS
+
+
+def get_token_address(
+    network: SupportedNetwork, token: SupportedToken
+) -> Optional[str]:
+    """Get the token contract address for a network."""
+    if token == "USDC":
+        return USDC_ADDRESSES.get(network)
+    elif token == "USDT":
+        return USDT_ADDRESSES.get(network)
+    elif token == "USDT0":
+        return USDT0_ADDRESSES.get(network)
+    return None
+
+
+def get_explorer_tx_url(network: SupportedNetwork, tx_hash: str) -> str:
+    """Get the explorer URL for a transaction."""
+    base_url = EXPLORER_URLS.get(network, "")
+    if not base_url:
+        return ""
+    return f"{base_url}/tx/{tx_hash}"
+
+
+def get_rpc_url(config: Optional[ServerConfig], network: SupportedNetwork) -> str:
+    """Get the RPC URL for a network, using config override if available."""
+    if config and config.rpc_urls and network in config.rpc_urls:
+        return config.rpc_urls[network]
+    return DEFAULT_RPC_URLS.get(network, "")
+
+
+def format_token_amount(amount: int, decimals: int) -> str:
+    """Format a raw token amount with decimals to human-readable string."""
+    if amount == 0:
+        return "0"
+
+    divisor = 10**decimals
+    whole = amount // divisor
+    fraction = amount % divisor
+
+    if fraction == 0:
+        return str(whole)
+
+    # Format fraction and trim trailing zeros
+    fraction_str = str(fraction).zfill(decimals).rstrip("0")
+    return f"{whole}.{fraction_str}"
+
+
+def parse_token_amount(amount: str, decimals: int) -> int:
+    """Parse a human-readable amount string to raw token units."""
+    parts = amount.split(".")
+
+    whole = int(parts[0])
+    result = whole * (10**decimals)
+
+    if len(parts) == 2:
+        frac = parts[1]
+        if len(frac) > decimals:
+            frac = frac[:decimals]
+        frac = frac.ljust(decimals, "0")
+        result += int(frac)
+
+    return result