tapimo 0.4.4 → 0.5.0

package/src/apps/data/routes/funding.ts

@@ -4,18 +4,18 @@ import * as z from 'zod/mini'
 import type * as App from '../../../App.js'
 import * as Auth from '../../../internal/Auth.js'
 import * as Cache from '../../../internal/Cache.js'
-import * as FundingRoutes from '../../../internal/FundingRoutes.js'
+import * as FundingQuotes from '../../../internal/FundingQuotes.js'
 import * as OpenApi from '../../../internal/OpenApi.js'
 import * as Response from '../../../internal/Response.js'
 import * as Schema from '../../../internal/Schema.js'
 
-/** Zod schemas owned by the funding routes resource. */
+/** Zod schemas owned by funding quote resources. */
 export namespace schema {
   /** Source or destination chain reference. */
   export const Chain = Schema.describe(
     z.object({
       addressFormat: z
-        .enum(['evm', 'solana', 'tron'])
+        .literal('evm')
         .check(
           z.describe('Address family used by accounts and token identifiers on this chain.'),
           z.meta({ examples: ['evm'] }),
@@ -24,12 +24,12 @@ export namespace schema {
         .string()
         .check(
           z.describe(
-            'Stable chain id, preferably CAIP-2 when one exists. Funding spans non-EVM chains, so ids are strings, unlike numeric `chainId` params elsewhere.',
+            'Stable CAIP-2 chain id, represented as a string instead of the numeric `chainId` used elsewhere.',
           ),
           z.meta({ examples: ['eip155:8453'] }),
         ),
       kind: z
-        .enum(['evm', 'solana', 'tron'])
+        .literal('evm')
         .check(
           z.describe('Chain execution family used for provider routing.'),
           z.meta({ examples: ['evm'] }),
@@ -40,11 +40,11 @@ export namespace schema {
       providerIds: z
         .optional(z.record(z.string(), z.string()))
         .check(
-          z.describe('Provider-specific chain ids Tempo uses when querying route providers.'),
-          z.meta({ examples: [{ bridge: 'base', relay: '8453' }] }),
+          z.describe('Provider-specific chain ids Tempo uses when requesting quotes.'),
+          z.meta({ examples: [{ relay: '8453' }] }),
         ),
     }),
-    'A normalized chain reference for funding routes.',
+    'A normalized chain reference for funding quotes.',
   )
 
   /** Source or destination token reference. */
@@ -88,14 +88,14 @@ export namespace schema {
       verified: z
         .boolean()
         .check(
-          z.describe('Whether Tempo recognizes this token in its funding route inventory.'),
+          z.describe('Whether Tempo recognizes this token in its funding quote inventory.'),
           z.meta({ examples: [true] }),
         ),
     }),
-    'A normalized token reference for funding routes.',
+    'A normalized token reference for funding quotes.',
   )
 
-  /** Source amount echoed by a funding route response. */
+  /** Source amount echoed by a funding quote response. */
   export const TokenAmount = Schema.describe(
     z.object({
       amount: Schema.DecimalString.check(
@@ -109,25 +109,21 @@ export namespace schema {
           ),
           z.meta({ examples: ['1'] }),
         ),
-      usd: z
-        .nullable(z.string())
-        .check(
-          z.describe('USD estimate for the requested source amount, when available.'),
-          z.meta({ examples: ['1.00'] }),
-        ),
     }),
     'The requested source amount in provider-safe base units and display form.',
   )
 
-  /** Provider summary embedded in a route candidate. */
+  /** Provider summary embedded in a funding quote. */
   export const ProviderRef = Schema.describe(
     z.object({
-      id: z.string().check(z.describe('Stable provider id.'), z.meta({ examples: ['relay'] })),
+      id: z
+        .literal('relay')
+        .check(z.describe('Stable provider id.'), z.meta({ examples: ['relay'] })),
       kind: z
         .string()
         .check(
-          z.describe('Provider category, such as an intent bridge, solver network, or aggregator.'),
-          z.meta({ examples: ['intentBridge'] }),
+          z.describe('Provider category, such as a solver network or aggregator.'),
+          z.meta({ examples: ['solverNetwork'] }),
         ),
       name: z
         .string()
@@ -136,124 +132,65 @@ export namespace schema {
         .boolean()
         .check(
           z.describe('Whether Tempo needs provider credentials to query or use this provider.'),
-          z.meta({ examples: [true] }),
+          z.meta({ examples: [false] }),
         ),
     }),
-    'Provider metadata embedded in a route candidate.',
+    'Provider metadata embedded in a funding quote.',
   )
 
-  /** Route quality signals exposed directly instead of implied by list order. */
+  /** Quote quality signals exposed directly instead of implied by list order. */
   export const Quality = Schema.describe(
     z.object({
-      availableVolumeUsd: z
-        .nullable(z.string())
-        .check(
-          z.describe('Available USD capacity, when available.'),
-          z.meta({ examples: ['1114274.43'] }),
-        ),
       estimatedSeconds: z
-        .nullable(z.number().check(z.int(), z.nonnegative()))
+        .optional(z.number().check(z.int(), z.nonnegative()))
         .check(
           z.describe('Estimated settlement time in seconds, when known.'),
           z.meta({ examples: [2] }),
         ),
-      feeBps: z
-        .nullable(z.number().check(z.int(), z.nonnegative()))
-        .check(
-          z.describe('Estimated fee in basis points, when known.'),
-          z.meta({ examples: [109] }),
-        ),
-      historicalVolumeUsd24h: z
-        .nullable(z.string())
-        .check(
-          z.describe('24h routed volume in USD, when available.'),
-          z.meta({ examples: ['250000.00'] }),
-        ),
-      instantVolumeUsd: z
-        .nullable(z.string())
-        .check(
-          z.describe('Instant USD capacity, when available.'),
-          z.meta({ examples: ['12453.94'] }),
-        ),
       liquiditySource: z
         .string()
         .check(
-          z.describe('Where the liquidity or support signal came from.'),
-          z.meta({ examples: ['staticInventory'] }),
-        ),
-      score: z
-        .nullable(z.number().check(z.int(), z.gte(0), z.lte(100)))
-        .check(
-          z.describe('Explainable route score from 0 to 100, when enough signals are available.'),
-          z.meta({ examples: [91] }),
+          z.describe('Provider source for the live quote quality signal.'),
+          z.meta({ examples: ['providerQuote'] }),
         ),
       sourceDetail: z
-        .nullable(z.string())
+        .optional(z.string())
         .check(
           z.describe('Provider-specific source or endpoint detail for the quality signal.'),
           z.meta({ examples: ['providerEndpoint'] }),
         ),
       tier: z
-        .enum(['liquid', 'thin', 'unknown', 'unavailable', 'error'])
+        .enum(['liquid', 'thin'])
         .check(
-          z.describe('Machine-readable route quality tier.'),
-          z.meta({ examples: ['unknown'] }),
+          z.describe('Machine-readable quality tier for a successful quote.'),
+          z.meta({ examples: ['liquid'] }),
         ),
     }),
-    'Machine-readable liquidity, fee, and source signals for a route candidate.',
+    'Machine-readable liquidity, fee, and source signals for a successful quote.',
   )
 
-  /** Provider-derived quote data for a route candidate. */
-  export const RouteQuote = Schema.describe(
+  /** Provider-derived output, limits, and freshness data. */
+  export const QuoteDetails = Schema.describe(
     z.object({
-      expiresAt: z
-        .nullable(z.iso.datetime())
-        .check(
-          z.describe('Provider quote expiry timestamp.'),
-          z.meta({ examples: ['2026-01-01T00:00:30Z'] }),
-        ),
       inputAmount: Schema.DecimalString.check(
         z.describe('Source amount sent to the provider in base units.'),
         z.meta({ examples: ['1000000'] }),
       ),
-      limits: z
-        .nullable(
-          z.object({
-            instantSourceAmount: z
-              .nullable(Schema.DecimalString)
-              .check(
-                z.describe('Provider-reported instant source amount capacity.'),
-                z.meta({ examples: ['12453940000'] }),
-              ),
-            maxSourceAmount: z
-              .nullable(Schema.DecimalString)
-              .check(
-                z.describe('Provider-reported maximum source amount.'),
-                z.meta({ examples: ['1114274433200'] }),
-              ),
-            minSourceAmount: z
-              .nullable(Schema.DecimalString)
-              .check(
-                z.describe('Provider-reported minimum source amount.'),
-                z.meta({ examples: ['500063'] }),
-              ),
-          }),
-        )
-        .check(z.describe('Provider limits expressed in source base units.')),
       minimumOutputAmount: z
-        .nullable(Schema.DecimalString)
+        .optional(Schema.DecimalString)
         .check(
           z.describe('Slippage-adjusted minimum destination amount in base units.'),
           z.meta({ examples: ['988000'] }),
         ),
       outputAmount: z
-        .nullable(Schema.DecimalString)
+        .string()
+        .check(z.regex(/^\d+$/))
         .check(
           z.describe('Expected destination amount in base units.'),
           z.meta({ examples: ['989102'] }),
         ),
       outputAmountFormatted: z
-        .nullable(z.string())
+        .string()
         .check(
           z.describe('Expected destination amount rendered with destination token decimals.'),
           z.meta({ examples: ['0.989102'] }),
@@ -261,58 +198,40 @@ export namespace schema {
       sampledAt: z.iso
         .datetime()
         .check(
-          z.describe('Timestamp for the live quote or route probe.'),
+          z.describe('Timestamp for the live quote probe.'),
           z.meta({ examples: ['2026-01-01T00:00:00Z'] }),
         ),
     }),
-    'Provider-derived quote, limit, and freshness data for a route candidate.',
+    'Provider-derived output, limits, and freshness data for a funding quote.',
   )
 
-  /** Static or live funding route candidate. */
-  export const RouteCandidate = Schema.describe(
+  /** Successful live funding quote. */
+  export const FundingQuote = Schema.describe(
     z.object({
       destinationChain: Chain.check(z.describe('Destination chain, always Tempo mainnet in V1.')),
-      destinationToken: Token.check(z.describe('Tempo token expected from this route.')),
-      errorCode: z
-        .nullable(z.string())
-        .check(
-          z.describe('Stable route error code, when status is `error`.'),
-          z.meta({ examples: ['provider_timeout'] }),
-        ),
+      destinationToken: Token.check(z.describe('Tempo token expected from this quote.')),
       id: z
         .string()
         .check(
-          z.describe('Stable deterministic route candidate id.'),
+          z.describe('Stable deterministic funding quote id.'),
           z.meta({ examples: ['base-usdc-tempo-usdce-relay'] }),
         ),
       provider: ProviderRef,
       quality: Quality,
-      quote: z
-        .nullable(RouteQuote)
-        .check(z.describe('Provider-derived quote data, when a live route probe succeeds.')),
+      quote: QuoteDetails,
       sourceAmount: TokenAmount,
       sourceChain: Chain.check(z.describe('Chain where the caller currently holds funds.')),
       sourceToken: Token.check(z.describe('Token the caller currently holds.')),
-      status: z
-        .enum(['available', 'thin', 'unknown', 'unavailable', 'error'])
-        .check(
-          z.describe('Provider-specific route status for the requested amount.'),
-          z.meta({ examples: ['unknown'] }),
-        ),
     }),
-    'One provider-specific funding route candidate.',
+    'One successful provider-specific funding quote.',
   )
 
-  /** Generic provider catalog entry. */
+  /** Funding quote provider catalog entry. */
   export const Provider = Schema.describe(
     z.object({
-      capabilities: z
-        .array(z.enum(['fundingRoutes']))
-        .check(
-          z.describe('Provider capabilities Tempo exposes through public APIs.'),
-          z.meta({ examples: [['fundingRoutes']] }),
-        ),
-      id: z.string().check(z.describe('Stable provider id.'), z.meta({ examples: ['relay'] })),
+      id: z
+        .literal('relay')
+        .check(z.describe('Stable provider id.'), z.meta({ examples: ['relay'] })),
       kind: z
         .string()
         .check(z.describe('Provider category.'), z.meta({ examples: ['solverNetwork'] })),
@@ -326,15 +245,15 @@ export namespace schema {
           z.meta({ examples: [false] }),
         ),
       status: z
-        .enum(['configured', 'inventoryOnly', 'planned'])
+        .enum(['configured', 'unconfigured'])
         .check(
           z.describe(
-            '`inventoryOnly` means Tempo exposes static route support but does not query live quotes yet. `planned` means the provider is listed for future support and may not return route candidates.',
+            '`configured` means live quotes are enabled for this deployment. `unconfigured` means the provider is supported but unavailable here.',
           ),
-          z.meta({ examples: ['inventoryOnly'] }),
+          z.meta({ examples: ['configured', 'unconfigured'] }),
         ),
     }),
-    'One provider in the generic provider catalog.',
+    'One funding quote provider.',
   )
 
   /** Chain inventory entry returned by the funding chains endpoint. */
@@ -345,9 +264,9 @@ export namespace schema {
     'One source chain and its known stablecoin inventory.',
   )
 
-  /** Schemas for the listFundingRoutes operation. */
-  export namespace listFundingRoutes {
-    /** Query parameters for funding route discovery. */
+  /** Schemas for the quoteFunding operation. */
+  export namespace quoteFunding {
+    /** Query parameters for live funding quotes. */
     export const Query = z
       .strictObject({
         destinationToken: z
@@ -358,26 +277,21 @@ export namespace schema {
             ),
             z.meta({ examples: ['USDC.e'] }),
           ),
-        include: z
-          .optional(z.string())
-          .check(
-            z.describe('Comma-separated response expansions. V1 accepts `quotes`.'),
-            z.meta({ examples: ['quotes'] }),
-          ),
-        limit: Schema.Limit,
         provider: z
-          .optional(z.string())
+          .optional(z.literal('relay'))
           .check(
             z.describe(
-              'Only return candidates from this provider id, such as `relay`, `bridge`, or `bungee`. Planned providers can return an empty list.',
+              'Only request a quote from this provider. The supported id is `relay`; omit it to query every configured provider.',
             ),
-            z.meta({ examples: ['relay', 'bridge'] }),
+            z.meta({ examples: ['relay'] }),
           ),
         sourceAmount: z
           .string()
           .check(
-            z.minLength(1),
-            z.describe('Source token amount. Base units by default, so 1 USDC is `1000000`.'),
+            z.regex(/^(?=.*[1-9])\d+(\.\d+)?$/),
+            z.describe(
+              'Positive source token amount. Base units by default, so 1 USDC is `1000000`.',
+            ),
             z.meta({ examples: ['1000000'] }),
           ),
         sourceAmountUnits: z
@@ -387,38 +301,30 @@ export namespace schema {
             z.meta({ examples: ['baseUnits', 'decimal'] }),
           ),
         sourceChain: z
+          .string()
+          .check(
+            z.minLength(1),
+            z.describe('Source chain alias or CAIP-2 id, such as `base` or `eip155:8453`.'),
+            z.meta({ examples: ['base', 'eip155:8453'] }),
+          ),
+        sourceToken: z
           .string()
           .check(
             z.minLength(1),
             z.describe(
-              'Source chain alias or CAIP-2 id, such as `base`, `solana`, `tron`, or `eip155:8453`.',
+              'Source token symbol, contract address, or Tempo token key. Symbol and address lookup is scoped to `sourceChain` and case-insensitive. An unknown token returns an empty list.',
             ),
-            z.meta({ examples: ['base', 'solana', 'tron'] }),
+            z.meta({ examples: ['USDC', '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913'] }),
           ),
-        sourceToken: z.string().check(
-          z.minLength(1),
-          z.describe(
-            'Source token symbol, contract address, mint, or Tempo token key. Symbol lookup is scoped to `sourceChain`; EVM identifiers are case-insensitive, while Solana and Tron identifiers must match exactly. An unknown token returns an empty list, not an error.',
-          ),
-          z.meta({
-            examples: [
-              'USDC',
-              'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
-              'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t',
-            ],
-          }),
-        ),
       })
-      .check(z.describe('Query parameters for discovering funding routes into Tempo.'))
+      .check(z.describe('Query parameters for live funding quotes into Tempo.'))
 
-    /** Non-paginated list of funding route candidates. */
+    /** Non-paginated list of successful funding quotes. */
     export const Response = Schema.describe(
       z.object({
-        data: z
-          .array(RouteCandidate)
-          .check(z.describe('Funding route candidates matching the request.')),
+        data: z.array(FundingQuote).check(z.describe('Successful live funding quotes.')),
       }),
-      'A non-paginated list of funding route candidates.',
+      'A non-paginated list of successful live funding quotes.',
     )
   }
 
@@ -429,7 +335,7 @@ export namespace schema {
       z.object({
         data: z
           .array(ChainInventory)
-          .check(z.describe('Source chains and stablecoins known to the funding route API.')),
+          .check(z.describe('Source chains and stablecoins supported by funding quotes.')),
       }),
       'A non-paginated list of source chains and stablecoin inventory.',
     )
@@ -437,118 +343,89 @@ export namespace schema {
 
   /** Schemas for the listProviders operation. */
   export namespace listProviders {
-    /** Query parameters for the generic provider catalog. */
-    export const Query = z
-      .strictObject({
-        capability: z
-          .optional(z.enum(['fundingRoutes']))
-          .check(
-            z.describe('Optional provider capability filter.'),
-            z.meta({ examples: ['fundingRoutes'] }),
-          ),
-      })
-      .check(z.describe('Query parameters for listing providers.'))
-
-    /** Non-paginated generic provider catalog. */
+    /** Non-paginated funding quote provider catalog. */
     export const Response = Schema.describe(
       z.object({
-        data: z.array(Provider).check(z.describe("Providers in Tempo's generic provider catalog.")),
+        data: z.array(Provider).check(z.describe("Providers in Tempo's funding quote catalog.")),
       }),
-      'A non-paginated list of providers.',
+      'A non-paginated list of funding quote providers.',
     )
   }
 }
 
-// Examples derive from the static inventory so they never drift from real responses.
-const fundingRouteResponseExamples = {
-  baseUsdc: {
-    description:
-      '`GET /v1/funding/routes?sourceChain=base&sourceToken=USDC&sourceAmount=1000000&provider=relay`',
-    summary: 'Base USDC',
-    value: {
-      data: FundingRoutes.listStaticRoutes({
-        limit: 10,
-        provider: 'relay',
-        sourceAmount: '1000000',
-        sourceAmountUnits: 'baseUnits',
-        sourceChain: 'base',
-        sourceToken: 'USDC',
-      }),
-    } satisfies z.output<typeof schema.listFundingRoutes.Response>,
-  },
-  solanaUsdc: {
-    description:
-      '`GET /v1/funding/routes?sourceChain=solana&sourceToken=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&sourceAmount=1000000&provider=bridge`',
-    summary: 'Solana USDC',
-    value: {
-      data: FundingRoutes.listStaticRoutes({
-        limit: 10,
-        provider: 'bridge',
-        sourceAmount: '1000000',
-        sourceAmountUnits: 'baseUnits',
-        sourceChain: 'solana',
-        sourceToken: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
-      }),
-    } satisfies z.output<typeof schema.listFundingRoutes.Response>,
-  },
-  tronUsdt: {
-    description:
-      '`GET /v1/funding/routes?sourceChain=tron&sourceToken=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t&sourceAmount=1000000&provider=bridge`',
-    summary: 'Tron USDT',
-    value: {
-      data: FundingRoutes.listStaticRoutes({
-        limit: 10,
-        provider: 'bridge',
-        sourceAmount: '1000000',
-        sourceAmountUnits: 'baseUnits',
-        sourceChain: 'tron',
-        sourceToken: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t',
-      }),
-    } satisfies z.output<typeof schema.listFundingRoutes.Response>,
-  },
-} satisfies OpenApi.responses.Options<
-  typeof schema.listFundingRoutes.Response
->['success']['examples']
+const fundingQuoteResponseExample = (() => {
+  const [candidate] = FundingQuotes.listQuoteCandidates({
+    provider: 'relay',
+    sourceAmount: '1000000',
+    sourceAmountUnits: 'baseUnits',
+    sourceChain: 'base',
+    sourceToken: 'USDC',
+  })
+  if (!candidate) throw new Error('Missing Relay funding quote example candidate')
+  return {
+    data: [
+      {
+        ...candidate,
+        quality: {
+          estimatedSeconds: 1,
+          liquiditySource: 'providerQuote',
+          sourceDetail: 'relay:quote-v2',
+          tier: 'liquid',
+        },
+        quote: {
+          inputAmount: '1000000',
+          minimumOutputAmount: '939242',
+          outputAmount: '979295',
+          outputAmountFormatted: '0.979295',
+          sampledAt: '2026-01-01T00:00:00.000Z',
+        },
+      },
+    ],
+  }
+})() satisfies z.output<typeof schema.quoteFunding.Response>
 
 const fundingChainsResponseExample = {
-  data: FundingRoutes.listChains(),
+  data: FundingQuotes.listChains(),
 } satisfies z.output<typeof schema.listFundingChains.Response>
 
 const providersResponseExample = {
-  data: FundingRoutes.listProviders(),
+  data: FundingQuotes.listProviders().map((provider) => ({
+    ...provider,
+    status: 'configured' as const,
+  })),
 } satisfies z.output<typeof schema.listProviders.Response>
 
-/** Mounts funding route discovery and generic provider inventory endpoints. */
+/** Mounts live funding quotes and their supporting inventory endpoints. */
 export function funding(options: funding.Options = {}) {
   return new Hono<App.Environment>()
     .get(
-      '/v1/funding/routes',
+      '/v1/funding/quotes',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
-      OpenApi.validate('query', schema.listFundingRoutes.Query, {
+      OpenApi.validate('query', schema.quoteFunding.Query, {
         code: 'query_invalid',
         message: 'Invalid query parameters',
       }),
       OpenApi.describeRoute({
         description:
-          'Lists provider-specific route candidates for moving a source stablecoin amount into Tempo. This endpoint is discovery-only: it does not execute a bridge, reserve liquidity, or guarantee settlement. Static inventory candidates use `status: unknown`; provider adapters may add best-effort live quote fields.',
-        operationId: 'listFundingRoutes',
+          'Returns live quotes for funding Tempo with a stablecoin. Omit `provider` to query all configured providers. This endpoint does not execute a transfer.',
+        operationId: 'quoteFunding',
         responses: OpenApi.responses({
-          errors: { 400: { codes: ['query_invalid'] } },
+          errors: {
+            400: { codes: ['query_invalid'] },
+            502: {
+              codes: ['upstream_error'],
+              description: 'Every matching quote provider failed unexpectedly.',
+            },
+          },
           success: {
-            description:
-              'Discovery-only funding route candidates for the requested source chain and token.',
-            examples: fundingRouteResponseExamples,
-            schema: schema.listFundingRoutes.Response,
+            description: 'Live funding quotes. An empty list means no provider returned a quote.',
+            example: fundingQuoteResponseExample,
+            schema: schema.quoteFunding.Response,
           },
         }),
-        summary: 'List funding routes',
+        summary: 'Get funding quotes',
         tags: ['Funding'],
       }),
-      Cache.response<App.Environment>({
-        cacheControl: Cache.policies.noStore,
-        name: 'tempo-api:funding-routes:v1',
-        key: (c) => Cache.urlKey(c, schema.listFundingRoutes.Query),
-      }),
       async (c) => {
         if (Auth.narrowAccess) return Auth.paidAccessError(c)
         if (OpenApi.narrowValidation)
@@ -559,16 +436,14 @@ export function funding(options: funding.Options = {}) {
 
         const query = c.req.valid('query')
         try {
-          const include = FundingRoutes.parseInclude(query.include)
+          c.header('Cache-Control', 'no-store')
           return c.json(
-            Response.validated(schema.listFundingRoutes.Response, {
-              data: await FundingRoutes.listRoutes({
+            Response.validated(schema.quoteFunding.Response, {
+              data: await FundingQuotes.listQuotes({
                 adapters: options.adapters,
                 adapterTimeoutMs: options.adapterTimeoutMs,
                 cache: { bypass: cacheBypass(c.req.raw) },
                 destinationToken: query.destinationToken,
-                include,
-                limit: query.limit,
                 provider: query.provider,
                 sourceAmount: query.sourceAmount,
                 sourceAmountUnits: query.sourceAmountUnits,
@@ -581,6 +456,12 @@ export function funding(options: funding.Options = {}) {
         } catch (cause) {
           const message = requestErrorMessage(cause)
           if (message) return Response.error(c, { code: 'query_invalid', message, status: 400 })
+          if (cause instanceof FundingQuotes.ProviderQuoteError)
+            return Response.error(c, {
+              code: 'upstream_error',
+              message: 'Quote providers could not complete the request.',
+              status: 502,
+            })
           throw cause
         }
       },
@@ -590,11 +471,11 @@ export function funding(options: funding.Options = {}) {
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.describeRoute({
         description:
-          'Lists source chains and stablecoins understood by the funding route API, including provider-specific ids useful when comparing provider docs. This is static inventory metadata, not a live liquidity check.',
+          'Lists the source chains and stablecoins you can use when requesting a funding quote.',
         operationId: 'listFundingChains',
         responses: OpenApi.responses({
           success: {
-            description: 'Source-chain and stablecoin inventory for funding route discovery.',
+            description: 'Supported source chains and stablecoins.',
             example: fundingChainsResponseExample,
             schema: schema.listFundingChains.Response,
           },
@@ -611,54 +492,39 @@ export function funding(options: funding.Options = {}) {
         if (Auth.narrowAccess) return Auth.paidAccessError(c)
         return c.json(
           Response.validated(schema.listFundingChains.Response, {
-            data: FundingRoutes.listChains(),
+            data: FundingQuotes.listChains(),
           }),
           200,
         )
       },
     )
     .get(
-      '/v1/providers',
+      '/v1/funding/providers',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
-      OpenApi.validate('query', schema.listProviders.Query, {
-        code: 'query_invalid',
-        message: 'Invalid query parameters',
-      }),
       OpenApi.describeRoute({
         description:
-          'Lists provider metadata, capability flags, auth requirements, and integration status across provider domains. `inventoryOnly` providers can appear in static route candidates; `planned` providers are visible for roadmap transparency and may not return candidates.',
-        operationId: 'listProviders',
+          'Lists funding quote providers and whether live quoting is configured for this deployment.',
+        operationId: 'listFundingProviders',
         responses: OpenApi.responses({
-          errors: { 400: { codes: ['query_invalid'] } },
           success: {
-            description: 'Providers known to Tempo.',
+            description: 'Funding quote providers supported by Tempo.',
             example: providersResponseExample,
             schema: schema.listProviders.Response,
           },
         }),
-        summary: 'List providers',
-        tags: ['Providers'],
+        summary: 'List funding providers',
+        tags: ['Funding'],
       }),
       Cache.response<App.Environment>({
         cacheControl: Cache.policies.stable,
-        name: 'tempo-api:providers:v1',
-        key: (c) => Cache.urlKey(c, schema.listProviders.Query),
+        name: 'tempo-api:funding-providers:v1',
+        key: (c) => c.req.url,
       }),
       (c) => {
         if (Auth.narrowAccess) return Auth.paidAccessError(c)
-        if (OpenApi.narrowValidation)
-          return OpenApi.validationError(c, {
-            code: 'query_invalid',
-            message: 'Invalid query parameters',
-          })
-
-        const query = c.req.valid('query')
         return c.json(
           Response.validated(schema.listProviders.Response, {
-            data: FundingRoutes.listProviders({
-              adapters: options.adapters,
-              capability: query.capability,
-            }),
+            data: FundingQuotes.listProviders({ adapters: options.adapters }),
           }),
           200,
         )
@@ -667,10 +533,10 @@ export function funding(options: funding.Options = {}) {
 }
 
 export declare namespace funding {
-  /** Options for funding route discovery. */
+  /** Options for live funding quotes. */
   type Options = {
-    /** Provider adapters used to enrich static inventory with live data. */
-    adapters?: FundingRoutes.ProviderAdapters | undefined
+    /** Provider adapters used to request live quotes. */
+    adapters?: FundingQuotes.ProviderAdapters | undefined
     /** Per-provider quote timeout in milliseconds. */
     adapterTimeoutMs?: number | undefined
   }
@@ -678,12 +544,11 @@ export declare namespace funding {
 
 // Maps caller-input errors to a specific 400 message; anything else rethrows.
 function requestErrorMessage(cause: unknown) {
-  if (cause instanceof FundingRoutes.InvalidAmountError) return 'Invalid `sourceAmount`.'
-  if (cause instanceof FundingRoutes.UnsupportedIncludeError) return 'Unsupported `include`.'
-  if (cause instanceof FundingRoutes.UnsupportedDestinationTokenError)
+  if (cause instanceof FundingQuotes.InvalidAmountError) return 'Invalid `sourceAmount`.'
+  if (cause instanceof FundingQuotes.UnsupportedDestinationTokenError)
     return 'Unsupported `destinationToken`.'
-  if (cause instanceof FundingRoutes.UnsupportedProviderError) return 'Unsupported `provider`.'
-  if (cause instanceof FundingRoutes.UnsupportedSourceChainError)
+  if (cause instanceof FundingQuotes.UnsupportedProviderError) return 'Unsupported `provider`.'
+  if (cause instanceof FundingQuotes.UnsupportedSourceChainError)
     return 'Unsupported `sourceChain`.'
   return undefined
 }