tapimo 0.14.0 → 0.15.0

package/src/admin/ui/src/lib/routes.ts

@@ -0,0 +1,304 @@
+import * as ReactQuery from '@tanstack/react-query'
+import type { InferResponseType } from 'hono/client'
+import * as z from 'zod/mini'
+
+import { client } from './client.js'
+
+const resources = ['transfers', 'deposits', 'deposit-addresses'] as const
+const statuses = [
+  'action-required',
+  'active',
+  'awaiting-source',
+  'bridging',
+  'completed',
+  'deactivated',
+  'detected',
+  'expired',
+  'processing',
+  'refunded',
+  'refunding',
+  'settling',
+] as const
+
+/** Schemas shared by admin provider routes. */
+export namespace schema {
+  /** URL-backed filters for the admin routes page. */
+  export const Search = z.object({
+    depositAddressId: z.catch(z.optional(z.string()), undefined),
+    environments: z.catch(
+      z.optional(z.readonly(z.array(z.enum(['production', 'sandbox'])))),
+      undefined,
+    ),
+    inProgress: z.catch(z.optional(z.literal('true')), undefined),
+    methods: z.catch(
+      z.optional(z.readonly(z.array(z.enum(['depositAddress', 'transaction'])))),
+      undefined,
+    ),
+    needsAttention: z.catch(z.optional(z.literal('true')), undefined),
+    orgId: z.catch(z.optional(z.string()), undefined),
+    projectId: z.catch(z.optional(z.string()), undefined),
+    providers: z.catch(z.optional(z.readonly(z.array(z.string()))), undefined),
+    query: z.catch(z.optional(z.string()), undefined),
+    resource: z.catch(z.optional(z.enum(resources)), undefined),
+    selected: z.catch(z.optional(z.string()), undefined),
+    sourceChains: z.catch(z.optional(z.readonly(z.array(z.string()))), undefined),
+    statuses: z.catch(z.optional(z.readonly(z.array(z.enum(statuses)))), undefined),
+  })
+}
+
+/** Parsed routes page search state. */
+export type Search = z.output<typeof schema.Search>
+
+/** Read the published route support matrix. */
+export namespace support {
+  /** Published route support matrix. */
+  export type Data = InferResponseType<(typeof client.routes.support)['$get'], 200>
+
+  /** One source-to-destination route in the support matrix. */
+  export type Item = Data['data'][number]
+
+  /** Stable query key for the route support matrix. */
+  export const key = ['routes', 'support', 'v1'] as const
+
+  /** Returns the published route support matrix. */
+  export async function fn() {
+    const response = await client.routes.support.$get()
+    if (!response.ok) throw new Error('Failed to load route support.')
+    return response.json() as Promise<Data>
+  }
+
+  /** Creates a cached route support query. */
+  export function options() {
+    return ReactQuery.queryOptions({ queryFn: fn, queryKey: key, staleTime: 30_000 })
+  }
+}
+
+type CommonFilters = Pick<
+  Search,
+  'environments' | 'methods' | 'orgId' | 'projectId' | 'providers' | 'sourceChains'
+>
+type WorkFilters = Pick<Search, 'inProgress' | 'needsAttention'>
+
+/** Read current routes work totals. */
+export namespace summary {
+  /** Current routes work totals. */
+  export type Data = InferResponseType<(typeof client.routes.summary)['$get'], 200>
+
+  /** Returns the routes summary for the selected filters. */
+  export async function fn(options: CommonFilters) {
+    const response = await client.routes.summary.$get({ query: serializeQuery(options) })
+    if (!response.ok) throw new Error('Failed to load the routes summary.')
+    return response.json() as Promise<Data>
+  }
+
+  /** Creates a cached routes summary query. */
+  export function options(options: CommonFilters) {
+    return ReactQuery.queryOptions({
+      queryFn: () => fn(options),
+      queryKey: ['routes', 'summary', options],
+      staleTime: 15_000,
+    })
+  }
+}
+
+/** List route transfers. */
+export namespace listTransfers {
+  /** One page of route transfers. */
+  export type Data = InferResponseType<(typeof client.routes.transfers)['$get'], 200>
+
+  /** One route transfer list row. */
+  export type Item = Data['data'][number]
+
+  /** Route transfer list filters. */
+  export type Options = CommonFilters &
+    WorkFilters &
+    Pick<Search, 'query'> & {
+      /** Route transfer lifecycle statuses. */
+      statuses?: readonly Item['status'][] | undefined
+    }
+
+  /** Returns one page of route transfers. */
+  export async function fn(options: Options & { cursor?: string | undefined }) {
+    const response = await client.routes.transfers.$get({
+      query: { ...serializeQuery(options), limit: '25' },
+    })
+    if (!response.ok) throw new Error('Failed to load route transfers.')
+    return response.json() as Promise<Data>
+  }
+
+  /** Creates a paginated route transfer query. */
+  export function options(options: Options) {
+    return ReactQuery.infiniteQueryOptions({
+      getNextPageParam: (page: Data) => page.nextCursor ?? undefined,
+      initialPageParam: null as string | null,
+      queryFn: ({ pageParam }) => fn({ ...options, cursor: pageParam ?? undefined }),
+      queryKey: ['routes', 'transfers', options],
+      staleTime: 15_000,
+    })
+  }
+}
+
+/** Read one route transfer. */
+export namespace getTransfer {
+  /** Detailed route transfer evidence. */
+  export type Data = InferResponseType<(typeof client.routes.transfers)[':id']['$get'], 200>
+
+  /** Returns one route transfer with lifecycle evidence. */
+  export async function fn(id: string) {
+    const response = await client.routes.transfers[':id'].$get({ param: { id } })
+    if (response.status === 404) throw new Error('Route transfer not found.')
+    if (!response.ok) throw new Error('Failed to load the route transfer.')
+    return response.json() as Promise<Data>
+  }
+
+  /** Creates a cached route transfer detail query. */
+  export function options(id: string) {
+    return ReactQuery.queryOptions({
+      queryFn: () => fn(id),
+      queryKey: ['routes', 'transfers', id],
+      staleTime: 15_000,
+    })
+  }
+}
+
+/** List detected route deposits. */
+export namespace listDeposits {
+  /** One page of detected route deposits. */
+  export type Data = InferResponseType<(typeof client.routes.deposits)['$get'], 200>
+
+  /** One route deposit list row. */
+  export type Item = Data['data'][number]
+
+  /** Route deposit list filters. */
+  export type Options = Omit<CommonFilters, 'methods'> &
+    WorkFilters &
+    Pick<Search, 'depositAddressId' | 'query'> & {
+      /** Route deposit lifecycle statuses. */
+      statuses?: readonly Item['status'][] | undefined
+    }
+
+  /** Returns one page of detected route deposits. */
+  export async function fn(options: Options & { cursor?: string | undefined }) {
+    const response = await client.routes.deposits.$get({
+      query: { ...serializeQuery(options), limit: '25' },
+    })
+    if (!response.ok) throw new Error('Failed to load route deposits.')
+    return response.json() as Promise<Data>
+  }
+
+  /** Creates a paginated route deposit query. */
+  export function options(options: Options) {
+    return ReactQuery.infiniteQueryOptions({
+      getNextPageParam: (page: Data) => page.nextCursor ?? undefined,
+      initialPageParam: null as string | null,
+      queryFn: ({ pageParam }) => fn({ ...options, cursor: pageParam ?? undefined }),
+      queryKey: ['routes', 'deposits', options],
+      staleTime: 15_000,
+    })
+  }
+}
+
+/** Read one detected route deposit. */
+export namespace getDeposit {
+  /** Detailed route deposit evidence. */
+  export type Data = InferResponseType<(typeof client.routes.deposits)[':id']['$get'], 200>
+
+  /** Returns one route deposit with its reusable address. */
+  export async function fn(id: string) {
+    const response = await client.routes.deposits[':id'].$get({ param: { id } })
+    if (response.status === 404) throw new Error('Route deposit not found.')
+    if (!response.ok) throw new Error('Failed to load the route deposit.')
+    return response.json() as Promise<Data>
+  }
+
+  /** Creates a cached route deposit detail query. */
+  export function options(id: string) {
+    return ReactQuery.queryOptions({
+      queryFn: () => fn(id),
+      queryKey: ['routes', 'deposits', id],
+      staleTime: 15_000,
+    })
+  }
+}
+
+/** List reusable route deposit addresses. */
+export namespace listDepositAddresses {
+  /** One page of reusable route deposit addresses. */
+  export type Data = InferResponseType<(typeof client.routes)['deposit-addresses']['$get'], 200>
+
+  /** One reusable route deposit address list row. */
+  export type Item = Data['data'][number]
+
+  /** Reusable deposit-address list filters. */
+  export type Options = Omit<CommonFilters, 'methods'> &
+    WorkFilters &
+    Pick<Search, 'query'> & {
+      /** Deposit-address lifecycle statuses. */
+      statuses?: readonly Item['status'][] | undefined
+    }
+
+  /** Returns one page of reusable route deposit addresses. */
+  export async function fn(options: Options & { cursor?: string | undefined }) {
+    const response = await client.routes['deposit-addresses'].$get({
+      query: { ...serializeQuery(options), limit: '25' },
+    })
+    if (!response.ok) throw new Error('Failed to load route deposit addresses.')
+    return response.json() as Promise<Data>
+  }
+
+  /** Creates a paginated deposit-address query. */
+  export function options(options: Options) {
+    return ReactQuery.infiniteQueryOptions({
+      getNextPageParam: (page: Data) => page.nextCursor ?? undefined,
+      initialPageParam: null as string | null,
+      queryFn: ({ pageParam }) => fn({ ...options, cursor: pageParam ?? undefined }),
+      queryKey: ['routes', 'deposit-addresses', options],
+      staleTime: 15_000,
+    })
+  }
+}
+
+function serializeQuery<
+  const options extends Partial<
+    Record<
+      'environments' | 'methods' | 'providers' | 'sourceChains' | 'statuses',
+      readonly string[] | undefined
+    >
+  >,
+>(options: options) {
+  const { environments, methods, providers, sourceChains, statuses, ...rest } = options
+  return {
+    ...rest,
+    environment: environments?.join(','),
+    method: methods?.join(','),
+    provider: providers?.join(','),
+    sourceChain: sourceChains?.join(','),
+    status: statuses?.join(','),
+  }
+}
+
+/** Read one reusable route deposit address. */
+export namespace getDepositAddress {
+  /** Detailed reusable route deposit address. */
+  export type Data = InferResponseType<
+    (typeof client.routes)['deposit-addresses'][':id']['$get'],
+    200
+  >
+
+  /** Returns one reusable route deposit address. */
+  export async function fn(id: string) {
+    const response = await client.routes['deposit-addresses'][':id'].$get({ param: { id } })
+    if (response.status === 404) throw new Error('Route deposit address not found.')
+    if (!response.ok) throw new Error('Failed to load the route deposit address.')
+    return response.json() as Promise<Data>
+  }
+
+  /** Creates a cached deposit-address detail query. */
+  export function options(id: string) {
+    return ReactQuery.queryOptions({
+      queryFn: () => fn(id),
+      queryKey: ['routes', 'deposit-addresses', id],
+      staleTime: 15_000,
+    })
+  }
+}

