@zkp2p/pay-shared 0.0.1

package/dist/chains.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Centralized chain configuration for ZKP2P Pay.
+ *
+ * All supported chains and their USDC addresses are defined here.
+ * Import this module instead of duplicating chain configs in each app.
+ */
+export declare const BASE_CHAIN_ID = 8453;
+export declare const HYPEREVM_CHAIN_ID = 999;
+export declare const SOLANA_CHAIN_ID = 34268394551451;
+export declare const SUPPORTED_DESTINATION_TOKEN_ALIASES: readonly ["USDC", "USDT"];
+export type DestinationTokenAlias = (typeof SUPPORTED_DESTINATION_TOKEN_ALIASES)[number];
+export declare const DEFAULT_DESTINATION_TOKEN_ALIAS: DestinationTokenAlias;
+/**
+ * Chain configuration interface.
+ *
+ * Note: We don't store spokePoolAddress for each chain because bridging
+ * always originates from Base, and the hook contract handles the Base SpokePool.
+ */
+export interface ChainConfig {
+    chainId: number;
+    name: string;
+    shortName: string;
+    usdcAddress: string;
+    isOriginChain: boolean;
+    isEvm: boolean;
+    explorerUrl?: string;
+}
+export declare const MAINNET_CHAINS: Record<number, ChainConfig>;
+/**
+ * Normalize destination token aliases (USDC/USDT) into canonical uppercase symbols.
+ * Returns null if the value is empty or not a known alias.
+ */
+export declare function normalizeDestinationTokenAlias(value: string | null | undefined): DestinationTokenAlias | null;
+/**
+ * Check whether a value is a supported destination token alias.
+ */
+export declare function isDestinationTokenAlias(value: string | null | undefined): value is DestinationTokenAlias;
+/**
+ * Resolve destination token alias, falling back to the hard default.
+ */
+export declare function resolveDefaultDestinationTokenAlias(value: string | null | undefined): DestinationTokenAlias;
+/**
+ * Parse a user-provided chain selection into a supported chain ID.
+ * Accepts numeric chain IDs as well as common aliases (e.g. "polygon", "arb", "sol").
+ */
+export declare function parseSupportedChainSelection(value: string): number | null;
+/**
+ * Get chain configurations.
+ */
+export declare function getChainConfigs(): Record<number, ChainConfig>;
+/**
+ * Get chain config by chain ID.
+ */
+export declare function getChainConfig(chainId: number): ChainConfig | undefined;
+/**
+ * Check if chain ID is the origin chain (Base).
+ */
+export declare function isOriginChain(chainId: number): boolean;
+/**
+ * Check if chain ID is an EVM chain.
+ */
+export declare function isEvmChain(chainId: number): boolean;
+/**
+ * Get origin chain ID for current environment.
+ */
+export declare function getOriginChainId(): number;
+/**
+ * Get USDC address for a chain.
+ */
+export declare function getUsdcAddress(chainId: number): string | undefined;
+/**
+ * Resolve destination token alias to chain-specific token address.
+ * Supported aliases:
+ * - USDC: map to configured USDC address
+ * - USDT: map to configured USDT address (if available)
+ * - fallback: return token string as provided (for explicit token addresses)
+ */
+export declare function resolveDestinationTokenAddress(destinationToken: string, destinationChainId: number): string | null;
+/**
+ * Get supported destination token aliases for a destination chain.
+ * Token support is derived from resolvable token addresses for the chain.
+ */
+export declare function getSupportedDestinationTokenAliasesForChain(destinationChainId: number): DestinationTokenAlias[];
+/**
+ * Get all supported chain IDs.
+ */
+export declare function getSupportedChainIds(): number[];
+/**
+ * Get destination chain IDs (excludes origin).
+ */
+export declare function getDestinationChainIds(): number[];
+/**
+ * Get EVM chain IDs only.
+ */
+export declare function getEvmChainIds(): number[];
+/**
+ * Get non-EVM chain IDs (e.g., Solana).
+ */
+export declare function getNonEvmChainIds(): number[];
+/**
+ * Get chain name for display.
+ */
+export declare function getChainName(chainId: number): string;
+/**
+ * Get chain short name for badges/tags.
+ */
+export declare function getChainShortName(chainId: number): string;
+/**
+ * Get explorer URL for a chain.
+ */
+export declare function getExplorerUrl(chainId: number): string | undefined;
+/**
+ * Array of supported chains for UI dropdowns.
+ * Includes origin chain marked with isOrigin flag.
+ */
+export declare const SUPPORTED_CHAINS: {
+    chainId: number;
+    name: string;
+    shortName: string;
+    isOrigin: boolean;
+    isEvm: boolean;
+}[];
+/**
+ * Array of destination chains only (excludes Base).
+ */
+export declare const DESTINATION_CHAINS: {
+    chainId: number;
+    name: string;
+    shortName: string;
+    isOrigin: boolean;
+    isEvm: boolean;
+}[];
+/**
+ * Mapping of chain ID to name for backward compatibility.
+ */
+export declare const SupportedChainsMap: Record<number, string>;
+//# sourceMappingURL=chains.d.ts.map

