tapimo 0.5.3 → 0.7.0

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')
@@ -75,7 +84,6 @@ describe('FundingQuoteProviders', () => {
       expiresAt: '2026-01-01T00:01:00.000Z',
       minimumOutputAmount: '988000',
       outputAmount: '990000',
-      outputAmountFormatted: '0.99',
       quality: {
         estimatedSeconds: 2,
         liquiditySource: 'providerQuote',
@@ -176,7 +184,6 @@ describe('FundingQuoteProviders', () => {
     expect(result).toMatchObject({
       minimumOutputAmount: '980000',
       outputAmount: '990000',
-      outputAmountFormatted: '0.99',
       quality: {
         estimatedSeconds: 15,
         liquiditySource: 'providerQuote',
@@ -221,7 +228,6 @@ describe('FundingQuoteProviders', () => {
     expect(result).toEqual({
       minimumOutputAmount: '989622',
       outputAmount: '999620',
-      outputAmountFormatted: '0.99962',
       quality: {
         estimatedSeconds: 10,
         liquiditySource: 'providerQuote',
@@ -262,6 +268,179 @@ 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',
+      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')
@@ -297,7 +476,6 @@ describe('FundingQuoteProviders', () => {
     })
     expect(result).toEqual({
       outputAmount: '983000',
-      outputAmountFormatted: '0.983',
       quality: {
         estimatedSeconds: 2,
         liquiditySource: 'providerQuote',
@@ -585,6 +763,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 +879,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 +969,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 {