@provex/utils 1.0.16

package/dist/src/deposit.d.ts

@@ -0,0 +1 @@
+export type StatusMutatingAction = "deposit" | "withdrawal" | "closed" | "exchange";

package/dist/src/deposit.js

@@ -0,0 +1 @@
+export {};

package/dist/src/events.d.ts

@@ -0,0 +1,3 @@
+export declare const eventOrder: readonly ["deposit", "verifier_added", "currency_added", "rate_update", "intent", "exchange", "pruned", "withdrawal", "closed"];
+export type EventType = (typeof eventOrder)[number];
+export declare const eventOrderId: Map<"deposit" | "withdrawal" | "closed" | "exchange" | "verifier_added" | "currency_added" | "rate_update" | "intent" | "pruned", number>;

package/dist/src/events.js

@@ -0,0 +1,16 @@
+export const eventOrder = [
+    // deposit open events
+    'deposit',
+    'verifier_added',
+    'currency_added',
+    // configuration events
+    'rate_update',
+    // intent events
+    'intent',
+    'exchange',
+    'pruned',
+    // deposit close events
+    'withdrawal',
+    'closed',
+];
+export const eventOrderId = new Map(eventOrder.map((event, index) => [event, index]));

package/dist/src/flags.d.ts

@@ -0,0 +1,2 @@
+export declare const USD_FLAG_SVG = "<svg xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" width=\"1235\" height=\"650\" viewBox=\"0 0 7410 3900\"> <path d=\"M0,0h7410v3900H0\" fill=\"#b31942\"/> <path d=\"M0,450H7410m0,600H0m0,600H7410m0,600H0m0,600H7410m0,600H0\" stroke=\"#FFF\" stroke-width=\"300\"/> <path d=\"M0,0h2964v2100H0\" fill=\"#0a3161\"/> <g fill=\"#FFF\"> <g id=\"s18\"> <g id=\"s9\"> <g id=\"s5\"> <g id=\"s4\"> <path id=\"s\" d=\"M247,90 317.534230,307.082039 132.873218,172.917961H361.126782L176.465770,307.082039z\"/> <use xlink:href=\"#s\" y=\"420\"/> <use xlink:href=\"#s\" y=\"840\"/> <use xlink:href=\"#s\" y=\"1260\"/> </g> <use xlink:href=\"#s\" y=\"1680\"/> </g> <use xlink:href=\"#s4\" x=\"247\" y=\"210\"/> </g> <use xlink:href=\"#s9\" x=\"494\"/> </g> <use xlink:href=\"#s18\" x=\"988\"/> <use xlink:href=\"#s9\" x=\"1976\"/> <use xlink:href=\"#s5\" x=\"2470\"/> </g> </svg>";
+export declare const EUR_FLAG_SVG = "<?xml version=\"1.0\" standalone=\"no\"?><!DOCTYPE svg PUBLIC \"-//W3C//DTD SVG 1.1//EN\" \"http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd\"><svg xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" version=\"1.1\" width=\"810\" height=\"540\"><desc>European flag</desc> <defs><g id=\"s\"><g id=\"c\"><path id=\"t\" d=\"M0,0v1h0.5z\" transform=\"translate(0,-1)rotate(18)\"/><use xlink:href=\"#t\" transform=\"scale(-1,1)\"/></g><g id=\"a\"><use xlink:href=\"#c\" transform=\"rotate(72)\"/><use xlink:href=\"#c\" transform=\"rotate(144)\"/></g><use xlink:href=\"#a\" transform=\"scale(-1,1)\"/></g></defs> <rect fill=\"#039\" width=\"810\" height=\"540\"/><g fill=\"#fc0\" transform=\"scale(30)translate(13.5,9)\"><use xlink:href=\"#s\" y=\"-6\"/><use xlink:href=\"#s\" y=\"6\"/><g id=\"l\"><use xlink:href=\"#s\" x=\"-6\"/><use xlink:href=\"#s\" transform=\"rotate(150)translate(0,6)rotate(66)\"/><use xlink:href=\"#s\" transform=\"rotate(120)translate(0,6)rotate(24)\"/><use xlink:href=\"#s\" transform=\"rotate(60)translate(0,6)rotate(12)\"/><use xlink:href=\"#s\" transform=\"rotate(30)translate(0,6)rotate(42)\"/></g><use xlink:href=\"#l\" transform=\"scale(-1,1)\"/></g> </svg>";

