@provex/utils 1.0.16 → 1.2.4

package/package.json

@@ -1,45 +1,135 @@
 {
   "name": "@provex/utils",
-  "version": "1.0.16",
-  "main": "dist/src/index.js",
-  "types": "dist/src/index.d.ts",
+  "version": "1.2.4",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "type": "module",
-  "access": "public",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/provex-tech/monorepo.git",
+    "directory": "packages/utils"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "exports": {
-    ".": "./dist/src/index.js",
-    "./contracts": "./dist/src/contracts.js",
-    "./currencies": "./dist/src/currencies.js",
-    "./units": "./dist/src/units.js",
-    "./payment": "./dist/src/payment.js",
-    "./sort": "./dist/src/sort.js",
-    "./time": "./dist/src/time.js",
-    "./tokens": "./dist/src/tokens.js",
-    "./intent": "./dist/src/intent.js",
-    "./conversionRates": "./dist/src/conversionRates.js",
-    "./json": "./dist/src/json.js",
-    "./profit": "./dist/src/profit.js",
-    "./chain": "./dist/src/chain.js",
-    "./participants": "./dist/src/participants.js",
-    "./input": "./dist/src/input.js",
-    "./stats": "./dist/src/stats.js",
-    "./ids": "./dist/src/ids.js",
-    "./events": "./dist/src/events.js",
-    "./zkp2p-types": "./dist/src/zkp2p-types.js",
-    "./deposit": "./dist/src/deposit.js"
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./contracts": {
+      "import": "./dist/contracts.js",
+      "types": "./dist/contracts.d.ts"
+    },
+    "./currencies": {
+      "import": "./dist/currencies.js",
+      "types": "./dist/currencies.d.ts"
+    },
+    "./units": {
+      "import": "./dist/units.js",
+      "types": "./dist/units.d.ts"
+    },
+    "./payment": {
+      "import": "./dist/payment.js",
+      "types": "./dist/payment.d.ts"
+    },
+    "./sort": {
+      "import": "./dist/sort.js",
+      "types": "./dist/sort.d.ts"
+    },
+    "./time": {
+      "import": "./dist/time.js",
+      "types": "./dist/time.d.ts"
+    },
+    "./tokens": {
+      "import": "./dist/tokens.js",
+      "types": "./dist/tokens.d.ts"
+    },
+    "./intent": {
+      "import": "./dist/intent.js",
+      "types": "./dist/intent.d.ts"
+    },
+    "./conversionRates": {
+      "import": "./dist/conversionRates.js",
+      "types": "./dist/conversionRates.d.ts"
+    },
+    "./json": {
+      "import": "./dist/json.js",
+      "types": "./dist/json.d.ts"
+    },
+    "./profit": {
+      "import": "./dist/profit.js",
+      "types": "./dist/profit.d.ts"
+    },
+    "./chain": {
+      "import": "./dist/chain.js",
+      "types": "./dist/chain.d.ts"
+    },
+    "./participants": {
+      "import": "./dist/participants.js",
+      "types": "./dist/participants.d.ts"
+    },
+    "./input": {
+      "import": "./dist/input.js",
+      "types": "./dist/input.d.ts"
+    },
+    "./stats": {
+      "import": "./dist/stats.js",
+      "types": "./dist/stats.d.ts"
+    },
+    "./stateKey": {
+      "import": "./dist/stateKey.js",
+      "types": "./dist/stateKey.d.ts"
+    },
+    "./ids": {
+      "import": "./dist/ids.js",
+      "types": "./dist/ids.d.ts"
+    },
+    "./events": {
+      "import": "./dist/events.js",
+      "types": "./dist/events.d.ts"
+    },
+    "./peer-types": {
+      "import": "./dist/peer-types.js",
+      "types": "./dist/peer-types.d.ts"
+    },
+    "./deposit": {
+      "import": "./dist/deposit.js",
+      "types": "./dist/deposit.d.ts"
+    },
+    "./fees": {
+      "import": "./dist/fees.js",
+      "types": "./dist/fees.d.ts"
+    },
+    "./reputation": {
+      "import": "./dist/reputation.js",
+      "types": "./dist/reputation.d.ts"
+    }
   },
   "scripts": {
-    "build": "tsx scripts/convert-svg && tsc && cp -r src/data dist/src/"
+    "build": "tsx scripts/convert-svg && tsc && cp -r src/data dist/",
+    "test": "node --import tsx --test 'src/**/*.test.ts'",
+    "test:watch": "node --import tsx --test --watch 'src/**/*.test.ts'",
+    "test:coverage": "node --import tsx --test --experimental-test-coverage --test-coverage-exclude='src/**/*.test.ts' --test-coverage-exclude='src/data/**' --test-coverage-exclude='src/flags/**' --test-coverage-exclude='src/flags.ts' --test-coverage-exclude='src/global.d.ts' 'src/**/*.test.ts'"
   },
   "keywords": [],
   "author": "",
   "license": "ISC",
   "description": "",
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "dependencies": {
+    "@zkp2p/providers": "^7.8.0"
+  },
+  "peerDependencies": {
+    "viem": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
     "tsx": "^4.20.3",
     "typescript": "^5.9.2",
     "viem": "^2.38.0"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0"
   }
