tapimo 0.14.0 → 0.15.1

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

@@ -4816,6 +4816,74 @@ export declare namespace schema {
         }, z.core.$strip>;
         type: z.ZodMiniLiteral<"unknown">;
     }, z.core.$strip>]>;
+    /** Public activity types accepted by the address feed's `type` filter. */
+    export const ActivityType: z.ZodMiniEnum<{
+        "access-key-created": "access-key-created";
+        "access-key-revoked": "access-key-revoked";
+        approval: "approval";
+        "assets-deposited": "assets-deposited";
+        "assets-withdrawn": "assets-withdrawn";
+        "blacklist-updated": "blacklist-updated";
+        burn: "burn";
+        "burn-blocked": "burn-blocked";
+        "channel-close-cancelled": "channel-close-cancelled";
+        "channel-closed": "channel-closed";
+        "channel-funded": "channel-funded";
+        "channel-opened": "channel-opened";
+        "channel-settled": "channel-settled";
+        "compound-policy-created": "compound-policy-created";
+        "fee-rebalance-swap": "fee-rebalance-swap";
+        "fee-user-token-set": "fee-user-token-set";
+        "fee-validator-token-set": "fee-validator-token-set";
+        "fees-distributed": "fees-distributed";
+        initialized: "initialized";
+        "key-authorization-witness": "key-authorization-witness";
+        "key-authorization-witness-burned": "key-authorization-witness-burned";
+        "master-registered": "master-registered";
+        mint: "mint";
+        "network-identity-rotation-epoch-set": "network-identity-rotation-epoch-set";
+        "nonce-incremented": "nonce-incremented";
+        "order-cancelled": "order-cancelled";
+        "order-filled": "order-filled";
+        "order-flipped": "order-flipped";
+        "order-placed": "order-placed";
+        "ownership-transferred": "ownership-transferred";
+        "pair-created": "pair-created";
+        "policy-admin-set": "policy-admin-set";
+        "policy-created": "policy-created";
+        "private-assets-deposited": "private-assets-deposited";
+        "private-shares-redeemed": "private-shares-redeemed";
+        "reward-distributed": "reward-distributed";
+        "reward-recipient-set": "reward-recipient-set";
+        "role-admin-set": "role-admin-set";
+        "role-membership-set": "role-membership-set";
+        "session-closed": "session-closed";
+        "shares-deposited": "shares-deposited";
+        "shares-redeemed": "shares-redeemed";
+        "shares-redemption-cancelled": "shares-redemption-cancelled";
+        "shares-redemption-finalized": "shares-redemption-finalized";
+        "shares-redemption-requested": "shares-redemption-requested";
+        "spending-limit-updated": "spending-limit-updated";
+        swap: "swap";
+        "token-created": "token-created";
+        "token-logo-set": "token-logo-set";
+        "token-next-quote-token-set": "token-next-quote-token-set";
+        "token-pause-set": "token-pause-set";
+        "token-quote-token-set": "token-quote-token-set";
+        "token-supply-cap-set": "token-supply-cap-set";
+        "token-transfer-policy-set": "token-transfer-policy-set";
+        transfer: "transfer";
+        unknown: "unknown";
+        "validator-added": "validator-added";
+        "validator-deactivated": "validator-deactivated";
+        "validator-fee-recipient-set": "validator-fee-recipient-set";
+        "validator-ip-set": "validator-ip-set";
+        "validator-migrated": "validator-migrated";
+        "validator-migration-skipped": "validator-migration-skipped";
+        "validator-ownership-transferred": "validator-ownership-transferred";
+        "validator-rotated": "validator-rotated";
+        "whitelist-updated": "whitelist-updated";
+    }>;
     /** A folded access-key group: consecutive same-signer items on one UTC day. */
     export const Group: z.ZodMiniObject<{
         chainId: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
@@ -11964,6 +12032,74 @@ export declare namespace schema {
         "token.verified": "token.verified";
         zones: "zones";
     }>>>;
+    /** Parses comma-separated activity types with OR semantics. */
+    export const typeQuery: z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniUnknown>, z.ZodMiniTransform<string[], unknown>>, z.ZodMiniArray<z.ZodMiniEnum<{
+        "access-key-created": "access-key-created";
+        "access-key-revoked": "access-key-revoked";
+        approval: "approval";
+        "assets-deposited": "assets-deposited";
+        "assets-withdrawn": "assets-withdrawn";
+        "blacklist-updated": "blacklist-updated";
+        burn: "burn";
+        "burn-blocked": "burn-blocked";
+        "channel-close-cancelled": "channel-close-cancelled";
+        "channel-closed": "channel-closed";
+        "channel-funded": "channel-funded";
+        "channel-opened": "channel-opened";
+        "channel-settled": "channel-settled";
+        "compound-policy-created": "compound-policy-created";
+        "fee-rebalance-swap": "fee-rebalance-swap";
+        "fee-user-token-set": "fee-user-token-set";
+        "fee-validator-token-set": "fee-validator-token-set";
+        "fees-distributed": "fees-distributed";
+        initialized: "initialized";
+        "key-authorization-witness": "key-authorization-witness";
+        "key-authorization-witness-burned": "key-authorization-witness-burned";
+        "master-registered": "master-registered";
+        mint: "mint";
+        "network-identity-rotation-epoch-set": "network-identity-rotation-epoch-set";
+        "nonce-incremented": "nonce-incremented";
+        "order-cancelled": "order-cancelled";
+        "order-filled": "order-filled";
+        "order-flipped": "order-flipped";
+        "order-placed": "order-placed";
+        "ownership-transferred": "ownership-transferred";
+        "pair-created": "pair-created";
+        "policy-admin-set": "policy-admin-set";
+        "policy-created": "policy-created";
+        "private-assets-deposited": "private-assets-deposited";
+        "private-shares-redeemed": "private-shares-redeemed";
+        "reward-distributed": "reward-distributed";
+        "reward-recipient-set": "reward-recipient-set";
+        "role-admin-set": "role-admin-set";
+        "role-membership-set": "role-membership-set";
+        "session-closed": "session-closed";
+        "shares-deposited": "shares-deposited";
+        "shares-redeemed": "shares-redeemed";
+        "shares-redemption-cancelled": "shares-redemption-cancelled";
+        "shares-redemption-finalized": "shares-redemption-finalized";
+        "shares-redemption-requested": "shares-redemption-requested";
+        "spending-limit-updated": "spending-limit-updated";
+        swap: "swap";
+        "token-created": "token-created";
+        "token-logo-set": "token-logo-set";
+        "token-next-quote-token-set": "token-next-quote-token-set";
+        "token-pause-set": "token-pause-set";
+        "token-quote-token-set": "token-quote-token-set";
+        "token-supply-cap-set": "token-supply-cap-set";
+        "token-transfer-policy-set": "token-transfer-policy-set";
+        transfer: "transfer";
+        unknown: "unknown";
+        "validator-added": "validator-added";
+        "validator-deactivated": "validator-deactivated";
+        "validator-fee-recipient-set": "validator-fee-recipient-set";
+        "validator-ip-set": "validator-ip-set";
+        "validator-migrated": "validator-migrated";
+        "validator-migration-skipped": "validator-migration-skipped";
+        "validator-ownership-transferred": "validator-ownership-transferred";
+        "validator-rotated": "validator-rotated";
+        "whitelist-updated": "whitelist-updated";
+    }>>>;
     /** Schemas for the getAddressActivities operation. */
     export namespace getAddressActivities {
         /** Path parameters for address activity requests. */
@@ -11972,6 +12108,8 @@ export declare namespace schema {
         }, z.core.$strip>;
         /** Query parameters for address activity requests. */
         const Query: z.ZodMiniObject<{
+            'amount.from': z.ZodMiniOptional<z.ZodMiniString<string>>;
+            'amount.to': z.ZodMiniOptional<z.ZodMiniString<string>>;
             chainId: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
                 mainnet: "mainnet";
                 testnet: "testnet";
@@ -11991,6 +12129,78 @@ export declare namespace schema {
                 false: "false";
                 true: "true";
             }>, z.ZodMiniTransform<boolean, "false" | "true">>>;
+            recipient: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+            sender: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+            token: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+            type: z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniUnknown>, z.ZodMiniTransform<string[], unknown>>, z.ZodMiniArray<z.ZodMiniEnum<{
+                "access-key-created": "access-key-created";
+                "access-key-revoked": "access-key-revoked";
+                approval: "approval";
+                "assets-deposited": "assets-deposited";
+                "assets-withdrawn": "assets-withdrawn";
+                "blacklist-updated": "blacklist-updated";
+                burn: "burn";
+                "burn-blocked": "burn-blocked";
+                "channel-close-cancelled": "channel-close-cancelled";
+                "channel-closed": "channel-closed";
+                "channel-funded": "channel-funded";
+                "channel-opened": "channel-opened";
+                "channel-settled": "channel-settled";
+                "compound-policy-created": "compound-policy-created";
+                "fee-rebalance-swap": "fee-rebalance-swap";
+                "fee-user-token-set": "fee-user-token-set";
+                "fee-validator-token-set": "fee-validator-token-set";
+                "fees-distributed": "fees-distributed";
+                initialized: "initialized";
+                "key-authorization-witness": "key-authorization-witness";
+                "key-authorization-witness-burned": "key-authorization-witness-burned";
+                "master-registered": "master-registered";
+                mint: "mint";
+                "network-identity-rotation-epoch-set": "network-identity-rotation-epoch-set";
+                "nonce-incremented": "nonce-incremented";
+                "order-cancelled": "order-cancelled";
+                "order-filled": "order-filled";
+                "order-flipped": "order-flipped";
+                "order-placed": "order-placed";
+                "ownership-transferred": "ownership-transferred";
+                "pair-created": "pair-created";
+                "policy-admin-set": "policy-admin-set";
+                "policy-created": "policy-created";
+                "private-assets-deposited": "private-assets-deposited";
+                "private-shares-redeemed": "private-shares-redeemed";
+                "reward-distributed": "reward-distributed";
+                "reward-recipient-set": "reward-recipient-set";
+                "role-admin-set": "role-admin-set";
+                "role-membership-set": "role-membership-set";
+                "session-closed": "session-closed";
+                "shares-deposited": "shares-deposited";
+                "shares-redeemed": "shares-redeemed";
+                "shares-redemption-cancelled": "shares-redemption-cancelled";
+                "shares-redemption-finalized": "shares-redemption-finalized";
+                "shares-redemption-requested": "shares-redemption-requested";
+                "spending-limit-updated": "spending-limit-updated";
+                swap: "swap";
+                "token-created": "token-created";
+                "token-logo-set": "token-logo-set";
+                "token-next-quote-token-set": "token-next-quote-token-set";
+                "token-pause-set": "token-pause-set";
+                "token-quote-token-set": "token-quote-token-set";
+                "token-supply-cap-set": "token-supply-cap-set";
+                "token-transfer-policy-set": "token-transfer-policy-set";
+                transfer: "transfer";
+                unknown: "unknown";
+                "validator-added": "validator-added";
+                "validator-deactivated": "validator-deactivated";
+                "validator-fee-recipient-set": "validator-fee-recipient-set";
+                "validator-ip-set": "validator-ip-set";
+                "validator-migrated": "validator-migrated";
+                "validator-migration-skipped": "validator-migration-skipped";
+                "validator-ownership-transferred": "validator-ownership-transferred";
+                "validator-rotated": "validator-rotated";
+                "whitelist-updated": "whitelist-updated";
+            }>>>;
+            'valuation.amount.from': z.ZodMiniOptional<z.ZodMiniString<string>>;
+            'valuation.amount.to': z.ZodMiniOptional<z.ZodMiniString<string>>;
             'valuation.currency': z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<string, string>>>;
         }, z.core.$strict>;
         /**
@@ -19189,7 +19399,7 @@ type UnenrichedData<data> = {
     [key in keyof data as key extends AmountKey ? never : key]: key extends TokenKey ? UnenrichedToken | Extract<data[key], undefined> : data[key];
 };
 /** A classified item whose token stubs have not been enriched with structured amounts. */
-type UnenrichedItem = {
+export type UnenrichedItem = {
     [type in Item['type']]: Omit<Extract<Item, {
         type: type;
     }>, 'data'> & {
@@ -19198,6 +19408,35 @@ type UnenrichedItem = {
         }>['data']>;
     };
 }[Item['type']];
+/** Inclusive token amount bounds in raw base units. */
+export type RawAmountBounds = {
+    /** Smallest matching amount. */
+    from?: bigint | undefined;
+    /** Largest matching amount. */
+    to?: bigint | undefined;
+};
+/** Exact activity predicates evaluated against classified token movements. */
+export type ActivityFilter = {
+    /** Inclusive raw base-unit range for one token leg. */
+    amount?: RawAmountBounds | undefined;
+    /** Required recipient on the classified activity. */
+    recipient?: Address.Address | undefined;
+    /** Required sender on the classified activity. */
+    sender?: Address.Address | undefined;
+    /** Required source, destination, or refund token on the same leg as the amount range. */
+    token?: Address.Address | undefined;
+};
+/** Applies exact participant and same-leg token predicates after classification. */
+export declare function filterActivities<item extends UnenrichedItem>(options: filterActivities.Options<item>): item[];
+export declare namespace filterActivities {
+    /** Inputs for exact classified activity refinement. */
+    type Options<item extends UnenrichedItem> = {
+        /** Exact participant and token-leg predicates. */
+        filter: ActivityFilter;
+        /** Classified activity items to refine. */
+        items: readonly item[];
+    };
+}
 /**
  * A normalized provider row. Mirrors the bounded receipt/log lookups
  * (`source: 'q1'`, full log columns) and the decoded `Transfer` projection
@@ -19235,11 +19474,22 @@ export type Provider = {
     fetchRows(options: {
         address: Address.Address;
         cursor?: string | undefined;
+        /** Sound indexed predicates that may reduce the candidate set before classification. */
+        filter?: CandidateFilter | undefined;
         limit: number;
     }): Promise<{
         rows: Row[];
     }>;
 };
