tapimo 0.13.0 → 0.15.0

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

@@ -1,13 +1,16 @@
 import { type Context } from 'hono';
-import type { Actions } from 'viem/tempo';
+import { type Actions } from 'viem/tempo';
 import { type Chain } from 'viem';
 import * as z from 'zod/mini';
 import type * as App from '../../../App.js';
 import * as core_EarnVaults from '../../../db/tables/earnVaults.js';
 import * as EarnRates from '../../../internal/EarnRates.js';
 import * as EarnVaults from '../../../internal/EarnVaults.js';
+import type * as Log from '../../../internal/Log.js';
+import * as RewardRead from '../../../internal/rewards/Read.js';
 import * as Response from '../../../internal/Response.js';
 import * as Schema from '../../../internal/Schema.js';
+import * as Tidx from '../../../internal/Tidx.js';
 import * as FxOracle from '../FxOracle.js';
 import * as Tokens from './tokens.js';
 import * as Valuation from './valuation.js';
@@ -39,6 +42,73 @@ export declare namespace hasZoneAccess {
 }
 /** Zod schemas owned by the public Earn-vault resource. */
 export declare namespace schema {
+    /** Schemas for the registerRewardEligibility operation. */
+    namespace registerRewardEligibility {
+        /** Wallet and vault association to register for reward eligibility. */
+        const Body: z.ZodMiniObject<{
+            chainId: z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                mainnet: "mainnet";
+                testnet: "testnet";
+            }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniPipe<z.ZodMiniNumber<unknown>, z.ZodMiniTransform<number, number>>]>, z.ZodMiniNumber<number>>;
+            transactionHash: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+            vaultAddress: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+            walletAddress: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+        }, z.core.$strict>;
+        /** Persisted reward eligibility association. */
+        const Association: z.ZodMiniObject<{
+            chainId: z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                mainnet: "mainnet";
+                testnet: "testnet";
+            }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniPipe<z.ZodMiniNumber<unknown>, z.ZodMiniTransform<number, number>>]>, z.ZodMiniNumber<number>>;
+            firstRegisteredAt: z.ZodMiniISODateTime;
+            id: z.ZodMiniString<string>;
+            latestRegisteredAt: z.ZodMiniISODateTime;
+            registrationOrder: z.ZodMiniString<string>;
+            transactionHash: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+            vaultAddress: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+            walletAddress: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+        }, z.core.$strict>;
+        /** Persisted reward eligibility registration result. */
+        const Response: z.ZodMiniObject<{
+            association: z.ZodMiniObject<{
+                chainId: z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                    mainnet: "mainnet";
+                    testnet: "testnet";
+                }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniPipe<z.ZodMiniNumber<unknown>, z.ZodMiniTransform<number, number>>]>, z.ZodMiniNumber<number>>;
+                firstRegisteredAt: z.ZodMiniISODateTime;
+                id: z.ZodMiniString<string>;
+                latestRegisteredAt: z.ZodMiniISODateTime;
+                registrationOrder: z.ZodMiniString<string>;
+                transactionHash: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+                vaultAddress: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                walletAddress: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+            }, z.core.$strict>;
+            created: z.ZodMiniBoolean<boolean>;
+        }, z.core.$strict>;
+    }
+    /** Schemas for the getRewardEligibility operation. */
+    namespace getRewardEligibility {
+        /** Selects one chain and vault eligibility snapshot page. */
+        const Query: z.ZodMiniObject<{
+            chainId: z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                mainnet: "mainnet";
+                testnet: "testnet";
+            }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniPipe<z.ZodMiniNumber<unknown>, z.ZodMiniTransform<number, number>>]>, z.ZodMiniNumber<number>>;
+            cursor: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            limit: z.ZodMiniDefault<z.ZodMiniPipe<z.ZodMiniNumber<unknown>, z.ZodMiniTransform<number, number>>>;
+            vaultAddress: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+        }, z.core.$strict>;
+        /** One page of eligible wallets at the cursor's fixed checkpoint. */
+        const Response: z.ZodMiniObject<{
+            chainId: z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                mainnet: "mainnet";
+                testnet: "testnet";
+            }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniPipe<z.ZodMiniNumber<unknown>, z.ZodMiniTransform<number, number>>]>, z.ZodMiniNumber<number>>;
+            data: z.ZodMiniArray<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+            nextCursor: z.ZodMiniNullable<z.ZodMiniString<string>>;
+            vaultAddress: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+        }, z.core.$strict>;
+    }
     /** One compatible Earn vault resolved from current chain state. */
     const Vault: z.ZodMiniObject<{
         access: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
@@ -51,6 +121,23 @@ export declare namespace schema {
             asOf: z.ZodMiniISODateTime;
             methodology: z.ZodMiniLiteral<"share-price-growth-annualized:v1">;
             net: z.ZodMiniString<string>;
+            rewards: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
+                apr: z.ZodMiniNullable<z.ZodMiniString<string>>;
+                asset: z.ZodMiniObject<{
+                    address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                    chainId: z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                        mainnet: "mainnet";
+                        testnet: "testnet";
+                    }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniPipe<z.ZodMiniNumber<unknown>, z.ZodMiniTransform<number, number>>]>, z.ZodMiniNumber<number>>;
+                    decimals: z.ZodMiniNumber<number>;
+                }, z.core.$strict>;
+                calculatedThrough: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+                campaignId: z.ZodMiniString<string>;
+                endsAt: z.ZodMiniNumber<number>;
+                startsAt: z.ZodMiniNumber<number>;
+                targetTotalApr: z.ZodMiniString<string>;
+            }, z.core.$strict>>>;
+            vault: z.ZodMiniString<string>;
             window: z.ZodMiniEnum<{
                 "1d": "1d";
                 "1h": "1h";
@@ -89,6 +176,12 @@ export declare namespace schema {
         }, z.core.$strict>;
         id: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
         instantLiquidity: z.ZodMiniNullable<z.ZodMiniString<string>>;
+        instantLiquidityValue: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+            amount: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strict>>>;
         label: z.ZodMiniString<string>;
         sharePrice: z.ZodMiniNullable<z.ZodMiniObject<{
             amount: z.ZodMiniString<string>;
@@ -157,6 +250,23 @@ export declare namespace schema {
             asOf: z.ZodMiniISODateTime;
             methodology: z.ZodMiniLiteral<"share-price-growth-annualized:v1">;
             net: z.ZodMiniString<string>;
+            rewards: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
+                apr: z.ZodMiniNullable<z.ZodMiniString<string>>;
+                asset: z.ZodMiniObject<{
+                    address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                    chainId: z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                        mainnet: "mainnet";
+                        testnet: "testnet";
+                    }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniPipe<z.ZodMiniNumber<unknown>, z.ZodMiniTransform<number, number>>]>, z.ZodMiniNumber<number>>;
+                    decimals: z.ZodMiniNumber<number>;
+                }, z.core.$strict>;
+                calculatedThrough: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+                campaignId: z.ZodMiniString<string>;
+                endsAt: z.ZodMiniNumber<number>;
+                startsAt: z.ZodMiniNumber<number>;
+                targetTotalApr: z.ZodMiniString<string>;
+            }, z.core.$strict>>>;
+            vault: z.ZodMiniString<string>;
             window: z.ZodMiniEnum<{
                 "1d": "1d";
                 "1h": "1h";
@@ -187,6 +297,12 @@ export declare namespace schema {
         description: z.ZodMiniNullable<z.ZodMiniString<string>>;
         id: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
         instantLiquidity: z.ZodMiniNullable<z.ZodMiniString<string>>;
+        instantLiquidityValue: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+            amount: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strict>>>;
         label: z.ZodMiniString<string>;
         sharePrice: z.ZodMiniNullable<z.ZodMiniObject<{
             amount: z.ZodMiniString<string>;
@@ -305,6 +421,23 @@ export declare namespace schema {
                     asOf: z.ZodMiniISODateTime;
                     methodology: z.ZodMiniLiteral<"share-price-growth-annualized:v1">;
                     net: z.ZodMiniString<string>;
+                    rewards: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
+                        apr: z.ZodMiniNullable<z.ZodMiniString<string>>;
+                        asset: z.ZodMiniObject<{
+                            address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                            chainId: z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                                mainnet: "mainnet";
+                                testnet: "testnet";
+                            }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniPipe<z.ZodMiniNumber<unknown>, z.ZodMiniTransform<number, number>>]>, z.ZodMiniNumber<number>>;
+                            decimals: z.ZodMiniNumber<number>;
+                        }, z.core.$strict>;
+                        calculatedThrough: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+                        campaignId: z.ZodMiniString<string>;
+                        endsAt: z.ZodMiniNumber<number>;
+                        startsAt: z.ZodMiniNumber<number>;
+                        targetTotalApr: z.ZodMiniString<string>;
+                    }, z.core.$strict>>>;
+                    vault: z.ZodMiniString<string>;
                     window: z.ZodMiniEnum<{
                         "1d": "1d";
                         "1h": "1h";
@@ -343,6 +476,12 @@ export declare namespace schema {
                 }, z.core.$strict>;
                 id: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
                 instantLiquidity: z.ZodMiniNullable<z.ZodMiniString<string>>;
+                instantLiquidityValue: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+                    amount: z.ZodMiniString<string>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    formatted: z.ZodMiniString<string>;
+                }, z.core.$strict>>>;
                 label: z.ZodMiniString<string>;
                 sharePrice: z.ZodMiniNullable<z.ZodMiniObject<{
                     amount: z.ZodMiniString<string>;
@@ -494,6 +633,23 @@ export declare namespace schema {
                     asOf: z.ZodMiniISODateTime;
                     methodology: z.ZodMiniLiteral<"share-price-growth-annualized:v1">;
                     net: z.ZodMiniString<string>;
+                    rewards: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
+                        apr: z.ZodMiniNullable<z.ZodMiniString<string>>;
+                        asset: z.ZodMiniObject<{
+                            address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                            chainId: z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                                mainnet: "mainnet";
+                                testnet: "testnet";
+                            }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniPipe<z.ZodMiniNumber<unknown>, z.ZodMiniTransform<number, number>>]>, z.ZodMiniNumber<number>>;
+                            decimals: z.ZodMiniNumber<number>;
+                        }, z.core.$strict>;
+                        calculatedThrough: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+                        campaignId: z.ZodMiniString<string>;
+                        endsAt: z.ZodMiniNumber<number>;
+                        startsAt: z.ZodMiniNumber<number>;
+                        targetTotalApr: z.ZodMiniString<string>;
+                    }, z.core.$strict>>>;
+                    vault: z.ZodMiniString<string>;
                     window: z.ZodMiniEnum<{
                         "1d": "1d";
                         "1h": "1h";
@@ -524,6 +680,12 @@ export declare namespace schema {
                 description: z.ZodMiniNullable<z.ZodMiniString<string>>;
                 id: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
                 instantLiquidity: z.ZodMiniNullable<z.ZodMiniString<string>>;
+                instantLiquidityValue: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+                    amount: z.ZodMiniString<string>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    formatted: z.ZodMiniString<string>;
+                }, z.core.$strict>>>;
                 label: z.ZodMiniString<string>;
                 sharePrice: z.ZodMiniNullable<z.ZodMiniObject<{
                     amount: z.ZodMiniString<string>;
@@ -611,6 +773,9 @@ export declare namespace schema {
                 testnet: "testnet";
             }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniPipe<z.ZodMiniNumber<unknown>, z.ZodMiniTransform<number, number>>]>, z.ZodMiniNumber<number>>>;
             cursor: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            include: z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniUnknown>, z.ZodMiniTransform<string[], unknown>>, z.ZodMiniArray<z.ZodMiniEnum<{
+                earnings: "earnings";
+            }>>>;
             limit: z.ZodMiniDefault<z.ZodMiniPipe<z.ZodMiniNumber<unknown>, z.ZodMiniTransform<number, number>>>;
             'valuation.currency': z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<string, string>>>;
             verified: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniEnum<{
@@ -645,7 +810,18 @@ export declare namespace schema {
                     symbol: z.ZodMiniString<string>;
                     verified: z.ZodMiniBoolean<boolean>;
                 }, z.core.$strip>;
+                chainId: z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                    mainnet: "mainnet";
+                    testnet: "testnet";
+                }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniPipe<z.ZodMiniNumber<unknown>, z.ZodMiniTransform<number, number>>]>, z.ZodMiniNumber<number>>;
                 id: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                lifetimeCashFlows: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniObject<{
+                    status: z.ZodMiniLiteral<"complete">;
+                    totalDeposited: z.ZodMiniString<string>;
+                    totalWithdrawn: z.ZodMiniString<string>;
+                }, z.core.$strict>, z.ZodMiniObject<{
+                    status: z.ZodMiniLiteral<"incomplete_history">;
+                }, z.core.$strict>]>>;
                 shareAmount: z.ZodMiniObject<{
                     amount: z.ZodMiniString<string>;
                     currency: z.ZodMiniString<string>;
@@ -666,6 +842,16 @@ export declare namespace schema {
                     amount: z.ZodMiniString<string>;
                     currency: z.ZodMiniString<string>;
                 }, z.core.$strip>>>;
+                valueToken: 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>;
                 vaultAddress: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
                 verified: z.ZodMiniBoolean<boolean>;
             }, z.core.$strict>>;
