otto-intel-mcp 0.1.2 → 0.1.4

package/dist/executable-yield-markets.d.ts

@@ -0,0 +1,261 @@
+/**
+ * Server-owned yield execution registry.
+ *
+ * The dApp's server route and TEA import the exact same records. Discovery can
+ * attach APY data to a record, but it cannot create or mutate execution
+ * eligibility. The canonical commitment is server-only (both consumers run in
+ * Node) and covers the complete registry record, including nested fields.
+ */
+export type ExecutableYieldAction = 'deposit' | 'withdraw';
+export type ExecutableYieldCall = 'approve' | 'supply' | 'deposit' | 'withdraw' | 'redeem';
+interface ExecutableYieldMarketBase {
+    readonly id: string;
+    readonly venue: string;
+    readonly chainId: 8453;
+    readonly chainSlug: 'base';
+    readonly asset: {
+        readonly symbol: 'USDC';
+        readonly group: 'USDC';
+        readonly address: `0x${string}`;
+        readonly decimals: 6;
+    };
+    /** Exact protocol call target (Aave Pool proxy or per-vault Morpho ERC-4626). */
+    readonly protocolTarget: `0x${string}`;
+    readonly vaultAddress: `0x${string}`;
+    readonly nativeValue: '0';
+    readonly allowedCallSequences: {
+        readonly deposit: readonly (readonly ExecutableYieldCall[])[];
+        readonly withdraw: readonly (readonly ExecutableYieldCall[])[];
+    };
+    readonly safeBinding: {
+        readonly executionOwner: 'SAFE';
+        readonly depositReceiver: 'SAFE';
+        readonly withdrawReceiver: 'SAFE';
+    };
+    /** Exact Yield Copilot discovery identity that may receive this execution ID. */
+    readonly discoveryMarketId: string;
+}
+export type ExecutableYieldMarket = (ExecutableYieldMarketBase & {
+    readonly protocol: 'AAVE';
+    readonly builder: 'aave-native';
+    readonly selectors: {
+        readonly approve: `0x${string}`;
+        readonly supply: `0x${string}`;
+        readonly withdraw: `0x${string}`;
+    };
+}) | (ExecutableYieldMarketBase & {
+    readonly protocol: 'MORPHO';
+    readonly builder: 'morpho-native';
+    /** Pinned ERC-4626 share-token decimals for exact `redeem(max)` accounting. */
+    readonly vaultShareDecimals: 18;
+    readonly selectors: {
+        readonly approve: `0x${string}`;
+        readonly deposit: `0x${string}`;
+        readonly withdraw: `0x${string}`;
+        readonly redeem: `0x${string}`;
+    };
+});
+export declare const BASE_USDC_AAVE_V3_MARKET: {
+    readonly id: "base-usdc-aave-v3";
+    readonly venue: "AAVE V3";
+    readonly protocol: "AAVE";
+    readonly chainId: 8453;
+    readonly chainSlug: "base";
+    readonly asset: {
+        readonly symbol: "USDC";
+        readonly group: "USDC";
+        readonly address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+        readonly decimals: 6;
+    };
+    readonly protocolTarget: "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5";
+    readonly vaultAddress: "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5";
+    readonly nativeValue: "0";
+    readonly builder: "aave-native";
+    readonly selectors: {
+        readonly approve: "0x095ea7b3";
+        readonly supply: "0x617ba037";
+        readonly withdraw: "0x69328dec";
+    };
+    readonly allowedCallSequences: {
+        readonly deposit: readonly [readonly ["approve", "supply"], readonly ["supply"]];
+        readonly withdraw: readonly [readonly ["withdraw"]];
+    };
+    readonly safeBinding: {
+        readonly executionOwner: "SAFE";
+        readonly depositReceiver: "SAFE";
+        readonly withdrawReceiver: "SAFE";
+    };
+    readonly discoveryMarketId: "aave:8453:0xa238dd80c259a72e81d7e4664a9801593f98d1c5:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913";
+};
+export declare const BASE_USDC_MORPHO_GAUNTLET_PRIME_MARKET: {
+    readonly id: "base-usdc-morpho-gauntlet-prime";
+    readonly venue: "MORPHO · GAUNTLET USDC PRIME";
+    readonly protocol: "MORPHO";
+    readonly chainId: 8453;
+    readonly chainSlug: "base";
+    readonly asset: {
+        readonly symbol: "USDC";
+        readonly group: "USDC";
+        readonly address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+        readonly decimals: 6;
+    };
+    readonly protocolTarget: "0xeE8F4eC5672F09119b96Ab6fB59C27E1b7e44b61";
+    readonly vaultAddress: "0xeE8F4eC5672F09119b96Ab6fB59C27E1b7e44b61";
+    readonly vaultShareDecimals: 18;
+    readonly nativeValue: "0";
+    readonly builder: "morpho-native";
+    readonly selectors: {
+        readonly approve: "0x095ea7b3";
+        readonly deposit: "0x6e553f65";
+        readonly withdraw: "0xb460af94";
+        readonly redeem: "0xba087652";
+    };
+    readonly allowedCallSequences: {
+        readonly deposit: readonly [readonly ["approve", "deposit"], readonly ["deposit"]];
+        readonly withdraw: readonly [readonly ["withdraw"], readonly ["redeem"]];
+    };
+    readonly safeBinding: {
+        readonly executionOwner: "SAFE";
+        readonly depositReceiver: "SAFE";
+        readonly withdrawReceiver: "SAFE";
+    };
+    readonly discoveryMarketId: "morpho:8453:0xee8f4ec5672f09119b96ab6fb59c27e1b7e44b61:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913";
+};
+export declare const BASE_USDC_MORPHO_STEAKHOUSE_PRIME_MARKET: {
+    readonly id: "base-usdc-morpho-steakhouse-prime";
+    readonly venue: "MORPHO · STEAKHOUSE PRIME USDC";
+    readonly protocol: "MORPHO";
+    readonly chainId: 8453;
+    readonly chainSlug: "base";
+    readonly asset: {
+        readonly symbol: "USDC";
+        readonly group: "USDC";
+        readonly address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+        readonly decimals: 6;
+    };
+    readonly protocolTarget: "0xBEEFE94c8aD530842bfE7d8B397938fFc1cb83b2";
+    readonly vaultAddress: "0xBEEFE94c8aD530842bfE7d8B397938fFc1cb83b2";
+    readonly vaultShareDecimals: 18;
+    readonly nativeValue: "0";
+    readonly builder: "morpho-native";
+    readonly selectors: {
+        readonly approve: "0x095ea7b3";
+        readonly deposit: "0x6e553f65";
+        readonly withdraw: "0xb460af94";
+        readonly redeem: "0xba087652";
+    };
+    readonly allowedCallSequences: {
+        readonly deposit: readonly [readonly ["approve", "deposit"], readonly ["deposit"]];
+        readonly withdraw: readonly [readonly ["withdraw"], readonly ["redeem"]];
+    };
+    readonly safeBinding: {
+        readonly executionOwner: "SAFE";
+        readonly depositReceiver: "SAFE";
+        readonly withdrawReceiver: "SAFE";
+    };
+    readonly discoveryMarketId: "morpho:8453:0xbeefe94c8ad530842bfe7d8b397938ffc1cb83b2:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913";
+};
+export declare const EXECUTABLE_YIELD_MARKETS: readonly [{
+    readonly id: "base-usdc-aave-v3";
+    readonly venue: "AAVE V3";
+    readonly protocol: "AAVE";
+    readonly chainId: 8453;
+    readonly chainSlug: "base";
+    readonly asset: {
+        readonly symbol: "USDC";
+        readonly group: "USDC";
+        readonly address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+        readonly decimals: 6;
+    };
+    readonly protocolTarget: "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5";
+    readonly vaultAddress: "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5";
+    readonly nativeValue: "0";
+    readonly builder: "aave-native";
+    readonly selectors: {
+        readonly approve: "0x095ea7b3";
+        readonly supply: "0x617ba037";
+        readonly withdraw: "0x69328dec";
+    };
+    readonly allowedCallSequences: {
+        readonly deposit: readonly [readonly ["approve", "supply"], readonly ["supply"]];
+        readonly withdraw: readonly [readonly ["withdraw"]];
+    };
+    readonly safeBinding: {
+        readonly executionOwner: "SAFE";
+        readonly depositReceiver: "SAFE";
+        readonly withdrawReceiver: "SAFE";
+    };
+    readonly discoveryMarketId: "aave:8453:0xa238dd80c259a72e81d7e4664a9801593f98d1c5:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913";
+}, {
+    readonly id: "base-usdc-morpho-gauntlet-prime";
+    readonly venue: "MORPHO · GAUNTLET USDC PRIME";
+    readonly protocol: "MORPHO";
+    readonly chainId: 8453;
+    readonly chainSlug: "base";
+    readonly asset: {
+        readonly symbol: "USDC";
+        readonly group: "USDC";
+        readonly address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+        readonly decimals: 6;
+    };
+    readonly protocolTarget: "0xeE8F4eC5672F09119b96Ab6fB59C27E1b7e44b61";
+    readonly vaultAddress: "0xeE8F4eC5672F09119b96Ab6fB59C27E1b7e44b61";
+    readonly vaultShareDecimals: 18;
+    readonly nativeValue: "0";
+    readonly builder: "morpho-native";
+    readonly selectors: {
+        readonly approve: "0x095ea7b3";
+        readonly deposit: "0x6e553f65";
+        readonly withdraw: "0xb460af94";
+        readonly redeem: "0xba087652";
+    };
+    readonly allowedCallSequences: {
+        readonly deposit: readonly [readonly ["approve", "deposit"], readonly ["deposit"]];
+        readonly withdraw: readonly [readonly ["withdraw"], readonly ["redeem"]];
+    };
+    readonly safeBinding: {
+        readonly executionOwner: "SAFE";
+        readonly depositReceiver: "SAFE";
+        readonly withdrawReceiver: "SAFE";
+    };
+    readonly discoveryMarketId: "morpho:8453:0xee8f4ec5672f09119b96ab6fb59c27e1b7e44b61:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913";
+}, {
+    readonly id: "base-usdc-morpho-steakhouse-prime";
+    readonly venue: "MORPHO · STEAKHOUSE PRIME USDC";
+    readonly protocol: "MORPHO";
+    readonly chainId: 8453;
+    readonly chainSlug: "base";
+    readonly asset: {
+        readonly symbol: "USDC";
+        readonly group: "USDC";
+        readonly address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+        readonly decimals: 6;
+    };
+    readonly protocolTarget: "0xBEEFE94c8aD530842bfE7d8B397938fFc1cb83b2";
+    readonly vaultAddress: "0xBEEFE94c8aD530842bfE7d8B397938fFc1cb83b2";
+    readonly vaultShareDecimals: 18;
+    readonly nativeValue: "0";
+    readonly builder: "morpho-native";
+    readonly selectors: {
+        readonly approve: "0x095ea7b3";
+        readonly deposit: "0x6e553f65";
+        readonly withdraw: "0xb460af94";
+        readonly redeem: "0xba087652";
+    };
+    readonly allowedCallSequences: {
+        readonly deposit: readonly [readonly ["approve", "deposit"], readonly ["deposit"]];
+        readonly withdraw: readonly [readonly ["withdraw"], readonly ["redeem"]];
+    };
+    readonly safeBinding: {
+        readonly executionOwner: "SAFE";
+        readonly depositReceiver: "SAFE";
+        readonly withdrawReceiver: "SAFE";
+    };
+    readonly discoveryMarketId: "morpho:8453:0xbeefe94c8ad530842bfe7d8b397938ffc1cb83b2:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913";
+}];
+export type ExecutableYieldMarketId = (typeof EXECUTABLE_YIELD_MARKETS)[number]['id'];
+export type ExecutableYieldMarketCommitment = `sha256:${string}`;
+/** SHA-256 commitment over every enumerable field in the complete, canonical registry record. */
+export declare function getExecutableYieldMarketCommitment(market: ExecutableYieldMarket): ExecutableYieldMarketCommitment;
+export declare function getExecutableYieldMarket(marketId: string): ExecutableYieldMarket | null;
+export {};

