tapimo 0.7.0 → 0.7.2

package/src/apps/data/FundingQuoteProviders.ts

@@ -1,1043 +0,0 @@
-import * as z from 'zod/mini'
-
-import * as FundingQuotes from '../../internal/FundingQuotes.js'
-import * as Store from '../../internal/Store.js'
-
-type Fetch = typeof globalThis.fetch
-
-const defaultFetch: Fetch = (input, init) => globalThis.fetch(input, init)
-
-const defaultAcrossBaseUrl = 'https://app.across.to/api'
-const defaultRelayBaseUrl = 'https://api.relay.link'
-const defaultRhinoBaseUrl = 'https://api.rhino.fi/bridge'
-const defaultSquidBaseUrl = 'https://v2.api.squidrouter.com/v2'
-const defaultSymbiosisBaseUrl = 'https://api.symbiosis.finance/crosschain'
-// Keep one upstream slot free for deployment smoke tests and operational probes.
-const symbiosisRateLimit = 4
-const symbiosisRateLimitWindowMs = 1_000
-const providerOperations = {
-  across: 'swap/approval',
-  relay: 'quote/v2',
-  rhino: 'quote/bridge-swap/public',
-  squid: 'v2/route',
-  symbiosis: 'v2/quote',
-} as const
-
-/** Returns the stable upstream operation used by a funding quote provider. */
-export function providerOperation(provider: FundingQuotes.ProviderId) {
-  return providerOperations[provider]
-}
-
-namespace schema {
-  const IntegerString = z.string().check(z.regex(/^\d+$/))
-
-  const AcrossToken = z.object({
-    address: z.string(),
-    chainId: z.number().check(z.int(), z.nonnegative()),
-    decimals: z.number().check(z.int(), z.nonnegative()),
-  })
-
-  export const AcrossQuote = z.object({
-    amountType: z.literal('exactInput'),
-    expectedFillTime: z.number().check(z.int(), z.nonnegative()),
-    expectedOutputAmount: IntegerString,
-    inputAmount: IntegerString,
-    inputToken: AcrossToken,
-    minOutputAmount: IntegerString,
-    outputToken: AcrossToken,
-    quoteExpiryTimestamp: z.number().check(z.int(), z.nonnegative()),
-  })
-
-  export const RhinoQuote = z.object({
-    _tag: z.literal('bridge'),
-    chainIn: z.string(),
-    chainOut: z.string(),
-    estimatedDuration: z.optional(z.nullable(z.number().check(z.nonnegative()))),
-    payAmount: z.string().check(z.regex(/^\d+(\.\d+)?$/)),
-    receiveAmount: z.string().check(z.regex(/^\d+(\.\d+)?$/)),
-    token: z.string(),
-  })
-
-  const SquidToken = z.object({
-    address: z.string(),
-    chainId: z.union([z.string(), z.number().check(z.int(), z.nonnegative())]),
-    decimals: z.number().check(z.int(), z.nonnegative()),
-  })
-
-  export const SquidQuote = z.object({
-    route: z.object({
-      estimate: z.object({
-        estimatedRouteDuration: z.number().check(z.nonnegative()),
-        fromAmount: IntegerString,
-        fromToken: SquidToken,
-        toAmount: IntegerString,
-        toAmountMin: IntegerString,
-        toToken: SquidToken,
-      }),
-    }),
-  })
-
-  export const SymbiosisToken = z.object({
-    address: z.string(),
-    chainId: z.number().check(z.int(), z.nonnegative()),
-    decimals: z.number().check(z.int(), z.nonnegative()),
-  })
-
-  const SymbiosisTokenAmount = z.extend(SymbiosisToken, { amount: IntegerString })
-
-  export const SymbiosisQuote = z.object({
-    estimatedTime: z.optional(z.number().check(z.nonnegative())),
-    kind: z.union([z.literal('bridge'), z.literal('crosschain-swap'), z.literal('intent-swap')]),
-    routes: z
-      .array(
-        z.object({
-          tokens: z.array(SymbiosisToken).check(z.minLength(1)),
-        }),
-      )
-      .check(z.minLength(1)),
-    tokenAmountOut: SymbiosisTokenAmount,
-    tokenAmountOutMin: SymbiosisTokenAmount,
-    tx: z.object({ chainId: z.number().check(z.int(), z.nonnegative()) }),
-    type: z.union([z.literal('evm'), z.literal('tron')]),
-  })
-}
-
-/** Creates the live funding quote adapters configured for this deployment. */
-export function createAdapters(options: createAdapters.Options = {}) {
-  return {
-    ...(options.across ? { across: across(options.across) } : {}),
-    ...(options.relay ? { relay: relay(options.relay) } : {}),
-    ...(options.rhino ? { rhino: rhino(options.rhino) } : {}),
-    ...(options.squid ? { squid: squid(options.squid) } : {}),
-    ...(options.symbiosis ? { symbiosis: symbiosis(options.symbiosis) } : {}),
-  } satisfies FundingQuotes.ProviderAdapters
-}
-
-export declare namespace createAdapters {
-  /** Provider adapter factory options. Omit a provider to leave it unconfigured. */
-  type Options = {
-    /** Across quote adapter options. */
-    across?: across.Options | false | undefined
-    /** Relay quote adapter options. */
-    relay?: relay.Options | false | undefined
-    /** Rhino quote adapter options. */
-    rhino?: rhino.Options | false | undefined
-    /** Squid quote adapter options. */
-    squid?: squid.Options | false | undefined
-    /** Symbiosis quote adapter options. */
-    symbiosis?: symbiosis.Options | false | undefined
-  }
-}
-
-/** Resolves all-or-none Across deployment configuration. */
-export function configureAcross(options: configureAcross.Options = {}): across.Options | undefined {
-  const configured = [options.apiKey, options.integratorId, options.userAddress].filter(Boolean)
-  if (configured.length === 0) return undefined
-  if (!options.apiKey || !options.integratorId || !options.userAddress)
-    throw new ProviderConfigurationError()
-  return {
-    apiKey: options.apiKey,
-    integratorId: options.integratorId,
-    userAddress: options.userAddress,
-  }
-}
-
-export declare namespace configureAcross {
-  /** Optional deployment bindings required together to enable Across. */
-  type Options = {
-    /** Across API key binding. */
-    apiKey?: string | undefined
-    /** Across integrator id binding. */
-    integratorId?: string | undefined
-    /** Across quote-user binding. */
-    userAddress?: string | undefined
-  }
-}
-
-/** Resolves all-or-none Squid deployment configuration. */
-export function configureSquid(options: configureSquid.Options = {}): squid.Options | undefined {
-  const configured = [options.integratorId, options.userAddress].filter(Boolean)
-  if (configured.length === 0) return undefined
-  if (!options.integratorId || !options.userAddress) throw new ProviderConfigurationError()
-  return {
-    integratorId: options.integratorId,
-    userAddress: options.userAddress,
-  }
-}
-
-export declare namespace configureSquid {
-  /** Optional deployment bindings required together to enable Squid. */
-  type Options = {
-    /** Squid integrator id binding. */
-    integratorId?: string | undefined
-    /** Squid quote-user binding. */
-    userAddress?: string | undefined
-  }
-}
-
-/** Resolves Symbiosis deployment configuration. */
-export function configureSymbiosis(
-  options: configureSymbiosis.Options = {},
-): symbiosis.Options | undefined {
-  if (!options.userAddress) return undefined
-  return { userAddress: options.userAddress }
-}
-
-export declare namespace configureSymbiosis {
-  /** Optional deployment binding required to enable Symbiosis. */
-  type Options = {
-    /** Symbiosis quote-user binding. */
-    userAddress?: string | undefined
-  }
-}
-
-/** Creates an Across quote adapter backed by `/swap/approval`. */
-export function across(options: across.Options): FundingQuotes.ProviderAdapter {
-  assertAcrossConfiguration(options)
-  const baseUrl = normalizeBaseUrl(options.baseUrl ?? defaultAcrossBaseUrl)
-  const fetcher = options.fetch ?? defaultFetch
-  const now = options.now ?? (() => new Date())
-
-  return {
-    async probeQuote({ candidate }, signal) {
-      const destinationChainId = eip155ChainId(candidate.destinationChain)
-      const originChainId = providerChainId(candidate.sourceChain, 'across')
-      const url = new URL(`${baseUrl}/swap/approval`)
-      url.search = new URLSearchParams({
-        amount: candidate.sourceAmount.amount,
-        depositor: options.userAddress,
-        destinationChainId,
-        inputToken: candidate.sourceToken.address,
-        integratorId: options.integratorId,
-        originChainId,
-        outputToken: candidate.destinationToken.address,
-        recipient: options.userAddress,
-        skipOriginTxEstimation: 'true',
-        strictTradeType: 'true',
-        tradeType: 'exactInput',
-      }).toString()
-
-      try {
-        const quote = await requestJson(url, {
-          fetcher,
-          headers: { Authorization: `Bearer ${options.apiKey}` },
-          signal,
-        })
-        return formatAcrossResult(candidate, quote, now())
-      } catch (cause) {
-        const unavailable = providerUnavailable(cause, [
-          'AMOUNT_TOO_HIGH',
-          'AMOUNT_TOO_LOW',
-          'INSUFFICIENT_LIQUIDITY',
-          'NO_QUOTES',
-          'NO_ROUTE',
-          'UNSUPPORTED_ROUTE',
-        ])
-        if (!unavailable) throw cause
-        return unavailableResult({
-          detail: 'across:swap-approval',
-          message: unavailable,
-          now: now(),
-          source: 'providerQuote',
-        })
-      }
-    },
-  }
-}
-
-export declare namespace across {
-  /** Across quote adapter options. */
-  type Options = {
-    /** Across API key sent as a bearer token. */
-    apiKey: string
-    /** Override for tests or Across test environments. */
-    baseUrl?: string | undefined
-    /** Fetch implementation override for tests. */
-    fetch?: Fetch | undefined
-    /** Across integrator id sent as the required query parameter. */
-    integratorId: string
-    /** Clock override for deterministic tests. */
-    now?: (() => Date) | undefined
-    /** Probe wallet address used as the Across depositor and recipient. */
-    userAddress: string
-  }
-}
-
-/** Creates a Relay quote adapter backed by `/quote/v2`. */
-export function relay(options: relay.Options): FundingQuotes.ProviderAdapter {
-  const baseUrl = normalizeBaseUrl(options.baseUrl ?? defaultRelayBaseUrl)
-  const fetcher = options.fetch ?? defaultFetch
-  const now = options.now ?? (() => new Date())
-
-  return {
-    async probeQuote({ candidate }, signal) {
-      const originChainId = providerChainId(candidate.sourceChain, 'relay')
-      const destinationChainId = eip155ChainId(candidate.destinationChain)
-      const headers = relayHeaders(options.apiKey)
-
-      try {
-        const quote = await requestJson(new URL(`${baseUrl}/quote/v2`), {
-          body: {
-            amount: candidate.sourceAmount.amount,
-            destinationChainId: Number(destinationChainId),
-            destinationCurrency: candidate.destinationToken.address,
-            originChainId: Number(originChainId),
-            originCurrency: candidate.sourceToken.address,
-            recipient: options.recipientAddress ?? options.userAddress,
-            tradeType: 'EXACT_INPUT',
-            user: options.userAddress,
-          },
-          fetcher,
-          headers,
-          method: 'POST',
-          signal,
-        })
-        return formatRelayResult(quote, now())
-      } catch (cause) {
-        const unavailable = providerUnavailable(cause, [
-          'NO_QUOTES',
-          'NO_ROUTE',
-          'UNSUPPORTED_ROUTE',
-        ])
-        if (!unavailable) throw cause
-        return unavailableResult({
-          detail: 'relay:quote-v2',
-          message: unavailable,
-          now: now(),
-          source: 'providerQuote',
-        })
-      }
-    },
-  }
-}
-
-export declare namespace relay {
-  /** Relay quote adapter options. */
-  type Options = {
-    /** Probe wallet address required by Relay's quote API. */
-    userAddress: string
-    /** Optional recipient override; defaults to `userAddress`. */
-    recipientAddress?: string | undefined
-    /** Optional Relay API key for higher rate limits. */
-    apiKey?: string | undefined
-    /** Override for tests or Relay testnet environments. */
-    baseUrl?: string | undefined
-    /** Fetch implementation override for tests. */
-    fetch?: Fetch | undefined
-    /** Clock override for deterministic tests. */
-    now?: (() => Date) | undefined
-  }
-}
-
-/** Creates a Rhino quote adapter backed by the public bridge-and-swap quote endpoint. */
-export function rhino(options: rhino.Options = {}): FundingQuotes.ProviderAdapter {
-  const baseUrl = normalizeBaseUrl(options.baseUrl ?? defaultRhinoBaseUrl)
-  const fetcher = options.fetch ?? defaultFetch
-  const now = options.now ?? (() => new Date())
-
-  return {
-    async probeQuote({ cache, candidate }, signal) {
-      const chainIn = providerChainReference(candidate.sourceChain, 'rhino')
-      const tokenOut = rhinoToken(candidate.destinationToken)
-      const url = new URL(`${baseUrl}/quote/bridge-swap/public`)
-      url.search = new URLSearchParams({
-        amount: candidate.sourceAmount.formatted,
-        amountNative: '0',
-        chainIn,
-        chainOut: 'TEMPO',
-        mode: 'pay',
-        tokenIn: candidate.sourceToken.symbol,
-        tokenOut,
-      }).toString()
-
-      try {
-        const quote = await requestJson(url, {
-          fetcher,
-          headers: cache.bypass ? { 'cache-control': 'no-cache' } : undefined,
-          signal,
-        })
-        return formatRhinoResult(candidate, quote, { chainIn, now: now(), tokenOut })
-      } catch (cause) {
-        const unavailable = providerUnavailable(cause, ['NoRouteFoundError'])
-        if (!unavailable) throw cause
-        return unavailableResult({
-          detail: 'rhino:bridge-swap-public',
-          message: unavailable,
-          now: now(),
-          source: 'providerQuote',
-        })
-      }
-    },
-  }
-}
-
-export declare namespace rhino {
-  /** Rhino public quote adapter options. */
-  type Options = {
-    /** Override for tests or Rhino test environments. */
-    baseUrl?: string | undefined
-    /** Fetch implementation override for tests. */
-    fetch?: Fetch | undefined
-    /** Clock override for deterministic tests. */
-    now?: (() => Date) | undefined
-  }
-}
-
-/** Creates a Squid quote adapter backed by `/v2/route`. */
-export function squid(options: squid.Options): FundingQuotes.ProviderAdapter {
-  assertSquidConfiguration(options)
-  const baseUrl = normalizeBaseUrl(options.baseUrl ?? defaultSquidBaseUrl)
-  const fetcher = options.fetch ?? defaultFetch
-  const now = options.now ?? (() => new Date())
-
-  return {
-    async probeQuote({ candidate }, signal) {
-      const fromChain = eip155ChainId(candidate.sourceChain)
-      const toChain = eip155ChainId(candidate.destinationChain)
-
-      try {
-        const quote = await requestJson(new URL(`${baseUrl}/route`), {
-          body: {
-            fromAddress: options.userAddress,
-            fromAmount: candidate.sourceAmount.amount,
-            fromChain,
-            fromToken: candidate.sourceToken.address,
-            quoteOnly: true,
-            // V1 quotes use a fixed 1% tolerance; callers cannot customize execution policy.
-            slippage: 1,
-            toAddress: options.userAddress,
-            toChain,
-            toToken: candidate.destinationToken.address,
-          },
-          fetcher,
-          headers: { 'x-integrator-id': options.integratorId },
-          method: 'POST',
-          signal,
-        })
-        return formatSquidResult(candidate, quote, now())
-      } catch (cause) {
-        const unavailable =
-          providerUnavailable(cause, [
-            'NO_ROUTE',
-            'NO_ROUTE_FOUND',
-            'ROUTE_NOT_FOUND',
-            'UNSUPPORTED_ROUTE',
-          ]) ?? squidUnavailable(cause)
-        if (!unavailable) throw cause
-        return unavailableResult({
-          detail: 'squid:route-v2',
-          message: unavailable,
-          now: now(),
-          source: 'providerQuote',
-        })
-      }
-    },
-  }
-}
-
-export declare namespace squid {
-  /** Squid quote adapter options. */
-  type Options = {
-    /** Override for tests or Squid test environments. */
-    baseUrl?: string | undefined
-    /** Fetch implementation override for tests. */
-    fetch?: Fetch | undefined
-    /** Squid integrator id sent in the required request header. */
-    integratorId: string
-    /** Clock override for deterministic tests. */
-    now?: (() => Date) | undefined
-    /** Probe wallet address used as the Squid sender and recipient. */
-    userAddress: string
-  }
-}
-
-/** Creates a Symbiosis quote adapter backed by `/v2/quote`. */
-export function symbiosis(options: symbiosis.Options): FundingQuotes.ProviderAdapter {
-  assertUserAddress(options.userAddress)
-  const baseUrl = normalizeBaseUrl(options.baseUrl ?? defaultSymbiosisBaseUrl)
-  const fetcher = options.fetch ?? defaultFetch
-  const now = options.now ?? (() => new Date())
-  const rateLimitStore = options.rateLimitStore ?? Store.memory()
-
-  return {
-    async probeQuote({ candidate }, signal) {
-      const fromChainId = Number(providerChainId(candidate.sourceChain, 'symbiosis'))
-      const fromToken = symbiosisSourceToken(candidate.sourceChain, candidate.sourceToken)
-      const toChainId = Number(eip155ChainId(candidate.destinationChain))
-
-      try {
-        await consumeSymbiosisQuota(rateLimitStore, now())
-        const quote = await requestJson(new URL(`${baseUrl}/v2/quote`), {
-          body: {
-            from: options.userAddress,
-            slippage: 100,
-            to: options.userAddress,
-            tokenAmountIn: {
-              address: fromToken,
-              amount: candidate.sourceAmount.amount,
-              chainId: fromChainId,
-              decimals: candidate.sourceToken.decimals,
-              symbol: candidate.sourceToken.symbol,
-            },
-            tokenOut: {
-              address: candidate.destinationToken.address,
-              chainId: toChainId,
-              decimals: candidate.destinationToken.decimals,
-              symbol: candidate.destinationToken.symbol,
-            },
-          },
-          fetcher,
-          headers: { 'x-partner-id': 'tempo' },
-          method: 'POST',
-          signal,
-        })
-        return formatSymbiosisResult(candidate, quote, now())
-      } catch (cause) {
-        const unavailable =
-          providerUnavailable(cause, [
-            'AMOUNT_TOO_LOW',
-            'NO_ROUTE',
-            'NO_ROUTE_FOUND',
-            'ROUTE_NOT_FOUND',
-            'UNSUPPORTED_ROUTE',
-          ]) ?? symbiosisUnavailable(cause)
-        if (!unavailable) throw cause
-        return unavailableResult({
-          detail: 'symbiosis:quote-v2',
-          message: unavailable,
-          now: now(),
-          source: 'providerQuote',
-        })
-      }
-    },
-  }
-}
-
-export declare namespace symbiosis {
-  /** Symbiosis quote adapter options. */
-  type Options = {
-    /** Override for tests or Symbiosis test environments. */
-    baseUrl?: string | undefined
-    /** Fetch implementation override for tests. */
-    fetch?: Fetch | undefined
-    /** Clock override for deterministic tests. */
-    now?: (() => Date) | undefined
-    /** Atomic store used to enforce the provider-wide quote quota. */
-    rateLimitStore?: Store.Store | undefined
-    /** Probe wallet address used as the Symbiosis sender and recipient. */
-    userAddress: string
-  }
-}
-
-/** Returns bounded provider failure details suitable for structured request logs. */
-export function providerFailure(options: providerFailure.Options): providerFailure.Result {
-  const operation = providerOperation(options.provider)
-  if (
-    options.cause instanceof FundingQuotes.ProviderAdapterTimeoutError ||
-    (options.cause instanceof DOMException && options.cause.name === 'AbortError')
-  )
-    return { failure: 'timeout', id: options.provider, operation }
-  if (options.cause instanceof ProviderResponseError) {
-    const code = providerErrorCode(options.cause.body)
-    return {
-      ...(code === undefined ? {} : { code }),
-      failure: 'http',
-      id: options.provider,
-      operation,
-      status: options.cause.status,
-    }
-  }
-  if (options.cause instanceof ProviderPayloadError)
-    return { failure: 'payload', id: options.provider, operation }
-  if (options.cause instanceof ProviderRateLimitError)
-    return { failure: 'rate_limit', id: options.provider, operation }
-  if (options.cause instanceof TypeError)
-    return { failure: 'network', id: options.provider, operation }
-  return { failure: 'unknown', id: options.provider, operation }
-}
-
-export declare namespace providerFailure {
-  /** Inputs used to classify a provider failure. */
-  type Options = FundingQuotes.ProviderFailure
-
-  /** Bounded provider failure fields. */
-  type Result = {
-    /** 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'
-    /** Provider identifier. */
-    id: FundingQuotes.ProviderId
-    /** Provider operation identifier. */
-    operation: (typeof providerOperations)[FundingQuotes.ProviderId]
-    /** Upstream HTTP status, when a response was received. */
-    status?: number | undefined
-  }
-}
-
-function formatAcrossResult(
-  candidate: FundingQuotes.QuoteCandidate,
-  quote: unknown,
-  now: Date,
-): FundingQuotes.QuoteProbeResult {
-  const parsed = schema.AcrossQuote.safeParse(quote)
-  if (!parsed.success) throw new ProviderPayloadError()
-  const response = parsed.data
-  const expiresAt = new Date(response.quoteExpiryTimestamp * 1_000)
-  if (
-    response.inputAmount !== candidate.sourceAmount.amount ||
-    !matchesToken(response.inputToken, candidate.sourceChain, candidate.sourceToken) ||
-    !matchesToken(response.outputToken, candidate.destinationChain, candidate.destinationToken) ||
-    BigInt(response.expectedOutputAmount) <= 0n ||
-    BigInt(response.minOutputAmount) <= 0n ||
-    BigInt(response.minOutputAmount) > BigInt(response.expectedOutputAmount) ||
-    Number.isNaN(expiresAt.getTime()) ||
-    response.quoteExpiryTimestamp * 1_000 <= now.getTime()
-  )
-    throw new ProviderPayloadError()
-
-  return {
-    expiresAt: expiresAt.toISOString(),
-    minimumOutputAmount: response.minOutputAmount,
-    outputAmount: response.expectedOutputAmount,
-    quality: {
-      estimatedSeconds: response.expectedFillTime,
-      liquiditySource: 'providerQuote',
-      sourceDetail: 'across:swap-approval',
-      tier: 'liquid',
-    },
-    sampledAt: now.toISOString(),
-    status: 'available',
-  }
-}
-
-function formatRelayResult(quote: unknown, now: Date): FundingQuotes.QuoteProbeResult {
-  const details = record(record(quote)['details'])
-  const currencyOut = record(details['currencyOut'])
-  const outputAmount = decimalString(currencyOut['amount'])
-  const status = outputAmount
-    ? { status: 'available' as const, tier: 'liquid' as const }
-    : { status: 'unknown' as const, tier: 'unknown' as const }
-
-  return {
-    minimumOutputAmount: decimalString(currencyOut['minimumAmount']),
-    outputAmount,
-    quality: {
-      estimatedSeconds: nonnegativeInteger(details['timeEstimate']),
-      liquiditySource: 'providerQuote',
-      sourceDetail: 'relay:quote-v2',
-      tier: status.tier,
-    },
-    sampledAt: now.toISOString(),
-    status: status.status,
-  }
-}
-
-function formatRhinoResult(
-  candidate: FundingQuotes.QuoteCandidate,
-  quote: unknown,
-  options: { chainIn: string; now: Date; tokenOut: string },
-): FundingQuotes.QuoteProbeResult {
-  const parsed = schema.RhinoQuote.safeParse(quote)
-  if (!parsed.success) throw new ProviderPayloadError()
-  const response = parsed.data
-  const inputAmount = baseUnitsFromDecimal(response.payAmount, candidate.sourceToken.decimals)
-  const outputAmount = baseUnitsFromDecimal(
-    response.receiveAmount,
-    candidate.destinationToken.decimals,
-  )
-  if (
-    response.chainIn !== options.chainIn ||
-    response.chainOut !== 'TEMPO' ||
-    response.token !== options.tokenOut ||
-    inputAmount !== candidate.sourceAmount.amount ||
-    outputAmount === undefined ||
-    BigInt(outputAmount) <= 0n
-  )
-    throw new ProviderPayloadError()
-
-  return {
-    outputAmount,
-    quality: {
-      ...(response.estimatedDuration === undefined || response.estimatedDuration === null
-        ? {}
-        : { estimatedSeconds: Math.ceil(response.estimatedDuration / 1_000) }),
-      liquiditySource: 'providerQuote',
-      sourceDetail: 'rhino:bridge-swap-public',
-      tier: 'liquid',
-    },
-    sampledAt: options.now.toISOString(),
-    status: 'available',
-  }
-}
-
-function formatSquidResult(
-  candidate: FundingQuotes.QuoteCandidate,
-  quote: unknown,
-  now: Date,
-): FundingQuotes.QuoteProbeResult {
-  const parsed = schema.SquidQuote.safeParse(quote)
-  if (!parsed.success) throw new ProviderPayloadError()
-  const response = parsed.data.route.estimate
-  if (
-    response.fromAmount !== candidate.sourceAmount.amount ||
-    !matchesSquidToken(response.fromToken, candidate.sourceChain, candidate.sourceToken) ||
-    !matchesSquidToken(response.toToken, candidate.destinationChain, candidate.destinationToken) ||
-    BigInt(response.toAmount) <= 0n ||
-    BigInt(response.toAmountMin) <= 0n ||
-    BigInt(response.toAmountMin) > BigInt(response.toAmount)
-  )
-    throw new ProviderPayloadError()
-
-  return {
-    minimumOutputAmount: response.toAmountMin,
-    outputAmount: response.toAmount,
-    quality: {
-      estimatedSeconds: Math.ceil(response.estimatedRouteDuration),
-      liquiditySource: 'providerQuote',
-      sourceDetail: 'squid:route-v2',
-      tier: 'liquid',
-    },
-    sampledAt: now.toISOString(),
-    status: 'available',
-  }
-}
-
-function formatSymbiosisResult(
-  candidate: FundingQuotes.QuoteCandidate,
-  quote: unknown,
-  now: Date,
-): FundingQuotes.QuoteProbeResult {
-  const parsed = schema.SymbiosisQuote.safeParse(quote)
-  if (!parsed.success) throw new ProviderPayloadError()
-  const response = parsed.data
-  const sourceChainId = Number(providerChainId(candidate.sourceChain, 'symbiosis'))
-  const sourceToken = symbiosisSourceToken(candidate.sourceChain, candidate.sourceToken)
-  const firstToken = response.routes[0]!.tokens[0]!
-  const lastRoute = response.routes[response.routes.length - 1]!
-  const lastToken = lastRoute.tokens[lastRoute.tokens.length - 1]!
-  if (
-    response.tx.chainId !== sourceChainId ||
-    response.type !== candidate.sourceChain.kind ||
-    !matchesSymbiosisToken(firstToken, {
-      address: sourceToken,
-      chainId: sourceChainId,
-      decimals: candidate.sourceToken.decimals,
-    }) ||
-    !matchesSymbiosisToken(lastToken, {
-      address: candidate.destinationToken.address,
-      chainId: Number(eip155ChainId(candidate.destinationChain)),
-      decimals: candidate.destinationToken.decimals,
-    }) ||
-    !matchesSymbiosisToken(response.tokenAmountOut, {
-      address: candidate.destinationToken.address,
-      chainId: Number(eip155ChainId(candidate.destinationChain)),
-      decimals: candidate.destinationToken.decimals,
-    }) ||
-    !matchesSymbiosisToken(response.tokenAmountOutMin, {
-      address: candidate.destinationToken.address,
-      chainId: Number(eip155ChainId(candidate.destinationChain)),
-      decimals: candidate.destinationToken.decimals,
-    }) ||
-    BigInt(response.tokenAmountOut.amount) <= 0n ||
-    BigInt(response.tokenAmountOutMin.amount) <= 0n ||
-    BigInt(response.tokenAmountOutMin.amount) > BigInt(response.tokenAmountOut.amount)
-  )
-    throw new ProviderPayloadError()
-
-  return {
-    minimumOutputAmount: response.tokenAmountOutMin.amount,
-    outputAmount: response.tokenAmountOut.amount,
-    quality: {
-      ...(response.estimatedTime === undefined
-        ? {}
-        : { estimatedSeconds: Math.ceil(response.estimatedTime) }),
-      liquiditySource: 'providerQuote',
-      sourceDetail: 'symbiosis:quote-v2',
-      tier: 'liquid',
-    },
-    sampledAt: now.toISOString(),
-    status: 'available',
-  }
-}
-
-function unavailableResult(options: {
-  detail: string
-  message: string
-  now: Date
-  source: string
-}): FundingQuotes.QuoteProbeResult {
-  return {
-    quality: {
-      liquiditySource: options.source,
-      sourceDetail: `${options.detail}:${options.message}`,
-      tier: 'unavailable',
-    },
-    sampledAt: options.now.toISOString(),
-    status: 'unavailable',
-  }
-}
-
-async function requestJson(
-  url: URL,
-  options: {
-    body?: unknown
-    fetcher: Fetch
-    headers?: Record<string, string> | undefined
-    method?: string | undefined
-    signal: AbortSignal
-  },
-) {
-  const headers = { accept: 'application/json', ...options.headers }
-  const init: RequestInit = {
-    headers:
-      options.body === undefined ? headers : { ...headers, 'content-type': 'application/json' },
-    method: options.method ?? 'GET',
-    signal: options.signal,
-  }
-  if (options.body !== undefined) init.body = JSON.stringify(options.body)
-  const response = await options.fetcher(url, init)
-  const text = await response.text()
-  const body = parseJson(text)
-  if (!response.ok) throw new ProviderResponseError(response.status, body)
-  return body
-}
-
-function relayHeaders(apiKey: string | undefined): Record<string, string> | undefined {
-  return apiKey ? { 'x-api-key': apiKey } : undefined
-}
-
-function providerUnavailable(cause: unknown, codes: readonly string[]) {
-  if (!(cause instanceof ProviderResponseError) || cause.status < 400 || cause.status >= 500)
-    return undefined
-  const code = providerErrorCode(cause.body)
-  if (code && codes.includes(code)) return code
-  return undefined
-}
-
-function providerErrorCode(input: unknown) {
-  const body = record(input)
-  const error = record(body['error'])
-  const code =
-    stringValue(body['_tag']) ??
-    stringValue(body['code']) ??
-    stringValue(body['errorCode']) ??
-    stringValue(body['errorType']) ??
-    stringValue(body['type']) ??
-    stringValue(error['code']) ??
-    stringValue(error['type'])
-  return code && /^[A-Za-z0-9_.:-]{1,64}$/.test(code) ? code : undefined
-}
-
-function squidUnavailable(cause: unknown) {
-  if (!(cause instanceof ProviderResponseError) || cause.status !== 400) return undefined
-  const body = record(cause.body)
-  if (
-    body['type'] === 'BAD_REQUEST' &&
-    body['message'] === 'Please increase the swap amount and try again.'
-  )
-    return 'AMOUNT_TOO_LOW'
-  return undefined
-}
-
-function symbiosisUnavailable(cause: unknown) {
-  if (!(cause instanceof ProviderResponseError) || cause.status !== 400) return undefined
-  const body = record(cause.body)
-  if (body['message'] === 'Amount is too low to cover fees') return 'AMOUNT_TOO_LOW'
-  return undefined
-}
-
-async function consumeSymbiosisQuota(store: Store.Store, now: Date) {
-  const time = now.getTime()
-  const bucket = Math.floor(time / symbiosisRateLimitWindowMs)
-  const count = await Store.increment(store, `funding:symbiosis:quote:${bucket}`, {
-    ttl: symbiosisRateLimitWindowMs * 2,
-  })
-  if (count > symbiosisRateLimit) throw new ProviderRateLimitError()
-}
-
-function providerChainId(
-  quoteChain: FundingQuotes.QuoteCandidate['sourceChain'],
-  provider: string,
-) {
-  const providerIds = quoteChain.providerIds as Record<string, string> | undefined
-  const id = providerIds?.[provider]
-  if (id && /^\d+$/.test(id)) return id
-  return eip155ChainId(quoteChain)
-}
-
-function providerChainReference(
-  quoteChain: FundingQuotes.QuoteCandidate['sourceChain'],
-  provider: string,
-) {
-  const providerIds = quoteChain.providerIds as Record<string, string> | undefined
-  const id = providerIds?.[provider]
-  if (!id) throw new UnsupportedProviderChainError()
-  return id
-}
-
-function rhinoToken(token: FundingQuotes.TokenRef) {
-  const tokens: Record<string, string> = {
-    '0x20c00000000000000000000014f22ca97301eb73': 'USDT',
-    '0x20c000000000000000000000b9537d11c60e8b50': 'USDC',
-  }
-  const id = tokens[token.address.toLowerCase()]
-  if (!id) throw new UnsupportedProviderTokenError()
-  return id
-}
-
-function symbiosisSourceToken(chain: FundingQuotes.ChainRef, token: FundingQuotes.TokenRef) {
-  if (chain.kind !== 'tron') return token.address
-  const tokens: Record<string, string> = {
-    TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t: '0xa614f803b6fd780986a42c78ec9c7f77e6ded13c',
-  }
-  const id = tokens[token.address]
-  if (!id) throw new UnsupportedProviderTokenError()
-  return id
-}
-
-function matchesToken(
-  token: z.output<typeof schema.AcrossQuote>['inputToken'],
-  chain: FundingQuotes.ChainRef,
-  expected: FundingQuotes.TokenRef,
-) {
-  return (
-    token.address.toLowerCase() === expected.address.toLowerCase() &&
-    token.chainId === Number(eip155ChainId(chain)) &&
-    token.decimals === expected.decimals
-  )
-}
-
-function matchesSquidToken(
-  token: z.output<typeof schema.SquidQuote>['route']['estimate']['fromToken'],
-  chain: FundingQuotes.ChainRef,
-  expected: FundingQuotes.TokenRef,
-) {
-  return (
-    token.address.toLowerCase() === expected.address.toLowerCase() &&
-    String(token.chainId) === eip155ChainId(chain) &&
-    token.decimals === expected.decimals
-  )
-}
-
-function matchesSymbiosisToken(
-  token: z.output<typeof schema.SymbiosisToken>,
-  options: matchesSymbiosisToken.Options,
-) {
-  return (
-    token.address.toLowerCase() === options.address.toLowerCase() &&
-    token.chainId === options.chainId &&
-    token.decimals === options.decimals
-  )
-}
-
-declare namespace matchesSymbiosisToken {
-  /** Expected provider token identity. */
-  type Options = {
-    /** Provider-specific token address. */
-    address: string
-    /** Provider-specific chain id. */
-    chainId: number
-    /** Token decimal precision. */
-    decimals: number
-  }
-}
-
-function eip155ChainId(chain: { id: string; kind: string }) {
-  if (chain.kind !== 'evm') throw new UnsupportedProviderChainError()
-  const match = /^eip155:(\d+)$/.exec(chain.id)
-  if (!match?.[1]) throw new UnsupportedProviderChainError()
-  return match[1]
-}
-
-function normalizeBaseUrl(input: string) {
-  return input.replace(/\/+$/, '')
-}
-
-function parseJson(input: string) {
-  if (!input) return null
-  try {
-    return JSON.parse(input) as unknown
-  } catch {
-    return input
-  }
-}
-
-function record(input: unknown): Record<string, unknown> {
-  return input && typeof input === 'object' && !Array.isArray(input)
-    ? (input as Record<string, unknown>)
-    : {}
-}
-
-function stringValue(input: unknown) {
-  return typeof input === 'string' && input.length > 0 ? input : undefined
-}
-
-function decimalString(input: unknown) {
-  if (typeof input === 'string' && /^\d+(\.\d+)?$/.test(input)) return input
-  if (typeof input === 'number' && Number.isFinite(input) && input >= 0) return String(input)
-  return undefined
-}
-
-function nonnegativeInteger(input: unknown) {
-  if (typeof input === 'number' && Number.isSafeInteger(input) && input >= 0) return input
-  if (typeof input === 'string' && /^\d+$/.test(input)) return Number(input)
-  return undefined
-}
-
-function baseUnitsFromDecimal(value: string, decimals: number) {
-  if (!/^\d+(\.\d+)?$/.test(value)) return undefined
-  const [whole, fraction = ''] = value.split('.')
-  const significantFraction = fraction.replace(/0+$/, '')
-  if (significantFraction.length > decimals) return undefined
-  return BigInt(`${whole}${significantFraction.padEnd(decimals, '0')}`).toString()
-}
-
-function assertAcrossConfiguration(options: across.Options) {
-  if (
-    options.apiKey.length === 0 ||
-    !/^0x[\da-fA-F]{4}$/.test(options.integratorId) ||
-    !/^0x[\da-fA-F]{40}$/.test(options.userAddress)
-  )
-    throw new ProviderConfigurationError()
-}
-
-function assertSquidConfiguration(options: squid.Options) {
-  if (options.integratorId.length === 0) throw new ProviderConfigurationError()
-  assertUserAddress(options.userAddress)
-}
-
-function assertUserAddress(userAddress: string) {
-  if (!/^0x[\da-fA-F]{40}$/.test(userAddress)) throw new ProviderConfigurationError()
-}
-
-class ProviderConfigurationError extends Error {
-  override name = 'FundingQuoteProviders.ProviderConfigurationError'
-}
-
-class ProviderPayloadError extends Error {
-  override name = 'FundingQuoteProviders.ProviderPayloadError'
-}
-
-class ProviderRateLimitError extends Error {
-  override name = 'FundingQuoteProviders.ProviderRateLimitError'
-}
-
-class ProviderResponseError extends Error {
-  override name = 'FundingQuoteProviders.ProviderResponseError'
-
-  constructor(
-    readonly status: number,
-    readonly body: unknown,
-  ) {
-    super(`Provider request failed with status ${status}`)
-  }
-}
-
-class UnsupportedProviderChainError extends Error {
-  override name = 'FundingQuoteProviders.UnsupportedProviderChainError'
-}
-
-class UnsupportedProviderTokenError extends Error {
-  override name = 'FundingQuoteProviders.UnsupportedProviderTokenError'
-}