@@ -733,6 +919,23 @@ export declare namespace schema {
                 asOf: z.ZodMiniISODateTime;
                 methodology: z.ZodMiniLiteral<"share-price-growth-annualized:v1">;
                 net: z.ZodMiniString<string>;
+                rewards: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
+                    apr: z.ZodMiniNullable<z.ZodMiniString<string>>;
+                    asset: z.ZodMiniObject<{
+                        address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                        chainId: z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                            mainnet: "mainnet";
+                            testnet: "testnet";
+                        }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniPipe<z.ZodMiniNumber<unknown>, z.ZodMiniTransform<number, number>>]>, z.ZodMiniNumber<number>>;
+                        decimals: z.ZodMiniNumber<number>;
+                    }, z.core.$strict>;
+                    calculatedThrough: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+                    campaignId: z.ZodMiniString<string>;
+                    endsAt: z.ZodMiniNumber<number>;
+                    startsAt: z.ZodMiniNumber<number>;
+                    targetTotalApr: z.ZodMiniString<string>;
+                }, z.core.$strict>>>;
+                vault: z.ZodMiniString<string>;
                 window: z.ZodMiniEnum<{
                     "1d": "1d";
                     "1h": "1h";
@@ -771,6 +974,12 @@ export declare namespace schema {
             }, z.core.$strict>;
             id: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
             instantLiquidity: z.ZodMiniNullable<z.ZodMiniString<string>>;
+            instantLiquidityValue: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+                amount: z.ZodMiniString<string>;
+                currency: z.ZodMiniString<string>;
+                decimals: z.ZodMiniNumber<number>;
+                formatted: z.ZodMiniString<string>;
+            }, z.core.$strict>>>;
             label: z.ZodMiniString<string>;
             sharePrice: z.ZodMiniNullable<z.ZodMiniObject<{
                 amount: z.ZodMiniString<string>;
@@ -835,6 +1044,35 @@ export declare namespace schema {
             }, z.core.$strip>>;
         }, z.core.$strict>;
     }
