tapimo 0.3.0 → 0.4.0

package/dist/internal/FundingRoutes.d.ts

@@ -1,3 +1,366 @@
+/** Tempo mainnet as a CAIP-2 chain reference. */
+declare const destinationChain: {
+    readonly addressFormat: 'evm';
+    readonly id: 'eip155:4217';
+    readonly kind: 'evm';
+    readonly name: 'Tempo';
+};
+/** Source chains accepted by the funding route inventory. */
+declare const sourceChains: readonly [{
+    readonly addressFormat: 'evm';
+    readonly aliases: readonly ['ethereum', 'eth', 'eip155:1'];
+    readonly id: 'eip155:1';
+    readonly kind: 'evm';
+    readonly name: 'Ethereum';
+    readonly providerIds: {
+        readonly across: '1';
+        readonly bridge: 'ethereum';
+        readonly bungee: '1';
+        readonly lifi: '1';
+        readonly relay: '1';
+    };
+    readonly slug: 'ethereum';
+    readonly tokens: readonly [{
+        readonly address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48';
+        readonly coingeckoId: 'usd-coin';
+        readonly decimals: 6;
+        readonly name: 'USD Coin';
+        readonly standard: 'ERC-20';
+        readonly symbol: 'USDC';
+    }, {
+        readonly address: '0xdac17f958d2ee523a2206206994597c13d831ec7';
+        readonly coingeckoId: 'tether';
+        readonly decimals: 6;
+        readonly name: 'Tether USD';
+        readonly standard: 'ERC-20';
+        readonly symbol: 'USDT';
+    }, {
+        readonly address: '0x6c3ea9036406852006290770bedfcaba0e23a0e8';
+        readonly coingeckoId: 'paypal-usd';
+        readonly decimals: 6;
+        readonly name: 'PayPal USD';
+        readonly standard: 'ERC-20';
+        readonly symbol: 'PYUSD';
+    }, {
+        readonly address: '0x1abaea1f7c830bd89acc67ec4af516284b1bc33c';
+        readonly coingeckoId: 'euro-coin';
+        readonly decimals: 6;
+        readonly name: 'Euro Coin';
+        readonly standard: 'ERC-20';
+        readonly symbol: 'EURC';
+    }, {
+        readonly address: '0x6b175474e89094c44da98b954eedeac495271d0f';
+        readonly coingeckoId: 'dai';
+        readonly decimals: 18;
+        readonly name: 'Dai Stablecoin';
+        readonly standard: 'ERC-20';
+        readonly symbol: 'DAI';
+    }];
+}, {
+    readonly addressFormat: 'evm';
+    readonly aliases: readonly ['base', 'eip155:8453'];
+    readonly id: 'eip155:8453';
+    readonly kind: 'evm';
+    readonly name: 'Base';
+    readonly providerIds: {
+        readonly across: '8453';
+        readonly bridge: 'base';
+        readonly bungee: '8453';
+        readonly lifi: '8453';
+        readonly relay: '8453';
+    };
+    readonly slug: 'base';
+    readonly tokens: readonly [{
+        readonly address: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913';
+        readonly coingeckoId: 'usd-coin';
+        readonly decimals: 6;
+        readonly name: 'USD Coin';
+        readonly standard: 'ERC-20';
+        readonly symbol: 'USDC';
+    }, {
+        readonly address: '0xfde4c96c8593536e31f229ea8f37b2ada2699bb2';
+        readonly coingeckoId: 'tether';
+        readonly decimals: 6;
+        readonly name: 'Tether USD';
+        readonly standard: 'ERC-20';
+        readonly symbol: 'USDT';
+    }, {
+        readonly address: '0x60a3e35cc302bfa44cb288bc5a4f316fdb1adb42';
+        readonly coingeckoId: 'euro-coin';
+        readonly decimals: 6;
+        readonly name: 'Euro Coin';
+        readonly standard: 'ERC-20';
+        readonly symbol: 'EURC';
+    }];
+}, {
+    readonly addressFormat: 'evm';
+    readonly aliases: readonly ['bnb', 'bsc', 'eip155:56'];
+    readonly id: 'eip155:56';
+    readonly kind: 'evm';
+    readonly name: 'BNB Smart Chain';
+    readonly providerIds: {
+        readonly across: '56';
+        readonly bungee: '56';
+        readonly lifi: '56';
+        readonly relay: '56';
+    };
+    readonly slug: 'bnb';
+    readonly tokens: readonly [{
+        readonly address: '0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d';
+        readonly coingeckoId: 'usd-coin';
+        readonly decimals: 18;
+        readonly name: 'Binance-Peg USD Coin';
+        readonly standard: 'BEP-20';
+        readonly symbol: 'USDC';
+    }, {
+        readonly address: '0x55d398326f99059ff775485246999027b3197955';
+        readonly coingeckoId: 'tether';
+        readonly decimals: 18;
+        readonly name: 'Tether USD';
+        readonly standard: 'BEP-20';
+        readonly symbol: 'USDT';
+    }];
+}, {
+    readonly addressFormat: 'solana';
+    readonly aliases: readonly ['solana', 'solana:mainnet'];
+    readonly id: 'solana:mainnet';
+    readonly kind: 'solana';
+    readonly name: 'Solana';
+    readonly providerIds: {
+        readonly bridge: 'solana';
+        readonly relay: 'solana';
+    };
+    readonly slug: 'solana';
+    readonly tokens: readonly [{
+        readonly address: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v';
+        readonly coingeckoId: 'usd-coin';
+        readonly decimals: 6;
+        readonly name: 'USD Coin';
+        readonly standard: 'SPL';
+        readonly symbol: 'USDC';
+    }, {
+        readonly address: 'Es9vMFrzaCERmJfrF4H2FYD4KCo3LwC1uix9YEaQ8t1v';
+        readonly coingeckoId: 'tether';
+        readonly decimals: 6;
+        readonly name: 'Tether USD';
+        readonly standard: 'SPL';
+        readonly symbol: 'USDT';
+    }];
+}, {
+    readonly addressFormat: 'tron';
+    readonly aliases: readonly ['tron', 'tron:mainnet'];
+    readonly id: 'tron:mainnet';
+    readonly kind: 'tron';
+    readonly name: 'Tron';
+    readonly providerIds: {
+        readonly bridge: 'tron';
+        readonly relay: 'tron';
+    };
+    readonly slug: 'tron';
+    readonly tokens: readonly [{
+        readonly address: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t';
+        readonly coingeckoId: 'tether';
+        readonly decimals: 6;
+        readonly name: 'Tether USD';
+        readonly standard: 'TRC-20';
+        readonly symbol: 'USDT';
+    }];
+}];
+/** Tempo destination tokens supported by the initial funding route inventory. */
+declare const destinationTokens: readonly [{
+    readonly address: '0x20c0000000000000000000000000000000000000';
+    readonly decimals: 6;
+    readonly name: 'pathUSD';
+    readonly slug: 'pathusd';
+    readonly standard: 'TIP-20';
+    readonly symbol: 'pathUSD';
+}, {
+    readonly address: '0x20c000000000000000000000b9537d11c60e8b50';
+    readonly decimals: 6;
+    readonly name: 'Bridged USDC (Stargate)';
+    readonly slug: 'usdce';
+    readonly standard: 'TIP-20';
+    readonly symbol: 'USDC.e';
+}, {
+    readonly address: '0x20c0000000000000000000001621e21f71cf12fb';
+    readonly decimals: 6;
+    readonly name: 'Bridged EURC';
+    readonly slug: 'eurce';
+    readonly standard: 'TIP-20';
+    readonly symbol: 'EURC.e';
+}, {
+    readonly address: '0x20c00000000000000000000014f22ca97301eb73';
+    readonly decimals: 6;
+    readonly name: 'USDT0';
+    readonly slug: 'usdt0';
+    readonly standard: 'TIP-20';
+    readonly symbol: 'USDT0';
+}, {
+    readonly address: '0x20c0000000000000000000003554d28269e0f3c2';
+    readonly decimals: 6;
+    readonly name: 'frxUSD';
+    readonly slug: 'frxusd';
+    readonly standard: 'TIP-20';
+    readonly symbol: 'frxUSD';
+}];
+/** Providers exposed by the generic provider catalog. */
+declare const providers: readonly [{
+    readonly capabilities: readonly ['fundingRoutes'];
+    readonly id: 'across';
+    readonly kind: 'intentBridge';
+    readonly name: 'Across';
+    readonly requiresApiKey: true;
+    readonly status: 'inventoryOnly';
+}, {
+    readonly capabilities: readonly ['fundingRoutes'];
+    readonly id: 'relay';
+    readonly kind: 'solverNetwork';
+    readonly name: 'Relay';
+    readonly requiresApiKey: false;
+    readonly status: 'inventoryOnly';
+}, {
+    readonly capabilities: readonly ['fundingRoutes'];
+    readonly id: 'bridge';
+    readonly kind: 'enterpriseTransfer';
+    readonly name: 'Bridge.xyz';
+    readonly requiresApiKey: true;
+    readonly status: 'inventoryOnly';
+}, {
+    readonly capabilities: readonly ['fundingRoutes'];
+    readonly id: 'bungee';
+    readonly kind: 'aggregator';
+    readonly name: 'Bungee';
+    readonly requiresApiKey: false;
+    readonly status: 'inventoryOnly';
+}, {
+    readonly capabilities: readonly ['fundingRoutes'];
+    readonly id: 'lifi';
+    readonly kind: 'aggregator';
+    readonly name: 'LI.FI';
+    readonly requiresApiKey: true;
+    readonly status: 'planned';
+}];
+type TokenInput = (typeof sourceChains)[number]['tokens'][number];
+type DestinationTokenInput = (typeof destinationTokens)[number];
+type ProviderInput = (typeof providers)[number];
+type SourceChainInput = (typeof sourceChains)[number];
+/** Provider ids accepted by the funding route inventory. */
+export type ProviderId = ProviderInput['id'];
+/** Provider-specific route status for the requested amount. */
+export type RouteStatus = 'available' | 'thin' | 'unknown' | 'unavailable' | 'error';
+/** Machine-readable route quality tier. */
+export type QualityTier = 'liquid' | 'thin' | 'unknown' | 'unavailable' | 'error';
+/** Response expansions accepted by funding route discovery. */
+export type Include = 'quotes';
+/** Normalized chain reference passed to provider adapters. */
+export type ChainRef = ReturnType<typeof formatChain> | typeof destinationChain;
+/** Normalized token amount passed to provider adapters. */
+export type TokenAmount = ReturnType<typeof resolveSourceAmount>;
+/** Normalized token reference passed to provider adapters. */
+export type TokenRef = ReturnType<typeof formatDestinationToken> | ReturnType<typeof formatSourceToken>;
+/** A normalized funding route candidate returned by route discovery. */
+export type RouteCandidate = ReturnType<typeof formatRouteCandidate>;
+/** Cache policy for a single funding route discovery request. */
+export type CachePolicy = {
+    /** Whether provider adapters should bypass their own quote or inventory caches. */
+    bypass: boolean;
+};
+/** Normalized caller request passed to provider adapters. */
+export type QuoteRequest = {
+    /** Optional Tempo destination token symbol, address, or token key. */
+    destinationToken?: string | undefined;
+    /** Response expansions requested by the caller. */
+    include: readonly Include[];
+    /** Maximum number of route candidates requested by the caller. */
+    limit: number;
+    /** Optional provider id filter. */
+    provider?: string | undefined;
+    /** Source amount as supplied by the caller. */
+    sourceAmount: string;
+    /** Unit used by {@link sourceAmount}. */
+    sourceAmountUnits: SourceAmountUnits;
+    /** Chain alias or CAIP-2 source chain id. */
+    sourceChain: string;
+    /** Source token symbol, contract address, mint, or Tempo token key. */
+    sourceToken: string;
+};
+/** Input passed to a provider adapter for one static route candidate probe. */
+export type QuoteProbeInput = {
+    /** Cache policy for provider-side inventory, quote, and liquidity lookups. */
+    cache: CachePolicy;
+    /** Destination chain, always Tempo mainnet in V1. */
+    destinationChain: ChainRef;
+    /** Tempo token expected from this route. */
+    destinationToken: TokenRef;
+    /** Response expansions requested by the caller. */
+    include: readonly Include[];
+    /** Normalized caller request that produced this route candidate. */
+    request: QuoteRequest;
+    /** Static candidate being enriched with live provider information. */
+    route: RouteCandidate;
+    /** Source amount in base units and display form. */
+    sourceAmount: TokenAmount;
+    /** Chain where the caller currently holds funds. */
+    sourceChain: ChainRef;
+    /** Token the caller currently holds. */
+    sourceToken: TokenRef;
+};
+/** Provider-specific source amount limits, expressed in source base units. */
+export type QuoteProbeLimits = {
+    /** Provider-reported instant source amount capacity. */
+    instantSourceAmount?: string | null | undefined;
+    /** Provider-reported maximum source amount. */
+    maxSourceAmount?: string | null | undefined;
+    /** Provider-reported minimum source amount. */
+    minSourceAmount?: string | null | undefined;
+};
+/** Quote probe data returned by a provider adapter. */
+export type QuoteProbeResult = {
+    /** Stable route error code when status is `error`. */
+    errorCode?: string | null | undefined;
+    /** Provider quote expiry timestamp. */
+    expiresAt?: string | null | undefined;
+    /** Provider-reported source amount limits. */
+    limits?: QuoteProbeLimits | null | undefined;
+    /** Slippage-adjusted minimum destination amount in base units. */
+    minimumOutputAmount?: string | null | undefined;
+    /** Expected destination amount in base units. */
+    outputAmount?: string | null | undefined;
+    /** Expected destination amount rendered with destination token decimals. */
+    outputAmountFormatted?: string | null | undefined;
+    /** Timestamp for the live quote or route probe. */
+    sampledAt: string;
+    /** Provider-specific route status for the requested amount. */
+    status: RouteStatus;
+    /** Provider-backed route quality metadata. */
+    quality?: {
+        /** Available USD capacity, when available. */
+        availableVolumeUsd?: string | null | undefined;
+        /** Estimated settlement time in seconds, when known. */
+        estimatedSeconds?: number | null | undefined;
+        /** Estimated fee in basis points, when known. */
+        feeBps?: number | null | undefined;
+        /** 24h routed volume in USD, when available. */
+        historicalVolumeUsd24h?: string | null | undefined;
+        /** Instant USD capacity, when available. */
+        instantVolumeUsd?: string | null | undefined;
+        /** Where the live liquidity or support signal came from. */
+        liquiditySource: string;
+        /** Explainable route score from 0 to 100, when enough signals are available. */
+        score?: number | null | undefined;
+        /** Provider-specific quote source or endpoint detail. */
+        sourceDetail?: string | null | undefined;
+        /** Machine-readable route quality tier. */
+        tier?: QualityTier | undefined;
+    };
+};
+/** Adapter used to enrich a static route candidate with live provider information. */
+export type ProviderAdapter = {
+    /** Probes provider-backed quote information for one static candidate. */
+    probeQuote(input: QuoteProbeInput, signal: AbortSignal): Promise<QuoteProbeResult>;
+};
+/** Provider adapter registry, keyed by provider id. Missing adapters leave routes static. */
+export type ProviderAdapters = Partial<Record<ProviderId, ProviderAdapter>>;
 /** Lists normalized chains and source tokens that can fund Tempo. */
 export declare function listChains(): {
     tokens: {
@@ -43,22 +406,52 @@ export declare function listChains(): {
 }[];
 /** Lists providers, optionally filtered by one provider capability. */
 export declare function listProviders(options?: listProviders.Options): {
+    status: "configured" | "inventoryOnly" | "planned";
     capabilities: "fundingRoutes"[];
     id: "across" | "bridge" | "bungee" | "lifi" | "relay";
     kind: "aggregator" | "enterpriseTransfer" | "intentBridge" | "solverNetwork";
     name: "Across" | "Bridge.xyz" | "Bungee" | "LI.FI" | "Relay";
     requiresApiKey: boolean;
-    status: "inventoryOnly" | "planned";
 }[];
 export declare namespace listProviders {
     /** Options for listing providers. */
     type Options = {
+        /** Provider adapters configured for this deployment. */
+        adapters?: ProviderAdapters | undefined;
         /** Provider capability to require. */
         capability?: Capability | undefined;
     };
 }
-/** Lists static funding route candidates for a normalized caller request. */
-export declare function listRoutes(options: listRoutes.Options): {
+/** Parses the comma-separated `include` query parameter. */
+export declare function parseInclude(input: string | undefined): readonly "quotes"[];
+/** Lists funding route candidates, enriching static inventory when adapters are configured. */
+export declare function listRoutes(options: listRoutes.Options): Promise<({
+    errorCode: string | null;
+    quality: {
+        availableVolumeUsd: string | null | undefined;
+        estimatedSeconds: number | null | undefined;
+        feeBps: number | null | undefined;
+        historicalVolumeUsd24h: string | null | undefined;
+        instantVolumeUsd: string | null | undefined;
+        liquiditySource: string;
+        score: number | null | undefined;
+        sourceDetail: string | null | undefined;
+        tier: QualityTier | undefined;
+    };
+    quote: {
+        readonly expiresAt: string | null;
+        readonly inputAmount: string;
+        readonly limits: {
+            instantSourceAmount: string | null;
+            maxSourceAmount: string | null;
+            minSourceAmount: string | null;
+        } | null;
+        readonly minimumOutputAmount: string | null;
+        readonly outputAmount: string | null;
+        readonly outputAmountFormatted: string | null;
+        readonly sampledAt: string;
+    } | null;
+    status: RouteStatus;
     destinationChain: {
         readonly addressFormat: 'evm';
         readonly id: 'eip155:4217';
@@ -82,16 +475,6 @@ export declare function listRoutes(options: listRoutes.Options): {
         name: "Across" | "Bridge.xyz" | "Bungee" | "LI.FI" | "Relay";
         requiresApiKey: boolean;
     };
-    quality: {
-        availableVolumeUsd: null;
-        estimatedSeconds: null;
-        feeBps: null;
-        historicalVolumeUsd24h: null;
-        instantVolumeUsd: null;
-        liquiditySource: string;
-        score: null;
-        tier: 'unknown';
-    };
     sourceAmount: {
         amount: string;
         formatted: string;
@@ -139,10 +522,181 @@ export declare function listRoutes(options: listRoutes.Options): {
         tokenKey: string;
         verified: boolean;
     };
-    status: 'unknown';
+} | {
+    readonly destinationChain: {
+        readonly addressFormat: 'evm';
+        readonly id: 'eip155:4217';
+        readonly kind: 'evm';
+        readonly name: 'Tempo';
+    };
+    readonly destinationToken: {
+        address: "0x20c0000000000000000000000000000000000000" | "0x20c00000000000000000000014f22ca97301eb73" | "0x20c0000000000000000000001621e21f71cf12fb" | "0x20c0000000000000000000003554d28269e0f3c2" | "0x20c000000000000000000000b9537d11c60e8b50";
+        decimals: 6;
+        metadata: {};
+        name: "Bridged EURC" | "Bridged USDC (Stargate)" | "USDT0" | "frxUSD" | "pathUSD";
+        standard: "TIP-20";
+        symbol: "EURC.e" | "USDC.e" | "USDT0" | "frxUSD" | "pathUSD";
+        tokenKey: string;
+        verified: boolean;
+    };
+    readonly errorCode: null;
+    readonly id: string;
+    readonly provider: {
+        id: "across" | "bridge" | "bungee" | "lifi" | "relay";
+        kind: "aggregator" | "enterpriseTransfer" | "intentBridge" | "solverNetwork";
+        name: "Across" | "Bridge.xyz" | "Bungee" | "LI.FI" | "Relay";
+        requiresApiKey: boolean;
+    };
+    readonly quality: {
+        readonly availableVolumeUsd: null;
+        readonly estimatedSeconds: null;
+        readonly feeBps: null;
+        readonly historicalVolumeUsd24h: null;
+        readonly instantVolumeUsd: null;
+        readonly liquiditySource: 'staticInventory';
+        readonly score: null;
+        readonly sourceDetail: null;
+        readonly tier: 'unknown';
+    };
+    readonly quote: null;
+    readonly sourceAmount: {
+        amount: string;
+        formatted: string;
+        usd: null;
+    };
+    readonly sourceChain: {
+        addressFormat: "evm" | "solana" | "tron";
+        id: "eip155:1" | "eip155:56" | "eip155:8453" | "solana:mainnet" | "tron:mainnet";
+        kind: "evm" | "solana" | "tron";
+        name: "BNB Smart Chain" | "Base" | "Ethereum" | "Solana" | "Tron";
+        providerIds: {
+            readonly across: '1';
+            readonly bridge: 'ethereum';
+            readonly bungee: '1';
+            readonly lifi: '1';
+            readonly relay: '1';
+        } | {
+            readonly across: '8453';
+            readonly bridge: 'base';
+            readonly bungee: '8453';
+            readonly lifi: '8453';
+            readonly relay: '8453';
+        } | {
+            readonly across: '56';
+            readonly bungee: '56';
+            readonly lifi: '56';
+            readonly relay: '56';
+        } | {
+            readonly bridge: 'solana';
+            readonly relay: 'solana';
+        } | {
+            readonly bridge: 'tron';
+            readonly relay: 'tron';
+        };
+    };
+    readonly sourceToken: {
+        address: "0x1abaea1f7c830bd89acc67ec4af516284b1bc33c" | "0x55d398326f99059ff775485246999027b3197955" | "0x60a3e35cc302bfa44cb288bc5a4f316fdb1adb42" | "0x6b175474e89094c44da98b954eedeac495271d0f" | "0x6c3ea9036406852006290770bedfcaba0e23a0e8" | "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" | "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d" | "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" | "0xdac17f958d2ee523a2206206994597c13d831ec7" | "0xfde4c96c8593536e31f229ea8f37b2ada2699bb2" | "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" | "Es9vMFrzaCERmJfrF4H2FYD4KCo3LwC1uix9YEaQ8t1v" | "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t";
+        decimals: 6 | 18;
+        metadata: {
+            coingeckoId: "dai" | "euro-coin" | "paypal-usd" | "tether" | "usd-coin";
+        };
+        name: "Binance-Peg USD Coin" | "Dai Stablecoin" | "Euro Coin" | "PayPal USD" | "Tether USD" | "USD Coin";
+        standard: "BEP-20" | "ERC-20" | "SPL" | "TRC-20";
+        symbol: "DAI" | "EURC" | "PYUSD" | "USDC" | "USDT";
+        tokenKey: string;
+        verified: boolean;
+    };
+    readonly status: 'unknown';
+})[]>;
+/** Lists static funding route candidates for a normalized caller request. */
+export declare function listStaticRoutes(options: listStaticRoutes.Options): {
+    readonly destinationChain: {
+        readonly addressFormat: 'evm';
+        readonly id: 'eip155:4217';
+        readonly kind: 'evm';
+        readonly name: 'Tempo';
+    };
+    readonly destinationToken: {
+        address: "0x20c0000000000000000000000000000000000000" | "0x20c00000000000000000000014f22ca97301eb73" | "0x20c0000000000000000000001621e21f71cf12fb" | "0x20c0000000000000000000003554d28269e0f3c2" | "0x20c000000000000000000000b9537d11c60e8b50";
+        decimals: 6;
+        metadata: {};
+        name: "Bridged EURC" | "Bridged USDC (Stargate)" | "USDT0" | "frxUSD" | "pathUSD";
+        standard: "TIP-20";
+        symbol: "EURC.e" | "USDC.e" | "USDT0" | "frxUSD" | "pathUSD";
+        tokenKey: string;
+        verified: boolean;
+    };
+    readonly errorCode: null;
+    readonly id: string;
+    readonly provider: {
+        id: "across" | "bridge" | "bungee" | "lifi" | "relay";
+        kind: "aggregator" | "enterpriseTransfer" | "intentBridge" | "solverNetwork";
+        name: "Across" | "Bridge.xyz" | "Bungee" | "LI.FI" | "Relay";
+        requiresApiKey: boolean;
+    };
+    readonly quality: {
+        readonly availableVolumeUsd: null;
+        readonly estimatedSeconds: null;
+        readonly feeBps: null;
+        readonly historicalVolumeUsd24h: null;
+        readonly instantVolumeUsd: null;
+        readonly liquiditySource: 'staticInventory';
+        readonly score: null;
+        readonly sourceDetail: null;
+        readonly tier: 'unknown';
+    };
+    readonly quote: null;
+    readonly sourceAmount: {
+        amount: string;
+        formatted: string;
+        usd: null;
+    };
+    readonly sourceChain: {
+        addressFormat: "evm" | "solana" | "tron";
+        id: "eip155:1" | "eip155:56" | "eip155:8453" | "solana:mainnet" | "tron:mainnet";
+        kind: "evm" | "solana" | "tron";
+        name: "BNB Smart Chain" | "Base" | "Ethereum" | "Solana" | "Tron";
+        providerIds: {
+            readonly across: '1';
+            readonly bridge: 'ethereum';
+            readonly bungee: '1';
+            readonly lifi: '1';
+            readonly relay: '1';
+        } | {
+            readonly across: '8453';
+            readonly bridge: 'base';
+            readonly bungee: '8453';
+            readonly lifi: '8453';
+            readonly relay: '8453';
+        } | {
+            readonly across: '56';
+            readonly bungee: '56';
+            readonly lifi: '56';
+            readonly relay: '56';
+        } | {
+            readonly bridge: 'solana';
+            readonly relay: 'solana';
+        } | {
+            readonly bridge: 'tron';
+            readonly relay: 'tron';
+        };
+    };
+    readonly sourceToken: {
+        address: "0x1abaea1f7c830bd89acc67ec4af516284b1bc33c" | "0x55d398326f99059ff775485246999027b3197955" | "0x60a3e35cc302bfa44cb288bc5a4f316fdb1adb42" | "0x6b175474e89094c44da98b954eedeac495271d0f" | "0x6c3ea9036406852006290770bedfcaba0e23a0e8" | "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" | "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d" | "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" | "0xdac17f958d2ee523a2206206994597c13d831ec7" | "0xfde4c96c8593536e31f229ea8f37b2ada2699bb2" | "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" | "Es9vMFrzaCERmJfrF4H2FYD4KCo3LwC1uix9YEaQ8t1v" | "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t";
+        decimals: 6 | 18;
+        metadata: {
+            coingeckoId: "dai" | "euro-coin" | "paypal-usd" | "tether" | "usd-coin";
+        };
+        name: "Binance-Peg USD Coin" | "Dai Stablecoin" | "Euro Coin" | "PayPal USD" | "Tether USD" | "USD Coin";
+        standard: "BEP-20" | "ERC-20" | "SPL" | "TRC-20";
+        symbol: "DAI" | "EURC" | "PYUSD" | "USDC" | "USDT";
+        tokenKey: string;
+        verified: boolean;
+    };
+    readonly status: 'unknown';
 }[];
-export declare namespace listRoutes {
-    /** Options for listing funding routes. */
+export declare namespace listStaticRoutes {
+    /** Options for listing static funding routes. */
     type Options = {
         /** Optional Tempo destination token symbol, address, or token key. */
         destinationToken?: string | undefined;
@@ -160,10 +714,179 @@ export declare namespace listRoutes {
         sourceToken: string;
     };
 }
+export declare namespace listRoutes {
+    /** Options for listing funding routes. */
+    type Options = listStaticRoutes.Options & {
+        /** Provider adapters used to enrich static inventory with live data. */
+        adapters?: ProviderAdapters | undefined;
+        /** Per-provider quote timeout in milliseconds. */
+        adapterTimeoutMs?: number | undefined;
+        /** Cache policy for provider-side inventory, quote, and liquidity lookups. */
+        cache?: CachePolicy | undefined;
+        /** Response expansions requested by the caller. */
+        include?: readonly Include[] | undefined;
+    };
+}
 /** Provider capability identifiers accepted by the generic provider catalog. */
 export type Capability = 'fundingRoutes';
 /** Source amount unit accepted by the funding route request. */
 export type SourceAmountUnits = 'baseUnits' | 'decimal';
+declare function formatChain(chain: SourceChainInput): {
+    addressFormat: "evm" | "solana" | "tron";
+    id: "eip155:1" | "eip155:56" | "eip155:8453" | "solana:mainnet" | "tron:mainnet";
+    kind: "evm" | "solana" | "tron";
+    name: "BNB Smart Chain" | "Base" | "Ethereum" | "Solana" | "Tron";
+    providerIds: {
+        readonly across: '1';
+        readonly bridge: 'ethereum';
+        readonly bungee: '1';
+        readonly lifi: '1';
+        readonly relay: '1';
+    } | {
+        readonly across: '8453';
+        readonly bridge: 'base';
+        readonly bungee: '8453';
+        readonly lifi: '8453';
+        readonly relay: '8453';
+    } | {
+        readonly across: '56';
+        readonly bungee: '56';
+        readonly lifi: '56';
+        readonly relay: '56';
+    } | {
+        readonly bridge: 'solana';
+        readonly relay: 'solana';
+    } | {
+        readonly bridge: 'tron';
+        readonly relay: 'tron';
+    };
+};
+declare function formatDestinationToken(token: DestinationTokenInput): {
+    address: "0x20c0000000000000000000000000000000000000" | "0x20c00000000000000000000014f22ca97301eb73" | "0x20c0000000000000000000001621e21f71cf12fb" | "0x20c0000000000000000000003554d28269e0f3c2" | "0x20c000000000000000000000b9537d11c60e8b50";
+    decimals: 6;
+    metadata: {};
+    name: "Bridged EURC" | "Bridged USDC (Stargate)" | "USDT0" | "frxUSD" | "pathUSD";
+    standard: "TIP-20";
+    symbol: "EURC.e" | "USDC.e" | "USDT0" | "frxUSD" | "pathUSD";
+    tokenKey: string;
+    verified: boolean;
+};
+declare function formatRouteCandidate(options: {
+    destinationToken: DestinationTokenInput;
+    provider: ProviderInput;
+    sourceAmount: ReturnType<typeof resolveSourceAmount>;
+    sourceChain: SourceChainInput;
+    sourceToken: TokenInput;
+}): {
+    readonly destinationChain: {
+        readonly addressFormat: 'evm';
+        readonly id: 'eip155:4217';
+        readonly kind: 'evm';
+        readonly name: 'Tempo';
+    };
+    readonly destinationToken: {
+        address: "0x20c0000000000000000000000000000000000000" | "0x20c00000000000000000000014f22ca97301eb73" | "0x20c0000000000000000000001621e21f71cf12fb" | "0x20c0000000000000000000003554d28269e0f3c2" | "0x20c000000000000000000000b9537d11c60e8b50";
+        decimals: 6;
+        metadata: {};
+        name: "Bridged EURC" | "Bridged USDC (Stargate)" | "USDT0" | "frxUSD" | "pathUSD";
+        standard: "TIP-20";
+        symbol: "EURC.e" | "USDC.e" | "USDT0" | "frxUSD" | "pathUSD";
+        tokenKey: string;
+        verified: boolean;
+    };
+    readonly errorCode: null;
+    readonly id: string;
+    readonly provider: {
+        id: "across" | "bridge" | "bungee" | "lifi" | "relay";
+        kind: "aggregator" | "enterpriseTransfer" | "intentBridge" | "solverNetwork";
+        name: "Across" | "Bridge.xyz" | "Bungee" | "LI.FI" | "Relay";
+        requiresApiKey: boolean;
+    };
+    readonly quality: {
+        readonly availableVolumeUsd: null;
+        readonly estimatedSeconds: null;
+        readonly feeBps: null;
+        readonly historicalVolumeUsd24h: null;
+        readonly instantVolumeUsd: null;
+        readonly liquiditySource: 'staticInventory';
+        readonly score: null;
+        readonly sourceDetail: null;
+        readonly tier: 'unknown';
+    };
+    readonly quote: null;
+    readonly sourceAmount: {
+        amount: string;
+        formatted: string;
+        usd: null;
+    };
+    readonly sourceChain: {
+        addressFormat: "evm" | "solana" | "tron";
+        id: "eip155:1" | "eip155:56" | "eip155:8453" | "solana:mainnet" | "tron:mainnet";
+        kind: "evm" | "solana" | "tron";
+        name: "BNB Smart Chain" | "Base" | "Ethereum" | "Solana" | "Tron";
+        providerIds: {
+            readonly across: '1';
+            readonly bridge: 'ethereum';
+            readonly bungee: '1';
+            readonly lifi: '1';
+            readonly relay: '1';
+        } | {
+            readonly across: '8453';
+            readonly bridge: 'base';
+            readonly bungee: '8453';
+            readonly lifi: '8453';
+            readonly relay: '8453';
+        } | {
+            readonly across: '56';
+            readonly bungee: '56';
+            readonly lifi: '56';
+            readonly relay: '56';
+        } | {
+            readonly bridge: 'solana';
+            readonly relay: 'solana';
+        } | {
+            readonly bridge: 'tron';
+            readonly relay: 'tron';
+        };
+    };
+    readonly sourceToken: {
+        address: "0x1abaea1f7c830bd89acc67ec4af516284b1bc33c" | "0x55d398326f99059ff775485246999027b3197955" | "0x60a3e35cc302bfa44cb288bc5a4f316fdb1adb42" | "0x6b175474e89094c44da98b954eedeac495271d0f" | "0x6c3ea9036406852006290770bedfcaba0e23a0e8" | "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" | "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d" | "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" | "0xdac17f958d2ee523a2206206994597c13d831ec7" | "0xfde4c96c8593536e31f229ea8f37b2ada2699bb2" | "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" | "Es9vMFrzaCERmJfrF4H2FYD4KCo3LwC1uix9YEaQ8t1v" | "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t";
+        decimals: 6 | 18;
+        metadata: {
+            coingeckoId: "dai" | "euro-coin" | "paypal-usd" | "tether" | "usd-coin";
+        };
+        name: "Binance-Peg USD Coin" | "Dai Stablecoin" | "Euro Coin" | "PayPal USD" | "Tether USD" | "USD Coin";
+        standard: "BEP-20" | "ERC-20" | "SPL" | "TRC-20";
+        symbol: "DAI" | "EURC" | "PYUSD" | "USDC" | "USDT";
+        tokenKey: string;
+        verified: boolean;
+    };
+    readonly status: 'unknown';
+};
+declare function formatSourceToken(chain: SourceChainInput, token: TokenInput): {
+    address: "0x1abaea1f7c830bd89acc67ec4af516284b1bc33c" | "0x55d398326f99059ff775485246999027b3197955" | "0x60a3e35cc302bfa44cb288bc5a4f316fdb1adb42" | "0x6b175474e89094c44da98b954eedeac495271d0f" | "0x6c3ea9036406852006290770bedfcaba0e23a0e8" | "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" | "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d" | "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" | "0xdac17f958d2ee523a2206206994597c13d831ec7" | "0xfde4c96c8593536e31f229ea8f37b2ada2699bb2" | "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" | "Es9vMFrzaCERmJfrF4H2FYD4KCo3LwC1uix9YEaQ8t1v" | "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t";
+    decimals: 6 | 18;
+    metadata: {
+        coingeckoId: "dai" | "euro-coin" | "paypal-usd" | "tether" | "usd-coin";
+    };
+    name: "Binance-Peg USD Coin" | "Dai Stablecoin" | "Euro Coin" | "PayPal USD" | "Tether USD" | "USD Coin";
+    standard: "BEP-20" | "ERC-20" | "SPL" | "TRC-20";
+    symbol: "DAI" | "EURC" | "PYUSD" | "USDC" | "USDT";
+    tokenKey: string;
+    verified: boolean;
+};
+declare function resolveSourceAmount(options: resolveSourceAmount.Options): {
+    amount: string;
+    formatted: string;
+    usd: null;
+};
+declare namespace resolveSourceAmount {
+    type Options = {
+        amount: string;
+        token: TokenInput;
+        units: SourceAmountUnits;
+    };
+}
 /** Error thrown when the caller supplies an unsupported destination token. */
 export declare class UnsupportedDestinationTokenError extends Error {
     name: string;
@@ -172,12 +895,21 @@ export declare class UnsupportedDestinationTokenError extends Error {
 export declare class InvalidAmountError extends Error {
     name: string;
 }
+/** Error thrown internally when a provider adapter exceeds its route quote timeout. */
+export declare class ProviderAdapterTimeoutError extends Error {
+    name: string;
+}
 /** Error thrown when the caller filters to an unknown provider. */
 export declare class UnsupportedProviderError extends Error {
     name: string;
 }
+/** Error thrown when the caller requests an unsupported include expansion. */
+export declare class UnsupportedIncludeError extends Error {
+    name: string;
+}
 /** Error thrown when the caller supplies an unsupported source chain. */
 export declare class UnsupportedSourceChainError extends Error {
     name: string;
 }
+export {};
 //# sourceMappingURL=FundingRoutes.d.ts.map