tapimo 0.0.2 → 0.2.0

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

@@ -1,8 +1,8 @@
-import { Schema } from 'cadent'
+import { Schema } from 'tapimo'
 import { Value as core_Value } from 'ox'
 
-import * as TestApp from '../../test/App.js'
-import * as Runtime from '../../test/runtime.js'
+import * as TestApp from '../../../../test/App.js'
+import * as Runtime from '../../../../test/runtime.js'
 import * as Balances from './balances.js'
 import * as Tokens from './tokens.js'
 
@@ -12,9 +12,10 @@ import * as Tokens from './tokens.js'
 // verified tokens the bundle used to provide; a test can still override
 // `verifiedTokens`.
 const runtime = Runtime.get()
-const verified = TestApp.verifiedStore(runtime.chainId)
+const db = TestApp.database()
+await TestApp.verifiedSeed(db, runtime.chainId)
 function app(options: TestApp.create.Options = {}) {
-  return TestApp.client({ verifiedTokens: { store: verified }, ...options })
+  return TestApp.client({ db, ...options })
 }
 
 async function holderWithBalance(client: ReturnType<typeof app>) {

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

@@ -1,17 +1,18 @@
 import { Hono, type Context } from 'hono'
 import { Hex, Value as core_Value } from 'ox'
+import { Actions } 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 Timing from '../internal/Timing.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 Timing from '../../../internal/Timing.js'
+import * as Value from '../../../internal/Value.js'
+import * as VerifiedTokens from '../../../internal/VerifiedTokens.js'
 import * as FeeAmm from './fee-amm.js'
 import * as Tokens from './tokens.js'
 
@@ -150,7 +151,7 @@ export namespace schema {
  */
 export function addresses() {
   return new Hono<App.Environment>().get(
-    '/:address/balances',
+    '/v1/addresses/:address/balances',
     Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
     OpenApi.validate('param', schema.getAddressBalances.Params, {
       code: 'address_invalid',
@@ -353,6 +354,39 @@ async function getAddressBalances(
 
   if (holdings.data.length === 0) return { data: [], nextCursor: holdings.nextCursor }
 
+  const client = c.get('getClient')(chainId)
+  // TODO: remove once https://github.com/tempoxyz/tidx/commit/2f37b44172d381fd00234ef23f79ed1e1d69c470 deployed.
+  const corrected = await Timing.time(c, 'balances_rpc', async () => {
+    const results = await client
+      .multicall({
+        allowFailure: true,
+        contracts: holdings.data.map((holding) =>
+          Actions.token.getBalance.call(client, { account: address, token: holding.address }),
+        ),
+      })
+      .catch(() => undefined)
+
+    const rows: { address: Hex.Hex; amount: string }[] = []
+    for (const [index, holding] of holdings.data.entries()) {
+      const result = results?.[index]
+      if (!result || result.status !== 'success' || typeof result.result !== 'bigint') {
+        rows.push(holding)
+        continue
+      }
+      if (result.result === 0n) continue
+      rows.push({ address: holding.address, amount: result.result.toString() })
+    }
+
+    rows.sort((a, b) => {
+      const delta = BigInt(b.amount) - BigInt(a.amount)
+      if (delta !== 0n) return delta > 0n ? 1 : -1
+      return a.address < b.address ? -1 : a.address > b.address ? 1 : 0
+    })
+    return rows
+  })
+
+  if (corrected.length === 0) return { data: [], nextCursor: holdings.nextCursor }
+
   // Resolve token metadata for each balance. The endpoint's contract is a
   // balance with its `token` reference inlined per row (and `formatted` needs
   // the token `decimals`), so a row whose metadata cannot be resolved is
@@ -365,7 +399,7 @@ async function getAddressBalances(
   // so it is never fetched here.
   const resolved = await Timing.time(c, 'tokens', () =>
     Promise.all(
-      holdings.data.map((holding) =>
+      corrected.map((holding) =>
         Tokens.resolveToken(c, {
           address: holding.address,
           chainId,

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

@@ -1,10 +1,10 @@
-import { Schema } from 'cadent'
+import { Schema } from 'tapimo'
 import { Hex } from 'ox'
 import { zeroHash } from 'viem'
 
-import * as TestApp from '../../test/App.js'
-import * as Runtime from '../../test/runtime.js'
-import * as Viem from '../../test/Viem.js'
+import * as TestApp from '../../../../test/App.js'
+import * as Runtime from '../../../../test/runtime.js'
+import * as Viem from '../../../../test/Viem.js'
 import * as Blocks from './blocks.js'
 import * as Transactions from './transactions.js'
 

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

@@ -2,17 +2,17 @@ import { Hono, type Context, type MiddlewareHandler } from 'hono'
 import { Hex } from 'ox'
 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 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'
 
 /** Example block number surfaced in OpenAPI docs. */
 const exampleBlockNumber = '1000000'
@@ -382,7 +382,7 @@ export function blocks() {
 
   return new Hono<App.Environment>()
     .get(
-      '/',
+      '/v1/blocks',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.validate('query', schema.getBlocks.Query, {
         code: 'query_invalid',
@@ -425,7 +425,7 @@ export function blocks() {
       },
     )
     .get(
-      '/:block',
+      '/v1/blocks/:block',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.validate('param', schema.getBlock.Params, {
         code: 'block_invalid',
@@ -590,7 +590,7 @@ export function blocks() {
  */
 export function blocksByTimestampCompat() {
   return new Hono<App.Environment>().get(
-    '/:chainId/blocks/by-timestamp',
+    '/chains/:chainId/blocks/by-timestamp',
     Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
     OpenApi.validate('param', schema.getBlockByTimestamp.Params, {
       code: 'chain_id_invalid',

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

@@ -1,7 +1,7 @@
 import { Address, Hash } from 'ox'
 
-import * as TestApp from '../../test/App.js'
-import * as Runtime from '../../test/runtime.js'
+import * as TestApp from '../../../../test/App.js'
+import * as Runtime from '../../../../test/runtime.js'
 import * as Coingecko from './coingecko.js'
 
 // The adapter addresses the chain positionally, mirroring the legacy `/gecko`

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 'cadent'
+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/{indexer.test.ts → data/routes/indexer.test.ts}

@@ -1,9 +1,9 @@
-import { RateLimit, Store } from 'cadent'
-import * as TestApp from '../../test/App.js'
-import * as Mppx from '../../test/Mppx.js'
-import * as Runtime from '../../test/runtime.js'
-import * as Tempo from '../../test/Tempo.js'
-import * as Tidx from '../internal/Tidx.js'
+import { RateLimit, Store } from 'tapimo'
+import * as TestApp from '../../../../test/App.js'
+import * as Mppx from '../../../../test/Mppx.js'
+import * as Runtime from '../../../../test/runtime.js'
+import * as Tempo from '../../../../test/Tempo.js'
+import * as Tidx from '../../../internal/Tidx.js'
 import * as Indexer from './indexer.js'
 
 const chainId = String(Runtime.get().chainId)
@@ -84,6 +84,27 @@ describe('GET /indexer/query', () => {
     }
   })
 
+  test('forwards chain aliases to the upstream as numeric ids', async () => {
+    const fetch = vi.spyOn(globalThis, 'fetch').mockResolvedValue(
+      new Response(JSON.stringify({ columns: [], ok: true, row_count: 0, rows: [] }), {
+        headers: { 'content-type': 'application/json' },
+      }),
+    )
+    try {
+      const client = TestApp.client()
+      const response = await client.v1.indexer.query.$get(
+        { query: { chainId: 'mainnet', sql: 'select 2' } },
+        TestApp.auth,
+      )
+
+      expect(response.status).toMatchInlineSnapshot(`200`)
+      const upstream = new URL((fetch.mock.calls[0]![0] as Request).url)
+      expect(upstream.searchParams.get('chainId')).toMatchInlineSnapshot(`"4217"`)
+    } finally {
+      fetch.mockRestore()
+    }
+  })
+
   test('requires authentication', async () => {
     const client = TestApp.client()
     const response = await client.v1.indexer.query.$get(

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

@@ -1,14 +1,14 @@
 import { Hono, type Context, type TypedResponse } from 'hono'
 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 Path from '../internal/Path.js'
-import * as Response from '../internal/Response.js'
-import * as Schema from '../internal/Schema.js'
-import * as Tidx from '../internal/Tidx.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 Path from '../../../internal/Path.js'
+import * as Response from '../../../internal/Response.js'
+import * as Schema from '../../../internal/Schema.js'
+import * as Tidx from '../../../internal/Tidx.js'
 
 // Request headers that must not be forwarded upstream: hop-by-hop headers, the
 // inbound host, and any caller auth so the consumer's Tempo API credentials never
@@ -98,7 +98,7 @@ export function indexer() {
   })
 
   return new Hono<App.Environment>().get(
-    '/query',
+    '/v1/indexer/query',
     Auth.policy({ apiKey: { scopes: ['indexer:query'] }, mpp: true, public: true }),
     OpenApi.describeRoute({
       description:
@@ -250,7 +250,7 @@ async function passthrough(
 
   // Resolve the upstream base URL per chain so mainnet and testnet
   // requests reach the correct indexer.
-  const chainIdParam = c.req.query('chainId')
+  const chainIdParam = c.req.query('chainId') ?? c.req.query('chain_id')
   const parsed = chainIdParam ? Schema.ChainId.safeParse(chainIdParam) : undefined
   const chainId = parsed?.success ? parsed.data : c.get('chainId')
   // Resolve the upstream for this caller. A resolver `tidx` can route by
@@ -275,6 +275,9 @@ async function passthrough(
   const upstream = new URL(baseUrl)
   upstream.pathname = Path.join(upstream.pathname, rest)
   upstream.search = requestUrl.search
+  if (parsed?.success)
+    for (const key of ['chainId', 'chain_id'])
+      if (upstream.searchParams.has(key)) upstream.searchParams.set(key, String(chainId))
 
   // Enforce the documented execution bounds server-side: an arbitrary SELECT
   // from an anonymous caller is always bounded even if the upstream's own

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

@@ -1,10 +1,10 @@
-import { Schema } from 'cadent'
+import { Schema } from 'tapimo'
 import { Hex } from 'ox'
 import { zeroHash } from 'viem'
 
-import * as TestApp from '../../test/App.js'
-import * as Runtime from '../../test/runtime.js'
-import * as Viem from '../../test/Viem.js'
+import * as TestApp from '../../../../test/App.js'
+import * as Runtime from '../../../../test/runtime.js'
+import * as Viem from '../../../../test/Viem.js'
 import * as Receipts from './receipts.js'
 
 /** The decoded `type` names a humanized receipt may report. */

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

@@ -2,17 +2,17 @@ import { Hono, type Context } from 'hono'
 import { Hex } from 'ox'
 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 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 Tokens from './tokens.js'
 
 // Receipts and transactions deliberately form an import cycle (receipts reuses
@@ -455,7 +455,7 @@ export namespace schema {
 export function receipts() {
   return new Hono<App.Environment>()
     .get(
-      '/receipts',
+      '/v1/transactions/receipts',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.validate('query', schema.getReceipts.Query, {
         code: 'query_invalid',
@@ -548,7 +548,7 @@ export function receipts() {
       },
     )
     .get(
-      '/:transactionHash/receipt',
+      '/v1/transactions/:transactionHash/receipt',
       Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }),
       OpenApi.validate('param', schema.getReceipt.Params, {
         code: 'transaction_invalid',