+    /** Schemas for the getEarnVaultSharePrices operation. */
+    namespace getEarnVaultSharePrices {
+        /** 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>;
+        /** Query parameters selecting a daily historical share-price range. */
+        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.ZodMiniPipe<z.ZodMiniNumber<unknown>, z.ZodMiniTransform<number, number>>]>, z.ZodMiniNumber<number>>>;
+            from: z.ZodMiniISODateTime;
+            interval: z.ZodMiniDefault<z.ZodMiniLiteral<"day">>;
+            to: z.ZodMiniISODateTime;
+        }, z.core.$strict>;
+        /** Daily share prices for one Earn vault. */
+        const Response: z.ZodMiniObject<{
+            data: z.ZodMiniArray<z.ZodMiniObject<{
+                sharePrice: z.ZodMiniObject<{
+                    amount: z.ZodMiniString<string>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    formatted: z.ZodMiniString<string>;
+                }, z.core.$strict>;
+                timestamp: z.ZodMiniISODateTime;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+    }
     /** Schemas for the getEarnVaultPosition operation. */
     namespace getEarnVaultPosition {
         /** Path parameters identifying the Earn vault and account. */
@@ -844,22 +1082,65 @@ export declare namespace schema {
         }, z.core.$strict>;
         /** Query parameters selecting the chain containing the vault. */
         const Query: z.ZodMiniObject<{
+            asOf: z.ZodMiniOptional<z.ZodMiniISODateTime>;
             chainId: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
                 mainnet: "mainnet";
                 testnet: "testnet";
             }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniPipe<z.ZodMiniNumber<unknown>, z.ZodMiniTransform<number, number>>]>, z.ZodMiniNumber<number>>>;
+            include: z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniUnknown>, z.ZodMiniTransform<string[], unknown>>, z.ZodMiniArray<z.ZodMiniEnum<{
+                apy: "apy";
+                rewards: "rewards";
+                "rewards.proof": "rewards.proof";
+            }>>>;
         }, z.core.$strict>;
-        /** Current asset and Earn-share state for one account in one vault. */
         const Response: z.ZodMiniObject<{
             account: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
             assetAllowance: z.ZodMiniString<string>;
             assetBalance: z.ZodMiniString<string>;
             assetToken: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+            chainId: z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                mainnet: "mainnet";
+                testnet: "testnet";
+            }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniPipe<z.ZodMiniNumber<unknown>, z.ZodMiniTransform<number, number>>]>, z.ZodMiniNumber<number>>;
             id: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
             shareAllowance: z.ZodMiniString<string>;
             shareBalance: z.ZodMiniString<string>;
             shareToken: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
             value: z.ZodMiniString<string>;
+            valueToken: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+            apy: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+                breakdown: z.ZodMiniArray<z.ZodMiniObject<{
+                    assetAmount: z.ZodMiniObject<{
+                        baseUnits: z.ZodMiniString<string>;
+                        decimals: z.ZodMiniNumber<number>;
+                        formatted: z.ZodMiniString<string>;
+                    }, z.core.$strict>;
+                    net: z.ZodMiniString<string>;
+                    type: z.ZodMiniEnum<{
+                        base: "base";
+                        boost: "boost";
+                    }>;
+                }, z.core.$strict>>;
+                net: z.ZodMiniString<string>;
+            }, z.core.$strict>>>;
+            asOf: z.ZodMiniOptional<z.ZodMiniISODateTime>;
+            block: z.ZodMiniOptional<z.ZodMiniObject<{
+                number: z.ZodMiniNumber<number>;
+                timestamp: z.ZodMiniISODateTime;
+            }, z.core.$strict>>;
+            rewards: z.ZodMiniOptional<z.ZodMiniObject<{
+                cumulativeEntitlement: z.ZodMiniString<string>;
+                cumulativePaid: z.ZodMiniString<string>;
+                deferral: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                pending: z.ZodMiniString<string>;
+                proof: z.ZodMiniOptional<z.ZodMiniObject<{
+                    cumulativeAmount: z.ZodMiniString<string>;
+                    distributorAddress: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                    proof: z.ZodMiniArray<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+                    rootVersion: z.ZodMiniString<string>;
+                    statementHash: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
         }, z.core.$strict>;
     }
     /** Schemas for the getEarnVaultEarnings operation. */
@@ -888,6 +1169,8 @@ export declare namespace schema {
             currentValue: z.ZodMiniString<string>;
             id: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
             lifetimeEarnings: z.ZodMiniString<string>;
+            totalDeposited: z.ZodMiniString<string>;
+            totalWithdrawn: z.ZodMiniString<string>;
             period: z.ZodMiniLiteral<"lifetime">;
             status: z.ZodMiniLiteral<"complete">;
         }, z.core.$strict>, z.ZodMiniObject<{
@@ -922,34 +1205,24 @@ 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.ZodMiniEnum<{
-                "30d": "30d";
-                lifetime: "lifetime";
-            }>;
+            period: z.ZodMiniLiteral<"30d">;
+            status: z.ZodMiniLiteral<"pending_redemption">;
+        }, 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<"lifetime">;
             status: z.ZodMiniLiteral<"pending_redemption">;
