tapimo 0.7.0 → 0.7.2

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

@@ -0,0 +1,2144 @@
+import { type Context } from 'hono';
+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 * as Response from '../../../internal/Response.js';
+import * as Schema from '../../../internal/Schema.js';
+import * as FxOracle from '../FxOracle.js';
+import * as Tokens from './tokens.js';
+import * as Valuation from './valuation.js';
+/** Returns the smallest useful live-discovery batch. */
+export declare function discoveryBatchLimit(options: discoveryBatchLimit.Options): number;
+export declare namespace discoveryBatchLimit {
+    /** Inputs controlling one discovery batch. */
+    type Options = {
+        /** Whether filters can reject resolved candidates. */
+        filtered: boolean;
+        /** Requested response page size. */
+        limit: number;
+        /** Compatible matches already collected. */
+        matches: number;
+        /** Candidates remaining within the scan bound. */
+        remaining: number;
+    };
+}
+/** Zod schemas owned by the public Earn-vault resource. */
+export declare namespace schema {
+    /** One compatible Earn vault resolved from current chain state. */
+    const Vault: z.ZodMiniObject<{
+        access: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+            status: z.ZodMiniEnum<{
+                allowlisted: "allowlisted";
+                open: "open";
+            }>;
+        }, z.core.$strict>>>;
+        apy: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+            asOf: z.ZodMiniISODateTime;
+            methodology: z.ZodMiniLiteral<"share-price-growth-annualized:v1">;
+            net: z.ZodMiniString<string>;
+            window: z.ZodMiniEnum<{
+                "1d": "1d";
+                "1h": "1h";
+                "30d": "30d";
+                "7d": "7d";
+            }>;
+        }, z.core.$strict>>>;
+        assetToken: z.ZodMiniObject<{
+            address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            id: z.ZodMiniString<string>;
+            logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            name: z.ZodMiniString<string>;
+            symbol: z.ZodMiniString<string>;
+            verified: z.ZodMiniBoolean<boolean>;
+        }, z.core.$strip>;
+        capabilities: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+            asyncRedeem: z.ZodMiniBoolean<boolean>;
+            boundedRedeem: z.ZodMiniBoolean<boolean>;
+            deposit: z.ZodMiniBoolean<boolean>;
+            exactWithdraw: z.ZodMiniBoolean<boolean>;
+            inKindDeposit: z.ZodMiniBoolean<boolean>;
+            privateRouting: z.ZodMiniBoolean<boolean>;
+            redeem: z.ZodMiniBoolean<boolean>;
+            routerSwaps: z.ZodMiniBoolean<boolean>;
+        }, z.core.$strict>>>;
+        description: z.ZodMiniNullable<z.ZodMiniString<string>>;
+        engine: z.ZodMiniObject<{
+            address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+            type: z.ZodMiniNullable<z.ZodMiniEnum<{
+                erc4626: "erc4626";
+                veda: "veda";
+            }>>;
+            venue: z.ZodMiniNullable<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+        }, z.core.$strict>;
+        id: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+        instantLiquidity: z.ZodMiniNullable<z.ZodMiniString<string>>;
+        label: z.ZodMiniString<string>;
+        sharePrice: z.ZodMiniNullable<z.ZodMiniObject<{
+            amount: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strict>>;
+        shareToken: z.ZodMiniObject<{
+            address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            id: z.ZodMiniString<string>;
+            logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            name: z.ZodMiniString<string>;
+            symbol: z.ZodMiniString<string>;
+            verified: z.ZodMiniBoolean<boolean>;
+        }, z.core.$strip>;
+        slug: z.ZodMiniNullable<z.ZodMiniString<string>>;
+        state: z.ZodMiniObject<{
+            depositsPaused: z.ZodMiniBoolean<boolean>;
+            engineShares: z.ZodMiniString<string>;
+            feesActive: z.ZodMiniBoolean<boolean>;
+            isAccountingAligned: z.ZodMiniBoolean<boolean>;
+            openRedeemRequestCount: z.ZodMiniNumber<number>;
+            totalAssets: z.ZodMiniString<string>;
+            totalEarnShares: z.ZodMiniString<string>;
+        }, z.core.$strict>;
+        tvl: 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>>>;
+        vaultAddress: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+        verified: z.ZodMiniBoolean<boolean>;
+        zone: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+            chainId: z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                mainnet: "mainnet";
+                testnet: "testnet";
+            }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniNumber<unknown>]>, z.ZodMiniNumber<number>>;
+            inputTokens: z.ZodMiniArray<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+            name: z.ZodMiniString<string>;
+            outputTokens: z.ZodMiniArray<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    /** One registry-curated Earn vault. */
+    const VerifiedVault: z.ZodMiniObject<{
+        access: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+            status: z.ZodMiniEnum<{
+                allowlisted: "allowlisted";
+                open: "open";
+            }>;
+        }, z.core.$strict>>>;
+        apy: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+            asOf: z.ZodMiniISODateTime;
+            methodology: z.ZodMiniLiteral<"share-price-growth-annualized:v1">;
+            net: z.ZodMiniString<string>;
+            window: z.ZodMiniEnum<{
+                "1d": "1d";
+                "1h": "1h";
+                "30d": "30d";
+                "7d": "7d";
+            }>;
+        }, z.core.$strict>>>;
+        assetToken: z.ZodMiniObject<{
+            address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            id: z.ZodMiniString<string>;
+            logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            name: z.ZodMiniString<string>;
+            symbol: z.ZodMiniString<string>;
+            verified: z.ZodMiniBoolean<boolean>;
+        }, z.core.$strip>;
+        capabilities: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+            asyncRedeem: z.ZodMiniBoolean<boolean>;
+            boundedRedeem: z.ZodMiniBoolean<boolean>;
+            deposit: z.ZodMiniBoolean<boolean>;
+            exactWithdraw: z.ZodMiniBoolean<boolean>;
+            inKindDeposit: z.ZodMiniBoolean<boolean>;
+            privateRouting: z.ZodMiniBoolean<boolean>;
+            redeem: z.ZodMiniBoolean<boolean>;
+            routerSwaps: z.ZodMiniBoolean<boolean>;
+        }, z.core.$strict>>>;
+        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>>;
+        label: z.ZodMiniString<string>;
+        sharePrice: z.ZodMiniNullable<z.ZodMiniObject<{
+            amount: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strict>>;
+        shareToken: z.ZodMiniObject<{
+            address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            id: z.ZodMiniString<string>;
+            logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            name: z.ZodMiniString<string>;
+            symbol: z.ZodMiniString<string>;
+            verified: z.ZodMiniBoolean<boolean>;
+        }, z.core.$strip>;
+        state: z.ZodMiniObject<{
+            depositsPaused: z.ZodMiniBoolean<boolean>;
+            engineShares: z.ZodMiniString<string>;
+            feesActive: z.ZodMiniBoolean<boolean>;
+            isAccountingAligned: z.ZodMiniBoolean<boolean>;
+            openRedeemRequestCount: z.ZodMiniNumber<number>;
+            totalAssets: z.ZodMiniString<string>;
+            totalEarnShares: z.ZodMiniString<string>;
+        }, z.core.$strict>;
+        tvl: 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>>>;
+        vaultAddress: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+        zone: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+            chainId: z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                mainnet: "mainnet";
+                testnet: "testnet";
+            }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniNumber<unknown>]>, z.ZodMiniNumber<number>>;
+            inputTokens: z.ZodMiniArray<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+            name: z.ZodMiniString<string>;
+            outputTokens: z.ZodMiniArray<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+        }, z.core.$strict>>>;
+        engine: z.ZodMiniObject<{
+            address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+            venue: z.ZodMiniNullable<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+            type: z.ZodMiniEnum<{
+                erc4626: "erc4626";
+                veda: "veda";
+            }>;
+        }, z.core.$strict>;
+        slug: z.ZodMiniString<string>;
+        verified: z.ZodMiniLiteral<true>;
+    }, z.core.$strict>;
+    /** Schemas for the getEarnVaults operation. */
+    namespace getEarnVaults {
+        /** Query parameters for all compatible deployed Earn vaults. */
+        const Query: z.ZodMiniObject<{
+            asset: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+            capability: z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniUnknown>, z.ZodMiniTransform<string[], unknown>>, z.ZodMiniArray<z.ZodMiniEnum<{
+                asyncRedeem: "asyncRedeem";
+                boundedRedeem: "boundedRedeem";
+                deposit: "deposit";
+                exactWithdraw: "exactWithdraw";
+                inKindDeposit: "inKindDeposit";
+                privateRouting: "privateRouting";
+                redeem: "redeem";
+                routerSwaps: "routerSwaps";
+            }>>>;
+            chainId: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                mainnet: "mainnet";
+                testnet: "testnet";
+            }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniNumber<unknown>]>, z.ZodMiniNumber<number>>>;
+            cursor: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            'engine.type': z.ZodMiniOptional<z.ZodMiniEnum<{
+                erc4626: "erc4626";
+                veda: "veda";
+            }>>;
+            include: z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniUnknown>, z.ZodMiniTransform<string[], unknown>>, z.ZodMiniArray<z.ZodMiniEnum<{
+                access: "access";
+                apy: "apy";
+                capabilities: "capabilities";
+                "token.logoUri": "token.logoUri";
+                tvl: "tvl";
+                zone: "zone";
+            }>>>;
+            limit: z.ZodMiniDefault<z.ZodMiniNumber<unknown>>;
+            'apy.window': z.ZodMiniOptional<z.ZodMiniEnum<{
+                "1d": "1d";
+                "1h": "1h";
+                "30d": "30d";
+                "7d": "7d";
+            }>>;
+        }, z.core.$strict>;
+        /** Paginated list of compatible deployed Earn vaults. */
+        const Response: z.ZodMiniObject<{
+            data: z.ZodMiniArray<z.ZodMiniObject<{
+                access: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+                    status: z.ZodMiniEnum<{
+                        allowlisted: "allowlisted";
+                        open: "open";
+                    }>;
+                }, z.core.$strict>>>;
+                apy: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+                    asOf: z.ZodMiniISODateTime;
+                    methodology: z.ZodMiniLiteral<"share-price-growth-annualized:v1">;
+                    net: z.ZodMiniString<string>;
+                    window: z.ZodMiniEnum<{
+                        "1d": "1d";
+                        "1h": "1h";
+                        "30d": "30d";
+                        "7d": "7d";
+                    }>;
+                }, z.core.$strict>>>;
+                assetToken: z.ZodMiniObject<{
+                    address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    id: z.ZodMiniString<string>;
+                    logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                    name: z.ZodMiniString<string>;
+                    symbol: z.ZodMiniString<string>;
+                    verified: z.ZodMiniBoolean<boolean>;
+                }, z.core.$strip>;
+                capabilities: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+                    asyncRedeem: z.ZodMiniBoolean<boolean>;
+                    boundedRedeem: z.ZodMiniBoolean<boolean>;
+                    deposit: z.ZodMiniBoolean<boolean>;
+                    exactWithdraw: z.ZodMiniBoolean<boolean>;
+                    inKindDeposit: z.ZodMiniBoolean<boolean>;
+                    privateRouting: z.ZodMiniBoolean<boolean>;
+                    redeem: z.ZodMiniBoolean<boolean>;
+                    routerSwaps: z.ZodMiniBoolean<boolean>;
+                }, z.core.$strict>>>;
+                description: z.ZodMiniNullable<z.ZodMiniString<string>>;
+                engine: z.ZodMiniObject<{
+                    address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                    type: z.ZodMiniNullable<z.ZodMiniEnum<{
+                        erc4626: "erc4626";
+                        veda: "veda";
+                    }>>;
+                    venue: z.ZodMiniNullable<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+                }, z.core.$strict>;
+                id: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                instantLiquidity: z.ZodMiniNullable<z.ZodMiniString<string>>;
+                label: z.ZodMiniString<string>;
+                sharePrice: z.ZodMiniNullable<z.ZodMiniObject<{
+                    amount: z.ZodMiniString<string>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    formatted: z.ZodMiniString<string>;
+                }, z.core.$strict>>;
+                shareToken: z.ZodMiniObject<{
+                    address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    id: z.ZodMiniString<string>;
+                    logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                    name: z.ZodMiniString<string>;
+                    symbol: z.ZodMiniString<string>;
+                    verified: z.ZodMiniBoolean<boolean>;
+                }, z.core.$strip>;
+                slug: z.ZodMiniNullable<z.ZodMiniString<string>>;
+                state: z.ZodMiniObject<{
+                    depositsPaused: z.ZodMiniBoolean<boolean>;
+                    engineShares: z.ZodMiniString<string>;
+                    feesActive: z.ZodMiniBoolean<boolean>;
+                    isAccountingAligned: z.ZodMiniBoolean<boolean>;
+                    openRedeemRequestCount: z.ZodMiniNumber<number>;
+                    totalAssets: z.ZodMiniString<string>;
+                    totalEarnShares: z.ZodMiniString<string>;
+                }, z.core.$strict>;
+                tvl: 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>>>;
+                vaultAddress: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                verified: z.ZodMiniBoolean<boolean>;
+                zone: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+                    chainId: z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                        mainnet: "mainnet";
+                        testnet: "testnet";
+                    }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniNumber<unknown>]>, z.ZodMiniNumber<number>>;
+                    inputTokens: z.ZodMiniArray<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+                    name: z.ZodMiniString<string>;
+                    outputTokens: z.ZodMiniArray<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>;
+            meta: z.ZodMiniOptional<z.ZodMiniObject<{
+                valuation: z.ZodMiniOptional<z.ZodMiniObject<{
+                    asOf: z.ZodMiniISODateTime;
+                    basis: z.ZodMiniLiteral<"nominal">;
+                    source: z.ZodMiniString<string>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            nextCursor: z.ZodMiniNullable<z.ZodMiniString<string>>;
+        }, z.core.$strict>;
+    }
+    /** Schemas for the getVerifiedEarnVaults operation. */
+    namespace getVerifiedEarnVaults {
+        /** Collection query without rates or valuation, for surfaces that cannot measure them. */
+        const BaseQuery: z.ZodMiniObject<{
+            asset: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+            capability: z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniUnknown>, z.ZodMiniTransform<string[], unknown>>, z.ZodMiniArray<z.ZodMiniEnum<{
+                asyncRedeem: "asyncRedeem";
+                boundedRedeem: "boundedRedeem";
+                deposit: "deposit";
+                exactWithdraw: "exactWithdraw";
+                inKindDeposit: "inKindDeposit";
+                privateRouting: "privateRouting";
+                redeem: "redeem";
+                routerSwaps: "routerSwaps";
+            }>>>;
+            chainId: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                mainnet: "mainnet";
+                testnet: "testnet";
+            }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniNumber<unknown>]>, z.ZodMiniNumber<number>>>;
+            cursor: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            'engine.type': z.ZodMiniOptional<z.ZodMiniEnum<{
+                erc4626: "erc4626";
+                veda: "veda";
+            }>>;
+            limit: z.ZodMiniDefault<z.ZodMiniNumber<unknown>>;
+            include: z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniUnknown>, z.ZodMiniTransform<string[], unknown>>, z.ZodMiniArray<z.ZodMiniEnum<{
+                access: "access";
+                capabilities: "capabilities";
+                "token.logoUri": "token.logoUri";
+                zone: "zone";
+            }>>>;
+        }, z.core.$strict>;
+        /** Query parameters for registry-curated Earn vaults. */
+        const Query: z.ZodMiniObject<{
+            asset: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+            capability: z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniUnknown>, z.ZodMiniTransform<string[], unknown>>, z.ZodMiniArray<z.ZodMiniEnum<{
+                asyncRedeem: "asyncRedeem";
+                boundedRedeem: "boundedRedeem";
+                deposit: "deposit";
+                exactWithdraw: "exactWithdraw";
+                inKindDeposit: "inKindDeposit";
+                privateRouting: "privateRouting";
+                redeem: "redeem";
+                routerSwaps: "routerSwaps";
+            }>>>;
+            chainId: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                mainnet: "mainnet";
+                testnet: "testnet";
+            }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniNumber<unknown>]>, z.ZodMiniNumber<number>>>;
+            cursor: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            'engine.type': z.ZodMiniOptional<z.ZodMiniEnum<{
+                erc4626: "erc4626";
+                veda: "veda";
+            }>>;
+            include: z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniUnknown>, z.ZodMiniTransform<string[], unknown>>, z.ZodMiniArray<z.ZodMiniEnum<{
+                access: "access";
+                apy: "apy";
+                capabilities: "capabilities";
+                "token.logoUri": "token.logoUri";
+                tvl: "tvl";
+                zone: "zone";
+            }>>>;
+            limit: z.ZodMiniDefault<z.ZodMiniNumber<unknown>>;
+            'apy.window': z.ZodMiniOptional<z.ZodMiniEnum<{
+                "1d": "1d";
+                "1h": "1h";
+                "30d": "30d";
+                "7d": "7d";
+            }>>;
+        }, z.core.$strict>;
+        /** Paginated list of registry-curated Earn vaults. */
+        const Response: z.ZodMiniObject<{
+            data: z.ZodMiniArray<z.ZodMiniObject<{
+                access: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+                    status: z.ZodMiniEnum<{
+                        allowlisted: "allowlisted";
+                        open: "open";
+                    }>;
+                }, z.core.$strict>>>;
+                apy: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+                    asOf: z.ZodMiniISODateTime;
+                    methodology: z.ZodMiniLiteral<"share-price-growth-annualized:v1">;
+                    net: z.ZodMiniString<string>;
+                    window: z.ZodMiniEnum<{
+                        "1d": "1d";
+                        "1h": "1h";
+                        "30d": "30d";
+                        "7d": "7d";
+                    }>;
+                }, z.core.$strict>>>;
+                assetToken: z.ZodMiniObject<{
+                    address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    id: z.ZodMiniString<string>;
+                    logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                    name: z.ZodMiniString<string>;
+                    symbol: z.ZodMiniString<string>;
+                    verified: z.ZodMiniBoolean<boolean>;
+                }, z.core.$strip>;
+                capabilities: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+                    asyncRedeem: z.ZodMiniBoolean<boolean>;
+                    boundedRedeem: z.ZodMiniBoolean<boolean>;
+                    deposit: z.ZodMiniBoolean<boolean>;
+                    exactWithdraw: z.ZodMiniBoolean<boolean>;
+                    inKindDeposit: z.ZodMiniBoolean<boolean>;
+                    privateRouting: z.ZodMiniBoolean<boolean>;
+                    redeem: z.ZodMiniBoolean<boolean>;
+                    routerSwaps: z.ZodMiniBoolean<boolean>;
+                }, z.core.$strict>>>;
+                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>>;
+                label: z.ZodMiniString<string>;
+                sharePrice: z.ZodMiniNullable<z.ZodMiniObject<{
+                    amount: z.ZodMiniString<string>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    formatted: z.ZodMiniString<string>;
+                }, z.core.$strict>>;
+                shareToken: z.ZodMiniObject<{
+                    address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    id: z.ZodMiniString<string>;
+                    logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                    name: z.ZodMiniString<string>;
+                    symbol: z.ZodMiniString<string>;
+                    verified: z.ZodMiniBoolean<boolean>;
+                }, z.core.$strip>;
+                state: z.ZodMiniObject<{
+                    depositsPaused: z.ZodMiniBoolean<boolean>;
+                    engineShares: z.ZodMiniString<string>;
+                    feesActive: z.ZodMiniBoolean<boolean>;
+                    isAccountingAligned: z.ZodMiniBoolean<boolean>;
+                    openRedeemRequestCount: z.ZodMiniNumber<number>;
+                    totalAssets: z.ZodMiniString<string>;
+                    totalEarnShares: z.ZodMiniString<string>;
+                }, z.core.$strict>;
+                tvl: 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>>>;
+                vaultAddress: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                zone: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+                    chainId: z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                        mainnet: "mainnet";
+                        testnet: "testnet";
+                    }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniNumber<unknown>]>, z.ZodMiniNumber<number>>;
+                    inputTokens: z.ZodMiniArray<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+                    name: z.ZodMiniString<string>;
+                    outputTokens: z.ZodMiniArray<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+                }, z.core.$strict>>>;
+                engine: z.ZodMiniObject<{
+                    address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                    venue: z.ZodMiniNullable<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+                    type: z.ZodMiniEnum<{
+                        erc4626: "erc4626";
+                        veda: "veda";
+                    }>;
+                }, z.core.$strict>;
+                slug: z.ZodMiniString<string>;
+                verified: z.ZodMiniLiteral<true>;
+            }, z.core.$strict>>;
+            meta: z.ZodMiniOptional<z.ZodMiniObject<{
+                valuation: z.ZodMiniOptional<z.ZodMiniObject<{
+                    asOf: z.ZodMiniISODateTime;
+                    basis: z.ZodMiniLiteral<"nominal">;
+                    source: z.ZodMiniString<string>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            nextCursor: z.ZodMiniNullable<z.ZodMiniString<string>>;
+        }, z.core.$strict>;
+    }
+    /** Schemas for the getEarnVault operation. */
+    namespace getEarnVault {
+        /** Path parameters identifying one Earn vault. */
+        const Params: z.ZodMiniObject<{
+            vaultId: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+        }, z.core.$strict>;
+        /** Detail query without rates or valuation, for surfaces that cannot measure them. */
+        const BaseQuery: z.ZodMiniObject<{
+            chainId: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                mainnet: "mainnet";
+                testnet: "testnet";
+            }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniNumber<unknown>]>, z.ZodMiniNumber<number>>>;
+            include: z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniUnknown>, z.ZodMiniTransform<string[], unknown>>, z.ZodMiniArray<z.ZodMiniEnum<{
+                access: "access";
+                capabilities: "capabilities";
+                "token.logoUri": "token.logoUri";
+                zone: "zone";
+            }>>>;
+        }, z.core.$strict>;
+        /** Query parameters selecting the chain containing the vault. */
+        const Query: z.ZodMiniObject<{
+            chainId: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                mainnet: "mainnet";
+                testnet: "testnet";
+            }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniNumber<unknown>]>, z.ZodMiniNumber<number>>>;
+            include: z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniUnknown>, z.ZodMiniTransform<string[], unknown>>, z.ZodMiniArray<z.ZodMiniEnum<{
+                access: "access";
+                apy: "apy";
+                capabilities: "capabilities";
+                "token.logoUri": "token.logoUri";
+                tvl: "tvl";
+                zone: "zone";
+            }>>>;
+            'apy.window': z.ZodMiniOptional<z.ZodMiniEnum<{
+                "1d": "1d";
+                "1h": "1h";
+                "30d": "30d";
+                "7d": "7d";
+            }>>;
+        }, z.core.$strict>;
+        /** One compatible Earn vault resolved directly from current chain state. */
+        const Response: z.ZodMiniObject<{
+            access: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+                status: z.ZodMiniEnum<{
+                    allowlisted: "allowlisted";
+                    open: "open";
+                }>;
+            }, z.core.$strict>>>;
+            apy: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+                asOf: z.ZodMiniISODateTime;
+                methodology: z.ZodMiniLiteral<"share-price-growth-annualized:v1">;
+                net: z.ZodMiniString<string>;
+                window: z.ZodMiniEnum<{
+                    "1d": "1d";
+                    "1h": "1h";
+                    "30d": "30d";
+                    "7d": "7d";
+                }>;
+            }, z.core.$strict>>>;
+            assetToken: z.ZodMiniObject<{
+                address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                currency: z.ZodMiniString<string>;
+                decimals: z.ZodMiniNumber<number>;
+                id: z.ZodMiniString<string>;
+                logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                name: z.ZodMiniString<string>;
+                symbol: z.ZodMiniString<string>;
+                verified: z.ZodMiniBoolean<boolean>;
+            }, z.core.$strip>;
+            capabilities: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+                asyncRedeem: z.ZodMiniBoolean<boolean>;
+                boundedRedeem: z.ZodMiniBoolean<boolean>;
+                deposit: z.ZodMiniBoolean<boolean>;
+                exactWithdraw: z.ZodMiniBoolean<boolean>;
+                inKindDeposit: z.ZodMiniBoolean<boolean>;
+                privateRouting: z.ZodMiniBoolean<boolean>;
+                redeem: z.ZodMiniBoolean<boolean>;
+                routerSwaps: z.ZodMiniBoolean<boolean>;
+            }, z.core.$strict>>>;
+            description: z.ZodMiniNullable<z.ZodMiniString<string>>;
+            engine: z.ZodMiniObject<{
+                address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                type: z.ZodMiniNullable<z.ZodMiniEnum<{
+                    erc4626: "erc4626";
+                    veda: "veda";
+                }>>;
+                venue: z.ZodMiniNullable<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+            }, z.core.$strict>;
+            id: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+            instantLiquidity: z.ZodMiniNullable<z.ZodMiniString<string>>;
+            label: z.ZodMiniString<string>;
+            sharePrice: z.ZodMiniNullable<z.ZodMiniObject<{
+                amount: z.ZodMiniString<string>;
+                currency: z.ZodMiniString<string>;
+                decimals: z.ZodMiniNumber<number>;
+                formatted: z.ZodMiniString<string>;
+            }, z.core.$strict>>;
+            shareToken: z.ZodMiniObject<{
+                address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                currency: z.ZodMiniString<string>;
+                decimals: z.ZodMiniNumber<number>;
+                id: z.ZodMiniString<string>;
+                logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                name: z.ZodMiniString<string>;
+                symbol: z.ZodMiniString<string>;
+                verified: z.ZodMiniBoolean<boolean>;
+            }, z.core.$strip>;
+            slug: z.ZodMiniNullable<z.ZodMiniString<string>>;
+            state: z.ZodMiniObject<{
+                depositsPaused: z.ZodMiniBoolean<boolean>;
+                engineShares: z.ZodMiniString<string>;
+                feesActive: z.ZodMiniBoolean<boolean>;
+                isAccountingAligned: z.ZodMiniBoolean<boolean>;
+                openRedeemRequestCount: z.ZodMiniNumber<number>;
+                totalAssets: z.ZodMiniString<string>;
+                totalEarnShares: z.ZodMiniString<string>;
+            }, z.core.$strict>;
+            tvl: 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>>>;
+            vaultAddress: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+            verified: z.ZodMiniBoolean<boolean>;
+            zone: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+                chainId: z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                    mainnet: "mainnet";
+                    testnet: "testnet";
+                }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniNumber<unknown>]>, z.ZodMiniNumber<number>>;
+                inputTokens: z.ZodMiniArray<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+                name: z.ZodMiniString<string>;
+                outputTokens: z.ZodMiniArray<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+            }, z.core.$strict>>>;
+            meta: z.ZodMiniOptional<z.ZodMiniObject<{
+                valuation: z.ZodMiniOptional<z.ZodMiniObject<{
+                    asOf: z.ZodMiniISODateTime;
+                    basis: z.ZodMiniLiteral<"nominal">;
+                    source: z.ZodMiniString<string>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strict>;
+    }
+    /** Schemas for the getEarnVaultPosition operation. */
+    namespace getEarnVaultPosition {
+        /** Path parameters identifying the Earn vault and account. */
+        const Params: z.ZodMiniObject<{
+            address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+            vaultId: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+        }, z.core.$strict>;
+        /** Query parameters selecting the chain containing the vault. */
+        const Query: z.ZodMiniObject<{
+            chainId: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                mainnet: "mainnet";
+                testnet: "testnet";
+            }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniNumber<unknown>]>, z.ZodMiniNumber<number>>>;
+        }, 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}`>>;
+            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>;
+        }, 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;
+            };
+        } | {
+            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";
+                    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: {
+                data: {
+                    access?: {
+                        status: "allowlisted" | "open";
+                    } | undefined;
+                    apy?: {
+                        asOf: string;
+                        methodology: "share-price-growth-annualized:v1";
+                        net: string;
+                        window: "1d" | "1h" | "30d" | "7d";
+                    } | null | undefined;
+                    assetToken: {
+                        address: `0x${string}`;
+                        currency: string;
+                        decimals: number;
+                        id: string;
+                        logoUri?: string | undefined;
+                        name: string;
+                        symbol: string;
+                        verified: boolean;
+                    };
+                    capabilities?: {
+                        asyncRedeem: boolean;
+                        boundedRedeem: boolean;
+                        deposit: boolean;
+                        exactWithdraw: boolean;
+                        inKindDeposit: boolean;
+                        privateRouting: boolean;
+                        redeem: boolean;
+                        routerSwaps: boolean;
+                    } | undefined;
+                    description: string | null;
+                    engine: {
+                        address: `0x${string}`;
+                        type: "erc4626" | "veda" | null;
+                        venue: `0x${string}` | null;
+                    };
+                    id: `0x${string}`;
+                    instantLiquidity: string | null;
+                    label: string;
+                    sharePrice: {
+                        amount: string;
+                        currency: string;
+                        decimals: number;
+                        formatted: string;
+                    } | null;
+                    shareToken: {
+                        address: `0x${string}`;
+                        currency: string;
+                        decimals: number;
+                        id: string;
+                        logoUri?: string | undefined;
+                        name: string;
+                        symbol: string;
+                        verified: boolean;
+                    };
+                    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;
+                }[];
+                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";
+                    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: {
+                data: {
+                    access?: {
+                        status: "allowlisted" | "open";
+                    } | undefined;
+                    apy?: {
+                        asOf: string;
+                        methodology: "share-price-growth-annualized:v1";
+                        net: string;
+                        window: "1d" | "1h" | "30d" | "7d";
+                    } | null | undefined;
+                    assetToken: {
+                        address: `0x${string}`;
+                        currency: string;
+                        decimals: number;
+                        id: string;
+                        logoUri?: string | undefined;
+                        name: string;
+                        symbol: string;
+                        verified: boolean;
+                    };
+                    capabilities?: {
+                        asyncRedeem: boolean;
+                        boundedRedeem: boolean;
+                        deposit: boolean;
+                        exactWithdraw: boolean;
+                        inKindDeposit: boolean;
+                        privateRouting: boolean;
+                        redeem: boolean;
+                        routerSwaps: boolean;
+                    } | undefined;
+                    description: string | null;
+                    id: `0x${string}`;
+                    instantLiquidity: string | null;
+                    label: string;
+                    sharePrice: {
+                        amount: string;
+                        currency: string;
+                        decimals: number;
+                        formatted: string;
+                    } | null;
+                    shareToken: {
+                        address: `0x${string}`;
+                        currency: string;
+                        decimals: number;
+                        id: string;
+                        logoUri?: string | undefined;
+                        name: string;
+                        symbol: string;
+                        verified: boolean;
+                    };
+                    state: {
+                        depositsPaused: boolean;
+                        engineShares: string;
+                        feesActive: boolean;
+                        isAccountingAligned: boolean;
+                        openRedeemRequestCount: number;
+                        totalAssets: string;
+                        totalEarnShares: string;
+                    };
+                    tvl?: {
+                        amount: string;
+                        currency: string;
+                        decimals: number;
+                        formatted: string;
+                    } | null | undefined;
+                    vaultAddress: `0x${string}`;
+                    zone?: {
+                        chainId: number;
+                        inputTokens: `0x${string}`[];
+                        name: string;
+                        outputTokens: `0x${string}`[];
+                    } | null | undefined;
+                    engine: {
+                        address: `0x${string}`;
+                        venue: `0x${string}` | null;
+                        type: "erc4626" | "veda";
+                    };
+                    slug: string;
+                    verified: true;
+                }[];
+                meta?: {
+                    valuation?: {
+                        asOf: string;
+                        basis: "nominal";
+                        source: string;
+                    } | undefined;
+                } | undefined;
+                nextCursor: string | null;
+            };
+            outputFormat: "json";
+            status: 200;
+            input: {
+                query?: {
+                    asset?: string | string[];
+                    capability?: string | string[];
+                    chainId?: string | string[];
+                    cursor?: string | string[];
+                    'engine.type'?: string | string[];
+                    include?: string | string[];
+                    limit?: string | string[];
+                    'apy.window'?: string | string[];
+                } | undefined;
+            };
+        };
+    };
+} & {
+    "/v1/earn/vaults/:vaultId/positions/:address": {
+        $get: {
+            output: null;
+            outputFormat: "body";
+            status: 402;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "api_key_malformed";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 400;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "api_key_invalid" | "api_key_missing";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 401;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "api_key_forbidden";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 403;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "payment_required" | "rate_limit_exceeded";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 429;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "query_invalid";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 400;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "upstream_error";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 502;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "chain_id_unsupported";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 400;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "chain_id_invalid";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 400;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "position_invalid";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 400;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                account: `0x${string}`;
+                assetAllowance: string;
+                assetBalance: string;
+                assetToken: `0x${string}`;
+                id: `0x${string}`;
+                shareAllowance: string;
+                shareBalance: string;
+                shareToken: `0x${string}`;
+                value: string;
+            };
+            outputFormat: "json";
+            status: 200;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: 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: {
+                    address: `0x${string}`;
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                } | undefined;
+            };
+        };
+    };
+} & {
+    "/v1/earn/vaults/:vaultId": {
+        $get: {
+            output: null;
+            outputFormat: "body";
+            status: 402;
+            input: {
+                param: {
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: 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: {
+                param: {
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: 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: {
+                param: {
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: string | string[];
+                    'apy.window'?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "api_key_forbidden";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 403;
+            input: {
+                param: {
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: 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: {
+                param: {
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: 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: {
+                param: {
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: 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: {
+                param: {
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: string | string[];
+                    '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: {
+                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[];
+                    include?: string | string[];
+                    'apy.window'?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                access?: {
+                    status: "allowlisted" | "open";
+                } | undefined;
+                apy?: {
+                    asOf: string;
+                    methodology: "share-price-growth-annualized:v1";
+                    net: string;
+                    window: "1d" | "1h" | "30d" | "7d";
+                } | null | undefined;
+                assetToken: {
+                    address: `0x${string}`;
+                    currency: string;
+                    decimals: number;
+                    id: string;
+                    logoUri?: string | undefined;
+                    name: string;
+                    symbol: string;
+                    verified: boolean;
+                };
+                capabilities?: {
+                    asyncRedeem: boolean;
+                    boundedRedeem: boolean;
+                    deposit: boolean;
+                    exactWithdraw: boolean;
+                    inKindDeposit: boolean;
+                    privateRouting: boolean;
+                    redeem: boolean;
+                    routerSwaps: boolean;
+                } | undefined;
+                description: string | null;
+                engine: {
+                    address: `0x${string}`;
+                    type: "erc4626" | "veda" | null;
+                    venue: `0x${string}` | null;
+                };
+                id: `0x${string}`;
+                instantLiquidity: string | null;
+                label: string;
+                sharePrice: {
+                    amount: string;
+                    currency: string;
+                    decimals: number;
+                    formatted: string;
+                } | null;
+                shareToken: {
+                    address: `0x${string}`;
+                    currency: string;
+                    decimals: number;
+                    id: string;
+                    logoUri?: string | undefined;
+                    name: string;
+                    symbol: string;
+                    verified: boolean;
+                };
+                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;
+                meta?: {
+                    valuation?: {
+                        asOf: string;
+                        basis: "nominal";
+                        source: string;
+                    } | undefined;
+                } | undefined;
+            };
+            outputFormat: "json";
+            status: 200;
+            input: {
+                param: {
+                    vaultId: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    include?: string | string[];
+                    'apy.window'?: string | string[];
+                } | undefined;
+            };
+        };
+    };
+}, "/", "/v1/earn/vaults/:vaultId">;
+export declare namespace earn {
+    /** Options for the public Earn-vault handlers. */
+    type Options = {
+        /** FX configuration backing TVL valuation. */
+        fx?: Valuation.addresses.Fx | undefined;
+    };
+}
+/** Lists compatible deployed Earn vaults. */
+export declare function listVaults(c: Context<App.Environment>, options: listVaults.Options): Promise<{
+    data: {
+        access?: {
+            status: "allowlisted" | "open";
+        } | undefined;
+        apy?: {
+            asOf: string;
+            methodology: "share-price-growth-annualized:v1";
+            net: string;
+            window: "1d" | "1h" | "30d" | "7d";
+        } | null | undefined;
+        assetToken: {
+            address: `0x${string}`;
+            currency: string;
+            decimals: number;
+            id: string;
+            logoUri?: string | undefined;
+            name: string;
+            symbol: string;
+            verified: boolean;
+        };
+        capabilities?: {
+            asyncRedeem: boolean;
+            boundedRedeem: boolean;
+            deposit: boolean;
+            exactWithdraw: boolean;
+            inKindDeposit: boolean;
+            privateRouting: boolean;
+            redeem: boolean;
+            routerSwaps: boolean;
+        } | undefined;
+        description: string | null;
+        engine: {
+            address: `0x${string}`;
+            type: "erc4626" | "veda" | null;
+            venue: `0x${string}` | null;
+        };
+        id: `0x${string}`;
+        instantLiquidity: string | null;
+        label: string;
+        sharePrice: {
+            amount: string;
+            currency: string;
+            decimals: number;
+            formatted: string;
+        } | null;
+        shareToken: {
+            address: `0x${string}`;
+            currency: string;
+            decimals: number;
+            id: string;
+            logoUri?: string | undefined;
+            name: string;
+            symbol: string;
+            verified: boolean;
+        };
+        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;
+    }[];
+    meta?: {
+        valuation: {
+            asOf: string;
+            basis: 'nominal';
+            source: string;
+        };
+    };
+    nextCursor: string | null;
+}>;
+export declare namespace listVaults {
+    /** One compatible deployment found while scanning TIDX. */
+    type Match = {
+        discovery: EarnVaults.Discovery;
+        position: Position;
+        record?: RegistryRecord | undefined;
+    };
+    /** Options for listing compatible Earn vaults. */
+    type Options = z.output<typeof schema.getEarnVaults.Query> & {
+        chainId: z.output<typeof Schema.ChainId>;
+        /** FX rate oracle backing TVL valuation. */
+        oracle: FxOracle.Oracle;
+    };
+    /** TIDX deployment cursor position. */
+    type Position = [number, number];
+}
+/** Lists registry-curated Earn vaults. */
+export declare function listVerifiedVaults(c: Context<App.Environment>, options: listVerifiedVaults.Options): Promise<{
+    data: {
+        access?: {
+            status: "allowlisted" | "open";
+        } | undefined;
+        apy?: {
+            asOf: string;
+            methodology: "share-price-growth-annualized:v1";
+            net: string;
+            window: "1d" | "1h" | "30d" | "7d";
+        } | null | undefined;
+        assetToken: {
+            address: `0x${string}`;
+            currency: string;
+            decimals: number;
+            id: string;
+            logoUri?: string | undefined;
+            name: string;
+            symbol: string;
+            verified: boolean;
+        };
+        capabilities?: {
+            asyncRedeem: boolean;
+            boundedRedeem: boolean;
+            deposit: boolean;
+            exactWithdraw: boolean;
+            inKindDeposit: boolean;
+            privateRouting: boolean;
+            redeem: boolean;
+            routerSwaps: boolean;
+        } | undefined;
+        description: string | null;
+        id: `0x${string}`;
+        instantLiquidity: string | null;
+        label: string;
+        sharePrice: {
+            amount: string;
+            currency: string;
+            decimals: number;
+            formatted: string;
+        } | null;
+        shareToken: {
+            address: `0x${string}`;
+            currency: string;
+            decimals: number;
+            id: string;
+            logoUri?: string | undefined;
+            name: string;
+            symbol: string;
+            verified: boolean;
+        };
+        state: {
+            depositsPaused: boolean;
+            engineShares: string;
+            feesActive: boolean;
+            isAccountingAligned: boolean;
+            openRedeemRequestCount: number;
+            totalAssets: string;
+            totalEarnShares: string;
+        };
+        tvl?: {
+            amount: string;
+            currency: string;
+            decimals: number;
+            formatted: string;
+        } | null | undefined;
+        vaultAddress: `0x${string}`;
+        zone?: {
+            chainId: number;
+            inputTokens: `0x${string}`[];
+            name: string;
+            outputTokens: `0x${string}`[];
+        } | null | undefined;
+        engine: {
+            address: `0x${string}`;
+            venue: `0x${string}` | null;
+            type: "erc4626" | "veda";
+        };
+        slug: string;
+        verified: true;
+    }[];
+    meta?: {
+        valuation: {
+            asOf: string;
+            basis: 'nominal';
+            source: string;
+        };
+    };
+    nextCursor: string | null;
+}>;
+export declare namespace listVerifiedVaults {
+    /** One verified vault and its current onchain state. */
+    type Match = {
+        discovery: EarnVaults.Discovery;
+        record: RegistryRecord;
+    };
+    /** Options for listing verified Earn vaults. */
+    type Options = z.output<typeof schema.getVerifiedEarnVaults.Query> & {
+        chainId: z.output<typeof Schema.ChainId>;
+        /** FX rate oracle backing TVL valuation. */
+        oracle: FxOracle.Oracle;
+    };
+}
+/** Gets one compatible Earn vault. */
+export declare function getVault(c: Context<App.Environment>, options: getVault.Options): Promise<{
+    access?: {
+        status: "allowlisted" | "open";
+    } | undefined;
+    apy?: {
+        asOf: string;
+        methodology: "share-price-growth-annualized:v1";
+        net: string;
+        window: "1d" | "1h" | "30d" | "7d";
+    } | null | undefined;
+    assetToken: {
+        address: `0x${string}`;
+        currency: string;
+        decimals: number;
+        id: string;
+        logoUri?: string | undefined;
+        name: string;
+        symbol: string;
+        verified: boolean;
+    };
+    capabilities?: {
+        asyncRedeem: boolean;
+        boundedRedeem: boolean;
+        deposit: boolean;
+        exactWithdraw: boolean;
+        inKindDeposit: boolean;
+        privateRouting: boolean;
+        redeem: boolean;
+        routerSwaps: boolean;
+    } | undefined;
+    description: string | null;
+    engine: {
+        address: `0x${string}`;
+        type: "erc4626" | "veda" | null;
+        venue: `0x${string}` | null;
+    };
+    id: `0x${string}`;
+    instantLiquidity: string | null;
+    label: string;
+    sharePrice: {
+        amount: string;
+        currency: string;
+        decimals: number;
+        formatted: string;
+    } | null;
+    shareToken: {
+        address: `0x${string}`;
+        currency: string;
+        decimals: number;
+        id: string;
+        logoUri?: string | undefined;
+        name: string;
+        symbol: string;
+        verified: boolean;
+    };
+    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;
+    meta?: {
+        valuation: {
+            asOf: string;
+            basis: 'nominal';
+            source: string;
+        };
+    };
+}>;
+export declare namespace getVault {
+    /** Options for getting one Earn vault. */
+    type Options = {
+        /** Canonical rate window the vault's APY covers. */
+        'apy.window': z.output<typeof schema.getEarnVault.Query>['apy.window'];
+        chainId: z.output<typeof Schema.ChainId>;
+        include: z.output<typeof schema.getEarnVault.Query>['include'];
+        /** FX rate oracle backing TVL valuation. */
+        oracle: FxOracle.Oracle;
+        vaultAddress: z.output<typeof Schema.Address>;
+    };
+}
+/** Serializes resolved onchain and curated fields into the shared vault contract. */
+export declare function serializeVault(options: serializeVault.Options): z.output<typeof schema.Vault>;
+export declare namespace serializeVault {
+    /** Values used to serialize one resolved Earn vault. */
+    type Options = {
+        /** Measured rate, or null when unavailable; omitted unless `include` carries `apy`. */
+        apy: EarnRates.Apy | null;
+        /** Resolved asset token. */
+        assetToken: z.output<typeof Tokens.schema.Token>;
+        /** Live onchain vault state. */
+        discovery: EarnVaults.Discovery;
+        /** Optional vault fields selected by the request. */
+        include: z.output<typeof schema.getEarnVault.Query>['include'];
+        /** Curated registry row, when verified. */
+        record?: core_EarnVaults.Record | 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`. */
+        tvl: z.output<typeof schema.Vault>['tvl'];
+        /** Private Zones available to the vault. */
+        zones: readonly Chain[];
+    };
+}
+/** Tests live vault state against the shared collection filters. */
+export declare function matchesVaultFilters(discovery: EarnVaults.Discovery, options: matchesVaultFilters.Options): boolean;
+export declare namespace matchesVaultFilters {
+    /** Filters shared by the all-vault and verified-vault collections. */
+    type Options = Pick<z.output<typeof schema.getEarnVaults.Query>, 'asset' | 'capability' | 'engine.type'>;
+}
+/** Returns whether a failed read proves the address is not a compatible Earn vault. */
+export declare function isIncompatible(cause: unknown): boolean;
+type RegistryRecord = Awaited<ReturnType<typeof core_EarnVaults.list>>[number];
+/** Thrown when no compatible Earn vault exists at the requested address. */
+export declare class NotFoundError extends Error {
+    name: string;
+}
+export {};
+//# sourceMappingURL=earn.d.ts.map