package/dist/chains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"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"}

package/dist/chains.js

@@ -0,0 +1,341 @@
+/**
+ * Centralized chain configuration for ZKP2P Pay.
+ *
+ * All supported chains and their USDC addresses are defined here.
+ * Import this module instead of duplicating chain configs in each app.
+ */
+// Chain IDs
+export const BASE_CHAIN_ID = 8453;
+export const HYPEREVM_CHAIN_ID = 999;
+export const SOLANA_CHAIN_ID = 34268394551451;
+export const SUPPORTED_DESTINATION_TOKEN_ALIASES = ['USDC', 'USDT'];
+export const DEFAULT_DESTINATION_TOKEN_ALIAS = 'USDC';
+// Mainnet chain configurations
+export const MAINNET_CHAINS = {
+    // Origin chain (Base)
+    [BASE_CHAIN_ID]: {
+        chainId: BASE_CHAIN_ID,
+        name: 'Base',
+        shortName: 'BASE',
+        usdcAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+        isOriginChain: true,
+        isEvm: true,
+        explorerUrl: 'https://basescan.org',
+    },
+    // EVM Destination chains
+    1: {
+        chainId: 1,
+        name: 'Ethereum',
+        shortName: 'ETH',
+        usdcAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+        isOriginChain: false,
+        isEvm: true,
+        explorerUrl: 'https://etherscan.io',
+    },
+    10: {
+        chainId: 10,
+        name: 'Optimism',
+        shortName: 'OP',
+        usdcAddress: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85',
+        isOriginChain: false,
+        isEvm: true,
+        explorerUrl: 'https://optimistic.etherscan.io',
+    },
+    42161: {
+        chainId: 42161,
+        name: 'Arbitrum',
+        shortName: 'ARB',
+        usdcAddress: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
+        isOriginChain: false,
+        isEvm: true,
+        explorerUrl: 'https://arbiscan.io',
+    },
+    137: {
+        chainId: 137,
+        name: 'Polygon',
+        shortName: 'MATIC',
+        usdcAddress: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359',
+        isOriginChain: false,
+        isEvm: true,
+        explorerUrl: 'https://polygonscan.com',
+    },
+    480: {
+        chainId: 480,
+        name: 'World Chain',
+        shortName: 'WLD',
+        usdcAddress: '0x79A02482A880bCE3F13e09Da970dC34db4CD24d1', // USDC.e on World Chain
+        isOriginChain: false,
+        isEvm: true,
+        explorerUrl: 'https://worldscan.org',
+    },
+    56: {
+        chainId: 56,
+        name: 'BNB Smart Chain',
+        shortName: 'BNB',
+        usdcAddress: '0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d',
+        isOriginChain: false,
+        isEvm: true,
+        explorerUrl: 'https://bscscan.com',
+    },
+    [HYPEREVM_CHAIN_ID]: {
+        chainId: HYPEREVM_CHAIN_ID,
+        name: 'Hyperliquid',
+        shortName: 'HL',
+        usdcAddress: '0xb88339CB7199b77E23DB6E890353E22632Ba630f', // Native USDC on HyperEVM
+        isOriginChain: false,
+        isEvm: true,
+        explorerUrl: 'https://hyperscan.xyz',
+    },
+    // Non-EVM Destination chains
+    [SOLANA_CHAIN_ID]: {
+        chainId: SOLANA_CHAIN_ID,
+        name: 'Solana',
+        shortName: 'SOL',
+        usdcAddress: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+        isOriginChain: false,
+        isEvm: false,
+        explorerUrl: 'https://solscan.io',
+    },
+};
+function normalizeChainSelectionKey(value) {
+    return value.trim().toLowerCase().replace(/[^a-z0-9]/g, '');
+}
+const SUPPORTED_CHAIN_IDS = Object.keys(MAINNET_CHAINS).map(Number);
+const SUPPORTED_CHAIN_ID_SET = new Set(SUPPORTED_CHAIN_IDS);
+const CHAIN_SELECTION_ALIASES = {
+    base: 8453,
+    ethereum: 1,
+    eth: 1,
+    optimism: 10,
+    op: 10,
+    arbitrum: 42161,
+    arb: 42161,
+    polygon: 137,
+    matic: 137,
+    world: 480,
+    worldchain: 480,
+    bnb: 56,
+    bsc: 56,
+    binancesmartchain: 56,
+    hyperliquid: 999,
+    hyperevm: 999,
+    hl: 999,
+    solana: 34268394551451,
+    sol: 34268394551451,
+};
+for (const chainId of SUPPORTED_CHAIN_IDS) {
+    const chainConfig = MAINNET_CHAINS[chainId];
+    const normalizedName = normalizeChainSelectionKey(chainConfig.name);
+    const normalizedShortName = normalizeChainSelectionKey(chainConfig.shortName);
+    if (!(normalizedName in CHAIN_SELECTION_ALIASES)) {
+        CHAIN_SELECTION_ALIASES[normalizedName] = chainId;
+    }
+    if (!(normalizedShortName in CHAIN_SELECTION_ALIASES)) {
+        CHAIN_SELECTION_ALIASES[normalizedShortName] = chainId;
+    }
+}
+const DESTINATION_TOKEN_ADDRESSES = {
+    // Ethereum
+    1: {
+        usdt: '0xdAC17F958D2ee523a2206206994597C13D831ec7',
+    },
+    // Optimism
+    10: {
+        usdt: '0x94b008aA00579c1307B0EF2c499aD98a8ce58e58',
+    },
+    // BNB Smart Chain
+    56: {
+        usdt: '0x55d398326f99059fF775485246999027B3197955',
+    },
+    // Arbitrum
+    42161: {
+        usdt: '0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9',
+    },
+    // Polygon
+    137: {
+        usdt: '0xc2132D05D31c914a87C6611C10748AEb04B58e8F',
+    },
+    // Hyperliquid
+    999: {
+        usdt: '0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb',
+    },
+};
+function isKnownDestinationTokenAlias(value) {
+    return SUPPORTED_DESTINATION_TOKEN_ALIASES.includes(value);
+}
+/**
+ * Normalize destination token aliases (USDC/USDT) into canonical uppercase symbols.
+ * Returns null if the value is empty or not a known alias.
+ */
+export function normalizeDestinationTokenAlias(value) {
+    const normalized = value?.trim().toUpperCase();
+    if (!normalized) {
+        return null;
+    }
+    return isKnownDestinationTokenAlias(normalized) ? normalized : null;
+}
+/**
+ * Check whether a value is a supported destination token alias.
+ */
+export function isDestinationTokenAlias(value) {
+    return normalizeDestinationTokenAlias(value) !== null;
+}
+/**
+ * Resolve destination token alias, falling back to the hard default.
+ */
+export function resolveDefaultDestinationTokenAlias(value) {
+    return normalizeDestinationTokenAlias(value) ?? DEFAULT_DESTINATION_TOKEN_ALIAS;
+}
+/**
+ * Parse a user-provided chain selection into a supported chain ID.
+ * Accepts numeric chain IDs as well as common aliases (e.g. "polygon", "arb", "sol").
+ */
+export function parseSupportedChainSelection(value) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return null;
+    }
+    if (/^\d+$/.test(trimmed)) {
+        const parsed = Number(trimmed);
+        return SUPPORTED_CHAIN_ID_SET.has(parsed) ? parsed : null;
+    }
+    const normalized = normalizeChainSelectionKey(trimmed);
+    return CHAIN_SELECTION_ALIASES[normalized] ?? null;
+}
+/**
+ * Get chain configurations.
+ */
+export function getChainConfigs() {
+    return MAINNET_CHAINS;
+}
+/**
+ * Get chain config by chain ID.
+ */
+export function getChainConfig(chainId) {
+    return getChainConfigs()[chainId];
+}
+/**
+ * Check if chain ID is the origin chain (Base).
+ */
+export function isOriginChain(chainId) {
+    const chain = getChainConfig(chainId);
+    return chain?.isOriginChain ?? false;
+}
+/**
+ * Check if chain ID is an EVM chain.
+ */
+export function isEvmChain(chainId) {
+    const chain = getChainConfig(chainId);
+    return chain?.isEvm ?? true; // Default to EVM if unknown
+}
+/**
+ * Get origin chain ID for current environment.
+ */
+export function getOriginChainId() {
+    const chains = getChainConfigs();
+    const originChain = Object.values(chains).find((c) => c.isOriginChain);
+    return originChain?.chainId ?? BASE_CHAIN_ID;
+}
+/**
+ * Get USDC address for a chain.
+ */
+export function getUsdcAddress(chainId) {
+    return getChainConfig(chainId)?.usdcAddress;
+}
+/**
+ * Resolve destination token alias to chain-specific token address.
+ * Supported aliases:
+ * - USDC: map to configured USDC address
+ * - USDT: map to configured USDT address (if available)
+ * - fallback: return token string as provided (for explicit token addresses)
+ */
+export function resolveDestinationTokenAddress(destinationToken, destinationChainId) {
+    const token = destinationToken.trim();
+    if (!token) {
+        return null;
+    }
+    const chainId = destinationChainId;
+    const tokenAlias = normalizeDestinationTokenAlias(token);
+    const chainAddresses = DESTINATION_TOKEN_ADDRESSES[chainId];
+    if (tokenAlias === 'USDC') {
+        return getUsdcAddress(chainId) ?? null;
+    }
+    if (tokenAlias === 'USDT') {
+        return chainAddresses?.usdt ?? null;
+    }
+    return token;
+}
+/**
+ * Get supported destination token aliases for a destination chain.
+ * Token support is derived from resolvable token addresses for the chain.
+ */
+export function getSupportedDestinationTokenAliasesForChain(destinationChainId) {
+    return SUPPORTED_DESTINATION_TOKEN_ALIASES.filter((tokenAlias) => Boolean(resolveDestinationTokenAddress(tokenAlias, destinationChainId)));
+}
+/**
+ * Get all supported chain IDs.
+ */
+export function getSupportedChainIds() {
+    return [...SUPPORTED_CHAIN_IDS];
+}
+/**
+ * Get destination chain IDs (excludes origin).
+ */
+export function getDestinationChainIds() {
+    return Object.entries(getChainConfigs())
+        .filter(([, cfg]) => !cfg.isOriginChain)
+        .map(([id]) => Number(id));
+}
+/**
+ * Get EVM chain IDs only.
+ */
+export function getEvmChainIds() {
+    return Object.entries(getChainConfigs())
+        .filter(([, cfg]) => cfg.isEvm)
+        .map(([id]) => Number(id));
+}
+/**
+ * Get non-EVM chain IDs (e.g., Solana).
+ */
+export function getNonEvmChainIds() {
+    return Object.entries(getChainConfigs())
+        .filter(([, cfg]) => !cfg.isEvm)
+        .map(([id]) => Number(id));
+}
+/**
+ * Get chain name for display.
+ */
+export function getChainName(chainId) {
+    return getChainConfig(chainId)?.name ?? `Chain ${chainId}`;
+}
+/**
+ * Get chain short name for badges/tags.
+ */
+export function getChainShortName(chainId) {
+    return getChainConfig(chainId)?.shortName ?? `${chainId}`;
+}
+/**
+ * Get explorer URL for a chain.
+ */
+export function getExplorerUrl(chainId) {
+    return getChainConfig(chainId)?.explorerUrl;
+}
+/**
+ * Array of supported chains for UI dropdowns.
+ * Includes origin chain marked with isOrigin flag.
+ */
+export const SUPPORTED_CHAINS = Object.values(MAINNET_CHAINS).map((chain) => ({
+    chainId: chain.chainId,
+    name: chain.name,
+    shortName: chain.shortName,
+    isOrigin: chain.isOriginChain,
+    isEvm: chain.isEvm,
+}));
+/**
+ * Array of destination chains only (excludes Base).
+ */
+export const DESTINATION_CHAINS = SUPPORTED_CHAINS.filter((c) => !c.isOrigin);
+/**
+ * Mapping of chain ID to name for backward compatibility.
+ */
+export const SupportedChainsMap = Object.fromEntries(Object.entries(MAINNET_CHAINS).map(([id, cfg]) => [Number(id), cfg.name]));

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './chains.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './types.js';
+export * from './chains.js';