package/src/admin/ui/src/lib/subsidies.ts

@@ -0,0 +1,75 @@
+import * as ReactQuery from '@tanstack/react-query'
+import type { InferResponseType } from 'hono/client'
+import * as z from 'zod/mini'
+
+import { client } from './client.js'
+
+/** Schemas shared by the admin subsidies page. */
+export namespace schema {
+  /** URL-backed subsidy tab state. */
+  export const Search = z.object({
+    selected: z.catch(z.optional(z.string()), undefined),
+    tab: z.catch(z.optional(z.enum(['routes', 'transactions'])), undefined),
+  })
+}
+
+/** Parsed subsidies page search state. */
+export type Search = z.output<typeof schema.Search>
+
+/** List managed fee-payer transactions. */
+export namespace listTransactions {
+  /** One page of managed fee-payer transactions. */
+  export type Data = InferResponseType<(typeof client.subsidies.transactions)['$get'], 200>
+
+  /** One managed fee-payer transaction. */
+  export type Item = Data['data'][number]
+
+  /** Returns one page of managed fee-payer transactions. */
+  export async function fn(options: { cursor?: string | undefined }) {
+    const response = await client.subsidies.transactions.$get({
+      query: { ...options, limit: '25' },
+    })
+    if (!response.ok) throw new Error('Failed to load subsidy transactions.')
+    return response.json() as Promise<Data>
+  }
+
+  /** Creates a paginated managed fee-payer transaction query. */
+  export function options() {
+    return ReactQuery.infiniteQueryOptions({
+      getNextPageParam: (page: Data) => page.nextCursor ?? undefined,
+      initialPageParam: null as string | null,
+      queryFn: ({ pageParam }) => fn({ cursor: pageParam ?? undefined }),
+      queryKey: ['subsidies', 'transactions'],
+      staleTime: 15_000,
+    })
+  }
+}
+
+/** List route subsidy records. */
+export namespace listRoutes {
+  /** One page of route subsidy records. */
+  export type Data = InferResponseType<(typeof client.subsidies.routes)['$get'], 200>
+
+  /** One route subsidy record. */
+  export type Item = Data['data'][number]
+
+  /** Returns one page of route subsidy records. */
+  export async function fn(options: { cursor?: string | undefined }) {
+    const response = await client.subsidies.routes.$get({
+      query: { ...options, limit: '25' },
+    })
+    if (!response.ok) throw new Error('Failed to load route subsidies.')
+    return response.json() as Promise<Data>
+  }
+
+  /** Creates a paginated route subsidy query. */
+  export function options() {
+    return ReactQuery.infiniteQueryOptions({
+      getNextPageParam: (page: Data) => page.nextCursor ?? undefined,
+      initialPageParam: null as string | null,
+      queryFn: ({ pageParam }) => fn({ cursor: pageParam ?? undefined }),
+      queryKey: ['subsidies', 'routes'],
+      staleTime: 15_000,
+    })
+  }
+}