package/dist/src/flags.js

@@ -0,0 +1,3 @@
+// Auto-generated from SVG files
+export const USD_FLAG_SVG = '<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="1235" height="650" viewBox="0 0 7410 3900"> <path d="M0,0h7410v3900H0" fill="#b31942"/> <path d="M0,450H7410m0,600H0m0,600H7410m0,600H0m0,600H7410m0,600H0" stroke="#FFF" stroke-width="300"/> <path d="M0,0h2964v2100H0" fill="#0a3161"/> <g fill="#FFF"> <g id="s18"> <g id="s9"> <g id="s5"> <g id="s4"> <path id="s" d="M247,90 317.534230,307.082039 132.873218,172.917961H361.126782L176.465770,307.082039z"/> <use xlink:href="#s" y="420"/> <use xlink:href="#s" y="840"/> <use xlink:href="#s" y="1260"/> </g> <use xlink:href="#s" y="1680"/> </g> <use xlink:href="#s4" x="247" y="210"/> </g> <use xlink:href="#s9" x="494"/> </g> <use xlink:href="#s18" x="988"/> <use xlink:href="#s9" x="1976"/> <use xlink:href="#s5" x="2470"/> </g> </svg>';
+export const EUR_FLAG_SVG = '<?xml version="1.0" standalone="no"?><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="810" height="540"><desc>European flag</desc> <defs><g id="s"><g id="c"><path id="t" d="M0,0v1h0.5z" transform="translate(0,-1)rotate(18)"/><use xlink:href="#t" transform="scale(-1,1)"/></g><g id="a"><use xlink:href="#c" transform="rotate(72)"/><use xlink:href="#c" transform="rotate(144)"/></g><use xlink:href="#a" transform="scale(-1,1)"/></g></defs> <rect fill="#039" width="810" height="540"/><g fill="#fc0" transform="scale(30)translate(13.5,9)"><use xlink:href="#s" y="-6"/><use xlink:href="#s" y="6"/><g id="l"><use xlink:href="#s" x="-6"/><use xlink:href="#s" transform="rotate(150)translate(0,6)rotate(66)"/><use xlink:href="#s" transform="rotate(120)translate(0,6)rotate(24)"/><use xlink:href="#s" transform="rotate(60)translate(0,6)rotate(12)"/><use xlink:href="#s" transform="rotate(30)translate(0,6)rotate(42)"/></g><use xlink:href="#l" transform="scale(-1,1)"/></g> </svg>';

package/dist/src/ids.d.ts

