tapimo 0.13.0 → 0.15.0

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

@@ -0,0 +1,201 @@
+import { Hex } from 'ox';
+import { type Address, type LocalAccount } from 'viem';
+import type * as Chain from './Chain.js';
+import type * as Provider from './Provider.js';
+/** Read-only destination subsidy inventory available during action creation. */
+export type Inventory = {
+    /** Account that supplies destination USDC and native gas. */
+    account: Address;
+    /** Verifies token and gas capacity without accessing signing material. */
+    check(parameters: Inventory.check.Parameters): Promise<Inventory.check.Result>;
+    /** Operational maximum applied in addition to organization policy. */
+    policy: {
+        maxAmount: string;
+    };
+};
+/** Contracts for checking destination subsidy inventory. */
+export declare namespace Inventory {
+    /** Contracts for one inventory check. */
+    namespace check {
+        /** Inputs used to reserve worst-case destination inventory. */
+        type Parameters = {
+            /** Destination token quantity promised by Tempo. */
+            amount: bigint;
+            /** Destination EVM chain. */
+            chain: Chain.Chain;
+            /** Final transfer recipient. */
+            recipient: Address;
+            /** Inventory already promised by active transfers. */
+            reservations: Settler.prepare.Reservations;
+            /** Destination ERC-20 token. */
+            token: Address;
+        };
+        /** Native gas amount reserved for the promised transfer. */
+        type Result = {
+            nativeAmount: string;
+        };
+    }
+}
+/** Signed destination-chain subsidy persisted before broadcast. */
+export type Transaction = {
+    /** Destination token quantity supplied by Tempo. */
+    amount: string;
+    /** Destination-chain signer account. */
+    account: Address;
+    /** Destination chain CAIP-2 id. */
+    chainId: string;
+    /** Hash of the signed transaction. */
+    hash: Hex.Hex;
+    /** EOA nonce reserved for this transaction. */
+    nonce: number;
+    /** Worst-case native gas amount reserved for this transaction. */
+    nativeAmount?: string | undefined;
+    /** Signed EVM transaction bytes. */
+    transaction: Hex.Hex;
+};
+/** Reads a persisted destination subsidy transaction from private route state. */
+export declare function read(value: unknown): Transaction | undefined;
+/** Prepares and submits ERC-20 destination subsidy transactions. */
+export type Settler = {
+    /** Account that supplies destination USDC and native gas. */
+    account: Address;
+    /** Broadcasts one previously persisted signed transaction. */
+    broadcast(parameters: {
+        chain: Chain.Chain;
+        transaction: Transaction;
+    }): Promise<void>;
+    /** Reads the next nonce visible at the destination RPC. */
+    pendingNonce(parameters: {
+        chain: Chain.Chain;
+    }): Promise<number>;
+    /** Operational maximum applied in addition to the scoped API-key policy. */
+    policy: {
+        maxAmount: string;
+    };
+    /** Prepares one signed ERC-20 transfer without broadcasting it. */
+    prepare(parameters: Settler.prepare.Parameters): Promise<Transaction>;
+    /** Reads and verifies one persisted subsidy transaction. */
+    status(parameters: Settler.status.Parameters): Promise<Settler.status.ReturnType>;
+};
+/** Contracts for destination subsidy settlement operations. */
+export declare namespace Settler {
+    /** Contracts for preparing one destination subsidy transaction. */
+    namespace prepare {
+        /** Inputs used to construct the signed ERC-20 transfer. */
+        type Parameters = {
+            /** Destination token quantity supplied by Tempo. */
+            amount: bigint;
+            /** Destination EVM chain. */
+            chain: Chain.Chain;
+            /** EOA nonce durably reserved for this transfer. */
+            nonce: number;
+            /** Final transfer recipient. */
+            recipient: Address;
+            /** Inventory already promised by unsettled transactions. */
+            reservations: Settler.prepare.Reservations;
+            /** Destination ERC-20 token. */
+            token: Address;
+        };
+        /** Inventory reserved while serializing transactions for one signer. */
+        type Reservations = {
+            /** Native gas amount promised by unsettled transactions. */
+            nativeAmount: bigint;
+            /** Token amount promised by unsettled transactions. */
+            tokenAmount: bigint;
+        };
+    }
+    /** Contracts for reading a destination subsidy receipt. */
+    namespace status {
+        /** Persisted transaction and expected transfer terms. */
+        type Parameters = {
+            /** Destination EVM chain. */
+            chain: Chain.Chain;
+            /** Final transfer recipient. */
+            recipient: Address;
+            /** Persisted subsidy transaction. */
+            transaction: Transaction;
+            /** Destination ERC-20 token. */
+            token: Address;
+        };
+        /** Receipt state used by transfer reconciliation. */
+        type ReturnType = {
+            broadcast: boolean;
+            type: 'pending';
+        } | {
+            type: 'reverted' | 'success';
+        };
+    }
+}
+/** Returns the normalized 1:1 destination amount for two USD stablecoins. */
+export declare function requiredAmount(options: requiredAmount.Options): bigint;
+export declare namespace requiredAmount {
+    /** Source amount and stablecoin metadata used for 1:1 normalization. */
+    type Options = {
+        /** Token delivered on the destination chain. */
+        destinationToken: Provider.TokenRef;
+        /** Source token quantity in base units. */
+        sourceAmount: string;
+        /** Token spent on the source chain. */
+        sourceToken: Provider.TokenRef;
+    };
+}
+/** Creates a read-only EVM destination subsidy inventory checker. */
+export declare function createInventory(options: createInventory.Options): Inventory;
+export declare namespace createInventory {
+    /** Dependencies for one destination subsidy inventory checker. */
+    type Options = {
+        /** EVM account funded with destination USDC and native gas. */
+        account: Address;
+        /** Fetch implementation used for destination RPC requests. */
+        fetch: typeof globalThis.fetch;
+        /** Operational maximum destination deficit in decimal USD. */
+        policy: {
+            maxAmount: string;
+        };
+    };
+}
+/** Creates an EVM destination subsidy settler. */
+export declare function create(options: create.Options): Settler;
+export declare namespace create {
+    /** Dependencies for one destination subsidy settler. */
+    type Options = {
+        /** EVM account funded with destination USDC and native gas. */
+        account: LocalAccount;
+        /** Fetch implementation used for destination RPC requests. */
+        fetch: typeof globalThis.fetch;
+        /** Operational maximum destination deficit in decimal USD. */
+        policy: {
+            maxAmount: string;
+        };
+    };
+}
+/** Returns whether preparing a fresh transaction cannot recover. */
+export declare function isPermanentPreparationError(cause: unknown): boolean;
+/** Returns whether rebroadcasting the same signed transaction cannot recover. */
+export declare function isPermanentBroadcastError(cause: unknown): boolean;
+/** The subsidy account lacks destination token inventory or native gas. */
+export declare class BalanceUnavailableError extends Error {
+    name: string;
+}
+/** A destination RPC prevented inventory verification. */
+export declare class InventoryUpstreamError extends Error {
+    name: string;
+    constructor(cause: unknown);
+}
+/** The route cannot preserve its denomination across the selected tokens. */
+export declare class UnsupportedTokenError extends Error {
+    name: string;
+}
+/** The source amount cannot be represented exactly in destination base units. */
+export declare class UnsupportedAmountError extends Error {
+    name: string;
+}
+/** The destination chain cannot execute an EVM subsidy transfer. */
+export declare class UnsupportedChainError extends Error {
+    name: string;
+}
+/** The RPC returned a hash that differs from the persisted transaction. */
+export declare class TransactionHashMismatchError extends Error {
+    name: string;
+}
+//# sourceMappingURL=TransferSubsidy.d.ts.map

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

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

