tapimo 0.10.0 → 0.10.2

package/src/apps/funding/routes/deposit-addresses.test.ts

@@ -45,7 +45,7 @@ const providers = [
     integratorId: '0xdead',
     userAddress: '0x1111111111111111111111111111111111111111',
   }),
-  Relay.relay({ userAddress: '0x1111111111111111111111111111111111111111' }),
+  Relay.relay({ userAddresses: TestFunding.relayQuoteUsers }),
   Rhino.rhino(),
   Squid.squid({
     integratorId: 'squid-integrator-id',
@@ -966,6 +966,67 @@ describe.skipIf(!relayApiKey)('POST /funding/deposit-addresses (relay)', () => {
   })
 })
 
+describe('GET /funding/deposit-addresses', () => {
+  test('pages organization addresses and narrows project-attributed keys', async () => {
+    const app = transfersApp()
+    const first = await seedDepositAddress({ orgId: fundingAddressListReader.orgId })
+    const second = await seedDepositAddress({ orgId: fundingAddressListReader.orgId })
+    const third = await seedDepositAddress({ orgId: fundingAddressListReader.orgId })
+    const project = await seedDepositAddress({
+      orgId: fundingAddressListReader.orgId,
+      projectId: fundingAddressListProjectReader.projectId,
+    })
+    const sibling = await seedDepositAddress({
+      orgId: fundingAddressListReader.orgId,
+      projectId: 'prj_funding_address_list_sibling',
+    })
+    const sixth = await seedDepositAddress({ orgId: fundingAddressListReader.orgId })
+    await seedDepositAddress({ orgId: fundingForeign.orgId })
+    await seedDepositAddress({
+      environment: 'sandbox',
+      orgId: fundingAddressListReader.orgId,
+    })
+
+    const path = '/v1/funding/deposit-addresses'
+    expect((await app.request(path)).status).toBe(401)
+    expect((await app.request(path, as(TestApp.key))).status).toBe(403)
+
+    const response = await app.request(`${path}?limit=5`, as(fundingAddressListReader))
+    expect(response.status).toBe(200)
+    expect({
+      cacheControl: response.headers.get('cache-control'),
+      etag: response.headers.get('etag'),
+      vary: response.headers.get('vary'),
+    }).toEqual({
+      cacheControl: 'no-store',
+      etag: null,
+      vary: 'Accept-Encoding, Authorization, Tempo-API-Key, X-API-Key',
+    })
+    const body = await TestApp.json(response, Funding.schema.listFundingDepositAddresses.Response)
+    expect(body.data.map((address) => address.id)).toEqual([
+      sixth.id,
+      sibling.id,
+      project.id,
+      third.id,
+      second.id,
+    ])
+    expect(body.nextCursor).toBe(Cursor.encode([second.createdAt, second.id]))
+
+    const next = await TestApp.json(
+      await app.request(`${path}?limit=5&cursor=${body.nextCursor}`, as(fundingAddressListReader)),
+      Funding.schema.listFundingDepositAddresses.Response,
+    )
+    expect(next.data.map((address) => address.id)).toEqual([first.id])
+    expect(next.nextCursor).toBeNull()
+
+    const projectBody = await TestApp.json(
+      await app.request(path, as(fundingAddressListProjectReader)),
+      Funding.schema.listFundingDepositAddresses.Response,
+    )
+    expect(projectBody.data.map((address) => address.id)).toEqual([project.id])
+  })
+})
+
 describe('GET /funding/deposit-addresses/:id', () => {
   test('requires funding:read and returns the owned address', async () => {
     const app = transfersApp()
@@ -1329,6 +1390,63 @@ describe('GET /funding/deposits?depositAddress', () => {
   })
 })
 
+describe('GET /funding/deposits', () => {
+  test('pages organization deposits and narrows project-attributed keys', async () => {
+    const app = transfersApp()
+    const firstAddress = await seedDepositAddress({ orgId: fundingDepositListReader.orgId })
+    const secondAddress = await seedDepositAddress({ orgId: fundingDepositListReader.orgId })
+    const thirdAddress = await seedDepositAddress({ orgId: fundingDepositListReader.orgId })
+    const projectAddress = await seedDepositAddress({
+      orgId: fundingDepositListReader.orgId,
+      projectId: fundingDepositListProjectReader.projectId,
+    })
+    const siblingAddress = await seedDepositAddress({
+      orgId: fundingDepositListReader.orgId,
+      projectId: 'prj_funding_deposit_list_sibling',
+    })
+    const sixthAddress = await seedDepositAddress({ orgId: fundingDepositListReader.orgId })
+    const first = await seedDeposit(firstAddress)
+    const second = await seedDeposit(secondAddress)
+    const third = await seedDeposit(thirdAddress)
+    const project = await seedDeposit(projectAddress)
+    const sibling = await seedDeposit(siblingAddress)
+    const sixth = await seedDeposit(sixthAddress)
+    const foreignAddress = await seedDepositAddress({ orgId: fundingForeign.orgId })
+    await seedDeposit(foreignAddress)
+    const sandboxAddress = await seedDepositAddress({
+      environment: 'sandbox',
+      orgId: fundingDepositListReader.orgId,
+    })
+    await seedDeposit(sandboxAddress)
+
+    const path = '/v1/funding/deposits'
+    const response = await app.request(`${path}?limit=5`, as(fundingDepositListReader))
+    expect(response.status).toBe(200)
+    const body = await TestApp.json(response, Funding.schema.listFundingDeposits.Response)
+    expect(body.data.map((deposit) => deposit.id)).toEqual([
+      sixth.id,
+      sibling.id,
+      project.id,
+      third.id,
+      second.id,
+    ])
+    expect(body.nextCursor).toBe(Cursor.encode([second.createdAt, second.id]))
+
+    const next = await TestApp.json(
+      await app.request(`${path}?limit=5&cursor=${body.nextCursor}`, as(fundingDepositListReader)),
+      Funding.schema.listFundingDeposits.Response,
+    )
+    expect(next.data.map((deposit) => deposit.id)).toEqual([first.id])
+    expect(next.nextCursor).toBeNull()
+
+    const projectBody = await TestApp.json(
+      await app.request(path, as(fundingDepositListProjectReader)),
+      Funding.schema.listFundingDeposits.Response,
+    )
+    expect(projectBody.data.map((deposit) => deposit.id)).toEqual([project.id])
+  })
+})
+
 describe('GET /funding/deposits?recipient', () => {
   test('requires funding:read and pages recipient deposits across addresses', async () => {
     const app = transfersApp()
@@ -1336,7 +1454,6 @@ describe('GET /funding/deposits?recipient', () => {
     const path = `/v1/funding/deposits?recipient=${recipient.toLowerCase()}`
     expect((await app.request(path)).status).toBe(401)
     expect((await app.request(path, as(TestApp.key))).status).toBe(403)
-    expect((await app.request('/v1/funding/deposits', as(fundingReader))).status).toBe(400)
     expect(
       (await app.request('/v1/funding/deposits?depositAddress=', as(fundingReader))).status,
     ).toBe(400)
@@ -1347,7 +1464,7 @@ describe('GET /funding/deposits?recipient', () => {
           as(fundingReader),
         )
       ).status,
-    ).toBe(400)
+    ).toBe(200)
 
     const firstAddress = await seedDepositAddress({
       snapshot: TestFunding.depositAddressSnapshot({
@@ -1438,6 +1555,61 @@ describe('GET /funding/deposits?recipient', () => {
   })
 })
 
+describe('GET /funding/deposits?filters', () => {
+  test('AND-combines canonical aliases and includes the matching count', async () => {
+    const app = transfersApp()
+    const snapshot = TestFunding.depositAddressSnapshot({
+      address: 'TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE',
+    })
+    const address = await seedDepositAddress({
+      orgId: fundingDepositFilterReader.orgId,
+      snapshot,
+    })
+    const deposit = await seedDeposit(address)
+    const unrelatedAddress = await seedDepositAddress({
+      orgId: fundingDepositFilterReader.orgId,
+      snapshot: TestFunding.depositAddressSnapshot({
+        provider: { id: 'relay_unrelated', name: 'Relay' },
+        recipient: `0x${'22'.repeat(20)}`,
+      }),
+    })
+    await seedDeposit(unrelatedAddress)
+    const query = new URLSearchParams({
+      depositAddress: snapshot.address,
+      destinationToken: 'usdt0',
+      include: 'totalCount',
+      provider: 'relay',
+      recipient: snapshot.recipient.toLowerCase(),
+      sourceChain: 'tron',
+      sourceToken: 'usdt',
+      status: 'detected',
+    })
+
+    const body = await TestApp.json(
+      await app.request(`/v1/funding/deposits?${query}`, as(fundingDepositFilterReader)),
+      Funding.schema.listFundingDeposits.Response,
+    )
+    expect(body).toEqual({
+      data: [FundingDeposit.toPublic(deposit)],
+      meta: { totalCount: 1, totalCountCapped: false },
+      nextCursor: null,
+    })
+
+    const empty = await TestApp.json(
+      await app.request(
+        '/v1/funding/deposits?sourceToken=unknown&include=totalCount',
+        as(fundingDepositFilterReader),
+      ),
+      Funding.schema.listFundingDeposits.Response,
+    )
+    expect(empty).toEqual({
+      data: [],
+      meta: { totalCount: 0, totalCountCapped: false },
+      nextCursor: null,
+    })
+  })
+})
+
 describe('GET /funding/deposits/:id', () => {
   test('returns the owned deposit without private reconciliation state', async () => {
     const app = transfersApp()
@@ -1544,6 +1716,43 @@ const fundingReader = {
   token: 'secret_funding_reader',
 } satisfies TestApp.kvStore.Key
 
+const fundingAddressListReader = {
+  id: 'key_funding_address_list',
+  orgId: 'org_funding_address_list',
+  scopes: ['funding:read'],
+  token: 'secret_funding_address_list',
+} satisfies TestApp.kvStore.Key
+
+const fundingAddressListProjectReader = {
+  id: 'key_funding_address_list_project',
+  orgId: fundingAddressListReader.orgId,
+  projectId: 'prj_funding_address_list',
+  scopes: ['funding:read'],
+  token: 'secret_funding_address_list_project',
+} satisfies TestApp.kvStore.Key
+
+const fundingDepositListReader = {
+  id: 'key_funding_deposit_list',
+  orgId: 'org_funding_deposit_list',
+  scopes: ['funding:read'],
+  token: 'secret_funding_deposit_list',
+} satisfies TestApp.kvStore.Key
+
+const fundingDepositFilterReader = {
+  id: 'key_funding_deposit_filter',
+  orgId: 'org_funding_deposit_filter',
+  scopes: ['funding:read'],
+  token: 'secret_funding_deposit_filter',
+} satisfies TestApp.kvStore.Key
+
+const fundingDepositListProjectReader = {
+  id: 'key_funding_deposit_list_project',
+  orgId: fundingDepositListReader.orgId,
+  projectId: 'prj_funding_deposit_list',
+  scopes: ['funding:read'],
+  token: 'secret_funding_deposit_list_project',
+} satisfies TestApp.kvStore.Key
+
 const fundingProjectReader = {
   id: 'key_funding_project',
   orgId: 'org_funding',
@@ -1589,6 +1798,11 @@ function transfersApp(options: TestApp.create.Options = {}) {
     auth: {
       keys: [
         TestApp.key,
+        fundingAddressListProjectReader,
+        fundingAddressListReader,
+        fundingDepositFilterReader,
+        fundingDepositListProjectReader,
+        fundingDepositListReader,
         fundingForeign,
         fundingForeignWriter,
         fundingProjectReader,

package/src/apps/funding/routes/deposit-addresses.ts

@@ -126,6 +126,27 @@ export namespace schema {
     export const Response = DepositAddress
   }
 
+  /** Schemas for the listFundingDepositAddresses operation. */
+  export namespace listFundingDepositAddresses {
+    /** Query parameters for listing funding deposit addresses. */
+    export const Query = z
+      .object({
+        cursor: Schema.Cursor,
+        limit: Schema.Limit,
+      })
+      .check(z.describe('Paging parameters for listing funding deposit addresses.'))
+
+    /** One page of reusable funding deposit addresses. */
+    export const Response = z
+      .object({
+        data: z
+          .array(DepositAddress)
+          .check(z.describe('Funding deposit addresses on this page, newest first.')),
+        nextCursor: Schema.NextCursor,
+      })
+      .check(z.describe('A page of reusable funding deposit addresses.'))
+  }
+
   /** Schemas for the reconcileFundingDepositAddress operation. */
   export namespace reconcileFundingDepositAddress {
     /** Path parameters for reconciling a funding deposit address. */
@@ -144,32 +165,49 @@ export namespace schema {
             z.meta({ examples: ['TJRabPrwbZy45sbavfcjinPJC18kjpRTv8'] }),
           ),
         cursor: Schema.Cursor,
+        destinationToken: z
+          .optional(z.string().check(z.minLength(1)))
+          .check(
+            z.describe('Destination token symbol, contract address, or token key.'),
+            z.meta({ examples: ['usdt0'] }),
+          ),
+        include: Schema.totalCountInclude,
         limit: Schema.Limit,
+        provider: z
+          .optional(z.string().check(z.minLength(1)))
+          .check(z.describe('Funding provider id.'), z.meta({ examples: ['relay'] })),
         recipient: z
           .optional(Schema.Address)
           .check(
             z.describe('Tempo account that received the deposits.'),
             z.meta({ examples: [`0x${'11'.repeat(20)}`] }),
           ),
+        sourceChain: z
+          .optional(z.string().check(z.minLength(1)))
+          .check(
+            z.describe('Source chain CAIP-2 id, slug, or alias.'),
+            z.meta({ examples: ['tron'] }),
+          ),
+        sourceToken: z
+          .optional(z.string().check(z.minLength(1)))
+          .check(
+            z.describe('Source token symbol, contract address, or token key.'),
+            z.meta({ examples: ['usdt'] }),
+          ),
+        status: z.optional(FundingDeposit.schema.Status),
       })
-      .check(
-        z.refine(
-          (query) => (query.depositAddress === undefined) !== (query.recipient === undefined),
-          {
-            error: 'Pass exactly one of `depositAddress` or `recipient`.',
-            path: ['depositAddress'],
-          },
-        ),
-        z.describe('Exactly one deposit filter and optional paging parameters.'),
-      )
+      .check(z.describe('Optional deposit filters and paging parameters.'))
 
     /** One page of detected deposits. */
     export const Response = z
       .object({
         data: z.array(Deposit).check(z.describe('Detected deposits on this page, newest first.')),
+        meta: z
+          .optional(Schema.CountMeta)
+          .check(z.describe('Extra response metadata requested with `include`.')),
         nextCursor: Schema.NextCursor,
       })
-      .check(z.describe('A page of funding deposits matching the selected filter.'))
+      .check(z.describe('A page of visible funding deposits.'))
   }
 
   /** Schemas for the getFundingDeposit operation. */
@@ -276,9 +314,114 @@ const fundingDepositExample = {
 
 const fundingDepositsExample = {
   data: [fundingDepositExample],
+  meta: { totalCount: 1, totalCountCapped: false },
   nextCursor: null,
 } satisfies z.output<typeof schema.listFundingDeposits.Response>
 
+const fundingDepositAddressesExample = {
+  data: [fundingDepositAddressExample],
+  nextCursor: null,
+} satisfies z.output<typeof schema.listFundingDepositAddresses.Response>
+
+function resolveDepositFilters(options: resolveDepositFilters.Options): FundingDeposits.Filters {
+  const { catalog, parameters } = options
+  return {
+    ...(parameters.depositAddress === undefined
+      ? {}
+      : { depositAddress: parameters.depositAddress }),
+    ...(parameters.destinationToken === undefined
+      ? {}
+      : {
+          destinationTokenKeys: resolveTokenKeys({
+            catalog,
+            input: parameters.destinationToken,
+            side: 'destination',
+          }),
+        }),
+    ...(parameters.provider === undefined
+      ? {}
+      : { providerId: parameters.provider.trim().toLowerCase() }),
+    ...(parameters.recipient === undefined ? {} : { recipient: parameters.recipient }),
+    ...(parameters.sourceChain === undefined
+      ? {}
+      : { sourceChainIds: resolveChainIds(catalog, parameters.sourceChain) }),
+    ...(parameters.sourceToken === undefined
+      ? {}
+      : {
+          sourceTokenKeys: resolveTokenKeys({
+            catalog,
+            input: parameters.sourceToken,
+            side: 'source',
+          }),
+        }),
+    ...(parameters.status === undefined ? {} : { status: parameters.status }),
+  }
+}
+
+declare namespace resolveDepositFilters {
+  type Options = {
+    catalog?: FundingCatalog.Snapshot | undefined
+    parameters: z.output<typeof schema.listFundingDeposits.Query>
+  }
+}
+
+function resolveChainIds(catalog: FundingCatalog.Snapshot | undefined, input: string): string[] {
+  const trimmed = input.trim()
+  const chain = catalog?.chainsByKey.get(trimmed.toLowerCase())
+  if (chain) return [chain.id]
+  return /^[a-z][a-z0-9-]*:.+$/i.test(trimmed) ? [trimmed] : []
+}
+
+function resolveTokenKeys(options: resolveTokenKeys.Options): string[] {
+  const trimmed = options.input.trim()
+  const normalized = trimmed.toLowerCase()
+  const keys =
+    options.catalog?.routes
+      .map((entry) => entry.route[options.side])
+      .filter((token) => matchesToken(token, trimmed, normalized))
+      .map(tokenKey) ?? []
+  if (keys.length) return [...new Set(keys)]
+  if (!/^[a-z][a-z0-9-]*:.+\/(?:erc20|trc20|token):.+$/i.test(trimmed)) return []
+  return [/\/erc20:/i.test(trimmed) ? normalized : trimmed]
+}
+
+declare namespace resolveTokenKeys {
+  type Options = {
+    catalog?: FundingCatalog.Snapshot | undefined
+    input: string
+    side: 'destination' | 'source'
+  }
+}
+
+type ResolvedToken = FundingCatalog.Snapshot['routes'][number]['route']['source']
+
+function matchesToken(token: ResolvedToken, trimmed: string, normalized: string): boolean {
+  return (
+    token.slug === normalized ||
+    token.symbol.toLowerCase() === normalized ||
+    matchesTokenIdentifier(token, token.address, trimmed, normalized) ||
+    matchesTokenIdentifier(token, tokenKey(token), trimmed, normalized)
+  )
+}
+
+function matchesTokenIdentifier(
+  token: ResolvedToken,
+  candidate: string,
+  trimmed: string,
+  normalized: string,
+): boolean {
+  return token.chain.kind === 'evm' ? candidate.toLowerCase() === normalized : candidate === trimmed
+}
+
+function tokenKey(token: ResolvedToken): string {
+  const namespace = (() => {
+    if (token.chain.kind === 'solana') return 'token'
+    if (token.chain.kind === 'tron') return 'trc20'
+    return 'erc20'
+  })()
+  return `${token.chain.id}/${namespace}:${token.address}`
+}
+
 const reconcileFundingDepositAddressResponses = (() => {
   const responses = OpenApi.responses({
     errors: {
@@ -646,6 +789,72 @@ export function depositAddresses(options: depositAddresses.Options = {}) {
         }
       },
     )
+    .get(
+      '/v1/funding/deposit-addresses',
+      Auth.policy({ apiKey: { scopes: ['funding:read'] } }),
+      OpenApi.validate('query', schema.listFundingDepositAddresses.Query, {
+        code: 'query_invalid',
+        message: 'Check the query parameters and try again.',
+      }),
+      OpenApi.describeRoute({
+        description: 'Lists reusable funding deposit addresses, newest first.',
+        operationId: 'listFundingDepositAddresses',
+        responses: OpenApi.responses({
+          errors: {
+            400: { codes: ['query_invalid'] },
+          },
+          success: {
+            description: 'A page of reusable funding deposit addresses.',
+            example: fundingDepositAddressesExample,
+            schema: schema.listFundingDepositAddresses.Response,
+          },
+        }),
+        summary: 'List deposit addresses',
+        tags: ['Deposit Addresses'],
+      }),
+      async (c) => {
+        if (Auth.narrowAccess) return Auth.accessError(c)
+        if (OpenApi.narrowValidation)
+          return OpenApi.validationError(c, {
+            code: 'query_invalid',
+            message: 'Check the query parameters and try again.',
+          })
+
+        const owner = Access.owner(c)
+        if (!owner) return Access.unauthorized(c)
+
+        const db = Db.get(c.get('db'))
+        const { cursor, limit } = c.req.valid('query')
+        const decoded = cursor ? Cursor.decode(cursor, ['timestamp', 'id']) : undefined
+        try {
+          const rows = await FundingDepositAddresses.list(db, {
+            ...(decoded
+              ? { cursor: { createdAt: String(decoded[0]), id: String(decoded[1]) } }
+              : {}),
+            limit: limit + 1,
+            owner,
+          })
+          const page = Cursor.paginate({
+            key: (record) => [record.createdAt, record.id],
+            limit,
+            rows,
+          })
+          const data = page.rows.map(FundingDepositAddress.toPublic)
+
+          c.header('Cache-Control', Cache.policies.noStore)
+          c.header('Vary', 'Accept-Encoding, Authorization, Tempo-API-Key, X-API-Key')
+          return c.json(
+            Response.validated(schema.listFundingDepositAddresses.Response, {
+              data,
+              nextCursor: page.nextCursor,
+            }),
+            200,
+          )
+        } catch (cause) {
+          return Response.upstream(c, cause)
+        }
+      },
+    )
     .get(
       '/v1/funding/deposit-addresses/:id{fda_[A-Za-z0-9_-]+}',
       Auth.policy({ apiKey: { scopes: ['funding:read'] } }),
@@ -712,7 +921,7 @@ export function depositAddresses(options: depositAddresses.Options = {}) {
     .post(
       '/v1/funding/deposit-addresses/:id{fda_[A-Za-z0-9_-]+}/reconcile',
       Auth.policy({
-        apiKey: { rateLimit: { perMinute: 10 }, scopes: ['funding:write'] },
+        apiKey: { rateLimit: { limit: 10, period: 'minute' }, scopes: ['funding:write'] },
       }),
       OpenApi.validate('param', schema.reconcileFundingDepositAddress.Params, {
         code: 'param_invalid',
@@ -782,14 +991,14 @@ export function depositAddresses(options: depositAddresses.Options = {}) {
         message: 'Check the query parameters and try again.',
       }),
       OpenApi.describeRoute({
-        description: 'Lists deposits by deposit address or Tempo recipient, newest first.',
+        description: 'Lists visible deposits, optionally filtered, newest first.',
         operationId: 'listFundingDeposits',
         responses: OpenApi.responses({
           errors: {
             400: { codes: ['query_invalid'] },
           },
           success: {
-            description: 'A page of funding deposits matching the selected filter.',
+            description: 'A page of visible funding deposits.',
             example: fundingDepositsExample,
             schema: schema.listFundingDeposits.Response,
           },
@@ -809,32 +1018,59 @@ export function depositAddresses(options: depositAddresses.Options = {}) {
         if (!owner) return Access.unauthorized(c)
 
         const db = Db.get(c.get('db'))
-        const { cursor, depositAddress, limit, recipient } = c.req.valid('query')
+        const parameters = c.req.valid('query')
+        const { cursor, include, limit } = parameters
         const decoded = cursor ? Cursor.decode(cursor, ['timestamp', 'id']) : undefined
         try {
+          const catalog =
+            parameters.destinationToken !== undefined ||
+            parameters.sourceChain !== undefined ||
+            parameters.sourceToken !== undefined
+              ? await FundingCatalog.snapshot(c)
+              : undefined
+          const filters = resolveDepositFilters({ catalog, parameters })
+          // Counts are best-effort and share every ownership and filter predicate
+          // with the page query. A failure omits `meta` rather than failing the page.
+          const countPromise = include.includes('totalCount')
+            ? FundingDeposits.count(db, {
+                ...filters,
+                cap: Schema.countCap,
+                owner,
+              }).catch(() => {
+                c.set('fundingDepositCountFailed', true)
+                return undefined
+              })
+            : undefined
           const paging = {
+            ...filters,
             ...(decoded
               ? { cursor: { createdAt: String(decoded[0]), id: String(decoded[1]) } }
               : {}),
             limit: limit + 1,
             owner,
           }
-          const rows =
-            depositAddress === undefined
-              ? await FundingDeposits.listByRecipient(db, { ...paging, recipient: recipient! })
-              : await FundingDeposits.listByDepositAddress(db, { ...paging, depositAddress })
+          const rows = await FundingDeposits.list(db, paging)
           const page = Cursor.paginate({
             key: (record) => [record.createdAt, record.id],
             limit,
             rows,
           })
           const data = page.rows.map(FundingDeposit.toPublic)
+          const count = await countPromise
 
           c.header('Cache-Control', Cache.policies.noStore)
           c.header('Vary', 'Accept-Encoding, Authorization, Tempo-API-Key')
           return c.json(
             Response.validated(schema.listFundingDeposits.Response, {
               data,
+              ...(count === undefined
+                ? {}
+                : {
+                    meta: {
+                      totalCount: Math.min(count, Schema.countCap),
+                      totalCountCapped: count > Schema.countCap,
+                    },
+                  }),
               nextCursor: page.nextCursor,
             }),
             200,

package/src/apps/funding/routes/providers.test.ts

@@ -28,7 +28,7 @@ const providers = [
     integratorId: '0xdead',
     userAddress: '0x1111111111111111111111111111111111111111',
   }),
-  Relay.relay({ userAddress: '0x1111111111111111111111111111111111111111' }),
+  Relay.relay({ userAddresses: TestFunding.relayQuoteUsers }),
   Rhino.rhino(),
   Squid.squid({
     integratorId: 'squid-integrator-id',

package/src/apps/funding/routes/quotes.test.ts

@@ -28,7 +28,7 @@ const providers = [
     integratorId: '0xdead',
     userAddress: '0x1111111111111111111111111111111111111111',
   }),
-  Relay.relay({ userAddress: '0x1111111111111111111111111111111111111111' }),
+  Relay.relay({ userAddresses: TestFunding.relayQuoteUsers }),
   Rhino.rhino(),
   Squid.squid({
     integratorId: 'squid-integrator-id',