@@ -0,0 +1,72 @@
+import { type Hex } from "viem";
+import { type EventType } from "./events.js";
+import { type TimeResolutionKey } from "./time.js";
+import type { StatAction } from "./stats.js";
+export type DepositVerifierInputs = {
+    verifier: Hex;
+    depositId: Hex;
+};
+export type DepositCurrencyInputs = DepositVerifierInputs & {
+    currency: Hex;
+};
+export type ConversionRateUpdatedInputs = DepositCurrencyInputs & {
+    changeId: number;
+};
+export type ProviderHashInputs = {
+    chainId: bigint | number;
+    hash: Hex;
+};
+export type OnChainHashInputs = {
+    chainId: bigint | number;
+    hash: Hex;
+};
+export type OnChainAddressInputs = {
+    chainId: bigint | number;
+    address: Hex;
+};
+export declare const onChainHash: ({ chainId, hash }: OnChainHashInputs) => `0x${string}`;
+export declare const onChainAddress: ({ chainId, address }: OnChainAddressInputs) => `0x${string}`;
+export declare const ids: {
+    block: ({ chainId, hash }: OnChainHashInputs) => `0x${string}`;
+    transaction: ({ chainId, hash }: OnChainHashInputs) => `0x${string}`;
+    participant: ({ chainId, address }: OnChainAddressInputs) => `0x${string}`;
+    providerHash: ({ chainId, hash }: OnChainHashInputs) => `0x${string}`;
+    verifier: ({ chainId, address }: OnChainAddressInputs) => `0x${string}`;
+    depositVerifierAdded: ({ depositId, verifier }: DepositVerifierInputs) => `0x${string}`;
+    depositCurrencyAdded: ({ depositId, currency, verifier }: DepositCurrencyInputs) => `0x${string}`;
+    depositConversionRateUpdated: ({ currency, verifier, depositId, changeId }: ConversionRateUpdatedInputs) => `0x${string}`;
+};
+export type OrderIdInputs = {
+    timestamp: bigint;
+    chainId: bigint;
+};
+export type OrderIdTransactionInputs = OrderIdInputs & {
+    transactionIndex: bigint;
+};
+export type OrderIdLogInputs = OrderIdTransactionInputs & {
+    logIndex: bigint;
+};
+export type OrderIdOrderInputs = OrderIdLogInputs & {
+    name: EventType;
+};
+export type DepositIdInputs = {
+    chainId: bigint | number;
+    depositId: bigint | number;
+};
+export type LogStatsIdInputs = {
+    timestamp: bigint;
+    type: TimeResolutionKey;
+    action: StatAction;
+    currency: Hex | null;
+    token: Hex;
+    verifier: Hex;
+    chainId: bigint | number;
+};
+export declare const orderId: {
+    deposit: ({ chainId, depositId }: DepositIdInputs) => `0x${string}`;
+    block: ({ timestamp, chainId }: OrderIdInputs) => `0x${string}`;
+    transaction: ({ timestamp, chainId, transactionIndex }: OrderIdTransactionInputs) => `0x${string}`;
+    log: ({ timestamp, chainId, transactionIndex, logIndex }: OrderIdLogInputs) => `0x${string}`;
+    order: ({ timestamp, chainId, transactionIndex, logIndex, name }: OrderIdOrderInputs) => `0x${string}`;
+    stat: ({ timestamp, type, action, currency, verifier, token, chainId }: LogStatsIdInputs) => `0x${string}`;
+};

package/dist/src/ids.js