package/dist/executable-yield-markets.js

@@ -0,0 +1,154 @@
+/**
+ * Server-owned yield execution registry.
+ *
+ * The dApp's server route and TEA import the exact same records. Discovery can
+ * attach APY data to a record, but it cannot create or mutate execution
+ * eligibility. The canonical commitment is server-only (both consumers run in
+ * Node) and covers the complete registry record, including nested fields.
+ */
+import { createHash } from 'node:crypto';
+function deepFreeze(value) {
+    if (value && typeof value === 'object' && !Object.isFrozen(value)) {
+        for (const nested of Object.values(value))
+            deepFreeze(nested);
+        Object.freeze(value);
+    }
+    return value;
+}
+export const BASE_USDC_AAVE_V3_MARKET = deepFreeze({
+    id: 'base-usdc-aave-v3',
+    venue: 'AAVE V3',
+    protocol: 'AAVE',
+    chainId: 8453,
+    chainSlug: 'base',
+    asset: {
+        symbol: 'USDC',
+        group: 'USDC',
+        address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+        decimals: 6,
+    },
+    protocolTarget: '0xA238Dd80C259a72e81d7e4664a9801593F98d1c5',
+    vaultAddress: '0xA238Dd80C259a72e81d7e4664a9801593F98d1c5',
+    nativeValue: '0',
+    builder: 'aave-native',
+    selectors: {
+        approve: '0x095ea7b3',
+        supply: '0x617ba037',
+        withdraw: '0x69328dec',
+    },
+    // An existing exact allowance lets the SDK omit approve. No other leg is valid.
+    allowedCallSequences: {
+        deposit: [['approve', 'supply'], ['supply']],
+        withdraw: [['withdraw']],
+    },
+    safeBinding: {
+        executionOwner: 'SAFE',
+        depositReceiver: 'SAFE',
+        withdrawReceiver: 'SAFE',
+    },
+    discoveryMarketId: 'aave:8453:0xa238dd80c259a72e81d7e4664a9801593f98d1c5:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913',
+});
+export const BASE_USDC_MORPHO_GAUNTLET_PRIME_MARKET = deepFreeze({
+    id: 'base-usdc-morpho-gauntlet-prime',
+    venue: 'MORPHO · GAUNTLET USDC PRIME',
+    protocol: 'MORPHO',
+    chainId: 8453,
+    chainSlug: 'base',
+    asset: {
+        symbol: 'USDC',
+        group: 'USDC',
+        address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+        decimals: 6,
+    },
+    protocolTarget: '0xeE8F4eC5672F09119b96Ab6fB59C27E1b7e44b61',
+    vaultAddress: '0xeE8F4eC5672F09119b96Ab6fB59C27E1b7e44b61',
+    vaultShareDecimals: 18,
+    nativeValue: '0',
+    builder: 'morpho-native',
+    selectors: {
+        approve: '0x095ea7b3',
+        deposit: '0x6e553f65',
+        withdraw: '0xb460af94',
+        redeem: '0xba087652',
+    },
+    allowedCallSequences: {
+        deposit: [['approve', 'deposit'], ['deposit']],
+        withdraw: [['withdraw'], ['redeem']],
+    },
+    safeBinding: {
+        executionOwner: 'SAFE',
+        depositReceiver: 'SAFE',
+        withdrawReceiver: 'SAFE',
+    },
+    discoveryMarketId: 'morpho:8453:0xee8f4ec5672f09119b96ab6fb59c27e1b7e44b61:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913',
+});
+export const BASE_USDC_MORPHO_STEAKHOUSE_PRIME_MARKET = deepFreeze({
+    id: 'base-usdc-morpho-steakhouse-prime',
+    venue: 'MORPHO · STEAKHOUSE PRIME USDC',
+    protocol: 'MORPHO',
+    chainId: 8453,
+    chainSlug: 'base',
+    asset: {
+        symbol: 'USDC',
+        group: 'USDC',
+        address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+        decimals: 6,
+    },
+    protocolTarget: '0xBEEFE94c8aD530842bfE7d8B397938fFc1cb83b2',
+    vaultAddress: '0xBEEFE94c8aD530842bfE7d8B397938fFc1cb83b2',
+    vaultShareDecimals: 18,
+    nativeValue: '0',
+    builder: 'morpho-native',
+    selectors: {
+        approve: '0x095ea7b3',
+        deposit: '0x6e553f65',
+        withdraw: '0xb460af94',
+        redeem: '0xba087652',
+    },
+    allowedCallSequences: {
+        deposit: [['approve', 'deposit'], ['deposit']],
+        withdraw: [['withdraw'], ['redeem']],
+    },
+    safeBinding: {
+        executionOwner: 'SAFE',
+        depositReceiver: 'SAFE',
+        withdrawReceiver: 'SAFE',
+    },
+    discoveryMarketId: 'morpho:8453:0xbeefe94c8ad530842bfe7d8b397938ffc1cb83b2:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913',
+});
+export const EXECUTABLE_YIELD_MARKETS = deepFreeze([
+    BASE_USDC_AAVE_V3_MARKET,
+    BASE_USDC_MORPHO_GAUNTLET_PRIME_MARKET,
+    BASE_USDC_MORPHO_STEAKHOUSE_PRIME_MARKET,
+]);
+function canonicalJson(value) {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean') {
+        return JSON.stringify(value);
+    }
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value))
+            throw new Error('executable yield registry contains a non-finite number');
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value))
+        return `[${value.map(canonicalJson).join(',')}]`;
+    if (typeof value === 'object') {
+        const entries = Object.entries(value).sort(([left], [right]) => left.localeCompare(right));
+        return `{${entries
+            .map(([key, nested]) => `${JSON.stringify(key)}:${canonicalJson(nested)}`)
+            .join(',')}}`;
+    }
+    throw new Error('executable yield registry contains a non-canonical value');
+}
+/** SHA-256 commitment over every enumerable field in the complete, canonical registry record. */
+export function getExecutableYieldMarketCommitment(market) {
+    const canonical = canonicalJson(market);
+    const digest = createHash('sha256')
+        .update(`otto:executable-yield-market:v1:${canonical}`, 'utf8')
+        .digest('hex');
+    return `sha256:${digest}`;
+}
+export function getExecutableYieldMarket(marketId) {
+    return EXECUTABLE_YIELD_MARKETS.find((market) => market.id === marketId) ?? null;
+}
+//# sourceMappingURL=executable-yield-markets.js.map

