tapimo 0.9.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>;
@@ -799,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[];
@@ -822,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[];
@@ -845,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[];
@@ -868,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[];
@@ -891,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[];
@@ -914,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[];
@@ -1062,14 +1144,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[];
@@ -1085,14 +1167,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[];
@@ -1108,14 +1190,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[];
@@ -1131,14 +1213,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[];
@@ -1154,14 +1236,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[];
@@ -1177,14 +1259,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[];
@@ -1305,7 +1387,7 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         };
     };
 } & {
-    "/v1/earn/vaults/:vaultId/positions/:address": {
+    "/v1/earn/addresses/:address/positions": {
         $get: {
             output: null;
             outputFormat: "body";
@@ -1313,11 +1395,62 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             input: {
                 param: {
                     address: `0x${string}`;
-                    vaultId: `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;
             };
         } | {
@@ -1334,11 +1467,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             input: {
                 param: {
                     address: `0x${string}`;
-                    vaultId: `0x${string}`;
                 };
             } & {
                 query?: {
                     chainId?: string | string[];
+                    cursor?: string | string[];
+                    limit?: string | string[];
+                    'valuation.currency'?: string | string[];
+                    verified?: string | string[];
                 } | undefined;
             };
         } | {
@@ -1355,11 +1491,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             input: {
                 param: {
                     address: `0x${string}`;
-                    vaultId: `0x${string}`;
                 };
             } & {
                 query?: {
                     chainId?: string | string[];
+                    cursor?: string | string[];
+                    limit?: string | string[];
+                    'valuation.currency'?: string | string[];
+                    verified?: string | string[];
                 } | undefined;
             };
         } | {
@@ -1376,11 +1515,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             input: {
                 param: {
                     address: `0x${string}`;
-                    vaultId: `0x${string}`;
                 };
             } & {
                 query?: {
                     chainId?: string | string[];
+                    cursor?: string | string[];
+                    limit?: string | string[];
+                    'valuation.currency'?: string | string[];
+                    verified?: string | string[];
                 } | undefined;
             };
         } | {
@@ -1397,11 +1539,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             input: {
                 param: {
                     address: `0x${string}`;
-                    vaultId: `0x${string}`;
                 };
             } & {
                 query?: {
                     chainId?: string | string[];
+                    cursor?: string | string[];
+                    limit?: string | string[];
+                    'valuation.currency'?: string | string[];
+                    verified?: string | string[];
                 } | undefined;
             };
         } | {
@@ -1415,6 +1560,163 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             };
             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: "chain_id_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[];
+                    limit?: string | string[];
+                    'valuation.currency'?: string | string[];
+                    verified?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "positions_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[];
+                    limit?: string | string[];
+                    'valuation.currency'?: string | string[];
+                    verified?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                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 | undefined;
+                    vaultAddress: `0x${string}`;
+                    verified: boolean;
+                }[];
+                meta?: {
+                    valuation?: {
+                        asOf: string;
+                        basis: "nominal";
+                        source: string;
+                    } | undefined;
+                } | undefined;
+                nextCursor: string | null;
+            };
+            outputFormat: "json";
+            status: 200;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    cursor?: string | string[];
+                    limit?: string | string[];
+                    'valuation.currency'?: string | string[];
+                    verified?: string | string[];
+                } | undefined;
+            };
+        };
+    };
+} & {
+    "/v1/earn/vaults/:vaultId/positions/:address": {
+        $get: {
+            output: null;
+            outputFormat: "body";
+            status: 402;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: 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}`;
@@ -1449,7 +1751,7 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "chain_id_invalid";
+                    code: "api_key_malformed";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
@@ -1470,7 +1772,91 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "chain_id_unsupported";
+                    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}`;
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: 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}`;
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: 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}`;
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: 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}`;
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "chain_id_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
@@ -1576,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;
                 };
@@ -1598,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}`;
@@ -1620,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}`;
@@ -1642,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}`;
@@ -1664,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}`;
@@ -1686,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}`;
@@ -1708,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;
                 };
@@ -1730,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;
                 };
@@ -1868,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}`;
@@ -1890,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}`;
@@ -1912,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}`;
@@ -1934,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}`;
@@ -1956,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}`;
@@ -1978,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}`;
@@ -2496,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?: {