tapimo 0.12.0 → 0.13.0

package/src/apps/data/routes/transfers.ts

@@ -122,17 +122,23 @@ export namespace schema {
       ),
     )
 
-  /** A token amount carrying its nominal value in the requested denomination. */
-  const ValuedAmount = z.extend(Schema.TokenAmount, {
-    valuation: z
-      .optional(z.nullable(Valuation.schema.Value))
-      .check(
-        z.describe(
-          'The amount’s nominal value in the requested `valuation.currency`. `null` when the token is ' +
-            'unverified, its display currency has no rate, or rates were unavailable.',
+  const transferToken = OpenApi.component(SourceToken, 'TokenTransferToken')
+
+  const ValuedAmount = Schema.describe(
+    z.extend(Schema.TokenAmount, {
+      valuation: z
+        .optional(z.nullable(Valuation.schema.Value))
+        .check(
+          z.describe(
+            'The amount’s nominal value in the requested `valuation.currency`. `null` when the token is ' +
+              'unverified, its display currency has no rate, or rates were unavailable.',
+          ),
         ),
-      ),
-  })
+    }),
+    'A token amount carrying its nominal value in the requested denomination.',
+  )
+
+  const valuedTokenAmount = OpenApi.component(ValuedAmount, 'ValuedTokenAmount')
 
   /**
    * Filter predicates shared verbatim by the `GET /transfers` list query
@@ -243,14 +249,14 @@ export namespace schema {
             z.meta({ examples: [23456789] }),
           ),
         destinationAmount: z
-          .optional(ValuedAmount)
+          .optional(valuedTokenAmount)
           .check(
             z.describe(
               'Amount delivered to the recipient for a cross-token transfer. Omitted with `destinationToken` for a same-token transfer.',
             ),
           ),
         destinationToken: z
-          .optional(schema.SourceToken)
+          .optional(transferToken)
           .check(
             z.describe(
               'The token delivered to the recipient when it differs from `sourceToken`. Omitted for same-token transfers and returned only with `include=crossToken`.',
@@ -284,8 +290,8 @@ export namespace schema {
           z.describe('The account address that received the tokens.'),
         ),
         sender: Schema.Address.check(z.describe('The account address that sent the tokens.')),
-        sourceAmount: ValuedAmount.check(z.describe('Amount associated with `sourceToken`.')),
-        sourceToken: schema.SourceToken.check(z.describe('The token that moved.')),
+        sourceAmount: valuedTokenAmount,
+        sourceToken: transferToken.check(z.describe('The token that moved.')),
         timestamp: z.iso
           .datetime()
           .check(
@@ -310,6 +316,8 @@ export namespace schema {
         ),
       )
 
+    const transfer = OpenApi.component(Transfer, 'TokenTransfer')
+
     /** Page-level resources: opt-in counts plus valuation rate provenance. */
     export const Meta = z
       .object({
@@ -326,19 +334,26 @@ export namespace schema {
       })
       .check(z.describe('Page-level resources attached to this response.'))
 
+    const meta = OpenApi.component(Meta, 'TokenTransferListMeta')
+
     /** Page of TIP-20 token transfers across the chain, ordered by block then log index. */
-    export const Response = z
-      .object({
-        data: z.array(Transfer).check(z.describe('The transfers in this page.')),
-        // Response-wide `meta` carries the opt-in capped total count
-        // (`include=totalCount`) and valuation rate provenance; per-row embeds
-        // (`memo`, `token`) attach to each `data` item, not here.
-        meta: z
-          .optional(Meta)
-          .check(z.describe('Page-level resources: opt-in counts and valuation rate provenance.')),
-        nextCursor: Schema.NextCursor,
-      })
-      .check(z.describe('A page of TIP-20 token transfer events across the chain.'))
+    export const Response = OpenApi.component(
+      z
+        .object({
+          data: z.array(transfer).check(z.describe('The transfers in this page.')),
+          // Response-wide `meta` carries the opt-in capped total count
+          // (`include=totalCount`) and valuation rate provenance; per-row embeds
+          // (`memo`, `token`) attach to each `data` item, not here.
+          meta: z
+            .optional(meta)
+            .check(
+              z.describe('Page-level resources: opt-in counts and valuation rate provenance.'),
+            ),
+          nextCursor: Schema.NextCursor,
+        })
+        .check(z.describe('A page of TIP-20 token transfer events across the chain.')),
+      'TokenTransferList',
+    )
   }
 }
 
