tapimo 0.14.0 → 0.15.0

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

@@ -1,8 +1,9 @@
 import { queryOptions, useQuery } from '@tanstack/react-query'
+import type { Address } from 'viem'
 
 import { client } from './client.js'
 
-/** The auth contract the SPA reads from `GET config.json` once loaded. */
+/** The bootstrap contract the SPA reads from `GET config.json` once loaded. */
 export type Config = {
   auth: {
     /** The signed-in admin identity, or `null` when logged out (shell is public). */
@@ -12,6 +13,10 @@ export type Config = {
     /** Where to send the user to sign out (e.g. Cloudflare Access logout). */
     logoutUrl?: string
   }
+  rewards: {
+    /** Public address used by the reward signer service. */
+    signerAddress: Address | null
+  }
 }
 
 declare global {
@@ -34,7 +39,11 @@ export async function getConfig(): Promise<Config> {
   const inlined = inlineConfig()
   if (inlined) return inlined
   const response = await client['config.json'].$get()
-  if (!response.ok) return { auth: { identity: null } }
+  if (!response.ok)
+    return {
+      auth: { identity: null },
+      rewards: { signerAddress: null },
+    }
   return response.json() as Promise<Config>
 }
 

package/src/admin/ui/src/lib/earn-vaults.ts

@@ -23,8 +23,8 @@ const include = 'access,capabilities,zone' as const
 /** A chain id managed by the Earn registry UI. */
 export type ChainId = typeof mainnet.id | typeof testnet.id
 
-/** Moderato is the first chain with a curated Earn deployment. */
-export const defaultChain: ChainId = testnet.id
+/** Mainnet is the default Earn registry chain. */
+export const defaultChain: ChainId = mainnet.id
 
 /** Tempo chains managed by the Earn registry UI. */
 export const chains = [

package/src/admin/ui/src/lib/organizations.test.ts

@@ -8,6 +8,7 @@ import { routeTree } from '../routeTree.gen.js'
 import {
   BillingSourcesCard,
   Route as DetailRoute,
+  RoutesSubsidyCard,
   SponsorshipSubsidyCard,
 } from '../routes/organizations_.$orgId.js'
 import { Route as ListRoute } from '../routes/organizations.js'
@@ -79,7 +80,6 @@ describe('withEnabledSources', () => {
       memberCount: 0,
       name: 'Example',
       projectCount: 0,
-      sponsorshipSubsidy: { durationDays: null, projectSpendLimit: null },
       updatedAt: '2026-01-01T00:00:00.000Z',
       userId: null,
     } satisfies Organizations.Detail
@@ -106,50 +106,6 @@ describe('withEnabledSources', () => {
   })
 })
 
-describe('withSponsorshipSubsidy', () => {
-  it('replaces only the organization subsidy policy', () => {
-    const detail = {
-      billing: {
-        enabledSources: [],
-        production: { settings: null, source: null },
-        sandbox: { settings: null, source: null },
-      },
-      createdAt: '2026-01-01T00:00:00.000Z',
-      createdBy: null,
-      id: 'org_example',
-      memberCount: 0,
-      name: 'Example',
-      projectCount: 0,
-      sponsorshipSubsidy: { durationDays: null, projectSpendLimit: null },
-      updatedAt: '2026-01-01T00:00:00.000Z',
-      userId: null,
-    } satisfies Organizations.Detail
-
-    const updated = Organizations.withSponsorshipSubsidy({
-      detail,
-      sponsorshipSubsidy: { durationDays: 90, projectSpendLimit: '1000' },
-    })
-
-    expect({
-      billingPreserved: updated.billing === detail.billing,
-      original: detail.sponsorshipSubsidy,
-      updated: updated.sponsorshipSubsidy,
-    }).toMatchInlineSnapshot(`
-      {
-        "billingPreserved": true,
-        "original": {
-          "durationDays": null,
-          "projectSpendLimit": null,
-        },
-        "updated": {
-          "durationDays": 90,
-          "projectSpendLimit": "1000",
-        },
-      }
-    `)
-  })
-})
-
 describe('BillingSourcesCard', () => {
   it('renders source state and the setup-only warning', () => {
     const markup = renderToStaticMarkup(
@@ -195,7 +151,7 @@ describe('SponsorshipSubsidyCard', () => {
         error: null,
         onSave() {},
         pending: false,
-        policy: { durationDays: 90, projectSpendLimit: '1000' },
+        policy: { attributionSpendLimit: '1000', durationDays: 90 },
       }),
     )
     const marker = 'aria-label="Sponsorship subsidy"'
@@ -226,7 +182,7 @@ describe('SponsorshipSubsidyCard', () => {
         error: null,
         onSave() {},
         pending: false,
-        policy: { durationDays: null, projectSpendLimit: null },
+        policy: { attributionSpendLimit: null, durationDays: null },
       }),
     )
     const marker = 'aria-label="Sponsorship subsidy"'
@@ -239,7 +195,7 @@ describe('SponsorshipSubsidyCard', () => {
     expect({
       billedNormally: markup.includes('billed normally'),
       disabled: switchTag.includes('aria-checked="false"'),
-      spendCapHidden: !markup.includes('Per-project spend cap'),
+      spendCapHidden: !markup.includes('Per-attribution spend cap'),
     }).toMatchInlineSnapshot(`
       {
         "billedNormally": true,
@@ -250,6 +206,83 @@ describe('SponsorshipSubsidyCard', () => {
   })
 })
 
+describe('RoutesSubsidyCard', () => {
+  const usage = {
+    amount: '1.25',
+    count: 3,
+    from: '2026-09-01T00:00:00.000Z',
+    to: '2026-09-02T00:00:00.000Z',
+  }
+
+  it('renders an enabled policy with its maximum subsidy amount', () => {
+    const markup = renderToStaticMarkup(
+      createElement(RoutesSubsidyCard, {
+        error: null,
+        onSave() {},
+        pending: false,
+        policy: { frequency: 'tx', maxAmount: '5' },
+        usage,
+      }),
+    )
+    const marker = 'aria-label="Routes subsidy"'
+    const markerIndex = markup.indexOf(marker)
+    const switchTag = markup.slice(
+      markup.lastIndexOf('<', markerIndex),
+      markup.indexOf('>', markerIndex),
+    )
+
+    expect({
+      billing: markup.includes('active Stripe billing'),
+      enabled: switchTag.includes('aria-checked="true"'),
+      gap: markup.includes('gap Tempo covers'),
+      maxAmount: markup.includes('value="5"'),
+      reusableAddressWarning: markup.includes('previously issued reusable'),
+      usageAmount: markup.includes('$1.25'),
+      usageCount: markup.includes('Completed deposits') && markup.includes('>3</dd>'),
+    }).toMatchInlineSnapshot(`
+      {
+        "billing": true,
+        "enabled": true,
+        "gap": true,
+        "maxAmount": true,
+        "reusableAddressWarning": true,
+        "usageAmount": true,
+        "usageCount": true,
+      }
+    `)
+  })
+
+  it('renders a disabled policy', () => {
+    const markup = renderToStaticMarkup(
+      createElement(RoutesSubsidyCard, {
+        error: null,
+        onSave() {},
+        pending: false,
+        policy: null,
+        usage,
+      }),
+    )
+    const marker = 'aria-label="Routes subsidy"'
+    const markerIndex = markup.indexOf(marker)
+    const switchTag = markup.slice(
+      markup.lastIndexOf('<', markerIndex),
+      markup.indexOf('>', markerIndex),
+    )
+
+    expect({
+      amountHidden: !markup.includes('Maximum subsidy per transaction'),
+      disabled: switchTag.includes('aria-checked="false"'),
+      policyDisabled: markup.includes('policy is disabled for this organization'),
+    }).toMatchInlineSnapshot(`
+      {
+        "amountHidden": true,
+        "disabled": true,
+        "policyDisabled": true,
+      }
+    `)
+  })
+})
+
 describe('organization routes', () => {
   it('matches a direct detail URL without the list route as a parent', () => {
     const router = createRouter({
@@ -269,7 +302,7 @@ describe('organization routes', () => {
       `)
   })
 
-  it('blocks only on the primary organization query', async () => {
+  it('blocks on organization detail and subsidy policies', async () => {
     const ensureQueryData = vi.fn().mockResolvedValue({})
     const ensureInfiniteQueryData = vi.fn()
 
@@ -279,7 +312,7 @@ describe('organization routes', () => {
       params: { orgId: 'org_example' },
     })
 
-    expect(ensureQueryData).toHaveBeenCalledOnce()
+    expect(ensureQueryData).toHaveBeenCalledTimes(2)
     expect(ensureInfiniteQueryData).not.toHaveBeenCalled()
   })
 

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

@@ -3,9 +3,14 @@ import type { InferResponseType } from 'hono/client'
 import * as z from 'zod/mini'
 
 import { client } from './client.js'
+import * as Response from './response.js'
 
 type ListResponse = InferResponseType<(typeof client)['organizations']['$get'], 200>
 type DetailResponse = InferResponseType<(typeof client)['organizations'][':orgId']['$get'], 200>
+type SubsidiesResponse = InferResponseType<
+  (typeof client)['organizations'][':orgId']['subsidies']['$get'],
+  200
+>
 type BillingSourcesResponse = InferResponseType<
   (typeof client)['organizations'][':orgId']['billing-sources'][':source']['$put'],
   200
@@ -14,6 +19,10 @@ type MembersResponse = InferResponseType<
   (typeof client)['organizations'][':orgId']['members']['$get'],
   200
 >
+type InvitationResponse = InferResponseType<
+  (typeof client)['organizations'][':orgId']['invitations']['$post'],
+  200
+>
 type ProjectsResponse = InferResponseType<
   (typeof client)['organizations'][':orgId']['projects']['$get'],
   200
@@ -26,8 +35,12 @@ type SponsorshipResponse = InferResponseType<
   (typeof client)['organizations'][':orgId']['sponsorship']['$get'],
   200
 >
+type RoutesSubsidyResponse = InferResponseType<
+  (typeof client)['organizations'][':orgId']['subsidies']['routes']['$put'],
+  200
+>
 type SponsorshipSubsidyResponse = InferResponseType<
-  (typeof client)['organizations'][':orgId']['sponsorship']['$put'],
+  (typeof client)['organizations'][':orgId']['subsidies']['sponsorship']['$put'],
   200
 >
 type UsageResponse = InferResponseType<
@@ -45,6 +58,9 @@ export type Organization = ListResponse['data'][number]
 /** Detailed organization information, including billing state. */
 export type Detail = DetailResponse
 
+/** Current organization subsidy policies. */
+export type Subsidies = SubsidiesResponse
+
 /** An organization-wide billing source. */
 export type BillingSource = Detail['billing']['enabledSources'][number]
 
@@ -155,6 +171,28 @@ export namespace get {
   }
 }
 
+/** Get an organization's subsidy policies. */
+export namespace getSubsidies {
+  export function key(orgId: string) {
+    return ['organizations', orgId, 'subsidies'] as const
+  }
+
+  export async function fn(orgId: string) {
+    const response = await client.organizations[':orgId'].subsidies.$get({ param: { orgId } })
+    if (response.status === 404) throw new Error('Organization not found.')
+    if (!response.ok) throw new Error('Failed to load organization subsidies.')
+    return (await response.json()) as SubsidiesResponse
+  }
+
+  export function options(orgId: string) {
+    return ReactQuery.queryOptions({
+      queryFn: () => fn(orgId),
+      queryKey: key(orgId),
+      staleTime: 30_000,
+    })
+  }
+}
+
 /** Returns organization detail with its enabled billing sources replaced. */
 export function withEnabledSources(options: withEnabledSources.Options): Detail {
   return {
@@ -176,24 +214,6 @@ export declare namespace withEnabledSources {
   }
 }
 
-/** Returns organization detail with its sponsorship subsidy policy replaced. */
-export function withSponsorshipSubsidy(options: withSponsorshipSubsidy.Options): Detail {
-  return {
-    ...options.detail,
-    sponsorshipSubsidy: options.sponsorshipSubsidy,
-  }
-}
-
-export declare namespace withSponsorshipSubsidy {
-  /** Inputs for replacing an organization's cached subsidy policy. */
-  type Options = {
-    /** Organization detail to update. */
-    detail: Detail
-    /** Current sponsorship subsidy policy. */
-    sponsorshipSubsidy: Detail['sponsorshipSubsidy']
-  }
-}
-
 /** Enable an organization-wide billing source. */
 export namespace enableBillingSource {
   /** Billing source to enable for an organization. */
@@ -258,19 +278,51 @@ export namespace disableBillingSource {
   }
 }
 
+/** Replace an organization's Routes subsidy policy. */
+export namespace setRoutesSubsidy {
+  /** Routes subsidy policy accepted by the admin API. */
+  export type Input = { enabled: false } | { enabled: true; maxAmount: string }
+
+  /** Replaces the policy and returns its current value. */
+  export async function fn(options: Input & { orgId: string }) {
+    const response = await client.organizations[':orgId'].subsidies.routes.$put({
+      json: options.enabled
+        ? { enabled: true, frequency: 'tx', maxAmount: options.maxAmount }
+        : { enabled: false },
+      param: { orgId: options.orgId },
+    })
+    if (!response.ok) throw new Error('Failed to update Routes subsidy.')
+    return (await response.json()) as RoutesSubsidyResponse
+  }
+
+  /** Creates a mutation that replaces the Routes subsidy policy. */
+  export function useMutation(orgId: string) {
+    const queryClient = ReactQuery.useQueryClient()
+    return ReactQuery.useMutation({
+      mutationFn: (input: Input) => fn({ ...input, orgId }),
+      onSuccess: (response) =>
+        queryClient.setQueryData(getSubsidies.key(orgId), (subsidies: Subsidies | undefined) =>
+          subsidies ? { ...subsidies, routes: response } : subsidies,
+        ),
+    })
+  }
+}
+
 /** Replace an organization's sponsorship subsidy policy. */
 export namespace setSponsorshipSubsidy {
   /** Sponsorship subsidy policy accepted by the admin API. */
-  export type Input = { enabled: false } | { enabled: true; projectSpendLimit?: string | undefined }
+  export type Input =
+    | { enabled: false }
+    | { attributionSpendLimit?: string | undefined; enabled: true }
 
   /** Replaces the policy and returns its current value. */
   export async function fn(options: Input & { orgId: string }) {
     const json = ((): Input => {
       if (!options.enabled) return { enabled: false }
-      if (!options.projectSpendLimit) return { enabled: true }
-      return { enabled: true, projectSpendLimit: options.projectSpendLimit }
+      if (!options.attributionSpendLimit) return { enabled: true }
+      return { attributionSpendLimit: options.attributionSpendLimit, enabled: true }
     })()
-    const response = await client.organizations[':orgId'].sponsorship.$put({
+    const response = await client.organizations[':orgId'].subsidies.sponsorship.$put({
       json,
       param: { orgId: options.orgId },
     })
@@ -284,8 +336,8 @@ export namespace setSponsorshipSubsidy {
     return ReactQuery.useMutation({
       mutationFn: (input: Input) => fn({ ...input, orgId }),
       onSuccess: (response) =>
-        queryClient.setQueryData(get.key(orgId), (detail: Detail | undefined) =>
-          detail ? withSponsorshipSubsidy({ detail, sponsorshipSubsidy: response }) : detail,
+        queryClient.setQueryData(getSubsidies.key(orgId), (subsidies: Subsidies | undefined) =>
+          subsidies ? { ...subsidies, sponsorship: response } : subsidies,
         ),
     })
   }
@@ -317,6 +369,35 @@ export namespace members {
   }
 }
 
+/** Invite someone to an organization by email. */
+export namespace invite {
+  /** Fields accepted by the invitation action. */
+  export type Input = {
+    /** Invitee email. */
+    email: string
+    /** Role granted when the invitation is accepted. */
+    role: Member['role']
+  }
+
+  /** Sends an organization invitation. */
+  export async function fn(options: Input & { orgId: string }) {
+    const response = await client.organizations[':orgId'].invitations.$post({
+      json: { email: options.email, role: options.role },
+      param: { orgId: options.orgId },
+    })
+    if (!response.ok)
+      throw new Error(
+        await Response.errorMessage(response, { fallback: 'Failed to send invitation.' }),
+      )
+    return (await response.json()) as InvitationResponse
+  }
+
+  /** Creates a mutation that sends an organization invitation. */
+  export function useMutation(orgId: string) {
+    return ReactQuery.useMutation({ mutationFn: (input: Input) => fn({ ...input, orgId }) })
+  }
+}
+
 /** List projects for one organization. */
 export namespace projects {
   export function key(orgId: string) {

package/src/admin/ui/src/lib/query-client.ts

@@ -17,7 +17,7 @@ const persister = createAsyncStoragePersister({
 })
 
 export const persistOptions: Omit<PersistQueryClientOptions, 'queryClient'> = {
-  buster: 'rate-limit-periods',
+  buster: 'route-subsidy-direction',
   dehydrateOptions: {
     shouldDehydrateQuery: (query) =>
       query.queryKey[0] !== 'config' &&

package/src/admin/ui/src/lib/reward-campaigns.ts

@@ -0,0 +1,136 @@
+import * as ReactQuery from '@tanstack/react-query'
+import type { InferRequestType, InferResponseType } from 'hono/client'
+import type { Address } from 'viem'
+
+import { client } from './client.js'
+
+type Endpoint = (typeof client)['earn']['verified-vaults'][':vaultId']['rewards']
+
+/** A configured Earn reward campaign and its current execution state. */
+export type Campaign = InferResponseType<Endpoint['$get'], 200>
+
+/** Complete reward configuration accepted by the Admin API. */
+export type Config = InferRequestType<Endpoint['$post']>['json']
+
+/** Identifies one Earn reward campaign. */
+export type Input = {
+  /** Tempo chain containing the Earn vault. */
+  chainId: number
+  /** EarnVault contract address. */
+  vaultId: Address
+}
+
+/** Read one reward campaign. */
+export namespace get {
+  /** Stable query key for one reward campaign. */
+  export function key(options: Input) {
+    return ['earn-reward-campaign', options.chainId, options.vaultId.toLowerCase()] as const
+  }
+
+  /** Returns the configured campaign, or null when rewards are not configured. */
+  export async function fn(options: Input): Promise<Campaign | null> {
+    const response = await client.earn['verified-vaults'][':vaultId'].rewards.$get({
+      param: { vaultId: options.vaultId },
+      query: { chainId: String(options.chainId) },
+    })
+    if (response.status === 404) return null
+    if (!response.ok) throw new Error(await errorMessage(response, 'Failed to load rewards.'))
+    return response.json()
+  }
+
+  /** TanStack Query options for one reward campaign. */
+  export function options(options: Input) {
+    return ReactQuery.queryOptions({
+      queryFn: () => fn(options),
+      queryKey: key(options),
+      refetchInterval: 10_000,
+      staleTime: 30_000,
+    })
+  }
+}
+
+/** Create or replace one reward campaign configuration. */
+export namespace configure {
+  /** Reward campaign identity and replacement configuration. */
+  export type Input = {
+    /** Tempo chain containing the Earn vault. */
+    chainId: number
+    /** Complete replacement configuration. */
+    config: Config
+    /** EarnVault contract address. */
+    vaultId: Address
+  }
+
+  /** Saves a complete reward configuration. */
+  export async function fn(options: Input): Promise<Campaign> {
+    const response = await client.earn['verified-vaults'][':vaultId'].rewards.$post({
+      json: options.config,
+      param: { vaultId: options.vaultId },
+      query: { chainId: String(options.chainId) },
+    })
+    if (!response.ok) throw new Error(await errorMessage(response, 'Failed to configure rewards.'))
+    return response.json()
+  }
+
+  /** Mutation that replaces a campaign and refreshes its cached state. */
+  export function useMutation() {
+    const queryClient = ReactQuery.useQueryClient()
+    return ReactQuery.useMutation({
+      mutationFn: fn,
+      onSuccess: (campaign, options) =>
+        queryClient.setQueryData(
+          get.key({ chainId: options.chainId, vaultId: options.vaultId }),
+          campaign,
+        ),
+    })
+  }
+}
+
+/** Pause or resume reward execution for one campaign. */
+export namespace setPaused {
+  /** Campaign identity and requested pause state. */
+  export type Input = {
+    /** Tempo chain containing the Earn vault. */
+    chainId: number
+    /** Whether new campaign work must pause. */
+    paused: boolean
+    /** EarnVault contract address. */
+    vaultId: Address
+  }
+
+  /** Updates the campaign pause state. */
+  export async function fn(options: Input): Promise<Campaign> {
+    const endpoint =
+      client.earn['verified-vaults'][':vaultId'].rewards[options.paused ? 'pause' : 'resume']
+    const response = await endpoint.$post({
+      param: { vaultId: options.vaultId },
+      query: { chainId: String(options.chainId) },
+    })
+    if (!response.ok)
+      throw new Error(await errorMessage(response, 'Failed to update reward execution.'))
+    return response.json()
+  }
+
+  /** Mutation that pauses or resumes a campaign and refreshes its cached state. */
+  export function useMutation() {
+    const queryClient = ReactQuery.useQueryClient()
+    return ReactQuery.useMutation({
+      mutationFn: fn,
+      onSuccess: (campaign, options) =>
+        queryClient.setQueryData(
+          get.key({ chainId: options.chainId, vaultId: options.vaultId }),
+          campaign,
+        ),
+    })
+  }
+}
+
+async function errorMessage(response: { json(): Promise<unknown> }, fallback: string) {
+  type Body = { error?: { details?: readonly { message?: string }[]; message?: string } }
+  const body = (await response.json().catch(() => null)) as Body | null
+  const message = body?.error?.message ?? fallback
+  const details = body?.error?.details?.flatMap((detail) =>
+    detail.message ? [detail.message] : [],
+  )
+  return details?.length ? `${message}\n${details.join('\n')}` : message
+}

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

@@ -0,0 +1,88 @@
+import { QueryClient } from '@tanstack/react-query'
+import { createMemoryHistory, createRouter } from '@tanstack/react-router'
+import { describe, expect, it } from 'vite-plus/test'
+
+import { routeTree } from '../routeTree.gen.js'
+import * as Routes from './routes.js'
+
+describe('search', () => {
+  it('parses routes filters and selected resource state', () => {
+    expect(
+      Routes.schema.Search.parse({
+        environments: ['production', 'sandbox'],
+        inProgress: 'true',
+        methods: ['transaction', 'depositAddress'],
+        needsAttention: 'true',
+        orgId: 'org_example',
+        providers: ['stargate', 'relay'],
+        resource: 'deposits',
+        selected: 'rdp_example',
+        sourceChains: ['eip155:8453', 'eip155:1'],
+        statuses: ['bridging', 'settling'],
+      }),
+    ).toMatchInlineSnapshot(`
+      {
+        "environments": [
+          "production",
+          "sandbox",
+        ],
+        "inProgress": "true",
+        "methods": [
+          "transaction",
+          "depositAddress",
+        ],
+        "needsAttention": "true",
+        "orgId": "org_example",
+        "providers": [
+          "stargate",
+          "relay",
+        ],
+        "resource": "deposits",
+        "selected": "rdp_example",
+        "sourceChains": [
+          "eip155:8453",
+          "eip155:1",
+        ],
+        "statuses": [
+          "bridging",
+          "settling",
+        ],
+      }
+    `)
+  })
+
+  it('drops invalid enum filters', () => {
+    expect(
+      Routes.schema.Search.parse({
+        environments: ['preview'],
+        resource: 'quotes',
+        statuses: ['queued'],
+      }),
+    ).toMatchInlineSnapshot(`
+      {
+        "environments": undefined,
+        "resource": undefined,
+        "statuses": undefined,
+      }
+    `)
+  })
+})
+
+describe('provider route', () => {
+  it('matches a filtered direct URL', () => {
+    const router = createRouter({
+      context: { queryClient: new QueryClient() },
+      history: createMemoryHistory({
+        initialEntries: ['/routes?resource=deposits&providers=%5B%22stargate%22%5D'],
+      }),
+      routeTree,
+    })
+
+    expect(router.matchRoutes('/routes').map((match) => match.routeId)).toMatchInlineSnapshot(`
+      [
+        "__root__",
+        "/routes",
+      ]
+    `)
+  })
+})