tapimo 0.13.0 → 0.15.0

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

@@ -6,7 +6,7 @@ import type * as core_Chain from './Chain.js';
 import type * as core_Route from './Route.js';
 import type * as core_Token from './Token.js';
 import type * as Transfer from './Transfer.js';
-/** Funding provider schemas. */
+/** Route provider schemas. */
 export declare namespace schema {
     /** Bounded upstream error code safe for structured logs. */
     const ErrorCode: z.ZodMiniString<string>;
@@ -27,11 +27,11 @@ export declare namespace schema {
         errorType: z.ZodMiniOptional<z.ZodMiniString<string>>;
         type: z.ZodMiniOptional<z.ZodMiniString<string>>;
     }, z.core.$strip>;
-    /** Positive decimal amount accepted by funding quote requests. */
+    /** Positive decimal amount accepted by route quote requests. */
     const PositiveDecimal: z.ZodMiniString<string>;
-    /** Positive base-unit amount accepted by funding quote requests. */
+    /** Positive base-unit amount accepted by route quote requests. */
     const PositiveInteger: z.ZodMiniString<string>;
-    /** Normalized chain reference passed to funding providers. */
+    /** Normalized chain reference passed to route providers. */
     const ChainRef: z.ZodMiniObject<{
         addressFormat: z.ZodMiniEnum<{
             base58: "base58";
@@ -46,7 +46,7 @@ export declare namespace schema {
         }>;
         name: z.ZodMiniString<string>;
     }, z.core.$strip>;
-    /** Normalized token reference passed to funding providers. */
+    /** Normalized token reference passed to route providers. */
     const TokenRef: z.ZodMiniObject<{
         address: z.ZodMiniString<string>;
         currency: z.ZodMiniString<string>;
@@ -57,18 +57,39 @@ export declare namespace schema {
         tokenKey: z.ZodMiniString<string>;
         verified: z.ZodMiniBoolean<boolean>;
     }, z.core.$strip>;
-    /** Provider identity embedded in funding resources. */
+    /** Provider identity embedded in route resources. */
     const ProviderRef: z.ZodMiniObject<{
         id: z.ZodMiniString<string>;
         name: z.ZodMiniString<string>;
     }, z.core.$strip>;
-    /** Source amount unit accepted by a funding quote request. */
+    /** One token amount paid by a subsidy provider. */
+    const Subsidy: z.ZodMiniObject<{
+        amount: z.ZodMiniObject<{
+            baseUnits: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        provider: z.ZodMiniString<string>;
+        token: z.ZodMiniObject<{
+            address: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            name: z.ZodMiniString<string>;
+            standard: z.ZodMiniString<string>;
+            symbol: z.ZodMiniString<string>;
+            tokenKey: z.ZodMiniString<string>;
+            verified: z.ZodMiniBoolean<boolean>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    /** Source amount unit accepted by a route quote request. */
     const SourceAmountUnits: z.ZodMiniDefault<z.ZodMiniEnum<{
         baseUnits: "baseUnits";
         decimal: "decimal";
     }>>;
-    /** Normalized caller request passed to funding providers. */
+    /** Normalized caller request passed to route providers. */
     const QuoteRequest: z.ZodMiniObject<{
+        destinationChain: z.ZodMiniOptional<z.ZodMiniString<string>>;
         destinationToken: z.ZodMiniOptional<z.ZodMiniString<string>>;
         provider: z.ZodMiniOptional<z.ZodMiniString<string>>;
         sourceAmount: z.ZodMiniString<string>;
@@ -93,7 +114,7 @@ export declare namespace schema {
         unavailable: "unavailable";
         unknown: "unknown";
     }>;
-    /** Quote data returned by a funding provider. */
+    /** Quote data returned by a route provider. */
     const GetQuoteResult: z.ZodMiniObject<{
         expiresAt: z.ZodMiniOptional<z.ZodMiniISODateTime>;
         destinationAmountMin: z.ZodMiniOptional<z.ZodMiniString<string>>;
@@ -117,7 +138,7 @@ export declare namespace schema {
             unknown: "unknown";
         }>;
     }, z.core.$strip>;
-    /** Executable preparation returned by a funding provider. */
+    /** Executable preparation returned by a route provider. */
     const PrepareResult: z.ZodMiniObject<{
         action: z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
             calls: z.ZodMiniArray<z.ZodMiniObject<{
@@ -151,6 +172,7 @@ export declare namespace schema {
                 verified: z.ZodMiniBoolean<boolean>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
+        providerState: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>>;
         quality: z.ZodMiniOptional<z.ZodMiniObject<{
             estimatedSeconds: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
             liquiditySource: z.ZodMiniString<string>;
@@ -164,7 +186,7 @@ export declare namespace schema {
         }, z.core.$strip>>;
         sampledAt: z.ZodMiniISODateTime;
     }, z.core.$strip>;
-    /** Reusable deposit address provisioned by a funding provider. */
+    /** Reusable deposit address provisioned by a route provider. */
     const DepositAddressResult: z.ZodMiniObject<{
         address: z.ZodMiniString<string>;
         correlation: z.ZodMiniObject<{
@@ -202,6 +224,25 @@ export declare namespace schema {
         refundAmountExpected: z.ZodMiniOptional<z.ZodMiniString<string>>;
         refundTransactionHashes: z.ZodMiniArray<z.ZodMiniString<string>>;
         sourceTransactionHashes: z.ZodMiniArray<z.ZodMiniString<string>>;
+        subsidy: z.ZodMiniOptional<z.ZodMiniObject<{
+            amount: z.ZodMiniObject<{
+                baseUnits: z.ZodMiniString<string>;
+                currency: z.ZodMiniString<string>;
+                decimals: z.ZodMiniNumber<number>;
+                formatted: z.ZodMiniString<string>;
+            }, z.core.$strip>;
+            provider: z.ZodMiniString<string>;
+            token: z.ZodMiniObject<{
+                address: z.ZodMiniString<string>;
+                currency: z.ZodMiniString<string>;
+                decimals: z.ZodMiniNumber<number>;
+                name: z.ZodMiniString<string>;
+                standard: z.ZodMiniString<string>;
+                symbol: z.ZodMiniString<string>;
+                tokenKey: z.ZodMiniString<string>;
+                verified: z.ZodMiniBoolean<boolean>;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
         status: z.ZodMiniString<string>;
         updatedAt: z.ZodMiniISODateTime;
     }, z.core.$strip>;
@@ -216,27 +257,44 @@ export declare namespace schema {
             refundAmountExpected: z.ZodMiniOptional<z.ZodMiniString<string>>;
             refundTransactionHashes: z.ZodMiniArray<z.ZodMiniString<string>>;
             sourceTransactionHashes: z.ZodMiniArray<z.ZodMiniString<string>>;
+            subsidy: z.ZodMiniOptional<z.ZodMiniObject<{
+                amount: z.ZodMiniObject<{
+                    baseUnits: z.ZodMiniString<string>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    formatted: z.ZodMiniString<string>;
+                }, z.core.$strip>;
+                provider: z.ZodMiniString<string>;
+                token: z.ZodMiniObject<{
+                    address: z.ZodMiniString<string>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    name: z.ZodMiniString<string>;
+                    standard: z.ZodMiniString<string>;
+                    symbol: z.ZodMiniString<string>;
+                    tokenKey: z.ZodMiniString<string>;
+                    verified: z.ZodMiniBoolean<boolean>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
             status: z.ZodMiniString<string>;
             updatedAt: z.ZodMiniISODateTime;
         }, z.core.$strip>>;
     }, z.core.$strip>;
-    /** Quote quality signals exposed to funding API callers. */
-    const FundingQuoteQuality: z.ZodMiniObject<{
+    /** Quote quality signals exposed to routes API callers. */
+    const RoutesQuoteQuality: z.ZodMiniObject<{
         estimatedSeconds: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-        liquiditySource: z.ZodMiniString<string>;
-        sourceDetail: z.ZodMiniOptional<z.ZodMiniString<string>>;
         tier: z.ZodMiniEnum<{
             liquid: "liquid";
             thin: "thin";
         }>;
     }, z.core.$strip>;
-    /** Provider quote freshness data exposed to funding API callers. */
+    /** Provider quote freshness data exposed to routes API callers. */
     const QuoteDetails: z.ZodMiniObject<{
         expiresAt: z.ZodMiniOptional<z.ZodMiniISODateTime>;
         sampledAt: z.ZodMiniISODateTime;
     }, z.core.$strip>;
-    /** Successful normalized funding quote returned to callers. */
-    const FundingQuote: z.ZodMiniObject<{
+    /** Successful normalized route quote returned to callers. */
+    const RoutesQuote: z.ZodMiniObject<{
         destinationAmount: z.ZodMiniObject<{
             baseUnits: z.ZodMiniString<string>;
             currency: z.ZodMiniString<string>;
@@ -280,8 +338,6 @@ export declare namespace schema {
         }, z.core.$strip>;
         quality: z.ZodMiniObject<{
             estimatedSeconds: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-            liquiditySource: z.ZodMiniString<string>;
-            sourceDetail: z.ZodMiniOptional<z.ZodMiniString<string>>;
             tier: z.ZodMiniEnum<{
                 liquid: "liquid";
                 thin: "thin";
@@ -323,50 +379,82 @@ export declare namespace schema {
         }, z.core.$strip>;
     }, z.core.$strip>;
 }
-/** Chain metadata declared by a funding route. */
+/** Chain metadata declared by a provider route. */
 export type Chain = core_Chain.Chain;
-/** Token metadata declared by a funding route. */
+/** Token metadata declared by a provider route. */
 export type Token = core_Token.Resolved;
-/** Provider ids accepted by funding quote requests. */
+/** Provider ids accepted by route quote requests. */
 export type ProviderId = string;
 /** Provider-specific quote status for the requested amount. */
 export type QuoteStatus = z.output<typeof schema.QuoteStatus>;
 /** Machine-readable quote quality tier. */
 export type QualityTier = z.output<typeof schema.QualityTier>;
-/** Normalized chain reference passed to funding providers. */
+/** Normalized chain reference passed to route providers. */
 export type ChainRef = z.output<typeof schema.ChainRef>;
-/** Normalized token amount passed to funding providers. */
+/** Normalized token amount passed to route providers. */
 export type TokenAmount = ReturnType<typeof resolveSourceAmount>;
-/** Normalized token reference passed to funding providers. */
+/** Normalized token reference passed to route providers. */
 export type TokenRef = z.output<typeof schema.TokenRef>;
-/** A normalized internal candidate passed to funding quote providers. */
+/** One token amount paid by a subsidy provider. */
+export type Subsidy = z.output<typeof schema.Subsidy>;
+/** A normalized internal candidate passed to route quote providers. */
 export type QuoteCandidate = ReturnType<typeof createQuoteCandidate>;
 /** A normalized route candidate passed to deposit-address providers. */
 export type DepositAddressCandidate = ReturnType<typeof createDepositAddressCandidate>;
-/** A successful normalized funding quote returned to callers. */
-export type FundingQuote = z.output<typeof schema.FundingQuote>;
-/** Cache policy for a single funding quote request. */
+/** A successful normalized route quote returned to callers. */
+export type RoutesQuote = z.output<typeof schema.RoutesQuote>;
+/** Cache policy for a single route quote request. */
 export type CachePolicy = {
     /** Whether providers should bypass their own quote or inventory caches. */
     bypass: boolean;
 };
-/** Normalized caller request passed to funding providers. */
+/** Normalized caller request passed to route providers. */
 export type QuoteRequest = z.output<typeof schema.QuoteRequest>;
+/** Bounded quote sample retained for request-level reliability telemetry. */
+export type QuoteSample = {
+    /** Quote age when the provider request completed. */
+    ageMs: number;
+    /** Destination value loss relative to the requested source amount, in signed basis points. */
+    customerValueLossBps?: number | undefined;
+    /** Destination chain in the quoted corridor. */
+    destinationChain: string;
+    /** Destination token in the quoted corridor. */
+    destinationToken: string;
+    /** Amount the provider timestamp is ahead of the API clock. */
+    futureSkewMs: number;
+    /** Provider that returned the quote. */
+    provider: string;
+    /** Source chain in the quoted corridor. */
+    sourceChain: string;
+    /** Source token in the quoted corridor. */
+    sourceToken: string;
+};
+/** Request-level result used to measure quote availability and freshness. */
+export type QuoteRequestResult = {
+    /** Number of configured route candidates matching the request. */
+    candidateCount: number;
+    /** Bounded request outcome for quote-availability measurement. */
+    outcome: 'available' | 'failed' | 'unavailable' | 'unsupported';
+    /** Successful provider quote samples returned to the caller. */
+    quotes: readonly QuoteSample[];
+};
 /** Contract of the provider `getQuote` method. */
 export declare namespace getQuote {
-    /** Input passed to a funding provider for one curated quote candidate. */
+    /** Input passed to a route provider for one curated quote candidate. */
     type Parameters = {
         /** Curated candidate selected for live provider quoting. */
         candidate: QuoteCandidate;
         /** Cache policy for provider-side discovery and quote lookups. */
         cache: CachePolicy;
-        /** Destination chain, always Tempo mainnet in V1. */
+        /** Chain that receives the routed token. */
         destinationChain: ChainRef;
-        /** Tempo token expected from this quote. */
+        /** Token expected from this quote. */
         destinationToken: TokenRef;
+        /** Stable non-secret tenant identity for provider-local fairness. */
+        quotaKey?: string | undefined;
         /** Normalized caller request that produced this quote candidate. */
         request: QuoteRequest;
-        /** Canonical funding route selected for this quote candidate. */
+        /** Canonical provider route selected for this quote candidate. */
         route: core_Route.Route;
         /** Source amount in base units and display form. */
         sourceAmount: TokenAmount;
@@ -375,7 +463,7 @@ export declare namespace getQuote {
         /** Token the caller currently holds. */
         sourceToken: TokenRef;
     };
-    /** Quote data returned by a funding provider. */
+    /** Quote data returned by a route provider. */
     type ReturnType = z.output<typeof schema.GetQuoteResult>;
 }
 /** Contract of the provider `prepareTransfer` method. */
@@ -387,22 +475,22 @@ export declare namespace prepareTransfer {
         /** Provider-issued request identifier. */
         requestId: string;
     };
-    /** Input passed to a funding provider preparing one executable transfer. */
+    /** Input passed to a route provider preparing one executable transfer. */
     type Parameters = {
         /** Curated candidate selected for preparation. */
         candidate: QuoteCandidate;
-        /** Funding method the caller selected. */
+        /** Route method the caller selected. */
         method: Transfer.Method;
         /** Amount mode the caller selected. */
         mode: Transfer.Mode;
         /** Final beneficiary on the destination chain. */
         recipient: string;
-        /** Source-chain account that signs the funding action. */
+        /** Source-chain account that signs the route action. */
         sender: string;
         /** Caller slippage bound in basis points. */
         slippageBps?: number | undefined;
     };
-    /** Executable preparation returned by a funding provider. */
+    /** Executable preparation returned by a route provider. */
     type ReturnType = z.output<typeof schema.PrepareResult>;
 }
 /** Contract for provider-specific executable action validation. */
@@ -411,11 +499,79 @@ export declare namespace validateTransferAction {
     type Parameters = prepareTransfer.Parameters & {
         /** Executable action returned by the provider. */
         action: Action.Action;
+        /** Minimum destination amount encoded by the provider action. */
+        destinationAmountMin: string;
     };
     /** Provider-specific constraints established by validation. */
     type ReturnType = {
         /** Exact native values independently validated against provider calldata. */
         nativeValues?: readonly Action.NativeValue[] | undefined;
+        /** Exact additional token approvals independently validated against provider calldata. */
+        tokenApprovals?: readonly Action.TokenApproval[] | undefined;
+    };
+}
+/** Contract for provider-specific destination delivery verification. */
+export declare namespace verifyDestinationDelivery {
+    /** Stored transfer terms and provider evidence. */
+    type Parameters = {
+        /** Configured chain that receives the provider delivery. */
+        destinationChain: Chain;
+        /** Private provider state captured while preparing and registering the transfer. */
+        providerState?: Transfer.ProviderState | undefined;
+        /** Configured chain containing the submitted transaction. */
+        sourceChain: Chain;
+        /** Stored public transfer terms. */
+        transfer: Transfer.Snapshot;
+    };
+    /** Destination delivery verification outcome. */
+    type ReturnType = {
+        type: 'invalid';
+    } | {
+        type: 'pending';
+    } | {
+        /** Verified destination transaction reference. */
+        transactionHash: string;
+        /** The destination delivery matches the stored transfer terms. */
+        type: 'verified';
+    };
+}
+/** Contract for provider-specific source transaction verification. */
+export declare namespace verifySourceTransaction {
+    /** Stored transfer terms and submitted source transaction. */
+    type Parameters = {
+        /** Configured chain that receives the provider delivery. */
+        destinationChain: Chain;
+        /** Private provider state captured while preparing the transfer. */
+        providerState?: Transfer.ProviderState | undefined;
+        /** Current configuration for the stored provider route. */
+        routeConfiguration?: core_Catalog.Configuration | undefined;
+        /** Configured chain containing the submitted transaction. */
+        sourceChain: Chain;
+        /** Submitted transaction reference. */
+        transactionHash: string;
+        /** Stored public transfer terms. */
+        transfer: Transfer.Snapshot;
+    };
+    /** Source transaction verification outcome. */
+    type ReturnType = {
+        type: 'invalid';
+    } | {
+        type: 'pending';
+    } | {
+        /** Private provider state retained while awaiting replacement evidence. */
+        providerState: Transfer.ProviderState;
+        /** Previously verified source evidence left the canonical chain. */
+        type: 'reorged';
+    } | {
+        /** The transaction supports the transfer but does not execute it. */
+        type: 'related';
+    } | {
+        /** Exact destination amount observed in the source transaction, when provider fees changed after preparation. */
+        destinationAmount?: string | undefined;
+        /** Private provider evidence retained for reconciliation. */
+        providerState?: Transfer.ProviderState | undefined;
+        /** The transaction matches the stored transfer terms. */
+        type: 'verified';
     };
 }
 /** Contract of the provider `createDepositAddress` method. */
@@ -444,8 +600,12 @@ export declare namespace listDepositAddressRequests {
         address: string;
         /** Opaque provider cursor returned by the previous page. */
         continuation?: string | undefined;
+        /** Token delivered by the provider, when needed to identify a subsidy payment. */
+        destinationToken?: TokenRef | undefined;
         /** Existing provider request to refresh directly. */
         requestId?: string | undefined;
+        /** Token received by the provider, when needed to identify a subsidy payment. */
+        sourceToken?: TokenRef | undefined;
     };
     /** One page of normalized provider requests. */
     type ReturnType = z.output<typeof schema.DepositAddressRequestsResult>;
@@ -499,31 +659,33 @@ export declare namespace observeDepositAddressRequest {
     } | {
         /** Verified destination transaction references. */
         destinationTransactionHashes: readonly string[];
+        /** Token amount paid by the provider for this request. */
+        subsidy?: z.output<typeof schema.Subsidy> | undefined;
         /** Authenticated provider delivery was observed onchain. */
         type: 'verified';
     });
 }
-/** Optional webhook capability implemented by a complete funding integration. */
+/** Optional webhook capability implemented by a complete route integration. */
 export type Webhook = {
     /** Authenticates, resolves, and enqueues one provider status event. */
     receive(input: Webhook.receive.Parameters): Promise<Webhook.receive.ReturnType>;
     /** Authenticates a provider status event and returns its bounded hint. */
     verify(input: Webhook.verify.Parameters): Webhook.verify.ReturnType;
 };
-/** Contracts for a funding provider webhook capability. */
+/** Contracts for a route provider webhook capability. */
 export declare namespace Webhook {
     /** Contracts for receiving one authenticated provider webhook. */
     namespace receive {
-        /** Raw provider webhook request passed to a funding integration. */
+        /** Raw provider webhook request passed to a route integration. */
         type Parameters = {
             /** Exact request body bytes decoded as UTF-8. */
             body: string;
             /** Original provider webhook headers. */
             headers: Headers;
         };
-        /** Durable queue message emitted for one authenticated funding status hint. */
+        /** Durable queue message emitted for one authenticated routes status hint. */
         type Dispatchable = {
-            /** Stored funding deposit address id. */
+            /** Stored route deposit address id. */
             addressId: string;
             /** Bounded follow-up state for work awaiting provider or settlement confirmation. */
             followUp?: FollowUp | undefined;
@@ -534,7 +696,7 @@ export declare namespace Webhook {
             /** Mechanism that requested reconciliation. */
             trigger: 'chain' | 'manual' | 'poll' | 'webhook';
             /** Reconciliation queue message discriminator. */
-            type: 'funding:deposit-address:reconcile';
+            type: 'routes:deposit-address:reconcile';
             /** Authenticated provider webhook timing carried into reconciliation. */
             webhookTiming?: WebhookTiming | undefined;
         };
@@ -563,7 +725,7 @@ export declare namespace Webhook {
             /** Mechanism that requested reconciliation, when written by a trigger-aware producer. */
             trigger?: Dispatchable['trigger'] | undefined;
         };
-        /** Safe disposition of one authenticated funding provider webhook. */
+        /** Safe disposition of one authenticated route provider webhook. */
         type ReturnType = {
             addressId: string;
             type: 'queued';
@@ -575,9 +737,9 @@ export declare namespace Webhook {
     }
     /** Contracts for verifying one provider webhook. */
     namespace verify {
-        /** Raw provider webhook request passed to a funding integration. */
+        /** Raw provider webhook request passed to a route integration. */
         type Parameters = receive.Parameters;
-        /** Authenticated provider hint extracted from a funding webhook. */
+        /** Authenticated provider hint extracted from a routes webhook. */
         type ReturnType = {
             /** Reusable provider address, when the provider attributed one. */
             address?: string | undefined;
@@ -592,63 +754,78 @@ export declare namespace Webhook {
         };
     }
 }
-/** A funding provider descriptor and live quote implementation. */
-export type Provider<id extends string = string> = core_Provider.Provider<id, 'funding'> & {
-    /** Provisions a reusable funding deposit address, when supported. */
+/** A route provider descriptor and live quote implementation. */
+export type Provider<id extends string = string> = core_Provider.Provider<id, 'routes'> & {
+    /** Provisions a reusable route deposit address, when supported. */
     createDepositAddress?(input: createDepositAddress.Parameters, signal: AbortSignal): Promise<createDepositAddress.ReturnType>;
-    /** Requests a live funding quote. */
+    /** Requests a live route quote. */
     getQuote(input: getQuote.Parameters, signal: AbortSignal): Promise<getQuote.ReturnType>;
     /** Lists requests discovered for a reusable deposit address, when supported. */
     listDepositAddressRequests?(input: listDepositAddressRequests.Parameters, signal: AbortSignal): Promise<listDepositAddressRequests.ReturnType>;
     /** Observes authenticated delivery for a verified reusable-address transfer, when supported. */
     observeDepositAddressRequest?(input: observeDepositAddressRequest.Parameters, signal: AbortSignal): Promise<observeDepositAddressRequest.ReturnType>;
-    /** Prepares an executable funding transfer, when the provider supports it. */
+    /** Prepares an executable route transfer, when the provider supports it. */
     prepareTransfer?(input: prepareTransfer.Parameters, signal: AbortSignal): Promise<prepareTransfer.ReturnType>;
     /** Validates provider-specific action semantics before generic persistence checks. */
     validateTransferAction?(input: validateTransferAction.Parameters): validateTransferAction.ReturnType;
+    /** Verifies destination delivery for a registered transfer, when supported. */
+    verifyDestinationDelivery?(input: verifyDestinationDelivery.Parameters, signal: AbortSignal): Promise<verifyDestinationDelivery.ReturnType>;
+    /** Verifies a submitted source transaction, when supported. */
+    verifySourceTransaction?(input: verifySourceTransaction.Parameters, signal: AbortSignal): Promise<verifySourceTransaction.ReturnType>;
     /** Receives authenticated provider status events, when configured. */
     webhook?: Webhook | undefined;
 };
-/** Defines a funding provider from its identity and quote implementation. */
+/** Defines a route provider from its identity and quote implementation. */
 export declare function from<const id extends string>(options: from.Options<id>): Provider<id>;
 export declare namespace from {
-    /** Funding provider definition. */
+    /** Route provider definition. */
     type Options<id extends string> = Omit<Provider<id>, 'type'>;
 }
-/** Narrows a registered provider to a funding provider. */
+/** Narrows a registered provider to a route provider. */
 export declare function is(provider: core_Provider.Provider): provider is Provider;
-/** Narrows a funding provider to one that prepares executable transfers. */
+/** Narrows a route provider to one that prepares executable transfers. */
 export declare function canPrepareTransfer(provider: Provider): provider is Provider & {
     prepareTransfer: NonNullable<Provider['prepareTransfer']>;
 };
-/** Narrows a funding provider to one that provisions reusable deposit addresses. */
+/** Narrows a route provider to one that provisions reusable deposit addresses. */
 export declare function canCreateDepositAddress(provider: Provider): provider is Provider & {
     createDepositAddress: NonNullable<Provider['createDepositAddress']>;
 };
-/** Narrows a funding provider to one that tracks reusable deposit addresses. */
+/** Narrows a route provider to one that tracks reusable deposit addresses. */
 export declare function canListDepositAddressRequests(provider: Provider): provider is Provider & {
     listDepositAddressRequests: NonNullable<Provider['listDepositAddressRequests']>;
 };
-/** Narrows a funding provider to one that observes reusable-address delivery onchain. */
+/** Narrows a route provider to one that observes reusable-address delivery onchain. */
 export declare function canObserveDepositAddressRequest(provider: Provider): provider is Provider & {
     observeDepositAddressRequest: NonNullable<Provider['observeDepositAddressRequest']>;
 };
-/** Narrows a funding provider to one with authenticated webhook receipt. */
+/** Narrows a route provider to one that reconciles registered transfers. */
+export declare function canReconcileTransfer(provider: Provider): provider is Provider & {
+    verifyDestinationDelivery: NonNullable<Provider['verifyDestinationDelivery']>;
+    verifySourceTransaction: NonNullable<Provider['verifySourceTransaction']>;
+};
+/** Narrows a route provider to one that verifies submitted source transactions. */
+export declare function canVerifySourceTransaction(provider: Provider): provider is Provider & {
+    verifySourceTransaction: NonNullable<Provider['verifySourceTransaction']>;
+};
+/** Narrows a route provider to one with authenticated webhook receipt. */
 export declare function canReceiveWebhook(provider: Provider): provider is Provider & {
     webhook: Webhook;
 };
-/** Funding provider method recorded by request diagnostics. */
-export type ProviderOperation = 'createDepositAddress' | 'getQuote' | 'listDepositAddressRequests' | 'prepareTransfer';
-/** One provider attempt made while resolving a funding quote request. */
+/** Route provider method recorded by operational telemetry. */
+export type ProviderOperation = 'createDepositAddress' | 'getQuote' | 'listDepositAddressRequests' | 'observeDepositAddressRequest' | 'prepareTransfer' | 'receiveWebhook' | 'verifyDestinationDelivery' | 'verifySourceTransaction';
+/** Route provider identity retained by bounded operation telemetry. */
+export type ProviderIdentity = Pick<Provider, 'id'>;
+/** One timed route provider operation. */
 export type ProviderAttempt = {
     /** Wall-clock duration of the provider attempt in milliseconds. */
     durationMs: number;
     /** Provider method invoked by the attempt. */
     operation: ProviderOperation;
     /** Successful or expected-unavailable provider outcome. */
-    outcome: 'available' | 'thin' | 'unavailable';
-    /** Provider that handled the quote candidate. */
-    provider: Provider;
+    outcome: 'available' | 'success' | 'thin' | 'unavailable';
+    /** Provider that handled the operation. */
+    provider: ProviderIdentity;
 } | {
     /** Error thrown by the provider boundary. */
     cause: unknown;
@@ -658,8 +835,8 @@ export type ProviderAttempt = {
     operation: ProviderOperation;
     /** Failed provider outcome. */
     outcome: 'failed';
-    /** Provider that handled the quote candidate. */
-    provider: Provider;
+    /** Provider that handled the operation. */
+    provider: ProviderIdentity;
 };
 /** Bounded result for one provider attempt. */
 export type ProviderAttemptResult = {
@@ -681,8 +858,19 @@ export type ProviderFailure = {
     /** Provider method that failed. */
     operation: ProviderOperation;
     /** Provider that failed. */
-    provider: Provider;
+    provider: ProviderIdentity;
 };
+/** Observes one provider operation without changing its result. */
+export declare function observe<const result>(provider: ProviderIdentity, fn: () => Promise<result>, options: observe.Options): Promise<result>;
+export declare namespace observe {
+    /** Provider operation observation configuration. */
+    type Options = {
+        /** Receives the bounded provider operation result. */
+        onAttempt: (result: ProviderAttemptResult) => void;
+        /** Stable provider method identifier. */
+        operation: ProviderOperation;
+    };
+}
 /** Returns normalized chains and source tokens supported by quote providers. */
 export declare function getChains(options: getChains.Options): {
     addressFormat: "base58" | "base58check" | "hex";
@@ -703,13 +891,13 @@ export declare function getChains(options: getChains.Options): {
 export declare namespace getChains {
     /** Options for getting provider-supported source chains. */
     type Options = {
-        /** Compiled funding catalog containing provider routes. */
+        /** Compiled route catalog containing provider routes. */
         catalog: core_Catalog.Snapshot;
         /** Providers whose routes contribute source chains and tokens. */
         providers: readonly Provider[];
     };
 }
-/** Returns the supplied funding quote providers. */
+/** Returns the supplied route quote providers. */
 export declare function getProviders(options: getProviders.Options): {
     id: string;
     name: string;
@@ -717,13 +905,13 @@ export declare function getProviders(options: getProviders.Options): {
 export declare namespace getProviders {
     /** Options for getting providers. */
     type Options = {
-        /** Compiled funding catalog containing provider routes. */
+        /** Compiled route catalog containing provider routes. */
         catalog: core_Catalog.Snapshot;
-        /** Funding providers included in this deployment. */
+        /** Route providers included in this deployment. */
         providers: readonly Provider[];
     };
 }
-/** Returns successful live funding quotes from the supplied providers. */
+/** Returns successful live route quotes from the supplied providers. */
 export declare function getQuotes(options: getQuotes.Options): Promise<{
     destinationAmount: {
         baseUnits: string;
@@ -760,8 +948,6 @@ export declare function getQuotes(options: getQuotes.Options): Promise<{
     };
     quality: {
         estimatedSeconds?: number | undefined;
-        liquiditySource: string;
-        sourceDetail?: string | undefined;
         tier: "liquid" | "thin";
     };
     quote: {
@@ -838,21 +1024,25 @@ export declare function getQuoteCandidates(options: getQuoteCandidates.Options):
     };
 }[];
 export declare namespace getQuoteCandidates {
-    /** Options for selecting funding quote candidates. */
+    /** Options for selecting route quote candidates. */
     type Options = QuoteRequest & {
-        /** Compiled funding catalog containing provider routes. */
+        /** Compiled route catalog containing provider routes. */
         catalog: core_Catalog.Snapshot;
-        /** Funding providers considered by the request. */
+        /** Route providers considered by the request. */
         providers: readonly Provider[];
     };
 }
 export declare namespace getQuotes {
-    /** Options for requesting live funding quotes. */
+    /** Options for requesting live route quotes. */
     type Options = getQuoteCandidates.Options & {
         /** Cache policy for provider-side discovery and quote lookups. */
         cache?: CachePolicy | undefined;
         /** Receives one bounded observation for every provider attempt. */
         onAttempt?: ((attempt: ProviderAttempt) => void) | undefined;
+        /** Receives the bounded request-level quote result. */
+        onResult?: ((result: QuoteRequestResult) => void) | undefined;
+        /** Stable non-secret tenant identity for provider-local fairness. */
+        quotaKey?: string | undefined;
         /** Per-provider quote timeout in milliseconds. */
         providerTimeoutMs?: number | undefined;
     };
@@ -862,6 +1052,28 @@ export declare namespace getQuotes {
  * capability-enabled provider. Returns `undefined` when no route is enabled.
  */
 export declare function createDepositAddress(options: createDepositAddress.Options): Promise<createDepositAddress.Selection | undefined>;
+/** Selects and normalizes the deterministic reusable-address route without provisioning it. */
+export declare function selectDepositAddress(options: selectDepositAddress.Options): selectDepositAddress.Result | undefined;
+export declare namespace selectDepositAddress {
+    /** Route and accounts used to select one reusable-address provider. */
+    type Options = getDepositAddressCandidates.Options & {
+        /** Final beneficiary on Tempo. */
+        recipient: string;
+        /** Source-chain account that receives refunds. */
+        refundAddress: string;
+    };
+    /** Deterministic provider route with normalized accounts. */
+    type Result = {
+        /** Curated reusable-address route selected for provisioning. */
+        candidate: DepositAddressCandidate;
+        /** Provider selected for the reusable address. */
+        provider: ReturnType<typeof getDepositAddressCandidates>[number]['provider'];
+        /** Normalized final beneficiary on Tempo. */
+        recipient: string;
+        /** Normalized source-chain refund account. */
+        refundAddress: string;
+    };
+}
 export declare namespace createDepositAddress {
     /** Options for provisioning one reusable deposit address. */
     type Options = getDepositAddressCandidates.Options & {
@@ -908,21 +1120,29 @@ export declare namespace prepareTransfer {
         providerTimeoutMs?: number | undefined;
         /** Final beneficiary on the destination chain. */
         recipient: string;
-        /** Source-chain account that signs the funding action. */
+        /** Source-chain account that signs the route action. */
         sender: string;
         /** Caller slippage bound in basis points. */
         slippageBps?: number | undefined;
     };
     /** The selected preparation with a guaranteed expiry. */
     type Selection = {
+        /** Highest expected destination amount returned by a successful candidate. */
+        bestDestinationAmount: string;
         /** Curated candidate the preparation was produced for. */
         candidate: QuoteCandidate;
+        /** Number of successful preparations considered for automatic selection. */
+        preparedCount: number;
         /** Provider that produced the selected preparation. */
         provider: Provider;
+        /** Normalized final beneficiary on the destination chain. */
+        recipient: string;
         /** The preparation, with a default expiry applied when the provider gave none. */
         result: prepareTransfer.ReturnType & {
             expiresAt: string;
         };
+        /** Normalized source-chain account that signs the route action. */
+        sender: string;
     };
 }
 /**
@@ -970,19 +1190,23 @@ export declare function getDepositAddressCandidates(options: getDepositAddressCa
             verified: boolean;
         };
     };
-    provider: core_Provider.Provider<string, "funding"> & {
-        /** Provisions a reusable funding deposit address, when supported. */
+    provider: core_Provider.Provider<string, "routes"> & {
+        /** Provisions a reusable route deposit address, when supported. */
         createDepositAddress?(input: createDepositAddress.Parameters, signal: AbortSignal): Promise<createDepositAddress.ReturnType>;
-        /** Requests a live funding quote. */
+        /** Requests a live route quote. */
         getQuote(input: getQuote.Parameters, signal: AbortSignal): Promise<getQuote.ReturnType>;
         /** Lists requests discovered for a reusable deposit address, when supported. */
         listDepositAddressRequests?(input: listDepositAddressRequests.Parameters, signal: AbortSignal): Promise<listDepositAddressRequests.ReturnType>;
         /** Observes authenticated delivery for a verified reusable-address transfer, when supported. */
         observeDepositAddressRequest?(input: observeDepositAddressRequest.Parameters, signal: AbortSignal): Promise<observeDepositAddressRequest.ReturnType>;
-        /** Prepares an executable funding transfer, when the provider supports it. */
+        /** Prepares an executable route transfer, when the provider supports it. */
         prepareTransfer?(input: prepareTransfer.Parameters, signal: AbortSignal): Promise<prepareTransfer.ReturnType>;
         /** Validates provider-specific action semantics before generic persistence checks. */
         validateTransferAction?(input: validateTransferAction.Parameters): validateTransferAction.ReturnType;
+        /** Verifies destination delivery for a registered transfer, when supported. */
+        verifyDestinationDelivery?(input: verifyDestinationDelivery.Parameters, signal: AbortSignal): Promise<verifyDestinationDelivery.ReturnType>;
+        /** Verifies a submitted source transaction, when supported. */
+        verifySourceTransaction?(input: verifySourceTransaction.Parameters, signal: AbortSignal): Promise<verifySourceTransaction.ReturnType>;
         /** Receives authenticated provider status events, when configured. */
         webhook?: Webhook | undefined;
     } & {
@@ -992,13 +1216,13 @@ export declare function getDepositAddressCandidates(options: getDepositAddressCa
 export declare namespace getDepositAddressCandidates {
     /** Options for selecting reusable deposit-address routes. */
     type Options = {
-        /** Compiled funding catalog containing provider routes and capabilities. */
+        /** Compiled route catalog containing provider routes and capabilities. */
         catalog: core_Catalog.Snapshot;
         /** Tempo destination chain selected by app composition. */
         destinationChainId: number;
         /** Tempo destination token symbol, contract address, or token key. */
         destinationToken: string;
-        /** Funding providers considered by the request. */
+        /** Route providers considered by the request. */
         providers: readonly Provider[];
         /** Source chain CAIP-2 id, slug, or alias. */
         sourceChain: string;
@@ -1057,19 +1281,23 @@ export declare function getPrepareCandidates(options: getPrepareCandidates.Optio
             verified: boolean;
         };
     };
-    provider: core_Provider.Provider<string, "funding"> & {
-        /** Provisions a reusable funding deposit address, when supported. */
+    provider: core_Provider.Provider<string, "routes"> & {
+        /** Provisions a reusable route deposit address, when supported. */
         createDepositAddress?(input: createDepositAddress.Parameters, signal: AbortSignal): Promise<createDepositAddress.ReturnType>;
-        /** Requests a live funding quote. */
+        /** Requests a live route quote. */
         getQuote(input: getQuote.Parameters, signal: AbortSignal): Promise<getQuote.ReturnType>;
         /** Lists requests discovered for a reusable deposit address, when supported. */
         listDepositAddressRequests?(input: listDepositAddressRequests.Parameters, signal: AbortSignal): Promise<listDepositAddressRequests.ReturnType>;
         /** Observes authenticated delivery for a verified reusable-address transfer, when supported. */
         observeDepositAddressRequest?(input: observeDepositAddressRequest.Parameters, signal: AbortSignal): Promise<observeDepositAddressRequest.ReturnType>;
-        /** Prepares an executable funding transfer, when the provider supports it. */
+        /** Prepares an executable route transfer, when the provider supports it. */
         prepareTransfer?(input: prepareTransfer.Parameters, signal: AbortSignal): Promise<prepareTransfer.ReturnType>;
         /** Validates provider-specific action semantics before generic persistence checks. */
         validateTransferAction?(input: validateTransferAction.Parameters): validateTransferAction.ReturnType;
+        /** Verifies destination delivery for a registered transfer, when supported. */
+        verifyDestinationDelivery?(input: verifyDestinationDelivery.Parameters, signal: AbortSignal): Promise<verifyDestinationDelivery.ReturnType>;
+        /** Verifies a submitted source transaction, when supported. */
+        verifySourceTransaction?(input: verifySourceTransaction.Parameters, signal: AbortSignal): Promise<verifySourceTransaction.ReturnType>;
         /** Receives authenticated provider status events, when configured. */
         webhook?: Webhook | undefined;
     } & {
@@ -1079,19 +1307,19 @@ export declare function getPrepareCandidates(options: getPrepareCandidates.Optio
 export declare namespace getPrepareCandidates {
     /** Options for selecting preparation candidates. */
     type Options = {
-        /** Compiled funding catalog containing provider routes and capabilities. */
+        /** Compiled route catalog containing provider routes and capabilities. */
         catalog: core_Catalog.Snapshot;
-        /** Tempo destination chain selected by app composition. */
-        destinationChainId: number;
-        /** Tempo destination token symbol, contract address, or token key. */
+        /** Destination chain CAIP-2 id, slug, or alias. */
+        destinationChain: string;
+        /** Destination token symbol, contract address, or token key. */
         destinationToken: string;
-        /** Funding method passed to provider preparation. */
+        /** Route method passed to provider preparation. */
         method: Transfer.Method;
         /** Amount mode the caller selected. */
         mode: Transfer.Mode;
-        /** Funding provider ID selected by the caller. */
+        /** Route provider ID selected by the caller. */
         provider?: string | undefined;
-        /** Funding providers considered by the request. */
+        /** Route providers considered by the request. */
         providers: readonly Provider[];
         /** Source amount in base units. */
         sourceAmount: string;
@@ -1101,21 +1329,25 @@ export declare namespace getPrepareCandidates {
         sourceToken: string;
     };
 }
-/** Source amount unit accepted by the funding quote request. */
+/** Source amount unit accepted by the route quote request. */
 export type SourceAmountUnits = z.output<typeof schema.SourceAmountUnits>;
-/** Fetch implementation accepted by funding provider factories. */
+/** Fetch implementation accepted by route provider factories. */
 export type Fetch = typeof globalThis.fetch;
 /** Returns bounded provider failure details suitable for structured request logs. */
 export declare function failure(options: ProviderFailure): failure.Result;
 export declare namespace failure {
     /** Bounded provider failure fields. */
     type Result = {
+        /** EIP-155 chain whose RPC request failed. */
+        chainId?: number | undefined;
         /** Stable provider error code, when one is safe to retain. */
         code?: string | undefined;
         /** Failure boundary that rejected the provider request. */
-        failure: 'http' | 'network' | 'payload' | 'rate_limit' | 'timeout' | 'unknown';
+        failure: 'http' | 'network' | 'payload' | 'query' | 'rate_limit' | 'timeout' | 'unknown';
         /** Provider identifier. */
         id: string;
+        /** Upstream error message, when one was returned. */
+        message?: string | undefined;
         /** Provider operation identifier. */
         operation: ProviderOperation;
         /** Upstream HTTP status, when a response was received. */
@@ -1258,6 +1490,8 @@ declare namespace createQuoteCandidate {
         sourceToken: Token;
     };
 }
+/** Formats one provider attempt for logs and aggregate metrics. */
+export declare function formatAttempt(attempt: ProviderAttempt): ProviderAttemptResult;
 declare function resolveSourceAmount(options: resolveSourceAmount.Options): {
     amount: string;
     formatted: string;
@@ -1269,6 +1503,10 @@ declare namespace resolveSourceAmount {
         units: SourceAmountUnits;
     };
 }
+/** Error thrown when the caller supplies an unsupported destination chain. */
+export declare class UnsupportedDestinationChainError extends Error {
+    name: string;
+}
 /** Error thrown when the caller supplies an unsupported destination token. */
 export declare class UnsupportedDestinationTokenError extends Error {
     name: string;
@@ -1289,6 +1527,14 @@ export declare class InvalidAmountError extends Error {
 export declare class InvalidRefundAddressError extends Error {
     name: string;
 }
+/** Error thrown when the caller supplies an invalid destination-chain recipient. */
+export declare class InvalidRecipientAddressError extends Error {
+    name: string;
+}
+/** Error thrown when the caller supplies an invalid source-chain sender. */
+export declare class InvalidSenderAddressError extends Error {
+    name: string;
+}
 /** Error thrown when provider deployment configuration is invalid. */
 export declare class ProviderConfigurationError extends Error {
     name: string;
@@ -1328,7 +1574,7 @@ export declare class ProviderQuoteError extends Error {
     /** Provider failures that prevented a successful quote. */
     failures: readonly ProviderFailure[];
     /** Bounded provider attempts retained for request logs. */
-    fundingProviderAttempts: readonly ProviderAttemptResult[];
+    routesProviderAttempts: readonly ProviderAttemptResult[];
     /** First bounded provider failure retained for request logs. */
     providerFailure?: failure.Result | undefined;
     /** Bounded provider failures retained when multiple providers failed. */