tapimo 0.15.0 → 0.18.0

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

@@ -161,6 +161,40 @@ export namespace getTransfer {
   }
 }
 
+/** Retry one stuck route transfer. */
+export namespace retryTransfer {
+  /** Transfer to retry at the version the operator reviewed. */
+  export type Input = {
+    /** Route transfer id. */
+    id: string
+    /** Reviewed transfer version. */
+    version: number
+  }
+
+  /** Returns an action-required transfer to processing for reconciliation. */
+  export async function fn(options: Input) {
+    const response = await client.routes.transfers[':id'].retry.$post({
+      json: { version: options.version },
+      param: { id: options.id },
+    })
+    if (response.status === 409) {
+      const { error } = await response.json()
+      throw new Error(error.message)
+    }
+    if (!response.ok) throw new Error('Failed to retry the route transfer.')
+    return response.json()
+  }
+
+  /** Creates a mutation that retries a transfer and refreshes routes queries. */
+  export function useMutation() {
+    const queryClient = ReactQuery.useQueryClient()
+    return ReactQuery.useMutation({
+      mutationFn: fn,
+      onSuccess: () => queryClient.invalidateQueries({ queryKey: ['routes'] }),
+    })
+  }
+}
+
 /** List detected route deposits. */
 export namespace listDeposits {
   /** One page of detected route deposits. */

package/src/admin/ui/src/lib/verified-tokens.ts

@@ -76,26 +76,41 @@ export namespace create {
 
 /** Review queue over organization verification requests. */
 export namespace requests {
+  /** One page returned by the queue endpoint. */
+  export type Data = InferResponseType<(typeof client)['verified-tokens']['requests']['$get'], 200>
+
   /** A verification request record from the queue endpoint. */
-  export type VerifiedTokenRequest = InferResponseType<
-    (typeof client)['verified-tokens']['requests']['$get'],
-    200
-  >['data'][number]
+  export type VerifiedTokenRequest = Data['data'][number]
 
   export namespace list {
     export function key() {
       return ['verified-token-requests'] as const
     }
-    export async function fn() {
-      const response = await client['verified-tokens'].requests.$get({ query: {} })
+    export async function fn(options: fn.Options) {
+      const response = await client['verified-tokens'].requests.$get({
+        query: { ...options, limit: '5' },
+      })
       if (!response.ok) throw new Error('Failed to load requests.')
-      return response.json()
+      return response.json() as Promise<Data>
+    }
+    export declare namespace fn {
+      /** Review-queue page selection. */
+      type Options = {
+        /** Cursor after the previous loaded page. */
+        cursor?: string | undefined
+      }
     }
     export function options() {
-      return ReactQuery.queryOptions({ queryFn: fn, queryKey: key(), staleTime: 30_000 })
+      return ReactQuery.infiniteQueryOptions({
+        getNextPageParam: (page: Data) => page.nextCursor ?? undefined,
+        initialPageParam: null as string | null,
+        queryFn: ({ pageParam }): Promise<Data> => fn({ cursor: pageParam ?? undefined }),
+        queryKey: key(),
+        staleTime: 30_000,
+      })
     }
     export function useQuery() {
-      return ReactQuery.useQuery(options())
+      return ReactQuery.useInfiniteQuery(options())
     }
   }
 

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

@@ -12,6 +12,7 @@ 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 RoutePoliciesRouteImport } from './routes/route-policies.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'
@@ -37,6 +38,11 @@ const RoutesRoute = RoutesRouteImport.update({
   path: '/routes',
   getParentRoute: () => rootRouteImport,
 } as any)
+const RoutePoliciesRoute = RoutePoliciesRouteImport.update({
+  id: '/route-policies',
+  path: '/route-policies',
+  getParentRoute: () => rootRouteImport,
+} as any)
 const OrganizationsRoute = OrganizationsRouteImport.update({
   id: '/organizations',
   path: '/organizations',
@@ -88,6 +94,7 @@ export interface FileRoutesByFullPath {
   '/api-keys': typeof ApiKeysRoute
   '/early-access': typeof EarlyAccessRoute
   '/organizations': typeof OrganizationsRoute
+  '/route-policies': typeof RoutePoliciesRoute
   '/routes': typeof RoutesRoute
   '/subsidies': typeof SubsidiesRoute
   '/verified-tokens': typeof VerifiedTokensRoute
@@ -102,6 +109,7 @@ export interface FileRoutesByTo {
   '/api-keys': typeof ApiKeysRoute
   '/early-access': typeof EarlyAccessRoute
   '/organizations': typeof OrganizationsRoute
+  '/route-policies': typeof RoutePoliciesRoute
   '/routes': typeof RoutesRoute
   '/subsidies': typeof SubsidiesRoute
   '/verified-tokens': typeof VerifiedTokensRoute
@@ -117,6 +125,7 @@ export interface FileRoutesById {
   '/api-keys': typeof ApiKeysRoute
   '/early-access': typeof EarlyAccessRoute
   '/organizations': typeof OrganizationsRoute
+  '/route-policies': typeof RoutePoliciesRoute
   '/routes': typeof RoutesRoute
   '/subsidies': typeof SubsidiesRoute
   '/verified-tokens': typeof VerifiedTokensRoute
@@ -133,6 +142,7 @@ export interface FileRouteTypes {
     | '/api-keys'
     | '/early-access'
     | '/organizations'
+    | '/route-policies'
     | '/routes'
     | '/subsidies'
     | '/verified-tokens'
@@ -147,6 +157,7 @@ export interface FileRouteTypes {
     | '/api-keys'
     | '/early-access'
     | '/organizations'
+    | '/route-policies'
     | '/routes'
     | '/subsidies'
     | '/verified-tokens'
@@ -161,6 +172,7 @@ export interface FileRouteTypes {
     | '/api-keys'
     | '/early-access'
     | '/organizations'
+    | '/route-policies'
     | '/routes'
     | '/subsidies'
     | '/verified-tokens'
@@ -176,6 +188,7 @@ export interface RootRouteChildren {
   ApiKeysRoute: typeof ApiKeysRoute
   EarlyAccessRoute: typeof EarlyAccessRoute
   OrganizationsRoute: typeof OrganizationsRoute
+  RoutePoliciesRoute: typeof RoutePoliciesRoute
   RoutesRoute: typeof RoutesRoute
   SubsidiesRoute: typeof SubsidiesRoute
   VerifiedTokensRoute: typeof VerifiedTokensRoute
@@ -209,6 +222,13 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof RoutesRouteImport
       parentRoute: typeof rootRouteImport
     }
+    '/route-policies': {
+      id: '/route-policies'
+      path: '/route-policies'
+      fullPath: '/route-policies'
+      preLoaderRoute: typeof RoutePoliciesRouteImport
+      parentRoute: typeof rootRouteImport
+    }
     '/organizations': {
       id: '/organizations'
       path: '/organizations'
@@ -280,6 +300,7 @@ const rootRouteChildren: RootRouteChildren = {
   ApiKeysRoute: ApiKeysRoute,
   EarlyAccessRoute: EarlyAccessRoute,
   OrganizationsRoute: OrganizationsRoute,
+  RoutePoliciesRoute: RoutePoliciesRoute,
   RoutesRoute: RoutesRoute,
   SubsidiesRoute: SubsidiesRoute,
   VerifiedTokensRoute: VerifiedTokensRoute,

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

@@ -111,7 +111,7 @@ function Admin() {
     <div className="relative flex min-h-dvh min-w-[360px] bg-background max-md:h-dvh max-md:flex-col max-md:overflow-hidden">
       <div className="flex-1 bg-background max-md:hidden" />
       <Sidebar email={email} logoutUrl={logoutUrl} />
-      <main className="flex w-full max-w-[1024px] flex-col px-4 pt-5 pb-10 max-md:min-h-0 max-md:flex-1 max-md:overflow-y-auto sm:px-8">
+      <main className="flex min-w-0 w-full max-w-[1024px] flex-col px-4 pt-5 pb-10 max-md:min-h-0 max-md:flex-1 max-md:overflow-y-auto sm:px-8">
         <Outlet />
       </main>
       <div className="flex-1 max-md:hidden" />

package/src/admin/ui/src/routes/api-keys.tsx

@@ -1,5 +1,5 @@
 import { useInfiniteQuery } from '@tanstack/react-query'
-import { createFileRoute, useNavigate } from '@tanstack/react-router'
+import { createFileRoute, Link, useNavigate } from '@tanstack/react-router'
 import { type ReactNode, useEffect, useId, useState } from 'react'
 import { Button, cx, Fields, Input, Rows, Select, useCopy } from 'regen-ui'
 import {
@@ -25,6 +25,7 @@ import * as Organizations from '../lib/organizations.js'
 import * as Scopes from '../lib/scopes.js'
 
 export const Route = createFileRoute('/api-keys')({
+  head: () => ({ meta: [{ title: 'API Keys | Tempo API Admin' }] }),
   validateSearch: ApiKeys.search,
   loaderDeps: ({ search }) => search,
   loader: ({ context, deps }) =>
@@ -810,7 +811,25 @@ function KeyRow(props: { currentUser?: string | undefined; record: ApiKeys.ApiKe
               )}
             </Detail>
           </dl>
-          <div className="flex justify-end gap-2 border-t border-border px-5 py-3">
+          <div className="flex flex-wrap justify-end gap-2 border-t border-border px-5 py-3">
+            {record.scopes.includes('routes:write') && record.orgId !== record.id ? (
+              <Button
+                size="small"
+                render={
+                  <Link
+                    to="/route-policies"
+                    search={{
+                      apiKeyId: record.id,
+                      environment: record.environment,
+                      orgId: record.orgId,
+                      projectId: record.projectId,
+                    }}
+                  />
+                }
+              >
+                Manage route policies
+              </Button>
+            ) : null}
             <EditDialog record={record} />
             <RotateDialog record={record} />
             <RevokeDialog currentUser={currentUser} record={record} />

package/src/admin/ui/src/routes/early-access.tsx

@@ -9,6 +9,7 @@ import * as EarlyAccess from '../lib/early-access.js'
 import * as Format from '../lib/format.js'
 
 export const Route = createFileRoute('/early-access')({
+  head: () => ({ meta: [{ title: 'Early Access | Tempo API Admin' }] }),
   loader: ({ context }) => context.queryClient.prefetchQuery(EarlyAccess.list.options()),
   component: RouteComponent,
 })

package/src/admin/ui/src/routes/earn.vaults.tsx

@@ -16,6 +16,7 @@ const explorers: Record<EarnVaults.ChainId, string> = {
 
 /** Route listing verified Earn vaults. */
 export const Route = createFileRoute('/earn/vaults')({
+  head: () => ({ meta: [{ title: 'Earn Vaults | Tempo API Admin' }] }),
   validateSearch: EarnVaults.schema.Search,
   loaderDeps: ({ search }) => ({
     chainId: search.chainId ?? EarnVaults.defaultChain,

package/src/admin/ui/src/routes/earn.vaults_.$vaultId.edit.tsx

@@ -12,6 +12,7 @@ import * as RewardCampaigns from '../lib/reward-campaigns.js'
 
 /** Route for editing a verified Earn vault. */
 export const Route = createFileRoute('/earn/vaults_/$vaultId/edit')({
+  head: () => ({ meta: [{ title: 'Edit vault | Tempo API Admin' }] }),
   validateSearch: z.extend(EarnVaults.schema.Search, {
     tab: z.optional(z.union([z.literal('overview'), z.literal('rewards')])),
   }),
@@ -134,6 +135,20 @@ function Page() {
             placeholder="One token address per line"
             rows={3}
           />
+          <fieldset className="flex flex-col gap-3 border-t border-border pt-5">
+            <legend className="text-label-14 text-foreground">Zone Earn routers</legend>
+            {vault.zones?.map((route) => (
+              <p className="text-copy-13 text-foreground-secondary" key={route.earnRouter}>
+                Zone {route.chainId}: {route.earnRouter}
+              </p>
+            ))}
+            <EarnVaultForm.AddressInput label="Add parent-chain router address" name="zoneRouter" />
+            <p className="text-copy-13 text-foreground-secondary">
+              The API verifies the router bindings and finds its deployment block from historical
+              chain state. An archive RPC is required.
+            </p>
+          </fieldset>
+          <EarnVaultForm.Earnings value={vault.earnings} />
         </EarnVaultForm>
       </div>
       {rewardsVisited ? (
@@ -155,14 +170,21 @@ type VaultAddress = EarnVaults.InsertInput['vaultAddress']
 
 function inputFrom(form: FormData, options: inputFrom.Options): EarnVaults.InsertInput {
   const slug = field(form, 'slug')
+  const zoneRouter = addresses(form, 'zoneRouter')[0]
   return {
     chainId: options.chainId,
     description: field(form, 'description') || null,
+    earnings: form.has('inheritEarnings')
+      ? null
+      : {
+          rewardDistributors: addresses(form, 'rewardDistributors'),
+        },
     label: field(form, 'label'),
     privateInputTokens: addresses(form, 'privateInputTokens'),
     privateOutputTokens: addresses(form, 'privateOutputTokens'),
     ...(slug ? { slug } : {}),
     vaultAddress: options.vault.vaultAddress,
+    ...(zoneRouter ? { zoneRouter } : {}),
   }
 }
 

package/src/admin/ui/src/routes/earn.vaults_.new.tsx

@@ -10,6 +10,7 @@ import * as EarnVaults from '../lib/earn-vaults.js'
 
 /** Route for adding a verified Earn vault. */
 export const Route = createFileRoute('/earn/vaults_/new')({
+  head: () => ({ meta: [{ title: 'Add vault | Tempo API Admin' }] }),
   validateSearch: EarnVaults.schema.Search,
   component: Page,
 })
@@ -149,6 +150,10 @@ function Page() {
               placeholder="One token address per line"
               rows={3}
             />
+            <EarnVaultForm.Earnings
+              key={`${chainId}-${resolution.data.id}-earnings`}
+              value={resolution.data.earnings}
+            />
           </>
         ) : null}
       </EarnVaultForm>
@@ -163,6 +168,11 @@ function inputFrom(form: FormData, options: inputFrom.Options): EarnVaults.Inser
   return {
     chainId: options.chainId,
     description: field(form, 'description') || null,
+    earnings: form.has('inheritEarnings')
+      ? null
+      : {
+          rewardDistributors: addresses(form, 'rewardDistributors'),
+        },
     label: field(form, 'label'),
     privateInputTokens: addresses(form, 'privateInputTokens'),
     privateOutputTokens: addresses(form, 'privateOutputTokens'),

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

@@ -6,7 +6,7 @@ import {
   useNavigate,
   useRouter,
 } from '@tanstack/react-router'
-import { useEffect, useState } from 'react'
+import { useEffect, useRef, useState } from 'react'
 import { Button, Input, Rows } from 'regen-ui'
 import { ChevronRight, Search } from 'lucide-react'
 
@@ -15,6 +15,7 @@ import * as Format from '../lib/format.js'
 import * as Organizations from '../lib/organizations.js'
 
 export const Route = createFileRoute('/organizations')({
+  head: () => ({ meta: [{ title: 'Organizations | Tempo API Admin' }] }),
   validateSearch: Organizations.schema.Search,
   loaderDeps: ({ search }) => ({ query: search.query || undefined }),
   loader: ({ context, deps }) =>
@@ -27,20 +28,39 @@ function PageComponent() {
   const { query } = Route.useLoaderDeps()
   const navigate = useNavigate({ from: Route.fullPath })
   const [value, setValue] = useState(query ?? '')
+  const debouncedValue = useDebouncedValue(value, 300)
+  const submittedValue = useRef(query ?? '')
   const organizations = useSuspenseInfiniteQuery(Organizations.list.options({ query }))
   const records = organizations.data.pages.flatMap((page) => page.data)
   const invalid = value.trim().length > 0 && value.trim().length < 3
 
-  useEffect(() => setValue(query ?? ''), [query])
+  useEffect(() => {
+    if (value.trim() !== submittedValue.current) return
+    const next = query ?? ''
+    submittedValue.current = next
+    setValue(next)
+  }, [query, value])
+  useEffect(() => {
+    const next = debouncedValue.trim()
+    if (value.trim() !== next || (next.length > 0 && next.length < 3) || next === (query ?? ''))
+      return
+    submittedValue.current = next
+    void navigate({
+      replace: true,
+      search: Organizations.searchParameters({ query: next }),
+      to: '/organizations',
+    })
+  }, [debouncedValue, navigate, query, value])
 
   return (
     <Page title="Organizations" description="Look up organizations by id, name, or member email">
       <form
-        className="flex gap-2"
+        className="flex min-w-0 gap-2"
         onSubmit={(event) => {
           event.preventDefault()
           const next = value.trim()
           if (invalid) return
+          submittedValue.current = next
           void navigate({
             search: Organizations.searchParameters({ query: next }),
             to: '/organizations',
@@ -56,7 +76,7 @@ function PageComponent() {
             value={value}
           />
         </div>
-        <Button disabled={invalid} type="submit">
+        <Button className="shrink-0" disabled={invalid} type="submit">
           <Search className="size-4" />
           Search
         </Button>
@@ -127,6 +147,17 @@ function PageComponent() {
   )
 }
 
+function useDebouncedValue(value: string, delay: number) {
+  const [debouncedValue, setDebouncedValue] = useState(value)
+
+  useEffect(() => {
+    const timeout = setTimeout(() => setDebouncedValue(value), delay)
+    return () => clearTimeout(timeout)
+  }, [delay, value])
+
+  return debouncedValue
+}
+
 function LookupError(options: LookupError.Props) {
   const router = useRouter()
   return (

package/src/admin/ui/src/routes/organizations_.$orgId.tsx

@@ -27,6 +27,9 @@ export const Route = createFileRoute('/organizations_/$orgId')({
       context.queryClient.ensureQueryData(Organizations.get.options(params.orgId)),
       context.queryClient.ensureQueryData(Organizations.getSubsidies.options(params.orgId)),
     ]),
+  head: ({ loaderData }) => ({
+    meta: [{ title: `${loaderData?.[0].name ?? 'Organization'} | Tempo API Admin` }],
+  }),
   component: PageComponent,
   errorComponent: OrganizationError,
 })
@@ -121,6 +124,9 @@ function PageComponent() {
         <div className="flex flex-wrap items-center justify-between gap-3">
           <h2 className="text-heading-18 text-foreground">Operations</h2>
           <div className="flex items-center gap-3">
+            <Button render={<Link search={{ orgId }} to="/route-policies" />}>
+              Route policies
+            </Button>
             <Button render={<Link search={{ orgId }} to="/routes" />}>View routes</Button>
             <span aria-live="polite" className="text-label-12 text-foreground-secondary">
               {refreshing && !updateComplete ? (
@@ -301,7 +307,7 @@ function PageComponent() {
                 <Link
                   className="truncate text-label-14 text-foreground hover:underline"
                   search={{ orgId, projectId: project.id }}
-                  to="/api-keys"
+                  to="/route-policies"
                 >
                   {project.name}
                 </Link>
@@ -561,9 +567,18 @@ function ApiKeysCard(options: ApiKeysCard.Props) {
             {keys.slice(0, 5).map((key) => (
               <Rows.Row className="min-h-[64px] py-3" key={key.id} style={{ height: 'auto' }}>
                 <span className="flex min-w-0 flex-1 flex-col gap-1">
-                  <span className="truncate text-label-14 text-foreground">
+                  <Link
+                    className="truncate text-label-14 text-foreground hover:underline"
+                    search={{
+                      apiKeyId: key.id,
+                      environment: key.environment,
+                      orgId: options.orgId,
+                      projectId: key.projectId,
+                    }}
+                    to="/route-policies"
+                  >
                     {key.name ?? key.id}
-                  </span>
+                  </Link>
                   <span className="truncate text-label-12 text-foreground-secondary">
                     {key.environment} · {key.scopes.join(', ')}
                   </span>