@perkos/util-tokens 1.0.0

package/README.md

@@ -0,0 +1,80 @@
+# @perkos/util-tokens
+
+ERC20 token detection utilities for reading on-chain token metadata. Essential for EIP-712 domain construction in payment signatures.
+
+## Installation
+
+```bash
+npm install @perkos/util-tokens
+```
+
+## Usage
+
+```typescript
+import { detectTokenInfo, getChainId, getRpcUrl } from "@perkos/util-tokens";
+
+// Detect token information from contract
+const tokenInfo = await detectTokenInfo(
+  "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
+  "avalanche"
+);
+
+console.log(tokenInfo);
+// {
+//   address: "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
+//   name: "USD Coin",
+//   symbol: "USDC",
+//   decimals: 6,
+//   chainId: 43114
+// }
+
+// Get chain ID for a network
+const chainId = getChainId("base-sepolia"); // 84532
+
+// Get RPC URL
+const rpcUrl = getRpcUrl("avalanche");
+```
+
+## Features
+
+- **Automatic Caching**: Token info is cached to avoid repeated RPC calls
+- **Multi-Network Support**: Avalanche, Base, Celo (mainnet and testnets)
+- **CAIP-2 Support**: Accepts both legacy and CAIP-2 network identifiers
+- **TypeScript**: Full type definitions included
+
+## API
+
+### `detectTokenInfo(tokenAddress, network, config?)`
+
+Detect token information from a contract address.
+
+- `tokenAddress`: ERC20 token contract address
+- `network`: Network name or CAIP-2 identifier
+- `config`: Optional configuration with custom RPC URL
+
+Returns `TokenInfo | null`
+
+### `getChainId(network)`
+
+Get chain ID for a network name.
+
+### `getRpcUrl(network, customUrl?)`
+
+Get RPC URL for a network.
+
+### `clearTokenCache()`
+
+Clear the token info cache.
+
+## Supported Networks
+
+- Avalanche (43114)
+- Avalanche Fuji (43113)
+- Base (8453)
+- Base Sepolia (84532)
+- Celo (42220)
+- Celo Sepolia (11142220)
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,81 @@
+import { Address, PublicClient } from 'viem';
+
+/**
+ * @perkos/token-detection
+ * ERC20 token detection utilities for reading on-chain token metadata
+ */
+
+/**
+ * Token information returned from detection
+ */
+interface TokenInfo {
+    address: Address;
+    name: string;
+    symbol: string;
+    decimals: number;
+    chainId: number;
+}
+/**
+ * Supported network names
+ */
+type NetworkName = "avalanche" | "avalanche-fuji" | "base" | "base-sepolia" | "celo" | "celo-sepolia";
+/**
+ * Network configuration options
+ */
+interface NetworkConfig {
+    rpcUrl?: string;
+}
+/**
+ * Convert CAIP-2 network format to legacy format
+ * e.g., "eip155:43114" → "avalanche"
+ */
+declare function toLegacyNetwork(network: string): NetworkName;
+/**
+ * Get chain ID for a network
+ */
+declare function getChainId(network: string): number;
+/**
+ * Get RPC URL for a network
+ */
+declare function getRpcUrl(network: string, customUrl?: string): string;
+/**
+ * Get public client for a network
+ */
+declare function getPublicClient(network: string, config?: NetworkConfig): PublicClient;
+/**
+ * Detect token information from contract address
+ * Results are cached to avoid repeated RPC calls
+ *
+ * @param tokenAddress - The ERC20 token contract address
+ * @param network - Network name or CAIP-2 identifier
+ * @param config - Optional network configuration
+ * @returns Token information or null if detection fails
+ *
+ * @example
+ * ```typescript
+ * const tokenInfo = await detectTokenInfo(
+ *   "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
+ *   "avalanche"
+ * );
+ * // => { name: "USD Coin", symbol: "USDC", decimals: 6, ... }
+ * ```
+ */
+declare function detectTokenInfo(tokenAddress: Address, network: string, config?: NetworkConfig): Promise<TokenInfo | null>;
+/**
+ * Clear the token info cache
+ */
+declare function clearTokenCache(): void;
+/**
+ * Get cached token info without RPC call
+ */
+declare function getCachedTokenInfo(tokenAddress: Address, network: string): TokenInfo | undefined;
+/**
+ * Check if a network is valid
+ */
+declare function isValidNetwork(network: string): boolean;
+/**
+ * Get all supported networks
+ */
+declare function getSupportedNetworks(): NetworkName[];
+
+export { type NetworkConfig, type NetworkName, type TokenInfo, clearTokenCache, detectTokenInfo, getCachedTokenInfo, getChainId, getPublicClient, getRpcUrl, getSupportedNetworks, isValidNetwork, toLegacyNetwork };