package/src/admin/ui/src/routeTree.gen.ts

@@ -10,10 +10,13 @@
 
 import { Route as rootRouteImport } from './routes/__root.js'
 import { Route as VerifiedTokensRouteImport } from './routes/verified-tokens.js'
+import { Route as SubsidiesRouteImport } from './routes/subsidies.js'
+import { Route as RoutesRouteImport } from './routes/routes.js'
 import { Route as OrganizationsRouteImport } from './routes/organizations.js'
 import { Route as EarlyAccessRouteImport } from './routes/early-access.js'
 import { Route as ApiKeysRouteImport } from './routes/api-keys.js'
 import { Route as IndexRouteImport } from './routes/index.js'
+import { Route as RoutesSupportRouteImport } from './routes/routes_.support.js'
 import { Route as OrganizationsOrgIdRouteImport } from './routes/organizations_.$orgId.js'
 import { Route as EarnVaultsRouteImport } from './routes/earn.vaults.js'
 import { Route as EarnVaultsNewRouteImport } from './routes/earn.vaults_.new.js'
@@ -24,6 +27,16 @@ const VerifiedTokensRoute = VerifiedTokensRouteImport.update({
   path: '/verified-tokens',
   getParentRoute: () => rootRouteImport,
 } as any)
+const SubsidiesRoute = SubsidiesRouteImport.update({
+  id: '/subsidies',
+  path: '/subsidies',
+  getParentRoute: () => rootRouteImport,
+} as any)
+const RoutesRoute = RoutesRouteImport.update({
+  id: '/routes',
+  path: '/routes',
+  getParentRoute: () => rootRouteImport,
+} as any)
 const OrganizationsRoute = OrganizationsRouteImport.update({
   id: '/organizations',
   path: '/organizations',
@@ -44,6 +57,11 @@ const IndexRoute = IndexRouteImport.update({
   path: '/',
   getParentRoute: () => rootRouteImport,
 } as any)
+const RoutesSupportRoute = RoutesSupportRouteImport.update({
+  id: '/routes_/support',
+  path: '/routes/support',
+  getParentRoute: () => rootRouteImport,
+} as any)
 const OrganizationsOrgIdRoute = OrganizationsOrgIdRouteImport.update({
   id: '/organizations_/$orgId',
   path: '/organizations/$orgId',
@@ -70,9 +88,12 @@ export interface FileRoutesByFullPath {
   '/api-keys': typeof ApiKeysRoute
   '/early-access': typeof EarlyAccessRoute
   '/organizations': typeof OrganizationsRoute
+  '/routes': typeof RoutesRoute
+  '/subsidies': typeof SubsidiesRoute
   '/verified-tokens': typeof VerifiedTokensRoute
   '/earn/vaults': typeof EarnVaultsRoute
   '/organizations/$orgId': typeof OrganizationsOrgIdRoute
+  '/routes/support': typeof RoutesSupportRoute
   '/earn/vaults/new': typeof EarnVaultsNewRoute
   '/earn/vaults/$vaultId/edit': typeof EarnVaultsVaultIdEditRoute
 }
@@ -81,9 +102,12 @@ export interface FileRoutesByTo {
   '/api-keys': typeof ApiKeysRoute
   '/early-access': typeof EarlyAccessRoute
   '/organizations': typeof OrganizationsRoute
+  '/routes': typeof RoutesRoute
+  '/subsidies': typeof SubsidiesRoute
   '/verified-tokens': typeof VerifiedTokensRoute
   '/earn/vaults': typeof EarnVaultsRoute
   '/organizations/$orgId': typeof OrganizationsOrgIdRoute
+  '/routes/support': typeof RoutesSupportRoute
   '/earn/vaults/new': typeof EarnVaultsNewRoute
   '/earn/vaults/$vaultId/edit': typeof EarnVaultsVaultIdEditRoute
 }
@@ -93,9 +117,12 @@ export interface FileRoutesById {
   '/api-keys': typeof ApiKeysRoute
   '/early-access': typeof EarlyAccessRoute
   '/organizations': typeof OrganizationsRoute
+  '/routes': typeof RoutesRoute
+  '/subsidies': typeof SubsidiesRoute
   '/verified-tokens': typeof VerifiedTokensRoute
   '/earn/vaults': typeof EarnVaultsRoute
   '/organizations_/$orgId': typeof OrganizationsOrgIdRoute
+  '/routes_/support': typeof RoutesSupportRoute
   '/earn/vaults_/new': typeof EarnVaultsNewRoute
   '/earn/vaults_/$vaultId/edit': typeof EarnVaultsVaultIdEditRoute
 }
@@ -106,9 +133,12 @@ export interface FileRouteTypes {
     | '/api-keys'
     | '/early-access'
     | '/organizations'
+    | '/routes'
+    | '/subsidies'
     | '/verified-tokens'
     | '/earn/vaults'
     | '/organizations/$orgId'
+    | '/routes/support'
     | '/earn/vaults/new'
     | '/earn/vaults/$vaultId/edit'
   fileRoutesByTo: FileRoutesByTo
@@ -117,9 +147,12 @@ export interface FileRouteTypes {
     | '/api-keys'
     | '/early-access'
     | '/organizations'
+    | '/routes'
+    | '/subsidies'
     | '/verified-tokens'
     | '/earn/vaults'
     | '/organizations/$orgId'
+    | '/routes/support'
     | '/earn/vaults/new'
     | '/earn/vaults/$vaultId/edit'
   id:
@@ -128,9 +161,12 @@ export interface FileRouteTypes {
     | '/api-keys'
     | '/early-access'
     | '/organizations'
+    | '/routes'
+    | '/subsidies'
     | '/verified-tokens'
     | '/earn/vaults'
     | '/organizations_/$orgId'
+    | '/routes_/support'
     | '/earn/vaults_/new'
     | '/earn/vaults_/$vaultId/edit'
   fileRoutesById: FileRoutesById
@@ -140,9 +176,12 @@ export interface RootRouteChildren {
   ApiKeysRoute: typeof ApiKeysRoute
   EarlyAccessRoute: typeof EarlyAccessRoute
   OrganizationsRoute: typeof OrganizationsRoute
+  RoutesRoute: typeof RoutesRoute
+  SubsidiesRoute: typeof SubsidiesRoute
   VerifiedTokensRoute: typeof VerifiedTokensRoute
   EarnVaultsRoute: typeof EarnVaultsRoute
   OrganizationsOrgIdRoute: typeof OrganizationsOrgIdRoute
+  RoutesSupportRoute: typeof RoutesSupportRoute
   EarnVaultsNewRoute: typeof EarnVaultsNewRoute
   EarnVaultsVaultIdEditRoute: typeof EarnVaultsVaultIdEditRoute
 }
@@ -156,6 +195,20 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof VerifiedTokensRouteImport
       parentRoute: typeof rootRouteImport
     }
+    '/subsidies': {
+      id: '/subsidies'
+      path: '/subsidies'
+      fullPath: '/subsidies'
+      preLoaderRoute: typeof SubsidiesRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/routes': {
+      id: '/routes'
+      path: '/routes'
+      fullPath: '/routes'
+      preLoaderRoute: typeof RoutesRouteImport
+      parentRoute: typeof rootRouteImport
+    }
     '/organizations': {
       id: '/organizations'
       path: '/organizations'
@@ -184,6 +237,13 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof IndexRouteImport
       parentRoute: typeof rootRouteImport
     }
+    '/routes_/support': {
+      id: '/routes_/support'
+      path: '/routes/support'
+      fullPath: '/routes/support'
+      preLoaderRoute: typeof RoutesSupportRouteImport
+      parentRoute: typeof rootRouteImport
+    }
     '/organizations_/$orgId': {
       id: '/organizations_/$orgId'
       path: '/organizations/$orgId'
@@ -220,9 +280,12 @@ const rootRouteChildren: RootRouteChildren = {
   ApiKeysRoute: ApiKeysRoute,
   EarlyAccessRoute: EarlyAccessRoute,
   OrganizationsRoute: OrganizationsRoute,
+  RoutesRoute: RoutesRoute,
+  SubsidiesRoute: SubsidiesRoute,
   VerifiedTokensRoute: VerifiedTokensRoute,
   EarnVaultsRoute: EarnVaultsRoute,
   OrganizationsOrgIdRoute: OrganizationsOrgIdRoute,
+  RoutesSupportRoute: RoutesSupportRoute,
   EarnVaultsNewRoute: EarnVaultsNewRoute,
   EarnVaultsVaultIdEditRoute: EarnVaultsVaultIdEditRoute,
 }

package/src/admin/ui/src/routes/__root.tsx

@@ -10,7 +10,16 @@ import type { QueryClient } from '@tanstack/react-query'
 import { PersistQueryClientProvider } from '@tanstack/react-query-persist-client'
 import { type ComponentType } from 'react'
 import { Button, Identicon } from 'regen-ui'
-import { BadgeCheck, Building2, KeyRound, Landmark, LogOut, Ticket } from 'lucide-react'
+import {
+  BadgeCheck,
+  BadgeDollarSign,
+  Building2,
+  KeyRound,
+  Landmark,
+  LogOut,
+  Ticket,
+  Waypoints,
+} from 'lucide-react'
 import { WagmiProvider } from 'wagmi'
 
 import appCss from '../styles.css?url'
@@ -115,6 +124,8 @@ const nav = [
   { exact: false, href: '/organizations', icon: Building2, label: 'Organizations' },
   { exact: false, href: '/api-keys', icon: KeyRound, label: 'API Keys' },
   { exact: false, href: '/verified-tokens', icon: BadgeCheck, label: 'Verified Tokens' },
+  { exact: false, href: '/routes', icon: Waypoints, label: 'Routes' },
+  { exact: false, href: '/subsidies', icon: BadgeDollarSign, label: 'Subsidies' },
   { exact: false, href: '/earn/vaults', icon: Landmark, label: 'Earn Vaults' },
   { exact: false, href: '/early-access', icon: Ticket, label: 'Early Access' },
 ] as const