tapimo 0.6.0 → 0.7.0

package/dist/apps/data/routes/rpc.d.ts

@@ -67,96 +67,96 @@ export declare function rpc(): import("hono/hono-base").HonoBase<App.Environment
     "/rpc/:chain{(mainnet|testnet|[0-9]+)}?": {
         $post: {
             output: {
-                error?: {
-                    code: number;
-                    data?: import("hono/utils/types").JSONValue;
-                    message: string;
-                } | undefined;
-                id?: string | number | null | undefined;
-                jsonrpc: "2.0";
-                result?: import("hono/utils/types").JSONValue;
-            }[] | {
-                error?: {
-                    code: number;
-                    data?: import("hono/utils/types").JSONValue;
+                error: {
+                    code: "api_key_malformed";
+                    details?: readonly Response.error.Detail[] | undefined;
                     message: string;
-                } | undefined;
-                id?: string | number | null | undefined;
-                jsonrpc: "2.0";
-                result?: import("hono/utils/types").JSONValue;
+                };
+                requestId: string;
             };
             outputFormat: "json";
-            status: 200;
+            status: 400;
             input: {
                 param: Record<"chain", string | undefined>;
             };
         } | {
             output: {
                 error: {
-                    code: "api_key_malformed";
+                    code: "api_key_invalid" | "api_key_missing";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400;
+            status: 401;
             input: {
                 param: Record<"chain", string | undefined>;
             };
         } | {
             output: {
                 error: {
-                    code: "chain_id_invalid";
+                    code: "api_key_forbidden";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400;
+            status: 403;
             input: {
                 param: Record<"chain", string | undefined>;
             };
         } | {
             output: {
                 error: {
-                    code: "api_key_invalid" | "api_key_missing";
+                    code: "payment_required" | "rate_limit_exceeded";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 401;
+            status: 429;
             input: {
                 param: Record<"chain", string | undefined>;
             };
         } | {
             output: {
                 error: {
-                    code: "api_key_forbidden";
+                    code: "chain_id_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 403;
+            status: 400;
             input: {
                 param: Record<"chain", string | undefined>;
             };
         } | {
             output: {
-                error: {
-                    code: "payment_required" | "rate_limit_exceeded";
-                    details?: readonly Response.error.Detail[] | undefined;
+                error?: {
+                    code: number;
+                    data?: import("hono/utils/types").JSONValue;
                     message: string;
-                };
-                requestId: string;
+                } | undefined;
+                id?: string | number | null | undefined;
+                jsonrpc: "2.0";
+                result?: import("hono/utils/types").JSONValue;
+            }[] | {
+                error?: {
+                    code: number;
+                    data?: import("hono/utils/types").JSONValue;
+                    message: string;
+                } | undefined;
+                id?: string | number | null | undefined;
+                jsonrpc: "2.0";
+                result?: import("hono/utils/types").JSONValue;
             };
             outputFormat: "json";
-            status: 429;
+            status: 200;
             input: {
                 param: Record<"chain", string | undefined>;
             };

package/dist/apps/data/routes/tokens.d.ts

@@ -393,7 +393,7 @@ export declare namespace schema {
                         }, z.core.$loose>>;
                         meta: z.ZodMiniObject<{
                             pricing: z.ZodMiniOptional<z.ZodMiniObject<{
-                                asOf: z.ZodMiniString<string>;
+                                asOf: z.ZodMiniISODateTime;
                                 basis: z.ZodMiniLiteral<"nominal">;
                                 source: z.ZodMiniString<string>;
                             }, z.core.$strip>>;
@@ -2154,7 +2154,7 @@ declare namespace getTokenMetadata {
 }
 /**
  * Resolves a token's curated R2 icon URI, memoized per `(chainId, address)`
- * so page enrichers (balances, holders, transfers `include=token`) don't
+ * so page enrichers (balances, holders, transfers `include=token.logoUri`) don't
  * re-fetch the asset per row on every request. Misses are memoized as `null`
  * too — most tokens have no curated icon, and the negative lookup is exactly
  * what page enrichment would otherwise repeat N times per page.

package/dist/apps/data/routes/tokens.js

@@ -908,7 +908,7 @@ export function getTokenMetadata(c, options) {
 }
 /**
  * Resolves a token's curated R2 icon URI, memoized per `(chainId, address)`
- * so page enrichers (balances, holders, transfers `include=token`) don't
+ * so page enrichers (balances, holders, transfers `include=token.logoUri`) don't
  * re-fetch the asset per row on every request. Misses are memoized as `null`
  * too — most tokens have no curated icon, and the negative lookup is exactly
  * what page enrichment would otherwise repeat N times per page.

package/dist/apps/data/routes/transactions.d.ts

@@ -127,7 +127,7 @@ export declare namespace schema {
             }, z.core.$loose>>;
             meta: z.ZodMiniObject<{
                 pricing: z.ZodMiniOptional<z.ZodMiniObject<{
-                    asOf: z.ZodMiniString<string>;
+                    asOf: z.ZodMiniISODateTime;
                     basis: z.ZodMiniLiteral<"nominal">;
                     source: z.ZodMiniString<string>;
                 }, z.core.$strip>>;
@@ -319,7 +319,7 @@ export declare namespace schema {
                 }, z.core.$loose>>;
                 meta: z.ZodMiniObject<{
                     pricing: z.ZodMiniOptional<z.ZodMiniObject<{
-                        asOf: z.ZodMiniString<string>;
+                        asOf: z.ZodMiniISODateTime;
                         basis: z.ZodMiniLiteral<"nominal">;
                         source: z.ZodMiniString<string>;
                     }, z.core.$strip>>;
@@ -545,7 +545,7 @@ export declare namespace schema {
                     }, z.core.$loose>>;
                     meta: z.ZodMiniObject<{
                         pricing: z.ZodMiniOptional<z.ZodMiniObject<{
-                            asOf: z.ZodMiniString<string>;
+                            asOf: z.ZodMiniISODateTime;
                             basis: z.ZodMiniLiteral<"nominal">;
                             source: z.ZodMiniString<string>;
                         }, z.core.$strip>>;
@@ -796,7 +796,7 @@ export declare namespace schema {
                         }, z.core.$loose>>;
                         meta: z.ZodMiniObject<{
                             pricing: z.ZodMiniOptional<z.ZodMiniObject<{
-                                asOf: z.ZodMiniString<string>;
+                                asOf: z.ZodMiniISODateTime;
                                 basis: z.ZodMiniLiteral<"nominal">;
                                 source: z.ZodMiniString<string>;
                             }, z.core.$strip>>;

package/dist/apps/data/routes/transfers.d.ts

@@ -9,33 +9,14 @@ import * as Valuation from './valuation.js';
 export declare const signature = "event Transfer(address indexed from, address indexed to, uint256 value)";
 /** Zod schemas owned by the transfer handlers. */
 export declare namespace schema {
-    /**
-     * The token moved by a transfer: its contract address and the transferred
-     * amount, plus the trimmed token reference spread in when requested via
-     * `include=token`. Reference fields are absent on the base (no-`include`)
-     * response and best-effort when requested (a row whose metadata is
-     * unavailable keeps just `address`/`amount`). Shared by every per-row
-     * transfer response across the API.
-     *
-     * The optional metadata fields are inlined here (rather than spread from
-     * `Tokens.schema.Token` via `z.partial`) so this module avoids referencing
-     * the `tokens` schema namespace at module-init time — `transfers` and
-     * `tokens` import each other for runtime helpers (`Transfers.query`,
-     * `Tokens.resolveToken`), and the schema-evaluation back-edge would
-     * otherwise deadlock the namespace.
-     */
+    /** A transfer token reference with RPC metadata. Inlined to avoid the `transfers`/`tokens` module cycle. */
     const SourceToken: z.ZodMiniObject<{
         address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
-        amount: z.ZodMiniString<string>;
-        currency: z.ZodMiniOptional<z.ZodMiniString<string>>;
-        decimals: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+        currency: z.ZodMiniString<string>;
+        decimals: z.ZodMiniNumber<number>;
         logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
-        name: z.ZodMiniOptional<z.ZodMiniString<string>>;
-        symbol: z.ZodMiniOptional<z.ZodMiniString<string>>;
-        valuation: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
-            amount: z.ZodMiniString<string>;
-            currency: z.ZodMiniString<string>;
-        }, z.core.$strip>>>;
+        name: z.ZodMiniString<string>;
+        symbol: z.ZodMiniString<string>;
         verified: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
     }, z.core.$strip>;
     /**
@@ -60,19 +41,20 @@ export declare namespace schema {
         const Include: z.ZodMiniEnum<{
             crossToken: "crossToken";
             memo: "memo";
-            token: "token";
+            "token.logoUri": "token.logoUri";
+            "token.verified": "token.verified";
             totalCount: "totalCount";
         }>;
         /**
          * Parses a comma-separated `include` query value into a list of optional
-         * resources to embed. Extra lookups (token metadata, the `TransferWithMemo`
-         * memo/attribution decode, the capped total count) each run only when their
-         * resource is requested, keeping the base transfer page fast.
+         * resources to embed. Extra lookups run only when their resource is
+         * requested, keeping the base transfer page fast.
          */
         const includeQuery: z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniUnknown>, z.ZodMiniTransform<string[], unknown>>, z.ZodMiniArray<z.ZodMiniEnum<{
             crossToken: "crossToken";
             memo: "memo";
-            token: "token";
+            "token.logoUri": "token.logoUri";
+            "token.verified": "token.verified";
             totalCount: "totalCount";
         }>>>;
         /**
@@ -97,7 +79,8 @@ export declare namespace schema {
             include: z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniUnknown>, z.ZodMiniTransform<string[], unknown>>, z.ZodMiniArray<z.ZodMiniEnum<{
                 crossToken: "crossToken";
                 memo: "memo";
-                token: "token";
+                "token.logoUri": "token.logoUri";
+                "token.verified": "token.verified";
                 totalCount: "totalCount";
             }>>>;
             limit: z.ZodMiniDefault<z.ZodMiniNumber<unknown>>;
@@ -117,18 +100,23 @@ export declare namespace schema {
         const Transfer: z.ZodMiniObject<{
             attribution: z.ZodMiniOptional<z.ZodMiniString<string>>;
             blockNumber: z.ZodMiniNumber<number>;
-            destinationToken: z.ZodMiniOptional<z.ZodMiniObject<{
-                address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
-                amount: z.ZodMiniString<string>;
-                currency: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                decimals: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-                logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                name: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                symbol: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            destinationAmount: z.ZodMiniOptional<z.ZodMiniObject<{
+                baseUnits: z.ZodMiniString<string>;
+                currency: z.ZodMiniString<string>;
+                decimals: z.ZodMiniNumber<number>;
+                formatted: z.ZodMiniString<string>;
                 valuation: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
                     amount: z.ZodMiniString<string>;
                     currency: z.ZodMiniString<string>;
                 }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+            destinationToken: z.ZodMiniOptional<z.ZodMiniObject<{
+                address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                currency: z.ZodMiniString<string>;
+                decimals: z.ZodMiniNumber<number>;
+                logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                name: z.ZodMiniString<string>;
+                symbol: z.ZodMiniString<string>;
                 verified: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
             }, z.core.$strip>>;
             id: z.ZodMiniString<string>;
@@ -136,18 +124,23 @@ export declare namespace schema {
             memo: z.ZodMiniOptional<z.ZodMiniString<string>>;
             recipient: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
             sender: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
-            sourceToken: z.ZodMiniObject<{
-                address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
-                amount: z.ZodMiniString<string>;
-                currency: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                decimals: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-                logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                name: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                symbol: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            sourceAmount: z.ZodMiniObject<{
+                baseUnits: z.ZodMiniString<string>;
+                currency: z.ZodMiniString<string>;
+                decimals: z.ZodMiniNumber<number>;
+                formatted: z.ZodMiniString<string>;
                 valuation: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
                     amount: z.ZodMiniString<string>;
                     currency: z.ZodMiniString<string>;
                 }, z.core.$strip>>>;
+            }, z.core.$strip>;
+            sourceToken: z.ZodMiniObject<{
+                address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                currency: z.ZodMiniString<string>;
+                decimals: z.ZodMiniNumber<number>;
+                logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                name: z.ZodMiniString<string>;
+                symbol: z.ZodMiniString<string>;
                 verified: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
             }, z.core.$strip>;
             timestamp: z.ZodMiniISODateTime;
@@ -156,7 +149,7 @@ export declare namespace schema {
         /** Page-level resources: opt-in counts plus valuation rate provenance. */
         const Meta: z.ZodMiniObject<{
             pricing: z.ZodMiniOptional<z.ZodMiniObject<{
-                asOf: z.ZodMiniString<string>;
+                asOf: z.ZodMiniISODateTime;
                 basis: z.ZodMiniLiteral<"nominal">;
                 source: z.ZodMiniString<string>;
             }, z.core.$strip>>;
@@ -168,18 +161,23 @@ export declare namespace schema {
             data: z.ZodMiniArray<z.ZodMiniObject<{
                 attribution: z.ZodMiniOptional<z.ZodMiniString<string>>;
                 blockNumber: z.ZodMiniNumber<number>;
-                destinationToken: z.ZodMiniOptional<z.ZodMiniObject<{
-                    address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
-                    amount: z.ZodMiniString<string>;
-                    currency: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                    decimals: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-                    logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                    name: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                    symbol: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                destinationAmount: z.ZodMiniOptional<z.ZodMiniObject<{
+                    baseUnits: z.ZodMiniString<string>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    formatted: z.ZodMiniString<string>;
                     valuation: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
                         amount: z.ZodMiniString<string>;
                         currency: z.ZodMiniString<string>;
                     }, z.core.$strip>>>;
+                }, z.core.$strip>>;
+                destinationToken: z.ZodMiniOptional<z.ZodMiniObject<{
+                    address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                    name: z.ZodMiniString<string>;
+                    symbol: z.ZodMiniString<string>;
                     verified: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                 }, z.core.$strip>>;
                 id: z.ZodMiniString<string>;
@@ -187,18 +185,23 @@ export declare namespace schema {
                 memo: z.ZodMiniOptional<z.ZodMiniString<string>>;
                 recipient: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
                 sender: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
-                sourceToken: z.ZodMiniObject<{
-                    address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
-                    amount: z.ZodMiniString<string>;
-                    currency: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                    decimals: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-                    logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                    name: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                    symbol: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                sourceAmount: z.ZodMiniObject<{
+                    baseUnits: z.ZodMiniString<string>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    formatted: z.ZodMiniString<string>;
                     valuation: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
                         amount: z.ZodMiniString<string>;
                         currency: z.ZodMiniString<string>;
                     }, z.core.$strip>>>;
+                }, z.core.$strip>;
+                sourceToken: z.ZodMiniObject<{
+                    address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                    name: z.ZodMiniString<string>;
+                    symbol: z.ZodMiniString<string>;
                     verified: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                 }, z.core.$strip>;
                 timestamp: z.ZodMiniISODateTime;
@@ -206,7 +209,7 @@ export declare namespace schema {
             }, z.core.$strip>>;
             meta: z.ZodMiniOptional<z.ZodMiniObject<{
                 pricing: z.ZodMiniOptional<z.ZodMiniObject<{
-                    asOf: z.ZodMiniString<string>;
+                    asOf: z.ZodMiniISODateTime;
                     basis: z.ZodMiniLiteral<"nominal">;
                     source: z.ZodMiniString<string>;
                 }, z.core.$strip>>;
@@ -428,18 +431,23 @@ export declare function transfers(options?: transfers.Options): import("hono/hon
                 data: {
                     attribution?: string | undefined;
                     blockNumber: number;
-                    destinationToken?: {
-                        address: `0x${string}`;
-                        amount: string;
-                        currency?: string | undefined;
-                        decimals?: number | undefined;
-                        logoUri?: string | undefined;
-                        name?: string | undefined;
-                        symbol?: string | undefined;
+                    destinationAmount?: {
+                        baseUnits: string;
+                        currency: string;
+                        decimals: number;
+                        formatted: string;
                         valuation?: {
                             amount: string;
                             currency: string;
                         } | null | undefined;
+                    } | undefined;
+                    destinationToken?: {
+                        address: `0x${string}`;
+                        currency: string;
+                        decimals: number;
+                        logoUri?: string | undefined;
+                        name: string;
+                        symbol: string;
                         verified?: boolean | undefined;
                     } | undefined;
                     id: string;
@@ -447,18 +455,23 @@ export declare function transfers(options?: transfers.Options): import("hono/hon
                     memo?: string | undefined;
                     recipient: `0x${string}`;
                     sender: `0x${string}`;
-                    sourceToken: {
-                        address: `0x${string}`;
-                        amount: string;
-                        currency?: string | undefined;
-                        decimals?: number | undefined;
-                        logoUri?: string | undefined;
-                        name?: string | undefined;
-                        symbol?: string | undefined;
+                    sourceAmount: {
+                        baseUnits: string;
+                        currency: string;
+                        decimals: number;
+                        formatted: string;
                         valuation?: {
                             amount: string;
                             currency: string;
                         } | null | undefined;
+                    };
+                    sourceToken: {
+                        address: `0x${string}`;
+                        currency: string;
+                        decimals: number;
+                        logoUri?: string | undefined;
+                        name: string;
+                        symbol: string;
                         verified?: boolean | undefined;
                     };
                     timestamp: string;
@@ -508,15 +521,13 @@ export declare namespace transfers {
 }
 /**
  * Shared TIP-20 `Transfer` page query. Used by `GET /transfers` and the
- * webhook poller. Builds the signature-decoded `Transfer` CTE query, applies
+ * webhook poller. Builds signature-decoded `Transfer` CTE queries, applies
  * opaque keyset pagination on `(block_num, log_idx)`, and decodes rows into a
  * strongly-typed intermediate shape that each caller maps to its own public
  * response.
  *
- * `eitherSide` (the subject address must appear on _either_ side of the
- * transfer) is exposed alongside the one-sided `sender`/`recipient` filters
- * because composing it with the keyset cursor pre-WHERE in SQL is awkward at
- * the call site; the helper takes the knob directly.
+ * `eitherSide` is exposed alongside one-sided `sender`/`recipient` filters
+ * because it requires two upstream scans. The helper owns their ordered merge.
  *
  * Memoization lives inside the helper under one canonical `transfers:v1:…`
  * key derived from every filter — so equivalent filter combinations share a
@@ -602,7 +613,7 @@ export declare namespace scan {
 declare function filterClauses(options: filterClauses.Options): string[];
 declare namespace filterClauses {
     /** The non-pagination filter fields of {@link scan.Options}. */
-    type Options = Pick<scan.Options, 'eitherSide' | 'fromBlock' | 'fromTimestamp' | 'recipient' | 'sender' | 'toBlock' | 'toTimestamp' | 'token'>;
+    type Options = Pick<scan.Options, 'fromBlock' | 'fromTimestamp' | 'recipient' | 'sender' | 'toBlock' | 'toTimestamp' | 'token'>;
 }
 /**
  * Capped total-row count for the `Transfer` feed, sharing {@link query}'s
@@ -626,12 +637,12 @@ export declare namespace count {
 /**
  * Context-free core of {@link count}: counts token-scoped rows from
  * `token_transfers`, otherwise the decoded `Transfer` CTE. The capped inner
- * scan bounds work; the SQL aggregate runs on ClickHouse.
+ * scan bounds work while preserving each source's established query engine.
  */
 export declare function countScan(deps: scan.Deps, options: countScan.Options): Promise<count.Result>;
 export declare namespace countScan {
     /** Options for {@link countScan}: the shared filters plus the target chain. */
-    type Options = filterClauses.Options & Pick<scan.Options, 'chainId'> & {
+    type Options = filterClauses.Options & Pick<scan.Options, 'chainId' | 'eitherSide'> & {
         /** Count folded cross-token transfers instead of raw `Transfer` logs. */
         crossToken?: boolean | undefined;
     };

package/dist/apps/data/routes/transfers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transfers.d.ts","sourceRoot":"","sources":["../../../../src/apps/data/routes/transfers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transfers.d.ts","sourceRoot":"","sources":["../../../../src/apps/data/routes/transfers.ts"],"names":[],"mappings":"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"}