package/dist/index.d.ts

@@ -0,0 +1,81 @@
+import { Address, PublicClient } from 'viem';
+
+/**
+ * @perkos/token-detection
+ * ERC20 token detection utilities for reading on-chain token metadata
+ */
+
+/**
+ * Token information returned from detection
+ */
+interface TokenInfo {
+    address: Address;
+    name: string;
+    symbol: string;
+    decimals: number;
+    chainId: number;
+}
+/**
+ * Supported network names
+ */
+type NetworkName = "avalanche" | "avalanche-fuji" | "base" | "base-sepolia" | "celo" | "celo-sepolia";
+/**
+ * Network configuration options
+ */
+interface NetworkConfig {
+    rpcUrl?: string;
+}
+/**
+ * Convert CAIP-2 network format to legacy format
+ * e.g., "eip155:43114" → "avalanche"
+ */
+declare function toLegacyNetwork(network: string): NetworkName;
+/**
+ * Get chain ID for a network
+ */
+declare function getChainId(network: string): number;
+/**
+ * Get RPC URL for a network
+ */
+declare function getRpcUrl(network: string, customUrl?: string): string;
+/**
+ * Get public client for a network
+ */
+declare function getPublicClient(network: string, config?: NetworkConfig): PublicClient;
+/**
+ * Detect token information from contract address
+ * Results are cached to avoid repeated RPC calls
+ *
+ * @param tokenAddress - The ERC20 token contract address
+ * @param network - Network name or CAIP-2 identifier
+ * @param config - Optional network configuration
+ * @returns Token information or null if detection fails
+ *
+ * @example
+ * ```typescript
+ * const tokenInfo = await detectTokenInfo(
+ *   "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
+ *   "avalanche"
+ * );
+ * // => { name: "USD Coin", symbol: "USDC", decimals: 6, ... }
+ * ```
+ */
+declare function detectTokenInfo(tokenAddress: Address, network: string, config?: NetworkConfig): Promise<TokenInfo | null>;
+/**
+ * Clear the token info cache
+ */
+declare function clearTokenCache(): void;
+/**
+ * Get cached token info without RPC call
+ */
+declare function getCachedTokenInfo(tokenAddress: Address, network: string): TokenInfo | undefined;
+/**
+ * Check if a network is valid
+ */
+declare function isValidNetwork(network: string): boolean;
+/**
+ * Get all supported networks
+ */
+declare function getSupportedNetworks(): NetworkName[];
+
+export { type NetworkConfig, type NetworkName, type TokenInfo, clearTokenCache, detectTokenInfo, getCachedTokenInfo, getChainId, getPublicClient, getRpcUrl, getSupportedNetworks, isValidNetwork, toLegacyNetwork };

package/dist/index.js