-}
+}

package/dist/scripts/convert-svg.js

@@ -1,17 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-const __dirname = import.meta.dirname;
-// Read SVG files and convert to TypeScript constants
-const svgDir = path.join(__dirname, '../src/flags');
-const outputFile = path.join(__dirname, '../src/flags.ts');
-const svgFiles = ['usd.svg', 'eur.svg'];
-let output = '// Auto-generated from SVG files\n\n';
-svgFiles.forEach(filename => {
-    const svgPath = path.join(svgDir, filename);
-    const svgContent = fs.readFileSync(svgPath, 'utf8');
-    const cleanSvg = svgContent.replace(/[\r\n]/g, ' ').replace(/\s+/g, ' ').trim();
-    const constName = filename.replace('.svg', '').toUpperCase() + '_FLAG_SVG';
-    output += `export const ${constName} = '${cleanSvg}';\n`;
-});
-fs.writeFileSync(outputFile, output);
-console.log('Generated flags.ts from SVG files');

package/dist/src/chain.d.ts

@@ -1,14 +0,0 @@
-import { type Chain } from 'viem/chains';
-export declare const chains: [Chain, ...Chain[]];
-export declare const chainIds: number[];
-export type ChainId = (typeof chainIds)[number];
-/**
- * Get the explorer URL for a given chain, type, and hash
- * @param chain - The chain to get the explorer URL for
- * @param type - The type of explorer to use (tx or address)
- * @param hash - The hash to get the explorer URL for
- * @returns The explorer URL
- */
-export declare function getExplorerUrl(chain: Chain, type: 'tx' | 'address', hash: string): string;
-export declare const chainIdToChain: Map<number, Chain>;
-export declare const chainIdToTargetBlockTime: Map<number, number>;

package/dist/src/chain.js

@@ -1,18 +0,0 @@
-import { base, pulsechain } from 'viem/chains';
-export const chains = [pulsechain, base];
-export const chainIds = chains.map((chain) => chain.id);
-/**
- * Get the explorer URL for a given chain, type, and hash
- * @param chain - The chain to get the explorer URL for
- * @param type - The type of explorer to use (tx or address)
- * @param hash - The hash to get the explorer URL for
- * @returns The explorer URL
- */
-export function getExplorerUrl(chain, type, hash) {
-    return `${chain.blockExplorers?.default.url}/${type}/${hash}`;
-}
-export const chainIdToChain = new Map(chains.map((chain) => [chain.id, chain]));
-export const chainIdToTargetBlockTime = new Map([
-    [369, 10_000],
-    [8453, 2_000],
-]);

