tapimo 0.1.0 → 0.3.0

package/src/apps/{coingecko.ts → data/routes/coingecko.ts}

@@ -5,14 +5,14 @@ import { type Address as ViemAddress, formatUnits } from 'viem'
 import { Addresses, Tick } from 'viem/tempo'
 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 OpenApi from '../internal/OpenApi.js'
-import * as Response from '../internal/Response.js'
-import * as Schema from '../internal/Schema.js'
-import * as Timing from '../internal/Timing.js'
-import * as Value from '../internal/Value.js'
+import type * as App from '../../../App.js'
+import * as Auth from '../../../internal/Auth.js'
+import * as Cache from '../../../internal/Cache.js'
+import * as OpenApi from '../../../internal/OpenApi.js'
+import * as Response from '../../../internal/Response.js'
+import * as Schema from '../../../internal/Schema.js'
+import * as Timing from '../../../internal/Timing.js'
+import * as Value from '../../../internal/Value.js'
 import { resolveBookQuotes, resolveBookReserves, resolveOrderStates } from './exchanges.js'
 import { getTokenMetadata } from './tokens.js'
 
@@ -484,9 +484,9 @@ const guardChainId = createMiddleware<App.Environment>(async (c, next) => {
 
 export function coingecko() {
   return new Hono<App.Environment>()
-    .use('/:chainId/*', guardChainId)
+    .use('/gecko/:chainId/*', guardChainId)
     .get(
-      '/:chainId/latest-block',
+      '/gecko/:chainId/latest-block',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.validate('param', schema.ChainIdParam, {
         code: 'chain_id_invalid',
@@ -527,7 +527,7 @@ export function coingecko() {
       },
     )
     .get(
-      '/:chainId/assets/:address',
+      '/gecko/:chainId/assets/:address',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.validate('param', schema.AssetParams, {
         code: 'address_invalid',
@@ -578,7 +578,7 @@ export function coingecko() {
       },
     )
     .get(
-      '/:chainId/pairs',
+      '/gecko/:chainId/pairs',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.validate('param', schema.ChainIdParam, {
         code: 'chain_id_invalid',
@@ -649,7 +649,7 @@ export function coingecko() {
       },
     )
     .get(
-      '/:chainId/pairs/:pairId',
+      '/gecko/:chainId/pairs/:pairId',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.validate('param', schema.PairParams, {
         code: 'pair_id_invalid',
@@ -711,7 +711,7 @@ export function coingecko() {
       },
     )
     .get(
-      '/:chainId/events',
+      '/gecko/:chainId/events',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.validate('param', schema.ChainIdParam, {
         code: 'chain_id_invalid',

package/src/apps/{exchanges.test.ts → data/routes/exchanges.test.ts}

@@ -1,7 +1,7 @@
 import type * as z from 'zod/mini'
 import { Schema } from 'tapimo'
 
-import * as TestApp from '../../test/App.js'
+import * as TestApp from '../../../../test/App.js'
 import * as Exchanges from './exchanges.js'
 
 type OrdersResponse = z.output<typeof Exchanges.schema.getOrders.Response>

package/src/apps/{exchanges.ts → data/routes/exchanges.ts}

@@ -10,18 +10,18 @@ import {
 import { Actions, Addresses, Tick } from 'viem/tempo'
 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 Cursor from '../internal/Cursor.js'
-import * as OpenApi from '../internal/OpenApi.js'
-import * as Response from '../internal/Response.js'
-import * as Schema from '../internal/Schema.js'
-import * as Store from '../internal/Store.js'
-import * as Timing from '../internal/Timing.js'
-import * as Ttl from '../internal/Ttl.js'
-import * as Value from '../internal/Value.js'
-import * as VerifiedTokens from '../internal/VerifiedTokens.js'
+import type * as App from '../../../App.js'
+import * as Auth from '../../../internal/Auth.js'
+import * as Cache from '../../../internal/Cache.js'
+import * as Cursor from '../../../internal/Cursor.js'
+import * as OpenApi from '../../../internal/OpenApi.js'
+import * as Response from '../../../internal/Response.js'
+import * as Schema from '../../../internal/Schema.js'
+import * as Store from '../../../internal/Store.js'
+import * as Timing from '../../../internal/Timing.js'
+import * as Ttl from '../../../internal/Ttl.js'
+import * as Value from '../../../internal/Value.js'
+import * as VerifiedTokens from '../../../internal/VerifiedTokens.js'
 import * as Tokens from './tokens.js'
 
 // Stablecoin DEX precompile. Pair lifecycle is announced by `PairCreated` from
@@ -1312,7 +1312,7 @@ export namespace schema {
 export function exchanges() {
   return new Hono<App.Environment>()
     .get(
-      '/swaps',
+      '/v1/exchange/swaps',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.validate('query', schema.getSwaps.Query, {
         code: 'query_invalid',
@@ -1422,7 +1422,7 @@ export function exchanges() {
       },
     )
     .get(
-      '/pairs',
+      '/v1/exchange/pairs',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.validate('query', schema.getPairs.Query, {
         code: 'query_invalid',
@@ -1529,7 +1529,7 @@ export function exchanges() {
     .get(
       // Single trading pair detail. The base address alone identifies the
       // pair (its quote is intrinsic to the base token on-chain).
-      '/pairs/:base',
+      '/v1/exchange/pairs/:base',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.validate('param', schema.getPair.Params, {
         code: 'pair_invalid',
@@ -1622,7 +1622,7 @@ export function exchanges() {
     )
     .get(
       // Resting-order feed, optionally scoped to one pair via `base`.
-      '/orders',
+      '/v1/exchange/orders',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.validate('query', schema.getOrders.Query, {
         code: 'query_invalid',
@@ -1747,7 +1747,7 @@ export function exchanges() {
     .get(
       // Single-order detail. The path-param schema rejects non-decimal
       // `orderId` values, surfacing the canonical `order_invalid` error.
-      '/orders/:orderId',
+      '/v1/exchange/orders/:orderId',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.validate('param', schema.getOrder.Params, {
         code: 'order_invalid',
@@ -1856,7 +1856,7 @@ export function exchanges() {
     )
     .get(
       // Paginated fill history for a single order.
-      '/orders/:orderId/fills',
+      '/v1/exchange/orders/:orderId/fills',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.validate('param', schema.getOrderFills.Params, {
         code: 'order_invalid',
@@ -1945,7 +1945,7 @@ export function exchanges() {
     .get(
       // OHLC (candlestick) aggregations for a single pair, addressed by its
       // base token.
-      '/pairs/:base/ohlc',
+      '/v1/exchange/pairs/:base/ohlc',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.validate('param', schema.getPairOhlc.Params, {
         code: 'pair_invalid',
@@ -2053,7 +2053,7 @@ export function exchanges() {
     .get(
       // Orderbook depth (cumulative size per tick) for a single pair,
       // addressed by its base token.
-      '/pairs/:base/depth',
+      '/v1/exchange/pairs/:base/depth',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.validate('param', schema.getPairDepth.Params, {
         code: 'pair_invalid',

package/src/apps/{fee-amm.test.ts → data/routes/fee-amm.test.ts}

@@ -1,8 +1,8 @@
 import { Abis, Addresses } from 'viem/tempo'
 
-import * as TestApp from '../../test/App.js'
-import * as Runtime from '../../test/runtime.js'
-import * as TestViem from '../../test/Viem.js'
+import * as TestApp from '../../../../test/App.js'
+import * as Runtime from '../../../../test/runtime.js'
+import * as TestViem from '../../../../test/Viem.js'
 import * as FeeAmm from './fee-amm.js'
 
 /** Validator-side token with live fee-AMM activity on Tempo Moderato. */

package/src/apps/{fee-amm.ts → data/routes/fee-amm.ts}

@@ -3,18 +3,18 @@ import { AbiEvent, AbiParameters, Hash, type Hex, Value as core_Value } from 'ox
 import { Abis, Addresses } from 'viem/tempo'
 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 Cursor from '../internal/Cursor.js'
-import * as OpenApi from '../internal/OpenApi.js'
-import * as Response from '../internal/Response.js'
-import * as Schema from '../internal/Schema.js'
-import * as Store from '../internal/Store.js'
-import * as Timing from '../internal/Timing.js'
-import * as Ttl from '../internal/Ttl.js'
-import * as Value from '../internal/Value.js'
-import * as VerifiedTokens from '../internal/VerifiedTokens.js'
+import type * as App from '../../../App.js'
+import * as Auth from '../../../internal/Auth.js'
+import * as Cache from '../../../internal/Cache.js'
+import * as Cursor from '../../../internal/Cursor.js'
+import * as OpenApi from '../../../internal/OpenApi.js'
+import * as Response from '../../../internal/Response.js'
+import * as Schema from '../../../internal/Schema.js'
+import * as Store from '../../../internal/Store.js'
+import * as Timing from '../../../internal/Timing.js'
+import * as Ttl from '../../../internal/Ttl.js'
+import * as Value from '../../../internal/Value.js'
+import * as VerifiedTokens from '../../../internal/VerifiedTokens.js'
 import * as Tokens from './tokens.js'
 
 // The protocol Fee AMM lives at the reserved FeeManager address. Pools are
@@ -308,7 +308,7 @@ export namespace schema {
 export function feeAmm() {
   return new Hono<App.Environment>()
     .get(
-      '/pools',
+      '/v1/fee-amm/pools',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.validate('query', schema.getFeeAmmPools.Query, {
         code: 'query_invalid',
@@ -420,7 +420,7 @@ export function feeAmm() {
       },
     )
     .get(
-      '/mints',
+      '/v1/fee-amm/mints',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.validate('query', schema.getFeeAmmMints.Query, {
         code: 'query_invalid',
@@ -520,8 +520,8 @@ export function feeAmm() {
  * Discovers fee pools by aggregating the FeeManager's `Mint` logs into one
  * row per `(userToken, validatorToken)` pair, paginated and ordered by mint
  * count (most active first), so the real fee pools (thousands to millions of
- * mints) lead the head pages and the one-shot spam pairs (mint count 1) sink
- * to the tail.
+ * mints) lead the head pages and the spam pairs (mint count 1) sink to the
+ * tail.
  *
  * Keyset pagination on `(mint_count, topic2, topic3)`: `mint_count` ranks the
  * page (mutable — it grows as pools mint — so this is best-effort across mint
@@ -568,7 +568,7 @@ function listPools(c: Context<App.Environment>, options: listPools.Options) {
 
         // Raw-`logs` ClickHouse aggregate (dynamic query, hence the cast):
         // ordering is by mint count so the head pages surface the real fee
-        // pools and the one-shot spam pairs sink to the tail. Fetch one extra
+        // pools and the single-mint spam pairs sink to the tail. Fetch one extra
         // row to detect `hasMore` without a separate count query.
         const result = await tidx.fetch({
           chainId,
@@ -669,7 +669,7 @@ declare namespace listPools {
  * Addresses are lowercased to match the indexer's stored casing.
  *
  * The set is intentionally gated to the verified list rather than every pooled
- * token: anyone can mint a one-shot spam pool, so the raw set of pool
+ * token: anyone can mint a single-mint spam pool, so the raw set of pool
  * `userToken`s is unbounded (tens of thousands on busy chains) and those
  * liquidity-less pools can't actually settle fees. Restricting to verified
  * tokens keeps the set small (a handful of USD stablecoins), bounds the scan

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

@@ -0,0 +1,214 @@
+import { Schema } from 'tapimo'
+
+import * as TestApp from '../../../../test/App.js'
+import * as Funding from './funding.js'
+
+describe('GET /funding/routes', () => {
+  test('returns static inventory-backed route candidates', async () => {
+    const response = await TestApp.client().v1.funding.routes.$get(
+      {
+        query: {
+          destinationToken: 'USDC.e',
+          sourceAmount: '1000000',
+          sourceChain: 'base',
+          sourceToken: 'USDC',
+        },
+      },
+      TestApp.auth,
+    )
+    expect(response.status).toBe(200)
+    const body = await TestApp.json(response, Funding.schema.listFundingRoutes.Response)
+
+    expect(body.data.map((route) => route.provider.id)).toEqual([
+      'across',
+      'relay',
+      'bridge',
+      'bungee',
+    ])
+    expect(body.data[0]).toMatchObject({
+      destinationChain: { id: 'eip155:4217', name: 'Tempo' },
+      destinationToken: { symbol: 'USDC.e' },
+      id: 'base-usdc-tempo-usdce-across',
+      quality: { liquiditySource: 'staticInventory', tier: 'unknown' },
+      sourceAmount: { amount: '1000000', formatted: '1' },
+      sourceChain: { id: 'eip155:8453', name: 'Base' },
+      sourceToken: { symbol: 'USDC' },
+      status: 'unknown',
+    })
+  })
+
+  test('converts decimal source amounts after resolving the source token', async () => {
+    const response = await TestApp.client().v1.funding.routes.$get(
+      {
+        query: {
+          provider: 'relay',
+          sourceAmount: '1.25',
+          sourceAmountUnits: 'decimal',
+          sourceChain: 'eip155:8453',
+          sourceToken: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913',
+        },
+      },
+      TestApp.auth,
+    )
+    expect(response.status).toBe(200)
+    const body = await TestApp.json(response, Funding.schema.listFundingRoutes.Response)
+
+    expect(body.data).toHaveLength(1)
+    expect(body.data[0]?.sourceAmount).toMatchObject({
+      amount: '1250000',
+      formatted: '1.25',
+    })
+  })
+
+  test('does not case-fold non-EVM source token identifiers', async () => {
+    const solanaMint = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'
+    const exactResponse = await TestApp.client().v1.funding.routes.$get(
+      {
+        query: {
+          sourceAmount: '1000000',
+          sourceChain: 'solana',
+          sourceToken: solanaMint,
+        },
+      },
+      TestApp.auth,
+    )
+    expect(exactResponse.status).toBe(200)
+    const exactBody = await TestApp.json(exactResponse, Funding.schema.listFundingRoutes.Response)
+    expect(exactBody.data.map((route) => route.provider.id)).toEqual(['bridge'])
+
+    const lowercasedSolanaResponse = await TestApp.client().v1.funding.routes.$get(
+      {
+        query: {
+          sourceAmount: '1000000',
+          sourceChain: 'solana',
+          sourceToken: solanaMint.toLowerCase(),
+        },
+      },
+      TestApp.auth,
+    )
+    expect(lowercasedSolanaResponse.status).toBe(200)
+    const lowercasedSolanaBody = await TestApp.json(
+      lowercasedSolanaResponse,
+      Funding.schema.listFundingRoutes.Response,
+    )
+    expect(lowercasedSolanaBody.data).toEqual([])
+
+    const lowercasedTronResponse = await TestApp.client().v1.funding.routes.$get(
+      {
+        query: {
+          sourceAmount: '1000000',
+          sourceChain: 'tron',
+          sourceToken: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'.toLowerCase(),
+        },
+      },
+      TestApp.auth,
+    )
+    expect(lowercasedTronResponse.status).toBe(200)
+    const lowercasedTronBody = await TestApp.json(
+      lowercasedTronResponse,
+      Funding.schema.listFundingRoutes.Response,
+    )
+    expect(lowercasedTronBody.data).toEqual([])
+  })
+
+  test('returns no candidates for an unsupported source token', async () => {
+    const response = await TestApp.client().v1.funding.routes.$get(
+      {
+        query: {
+          sourceAmount: '1.234567890',
+          sourceAmountUnits: 'decimal',
+          sourceChain: 'base',
+          sourceToken: 'DAI',
+        },
+      },
+      TestApp.auth,
+    )
+    expect(response.status).toBe(200)
+    const body = await TestApp.json(response, Funding.schema.listFundingRoutes.Response)
+    expect(body.data).toEqual([])
+  })
+
+  test('rejects amounts that cannot be represented in source decimals', async () => {
+    const response = await TestApp.client().v1.funding.routes.$get(
+      {
+        query: {
+          sourceAmount: '1.0000001',
+          sourceAmountUnits: 'decimal',
+          sourceChain: 'base',
+          sourceToken: 'USDC',
+        },
+      },
+      TestApp.auth,
+    )
+    expect(response.status).toBe(400)
+    const body = await TestApp.json(response, Schema.ErrorResponse)
+    expect(body.error.code).toBe('query_invalid')
+  })
+
+  test('rejects unimplemented include parameters', async () => {
+    const response = await TestApp.create().request(
+      '/v1/funding/routes?sourceChain=base&sourceToken=USDC&sourceAmount=1000000&include=quotes',
+      { headers: TestApp.auth.headers },
+    )
+    expect(response.status).toBe(400)
+    const body = await TestApp.json(response, Schema.ErrorResponse)
+    expect(body.error.code).toBe('query_invalid')
+  })
+})
+
+describe('GET /funding/chains', () => {
+  test('lists source chain and stablecoin inventory', async () => {
+    const response = await TestApp.client().v1.funding.chains.$get(undefined, TestApp.auth)
+    expect(response.status).toBe(200)
+    const body = await TestApp.json(response, Funding.schema.listFundingChains.Response)
+
+    expect(body.data.map((chain) => chain.id)).toEqual([
+      'eip155:1',
+      'eip155:8453',
+      'eip155:56',
+      'solana:mainnet',
+      'tron:mainnet',
+    ])
+    expect(body.data.find((chain) => chain.id === 'solana:mainnet')?.tokens).toEqual(
+      expect.arrayContaining([expect.objectContaining({ symbol: 'USDC', standard: 'SPL' })]),
+    )
+  })
+})
+
+describe('GET /providers', () => {
+  test('lists providers filtered by capability', async () => {
+    const response = await TestApp.client().v1.providers.$get(
+      { query: { capability: 'fundingRoutes' } },
+      TestApp.auth,
+    )
+    expect(response.status).toBe(200)
+    const body = await TestApp.json(response, Funding.schema.listProviders.Response)
+
+    expect(body.data.map((provider) => provider.id)).toEqual([
+      'across',
+      'relay',
+      'bridge',
+      'bungee',
+      'lifi',
+    ])
+    expect(body.data.every((provider) => provider.capabilities.includes('fundingRoutes'))).toBe(
+      true,
+    )
+    expect(body.data.map((provider) => provider.status)).toEqual([
+      'inventoryOnly',
+      'inventoryOnly',
+      'inventoryOnly',
+      'inventoryOnly',
+      'planned',
+    ])
+  })
+
+  test('rejects unsupported provider capabilities', async () => {
+    const response = await TestApp.create().request('/v1/providers?capability=settlement', {
+      headers: TestApp.auth.headers,
+    })
+    expect(response.status).toBe(400)
+    const body = await TestApp.json(response, Schema.ErrorResponse)
+    expect(body.error.code).toBe('query_invalid')
+  })
+})