feat(explorer): migrate Tempo API amount fields

Author: jxom

apps/explorer/package.json

@@ -52,7 +52,7 @@
 		"abitype": "catalog:",
 		"animejs": "catalog:",
 		"cva": "catalog:",
-		"hono": "catalog:",
+		"hono": "^4.12.31",
 		"midcut": "catalog:",
 		"ox": "catalog:",
 		"react": "catalog:",
@@ -81,11 +81,11 @@
 		"@types/react": "catalog:",
 		"@types/react-dom": "catalog:",
 		"@vitejs/plugin-react": "catalog:",
-		"cadent": "https://pkg.pr.new/tempoxyz/cadent@57613c4",
 		"eruda": "catalog:",
 		"rollup-plugin-visualizer": "catalog:",
 		"shiki": "catalog:",
 		"sonda": "catalog:",
+		"tapimo": "https://pkg.pr.new/tempoxyz/api/tapimo@500",
 		"tailwind-merge": "catalog:",
 		"tw-animate-css": "catalog:",
 		"typed-query-selector": "catalog:",

apps/explorer/src/lib/server/fee-amm.ts

@@ -17,12 +17,12 @@ export type FeeAmmPool = {
 	reserveUserToken: bigint
 	reserveValidatorToken: bigint
 	liquidityUsd: number
-	userTokenSymbol?: string | undefined
-	userTokenName?: string | undefined
-	userTokenDecimals?: number | undefined
-	validatorTokenSymbol?: string | undefined
-	validatorTokenName?: string | undefined
-	validatorTokenDecimals?: number | undefined
+	userTokenSymbol: string
+	userTokenName: string
+	userTokenDecimals: number
+	validatorTokenSymbol: string
+	validatorTokenName: string
+	validatorTokenDecimals: number
 }
 
 type PoolsResponse = InferResponseType<
