tapimo 0.5.2 → 0.6.0

package/src/apps/data/App.ts

@@ -14,6 +14,7 @@ import * as Tidx from '../../internal/Tidx.js'
 import * as Viem from '../../internal/Viem.js'
 import * as Scope from '../../Scope.js'
 import * as Metadata from '../metadata.js'
+import type * as FxOracle from './FxOracle.js'
 
 import { transactions as transactionActivities } from './routes/activities.js'
 import { addresses } from './routes/addresses.js'
@@ -42,6 +43,12 @@ import { schema as webhookSchema, webhooks } from './routes/webhooks.js'
  */
 export function data(options: data.Options = {}) {
   const { assets, tidx } = options
+  const webhook =
+    options.webhook === false
+      ? undefined
+      : (options.webhook ?? {
+          supportedChainIds: [Viem.chainId.mainnet, Viem.chainId.testnet],
+        })
 
   // Zone endpoints are explicit trust boundaries; the API never derives them.
   const zones = new Map((options.zones ?? []).map((zone) => [zone.chainId, zone]))
@@ -66,7 +73,7 @@ export function data(options: data.Options = {}) {
       c.set('supportedChainIds', supportedChainIds)
       c.set('tidx', tidx)
       c.set('verifiedTokens', options.verifiedTokens === false ? undefined : (options.verifiedTokens ?? {})) // prettier-ignore
-      c.set('webhook', options.webhook === false ? undefined : (options.webhook ?? {}))
+      c.set('webhook', webhook)
       c.set('zones', zones)
       await next()
     })
@@ -158,18 +165,18 @@ export function data(options: data.Options = {}) {
         'Content-Type': asset.contentType,
       })
     })
-    .route('/', addresses())
+    .route('/', addresses({ fx: options.fx }))
     .route('/', blocks())
-    .route('/', exchanges())
+    .route('/', exchanges({ fx: options.fx }))
     .route('/', feeAmm())
     .route('/', funding(options.funding))
     .route('/', indexer())
-    .route('/', receipts())
+    .route('/', receipts({ fx: options.fx }))
     .route('/', tokenlist())
     .route('/', tokens())
     .route('/', transactions())
-    .route('/', transactionActivities())
-    .route('/', transfers())
+    .route('/', transactionActivities({ fx: options.fx }))
+    .route('/', transfers({ fx: options.fx }))
     .route('/', verifiedTokens())
     .route('/', webhooks({ enabled: options.webhook !== false }))
     .route('/', rpc())