@@ -364,7 +379,10 @@ export function transfers(options: transfers.Options = {}) {
       description: 'List token transfer events across Tempo.',
       operationId: 'getTransfers',
       responses: OpenApi.responses({
-        errors: { 502: 'The indexer or Tempo RPC could not serve this request.' },
+        errors: {
+          400: { codes: ['chain_id_invalid', 'chain_id_unsupported', 'query_invalid'] },
+          502: 'The indexer or Tempo RPC could not serve this request.',
+        },
         success: {
           description: 'A page of token transfer events.',
           schema: schema.getTransfers.Response,

package/src/apps/data/routes/valuation.ts

@@ -23,47 +23,55 @@ const tokenReadChunkSize = 20
 /** Zod schemas owned by the valuation handlers. */
 export namespace schema {
   /** A holding's nominal value in the requested denomination. */
-  export const Value = z
-    .object({
-      amount: z
-        .string()
-        .check(
-          z.regex(/^\d+(\.\d+)?$/),
-          z.describe('The holding’s nominal value, as a decimal string in `currency`.'),
-          z.meta({ examples: ['1.50'] }),
-        ),
-      currency: z
-        .string()
-        .check(
-          z.describe('The denomination currency of this value.'),
-          z.meta({ examples: ['USD'] }),
-        ),
-    })
-    .check(z.describe('The holding’s nominal value in the requested denomination.'))
+  export const Value = OpenApi.component(
+    z
+      .object({
+        amount: z
+          .string()
+          .check(
+            z.regex(/^\d+(\.\d+)?$/),
+            z.describe('The holding’s nominal value, as a decimal string in `currency`.'),
+            z.meta({ examples: ['1.50'] }),
+          ),
+        currency: z
+          .string()
+          .check(
+            z.describe('The denomination currency of this value.'),
+            z.meta({ examples: ['USD'] }),
+          ),
+      })
+      .check(z.describe('The holding’s nominal value in the requested denomination.')),
+    'ValuationValue',
+  )
 
   /** Rate provenance for a converted valuation. */
-  export const Pricing = z
-    .object({
-      asOf: z.iso
-        .datetime()
-        .check(
-          z.describe('Publication date of the rate set as an ISO 8601 timestamp.'),
-          z.meta({ examples: ['2026-07-20T00:00:00.000Z'] }),
-        ),
-      basis: z
-        .literal('nominal')
-        .check(
-          z.describe('Valuation basis: one token unit counts as one unit of its display currency.'),
-          z.meta({ examples: ['nominal'] }),
-        ),
-      source: z
-        .string()
-        .check(
-          z.describe('FX rate oracle that supplied the conversion rates.'),
-          z.meta({ examples: ['ecb'] }),
-        ),
-    })
-    .check(z.describe('Rate provenance for a converted valuation.'))
+  export const Pricing = OpenApi.component(
+    z
+      .object({
+        asOf: z.iso
+          .datetime()
+          .check(
+            z.describe('Publication date of the rate set as an ISO 8601 timestamp.'),
+            z.meta({ examples: ['2026-07-20T00:00:00.000Z'] }),
+          ),
+        basis: z
+          .literal('nominal')
+          .check(
+            z.describe(
+              'Valuation basis: one token unit counts as one unit of its display currency.',
+            ),
+            z.meta({ examples: ['nominal'] }),
+          ),
+        source: z
+          .string()
+          .check(
+            z.describe('FX rate oracle that supplied the conversion rates.'),
+            z.meta({ examples: ['ecb'] }),
+          ),
+      })
+      .check(z.describe('Rate provenance for a converted valuation.')),
+    'ValuationPricing',
+  )
 
   /** Schemas for the getAddressValuation operation. */
   export namespace getAddressValuation {
@@ -89,47 +97,50 @@ export namespace schema {
       .check(z.describe('Query parameters for valuing an account’s verified holdings.'))
 
     /** The nominal valuation of an account's verified holdings. */
-    export const Response = z
-      .object({
-        address: Schema.Address.check(z.describe('The account address this valuation covers.')),
-        amount: z
-          .string()
-          .check(
-            z.regex(/^\d+(\.\d+)?$/),
-            z.describe(
-              'The total value of the account’s verified holdings, as a decimal string in `currency`.',
+    export const Response = OpenApi.component(
+      z
+        .object({
+          address: Schema.Address.check(z.describe('The account address this valuation covers.')),
+          amount: z
+            .string()
+            .check(
+              z.regex(/^\d+(\.\d+)?$/),
+              z.describe(
+                'The total value of the account’s verified holdings, as a decimal string in `currency`.',
+              ),
+              z.meta({ examples: ['160.50'] }),
             ),
-            z.meta({ examples: ['160.50'] }),
-          ),
-        currency: z
-          .string()
-          .check(
-            z.describe('The denomination currency of `amount`.'),
-            z.meta({ examples: ['USD'] }),
-          ),
-        id: z
-          .string()
-          .check(
-            z.describe('A stable resource ID for this valuation, equal to the account address.'),
-            z.meta({ examples: ['0xbe058e1c4df8a4366a387bf595b284246a93039e'] }),
-          ),
-        pricing: z
-          .nullable(Pricing)
-          .check(
-            z.describe(
-              'Rate provenance, or `null` when every valued holding was already denominated in `currency`.',
+          currency: z
+            .string()
+            .check(
+              z.describe('The denomination currency of `amount`.'),
+              z.meta({ examples: ['USD'] }),
             ),
-          ),
-        unpriced: z
-          .array(z.string())
-          .check(
-            z.describe(
-              'Display currencies excluded from `amount` because the FX oracle has no rate for them.',
+          id: z
+            .string()
+            .check(
+              z.describe('A stable resource ID for this valuation, equal to the account address.'),
+              z.meta({ examples: ['0xbe058e1c4df8a4366a387bf595b284246a93039e'] }),
             ),
-            z.meta({ examples: [['BTC']] }),
-          ),
-      })
-      .check(z.describe('The nominal valuation of an account’s verified token holdings.'))
+          pricing: z
+            .nullable(Pricing)
+            .check(
+              z.describe(
+                'Rate provenance, or `null` when every valued holding was already denominated in `currency`.',
+              ),
+            ),
+          unpriced: z
+            .array(z.string())
+            .check(
+              z.describe(
+                'Display currencies excluded from `amount` because the FX oracle has no rate for them.',
+              ),
+              z.meta({ examples: [['BTC']] }),
+            ),
+        })
+        .check(z.describe('The nominal valuation of an account’s verified token holdings.')),
+      'AddressValuation',
+    )
   }
 }
 
@@ -155,7 +166,12 @@ export function addresses(options: addresses.Options = {}) {
         'Values every verified TIP-20 token an account holds as one unit of its display currency, converts each currency into the requested denomination using the configured FX rates, and returns the total.',
       operationId: 'getAddressValuation',
       responses: OpenApi.responses({
-        errors: { 502: 'Could not read balances or exchange rates from an upstream service.' },
+        errors: {
+          400: {
+            codes: ['address_invalid', 'chain_id_invalid', 'chain_id_unsupported', 'query_invalid'],
+          },
+          502: 'Could not read balances or exchange rates from an upstream service.',
+        },
         success: {
           description: 'The valuation of this account’s verified holdings.',
           schema: schema.getAddressValuation.Response,

package/src/apps/data/routes/zones.test.ts

@@ -335,7 +335,7 @@ describe('GET /v1/zones/withdrawals/:senderTag', () => {
     expect(response.status).toBe(403)
     expect(body.error.code).toBe('api_key_forbidden')
     expect(body.error.message).toBe(
-      `Chain id ${runtime.zone.chainId} is a zone. Use an API key granting \`zone:${runtime.zone.chainId}:read\` or \`zone:${runtime.zone.chainId}:write\`.`,
+      `Chain ID ${runtime.zone.chainId} is a Zone. Use an API key granting \`zone:${runtime.zone.chainId}:read\` or \`zone:${runtime.zone.chainId}:write\`.`,
     )
   })
 
@@ -423,7 +423,7 @@ describe('GET /v1/zones/withdrawals/:senderTag', () => {
         },
         {
           "examples": [
-            1424310001,
+            1424310003,
           ],
           "name": "chainId",
           "required": true,

package/src/apps/data/routes/zones.ts

@@ -43,7 +43,7 @@ export namespace schema {
       .strictObject({
         chainId: Schema.ChainId.check(
           z.describe('The chain id of the Zone where the withdrawal originated.'),
-          z.meta({ examples: [1_424_310_001] }),
+          z.meta({ examples: [1_424_310_003] }),
         ),
       })
       .check(z.describe('Query parameters used to select the originating Zone.'))

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

@@ -65,6 +65,21 @@ type ContractResponse = {
   content?: Record<string, { schema: unknown }> | undefined
 }
 
+type JsonSchema = {
+  $ref?: string | undefined
+  properties?: Record<string, JsonSchema> | 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]!
+}
+
 test('publishes generator-ready funding deposit contracts', async () => {
   const spec = await (await create({ auth: false }).request('/openapi.json')).json()
   const depositAddressPath = Object.keys(spec.paths).find(
@@ -126,9 +141,10 @@ test('publishes generator-ready funding deposit contracts', async () => {
       addressList: spec.components.schemas.FundingDepositAddressList.properties.data.items,
       createResponse: spec.components.schemas.CreateFundingDepositAddressResponse.anyOf,
       createdAddress: {
-        feeToken:
-          spec.components.schemas.CreatedFundingDepositAddress.properties.fees.items.properties
-            .token,
+        feeToken: dereference(
+          spec,
+          spec.components.schemas.CreatedFundingDepositAddress.properties.fees.items,
+        ).properties!['token'],
         quote: spec.components.schemas.CreatedFundingDepositAddress.properties.quote,
       },
       deposit: {
@@ -278,6 +294,7 @@ test('publishes generator-ready funding deposit contracts', async () => {
             "502": {
               "$ref": "#/components/schemas/UpstreamError",
             },
+            "504": "#/components/responses/RequestTimeout",
           },
           "operationId": "createFundingDepositAddress",
           "request": {
@@ -306,6 +323,7 @@ test('publishes generator-ready funding deposit contracts', async () => {
             "502": {
               "$ref": "#/components/schemas/UpstreamError",
             },
+            "504": "#/components/responses/RequestTimeout",
           },
           "operationId": "getFundingDepositAddress",
           "request": undefined,
@@ -332,6 +350,7 @@ test('publishes generator-ready funding deposit contracts', async () => {
             "502": {
               "$ref": "#/components/schemas/UpstreamError",
             },
+            "504": "#/components/responses/RequestTimeout",
           },
           "operationId": "getFundingDeposit",
           "request": undefined,
@@ -355,6 +374,7 @@ test('publishes generator-ready funding deposit contracts', async () => {
             "502": {
               "$ref": "#/components/schemas/UpstreamError",
             },
+            "504": "#/components/responses/RequestTimeout",
           },
           "operationId": "listFundingDepositAddresses",
           "request": undefined,
@@ -378,6 +398,7 @@ test('publishes generator-ready funding deposit contracts', async () => {
             "502": {
               "$ref": "#/components/schemas/UpstreamError",
             },
+            "504": "#/components/responses/RequestTimeout",
           },
           "operationId": "listFundingDeposits",
           "request": undefined,
@@ -410,6 +431,7 @@ test('publishes generator-ready funding deposit contracts', async () => {
             "502": {
               "$ref": "#/components/schemas/UpstreamError",
             },
+            "504": "#/components/responses/RequestTimeout",
           },
           "operationId": "reconcileFundingDepositAddress",
           "request": undefined,

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

@@ -700,8 +700,6 @@ export function depositAddresses(options: depositAddresses.Options = {}) {
             refundAddress,
             result,
           } = selected
-          const feeToken = (side: 'destination' | 'source') =>
-            side === 'source' ? selectedCandidate.sourceToken : selectedCandidate.destinationToken
           const created = await db.transaction(async (tx) => {
             const stored = await FundingDepositAddress.createOrGet(tx, {
               apiKeyId: principal.id,
@@ -741,16 +739,23 @@ export function depositAddresses(options: depositAddresses.Options = {}) {
                 currency: selectedCandidate.destinationToken.currency,
                 decimals: selectedCandidate.destinationToken.decimals,
               }),
-              fees: result.fees.map((fee) => ({
-                amount: Value.tokenAmount({
-                  baseUnits: fee.amount,
-                  currency: feeToken(fee.side).currency,
-                  decimals: feeToken(fee.side).decimals,
-                }),
-                side: fee.side,
-                token: feeToken(fee.side),
-                type: 'provider',
-              })),
+              fees: result.fees.map((fee) => {
+                const token =
+                  fee.token ??
+                  (fee.side === 'source'
+                    ? selectedCandidate.sourceToken
+                    : selectedCandidate.destinationToken)
+                return {
+                  amount: Value.tokenAmount({
+                    baseUnits: fee.amount,
+                    currency: token.currency,
+                    decimals: token.decimals,
+                  }),
+                  side: fee.side,
+                  token,
+                  type: 'provider',
+                }
+              }),
               quote: {
                 ...(result.expiresAt === undefined ? {} : { expiresAt: result.expiresAt }),
                 sampledAt: result.sampledAt,

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

@@ -36,10 +36,7 @@ const providers = [
     integratorId: 'squid-integrator-id',
     userAddress: '0x1111111111111111111111111111111111111111',
   }),
-  Stargate.stargate({
-    apiKey: 'layerzero-api-key',
-    userAddress: '0x1111111111111111111111111111111111111111',
-  }),
+  Stargate.stargate(),
   Symbiosis.symbiosis({ userAddress: '0x1111111111111111111111111111111111111111' }),
 ] as const
 
@@ -195,8 +192,8 @@ describe('GET /funding/quotes', () => {
       id: 'base-usdc-tempo-usdce-stargate',
       provider: { id: 'stargate', name: 'Stargate' },
       quality: {
-        liquiditySource: 'providerQuote',
-        sourceDetail: 'stargate:value-transfer-v1:bus',
+        liquiditySource: 'onchain',
+        sourceDetail: 'stargate:oft-v2:taxi',
         tier: 'liquid',
       },
     })
@@ -536,9 +533,8 @@ function stargateProvider() {
       destinationAmountMin: '999100',
       destinationAmount: '999600',
       quality: {
-        estimatedSeconds: 28,
-        liquiditySource: 'providerQuote',
-        sourceDetail: 'stargate:value-transfer-v1:bus',
+        liquiditySource: 'onchain',
+        sourceDetail: 'stargate:oft-v2:taxi',
         tier: 'liquid',
       },
       sampledAt: '2026-01-01T00:00:00Z',