@faremeter/info 0.15.0 → 0.17.0

package/README.md

@@ -24,6 +24,33 @@ pnpm install @faremeter/info
 
 <!-- TSDOC_START -->
 
+## Functions
+
+- [normalizeNetworkId](#normalizenetworkid)
+- [translateNetworkToLegacy](#translatenetworktolegacy)
+
+### normalizeNetworkId
+
+Normalize a legacy network identifier to CAIP-2 format.
+Handles both EVM and Solana networks.
+Returns the input unchanged if no mapping exists (may already be CAIP-2
+or an unknown network).
+
+| Function             | Type                          |
+| -------------------- | ----------------------------- |
+| `normalizeNetworkId` | `(network: string) => string` |
+
+### translateNetworkToLegacy
+
+Translate a CAIP-2 network identifier to legacy format.
+Handles both EVM and Solana networks.
+Returns the input unchanged if no mapping exists (may not be a known
+CAIP-2 network, or may already be legacy).
+
+| Function                   | Type                          |
+| -------------------------- | ----------------------------- |
+| `translateNetworkToLegacy` | `(network: string) => string` |
+
 <!-- TSDOC_END -->
 
 ## Related Packages

package/dist/src/common.d.ts

@@ -6,10 +6,10 @@ export declare function addX402PaymentRequirementDefaults(req: Partial<x402Payme
     maxAmountRequired: string;
     resource: string;
     description: string;
-    mimeType: string;
     payTo: string;
     maxTimeoutSeconds: number;
     asset: string;
+    mimeType?: string;
     outputSchema?: object;
     extra?: object;
 }>;

package/dist/src/evm.d.ts

@@ -1,31 +1,141 @@
 import { type UnitInput } from "./common.js";
 import { Address } from "@faremeter/types/evm";
 declare const knownX402Networks: {
-    readonly base: {
+    readonly "eip155:8453": {
+        readonly legacyName: "base";
         readonly chainId: 8453;
     };
-    readonly "base-sepolia": {
+    readonly "eip155:84532": {
+        readonly legacyName: "base-sepolia";
         readonly chainId: 84532;
     };
-    readonly "skale-europa-testnet": {
+    readonly "eip155:1444673419": {
+        readonly legacyName: "skale-europa-testnet";
         readonly chainId: 1444673419;
     };
+    readonly "eip155:137": {
+        readonly legacyName: "polygon";
+        readonly chainId: 137;
+    };
+    readonly "eip155:80002": {
+        readonly legacyName: "polygon-amoy";
+        readonly chainId: 80002;
+    };
+    readonly "eip155:143": {
+        readonly legacyName: "monad";
+        readonly chainId: 143;
+    };
+    readonly "eip155:10143": {
+        readonly legacyName: "monad-testnet";
+        readonly chainId: 10143;
+    };
+    readonly "eip155:324705682": {
+        readonly legacyName: "skale-base-sepolia";
+        readonly chainId: 324705682;
+    };
+    readonly "eip155:1187947933": {
+        readonly legacyName: "skale-base";
+        readonly chainId: 1187947933;
+    };
 };
-type knownX402Networks = typeof knownX402Networks;
-export type KnownX402Network = keyof knownX402Networks;
-export declare function isKnownX402Network(n: string): n is KnownX402Network;
-export declare function lookupKnownX402Network(n: KnownX402Network): {
-    name: "base" | "base-sepolia" | "skale-europa-testnet";
+type KnownX402Networks = typeof knownX402Networks;
+export type CAIP2Network = keyof KnownX402Networks;
+export type LegacyNetworkName = KnownX402Networks[CAIP2Network]["legacyName"];
+/**
+ * Converts an EVM chain ID to CAIP-2 network identifier.
+ *
+ * @param chainId - The EVM chain ID
+ * @returns The CAIP-2 network identifier (eip155:chainId)
+ */
+export declare function chainIdToCAIP2(chainId: number): string;
+/**
+ * Extracts the EVM chain ID from a CAIP-2 network identifier.
+ *
+ * @param caip2 - The CAIP-2 network identifier
+ * @returns The chain ID, or null if not a valid eip155 identifier
+ */
+export declare function caip2ToChainId(caip2: string): number | null;
+/**
+ * Converts a legacy EVM network name to CAIP-2 format.
+ *
+ * @param legacy - Legacy network name (e.g., "base", "polygon")
+ * @returns The CAIP-2 network identifier, or null if unknown
+ */
+export declare function legacyNameToCAIP2(legacy: string): string | null;
+/**
+ * Converts a CAIP-2 network identifier to legacy EVM network name.
+ *
+ * @param caip2 - The CAIP-2 network identifier
+ * @returns The legacy network name, or null if unknown
+ */
+export declare function caip2ToLegacyName(caip2: string): string | null;
+/**
+ * Normalizes an EVM network identifier to CAIP-2 format.
+ *
+ * Accepts chain IDs (number or string), legacy names, or CAIP-2 identifiers.
+ * Returns the input unchanged if no mapping exists.
+ *
+ * @param network - The network identifier in any supported format
+ * @returns The CAIP-2 network identifier
+ */
+export declare function normalizeNetworkId(network: string | number): string;
+/**
+ * Type guard that checks if a string is a known EVM CAIP-2 network.
+ *
+ * @param n - The string to check
+ * @returns True if the string is a known EVM CAIP-2 network identifier
+ */
+export declare function isKnownCAIP2Network(n: string): n is CAIP2Network;
+/**
+ * Looks up network information by CAIP-2 identifier.
+ *
+ * @param n - The CAIP-2 network identifier
+ * @returns Network information including legacy name and chain ID
+ */
+export declare function lookupKnownCAIP2Network(n: CAIP2Network): {
+    caip2: "eip155:8453" | "eip155:84532" | "eip155:1444673419" | "eip155:137" | "eip155:80002" | "eip155:143" | "eip155:10143" | "eip155:324705682" | "eip155:1187947933";
+    legacyName: "base";
     chainId: 8453;
 } | {
-    name: "base" | "base-sepolia" | "skale-europa-testnet";
+    caip2: "eip155:8453" | "eip155:84532" | "eip155:1444673419" | "eip155:137" | "eip155:80002" | "eip155:143" | "eip155:10143" | "eip155:324705682" | "eip155:1187947933";
+    legacyName: "base-sepolia";
     chainId: 84532;
 } | {
-    name: "base" | "base-sepolia" | "skale-europa-testnet";
+    caip2: "eip155:8453" | "eip155:84532" | "eip155:1444673419" | "eip155:137" | "eip155:80002" | "eip155:143" | "eip155:10143" | "eip155:324705682" | "eip155:1187947933";
+    legacyName: "skale-europa-testnet";
     chainId: 1444673419;
+} | {
+    caip2: "eip155:8453" | "eip155:84532" | "eip155:1444673419" | "eip155:137" | "eip155:80002" | "eip155:143" | "eip155:10143" | "eip155:324705682" | "eip155:1187947933";
+    legacyName: "polygon";
+    chainId: 137;
+} | {
+    caip2: "eip155:8453" | "eip155:84532" | "eip155:1444673419" | "eip155:137" | "eip155:80002" | "eip155:143" | "eip155:10143" | "eip155:324705682" | "eip155:1187947933";
+    legacyName: "polygon-amoy";
+    chainId: 80002;
+} | {
+    caip2: "eip155:8453" | "eip155:84532" | "eip155:1444673419" | "eip155:137" | "eip155:80002" | "eip155:143" | "eip155:10143" | "eip155:324705682" | "eip155:1187947933";
+    legacyName: "monad";
+    chainId: 143;
+} | {
+    caip2: "eip155:8453" | "eip155:84532" | "eip155:1444673419" | "eip155:137" | "eip155:80002" | "eip155:143" | "eip155:10143" | "eip155:324705682" | "eip155:1187947933";
+    legacyName: "monad-testnet";
+    chainId: 10143;
+} | {
+    caip2: "eip155:8453" | "eip155:84532" | "eip155:1444673419" | "eip155:137" | "eip155:80002" | "eip155:143" | "eip155:10143" | "eip155:324705682" | "eip155:1187947933";
+    legacyName: "skale-base-sepolia";
+    chainId: 324705682;
+} | {
+    caip2: "eip155:8453" | "eip155:84532" | "eip155:1444673419" | "eip155:137" | "eip155:80002" | "eip155:143" | "eip155:10143" | "eip155:324705682" | "eip155:1187947933";
+    legacyName: "skale-base";
+    chainId: 1187947933;
 };
-export type x402Network = KnownX402Network | `eip155:${number}`;
-export declare function lookupX402Network(chainId: number): x402Network;
+/**
+ * Looks up the x402 network identifier for an EVM chain ID.
+ *
+ * @param chainId - The EVM chain ID
+ * @returns The CAIP-2 network identifier
+ */
+export declare function lookupX402Network(chainId: number): string;
 export type ContractInfo = {
     address: Address;
     contractName: string;
@@ -36,15 +146,15 @@ export type ContractInfo = {
 declare const knownAssets: {
     readonly USDC: {
         readonly network: {
-            readonly "base-sepolia": {
+            readonly "eip155:84532": {
                 readonly address: "0x036cbd53842c5426634e7929541ec2318f3dcf7e";
                 readonly contractName: "USDC";
             };
-            readonly base: {
+            readonly "eip155:8453": {
                 readonly address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
                 readonly contractName: "USD Coin";
             };
-            readonly "skale-europa-testnet": {
+            readonly "eip155:1444673419": {
                 readonly address: "0x9eAb55199f4481eCD7659540A17Af618766b07C4";
                 readonly contractName: "USDC";
                 readonly forwarder: "0x7779B0d1766e6305E5f8081E3C0CDF58FcA24330";
@@ -67,14 +177,29 @@ declare const knownAssets: {
                 readonly address: "0x534b2f3A21130d7a60830c2Df862319e593943A3";
                 readonly contractName: "USDC";
             };
+            readonly "eip155:324705682": {
+                readonly address: "0x2e08028E3C4c2356572E096d8EF835cD5C6030bD";
+                readonly contractName: "Bridged USDC (SKALE Bridge)";
+            };
+            readonly "eip155:1187947933": {
+                readonly address: "0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20";
+                readonly contractName: "Bridged USDC (SKALE Bridge)";
+            };
         };
         readonly toUnit: (v: UnitInput) => string;
     };
 };
 export type KnownAsset = keyof typeof knownAssets;
-export declare function lookupKnownAsset(network: x402Network | number, name: KnownAsset): {
+/**
+ * Looks up asset information by network and asset name.
+ *
+ * @param network - The network identifier (chain ID, CAIP-2, or legacy name)
+ * @param name - The known asset name (e.g., "USDC")
+ * @returns Asset information including contract address, or undefined if not found
+ */
+export declare function lookupKnownAsset(network: string | number, name: KnownAsset): {
     name: "USDC";
-    network: x402Network;
+    network: string;
     toUnit: (v: UnitInput) => string;
     address: Address;
     contractName: string;
@@ -82,25 +207,45 @@ export declare function lookupKnownAsset(network: x402Network | number, name: Kn
     forwarderName?: string;
     forwarderVersion?: string;
 } | undefined;
+/**
+ * Type guard that checks if a string is a known EVM asset name.
+ *
+ * @param asset - The string to check
+ * @returns True if the string is a known asset name
+ */
 export declare function isKnownAsset(asset: string): asset is KnownAsset;
 export type AssetNameOrContractInfo = string | ContractInfo;
-export declare function findAssetInfo(network: x402Network, assetNameOrInfo: AssetNameOrContractInfo): ContractInfo;
+/**
+ * Finds asset information by network and asset name or contract info.
+ *
+ * @param network - The network identifier
+ * @param assetNameOrInfo - Asset name (e.g., "USDC") or direct ContractInfo
+ * @returns Contract information for the asset
+ * @throws Error if the asset is unknown or not found on the network
+ */
+export declare function findAssetInfo(network: string | number, assetNameOrInfo: AssetNameOrContractInfo): ContractInfo;
 export type x402ExactArgs = {
-    network: x402Network | number;
+    network: string | number;
     asset: KnownAsset;
     amount: UnitInput;
     payTo: Address;
 };
+/**
+ * Creates x402 exact payment requirements for EVM.
+ *
+ * @param args - Payment configuration including network, asset, amount, and payTo
+ * @returns x402 payment requirement for the exact scheme
+ */
 export declare function x402Exact(args: x402ExactArgs): Partial<{
     scheme: string;
     network: string;
     maxAmountRequired: string;
     resource: string;
     description: string;
-    mimeType: string;
     payTo: string;
     maxTimeoutSeconds: number;
     asset: string;
+    mimeType?: string;
     outputSchema?: object;
     extra?: object;
 }>;

package/dist/src/evm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evm.d.ts","sourceRoot":"","sources":["../../src/evm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAqC,MAAM,UAAU,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,QAAA,MAAM,iBAAiB;;;;;;;;;;CAUb,CAAC;AACX,KAAK,iBAAiB,GAAG,OAAO,iBAAiB,CAAC;AAClD,MAAM,MAAM,gBAAgB,GAAG,MAAM,iBAAiB,CAAC;AAEvD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,gBAAgB,CAEnE;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,gBAAgB;;;;;;;;;EAKzD;AAED,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,UAAU,MAAM,EAAE,CAAC;AAEhE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,eAShD;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAOF,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAuCD,SAAS;;CAEqB,CAAC;AAC/C,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,WAAW,CAAC;AAElD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,WAAW,GAAG,MAAM,EAC7B,IAAI,EAAE,UAAU;;;gBAjDJ,SAAS,KAAK,MAAM;aATvB,OAAO;kBACF,MAAM;gBACR,OAAO;oBACH,MAAM;uBACH,MAAM;cA8E1B;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,YAAY,CAAC;AAE5D,wBAAgB,aAAa,CAC3B,OAAO,EAAE,WAAW,EACpB,eAAe,EAAE,uBAAuB,gBAuBzC;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC;IAC9B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa;;;;;;;;;;;;GAiB5C"}
+{"version":3,"file":"evm.d.ts","sourceRoot":"","sources":["../../src/evm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAqC,MAAM,UAAU,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAab,CAAC;AAEX,KAAK,iBAAiB,GAAG,OAAO,iBAAiB,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC;AACnD,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC;AAS9E;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM3D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAoBnE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,YAAY,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKtD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAOF,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BA+CD,SAAS;;CAEqB,CAAC;AAE/C,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,WAAW,CAAC;AAElD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,UAAU;;;gBA/D7D,SAAS,KAAK,MAAM;aATvB,OAAO;kBACF,MAAM;gBACR,OAAO;oBACH,MAAM;uBACH,MAAM;cAwF1B;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,YAAY,CAAC;AAE5D;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,eAAe,EAAE,uBAAuB,gBAwBzC;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa;;;;;;;;;;;;GAiB5C"}

package/dist/src/evm.js

@@ -1,48 +1,134 @@
 import { addX402PaymentRequirementDefaults } from "./common.js";
 import { Address } from "@faremeter/types/evm";
 const knownX402Networks = {
-    base: {
-        chainId: 8453,
-    },
-    "base-sepolia": {
-        chainId: 84532,
-    },
-    "skale-europa-testnet": {
+    "eip155:8453": { legacyName: "base", chainId: 8453 },
+    "eip155:84532": { legacyName: "base-sepolia", chainId: 84532 },
+    "eip155:1444673419": {
+        legacyName: "skale-europa-testnet",
         chainId: 1444673419,
     },
+    "eip155:137": { legacyName: "polygon", chainId: 137 },
+    "eip155:80002": { legacyName: "polygon-amoy", chainId: 80002 },
+    "eip155:143": { legacyName: "monad", chainId: 143 },
+    "eip155:10143": { legacyName: "monad-testnet", chainId: 10143 },
+    "eip155:324705682": { legacyName: "skale-base-sepolia", chainId: 324705682 },
+    "eip155:1187947933": { legacyName: "skale-base", chainId: 1187947933 },
 };
-export function isKnownX402Network(n) {
+const legacyNameToCAIP2Map = new Map(Object.entries(knownX402Networks).map(([caip2, info]) => [
+    info.legacyName,
+    caip2,
+]));
+/**
+ * Converts an EVM chain ID to CAIP-2 network identifier.
+ *
+ * @param chainId - The EVM chain ID
+ * @returns The CAIP-2 network identifier (eip155:chainId)
+ */
+export function chainIdToCAIP2(chainId) {
+    return `eip155:${chainId}`;
+}
+/**
+ * Extracts the EVM chain ID from a CAIP-2 network identifier.
+ *
+ * @param caip2 - The CAIP-2 network identifier
+ * @returns The chain ID, or null if not a valid eip155 identifier
+ */
+export function caip2ToChainId(caip2) {
+    const match = /^eip155:(\d+)$/.exec(caip2);
+    if (!match?.[1]) {
+        return null;
+    }
+    return parseInt(match[1], 10);
+}
+/**
+ * Converts a legacy EVM network name to CAIP-2 format.
+ *
+ * @param legacy - Legacy network name (e.g., "base", "polygon")
+ * @returns The CAIP-2 network identifier, or null if unknown
+ */
+export function legacyNameToCAIP2(legacy) {
+    return legacyNameToCAIP2Map.get(legacy) ?? null;
+}
+/**
+ * Converts a CAIP-2 network identifier to legacy EVM network name.
+ *
+ * @param caip2 - The CAIP-2 network identifier
+ * @returns The legacy network name, or null if unknown
+ */
+export function caip2ToLegacyName(caip2) {
+    const network = knownX402Networks[caip2];
+    return network?.legacyName ?? null;
+}
+/**
+ * Normalizes an EVM network identifier to CAIP-2 format.
+ *
+ * Accepts chain IDs (number or string), legacy names, or CAIP-2 identifiers.
+ * Returns the input unchanged if no mapping exists.
+ *
+ * @param network - The network identifier in any supported format
+ * @returns The CAIP-2 network identifier
+ */
+export function normalizeNetworkId(network) {
+    if (typeof network === "number") {
+        return chainIdToCAIP2(network);
+    }
+    if (network.startsWith("eip155:")) {
+        return network;
+    }
+    const caip2 = legacyNameToCAIP2(network);
+    if (caip2) {
+        return caip2;
+    }
+    const chainId = parseInt(network, 10);
+    if (!isNaN(chainId)) {
+        return chainIdToCAIP2(chainId);
+    }
+    return network;
+}
+/**
+ * Type guard that checks if a string is a known EVM CAIP-2 network.
+ *
+ * @param n - The string to check
+ * @returns True if the string is a known EVM CAIP-2 network identifier
+ */
+export function isKnownCAIP2Network(n) {
     return n in knownX402Networks;
 }
-export function lookupKnownX402Network(n) {
+/**
+ * Looks up network information by CAIP-2 identifier.
+ *
+ * @param n - The CAIP-2 network identifier
+ * @returns Network information including legacy name and chain ID
+ */
+export function lookupKnownCAIP2Network(n) {
     return {
         ...knownX402Networks[n],
-        name: n,
+        caip2: n,
     };
 }
+/**
+ * Looks up the x402 network identifier for an EVM chain ID.
+ *
+ * @param chainId - The EVM chain ID
+ * @returns The CAIP-2 network identifier
+ */
 export function lookupX402Network(chainId) {
-    let k;
-    for (k in knownX402Networks) {
-        if (knownX402Networks[k].chainId == chainId) {
-            return k;
-        }
-    }
-    return ("eip155:" + chainId.toString());
+    return chainIdToCAIP2(chainId);
 }
 const knownAssets = {
     USDC: {
         network: {
-            "base-sepolia": {
+            "eip155:84532": {
                 address: "0x036cbd53842c5426634e7929541ec2318f3dcf7e",
                 contractName: "USDC",
             },
-            base: {
+            "eip155:8453": {
                 address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                 contractName: "USD Coin",
             },
-            "skale-europa-testnet": {
+            "eip155:1444673419": {
                 address: "0x9eAb55199f4481eCD7659540A17Af618766b07C4",
-                contractName: "USDC", // EIP-3009 Forwarder,
+                contractName: "USDC",
                 forwarder: "0x7779B0d1766e6305E5f8081E3C0CDF58FcA24330",
                 forwarderName: "USDC Forwarder",
                 forwarderVersion: "1",
@@ -67,41 +153,69 @@ const knownAssets = {
                 address: "0x534b2f3A21130d7a60830c2Df862319e593943A3",
                 contractName: "USDC",
             },
+            "eip155:324705682": {
+                address: "0x2e08028E3C4c2356572E096d8EF835cD5C6030bD",
+                contractName: "Bridged USDC (SKALE Bridge)",
+            },
+            "eip155:1187947933": {
+                address: "0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20",
+                contractName: "Bridged USDC (SKALE Bridge)",
+            },
         },
         toUnit: (v) => v.toString(),
     },
 };
+/**
+ * Looks up asset information by network and asset name.
+ *
+ * @param network - The network identifier (chain ID, CAIP-2, or legacy name)
+ * @param name - The known asset name (e.g., "USDC")
+ * @returns Asset information including contract address, or undefined if not found
+ */
 export function lookupKnownAsset(network, name) {
     const assetInfo = knownAssets[name];
     if (!assetInfo) {
         return;
     }
-    if (typeof network === "number") {
-        network = lookupX402Network(network);
-    }
-    const contractInfo = assetInfo.network[network];
+    const caip2Network = normalizeNetworkId(network);
+    const contractInfo = assetInfo.network[caip2Network];
     if (!contractInfo) {
         return;
     }
     return {
         ...contractInfo,
         name,
-        network,
+        network: caip2Network,
         toUnit: assetInfo.toUnit,
     };
 }
+/**
+ * Type guard that checks if a string is a known EVM asset name.
+ *
+ * @param asset - The string to check
+ * @returns True if the string is a known asset name
+ */
 export function isKnownAsset(asset) {
     return asset in knownAssets;
 }
+/**
+ * Finds asset information by network and asset name or contract info.
+ *
+ * @param network - The network identifier
+ * @param assetNameOrInfo - Asset name (e.g., "USDC") or direct ContractInfo
+ * @returns Contract information for the asset
+ * @throws Error if the asset is unknown or not found on the network
+ */
 export function findAssetInfo(network, assetNameOrInfo) {
     let assetInfo;
+    const caip2Network = normalizeNetworkId(network);
     if (typeof assetNameOrInfo == "string") {
         if (!isKnownAsset(assetNameOrInfo)) {
             throw new Error(`Unknown asset: ${assetNameOrInfo}`);
         }
-        const t = lookupKnownAsset(network, assetNameOrInfo);
+        const t = lookupKnownAsset(caip2Network, assetNameOrInfo);
         if (!t) {
-            throw new Error(`Couldn't look up asset ${assetNameOrInfo} on ${network}`);
+            throw new Error(`Couldn't look up asset ${assetNameOrInfo} on ${caip2Network}`);
         }
         assetInfo = t;
     }
@@ -110,6 +224,12 @@ export function findAssetInfo(network, assetNameOrInfo) {
     }
     return assetInfo;
 }
+/**
+ * Creates x402 exact payment requirements for EVM.
+ *
+ * @param args - Payment configuration including network, asset, amount, and payTo
+ * @returns x402 payment requirement for the exact scheme
+ */
 export function x402Exact(args) {
     const tokenInfo = lookupKnownAsset(args.network, args.asset);
     if (!tokenInfo) {
@@ -121,7 +241,7 @@ export function x402Exact(args) {
         maxAmountRequired: tokenInfo.toUnit(args.amount),
         payTo: args.payTo,
         asset: tokenInfo.address,
-        maxTimeoutSeconds: 300, // from coinbase/x402's middleware defaults
+        maxTimeoutSeconds: 300,
     });
     return req;
 }