@@ -47,11 +47,11 @@ export function mapFeeAmmPools(pools: PoolsResponse['data']): FeeAmmPool[] {
 			createdAt: parseTimestamp(pool.createdAt) ?? null,
 			latestMintAt: parseTimestamp(pool.lastMintAt) ?? null,
 			mintCount: pool.mintCount,
-			reserveUserToken: BigInt(pool.userToken.amount ?? 0),
-			reserveValidatorToken: BigInt(pool.validatorToken.amount ?? 0),
+			reserveUserToken: BigInt(pool.userAmount?.baseUnits ?? 0),
+			reserveValidatorToken: BigInt(pool.validatorAmount?.baseUnits ?? 0),
 			liquidityUsd:
-				Number(pool.userToken.formatted ?? 0) +
-				Number(pool.validatorToken.formatted ?? 0),
+				Number(pool.userAmount?.formatted ?? 0) +
+				Number(pool.validatorAmount?.formatted ?? 0),
 			userTokenName: pool.userToken.name,
 			userTokenSymbol: pool.userToken.symbol,
 			userTokenDecimals: pool.userToken.decimals,

apps/explorer/src/lib/server/tempo-api.ts

@@ -1,6 +1,5 @@
-import type * as cadent from 'cadent'
 import * as Sentry from '@sentry/cloudflare'
-import { hc } from 'hono/client'
+import { create } from 'tapimo/client'
 import { serverEnv, tempoApiUrl } from './env.ts'
 
 const ALERTABLE_STATUSES = new Set([402, 403, 429])
@@ -50,20 +49,17 @@ const instrumentedFetch: typeof fetch = async (input, init) => {
 /**
  * Typed client for the Tempo API. Server-side only.
  *
- * Built with hono's `hc` + the API's `App` type (instead of its
- * `Client.create`) so the package stays a type-only import: its runtime barrel
- * pulls the whole API server, including Node-only transitive dependencies
- * that can't load in the Workers runtime.
+ * Uses the API's client-only entrypoint, which keeps its Node-only server
+ * dependencies out of the Workers runtime.
  *
  * Consume with hono's `parseResponse` (throws on non-2xx, returns the typed
  * success body), or narrow manually with `response.status === 200`.
  *
  * Anonymous requests are rate-limited; deployments set `TEMPO_API_KEY`
  * (scopes: `data:read`, `indexer:query`).
  */
-export const api = hc<cadent.App.App>(tempoApiUrl, {
+export const api = create({
+	apiKey: serverEnv.TEMPO_API_KEY,
 	fetch: instrumentedFetch,
-	headers: serverEnv.TEMPO_API_KEY
-		? { 'tempo-api-key': serverEnv.TEMPO_API_KEY }
-		: undefined,
+	url: tempoApiUrl,
 })

apps/explorer/src/lib/server/token.ts

@@ -1,13 +1,10 @@
 import { createServerFn } from '@tanstack/react-start'
 import { type InferResponseType, parseResponse } from 'hono/client'
 import type { Address, Hex } from 'ox'
-import type { Config } from 'wagmi'
 import { getChainId } from 'wagmi/actions'
-import { Actions } from 'wagmi/tempo'
 import * as z from 'zod/mini'
 import { TOKEN_COUNT_MAX } from '#lib/constants'
 import { api } from '#lib/server/tempo-api'
-import { getVerifiedTokens } from '#lib/server/verified-tokens'
 import { zAddress } from '#lib/zod'
 import { getWagmiConfig } from '#wagmi.config.ts'
 
@@ -217,9 +214,9 @@ export type AccountTransfersApiResponse = {
 		timestamp: string | null
 		token: {
 			address: Address.Address
-			symbol?: string | undefined
-			decimals?: number | undefined
-			currency?: string | undefined
+			symbol: string
+			decimals: number
+			currency: string
 		}
 	}>
 	total: number
@@ -232,70 +229,6 @@ const EMPTY_ACCOUNT_TRANSFERS_RESPONSE: AccountTransfersApiResponse = {
 	totalCapped: false,
 }
 
-type TransferTokenMeta = {
-	symbol?: string | undefined
-	decimals?: number | undefined
-	currency?: string | undefined
-}
-
-const transferTokenMetaCache = new Map<string, CacheEntry<TransferTokenMeta>>()
-
-/**
- * Display metadata (symbol/decimals) for transfer-row tokens: the cached
- * verified list covers nearly every row for free; unknown tokens fall back to
- * one RPC metadata read each, memoized. (The API's `include=token` does the
- * same upstream but adds ~5s per page — resolve locally instead.)
- */
-async function getTransferTokenMeta(
-	chainId: number,
-	tokens: readonly Address.Address[],
-): Promise<Map<string, TransferTokenMeta>> {
-	const verified = await getVerifiedTokens(chainId)
-	const verifiedByAddress = new Map(
-		verified.map((token) => [token.address.toLowerCase(), token]),
-	)
-
-	const meta = new Map<string, TransferTokenMeta>()
-	const misses: Address.Address[] = []
-	for (const token of new Set(tokens.map((t) => t.toLowerCase()))) {
-		const entry = verifiedByAddress.get(token)
-		if (entry) {
-			meta.set(token, {
-				symbol: entry.symbol,
-				decimals: entry.decimals,
-				currency: entry.currency,
-			})
-			continue
-		}
-		const cached = transferTokenMetaCache.get(`${chainId}-${token}`)
-		if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
-			meta.set(token, cached.data)
-			continue
-		}
-		misses.push(token as Address.Address)
-	}
-
-	const config = getWagmiConfig()
-	await Promise.all(
-		misses.map(async (token) => {
-			const resolved = await Actions.token
-				.getMetadata(config as Config, { token })
-				.then(
-					(m): TransferTokenMeta => ({
-						symbol: m.symbol,
-						decimals: m.decimals,
-						currency: m.currency,
-					}),
-				)
-				.catch((): TransferTokenMeta => ({}))
-			meta.set(token.toLowerCase(), resolved)
-			setCached(transferTokenMetaCache, `${chainId}-${token}`, resolved)
-		}),
-	)
-
-	return meta
-}
-
 /**
  * Token transfers where the account is sender or recipient, across all
  * tokens (the address page's account-scoped Transfers tab). Rows span
@@ -321,31 +254,21 @@ export const fetchAccountTransfers = createServerFn({ method: 'POST' })
 				}),
 			)
 
-			const tokenMeta = await getTransferTokenMeta(
-				chainId,
-				page.data.map(
-					(transfer) => transfer.sourceToken.address as Address.Address,
-				),
-			)
-
 			return {
-				transfers: page.data.map((transfer) => {
-					const meta = tokenMeta.get(transfer.sourceToken.address.toLowerCase())
-					return {
-						from: transfer.sender as Address.Address,
-						to: transfer.recipient as Address.Address,
-						value: transfer.sourceToken.amount,
-						transactionHash: transfer.transactionHash as Hex.Hex,
-						blockNumber: String(transfer.blockNumber),
-						timestamp: transfer.timestamp ?? null,
-						token: {
-							address: transfer.sourceToken.address as Address.Address,
-							symbol: meta?.symbol,
-							decimals: meta?.decimals,
-							currency: meta?.currency,
-						},
-					}
-				}),
+				transfers: page.data.map((transfer) => ({
+					from: transfer.sender as Address.Address,
+					to: transfer.recipient as Address.Address,
+					value: transfer.sourceAmount.baseUnits,
+					transactionHash: transfer.transactionHash as Hex.Hex,
+					blockNumber: String(transfer.blockNumber),
+					timestamp: transfer.timestamp ?? null,
+					token: {
+						address: transfer.sourceToken.address as Address.Address,
+						symbol: transfer.sourceToken.symbol,
+						decimals: transfer.sourceToken.decimals,
+						currency: transfer.sourceToken.currency,
+					},
+				})),
 				...resolveTotal({
 					exactCount: page.meta?.totalCount,
 					exactCountCapped: page.meta?.totalCountCapped,
@@ -389,7 +312,7 @@ export const fetchTransfers = createServerFn({ method: 'POST' })
 				transfers: page.data.map((transfer) => ({
 					from: transfer.sender as Address.Address,
 					to: transfer.recipient as Address.Address,
-					value: transfer.sourceToken.amount,
+					value: transfer.sourceAmount.baseUnits,
 					transactionHash: transfer.transactionHash as Hex.Hex,
 					blockNumber: String(transfer.blockNumber),
 					timestamp: transfer.timestamp ?? null,

apps/explorer/test/fee-amm.node.test.ts

@@ -0,0 +1,62 @@
+import { describe, expect, it } from 'vitest'
+import { mapFeeAmmPools } from '#lib/server/fee-amm'
+
+describe('mapFeeAmmPools', () => {
+	it('maps reserve amounts separately from token metadata', () => {
+		const [pool] = mapFeeAmmPools([
+			{
+				createdAt: '2026-07-22T00:00:00.000Z',
+				id: `0x${'11'.repeat(32)}`,
+				lastMintAt: '2026-07-22T01:00:00.000Z',
+				mintCount: 2,
+				poolId: `0x${'11'.repeat(32)}`,
+				userAmount: {
+					baseUnits: '1250000',
+					currency: 'USD',
+					decimals: 6,
+					formatted: '1.25',
+				},
+				userToken: {
+					address: `0x${'22'.repeat(20)}`,
+					currency: 'USD',
+					decimals: 6,
+					name: 'Alpha USD',
+					symbol: 'aUSD',
+				},
+				validatorAmount: {
+					baseUnits: '2500000',
+					currency: 'USD',
+					decimals: 6,
+					formatted: '2.5',
+				},
+				validatorToken: {
+					address: `0x${'33'.repeat(20)}`,
+					currency: 'USD',
+					decimals: 6,
+					name: 'Beta USD',
+					symbol: 'bUSD',
+				},
+			},
+		])
+
+		expect(pool).toMatchInlineSnapshot(`
+			{
+			  "createdAt": 1784678400,
+			  "latestMintAt": 1784682000,
+			  "liquidityUsd": 3.75,
+			  "mintCount": 2,
+			  "poolId": "0x1111111111111111111111111111111111111111111111111111111111111111",
+			  "reserveUserToken": 1250000n,
+			  "reserveValidatorToken": 2500000n,
+			  "userToken": "0x2222222222222222222222222222222222222222",
+			  "userTokenDecimals": 6,
+			  "userTokenName": "Alpha USD",
+			  "userTokenSymbol": "aUSD",
+			  "validatorToken": "0x3333333333333333333333333333333333333333",
+			  "validatorTokenDecimals": 6,
+			  "validatorTokenName": "Beta USD",
+			  "validatorTokenSymbol": "bUSD",
+			}
+		`)
+	})
+})