package/dist/internal/routes/TransferSubsidy.js

@@ -0,0 +1,256 @@
+import { Hash, Hex } from 'ox';
+import { BaseError, decodeEventLog, encodeFunctionData, erc20Abi, ExecutionRevertedError, InsufficientFundsError, IntrinsicGasTooHighError, IntrinsicGasTooLowError, NonceMaxValueError, NonceTooLowError, TipAboveFeeCapError, TransactionReceiptNotFoundError, TransactionTypeNotSupportedError, } from 'viem';
+import { getBalance, getBlock, getTransactionCount, getTransactionReceipt, prepareTransactionRequest, readContract, sendRawTransaction, } from 'viem/actions';
+import * as Viem from '../Viem.js';
+/** Reads a persisted destination subsidy transaction from private route state. */
+export function read(value) {
+    if (typeof value !== 'object' || value === null)
+        return undefined;
+    const transaction = value;
+    if (typeof transaction['account'] !== 'string' ||
+        !/^0x[0-9a-fA-F]{40}$/.test(transaction['account']) ||
+        typeof transaction['amount'] !== 'string' ||
+        !/^\d+$/.test(transaction['amount']) ||
+        typeof transaction['chainId'] !== 'string' ||
+        !/^eip155:\d+$/.test(transaction['chainId']) ||
+        typeof transaction['hash'] !== 'string' ||
+        !/^0x[0-9a-fA-F]{64}$/.test(transaction['hash']) ||
+        typeof transaction['nonce'] !== 'number' ||
+        !Number.isSafeInteger(transaction['nonce']) ||
+        transaction['nonce'] < 0 ||
+        (transaction['nativeAmount'] !== undefined &&
+            (typeof transaction['nativeAmount'] !== 'string' ||
+                !/^\d+$/.test(transaction['nativeAmount']))) ||
+        typeof transaction['transaction'] !== 'string' ||
+        !/^0x[0-9a-fA-F]+$/.test(transaction['transaction']))
+        return undefined;
+    return transaction;
+}
+/** Returns the normalized 1:1 destination amount for two USD stablecoins. */
+export function requiredAmount(options) {
+    if (options.destinationToken.currency !== 'USD' ||
+        options.sourceToken.currency !== options.destinationToken.currency)
+        throw new UnsupportedTokenError();
+    const amount = BigInt(options.sourceAmount);
+    const difference = options.destinationToken.decimals - options.sourceToken.decimals;
+    if (difference >= 0)
+        return amount * 10n ** BigInt(difference);
+    const divisor = 10n ** BigInt(-difference);
+    if (amount % divisor !== 0n)
+        throw new UnsupportedAmountError();
+    return amount / divisor;
+}
+/** Creates a read-only EVM destination subsidy inventory checker. */
+export function createInventory(options) {
+    const getClient = createGetClient(options.fetch);
+    return {
+        account: options.account,
+        async check(parameters) {
+            try {
+                const request = await checkInventory(getClient, options.account, parameters);
+                return { nativeAmount: request.nativeAmount.toString() };
+            }
+            catch (cause) {
+                if (cause instanceof BalanceUnavailableError || cause instanceof UnsupportedChainError)
+                    throw cause;
+                throw new InventoryUpstreamError(cause);
+            }
+        },
+        policy: options.policy,
+    };
+}
+/** Creates an EVM destination subsidy settler. */
+export function create(options) {
+    const getClient = createGetClient(options.fetch);
+    return {
+        account: options.account.address,
+        async broadcast(parameters) {
+            const client = getClient(parameters.chain);
+            const hash = await sendRawTransaction(client, {
+                serializedTransaction: parameters.transaction.transaction,
+            }).catch(async (cause) => {
+                if (!isNonceTooLowBroadcastError(cause))
+                    throw cause;
+                const receipt = await getTransactionReceipt(client, {
+                    hash: parameters.transaction.hash,
+                }).catch((receiptCause) => {
+                    if (receiptCause instanceof TransactionReceiptNotFoundError)
+                        return undefined;
+                    throw receiptCause;
+                });
+                if (!receipt)
+                    throw cause;
+                return parameters.transaction.hash;
+            });
+            if (!Hex.isEqual(hash, parameters.transaction.hash))
+                throw new TransactionHashMismatchError();
+        },
+        async pendingNonce(parameters) {
+            return getTransactionCount(getClient(parameters.chain), {
+                address: options.account.address,
+                blockTag: 'pending',
+            });
+        },
+        policy: options.policy,
+        async prepare(parameters) {
+            const { nativeAmount, request } = await checkInventory(getClient, options.account, parameters);
+            const transaction = await options.account.signTransaction({
+                ...request,
+                chainId: Number(parameters.chain.id.slice('eip155:'.length)),
+            });
+            return {
+                account: options.account.address,
+                amount: parameters.amount.toString(),
+                chainId: parameters.chain.id,
+                hash: Hash.keccak256(transaction),
+                nativeAmount: nativeAmount.toString(),
+                nonce: parameters.nonce,
+                transaction,
+            };
+        },
+        async status(parameters) {
+            const client = getClient(parameters.chain);
+            const receipt = await getTransactionReceipt(client, {
+                hash: parameters.transaction.hash,
+            }).catch((cause) => {
+                if (cause instanceof TransactionReceiptNotFoundError)
+                    return undefined;
+                throw cause;
+            });
+            if (!receipt)
+                return { broadcast: true, type: 'pending' };
+            const [canonical, finalized] = await Promise.all([
+                getBlock(client, { blockNumber: receipt.blockNumber, includeTransactions: false }),
+                getBlock(client, { blockTag: 'finalized', includeTransactions: false }),
+            ]);
+            if (canonical.hash !== receipt.blockHash || receipt.blockNumber > finalized.number)
+                return { broadcast: false, type: 'pending' };
+            if (receipt.status !== 'success')
+                return { type: 'reverted' };
+            const matched = receipt.logs.some((log) => {
+                if (log.address.toLowerCase() !== parameters.token.toLowerCase())
+                    return false;
+                try {
+                    const event = decodeEventLog({ abi: erc20Abi, data: log.data, topics: log.topics });
+                    return (event.eventName === 'Transfer' &&
+                        event.args.from.toLowerCase() === parameters.transaction.account.toLowerCase() &&
+                        event.args.to.toLowerCase() === parameters.recipient.toLowerCase() &&
+                        event.args.value === BigInt(parameters.transaction.amount));
+                }
+                catch {
+                    return false;
+                }
+            });
+            return { type: matched ? 'success' : 'reverted' };
+        },
+    };
+}
+function createGetClient(fetch) {
+    return (chain) => {
+        if (chain.kind !== 'evm' || chain.rpcUrls.length === 0)
+            throw new UnsupportedChainError();
+        return Viem.createEvmClient({
+            chainId: Number(chain.id.slice('eip155:'.length)),
+            fetch,
+            urls: chain.rpcUrls,
+        });
+    };
+}
+async function checkInventory(getClient, account, parameters) {
+    const client = getClient(parameters.chain);
+    const address = typeof account === 'string' ? account : account.address;
+    const tokenBalance = await readContract(client, {
+        abi: erc20Abi,
+        address: parameters.token,
+        args: [address],
+        functionName: 'balanceOf',
+    });
+    if (tokenBalance < parameters.amount + parameters.reservations.tokenAmount)
+        throw new BalanceUnavailableError();
+    const request = await prepareTransactionRequest(client, {
+        account,
+        data: encodeFunctionData({
+            abi: erc20Abi,
+            args: [parameters.recipient, parameters.amount],
+            functionName: 'transfer',
+        }),
+        ...(parameters.nonce === undefined ? {} : { nonce: parameters.nonce }),
+        to: parameters.token,
+        value: 0n,
+    });
+    const gasPrice = request.maxFeePerGas ?? request.gasPrice;
+    if (request.gas === undefined || gasPrice === undefined)
+        throw new BalanceUnavailableError();
+    const nativeAmount = request.gas * gasPrice;
+    if ((await getBalance(client, { address })) < nativeAmount + parameters.reservations.nativeAmount)
+        throw new BalanceUnavailableError();
+    return { nativeAmount, request };
+}
+/** Returns whether preparing a fresh transaction cannot recover. */
+export function isPermanentPreparationError(cause) {
+    if (!(cause instanceof Error))
+        return false;
+    if (cause instanceof BaseError &&
+        cause.walk((error) => error instanceof ExecutionRevertedError ||
+            error instanceof InsufficientFundsError ||
+            error instanceof IntrinsicGasTooHighError ||
+            error instanceof IntrinsicGasTooLowError ||
+            error instanceof NonceMaxValueError ||
+            error instanceof TransactionTypeNotSupportedError))
+        return true;
+    const message = `${cause.message} ${'details' in cause ? String(cause.details) : ''}`;
+    return [
+        /execution reverted/i,
+        /insufficient funds/i,
+        /intrinsic gas too (?:high|low)/i,
+        /nonce has max value/i,
+        /transaction type not supported/i,
+    ].some((pattern) => pattern.test(message));
+}
+/** Returns whether rebroadcasting the same signed transaction cannot recover. */
+export function isPermanentBroadcastError(cause) {
+    if (isPermanentPreparationError(cause))
+        return true;
+    if (!(cause instanceof Error))
+        return false;
+    if (cause instanceof BaseError && cause.walk((error) => error instanceof TipAboveFeeCapError))
+        return true;
+    const message = `${cause.message} ${'details' in cause ? String(cause.details) : ''}`;
+    return /max priority fee per gas higher than max fee per gas|tip (?:above|higher than) fee cap/i.test(message);
+}
+function isNonceTooLowBroadcastError(cause) {
+    if (!(cause instanceof Error))
+        return false;
+    if (cause instanceof BaseError && cause.walk((error) => error instanceof NonceTooLowError))
+        return true;
+    const message = `${cause.message} ${'details' in cause ? String(cause.details) : ''}`;
+    return /nonce too low/i.test(message);
+}
+/** The subsidy account lacks destination token inventory or native gas. */
+export class BalanceUnavailableError extends Error {
+    name = 'Routes.TransferSubsidy.BalanceUnavailableError';
+}
+/** A destination RPC prevented inventory verification. */
+export class InventoryUpstreamError extends Error {
+    name = 'Routes.TransferSubsidy.InventoryUpstreamError';
+    constructor(cause) {
+        super('Destination subsidy inventory could not be verified.', { cause });
+    }
+}
+/** The route cannot preserve its denomination across the selected tokens. */
+export class UnsupportedTokenError extends Error {
+    name = 'Routes.TransferSubsidy.UnsupportedTokenError';
+}
+/** The source amount cannot be represented exactly in destination base units. */
+export class UnsupportedAmountError extends Error {
+    name = 'Routes.TransferSubsidy.UnsupportedAmountError';
+}
+/** The destination chain cannot execute an EVM subsidy transfer. */
+export class UnsupportedChainError extends Error {
+    name = 'Routes.TransferSubsidy.UnsupportedChainError';
+}
+/** The RPC returned a hash that differs from the persisted transaction. */
+export class TransactionHashMismatchError extends Error {
+    name = 'Routes.TransferSubsidy.TransactionHashMismatchError';
+}
+//# sourceMappingURL=TransferSubsidy.js.map

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

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

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