@@ -206,6 +213,8 @@ export declare namespace data {
     assets?: Assets.Assets | undefined
     /** Funding quote provider configuration. */
     funding?: funding.Options | undefined
+    /** FX configuration for the valuation endpoint. */
+    fx?: Fx | undefined
     /** TIDX query client options. */
     tidx?: Tidx.getClient.Tidx | undefined
     /** Verified-token feature configuration. Enabled by default (token rows live in `db`; empty until published); pass `false` to always serve an empty verified list. */
@@ -219,6 +228,12 @@ export declare namespace data {
     zones?: readonly Zone[] | undefined
   }
 
+  /** FX configuration for the valuation endpoint. */
+  type Fx = {
+    /** FX rate oracle backing currency conversion. Defaults to the ECB daily reference rates (`FxOracle.ecb()`). */
+    oracle?: FxOracle.Oracle | undefined
+  }
+
   /** One zone chain served by this deployment. */
   type Zone = {
     /** Zone chain id. Consumer-supplied literal; the API never derives zone chain ids. */
@@ -238,14 +253,7 @@ export declare namespace data {
   }
 
   /** Webhook feature configuration. */
-  type Webhook = {
-    /**
-     * Maximum active subscriptions per owner; creation is rejected with
-     * `403 limit_exceeded` once reached. Defaults to 100, bounding the spam/SSRF
-     * and delivery-cost surface per owner.
-     */
-    maxPerOwner?: number | undefined
-  }
+  type Webhook = App.Webhook
 }
 
 function resolveChainSelector(options: {

package/src/apps/data/FundingQuoteProviders.test.ts

@@ -38,6 +38,15 @@ describe('FundingQuoteProviders', () => {
     })
   })
 
+  test('configures Symbiosis only when its quote user is present', () => {
+    expect(FundingQuoteProviders.configureSymbiosis()).toBeUndefined()
+    expect(
+      FundingQuoteProviders.configureSymbiosis({
+        userAddress: '0x1111111111111111111111111111111111111111',
+      }),
+    ).toEqual({ userAddress: '0x1111111111111111111111111111111111111111' })
+  })
+
   test('maps successful Across quotes to available quote probes', async () => {
     const requests: RecordedRequest[] = []
     const candidate = quoteCandidate('across')
@@ -262,6 +271,180 @@ describe('FundingQuoteProviders', () => {
     })
   })
 
+  test('maps successful Symbiosis quotes to available quote probes', async () => {
+    const requests: RecordedRequest[] = []
+    const candidate = quoteCandidate('symbiosis')
+    const fetch = recordingFetch(requests, async () => jsonResponse(symbiosisQuote(candidate)))
+    const adapter = FundingQuoteProviders.symbiosis({
+      baseUrl: 'https://symbiosis.test/crosschain/',
+      fetch,
+      now,
+      userAddress: '0x1111111111111111111111111111111111111111',
+    })
+
+    const result = await adapter.probeQuote(probeInput(candidate), new AbortController().signal)
+
+    expect(requests).toHaveLength(1)
+    expect(requests[0]?.url.pathname).toBe('/crosschain/v2/quote')
+    expect(new Headers(requests[0]?.init?.headers).get('x-partner-id')).toBe('tempo')
+    expect(jsonRequestBody(requests[0])).toEqual({
+      from: '0x1111111111111111111111111111111111111111',
+      slippage: 100,
+      to: '0x1111111111111111111111111111111111111111',
+      tokenAmountIn: {
+        address: candidate.sourceToken.address,
+        amount: '1000000',
+        chainId: 8453,
+        decimals: 6,
+        symbol: 'USDC',
+      },
+      tokenOut: {
+        address: candidate.destinationToken.address,
+        chainId: 4217,
+        decimals: 6,
+        symbol: 'USDC.e',
+      },
+    })
+    expect(result).toEqual({
+      minimumOutputAmount: '979000',
+      outputAmount: '989000',
+      outputAmountFormatted: '0.989',
+      quality: {
+        estimatedSeconds: 18,
+        liquiditySource: 'providerQuote',
+        sourceDetail: 'symbiosis:quote-v2',
+        tier: 'liquid',
+      },
+      sampledAt: '2026-01-01T00:00:00.000Z',
+      status: 'available',
+    })
+  })
+
+  test('maps Tron identifiers into Symbiosis quote requests', async () => {
+    const requests: RecordedRequest[] = []
+    const candidate = quoteCandidate('symbiosis', {
+      destinationToken: 'USDT0',
+      sourceChain: 'tron',
+      sourceToken: 'USDT',
+    })
+    const fetch = recordingFetch(requests, async () => jsonResponse(symbiosisQuote(candidate)))
+    const adapter = FundingQuoteProviders.symbiosis({
+      fetch,
+      now,
+      userAddress: '0x1111111111111111111111111111111111111111',
+    })
+
+    await adapter.probeQuote(probeInput(candidate), new AbortController().signal)
+
+    expect(jsonRequestBody(requests[0])).toMatchObject({
+      tokenAmountIn: {
+        address: '0xa614f803b6fd780986a42c78ec9c7f77e6ded13c',
+        chainId: 728126428,
+        decimals: 6,
+        symbol: 'USDT',
+      },
+      tokenOut: {
+        address: candidate.destinationToken.address,
+        chainId: 4217,
+        decimals: 6,
+        symbol: 'USDT0',
+      },
+    })
+  })
+
+  test('rejects Symbiosis responses without route identity fields', async () => {
+    const candidate = quoteCandidate('symbiosis')
+    const quote = symbiosisQuote(candidate)
+    const response = {
+      tokenAmountOut: quote.tokenAmountOut,
+      tokenAmountOutMin: quote.tokenAmountOutMin,
+    }
+    const adapter = FundingQuoteProviders.symbiosis({
+      fetch: recordingFetch([], async () => jsonResponse(response)),
+      now,
+      userAddress: '0x1111111111111111111111111111111111111111',
+    })
+
+    await expect(
+      adapter.probeQuote(probeInput(candidate), new AbortController().signal),
+    ).rejects.toThrowErrorMatchingInlineSnapshot(`[FundingQuoteProviders.ProviderPayloadError]`)
+  })
+
+  test('enforces the Symbiosis provider quota before fetching', async () => {
+    const requests: RecordedRequest[] = []
+    const candidate = quoteCandidate('symbiosis')
+    const adapter = FundingQuoteProviders.symbiosis({
+      fetch: recordingFetch(requests, async () => jsonResponse(symbiosisQuote(candidate))),
+      now,
+      userAddress: '0x1111111111111111111111111111111111111111',
+    })
+
+    await Promise.all(
+      Array.from({ length: 4 }, () =>
+        adapter.probeQuote(probeInput(candidate), new AbortController().signal),
+      ),
+    )
+    const cause = await adapter
+      .probeQuote(probeInput(candidate), new AbortController().signal)
+      .catch((error: unknown) => error)
+
+    expect(requests).toHaveLength(4)
+    expect(cause).toMatchObject({
+      name: 'FundingQuoteProviders.ProviderRateLimitError',
+    })
+    expect(FundingQuoteProviders.providerFailure({ cause, provider: 'symbiosis' })).toEqual({
+      failure: 'rate_limit',
+      id: 'symbiosis',
+      operation: 'v2/quote',
+    })
+  })
+
+  test('maps unavailable Symbiosis routes to unavailable quote probes', async () => {
+    const candidate = quoteCandidate('symbiosis')
+    const adapter = FundingQuoteProviders.symbiosis({
+      fetch: recordingFetch([], async () => jsonResponse({ code: 'NO_ROUTE' }, 400)),
+      now,
+      userAddress: '0x1111111111111111111111111111111111111111',
+    })
+
+    await expect(
+      adapter.probeQuote(probeInput(candidate), new AbortController().signal),
+    ).resolves.toMatchObject({
+      quality: {
+        sourceDetail: 'symbiosis:quote-v2:NO_ROUTE',
+        tier: 'unavailable',
+      },
+      status: 'unavailable',
+    })
+  })
+
+  test('maps Symbiosis fee-floor errors to unavailable quote probes', async () => {
+    const candidate = quoteCandidate('symbiosis')
+    const adapter = FundingQuoteProviders.symbiosis({
+      fetch: recordingFetch([], async () =>
+        jsonResponse({ code: 0, message: 'Amount is too low to cover fees' }, 400),
+      ),
+      now,
+      userAddress: '0x1111111111111111111111111111111111111111',
+    })
+
+    await expect(
+      adapter.probeQuote(probeInput(candidate), new AbortController().signal),
+    ).resolves.toMatchObject({
+      quality: {
+        sourceDetail: 'symbiosis:quote-v2:AMOUNT_TOO_LOW',
+        tier: 'unavailable',
+      },
+      status: 'unavailable',
+    })
+  })
+
+  test('rejects invalid Symbiosis configuration', () => {
+    expect(() =>
+      FundingQuoteProviders.symbiosis({ userAddress: 'invalid' }),
+    ).toThrowErrorMatchingInlineSnapshot(`[FundingQuoteProviders.ProviderConfigurationError]`)
+  })
+
   test('maps successful Rhino quotes to available quote probes', async () => {
     const requests: RecordedRequest[] = []
     const candidate = quoteCandidate('rhino')
@@ -585,6 +768,73 @@ describe('FundingQuoteProviders', () => {
       ).rejects.toThrowErrorMatchingInlineSnapshot(`[FundingQuoteProviders.ProviderPayloadError]`)
     })
 
+  const invalidSymbiosisQuotes = [
+    [
+      'unsupported route kinds',
+      (body: ReturnType<typeof symbiosisQuote>) => (body.kind = 'onchain-swap' as never),
+    ],
+    [
+      'mismatched execution types',
+      (body: ReturnType<typeof symbiosisQuote>) => (body.type = 'tron'),
+    ],
+    [
+      'mismatched transaction chains',
+      (body: ReturnType<typeof symbiosisQuote>) => (body.tx.chainId = 1),
+    ],
+    ['empty routes', (body: ReturnType<typeof symbiosisQuote>) => (body.routes = [])],
+    [
+      'mismatched source token addresses',
+      (body: ReturnType<typeof symbiosisQuote>) =>
+        (body.routes[0]!.tokens[0]!.address = '0xfde4c96c8593536e31f229ea8f37b2ada2699bb2'),
+    ],
+    [
+      'mismatched source chains',
+      (body: ReturnType<typeof symbiosisQuote>) => (body.routes[0]!.tokens[0]!.chainId = 1),
+    ],
+    [
+      'mismatched route destination tokens',
+      (body: ReturnType<typeof symbiosisQuote>) =>
+        (body.routes[0]!.tokens[1]!.address = '0x20c00000000000000000000014f22ca97301eb73'),
+    ],
+    [
+      'mismatched output token addresses',
+      (body: ReturnType<typeof symbiosisQuote>) =>
+        (body.tokenAmountOut.address = '0x20c00000000000000000000014f22ca97301eb73'),
+    ],
+    [
+      'mismatched minimum output chains',
+      (body: ReturnType<typeof symbiosisQuote>) => (body.tokenAmountOutMin.chainId = 1),
+    ],
+    [
+      'mismatched output decimals',
+      (body: ReturnType<typeof symbiosisQuote>) => (body.tokenAmountOut.decimals = 18 as never),
+    ],
+    [
+      'zero output amounts',
+      (body: ReturnType<typeof symbiosisQuote>) => (body.tokenAmountOut.amount = '0'),
+    ],
+    [
+      'invalid output bounds',
+      (body: ReturnType<typeof symbiosisQuote>) => (body.tokenAmountOutMin.amount = '990000'),
+    ],
+  ] as const
+
+  for (const [name, mutate] of invalidSymbiosisQuotes)
+    test(`rejects Symbiosis quotes with ${name}`, async () => {
+      const candidate = quoteCandidate('symbiosis')
+      const body = symbiosisQuote(candidate)
+      mutate(body)
+      const adapter = FundingQuoteProviders.symbiosis({
+        fetch: recordingFetch([], async () => jsonResponse(body)),
+        now,
+        userAddress: '0x1111111111111111111111111111111111111111',
+      })
+
+      await expect(
+        adapter.probeQuote(probeInput(candidate), new AbortController().signal),
+      ).rejects.toThrowErrorMatchingInlineSnapshot(`[FundingQuoteProviders.ProviderPayloadError]`)
+    })
+
   test('returns bounded Across failure diagnostics', async () => {
     const candidate = quoteCandidate('across')
     const adapter = FundingQuoteProviders.across({
@@ -634,6 +884,19 @@ describe('FundingQuoteProviders', () => {
       operation: 'v2/route',
     })
   })
+
+  test('returns bounded Symbiosis failure diagnostics', () => {
+    expect(
+      FundingQuoteProviders.providerFailure({
+        cause: new TypeError('network failure'),
+        provider: 'symbiosis',
+      }),
+    ).toEqual({
+      failure: 'network',
+      id: 'symbiosis',
+      operation: 'v2/quote',
+    })
+  })
 })
 
 type RecordedRequest = {
@@ -711,6 +974,41 @@ function squidQuote(candidate: FundingQuotes.QuoteProbeInput['candidate']) {
   }
 }
 
+function symbiosisQuote(candidate: FundingQuotes.QuoteProbeInput['candidate']) {
+  const source =
+    candidate.sourceChain.kind === 'tron'
+      ? {
+          address: '0xa614f803b6fd780986a42c78ec9c7f77e6ded13c',
+          chainId: 728126428,
+          decimals: candidate.sourceToken.decimals,
+        }
+      : {
+          address: candidate.sourceToken.address,
+          chainId: Number(candidate.sourceChain.id.replace('eip155:', '')),
+          decimals: candidate.sourceToken.decimals,
+        }
+  const destination = {
+    address: candidate.destinationToken.address,
+    chainId: 4217,
+    decimals: candidate.destinationToken.decimals,
+  }
+  return {
+    estimatedTime: 17.2,
+    kind: 'crosschain-swap' as const,
+    routes: [{ tokens: [source, destination] }],
+    tokenAmountOut: {
+      ...destination,
+      amount: '989000',
+    },
+    tokenAmountOutMin: {
+      ...destination,
+      amount: '979000',
+    },
+    tx: { chainId: source.chainId },
+    type: candidate.sourceChain.kind,
+  }
+}
+
 function probeInput(
   candidate: FundingQuotes.QuoteProbeInput['candidate'],
 ): FundingQuotes.QuoteProbeInput {