package/dist/src/contracts.d.ts

@@ -1,30 +0,0 @@
-import { type Hex } from 'viem';
-import type { ChainId } from './chain.js';
-/**
- * Contracts for the app
- */
-export type Contracts = {
-    gatingService: Hex;
-    usdc: Hex;
-    escrow: Hex[];
-    venmoReclaimVerifier: Hex[];
-    revolutReclaimVerifier: Hex[];
-    cashappReclaimVerifier: Hex[];
-    wiseReclaimVerifier: Hex[];
-    mercadopagoReclaimVerifier: Hex[];
-    zelleBaseVerifier: Hex[];
-    zelleBoAReclaimVerifier: Hex[];
-    zelleChaseReclaimVerifier: Hex[];
-    zelleCitiReclaimVerifier: Hex[];
-    paypalReclaimVerifier: Hex[];
-    monzoReclaimVerifier: Hex[];
-};
-export declare const reclaimSigners: {
-    readonly zkp2pWitnessSigner: "0x0636c417755E3ae25C6c166D181c0607F4C572A3";
-    readonly reclaimWitnessSigner: "0x244897572368eadf65bfbc5aec98d8e5443a9072";
-};
-export declare const baseContracts: Contracts;
-export declare const pulsechainContracts: Contracts;
-export declare const contractsByChainId: Map<number, Contracts>;
-export declare const getContracts: (chainId: ChainId) => Contracts | null;
-export declare const getLatestContract: (chainId: ChainId, key: keyof Contracts) => `0x${string}` | null;

package/dist/src/contracts.js