@@ -0,0 +1,21 @@
+import type * as Db from '../../db/Db.js';
+import type * as RoutesTransferEvents from '../../db/tables/routesTransferEvents.js';
+import type * as RoutesTransfers from '../../db/tables/routesTransfers.js';
+import * as Webhooks from '../Webhooks.js';
+/** Stages durable webhook obligations for committed route transfer versions. */
+export declare function stage(db: Db.Db, options: stage.Options): Promise<Webhooks.ensureQueueEvents.Result>;
+export declare namespace stage {
+    /** One committed transfer record and its immutable public event. */
+    type Change = {
+        /** Immutable public transfer version. */
+        event: RoutesTransferEvents.Record;
+        /** Transfer ownership and environment record. */
+        record: RoutesTransfers.Record;
+    };
+    /** Committed transfer changes eligible for customer webhook delivery. */
+    type Options = {
+        /** Transfer changes committed with their delivery obligations. */
+        changes: readonly Change[];
+    };
+}
+//# sourceMappingURL=TransferWebhook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TransferWebhook.d.ts","sourceRoot":"","sources":["../../../src/internal/routes/TransferWebhook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,KAAK,oBAAoB,MAAM,yCAAyC,CAAA;AACpF,OAAO,KAAK,KAAK,eAAe,MAAM,oCAAoC,CAAA;AAE1E,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA;AAE1C,gFAAgF;AAChF,wBAAsB,KAAK,CACzB,EAAE,EAAE,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,KAAK,CAAC,OAAO,GACrB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAwC5C;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,oEAAoE;IACpE,KAAK,MAAM,GAAG;QACZ,yCAAyC;QACzC,KAAK,EAAE,oBAAoB,CAAC,MAAM,CAAA;QAClC,iDAAiD;QACjD,MAAM,EAAE,eAAe,CAAC,MAAM,CAAA;KAC/B,CAAA;IAED,yEAAyE;IACzE,KAAK,OAAO,GAAG;QACb,kEAAkE;QAClE,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;KAC3B,CAAA;CACF"}

