feat(python-sdk): unify evm/tron permit2 flow and add extension coverage

e2e/.env-local

@@ -1,10 +1,36 @@
-# E2E Test Configuration
-SERVER_EVM_ADDRESS=
-SERVER_SVM_ADDRESS=
-SERVER_STELLAR_ADDRESS=
-CLIENT_EVM_PRIVATE_KEY=
-CLIENT_SVM_PRIVATE_KEY=
-CLIENT_STELLAR_PRIVATE_KEY=
-FACILITATOR_EVM_PRIVATE_KEY=
-FACILITATOR_SVM_PRIVATE_KEY=
-FACILITATOR_STELLAR_PRIVATE_KEY=
+# E2E Environment Template
+# Copy to .env and fill in real values.
+
+# Client wallets
+CLIENT_EVM_PRIVATE_KEY=0x...
+CLIENT_SVM_PRIVATE_KEY=...
+CLIENT_APTOS_PRIVATE_KEY=...
+CLIENT_STELLAR_PRIVATE_KEY=...
+CLIENT_TRON_PRIVATE_KEY=...
+
+# Server payment addresses
+SERVER_EVM_ADDRESS=0x...
+SERVER_SVM_ADDRESS=...
+SERVER_APTOS_ADDRESS=...
+SERVER_STELLAR_ADDRESS=...
+SERVER_TRON_ADDRESS=...
+EVM_FACILITATOR_ADDRESS=0x...
+TRON_FACILITATOR_ADDRESS=...
+
+# Facilitator wallets
+FACILITATOR_EVM_PRIVATE_KEY=0x...
+FACILITATOR_SVM_PRIVATE_KEY=...
+FACILITATOR_APTOS_PRIVATE_KEY=...
+FACILITATOR_STELLAR_PRIVATE_KEY=...
+FACILITATOR_TRON_PRIVATE_KEY=...
+
+# Optional network overrides
+# EVM_NETWORK=eip155:97
+# TRON_NETWORK=tron:nile
+
+# Optional RPC overrides
+# BSC_TESTNET_RPC_URL=https://bsc-testnet-rpc.publicnode.com
+# TRON_NILE_RPC_URL=https://nile.trongrid.io
+# SOLANA_DEVNET_RPC_URL=https://api.devnet.solana.com
+# APTOS_TESTNET_RPC_URL=https://fullnode.testnet.aptoslabs.com/v1
+# STELLAR_TESTNET_RPC_URL=https://soroban-testnet.stellar.org

e2e/README.md

@@ -101,12 +101,15 @@ SERVER_EVM_ADDRESS=0x...            # Where servers receive EVM payments
 SERVER_SVM_ADDRESS=...              # Where servers receive Solana payments
 SERVER_APTOS_ADDRESS=0x...          # Where servers receive Aptos payments
 SERVER_STELLAR_ADDRESS=...          # Where servers receive Stellar payments
+SERVER_TRON_ADDRESS=...             # Where servers receive TRON payments
+TRON_FACILITATOR_ADDRESS=...        # TRON facilitator address for Permit2 (base58)
 
 # Facilitator wallets (for payment verification/settlement)
 FACILITATOR_EVM_PRIVATE_KEY=0x...   # EVM private key for facilitator
 FACILITATOR_SVM_PRIVATE_KEY=...     # Solana private key for facilitator
 FACILITATOR_APTOS_PRIVATE_KEY=...   # Aptos private key for facilitator (hex string)
 FACILITATOR_STELLAR_PRIVATE_KEY=... # Stellar private key for facilitator