@@ -0,0 +1,81 @@
+import { concatHex, keccak256, numberToHex, stringToHex } from "viem";
+import { eventOrderId } from "./events.js";
+import { interval } from "./time.js";
+export const onChainHash = ({ chainId, hash }) => (keccak256(concatHex([
+    numberToHex(chainId, { size: 8 }),
+    hash,
+])));
+export const onChainAddress = ({ chainId, address }) => (onChainHash({ chainId, hash: address }));
+export const ids = {
+    block: onChainHash,
+    transaction: onChainHash,
+    participant: onChainAddress,
+    providerHash: onChainHash,
+    verifier: onChainAddress,
+    depositVerifierAdded: ({ depositId, verifier }) => {
+        return keccak256(concatHex([depositId, verifier]));
+    },
+    depositCurrencyAdded: ({ depositId, currency, verifier }) => {
+        return keccak256(concatHex([
+            ids.depositVerifierAdded({ verifier, depositId }),
+            currency,
+        ]));
+    },
+    depositConversionRateUpdated: ({ currency, verifier, depositId, changeId }) => {
+        return concatHex([
+            ids.depositCurrencyAdded({ currency, verifier, depositId }),
+            numberToHex(changeId, { size: 4 }),
+        ]);
+    },
+};
+const hourFactor = BigInt(interval.hour) / BigInt(interval.second);
+const dayFactor = BigInt(interval.day) / BigInt(interval.second);
+const monthFactor = BigInt(interval.month) / BigInt(interval.second);
+export const orderId = {
+    deposit: ({ chainId, depositId }) => concatHex([
+        numberToHex(depositId, { size: 8 }),
+        numberToHex(chainId, { size: 4 }),
+    ]),
+    block: ({ timestamp, chainId }) => concatHex([
+        numberToHex(timestamp, { size: 8 }),
+        numberToHex(chainId, { size: 4 }),
+    ]),
+    transaction: ({ timestamp, chainId, transactionIndex }) => concatHex([
+        numberToHex(timestamp, { size: 8 }),
+        numberToHex(transactionIndex, { size: 4 }),
+        numberToHex(chainId, { size: 4 }),
+    ]),
+    log: ({ timestamp, chainId, transactionIndex, logIndex }) => concatHex([
+        numberToHex(timestamp, { size: 8 }),
+        numberToHex(transactionIndex, { size: 4 }),
+        numberToHex(logIndex, { size: 4 }),
+        numberToHex(chainId, { size: 4 }),
+    ]),
+    order: ({ timestamp, chainId, transactionIndex, logIndex, name }) => concatHex([
+        numberToHex(timestamp, { size: 8 }),
+        numberToHex(transactionIndex, { size: 4 }),
+        numberToHex(eventOrderId.get(name), { size: 1 }),
+        numberToHex(logIndex, { size: 4 }),
+        numberToHex(chainId, { size: 4 }),
+    ]),
+    stat: ({ timestamp, type, action, currency, verifier, token, chainId }) => {
+        const hour = (timestamp / hourFactor) * hourFactor;
+        const day = (timestamp / dayFactor) * dayFactor;
+        const month = (timestamp / monthFactor) * monthFactor;
+        let time = timestamp;
+        if (type === "hour") {
+            time = hour;
+        }
+        if (type === "day") {
+            time = day;
+        }
+        if (type === "month") {
+            time = month;
+        }
+        return concatHex([
+            numberToHex(time, { size: 8 }),
+            `0x${keccak256(concatHex([stringToHex(type), stringToHex(action), token, currency ?? '0x', verifier])).slice(26)}`,
+            numberToHex(chainId, { size: 4 }),
+        ]);
+    },
+};

package/dist/src/index.d.ts

@@ -0,0 +1,16 @@
+export * from './currencies.js';
+export * from './units.js';
+export * from './contracts.js';
+export * from './participants.js';
+export * from './chain.js';
+export * from './intent.js';
+export * from './conversionRates.js';
+export * from './payment.js';
+export * from './sort.js';
+export * from './time.js';
+export * from './tokens.js';
+export * from './stats.js';
+export * from './deposit.js';
+export * from './ids.js';
+export * from './events.js';
+export * from './zkp2p-types.js';

package/dist/src/index.js

@@ -0,0 +1,16 @@
+export * from './currencies.js';
+export * from './units.js';
+export * from './contracts.js';
+export * from './participants.js';
+export * from './chain.js';
+export * from './intent.js';
+export * from './conversionRates.js';
+export * from './payment.js';
+export * from './sort.js';
+export * from './time.js';
+export * from './tokens.js';
+export * from './stats.js';
+export * from './deposit.js';
+export * from './ids.js';
+export * from './events.js';
+export * from './zkp2p-types.js';

package/dist/src/input.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Adjust the lowest decimal place directly on the string, preserving all trailing zeros
+ * @param inputVal - The input value
+ * @param direction - The direction to adjust the decimal place
+ * @returns The adjusted value
+ */
+export declare const adjustLowestDecimal: (inputVal: string, direction: 1 | -1) => string;

package/dist/src/input.js

