@xochi/client 0.0.0-stage → 0.1.2

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

@@ -0,0 +1,841 @@
+/**
+ * Riddler's shielded terms preview wire (`POST /xochi/shielded/preview`,
+ * Riddler#1296): the typed request and response shapes and a decoder.
+ *
+ * There is NO transport method: the preview needs a `quote`-scoped Riddler
+ * credential, so only the Xochi Worker calls it, and the Worker proxy route is
+ * a follow-up owned by xochi#635. These shapes exist so that proxy and its
+ * consumers decode the solver's answer with the same schema the solver
+ * publishes (`packages/spec/wire/openapi.json`, `ShieldedPreviewResponse`).
+ *
+ * The preview is NOT a signing payload: `preview_digest` is the EIP-712 digest
+ * of `ShieldedPreviewV1` under the `Xochi Shielded Preview` domain, which no
+ * `ShieldedTermsV1` signature verifies against (`@xochi/spec`
+ * `conformance/shielded-terms.json`, PROPOSED). `executable` is always false.
+ */
+import { z } from "zod";
+/**
+ * A 32-byte Aztec address or field element. The decoder checks the shape only;
+ * the solver has already refused zero and values at or above the BN254 modulus.
+ * A 20-byte EVM address never fits.
+ */
+export declare const aztecValue: z.ZodString;
+export declare const ShieldedNetworkIdentitySchema: z.ZodObject<{
+    aztec_chain_id: z.ZodString;
+    protocol_version: z.ZodString;
+    rollup_address: z.ZodString;
+    l1_chain_id: z.ZodString;
+    genesis_or_network_digest: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    aztec_chain_id: string;
+    protocol_version: string;
+    rollup_address: string;
+    l1_chain_id: string;
+    genesis_or_network_digest: string;
+}, {
+    aztec_chain_id: string;
+    protocol_version: string;
+    rollup_address: string;
+    l1_chain_id: string;
+    genesis_or_network_digest: string;
+}>;
+export declare const ShieldedCorridorSchema: z.ZodObject<{
+    corridor_id: z.ZodString;
+    revision: z.ZodNumber;
+    manifest_digest: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    revision: number;
+    corridor_id: string;
+    manifest_digest: string;
+}, {
+    revision: number;
+    corridor_id: string;
+    manifest_digest: string;
+}>;
+export declare const ShieldedFeeBreakdownSchema: z.ZodObject<{
+    gas_floor: z.ZodString;
+    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;
+}, "strip", z.ZodTypeAny, {
+    gas_floor: 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;
+}, {
+    gas_floor: 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;
+}>;
+/** `ShieldedPreviewV1` in snake_case: the terms minus the per-execution members. */
+export declare const ShieldedPreviewSchema: z.ZodObject<{
+    protocol_version: z.ZodLiteral<"xochi.shielded.preview.v1">;
+    environment: z.ZodString;
+    source: z.ZodObject<{
+        chain_id: z.ZodNumber;
+        token_address: z.ZodString;
+        wallet: z.ZodString;
+        collector: z.ZodString;
+        amount: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        amount: string;
+        chain_id: number;
+        token_address: string;
+        wallet: string;
+        collector: string;
+    }, {
+        amount: string;
+        chain_id: number;
+        token_address: string;
+        wallet: string;
+        collector: string;
+    }>;
+    destination: z.ZodObject<{
+        settlement_type: z.ZodLiteral<"shielded">;
+        privacy_level: z.ZodLiteral<"private">;
+        disclosure_profile: z.ZodLiteral<"recipient-private-public-amount-v1">;
+        rail: z.ZodLiteral<"a_tracer">;
+        network: z.ZodObject<{
+            aztec_chain_id: z.ZodString;
+            protocol_version: z.ZodString;
+            rollup_address: z.ZodString;
+            l1_chain_id: z.ZodString;
+            genesis_or_network_digest: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            aztec_chain_id: string;
+            protocol_version: string;
+            rollup_address: string;
+            l1_chain_id: string;
+            genesis_or_network_digest: string;
+        }, {
+            aztec_chain_id: string;
+            protocol_version: string;
+            rollup_address: string;
+            l1_chain_id: string;
+            genesis_or_network_digest: string;
+        }>;
+        corridor: z.ZodObject<{
+            corridor_id: z.ZodString;
+            revision: z.ZodNumber;
+            manifest_digest: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            revision: number;
+            corridor_id: string;
+            manifest_digest: string;
+        }, {
+            revision: number;
+            corridor_id: string;
+            manifest_digest: string;
+        }>;
+        asset_id: z.ZodString;
+        token_address: z.ZodString;
+        recipient_binding_id: z.ZodString;
+        recipient_descriptor_digest: z.ZodString;
+        recipient_address: z.ZodString;
+        amount: z.ZodString;
+        fee_payer: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        amount: string;
+        recipient_address: string;
+        token_address: string;
+        settlement_type: "shielded";
+        privacy_level: "private";
+        disclosure_profile: "recipient-private-public-amount-v1";
+        rail: "a_tracer";
+        network: {
+            aztec_chain_id: string;
+            protocol_version: string;
+            rollup_address: string;
+            l1_chain_id: string;
+            genesis_or_network_digest: string;
+        };
+        corridor: {
+            revision: number;
+            corridor_id: string;
+            manifest_digest: string;
+        };
+        asset_id: string;
+        recipient_binding_id: string;
+        recipient_descriptor_digest: string;
+        fee_payer: string;
+    }, {
+        amount: string;
+        recipient_address: string;
+        token_address: string;
+        settlement_type: "shielded";
+        privacy_level: "private";
+        disclosure_profile: "recipient-private-public-amount-v1";
+        rail: "a_tracer";
+        network: {
+            aztec_chain_id: string;
+            protocol_version: string;
+            rollup_address: string;
+            l1_chain_id: string;
+            genesis_or_network_digest: string;
+        };
+        corridor: {
+            revision: number;
+            corridor_id: string;
+            manifest_digest: string;
+        };
+        asset_id: string;
+        recipient_binding_id: string;
+        recipient_descriptor_digest: string;
+        fee_payer: string;
+    }>;
+    fee_breakdown: z.ZodObject<{
+        gas_floor: z.ZodString;
+        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;
+    }, "strip", z.ZodTypeAny, {
+        gas_floor: 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;
+    }, {
+        gas_floor: 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;
+    }>;
+    refund_address: z.ZodString;
+    refund_amount: z.ZodString;
+    collect_before: z.ZodNumber;
+    settlement_service_deadline: z.ZodNumber;
+    recipient_binding_digest: z.ZodString;
+    policy_revision: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    source: {
+        amount: string;
+        chain_id: number;
+        token_address: string;
+        wallet: string;
+        collector: string;
+    };
+    destination: {
+        amount: string;
+        recipient_address: string;
+        token_address: string;
+        settlement_type: "shielded";
+        privacy_level: "private";
+        disclosure_profile: "recipient-private-public-amount-v1";
+        rail: "a_tracer";
+        network: {
+            aztec_chain_id: string;
+            protocol_version: string;
+            rollup_address: string;
+            l1_chain_id: string;
+            genesis_or_network_digest: string;
+        };
+        corridor: {
+            revision: number;
+            corridor_id: string;
+            manifest_digest: string;
+        };
+        asset_id: string;
+        recipient_binding_id: string;
+        recipient_descriptor_digest: string;
+        fee_payer: string;
+    };
+    fee_breakdown: {
+        gas_floor: 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;
+    };
+    protocol_version: "xochi.shielded.preview.v1";
+    environment: string;
+    refund_address: string;
+    refund_amount: string;
+    collect_before: number;
+    settlement_service_deadline: number;
+    recipient_binding_digest: string;
+    policy_revision: number;
+}, {
+    source: {
+        amount: string;
+        chain_id: number;
+        token_address: string;
+        wallet: string;
+        collector: string;
+    };
+    destination: {
+        amount: string;
+        recipient_address: string;
+        token_address: string;
+        settlement_type: "shielded";
+        privacy_level: "private";
+        disclosure_profile: "recipient-private-public-amount-v1";
+        rail: "a_tracer";
+        network: {
+            aztec_chain_id: string;
+            protocol_version: string;
+            rollup_address: string;
+            l1_chain_id: string;
+            genesis_or_network_digest: string;
+        };
+        corridor: {
+            revision: number;
+            corridor_id: string;
+            manifest_digest: string;
+        };
+        asset_id: string;
+        recipient_binding_id: string;
+        recipient_descriptor_digest: string;
+        fee_payer: string;
+    };
+    fee_breakdown: {
+        gas_floor: 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;
+    };
+    protocol_version: "xochi.shielded.preview.v1";
+    environment: string;
+    refund_address: string;
+    refund_amount: string;
+    collect_before: number;
+    settlement_service_deadline: number;
+    recipient_binding_digest: string;
+    policy_revision: number;
+}>;
+export declare const ShieldedPreviewResponseSchema: z.ZodObject<{
+    executable: z.ZodLiteral<false>;
+    preview_version: z.ZodLiteral<"xochi.shielded.preview.v1">;
+    preview_digest: z.ZodString;
+    recipient_binding_digest: z.ZodString;
+    domain: z.ZodObject<{
+        name: z.ZodLiteral<"Xochi Shielded Preview">;
+        version: z.ZodLiteral<"1">;
+        chain_id: z.ZodNumber;
+        salt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: "Xochi Shielded Preview";
+        version: "1";
+        salt: string;
+        chain_id: number;
+    }, {
+        name: "Xochi Shielded Preview";
+        version: "1";
+        salt: string;
+        chain_id: number;
+    }>;
+    preview: z.ZodObject<{
+        protocol_version: z.ZodLiteral<"xochi.shielded.preview.v1">;
+        environment: z.ZodString;
+        source: z.ZodObject<{
+            chain_id: z.ZodNumber;
+            token_address: z.ZodString;
+            wallet: z.ZodString;
+            collector: z.ZodString;
+            amount: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            amount: string;
+            chain_id: number;
+            token_address: string;
+            wallet: string;
+            collector: string;
+        }, {
+            amount: string;
+            chain_id: number;
+            token_address: string;
+            wallet: string;
+            collector: string;
+        }>;
+        destination: z.ZodObject<{
+            settlement_type: z.ZodLiteral<"shielded">;
+            privacy_level: z.ZodLiteral<"private">;
+            disclosure_profile: z.ZodLiteral<"recipient-private-public-amount-v1">;
+            rail: z.ZodLiteral<"a_tracer">;
+            network: z.ZodObject<{
+                aztec_chain_id: z.ZodString;
+                protocol_version: z.ZodString;
+                rollup_address: z.ZodString;
+                l1_chain_id: z.ZodString;
+                genesis_or_network_digest: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                aztec_chain_id: string;
+                protocol_version: string;
+                rollup_address: string;
+                l1_chain_id: string;
+                genesis_or_network_digest: string;
+            }, {
+                aztec_chain_id: string;
+                protocol_version: string;
+                rollup_address: string;
+                l1_chain_id: string;
+                genesis_or_network_digest: string;
+            }>;
+            corridor: z.ZodObject<{
+                corridor_id: z.ZodString;
+                revision: z.ZodNumber;
+                manifest_digest: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                revision: number;
+                corridor_id: string;
+                manifest_digest: string;
+            }, {
+                revision: number;
+                corridor_id: string;
+                manifest_digest: string;
+            }>;
+            asset_id: z.ZodString;
+            token_address: z.ZodString;
+            recipient_binding_id: z.ZodString;
+            recipient_descriptor_digest: z.ZodString;
+            recipient_address: z.ZodString;
+            amount: z.ZodString;
+            fee_payer: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            amount: string;
+            recipient_address: string;
+            token_address: string;
+            settlement_type: "shielded";
+            privacy_level: "private";
+            disclosure_profile: "recipient-private-public-amount-v1";
+            rail: "a_tracer";
+            network: {
+                aztec_chain_id: string;
+                protocol_version: string;
+                rollup_address: string;
+                l1_chain_id: string;
+                genesis_or_network_digest: string;
+            };
+            corridor: {
+                revision: number;
+                corridor_id: string;
+                manifest_digest: string;
+            };
+            asset_id: string;
+            recipient_binding_id: string;
+            recipient_descriptor_digest: string;
+            fee_payer: string;
+        }, {
+            amount: string;
+            recipient_address: string;
+            token_address: string;
+            settlement_type: "shielded";
+            privacy_level: "private";
+            disclosure_profile: "recipient-private-public-amount-v1";
+            rail: "a_tracer";
+            network: {
+                aztec_chain_id: string;
+                protocol_version: string;
+                rollup_address: string;
+                l1_chain_id: string;
+                genesis_or_network_digest: string;
+            };
+            corridor: {
+                revision: number;
+                corridor_id: string;
+                manifest_digest: string;
+            };
+            asset_id: string;
+            recipient_binding_id: string;
+            recipient_descriptor_digest: string;
+            fee_payer: string;
+        }>;
+        fee_breakdown: z.ZodObject<{
+            gas_floor: z.ZodString;
+            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;
+        }, "strip", z.ZodTypeAny, {
+            gas_floor: 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;
+        }, {
+            gas_floor: 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;
+        }>;
+        refund_address: z.ZodString;
+        refund_amount: z.ZodString;
+        collect_before: z.ZodNumber;
+        settlement_service_deadline: z.ZodNumber;
+        recipient_binding_digest: z.ZodString;
+        policy_revision: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        source: {
+            amount: string;
+            chain_id: number;
+            token_address: string;
+            wallet: string;
+            collector: string;
+        };
+        destination: {
+            amount: string;
+            recipient_address: string;
+            token_address: string;
+            settlement_type: "shielded";
+            privacy_level: "private";
+            disclosure_profile: "recipient-private-public-amount-v1";
+            rail: "a_tracer";
+            network: {
+                aztec_chain_id: string;
+                protocol_version: string;
+                rollup_address: string;
+                l1_chain_id: string;
+                genesis_or_network_digest: string;
+            };
+            corridor: {
+                revision: number;
+                corridor_id: string;
+                manifest_digest: string;
+            };
+            asset_id: string;
+            recipient_binding_id: string;
+            recipient_descriptor_digest: string;
+            fee_payer: string;
+        };
+        fee_breakdown: {
+            gas_floor: 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;
+        };
+        protocol_version: "xochi.shielded.preview.v1";
+        environment: string;
+        refund_address: string;
+        refund_amount: string;
+        collect_before: number;
+        settlement_service_deadline: number;
+        recipient_binding_digest: string;
+        policy_revision: number;
+    }, {
+        source: {
+            amount: string;
+            chain_id: number;
+            token_address: string;
+            wallet: string;
+            collector: string;
+        };
+        destination: {
+            amount: string;
+            recipient_address: string;
+            token_address: string;
+            settlement_type: "shielded";
+            privacy_level: "private";
+            disclosure_profile: "recipient-private-public-amount-v1";
+            rail: "a_tracer";
+            network: {
+                aztec_chain_id: string;
+                protocol_version: string;
+                rollup_address: string;
+                l1_chain_id: string;
+                genesis_or_network_digest: string;
+            };
+            corridor: {
+                revision: number;
+                corridor_id: string;
+                manifest_digest: string;
+            };
+            asset_id: string;
+            recipient_binding_id: string;
+            recipient_descriptor_digest: string;
+            fee_payer: string;
+        };
+        fee_breakdown: {
+            gas_floor: 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;
+        };
+        protocol_version: "xochi.shielded.preview.v1";
+        environment: string;
+        refund_address: string;
+        refund_amount: string;
+        collect_before: number;
+        settlement_service_deadline: number;
+        recipient_binding_digest: string;
+        policy_revision: number;
+    }>;
+    manifest: z.ZodObject<{
+        manifest_digest: z.ZodString;
+        aztec_sdk_version: z.ZodString;
+        recipient_account_class_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        manifest_digest: string;
+        aztec_sdk_version: string;
+        recipient_account_class_id: string;
+    }, {
+        manifest_digest: string;
+        aztec_sdk_version: string;
+        recipient_account_class_id: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    domain: {
+        name: "Xochi Shielded Preview";
+        version: "1";
+        salt: string;
+        chain_id: number;
+    };
+    preview: {
+        source: {
+            amount: string;
+            chain_id: number;
+            token_address: string;
+            wallet: string;
+            collector: string;
+        };
+        destination: {
+            amount: string;
+            recipient_address: string;
+            token_address: string;
+            settlement_type: "shielded";
+            privacy_level: "private";
+            disclosure_profile: "recipient-private-public-amount-v1";
+            rail: "a_tracer";
+            network: {
+                aztec_chain_id: string;
+                protocol_version: string;
+                rollup_address: string;
+                l1_chain_id: string;
+                genesis_or_network_digest: string;
+            };
+            corridor: {
+                revision: number;
+                corridor_id: string;
+                manifest_digest: string;
+            };
+            asset_id: string;
+            recipient_binding_id: string;
+            recipient_descriptor_digest: string;
+            fee_payer: string;
+        };
+        fee_breakdown: {
+            gas_floor: 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;
+        };
+        protocol_version: "xochi.shielded.preview.v1";
+        environment: string;
+        refund_address: string;
+        refund_amount: string;
+        collect_before: number;
+        settlement_service_deadline: number;
+        recipient_binding_digest: string;
+        policy_revision: number;
+    };
+    recipient_binding_digest: string;
+    executable: false;
+    preview_version: "xochi.shielded.preview.v1";
+    preview_digest: string;
+    manifest: {
+        manifest_digest: string;
+        aztec_sdk_version: string;
+        recipient_account_class_id: string;
+    };
+}, {
+    domain: {
+        name: "Xochi Shielded Preview";
+        version: "1";
+        salt: string;
+        chain_id: number;
+    };
+    preview: {
+        source: {
+            amount: string;
+            chain_id: number;
+            token_address: string;
+            wallet: string;
+            collector: string;
+        };
+        destination: {
+            amount: string;
+            recipient_address: string;
+            token_address: string;
+            settlement_type: "shielded";
+            privacy_level: "private";
+            disclosure_profile: "recipient-private-public-amount-v1";
+            rail: "a_tracer";
+            network: {
+                aztec_chain_id: string;
+                protocol_version: string;
+                rollup_address: string;
+                l1_chain_id: string;
+                genesis_or_network_digest: string;
+            };
+            corridor: {
+                revision: number;
+                corridor_id: string;
+                manifest_digest: string;
+            };
+            asset_id: string;
+            recipient_binding_id: string;
+            recipient_descriptor_digest: string;
+            fee_payer: string;
+        };
+        fee_breakdown: {
+            gas_floor: 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;
+        };
+        protocol_version: "xochi.shielded.preview.v1";
+        environment: string;
+        refund_address: string;
+        refund_amount: string;
+        collect_before: number;
+        settlement_service_deadline: number;
+        recipient_binding_digest: string;
+        policy_revision: number;
+    };
+    recipient_binding_digest: string;
+    executable: false;
+    preview_version: "xochi.shielded.preview.v1";
+    preview_digest: string;
+    manifest: {
+        manifest_digest: string;
+        aztec_sdk_version: string;
+        recipient_account_class_id: string;
+    };
+}>;
+/** The request body. Unknown keys are refused by the solver (`unknown_field`). */
+export interface ShieldedPreviewRequestWire {
+    preview_version: "xochi.shielded.preview.v1";
+    privacy_level: "private";
+    corridor: z.infer<typeof ShieldedCorridorSchema>;
+    network: z.infer<typeof ShieldedNetworkIdentitySchema>;
+    source: {
+        chain_id: number;
+        token_address: string;
+        wallet: string;
+    };
+    destination: {
+        token_address: string;
+        recipient_address: string;
+        recipient_descriptor_digest: string;
+        amount: string;
+    };
+    recipient_binding: {
+        binding_id: string;
+        nonce: string;
+        challenge_expiry: number;
+        digest?: string;
+    };
+    refund_address?: string;
+    collect_before: number;
+    settlement_service_deadline: number;
+    expected_preview_digest?: string;
+}
+export type ShieldedPreviewResponseWire = z.infer<typeof ShieldedPreviewResponseSchema>;
+export type ShieldedPreviewWire = z.infer<typeof ShieldedPreviewSchema>;
+export type ShieldedFeeBreakdownWire = z.infer<typeof ShieldedFeeBreakdownSchema>;
+/**
+ * Decode a preview response. Throws (zod) on any shape the solver does not
+ * publish, including an executable or terms-shaped answer, and on a fee
+ * breakdown whose totals disagree: `total_fee` must be `max(gas_floor, layers)` (the gas
+ * floor is a minimum fee, as in FeePolicy) and `total_bps` the four rates.
+ */
+export declare function decodeShieldedPreview(body: unknown): ShieldedPreviewResponseWire;