+/** A reusable two-stage filter: sound indexed candidate narrowing plus exact classified refinement. */
+type QueryFilter<item extends UnenrichedItem = UnenrichedItem> = {
+    /** Predicates the provider can apply without excluding a possible classified match. */
+    candidate?: CandidateFilter | undefined;
+    /** Exact API semantics evaluated after transaction-level classification. */
+    refine?: ((items: readonly item[]) => Promise<item[]> | item[]) | undefined;
+};
+/** Sound predicates an activity provider can apply before classification. */
+export type CandidateFilter = ActivityFilter;
 /**
  * Creates address-scoped activity handlers, mounted under the `/addresses`
  * composer. Exposes `GET /:address/activities`.
@@ -19261,207 +19511,6 @@ export type Provider = {
 export declare function addresses(options?: addresses.Options): import("hono/hono-base").HonoBase<App.Environment, {
     "/v1/addresses/:address/activities": {
         $get: {
-            output: null;
-            outputFormat: "body";
-            status: 402;
-            input: {
-                param: {
-                    address: `0x${string}`;
-                };
-            } & {
-                query?: {
-                    chainId?: string | string[];
-                    cursor?: string | string[];
-                    group?: string | string[];
-                    include?: string | string[];
-                    limit?: string | string[];
-                    logs?: string | string[];
-                    'valuation.currency'?: string | string[];
-                } | undefined;
-            };
-        } | {
-            output: {
-                error: {
-                    code: "upstream_error";
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
-                };
-                requestId: string;
-            };
-            outputFormat: "json";
-            status: 502;
-            input: {
-                param: {
-                    address: `0x${string}`;
-                };
-            } & {
-                query?: {
-                    chainId?: string | string[];
-                    cursor?: string | string[];
-                    group?: string | string[];
-                    include?: string | string[];
-                    limit?: string | string[];
-                    logs?: string | string[];
-                    'valuation.currency'?: string | string[];
-                } | undefined;
-            };
-        } | {
-            output: {
-                error: {
-                    code: "query_invalid";
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
-                };
-                requestId: string;
-            };
-            outputFormat: "json";
-            status: 400;
-            input: {
-                param: {
-                    address: `0x${string}`;
-                };
-            } & {
-                query?: {
-                    chainId?: string | string[];
-                    cursor?: string | string[];
-                    group?: string | string[];
-                    include?: string | string[];
-                    limit?: string | string[];
-                    logs?: string | string[];
-                    'valuation.currency'?: string | string[];
-                } | undefined;
-            };
-        } | {
-            output: {
-                error: {
-                    code: "api_key_malformed";
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
-                };
-                requestId: string;
-            };
-            outputFormat: "json";
-            status: 400;
-            input: {
-                param: {
-                    address: `0x${string}`;
-                };
-            } & {
-                query?: {
-                    chainId?: string | string[];
-                    cursor?: string | string[];
-                    group?: string | string[];
-                    include?: string | string[];
-                    limit?: string | string[];
-                    logs?: string | string[];
-                    'valuation.currency'?: string | string[];
-                } | undefined;
-            };
-        } | {
-            output: {
-                error: {
-                    code: "api_key_invalid" | "api_key_missing";
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
-                };
-                requestId: string;
-            };
-            outputFormat: "json";
-            status: 401;
-            input: {
-                param: {
-                    address: `0x${string}`;
-                };
-            } & {
-                query?: {
-                    chainId?: string | string[];
-                    cursor?: string | string[];
-                    group?: string | string[];
-                    include?: string | string[];
-                    limit?: string | string[];
-                    logs?: string | string[];
-                    'valuation.currency'?: string | string[];
-                } | undefined;
-            };
-        } | {
-            output: {
-                error: {
-                    code: "api_key_forbidden" | "api_key_ip_forbidden";
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
-                };
-                requestId: string;
-            };
-            outputFormat: "json";
-            status: 403;
-            input: {
-                param: {
-                    address: `0x${string}`;
-                };
-            } & {
-                query?: {
-                    chainId?: string | string[];
-                    cursor?: string | string[];
-                    group?: string | string[];
-                    include?: string | string[];
-                    limit?: string | string[];
-                    logs?: string | string[];
-                    'valuation.currency'?: string | string[];
-                } | undefined;
-            };
-        } | {
-            output: {
-                error: {
-                    code: "payment_required" | "rate_limit_exceeded";
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
-                };
-                requestId: string;
-            };
-            outputFormat: "json";
-            status: 429;
-            input: {
-                param: {
-                    address: `0x${string}`;
-                };
-            } & {
-                query?: {
-                    chainId?: string | string[];
-                    cursor?: string | string[];
-                    group?: string | string[];
-                    include?: string | string[];
-                    limit?: string | string[];
-                    logs?: string | string[];
-                    'valuation.currency'?: string | string[];
-                } | undefined;
-            };
-        } | {
-            output: {
-                error: {
-                    code: "address_invalid";
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
-                };
-                requestId: string;
-            };
-            outputFormat: "json";
-            status: 400;
-            input: {
-                param: {
-                    address: `0x${string}`;
-                };
-            } & {
-                query?: {
-                    chainId?: string | string[];
-                    cursor?: string | string[];
-                    group?: string | string[];
-                    include?: string | string[];
-                    limit?: string | string[];
-                    logs?: string | string[];
-                    'valuation.currency'?: string | string[];
-                } | undefined;
-            };
-        } | {
             output: {
                 data: ({
                     chainId?: number | undefined;
@@ -23686,80 +23735,61 @@ export declare function addresses(options?: addresses.Options): import("hono/hon
                 };
             } & {
                 query?: {
+                    'amount.from'?: string | string[];
+                    'amount.to'?: string | string[];
                     chainId?: string | string[];
                     cursor?: string | string[];
                     group?: string | string[];
                     include?: string | string[];
                     limit?: string | string[];
                     logs?: string | string[];
-                    'valuation.currency'?: string | string[];
-                } | undefined;
-            };
-        };
-    };
-}, "/", "/v1/addresses/:address/activities">;
-export declare namespace addresses {
-    /** Options for the address-scoped activity handlers. */
-    type Options = {
-        /** FX configuration backing amount valuation. */
-        fx?: Valuation.addresses.Fx | undefined;
-    };
-}
-/**
- * Creates transaction-scoped activity handlers, mounted under the
- * `/transactions` composer. Exposes `GET /:transactionHash/activities`.
- *
- * Runs the same `groupByTx` → `classifyGroup` pipeline the address feed uses
- * over a single transaction's logs, anchored on the transaction sender as the
- * viewer (a transaction-scoped feed has no subject account). Returns the
- * classified items (one per independent activity) with the full per-tx
- * event set available via `logs=true`.
- */
-export declare function transactions(options?: transactions.Options): import("hono/hono-base").HonoBase<App.Environment, {
-    "/v1/transactions/:transactionHash/activities": {
-        $get: {
-            output: null;
-            outputFormat: "body";
-            status: 402;
-            input: {
-                param: {
-                    transactionHash: `0x${string}`;
-                };
-            } & {
-                query?: {
-                    chainId?: string | string[];
-                    include?: string | string[];
-                    logs?: string | string[];
+                    recipient?: string | string[];
+                    sender?: string | string[];
+                    token?: string | string[];
+                    type?: string | string[];
+                    'valuation.amount.from'?: string | string[];
+                    'valuation.amount.to'?: string | string[];
                     'valuation.currency'?: string | string[];
                 } | undefined;
             };
         } | {
             output: {
                 error: {
-                    code: "upstream_error";
+                    code: "api_key_malformed";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 502;
+            status: 400;
             input: {
                 param: {
-                    transactionHash: `0x${string}`;
+                    address: `0x${string}`;
                 };
             } & {
                 query?: {
+                    'amount.from'?: string | string[];
+                    'amount.to'?: string | string[];
                     chainId?: string | string[];
+                    cursor?: string | string[];
+                    group?: string | string[];
                     include?: string | string[];
+                    limit?: string | string[];
                     logs?: string | string[];
+                    recipient?: string | string[];
+                    sender?: string | string[];
+                    token?: string | string[];
+                    type?: string | string[];
+                    'valuation.amount.from'?: string | string[];
+                    'valuation.amount.to'?: string | string[];
                     'valuation.currency'?: string | string[];
                 } | undefined;
             };
         } | {
             output: {
                 error: {
-                    code: "query_invalid";
+                    code: "address_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
@@ -23769,20 +23799,31 @@ export declare function transactions(options?: transactions.Options): import("ho
             status: 400;
             input: {
                 param: {
-                    transactionHash: `0x${string}`;
+                    address: `0x${string}`;
                 };
             } & {
                 query?: {
+                    'amount.from'?: string | string[];
+                    'amount.to'?: string | string[];
                     chainId?: string | string[];
+                    cursor?: string | string[];
+                    group?: string | string[];
                     include?: string | string[];
+                    limit?: string | string[];
                     logs?: string | string[];
+                    recipient?: string | string[];
+                    sender?: string | string[];
+                    token?: string | string[];
+                    type?: string | string[];
+                    'valuation.amount.from'?: string | string[];
+                    'valuation.amount.to'?: string | string[];
                     'valuation.currency'?: string | string[];
                 } | undefined;
             };
         } | {
             output: {
                 error: {
-                    code: "api_key_malformed";
+                    code: "query_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
@@ -23792,13 +23833,24 @@ export declare function transactions(options?: transactions.Options): import("ho
             status: 400;
             input: {
                 param: {
-                    transactionHash: `0x${string}`;
+                    address: `0x${string}`;
                 };
             } & {
                 query?: {
+                    'amount.from'?: string | string[];
+                    'amount.to'?: string | string[];
                     chainId?: string | string[];
+                    cursor?: string | string[];
+                    group?: string | string[];
                     include?: string | string[];
+                    limit?: string | string[];
                     logs?: string | string[];
+                    recipient?: string | string[];
+                    sender?: string | string[];
+                    token?: string | string[];
+                    type?: string | string[];
+                    'valuation.amount.from'?: string | string[];
+                    'valuation.amount.to'?: string | string[];
                     'valuation.currency'?: string | string[];
                 } | undefined;
             };
@@ -23815,132 +23867,179 @@ export declare function transactions(options?: transactions.Options): import("ho
             status: 401;
             input: {
                 param: {
-                    transactionHash: `0x${string}`;
-                };
-            } & {
-                query?: {
-                    chainId?: string | string[];
-                    include?: string | string[];
-                    logs?: string | string[];
-                    'valuation.currency'?: string | string[];
-                } | undefined;
-            };
-        } | {
-            output: {
-                error: {
-                    code: "api_key_forbidden" | "api_key_ip_forbidden";
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
-                };
-                requestId: string;
-            };
-            outputFormat: "json";
-            status: 403;
-            input: {
-                param: {
-                    transactionHash: `0x${string}`;
+                    address: `0x${string}`;
                 };
             } & {
                 query?: {
+                    'amount.from'?: string | string[];
+                    'amount.to'?: string | string[];
                     chainId?: string | string[];
+                    cursor?: string | string[];
+                    group?: string | string[];
                     include?: string | string[];
+                    limit?: string | string[];
                     logs?: string | string[];
+                    recipient?: string | string[];
+                    sender?: string | string[];
+                    token?: string | string[];
+                    type?: string | string[];
+                    'valuation.amount.from'?: string | string[];
+                    'valuation.amount.to'?: string | string[];
                     'valuation.currency'?: string | string[];
                 } | undefined;
             };
         } | {
-            output: {
-                error: {
-                    code: "payment_required" | "rate_limit_exceeded";
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
-                };
-                requestId: string;
-            };
-            outputFormat: "json";
-            status: 429;
+            output: null;
+            outputFormat: "body";
+            status: 402;
             input: {
                 param: {
-                    transactionHash: `0x${string}`;
+                    address: `0x${string}`;
                 };
             } & {
                 query?: {
+                    'amount.from'?: string | string[];
+                    'amount.to'?: string | string[];
                     chainId?: string | string[];
+                    cursor?: string | string[];
+                    group?: string | string[];
                     include?: string | string[];
+                    limit?: string | string[];
                     logs?: string | string[];
+                    recipient?: string | string[];
+                    sender?: string | string[];
+                    token?: string | string[];
+                    type?: string | string[];
+                    'valuation.amount.from'?: string | string[];
+                    'valuation.amount.to'?: string | string[];
                     'valuation.currency'?: string | string[];
                 } | undefined;
             };
         } | {
             output: {
                 error: {
-                    code: "transaction_invalid";
+                    code: "api_key_forbidden" | "api_key_ip_forbidden";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400;
+            status: 403;
             input: {
                 param: {
-                    transactionHash: `0x${string}`;
+                    address: `0x${string}`;
                 };
             } & {
                 query?: {
+                    'amount.from'?: string | string[];
+                    'amount.to'?: string | string[];
                     chainId?: string | string[];
+                    cursor?: string | string[];
+                    group?: string | string[];
                     include?: string | string[];
+                    limit?: string | string[];
                     logs?: string | string[];
+                    recipient?: string | string[];
+                    sender?: string | string[];
+                    token?: string | string[];
+                    type?: string | string[];
+                    'valuation.amount.from'?: string | string[];
+                    'valuation.amount.to'?: string | string[];
                     'valuation.currency'?: string | string[];
                 } | undefined;
             };
         } | {
             output: {
                 error: {
-                    code: "transaction_not_found";
+                    code: "payment_required" | "rate_limit_exceeded";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 404;
+            status: 429;
             input: {
                 param: {
-                    transactionHash: `0x${string}`;
+                    address: `0x${string}`;
                 };
             } & {
                 query?: {
+                    'amount.from'?: string | string[];
+                    'amount.to'?: string | string[];
                     chainId?: string | string[];
+                    cursor?: string | string[];
+                    group?: string | string[];
                     include?: string | string[];
+                    limit?: string | string[];
                     logs?: string | string[];
+                    recipient?: string | string[];
+                    sender?: string | string[];
+                    token?: string | string[];
+                    type?: string | string[];
+                    'valuation.amount.from'?: string | string[];
+                    'valuation.amount.to'?: string | string[];
                     'valuation.currency'?: string | string[];
                 } | undefined;
             };
         } | {
             output: {
                 error: {
-                    code: "transaction_ambiguous";
+                    code: "upstream_error";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 409;
+            status: 502;
             input: {
                 param: {
-                    transactionHash: `0x${string}`;
+                    address: `0x${string}`;
                 };
             } & {
                 query?: {
+                    'amount.from'?: string | string[];
+                    'amount.to'?: string | string[];
                     chainId?: string | string[];
+                    cursor?: string | string[];
+                    group?: string | string[];
                     include?: string | string[];
+                    limit?: string | string[];
                     logs?: string | string[];
+                    recipient?: string | string[];
+                    sender?: string | string[];
+                    token?: string | string[];
+                    type?: string | string[];
+                    'valuation.amount.from'?: string | string[];
+                    'valuation.amount.to'?: string | string[];
                     'valuation.currency'?: string | string[];
                 } | undefined;
             };
-        } | {
+        };
+    };
+}, "/", "/v1/addresses/:address/activities">;
+export declare namespace addresses {
+    /** Options for the address-scoped activity handlers. */
+    type Options = {
+        /** FX configuration backing amount valuation. */
+        fx?: Valuation.addresses.Fx | undefined;
+    };
+}
+/**
+ * Creates transaction-scoped activity handlers, mounted under the
+ * `/transactions` composer. Exposes `GET /:transactionHash/activities`.
+ *
+ * Runs the same `groupByTx` → `classifyGroup` pipeline the address feed uses
+ * over a single transaction's logs, anchored on the transaction sender as the
+ * viewer (a transaction-scoped feed has no subject account). Returns the
+ * classified items (one per independent activity) with the full per-tx
+ * event set available via `logs=true`.
+ */
+export declare function transactions(options?: transactions.Options): import("hono/hono-base").HonoBase<App.Environment, {
+    "/v1/transactions/:transactionHash/activities": {
+        $get: {
             output: {
                 chainId: number;
                 data: ({
@@ -26063,6 +26162,229 @@ export declare function transactions(options?: transactions.Options): import("ho
                     'valuation.currency'?: string | string[];
                 } | undefined;
             };
+        } | {
+            output: {
+                error: {
+                    code: "api_key_malformed";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 400;
+            input: {
+                param: {
+                    transactionHash: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: string | string[];
+                    logs?: string | string[];
+                    'valuation.currency'?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "query_invalid";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 400;
+            input: {
+                param: {
+                    transactionHash: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: string | string[];
+                    logs?: string | string[];
+                    'valuation.currency'?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "transaction_invalid";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 400;
+            input: {
+                param: {
+                    transactionHash: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: string | string[];
+                    logs?: string | string[];
+                    'valuation.currency'?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "api_key_invalid" | "api_key_missing";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 401;
+            input: {
+                param: {
+                    transactionHash: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: string | string[];
+                    logs?: string | string[];
+                    'valuation.currency'?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: null;
+            outputFormat: "body";
+            status: 402;
+            input: {
+                param: {
+                    transactionHash: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: string | string[];
+                    logs?: string | string[];
+                    'valuation.currency'?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "api_key_forbidden" | "api_key_ip_forbidden";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 403;
+            input: {
+                param: {
+                    transactionHash: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: string | string[];
+                    logs?: string | string[];
+                    'valuation.currency'?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "transaction_not_found";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 404;
+            input: {
+                param: {
+                    transactionHash: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: string | string[];
+                    logs?: string | string[];
+                    'valuation.currency'?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "transaction_ambiguous";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 409;
+            input: {
+                param: {
+                    transactionHash: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: string | string[];
+                    logs?: string | string[];
+                    'valuation.currency'?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "payment_required" | "rate_limit_exceeded";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 429;
+            input: {
+                param: {
+                    transactionHash: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: string | string[];
+                    logs?: string | string[];
+                    'valuation.currency'?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "upstream_error";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 502;
+            input: {
+                param: {
+                    transactionHash: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: string | string[];
+                    logs?: string | string[];
+                    'valuation.currency'?: string | string[];
+                } | undefined;
+            };
         };
     };
 }, "/", "/v1/transactions/:transactionHash/activities">;
@@ -26099,6 +26421,8 @@ export declare namespace getTransactionActivities {
         transactionHash: string;
     };
 }
+type AddressActivityTimingName = 'address_activity_classify' | 'address_activity_mpp' | 'address_activity_outbound' | 'address_activity_transfers';
+type AddressActivityTime = <value>(name: AddressActivityTimingName, fn: () => Promise<value> | value) => Promise<value>;
 /**
  * Lists classified activity for an address by running the shared pipeline
  * (`groupByTx` → `classifyGroup` → `enrichItem`) over rows from a
@@ -26113,6 +26437,8 @@ export declare namespace list {
         address: Address.Address;
         /** Opaque cursor from a previous page; omit for the head page. */
         cursor?: string | undefined;
+        /** Indexed candidate narrowing and exact classified refinement. */
+        filter?: QueryFilter | undefined;
         /** Whether the caller will fold items into access-key groups (tunes the page-fill target). */
         group?: boolean | undefined;
         /** Attach each item's full transaction `events` capture (decoded + raw logs). */
@@ -26121,6 +26447,8 @@ export declare namespace list {
         limit?: number | undefined;
         /** Cache store for the MPP fingerprint-directory lookup. */
         store: Store.Store;
+        /** Request-scoped timing hook for address activity work. */
+        time?: AddressActivityTime | undefined;
     };
     /** Result of {@link list}. */
     type ReturnType = {
@@ -26152,6 +26480,8 @@ export declare namespace listChains {
         address: Address.Address;
         /** Opaque multi-chain cursor from a previous page. */
         cursor?: string | undefined;
+        /** Indexed candidate narrowing and exact classified refinement. */
+        filter?: QueryFilter<Item> | undefined;
         /** Whether the caller will fold access-key items. */
         group?: boolean | undefined;
         /** Target number of transaction groups per page. */
@@ -26162,6 +26492,8 @@ export declare namespace listChains {
         providers: readonly ChainProvider[];
         /** Cache store for the MPP fingerprint-directory lookup. */
         store: Store.Store;
+        /** Request-scoped timing hook for address activity work. */
+        time?: AddressActivityTime | undefined;
     };
     /** Multi-chain classified page before token enrichment. */
     type ReturnType = {
@@ -26172,13 +26504,9 @@ export declare namespace listChains {
     };
 }
 /**
- * Creates a TIDX-backed {@link Provider} that runs three sub-queries in
- * parallel and merges them:
- * - Q1 (outbound): page receipts where the address is `from` or `fee_payer`,
- *   then fetch the selected transactions' logs with a bounded lookup.
- * - Q2 (inbound): decoded `Transfer` events to the address.
- * - Q3 (outbound transfers): decoded `Transfer` events from the address
- *   (catches access-key-signed sends where `tx.from` differs from the address).
+ * Creates a TIDX-backed {@link Provider} that runs two sub-queries in parallel:
+ * one joins bounded outbound transactions to their logs, and one reads inbound
+ * and outbound `Transfer` logs.
  */
 export declare function tidx(deps: tidx.Deps): Provider;
 export declare namespace tidx {
@@ -26190,6 +26518,8 @@ export declare namespace tidx {
         signal?: AbortSignal | undefined;
         /** TIDX query client. */
         tidx: Tidx.Client;
+        /** Request-scoped timing hook for the provider's logical queries. */
+        time?: AddressActivityTime | undefined;
     };
 }
 /**