tapimo 0.5.3 → 0.7.0

package/src/internal/FundingQuotes.ts

@@ -1,3 +1,5 @@
+import * as Value from './Value.js'
+
 /** Tempo mainnet as a CAIP-2 chain reference. */
 const destinationChain = {
   addressFormat: 'evm',
@@ -20,12 +22,14 @@ const sourceChains = [
     providerIds: {
       across: '1',
       relay: '1',
+      symbiosis: '1',
     },
     slug: 'ethereum',
     tokens: [
       {
         address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
         coingeckoId: 'usd-coin',
+        currency: 'USD',
         decimals: 6,
         name: 'USD Coin',
         standard: 'ERC-20',
@@ -34,6 +38,7 @@ const sourceChains = [
       {
         address: '0xdac17f958d2ee523a2206206994597c13d831ec7',
         coingeckoId: 'tether',
+        currency: 'USD',
         decimals: 6,
         name: 'Tether USD',
         standard: 'ERC-20',
@@ -42,6 +47,7 @@ const sourceChains = [
       {
         address: '0x6c3ea9036406852006290770bedfcaba0e23a0e8',
         coingeckoId: 'paypal-usd',
+        currency: 'USD',
         decimals: 6,
         name: 'PayPal USD',
         standard: 'ERC-20',
@@ -50,6 +56,7 @@ const sourceChains = [
       {
         address: '0x1abaea1f7c830bd89acc67ec4af516284b1bc33c',
         coingeckoId: 'euro-coin',
+        currency: 'EUR',
         decimals: 6,
         name: 'Euro Coin',
         standard: 'ERC-20',
@@ -58,6 +65,7 @@ const sourceChains = [
       {
         address: '0x6b175474e89094c44da98b954eedeac495271d0f',
         coingeckoId: 'dai',
+        currency: 'USD',
         decimals: 18,
         name: 'Dai Stablecoin',
         standard: 'ERC-20',
@@ -75,12 +83,14 @@ const sourceChains = [
       across: '8453',
       relay: '8453',
       rhino: 'BASE',
+      symbiosis: '8453',
     },
     slug: 'base',
     tokens: [
       {
         address: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913',
         coingeckoId: 'usd-coin',
+        currency: 'USD',
         decimals: 6,
         name: 'USD Coin',
         standard: 'ERC-20',
@@ -89,6 +99,7 @@ const sourceChains = [
       {
         address: '0xfde4c96c8593536e31f229ea8f37b2ada2699bb2',
         coingeckoId: 'tether',
+        currency: 'USD',
         decimals: 6,
         name: 'Tether USD',
         standard: 'ERC-20',
@@ -97,6 +108,7 @@ const sourceChains = [
       {
         address: '0x60a3e35cc302bfa44cb288bc5a4f316fdb1adb42',
         coingeckoId: 'euro-coin',
+        currency: 'EUR',
         decimals: 6,
         name: 'Euro Coin',
         standard: 'ERC-20',
@@ -113,12 +125,14 @@ const sourceChains = [
     providerIds: {
       across: '56',
       relay: '56',
+      symbiosis: '56',
     },
     slug: 'bnb',
     tokens: [
       {
         address: '0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d',
         coingeckoId: 'usd-coin',
+        currency: 'USD',
         decimals: 18,
         name: 'Binance-Peg USD Coin',
         standard: 'BEP-20',
@@ -127,6 +141,7 @@ const sourceChains = [
       {
         address: '0x55d398326f99059ff775485246999027b3197955',
         coingeckoId: 'tether',
+        currency: 'USD',
         decimals: 18,
         name: 'Tether USD',
         standard: 'BEP-20',
@@ -148,6 +163,7 @@ const sourceChains = [
       {
         address: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
         coingeckoId: 'usd-coin',
+        currency: 'USD',
         decimals: 6,
         name: 'USD Coin',
         standard: 'SPL',
@@ -163,12 +179,14 @@ const sourceChains = [
     name: 'Tron',
     providerIds: {
       rhino: 'TRON',
+      symbiosis: '728126428',
     },
     slug: 'tron',
     tokens: [
       {
         address: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t',
         coingeckoId: 'tether',
+        currency: 'USD',
         decimals: 6,
         name: 'Tether USD',
         standard: 'TRC-20',
@@ -182,6 +200,7 @@ const sourceChains = [
 const destinationTokens = [
   {
     address: '0x20c0000000000000000000000000000000000000',
+    currency: 'USD',
     decimals: 6,
     name: 'pathUSD',
     slug: 'pathusd',
@@ -190,6 +209,7 @@ const destinationTokens = [
   },
   {
     address: '0x20c000000000000000000000b9537d11c60e8b50',
+    currency: 'USD',
     decimals: 6,
     name: 'Bridged USDC (Stargate)',
     slug: 'usdce',
@@ -198,6 +218,7 @@ const destinationTokens = [
   },
   {
     address: '0x20c0000000000000000000001621e21f71cf12fb',
+    currency: 'EUR',
     decimals: 6,
     name: 'Bridged EURC',
     slug: 'eurce',
@@ -206,6 +227,7 @@ const destinationTokens = [
   },
   {
     address: '0x20c00000000000000000000014f22ca97301eb73',
+    currency: 'USD',
     decimals: 6,
     name: 'USDT0',
     slug: 'usdt0',
@@ -214,6 +236,7 @@ const destinationTokens = [
   },
   {
     address: '0x20c0000000000000000000003554d28269e0f3c2',
+    currency: 'USD',
     decimals: 6,
     name: 'frxUSD',
     slug: 'frxusd',
@@ -252,6 +275,13 @@ const providers = [
     requiresApiKey: true,
     status: 'unconfigured',
   },
+  {
+    id: 'symbiosis',
+    kind: 'crossChainDex',
+    name: 'Symbiosis',
+    requiresApiKey: false,
+    status: 'unconfigured',
+  },
 ] as const
 
 type TokenInput = (typeof sourceChains)[number]['tokens'][number]
@@ -335,8 +365,6 @@ export type QuoteProbeResult = {
   minimumOutputAmount?: string | undefined
   /** Expected destination amount in base units. */
   outputAmount?: string | undefined
-  /** Expected destination amount rendered with destination token decimals. */
-  outputAmountFormatted?: string | undefined
   /** Timestamp for the live quote probe. */
   sampledAt: string
   /** Provider-specific quote status for the requested amount. */
@@ -363,6 +391,27 @@ export type ProviderAdapter = {
 /** Provider adapter registry, keyed by provider id. */
 export type ProviderAdapters = Partial<Record<ProviderId, ProviderAdapter>>
 
+/** One configured provider attempt made while resolving a funding quote request. */
+export type ProviderAttempt =
+  | {
+      /** Wall-clock duration of the provider attempt in milliseconds. */
+      durationMs: number
+      /** Successful or expected-unavailable provider outcome. */
+      outcome: 'available' | 'thin' | 'unavailable'
+      /** Provider that handled the quote candidate. */
+      provider: ProviderId
+    }
+  | {
+      /** Error thrown by the provider boundary. */
+      cause: unknown
+      /** Wall-clock duration of the provider attempt in milliseconds. */
+      durationMs: number
+      /** Failed provider outcome. */
+      outcome: 'failed'
+      /** Provider that handled the quote candidate. */
+      provider: ProviderId
+    }
+
 /** A provider adapter failure retained for bounded request diagnostics. */
 export type ProviderFailure = {
   /** Error thrown by the provider boundary. */
@@ -377,8 +426,10 @@ const inventory: readonly InventoryEntry[] = [
   { destinationToken: 'usdce', provider: 'relay', sourceChains: ['ethereum', 'base', 'bnb'], sourceTokens: ['USDC', 'USDT'] }, // prettier-ignore
   { destinationToken: 'usdce', provider: 'rhino', sourceChains: ['base', 'solana'], sourceTokens: ['USDC'] }, // prettier-ignore
   { destinationToken: 'usdce', provider: 'squid', sourceChains: ['ethereum', 'base', 'bnb'], sourceTokens: ['USDC'] }, // prettier-ignore
+  { destinationToken: 'usdce', provider: 'symbiosis', sourceChains: ['ethereum', 'base', 'bnb'], sourceTokens: ['USDC'] }, // prettier-ignore
   { destinationToken: 'usdt0', provider: 'rhino', sourceChains: ['tron'], sourceTokens: ['USDT'] }, // prettier-ignore
   { destinationToken: 'usdt0', provider: 'squid', sourceChains: ['ethereum', 'base', 'bnb'], sourceTokens: ['USDT'] }, // prettier-ignore
+  { destinationToken: 'usdt0', provider: 'symbiosis', sourceChains: ['ethereum', 'base', 'bnb', 'tron'], sourceTokens: ['USDT'] }, // prettier-ignore
 ]
 
 type InventoryEntry = {
@@ -428,30 +479,61 @@ export declare namespace listProviders {
 
 /** Returns successful live funding quotes from configured providers. */
 export async function listQuotes(options: listQuotes.Options) {
-  const candidates = listQuoteCandidates(options)
+  const adapters = options.adapters ?? {}
+  const candidates = listQuoteCandidates(options).flatMap((candidate) => {
+    const adapter = adapters[candidate.provider.id as ProviderId]
+    return adapter ? [{ adapter, candidate }] : []
+  })
+  const attempts = new Map<number, ProviderAttempt>()
   const results = await Promise.allSettled(
-    candidates.map((candidate) =>
-      quoteCandidate(candidate, {
-        adapters: options.adapters ?? {},
-        cache: options.cache ?? { bypass: false },
-        request: {
-          destinationToken: options.destinationToken,
-          provider: options.provider,
-          sourceAmount: options.sourceAmount,
-          sourceAmountUnits: options.sourceAmountUnits,
-          sourceChain: options.sourceChain,
-          sourceToken: options.sourceToken,
-        },
-        timeoutMs: options.adapterTimeoutMs ?? defaultAdapterTimeoutMs,
-      }),
-    ),
+    candidates.map(async ({ adapter, candidate }, index) => {
+      const start = performance.now()
+      try {
+        const result = await quoteCandidate(candidate, {
+          adapter,
+          cache: options.cache ?? { bypass: false },
+          request: {
+            destinationToken: options.destinationToken,
+            provider: options.provider,
+            sourceAmount: options.sourceAmount,
+            sourceAmountUnits: options.sourceAmountUnits,
+            sourceChain: options.sourceChain,
+            sourceToken: options.sourceToken,
+          },
+          timeoutMs: options.adapterTimeoutMs ?? defaultAdapterTimeoutMs,
+        })
+        attempts.set(index, {
+          durationMs: performance.now() - start,
+          outcome: result.outcome,
+          provider: candidate.provider.id,
+        })
+        return 'quote' in result ? result.quote : undefined
+      } catch (cause) {
+        attempts.set(index, {
+          cause,
+          durationMs: performance.now() - start,
+          outcome: 'failed',
+          provider: candidate.provider.id,
+        })
+        throw cause
+      }
+    }),
   )
+  for (const index of candidates.keys()) {
+    const attempt = attempts.get(index)
+    if (!attempt) continue
+    try {
+      options.onAttempt?.(attempt)
+    } catch {
+      // Observability hooks never alter funding quote behavior.
+    }
+  }
   const quotes = results.flatMap((result) =>
     result.status === 'fulfilled' && result.value ? [result.value] : [],
   )
   const failures = results.flatMap((result, index) =>
     result.status === 'rejected'
-      ? [{ cause: result.reason, provider: candidates[index]!.provider.id }]
+      ? [{ cause: result.reason, provider: candidates[index]!.candidate.provider.id }]
       : [],
   )
   if (quotes.length === 0 && failures.length > 0) throw new ProviderQuoteError(failures)
@@ -519,6 +601,8 @@ export declare namespace listQuotes {
     adapterTimeoutMs?: number | undefined
     /** Cache policy for provider-side discovery and quote lookups. */
     cache?: CachePolicy | undefined
+    /** Receives one bounded observation for every configured provider attempt. */
+    onAttempt?: ((attempt: ProviderAttempt) => void) | undefined
   }
 }
 
@@ -544,18 +628,15 @@ function decimalFromBaseUnits(baseUnits: string, decimals: number) {
 async function quoteCandidate(
   candidate: QuoteCandidate,
   options: {
-    adapters: ProviderAdapters
+    adapter: ProviderAdapter
     cache: CachePolicy
     request: QuoteRequest
     timeoutMs: number
   },
 ) {
-  const adapter = options.adapters[candidate.provider.id as ProviderId]
-  if (!adapter) return undefined
-
   const quote = await runWithTimeout(
     (signal) =>
-      adapter.probeQuote(
+      options.adapter.probeQuote(
         {
           cache: options.cache,
           destinationChain: candidate.destinationChain,
@@ -570,18 +651,21 @@ async function quoteCandidate(
       ),
     options.timeoutMs,
   )
-  if (quote.status === 'unavailable') return undefined
+  if (quote.status === 'unavailable') return { outcome: quote.status }
   if (
     (quote.status !== 'available' && quote.status !== 'thin') ||
     quote.outputAmount === undefined ||
     quote.outputAmount === null
   )
     throw new InvalidProviderQuoteError()
-  return formatFundingQuote(candidate, {
-    ...quote,
-    outputAmount: quote.outputAmount,
-    status: quote.status,
-  })
+  return {
+    outcome: quote.status,
+    quote: formatFundingQuote(candidate, {
+      ...quote,
+      outputAmount: quote.outputAmount,
+      status: quote.status,
+    }),
+  }
 }
 
 function formatChain(chain: SourceChainInput) {
@@ -592,6 +676,7 @@ function formatChain(chain: SourceChainInput) {
 function formatDestinationToken(token: DestinationTokenInput) {
   return {
     address: token.address,
+    currency: token.currency,
     decimals: token.decimals,
     metadata: {},
     name: token.name,
@@ -639,6 +724,7 @@ function formatQuoteCandidate(options: {
 function formatSourceToken(chain: SourceChainInput, token: TokenInput) {
   return {
     address: token.address,
+    currency: token.currency,
     decimals: token.decimals,
     metadata: { coingeckoId: token.coingeckoId },
     name: token.name,
@@ -674,7 +760,24 @@ type SuccessfulQuoteProbe = QuoteProbeResult & {
 
 function formatFundingQuote(candidate: QuoteCandidate, quote: SuccessfulQuoteProbe) {
   return {
-    ...candidate,
+    destinationAmount: Value.tokenAmount({
+      baseUnits: quote.outputAmount,
+      currency: candidate.destinationToken.currency,
+      decimals: candidate.destinationToken.decimals,
+    }),
+    ...(quote.minimumOutputAmount !== undefined
+      ? {
+          destinationAmountMin: Value.tokenAmount({
+            baseUnits: quote.minimumOutputAmount,
+            currency: candidate.destinationToken.currency,
+            decimals: candidate.destinationToken.decimals,
+          }),
+        }
+      : {}),
+    destinationChain: candidate.destinationChain,
+    destinationToken: candidate.destinationToken,
+    id: candidate.id,
+    provider: candidate.provider,
     quality: {
       ...(quote.quality?.estimatedSeconds !== undefined
         ? { estimatedSeconds: quote.quality.estimatedSeconds }
@@ -687,16 +790,15 @@ function formatFundingQuote(candidate: QuoteCandidate, quote: SuccessfulQuotePro
     },
     quote: {
       ...(quote.expiresAt !== undefined ? { expiresAt: quote.expiresAt } : {}),
-      inputAmount: candidate.sourceAmount.amount,
-      ...(quote.minimumOutputAmount !== undefined
-        ? { minimumOutputAmount: quote.minimumOutputAmount }
-        : {}),
-      outputAmount: quote.outputAmount,
-      outputAmountFormatted:
-        quote.outputAmountFormatted ??
-        decimalFromBaseUnits(quote.outputAmount, candidate.destinationToken.decimals),
       sampledAt: quote.sampledAt,
     },
+    sourceAmount: Value.tokenAmount({
+      baseUnits: candidate.sourceAmount.amount,
+      currency: candidate.sourceToken.currency,
+      decimals: candidate.sourceToken.decimals,
+    }),
+    sourceChain: candidate.sourceChain,
+    sourceToken: candidate.sourceToken,
   } as const
 }
 

package/src/internal/Log.test-d.ts

@@ -0,0 +1,21 @@
+import type * as FundingQuotes from './FundingQuotes.js'
+import type * as Log from './Log.js'
+
+test('bounds funding provider metric identifiers', () => {
+  const provider = null as never as FundingQuotes.ProviderId
+  const id: Log.FundingProviderAttempt['id'] = provider
+  const provider_roundTrip: FundingQuotes.ProviderId = id
+  void provider_roundTrip
+
+  const attempt = {
+    durationMs: 1,
+    id: 'relay',
+    operation: 'quote/v2',
+    outcome: 'available',
+  } satisfies Log.FundingProviderAttempt
+  void attempt
+
+  // @ts-expect-error arbitrary provider names would create unbounded metric tags
+  const invalid: Log.FundingProviderAttempt['id'] = 'user-controlled-provider'
+  void invalid
+})

package/src/internal/Log.test.ts

@@ -138,6 +138,97 @@ describe('middleware', () => {
     `)
   })
 
+  test('records a JSON-RPC error returned with HTTP 200', async () => {
+    const entries: Log.Entry[] = []
+    const api = app({ emit: (entry) => void entries.push(entry) })
+    api.post('/rpc/sponsor', (c) => {
+      const body = {
+        error: {
+          code: -32602,
+          data: { code: 'billing_required', retryable: false },
+          message: 'Sponsorship requires an active billing source.',
+        },
+        id: 1,
+        jsonrpc: '2.0',
+      }
+      c.set('rpcResponse', Log.rpcErrors(body))
+      return c.json(body)
+    })
+
+    const response = await api.request('/rpc/sponsor', { method: 'POST' })
+
+    expect(response.status).toBe(200)
+    expect(stable(entries[0]!)).toMatchInlineSnapshot(`
+      {
+        "level": "warn",
+        "method": "POST",
+        "path": "/rpc/sponsor",
+        "route": "/rpc/sponsor",
+        "rpc": {
+          "code": -32602,
+          "dataCode": "billing_required",
+          "errors": 1,
+        },
+        "status": 200,
+      }
+    `)
+  })
+
+  test('logs JSON-RPC server errors at error level', async () => {
+    const entries: Log.Entry[] = []
+    const api = app({ emit: (entry) => void entries.push(entry) })
+    api.post('/rpc/sponsor', (c) => {
+      const body = {
+        error: {
+          code: -32603,
+          data: { code: 'internal_error' },
+          message: 'Internal error',
+        },
+        id: 1,
+        jsonrpc: '2.0',
+      }
+      c.set('rpcResponse', Log.rpcErrors(body))
+      return c.json(body)
+    })
+
+    await api.request('/rpc/sponsor', { method: 'POST' })
+
+    expect(entries[0]?.level).toBe('error')
+  })
+
+  test('counts batch JSON-RPC errors without retaining mixed codes', async () => {
+    const entries: Log.Entry[] = []
+    const api = app({ emit: (entry) => void entries.push(entry) })
+    api.post('/rpc/relay', (c) => {
+      const body = [
+        { id: 1, jsonrpc: '2.0', result: '0x1' },
+        { error: { code: -32602, message: 'Invalid params.' }, id: 2, jsonrpc: '2.0' },
+        {
+          error: { code: -32603, data: { code: 'Internal Error' }, message: 'Internal error.' },
+          id: 3,
+          jsonrpc: '2.0',
+        },
+      ]
+      c.set('rpcResponse', Log.rpcErrors(body))
+      return c.json(body)
+    })
+
+    await api.request('/rpc/relay', { method: 'POST' })
+
+    expect(stable(entries[0]!)).toMatchInlineSnapshot(`
+      {
+        "level": "warn",
+        "method": "POST",
+        "path": "/rpc/relay",
+        "route": "/rpc/relay",
+        "rpc": {
+          "errors": 2,
+        },
+        "status": 200,
+      }
+    `)
+  })
+
   test('includes redacted provider failure details', async () => {
     const entries: Log.Entry[] = []
     const api = app({ emit: (entry) => void entries.push(entry) })
@@ -177,6 +268,56 @@ describe('middleware', () => {
     `)
   })
 
+  test('includes bounded funding provider attempts', async () => {
+    const entries: Log.Entry[] = []
+    const api = app({ emit: (entry) => void entries.push(entry) })
+    api.get('/funding', (c) => {
+      c.set('fundingProviderAttempts', [
+        {
+          durationMs: 12.5,
+          id: 'relay',
+          operation: 'quote/v2',
+          outcome: 'available',
+        },
+        {
+          durationMs: 25,
+          failure: 'timeout',
+          id: 'across',
+          operation: 'swap/approval',
+          outcome: 'failed',
+        },
+      ])
+      return c.json({ ok: true }, 200)
+    })
+
+    await api.request('/funding')
+
+    expect(stable(entries[0]!)).toMatchInlineSnapshot(`
+      {
+        "fundingProviderAttempts": [
+          {
+            "durationMs": 12.5,
+            "id": "relay",
+            "operation": "quote/v2",
+            "outcome": "available",
+          },
+          {
+            "durationMs": 25,
+            "failure": "timeout",
+            "id": "across",
+            "operation": "swap/approval",
+            "outcome": "failed",
+          },
+        ],
+        "level": "info",
+        "method": "GET",
+        "path": "/funding",
+        "route": "/funding",
+        "status": 200,
+      }
+    `)
+  })
+
   test('logs thrown errors at error level', async () => {
     const entries: Log.Entry[] = []
     const api = app({ emit: (entry) => void entries.push(entry) })