+FACILITATOR_TRON_PRIVATE_KEY=...    # TRON private key for facilitator
 ```
 
 ### Account Setup Instructions

e2e/clients/axios/index.ts

@@ -1,6 +1,7 @@
 import { config } from "dotenv";
 import axios from "axios";
 import { wrapAxiosWithPayment, decodePaymentResponseHeader } from "@bankofai/x402-axios";
+import { decodePaymentRequiredHeader } from "@bankofai/x402-core/http";
 import { createPublicClient, http } from "viem";
 import { privateKeyToAccount } from "viem/accounts";
 import { bscTestnet } from "viem/chains";
@@ -107,11 +108,31 @@ axiosWithPayment
     process.exit(0);
   })
   .catch(error => {
+    const status = error.response?.status || 500;
+    const headers = error.response?.headers || {};
+    const paymentRequiredHeader = headers["payment-required"] || headers["x-payment"];
+    const paymentResponseHeader = headers["payment-response"] || headers["x-payment-response"];
+
+    let paymentRequired = undefined;
+    let paymentResponse = undefined;
+    if (paymentRequiredHeader) {
+      try {
+        paymentRequired = decodePaymentRequiredHeader(paymentRequiredHeader);
+      } catch {}
+    }
+    if (paymentResponseHeader) {
+      try {
+        paymentResponse = decodePaymentResponseHeader(paymentResponseHeader);
+      } catch {}
+    }
+
     console.error(
       JSON.stringify({
         success: false,
         error: error.message || "Request failed",
-        status_code: error.response?.status || 500,
+        status_code: status,
+        payment_required: paymentRequired,
+        payment_response: paymentResponse,
       }),
     );
     process.exit(1);

e2e/clients/httpx/main.py

@@ -8,12 +8,14 @@
 
 # Import from new x402 package
 from bankofai.x402 import x402Client
-from bankofai.x402.http import decode_payment_response_header
+from bankofai.x402.http import decode_payment_response_header, decode_payment_required_header
 from bankofai.x402.http.clients import x402_httpx_transport
 from bankofai.x402.mechanisms.evm import EthAccountSigner
 from bankofai.x402.mechanisms.evm.exact import register_exact_evm_client
 from bankofai.x402.mechanisms.svm import KeypairSigner
 from bankofai.x402.mechanisms.svm.exact import register_exact_svm_client
+from bankofai.x402.mechanisms.tron.signers import ClientTronSigner
+from bankofai.x402.mechanisms.tron.exact import register_exact_tron_client
 import httpx
 
 # Load environment variables
@@ -22,6 +24,8 @@
 # Get environment variables
 evm_private_key = os.getenv("EVM_PRIVATE_KEY")
 svm_private_key = os.getenv("SVM_PRIVATE_KEY")
+tron_private_key = os.getenv("TRON_PRIVATE_KEY")
+tron_rpc_url = os.getenv("TRON_RPC_URL")
 base_url = os.getenv("RESOURCE_SERVER_URL")
 endpoint_path = os.getenv("ENDPOINT_PATH")
 
@@ -54,9 +58,17 @@ async def main():
         svm_signer = KeypairSigner.from_base58(svm_private_key)
         register_exact_svm_client(client, svm_signer)
 
+    # Register TRON exact scheme if private key is available
+    if tron_private_key:
+        tron_signer = ClientTronSigner(
+            private_key=tron_private_key,
+            full_node=tron_rpc_url or "https://nile.trongrid.io",
+        )
+        register_exact_tron_client(client, tron_signer)
+
     # Create httpx client with x402 payment transport and increased timeout
-    # Set timeout to 30 seconds to handle busy servers during test runs
-    timeout = httpx.Timeout(30.0, connect=10.0)
+    # Set timeout to 90 seconds to handle slow on-chain settlement during test runs
+    timeout = httpx.Timeout(90.0, connect=10.0)
     async with httpx.AsyncClient(
         base_url=base_url,
         timeout=timeout,
@@ -76,6 +88,7 @@ async def main():
                 "data": response_data,
                 "status_code": response.status_code,
                 "payment_response": None,
+                "payment_required": None,
             }
 
             # Check for payment response header (V2: PAYMENT-RESPONSE, V1: X-PAYMENT-RESPONSE)
@@ -86,6 +99,13 @@ async def main():
                 payment_response = decode_payment_response_header(payment_header)
                 result["payment_response"] = payment_response.model_dump()
 
+            payment_required_header = response.headers.get("PAYMENT-REQUIRED") or response.headers.get(
+                "X-PAYMENT"
+            )
+            if payment_required_header:
+                payment_required = decode_payment_required_header(payment_required_header)
+                result["payment_required"] = payment_required.model_dump()
+
             # Output structured result as JSON for proxy to parse
             print(json.dumps(result))
             exit(0)

e2e/clients/httpx/pyproject.toml

@@ -5,7 +5,7 @@ description = "Python httpx client for x402 e2e tests"
 requires-python = ">=3.10"
 dependencies = [
     "python-dotenv>=1.0.0",
-    "bankofai.x402[httpx,evm,svm,extensions]"
+    "bankofai.x402[httpx,evm,svm,tron,extensions]"
 ]
 
 [build-system]

e2e/clients/httpx/test.config.json

@@ -4,14 +4,18 @@
   "language": "python",
   "protocolFamilies": [
     "evm",
-    "svm"
+    "svm",
+    "tron"
   ],
   "x402Versions": [
     1,
     2
   ],
   "evm": {
-    "transferMethods": ["eip3009"]
+    "transferMethods": ["eip3009", "permit2"]
+  },
+  "tron": {
+    "transferMethods": ["transferWithAuthorization", "permit2"]
   },
   "description": "Python httpx client with x402 v2 payment hooks",
   "environment": {
@@ -21,7 +25,9 @@
     ],
     "optional": [
       "EVM_PRIVATE_KEY",
-      "SVM_PRIVATE_KEY"
+      "SVM_PRIVATE_KEY",
+      "TRON_PRIVATE_KEY",
+      "TRON_RPC_URL"
     ]
   }
-}
+}