tapimo 0.13.0 → 0.15.0

package/dist/internal/{funding → routes}/Evidence.js

@@ -1,5 +1,5 @@
 import { AbiEvent, Address, Base58, Bytes, Hash, Hex, RpcSchema, RpcTransport } from 'ox';
-import { createClient, custom, fallback, TransactionReceiptNotFoundError } from 'viem';
+import { TransactionReceiptNotFoundError } from 'viem';
 import { getBlockNumber, getTransactionReceipt } from 'viem/actions';
 import * as z from 'zod/mini';
 import * as Db from '../../db/Db.js';
@@ -118,7 +118,7 @@ export function createVerifier(options) {
     };
 }
 async function verifyEvm(parameters, options) {
-    const client = jsonRpcClient(options);
+    const client = Viem.createEvmClient(options);
     const [receipt, head] = await Promise.all([
         getTransactionReceipt(client, { hash: parameters.transactionHash }).catch((cause) => {
             if (cause instanceof TransactionReceiptNotFoundError)
@@ -236,14 +236,6 @@ async function verifyTron(parameters, options) {
         ];
     });
 }
-function jsonRpcClient(options) {
-    return createClient({
-        transport: fallback(options.urls.map((url) => {
-            const transport = RpcTransport.fromHttp(url, { fetchFn: options.fetch });
-            return custom(transport, { retryCount: 0 });
-        })),
-    });
-}
 async function requestSolana(options, request) {
     let cause;
     for (const rpcUrl of options.urls) {
@@ -256,7 +248,7 @@ async function requestSolana(options, request) {
             cause = error;
         }
     }
-    throw cause ?? new ChainResponseError('No funding evidence endpoint is configured.');
+    throw cause ?? new ChainResponseError('No routes evidence endpoint is configured.');
 }
 async function post(options, pathname, body, result) {
     let cause;
@@ -277,7 +269,7 @@ async function post(options, pathname, body, result) {
             cause = error;
         }
     }
-    throw cause ?? new ChainResponseError('No funding evidence endpoint is configured.');
+    throw cause ?? new ChainResponseError('No routes evidence endpoint is configured.');
 }
 function tronHex(address) {
     const bytes = Base58.toBytes(address);
@@ -297,19 +289,19 @@ function tronAddress(hex) {
     bytes.set(checksum, payload.length);
     return Base58.fromBytes(bytes);
 }
-/** No authoritative chain endpoint is configured for a funding route. */
+/** No authoritative chain endpoint is configured for a provider route. */
 export class ChainConfigurationError extends Error {
-    name = 'Funding.Evidence.ChainConfigurationError';
+    name = 'Routes.Evidence.ChainConfigurationError';
     constructor(chainId) {
-        super(`No funding evidence endpoint is configured for ${chainId}.`);
+        super(`No routes evidence endpoint is configured for ${chainId}.`);
     }
 }
 /** An authoritative chain endpoint returned an invalid payload. */
 export class ChainPayloadError extends Error {
-    name = 'Funding.Evidence.ChainPayloadError';
+    name = 'Routes.Evidence.ChainPayloadError';
 }
 /** An authoritative chain endpoint returned an unsuccessful response. */
 export class ChainResponseError extends Error {
-    name = 'Funding.Evidence.ChainResponseError';
+    name = 'Routes.Evidence.ChainResponseError';
 }
 //# sourceMappingURL=Evidence.js.map

package/dist/internal/routes/Evidence.js.map

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

package/dist/internal/routes/Observability.d.ts

@@ -0,0 +1,154 @@
+import type * as Db from '../../db/Db.js';
+import * as RoutesDepositAddresses from '../../db/tables/routesDepositAddresses.js';
+import * as RoutesDeposits from '../../db/tables/routesDeposits.js';
+import * as RoutesTransfers from '../../db/tables/routesTransfers.js';
+import type * as Metrics from '../../Metrics.js';
+import * as Economics from './Economics.js';
+import * as Provider from './Provider.js';
+/** One completed route lifecycle stage used for retrospective history. */
+export type LifecycleInterval = {
+    /** UTC time when the stage ended. */
+    endedAt: string;
+    /** API-key environment that owns the route journey. */
+    routesEnvironment: 'production' | 'sandbox';
+    /** Route method used by the journey. */
+    method: 'deposit_address' | 'transaction';
+    /** Route provider that owns the journey. */
+    provider: string;
+    /** Stable route resource id. */
+    resourceId: string;
+    /** Completed lifecycle stage. */
+    stage: 'source_routes';
+    /** UTC time when the stage began. */
+    startedAt: string;
+};
+/** Returns the source-routes interval completed by an address's first verified deposit. */
+export declare function depositAddressSourceRoutesInterval(options: depositAddressSourceRoutesInterval.Options): LifecycleInterval;
+export declare namespace depositAddressSourceRoutesInterval {
+    /** Address and first verified provider request. */
+    type Options = {
+        /** Reusable deposit address whose first route journey advanced. */
+        address: RoutesDepositAddresses.Record;
+        /** Provider request that first reported source funds. */
+        request: Provider.listDepositAddressRequests.ReturnType['requests'][number];
+    };
+}
+/** Records a committed deposit transition and its completed lifecycle segments. */
+export declare function recordDeposit(metrics: Metrics.Metrics | undefined, options: recordDeposit.Options): void;
+export declare namespace recordDeposit {
+    /** Committed deposit transition. */
+    type Options = {
+        /** Record before the transition, absent for first detection. */
+        previous?: RoutesDeposits.Record | undefined;
+        /** Whether complete provider delivery evidence informed this transition. */
+        providerEvidenceComplete?: boolean | undefined;
+        /** Committed deposit record. */
+        record: RoutesDeposits.Record;
+    };
+}
+/** Records a committed deposit-address transition. */
+export declare function recordDepositAddress(metrics: Metrics.Metrics | undefined, options: recordDepositAddress.Options): void;
+export declare namespace recordDepositAddress {
+    /** Committed deposit-address transition. */
+    type Options = {
+        /** Record before the transition, absent for creation. */
+        previous?: RoutesDepositAddresses.Record | undefined;
+        /** Committed deposit-address record. */
+        record: RoutesDepositAddresses.Record;
+    };
+}
+/** Records a bounded deposit-address cap rejection. */
+export declare function recordDepositAddressLimitRejection(metrics: Metrics.Metrics | undefined, options: recordDepositAddressLimitRejection.Options): void;
+export declare namespace recordDepositAddressLimitRejection {
+    /** Bounded dimensions for one rejected address creation. */
+    type Options = {
+        /** API-key environment whose request was rejected. */
+        routesEnvironment: 'production' | 'sandbox';
+    };
+}
+/** Records a bounded creation-time Routes subsidy rejection. */
+export declare function recordSubsidyRejection(metrics: Metrics.Metrics | undefined, options: recordSubsidyRejection.Options): void;
+export declare namespace recordSubsidyRejection {
+    /** Bounded dimensions for one rejected subsidy request. */
+    type Options = {
+        /** Public reason returned to the caller. */
+        reason: 'billing_past_due' | 'billing_required' | 'routes_subsidy_not_enabled';
+        /** API-key environment whose request was rejected. */
+        routesEnvironment: 'production' | 'sandbox';
+    };
+}
+/** Records a committed transfer transition and its completed lifecycle segments. */
+export declare function recordTransfer(metrics: Metrics.Metrics | undefined, options: recordTransfer.Options): void;
+export declare namespace recordTransfer {
+    /** Committed transfer transition. */
+    type Options = {
+        /** Record before the transition, absent for creation. */
+        previous?: RoutesTransfers.Record | undefined;
+        /** Committed transfer record. */
+        record: RoutesTransfers.Record;
+        /** Automatic selection comparison retained only while creating the transfer. */
+        selection?: recordRouteQuote.Options['selection'] | undefined;
+    };
+}
+/** Records customer economics for one selected route quote. */
+export declare function recordRouteQuote(metrics: Metrics.Metrics | undefined, options: recordRouteQuote.Options): void;
+export declare namespace recordRouteQuote {
+    /** Selected quote and its bounded corridor dimensions. */
+    type Options = {
+        /** Selected expected destination amount. */
+        destinationAmount?: Economics.Amount | undefined;
+        /** Destination chain selected for the route. */
+        destinationChain: Pick<Provider.ChainRef, 'id'>;
+        /** Destination token selected for the route. */
+        destinationToken: Pick<Provider.TokenRef, 'tokenKey'>;
+        /** Party responsible for the provider fees. */
+        feePayer: 'customer' | 'tempo';
+        /** Provider fees included in the selected quote. */
+        fees: readonly {
+            /** Fee amount in the charged token. */
+            amount: Economics.Amount;
+            /** Stable key for the charged token. */
+            token: Pick<Provider.TokenRef, 'tokenKey'>;
+        }[];
+        /** API-key environment that owns the route. */
+        routesEnvironment: 'production' | 'sandbox';
+        /** Route method selected by the caller. */
+        method: 'deposit_address' | 'transaction';
+        /** Provider selected for the route. */
+        provider: Pick<Provider.RoutesQuote['provider'], 'id'>;
+        /** Automatic selection comparison, omitted for provider-forced requests. */
+        selection?: Selection | undefined;
+        /** Requested source amount. */
+        sourceAmount: Economics.Amount;
+        /** Source chain selected for the route. */
+        sourceChain: Pick<Provider.ChainRef, 'id'>;
+        /** Source token selected for the route. */
+        sourceToken: Pick<Provider.TokenRef, 'tokenKey'>;
+    };
+    /** Automatic route-selection comparison. */
+    type Selection = {
+        /** Highest expected destination amount returned by successful candidates. */
+        bestDestinationAmount: string;
+    };
+}
+/** Returns the source-routes interval completed by initial source registration. */
+export declare function transferSourceRoutesInterval(options: transferSourceRoutesInterval.Options): LifecycleInterval | undefined;
+export declare namespace transferSourceRoutesInterval {
+    /** Transfer whose initial source registration has completed. */
+    type Options = {
+        /** Registered transfer at the start of provider processing. */
+        record: RoutesTransfers.Record;
+    };
+}
+/** Queries active durable routes state and emits zero-filled gauges. */
+export declare function recordState(db: Db.Db, options: recordState.Options): Promise<void>;
+export declare namespace recordState {
+    /** Durable routes state snapshot dependencies. */
+    type Options = {
+        /** Bounded operational metrics backend. */
+        metrics: Metrics.Metrics;
+        /** Route providers configured by the host application. */
+        providers: readonly Provider.Provider[];
+    };
+}
+//# sourceMappingURL=Observability.d.ts.map

package/dist/internal/routes/Observability.d.ts.map

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

package/dist/internal/routes/Observability.js

@@ -0,0 +1,389 @@
+import * as RoutesDepositAddresses from '../../db/tables/routesDepositAddresses.js';
+import * as RoutesDeposits from '../../db/tables/routesDeposits.js';
+import * as RoutesTransfers from '../../db/tables/routesTransfers.js';
+import * as Deposit from './Deposit.js';
+import * as DepositAddress from './DepositAddress.js';
+import * as Economics from './Economics.js';
+import * as Provider from './Provider.js';
+import * as Transfer from './Transfer.js';
+const activeDepositStatuses = Deposit.statuses.filter((status) => !Deposit.isTerminal(status));
+const activeDepositAddressStatuses = DepositAddress.statuses.filter((status) => !DepositAddress.isTerminal(status));
+const activeTransferStatuses = Transfer.statuses.filter((status) => !Transfer.isTerminal(status));
+const environments = ['production', 'sandbox'];
+/** Returns the source-routes interval completed by an address's first verified deposit. */
+export function depositAddressSourceRoutesInterval(options) {
+    return {
+        endedAt: end(options.address.createdAt, options.request.createdAt),
+        routesEnvironment: options.address.environment,
+        method: 'deposit_address',
+        provider: options.address.providerId,
+        resourceId: options.address.id,
+        stage: 'source_routes',
+        startedAt: options.address.createdAt,
+    };
+}
+/** Records a committed deposit transition and its completed lifecycle segments. */
+export function recordDeposit(metrics, options) {
+    if (!metrics || options.previous?.status === options.record.status)
+        return;
+    metrics.count('routes_resource_transition_count', 1, {
+        from_status: options.previous?.status ?? 'none',
+        routes_environment: options.record.environment,
+        method: 'deposit_address',
+        provider: options.record.snapshot.provider.id,
+        reason: options.record.statusReason?.code ?? 'none',
+        resource: 'deposit',
+        to_status: options.record.status,
+    });
+    if (options.providerEvidenceComplete &&
+        options.record.providerDeliveredAt &&
+        (options.previous?.status === 'bridging' || options.previous?.status === 'detected'))
+        lifecycle(metrics, options.record.providerDeliveredAt, options.record.createdAt, {
+            flow: 'deposit_address',
+            routes_environment: options.record.environment,
+            outcome: 'success',
+            provider: options.record.snapshot.provider.id,
+            segment: 'detected_to_provider_delivery',
+        });
+    if (options.record.status !== 'completed')
+        return;
+    const tags = routeTags({
+        routesEnvironment: options.record.environment,
+        method: 'deposit_address',
+        snapshot: options.record.snapshot,
+    });
+    recordCustomerValueLoss(metrics, {
+        destination: options.record.snapshot.destinationAmount,
+        source: options.record.snapshot.sourceAmount,
+        tags: { ...tags, stage: 'executed' },
+    });
+    if (options.record.subsidyAmount) {
+        const subsidy = Economics.usd(options.record.subsidyAmount);
+        if (subsidy !== undefined)
+            metrics.histogram('routes_tempo_subsidy_usd', subsidy, tags);
+    }
+    if (options.record.tempoGasPaid) {
+        const gasPaid = Number(options.record.tempoGasPaid);
+        if (Number.isFinite(gasPaid))
+            metrics.histogram('routes_tempo_gas_paid_base_units', gasPaid, tags);
+    }
+    if (options.previous?.status === 'settling' && options.record.providerDeliveredAt)
+        lifecycle(metrics, options.record.updatedAt, options.record.providerDeliveredAt, {
+            flow: 'deposit_address',
+            routes_environment: options.record.environment,
+            outcome: 'success',
+            provider: options.record.snapshot.provider.id,
+            segment: 'provider_delivery_to_completed',
+        });
+    lifecycle(metrics, options.record.updatedAt, options.record.createdAt, {
+        flow: 'deposit_address',
+        routes_environment: options.record.environment,
+        outcome: 'success',
+        provider: options.record.snapshot.provider.id,
+        segment: 'detected_to_completed',
+    });
+}
+/** Records a committed deposit-address transition. */
+export function recordDepositAddress(metrics, options) {
+    if (!metrics || options.previous?.status === options.record.status)
+        return;
+    metrics.count('routes_resource_transition_count', 1, {
+        from_status: options.previous?.status ?? 'none',
+        routes_environment: options.record.environment,
+        method: 'deposit_address',
+        provider: options.record.providerId,
+        reason: 'none',
+        resource: 'deposit_address',
+        to_status: options.record.status,
+    });
+}
+/** Records a bounded deposit-address cap rejection. */
+export function recordDepositAddressLimitRejection(metrics, options) {
+    if (!metrics)
+        return;
+    metrics.count('routes_deposit_address_limit_rejection_count', 1, {
+        routes_environment: options.routesEnvironment,
+    });
+}
+/** Records a bounded creation-time Routes subsidy rejection. */
+export function recordSubsidyRejection(metrics, options) {
+    if (!metrics)
+        return;
+    metrics.count('routes_subsidy_request_rejection_count', 1, {
+        reason: options.reason,
+        routes_environment: options.routesEnvironment,
+    });
+}
+/** Records a committed transfer transition and its completed lifecycle segments. */
+export function recordTransfer(metrics, options) {
+    if (!metrics)
+        return;
+    const flow = method(options.record.method);
+    const provider = options.record.providerId;
+    if (options.previous?.status !== options.record.status)
+        metrics.count('routes_resource_transition_count', 1, {
+            from_status: options.previous?.status ?? 'none',
+            routes_environment: options.record.environment,
+            method: method(options.record.method),
+            provider,
+            reason: options.record.statusReason?.code ?? 'none',
+            resource: 'transfer',
+            to_status: options.record.status,
+        });
+    if (options.previous === undefined)
+        recordRouteQuote(metrics, {
+            destinationAmount: options.record.snapshot.destinationAmount,
+            destinationChain: options.record.snapshot.destinationChain,
+            destinationToken: options.record.snapshot.destinationToken,
+            feePayer: options.record.snapshot.subsidize ? 'tempo' : 'customer',
+            fees: options.record.snapshot.fees,
+            routesEnvironment: options.record.environment,
+            method: flow,
+            provider: options.record.snapshot.provider,
+            ...(options.selection === undefined ? {} : { selection: options.selection }),
+            sourceAmount: options.record.snapshot.sourceAmount,
+            sourceChain: options.record.snapshot.sourceChain,
+            sourceToken: options.record.snapshot.sourceToken,
+        });
+    if (options.previous?.status === 'awaiting-source' &&
+        options.previous.version === 1 &&
+        options.record.status === 'processing')
+        lifecycle(metrics, options.record.updatedAt, options.record.createdAt, {
+            flow,
+            routes_environment: options.record.environment,
+            outcome: 'success',
+            provider,
+            segment: 'created_to_source_registered',
+        });
+    if (!options.previous?.providerDeliveredAt && options.record.providerDeliveredAt)
+        lifecycle(metrics, options.record.providerDeliveredAt, options.previous?.statusUpdatedAt ?? options.previous?.updatedAt ?? options.record.createdAt, {
+            flow,
+            routes_environment: options.record.environment,
+            outcome: 'success',
+            provider,
+            segment: 'source_registered_to_provider_delivery',
+        });
+    if (options.previous?.status !== 'processing' || options.record.status !== 'completed')
+        return;
+    const tags = routeTags({
+        routesEnvironment: options.record.environment,
+        method: flow,
+        snapshot: options.record.snapshot,
+    });
+    if (options.record.subsidyAmount) {
+        const subsidy = Economics.usd(options.record.subsidyAmount);
+        if (subsidy !== undefined)
+            metrics.histogram('routes_tempo_subsidy_usd', subsidy, tags);
+    }
+    if (options.record.subsidyTransactionHash && options.previous.providerDeliveredAt)
+        lifecycle(metrics, options.record.updatedAt, options.previous.providerDeliveredAt, {
+            flow,
+            routes_environment: options.record.environment,
+            outcome: 'success',
+            provider,
+            segment: 'provider_delivery_to_completed',
+        });
+    lifecycle(metrics, options.record.updatedAt, options.record.createdAt, {
+        flow,
+        routes_environment: options.record.environment,
+        outcome: 'success',
+        provider,
+        segment: 'created_to_completed',
+    });
+}
+/** Records customer economics for one selected route quote. */
+export function recordRouteQuote(metrics, options) {
+    if (!metrics || !options.destinationAmount)
+        return;
+    const tags = routeTags({
+        routesEnvironment: options.routesEnvironment,
+        method: options.method,
+        snapshot: options,
+    });
+    recordCustomerValueLoss(metrics, {
+        destination: options.destinationAmount,
+        source: options.sourceAmount,
+        tags: { ...tags, stage: 'selected' },
+    });
+    const providerFeeUsdMetric = options.feePayer === 'tempo'
+        ? 'routes_tempo_provider_fee_usd'
+        : 'routes_customer_provider_fee_usd';
+    const providerFeeTokenMetric = options.feePayer === 'tempo'
+        ? 'routes_tempo_provider_fee_token_units'
+        : 'routes_customer_provider_fee_token_units';
+    const providerFeesUsd = options.fees.map((fee) => Economics.usd(fee.amount));
+    if (providerFeesUsd.every((cost) => cost !== undefined))
+        metrics.histogram(providerFeeUsdMetric, providerFeesUsd.reduce((total, cost) => total + cost, 0), tags);
+    const providerFees = new Map();
+    for (const fee of options.fees)
+        providerFees.set(fee.token.tokenKey, [...(providerFees.get(fee.token.tokenKey) ?? []), fee]);
+    for (const [feeToken, fees] of providerFees) {
+        const values = fees.map((fee) => Economics.units(fee.amount));
+        if (values.every((value) => value !== undefined))
+            metrics.histogram(providerFeeTokenMetric, values.reduce((total, value) => total + value, 0), { ...tags, fee_token: feeToken });
+    }
+    if (options.selection) {
+        const delta = Economics.differenceBps({
+            reference: {
+                ...options.destinationAmount,
+                baseUnits: options.selection.bestDestinationAmount,
+            },
+            value: options.destinationAmount,
+        });
+        if (delta !== undefined)
+            metrics.histogram('routes_selection_delta_bps', delta, tags);
+    }
+}
+/** Returns the source-routes interval completed by initial source registration. */
+export function transferSourceRoutesInterval(options) {
+    if (options.record.status !== 'processing' || options.record.version !== 2)
+        return undefined;
+    return {
+        endedAt: end(options.record.createdAt, options.record.statusUpdatedAt ?? options.record.updatedAt),
+        routesEnvironment: options.record.environment,
+        method: method(options.record.method),
+        provider: options.record.providerId,
+        resourceId: options.record.id,
+        stage: 'source_routes',
+        startedAt: options.record.createdAt,
+    };
+}
+/** Queries active durable routes state and emits zero-filled gauges. */
+export async function recordState(db, options) {
+    const now = new Date();
+    const [addresses, deposits, overdue, transfers] = await Promise.all([
+        RoutesDepositAddresses.summarizeStates(db),
+        RoutesDeposits.summarizeStates(db, { statuses: activeDepositStatuses }),
+        RoutesDepositAddresses.summarizeOverdue(db, { now: now.toISOString() }),
+        RoutesTransfers.summarizeStates(db, { statuses: activeTransferStatuses }),
+    ]);
+    const states = [
+        ...addresses.map((state) => ({
+            ...state,
+            method: 'deposit_address',
+            reason: 'none',
+            resource: 'deposit_address',
+        })),
+        ...deposits.map((state) => ({
+            ...state,
+            method: 'deposit_address',
+            reason: state.reason ?? 'none',
+            resource: 'deposit',
+        })),
+        ...transfers.map((state) => ({
+            ...state,
+            method: method(state.method),
+            reason: state.reason ?? 'none',
+            resource: 'transfer',
+        })),
+    ];
+    const dimensions = new Map([...providerDimensions(options.providers), ...states].map((state) => [key(state, []), state]));
+    const statesByKey = new Map(states.map((state) => [key(state, [state.status, state.reason]), state]));
+    for (const state of dimensions.values())
+        for (const status of statuses(state.resource)) {
+            const reasons = statusReasons(state.resource, status);
+            for (const reason of reasons) {
+                const current = statesByKey.get(key(state, [status, reason]));
+                const tags = {
+                    routes_environment: state.environment,
+                    method: state.method,
+                    provider: state.providerId,
+                    reason,
+                    resource: state.resource,
+                    status,
+                };
+                options.metrics.gauge('routes_resource_state_count', Number(current?.count ?? 0), tags);
+                options.metrics.gauge('routes_resource_oldest_state_age_ms', current ? age(now, current.oldestStatusUpdatedAt) : 0, tags);
+            }
+        }
+    const overdueByKey = new Map(overdue.map((state) => [[state.providerId, state.environment].join(':'), state]));
+    for (const state of dimensions.values()) {
+        if (state.resource !== 'deposit_address')
+            continue;
+        const current = overdueByKey.get([state.providerId, state.environment].join(':'));
+        const tags = { routes_environment: state.environment, provider: state.providerId };
+        options.metrics.gauge('routes_deposit_address_overdue_count', Number(current?.count ?? 0), tags);
+        options.metrics.gauge('routes_deposit_address_oldest_overdue_age_ms', current ? age(now, current.oldestNextPollAt) : 0, tags);
+    }
+}
+function recordCustomerValueLoss(metrics, options) {
+    if (!options.source || !options.destination)
+        return;
+    const valueLoss = Economics.differenceBps({
+        reference: options.source,
+        value: options.destination,
+    });
+    if (valueLoss !== undefined)
+        metrics.histogram('routes_customer_value_loss_bps', valueLoss, options.tags);
+}
+function routeTags(options) {
+    return {
+        destination_chain: options.snapshot.destinationChain.id,
+        destination_token: options.snapshot.destinationToken.tokenKey,
+        routes_environment: options.routesEnvironment,
+        method: options.method,
+        provider: options.snapshot.provider.id,
+        source_chain: options.snapshot.sourceChain.id,
+        source_token: options.snapshot.sourceToken.tokenKey,
+    };
+}
+function lifecycle(metrics, end, start, tags) {
+    metrics.histogram('routes_lifecycle_duration_ms', Math.max(0, Date.parse(end) - Date.parse(start)), tags);
+}
+function end(start, value) {
+    return new Date(Math.max(Date.parse(start), Date.parse(value))).toISOString();
+}
+function age(now, timestamp) {
+    return Math.max(0, now.getTime() - Date.parse(timestamp));
+}
+function key(state, suffix) {
+    return [state.resource, state.providerId, state.environment, state.method, ...suffix].join(':');
+}
+function providerDimensions(providers) {
+    return providers.flatMap((provider) => environments.flatMap((environment) => [
+        ...(Provider.canCreateDepositAddress(provider)
+            ? [
+                {
+                    environment,
+                    method: 'deposit_address',
+                    providerId: provider.id,
+                    resource: 'deposit',
+                },
+                {
+                    environment,
+                    method: 'deposit_address',
+                    providerId: provider.id,
+                    resource: 'deposit_address',
+                },
+            ]
+            : []),
+        ...(Provider.canPrepareTransfer(provider)
+            ? Transfer.methods.map((value) => ({
+                environment,
+                method: method(value),
+                providerId: provider.id,
+                resource: 'transfer',
+            }))
+            : []),
+    ]));
+}
+function method(value) {
+    return value === 'transaction' ? 'transaction' : 'deposit_address';
+}
+function statuses(resource) {
+    if (resource === 'transfer')
+        return activeTransferStatuses;
+    if (resource === 'deposit')
+        return activeDepositStatuses;
+    return activeDepositAddressStatuses;
+}
+function statusReasons(resource, status) {
+    if (status !== 'action-required')
+        return ['none'];
+    if (resource === 'transfer')
+        return ['none', ...Transfer.statusReasonCodes];
+    if (resource === 'deposit')
+        return ['none', ...Deposit.statusReasonCodes];
+    return ['none'];
+}
+//# sourceMappingURL=Observability.js.map