package/dist/internal/routes/TransferWebhook.js

@@ -0,0 +1,43 @@
+import * as WebhookSubscriptions from '../../db/tables/webhookSubscriptions.js';
+import * as Webhooks from '../Webhooks.js';
+/** Stages durable webhook obligations for committed route transfer versions. */
+export async function stage(db, options) {
+    const dispatchables = [];
+    const now = new Date().toISOString();
+    for (const { event, record } of options.changes) {
+        const match = /^eip155:(\d+)$/.exec(event.snapshot.destinationChain.id);
+        if (!match?.[1])
+            continue;
+        const chainId = Number(match[1]);
+        if (!Number.isSafeInteger(chainId) || chainId <= 0)
+            continue;
+        const subscriptions = await WebhookSubscriptions.listActiveForRoutesEvent(db, {
+            chainId,
+            environment: record.environment,
+            eventCreatedAt: event.createdAt,
+            eventType: 'routes:transfer.updated',
+            now,
+            orgId: record.orgId,
+            ...(record.projectId === null ? {} : { projectId: record.projectId }),
+        });
+        for (const subscription of subscriptions) {
+            if (typeof subscription.filters['id'] === 'string' &&
+                subscription.filters['id'] !== event.transferId)
+                continue;
+            if (typeof subscription.filters['status'] === 'string' &&
+                subscription.filters['status'] !== event.status)
+                continue;
+            dispatchables.push({
+                envelope: Webhooks.buildKeyedEnvelope({
+                    createdAt: new Date(event.createdAt),
+                    data: event.snapshot,
+                    key: `${event.transferId}:${event.version}`,
+                    subscription,
+                }),
+                subscription,
+            });
+        }
+    }
+    return Webhooks.ensureQueueEvents(db, dispatchables);
+}
+//# sourceMappingURL=TransferWebhook.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TransferWebhook.js","sourceRoot":"","sources":["../../../src/internal/routes/TransferWebhook.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,oBAAoB,MAAM,yCAAyC,CAAA;AAC/E,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA;AAE1C,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,EAAS,EACT,OAAsB;IAEtB,MAAM,aAAa,GAA8C,EAAE,CAAA;IACnE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACpC,KAAK,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAA;QACvE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAAE,SAAQ;QACzB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAChC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC;YAAE,SAAQ;QAC5D,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC,wBAAwB,CAAC,EAAE,EAAE;YAC5E,OAAO;YACP,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,cAAc,EAAE,KAAK,CAAC,SAAS;YAC/B,SAAS,EAAE,yBAAyB;YACpC,GAAG;YACH,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;SACtE,CAAC,CAAA;QACF,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YACzC,IACE,OAAO,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,QAAQ;gBAC9C,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,UAAU;gBAE/C,SAAQ;YACV,IACE,OAAO,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,QAAQ;gBAClD,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,KAAK,CAAC,MAAM;gBAE/C,SAAQ;YACV,aAAa,CAAC,IAAI,CAAC;gBACjB,QAAQ,EAAE,QAAQ,CAAC,kBAAkB,CAAC;oBACpC,SAAS,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;oBACpC,IAAI,EAAE,KAAK,CAAC,QAAQ;oBACpB,GAAG,EAAE,GAAG,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,OAAO,EAAE;oBAC3C,YAAY;iBACb,CAAC;gBACF,YAAY;aACb,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC,iBAAiB,CAAC,EAAE,EAAE,aAAa,CAAC,CAAA;AACtD,CAAC"}