@@ -0,0 +1,35 @@
+/**
+ * Adjust the lowest decimal place directly on the string, preserving all trailing zeros
+ * @param inputVal - The input value
+ * @param direction - The direction to adjust the decimal place
+ * @returns The adjusted value
+ */
+export const adjustLowestDecimal = (inputVal, direction) => {
+    let [whole, decimal = ''] = inputVal.split('.');
+    // truncate the decimal to 18 decimals
+    decimal = decimal.slice(0, 18);
+    // If no decimals, treat as zero decimals
+    const originalDecimals = decimal.length;
+    // Pad to 18 decimals for calculation
+    const paddedDecimals = (decimal + '0'.repeat(18)).slice(0, 18);
+    // Compose the full number as a string
+    const fullNumberStr = whole + paddedDecimals;
+    let value = BigInt(fullNumberStr);
+    // Determine which decimal place to operate on (last entered, or 18th if maxed)
+    // idx will be -1 if it should be incrementing the whole number
+    const idx = originalDecimals - 1;
+    // The amount to increment/decrement at the correct decimal place
+    const delta = 10n ** BigInt(17 - idx);
+    if (direction === 1) {
+        value += delta;
+    }
+    else if (value >= delta) {
+        value -= delta;
+    }
+    // Convert back to string, pad with zeros if needed
+    let valueStr = value.toString().padStart(whole.length + 18, '0');
+    let newWhole = BigInt(valueStr.slice(0, valueStr.length - 18) || '0').toString();
+    let newDecimal = valueStr.slice(-18, -18 + originalDecimals);
+    // If originalDecimals was 0, don't add a decimal point
+    return originalDecimals > 0 ? `${newWhole}.${newDecimal}` : newWhole;
+};

package/dist/src/intent.d.ts

@@ -0,0 +1,14 @@
+import type { Hex } from "viem";
+/**
+ * Structure for an intent
+ */
+export interface IntentStruct {
+    owner: Hex;
+    to: Hex;
+    depositId: bigint;
+    amount: bigint;
+    timestamp: bigint;
+    paymentVerifier: Hex;
+    fiatCurrency: Hex;
+    conversionRate: bigint;
+}

package/dist/src/intent.js

@@ -0,0 +1 @@
+export {};

package/dist/src/json.d.ts

@@ -0,0 +1,18 @@
+/**
+ * JSON serializer
+ */
+export declare const jsonSerializer: {
+    /**
+     * Parse a JSON string
+     * @param str - The JSON string to parse
+     * @returns The parsed object
+     */
+    parse: (text: string, reviver?: (this: any, key: string, value: any) => any) => any;
+    /**
+     * Stringify an object
+     * @param obj - The object to stringify
+     * @returns The stringified object
+     */
+    stringify: (obj: unknown) => string;
+};
+export declare function mapBigIntFields<T>(obj: T, fields: string[]): T;

package/dist/src/json.js