@@ -0,0 +1,195 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  clearTokenCache: () => clearTokenCache,
+  detectTokenInfo: () => detectTokenInfo,
+  getCachedTokenInfo: () => getCachedTokenInfo,
+  getChainId: () => getChainId,
+  getPublicClient: () => getPublicClient,
+  getRpcUrl: () => getRpcUrl,
+  getSupportedNetworks: () => getSupportedNetworks,
+  isValidNetwork: () => isValidNetwork,
+  toLegacyNetwork: () => toLegacyNetwork
+});
+module.exports = __toCommonJS(index_exports);
+var import_viem = require("viem");
+var import_chains = require("viem/chains");
+var ERC20_ABI = [
+  {
+    constant: true,
+    inputs: [],
+    name: "name",
+    outputs: [{ name: "", type: "string" }],
+    type: "function"
+  },
+  {
+    constant: true,
+    inputs: [],
+    name: "symbol",
+    outputs: [{ name: "", type: "string" }],
+    type: "function"
+  },
+  {
+    constant: true,
+    inputs: [],
+    name: "decimals",
+    outputs: [{ name: "", type: "uint8" }],
+    type: "function"
+  }
+];
+var CHAIN_IDS = {
+  avalanche: 43114,
+  "avalanche-fuji": 43113,
+  base: 8453,
+  "base-sepolia": 84532,
+  celo: 42220,
+  "celo-sepolia": 11142220,
+  // CAIP-2 format support
+  "eip155:43114": 43114,
+  "eip155:43113": 43113,
+  "eip155:8453": 8453,
+  "eip155:84532": 84532,
+  "eip155:42220": 42220,
+  "eip155:11142220": 11142220
+};
+var DEFAULT_RPC_URLS = {
+  avalanche: "https://api.avax.network/ext/bc/C/rpc",
+  "avalanche-fuji": "https://api.avax-test.network/ext/bc/C/rpc",
+  base: "https://mainnet.base.org",
+  "base-sepolia": "https://sepolia.base.org",
+  celo: "https://forno.celo.org",
+  "celo-sepolia": "https://forno.celo-sepolia.celo-testnet.org"
+};
+var CHAINS = {
+  avalanche: import_chains.avalanche,
+  "avalanche-fuji": import_chains.avalancheFuji,
+  base: import_chains.base,
+  "base-sepolia": import_chains.baseSepolia,
+  celo: import_chains.celo,
+  "celo-sepolia": import_chains.celoAlfajores
+};
+var CAIP2_TO_LEGACY = {
+  "eip155:43114": "avalanche",
+  "eip155:43113": "avalanche-fuji",
+  "eip155:8453": "base",
+  "eip155:84532": "base-sepolia",
+  "eip155:42220": "celo",
+  "eip155:11142220": "celo-sepolia"
+};
+var tokenInfoCache = /* @__PURE__ */ new Map();
+function toLegacyNetwork(network) {
+  if (!network.includes(":")) {
+    return network;
+  }
+  return CAIP2_TO_LEGACY[network] || "avalanche";
+}
+function getChainId(network) {
+  return CHAIN_IDS[network] || CHAIN_IDS.avalanche;
+}
+function getRpcUrl(network, customUrl) {
+  if (customUrl) return customUrl;
+  const legacyNetwork = toLegacyNetwork(network);
+  return DEFAULT_RPC_URLS[legacyNetwork] || DEFAULT_RPC_URLS.avalanche;
+}
+function getPublicClient(network, config) {
+  const legacyNetwork = toLegacyNetwork(network);
+  const rpcUrl = getRpcUrl(network, config?.rpcUrl);
+  const chain = CHAINS[legacyNetwork] || {
+    id: getChainId(legacyNetwork),
+    name: legacyNetwork,
+    network: legacyNetwork,
+    nativeCurrency: { name: "ETH", symbol: "ETH", decimals: 18 },
+    rpcUrls: { default: { http: [rpcUrl] } }
+  };
+  return (0, import_viem.createPublicClient)({
+    chain,
+    transport: (0, import_viem.http)(rpcUrl)
+  });
+}
+async function detectTokenInfo(tokenAddress, network, config) {
+  const legacyNetwork = toLegacyNetwork(network);
+  const cacheKey = `${tokenAddress.toLowerCase()}-${legacyNetwork}`;
+  if (tokenInfoCache.has(cacheKey)) {
+    return tokenInfoCache.get(cacheKey);
+  }
+  try {
+    const client = getPublicClient(legacyNetwork, config);
+    const chainId = getChainId(legacyNetwork);
+    const [name, symbol, decimals] = await Promise.all([
+      client.readContract({
+        address: tokenAddress,
+        abi: ERC20_ABI,
+        functionName: "name"
+      }),
+      client.readContract({
+        address: tokenAddress,
+        abi: ERC20_ABI,
+        functionName: "symbol"
+      }),
+      client.readContract({
+        address: tokenAddress,
+        abi: ERC20_ABI,
+        functionName: "decimals"
+      })
+    ]);
+    const tokenInfo = {
+      address: tokenAddress,
+      name: name || "Unknown Token",
+      symbol: symbol || "UNKNOWN",
+      decimals: decimals || 18,
+      chainId
+    };
+    tokenInfoCache.set(cacheKey, tokenInfo);
+    return tokenInfo;
+  } catch (error) {
+    console.error("Failed to detect token info:", error);
+    return null;
+  }
+}
+function clearTokenCache() {
+  tokenInfoCache.clear();
+}
+function getCachedTokenInfo(tokenAddress, network) {
+  const legacyNetwork = toLegacyNetwork(network);
+  const cacheKey = `${tokenAddress.toLowerCase()}-${legacyNetwork}`;
+  return tokenInfoCache.get(cacheKey);
+}
+function isValidNetwork(network) {
+  const legacyNetwork = toLegacyNetwork(network);
+  return legacyNetwork in CHAINS;
+}
+function getSupportedNetworks() {
+  return Object.keys(CHAINS);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  clearTokenCache,
+  detectTokenInfo,
+  getCachedTokenInfo,
+  getChainId,
+  getPublicClient,
+  getRpcUrl,
+  getSupportedNetworks,
+  isValidNetwork,
+  toLegacyNetwork
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @perkos/token-detection\n * ERC20 token detection utilities for reading on-chain token metadata\n */\n\nimport { createPublicClient, http, type Address, type PublicClient } from \"viem\";\nimport {\n  avalanche,\n  avalancheFuji,\n  base,\n  baseSepolia,\n  celo,\n  celoAlfajores,\n} from \"viem/chains\";\n\n/**\n * Token information returned from detection\n */\nexport interface TokenInfo {\n  address: Address;\n  name: string;\n  symbol: string;\n  decimals: number;\n  chainId: number;\n}\n\n/**\n * Supported network names\n */\nexport type NetworkName =\n  | \"avalanche\"\n  | \"avalanche-fuji\"\n  | \"base\"\n  | \"base-sepolia\"\n  | \"celo\"\n  | \"celo-sepolia\";\n\n/**\n * Network configuration options\n */\nexport interface NetworkConfig {\n  rpcUrl?: string;\n}\n\n/**\n * Standard ERC20 ABI (minimal - just what we need)\n */\nconst ERC20_ABI = [\n  {\n    constant: true,\n    inputs: [],\n    name: \"name\",\n    outputs: [{ name: \"\", type: \"string\" }],\n    type: \"function\",\n  },\n  {\n    constant: true,\n    inputs: [],\n    name: \"symbol\",\n    outputs: [{ name: \"\", type: \"string\" }],\n    type: \"function\",\n  },\n  {\n    constant: true,\n    inputs: [],\n    name: \"decimals\",\n    outputs: [{ name: \"\", type: \"uint8\" }],\n    type: \"function\",\n  },\n] as const;\n\n/**\n * Chain ID mappings\n */\nconst CHAIN_IDS: Record<string, number> = {\n  avalanche: 43114,\n  \"avalanche-fuji\": 43113,\n  base: 8453,\n  \"base-sepolia\": 84532,\n  celo: 42220,\n  \"celo-sepolia\": 11142220,\n  // CAIP-2 format support\n  \"eip155:43114\": 43114,\n  \"eip155:43113\": 43113,\n  \"eip155:8453\": 8453,\n  \"eip155:84532\": 84532,\n  \"eip155:42220\": 42220,\n  \"eip155:11142220\": 11142220,\n};\n\n/**\n * Default RPC URLs\n */\nconst DEFAULT_RPC_URLS: Record<NetworkName, string> = {\n  avalanche: \"https://api.avax.network/ext/bc/C/rpc\",\n  \"avalanche-fuji\": \"https://api.avax-test.network/ext/bc/C/rpc\",\n  base: \"https://mainnet.base.org\",\n  \"base-sepolia\": \"https://sepolia.base.org\",\n  celo: \"https://forno.celo.org\",\n  \"celo-sepolia\": \"https://forno.celo-sepolia.celo-testnet.org\",\n};\n\n/**\n * Chain definitions\n */\nconst CHAINS: Record<NetworkName, any> = {\n  avalanche,\n  \"avalanche-fuji\": avalancheFuji,\n  base,\n  \"base-sepolia\": baseSepolia,\n  celo,\n  \"celo-sepolia\": celoAlfajores,\n};\n\n/**\n * CAIP-2 to legacy network mapping\n */\nconst CAIP2_TO_LEGACY: Record<string, NetworkName> = {\n  \"eip155:43114\": \"avalanche\",\n  \"eip155:43113\": \"avalanche-fuji\",\n  \"eip155:8453\": \"base\",\n  \"eip155:84532\": \"base-sepolia\",\n  \"eip155:42220\": \"celo\",\n  \"eip155:11142220\": \"celo-sepolia\",\n};\n\n// Token info cache to avoid repeated RPC calls\nconst tokenInfoCache = new Map<string, TokenInfo>();\n\n/**\n * Convert CAIP-2 network format to legacy format\n * e.g., \"eip155:43114\" → \"avalanche\"\n */\nexport function toLegacyNetwork(network: string): NetworkName {\n  if (!network.includes(\":\")) {\n    return network as NetworkName;\n  }\n  return CAIP2_TO_LEGACY[network] || \"avalanche\";\n}\n\n/**\n * Get chain ID for a network\n */\nexport function getChainId(network: string): number {\n  return CHAIN_IDS[network] || CHAIN_IDS.avalanche;\n}\n\n/**\n * Get RPC URL for a network\n */\nexport function getRpcUrl(network: string, customUrl?: string): string {\n  if (customUrl) return customUrl;\n  const legacyNetwork = toLegacyNetwork(network);\n  return DEFAULT_RPC_URLS[legacyNetwork] || DEFAULT_RPC_URLS.avalanche;\n}\n\n/**\n * Get public client for a network\n */\nexport function getPublicClient(\n  network: string,\n  config?: NetworkConfig\n): PublicClient {\n  const legacyNetwork = toLegacyNetwork(network);\n  const rpcUrl = getRpcUrl(network, config?.rpcUrl);\n  const chain = CHAINS[legacyNetwork] || {\n    id: getChainId(legacyNetwork),\n    name: legacyNetwork,\n    network: legacyNetwork,\n    nativeCurrency: { name: \"ETH\", symbol: \"ETH\", decimals: 18 },\n    rpcUrls: { default: { http: [rpcUrl] } },\n  };\n\n  return createPublicClient({\n    chain,\n    transport: http(rpcUrl),\n  }) as PublicClient;\n}\n\n/**\n * Detect token information from contract address\n * Results are cached to avoid repeated RPC calls\n *\n * @param tokenAddress - The ERC20 token contract address\n * @param network - Network name or CAIP-2 identifier\n * @param config - Optional network configuration\n * @returns Token information or null if detection fails\n *\n * @example\n * ```typescript\n * const tokenInfo = await detectTokenInfo(\n *   \"0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E\",\n *   \"avalanche\"\n * );\n * // => { name: \"USD Coin\", symbol: \"USDC\", decimals: 6, ... }\n * ```\n */\nexport async function detectTokenInfo(\n  tokenAddress: Address,\n  network: string,\n  config?: NetworkConfig\n): Promise<TokenInfo | null> {\n  const legacyNetwork = toLegacyNetwork(network);\n  const cacheKey = `${tokenAddress.toLowerCase()}-${legacyNetwork}`;\n\n  // Check cache first\n  if (tokenInfoCache.has(cacheKey)) {\n    return tokenInfoCache.get(cacheKey)!;\n  }\n\n  try {\n    const client = getPublicClient(legacyNetwork, config);\n    const chainId = getChainId(legacyNetwork);\n\n    // Read token info in parallel\n    const [name, symbol, decimals] = await Promise.all([\n      client.readContract({\n        address: tokenAddress,\n        abi: ERC20_ABI,\n        functionName: \"name\",\n      }) as Promise<string>,\n      client.readContract({\n        address: tokenAddress,\n        abi: ERC20_ABI,\n        functionName: \"symbol\",\n      }) as Promise<string>,\n      client.readContract({\n        address: tokenAddress,\n        abi: ERC20_ABI,\n        functionName: \"decimals\",\n      }) as Promise<number>,\n    ]);\n\n    const tokenInfo: TokenInfo = {\n      address: tokenAddress,\n      name: name || \"Unknown Token\",\n      symbol: symbol || \"UNKNOWN\",\n      decimals: decimals || 18,\n      chainId,\n    };\n\n    // Cache the result\n    tokenInfoCache.set(cacheKey, tokenInfo);\n\n    return tokenInfo;\n  } catch (error) {\n    console.error(\"Failed to detect token info:\", error);\n    return null;\n  }\n}\n\n/**\n * Clear the token info cache\n */\nexport function clearTokenCache(): void {\n  tokenInfoCache.clear();\n}\n\n/**\n * Get cached token info without RPC call\n */\nexport function getCachedTokenInfo(\n  tokenAddress: Address,\n  network: string\n): TokenInfo | undefined {\n  const legacyNetwork = toLegacyNetwork(network);\n  const cacheKey = `${tokenAddress.toLowerCase()}-${legacyNetwork}`;\n  return tokenInfoCache.get(cacheKey);\n}\n\n/**\n * Check if a network is valid\n */\nexport function isValidNetwork(network: string): boolean {\n  const legacyNetwork = toLegacyNetwork(network);\n  return legacyNetwork in CHAINS;\n}\n\n/**\n * Get all supported networks\n */\nexport function getSupportedNetworks(): NetworkName[] {\n  return Object.keys(CHAINS) as NetworkName[];\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,169 @@
+// src/index.ts
+import { createPublicClient, http } from "viem";
+import {
+  avalanche,
+  avalancheFuji,
+  base,
+  baseSepolia,
+  celo,
+  celoAlfajores
+} from "viem/chains";
+var ERC20_ABI = [
+  {
+    constant: true,
+    inputs: [],
+    name: "name",
+    outputs: [{ name: "", type: "string" }],
+    type: "function"
+  },
+  {
+    constant: true,
+    inputs: [],
+    name: "symbol",
+    outputs: [{ name: "", type: "string" }],
+    type: "function"
+  },
+  {
+    constant: true,
+    inputs: [],
+    name: "decimals",
+    outputs: [{ name: "", type: "uint8" }],
+    type: "function"
+  }
+];
+var CHAIN_IDS = {
+  avalanche: 43114,
+  "avalanche-fuji": 43113,
+  base: 8453,
+  "base-sepolia": 84532,
+  celo: 42220,
+  "celo-sepolia": 11142220,
+  // CAIP-2 format support
+  "eip155:43114": 43114,
+  "eip155:43113": 43113,
+  "eip155:8453": 8453,
+  "eip155:84532": 84532,
+  "eip155:42220": 42220,
+  "eip155:11142220": 11142220
+};
+var DEFAULT_RPC_URLS = {
+  avalanche: "https://api.avax.network/ext/bc/C/rpc",
+  "avalanche-fuji": "https://api.avax-test.network/ext/bc/C/rpc",
+  base: "https://mainnet.base.org",
+  "base-sepolia": "https://sepolia.base.org",
+  celo: "https://forno.celo.org",
+  "celo-sepolia": "https://forno.celo-sepolia.celo-testnet.org"
+};
+var CHAINS = {
+  avalanche,
+  "avalanche-fuji": avalancheFuji,
+  base,
+  "base-sepolia": baseSepolia,
+  celo,
+  "celo-sepolia": celoAlfajores
+};
+var CAIP2_TO_LEGACY = {
+  "eip155:43114": "avalanche",
+  "eip155:43113": "avalanche-fuji",
+  "eip155:8453": "base",
+  "eip155:84532": "base-sepolia",
+  "eip155:42220": "celo",
+  "eip155:11142220": "celo-sepolia"
+};
+var tokenInfoCache = /* @__PURE__ */ new Map();
+function toLegacyNetwork(network) {
+  if (!network.includes(":")) {
+    return network;
+  }
+  return CAIP2_TO_LEGACY[network] || "avalanche";
+}
+function getChainId(network) {
+  return CHAIN_IDS[network] || CHAIN_IDS.avalanche;
+}
+function getRpcUrl(network, customUrl) {
+  if (customUrl) return customUrl;
+  const legacyNetwork = toLegacyNetwork(network);
+  return DEFAULT_RPC_URLS[legacyNetwork] || DEFAULT_RPC_URLS.avalanche;
+}
+function getPublicClient(network, config) {
+  const legacyNetwork = toLegacyNetwork(network);
+  const rpcUrl = getRpcUrl(network, config?.rpcUrl);
+  const chain = CHAINS[legacyNetwork] || {
+    id: getChainId(legacyNetwork),
+    name: legacyNetwork,
+    network: legacyNetwork,
+    nativeCurrency: { name: "ETH", symbol: "ETH", decimals: 18 },
+    rpcUrls: { default: { http: [rpcUrl] } }
+  };
+  return createPublicClient({
+    chain,
+    transport: http(rpcUrl)
+  });
+}
+async function detectTokenInfo(tokenAddress, network, config) {
+  const legacyNetwork = toLegacyNetwork(network);
+  const cacheKey = `${tokenAddress.toLowerCase()}-${legacyNetwork}`;
+  if (tokenInfoCache.has(cacheKey)) {
+    return tokenInfoCache.get(cacheKey);
+  }
+  try {
+    const client = getPublicClient(legacyNetwork, config);
+    const chainId = getChainId(legacyNetwork);
+    const [name, symbol, decimals] = await Promise.all([
+      client.readContract({
+        address: tokenAddress,
+        abi: ERC20_ABI,
+        functionName: "name"
+      }),
+      client.readContract({
+        address: tokenAddress,
+        abi: ERC20_ABI,
+        functionName: "symbol"
+      }),
+      client.readContract({
+        address: tokenAddress,
+        abi: ERC20_ABI,
+        functionName: "decimals"
+      })
+    ]);
+    const tokenInfo = {
+      address: tokenAddress,
+      name: name || "Unknown Token",
+      symbol: symbol || "UNKNOWN",
+      decimals: decimals || 18,
+      chainId
+    };
+    tokenInfoCache.set(cacheKey, tokenInfo);
+    return tokenInfo;
+  } catch (error) {
+    console.error("Failed to detect token info:", error);
+    return null;
+  }
+}
+function clearTokenCache() {
+  tokenInfoCache.clear();
+}
+function getCachedTokenInfo(tokenAddress, network) {
+  const legacyNetwork = toLegacyNetwork(network);
+  const cacheKey = `${tokenAddress.toLowerCase()}-${legacyNetwork}`;
+  return tokenInfoCache.get(cacheKey);
+}
+function isValidNetwork(network) {
+  const legacyNetwork = toLegacyNetwork(network);
+  return legacyNetwork in CHAINS;
+}
+function getSupportedNetworks() {
+  return Object.keys(CHAINS);
+}
+export {
+  clearTokenCache,
+  detectTokenInfo,
+  getCachedTokenInfo,
+  getChainId,
+  getPublicClient,
+  getRpcUrl,
+  getSupportedNetworks,
+  isValidNetwork,
+  toLegacyNetwork
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @perkos/token-detection\n * ERC20 token detection utilities for reading on-chain token metadata\n */\n\nimport { createPublicClient, http, type Address, type PublicClient } from \"viem\";\nimport {\n  avalanche,\n  avalancheFuji,\n  base,\n  baseSepolia,\n  celo,\n  celoAlfajores,\n} from \"viem/chains\";\n\n/**\n * Token information returned from detection\n */\nexport interface TokenInfo {\n  address: Address;\n  name: string;\n  symbol: string;\n  decimals: number;\n  chainId: number;\n}\n\n/**\n * Supported network names\n */\nexport type NetworkName =\n  | \"avalanche\"\n  | \"avalanche-fuji\"\n  | \"base\"\n  | \"base-sepolia\"\n  | \"celo\"\n  | \"celo-sepolia\";\n\n/**\n * Network configuration options\n */\nexport interface NetworkConfig {\n  rpcUrl?: string;\n}\n\n/**\n * Standard ERC20 ABI (minimal - just what we need)\n */\nconst ERC20_ABI = [\n  {\n    constant: true,\n    inputs: [],\n    name: \"name\",\n    outputs: [{ name: \"\", type: \"string\" }],\n    type: \"function\",\n  },\n  {\n    constant: true,\n    inputs: [],\n    name: \"symbol\",\n    outputs: [{ name: \"\", type: \"string\" }],\n    type: \"function\",\n  },\n  {\n    constant: true,\n    inputs: [],\n    name: \"decimals\",\n    outputs: [{ name: \"\", type: \"uint8\" }],\n    type: \"function\",\n  },\n] as const;\n\n/**\n * Chain ID mappings\n */\nconst CHAIN_IDS: Record<string, number> = {\n  avalanche: 43114,\n  \"avalanche-fuji\": 43113,\n  base: 8453,\n  \"base-sepolia\": 84532,\n  celo: 42220,\n  \"celo-sepolia\": 11142220,\n  // CAIP-2 format support\n  \"eip155:43114\": 43114,\n  \"eip155:43113\": 43113,\n  \"eip155:8453\": 8453,\n  \"eip155:84532\": 84532,\n  \"eip155:42220\": 42220,\n  \"eip155:11142220\": 11142220,\n};\n\n/**\n * Default RPC URLs\n */\nconst DEFAULT_RPC_URLS: Record<NetworkName, string> = {\n  avalanche: \"https://api.avax.network/ext/bc/C/rpc\",\n  \"avalanche-fuji\": \"https://api.avax-test.network/ext/bc/C/rpc\",\n  base: \"https://mainnet.base.org\",\n  \"base-sepolia\": \"https://sepolia.base.org\",\n  celo: \"https://forno.celo.org\",\n  \"celo-sepolia\": \"https://forno.celo-sepolia.celo-testnet.org\",\n};\n\n/**\n * Chain definitions\n */\nconst CHAINS: Record<NetworkName, any> = {\n  avalanche,\n  \"avalanche-fuji\": avalancheFuji,\n  base,\n  \"base-sepolia\": baseSepolia,\n  celo,\n  \"celo-sepolia\": celoAlfajores,\n};\n\n/**\n * CAIP-2 to legacy network mapping\n */\nconst CAIP2_TO_LEGACY: Record<string, NetworkName> = {\n  \"eip155:43114\": \"avalanche\",\n  \"eip155:43113\": \"avalanche-fuji\",\n  \"eip155:8453\": \"base\",\n  \"eip155:84532\": \"base-sepolia\",\n  \"eip155:42220\": \"celo\",\n  \"eip155:11142220\": \"celo-sepolia\",\n};\n\n// Token info cache to avoid repeated RPC calls\nconst tokenInfoCache = new Map<string, TokenInfo>();\n\n/**\n * Convert CAIP-2 network format to legacy format\n * e.g., \"eip155:43114\" → \"avalanche\"\n */\nexport function toLegacyNetwork(network: string): NetworkName {\n  if (!network.includes(\":\")) {\n    return network as NetworkName;\n  }\n  return CAIP2_TO_LEGACY[network] || \"avalanche\";\n}\n\n/**\n * Get chain ID for a network\n */\nexport function getChainId(network: string): number {\n  return CHAIN_IDS[network] || CHAIN_IDS.avalanche;\n}\n\n/**\n * Get RPC URL for a network\n */\nexport function getRpcUrl(network: string, customUrl?: string): string {\n  if (customUrl) return customUrl;\n  const legacyNetwork = toLegacyNetwork(network);\n  return DEFAULT_RPC_URLS[legacyNetwork] || DEFAULT_RPC_URLS.avalanche;\n}\n\n/**\n * Get public client for a network\n */\nexport function getPublicClient(\n  network: string,\n  config?: NetworkConfig\n): PublicClient {\n  const legacyNetwork = toLegacyNetwork(network);\n  const rpcUrl = getRpcUrl(network, config?.rpcUrl);\n  const chain = CHAINS[legacyNetwork] || {\n    id: getChainId(legacyNetwork),\n    name: legacyNetwork,\n    network: legacyNetwork,\n    nativeCurrency: { name: \"ETH\", symbol: \"ETH\", decimals: 18 },\n    rpcUrls: { default: { http: [rpcUrl] } },\n  };\n\n  return createPublicClient({\n    chain,\n    transport: http(rpcUrl),\n  }) as PublicClient;\n}\n\n/**\n * Detect token information from contract address\n * Results are cached to avoid repeated RPC calls\n *\n * @param tokenAddress - The ERC20 token contract address\n * @param network - Network name or CAIP-2 identifier\n * @param config - Optional network configuration\n * @returns Token information or null if detection fails\n *\n * @example\n * ```typescript\n * const tokenInfo = await detectTokenInfo(\n *   \"0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E\",\n *   \"avalanche\"\n * );\n * // => { name: \"USD Coin\", symbol: \"USDC\", decimals: 6, ... }\n * ```\n */\nexport async function detectTokenInfo(\n  tokenAddress: Address,\n  network: string,\n  config?: NetworkConfig\n): Promise<TokenInfo | null> {\n  const legacyNetwork = toLegacyNetwork(network);\n  const cacheKey = `${tokenAddress.toLowerCase()}-${legacyNetwork}`;\n\n  // Check cache first\n  if (tokenInfoCache.has(cacheKey)) {\n    return tokenInfoCache.get(cacheKey)!;\n  }\n\n  try {\n    const client = getPublicClient(legacyNetwork, config);\n    const chainId = getChainId(legacyNetwork);\n\n    // Read token info in parallel\n    const [name, symbol, decimals] = await Promise.all([\n      client.readContract({\n        address: tokenAddress,\n        abi: ERC20_ABI,\n        functionName: \"name\",\n      }) as Promise<string>,\n      client.readContract({\n        address: tokenAddress,\n        abi: ERC20_ABI,\n        functionName: \"symbol\",\n      }) as Promise<string>,\n      client.readContract({\n        address: tokenAddress,\n        abi: ERC20_ABI,\n        functionName: \"decimals\",\n      }) as Promise<number>,\n    ]);\n\n    const tokenInfo: TokenInfo = {\n      address: tokenAddress,\n      name: name || \"Unknown Token\",\n      symbol: symbol || \"UNKNOWN\",\n      decimals: decimals || 18,\n      chainId,\n    };\n\n    // Cache the result\n    tokenInfoCache.set(cacheKey, tokenInfo);\n\n    return tokenInfo;\n  } catch (error) {\n    console.error(\"Failed to detect token info:\", error);\n    return null;\n  }\n}\n\n/**\n * Clear the token info cache\n */\nexport function clearTokenCache(): void {\n  tokenInfoCache.clear();\n}\n\n/**\n * Get cached token info without RPC call\n */\nexport function getCachedTokenInfo(\n  tokenAddress: Address,\n  network: string\n): TokenInfo | undefined {\n  const legacyNetwork = toLegacyNetwork(network);\n  const cacheKey = `${tokenAddress.toLowerCase()}-${legacyNetwork}`;\n  return tokenInfoCache.get(cacheKey);\n}\n\n/**\n * Check if a network is valid\n */\nexport function isValidNetwork(network: string): boolean {\n  const legacyNetwork = toLegacyNetwork(network);\n  return legacyNetwork in CHAINS;\n}\n\n/**\n * Get all supported networks\n */\nexport function getSupportedNetworks(): NetworkName[] {\n  return Object.keys(CHAINS) as NetworkName[];\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@perkos/util-tokens",
+  "version": "1.0.0",
+  "description": "ERC20 token detection utilities for reading on-chain token metadata",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "erc20",
+    "token",
+    "detection",
+    "blockchain",
+    "eip-712",
+    "perkos"
+  ],
+  "author": "PerkOS",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/PerkOS-xyz/pkg-util-tokens.git"
+  },
+  "dependencies": {
+    "viem": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}