package/dist/internal/{funding → routes}/index.d.ts

@@ -5,6 +5,7 @@ export * as Deposit from './Deposit.js';
 export * as DepositAddress from './DepositAddress.js';
 export * as DepositWebhook from './DepositWebhook.js';
 export * as Evidence from './Evidence.js';
+export * as Observability from './Observability.js';
 export * as Provider from './Provider.js';
 export * as Reconciliation from './Reconciliation.js';
 export * as Route from './Route.js';
@@ -12,4 +13,6 @@ export * as SourceObservation from './SourceObservation.js';
 export * as Subsidy from './Subsidy.js';
 export * as Token from './Token.js';
 export * as Transfer from './Transfer.js';
+export * as TransferReconciliation from './TransferReconciliation.js';
+export * as TransferSubsidy from './TransferSubsidy.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/routes/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,sBAAsB,MAAM,6BAA6B,CAAA;AACrE,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA"}

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

@@ -5,6 +5,7 @@ export * as Deposit from './Deposit.js';
 export * as DepositAddress from './DepositAddress.js';
 export * as DepositWebhook from './DepositWebhook.js';
 export * as Evidence from './Evidence.js';
+export * as Observability from './Observability.js';
 export * as Provider from './Provider.js';
 export * as Reconciliation from './Reconciliation.js';
 export * as Route from './Route.js';
