@xochi/client 0.0.0-stage → 0.1.1

package/dist/cjs/shared/schemas.d.ts

@@ -0,0 +1,928 @@
+/**
+ * Zod Schemas
+ *
+ * The Worker's quote and execute RESPONSE wire contract (`/api/intent/quote`,
+ * `/api/intent/execute`), with the primitives it closes over. Types are derived
+ * from schemas via z.infer -- single source of truth.
+ */
+import { z } from "zod";
+/** Ethereum address: 0x-prefixed, 42 hex chars. Single source: validators.ts. */
+export declare const ethAddress: z.ZodString;
+/**
+ * Tron base58check address: leading `T`, 34 chars, base58 alphabet (no
+ * 0/O/I/l). Structural check mirroring `TRON_ADDRESS_REGEX` in validators.ts;
+ * kept inline here so the schema module stays free of the viem import chain.
+ */
+export declare const tronAddress: z.ZodString;
+/**
+ * Recipient address for a non-EVM destination: the user's own address on the
+ * destination chain (EVM routes settle to the signing wallet, so it is
+ * optional). EVM hex20 or Tron base58.
+ */
+export declare const recipientAddress: z.ZodUnion<[z.ZodString, z.ZodString]>;
+/** Settlement type */
+export declare const settlementType: z.ZodEnum<["public", "shielded", "stealth"]>;
+/**
+ * Pull+gas payment method the quote's eip712 authorizes.
+ *
+ * `deposit` is the odd one out and is not a pull at all: on a non-EVM origin
+ * (Tron) the user sends the tokens themselves to a served `deposit_address`,
+ * at their own network cost, with no wallet signature anywhere in the flow.
+ * It is in this enum because it is what belongs in this FIELD, which answers
+ * "how does the origin leg get funded".
+ *
+ * Without it the wire lies: a Tron-origin quote reports `payment_method:
+ * "permit2"` next to `gasless: false` and a `deposit_address`, describing a
+ * Permit2 pull on a chain that has no Permit2. The browser papers over it
+ * (`resolvePaymentMethod` overrides to `deposit` whenever a deposit address is
+ * present), so a human never sees the wrong label; every non-browser consumer
+ * does: the MCP server, the OpenAPI contract, and any agent branching on this
+ * field to decide whether to prepare a signature.
+ */
+export declare const paymentMethod: z.ZodEnum<["erc3009", "permit2", "pimlico", "x402", "mpp", "approval", "deposit"]>;
+/**
+ * A referral code as stored (xochi#583): 3-32 of `A-Z 0-9 _ -`, starting with a
+ * letter or digit. Stored and compared uppercase, so a link's `?ref=summer` and
+ * `SUMMER` are the same code. Migration 0019 enforces the same shape.
+ */
+export declare const REFERRAL_CODE_REGEX: RegExp;
+/**
+ * The note served when a `ref` was sent and is not applied. ONE text for every
+ * reason (unknown, expired, revoked, scoped to another key, a key that does not
+ * accept referrals, self-referral): a per-reason note would let a caller
+ * enumerate which codes exist.
+ */
+export declare const REFERRAL_NOT_APPLIED_NOTE = "Referral code not applied.";
+/**
+ * The neutral referral line (xochi#603): served on a quote whose `ref` was
+ * applied when the request is not signed in as the quoting wallet. One fixed
+ * text, identical whether or not the wallet has a referral binding.
+ */
+export declare const REFERRAL_NEUTRAL_NOTE = "A referrer may earn part of the routing fee on this trade.";
+export declare const QuoteReferralSchema: z.ZodUnion<[z.ZodObject<{
+    code: z.ZodString;
+    name: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    code: string;
+    name: string;
+}, {
+    code: string;
+    name: string;
+}>, z.ZodObject<{
+    neutral: z.ZodLiteral<true>;
+    note: z.ZodLiteral<"A referrer may earn part of the routing fee on this trade.">;
+}, "strict", z.ZodTypeAny, {
+    neutral: true;
+    note: "A referrer may earn part of the routing fee on this trade.";
+}, {
+    neutral: true;
+    note: "A referrer may earn part of the routing fee on this trade.";
+}>]>;
+/**
+ * A promo code as stored (xochi#584): 3-32 of `A-Z 0-9 _ -`, starting with a
+ * letter or digit. Stored and compared uppercase, so `launch10` and `LAUNCH10`
+ * are the same code. Migration 0020 enforces the same shape.
+ */
+export declare const PROMO_CODE_REGEX: RegExp;
+/**
+ * The inline error served when a `promo` was sent and cannot be used. ONE text
+ * for every reason (unknown, malformed, expired, revoked, used up, used up by
+ * this wallet, not accepted under this publishable key, lookup ceiling, the
+ * feature off): a per-reason message would let a caller enumerate which codes
+ * exist.
+ */
+export declare const PROMO_NOT_APPLIED_NOTE = "This code can't be applied.";
+/**
+ * The note served when a valid code was sent but the caller's trust tier
+ * already discounts at least as much (discount = max(tier, capped promo), never
+ * both; an Institutional wallet always lands here). The code is
+ * not consumed.
+ */
+export declare const PROMO_TIER_BETTER_NOTE = "Your trust tier already gives you a fee at least as low as this code.";
+export declare const QuotePromoSchema: z.ZodObject<{
+    code: z.ZodString;
+    discount_bps: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    code: string;
+    discount_bps: number;
+}, {
+    code: string;
+    discount_bps: number;
+}>;
+/**
+ * EIP-712 typed data the user signs. Internal keys follow the EIP-712
+ * standard (camelCase: domain.chainId, domain.verifyingContract, primaryType)
+ * and are part of the signed payload -- they are intentionally NOT snake_cased.
+ * Passed through verbatim from the solver. Mirrors the `Eip712TypedData`
+ * schema in public/openapi.yaml.
+ */
+export declare const Eip712TypedDataSchema: z.ZodObject<{
+    domain: z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodString;
+        chainId: z.ZodNumber;
+        verifyingContract: z.ZodOptional<z.ZodString>;
+        salt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version: string;
+        chainId: number;
+        verifyingContract?: string | undefined;
+        salt?: string | undefined;
+    }, {
+        name: string;
+        version: string;
+        chainId: number;
+        verifyingContract?: string | undefined;
+        salt?: string | undefined;
+    }>;
+    types: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        name: string;
+    }, {
+        type: string;
+        name: string;
+    }>, "many">>;
+    primaryType: z.ZodString;
+    message: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    message: Record<string, unknown>;
+    domain: {
+        name: string;
+        version: string;
+        chainId: number;
+        verifyingContract?: string | undefined;
+        salt?: string | undefined;
+    };
+    types: Record<string, {
+        type: string;
+        name: string;
+    }[]>;
+    primaryType: string;
+}, {
+    message: Record<string, unknown>;
+    domain: {
+        name: string;
+        version: string;
+        chainId: number;
+        verifyingContract?: string | undefined;
+        salt?: string | undefined;
+    };
+    types: Record<string, {
+        type: string;
+        name: string;
+    }[]>;
+    primaryType: string;
+}>;
+export declare const SettlementOptionSchema: z.ZodObject<{
+    type: z.ZodEnum<["public", "shielded", "stealth"]>;
+    available: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "public" | "shielded" | "stealth";
+    available: boolean;
+    reason?: string | undefined;
+}, {
+    type: "public" | "shielded" | "stealth";
+    available: boolean;
+    reason?: string | undefined;
+}>;
+export declare const ClaimInfoSchema: z.ZodObject<{
+    factory_address: z.ZodString;
+    salt: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    salt: number;
+    factory_address: string;
+}, {
+    salt: number;
+    factory_address: string;
+}>;
+/**
+ * Itemized fee breakdown (economics.md Part 1). snake_case wire shape the worker
+ * emits and the frontend renders against. Layers are three additive bps lines on
+ * a never-discounted cost floor (solver + gas), plus venue and routing.
+ *
+ * The layer AMOUNTS carry no denomination of their own. The token they are
+ * measured in is named by `fee_denomination` on the enclosing quote response.
+ */
+export declare const FeeBreakdownSchema: z.ZodObject<{
+    tier: z.ZodEnum<["standard", "trusted", "verified", "premium", "institutional"]>;
+    asset_class: z.ZodEnum<["stable", "volatile"]>;
+    gas_floor: z.ZodObject<{
+        amount: z.ZodString;
+        usd: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        amount: string;
+        usd: string;
+    }, {
+        amount: string;
+        usd: string;
+    }>;
+    solver_fee_bps: z.ZodNumber;
+    solver_fee: z.ZodString;
+    price_impact_bps: z.ZodNumber;
+    price_impact: z.ZodString;
+    venue_fee_bps: z.ZodNumber;
+    venue_fee: z.ZodString;
+    routing_fee_bps: z.ZodNumber;
+    routing_fee: z.ZodString;
+    total_bps: z.ZodNumber;
+    total_fee: z.ZodString;
+    total_usd: z.ZodString;
+    surplus_share_pct: z.ZodNumber;
+    discount: z.ZodOptional<z.ZodObject<{
+        source: z.ZodEnum<["tier", "promo"]>;
+        bps: z.ZodNumber;
+        amount: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        amount: string;
+        source: "tier" | "promo";
+        bps: number;
+    }, {
+        amount: string;
+        source: "tier" | "promo";
+        bps: number;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    tier: "standard" | "trusted" | "verified" | "premium" | "institutional";
+    asset_class: "stable" | "volatile";
+    gas_floor: {
+        amount: string;
+        usd: string;
+    };
+    solver_fee_bps: number;
+    solver_fee: string;
+    price_impact_bps: number;
+    price_impact: string;
+    venue_fee_bps: number;
+    venue_fee: string;
+    routing_fee_bps: number;
+    routing_fee: string;
+    total_bps: number;
+    total_fee: string;
+    total_usd: string;
+    surplus_share_pct: number;
+    discount?: {
+        amount: string;
+        source: "tier" | "promo";
+        bps: number;
+    } | undefined;
+}, {
+    tier: "standard" | "trusted" | "verified" | "premium" | "institutional";
+    asset_class: "stable" | "volatile";
+    gas_floor: {
+        amount: string;
+        usd: string;
+    };
+    solver_fee_bps: number;
+    solver_fee: string;
+    price_impact_bps: number;
+    price_impact: string;
+    venue_fee_bps: number;
+    venue_fee: string;
+    routing_fee_bps: number;
+    routing_fee: string;
+    total_bps: number;
+    total_fee: string;
+    total_usd: string;
+    surplus_share_pct: number;
+    discount?: {
+        amount: string;
+        source: "tier" | "promo";
+        bps: number;
+    } | undefined;
+}>;
+/**
+ * Which token the `fee_breakdown` layer amounts are measured in. See the
+ * `fee_denomination` field on {@link QuoteResponseSchema}.
+ */
+export declare const FeeDenominationSchema: z.ZodEnum<["origin", "destination"]>;
+/** Which token a served `fee_breakdown`'s layer amounts are denominated in. */
+export type FeeDenomination = z.infer<typeof FeeDenominationSchema>;
+/**
+ * The WIRE shape of a fee breakdown (snake_case), distinct from the camelCase
+ * `FeeBreakdown` domain type in `types.ts`. Named apart on purpose: the two
+ * describe the same fifteen values in two different casings, and a worker that
+ * forwards the wire form must not be handed the domain type by mistake.
+ * `mapQuoteResponse` is the one place that converts between them.
+ */
+export type FeeBreakdownWire = z.infer<typeof FeeBreakdownSchema>;
+/**
+ * Canonical quote response: the Xochi worker's `/api/intent/quote` output and
+ * the pinned agent contract. snake_case envelope; the `eip712` value is
+ * verbatim EIP-712 typed data. When `can_solve` is true, `to_amount`,
+ * `payment_method`, and `eip712` are present. Mirrors `QuoteResponse` in
+ * public/openapi.yaml -- keep all three in lockstep.
+ */
+export declare const QuoteResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    intent_id: z.ZodString;
+    quote_id: z.ZodString;
+    can_solve: z.ZodBoolean;
+    /** Non-executable price exploration: never persisted and carries no signing material. */
+    preview: z.ZodOptional<z.ZodBoolean>;
+    to_amount: z.ZodOptional<z.ZodString>;
+    min_to_amount: z.ZodOptional<z.ZodString>;
+    xochi_fee: z.ZodOptional<z.ZodString>;
+    xochi_fee_rate: z.ZodOptional<z.ZodString>;
+    cost_bps: z.ZodOptional<z.ZodNumber>;
+    fee_breakdown: z.ZodOptional<z.ZodObject<{
+        tier: z.ZodEnum<["standard", "trusted", "verified", "premium", "institutional"]>;
+        asset_class: z.ZodEnum<["stable", "volatile"]>;
+        gas_floor: z.ZodObject<{
+            amount: z.ZodString;
+            usd: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            amount: string;
+            usd: string;
+        }, {
+            amount: string;
+            usd: string;
+        }>;
+        solver_fee_bps: z.ZodNumber;
+        solver_fee: z.ZodString;
+        price_impact_bps: z.ZodNumber;
+        price_impact: z.ZodString;
+        venue_fee_bps: z.ZodNumber;
+        venue_fee: z.ZodString;
+        routing_fee_bps: z.ZodNumber;
+        routing_fee: z.ZodString;
+        total_bps: z.ZodNumber;
+        total_fee: z.ZodString;
+        total_usd: z.ZodString;
+        surplus_share_pct: z.ZodNumber;
+        discount: z.ZodOptional<z.ZodObject<{
+            source: z.ZodEnum<["tier", "promo"]>;
+            bps: z.ZodNumber;
+            amount: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            amount: string;
+            source: "tier" | "promo";
+            bps: number;
+        }, {
+            amount: string;
+            source: "tier" | "promo";
+            bps: number;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        tier: "standard" | "trusted" | "verified" | "premium" | "institutional";
+        asset_class: "stable" | "volatile";
+        gas_floor: {
+            amount: string;
+            usd: string;
+        };
+        solver_fee_bps: number;
+        solver_fee: string;
+        price_impact_bps: number;
+        price_impact: string;
+        venue_fee_bps: number;
+        venue_fee: string;
+        routing_fee_bps: number;
+        routing_fee: string;
+        total_bps: number;
+        total_fee: string;
+        total_usd: string;
+        surplus_share_pct: number;
+        discount?: {
+            amount: string;
+            source: "tier" | "promo";
+            bps: number;
+        } | undefined;
+    }, {
+        tier: "standard" | "trusted" | "verified" | "premium" | "institutional";
+        asset_class: "stable" | "volatile";
+        gas_floor: {
+            amount: string;
+            usd: string;
+        };
+        solver_fee_bps: number;
+        solver_fee: string;
+        price_impact_bps: number;
+        price_impact: string;
+        venue_fee_bps: number;
+        venue_fee: string;
+        routing_fee_bps: number;
+        routing_fee: string;
+        total_bps: number;
+        total_fee: string;
+        total_usd: string;
+        surplus_share_pct: number;
+        discount?: {
+            amount: string;
+            source: "tier" | "promo";
+            bps: number;
+        } | undefined;
+    }>>;
+    fee_denomination: z.ZodOptional<z.ZodEnum<["origin", "destination"]>>;
+    referral: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        code: z.ZodString;
+        name: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        code: string;
+        name: string;
+    }, {
+        code: string;
+        name: string;
+    }>, z.ZodObject<{
+        neutral: z.ZodLiteral<true>;
+        note: z.ZodLiteral<"A referrer may earn part of the routing fee on this trade.">;
+    }, "strict", z.ZodTypeAny, {
+        neutral: true;
+        note: "A referrer may earn part of the routing fee on this trade.";
+    }, {
+        neutral: true;
+        note: "A referrer may earn part of the routing fee on this trade.";
+    }>]>>;
+    referral_note: z.ZodOptional<z.ZodLiteral<"Referral code not applied.">>;
+    promo: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        discount_bps: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        code: string;
+        discount_bps: number;
+    }, {
+        code: string;
+        discount_bps: number;
+    }>>;
+    promo_note: z.ZodOptional<z.ZodEnum<["This code can't be applied.", "Your trust tier already gives you a fee at least as low as this code."]>>;
+    estimated_gas_cost: z.ZodOptional<z.ZodString>;
+    stream_topic: z.ZodOptional<z.ZodString>;
+    expiry: z.ZodString;
+    gasless: z.ZodOptional<z.ZodBoolean>;
+    gasless_fee: z.ZodOptional<z.ZodString>;
+    payment_method: z.ZodOptional<z.ZodEnum<["erc3009", "permit2", "pimlico", "x402", "mpp", "approval", "deposit"]>>;
+    route: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    eip712: z.ZodOptional<z.ZodObject<{
+        domain: z.ZodObject<{
+            name: z.ZodString;
+            version: z.ZodString;
+            chainId: z.ZodNumber;
+            verifyingContract: z.ZodOptional<z.ZodString>;
+            salt: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            version: string;
+            chainId: number;
+            verifyingContract?: string | undefined;
+            salt?: string | undefined;
+        }, {
+            name: string;
+            version: string;
+            chainId: number;
+            verifyingContract?: string | undefined;
+            salt?: string | undefined;
+        }>;
+        types: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            name: string;
+        }, {
+            type: string;
+            name: string;
+        }>, "many">>;
+        primaryType: z.ZodString;
+        message: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        message: Record<string, unknown>;
+        domain: {
+            name: string;
+            version: string;
+            chainId: number;
+            verifyingContract?: string | undefined;
+            salt?: string | undefined;
+        };
+        types: Record<string, {
+            type: string;
+            name: string;
+        }[]>;
+        primaryType: string;
+    }, {
+        message: Record<string, unknown>;
+        domain: {
+            name: string;
+            version: string;
+            chainId: number;
+            verifyingContract?: string | undefined;
+            salt?: string | undefined;
+        };
+        types: Record<string, {
+            type: string;
+            name: string;
+        }[]>;
+        primaryType: string;
+    }>>;
+    pull_authorization: z.ZodOptional<z.ZodObject<{
+        domain: z.ZodObject<{
+            name: z.ZodString;
+            version: z.ZodString;
+            chainId: z.ZodNumber;
+            verifyingContract: z.ZodOptional<z.ZodString>;
+            salt: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            version: string;
+            chainId: number;
+            verifyingContract?: string | undefined;
+            salt?: string | undefined;
+        }, {
+            name: string;
+            version: string;
+            chainId: number;
+            verifyingContract?: string | undefined;
+            salt?: string | undefined;
+        }>;
+        types: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            name: string;
+        }, {
+            type: string;
+            name: string;
+        }>, "many">>;
+        primaryType: z.ZodString;
+        message: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        message: Record<string, unknown>;
+        domain: {
+            name: string;
+            version: string;
+            chainId: number;
+            verifyingContract?: string | undefined;
+            salt?: string | undefined;
+        };
+        types: Record<string, {
+            type: string;
+            name: string;
+        }[]>;
+        primaryType: string;
+    }, {
+        message: Record<string, unknown>;
+        domain: {
+            name: string;
+            version: string;
+            chainId: number;
+            verifyingContract?: string | undefined;
+            salt?: string | undefined;
+        };
+        types: Record<string, {
+            type: string;
+            name: string;
+        }[]>;
+        primaryType: string;
+    }>>;
+    deposit_address: z.ZodOptional<z.ZodString>;
+    deposit_attestation: z.ZodOptional<z.ZodString>;
+    deposit_deadline: z.ZodOptional<z.ZodNumber>;
+    recipient_address: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodString]>>;
+    settlement_options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["public", "shielded", "stealth"]>;
+        available: z.ZodBoolean;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "public" | "shielded" | "stealth";
+        available: boolean;
+        reason?: string | undefined;
+    }, {
+        type: "public" | "shielded" | "stealth";
+        available: boolean;
+        reason?: string | undefined;
+    }>, "many">>;
+    claim_info: z.ZodOptional<z.ZodObject<{
+        factory_address: z.ZodString;
+        salt: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        salt: number;
+        factory_address: string;
+    }, {
+        salt: number;
+        factory_address: string;
+    }>>;
+    nonce: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+    error_category: z.ZodOptional<z.ZodString>;
+    detail: z.ZodOptional<z.ZodString>;
+    minimum_amount_usd: z.ZodOptional<z.ZodNumber>;
+    min_fillable_usd: z.ZodOptional<z.ZodNumber>;
+    max_order_usd: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    success: boolean;
+    intent_id: string;
+    quote_id: string;
+    can_solve: boolean;
+    expiry: string;
+    promo?: {
+        code: string;
+        discount_bps: number;
+    } | undefined;
+    preview?: boolean | undefined;
+    to_amount?: string | undefined;
+    min_to_amount?: string | undefined;
+    xochi_fee?: string | undefined;
+    xochi_fee_rate?: string | undefined;
+    cost_bps?: number | undefined;
+    fee_breakdown?: {
+        tier: "standard" | "trusted" | "verified" | "premium" | "institutional";
+        asset_class: "stable" | "volatile";
+        gas_floor: {
+            amount: string;
+            usd: string;
+        };
+        solver_fee_bps: number;
+        solver_fee: string;
+        price_impact_bps: number;
+        price_impact: string;
+        venue_fee_bps: number;
+        venue_fee: string;
+        routing_fee_bps: number;
+        routing_fee: string;
+        total_bps: number;
+        total_fee: string;
+        total_usd: string;
+        surplus_share_pct: number;
+        discount?: {
+            amount: string;
+            source: "tier" | "promo";
+            bps: number;
+        } | undefined;
+    } | undefined;
+    fee_denomination?: "origin" | "destination" | undefined;
+    referral?: {
+        code: string;
+        name: string;
+    } | {
+        neutral: true;
+        note: "A referrer may earn part of the routing fee on this trade.";
+    } | undefined;
+    referral_note?: "Referral code not applied." | undefined;
+    promo_note?: "This code can't be applied." | "Your trust tier already gives you a fee at least as low as this code." | undefined;
+    estimated_gas_cost?: string | undefined;
+    stream_topic?: string | undefined;
+    gasless?: boolean | undefined;
+    gasless_fee?: string | undefined;
+    payment_method?: "erc3009" | "permit2" | "pimlico" | "x402" | "mpp" | "approval" | "deposit" | undefined;
+    route?: Record<string, unknown> | undefined;
+    eip712?: {
+        message: Record<string, unknown>;
+        domain: {
+            name: string;
+            version: string;
+            chainId: number;
+            verifyingContract?: string | undefined;
+            salt?: string | undefined;
+        };
+        types: Record<string, {
+            type: string;
+            name: string;
+        }[]>;
+        primaryType: string;
+    } | undefined;
+    pull_authorization?: {
+        message: Record<string, unknown>;
+        domain: {
+            name: string;
+            version: string;
+            chainId: number;
+            verifyingContract?: string | undefined;
+            salt?: string | undefined;
+        };
+        types: Record<string, {
+            type: string;
+            name: string;
+        }[]>;
+        primaryType: string;
+    } | undefined;
+    deposit_address?: string | undefined;
+    deposit_attestation?: string | undefined;
+    deposit_deadline?: number | undefined;
+    recipient_address?: string | undefined;
+    settlement_options?: {
+        type: "public" | "shielded" | "stealth";
+        available: boolean;
+        reason?: string | undefined;
+    }[] | undefined;
+    claim_info?: {
+        salt: number;
+        factory_address: string;
+    } | undefined;
+    nonce?: number | undefined;
+    error?: string | undefined;
+    error_category?: string | undefined;
+    detail?: string | undefined;
+    minimum_amount_usd?: number | undefined;
+    min_fillable_usd?: number | undefined;
+    max_order_usd?: number | undefined;
+}, {
+    success: boolean;
+    intent_id: string;
+    quote_id: string;
+    can_solve: boolean;
+    expiry: string;
+    promo?: {
+        code: string;
+        discount_bps: number;
+    } | undefined;
+    preview?: boolean | undefined;
+    to_amount?: string | undefined;
+    min_to_amount?: string | undefined;
+    xochi_fee?: string | undefined;
+    xochi_fee_rate?: string | undefined;
+    cost_bps?: number | undefined;
+    fee_breakdown?: {
+        tier: "standard" | "trusted" | "verified" | "premium" | "institutional";
+        asset_class: "stable" | "volatile";
+        gas_floor: {
+            amount: string;
+            usd: string;
+        };
+        solver_fee_bps: number;
+        solver_fee: string;
+        price_impact_bps: number;
+        price_impact: string;
+        venue_fee_bps: number;
+        venue_fee: string;
+        routing_fee_bps: number;
+        routing_fee: string;
+        total_bps: number;
+        total_fee: string;
+        total_usd: string;
+        surplus_share_pct: number;
+        discount?: {
+            amount: string;
+            source: "tier" | "promo";
+            bps: number;
+        } | undefined;
+    } | undefined;
+    fee_denomination?: "origin" | "destination" | undefined;
+    referral?: {
+        code: string;
+        name: string;
+    } | {
+        neutral: true;
+        note: "A referrer may earn part of the routing fee on this trade.";
+    } | undefined;
+    referral_note?: "Referral code not applied." | undefined;
+    promo_note?: "This code can't be applied." | "Your trust tier already gives you a fee at least as low as this code." | undefined;
+    estimated_gas_cost?: string | undefined;
+    stream_topic?: string | undefined;
+    gasless?: boolean | undefined;
+    gasless_fee?: string | undefined;
+    payment_method?: "erc3009" | "permit2" | "pimlico" | "x402" | "mpp" | "approval" | "deposit" | undefined;
+    route?: Record<string, unknown> | undefined;
+    eip712?: {
+        message: Record<string, unknown>;
+        domain: {
+            name: string;
+            version: string;
+            chainId: number;
+            verifyingContract?: string | undefined;
+            salt?: string | undefined;
+        };
+        types: Record<string, {
+            type: string;
+            name: string;
+        }[]>;
+        primaryType: string;
+    } | undefined;
+    pull_authorization?: {
+        message: Record<string, unknown>;
+        domain: {
+            name: string;
+            version: string;
+            chainId: number;
+            verifyingContract?: string | undefined;
+            salt?: string | undefined;
+        };
+        types: Record<string, {
+            type: string;
+            name: string;
+        }[]>;
+        primaryType: string;
+    } | undefined;
+    deposit_address?: string | undefined;
+    deposit_attestation?: string | undefined;
+    deposit_deadline?: number | undefined;
+    recipient_address?: string | undefined;
+    settlement_options?: {
+        type: "public" | "shielded" | "stealth";
+        available: boolean;
+        reason?: string | undefined;
+    }[] | undefined;
+    claim_info?: {
+        salt: number;
+        factory_address: string;
+    } | undefined;
+    nonce?: number | undefined;
+    error?: string | undefined;
+    error_category?: string | undefined;
+    detail?: string | undefined;
+    minimum_amount_usd?: number | undefined;
+    min_fillable_usd?: number | undefined;
+    max_order_usd?: number | undefined;
+}>;
+/**
+ * Length of an intent read capability (`read_token` on the execute response,
+ * xochi#563): 32 random bytes as unpadded base64url.
+ */
+export declare const READ_TOKEN_LENGTH = 43;
+/** Shape of an intent read capability: exactly `READ_TOKEN_LENGTH` base64url characters. */
+export declare const READ_TOKEN_PATTERN: RegExp;
+/**
+ * The request header that carries a `read_token` on `GET /api/intent/:id` and
+ * `GET /api/intent/:id/status`. A header and never a query parameter: the token
+ * must not land in URLs, logs or referrers.
+ */
+export declare const READ_TOKEN_HEADER = "X-Xochi-Read-Token";
+/** Mirrors `ExecuteResponse` in public/openapi.yaml. */
+export declare const ExecuteResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    intent_id: z.ZodString;
+    status: z.ZodString;
+    tx_hash: z.ZodOptional<z.ZodString>;
+    bridge_tx_hash: z.ZodOptional<z.ZodString>;
+    receiving_tx_hash: z.ZodOptional<z.ZodString>;
+    settlement_tx_hash: z.ZodOptional<z.ZodString>;
+    settlement_chain_id: z.ZodOptional<z.ZodNumber>;
+    reconciling: z.ZodOptional<z.ZodBoolean>;
+    note_commitment: z.ZodOptional<z.ZodString>;
+    stealth_address: z.ZodOptional<z.ZodString>;
+    ephemeral_pub_key: z.ZodOptional<z.ZodString>;
+    view_tag: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+    substatus: z.ZodOptional<z.ZodLiteral<"not_executed">>;
+    read_token: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+}, "strict", z.ZodTypeAny, {
+    status: string;
+    success: boolean;
+    intent_id: string;
+    error?: string | undefined;
+    tx_hash?: string | undefined;
+    bridge_tx_hash?: string | undefined;
+    receiving_tx_hash?: string | undefined;
+    settlement_tx_hash?: string | undefined;
+    settlement_chain_id?: number | undefined;
+    reconciling?: boolean | undefined;
+    note_commitment?: string | undefined;
+    stealth_address?: string | undefined;
+    ephemeral_pub_key?: string | undefined;
+    view_tag?: number | undefined;
+    substatus?: "not_executed" | undefined;
+    read_token?: string | undefined;
+}, {
+    status: string;
+    success: boolean;
+    intent_id: string;
+    error?: string | undefined;
+    tx_hash?: string | undefined;
+    bridge_tx_hash?: string | undefined;
+    receiving_tx_hash?: string | undefined;
+    settlement_tx_hash?: string | undefined;
+    settlement_chain_id?: number | undefined;
+    reconciling?: boolean | undefined;
+    note_commitment?: string | undefined;
+    stealth_address?: string | undefined;
+    ephemeral_pub_key?: string | undefined;
+    view_tag?: number | undefined;
+    substatus?: "not_executed" | undefined;
+    read_token?: unknown;
+}>;
+/**
+ * Automatic resends of one execute after its not-accepted answer. Mirrors
+ * `MAX_EXECUTE_RESENDS` in xochi's `@xochi/shared` `schemas.ts`, the budget
+ * the Worker enforces too: the refusal that follows this many un-claims
+ * finishes the intent `failed` instead.
+ */
+export declare const MAX_EXECUTE_RESENDS = 3;
+/**
+ * A resend must reach the Worker at least this many seconds before the
+ * earliest deadline the signed request carries. Mirrors
+ * `EXECUTE_RESEND_MARGIN_SECS` in xochi's `@xochi/shared` `schemas.ts`, the
+ * margin the Worker applies before it un-claims.
+ */
+export declare const EXECUTE_RESEND_MARGIN_SECS = 5;
+/**
+ * Seconds past an unexecuted intent's signed deadline before the Worker ends
+ * it: a `quoted` market row (never claimed, or every claim undone) that an
+ * intent read (`GET /api/intent/:id` or the status poll, never the stream)
+ * finds this far past the `deadline` the user signed is finished `failed`
+ * with `NOT_EXECUTED_SUBSTATUS`, and the read serves that. Slack for clock
+ * skew between the Worker, the database (whose clock the claim's deadline
+ * check uses), the solver and the client. Measured from the signed deadline;
+ * the quote sweep's own 60 s is measured from the Worker's 30 s quote expiry
+ * and usually ends a touched row first (README "Fund safety"). Mirrors
+ * `QUOTED_EXPIRY_GRACE_SECS` in xochi's `@xochi/shared` `schemas.ts`. The
+ * machine polls an execute at least this long past the quote's deadline
+ * (`unexecutedFinishAt`).
+ */
+export declare const QUOTED_EXPIRY_GRACE_SECS = 60;
+export type Eip712TypedDataWire = z.infer<typeof Eip712TypedDataSchema>;
+export type SettlementOptionWire = z.infer<typeof SettlementOptionSchema>;
+export type ClaimInfoWire = z.infer<typeof ClaimInfoSchema>;
+export type QuoteResponseWire = z.infer<typeof QuoteResponseSchema>;
+export type ExecuteResponseWire = z.infer<typeof ExecuteResponseSchema>;