@@ -1,64 +0,0 @@
-import { getAddress } from 'viem';
-import { base, pulsechain } from 'viem/chains';
-export const reclaimSigners = {
-    zkp2pWitnessSigner: '0x0636c417755E3ae25C6c166D181c0607F4C572A3',
-    reclaimWitnessSigner: '0x244897572368eadf65bfbc5aec98d8e5443a9072',
-};
-export const baseContracts = {
-    gatingService: getAddress('0x396D31055Db28C0C6f36e8b36f18FE7227248a97'),
-    usdc: getAddress('0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'),
-    escrow: [getAddress('0xCA38607D85E8F6294Dc10728669605E6664C2D70')],
-    venmoReclaimVerifier: [getAddress('0x9a733B55a875D0DB4915c6B36350b24F8AB99dF5')],
-    revolutReclaimVerifier: [getAddress('0xAA5A1B62B01781E789C900d616300717CD9A41aB')],
-    cashappReclaimVerifier: [getAddress('0x76D33A33068D86016B806dF02376dDBb23Dd3703')],
-    wiseReclaimVerifier: [getAddress('0xFF0149799631D7A5bdE2e7eA9b306c42b3d9a9ca')],
-    mercadopagoReclaimVerifier: [
-        // getAddress('0x00d003c73eab8feaec04bab976235915fe7641e3'),
-        getAddress('0xf2AC5be14F32Cbe6A613CFF8931d95460D6c33A3'),
-    ],
-    zelleBaseVerifier: [
-        // getAddress('0x1783f040783c0827fb64d128ece548d9b3613ad5'),
-        getAddress('0x431a078A5029146aAB239c768A615CD484519aF7'),
-    ],
-    zelleChaseReclaimVerifier: [getAddress('0xBcD7C6BBcA5869fBefe3E322263EE1090221D7A9')],
-    zelleBoAReclaimVerifier: [getAddress('0x809c7A20A2dbBB3210fC73Dd7C01Cd7Fa70C195F')],
-    zelleCitiReclaimVerifier: [getAddress('0x3128badc46dbe2e37bdd2d64f33fb3b3a639570e')],
-    paypalReclaimVerifier: [getAddress('0x03d17E9371C858072E171276979f6B44571C5DeA')],
-    monzoReclaimVerifier: [getAddress('0x0dE46433bD251027f73eD8f28E01eF05DA36a2E0')],
-};
-export const pulsechainContracts = {
-    gatingService: getAddress('0x4Bd6364FCC4D8A537aBfee33B16E959794fDf9Cf'),
-    usdc: getAddress('0x15D38573d2feeb82e7ad5187aB8c1D52810B1f07'),
-    escrow: [getAddress('0x2932E08BFD212Ef0732257bDd6463BF55E9b97d7')],
-    cashappReclaimVerifier: [getAddress('0x9224433D6AD9a5A774ca74Ca33c01747FA710A9d')],
-    mercadopagoReclaimVerifier: [getAddress('0xc4D0cf4DF12e329f9c951d1D9BB815da6138850A')],
-    monzoReclaimVerifier: [getAddress('0xBde2c79c1897459e66C0fdF6764EED0c6839C878')],
-    nullifierRegistry: [getAddress('0x471D3c6C9E32CE2556d0117aC161Aa82AEac17d8')],
-    paypalReclaimVerifier: [getAddress('0x1DdBfd39a141C5A2329d849CADa6a83404E0Ce4F')],
-    revolutReclaimVerifier: [getAddress('0x8234AA463C8B94778f58eA0bFEfcBAC3683341A9')],
-    venmoReclaimVerifier: [getAddress('0x0Dd524dA03f610480aF3F433B411b6016cFBDeab')],
-    wiseReclaimVerifier: [getAddress('0x7B72d7CfAfDfD397E2460c933e84D16dc121845a')],
-    zelleBaseVerifier: [getAddress('0x539566771f9c38c6038aafc1946bf11af9cdb201')],
-    zelleBoAReclaimVerifier: [getAddress('0x506a746b8228F9f9d4522105b973Dc7223A64EAC')],
-    zelleChaseReclaimVerifier: [getAddress('0xB0aA0a58959465bBCf0eCbD62A84B743A5435c99')],
-    zelleCitiReclaimVerifier: [getAddress('0x5624E479924eBFb25B51F36e3FDaE605dADb448b')],
-};
-export const contractsByChainId = new Map([
-    [base.id, baseContracts],
-    [pulsechain.id, pulsechainContracts],
-]);
-export const getContracts = (chainId) => {
-    return contractsByChainId.get(chainId) ?? null;
-};
-export const getLatestContract = (chainId, key) => {
-    const contracts = getContracts(chainId);
-    if (!contracts)
-        return null;
-    const target = contracts[key];
-    if (!target)
-        return null;
-    if (Array.isArray(target)) {
-        return target[target.length - 1] ?? null;
-    }
-    return target;
-};

package/dist/src/conversionRates.d.ts

