tapimo 0.8.0 → 0.10.0

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

@@ -1,4 +1,5 @@
 import { type Context } from 'hono';
+import type { Actions } from 'viem/tempo';
 import { type Chain } from 'viem';
 import * as z from 'zod/mini';
 import type * as App from '../../../App.js';
@@ -539,9 +540,90 @@ export declare namespace schema {
             nextCursor: z.ZodMiniNullable<z.ZodMiniString<string>>;
         }, z.core.$strict>;
     }
+    /** Schemas for the getEarnAddressPositions operation. */
+    namespace getEarnAddressPositions {
+        /** Path parameters identifying the account. */
+        const Params: z.ZodMiniObject<{
+            address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+        }, z.core.$strict>;
+        /** Query parameters for listing an account's earn positions. */
+        const Query: z.ZodMiniObject<{
+            chainId: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                mainnet: "mainnet";
+                testnet: "testnet";
+            }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniNumber<unknown>]>, z.ZodMiniNumber<number>>>;
+            cursor: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            limit: z.ZodMiniDefault<z.ZodMiniNumber<unknown>>;
+            'valuation.currency': z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<string, string>>>;
+            verified: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniEnum<{
+                false: "false";
+                true: "true";
+            }>, z.ZodMiniTransform<boolean, "false" | "true">>>;
+        }, z.core.$strict>;
+        /** Page-level valuation rate provenance. */
+        const Meta: z.ZodMiniObject<{
+            valuation: z.ZodMiniOptional<z.ZodMiniObject<{
+                asOf: z.ZodMiniISODateTime;
+                basis: z.ZodMiniLiteral<"nominal">;
+                source: z.ZodMiniString<string>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        /** Paginated list of the account's earn vault positions. */
+        const Response: z.ZodMiniObject<{
+            data: z.ZodMiniArray<z.ZodMiniObject<{
+                assetAmount: z.ZodMiniObject<{
+                    amount: z.ZodMiniString<string>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    formatted: z.ZodMiniString<string>;
+                }, z.core.$strict>;
+                assetToken: z.ZodMiniObject<{
+                    address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    id: z.ZodMiniString<string>;
+                    logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                    name: z.ZodMiniString<string>;
+                    symbol: z.ZodMiniString<string>;
+                    verified: z.ZodMiniBoolean<boolean>;
+                }, z.core.$strip>;
+                id: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                shareAmount: z.ZodMiniObject<{
+                    amount: z.ZodMiniString<string>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    formatted: z.ZodMiniString<string>;
+                }, z.core.$strict>;
+                shareToken: z.ZodMiniObject<{
+                    address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    id: z.ZodMiniString<string>;
+                    logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                    name: z.ZodMiniString<string>;
+                    symbol: z.ZodMiniString<string>;
+                    verified: z.ZodMiniBoolean<boolean>;
+                }, z.core.$strip>;
+                valuation: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+                    amount: z.ZodMiniString<string>;
+                    currency: z.ZodMiniString<string>;
+                }, z.core.$strip>>>;
+                vaultAddress: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                verified: z.ZodMiniBoolean<boolean>;
+            }, z.core.$strict>>;
+            meta: z.ZodMiniOptional<z.ZodMiniObject<{
+                valuation: z.ZodMiniOptional<z.ZodMiniObject<{
+                    asOf: z.ZodMiniISODateTime;
+                    basis: z.ZodMiniLiteral<"nominal">;
+                    source: z.ZodMiniString<string>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            nextCursor: z.ZodMiniNullable<z.ZodMiniString<string>>;
+        }, z.core.$strict>;
+    }
     /** Schemas for the getEarnVault operation. */
     namespace getEarnVault {
-        /** Path parameters identifying one Earn vault. */
+        /** Path parameters identifying one earn vault. */
         const Params: z.ZodMiniObject<{
             vaultId: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
         }, z.core.$strict>;
@@ -723,6 +805,7 @@ export declare namespace schema {
                 testnet: "testnet";
             }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniNumber<unknown>]>, z.ZodMiniNumber<number>>>;
             period: z.ZodMiniDefault<z.ZodMiniEnum<{
+                "30d": "30d";
                 active: "active";
                 lifetime: "lifetime";
             }>>;
@@ -744,12 +827,21 @@ export declare namespace schema {
             activeEarnings: z.ZodMiniString<string>;
             period: z.ZodMiniLiteral<"active">;
             status: z.ZodMiniLiteral<"complete">;
+        }, z.core.$strict>, z.ZodMiniObject<{
+            account: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+            assetToken: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+            currentValue: z.ZodMiniString<string>;
+            id: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+            period: z.ZodMiniLiteral<"30d">;
+            status: z.ZodMiniLiteral<"complete">;
+            windowEarnings: z.ZodMiniString<string>;
         }, z.core.$strict>, z.ZodMiniObject<{
             account: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
             assetToken: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
             currentValue: z.ZodMiniString<string>;
             id: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
             period: z.ZodMiniEnum<{
+                "30d": "30d";
                 active: "active";
                 lifetime: "lifetime";
             }>;
@@ -759,7 +851,10 @@ export declare namespace schema {
             assetToken: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
             currentValue: z.ZodMiniString<string>;
             id: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
-            period: z.ZodMiniLiteral<"lifetime">;
+            period: z.ZodMiniEnum<{
+                "30d": "30d";
+                lifetime: "lifetime";
+            }>;
             status: z.ZodMiniLiteral<"pending_redemption">;
         }, z.core.$strict>]>;
     }
@@ -786,14 +881,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "api_key_malformed";
+                    code: "upstream_error";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400;
+            status: 502;
             input: {
                 query?: {
                     asset?: string | string[];
@@ -809,14 +904,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "api_key_invalid" | "api_key_missing";
+                    code: "api_key_malformed";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 401;
+            status: 400;
             input: {
                 query?: {
                     asset?: string | string[];
@@ -832,14 +927,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "api_key_forbidden" | "api_key_ip_forbidden";
+                    code: "api_key_invalid" | "api_key_missing";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 403;
+            status: 401;
             input: {
                 query?: {
                     asset?: string | string[];
@@ -855,14 +950,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "payment_required" | "rate_limit_exceeded";
+                    code: "api_key_forbidden" | "api_key_ip_forbidden";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 429;
+            status: 403;
             input: {
                 query?: {
                     asset?: string | string[];
@@ -878,14 +973,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "query_invalid";
+                    code: "payment_required" | "rate_limit_exceeded";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400;
+            status: 429;
             input: {
                 query?: {
                     asset?: string | string[];
@@ -901,14 +996,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "upstream_error";
+                    code: "query_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 502;
+            status: 400;
             input: {
                 query?: {
                     asset?: string | string[];
@@ -1046,6 +1141,29 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                     'apy.window'?: string | string[];
                 } | undefined;
             };
+        } | {
+            output: {
+                error: {
+                    code: "upstream_error";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 502;
+            input: {
+                query?: {
+                    asset?: string | string[];
+                    capability?: string | string[];
+                    chainId?: string | string[];
+                    cursor?: string | string[];
+                    'engine.type'?: string | string[];
+                    include?: string | string[];
+                    limit?: string | string[];
+                    'apy.window'?: string | string[];
+                } | undefined;
+            };
         } | {
             output: {
                 error: {
@@ -1128,20 +1246,337 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             status: 429;
             input: {
                 query?: {
-                    asset?: string | string[];
-                    capability?: string | string[];
+                    asset?: string | string[];
+                    capability?: string | string[];
+                    chainId?: string | string[];
+                    cursor?: string | string[];
+                    'engine.type'?: string | string[];
+                    include?: string | string[];
+                    limit?: string | string[];
+                    'apy.window'?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "query_invalid";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 400;
+            input: {
+                query?: {
+                    asset?: string | string[];
+                    capability?: string | string[];
+                    chainId?: string | string[];
+                    cursor?: string | string[];
+                    'engine.type'?: string | string[];
+                    include?: string | string[];
+                    limit?: string | string[];
+                    'apy.window'?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                data: {
+                    access?: {
+                        status: "allowlisted" | "open";
+                    } | undefined;
+                    apy?: {
+                        asOf: string;
+                        methodology: "share-price-growth-annualized:v1";
+                        net: string;
+                        window: "1d" | "1h" | "30d" | "7d";
+                    } | null | undefined;
+                    assetToken: {
+                        address: `0x${string}`;
+                        currency: string;
+                        decimals: number;
+                        id: string;
+                        logoUri?: string | undefined;
+                        name: string;
+                        symbol: string;
+                        verified: boolean;
+                    };
+                    capabilities?: {
+                        asyncRedeem: boolean;
+                        boundedRedeem: boolean;
+                        deposit: boolean;
+                        exactWithdraw: boolean;
+                        inKindDeposit: boolean;
+                        privateRouting: boolean;
+                        redeem: boolean;
+                        routerSwaps: boolean;
+                    } | undefined;
+                    description: string | null;
+                    id: `0x${string}`;
+                    instantLiquidity: string | null;
+                    label: string;
+                    sharePrice: {
+                        amount: string;
+                        currency: string;
+                        decimals: number;
+                        formatted: string;
+                    } | null;
+                    shareToken: {
+                        address: `0x${string}`;
+                        currency: string;
+                        decimals: number;
+                        id: string;
+                        logoUri?: string | undefined;
+                        name: string;
+                        symbol: string;
+                        verified: boolean;
+                    };
+                    state: {
+                        depositsPaused: boolean;
+                        engineShares: string;
+                        feesActive: boolean;
+                        isAccountingAligned: boolean;
+                        openRedeemRequestCount: number;
+                        totalAssets: string;
+                        totalEarnShares: string;
+                    };
+                    tvl?: {
+                        amount: string;
+                        currency: string;
+                        decimals: number;
+                        formatted: string;
+                    } | null | undefined;
+                    vaultAddress: `0x${string}`;
+                    zone?: {
+                        chainId: number;
+                        inputTokens: `0x${string}`[];
+                        name: string;
+                        outputTokens: `0x${string}`[];
+                    } | null | undefined;
+                    engine: {
+                        address: `0x${string}`;
+                        venue: `0x${string}` | null;
+                        type: "erc4626" | "veda";
+                    };
+                    slug: string;
+                    verified: true;
+                }[];
+                meta?: {
+                    valuation?: {
+                        asOf: string;
+                        basis: "nominal";
+                        source: string;
+                    } | undefined;
+                } | undefined;
+                nextCursor: string | null;
+            };
+            outputFormat: "json";
+            status: 200;
+            input: {
+                query?: {
+                    asset?: string | string[];
+                    capability?: string | string[];
+                    chainId?: string | string[];
+                    cursor?: string | string[];
+                    'engine.type'?: string | string[];
+                    include?: string | string[];
+                    limit?: string | string[];
+                    'apy.window'?: string | string[];
+                } | undefined;
+            };
+        };
+    };
+} & {
+    "/v1/earn/addresses/:address/positions": {
+        $get: {
+            output: null;
+            outputFormat: "body";
+            status: 402;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    cursor?: string | string[];
+                    limit?: string | string[];
+                    'valuation.currency'?: string | string[];
+                    verified?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "chain_id_unsupported";
+                    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[];
+                    limit?: string | string[];
+                    'valuation.currency'?: string | string[];
+                    verified?: 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[];
+                    limit?: string | string[];
+                    'valuation.currency'?: string | string[];
+                    verified?: 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[];
+                    limit?: string | string[];
+                    'valuation.currency'?: string | string[];
+                    verified?: 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[];
+                    limit?: string | string[];
+                    'valuation.currency'?: string | string[];
+                    verified?: 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[];
+                    limit?: string | string[];
+                    'valuation.currency'?: string | string[];
+                    verified?: 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[];
+                    limit?: string | string[];
+                    'valuation.currency'?: string | string[];
+                    verified?: 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[];
-                    'engine.type'?: string | string[];
-                    include?: string | string[];
                     limit?: string | string[];
-                    'apy.window'?: string | string[];
+                    'valuation.currency'?: string | string[];
+                    verified?: string | string[];
                 } | undefined;
             };
         } | {
             output: {
                 error: {
-                    code: "query_invalid";
+                    code: "chain_id_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
@@ -1150,52 +1585,51 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             outputFormat: "json";
             status: 400;
             input: {
+                param: {
+                    address: `0x${string}`;
+                };
+            } & {
                 query?: {
-                    asset?: string | string[];
-                    capability?: string | string[];
                     chainId?: string | string[];
                     cursor?: string | string[];
-                    'engine.type'?: string | string[];
-                    include?: string | string[];
                     limit?: string | string[];
-                    'apy.window'?: string | string[];
+                    'valuation.currency'?: string | string[];
+                    verified?: string | string[];
                 } | undefined;
             };
         } | {
             output: {
                 error: {
-                    code: "upstream_error";
+                    code: "positions_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 502;
+            status: 400;
             input: {
+                param: {
+                    address: `0x${string}`;
+                };
+            } & {
                 query?: {
-                    asset?: string | string[];
-                    capability?: string | string[];
                     chainId?: string | string[];
                     cursor?: string | string[];
-                    'engine.type'?: string | string[];
-                    include?: string | string[];
                     limit?: string | string[];
-                    'apy.window'?: string | string[];
+                    'valuation.currency'?: string | string[];
+                    verified?: string | string[];
                 } | undefined;
             };
         } | {
             output: {
                 data: {
-                    access?: {
-                        status: "allowlisted" | "open";
-                    } | undefined;
-                    apy?: {
-                        asOf: string;
-                        methodology: "share-price-growth-annualized:v1";
-                        net: string;
-                        window: "1d" | "1h" | "30d" | "7d";
-                    } | null | undefined;
+                    assetAmount: {
+                        amount: string;
+                        currency: string;
+                        decimals: number;
+                        formatted: string;
+                    };
                     assetToken: {
                         address: `0x${string}`;
                         currency: string;
@@ -1206,26 +1640,13 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                         symbol: string;
                         verified: boolean;
                     };
-                    capabilities?: {
-                        asyncRedeem: boolean;
-                        boundedRedeem: boolean;
-                        deposit: boolean;
-                        exactWithdraw: boolean;
-                        inKindDeposit: boolean;
-                        privateRouting: boolean;
-                        redeem: boolean;
-                        routerSwaps: boolean;
-                    } | undefined;
-                    description: string | null;
                     id: `0x${string}`;
-                    instantLiquidity: string | null;
-                    label: string;
-                    sharePrice: {
+                    shareAmount: {
                         amount: string;
                         currency: string;
                         decimals: number;
                         formatted: string;
-                    } | null;
+                    };
                     shareToken: {
                         address: `0x${string}`;
                         currency: string;
@@ -1236,35 +1657,12 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                         symbol: string;
                         verified: boolean;
                     };
-                    state: {
-                        depositsPaused: boolean;
-                        engineShares: string;
-                        feesActive: boolean;
-                        isAccountingAligned: boolean;
-                        openRedeemRequestCount: number;
-                        totalAssets: string;
-                        totalEarnShares: string;
-                    };
-                    tvl?: {
+                    valuation?: {
                         amount: string;
                         currency: string;
-                        decimals: number;
-                        formatted: string;
                     } | null | undefined;
                     vaultAddress: `0x${string}`;
-                    zone?: {
-                        chainId: number;
-                        inputTokens: `0x${string}`[];
-                        name: string;
-                        outputTokens: `0x${string}`[];
-                    } | null | undefined;
-                    engine: {
-                        address: `0x${string}`;
-                        venue: `0x${string}` | null;
-                        type: "erc4626" | "veda";
-                    };
-                    slug: string;
-                    verified: true;
+                    verified: boolean;
                 }[];
                 meta?: {
                     valuation?: {
@@ -1278,15 +1676,16 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             outputFormat: "json";
             status: 200;
             input: {
+                param: {
+                    address: `0x${string}`;
+                };
+            } & {
                 query?: {
-                    asset?: string | string[];
-                    capability?: string | string[];
                     chainId?: string | string[];
                     cursor?: string | string[];
-                    'engine.type'?: string | string[];
-                    include?: string | string[];
                     limit?: string | string[];
-                    'apy.window'?: string | string[];
+                    'valuation.currency'?: string | string[];
+                    verified?: string | string[];
                 } | undefined;
             };
         };
@@ -1310,7 +1709,7 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "api_key_malformed";
+                    code: "chain_id_unsupported";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
@@ -1331,14 +1730,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "api_key_invalid" | "api_key_missing";
+                    code: "upstream_error";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 401;
+            status: 502;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -1352,14 +1751,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "api_key_forbidden" | "api_key_ip_forbidden";
+                    code: "api_key_malformed";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 403;
+            status: 400;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -1373,14 +1772,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "payment_required" | "rate_limit_exceeded";
+                    code: "api_key_invalid" | "api_key_missing";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 429;
+            status: 401;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -1394,14 +1793,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "query_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: {
                     address: `0x${string}`;
@@ -1415,14 +1814,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "upstream_error";
+                    code: "payment_required" | "rate_limit_exceeded";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 502;
+            status: 429;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -1436,7 +1835,7 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "chain_id_invalid";
+                    code: "query_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
@@ -1457,7 +1856,7 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "chain_id_unsupported";
+                    code: "chain_id_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
@@ -1563,7 +1962,7 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "api_key_malformed";
+                    code: "chain_id_unsupported";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
@@ -1585,14 +1984,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "api_key_invalid" | "api_key_missing";
+                    code: "upstream_error";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 401;
+            status: 502;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -1607,14 +2006,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "api_key_forbidden" | "api_key_ip_forbidden";
+                    code: "api_key_malformed";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 403;
+            status: 400;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -1629,14 +2028,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "payment_required" | "rate_limit_exceeded";
+                    code: "api_key_invalid" | "api_key_missing";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 429;
+            status: 401;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -1651,14 +2050,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "query_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: {
                     address: `0x${string}`;
@@ -1673,14 +2072,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "upstream_error";
+                    code: "payment_required" | "rate_limit_exceeded";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 502;
+            status: 429;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -1695,7 +2094,7 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "chain_id_invalid";
+                    code: "query_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
@@ -1717,7 +2116,7 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "chain_id_unsupported";
+                    code: "chain_id_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
@@ -1802,14 +2201,22 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                 assetToken: `0x${string}`;
                 currentValue: string;
                 id: `0x${string}`;
-                period: "active" | "lifetime";
+                period: "30d";
+                status: "complete";
+                windowEarnings: string;
+            } | {
+                account: `0x${string}`;
+                assetToken: `0x${string}`;
+                currentValue: string;
+                id: `0x${string}`;
+                period: "30d" | "active" | "lifetime";
                 status: "incomplete_cost_basis";
             } | {
                 account: `0x${string}`;
                 assetToken: `0x${string}`;
                 currentValue: string;
                 id: `0x${string}`;
-                period: "lifetime";
+                period: "30d" | "lifetime";
                 status: "pending_redemption";
             };
             outputFormat: "json";
@@ -1847,14 +2254,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "api_key_malformed";
+                    code: "upstream_error";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400;
+            status: 502;
             input: {
                 param: {
                     vaultId: `0x${string}`;
@@ -1869,14 +2276,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "api_key_invalid" | "api_key_missing";
+                    code: "api_key_malformed";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 401;
+            status: 400;
             input: {
                 param: {
                     vaultId: `0x${string}`;
@@ -1891,14 +2298,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "api_key_forbidden" | "api_key_ip_forbidden";
+                    code: "api_key_invalid" | "api_key_missing";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 403;
+            status: 401;
             input: {
                 param: {
                     vaultId: `0x${string}`;
@@ -1913,14 +2320,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "payment_required" | "rate_limit_exceeded";
+                    code: "api_key_forbidden" | "api_key_ip_forbidden";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 429;
+            status: 403;
             input: {
                 param: {
                     vaultId: `0x${string}`;
@@ -1935,14 +2342,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "query_invalid";
+                    code: "payment_required" | "rate_limit_exceeded";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400;
+            status: 429;
             input: {
                 param: {
                     vaultId: `0x${string}`;
@@ -1957,14 +2364,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "upstream_error";
+                    code: "query_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 502;
+            status: 400;
             input: {
                 param: {
                     vaultId: `0x${string}`;
@@ -2169,7 +2576,48 @@ export declare function getVaultEarnings(c: Context<App.Environment>, options: g
     period: "lifetime";
     lifetimeEarnings: string;
     status: 'complete';
+} | {
+    account: `0x${string}`;
+    assetToken: `0x${string}`;
+    currentValue: string;
+    id: `0x${string}`;
+    period: "30d";
+    status: 'incomplete_cost_basis';
+} | {
+    account: `0x${string}`;
+    assetToken: `0x${string}`;
+    currentValue: string;
+    id: `0x${string}`;
+    period: "30d";
+    status: 'pending_redemption';
+} | {
+    account: `0x${string}`;
+    assetToken: `0x${string}`;
+    currentValue: string;
+    id: `0x${string}`;
+    period: "30d";
+    status: 'complete';
+    windowEarnings: string;
 }>;
+/** Calculates cash-flow-adjusted earnings between two position snapshots. */
+export declare function calculateWindowEarnings(options: calculateWindowEarnings.Options): bigint;
+export declare namespace calculateWindowEarnings {
+    /** Asset-denominated values spanning one earnings window. */
+    type Options = {
+        /** Assets deposited during the window. */
+        deposited: bigint;
+        /** Asset value of shares held at the ending boundary. */
+        endingValue: bigint;
+        /** Assets received from async redemptions finalized during the window. */
+        finalized: bigint;
+        /** Asset value of shares held at the opening boundary. */
+        openingValue: bigint;
+        /** Assets received from redemptions during the window. */
+        redeemed: bigint;
+        /** Assets received from exact withdrawals during the window. */
+        withdrewExact: bigint;
+    };
+}
 export declare namespace getVaultEarnings {
     /** Inputs identifying the account and vault to calculate. */
     type Options = {
@@ -2434,6 +2882,74 @@ export declare namespace listVerifiedVaults {
         oracle: FxOracle.Oracle;
     };
 }
+/** Lists every vault where an account holds earn shares, ordered by vault address. */
+export declare function listPositions(c: Context<App.Environment>, options: listPositions.Options): Promise<{
+    data: {
+        assetAmount: {
+            amount: string;
+            currency: string;
+            decimals: number;
+            formatted: string;
+        };
+        assetToken: {
+            address: `0x${string}`;
+            currency: string;
+            decimals: number;
+            id: string;
+            logoUri?: string | undefined;
+            name: string;
+            symbol: string;
+            verified: boolean;
+        };
+        id: `0x${string}`;
+        shareAmount: {
+            amount: string;
+            currency: string;
+            decimals: number;
+            formatted: string;
+        };
+        shareToken: {
+            address: `0x${string}`;
+            currency: string;
+            decimals: number;
+            id: string;
+            logoUri?: string | undefined;
+            name: string;
+            symbol: string;
+            verified: boolean;
+        };
+        valuation?: {
+            amount: string;
+            currency: string;
+        } | null;
+        vaultAddress: `0x${string}`;
+        verified: boolean;
+    }[];
+    meta?: {
+        valuation: {
+            asOf: string;
+            basis: 'nominal';
+            source: string;
+        };
+    };
+    nextCursor: string | null;
+}>;
+export declare namespace listPositions {
+    /** One candidate vault holding a non-zero position. */
+    type Match = {
+        position: Actions.earn.getPosition.ReturnValue;
+        record?: RegistryRecord | undefined;
+        vaultAddress: string;
+    };
+    /** Options for listing an account's earn positions. */
+    type Options = z.output<typeof schema.getEarnAddressPositions.Query> & {
+        /** Account whose positions to list. */
+        address: z.output<typeof Schema.Address>;
+        chainId: z.output<typeof Schema.ChainId>;
+        /** FX rate oracle backing per-row valuation. */
+        oracle: FxOracle.Oracle;
+    };
+}
 /** Gets one compatible Earn vault. */
 export declare function getVault(c: Context<App.Environment>, options: getVault.Options): Promise<{
     access?: {