@bosonprotocol/x402-core 0.1.0-alpha-0

package/dist/cjs/schemes/escrow/index.d.ts

@@ -0,0 +1,1262 @@
+import { z } from 'zod';
+import * as _bosonprotocol_core_sdk_dist_cjs_subgraph_js from '@bosonprotocol/core-sdk/dist/cjs/subgraph.js';
+import { E as ExchangeState, D as DisputeState } from '../../states-Q2FJASHh.js';
+import '@bosonprotocol/core-sdk';
+
+/**
+ * CAIP-2 network identifier for an EVM chain. Constrained to `eip155:<chainId>`
+ * shape at runtime by the JSON Schema and zod regex; aliased to `string` here
+ * for the same reason as `Address` / `Hex` — the wire format is JSON, where
+ * everything is a string, and template-literal types cause friction with
+ * zod's regex-based validators.
+ */
+type EvmNetwork = string;
+/** BPIP-12 token-authorization strategies. */
+type TokenAuthStrategy = "none" | "erc3009" | "permit" | "permit2";
+declare const TOKEN_AUTH_STRATEGIES: readonly TokenAuthStrategy[];
+/** Boson commit-time action ids advertised by the server. */
+type BosonCommitActionId = "boson-createOfferAndCommit" | "boson-createOfferCommitAndRedeem";
+/** Channels through which a `nextAction` can be performed. */
+type ActionChannel = "server" | "facilitator" | "onchain" | "mcp" | "xmtp";
+declare const ACTION_CHANNELS: readonly ActionChannel[];
+/**
+ * BPIP-10 FullOffer. Treated as opaque at this layer — the on-chain shape lives
+ * in `@bosonprotocol/core-sdk`, and validation against the protocol struct is
+ * the EIP-712 builder's job. Here it's just "an object echoed verbatim".
+ */
+type FullOffer = Record<string, unknown>;
+/**
+ * 0x-prefixed hex string. Aliased to `string` in the wire format so JSON
+ * shapes are easy to construct; runtime validation is handled by the JSON
+ * Schema and zod regex. The strongly-typed `\`0x${string}\`` form is reserved
+ * for the EIP-712 builder layer where viem's brands matter.
+ */
+type Hex = string;
+/** 0x-prefixed 40-char hex string. See `Hex` for typing rationale. */
+type Address = string;
+/** Off-chain offer reference signed by the seller. */
+interface BosonOfferRef {
+    fullOffer: FullOffer;
+    sellerSig: Hex;
+    creator: Address;
+}
+interface FulfillmentOption {
+    id: string;
+    /** JSON-Schema-shaped `type: object` description of the data the buyer must supply, or `null` for schemaless channels. */
+    schema: Record<string, unknown> | null;
+    /** Channel-specific hints advertised to the client, such as endpoint URLs or public keys. */
+    metadata?: unknown;
+}
+interface FulfillmentRequirements {
+    required: boolean;
+    options: FulfillmentOption[];
+}
+interface NextAction {
+    id: string;
+    channels: ActionChannel[];
+    endpoints?: Record<string, string>;
+    /**
+     * ISO 8601 absolute timestamp by which the action must be invoked.
+     * Relevant for dispute-window-bounded actions like
+     * `boson-resolveDispute`, `boson-escalateDispute`,
+     * `boson-retractDispute`, and (post-commit) `boson-completeExchange`.
+     */
+    deadline?: string;
+}
+interface OnchainHints {
+    /** Address of the Boson escrow contract. */
+    escrow: Address;
+    metaTxFacet: string;
+    /**
+     * Per-`tokenAuthStrategy` meta-tx entry points on `metaTxFacet`. The
+     * Boson Diamond exposes two functions on `MetaTransactionsHandlerFacet`:
+     *
+     * - `executeMetaTransaction` — legacy BPIP-9 entry point. Used when
+     *   the buyer's `tokenAuthStrategy` is `none` (the buyer has
+     *   pre-approved the Diamond, so no token-transfer authorization
+     *   queue is needed). Also the right entry point for any
+     *   post-commit action that doesn't move tokens (`redeem`,
+     *   `complete`, dispute transitions).
+     * - `executeMetaTransactionWithTokenTransferAuthorization` — BPIP-12
+     *   entry point. Carries the buyer's signed `MetaTransaction` *and*
+     *   a queue of token-transfer authorizations. Used when
+     *   `tokenAuthStrategy` is `erc3009`, `permit`, or `permit2`.
+     *
+     * Clients select the entry point by their chosen strategy at
+     * dispatch time.
+     */
+    metaTxEntrypoints: Record<TokenAuthStrategy, string>;
+    actionFacets: Record<string, string>;
+}
+interface ActionsFallback {
+    xmtp?: string;
+    /**
+     * Identifier within the Boson MCP server (e.g. the
+     * `bosonprotocol/agentic-commerce` server) that the buyer's
+     * MCP-aware agent dispatches against. The MCP *server* is escrow-
+     * level (one BosonMCP serving every Boson seller); this value is the
+     * URI/identifier the BosonMCP routes to the right exchange / seller.
+     */
+    mcp?: string;
+    onchainHints?: OnchainHints;
+}
+interface ActionsEnvelope {
+    next: NextAction[];
+    fallback?: ActionsFallback;
+}
+/** Boson protocol meta-transaction envelope (signed by the buyer). */
+interface BosonMetaTx {
+    from: Address;
+    /** Decimal string. */
+    nonce: string;
+    functionName: string;
+    /**
+     * ABI-encoded function-call data as a `0x`-prefixed hex string. Named
+     * `functionSignature` to match the on-chain `MetaTransactionsHandlerFacet`
+     * struct field — the value is the encoded calldata, not just the function
+     * selector.
+     */
+    functionSignature: Hex;
+    sig: {
+        v: number;
+        r: Hex;
+        s: Hex;
+    };
+}
+interface Erc3009AuthData {
+    from: Address;
+    to: Address;
+    /** Atomic units, decimal string. */
+    value: string;
+    validAfter: number;
+    validBefore: number;
+    /** 32-byte hex string. */
+    nonce: Hex;
+    v: number;
+    r: Hex;
+    s: Hex;
+}
+interface PermitAuthData {
+    owner: Address;
+    spender: Address;
+    /** Atomic units, decimal string. */
+    value: string;
+    deadline: number;
+    /** Token-internal sequential nonce, decimal string. */
+    nonce: string;
+    v: number;
+    r: Hex;
+    s: Hex;
+}
+interface Permit2AuthData {
+    permitted: {
+        token: Address;
+        amount: string;
+    };
+    spender: Address;
+    /** Permit2 word-bitmap nonce, decimal string. */
+    nonce: string;
+    deadline: number;
+    /** Concatenated 65-byte ECDSA signature. */
+    signature: Hex;
+}
+/** Discriminated union of all token-authorization payloads. `none` is encoded by the absence of this field on the payload. */
+type BosonTokenAuth = {
+    kind: "erc3009";
+    data: Erc3009AuthData;
+} | {
+    kind: "permit";
+    data: PermitAuthData;
+} | {
+    kind: "permit2";
+    data: Permit2AuthData;
+};
+
+/**
+ * Wire-format type for the `escrow` PaymentRequirements that a server emits
+ * inside a 402 `accepts[]` entry. See docs/boson-impl-01-escrow-scheme.md §2
+ * for field semantics.
+ */
+interface EscrowPaymentRequirements {
+    scheme: "escrow";
+    network: EvmNetwork;
+    asset: Address;
+    /** Atomic units, decimal string. */
+    amount: string;
+    /** Address of the Boson escrow contract — the custodian. */
+    escrowAddress: Address;
+    /** Routing-only seller identifier. May be a numeric `sellerId`, a `did:boson:seller:N`, or a wallet address. */
+    recipientId: string;
+    maxTimeoutSeconds: number;
+    offer: BosonOfferRef;
+    tokenAuthStrategies: TokenAuthStrategy[];
+    fulfillment?: FulfillmentRequirements;
+    actions: ActionsEnvelope;
+}
+/** Zod validator paired with `payment_requirements.schema.json`. */
+declare const escrowPaymentRequirementsSchema: z.ZodObject<{
+    scheme: z.ZodLiteral<"escrow">;
+    network: z.ZodString;
+    asset: z.ZodString;
+    amount: z.ZodString;
+    escrowAddress: z.ZodString;
+    recipientId: z.ZodString;
+    maxTimeoutSeconds: z.ZodNumber;
+    offer: z.ZodObject<{
+        fullOffer: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        sellerSig: z.ZodString;
+        creator: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        fullOffer: Record<string, unknown>;
+        sellerSig: string;
+        creator: string;
+    }, {
+        fullOffer: Record<string, unknown>;
+        sellerSig: string;
+        creator: string;
+    }>;
+    tokenAuthStrategies: z.ZodEffects<z.ZodArray<z.ZodEnum<[TokenAuthStrategy, ...TokenAuthStrategy[]]>, "many">, TokenAuthStrategy[], TokenAuthStrategy[]>;
+    fulfillment: z.ZodOptional<z.ZodObject<{
+        required: z.ZodBoolean;
+        options: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            schema: z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodNull]>;
+            metadata: z.ZodOptional<z.ZodUnknown>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            schema: Record<string, unknown> | null;
+            metadata?: unknown;
+        }, {
+            id: string;
+            schema: Record<string, unknown> | null;
+            metadata?: unknown;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        options: {
+            id: string;
+            schema: Record<string, unknown> | null;
+            metadata?: unknown;
+        }[];
+        required: boolean;
+    }, {
+        options: {
+            id: string;
+            schema: Record<string, unknown> | null;
+            metadata?: unknown;
+        }[];
+        required: boolean;
+    }>>;
+    actions: z.ZodObject<{
+        next: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            channels: z.ZodEffects<z.ZodArray<z.ZodEnum<[ActionChannel, ...ActionChannel[]]>, "many">, ActionChannel[], ActionChannel[]>;
+            endpoints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            deadline: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            channels: ActionChannel[];
+            endpoints?: Record<string, string> | undefined;
+            deadline?: string | undefined;
+        }, {
+            id: string;
+            channels: ActionChannel[];
+            endpoints?: Record<string, string> | undefined;
+            deadline?: string | undefined;
+        }>, "many">;
+        fallback: z.ZodOptional<z.ZodObject<{
+            xmtp: z.ZodOptional<z.ZodString>;
+            mcp: z.ZodOptional<z.ZodString>;
+            onchainHints: z.ZodOptional<z.ZodObject<{
+                escrow: z.ZodString;
+                metaTxFacet: z.ZodString;
+                metaTxEntrypoints: z.ZodObject<{
+                    none: z.ZodString;
+                    erc3009: z.ZodString;
+                    permit: z.ZodString;
+                    permit2: z.ZodString;
+                }, "strict", z.ZodTypeAny, {
+                    none: string;
+                    erc3009: string;
+                    permit: string;
+                    permit2: string;
+                }, {
+                    none: string;
+                    erc3009: string;
+                    permit: string;
+                    permit2: string;
+                }>;
+                actionFacets: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                escrow: string;
+                metaTxFacet: string;
+                metaTxEntrypoints: {
+                    none: string;
+                    erc3009: string;
+                    permit: string;
+                    permit2: string;
+                };
+                actionFacets: Record<string, string>;
+            }, {
+                escrow: string;
+                metaTxFacet: string;
+                metaTxEntrypoints: {
+                    none: string;
+                    erc3009: string;
+                    permit: string;
+                    permit2: string;
+                };
+                actionFacets: Record<string, string>;
+            }>>;
+        }, "strict", z.ZodTypeAny, {
+            mcp?: string | undefined;
+            xmtp?: string | undefined;
+            onchainHints?: {
+                escrow: string;
+                metaTxFacet: string;
+                metaTxEntrypoints: {
+                    none: string;
+                    erc3009: string;
+                    permit: string;
+                    permit2: string;
+                };
+                actionFacets: Record<string, string>;
+            } | undefined;
+        }, {
+            mcp?: string | undefined;
+            xmtp?: string | undefined;
+            onchainHints?: {
+                escrow: string;
+                metaTxFacet: string;
+                metaTxEntrypoints: {
+                    none: string;
+                    erc3009: string;
+                    permit: string;
+                    permit2: string;
+                };
+                actionFacets: Record<string, string>;
+            } | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        next: {
+            id: string;
+            channels: ActionChannel[];
+            endpoints?: Record<string, string> | undefined;
+            deadline?: string | undefined;
+        }[];
+        fallback?: {
+            mcp?: string | undefined;
+            xmtp?: string | undefined;
+            onchainHints?: {
+                escrow: string;
+                metaTxFacet: string;
+                metaTxEntrypoints: {
+                    none: string;
+                    erc3009: string;
+                    permit: string;
+                    permit2: string;
+                };
+                actionFacets: Record<string, string>;
+            } | undefined;
+        } | undefined;
+    }, {
+        next: {
+            id: string;
+            channels: ActionChannel[];
+            endpoints?: Record<string, string> | undefined;
+            deadline?: string | undefined;
+        }[];
+        fallback?: {
+            mcp?: string | undefined;
+            xmtp?: string | undefined;
+            onchainHints?: {
+                escrow: string;
+                metaTxFacet: string;
+                metaTxEntrypoints: {
+                    none: string;
+                    erc3009: string;
+                    permit: string;
+                    permit2: string;
+                };
+                actionFacets: Record<string, string>;
+            } | undefined;
+        } | undefined;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    scheme: "escrow";
+    network: string;
+    asset: string;
+    amount: string;
+    escrowAddress: string;
+    recipientId: string;
+    maxTimeoutSeconds: number;
+    offer: {
+        fullOffer: Record<string, unknown>;
+        sellerSig: string;
+        creator: string;
+    };
+    tokenAuthStrategies: TokenAuthStrategy[];
+    actions: {
+        next: {
+            id: string;
+            channels: ActionChannel[];
+            endpoints?: Record<string, string> | undefined;
+            deadline?: string | undefined;
+        }[];
+        fallback?: {
+            mcp?: string | undefined;
+            xmtp?: string | undefined;
+            onchainHints?: {
+                escrow: string;
+                metaTxFacet: string;
+                metaTxEntrypoints: {
+                    none: string;
+                    erc3009: string;
+                    permit: string;
+                    permit2: string;
+                };
+                actionFacets: Record<string, string>;
+            } | undefined;
+        } | undefined;
+    };
+    fulfillment?: {
+        options: {
+            id: string;
+            schema: Record<string, unknown> | null;
+            metadata?: unknown;
+        }[];
+        required: boolean;
+    } | undefined;
+}, {
+    scheme: "escrow";
+    network: string;
+    asset: string;
+    amount: string;
+    escrowAddress: string;
+    recipientId: string;
+    maxTimeoutSeconds: number;
+    offer: {
+        fullOffer: Record<string, unknown>;
+        sellerSig: string;
+        creator: string;
+    };
+    tokenAuthStrategies: TokenAuthStrategy[];
+    actions: {
+        next: {
+            id: string;
+            channels: ActionChannel[];
+            endpoints?: Record<string, string> | undefined;
+            deadline?: string | undefined;
+        }[];
+        fallback?: {
+            mcp?: string | undefined;
+            xmtp?: string | undefined;
+            onchainHints?: {
+                escrow: string;
+                metaTxFacet: string;
+                metaTxEntrypoints: {
+                    none: string;
+                    erc3009: string;
+                    permit: string;
+                    permit2: string;
+                };
+                actionFacets: Record<string, string>;
+            } | undefined;
+        } | undefined;
+    };
+    fulfillment?: {
+        options: {
+            id: string;
+            schema: Record<string, unknown> | null;
+            metadata?: unknown;
+        }[];
+        required: boolean;
+    } | undefined;
+}>;
+/** Type-guard form. Returns the parsed value on success, throws on failure (with a `ZodError` carrying the field path). */
+declare function parseEscrowPaymentRequirements(value: unknown): EscrowPaymentRequirements;
+
+/** Inner `payload` field of `EscrowPaymentPayload`. */
+interface EscrowPaymentPayloadInner {
+    action: string;
+    tokenAuthStrategy: TokenAuthStrategy;
+    offerRef: {
+        fullOffer: FullOffer;
+        sellerSig: Hex;
+    };
+    buyer: Address;
+    metaTx: BosonMetaTx;
+    /** Required iff `tokenAuthStrategy !== "none"`. */
+    tokenAuth?: BosonTokenAuth;
+}
+/**
+ * Wire-format type for the `escrow` PaymentPayload that a client base64's into
+ * the `X-PAYMENT` header. See docs/boson-impl-01-escrow-scheme.md §3.
+ *
+ * `fulfillment.option` is always the buyer's pick from the server-advertised
+ * option set (capability negotiation). `fulfillment.data` is action-conditional:
+ *
+ * - For atomic Flow B (`boson-createOfferCommitAndRedeem`), `data` MUST be
+ *   present (or `null` when the option's schema is `null`). Atomic Flow B
+ *   completes the redeem on-chain inside the commit transaction, so there's
+ *   no later round trip in which the buyer could hand the seller delivery
+ *   data — it must travel with `X-PAYMENT`.
+ * - For two-step Flow A (`boson-createOfferAndCommit`), `data` MUST be
+ *   omitted. The buyer attaches it to the redeem-time POST body that
+ *   accompanies `boson-redeem`, after a successful commit. See
+ *   `docs/boson-impl-03-fulfillment-channels.md`.
+ *
+ * The Zod schema parses both shapes structurally; the action-conditional
+ * presence/absence rule is enforced by the server-side validator (rule 13).
+ */
+interface EscrowPaymentPayload {
+    x402Version: number;
+    scheme: "escrow";
+    network: EvmNetwork;
+    payload: EscrowPaymentPayloadInner;
+    fulfillment?: {
+        option: string;
+        data?: Record<string, unknown> | null;
+    };
+}
+/**
+ * Zod validator paired with `payment_payload.schema.json`. Note: this only
+ * validates structural shape; cross-field rules (per docs/boson-impl-01 §5)
+ * such as "tokenAuth must be omitted iff tokenAuthStrategy === 'none'" are
+ * enforced server-side and are not part of this schema.
+ */
+declare const escrowPaymentPayloadSchema: z.ZodObject<{
+    x402Version: z.ZodNumber;
+    scheme: z.ZodLiteral<"escrow">;
+    network: z.ZodString;
+    payload: z.ZodObject<{
+        action: z.ZodString;
+        tokenAuthStrategy: z.ZodEnum<[TokenAuthStrategy, ...TokenAuthStrategy[]]>;
+        offerRef: z.ZodObject<{
+            fullOffer: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            sellerSig: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            fullOffer: Record<string, unknown>;
+            sellerSig: string;
+        }, {
+            fullOffer: Record<string, unknown>;
+            sellerSig: string;
+        }>;
+        buyer: z.ZodString;
+        metaTx: z.ZodObject<{
+            from: z.ZodString;
+            nonce: z.ZodString;
+            functionName: z.ZodString;
+            functionSignature: z.ZodString;
+            sig: z.ZodObject<{
+                v: z.ZodNumber;
+                r: z.ZodString;
+                s: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                v: number;
+                r: string;
+                s: string;
+            }, {
+                v: number;
+                r: string;
+                s: string;
+            }>;
+        }, "strict", z.ZodTypeAny, {
+            functionSignature: string;
+            from: string;
+            sig: {
+                v: number;
+                r: string;
+                s: string;
+            };
+            functionName: string;
+            nonce: string;
+        }, {
+            functionSignature: string;
+            from: string;
+            sig: {
+                v: number;
+                r: string;
+                s: string;
+            };
+            functionName: string;
+            nonce: string;
+        }>;
+        tokenAuth: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"erc3009">;
+            data: z.ZodObject<{
+                from: z.ZodString;
+                to: z.ZodString;
+                value: z.ZodString;
+                validAfter: z.ZodNumber;
+                validBefore: z.ZodNumber;
+                nonce: z.ZodString;
+                v: z.ZodNumber;
+                r: z.ZodString;
+                s: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                value: string;
+                from: string;
+                to: string;
+                nonce: string;
+                v: number;
+                r: string;
+                s: string;
+                validAfter: number;
+                validBefore: number;
+            }, {
+                value: string;
+                from: string;
+                to: string;
+                nonce: string;
+                v: number;
+                r: string;
+                s: string;
+                validAfter: number;
+                validBefore: number;
+            }>;
+        }, "strict", z.ZodTypeAny, {
+            data: {
+                value: string;
+                from: string;
+                to: string;
+                nonce: string;
+                v: number;
+                r: string;
+                s: string;
+                validAfter: number;
+                validBefore: number;
+            };
+            kind: "erc3009";
+        }, {
+            data: {
+                value: string;
+                from: string;
+                to: string;
+                nonce: string;
+                v: number;
+                r: string;
+                s: string;
+                validAfter: number;
+                validBefore: number;
+            };
+            kind: "erc3009";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"permit">;
+            data: z.ZodObject<{
+                owner: z.ZodString;
+                spender: z.ZodString;
+                value: z.ZodString;
+                deadline: z.ZodNumber;
+                nonce: z.ZodString;
+                v: z.ZodNumber;
+                r: z.ZodString;
+                s: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                value: string;
+                deadline: number;
+                owner: string;
+                spender: string;
+                nonce: string;
+                v: number;
+                r: string;
+                s: string;
+            }, {
+                value: string;
+                deadline: number;
+                owner: string;
+                spender: string;
+                nonce: string;
+                v: number;
+                r: string;
+                s: string;
+            }>;
+        }, "strict", z.ZodTypeAny, {
+            data: {
+                value: string;
+                deadline: number;
+                owner: string;
+                spender: string;
+                nonce: string;
+                v: number;
+                r: string;
+                s: string;
+            };
+            kind: "permit";
+        }, {
+            data: {
+                value: string;
+                deadline: number;
+                owner: string;
+                spender: string;
+                nonce: string;
+                v: number;
+                r: string;
+                s: string;
+            };
+            kind: "permit";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"permit2">;
+            data: z.ZodObject<{
+                permitted: z.ZodObject<{
+                    token: z.ZodString;
+                    amount: z.ZodString;
+                }, "strict", z.ZodTypeAny, {
+                    amount: string;
+                    token: string;
+                }, {
+                    amount: string;
+                    token: string;
+                }>;
+                spender: z.ZodString;
+                nonce: z.ZodString;
+                deadline: z.ZodNumber;
+                signature: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                deadline: number;
+                spender: string;
+                nonce: string;
+                signature: string;
+                permitted: {
+                    amount: string;
+                    token: string;
+                };
+            }, {
+                deadline: number;
+                spender: string;
+                nonce: string;
+                signature: string;
+                permitted: {
+                    amount: string;
+                    token: string;
+                };
+            }>;
+        }, "strict", z.ZodTypeAny, {
+            data: {
+                deadline: number;
+                spender: string;
+                nonce: string;
+                signature: string;
+                permitted: {
+                    amount: string;
+                    token: string;
+                };
+            };
+            kind: "permit2";
+        }, {
+            data: {
+                deadline: number;
+                spender: string;
+                nonce: string;
+                signature: string;
+                permitted: {
+                    amount: string;
+                    token: string;
+                };
+            };
+            kind: "permit2";
+        }>]>>;
+    }, "strict", z.ZodTypeAny, {
+        action: string;
+        buyer: string;
+        tokenAuthStrategy: TokenAuthStrategy;
+        offerRef: {
+            fullOffer: Record<string, unknown>;
+            sellerSig: string;
+        };
+        metaTx: {
+            functionSignature: string;
+            from: string;
+            sig: {
+                v: number;
+                r: string;
+                s: string;
+            };
+            functionName: string;
+            nonce: string;
+        };
+        tokenAuth?: {
+            data: {
+                value: string;
+                from: string;
+                to: string;
+                nonce: string;
+                v: number;
+                r: string;
+                s: string;
+                validAfter: number;
+                validBefore: number;
+            };
+            kind: "erc3009";
+        } | {
+            data: {
+                value: string;
+                deadline: number;
+                owner: string;
+                spender: string;
+                nonce: string;
+                v: number;
+                r: string;
+                s: string;
+            };
+            kind: "permit";
+        } | {
+            data: {
+                deadline: number;
+                spender: string;
+                nonce: string;
+                signature: string;
+                permitted: {
+                    amount: string;
+                    token: string;
+                };
+            };
+            kind: "permit2";
+        } | undefined;
+    }, {
+        action: string;
+        buyer: string;
+        tokenAuthStrategy: TokenAuthStrategy;
+        offerRef: {
+            fullOffer: Record<string, unknown>;
+            sellerSig: string;
+        };
+        metaTx: {
+            functionSignature: string;
+            from: string;
+            sig: {
+                v: number;
+                r: string;
+                s: string;
+            };
+            functionName: string;
+            nonce: string;
+        };
+        tokenAuth?: {
+            data: {
+                value: string;
+                from: string;
+                to: string;
+                nonce: string;
+                v: number;
+                r: string;
+                s: string;
+                validAfter: number;
+                validBefore: number;
+            };
+            kind: "erc3009";
+        } | {
+            data: {
+                value: string;
+                deadline: number;
+                owner: string;
+                spender: string;
+                nonce: string;
+                v: number;
+                r: string;
+                s: string;
+            };
+            kind: "permit";
+        } | {
+            data: {
+                deadline: number;
+                spender: string;
+                nonce: string;
+                signature: string;
+                permitted: {
+                    amount: string;
+                    token: string;
+                };
+            };
+            kind: "permit2";
+        } | undefined;
+    }>;
+    fulfillment: z.ZodOptional<z.ZodObject<{
+        option: z.ZodString;
+        data: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodNull]>>;
+    }, "strict", z.ZodTypeAny, {
+        option: string;
+        data?: Record<string, unknown> | null | undefined;
+    }, {
+        option: string;
+        data?: Record<string, unknown> | null | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    scheme: "escrow";
+    network: string;
+    x402Version: number;
+    payload: {
+        action: string;
+        buyer: string;
+        tokenAuthStrategy: TokenAuthStrategy;
+        offerRef: {
+            fullOffer: Record<string, unknown>;
+            sellerSig: string;
+        };
+        metaTx: {
+            functionSignature: string;
+            from: string;
+            sig: {
+                v: number;
+                r: string;
+                s: string;
+            };
+            functionName: string;
+            nonce: string;
+        };
+        tokenAuth?: {
+            data: {
+                value: string;
+                from: string;
+                to: string;
+                nonce: string;
+                v: number;
+                r: string;
+                s: string;
+                validAfter: number;
+                validBefore: number;
+            };
+            kind: "erc3009";
+        } | {
+            data: {
+                value: string;
+                deadline: number;
+                owner: string;
+                spender: string;
+                nonce: string;
+                v: number;
+                r: string;
+                s: string;
+            };
+            kind: "permit";
+        } | {
+            data: {
+                deadline: number;
+                spender: string;
+                nonce: string;
+                signature: string;
+                permitted: {
+                    amount: string;
+                    token: string;
+                };
+            };
+            kind: "permit2";
+        } | undefined;
+    };
+    fulfillment?: {
+        option: string;
+        data?: Record<string, unknown> | null | undefined;
+    } | undefined;
+}, {
+    scheme: "escrow";
+    network: string;
+    x402Version: number;
+    payload: {
+        action: string;
+        buyer: string;
+        tokenAuthStrategy: TokenAuthStrategy;
+        offerRef: {
+            fullOffer: Record<string, unknown>;
+            sellerSig: string;
+        };
+        metaTx: {
+            functionSignature: string;
+            from: string;
+            sig: {
+                v: number;
+                r: string;
+                s: string;
+            };
+            functionName: string;
+            nonce: string;
+        };
+        tokenAuth?: {
+            data: {
+                value: string;
+                from: string;
+                to: string;
+                nonce: string;
+                v: number;
+                r: string;
+                s: string;
+                validAfter: number;
+                validBefore: number;
+            };
+            kind: "erc3009";
+        } | {
+            data: {
+                value: string;
+                deadline: number;
+                owner: string;
+                spender: string;
+                nonce: string;
+                v: number;
+                r: string;
+                s: string;
+            };
+            kind: "permit";
+        } | {
+            data: {
+                deadline: number;
+                spender: string;
+                nonce: string;
+                signature: string;
+                permitted: {
+                    amount: string;
+                    token: string;
+                };
+            };
+            kind: "permit2";
+        } | undefined;
+    };
+    fulfillment?: {
+        option: string;
+        data?: Record<string, unknown> | null | undefined;
+    } | undefined;
+}>;
+declare function parseEscrowPaymentPayload(value: unknown): EscrowPaymentPayload;
+
+/**
+ * Wire-format type for the post-commit `nextActions` envelope.
+ *
+ * The `exchangeState === DISPUTED ↔ disputeState present` invariant is
+ * encoded structurally: `exchangeState: DISPUTED` requires
+ * `disputeState`, and any other `exchangeState` forbids it. The zod
+ * validator below enforces the same invariant at runtime.
+ *
+ * The wire field is named `exchangeState` (not `state`) for symmetry
+ * with `disputeState` and to remove ambiguity with the `state` field
+ * the subgraph entity itself carries.
+ */
+type EscrowNextActions = {
+    exchangeId: string;
+    next: NextAction[];
+    fallback?: ActionsFallback;
+} & ({
+    exchangeState: Exclude<ExchangeState, typeof ExchangeState.DISPUTED>;
+    disputeState?: never;
+} | {
+    exchangeState: typeof ExchangeState.DISPUTED;
+    disputeState: DisputeState;
+});
+/** Zod validator paired with `next_actions.schema.json`. */
+declare const escrowNextActionsSchema: z.ZodEffects<z.ZodObject<{
+    exchangeId: z.ZodString;
+    exchangeState: z.ZodNativeEnum<typeof _bosonprotocol_core_sdk_dist_cjs_subgraph_js.ExchangeState>;
+    disputeState: z.ZodOptional<z.ZodNativeEnum<typeof _bosonprotocol_core_sdk_dist_cjs_subgraph_js.DisputeState>>;
+    next: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        channels: z.ZodEffects<z.ZodArray<z.ZodEnum<[ActionChannel, ...ActionChannel[]]>, "many">, ActionChannel[], ActionChannel[]>;
+        endpoints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        deadline: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        channels: ActionChannel[];
+        endpoints?: Record<string, string> | undefined;
+        deadline?: string | undefined;
+    }, {
+        id: string;
+        channels: ActionChannel[];
+        endpoints?: Record<string, string> | undefined;
+        deadline?: string | undefined;
+    }>, "many">;
+    fallback: z.ZodOptional<z.ZodObject<{
+        xmtp: z.ZodOptional<z.ZodString>;
+        mcp: z.ZodOptional<z.ZodString>;
+        onchainHints: z.ZodOptional<z.ZodObject<{
+            escrow: z.ZodString;
+            metaTxFacet: z.ZodString;
+            metaTxEntrypoints: z.ZodObject<{
+                none: z.ZodString;
+                erc3009: z.ZodString;
+                permit: z.ZodString;
+                permit2: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                none: string;
+                erc3009: string;
+                permit: string;
+                permit2: string;
+            }, {
+                none: string;
+                erc3009: string;
+                permit: string;
+                permit2: string;
+            }>;
+            actionFacets: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            escrow: string;
+            metaTxFacet: string;
+            metaTxEntrypoints: {
+                none: string;
+                erc3009: string;
+                permit: string;
+                permit2: string;
+            };
+            actionFacets: Record<string, string>;
+        }, {
+            escrow: string;
+            metaTxFacet: string;
+            metaTxEntrypoints: {
+                none: string;
+                erc3009: string;
+                permit: string;
+                permit2: string;
+            };
+            actionFacets: Record<string, string>;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        mcp?: string | undefined;
+        xmtp?: string | undefined;
+        onchainHints?: {
+            escrow: string;
+            metaTxFacet: string;
+            metaTxEntrypoints: {
+                none: string;
+                erc3009: string;
+                permit: string;
+                permit2: string;
+            };
+            actionFacets: Record<string, string>;
+        } | undefined;
+    }, {
+        mcp?: string | undefined;
+        xmtp?: string | undefined;
+        onchainHints?: {
+            escrow: string;
+            metaTxFacet: string;
+            metaTxEntrypoints: {
+                none: string;
+                erc3009: string;
+                permit: string;
+                permit2: string;
+            };
+            actionFacets: Record<string, string>;
+        } | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    next: {
+        id: string;
+        channels: ActionChannel[];
+        endpoints?: Record<string, string> | undefined;
+        deadline?: string | undefined;
+    }[];
+    exchangeId: string;
+    exchangeState: _bosonprotocol_core_sdk_dist_cjs_subgraph_js.ExchangeState;
+    fallback?: {
+        mcp?: string | undefined;
+        xmtp?: string | undefined;
+        onchainHints?: {
+            escrow: string;
+            metaTxFacet: string;
+            metaTxEntrypoints: {
+                none: string;
+                erc3009: string;
+                permit: string;
+                permit2: string;
+            };
+            actionFacets: Record<string, string>;
+        } | undefined;
+    } | undefined;
+    disputeState?: _bosonprotocol_core_sdk_dist_cjs_subgraph_js.DisputeState | undefined;
+}, {
+    next: {
+        id: string;
+        channels: ActionChannel[];
+        endpoints?: Record<string, string> | undefined;
+        deadline?: string | undefined;
+    }[];
+    exchangeId: string;
+    exchangeState: _bosonprotocol_core_sdk_dist_cjs_subgraph_js.ExchangeState;
+    fallback?: {
+        mcp?: string | undefined;
+        xmtp?: string | undefined;
+        onchainHints?: {
+            escrow: string;
+            metaTxFacet: string;
+            metaTxEntrypoints: {
+                none: string;
+                erc3009: string;
+                permit: string;
+                permit2: string;
+            };
+            actionFacets: Record<string, string>;
+        } | undefined;
+    } | undefined;
+    disputeState?: _bosonprotocol_core_sdk_dist_cjs_subgraph_js.DisputeState | undefined;
+}>, {
+    next: {
+        id: string;
+        channels: ActionChannel[];
+        endpoints?: Record<string, string> | undefined;
+        deadline?: string | undefined;
+    }[];
+    exchangeId: string;
+    exchangeState: _bosonprotocol_core_sdk_dist_cjs_subgraph_js.ExchangeState;
+    fallback?: {
+        mcp?: string | undefined;
+        xmtp?: string | undefined;
+        onchainHints?: {
+            escrow: string;
+            metaTxFacet: string;
+            metaTxEntrypoints: {
+                none: string;
+                erc3009: string;
+                permit: string;
+                permit2: string;
+            };
+            actionFacets: Record<string, string>;
+        } | undefined;
+    } | undefined;
+    disputeState?: _bosonprotocol_core_sdk_dist_cjs_subgraph_js.DisputeState | undefined;
+}, {
+    next: {
+        id: string;
+        channels: ActionChannel[];
+        endpoints?: Record<string, string> | undefined;
+        deadline?: string | undefined;
+    }[];
+    exchangeId: string;
+    exchangeState: _bosonprotocol_core_sdk_dist_cjs_subgraph_js.ExchangeState;
+    fallback?: {
+        mcp?: string | undefined;
+        xmtp?: string | undefined;
+        onchainHints?: {
+            escrow: string;
+            metaTxFacet: string;
+            metaTxEntrypoints: {
+                none: string;
+                erc3009: string;
+                permit: string;
+                permit2: string;
+            };
+            actionFacets: Record<string, string>;
+        } | undefined;
+    } | undefined;
+    disputeState?: _bosonprotocol_core_sdk_dist_cjs_subgraph_js.DisputeState | undefined;
+}>;
+/** Type-guard form. Returns the parsed value on success, throws on failure. */
+declare function parseEscrowNextActions(value: unknown): EscrowNextActions;
+
+/** 0x-prefixed hex string, at least one nibble. */
+declare const HEX: RegExp;
+/** 0x-prefixed hex string, allowing the empty `0x` form for empty bytes. */
+declare const HEX_BYTES: RegExp;
+/** 0x-prefixed 32-byte (64-nibble) hex string. */
+declare const HEX32: RegExp;
+/** 0x-prefixed 20-byte (40-nibble) hex address. */
+declare const ADDRESS: RegExp;
+/** Decimal unsigned integer string, no leading zeros (except "0" itself). */
+declare const DECIMAL_UINT: RegExp;
+/** CAIP-2 EVM network identifier: `eip155:<chainId>`. */
+declare const EVM_NETWORK: RegExp;
+declare const addressSchema: z.ZodString;
+declare const hexSchema: z.ZodString;
+declare const hexBytesSchema: z.ZodString;
+declare const hex32Schema: z.ZodString;
+declare const decimalUintSchema: z.ZodString;
+declare const evmNetworkSchema: z.ZodString;
+
+/** Stable identifier for the scheme. Use this in place of the raw string `"escrow"` to avoid typos. */
+declare const ESCROW_SCHEME: "escrow";
+type EscrowScheme = typeof ESCROW_SCHEME;
+
+export { ACTION_CHANNELS, ADDRESS, type ActionChannel, type ActionsEnvelope, type ActionsFallback, type Address, type BosonCommitActionId, type BosonMetaTx, type BosonOfferRef, type BosonTokenAuth, DECIMAL_UINT, ESCROW_SCHEME, EVM_NETWORK, type Erc3009AuthData, type EscrowNextActions, type EscrowPaymentPayload, type EscrowPaymentPayloadInner, type EscrowPaymentRequirements, type EscrowScheme, type EvmNetwork, type FulfillmentOption, type FulfillmentRequirements, type FullOffer, HEX, HEX32, HEX_BYTES, type Hex, type NextAction, type OnchainHints, type Permit2AuthData, type PermitAuthData, TOKEN_AUTH_STRATEGIES, type TokenAuthStrategy, addressSchema, decimalUintSchema, escrowNextActionsSchema, escrowPaymentPayloadSchema, escrowPaymentRequirementsSchema, evmNetworkSchema, hex32Schema, hexBytesSchema, hexSchema, parseEscrowNextActions, parseEscrowPaymentPayload, parseEscrowPaymentRequirements };