@@ -1,124 +0,0 @@
-import type { Hex } from 'viem';
-import { Currency } from './currencies.js';
-import { type ProviderKey } from './payment.js';
-import type { SortDirection } from './sort.js';
-import type { TokenInfo } from './tokens.js';
-import type { ChainId } from './chain.js';
-/**
- * Conversion rate info
- */
-export interface ConversionRateInfo {
-    depositConversionRateUpdatedId: string;
-    currency: string;
-    verifier: string;
-    value: string;
-    orderId: string;
-    depositId: string;
-    transaction: {
-        hash: string;
-        block: {
-            timestamp: string;
-        };
-    };
-}
-/**
- * Conversion rate info with current deposit conversion rate updated
- */
-export interface ConversionRateInfoWithCurrent extends ConversionRateInfo {
-    currentDepositConversionRateUpdatedId: string;
-    currentDepositConversionRateUpdated: {
-        value: string;
-    };
-}
-/**
- * Provider rates
- */
-export type ProviderRates<RateInfo> = Map<ProviderKey, Map<Hex, RateInfo>>;
-/**
- * Process conversion rates options
- */
-interface ProcessConversionRatesOptions {
-    chainId: ChainId;
-    events: ConversionRateInfoWithCurrent[];
-    sortOrder?: SortDirection;
-    includeHistorical?: boolean;
-}
-/**
- * Get conversion rate options
- */
-interface GetConversionRateOptions {
-    events: ConversionRateInfoWithCurrent[];
-    currency: Hex;
-    verifier: string;
-    chainId: ChainId;
-    includeHistory?: boolean;
-    fallbackRate?: {
-        currency: string;
-        value: string;
-        verifier: string;
-    } | null;
-}
-/**
- * Extract currencies options
- */
-interface ExtractCurrenciesOptions {
-    providerRates: ProviderRates<ConversionRateInfo[]>;
-    providersOnly?: ProviderKey[];
-    currenciesOnly?: string[];
-}
-/**
- * Process deposit currency added events into organized conversion rates
- */
-export declare function processConversionRates(options: ProcessConversionRatesOptions): ProviderRates<ConversionRateInfo[]>;
-/**
- * Get conversion rate for a specific currency and verifier combination
- */
-export declare function getConversionRate(options: GetConversionRateOptions): ConversionRateInfo | ConversionRateInfo[] | null;
-/**
- * Extract unique currencies from processed provider rates
- */
-export declare function extractCurrencies(options: ExtractCurrenciesOptions): string[];
-/**
- * Get the latest conversion rate across all providers for a currency
- */
-export declare function getLatestRateForCurrency(options: {
-    providerRates: ProviderRates<ConversionRateInfo>;
-    currency: Hex;
-    preferredProvider?: ProviderKey;
-}): ConversionRateInfo | null;
-/**
- * Get the primary conversion rate from processed provider rates
- * Returns the first available rate, prioritizing by provider order
- */
-export declare function getPrimaryConversionRate(providerRates: ProviderRates<ConversionRateInfo>): ConversionRateInfo | null;
-/**
- * Get primary conversion rate for a specific currency across all providers
- */
-export declare function getPrimaryRateForCurrency(providerRates: ProviderRates<ConversionRateInfo>, currency: Hex): ConversionRateInfo | null;
-/**
- * Get the primary verifier (payment provider) from conversion rates
- */
-export declare function getPrimaryVerifier(providerRates: ProviderRates<ConversionRateInfo>): string | null;
-/**
- * Get the primary currency from conversion rates
- */
-export declare function getPrimaryCurrency(providerRates: ProviderRates<ConversionRateInfo>): string | null;
-/**
- * Convert token input to currency
- */
-export declare const convertTokenInputToCurrency: ({ token, amountOutInt, rate }: {
-    token: TokenInfo;
-    amountOutInt: bigint;
-    rate: bigint;
-}) => bigint;
-/**
- * Convert currency amount to token amount out (inverse of convertTokenInputToCurrency)
- * This accounts for the cent-rounding applied in the original function
- */
-export declare const convertCurrencyToTokenOutput: ({ token, currency, currencyAmountInt, rate, }: {
-    token: TokenInfo;
-    currency: Currency;
-    currencyAmountInt: bigint;
-    rate: bigint;
-}) => bigint;
-export {};

package/dist/src/currencies.d.ts

