t402 1.9.0__tar.gz → 1.9.1__tar.gz

{t402-1.9.0 → t402-1.9.1}/.gitignore

@@ -7,9 +7,12 @@ coverage/
 proxy
 .env
 __pycache__/
+.coverage
 **/.DS_Store
 e2e/facilitators/external-proxies/*
 !e2e/facilitators/external-proxies/README.md
 .vercel
 .env*.local
+.wrangler/
+.claude/settings.local.json
 api-docs/

{t402-1.9.0 → t402-1.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: t402
-Version: 1.9.0
+Version: 1.9.1
 Summary: t402: An internet native payments protocol
 Author-email: T402 Team <dev@t402.io>
 License: Apache-2.0
@@ -389,6 +389,47 @@ result = await bridge.bridge(
 )
 ```
 
+## Deprecation Notice: exact-legacy Scheme
+
+> **⚠️ Deprecated in v2.3.0**: The `exact-legacy` scheme is deprecated and will be removed in v3.0.0.
+
+The `exact-legacy` scheme uses the traditional `approve + transferFrom` pattern for legacy USDT tokens. This has been superseded by the `exact` scheme with USDT0.
+
+### Why Migrate?
+
+| Feature | exact-legacy | exact (USDT0) |
+|---------|--------------|---------------|
+| Transactions | 2 (approve + transfer) | 1 (single signature) |
+| Gas Cost | User pays gas | Gasless (EIP-3009) |
+| Chains | ~5 chains | 19+ chains |
+| Cross-chain | ❌ | ✅ LayerZero bridge |
+
+### Migration Guide
+
+```python
+# Before (deprecated)
+from t402.schemes.evm import ExactLegacyEvmClientScheme, ExactLegacyEvmServerScheme
+
+client_scheme = ExactLegacyEvmClientScheme(signer)
+server_scheme = ExactLegacyEvmServerScheme()
+
+# After (recommended)
+from t402.schemes.evm import ExactEvmClientScheme, ExactEvmServerScheme
+
+client_scheme = ExactEvmClientScheme(signer)
+server_scheme = ExactEvmServerScheme()
+```
+
+### USDT0 Token Addresses
+
+| Chain | USDT0 Address |
+|-------|---------------|
+| Ethereum | `0x6C96dE32CEa08842dcc4058c14d3aaAD7Fa41dee` |
+| Arbitrum | `0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9` |
+| Ink | `0x0200C29006150606B650577BBE7B6248F58470c1` |
+| Berachain | `0x779Ded0c9e1022225f8E0630b35a9b54bE713736` |
+| And 15+ more... | See [USDT0 documentation](https://docs.t402.io/networks/usdt0) |
+
 ## WDK Integration
 
 Tether Wallet Development Kit support:

{t402-1.9.0 → t402-1.9.1}/README.md

@@ -364,6 +364,47 @@ result = await bridge.bridge(
 )
 ```
 
+## Deprecation Notice: exact-legacy Scheme
+
+> **⚠️ Deprecated in v2.3.0**: The `exact-legacy` scheme is deprecated and will be removed in v3.0.0.
+
+The `exact-legacy` scheme uses the traditional `approve + transferFrom` pattern for legacy USDT tokens. This has been superseded by the `exact` scheme with USDT0.
+
+### Why Migrate?
+
+| Feature | exact-legacy | exact (USDT0) |
+|---------|--------------|---------------|
+| Transactions | 2 (approve + transfer) | 1 (single signature) |
+| Gas Cost | User pays gas | Gasless (EIP-3009) |
+| Chains | ~5 chains | 19+ chains |
+| Cross-chain | ❌ | ✅ LayerZero bridge |
+
+### Migration Guide
+
+```python
+# Before (deprecated)
+from t402.schemes.evm import ExactLegacyEvmClientScheme, ExactLegacyEvmServerScheme
+
+client_scheme = ExactLegacyEvmClientScheme(signer)
+server_scheme = ExactLegacyEvmServerScheme()
+
+# After (recommended)
+from t402.schemes.evm import ExactEvmClientScheme, ExactEvmServerScheme
+
+client_scheme = ExactEvmClientScheme(signer)
+server_scheme = ExactEvmServerScheme()
+```
+
+### USDT0 Token Addresses
+
+| Chain | USDT0 Address |
+|-------|---------------|
+| Ethereum | `0x6C96dE32CEa08842dcc4058c14d3aaAD7Fa41dee` |
+| Arbitrum | `0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9` |
+| Ink | `0x0200C29006150606B650577BBE7B6248F58470c1` |
+| Berachain | `0x779Ded0c9e1022225f8E0630b35a9b54bE713736` |
+| And 15+ more... | See [USDT0 documentation](https://docs.t402.io/networks/usdt0) |
+
 ## WDK Integration
 
 Tether Wallet Development Kit support:

{t402-1.9.0 → t402-1.9.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "t402"
-version = "1.9.0"
+version = "1.9.1"
 description = "t402: An internet native payments protocol"
 readme = "README.md"
 license = { text = "Apache-2.0" }
@@ -50,6 +50,7 @@ dev = [
 
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
+pythonpath = ["src"]
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/t402"]

{t402-1.9.0 → t402-1.9.1}/src/t402/__init__.py

@@ -1,5 +1,5 @@
 # Package version
-__version__ = "1.7.1"
+__version__ = "1.9.0"
 
 # Re-export commonly used items for convenience
 from t402.common import (
@@ -290,6 +290,7 @@ from t402.fastapi import (
     settle_payment,
 )
 
+
 def hello() -> str:
     return "Hello from t402!"
 

{t402-1.9.0 → t402-1.9.1}/src/t402/bridge/client.py

@@ -1,6 +1,5 @@
 """USDT0 Bridge Client for LayerZero OFT transfers."""
 
-
 from .constants import (
     DEFAULT_EXTRA_OPTIONS,
     DEFAULT_SLIPPAGE,
@@ -73,7 +72,7 @@ class Usdt0Bridge:
         if not supports_bridging(chain):
             raise ValueError(
                 f'Chain "{chain}" does not support USDT0 bridging. '
-                f'Supported chains: {", ".join(get_bridgeable_chains())}'
+                f"Supported chains: {', '.join(get_bridgeable_chains())}"
             )
 
         self._signer = signer
@@ -107,7 +106,9 @@ class Usdt0Bridge:
             False,
         )
 
-        native_fee = fee[0] if isinstance(fee, (list, tuple)) else fee.get("nativeFee", 0)
+        native_fee = (
+            fee[0] if isinstance(fee, (list, tuple)) else fee.get("nativeFee", 0)
+        )
 
         return BridgeQuote(
             native_fee=int(native_fee),
@@ -139,7 +140,11 @@ class Usdt0Bridge:
             )
         )
 
-        slippage = params.slippage_tolerance if params.slippage_tolerance > 0 else DEFAULT_SLIPPAGE
+        slippage = (
+            params.slippage_tolerance
+            if params.slippage_tolerance > 0
+            else DEFAULT_SLIPPAGE
+        )
         oft_address = get_usdt0_oft_address(params.from_chain)
         send_param = self._build_send_param(
             params.to_chain, params.amount, params.recipient, slippage
@@ -304,7 +309,10 @@ class Usdt0Bridge:
     def _extract_message_guid(self, receipt: BridgeTransactionReceipt) -> str:
         """Extract LayerZero message GUID from OFTSent event logs."""
         for log in receipt.logs:
-            if len(log.topics) >= 2 and log.topics[0].lower() == OFT_SENT_EVENT_TOPIC.lower():
+            if (
+                len(log.topics) >= 2
+                and log.topics[0].lower() == OFT_SENT_EVENT_TOPIC.lower()
+            ):
                 # GUID is the first indexed parameter (topics[1])
                 return log.topics[1]
 

{t402-1.9.0 → t402-1.9.1}/src/t402/bridge/constants.py

@@ -251,7 +251,9 @@ def address_to_bytes32(address: str) -> bytes:
     addr = address.lower().removeprefix("0x")
 
     if len(addr) != 40:
-        raise ValueError(f"Invalid address length: expected 40 hex chars, got {len(addr)}")
+        raise ValueError(
+            f"Invalid address length: expected 40 hex chars, got {len(addr)}"
+        )
 
     try:
         addr_bytes = bytes.fromhex(addr)

{t402-1.9.0 → t402-1.9.1}/src/t402/bridge/router.py

@@ -199,7 +199,7 @@ class CrossChainPaymentRouter:
             raise ValueError(
                 f'Cannot route payment from "{params.source_chain}" to '
                 f'"{params.destination_chain}". '
-                f'Supported chains: {", ".join(get_bridgeable_chains())}'
+                f"Supported chains: {', '.join(get_bridgeable_chains())}"
             )
 
         if params.amount <= 0:

{t402-1.9.0 → t402-1.9.1}/src/t402/bridge/scan.py

@@ -206,7 +206,9 @@ class LayerZeroScanClient:
             dst_tx_hash=data.get("dstTxHash"),
             status=LayerZeroMessageStatus(data.get("status") or "INFLIGHT"),
             src_block_number=int(data.get("srcBlockNumber") or 0),
-            dst_block_number=int(data.get("dstBlockNumber")) if data.get("dstBlockNumber") else None,
+            dst_block_number=int(data.get("dstBlockNumber"))
+            if data.get("dstBlockNumber")
+            else None,
             created=data.get("created") or data.get("createdAt") or "",
             updated=data.get("updated") or data.get("updatedAt") or "",
         )

t402-1.9.1/src/t402/chains.py

@@ -0,0 +1,359 @@
+NETWORK_TO_ID = {
+    # Standard networks
+    "base-sepolia": "84532",
+    "base": "8453",
+    "avalanche-fuji": "43113",
+    "avalanche": "43114",
+    # Core USDT0 Networks
+    "ethereum": "1",
+    "arbitrum": "42161",
+    "optimism": "10",
+    "polygon": "137",
+    "ink": "57073",
+    "berachain": "80094",
+    "unichain": "130",
+    # Phase 1: High Priority USDT0 Networks
+    "mantle": "5000",
+    "plasma": "9745",
+    "sei": "1329",
+    "conflux": "1030",
+    "monad": "143",
+    # Phase 2: Medium Priority USDT0 Networks
+    "flare": "14",
+    "rootstock": "30",
+    "xlayer": "196",
+    "stable": "988",
+    "hyperevm": "999",
+    "megaeth": "4326",
+    "corn": "21000000",
+    # Legacy USDT Networks (no EIP-3009 support)
+    "bnb": "56",
+    "bsc": "56",
+    "fantom": "250",
+    "celo": "42220",
+    "kaia": "8217",
+    "klaytn": "8217",
+}
+
+
+def get_chain_id(network: str) -> str:
+    """Get the chain ID for a given network
+    Supports string encoded chain IDs and human readable networks
+    """
+    try:
+        int(network)
+        return network
+    except ValueError:
+        pass
+    if network not in NETWORK_TO_ID:
+        raise ValueError(f"Unsupported network: {network}")
+    return NETWORK_TO_ID[network]
+
+
+KNOWN_TOKENS = {
+    # Base Sepolia (testnet)
+    "84532": [
+        {
+            "human_name": "usdc",
+            "address": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+            "name": "USDC",
+            "decimals": 6,
+            "version": "2",
+        }
+    ],
+    # Base Mainnet
+    "8453": [
+        {
+            "human_name": "usdc",
+            "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+            "name": "USD Coin",
+            "decimals": 6,
+            "version": "2",
+        }
+    ],
+    # Avalanche Fuji (testnet)
+    "43113": [
+        {
+            "human_name": "usdc",
+            "address": "0x5425890298aed601595a70AB815c96711a31Bc65",
+            "name": "USD Coin",
+            "decimals": 6,
+            "version": "2",
+        }
+    ],
+    # Avalanche Mainnet
+    "43114": [
+        {
+            "human_name": "usdc",
+            "address": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
+            "name": "USDC",
+            "decimals": 6,
+            "version": "2",
+        }
+    ],
+    # === USDT0 Networks ===
+    # Ethereum Mainnet
+    "1": [
+        {
+            "human_name": "usdt0",
+            "address": "0x6C96dE32CEa08842dcc4058c14d3aaAD7Fa41dee",
+            "name": "TetherToken",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # Arbitrum One
+    "42161": [
+        {
+            "human_name": "usdt0",
+            "address": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
+            "name": "TetherToken",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # Optimism
+    "10": [
+        {
+            "human_name": "usdt0",
+            "address": "0x01bFF41798a0BcF287b996046Ca68b395DbC1071",
+            "name": "TetherToken",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # Polygon
+    "137": [
+        {
+            "human_name": "usdt0",
+            "address": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
+            "name": "TetherToken",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # Ink
+    "57073": [
+        {
+            "human_name": "usdt0",
+            "address": "0x0200C29006150606B650577BBE7B6248F58470c1",
+            "name": "TetherToken",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # Berachain
+    "80094": [
+        {
+            "human_name": "usdt0",
+            "address": "0x779Ded0c9e1022225f8E0630b35a9b54bE713736",
+            "name": "TetherToken",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # Unichain
+    "130": [
+        {
+            "human_name": "usdt0",
+            "address": "0x9151434b16b9763660705744891fA906F660EcC5",
+            "name": "TetherToken",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # Mantle
+    "5000": [
+        {
+            "human_name": "usdt0",
+            "address": "0x779Ded0c9e1022225f8E0630b35a9b54bE713736",
+            "name": "TetherToken",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # Plasma
+    "9745": [
+        {
+            "human_name": "usdt0",
+            "address": "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb",
+            "name": "TetherToken",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # Sei
+    "1329": [
+        {
+            "human_name": "usdt0",
+            "address": "0x9151434b16b9763660705744891fA906F660EcC5",
+            "name": "TetherToken",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # Conflux eSpace
+    "1030": [
+        {
+            "human_name": "usdt0",
+            "address": "0xaf37E8B6C9ED7f6318979f56Fc287d76c30847ff",
+            "name": "TetherToken",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # Monad
+    "143": [
+        {
+            "human_name": "usdt0",
+            "address": "0xe7cd86e13AC4309349F30B3435a9d337750fC82D",
+            "name": "TetherToken",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # Flare
+    "14": [
+        {
+            "human_name": "usdt0",
+            "address": "0xe7cd86e13AC4309349F30B3435a9d337750fC82D",
+            "name": "TetherToken",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # Rootstock
+    "30": [
+        {
+            "human_name": "usdt0",
+            "address": "0x779dED0C9e1022225F8e0630b35A9B54Be713736",
+            "name": "TetherToken",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # XLayer
+    "196": [
+        {
+            "human_name": "usdt0",
+            "address": "0x779Ded0c9e1022225f8E0630b35a9b54bE713736",
+            "name": "TetherToken",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # Stable
+    "988": [
+        {
+            "human_name": "usdt0",
+            "address": "0x779Ded0c9e1022225f8E0630b35a9b54bE713736",
+            "name": "TetherToken",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # HyperEVM
+    "999": [
+        {
+            "human_name": "usdt0",
+            "address": "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb",
+            "name": "TetherToken",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # MegaETH
+    "4326": [
+        {
+            "human_name": "usdt0",
+            "address": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
+            "name": "TetherToken",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # Corn
+    "21000000": [
+        {
+            "human_name": "usdt0",
+            "address": "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb",
+            "name": "TetherToken",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # === Legacy USDT Networks (no EIP-3009 support) ===
+    # BNB Chain (BSC)
+    "56": [
+        {
+            "human_name": "usdt",
+            "address": "0x55d398326f99059fF775485246999027B3197955",
+            "name": "Tether USD",
+            "decimals": 18,
+            "version": "1",
+        }
+    ],
+    # Avalanche C-Chain (already in KNOWN_TOKENS via "43114", add USDT)
+    # Fantom
+    "250": [
+        {
+            "human_name": "usdt",
+            "address": "0x049d68029688eabf473097a2fc38ef61633a3c7a",
+            "name": "Frapped USDT",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+    # Celo
+    "42220": [
+        {
+            "human_name": "usdt",
+            "address": "0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e",
+            "name": "Tether USD",
+            "decimals": 18,
+            "version": "1",
+        }
+    ],
+    # Kaia (formerly Klaytn)
+    "8217": [
+        {
+            "human_name": "usdt",
+            "address": "0xcee8faf64bb97a73bb51e115aa89c17ffa8dd167",
+            "name": "Tether USD",
+            "decimals": 6,
+            "version": "1",
+        }
+    ],
+}
+
+
+def get_token_name(chain_id: str, address: str) -> str:
+    """Get the token name for a given chain and address"""
+    for token in KNOWN_TOKENS[chain_id]:
+        if token["address"] == address:
+            return token["name"]
+    raise ValueError(f"Token not found for chain {chain_id} and address {address}")
+
+
+def get_token_version(chain_id: str, address: str) -> str:
+    """Get the token version for a given chain and address"""
+    for token in KNOWN_TOKENS[chain_id]:
+        if token["address"] == address:
+            return token["version"]
+    raise ValueError(f"Token not found for chain {chain_id} and address {address}")
+
+
+def get_token_decimals(chain_id: str, address: str) -> int:
+    """Get the token decimals for a given chain and address"""
+    for token in KNOWN_TOKENS[chain_id]:
+        if token["address"] == address:
+            return token["decimals"]
+    raise ValueError(f"Token not found for chain {chain_id} and address {address}")
+
+
+def get_default_token_address(chain_id: str, token_type: str = "usdc") -> str:
+    """Get the default token address for a given chain and token type"""
+    for token in KNOWN_TOKENS[chain_id]:
+        if token["human_name"] == token_type:
+            return token["address"]
+    raise ValueError(f"Token type '{token_type}' not found for chain {chain_id}")

{t402-1.9.0 → t402-1.9.1}/src/t402/cli.py

@@ -10,6 +10,7 @@ Usage:
     t402 decode <base64-string>
     t402 version
 """
+
 from __future__ import annotations
 
 import argparse
@@ -20,7 +21,7 @@ from pathlib import Path
 from typing import Any
 
 from . import __version__
-from .encoding import decode_payment, encode_payment
+from .exact import decode_payment, encode_payment
 from .facilitator import FacilitatorClient, FacilitatorConfig
 from .types import PaymentPayload
 
@@ -263,7 +264,16 @@ def cmd_decode(args: argparse.Namespace) -> int:
 
 def cmd_info(args: argparse.Namespace) -> int:
     """Show information about a network."""
-    from .networks import is_evm_network, is_ton_network, is_tron_network
+    from .networks import (
+        is_evm_network,
+        is_ton_network,
+        is_tron_network,
+        is_svm_network,
+        EVM_NETWORK_TO_CHAIN_ID,
+        TON_NETWORKS,
+        TRON_NETWORKS,
+        SVM_NETWORKS,
+    )
 
     network = args.network
 
@@ -272,17 +282,29 @@ def cmd_info(args: argparse.Namespace) -> int:
         "is_evm": is_evm_network(network),
         "is_ton": is_ton_network(network),
         "is_tron": is_tron_network(network),
+        "is_svm": is_svm_network(network),
     }
 
     # Add chain-specific info
     if is_evm_network(network):
-        from .chains import EVM_CHAINS
-
-        chain_id = network.split(":")[1] if ":" in network else network
-        if chain_id in EVM_CHAINS:
-            chain = EVM_CHAINS[chain_id]
-            info["chain_name"] = chain.get("name", "Unknown")
-            info["currency"] = chain.get("currency", "Unknown")
+        chain_id = EVM_NETWORK_TO_CHAIN_ID.get(network)
+        if chain_id:
+            info["chain_id"] = chain_id
+
+    if is_ton_network(network) and network in TON_NETWORKS:
+        net_info = TON_NETWORKS[network]
+        info["name"] = net_info.get("name", "Unknown")
+        info["is_testnet"] = net_info.get("is_testnet", False)
+
+    if is_tron_network(network) and network in TRON_NETWORKS:
+        net_info = TRON_NETWORKS[network]
+        info["name"] = net_info.get("name", "Unknown")
+        info["is_testnet"] = net_info.get("is_testnet", False)
+
+    if is_svm_network(network) and network in SVM_NETWORKS:
+        net_info = SVM_NETWORKS[network]
+        info["name"] = net_info.get("name", "Unknown")
+        info["is_testnet"] = net_info.get("is_testnet", False)
 
     if args.output == "json":
         print(json.dumps(info, indent=2))

{t402-1.9.0 → t402-1.9.1}/src/t402/common.py

@@ -34,10 +34,12 @@ def parse_money(amount: str | int, address: str, network: str) -> int:
         # 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)