tapimo 0.11.0 → 0.12.0

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

@@ -34,52 +34,55 @@ export namespace schema {
   /** Schemas for the createFundingDepositAddress operation. */
   export namespace createFundingDepositAddress {
     /** Funding deposit address creation request body. */
-    export const Body = z
-      .strictObject({
-        amount: FundingTransfer.schema.CreateRequest.shape.amount,
-        destinationToken: z
-          .string()
-          .check(
-            z.minLength(1),
-            z.describe('Tempo destination token symbol, contract address, or token key.'),
-            z.meta({ examples: ['usdt0'] }),
-          ),
-        recipient: z
-          .string()
-          .check(
-            z.regex(/^0x[0-9a-fA-F]{40}$/),
-            z.describe('Tempo account that receives completed deposits.'),
-            z.meta({ examples: [`0x${'11'.repeat(20)}`] }),
-          ),
-        refundAddress: z
-          .string()
-          .check(
-            z.minLength(1),
-            z.describe('Source-chain account that receives refunds.'),
-            z.meta({ examples: ['TJRabPrwbZy45sbavfcjinPJC18kjpRTv8'] }),
-          ),
-        sourceChain: z
-          .string()
-          .check(
-            z.minLength(1),
-            z.describe('Source chain CAIP-2 id, slug, or alias.'),
-            z.meta({ examples: ['tron', 'tron:0x2b6653dc'] }),
-          ),
-        sourceToken: z
-          .string()
-          .check(
-            z.minLength(1),
-            z.describe('Source token symbol, contract address, or token key.'),
-            z.meta({ examples: ['usdt'] }),
-          ),
-        subsidize: z
-          .optional(z.boolean())
-          .check(
-            z.describe('Guarantees normalized 1:1 delivery through a Tempo-funded subsidy.'),
-            z.meta({ examples: [false] }),
-          ),
-      })
-      .check(z.describe('Reusable funding deposit address creation request.'))
+    export const Body = OpenApi.component(
+      z
+        .strictObject({
+          amount: FundingTransfer.schema.CreateRequest.shape.amount,
+          destinationToken: z
+            .string()
+            .check(
+              z.minLength(1),
+              z.describe('Tempo destination token symbol, contract address, or token key.'),
+              z.meta({ examples: ['usdt0'] }),
+            ),
+          recipient: z
+            .string()
+            .check(
+              z.regex(/^0x[0-9a-fA-F]{40}$/),
+              z.describe('Tempo account that receives completed deposits.'),
+              z.meta({ examples: [`0x${'11'.repeat(20)}`] }),
+            ),
+          refundAddress: z
+            .string()
+            .check(
+              z.minLength(1),
+              z.describe('Source-chain account that receives refunds.'),
+              z.meta({ examples: ['TJRabPrwbZy45sbavfcjinPJC18kjpRTv8'] }),
+            ),
+          sourceChain: z
+            .string()
+            .check(
+              z.minLength(1),
+              z.describe('Source chain CAIP-2 id, slug, or alias.'),
+              z.meta({ examples: ['tron', 'tron:0x2b6653dc'] }),
+            ),
+          sourceToken: z
+            .string()
+            .check(
+              z.minLength(1),
+              z.describe('Source token symbol, contract address, or token key.'),
+              z.meta({ examples: ['usdt'] }),
+            ),
+          subsidize: z
+            .optional(z.boolean())
+            .check(
+              z.describe('Guarantees normalized 1:1 delivery through a Tempo-funded subsidy.'),
+              z.meta({ examples: [false] }),
+            ),
+        })
+        .check(z.describe('Reusable funding deposit address creation request.')),
+      'CreateFundingDepositAddressRequest',
+    )
 
     /** Required headers for funding deposit address creation. */
     export const Headers = z.object({
@@ -95,16 +98,19 @@ export namespace schema {
     })
 
     /** The reusable address, with quoted terms only when the provider address was newly stored. */
-    export const Response = z
-      .union([
-        FundingDepositAddress.schema.CreatedFundingDepositAddress,
-        FundingDepositAddress.schema.FundingDepositAddress,
-      ])
-      .check(
-        z.describe(
-          'A reusable funding deposit address, including terms sampled for a newly stored provider address.',
+    export const Response = OpenApi.component(
+      z
+        .union([
+          FundingDepositAddress.schema.CreatedFundingDepositAddress,
+          FundingDepositAddress.schema.FundingDepositAddress,
+        ])
+        .check(
+          z.describe(
+            'A reusable funding deposit address, including terms sampled for a newly stored provider address.',
+          ),
         ),
-      )
+      'CreateFundingDepositAddressResponse',
+    )
   }
 
   /** Schemas for the getFundingDepositAddress operation. */
@@ -137,14 +143,17 @@ export namespace schema {
       .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.'))
+    export const Response = OpenApi.component(
+      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.')),
+      'FundingDepositAddressList',
+    )
   }
 
   /** Schemas for the reconcileFundingDepositAddress operation. */
@@ -199,15 +208,18 @@ export namespace schema {
       .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 visible funding deposits.'))
+    export const Response = OpenApi.component(
+      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 visible funding deposits.')),
+      'FundingDepositList',
+    )
   }
 
   /** Schemas for the getFundingDeposit operation. */

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

@@ -22,11 +22,14 @@ export namespace schema {
   /** Schemas for the getFundingProviders operation. */
   export namespace getFundingProviders {
     /** Non-paginated funding provider catalog. */
-    export const Response = Schema.describe(
-      z.object({
-        data: z.array(Provider).check(z.describe("Providers in Tempo's funding quote catalog.")),
-      }),
-      'A non-paginated list of funding quote providers.',
+    export const Response = OpenApi.component(
+      Schema.describe(
+        z.object({
+          data: z.array(Provider).check(z.describe("Providers in Tempo's funding quote catalog.")),
+        }),
+        'A non-paginated list of funding quote providers.',
+      ),
+      'FundingProviderList',
     )
   }
 }
@@ -44,6 +47,7 @@ export function providers() {
       description: 'Lists available transfer providers.',
       operationId: 'getFundingProviders',
       responses: OpenApi.responses({
+        errors: { 400: { codes: [] } },
         success: {
           description: 'Funding quote providers supported by Tempo.',
           example: providersResponseExample,

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

@@ -10,6 +10,8 @@ import * as Rhino from '../../../internal/funding/providers/rhino.js'
 
 import * as Squid from '../../../internal/funding/providers/squid.js'
 
+import * as Stargate from '../../../internal/funding/providers/stargate.js'
+
 import * as Symbiosis from '../../../internal/funding/providers/symbiosis.js'
 
 import type * as Log from '../../../internal/Log.js'
@@ -34,6 +36,10 @@ const providers = [
     integratorId: 'squid-integrator-id',
     userAddress: '0x1111111111111111111111111111111111111111',
   }),
+  Stargate.stargate({
+    apiKey: 'layerzero-api-key',
+    userAddress: '0x1111111111111111111111111111111111111111',
+  }),
   Symbiosis.symbiosis({ userAddress: '0x1111111111111111111111111111111111111111' }),
 ] as const
 
@@ -175,6 +181,27 @@ describe('GET /funding/quotes', () => {
     expect(body.data[0]?.quote.expiresAt).toBe('2026-01-01T00:01:00Z')
   })
 
+  test('returns Stargate quotes for Base USDC to Tempo USDC.e', async () => {
+    const app = create({ providers: [stargateProvider()] })
+    const response = await app.request(quoteUrl({ ...baseUsdcQuery, provider: 'stargate' }), {
+      headers: TestApp.auth.headers,
+    })
+
+    expect(response.status).toBe(200)
+    const body = await TestApp.json(response, Funding.schema.quoteFunding.Response)
+    expect(body.data[0]).toMatchObject({
+      destinationAmount: { baseUnits: '999600' },
+      destinationAmountMin: { baseUnits: '999100' },
+      id: 'base-usdc-tempo-usdce-stargate',
+      provider: { id: 'stargate', name: 'Stargate' },
+      quality: {
+        liquiditySource: 'providerQuote',
+        sourceDetail: 'stargate:value-transfer-v1:bus',
+        tier: 'liquid',
+      },
+    })
+  })
+
   test('returns non-EVM Rhino quotes with stable chain and token ids', async () => {
     const app = create({ providers: [rhinoProvider()] })
     const response = await app.request(
@@ -501,6 +528,25 @@ function rhinoProvider() {
   })
 }
 
+function stargateProvider() {
+  return withGetQuote('stargate', async (input, signal) => {
+    expect(signal.aborted).toBe(false)
+    expect(input.candidate.id).toBe('base-usdc-tempo-usdce-stargate')
+    return {
+      destinationAmountMin: '999100',
+      destinationAmount: '999600',
+      quality: {
+        estimatedSeconds: 28,
+        liquiditySource: 'providerQuote',
+        sourceDetail: 'stargate:value-transfer-v1:bus',
+        tier: 'liquid',
+      },
+      sampledAt: '2026-01-01T00:00:00Z',
+      status: 'available',
+    }
+  })
+}
+
 function withGetQuote(
   id: FundingProvider.ProviderId,
   getQuote: FundingProvider.Provider['getQuote'],

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

@@ -22,11 +22,14 @@ export namespace schema {
     export const Query = FundingProvider.schema.QuoteRequest
 
     /** Non-paginated list of successful funding quotes. */
-    export const Response = Schema.describe(
-      z.object({
-        data: z.array(FundingQuote).check(z.describe('Successful live funding quotes.')),
-      }),
-      'A non-paginated list of successful live funding quotes.',
+    export const Response = OpenApi.component(
+      Schema.describe(
+        z.object({
+          data: z.array(FundingQuote).check(z.describe('Successful live funding quotes.')),
+        }),
+        'A non-paginated list of successful live funding quotes.',
+      ),
+      'FundingQuoteList',
     )
   }
 }

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

@@ -39,6 +39,24 @@ function create(options: TestApp.create.Options = {}) {
   return TestApp.create({ ...options, db })
 }
 
+type JsonSchema = {
+  $ref?: string | undefined
+  additionalProperties?: boolean | undefined
+  examples?: readonly unknown[] | undefined
+  properties?: Record<string, JsonSchema> | undefined
+  required?: readonly string[] | undefined
+}
+
+type ComponentSpec = {
+  components: { schemas: Record<string, JsonSchema> }
+}
+
+function dereference(spec: ComponentSpec, schema: JsonSchema): JsonSchema {
+  if (!schema.$ref) return schema
+  const name = schema.$ref.split('/').at(-1)!
+  return spec.components.schemas[name]!
+}
+
 describe('GET /funding/transfers', () => {
   test('requires the funding:read scope', async () => {
     const app = transfersApp()
@@ -766,33 +784,23 @@ describe('funding transfers OpenAPI', () => {
 
   test('publishes human-readable deposit address route examples', async () => {
     const app = create({ auth: false })
-    type Property = { examples: string[] }
     type Operation = {
       requestBody: {
-        content: Record<
-          string,
-          {
-            schema: {
-              properties: {
-                destinationToken: Property
-                sourceChain: Property
-                sourceToken: Property
-              }
-            }
-          }
-        >
+        content: Record<string, { schema: JsonSchema }>
       }
     }
-    type Spec = { paths: Record<string, { post: Operation }> }
+    type Spec = ComponentSpec & { paths: Record<string, { post: Operation }> }
     const spec = (await (await app.request('/openapi.json')).json()) as Spec
-    const properties =
+    const properties = dereference(
+      spec,
       spec.paths['/v1/funding/deposit-addresses']!.post.requestBody.content['application/json']!
-        .schema.properties
+        .schema,
+    ).properties!
 
     expect({
-      destinationToken: properties.destinationToken.examples,
-      sourceChain: properties.sourceChain.examples,
-      sourceToken: properties.sourceToken.examples,
+      destinationToken: properties['destinationToken']!.examples,
+      sourceChain: properties['sourceChain']!.examples,
+      sourceToken: properties['sourceToken']!.examples,
     }).toMatchInlineSnapshot(`
       {
         "destinationToken": [
@@ -949,30 +957,22 @@ describe('funding transfers OpenAPI', () => {
 
   test('publishes concrete creation schemas', async () => {
     const app = create({ auth: false })
-    const spec = (await (await app.request('/openapi.json')).json()) as {
+    type Spec = ComponentSpec & {
       paths: Record<
         string,
         {
           post?: {
             requestBody: {
-              content: Record<
-                string,
-                {
-                  schema: {
-                    additionalProperties?: boolean
-                    properties: object
-                    required?: readonly string[] | undefined
-                  }
-                }
-              >
+              content: Record<string, { schema: JsonSchema }>
             }
             responses: Record<string, unknown>
           }
         }
       >
     }
+    const spec = (await (await app.request('/openapi.json')).json()) as Spec
     const creationSchema = (path: string) =>
-      spec.paths[path]!.post!.requestBody.content['application/json']!.schema
+      dereference(spec, spec.paths[path]!.post!.requestBody.content['application/json']!.schema)
     expect(
       creationSchema('/v1/funding/deposit-addresses').required?.includes('subsidize') ?? false,
     ).toMatchInlineSnapshot(`false`)
@@ -980,7 +980,7 @@ describe('funding transfers OpenAPI', () => {
       const schema = creationSchema(path)
       return {
         additionalProperties: schema.additionalProperties,
-        properties: Object.keys(schema.properties),
+        properties: Object.keys(schema.properties!),
       }
     }
 
@@ -1025,6 +1025,7 @@ describe('funding transfers OpenAPI', () => {
           "200",
           "400",
           "401",
+          "403",
           "404",
           "409",
           "429",
@@ -1047,6 +1048,7 @@ describe('funding transfers OpenAPI', () => {
         "vaultResponses": [
           "400",
           "401",
+          "403",
           "429",
           "500",
           "501",
@@ -1069,6 +1071,7 @@ describe('funding transfers OpenAPI', () => {
         "zoneResponses": [
           "400",
           "401",
+          "403",
           "429",
           "500",
           "501",

package/src/apps/management/Billing.test.ts

@@ -199,6 +199,32 @@ describe('createReporter', () => {
     await db.close()
   })
 
+  test('behavior: marks a meter event that Stripe already accepted', async () => {
+    const db = create()
+    await db.migrate()
+    await StripeCustomers.create(db, { orgId: 'org_1', stripeCustomerId: 'cus_1' })
+    const row = await finalized(db, { feeAmount: '100000', seed: '03' })
+
+    const { stripe } = stubStripe({
+      meterEvent: (params) => {
+        throw new Error(`An event already exists with identifier ${params.identifier}.`)
+      },
+      subscriptions: [{ items: ['feePayerSpend', 'apiRequests'], status: 'active' }],
+    })
+    expect(await Billing.createReporter({ db, stripe }).tick()).toStrictEqual({
+      failed: 0,
+      reported: 1,
+      skipped: 0,
+    })
+    expect((await SponsoredTransactions.get(db, row.id))?.meterReportedAt).not.toBeNull()
+    expect(await Billing.createReporter({ db, stripe }).tick()).toStrictEqual({
+      failed: 0,
+      reported: 0,
+      skipped: 0,
+    })
+    await db.close()
+  })
+
   test('behavior: canceled customers skip without meter events', async () => {
     const db = create()
     await db.migrate()

package/src/apps/management/Billing.ts

@@ -357,12 +357,18 @@ export function createReporter(options: createReporter.Options): createReporter.
             const stamp = recent && !subscription.items.feePayerSpend?.created
             // The row id makes short-window retries idempotent on Stripe's
             // side; `meter_reported_at` is the durable exactly-once guard.
-            await stripe.billing.meterEvents.create({
-              event_name: meterEventName,
-              identifier: row.id,
-              payload: { stripe_customer_id: customer.stripeCustomerId, value: row.feeAmount! },
-              ...(stamp ? { timestamp: Math.floor(finalizedAt / 1000) } : {}),
-            })
+            try {
+              await stripe.billing.meterEvents.create({
+                event_name: meterEventName,
+                identifier: row.id,
+                payload: { stripe_customer_id: customer.stripeCustomerId, value: row.feeAmount! },
+                ...(stamp ? { timestamp: Math.floor(finalizedAt / 1000) } : {}),
+              })
+            } catch (error) {
+              // Stripe may persist the event before the Worker records its ack.
+              // Its duplicate response proves this exact row was already metered.
+              if (!isDuplicateMeterEvent(error, row.id)) throw error
+            }
             reported++
           } else {
             // Deleted orgs and Stripe-deleted (canceled) customers keep their
@@ -381,6 +387,14 @@ export function createReporter(options: createReporter.Options): createReporter.
   }
 }
 
+/** Whether Stripe confirms that the exact meter event identifier already exists. */
+function isDuplicateMeterEvent(error: unknown, identifier: string): boolean {
+  return (
+    error instanceof Error &&
+    error.message === `An event already exists with identifier ${identifier}.`
+  )
+}
+
 export declare namespace createReporter {
   /** Options for {@link createReporter}. */
   type Options = {
@@ -452,7 +466,10 @@ export function createRequestUsageReporter(
             count: status.count,
             environment,
             oldestPendingAgeSeconds: status.oldestAttemptedAt
-              ? Math.max(0, Math.floor((now() - new Date(status.oldestAttemptedAt).getTime()) / 1_000))
+              ? Math.max(
+                  0,
+                  Math.floor((now() - new Date(status.oldestAttemptedAt).getTime()) / 1_000),
+                )
               : 0,
           }
         }),