@bankofai/x402-gateway 1.0.1-beta.2 → 1.0.1-beta.4

package/README.md

@@ -66,7 +66,7 @@ curl http://127.0.0.1:4020/__402/health
 Paid provider path:
 
 ```bash
-curl -i http://127.0.0.1:4020/providers/tron-nile-usdt/v1/ping
+curl -i http://127.0.0.1:4020/providers/example-price-tron/v1/ping
 ```
 
 If the endpoint has metering, the gateway returns `402 Payment Required` with a
@@ -118,7 +118,7 @@ deliberately public test deployment, set `X402_GATEWAY_ADMIN_ALLOW_PUBLIC=true`.
 Provider files stay in YAML:
 
 ```yaml
-name: tron-nile-usdt
+name: example-price-tron
 forward_url: ${X402_PROVIDER_FORWARD_URL}
 
 routing:
@@ -129,7 +129,7 @@ routing:
     value_from_env: X402_PROVIDER_API_TOKEN
 
 operator:
-  network: tron-nile
+  network: tron:0xcd8690dc
   currencies:
     usd: ["USDT"]
   recipient: ${X402_PROVIDER_RECIPIENT_TRON}
@@ -149,16 +149,17 @@ endpoints:
             - price_usd: 0.002
 ```
 
-`@bankofai/x402-*` 1.0.1-beta.2 uses `scheme: exact` with
+`@bankofai/x402-*` 1.0.1-beta.4 uses `scheme: exact` with
 `extra.assetTransferMethod: permit2`, or TRON `scheme: exact_gasfree`. Older
 provider configs that say `exact_permit` are normalized to `exact`. For GasFree,
 set both `scheme` and `protocol` to `exact_gasfree`; the facilitator must support
 GasFree for the selected TRON network and token.
 
-Network aliases accepted:
+Non-CAIP TRON aliases are rejected. Provider files must use canonical TRON
+CAIP-2 IDs.
+
+EVM convenience aliases accepted:
 
-- `tron-mainnet` -> `tron:mainnet`
-- `tron-nile` -> `tron:nile`
 - `bsc-mainnet` -> `eip155:56`
 - `bsc-testnet` -> `eip155:97`
 

package/dist/tokens.js

@@ -16,19 +16,25 @@ export const TOKENS = {
     },
 };
 export function normalizeNetwork(network) {
-    return ({
+    const legacyTronIds = {
         "tron-mainnet": "tron:0x2b6653dc",
         "tron:mainnet": "tron:0x2b6653dc",
-        "mainnet": "tron:0x2b6653dc",
+        mainnet: "tron:0x2b6653dc",
         "tron-shasta": "tron:0x94a9059e",
         "tron:shasta": "tron:0x94a9059e",
-        "shasta": "tron:0x94a9059e",
+        shasta: "tron:0x94a9059e",
         "tron-nile": "tron:0xcd8690dc",
         "tron:nile": "tron:0xcd8690dc",
-        "nile": "tron:0xcd8690dc",
+        nile: "tron:0xcd8690dc",
+    };
+    const canonical = legacyTronIds[network];
+    if (canonical) {
+        throw new Error(`legacy TRON network identifier ${network} is not supported; use ${canonical}`);
+    }
+    return {
         "bsc-mainnet": "eip155:56",
         "bsc-testnet": "eip155:97",
-    }[network] ?? network);
+    }[network] ?? network;
 }
 export function getToken(network, symbol) {
     const normalized = normalizeNetwork(network);

package/examples/provider.yml

@@ -1,4 +1,4 @@
-name: tron-nile-usdt
+name: example-price-tron
 title: "TRON Nile USDT Provider"
 description: "TRON Nile provider protected by x402 exact Permit2 USDT payment"
 category: data
@@ -8,8 +8,8 @@ forward_url: ${X402_PROVIDER_FORWARD_URL}
 openapi_url: ${X402_PROVIDER_OPENAPI_URL}
 
 display:
-  service_url: ${X402_GATEWAY_PUBLIC_BASE_URL}/providers/tron-nile-usdt
-  tags: ["tron-nile", "usdt", "x402"]
+  service_url: ${X402_GATEWAY_PUBLIC_BASE_URL}/providers/example-price-tron
+  tags: ["nile", "usdt", "x402"]
 
 discovery:
   use_case: "Use for validating TRON Nile USDT x402 payments."
@@ -18,7 +18,7 @@ discovery:
   when_to_use:
     - "Use when testing x402 exact Permit2 payments on TRON Nile."
   request_examples:
-    - "GET /providers/tron-nile-usdt/v1/ping"
+    - "GET /providers/example-price-tron/v1/ping"
 
 routing:
   type: proxy
@@ -29,7 +29,7 @@ routing:
     value_from_env: X402_PROVIDER_API_TOKEN
 
 operator:
-  network: tron-nile
+  network: tron:0xcd8690dc
   currencies:
     usd: ["USDT"]
   recipient: ${X402_PROVIDER_RECIPIENT_TRON}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bankofai/x402-gateway",
-  "version": "1.0.1-beta.2",
+  "version": "1.0.1-beta.4",
   "private": false,
   "type": "module",
   "files": [