t402 1.7.1__py3-none-any.whl → 1.9.1__py3-none-any.whl

t402/__init__.py

@@ -1,5 +1,5 @@
 # Package version
-__version__ = "1.6.2"
+__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/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/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/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/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/chains.py

@@ -1,8 +1,38 @@
 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",
 }
 
 
@@ -21,6 +51,7 @@ def get_chain_id(network: str) -> str:
 
 
 KNOWN_TOKENS = {
+    # Base Sepolia (testnet)
     "84532": [
         {
             "human_name": "usdc",
@@ -30,15 +61,17 @@ KNOWN_TOKENS = {
             "version": "2",
         }
     ],
+    # Base Mainnet
     "8453": [
         {
             "human_name": "usdc",
             "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-            "name": "USD Coin",  # needs to be exactly what is returned by name() on contract
+            "name": "USD Coin",
             "decimals": 6,
             "version": "2",
         }
     ],
+    # Avalanche Fuji (testnet)
     "43113": [
         {
             "human_name": "usdc",
@@ -48,6 +81,7 @@ KNOWN_TOKENS = {
             "version": "2",
         }
     ],
+    # Avalanche Mainnet
     "43114": [
         {
             "human_name": "usdc",
@@ -57,6 +91,239 @@ KNOWN_TOKENS = {
             "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",
+        }
+    ],
 }
 
 

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/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)