@@ -12,4 +13,6 @@ export * as SourceObservation from './SourceObservation.js';
 export * as Subsidy from './Subsidy.js';
 export * as Token from './Token.js';
 export * as Transfer from './Transfer.js';
+export * as TransferReconciliation from './TransferReconciliation.js';
+export * as TransferSubsidy from './TransferSubsidy.js';
 //# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internal/routes/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,sBAAsB,MAAM,6BAA6B,CAAA;AACrE,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA"}

package/dist/internal/{funding → routes}/providers/across.d.ts

@@ -1,6 +1,6 @@
-import * as FundingProvider from '../Provider.js';
-/** Creates an Across funding provider backed by `/swap/approval`. */
-export declare function across(options: across.Options): FundingProvider.Provider<"across">;
+import * as RoutesProvider from '../Provider.js';
+/** Creates an Across route provider backed by `/swap/approval`. */
+export declare function across(options: across.Options): RoutesProvider.Provider<"across">;
 export declare namespace across {
     /** Across provider options. */
     type Options = {
@@ -9,7 +9,7 @@ export declare namespace across {
         /** Override for tests or Across test environments. */
         baseUrl?: string | undefined;
         /** Fetch implementation override for tests. */
-        fetch?: FundingProvider.Fetch | undefined;
+        fetch?: RoutesProvider.Fetch | undefined;
         /** Across integrator id sent as the required query parameter. */
         integratorId: string;
         /** Clock override for deterministic tests. */

package/dist/internal/routes/providers/across.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"across.d.ts","sourceRoot":"","sources":["../../../../src/internal/routes/providers/across.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,cAAc,MAAM,gBAAgB,CAAA;AA0BhD,mEAAmE;AACnE,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,qCAuF7C;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,+BAA+B;IAC/B,KAAK,OAAO,GAAG;QACb,6CAA6C;QAC7C,MAAM,EAAE,MAAM,CAAA;QACd,sDAAsD;QACtD,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC5B,+CAA+C;QAC/C,KAAK,CAAC,EAAE,cAAc,CAAC,KAAK,GAAG,SAAS,CAAA;QACxC,iEAAiE;QACjE,YAAY,EAAE,MAAM,CAAA;QACpB,8CAA8C;QAC9C,GAAG,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAA;QAC9B,uEAAuE;QACvE,WAAW,EAAE,MAAM,CAAA;KACpB,CAAA;CACF"}