@@ -0,0 +1,44 @@
+/**
+ * JSON serializer
+ */
+export const jsonSerializer = {
+    /**
+     * Parse a JSON string
+     * @param str - The JSON string to parse
+     * @returns The parsed object
+     */
+    parse: JSON.parse,
+    /**
+     * Stringify an object
+     * @param obj - The object to stringify
+     * @returns The stringified object
+     */
+    stringify: (obj) => JSON.stringify(obj, (_key, value) => {
+        if (typeof value === 'bigint') {
+            return value.toString();
+        }
+        return value;
+    })
+};
+// Recursively convert specified fields to BigInt in an object or array
+export function mapBigIntFields(obj, fields) {
+    if (Array.isArray(obj)) {
+        return obj.map(item => mapBigIntFields(item, fields));
+    }
+    if (obj && typeof obj === 'object') {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            if (fields.includes(key) && typeof value === 'string' && value.match(/^-?\d+$/)) {
+                result[key] = BigInt(value);
+            }
+            else if (Array.isArray(value) || (value && typeof value === 'object')) {
+                result[key] = mapBigIntFields(value, fields);
+            }
+            else {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+    return obj;
+}

package/dist/src/participants.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Generate a participantId from chainId and address using the same logic as the indexer
+ * @param chainId - The chain ID
+ * @param address - The address
+ * @returns The participant ID
+ */
+export declare function generateParticipantId(chainId: number | bigint, address: string): string;

package/dist/src/participants.js

@@ -0,0 +1,13 @@
+import { concatHex, keccak256, numberToHex } from 'viem';
+/**
+ * Generate a participantId from chainId and address using the same logic as the indexer
+ * @param chainId - The chain ID
+ * @param address - The address
+ * @returns The participant ID
+ */
+export function generateParticipantId(chainId, address) {
+    return keccak256(concatHex([
+        numberToHex(chainId, { size: 8 }),
+        address
+    ]));
+}

package/dist/src/payment.d.ts

@@ -0,0 +1,164 @@
+import { type Hex } from "viem";
+import type { TokenInfo } from "./tokens.js";
+import type { ConversionRateInfo, ProviderRates } from "./conversionRates.js";
+import { ChainId } from "./chain.js";
+/**
+ * Payment providers, including manual
+ */
+export declare const providers: {
+    readonly VENMO: "venmo";
+    readonly ZELLE: "zelle";
+    readonly CASHAPP: "cashapp";
+    readonly REVOLUT: "revolut";
+    readonly WISE: "wise";
+    readonly MERCADOPAGO: "mercadopago";
+    readonly MANUAL: "manual";
+    readonly PAYPAL: "paypal";
+    readonly MONZO: "monzo";
+};
+export type ProviderKey = typeof providers[keyof typeof providers];
+/** Distinct keys for payment sub-providers (currently only used by Zelle) */
+export declare const subProviders: {
+    readonly CHASE: "chase";
+    readonly BANK_OF_AMERICA: "bank_of_america";
+    readonly CITI: "citi";
+};
+/** Sub-provider key (providers within providers) */
+export type SubProviderKey = typeof subProviders[keyof typeof subProviders];
+/** Action type for a provider */
+export type ProviderKeyActionType = 'transfer' | 'send';
+/** Validatable provider key */
+export type ValidatableProviderKey = Exclude<ProviderKey, typeof providers.MANUAL>;
+/** Transparent platforms */
+export type TransparentPlatforms = typeof providers.ZELLE;
+/** Platform key */
+export type PlatformKey = Exclude<ValidatableProviderKey, TransparentPlatforms> | SubProviderKey;
+/** Action type */
+export type ActionType = `${ProviderKeyActionType}_${ProviderKey}`;
+/** Provider key to validation key */
+export declare const providerKeyToValidationKey: Record<ValidatableProviderKey, string>;
+/** Validation key */
+export type ValidationKey = typeof providerKeyToValidationKey[keyof typeof providerKeyToValidationKey];
+/** Limits for a payment method */
+export type Limits = {
+    min: number;
+};
+/** Send link options */
+export type SendLinkOptions = {
+    username: string;
+    amount: bigint;
+    subProvider?: SubProviderKey;
+    qrCode?: boolean;
+};
+/** Send link */
+export type SendLink = (options: SendLinkOptions) => string | null;
+/** Payment sub-provider config */
+export type PaymentSubProviderConfig = {
+    key: SubProviderKey;
+    name: string;
+    icon?: string;
+    color?: string;
+    usernameType?: string;
+    verifiers: (chain: ChainId) => Hex[];
+    sendLink: SendLink;
+    paymentMethod: number;
+};
+/** Payment config */
+export type PaymentConfig = {
+    icon: string;
+    key: ProviderKey;
+    name: string;
+    color: string;
+    usernameType: string;
+    validationKey: ValidationKey | null;
+    verifiers: string[];
+    limits: Limits;
+    /**
+     * Set of sub-provider keys that this payment method supports. Empty when none.
+     */
+    subProviders: Set<PaymentSubProviderConfig>;
+    list: Hex[];
+    sendLink?: SendLink;
+};
+/** Validation deposit data payment identifier */
+export type ValidationDepositDataPaymentIdentifier = Partial<{
+    [key in Exclude<ValidationKey, null>]: string;
+}>;
+/** Validation deposit data */
+export type ValidationDepositData = ValidationDepositDataPaymentIdentifier & {
+    telegramUsername: string;
+};
+/** Data encoding for zelle urls */
+export declare const dataEncoding: (data: string) => string;
+/** Default Zelle send link */
+export declare const defaultZelleSendLink: (options: SendLinkOptions) => string | null;
+/** Global configuration for all supported sub-providers. Other modules can import this directly. */
+export declare const subProviderConfigs: Partial<Record<ProviderKey, Record<SubProviderKey, PaymentSubProviderConfig>>>;
+/** Payment method icon mappings */
+export declare const providerConfigs: (chainId: ChainId) => Record<ProviderKey, PaymentConfig>;
+/** Payment verifier to key map */
+export declare const paymentVerifierToKey: (chainId: ChainId | null) => Map<string, ProviderKey>;
+/** Provider key to verifiers map */
+export declare const providerKeyToVerifiersMap: (chainId: ChainId) => Map<ProviderKey, `0x${string}`[]>;
+/** Provider key to verifiers */
+export declare const providerKeyToVerifiers: (chainId: ChainId, providerKey: ProviderKey) => Hex[] | null;
+/** Verifier gets key */
+export declare const verifierGetsKey: (chainId: ChainId | null, verifierAddress: string) => ProviderKey;
+/**
+ * Utility function to get payment method icon
+ * @param key - The provider key
+ * @returns The icon string used for iconify
+ */
+export declare const getPaymentIcon: (chainId: ChainId | null, key: ProviderKey) => string;
+/**
+ * Utility function to get payment method configuration by verifier address
+ * @param verifierAddress - The verifier address
+ * @returns The payment method configuration
+ */
+export declare const getPaymentMethodConfig: (chainId: ChainId | null, verifierAddress: string) => PaymentConfig | null;
+/**
+ * Utility function to get payment method minimum limit by verifier address
+ * @param key - The provider key
+ * @returns The minimum limit
+ */
+export declare const getPaymentMethodMinimum: (chainId: ChainId | null, key: ProviderKey) => number;
+/**
+ * Utility function to get payment method name by verifier address
+ */
+export declare const getPaymentMethodName: (chainId: ChainId | null, verifierAddress: string | ProviderKey) => string;
+/**
+ * Calculate effective minimum amount (higher of user minimum or payment provider minimum)
+ * @param userMinAmountWei - The user minimum amount
+ * @param tokenInfo - The token info
+ * @param providerRates - The provider rates
+ * @returns The effective minimum amount
+ */
+export declare function calculateEffectiveMinimum(chainId: ChainId, userMinAmountWei: string | bigint, tokenInfo: TokenInfo, providerRates?: ProviderRates<ConversionRateInfo>): {
+    userMinAmountWei: bigint;
+    providerMinAmountWei: bigint;
+    effectiveMinAmountWei: bigint;
+    formattedEffectiveMin: string;
+};
+/**
+ * Helper function to get payment provider minimum limit (returns decimal number for config)
+ * @param key - The provider key
+ * @returns The minimum limit
+ */
+export declare function getPaymentProviderMinimum(chainId: ChainId, key: ProviderKey): number;
+/**
+ * Check if a payment method is known
+ * @param chainId - The chain ID
+ * @param verifierAddress - The verifier address
+ * @returns True if the payment method is known, false otherwise
+ */
+export declare const isPaymentMethodKnown: (chainId: ChainId | null, verifierAddress: string) => boolean;
+/**
+ * Get all payment methods
+ * @returns All payment methods
+ */
+export declare const getAllPaymentMethods: (chainId: ChainId) => ProviderKey[];
+/**
+ * Get all verifiable payment methods
+ * @returns All verifiable payment methods
+ */
+export declare const verifiablePaymentMethods: (chainId: ChainId) => ProviderKey[];