@zkp2p/cash 0.1.0-dev.0

package/dist/index.d.cts

@@ -0,0 +1,1367 @@
+import { I as IntentStatus, C as CashPayoutInfo, a as IntentEntity, b as CashBuyerProfile, c as CashDepositInput, d as CreateDepositParamsArg, e as CashOrder, f as CashFill, g as CashCapabilities, h as CashoutResult, i as CashEstimate, P as PrepareResult, j as CashPreparedStep, T as TopUpResult, W as WithdrawResult } from './createCashClient-DpAx9A1A.cjs';
+export { k as CASH_ATTRIBUTION_CODE, l as CashClient, m as CashClientOptions, n as CashLeg, o as CashNextAction, p as CashOrderState, q as CashPayout, r as CashPayoutPricing, s as CashPlatformCapability, t as CashPreparedStepKind, u as CashoutInput, v as CuratorPayeeDataInput, E as EstimateInput, M as MIN_CASHOUT_AMOUNT, O as OrdersOptions, R as RECOMMENDED_MIN_CASHOUT_AMOUNT, S as SignerOptions, w as WatchOptions, x as WithdrawOptions, y as buildCapabilities, z as createCashClient } from './createCashClient-DpAx9A1A.cjs';
+import { PaymentMethodCatalog, CurrencyType, OracleAdapterOverrides, OnchainCurrency, Zkp2pClient, PreparedTransaction } from '@zkp2p/sdk';
+export { CurrencyType, PreparedTransaction, RuntimeEnv } from '@zkp2p/sdk';
+import { Log, Abi } from 'viem';
+import { z } from 'zod';
+
+/**
+ * Typed errors - every failure carries a `code`, whether it is `retryable`,
+ * and a `remediation` sentence so agents can self-drive recovery.
+ */
+type CashErrorCode = 'ORACLE_UNSUPPORTED_CURRENCY' | 'UNSUPPORTED_PLATFORM' | 'AMOUNT_BELOW_MINIMUM' | 'ACTIVE_INTENT_BLOCKS_WITHDRAWAL' | 'NOTHING_TO_WITHDRAW' | 'INSUFFICIENT_AVAILABLE_FUNDS' | 'ORDER_NOT_ACTIVE' | 'ESCROW_PAUSED' | 'INDEXER_LAG' | 'ORDER_NOT_FOUND' | 'PAYEE_REGISTRATION_FAILED' | 'PAYEE_VERIFICATION_REQUIRED' | 'DEPOSIT_RESOLUTION_FAILED' | 'ALLOWANCE_NOT_VISIBLE' | 'SIGNER_REQUIRED' | 'WATCH_TIMEOUT' | 'TRANSACTION_FAILED';
+interface CashErrorShape {
+    code: CashErrorCode;
+    message: string;
+    retryable: boolean;
+    remediation: string;
+}
+declare class CashError extends Error implements CashErrorShape {
+    readonly code: CashErrorCode;
+    readonly retryable: boolean;
+    readonly remediation: string;
+    constructor(shape: CashErrorShape, options?: {
+        cause?: unknown;
+    });
+    /** Serializable view (for tool results and logs). */
+    toJSON(): CashErrorShape;
+}
+declare function isCashError(value: unknown): value is CashError;
+/** Factory helpers keep call sites one-liners and remediation copy consistent. */
+declare const errors: {
+    oracleUnsupportedCurrency: (currency: string) => CashError;
+    unsupportedPlatform: (platform: string) => CashError;
+    amountBelowMinimum: (amount: bigint, min: bigint) => CashError;
+    activeIntentBlocksWithdrawal: (depositId: string) => CashError;
+    insufficientAvailableFunds: (depositId: string, requested: bigint, available: bigint) => CashError;
+    orderNotActive: (depositId: string) => CashError;
+    nothingToWithdraw: (depositId: string) => CashError;
+    indexerLag: (depositId: string) => CashError;
+    orderNotFound: (depositId: string) => CashError;
+    payeeRegistrationFailed: (cause: unknown) => CashError;
+    payeeVerificationRequired: (platform: string, cause?: unknown) => CashError;
+    allowanceNotVisible: (amount: bigint) => CashError;
+    depositResolutionFailed: (txHash: string) => CashError;
+    signerRequired: (verb: string) => CashError;
+    watchTimeout: (depositId: string, timeoutMs: number) => CashError;
+    transactionFailed: (txHash: string, cause?: unknown) => CashError;
+    escrowPaused: () => CashError;
+    /** Generic fallback for an on-chain call that failed for an unrecognized reason. */
+    chainCallFailed: (verb: string, cause?: unknown) => CashError;
+};
+
+/**
+ * Convert a human USDC amount to base units (6 decimals).
+ *
+ * @example
+ * usdc(1000)      // 1_000_000_000n
+ * usdc('12.34')   // 12_340_000n
+ */
+declare function usdc(amount: number | string): bigint;
+/** Format USDC base units back to a decimal string (no trailing zeros). */
+declare function formatUsdc(amount: bigint): string;
+/** Protocol rate precision - conversion rates are fiat-per-USDC scaled by 1e18. */
+declare const RATE_PRECISION: bigint;
+/**
+ * Fiat owed for a USDC amount at a locked 1e18 conversion rate, in fiat base
+ * units (6 decimals), rounded UP to the nearest cent - the same math the
+ * protocol clients use, so the number matches what the buyer is told to pay.
+ */
+declare function fiatFromUsdc(amount: bigint, conversionRate: bigint): bigint;
+/** Decode a 1e18 conversion rate to a plain number (fiat per USDC). */
+declare function rateToNumber(conversionRate: bigint): number;
+/** Decode fiat base units (6 decimals) to a plain number. */
+declare function fiatToNumber(fiat: bigint): number;
+/** Decode fiat cents (verified `paymentAmount` precision) to a plain number. */
+declare function centsToNumber(cents: bigint): number;
+
+/**
+ * Peer Cash - engine constants.
+ *
+ * Peer Cash is an async crypto→fiat offramp built on the maker/deposit side of
+ * the protocol: the cashing-out user IS the maker. They create a deposit at the
+ * live oracle/market rate (0% spread); a buyer (a standard taker) signals an
+ * intent, pays fiat, and proves it via the standard TEE-TLS flow, releasing the
+ * user's crypto. The protocol is reused in its existing direction - no proof
+ * inversion, no sell-side quote.
+ */
+
+/** Base chain id - Peer Cash settles in Base USDC. */
+declare const BASE_CHAIN_ID = 8453;
+/** Canonical USDC on Base (6 decimals). The deposit asset for every cash-out. */
+declare const BASE_USDC_ADDRESS: "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913";
+/** USDC has 6 decimals. */
+declare const USDC_DECIMALS = 6;
+/**
+ * Market rate = the live Chainlink oracle with **zero spread**. The user sets no
+ * rate; selling at market is the fast-fill incentive (the deposit is the best
+ * deal on the book, so buyers have reason to take it quickly).
+ */
+declare const MARKET_SPREAD_BPS = 0;
+/**
+ * EscrowV2 rejects a zero `minConversionRate` even when an oracle-backed rate
+ * config is attached. Use the smallest non-zero sentinel so the oracle rate
+ * still fully determines pricing while satisfying the on-chain invariant.
+ */
+declare const ORACLE_MIN_CONVERSION_RATE_SENTINEL = 1n;
+/**
+ * The full intent-status set a cash-out order can pass through. The indexer's
+ * `getIntentsForDeposits` defaults to `['SIGNALED']` only - passing this
+ * explicit set is REQUIRED, otherwise `delivered`/`returned` states are
+ * silently filtered out.
+ */
+declare const CASH_ORDER_STATUSES: IntentStatus[];
+/** Default polling cadence for an in-flight order (ms). Matches the protocol's active-intent polling. */
+declare const CASH_ORDER_POLL_INTERVAL_MS = 5000;
+/**
+ * Default deposit config for every Peer Cash deposit: a one-shot cash-out
+ * cleans up when fully filled rather than lingering empty.
+ */
+declare const CASH_RETAIN_ON_EMPTY = false;
+
+/** The raw indexed shape of a deposit's payment method (relation row). */
+interface PaymentMethodLike {
+    paymentMethodHash?: string | null;
+    payeeDetailsHash?: string | null;
+    active?: boolean | null;
+}
+/** The raw indexed shape of a per-method currency tuple (relation row). */
+interface MethodCurrencyLike {
+    paymentMethodHash?: string | null;
+    currencyCode?: string | null;
+    spreadBps?: number | string | null;
+    kind?: string | null;
+    rateSource?: string | null;
+    oracleRate?: string | number | bigint | null;
+    lastOracleUpdatedAt?: string | number | null;
+}
+/**
+ * Decode a deposit's payment methods + currency tuples into payout legs.
+ * Pure - the environment arrives via the catalog. One leg per
+ * (method, currency) pair; cash orders create exactly one in v1.
+ */
+declare function derivePayouts(paymentMethods: ReadonlyArray<PaymentMethodLike>, currencies: ReadonlyArray<MethodCurrencyLike>, catalog: PaymentMethodCatalog): CashPayoutInfo[];
+
+/**
+ * Peer Cash - buyer reputation, derived purely from the buyer's own intent
+ * history. The anxious moment in a cash-out is `matched`: a stranger's
+ * address is holding your order. This turns that address into a track record.
+ */
+
+/** Aggregate a buyer's full intent history into a profile. Pure and deterministic. */
+declare function deriveBuyerProfile(address: string, intents: ReadonlyArray<IntentEntity>): CashBuyerProfile;
+
+/**
+ * Whether a currency can be priced at the live market rate. Only currencies with
+ * a Chainlink feed (`supportsSpreadOracle`) get oracle pricing; others would fall
+ * back to a fixed rate, which Peer Cash does not offer.
+ */
+declare function isMarketRateSupported(currency: CurrencyType, adapters?: OracleAdapterOverrides): boolean;
+/**
+ * Build a single oracle-backed currency tuple priced at market (0% spread).
+ * Returns `null` for currencies without a Chainlink feed.
+ */
+declare function buildMarketRateCurrencyOverride(currency: CurrencyType, adapters?: OracleAdapterOverrides): OnchainCurrency | null;
+declare function buildIntentAmountRange(amount: bigint): {
+    min: bigint;
+    max: bigint;
+};
+/**
+ * Prepare the full `createDeposit` params for a market-rate cash-out.
+ *
+ * Registers payee details with the curator (no auth), resolves payment-method
+ * hashes + the gating service from the catalog, and assembles the override
+ * arrays with `spreadBps: 0` oracle configs. Throws if any payout currency lacks
+ * a live oracle feed (Peer Cash is market-rate only).
+ */
+declare function prepareCashDepositParams(client: Zkp2pClient, input: CashDepositInput, adapters?: OracleAdapterOverrides): Promise<CreateDepositParamsArg>;
+
+/**
+ * Whether a signaled fill can still be completed by its buyer. Uses the
+ * indexer's reconciler flag when present, belt-and-braces with the local
+ * clock (the reconciler can lag; the clock can skew - either signal counts).
+ */
+declare function isFillLive(fill: CashFill, nowSeconds: number): boolean;
+interface DeriveCashOrderOptions {
+    /** Original deposit amount, when already computed (else derived from the parts below). */
+    totalAmount?: bigint;
+    /** `remainingDeposits` - currently available, unlocked balance. */
+    remainingAmount?: bigint;
+    /** `outstandingIntentAmount` - currently locked by an active (SIGNALED) intent. */
+    outstandingAmount?: bigint;
+    /** `totalAmountTaken` - cumulative amount delivered to buyers (cashed out). */
+    takenAmount?: bigint;
+    /** `totalWithdrawn` - cumulative amount returned to the maker. */
+    withdrawnAmount?: bigint;
+    /** Deposit status from the indexer: `ACTIVE` | `CLOSED`. */
+    status?: string;
+    /** Total intent count from the indexer aggregate. */
+    intentCount?: number;
+    /** Unix seconds of the deposit's last on-chain change. */
+    updatedAt?: number;
+    /** Payout legs reconstructed from the deposit relations (see `derivePayouts`). */
+    payouts?: CashPayoutInfo[];
+    /** Deposit quality signal (basis points) from the indexer aggregate. */
+    successRateBps?: number;
+    /**
+     * Whether per-fill intent detail is present. Defaults to `intents.length > 0`.
+     * Pass `false` on list rows (deposits fetched without their intents) so
+     * `nextActions` treats a positive outstanding amount as a live lock rather
+     * than offering a withdraw that would revert.
+     */
+    fillsIncluded?: boolean;
+    /** Unix seconds "now" for expiry-sensitive `nextActions` (defaults to wall clock). */
+    nowSeconds?: number;
+}
+/** Plain-data view of {@link CashOrder} (everything except the `explain` method). */
+type CashOrderData = Omit<CashOrder, 'explain'>;
+/**
+ * One honest sentence from live data - never a fake countdown. The binding
+ * rate resolves at the oracle when a buyer fills, and buyer arrival time is
+ * unknowable, so the sentence only ever states what the chain actually shows.
+ */
+declare function explainOrder(order: CashOrderData): string;
+/** Attach the `explain()` method to plain order data (used by codecs on parse). */
+declare function withExplain(data: CashOrderData): CashOrder;
+/**
+ * Derive the resumable {@link CashOrder} view for one deposit. Pure and
+ * deterministic - safe on every poll, list render, or cold page load.
+ */
+declare function deriveCashOrder(depositId: string, intents: ReadonlyArray<IntentEntity>, options?: DeriveCashOrderOptions): CashOrder;
+
+/**
+ * Peer Cash - resolve the composite deposit id from a `createDeposit` receipt.
+ *
+ * `createDeposit` returns only a tx hash; the on-chain `depositId` is assigned by
+ * the contract and emitted in `DepositReceived` (indexed). We decode it from the
+ * receipt logs using the real escrow ABI so the order can be keyed on the
+ * composite id (`escrow_onchainId`) the indexer uses.
+ */
+
+interface ResolvedCashDeposit {
+    onchainDepositId: bigint;
+    escrowAddress: string;
+    compositeId: string;
+}
+declare function resolveCashDepositId(params: {
+    logs: Log[];
+    abi: Abi;
+}): ResolvedCashDeposit | null;
+/** Split a composite deposit id (`escrow_onchainId`) back into its parts. */
+declare function parseCompositeDepositId(compositeId: string): {
+    escrowAddress: string;
+    onchainDepositId: bigint;
+};
+
+/**
+ * zod schemas for every wire type. The wire format encodes bigints as decimal
+ * strings so orders, estimates, and prepared txs cross tool-call and process
+ * boundaries losslessly.
+ */
+
+declare const bigintString: z.ZodString;
+declare const cashOrderStateSchema: z.ZodEnum<["awaiting-buyer", "matched", "delivering", "delivered", "returned"]>;
+declare const cashNextActionSchema: z.ZodEnum<["wait", "withdraw"]>;
+declare const intentStatusSchema: z.ZodEnum<["SIGNALED", "FULFILLED", "PRUNED", "MANUALLY_RELEASED"]>;
+declare const cashFillJsonSchema: z.ZodObject<{
+    intentHash: z.ZodString;
+    status: z.ZodEnum<["SIGNALED", "FULFILLED", "PRUNED", "MANUALLY_RELEASED"]>;
+    amount: z.ZodString;
+    buyer: z.ZodString;
+    currency: z.ZodOptional<z.ZodString>;
+    currencyHash: z.ZodOptional<z.ZodString>;
+    rate: z.ZodOptional<z.ZodNumber>;
+    conversionRate: z.ZodOptional<z.ZodString>;
+    fiatOwed: z.ZodOptional<z.ZodNumber>;
+    fiatPaid: z.ZodOptional<z.ZodNumber>;
+    paidCurrency: z.ZodOptional<z.ZodString>;
+    paymentId: z.ZodOptional<z.ZodString>;
+    paidAt: z.ZodOptional<z.ZodNumber>;
+    releasedAmount: z.ZodOptional<z.ZodString>;
+    fillLatencySeconds: z.ZodOptional<z.ZodNumber>;
+    isExpired: z.ZodOptional<z.ZodBoolean>;
+    signaledAt: z.ZodOptional<z.ZodNumber>;
+    expiresAt: z.ZodOptional<z.ZodNumber>;
+    fulfilledAt: z.ZodOptional<z.ZodNumber>;
+    prunedAt: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    intentHash: string;
+    amount: string;
+    status: "SIGNALED" | "FULFILLED" | "PRUNED" | "MANUALLY_RELEASED";
+    buyer: string;
+    conversionRate?: string | undefined;
+    isExpired?: boolean | undefined;
+    fillLatencySeconds?: number | undefined;
+    paymentId?: string | undefined;
+    releasedAmount?: string | undefined;
+    currency?: string | undefined;
+    currencyHash?: string | undefined;
+    fiatPaid?: number | undefined;
+    paidCurrency?: string | undefined;
+    paidAt?: number | undefined;
+    signaledAt?: number | undefined;
+    expiresAt?: number | undefined;
+    fulfilledAt?: number | undefined;
+    prunedAt?: number | undefined;
+    rate?: number | undefined;
+    fiatOwed?: number | undefined;
+}, {
+    intentHash: string;
+    amount: string;
+    status: "SIGNALED" | "FULFILLED" | "PRUNED" | "MANUALLY_RELEASED";
+    buyer: string;
+    conversionRate?: string | undefined;
+    isExpired?: boolean | undefined;
+    fillLatencySeconds?: number | undefined;
+    paymentId?: string | undefined;
+    releasedAmount?: string | undefined;
+    currency?: string | undefined;
+    currencyHash?: string | undefined;
+    fiatPaid?: number | undefined;
+    paidCurrency?: string | undefined;
+    paidAt?: number | undefined;
+    signaledAt?: number | undefined;
+    expiresAt?: number | undefined;
+    fulfilledAt?: number | undefined;
+    prunedAt?: number | undefined;
+    rate?: number | undefined;
+    fiatOwed?: number | undefined;
+}>;
+declare const cashPayoutPricingJsonSchema: z.ZodObject<{
+    spreadBps: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodOptional<z.ZodString>;
+    rateSource: z.ZodOptional<z.ZodString>;
+    oracleRate: z.ZodOptional<z.ZodNumber>;
+    lastOracleUpdatedAt: z.ZodOptional<z.ZodNumber>;
+    marketRate: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    marketRate: boolean;
+    spreadBps?: number | undefined;
+    lastOracleUpdatedAt?: number | undefined;
+    kind?: string | undefined;
+    rateSource?: string | undefined;
+    oracleRate?: number | undefined;
+}, {
+    marketRate: boolean;
+    spreadBps?: number | undefined;
+    lastOracleUpdatedAt?: number | undefined;
+    kind?: string | undefined;
+    rateSource?: string | undefined;
+    oracleRate?: number | undefined;
+}>;
+declare const cashPayoutInfoJsonSchema: z.ZodObject<{
+    platform: z.ZodOptional<z.ZodString>;
+    platformHash: z.ZodString;
+    currency: z.ZodOptional<z.ZodString>;
+    currencyHash: z.ZodOptional<z.ZodString>;
+    payeeHash: z.ZodString;
+    active: z.ZodBoolean;
+    pricing: z.ZodObject<{
+        spreadBps: z.ZodOptional<z.ZodNumber>;
+        kind: z.ZodOptional<z.ZodString>;
+        rateSource: z.ZodOptional<z.ZodString>;
+        oracleRate: z.ZodOptional<z.ZodNumber>;
+        lastOracleUpdatedAt: z.ZodOptional<z.ZodNumber>;
+        marketRate: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        marketRate: boolean;
+        spreadBps?: number | undefined;
+        lastOracleUpdatedAt?: number | undefined;
+        kind?: string | undefined;
+        rateSource?: string | undefined;
+        oracleRate?: number | undefined;
+    }, {
+        marketRate: boolean;
+        spreadBps?: number | undefined;
+        lastOracleUpdatedAt?: number | undefined;
+        kind?: string | undefined;
+        rateSource?: string | undefined;
+        oracleRate?: number | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    platformHash: string;
+    payeeHash: string;
+    active: boolean;
+    pricing: {
+        marketRate: boolean;
+        spreadBps?: number | undefined;
+        lastOracleUpdatedAt?: number | undefined;
+        kind?: string | undefined;
+        rateSource?: string | undefined;
+        oracleRate?: number | undefined;
+    };
+    currency?: string | undefined;
+    currencyHash?: string | undefined;
+    platform?: string | undefined;
+}, {
+    platformHash: string;
+    payeeHash: string;
+    active: boolean;
+    pricing: {
+        marketRate: boolean;
+        spreadBps?: number | undefined;
+        lastOracleUpdatedAt?: number | undefined;
+        kind?: string | undefined;
+        rateSource?: string | undefined;
+        oracleRate?: number | undefined;
+    };
+    currency?: string | undefined;
+    currencyHash?: string | undefined;
+    platform?: string | undefined;
+}>;
+declare const cashBuyerProfileJsonSchema: z.ZodObject<{
+    address: z.ZodString;
+    totalIntents: z.ZodNumber;
+    fulfilled: z.ZodNumber;
+    pruned: z.ZodNumber;
+    signaled: z.ZodNumber;
+    successRateBps: z.ZodOptional<z.ZodNumber>;
+    firstSeenAt: z.ZodOptional<z.ZodNumber>;
+    lastSeenAt: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    totalIntents: number;
+    address: string;
+    fulfilled: number;
+    pruned: number;
+    signaled: number;
+    successRateBps?: number | undefined;
+    firstSeenAt?: number | undefined;
+    lastSeenAt?: number | undefined;
+}, {
+    totalIntents: number;
+    address: string;
+    fulfilled: number;
+    pruned: number;
+    signaled: number;
+    successRateBps?: number | undefined;
+    firstSeenAt?: number | undefined;
+    lastSeenAt?: number | undefined;
+}>;
+declare const cashOrderJsonSchema: z.ZodObject<{
+    depositId: z.ZodString;
+    state: z.ZodEnum<["awaiting-buyer", "matched", "delivering", "delivered", "returned"]>;
+    fills: z.ZodArray<z.ZodObject<{
+        intentHash: z.ZodString;
+        status: z.ZodEnum<["SIGNALED", "FULFILLED", "PRUNED", "MANUALLY_RELEASED"]>;
+        amount: z.ZodString;
+        buyer: z.ZodString;
+        currency: z.ZodOptional<z.ZodString>;
+        currencyHash: z.ZodOptional<z.ZodString>;
+        rate: z.ZodOptional<z.ZodNumber>;
+        conversionRate: z.ZodOptional<z.ZodString>;
+        fiatOwed: z.ZodOptional<z.ZodNumber>;
+        fiatPaid: z.ZodOptional<z.ZodNumber>;
+        paidCurrency: z.ZodOptional<z.ZodString>;
+        paymentId: z.ZodOptional<z.ZodString>;
+        paidAt: z.ZodOptional<z.ZodNumber>;
+        releasedAmount: z.ZodOptional<z.ZodString>;
+        fillLatencySeconds: z.ZodOptional<z.ZodNumber>;
+        isExpired: z.ZodOptional<z.ZodBoolean>;
+        signaledAt: z.ZodOptional<z.ZodNumber>;
+        expiresAt: z.ZodOptional<z.ZodNumber>;
+        fulfilledAt: z.ZodOptional<z.ZodNumber>;
+        prunedAt: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        intentHash: string;
+        amount: string;
+        status: "SIGNALED" | "FULFILLED" | "PRUNED" | "MANUALLY_RELEASED";
+        buyer: string;
+        conversionRate?: string | undefined;
+        isExpired?: boolean | undefined;
+        fillLatencySeconds?: number | undefined;
+        paymentId?: string | undefined;
+        releasedAmount?: string | undefined;
+        currency?: string | undefined;
+        currencyHash?: string | undefined;
+        fiatPaid?: number | undefined;
+        paidCurrency?: string | undefined;
+        paidAt?: number | undefined;
+        signaledAt?: number | undefined;
+        expiresAt?: number | undefined;
+        fulfilledAt?: number | undefined;
+        prunedAt?: number | undefined;
+        rate?: number | undefined;
+        fiatOwed?: number | undefined;
+    }, {
+        intentHash: string;
+        amount: string;
+        status: "SIGNALED" | "FULFILLED" | "PRUNED" | "MANUALLY_RELEASED";
+        buyer: string;
+        conversionRate?: string | undefined;
+        isExpired?: boolean | undefined;
+        fillLatencySeconds?: number | undefined;
+        paymentId?: string | undefined;
+        releasedAmount?: string | undefined;
+        currency?: string | undefined;
+        currencyHash?: string | undefined;
+        fiatPaid?: number | undefined;
+        paidCurrency?: string | undefined;
+        paidAt?: number | undefined;
+        signaledAt?: number | undefined;
+        expiresAt?: number | undefined;
+        fulfilledAt?: number | undefined;
+        prunedAt?: number | undefined;
+        rate?: number | undefined;
+        fiatOwed?: number | undefined;
+    }>, "many">;
+    totalAmount: z.ZodString;
+    filledAmount: z.ZodString;
+    pendingAmount: z.ZodString;
+    returnedAmount: z.ZodString;
+    nextActions: z.ZodArray<z.ZodEnum<["wait", "withdraw"]>, "many">;
+    primaryIntentHash: z.ZodOptional<z.ZodString>;
+    matchedAt: z.ZodOptional<z.ZodNumber>;
+    deliveredAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    intentCount: z.ZodOptional<z.ZodNumber>;
+    payouts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        platform: z.ZodOptional<z.ZodString>;
+        platformHash: z.ZodString;
+        currency: z.ZodOptional<z.ZodString>;
+        currencyHash: z.ZodOptional<z.ZodString>;
+        payeeHash: z.ZodString;
+        active: z.ZodBoolean;
+        pricing: z.ZodObject<{
+            spreadBps: z.ZodOptional<z.ZodNumber>;
+            kind: z.ZodOptional<z.ZodString>;
+            rateSource: z.ZodOptional<z.ZodString>;
+            oracleRate: z.ZodOptional<z.ZodNumber>;
+            lastOracleUpdatedAt: z.ZodOptional<z.ZodNumber>;
+            marketRate: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            marketRate: boolean;
+            spreadBps?: number | undefined;
+            lastOracleUpdatedAt?: number | undefined;
+            kind?: string | undefined;
+            rateSource?: string | undefined;
+            oracleRate?: number | undefined;
+        }, {
+            marketRate: boolean;
+            spreadBps?: number | undefined;
+            lastOracleUpdatedAt?: number | undefined;
+            kind?: string | undefined;
+            rateSource?: string | undefined;
+            oracleRate?: number | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        platformHash: string;
+        payeeHash: string;
+        active: boolean;
+        pricing: {
+            marketRate: boolean;
+            spreadBps?: number | undefined;
+            lastOracleUpdatedAt?: number | undefined;
+            kind?: string | undefined;
+            rateSource?: string | undefined;
+            oracleRate?: number | undefined;
+        };
+        currency?: string | undefined;
+        currencyHash?: string | undefined;
+        platform?: string | undefined;
+    }, {
+        platformHash: string;
+        payeeHash: string;
+        active: boolean;
+        pricing: {
+            marketRate: boolean;
+            spreadBps?: number | undefined;
+            lastOracleUpdatedAt?: number | undefined;
+            kind?: string | undefined;
+            rateSource?: string | undefined;
+            oracleRate?: number | undefined;
+        };
+        currency?: string | undefined;
+        currencyHash?: string | undefined;
+        platform?: string | undefined;
+    }>, "many">>;
+    successRateBps: z.ZodOptional<z.ZodNumber>;
+    isInFlight: z.ZodBoolean;
+    withdrawn: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    depositId: string;
+    state: "awaiting-buyer" | "matched" | "delivering" | "delivered" | "returned";
+    fills: {
+        intentHash: string;
+        amount: string;
+        status: "SIGNALED" | "FULFILLED" | "PRUNED" | "MANUALLY_RELEASED";
+        buyer: string;
+        conversionRate?: string | undefined;
+        isExpired?: boolean | undefined;
+        fillLatencySeconds?: number | undefined;
+        paymentId?: string | undefined;
+        releasedAmount?: string | undefined;
+        currency?: string | undefined;
+        currencyHash?: string | undefined;
+        fiatPaid?: number | undefined;
+        paidCurrency?: string | undefined;
+        paidAt?: number | undefined;
+        signaledAt?: number | undefined;
+        expiresAt?: number | undefined;
+        fulfilledAt?: number | undefined;
+        prunedAt?: number | undefined;
+        rate?: number | undefined;
+        fiatOwed?: number | undefined;
+    }[];
+    totalAmount: string;
+    filledAmount: string;
+    pendingAmount: string;
+    returnedAmount: string;
+    nextActions: ("wait" | "withdraw")[];
+    isInFlight: boolean;
+    updatedAt?: number | undefined;
+    successRateBps?: number | undefined;
+    payouts?: {
+        platformHash: string;
+        payeeHash: string;
+        active: boolean;
+        pricing: {
+            marketRate: boolean;
+            spreadBps?: number | undefined;
+            lastOracleUpdatedAt?: number | undefined;
+            kind?: string | undefined;
+            rateSource?: string | undefined;
+            oracleRate?: number | undefined;
+        };
+        currency?: string | undefined;
+        currencyHash?: string | undefined;
+        platform?: string | undefined;
+    }[] | undefined;
+    primaryIntentHash?: string | undefined;
+    matchedAt?: number | undefined;
+    deliveredAt?: number | undefined;
+    intentCount?: number | undefined;
+    withdrawn?: boolean | undefined;
+}, {
+    depositId: string;
+    state: "awaiting-buyer" | "matched" | "delivering" | "delivered" | "returned";
+    fills: {
+        intentHash: string;
+        amount: string;
+        status: "SIGNALED" | "FULFILLED" | "PRUNED" | "MANUALLY_RELEASED";
+        buyer: string;
+        conversionRate?: string | undefined;
+        isExpired?: boolean | undefined;
+        fillLatencySeconds?: number | undefined;
+        paymentId?: string | undefined;
+        releasedAmount?: string | undefined;
+        currency?: string | undefined;
+        currencyHash?: string | undefined;
+        fiatPaid?: number | undefined;
+        paidCurrency?: string | undefined;
+        paidAt?: number | undefined;
+        signaledAt?: number | undefined;
+        expiresAt?: number | undefined;
+        fulfilledAt?: number | undefined;
+        prunedAt?: number | undefined;
+        rate?: number | undefined;
+        fiatOwed?: number | undefined;
+    }[];
+    totalAmount: string;
+    filledAmount: string;
+    pendingAmount: string;
+    returnedAmount: string;
+    nextActions: ("wait" | "withdraw")[];
+    isInFlight: boolean;
+    updatedAt?: number | undefined;
+    successRateBps?: number | undefined;
+    payouts?: {
+        platformHash: string;
+        payeeHash: string;
+        active: boolean;
+        pricing: {
+            marketRate: boolean;
+            spreadBps?: number | undefined;
+            lastOracleUpdatedAt?: number | undefined;
+            kind?: string | undefined;
+            rateSource?: string | undefined;
+            oracleRate?: number | undefined;
+        };
+        currency?: string | undefined;
+        currencyHash?: string | undefined;
+        platform?: string | undefined;
+    }[] | undefined;
+    primaryIntentHash?: string | undefined;
+    matchedAt?: number | undefined;
+    deliveredAt?: number | undefined;
+    intentCount?: number | undefined;
+    withdrawn?: boolean | undefined;
+}>;
+declare const cashEstimateJsonSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"oracle-estimate">;
+    currency: z.ZodString;
+    amount: z.ZodString;
+    rate: z.ZodNumber;
+    receiveAmount: z.ZodNumber;
+    asOf: z.ZodNumber;
+    oracleUpdatedAt: z.ZodOptional<z.ZodNumber>;
+    stale: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    currency: string;
+    kind: "oracle-estimate";
+    rate: number;
+    asOf: number;
+    receiveAmount: number;
+    oracleUpdatedAt?: number | undefined;
+    stale?: boolean | undefined;
+}, {
+    amount: string;
+    currency: string;
+    kind: "oracle-estimate";
+    rate: number;
+    asOf: number;
+    receiveAmount: number;
+    oracleUpdatedAt?: number | undefined;
+    stale?: boolean | undefined;
+}>;
+declare const preparedTransactionJsonSchema: z.ZodObject<{
+    to: z.ZodString;
+    data: z.ZodString;
+    value: z.ZodString;
+    chainId: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    chainId: number;
+    data: string;
+    to: string;
+    value: string;
+}, {
+    chainId: number;
+    data: string;
+    to: string;
+    value: string;
+}>;
+declare const cashPreparedStepJsonSchema: z.ZodObject<{
+    kind: z.ZodEnum<["approve", "createDeposit", "pruneExpiredIntents", "withdrawDeposit", "removeFunds", "addFunds"]>;
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "createDeposit" | "approve" | "pruneExpiredIntents" | "withdrawDeposit" | "removeFunds" | "addFunds";
+    description: string;
+}, {
+    kind: "createDeposit" | "approve" | "pruneExpiredIntents" | "withdrawDeposit" | "removeFunds" | "addFunds";
+    description: string;
+}>;
+declare const cashoutResultJsonSchema: z.ZodObject<{
+    depositId: z.ZodString;
+    txHash: z.ZodString;
+    escrowAddress: z.ZodString;
+    onchainDepositId: z.ZodString;
+    order: z.ZodObject<{
+        depositId: z.ZodString;
+        state: z.ZodEnum<["awaiting-buyer", "matched", "delivering", "delivered", "returned"]>;
+        fills: z.ZodArray<z.ZodObject<{
+            intentHash: z.ZodString;
+            status: z.ZodEnum<["SIGNALED", "FULFILLED", "PRUNED", "MANUALLY_RELEASED"]>;
+            amount: z.ZodString;
+            buyer: z.ZodString;
+            currency: z.ZodOptional<z.ZodString>;
+            currencyHash: z.ZodOptional<z.ZodString>;
+            rate: z.ZodOptional<z.ZodNumber>;
+            conversionRate: z.ZodOptional<z.ZodString>;
+            fiatOwed: z.ZodOptional<z.ZodNumber>;
+            fiatPaid: z.ZodOptional<z.ZodNumber>;
+            paidCurrency: z.ZodOptional<z.ZodString>;
+            paymentId: z.ZodOptional<z.ZodString>;
+            paidAt: z.ZodOptional<z.ZodNumber>;
+            releasedAmount: z.ZodOptional<z.ZodString>;
+            fillLatencySeconds: z.ZodOptional<z.ZodNumber>;
+            isExpired: z.ZodOptional<z.ZodBoolean>;
+            signaledAt: z.ZodOptional<z.ZodNumber>;
+            expiresAt: z.ZodOptional<z.ZodNumber>;
+            fulfilledAt: z.ZodOptional<z.ZodNumber>;
+            prunedAt: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            intentHash: string;
+            amount: string;
+            status: "SIGNALED" | "FULFILLED" | "PRUNED" | "MANUALLY_RELEASED";
+            buyer: string;
+            conversionRate?: string | undefined;
+            isExpired?: boolean | undefined;
+            fillLatencySeconds?: number | undefined;
+            paymentId?: string | undefined;
+            releasedAmount?: string | undefined;
+            currency?: string | undefined;
+            currencyHash?: string | undefined;
+            fiatPaid?: number | undefined;
+            paidCurrency?: string | undefined;
+            paidAt?: number | undefined;
+            signaledAt?: number | undefined;
+            expiresAt?: number | undefined;
+            fulfilledAt?: number | undefined;
+            prunedAt?: number | undefined;
+            rate?: number | undefined;
+            fiatOwed?: number | undefined;
+        }, {
+            intentHash: string;
+            amount: string;
+            status: "SIGNALED" | "FULFILLED" | "PRUNED" | "MANUALLY_RELEASED";
+            buyer: string;
+            conversionRate?: string | undefined;
+            isExpired?: boolean | undefined;
+            fillLatencySeconds?: number | undefined;
+            paymentId?: string | undefined;
+            releasedAmount?: string | undefined;
+            currency?: string | undefined;
+            currencyHash?: string | undefined;
+            fiatPaid?: number | undefined;
+            paidCurrency?: string | undefined;
+            paidAt?: number | undefined;
+            signaledAt?: number | undefined;
+            expiresAt?: number | undefined;
+            fulfilledAt?: number | undefined;
+            prunedAt?: number | undefined;
+            rate?: number | undefined;
+            fiatOwed?: number | undefined;
+        }>, "many">;
+        totalAmount: z.ZodString;
+        filledAmount: z.ZodString;
+        pendingAmount: z.ZodString;
+        returnedAmount: z.ZodString;
+        nextActions: z.ZodArray<z.ZodEnum<["wait", "withdraw"]>, "many">;
+        primaryIntentHash: z.ZodOptional<z.ZodString>;
+        matchedAt: z.ZodOptional<z.ZodNumber>;
+        deliveredAt: z.ZodOptional<z.ZodNumber>;
+        updatedAt: z.ZodOptional<z.ZodNumber>;
+        intentCount: z.ZodOptional<z.ZodNumber>;
+        payouts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            platform: z.ZodOptional<z.ZodString>;
+            platformHash: z.ZodString;
+            currency: z.ZodOptional<z.ZodString>;
+            currencyHash: z.ZodOptional<z.ZodString>;
+            payeeHash: z.ZodString;
+            active: z.ZodBoolean;
+            pricing: z.ZodObject<{
+                spreadBps: z.ZodOptional<z.ZodNumber>;
+                kind: z.ZodOptional<z.ZodString>;
+                rateSource: z.ZodOptional<z.ZodString>;
+                oracleRate: z.ZodOptional<z.ZodNumber>;
+                lastOracleUpdatedAt: z.ZodOptional<z.ZodNumber>;
+                marketRate: z.ZodBoolean;
+            }, "strip", z.ZodTypeAny, {
+                marketRate: boolean;
+                spreadBps?: number | undefined;
+                lastOracleUpdatedAt?: number | undefined;
+                kind?: string | undefined;
+                rateSource?: string | undefined;
+                oracleRate?: number | undefined;
+            }, {
+                marketRate: boolean;
+                spreadBps?: number | undefined;
+                lastOracleUpdatedAt?: number | undefined;
+                kind?: string | undefined;
+                rateSource?: string | undefined;
+                oracleRate?: number | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            platformHash: string;
+            payeeHash: string;
+            active: boolean;
+            pricing: {
+                marketRate: boolean;
+                spreadBps?: number | undefined;
+                lastOracleUpdatedAt?: number | undefined;
+                kind?: string | undefined;
+                rateSource?: string | undefined;
+                oracleRate?: number | undefined;
+            };
+            currency?: string | undefined;
+            currencyHash?: string | undefined;
+            platform?: string | undefined;
+        }, {
+            platformHash: string;
+            payeeHash: string;
+            active: boolean;
+            pricing: {
+                marketRate: boolean;
+                spreadBps?: number | undefined;
+                lastOracleUpdatedAt?: number | undefined;
+                kind?: string | undefined;
+                rateSource?: string | undefined;
+                oracleRate?: number | undefined;
+            };
+            currency?: string | undefined;
+            currencyHash?: string | undefined;
+            platform?: string | undefined;
+        }>, "many">>;
+        successRateBps: z.ZodOptional<z.ZodNumber>;
+        isInFlight: z.ZodBoolean;
+        withdrawn: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        depositId: string;
+        state: "awaiting-buyer" | "matched" | "delivering" | "delivered" | "returned";
+        fills: {
+            intentHash: string;
+            amount: string;
+            status: "SIGNALED" | "FULFILLED" | "PRUNED" | "MANUALLY_RELEASED";
+            buyer: string;
+            conversionRate?: string | undefined;
+            isExpired?: boolean | undefined;
+            fillLatencySeconds?: number | undefined;
+            paymentId?: string | undefined;
+            releasedAmount?: string | undefined;
+            currency?: string | undefined;
+            currencyHash?: string | undefined;
+            fiatPaid?: number | undefined;
+            paidCurrency?: string | undefined;
+            paidAt?: number | undefined;
+            signaledAt?: number | undefined;
+            expiresAt?: number | undefined;
+            fulfilledAt?: number | undefined;
+            prunedAt?: number | undefined;
+            rate?: number | undefined;
+            fiatOwed?: number | undefined;
+        }[];
+        totalAmount: string;
+        filledAmount: string;
+        pendingAmount: string;
+        returnedAmount: string;
+        nextActions: ("wait" | "withdraw")[];
+        isInFlight: boolean;
+        updatedAt?: number | undefined;
+        successRateBps?: number | undefined;
+        payouts?: {
+            platformHash: string;
+            payeeHash: string;
+            active: boolean;
+            pricing: {
+                marketRate: boolean;
+                spreadBps?: number | undefined;
+                lastOracleUpdatedAt?: number | undefined;
+                kind?: string | undefined;
+                rateSource?: string | undefined;
+                oracleRate?: number | undefined;
+            };
+            currency?: string | undefined;
+            currencyHash?: string | undefined;
+            platform?: string | undefined;
+        }[] | undefined;
+        primaryIntentHash?: string | undefined;
+        matchedAt?: number | undefined;
+        deliveredAt?: number | undefined;
+        intentCount?: number | undefined;
+        withdrawn?: boolean | undefined;
+    }, {
+        depositId: string;
+        state: "awaiting-buyer" | "matched" | "delivering" | "delivered" | "returned";
+        fills: {
+            intentHash: string;
+            amount: string;
+            status: "SIGNALED" | "FULFILLED" | "PRUNED" | "MANUALLY_RELEASED";
+            buyer: string;
+            conversionRate?: string | undefined;
+            isExpired?: boolean | undefined;
+            fillLatencySeconds?: number | undefined;
+            paymentId?: string | undefined;
+            releasedAmount?: string | undefined;
+            currency?: string | undefined;
+            currencyHash?: string | undefined;
+            fiatPaid?: number | undefined;
+            paidCurrency?: string | undefined;
+            paidAt?: number | undefined;
+            signaledAt?: number | undefined;
+            expiresAt?: number | undefined;
+            fulfilledAt?: number | undefined;
+            prunedAt?: number | undefined;
+            rate?: number | undefined;
+            fiatOwed?: number | undefined;
+        }[];
+        totalAmount: string;
+        filledAmount: string;
+        pendingAmount: string;
+        returnedAmount: string;
+        nextActions: ("wait" | "withdraw")[];
+        isInFlight: boolean;
+        updatedAt?: number | undefined;
+        successRateBps?: number | undefined;
+        payouts?: {
+            platformHash: string;
+            payeeHash: string;
+            active: boolean;
+            pricing: {
+                marketRate: boolean;
+                spreadBps?: number | undefined;
+                lastOracleUpdatedAt?: number | undefined;
+                kind?: string | undefined;
+                rateSource?: string | undefined;
+                oracleRate?: number | undefined;
+            };
+            currency?: string | undefined;
+            currencyHash?: string | undefined;
+            platform?: string | undefined;
+        }[] | undefined;
+        primaryIntentHash?: string | undefined;
+        matchedAt?: number | undefined;
+        deliveredAt?: number | undefined;
+        intentCount?: number | undefined;
+        withdrawn?: boolean | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    depositId: string;
+    escrowAddress: string;
+    txHash: string;
+    onchainDepositId: string;
+    order: {
+        depositId: string;
+        state: "awaiting-buyer" | "matched" | "delivering" | "delivered" | "returned";
+        fills: {
+            intentHash: string;
+            amount: string;
+            status: "SIGNALED" | "FULFILLED" | "PRUNED" | "MANUALLY_RELEASED";
+            buyer: string;
+            conversionRate?: string | undefined;
+            isExpired?: boolean | undefined;
+            fillLatencySeconds?: number | undefined;
+            paymentId?: string | undefined;
+            releasedAmount?: string | undefined;
+            currency?: string | undefined;
+            currencyHash?: string | undefined;
+            fiatPaid?: number | undefined;
+            paidCurrency?: string | undefined;
+            paidAt?: number | undefined;
+            signaledAt?: number | undefined;
+            expiresAt?: number | undefined;
+            fulfilledAt?: number | undefined;
+            prunedAt?: number | undefined;
+            rate?: number | undefined;
+            fiatOwed?: number | undefined;
+        }[];
+        totalAmount: string;
+        filledAmount: string;
+        pendingAmount: string;
+        returnedAmount: string;
+        nextActions: ("wait" | "withdraw")[];
+        isInFlight: boolean;
+        updatedAt?: number | undefined;
+        successRateBps?: number | undefined;
+        payouts?: {
+            platformHash: string;
+            payeeHash: string;
+            active: boolean;
+            pricing: {
+                marketRate: boolean;
+                spreadBps?: number | undefined;
+                lastOracleUpdatedAt?: number | undefined;
+                kind?: string | undefined;
+                rateSource?: string | undefined;
+                oracleRate?: number | undefined;
+            };
+            currency?: string | undefined;
+            currencyHash?: string | undefined;
+            platform?: string | undefined;
+        }[] | undefined;
+        primaryIntentHash?: string | undefined;
+        matchedAt?: number | undefined;
+        deliveredAt?: number | undefined;
+        intentCount?: number | undefined;
+        withdrawn?: boolean | undefined;
+    };
+}, {
+    depositId: string;
+    escrowAddress: string;
+    txHash: string;
+    onchainDepositId: string;
+    order: {
+        depositId: string;
+        state: "awaiting-buyer" | "matched" | "delivering" | "delivered" | "returned";
+        fills: {
+            intentHash: string;
+            amount: string;
+            status: "SIGNALED" | "FULFILLED" | "PRUNED" | "MANUALLY_RELEASED";
+            buyer: string;
+            conversionRate?: string | undefined;
+            isExpired?: boolean | undefined;
+            fillLatencySeconds?: number | undefined;
+            paymentId?: string | undefined;
+            releasedAmount?: string | undefined;
+            currency?: string | undefined;
+            currencyHash?: string | undefined;
+            fiatPaid?: number | undefined;
+            paidCurrency?: string | undefined;
+            paidAt?: number | undefined;
+            signaledAt?: number | undefined;
+            expiresAt?: number | undefined;
+            fulfilledAt?: number | undefined;
+            prunedAt?: number | undefined;
+            rate?: number | undefined;
+            fiatOwed?: number | undefined;
+        }[];
+        totalAmount: string;
+        filledAmount: string;
+        pendingAmount: string;
+        returnedAmount: string;
+        nextActions: ("wait" | "withdraw")[];
+        isInFlight: boolean;
+        updatedAt?: number | undefined;
+        successRateBps?: number | undefined;
+        payouts?: {
+            platformHash: string;
+            payeeHash: string;
+            active: boolean;
+            pricing: {
+                marketRate: boolean;
+                spreadBps?: number | undefined;
+                lastOracleUpdatedAt?: number | undefined;
+                kind?: string | undefined;
+                rateSource?: string | undefined;
+                oracleRate?: number | undefined;
+            };
+            currency?: string | undefined;
+            currencyHash?: string | undefined;
+            platform?: string | undefined;
+        }[] | undefined;
+        primaryIntentHash?: string | undefined;
+        matchedAt?: number | undefined;
+        deliveredAt?: number | undefined;
+        intentCount?: number | undefined;
+        withdrawn?: boolean | undefined;
+    };
+}>;
+declare const prepareResultJsonSchema: z.ZodObject<{
+    txs: z.ZodArray<z.ZodObject<{
+        to: z.ZodString;
+        data: z.ZodString;
+        value: z.ZodString;
+        chainId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        chainId: number;
+        data: string;
+        to: string;
+        value: string;
+    }, {
+        chainId: number;
+        data: string;
+        to: string;
+        value: string;
+    }>, "many">;
+    steps: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<["approve", "createDeposit", "pruneExpiredIntents", "withdrawDeposit", "removeFunds", "addFunds"]>;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "createDeposit" | "approve" | "pruneExpiredIntents" | "withdrawDeposit" | "removeFunds" | "addFunds";
+        description: string;
+    }, {
+        kind: "createDeposit" | "approve" | "pruneExpiredIntents" | "withdrawDeposit" | "removeFunds" | "addFunds";
+        description: string;
+    }>, "many">;
+    register: z.ZodObject<{
+        hashedOnchainIds: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        hashedOnchainIds: string[];
+    }, {
+        hashedOnchainIds: string[];
+    }>;
+}, "strip", z.ZodTypeAny, {
+    txs: {
+        chainId: number;
+        data: string;
+        to: string;
+        value: string;
+    }[];
+    steps: {
+        kind: "createDeposit" | "approve" | "pruneExpiredIntents" | "withdrawDeposit" | "removeFunds" | "addFunds";
+        description: string;
+    }[];
+    register: {
+        hashedOnchainIds: string[];
+    };
+}, {
+    txs: {
+        chainId: number;
+        data: string;
+        to: string;
+        value: string;
+    }[];
+    steps: {
+        kind: "createDeposit" | "approve" | "pruneExpiredIntents" | "withdrawDeposit" | "removeFunds" | "addFunds";
+        description: string;
+    }[];
+    register: {
+        hashedOnchainIds: string[];
+    };
+}>;
+declare const withdrawResultJsonSchema: z.ZodObject<{
+    depositId: z.ZodString;
+    pruneTxHash: z.ZodOptional<z.ZodString>;
+    withdrawTxHash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    depositId: string;
+    withdrawTxHash: string;
+    pruneTxHash?: string | undefined;
+}, {
+    depositId: string;
+    withdrawTxHash: string;
+    pruneTxHash?: string | undefined;
+}>;
+declare const topUpResultJsonSchema: z.ZodObject<{
+    depositId: z.ZodString;
+    txHash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    depositId: string;
+    txHash: string;
+}, {
+    depositId: string;
+    txHash: string;
+}>;
+declare const cashCapabilitiesJsonSchema: z.ZodObject<{
+    chainId: z.ZodNumber;
+    token: z.ZodObject<{
+        address: z.ZodString;
+        symbol: z.ZodLiteral<"USDC">;
+        decimals: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        symbol: "USDC";
+        address: string;
+        decimals: number;
+    }, {
+        symbol: "USDC";
+        address: string;
+        decimals: number;
+    }>;
+    environment: z.ZodEnum<["production", "preproduction", "staging"]>;
+    platforms: z.ZodArray<z.ZodObject<{
+        platform: z.ZodString;
+        currencies: z.ZodArray<z.ZodString, "many">;
+        payeeHint: z.ZodString;
+        requiresIdentityAttestation: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        platform: string;
+        currencies: string[];
+        payeeHint: string;
+        requiresIdentityAttestation: boolean;
+    }, {
+        platform: string;
+        currencies: string[];
+        payeeHint: string;
+        requiresIdentityAttestation: boolean;
+    }>, "many">;
+    currencies: z.ZodArray<z.ZodString, "many">;
+    amount: z.ZodObject<{
+        min: z.ZodString;
+        recommendedMin: z.ZodString;
+        max: z.ZodNull;
+    }, "strip", z.ZodTypeAny, {
+        min: string;
+        recommendedMin: string;
+        max: null;
+    }, {
+        min: string;
+        recommendedMin: string;
+        max: null;
+    }>;
+    pricing: z.ZodObject<{
+        kind: z.ZodLiteral<"oracle-market-rate">;
+        spreadBps: z.ZodLiteral<0>;
+    }, "strip", z.ZodTypeAny, {
+        spreadBps: 0;
+        kind: "oracle-market-rate";
+    }, {
+        spreadBps: 0;
+        kind: "oracle-market-rate";
+    }>;
+}, "strip", z.ZodTypeAny, {
+    amount: {
+        min: string;
+        recommendedMin: string;
+        max: null;
+    };
+    chainId: number;
+    token: {
+        symbol: "USDC";
+        address: string;
+        decimals: number;
+    };
+    environment: "production" | "preproduction" | "staging";
+    currencies: string[];
+    pricing: {
+        spreadBps: 0;
+        kind: "oracle-market-rate";
+    };
+    platforms: {
+        platform: string;
+        currencies: string[];
+        payeeHint: string;
+        requiresIdentityAttestation: boolean;
+    }[];
+}, {
+    amount: {
+        min: string;
+        recommendedMin: string;
+        max: null;
+    };
+    chainId: number;
+    token: {
+        symbol: "USDC";
+        address: string;
+        decimals: number;
+    };
+    environment: "production" | "preproduction" | "staging";
+    currencies: string[];
+    pricing: {
+        spreadBps: 0;
+        kind: "oracle-market-rate";
+    };
+    platforms: {
+        platform: string;
+        currencies: string[];
+        payeeHint: string;
+        requiresIdentityAttestation: boolean;
+    }[];
+}>;
+declare const cashErrorJsonSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    retryable: z.ZodBoolean;
+    remediation: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    message: string;
+    retryable: boolean;
+    remediation: string;
+}, {
+    code: string;
+    message: string;
+    retryable: boolean;
+    remediation: string;
+}>;
+type CashOrderJson = z.infer<typeof cashOrderJsonSchema>;
+type CashFillJson = z.infer<typeof cashFillJsonSchema>;
+type CashEstimateJson = z.infer<typeof cashEstimateJsonSchema>;
+type PreparedTransactionJson = z.infer<typeof preparedTransactionJsonSchema>;
+type CashoutResultJson = z.infer<typeof cashoutResultJsonSchema>;
+type PrepareResultJson = z.infer<typeof prepareResultJsonSchema>;
+type WithdrawResultJson = z.infer<typeof withdrawResultJsonSchema>;
+type TopUpResultJson = z.infer<typeof topUpResultJsonSchema>;
+type CashPreparedStepJson = z.infer<typeof cashPreparedStepJsonSchema>;
+type CashPayoutInfoJson = z.infer<typeof cashPayoutInfoJsonSchema>;
+type CashBuyerProfileJson = z.infer<typeof cashBuyerProfileJsonSchema>;
+type CashCapabilitiesJson = z.infer<typeof cashCapabilitiesJsonSchema>;
+
+/**
+ * JSON codecs - lossless (de)serialization for every wire type. bigints encode
+ * as decimal strings; `parse*` validates with the zod schema and re-attaches
+ * derived behavior (`order.explain()`).
+ */
+
+declare function fillToJson(fill: CashFill): CashFillJson;
+declare function fillFromJson(json: CashFillJson): CashFill;
+declare function orderToJson(order: CashOrder): CashOrderJson;
+declare function orderFromJson(json: unknown): CashOrder;
+declare function estimateToJson(estimate: CashEstimate): CashEstimateJson;
+declare function estimateFromJson(json: unknown): CashEstimate;
+declare function preparedTxToJson(tx: PreparedTransaction): PreparedTransactionJson;
+declare function preparedTxFromJson(json: unknown): PreparedTransaction;
+declare function preparedStepToJson(step: CashPreparedStep): CashPreparedStepJson;
+declare function preparedStepFromJson(json: unknown): CashPreparedStep;
+declare function cashoutResultToJson(result: CashoutResult): CashoutResultJson;
+declare function cashoutResultFromJson(json: unknown): CashoutResult;
+declare function prepareResultToJson(result: PrepareResult): PrepareResultJson;
+declare function prepareResultFromJson(json: unknown): PrepareResult;
+declare function withdrawResultToJson(result: WithdrawResult): WithdrawResultJson;
+declare function withdrawResultFromJson(json: unknown): WithdrawResult;
+declare function buyerProfileToJson(profile: CashBuyerProfile): CashBuyerProfileJson;
+declare function buyerProfileFromJson(json: unknown): CashBuyerProfile;
+declare function topUpResultToJson(result: TopUpResult): TopUpResultJson;
+declare function topUpResultFromJson(json: unknown): TopUpResult;
+declare function capabilitiesToJson(caps: CashCapabilities): CashCapabilitiesJson;
+declare function capabilitiesFromJson(json: unknown): CashCapabilities;
+
+export { BASE_CHAIN_ID, BASE_USDC_ADDRESS, CASH_ORDER_POLL_INTERVAL_MS, CASH_ORDER_STATUSES, CASH_RETAIN_ON_EMPTY, CashBuyerProfile, type CashBuyerProfileJson, CashCapabilities, type CashCapabilitiesJson, CashDepositInput, CashError, type CashErrorCode, type CashErrorShape, CashEstimate, type CashEstimateJson, CashFill, type CashFillJson, CashOrder, type CashOrderData, type CashOrderJson, CashPayoutInfo, type CashPayoutInfoJson, CashPreparedStep, type CashPreparedStepJson, CashoutResult, type CashoutResultJson, type DeriveCashOrderOptions, MARKET_SPREAD_BPS, type MethodCurrencyLike, ORACLE_MIN_CONVERSION_RATE_SENTINEL, type PaymentMethodLike, PrepareResult, type PrepareResultJson, type PreparedTransactionJson, RATE_PRECISION, type ResolvedCashDeposit, TopUpResult, type TopUpResultJson, USDC_DECIMALS, WithdrawResult, type WithdrawResultJson, bigintString, buildIntentAmountRange, buildMarketRateCurrencyOverride, buyerProfileFromJson, buyerProfileToJson, capabilitiesFromJson, capabilitiesToJson, cashBuyerProfileJsonSchema, cashCapabilitiesJsonSchema, cashErrorJsonSchema, cashEstimateJsonSchema, cashFillJsonSchema, cashNextActionSchema, cashOrderJsonSchema, cashOrderStateSchema, cashPayoutInfoJsonSchema, cashPayoutPricingJsonSchema, cashPreparedStepJsonSchema, cashoutResultFromJson, cashoutResultJsonSchema, cashoutResultToJson, centsToNumber, deriveBuyerProfile, deriveCashOrder, derivePayouts, errors, estimateFromJson, estimateToJson, explainOrder, fiatFromUsdc, fiatToNumber, fillFromJson, fillToJson, formatUsdc, intentStatusSchema, isCashError, isFillLive, isMarketRateSupported, orderFromJson, orderToJson, parseCompositeDepositId, prepareCashDepositParams, prepareResultFromJson, prepareResultJsonSchema, prepareResultToJson, preparedStepFromJson, preparedStepToJson, preparedTransactionJsonSchema, preparedTxFromJson, preparedTxToJson, rateToNumber, resolveCashDepositId, topUpResultFromJson, topUpResultJsonSchema, topUpResultToJson, usdc, withExplain, withdrawResultFromJson, withdrawResultJsonSchema, withdrawResultToJson };