@@ -1,144 +0,0 @@
-import { type Hex } from 'viem';
-import { type FormatRateDisplayOptions } from './units.js';
-/**
- * Relevant info for a currency
- */
-export interface CurrencyInfo {
-    ticker: string;
-    symbol: string;
-    name: string;
-    decimals: number;
-    contractId: Hex;
-    flag: string;
-}
-/**
- * Country info from the countries.json file
- */
-export interface CountryInfo {
-    code: string;
-    name: string;
-    country: string;
-    countryCode: string;
-    flag?: string;
-}
-/**
- * Convert a ticker to a contract ID
- * @param ticker - The ticker to convert
- * @returns The contract ID
- */
-export declare const tickerToContractId: (ticker: string) => Hex;
-/**
- * Currency class that automatically generates contract ID
- * @param code - The currency code
- * @param symbol - The currency symbol
- * @param name - The currency name
- * @param decimals - The number of decimals
- * @param flag - The flag image path
- */
-export declare class Currency implements CurrencyInfo {
-    readonly ticker: string;
-    readonly symbol: string;
-    readonly name: string;
-    readonly decimals: number;
-    readonly contractId: Hex;
-    readonly flag: string;
-    constructor(code: string, symbol: string, name: string, decimals: number, flag?: string);
-    /**
-     * Generate a contract ID for the currency
-     * @returns The contract ID
-     */
-    private generateContractId;
-    /**
-     * Parse an amount to a bigint
-     * @param amount - The amount to parse
-     * @returns The amount as a bigint
-     */
-    parseAmount(amount: string): bigint | null;
-    /**
-     * Format an amount to a string
-     * @param amount - The amount to format
-     * @returns The amount as a string
-     */
-    formatAmount(amount: bigint | null, options?: Partial<FormatRateDisplayOptions>): string | null;
-    /**
-     * Convert to plain object for compatibility
-     * @returns The currency info
-     */
-    toJSON(): CurrencyInfo;
-}
-/**
- * Generate contract ID for a currency code (standalone function for backward compatibility)
- * @param currencyCode - The currency code
- */
-export declare function generateCurrencyId(currencyCode: string): string;
-export declare const SUPPORTED_CURRENCIES: {
-    readonly USD: Currency;
-    readonly EUR: Currency;
-    readonly GBP: Currency;
-    readonly AUD: Currency;
-    readonly CAD: Currency;
-    readonly NZD: Currency;
-    readonly CHF: Currency;
-    readonly SEK: Currency;
-    readonly NOK: Currency;
-    readonly DKK: Currency;
-    readonly PLN: Currency;
-    readonly CZK: Currency;
-    readonly ARS: Currency;
-    readonly CNY: Currency;
-    readonly MXN: Currency;
-    readonly JPY: Currency;
-    readonly THB: Currency;
-    readonly RUB: Currency;
-    readonly AED: Currency;
-    readonly ZAR: Currency;
-    readonly HKD: Currency;
-    readonly SGD: Currency;
-    readonly SAR: Currency;
-    readonly ILS: Currency;
-    readonly IDR: Currency;
-    readonly MYR: Currency;
-    readonly PHP: Currency;
-    readonly VND: Currency;
-    readonly KRW: Currency;
-    readonly INR: Currency;
-    readonly BRL: Currency;
-    readonly KES: Currency;
-    readonly TRY: Currency;
-    readonly UGX: Currency;
-    readonly RON: Currency;
-    readonly HUF: Currency;
-};
-/** Supported currency code */
-export type SupportedCurrencyCode = keyof typeof SUPPORTED_CURRENCIES;
-export declare const currencyById: Map<`0x${string}`, Currency>;
-/**
- * Get the currency info for a currency code
- * @param currencyCode - The currency code
- * @returns The currency info
- */
-export declare function getCurrencyInfo(currencyCode: string): CurrencyInfo | null;
-/**
- * Get the currency info for a contract ID
- * @param contractId - The contract ID
- * @returns The currency info
- */
-export declare function getCurrencyByContractId(contractId: string): Currency | null;
-/**
- * Format a currency amount
- * @param amount - The amount to format
- * @param currencyCode - The currency code
- * @returns The formatted currency amount
- */
-export declare function formatCurrencyAmount(amount: string | number, currencyCode: string): string;
-/**
- * Get all supported currencies
- * @returns All supported currencies
- */
-export declare function getAllSupportedCurrencies(): CurrencyInfo[];
-/**
- * Check if a currency is supported
- * @param currencyCode - The currency code
- * @returns True if the currency is supported, false otherwise
- */
-export declare function isSupportedCurrency(currencyCode: string): boolean;