package/dist/execution-account-gas-quote.d.ts

@@ -0,0 +1,141 @@
+import { type PublicClient } from 'viem';
+import { z } from 'zod';
+declare const callsSchema: z.ZodArray<z.ZodObject<{
+    to: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    data: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    value: z.ZodString;
+}, z.core.$strict>>;
+declare const bindingSchema: z.ZodObject<{
+    account: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    chainId: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<8453>, z.ZodLiteral<42161>, z.ZodLiteral<10>, z.ZodLiteral<137>]>;
+    entryPoint: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    calls: z.ZodArray<z.ZodObject<{
+        to: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        data: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        value: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const priceSchema: z.ZodObject<{
+    amountAtomic: z.ZodString;
+    decimals: z.ZodNumber;
+    observedAtMs: z.ZodNumber;
+    expiresAtMs: z.ZodNumber;
+}, z.core.$strict>;
+declare const sponsorSchema: z.ZodObject<{
+    paymaster: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    sponsorshipPolicyId: z.ZodString;
+}, z.core.$strict>;
+export type AccountGasQuoteCall = z.input<typeof callsSchema>[number];
+export type AccountGasQuoteBinding = Omit<z.input<typeof bindingSchema>, 'calls'> & {
+    calls: readonly AccountGasQuoteCall[];
+};
+export type AccountGasQuoteUsdPrice = z.input<typeof priceSchema>;
+/** The block anchor covers balance, deposit and nonce only. The bundler estimate has no block parameter. */
+export declare const ACCOUNT_GAS_QUOTE_SCHEMA: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    kind: z.ZodLiteral<"estimate">;
+    payer: z.ZodLiteral<"user">;
+    account: z.ZodString;
+    chainId: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<8453>, z.ZodLiteral<42161>, z.ZodLiteral<10>, z.ZodLiteral<137>]>;
+    entryPoint: z.ZodString;
+    nativeAsset: z.ZodObject<{
+        symbol: z.ZodEnum<{
+            ETH: "ETH";
+            POL: "POL";
+        }>;
+        decimals: z.ZodLiteral<18>;
+    }, z.core.$strict>;
+    callsCommitment: z.ZodString;
+    nonce: z.ZodString;
+    blockNumber: z.ZodString;
+    blockHash: z.ZodString;
+    blockTimestampMs: z.ZodNumber;
+    observedAtMs: z.ZodNumber;
+    expiresAtMs: z.ZodNumber;
+    simulation: z.ZodLiteral<"sender-balance-override">;
+    providerEstimate: z.ZodObject<{
+        blockAnchor: z.ZodLiteral<"unanchored">;
+        startedAtMs: z.ZodNumber;
+        completedAtMs: z.ZodNumber;
+        elapsedMs: z.ZodNumber;
+    }, z.core.$strict>;
+    gas: z.ZodObject<{
+        callGasLimit: z.ZodString;
+        verificationGasLimit: z.ZodString;
+        preVerificationGas: z.ZodString;
+        maxFeePerGasWei: z.ZodString;
+        maxPriorityFeePerGasWei: z.ZodString;
+        estimatedPrefundWei: z.ZodString;
+        reserveWei: z.ZodString;
+        estimatedRequiredWei: z.ZodString;
+        reserveBps: z.ZodLiteral<"2500">;
+    }, z.core.$strict>;
+    balance: z.ZodObject<{
+        nativeWei: z.ZodString;
+        entryPointDepositWei: z.ZodString;
+        callValueWei: z.ZodString;
+        depositAppliedToGasWei: z.ZodString;
+        walletGasRequirementWei: z.ZodString;
+        nativeAvailableForGasWei: z.ZodString;
+        gasShortfallWei: z.ZodString;
+        requiredNativeWei: z.ZodString;
+        shortfallWei: z.ZodString;
+    }, z.core.$strict>;
+    usdPrice: z.ZodOptional<z.ZodObject<{
+        amountAtomic: z.ZodString;
+        decimals: z.ZodNumber;
+        observedAtMs: z.ZodNumber;
+        expiresAtMs: z.ZodNumber;
+    }, z.core.$strict>>;
+    estimatedGasCostUsdMicros: z.ZodOptional<z.ZodString>;
+    sponsoredEstimate: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodLiteral<"estimate">;
+        simulation: z.ZodLiteral<"paymaster-stub">;
+        entryPointVersion: z.ZodLiteral<"0.6">;
+        paymaster: z.ZodString;
+        sponsorshipPolicyId: z.ZodString;
+        paymasterAndDataCommitment: z.ZodString;
+        providerEstimate: z.ZodObject<{
+            blockAnchor: z.ZodLiteral<"unanchored">;
+            startedAtMs: z.ZodNumber;
+            completedAtMs: z.ZodNumber;
+            elapsedMs: z.ZodNumber;
+        }, z.core.$strict>;
+        gas: z.ZodObject<{
+            callGasLimit: z.ZodString;
+            verificationGasLimit: z.ZodString;
+            preVerificationGas: z.ZodString;
+            maxFeePerGasWei: z.ZodString;
+            maxPriorityFeePerGasWei: z.ZodString;
+            verificationGasMultiplier: z.ZodLiteral<"3">;
+            estimatedPrefundWei: z.ZodString;
+            reserveWei: z.ZodString;
+            estimatedRequiredWei: z.ZodString;
+            reserveBps: z.ZodLiteral<"2500">;
+        }, z.core.$strict>;
+        estimatedGasCostUsdMicros: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type AccountGasQuote = z.infer<typeof ACCOUNT_GAS_QUOTE_SCHEMA>;
+export declare class AccountGasQuoteError extends Error {
+    readonly code = "ACCOUNT_GAS_QUOTE_UNAVAILABLE";
+    constructor(message?: string);
+}
+export declare function accountGasCallsCommitment(calls: readonly AccountGasQuoteCall[]): string;
+export interface PrepareAccountGasQuoteInput extends AccountGasQuoteBinding {
+    client: PublicClient;
+    /** Operator-configured Pimlico endpoint. Kept out of quotes, hashes and errors. */
+    paymasterUrl: string;
+    fetch?: typeof globalThis.fetch;
+    nowMs?: () => number;
+    monotonicNowMs?: () => number;
+    /** Optional separately sourced advisory USD price. Missing means unavailable, never zero. */
+    usdPrice?: AccountGasQuoteUsdPrice;
+    /** Already reviewed source activation identity, never selected by the end user. */
+    sponsor?: z.input<typeof sponsorSchema>;
+}
+/** No signer, paymaster sponsorship, submission, account authority or account code reads. */
+export declare function prepareAccountGasQuote(input: PrepareAccountGasQuoteInput): Promise<AccountGasQuote>;
+/** Call synchronously at request start. Persisted copies retain wall-clock expiry but no process-local clock proof. */
+export declare function assertFreshAccountGasQuote(value: AccountGasQuote, input: AccountGasQuoteBinding, nowMs?: number): void;
+export {};