+            totalDeposited: z.ZodMiniString<string>;
+            totalWithdrawn: z.ZodMiniString<string>;
         }, z.core.$strict>]>;
     }
 }
 /** Creates the public Earn-vault handlers. */
 export declare function earn(options?: earn.Options): import("hono/hono-base").HonoBase<App.Environment, {
-    "/v1/earn/vaults": {
-        $get: {
-            output: null;
-            outputFormat: "body";
-            status: 402;
-            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/rewards/eligibility": {
+        $post: {
             output: {
                 error: {
                     code: "api_key_malformed";
@@ -961,16 +1234,12 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             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;
+                json: {
+                    chainId: unknown;
+                    transactionHash?: `0x${string}` | undefined;
+                    vaultAddress: `0x${string}`;
+                    walletAddress: `0x${string}`;
+                };
             };
         } | {
             output: {
@@ -984,16 +1253,12 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             outputFormat: "json";
             status: 401;
             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;
+                json: {
+                    chainId: unknown;
+                    transactionHash?: `0x${string}` | undefined;
+                    vaultAddress: `0x${string}`;
+                    walletAddress: `0x${string}`;
+                };
             };
         } | {
             output: {
@@ -1007,16 +1272,12 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             outputFormat: "json";
             status: 403;
             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;
+                json: {
+                    chainId: unknown;
+                    transactionHash?: `0x${string}` | undefined;
+                    vaultAddress: `0x${string}`;
+                    walletAddress: `0x${string}`;
+                };
             };
         } | {
             output: {
@@ -1030,21 +1291,17 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             outputFormat: "json";
             status: 429;
             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;
+                json: {
+                    chainId: unknown;
+                    transactionHash?: `0x${string}` | undefined;
+                    vaultAddress: `0x${string}`;
+                    walletAddress: `0x${string}`;
+                };
             };
         } | {
             output: {
                 error: {
-                    code: "query_invalid";
+                    code: "body_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
@@ -1053,57 +1310,744 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             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;
+                json: {
+                    chainId: unknown;
+                    transactionHash?: `0x${string}` | undefined;
+                    vaultAddress: `0x${string}`;
+                    walletAddress: `0x${string}`;
+                };
             };
         } | {
             output: {
                 error: {
-                    code: "upstream_error";
+                    code: "chain_id_unsupported";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 502;
+            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;
+                json: {
+                    chainId: unknown;
+                    transactionHash?: `0x${string}` | undefined;
+                    vaultAddress: `0x${string}`;
+                    walletAddress: `0x${string}`;
+                };
             };
         } | {
             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;
+                association: {
+                    chainId: number;
+                    firstRegisteredAt: string;
+                    id: string;
+                    latestRegisteredAt: string;
+                    registrationOrder: string;
+                    transactionHash?: `0x${string}` | undefined;
+                    vaultAddress: `0x${string}`;
+                    walletAddress: `0x${string}`;
+                };
+                created: boolean;
+            };
+            outputFormat: "json";
+            status: 200;
+            input: {
+                json: {
+                    chainId: unknown;
+                    transactionHash?: `0x${string}` | undefined;
+                    vaultAddress: `0x${string}`;
+                    walletAddress: `0x${string}`;
+                };
+            };
+        };
+    };
+} & {
+    "/v1/earn/rewards/eligibility": {
+        $get: {
+            output: {
+                error: {
+                    code: "api_key_malformed";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 400;
+            input: {
+                query: {
+                    chainId: string | string[];
+                    cursor?: string | string[];
+                    limit?: string | string[];
+                    vaultAddress: string | string[];
+                };
+            };
+        } | {
+            output: {
+                error: {
+                    code: "api_key_invalid" | "api_key_missing";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 401;
+            input: {
+                query: {
+                    chainId: string | string[];
+                    cursor?: string | string[];
+                    limit?: string | string[];
+                    vaultAddress: string | string[];
+                };
+            };
+        } | {
+            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: {
+                query: {
+                    chainId: string | string[];
+                    cursor?: string | string[];
+                    limit?: string | string[];
+                    vaultAddress: string | string[];
+                };
+            };
+        } | {
+            output: {
+                error: {
+                    code: "payment_required" | "rate_limit_exceeded";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 429;
+            input: {
+                query: {
+                    chainId: string | string[];
+                    cursor?: string | string[];
+                    limit?: string | string[];
+                    vaultAddress: string | string[];
+                };
+            };
+        } | {
+            output: {
+                error: {
+                    code: "query_invalid";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 400;
+            input: {
+                query: {
+                    chainId: string | string[];
+                    cursor?: string | string[];
+                    limit?: string | string[];
+                    vaultAddress: string | string[];
+                };
+            };
+        } | {
+            output: {
+                chainId: number;
+                data: `0x${string}`[];
+                nextCursor: string | null;
+                vaultAddress: `0x${string}`;
+            };
+            outputFormat: "json";
+            status: 200;
+            input: {
+                query: {
+                    chainId: string | string[];
+                    cursor?: string | string[];
+                    limit?: string | string[];
+                    vaultAddress: string | string[];
+                };
+            };
+        };
+    };
+} & {
+    "/v1/earn/vaults": {
+        $get: {
+            output: null;
+            outputFormat: "body";
+            status: 402;
+            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: {
+                    code: "api_key_malformed";
+                    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: {
+                error: {
+                    code: "api_key_invalid" | "api_key_missing";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 401;
+            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: {
+                    code: "api_key_forbidden" | "api_key_ip_forbidden";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 403;
+            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: {
+                    code: "payment_required" | "rate_limit_exceeded";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 429;
+            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: {
+                    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: {
+                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: {
+                    code: "chain_id_unsupported";
+                    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: {
+                error: {
+                    code: "chain_id_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;
+                        rewards?: {
+                            apr: string | null;
+                            asset: {
+                                address: `0x${string}`;
+                                chainId: number;
+                                decimals: number;
+                            };
+                            calculatedThrough?: number | undefined;
+                            campaignId: string;
+                            endsAt: number;
+                            startsAt: number;
+                            targetTotalApr: string;
+                        }[] | undefined;
+                        vault: 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;
+                    engine: {
+                        address: `0x${string}`;
+                        type: "erc4626" | "veda" | null;
+                        venue: `0x${string}` | null;
+                    };
+                    id: `0x${string}`;
+                    instantLiquidity: string | null;
+                    instantLiquidityValue?: {
+                        amount: string;
+                        currency: string;
+                        decimals: number;
+                        formatted: string;
+                    } | null | undefined;
+                    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;
+                    };
+                    slug: string | null;
+                    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}`;
+                    verified: boolean;
+                    zone?: {
+                        chainId: number;
+                        inputTokens: `0x${string}`[];
+                        name: string;
+                        outputTokens: `0x${string}`[];
+                    } | null | undefined;
+                    zones?: {
+                        chainId: number;
+                        deploymentBlock: number;
+                        earnRouter: `0x${string}`;
+                        inputTokens: `0x${string}`[];
+                        name: string;
+                        outputTokens: `0x${string}`[];
+                    }[] | undefined;
+                }[];
+                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/vaults/verified": {
+        $get: {
+            output: null;
+            outputFormat: "body";
+            status: 402;
+            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: {
+                    code: "api_key_malformed";
+                    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: {
+                error: {
+                    code: "api_key_invalid" | "api_key_missing";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 401;
+            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: {
+                    code: "api_key_forbidden" | "api_key_ip_forbidden";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 403;
+            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: {
+                    code: "payment_required" | "rate_limit_exceeded";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 429;
+            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: {
+                    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: {
+                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: {
+                    code: "chain_id_unsupported";
+                    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: {
+                error: {
+                    code: "chain_id_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;
+                        rewards?: {
+                            apr: string | null;
+                            asset: {
+                                address: `0x${string}`;
+                                chainId: number;
+                                decimals: number;
+                            };
+                            calculatedThrough?: number | undefined;
+                            campaignId: string;
+                            endsAt: number;
+                            startsAt: number;
+                            targetTotalApr: string;
+                        }[] | undefined;
+                        vault: 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;
@@ -1120,13 +2064,14 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                         routerSwaps: boolean;
                     } | undefined;
                     description: string | null;
-                    engine: {
-                        address: `0x${string}`;
-                        type: "erc4626" | "veda" | null;
-                        venue: `0x${string}` | null;
-                    };
                     id: `0x${string}`;
                     instantLiquidity: string | null;
+                    instantLiquidityValue?: {
+                        amount: string;
+                        currency: string;
+                        decimals: number;
+                        formatted: string;
+                    } | null | undefined;
                     label: string;
                     sharePrice: {
                         amount: string;
@@ -1144,7 +2089,6 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                         symbol: string;
                         verified: boolean;
                     };
-                    slug: string | null;
                     state: {
                         depositsPaused: boolean;
                         engineShares: string;
@@ -1161,7 +2105,6 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                         formatted: string;
                     } | null | undefined;
                     vaultAddress: `0x${string}`;
-                    verified: boolean;
                     zone?: {
                         chainId: number;
                         inputTokens: `0x${string}`[];
@@ -1176,6 +2119,13 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                         name: string;
                         outputTokens: `0x${string}`[];
                     }[] | undefined;
+                    engine: {
+                        address: `0x${string}`;
+                        venue: `0x${string}` | null;
+                        type: "erc4626" | "veda";
+                    };
+                    slug: string;
+                    verified: true;
                 }[];
                 meta?: {
                     valuation?: {
@@ -1203,21 +2153,23 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         };
     };
 } & {
-    "/v1/earn/vaults/verified": {
+    "/v1/earn/addresses/:address/positions": {
         $get: {
             output: null;
             outputFormat: "body";
             status: 402;
             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;
             };
         } | {
@@ -1232,90 +2184,173 @@ 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: "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[];
+                    include?: 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[];
+                    include?: 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[];
+                    include?: string | string[];
+                    limit?: string | string[];
+                    'valuation.currency'?: string | string[];
+                    verified?: string | string[];
                 } | undefined;
             };
         } | {
             output: {
                 error: {
-                    code: "api_key_invalid" | "api_key_missing";
+                    code: "query_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 401;
+            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: "api_key_forbidden" | "api_key_ip_forbidden";
+                    code: "upstream_error";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 403;
+            status: 502;
             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: "payment_required" | "rate_limit_exceeded";
+                    code: "chain_id_unsupported";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 429;
+            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: "query_invalid";
+                    code: "chain_id_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
@@ -1324,52 +2359,53 @@ 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;
@@ -1380,26 +2416,21 @@ 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;
+                    chainId: number;
                     id: `0x${string}`;
-                    instantLiquidity: string | null;
-                    label: string;
-                    sharePrice: {
+                    lifetimeCashFlows?: {
+                        status: "complete";
+                        totalDeposited: string;
+                        totalWithdrawn: string;
+                    } | {
+                        status: "incomplete_history";
+                    } | undefined;
+                    shareAmount: {
                         amount: string;
                         currency: string;
                         decimals: number;
                         formatted: string;
-                    } | null;
+                    };
                     shareToken: {
                         address: `0x${string}`;
                         currency: string;
@@ -1410,43 +2441,22 @@ 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;
-                    zones?: {
-                        chainId: number;
-                        deploymentBlock: number;
-                        earnRouter: `0x${string}`;
-                        inputTokens: `0x${string}`[];
-                        name: string;
-                        outputTokens: `0x${string}`[];
-                    }[] | undefined;
-                    engine: {
+                    valueToken: {
                         address: `0x${string}`;
-                        venue: `0x${string}` | null;
-                        type: "erc4626" | "veda";
+                        currency: string;
+                        decimals: number;
+                        id: string;
+                        logoUri?: string | undefined;
+                        name: string;
+                        symbol: string;
+                        verified: boolean;
                     };
-                    slug: string;
-                    verified: true;
+                    vaultAddress: `0x${string}`;
+                    verified: boolean;
                 }[];
                 meta?: {
                     valuation?: {
@@ -1460,37 +2470,38 @@ 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;
             };
         };
     };
 } & {
-    "/v1/earn/addresses/:address/positions": {
+    "/v1/earn/vaults/:vaultId/share-prices": {
         $get: {
             output: null;
             outputFormat: "body";
             status: 402;
             input: {
                 param: {
-                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
                 };
             } & {
-                query?: {
+                query: {
                     chainId?: string | string[];
-                    cursor?: string | string[];
-                    limit?: string | string[];
-                    'valuation.currency'?: string | string[];
-                    verified?: string | string[];
-                } | undefined;
+                    from: string | string[];
+                    interval?: string | string[];
+                    to: string | string[];
+                };
             };
         } | {
             output: {
@@ -1505,16 +2516,15 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             status: 400;
             input: {
                 param: {
-                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
                 };
             } & {
-                query?: {
+                query: {
                     chainId?: string | string[];
-                    cursor?: string | string[];
-                    limit?: string | string[];
-                    'valuation.currency'?: string | string[];
-                    verified?: string | string[];
-                } | undefined;
+                    from: string | string[];
+                    interval?: string | string[];
+                    to: string | string[];
+                };
             };
         } | {
             output: {
@@ -1529,16 +2539,15 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             status: 401;
             input: {
                 param: {
-                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
                 };
             } & {
-                query?: {
+                query: {
                     chainId?: string | string[];
-                    cursor?: string | string[];
-                    limit?: string | string[];
-                    'valuation.currency'?: string | string[];
-                    verified?: string | string[];
-                } | undefined;
+                    from: string | string[];
+                    interval?: string | string[];
+                    to: string | string[];
+                };
             };
         } | {
             output: {
@@ -1553,16 +2562,15 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             status: 403;
             input: {
                 param: {
-                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
                 };
             } & {
-                query?: {
+                query: {
                     chainId?: string | string[];
-                    cursor?: string | string[];
-                    limit?: string | string[];
-                    'valuation.currency'?: string | string[];
-                    verified?: string | string[];
-                } | undefined;
+                    from: string | string[];
+                    interval?: string | string[];
+                    to: string | string[];
+                };
             };
         } | {
             output: {
@@ -1577,16 +2585,15 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             status: 429;
             input: {
                 param: {
-                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
                 };
             } & {
-                query?: {
+                query: {
                     chainId?: string | string[];
-                    cursor?: string | string[];
-                    limit?: string | string[];
-                    'valuation.currency'?: string | string[];
-                    verified?: string | string[];
-                } | undefined;
+                    from: string | string[];
+                    interval?: string | string[];
+                    to: string | string[];
+                };
             };
         } | {
             output: {
@@ -1601,16 +2608,15 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             status: 400;
             input: {
                 param: {
-                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
                 };
             } & {
-                query?: {
+                query: {
                     chainId?: string | string[];
-                    cursor?: string | string[];
-                    limit?: string | string[];
-                    'valuation.currency'?: string | string[];
-                    verified?: string | string[];
-                } | undefined;
+                    from: string | string[];
+                    interval?: string | string[];
+                    to: string | string[];
+                };
             };
         } | {
             output: {
@@ -1625,16 +2631,15 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             status: 502;
             input: {
                 param: {
-                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
                 };
             } & {
-                query?: {
+                query: {
                     chainId?: string | string[];
-                    cursor?: string | string[];
-                    limit?: string | string[];
-                    'valuation.currency'?: string | string[];
-                    verified?: string | string[];
-                } | undefined;
+                    from: string | string[];
+                    interval?: string | string[];
+                    to: string | string[];
+                };
             };
         } | {
             output: {
@@ -1649,16 +2654,15 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             status: 400;
             input: {
                 param: {
-                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
                 };
             } & {
-                query?: {
+                query: {
                     chainId?: string | string[];
-                    cursor?: string | string[];
-                    limit?: string | string[];
-                    'valuation.currency'?: string | string[];
-                    verified?: string | string[];
-                } | undefined;
+                    from: string | string[];
+                    interval?: string | string[];
+                    to: string | string[];
+                };
             };
         } | {
             output: {
@@ -1673,107 +2677,87 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
             status: 400;
             input: {
                 param: {
-                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
                 };
             } & {
-                query?: {
+                query: {
                     chainId?: string | string[];
-                    cursor?: string | string[];
-                    limit?: string | string[];
-                    'valuation.currency'?: string | string[];
-                    verified?: string | string[];
-                } | undefined;
+                    from: string | string[];
+                    interval?: string | string[];
+                    to: string | string[];
+                };
+            };
+        } | {
+            output: {
+                error: {
+                    code: "vault_id_invalid";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 400;
+            input: {
+                param: {
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query: {
+                    chainId?: string | string[];
+                    from: string | string[];
+                    interval?: string | string[];
+                    to: string | string[];
+                };
             };
         } | {
             output: {
                 error: {
-                    code: "positions_invalid";
+                    code: "earn_vault_not_found";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400;
+            status: 404;
             input: {
                 param: {
-                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
                 };
             } & {
-                query?: {
+                query: {
                     chainId?: string | string[];
-                    cursor?: string | string[];
-                    limit?: string | string[];
-                    'valuation.currency'?: string | string[];
-                    verified?: string | string[];
-                } | undefined;
+                    from: string | string[];
+                    interval?: string | string[];
+                    to: string | string[];
+                };
             };
         } | {
             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: {
+                    sharePrice: {
                         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;
+                    timestamp: string;
                 }[];
-                meta?: {
-                    valuation?: {
-                        asOf: string;
-                        basis: "nominal";
-                        source: string;
-                    } | undefined;
-                } | undefined;
-                nextCursor: string | null;
             };
             outputFormat: "json";
             status: 200;
             input: {
                 param: {
-                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
                 };
             } & {
-                query?: {
+                query: {
                     chainId?: string | string[];
-                    cursor?: string | string[];
-                    limit?: string | string[];
-                    'valuation.currency'?: string | string[];
-                    verified?: string | string[];
-                } | undefined;
+                    from: string | string[];
+                    interval?: string | string[];
+                    to: string | string[];
+                };
             };
         };
     };
@@ -1790,7 +2774,9 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                 };
             } & {
                 query?: {
+                    asOf?: string | string[];
                     chainId?: string | string[];
+                    include?: string | string[];
                 } | undefined;
             };
         } | {
@@ -1811,7 +2797,9 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                 };
             } & {
                 query?: {
+                    asOf?: string | string[];
                     chainId?: string | string[];
+                    include?: string | string[];
                 } | undefined;
             };
         } | {
@@ -1832,7 +2820,9 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                 };
             } & {
                 query?: {
+                    asOf?: string | string[];
                     chainId?: string | string[];
+                    include?: string | string[];
                 } | undefined;
             };
         } | {
@@ -1853,7 +2843,9 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                 };
             } & {
                 query?: {
+                    asOf?: string | string[];
                     chainId?: string | string[];
+                    include?: string | string[];
                 } | undefined;
             };
         } | {
@@ -1874,7 +2866,9 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                 };
             } & {
                 query?: {
+                    asOf?: string | string[];
                     chainId?: string | string[];
+                    include?: string | string[];
                 } | undefined;
             };
         } | {
@@ -1895,7 +2889,9 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                 };
             } & {
                 query?: {
+                    asOf?: string | string[];
                     chainId?: string | string[];
+                    include?: string | string[];
                 } | undefined;
             };
         } | {
@@ -1916,7 +2912,9 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                 };
             } & {
                 query?: {
+                    asOf?: string | string[];
                     chainId?: string | string[];
+                    include?: string | string[];
                 } | undefined;
             };
         } | {
@@ -1937,7 +2935,9 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                 };
             } & {
                 query?: {
+                    asOf?: string | string[];
                     chainId?: string | string[];
+                    include?: string | string[];
                 } | undefined;
             };
         } | {
@@ -1958,20 +2958,22 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                 };
             } & {
                 query?: {
+                    asOf?: string | string[];
                     chainId?: string | string[];
+                    include?: string | string[];
                 } | undefined;
             };
         } | {
             output: {
                 error: {
-                    code: "position_invalid";
+                    code: "earn_vault_not_found";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400;
+            status: 404;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -1979,23 +2981,22 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                 };
             } & {
                 query?: {
+                    asOf?: string | string[];
                     chainId?: string | string[];
+                    include?: string | string[];
                 } | undefined;
             };
         } | {
             output: {
-                account: `0x${string}`;
-                assetAllowance: string;
-                assetBalance: string;
-                assetToken: `0x${string}`;
-                id: `0x${string}`;
-                shareAllowance: string;
-                shareBalance: string;
-                shareToken: `0x${string}`;
-                value: string;
+                error: {
+                    code: "position_invalid";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
             };
             outputFormat: "json";
-            status: 200;
+            status: 400;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -2003,20 +3004,57 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                 };
             } & {
                 query?: {
+                    asOf?: string | string[];
                     chainId?: string | string[];
+                    include?: string | string[];
                 } | undefined;
             };
         } | {
             output: {
-                error: {
-                    code: "earn_vault_not_found";
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
-                };
-                requestId: string;
+                account: `0x${string}`;
+                assetAllowance: string;
+                assetBalance: string;
+                assetToken: `0x${string}`;
+                chainId: number;
+                id: `0x${string}`;
+                shareAllowance: string;
+                shareBalance: string;
+                shareToken: `0x${string}`;
+                value: string;
+                valueToken: `0x${string}`;
+                apy?: {
+                    breakdown: {
+                        assetAmount: {
+                            baseUnits: string;
+                            decimals: number;
+                            formatted: string;
+                        };
+                        net: string;
+                        type: "base" | "boost";
+                    }[];
+                    net: string;
+                } | null | undefined;
+                asOf?: string | undefined;
+                block?: {
+                    number: number;
+                    timestamp: string;
+                } | undefined;
+                rewards?: {
+                    cumulativeEntitlement: string;
+                    cumulativePaid: string;
+                    deferral?: string | undefined;
+                    pending: string;
+                    proof?: {
+                        cumulativeAmount: string;
+                        distributorAddress: `0x${string}`;
+                        proof: `0x${string}`[];
+                        rootVersion: string;
+                        statementHash: `0x${string}`;
+                    } | undefined;
+                } | undefined;
             };
             outputFormat: "json";
-            status: 404;
+            status: 200;
             input: {
                 param: {
                     address: `0x${string}`;
@@ -2024,7 +3062,9 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                 };
             } & {
                 query?: {
+                    asOf?: string | string[];
                     chainId?: string | string[];
+                    include?: string | string[];
                 } | undefined;
             };
         };
@@ -2273,6 +3313,8 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                 currentValue: string;
                 id: `0x${string}`;
                 lifetimeEarnings: string;
+                totalDeposited: string;
+                totalWithdrawn: string;
                 period: "lifetime";
                 status: "complete";
             } | {
@@ -2303,8 +3345,17 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                 assetToken: `0x${string}`;
                 currentValue: string;
                 id: `0x${string}`;
-                period: "30d" | "lifetime";
+                period: "30d";
+                status: "pending_redemption";
+            } | {
+                account: `0x${string}`;
+                assetToken: `0x${string}`;
+                currentValue: string;
+                id: `0x${string}`;
+                period: "lifetime";
                 status: "pending_redemption";
+                totalDeposited: string;
+                totalWithdrawn: string;
             };
             outputFormat: "json";
             status: 200;
@@ -2473,14 +3524,36 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
         } | {
             output: {
                 error: {
-                    code: "earn_vault_not_found";
+                    code: "chain_id_unsupported";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 404;
+            status: 400;
+            input: {
+                param: {
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: string | string[];
+                    'apy.window'?: 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: {
                     vaultId: `0x${string}`;
@@ -2514,6 +3587,28 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                     'apy.window'?: string | string[];
                 } | undefined;
             };
+        } | {
+            output: {
+                error: {
+                    code: "earn_vault_not_found";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 404;
+            input: {
+                param: {
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: string | string[];
+                    'apy.window'?: string | string[];
+                } | undefined;
+            };
         } | {
             output: {
                 access?: {
@@ -2523,6 +3618,20 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                     asOf: string;
                     methodology: "share-price-growth-annualized:v1";
                     net: string;
+                    rewards?: {
+                        apr: string | null;
+                        asset: {
+                            address: `0x${string}`;
+                            chainId: number;
+                            decimals: number;
+                        };
+                        calculatedThrough?: number | undefined;
+                        campaignId: string;
+                        endsAt: number;
+                        startsAt: number;
+                        targetTotalApr: string;
+                    }[] | undefined;
+                    vault: string;
                     window: "1d" | "1h" | "30d" | "7d";
                 } | null | undefined;
                 assetToken: {
@@ -2553,6 +3662,12 @@ export declare function earn(options?: earn.Options): import("hono/hono-base").H
                 };
                 id: `0x${string}`;
                 instantLiquidity: string | null;
+                instantLiquidityValue?: {
+                    amount: string;
+                    currency: string;
+                    decimals: number;
+                    formatted: string;
+                } | null | undefined;
                 label: string;
                 sharePrice: {
                     amount: string;
@@ -2662,6 +3777,8 @@ export declare function getVaultEarnings(c: Context<App.Environment>, options: g
     currentValue: string;
     id: `0x${string}`;
     period: "lifetime";
+    totalDeposited: string;
+    totalWithdrawn: string;
     status: 'pending_redemption';
 } | {
     account: `0x${string}`;
@@ -2669,6 +3786,8 @@ export declare function getVaultEarnings(c: Context<App.Environment>, options: g
     currentValue: string;
     id: `0x${string}`;
     period: "lifetime";
+    totalDeposited: string;
+    totalWithdrawn: string;
     lifetimeEarnings: string;
     status: 'complete';
 } | {
@@ -2722,6 +3841,20 @@ export declare namespace getVaultEarnings {
         vault: z.output<typeof Schema.Address>;
     };
 }
+/** Decodes the indexed head and historical position boundary from TIDX rows. */
+export declare function parseIndexedBlockAtOrBefore(options: parseIndexedBlockAtOrBefore.Options): {
+    number: number;
+    timestamp: string;
+};
+export declare namespace parseIndexedBlockAtOrBefore {
+    /** Inputs returned by the historical boundary query. */
+    type Options = {
+        /** Requested historical observation timestamp. */
+        asOf: string;
+        /** Indexed head and optional boundary rows. */
+        rows: readonly Record<string, unknown>[];
+    };
+}
 /** Calculates the asset cost basis attached to an account's remaining Earn shares. */
 export declare function calculateActiveCostBasis(options: calculateActiveCostBasis.Options): bigint | undefined;
 export declare namespace calculateActiveCostBasis {
@@ -2776,6 +3909,20 @@ export declare function listVaults(c: Context<App.Environment>, options: listVau
             asOf: string;
             methodology: "share-price-growth-annualized:v1";
             net: string;
+            rewards?: {
+                apr: string | null;
+                asset: {
+                    address: `0x${string}`;
+                    chainId: number;
+                    decimals: number;
+                };
+                calculatedThrough?: number | undefined;
+                campaignId: string;
+                endsAt: number;
+                startsAt: number;
+                targetTotalApr: string;
+            }[] | undefined;
+            vault: string;
             window: "1d" | "1h" | "30d" | "7d";
         } | null | undefined;
         assetToken: {
@@ -2806,6 +3953,12 @@ export declare function listVaults(c: Context<App.Environment>, options: listVau
         };
         id: `0x${string}`;
         instantLiquidity: string | null;
+        instantLiquidityValue?: {
+            amount: string;
+            currency: string;
+            decimals: number;
+            formatted: string;
+        } | null | undefined;
         label: string;
         sharePrice: {
             amount: string;
@@ -2892,6 +4045,20 @@ export declare function listVerifiedVaults(c: Context<App.Environment>, options:
             asOf: string;
             methodology: "share-price-growth-annualized:v1";
             net: string;
+            rewards?: {
+                apr: string | null;
+                asset: {
+                    address: `0x${string}`;
+                    chainId: number;
+                    decimals: number;
+                };
+                calculatedThrough?: number | undefined;
+                campaignId: string;
+                endsAt: number;
+                startsAt: number;
+                targetTotalApr: string;
+            }[] | undefined;
+            vault: string;
             window: "1d" | "1h" | "30d" | "7d";
         } | null | undefined;
         assetToken: {
@@ -2917,6 +4084,12 @@ export declare function listVerifiedVaults(c: Context<App.Environment>, options:
         description: string | null;
         id: `0x${string}`;
         instantLiquidity: string | null;
+        instantLiquidityValue?: {
+            amount: string;
+            currency: string;
+            decimals: number;
+            formatted: string;
+        } | null | undefined;
         label: string;
         sharePrice: {
             amount: string;
@@ -2995,6 +4168,68 @@ export declare namespace listVerifiedVaults {
         oracle: FxOracle.Oracle;
     };
 }
+/** Reads daily historical share prices for one Earn vault. */
+export declare function getVaultSharePrices(c: Context<App.Environment>, options: getVaultSharePrices.Options): Promise<{
+    sharePrice: {
+        amount: string;
+        currency: string;
+        decimals: number;
+        formatted: string;
+    };
+    timestamp: string;
+}[]>;
+/** Classifies an Earn share-price dependency failure for request metrics. */
+export declare function sharePriceProviderFailure(options: sharePriceProviderFailure.Options): Log.ProviderFailure | undefined;
+export declare namespace sharePriceProviderFailure {
+    /** Failure and chain used to derive bounded dependency metadata. */
+    type Options = {
+        /** Chain whose dependency call failed. */
+        chainId: number;
+        /** Error returned by TIDX parsing or the RPC client. */
+        cause: unknown;
+    };
+}
+export declare namespace getVaultSharePrices {
+    /** Inputs selecting one Earn vault share-price series. */
+    type Options = z.output<typeof schema.getEarnVaultSharePrices.Query> & {
+        /** Chain containing the Earn vault. */
+        chainId: z.output<typeof Schema.ChainId>;
+        /** Current compatible vault and token metadata. */
+        discovery: EarnVaults.Discovery;
+        /** Earn vault contract address. */
+        vault: z.output<typeof Schema.Address>;
+    };
+}
+/** Reads one direct or Zone-routed account position in a parent-chain Earn vault. */
+export declare function getVaultPosition(c: Context<App.Environment>, options: getVaultPosition.Options): Promise<getVaultPosition.ReturnType>;
+export declare namespace getVaultPosition {
+    /** Inputs selecting one direct or Zone-routed account position. */
+    type Options = {
+        account: z.output<typeof Schema.Address>;
+        asOf?: string | undefined;
+        chainId: z.output<typeof Schema.ChainId>;
+        vault: z.output<typeof Schema.Address>;
+    };
+    /** Normalized position state across a direct chain or private Zone. */
+    type ReturnType = Actions.earn.getPosition.ReturnValue & {
+        block?: {
+            number: number;
+            timestamp: string;
+        } | undefined;
+        valueToken: z.output<typeof Schema.Address>;
+    };
+}
+/** Caps a Zone-reported parent checkpoint at the L1 portal's verified watermark. */
+export declare function alignZoneSourceBlock(options: alignZoneSourceBlock.Options): bigint;
+export declare namespace alignZoneSourceBlock {
+    /** Zone-reported and L1-verified parent checkpoints. */
+    type Options = {
+        /** Parent checkpoint reported by the Zone, when available. */
+        reported?: bigint | undefined;
+        /** Latest parent checkpoint verified by the L1 portal. */
+        verified: bigint;
+    };
+}
 /** 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: {
@@ -3014,7 +4249,15 @@ export declare function listPositions(c: Context<App.Environment>, options: list
             symbol: string;
             verified: boolean;
         };
+        chainId: number;
         id: `0x${string}`;
+        lifetimeCashFlows?: {
+            status: "complete";
+            totalDeposited: string;
+            totalWithdrawn: string;
+        } | {
+            status: "incomplete_history";
+        };
         shareAmount: {
             amount: string;
             currency: string;
@@ -3035,6 +4278,16 @@ export declare function listPositions(c: Context<App.Environment>, options: list
             amount: string;
             currency: string;
         } | null;
+        valueToken: {
+            address: `0x${string}`;
+            currency: string;
+            decimals: number;
+            id: string;
+            logoUri?: string | undefined;
+            name: string;
+            symbol: string;
+            verified: boolean;
+        };
         vaultAddress: `0x${string}`;
         verified: boolean;
     }[];
@@ -3050,7 +4303,7 @@ export declare function listPositions(c: Context<App.Environment>, options: list
 export declare namespace listPositions {
     /** One candidate vault holding a non-zero position. */
     type Match = {
-        position: Actions.earn.getPosition.ReturnValue;
+        position: getVaultPosition.ReturnType;
         record?: RegistryRecord | undefined;
         vaultAddress: string;
     };
@@ -3063,6 +4316,18 @@ export declare namespace listPositions {
         oracle: FxOracle.Oracle;
     };
 }
+/** Reads complete protocol cash flows for one account and a set of vaults. */
+export declare function getVaultLifetimeCashFlows(tidx: Tidx.Client, options: getVaultLifetimeCashFlows.Options): Promise<Map<string, getVaultLifetimeCashFlows.CashFlows>>;
+export declare namespace getVaultLifetimeCashFlows {
+    /** Lifetime cash-flow state for one vault. */
+    type CashFlows = NonNullable<z.output<typeof schema.getEarnAddressPositions.Response>['data'][number]['lifetimeCashFlows']>;
+    /** Indexed boundary and account whose protocol cash flows are read. */
+    type Options = {
+        account: z.output<typeof Schema.Address>;
+        blockNumber: number;
+        vaults: readonly z.output<typeof Schema.Address>[];
+    };
+}
 /** Gets one compatible Earn vault. */
 export declare function getVault(c: Context<App.Environment>, options: getVault.Options): Promise<{
     access?: {
@@ -3072,6 +4337,20 @@ export declare function getVault(c: Context<App.Environment>, options: getVault.
         asOf: string;
         methodology: "share-price-growth-annualized:v1";
         net: string;
+        rewards?: {
+            apr: string | null;
+            asset: {
+                address: `0x${string}`;
+                chainId: number;
+                decimals: number;
+            };
+            calculatedThrough?: number | undefined;
+            campaignId: string;
+            endsAt: number;
+            startsAt: number;
+            targetTotalApr: string;
+        }[] | undefined;
+        vault: string;
         window: "1d" | "1h" | "30d" | "7d";
     } | null | undefined;
     assetToken: {
@@ -3102,6 +4381,12 @@ export declare function getVault(c: Context<App.Environment>, options: getVault.
     };
     id: `0x${string}`;
     instantLiquidity: string | null;
+    instantLiquidityValue?: {
+        amount: string;
+        currency: string;
+        decimals: number;
+        formatted: string;
+    } | null | undefined;
     label: string;
     sharePrice: {
         amount: string;
@@ -3186,8 +4471,12 @@ export declare namespace serializeVault {
         discovery: EarnVaults.Discovery;
         /** Optional vault fields selected by the request. */
         include: z.output<typeof schema.getEarnVault.Query>['include'];
+        /** USD value of instant liquidity, or null when unavailable; omitted unless `include` carries `tvl`. */
+        instantLiquidityValue: z.output<typeof schema.Vault>['instantLiquidityValue'];
         /** Curated registry row, when verified. */
         record?: core_EarnVaults.Record | undefined;
+        /** Enabled, registered Merkle rewards, or undefined when enrichment is unavailable. */
+        rewards?: readonly RewardRead.Reward[] | undefined;
         /** Resolved share token. */
         shareToken: z.output<typeof Tokens.schema.Token>;
         /** USD value of the assets, or null when unpriced; omitted unless `include` carries `tvl`. */