@polymarket/bindings 0.4.0 → 0.6.0

package/dist/combos/index.d.ts

@@ -1,173 +1,9 @@
 import * as _polymarket_types from '@polymarket/types';
-import { HexString, EvmAddress, EvmSignature, Erc1271Signature } from '@polymarket/types';
+import { EvmAddress, HexString, EvmSignature, Erc1271Signature, TxHash } from '@polymarket/types';
+import { PositionId, TokenId, BaseUnits, OrderSide, MarketId, ConditionId, DecimalString, PaginationCursor, RfqId, RfqQuoteId, ComboConditionId, EpochMilliseconds, RfqRequestorPublicId, BuilderCode, EventId } from '../index.js';
 import { z } from 'zod';
-import { ComboConditionId, EventId, PositionId, DecimalString, MarketId, CtfConditionId, PaginationCursor, RfqId, RfqQuoteId, EpochMilliseconds, OrderSide, TokenId, BaseUnits, RfqRequestorPublicId } from '../index.js';
 import { S as SignatureType } from '../signature-type-CrLAA9AN.js';
 
-/**
- * Known collateral-return plan operation kinds.
- *
- * The service evolves this set independently of released clients, so plan
- * parsing accepts unknown kinds as plain strings; see
- * {@link CollateralReturnOperationKind}.
- */
-declare enum CollateralReturnKnownOperationKind {
-    Split = "split",
-    Merge = "merge",
-    Redeem = "redeem",
-    SplitOnCondition = "split_on_condition",
-    MergeOnCondition = "merge_on_condition",
-    SplitOnEvent = "split_on_event",
-    MergeOnEvent = "merge_on_event",
-    ConvertOnEvent = "convert_on_event",
-    Extract = "extract",
-    Inject = "inject",
-    ConvertToYesBasket = "convert_to_yes_basket",
-    MergeFromYesBasket = "merge_from_yes_basket",
-    Compress = "compress"
-}
-/**
- * A collateral-return operation kind. Known kinds are enumerated in
- * {@link CollateralReturnKnownOperationKind}; newly introduced kinds flow
- * through as plain strings so plans keep parsing before a client release that
- * enumerates them.
- */
-type CollateralReturnOperationKind = CollateralReturnKnownOperationKind | (string & {});
-type CollateralReturnOperation = {
-    kind: CollateralReturnOperationKind;
-    conditionId?: ComboConditionId;
-    eventId?: EventId;
-    positionId?: PositionId;
-    conditionIndex: number;
-    amount: DecimalString;
-};
-type CollateralReturnPositionAmount = {
-    positionId: PositionId;
-    amount: DecimalString;
-};
-type CollateralReturnPositionSummary = {
-    consumed: CollateralReturnPositionAmount[];
-    created: CollateralReturnPositionAmount[];
-};
-type CollateralReturnRouterCall = {
-    to: EvmAddress;
-    data: HexString;
-};
-/**
- * The plan fields execution consumes: the plan identifier round-tripped to
- * the service, the chain and wallet the plan was computed for, and the exact
- * Router call the execution signs and submits.
- */
-declare const CollateralReturnPlanSchema: z.ZodObject<{
-    planHash: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
-    chainId: z.ZodNumber;
-    wallet: z.ZodPipe<z.ZodString, z.ZodTransform<EvmAddress, string>>;
-    routerCall: z.ZodPipe<z.ZodObject<{
-        to: z.ZodPipe<z.ZodString, z.ZodTransform<EvmAddress, string>>;
-        data: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
-    }, z.core.$strip>, z.ZodTransform<CollateralReturnRouterCall, {
-        to: EvmAddress;
-        data: `0x${string}`;
-    }>>;
-}, z.core.$loose>;
-type CollateralReturnPlanResponse = {
-    planHash: HexString;
-    chainId: number;
-    wallet: EvmAddress;
-    blockNumber: bigint;
-    startingPusd: DecimalString;
-    netPusdOut: DecimalString;
-    finalPusd: DecimalString;
-    operations: CollateralReturnOperation[];
-    operationCount: number;
-    truncated: boolean;
-    estimatedCost: number;
-    requiredPusdInput: DecimalString;
-    requiredPositions: CollateralReturnPositionAmount[];
-    positionSummary: CollateralReturnPositionSummary;
-    candidatePositionIds: PositionId[];
-    routerCall: CollateralReturnRouterCall;
-};
-declare const CollateralReturnPlanResponseSchema: z.ZodPipe<z.ZodObject<{
-    plan_hash: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
-    chain_id: z.ZodNumber;
-    wallet: z.ZodPipe<z.ZodString, z.ZodTransform<EvmAddress, string>>;
-    block_number: z.ZodPipe<z.ZodString, z.ZodTransform<bigint, string>>;
-    starting_pusd: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
-    net_pusd_out: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
-    final_pusd: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
-    operations: z.ZodArray<z.ZodPipe<z.ZodObject<{
-        kind: z.ZodPipe<z.ZodString, z.ZodTransform<CollateralReturnKnownOperationKind | (string & {}), string>>;
-        condition_id: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<ComboConditionId, string>>>;
-        event_id: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodPipe<z.ZodNumber, z.ZodTransform<string, number>>]>, z.ZodTransform<EventId, string>>>;
-        position_id: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<PositionId, string>>>;
-        condition_index: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-        amount: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
-    }, z.core.$strip>, z.ZodTransform<CollateralReturnOperation, {
-        kind: CollateralReturnKnownOperationKind | (string & {});
-        condition_index: number;
-        amount: DecimalString;
-        condition_id?: ComboConditionId | undefined;
-        event_id?: EventId | undefined;
-        position_id?: PositionId | undefined;
-    }>>>;
-    operation_count: z.ZodNumber;
-    truncated: z.ZodBoolean;
-    estimated_cost: z.ZodNumber;
-    required_pusd_input: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
-    required_positions: z.ZodArray<z.ZodPipe<z.ZodObject<{
-        position_id: z.ZodPipe<z.ZodString, z.ZodTransform<PositionId, string>>;
-        amount: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
-    }, z.core.$strip>, z.ZodTransform<CollateralReturnPositionAmount, {
-        position_id: PositionId;
-        amount: DecimalString;
-    }>>>;
-    position_summary: z.ZodOptional<z.ZodPipe<z.ZodObject<{
-        consumed: z.ZodArray<z.ZodPipe<z.ZodObject<{
-            position_id: z.ZodPipe<z.ZodString, z.ZodTransform<PositionId, string>>;
-            amount: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
-        }, z.core.$strip>, z.ZodTransform<CollateralReturnPositionAmount, {
-            position_id: PositionId;
-            amount: DecimalString;
-        }>>>;
-        created: z.ZodArray<z.ZodPipe<z.ZodObject<{
-            position_id: z.ZodPipe<z.ZodString, z.ZodTransform<PositionId, string>>;
-            amount: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
-        }, z.core.$strip>, z.ZodTransform<CollateralReturnPositionAmount, {
-            position_id: PositionId;
-            amount: DecimalString;
-        }>>>;
-    }, z.core.$strip>, z.ZodTransform<CollateralReturnPositionSummary, {
-        consumed: CollateralReturnPositionAmount[];
-        created: CollateralReturnPositionAmount[];
-    }>>>;
-    candidate_position_ids: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<PositionId, string>>>;
-    router_call: z.ZodPipe<z.ZodObject<{
-        to: z.ZodPipe<z.ZodString, z.ZodTransform<EvmAddress, string>>;
-        data: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
-    }, z.core.$strip>, z.ZodTransform<CollateralReturnRouterCall, {
-        to: EvmAddress;
-        data: `0x${string}`;
-    }>>;
-}, z.core.$strip>, z.ZodTransform<CollateralReturnPlanResponse, {
-    plan_hash: `0x${string}`;
-    chain_id: number;
-    wallet: EvmAddress;
-    block_number: bigint;
-    starting_pusd: DecimalString;
-    net_pusd_out: DecimalString;
-    final_pusd: DecimalString;
-    operations: CollateralReturnOperation[];
-    operation_count: number;
-    truncated: boolean;
-    estimated_cost: number;
-    required_pusd_input: DecimalString;
-    required_positions: CollateralReturnPositionAmount[];
-    candidate_position_ids: PositionId[];
-    router_call: CollateralReturnRouterCall;
-    position_summary?: CollateralReturnPositionSummary | undefined;
-}>>;
-
 declare enum RfqDirection {
     Buy = "BUY",
     Sell = "SELL"
@@ -212,6 +48,7 @@ declare enum RfqKnownErrorCode {
     InternalError = "INTERNAL_ERROR",
     LegMetadataUnavailable = "LEG_METADATA_UNAVAILABLE",
     MakerAlreadyResponded = "MAKER_ALREADY_RESPONDED",
+    MakerDeclined = "MAKER_DECLINED",
     MakerNotRequired = "MAKER_NOT_REQUIRED",
     MakerQuoteLimited = "MAKER_QUOTE_LIMITED",
     MissingMakerAddressInQuote = "MISSING_MAKER_ADDRESS_IN_QUOTE",
@@ -226,6 +63,7 @@ declare enum RfqKnownErrorCode {
     MissingTakerAmountInSignedOrder = "MISSING_TAKER_AMOUNT_IN_SIGNED_ORDER",
     MissingTimestampInSignedOrder = "MISSING_TIMESTAMP_IN_SIGNED_ORDER",
     MissingTokenIdInSignedOrder = "MISSING_TOKEN_ID_IN_SIGNED_ORDER",
+    NoQuotes = "NO_QUOTES",
     OrderSideOrTokenDoesNotMatchRequest = "ORDER_SIDE_OR_TOKEN_DOES_NOT_MATCH_REQUEST",
     PreExecutionBalanceReservationFailed = "PRE_EXECUTION_BALANCE_RESERVATION_FAILED",
     PriceE6NotPositive = "PRICE_E6_NOT_POSITIVE",
@@ -244,6 +82,7 @@ declare enum RfqKnownErrorCode {
     SignedOrderSizeDoesNotCoverQuote = "SIGNED_ORDER_SIZE_DOES_NOT_COVER_QUOTE",
     SignedOrderTakerAmountNotPositive = "SIGNED_ORDER_TAKER_AMOUNT_NOT_POSITIVE",
     SizeE6NotPositive = "SIZE_E6_NOT_POSITIVE",
+    SizeTooLarge = "SIZE_TOO_LARGE",
     SubmissionWindowClosed = "SUBMISSION_WINDOW_CLOSED",
     TradeSubmissionFailed = "TRADE_SUBMISSION_FAILED",
     Unauthenticated = "UNAUTHENTICATED",
@@ -258,7 +97,7 @@ declare enum RfqKnownErrorCode {
 type RfqErrorCode = RfqKnownErrorCode | (string & {});
 type ComboMarket = {
     id: MarketId;
-    conditionId: CtfConditionId;
+    conditionId: ConditionId;
     slug: string;
     title: string;
     outcomes: ComboMarketOutcomes;
@@ -278,7 +117,7 @@ type ComboMarketOutcomes = {
 declare const ListComboMarketsResponseSchema: z.ZodPipe<z.ZodObject<{
     markets: z.ZodArray<z.ZodPipe<z.ZodObject<{
         id: z.ZodPipe<z.ZodString, z.ZodTransform<MarketId, string>>;
-        condition_id: z.ZodPipe<z.ZodString, z.ZodTransform<CtfConditionId, string>>;
+        condition_id: z.ZodPipe<z.ZodString, z.ZodTransform<ConditionId, string>>;
         position_ids: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<PositionId, string>>>;
         slug: z.ZodString;
         title: z.ZodString;
@@ -289,7 +128,7 @@ declare const ListComboMarketsResponseSchema: z.ZodPipe<z.ZodObject<{
         tags: z.ZodArray<z.ZodString>;
     }, z.core.$strip>, z.ZodTransform<ComboMarket, {
         id: MarketId;
-        condition_id: CtfConditionId;
+        condition_id: ConditionId;
         position_ids: PositionId[];
         slug: string;
         title: string;
@@ -604,11 +443,11 @@ declare const RfqErrorMessageSchema: z.ZodPipe<z.ZodObject<{
     request_type: z.ZodOptional<z.ZodString>;
     rfq_id: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<RfqId, string>>>;
     quote_id: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<RfqQuoteId, string>>>;
-    code: z.ZodPipe<z.ZodString, z.ZodTransform<(string & {}) | RfqKnownErrorCode, string>>;
+    code: z.ZodPipe<z.ZodString, z.ZodTransform<RfqKnownErrorCode | (string & {}), string>>;
     error: z.ZodString;
     request: z.ZodOptional<z.ZodUnknown>;
 }, z.core.$strip>, z.ZodTransform<{
-    code: (string & {}) | RfqKnownErrorCode;
+    code: RfqKnownErrorCode | (string & {});
     errorId: string | undefined;
     message: string;
     quoteId: RfqQuoteId | undefined;
@@ -617,7 +456,7 @@ declare const RfqErrorMessageSchema: z.ZodPipe<z.ZodObject<{
     type: "rfq_error";
 }, {
     type: RfqKnownInboundType.Error;
-    code: (string & {}) | RfqKnownErrorCode;
+    code: RfqKnownErrorCode | (string & {});
     error: string;
     error_id?: string | undefined;
     request_type?: string | undefined;
@@ -839,11 +678,11 @@ declare const RfqQuoterInboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
     request_type: z.ZodOptional<z.ZodString>;
     rfq_id: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<RfqId, string>>>;
     quote_id: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<RfqQuoteId, string>>>;
-    code: z.ZodPipe<z.ZodString, z.ZodTransform<(string & {}) | RfqKnownErrorCode, string>>;
+    code: z.ZodPipe<z.ZodString, z.ZodTransform<RfqKnownErrorCode | (string & {}), string>>;
     error: z.ZodString;
     request: z.ZodOptional<z.ZodUnknown>;
 }, z.core.$strip>, z.ZodTransform<{
-    code: (string & {}) | RfqKnownErrorCode;
+    code: RfqKnownErrorCode | (string & {});
     errorId: string | undefined;
     message: string;
     quoteId: RfqQuoteId | undefined;
@@ -852,7 +691,7 @@ declare const RfqQuoterInboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
     type: "rfq_error";
 }, {
     type: RfqKnownInboundType.Error;
-    code: (string & {}) | RfqKnownErrorCode;
+    code: RfqKnownErrorCode | (string & {});
     error: string;
     error_id?: string | undefined;
     request_type?: string | undefined;
@@ -863,4 +702,421 @@ declare const RfqQuoterInboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
 type RfqQuoterInboundMessage = z.infer<typeof RfqQuoterInboundMessageSchema>;
 type RfqQuoterOutboundMessage = RfqQuoteMessage | RfqQuoteCancelMessage | RfqConfirmationResponseMessage;
 
-export { CollateralReturnKnownOperationKind, type CollateralReturnOperation, type CollateralReturnOperationKind, type CollateralReturnPlanResponse, CollateralReturnPlanResponseSchema, CollateralReturnPlanSchema, type CollateralReturnPositionAmount, type CollateralReturnPositionSummary, type CollateralReturnRouterCall, type ComboMarket, type ComboMarketOutcome, type ComboMarketOutcomes, type ListComboMarketsResponse, ListComboMarketsResponseSchema, type RfqAuthMessage, type RfqAuthResponseMessage, type RfqConfirmationAck, RfqConfirmationDecision, type RfqConfirmationRequest, type RfqConfirmationResponseMessage, RfqDirection, type RfqErrorCode, type RfqErrorMessage, RfqExecutionStatus, type RfqExecutionUpdate, RfqId, RfqKnownErrorCode, RfqKnownInboundType, type RfqOrderSide, type RfqQuoteAck, type RfqQuoteCancelAck, type RfqQuoteCancelMessage, RfqQuoteId, type RfqQuoteMessage, type RfqQuoteRequest, type RfqQuoterInboundMessage, RfqQuoterInboundMessageSchema, type RfqQuoterOutboundMessage, type RfqRequestedSize, RfqRequestedSizeUnit, RfqRequestorPublicId, RfqSide, type RfqSignedOrder, type RfqTrade };
+/** Lifecycle status of an RFQ. */
+declare enum RfqStatus {
+    AwaitingRequesterAcceptance = "AWAITING_REQUESTER_ACCEPTANCE",
+    AwaitingMakerConfirmation = "AWAITING_MAKER_CONFIRMATION",
+    Executing = "EXECUTING",
+    Filled = "FILLED",
+    Failed = "FAILED",
+    Expired = "EXPIRED",
+    Canceled = "CANCELED"
+}
+/**
+ * Machine-readable reason an RFQ request or acceptance was rejected.
+ *
+ * @remarks
+ * Codes not enumerated in this SDK release are classified as
+ * {@link RfqRejectionCode.RequestFailed} with the original error preserved on
+ * `cause`.
+ */
+declare enum RfqRejectionCode {
+    /** The request body could not be decoded as JSON. */
+    InvalidJson = "INVALID_JSON",
+    /** The request message is malformed. */
+    InvalidMessage = "INVALID_MESSAGE",
+    /** The authenticated role is not valid for this request. */
+    InvalidRole = "INVALID_ROLE",
+    /** The authenticated role is not authorized for this request. */
+    UnauthorizedRole = "UNAUTHORIZED_ROLE",
+    /** Authentication credentials are missing or invalid. */
+    Unauthenticated = "UNAUTHENTICATED",
+    /** The authenticated address does not match the request. */
+    AddressMismatch = "ADDRESS_MISMATCH",
+    /** The request is malformed or references invalid legs. */
+    InvalidRfq = "INVALID_RFQ",
+    /** The legs are mutually exclusive (e.g. YES and NO on the same market). */
+    ContradictoryLegs = "CONTRADICTORY_LEGS",
+    /** Leg metadata is temporarily unavailable; the request may be retried. */
+    LegMetadataUnavailable = "LEG_METADATA_UNAVAILABLE",
+    /** The acceptance is invalid (unknown RFQ, wrong state, quote/builder mismatch). */
+    InvalidAcceptance = "INVALID_ACCEPTANCE",
+    /** The referenced quote is invalid or no longer available. */
+    InvalidQuote = "INVALID_QUOTE",
+    /** The order signature failed verification. */
+    InvalidSignature = "INVALID_SIGNATURE",
+    /** The request identity is invalid. */
+    InvalidIdentity = "INVALID_IDENTITY",
+    /** The RFQ does not exist for the authenticated requester. */
+    UnknownRfq = "UNKNOWN_RFQ",
+    /** The RFQ acceptance window has expired. */
+    ExpiredRfq = "EXPIRED_RFQ",
+    /** The RFQ is not in a state that permits this operation. */
+    InvalidRfqState = "INVALID_RFQ_STATE",
+    /** The quote does not match the RFQ being accepted. */
+    QuoteMismatch = "QUOTE_MISMATCH",
+    /** The submission window is closed. */
+    SubmissionWindowClosed = "SUBMISSION_WINDOW_CLOSED",
+    /** A required service is temporarily unavailable. */
+    ServiceUnavailable = "SERVICE_UNAVAILABLE",
+    /** Balance reservation failed before execution. */
+    PreExecutionBalanceReservationFailed = "PRE_EXECUTION_BALANCE_RESERVATION_FAILED",
+    /** The requester does not have sufficient balance. */
+    BalanceValidationFailed = "BALANCE_VALIDATION_FAILED",
+    /** The requester does not have sufficient allowance. */
+    AllowanceValidationFailed = "ALLOWANCE_VALIDATION_FAILED",
+    /** The accepted trade could not be submitted for execution. */
+    TradeSubmissionFailed = "TRADE_SUBMISSION_FAILED",
+    /** The request failed without a more specific classification. */
+    RequestFailed = "REQUEST_FAILED"
+}
+/** Reason no quote was returned for a combo quote request. */
+declare enum ComboQuoteUnavailableReason {
+    NoQuotes = "NO_QUOTES",
+    SizeTooLarge = "SIZE_TOO_LARGE"
+}
+/** Reason an accepted combo quote did not proceed to a fill. */
+declare enum ComboAcceptFailureReason {
+    MakerDeclined = "MAKER_DECLINED",
+    AcceptanceWindowExpired = "ACCEPTANCE_WINDOW_EXPIRED",
+    /** The trade failed before or during onchain execution handoff. */
+    ExecutionFailed = "EXECUTION_FAILED"
+}
+type BuilderRfqRequestedSize = {
+    unit: RfqRequestedSizeUnit;
+    value_e6: string;
+};
+type BuilderRfqCreateRequest = {
+    signer_address: EvmAddress;
+    maker_address: EvmAddress;
+    signature_type: SignatureType;
+    leg_position_ids: string[];
+    direction: RfqDirection;
+    side: RfqSide;
+    requested_size: BuilderRfqRequestedSize;
+};
+type BuilderRfqAcceptRequest = {
+    quote_id: string;
+    signed_order: RfqSignedOrder;
+};
+/** Structured error carried inside combo RFQ responses. */
+type BuilderRfqError = {
+    code: RfqErrorCode;
+    message: string;
+};
+/** The winning quote for an RFQ. */
+type BuilderRfqQuote = {
+    quoteId: RfqQuoteId;
+    /** Blended price across legs, in collateral per outcome token. */
+    blendedPrice: DecimalString;
+    /** Signed-order collateral for BUY, or position shares for SELL. */
+    makerAmount: DecimalString;
+    /** Signed-order shares for BUY, or gross collateral limit for SELL. */
+    takerAmount: DecimalString;
+    /** Total collateral (BUY) or position-share (SELL) balance required to accept. */
+    totalRequired: DecimalString;
+    /** Exact collateral proceeds after fees. Present only for SELL quotes. */
+    netReceive?: DecimalString;
+};
+type BuilderRfqResponseRequestedSize = {
+    unit: RfqRequestedSizeUnit;
+    valueE6: BaseUnits;
+};
+/** Original request echoed by a quote-ready builder RFQ response. */
+type BuilderRfqResponseRequest = {
+    rfqId: RfqId;
+    legPositionIds: PositionId[];
+    conditionId: ComboConditionId;
+    yesPositionId: PositionId;
+    noPositionId: PositionId;
+    direction: RfqDirection;
+    side: RfqSide;
+    requestedSize: BuilderRfqResponseRequestedSize;
+};
+type BuilderRfqQuoteReadyResponse = {
+    rfqId: RfqId;
+    status: RfqStatus.AwaitingRequesterAcceptance;
+    /** Acceptance deadline (Unix ms). */
+    expiresAt: EpochMilliseconds;
+    builderCode: BuilderCode;
+    request: BuilderRfqResponseRequest;
+    quote: BuilderRfqQuote;
+};
+type BuilderRfqFinalStateResponse = {
+    rfqId: RfqId;
+    status: RfqStatus.Failed | RfqStatus.Expired | RfqStatus.Canceled;
+    error?: BuilderRfqError;
+};
+declare const BuilderRfqCreateResponseSchema: z.ZodUnion<readonly [z.ZodPipe<z.ZodObject<{
+    rfq_id: z.ZodPipe<z.ZodString, z.ZodTransform<RfqId, string>>;
+    status: z.ZodLiteral<RfqStatus.AwaitingRequesterAcceptance>;
+    expires_at: z.ZodPipe<z.ZodNumber, z.ZodTransform<EpochMilliseconds, number>>;
+    builder_code: z.ZodPipe<z.ZodString, z.ZodTransform<BuilderCode, string>>;
+    request: z.ZodPipe<z.ZodObject<{
+        rfq_id: z.ZodPipe<z.ZodString, z.ZodTransform<RfqId, string>>;
+        leg_position_ids: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<PositionId, string>>>;
+        condition_id: z.ZodPipe<z.ZodString, z.ZodTransform<ComboConditionId, string>>;
+        yes_position_id: z.ZodPipe<z.ZodString, z.ZodTransform<PositionId, string>>;
+        no_position_id: z.ZodPipe<z.ZodString, z.ZodTransform<PositionId, string>>;
+        direction: z.ZodEnum<typeof RfqDirection>;
+        side: z.ZodEnum<typeof RfqSide>;
+        requested_size: z.ZodPipe<z.ZodObject<{
+            unit: z.ZodEnum<typeof RfqRequestedSizeUnit>;
+            value_e6: z.ZodPipe<z.ZodString, z.ZodTransform<BaseUnits, string>>;
+        }, z.core.$strip>, z.ZodTransform<BuilderRfqResponseRequestedSize, {
+            unit: RfqRequestedSizeUnit;
+            value_e6: BaseUnits;
+        }>>;
+    }, z.core.$strip>, z.ZodTransform<BuilderRfqResponseRequest, {
+        rfq_id: RfqId;
+        leg_position_ids: PositionId[];
+        condition_id: ComboConditionId;
+        yes_position_id: PositionId;
+        no_position_id: PositionId;
+        direction: RfqDirection;
+        side: RfqSide;
+        requested_size: BuilderRfqResponseRequestedSize;
+    }>>;
+    quote: z.ZodPipe<z.ZodObject<{
+        quote_id: z.ZodPipe<z.ZodString, z.ZodTransform<RfqQuoteId, string>>;
+        blended_price_e6: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
+        maker_amount_e6: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
+        taker_amount_e6: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
+        total_required_e6: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
+        net_receive_e6: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>>;
+    }, z.core.$strip>, z.ZodTransform<BuilderRfqQuote, {
+        quote_id: RfqQuoteId;
+        blended_price_e6: DecimalString;
+        maker_amount_e6: DecimalString;
+        taker_amount_e6: DecimalString;
+        total_required_e6: DecimalString;
+        net_receive_e6?: DecimalString | undefined;
+    }>>;
+}, z.core.$strip>, z.ZodTransform<BuilderRfqQuoteReadyResponse, {
+    rfq_id: RfqId;
+    status: RfqStatus.AwaitingRequesterAcceptance;
+    expires_at: EpochMilliseconds;
+    builder_code: BuilderCode;
+    request: BuilderRfqResponseRequest;
+    quote: BuilderRfqQuote;
+}>>, z.ZodPipe<z.ZodObject<{
+    rfq_id: z.ZodPipe<z.ZodString, z.ZodTransform<RfqId, string>>;
+    status: z.ZodEnum<{
+        FAILED: RfqStatus.Failed;
+        EXPIRED: RfqStatus.Expired;
+        CANCELED: RfqStatus.Canceled;
+    }>;
+    error: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+        code: z.ZodPipe<z.ZodString, z.ZodTransform<RfqKnownErrorCode | (string & {}), string>>;
+        message: z.ZodString;
+    }, z.core.$strip>, z.ZodTransform<BuilderRfqError, {
+        code: RfqKnownErrorCode | (string & {});
+        message: string;
+    }>>>;
+}, z.core.$strip>, z.ZodTransform<BuilderRfqFinalStateResponse, {
+    rfq_id: RfqId;
+    status: RfqStatus.Failed | RfqStatus.Expired | RfqStatus.Canceled;
+    error?: BuilderRfqError | undefined;
+}>>]>;
+type BuilderRfqCreateResponse = BuilderRfqQuoteReadyResponse | BuilderRfqFinalStateResponse;
+/**
+ * Status projection returned on accept responses and post-acceptance status
+ * reads.
+ *
+ * @remarks
+ * Onchain execution progress is merged into the top-level `status`:
+ * {@link RfqExecutionStatus} values surface alongside the RFQ lifecycle
+ * (`MATCHED` is reported as {@link RfqStatus.Executing}).
+ */
+type BuilderRfqStatusResponse = {
+    rfqId: RfqId;
+    status: RfqStatus | RfqExecutionStatus;
+    takerOrderHash?: string;
+    txHash?: TxHash;
+    error?: BuilderRfqError;
+};
+declare const BuilderRfqStatusResponseSchema: z.ZodPipe<z.ZodObject<{
+    rfq_id: z.ZodPipe<z.ZodString, z.ZodTransform<RfqId, string>>;
+    status: z.ZodUnion<readonly [z.ZodEnum<typeof RfqStatus>, z.ZodEnum<typeof RfqExecutionStatus>]>;
+    taker_order_hash: z.ZodOptional<z.ZodString>;
+    tx_hash: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<TxHash, string>>>;
+    error: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+        code: z.ZodPipe<z.ZodString, z.ZodTransform<RfqKnownErrorCode | (string & {}), string>>;
+        message: z.ZodString;
+    }, z.core.$strip>, z.ZodTransform<BuilderRfqError, {
+        code: RfqKnownErrorCode | (string & {});
+        message: string;
+    }>>>;
+}, z.core.$strip>, z.ZodTransform<BuilderRfqStatusResponse, {
+    rfq_id: RfqId;
+    status: RfqExecutionStatus | RfqStatus;
+    taker_order_hash?: string | undefined;
+    tx_hash?: TxHash | undefined;
+    error?: BuilderRfqError | undefined;
+}>>;
+
+/**
+ * Known collateral-return plan operation kinds.
+ *
+ * The service evolves this set independently of released clients, so plan
+ * parsing accepts unknown kinds as plain strings; see
+ * {@link CollateralReturnOperationKind}.
+ */
+declare enum CollateralReturnKnownOperationKind {
+    Split = "split",
+    Merge = "merge",
+    Redeem = "redeem",
+    SplitOnCondition = "split_on_condition",
+    MergeOnCondition = "merge_on_condition",
+    SplitOnEvent = "split_on_event",
+    MergeOnEvent = "merge_on_event",
+    ConvertOnEvent = "convert_on_event",
+    Extract = "extract",
+    Inject = "inject",
+    ConvertToYesBasket = "convert_to_yes_basket",
+    MergeFromYesBasket = "merge_from_yes_basket",
+    Compress = "compress"
+}
+/**
+ * A collateral-return operation kind. Known kinds are enumerated in
+ * {@link CollateralReturnKnownOperationKind}; newly introduced kinds flow
+ * through as plain strings so plans keep parsing before a client release that
+ * enumerates them.
+ */
+type CollateralReturnOperationKind = CollateralReturnKnownOperationKind | (string & {});
+type CollateralReturnOperation = {
+    kind: CollateralReturnOperationKind;
+    conditionId?: ComboConditionId;
+    eventId?: EventId;
+    positionId?: PositionId;
+    conditionIndex: number;
+    amount: DecimalString;
+};
+type CollateralReturnPositionAmount = {
+    positionId: PositionId;
+    amount: DecimalString;
+};
+type CollateralReturnPositionSummary = {
+    consumed: CollateralReturnPositionAmount[];
+    created: CollateralReturnPositionAmount[];
+};
+type CollateralReturnRouterCall = {
+    to: EvmAddress;
+    data: HexString;
+};
+/**
+ * The plan fields execution consumes: the plan identifier round-tripped to
+ * the service, the chain and wallet the plan was computed for, and the exact
+ * Router call the execution signs and submits.
+ */
+declare const CollateralReturnPlanSchema: z.ZodObject<{
+    planHash: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    chainId: z.ZodNumber;
+    wallet: z.ZodPipe<z.ZodString, z.ZodTransform<EvmAddress, string>>;
+    routerCall: z.ZodPipe<z.ZodObject<{
+        to: z.ZodPipe<z.ZodString, z.ZodTransform<EvmAddress, string>>;
+        data: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    }, z.core.$strip>, z.ZodTransform<CollateralReturnRouterCall, {
+        to: EvmAddress;
+        data: `0x${string}`;
+    }>>;
+}, z.core.$loose>;
+type CollateralReturnPlanResponse = {
+    planHash: HexString;
+    chainId: number;
+    wallet: EvmAddress;
+    blockNumber: bigint;
+    startingPusd: DecimalString;
+    netPusdOut: DecimalString;
+    finalPusd: DecimalString;
+    operations: CollateralReturnOperation[];
+    operationCount: number;
+    truncated: boolean;
+    estimatedCost: number;
+    requiredPusdInput: DecimalString;
+    requiredPositions: CollateralReturnPositionAmount[];
+    positionSummary: CollateralReturnPositionSummary;
+    candidatePositionIds: PositionId[];
+    routerCall: CollateralReturnRouterCall;
+};
+declare const CollateralReturnPlanResponseSchema: z.ZodPipe<z.ZodObject<{
+    plan_hash: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    chain_id: z.ZodNumber;
+    wallet: z.ZodPipe<z.ZodString, z.ZodTransform<EvmAddress, string>>;
+    block_number: z.ZodPipe<z.ZodString, z.ZodTransform<bigint, string>>;
+    starting_pusd: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
+    net_pusd_out: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
+    final_pusd: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
+    operations: z.ZodArray<z.ZodPipe<z.ZodObject<{
+        kind: z.ZodPipe<z.ZodString, z.ZodTransform<(string & {}) | CollateralReturnKnownOperationKind, string>>;
+        condition_id: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<ComboConditionId, string>>>;
+        event_id: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodPipe<z.ZodNumber, z.ZodTransform<string, number>>]>, z.ZodTransform<EventId, string>>>;
+        position_id: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<PositionId, string>>>;
+        condition_index: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        amount: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
+    }, z.core.$strip>, z.ZodTransform<CollateralReturnOperation, {
+        kind: (string & {}) | CollateralReturnKnownOperationKind;
+        condition_index: number;
+        amount: DecimalString;
+        condition_id?: ComboConditionId | undefined;
+        event_id?: EventId | undefined;
+        position_id?: PositionId | undefined;
+    }>>>;
+    operation_count: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    estimated_cost: z.ZodNumber;
+    required_pusd_input: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
+    required_positions: z.ZodArray<z.ZodPipe<z.ZodObject<{
+        position_id: z.ZodPipe<z.ZodString, z.ZodTransform<PositionId, string>>;
+        amount: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
+    }, z.core.$strip>, z.ZodTransform<CollateralReturnPositionAmount, {
+        position_id: PositionId;
+        amount: DecimalString;
+    }>>>;
+    position_summary: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+        consumed: z.ZodArray<z.ZodPipe<z.ZodObject<{
+            position_id: z.ZodPipe<z.ZodString, z.ZodTransform<PositionId, string>>;
+            amount: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
+        }, z.core.$strip>, z.ZodTransform<CollateralReturnPositionAmount, {
+            position_id: PositionId;
+            amount: DecimalString;
+        }>>>;
+        created: z.ZodArray<z.ZodPipe<z.ZodObject<{
+            position_id: z.ZodPipe<z.ZodString, z.ZodTransform<PositionId, string>>;
+            amount: z.ZodPipe<z.ZodString, z.ZodTransform<DecimalString, string>>;
+        }, z.core.$strip>, z.ZodTransform<CollateralReturnPositionAmount, {
+            position_id: PositionId;
+            amount: DecimalString;
+        }>>>;
+    }, z.core.$strip>, z.ZodTransform<CollateralReturnPositionSummary, {
+        consumed: CollateralReturnPositionAmount[];
+        created: CollateralReturnPositionAmount[];
+    }>>>;
+    candidate_position_ids: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<PositionId, string>>>;
+    router_call: z.ZodPipe<z.ZodObject<{
+        to: z.ZodPipe<z.ZodString, z.ZodTransform<EvmAddress, string>>;
+        data: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    }, z.core.$strip>, z.ZodTransform<CollateralReturnRouterCall, {
+        to: EvmAddress;
+        data: `0x${string}`;
+    }>>;
+}, z.core.$strip>, z.ZodTransform<CollateralReturnPlanResponse, {
+    plan_hash: `0x${string}`;
+    chain_id: number;
+    wallet: EvmAddress;
+    block_number: bigint;
+    starting_pusd: DecimalString;
+    net_pusd_out: DecimalString;
+    final_pusd: DecimalString;
+    operations: CollateralReturnOperation[];
+    operation_count: number;
+    truncated: boolean;
+    estimated_cost: number;
+    required_pusd_input: DecimalString;
+    required_positions: CollateralReturnPositionAmount[];
+    candidate_position_ids: PositionId[];
+    router_call: CollateralReturnRouterCall;
+    position_summary?: CollateralReturnPositionSummary | undefined;
+}>>;
+
+export { type BuilderRfqAcceptRequest, type BuilderRfqCreateRequest, type BuilderRfqCreateResponse, BuilderRfqCreateResponseSchema, type BuilderRfqError, type BuilderRfqFinalStateResponse, type BuilderRfqQuote, type BuilderRfqQuoteReadyResponse, type BuilderRfqRequestedSize, type BuilderRfqResponseRequest, type BuilderRfqResponseRequestedSize, type BuilderRfqStatusResponse, BuilderRfqStatusResponseSchema, CollateralReturnKnownOperationKind, type CollateralReturnOperation, type CollateralReturnOperationKind, type CollateralReturnPlanResponse, CollateralReturnPlanResponseSchema, CollateralReturnPlanSchema, type CollateralReturnPositionAmount, type CollateralReturnPositionSummary, type CollateralReturnRouterCall, ComboAcceptFailureReason, type ComboMarket, type ComboMarketOutcome, type ComboMarketOutcomes, ComboQuoteUnavailableReason, type ListComboMarketsResponse, ListComboMarketsResponseSchema, type RfqAuthMessage, type RfqAuthResponseMessage, type RfqConfirmationAck, RfqConfirmationDecision, type RfqConfirmationRequest, type RfqConfirmationResponseMessage, RfqDirection, type RfqErrorCode, type RfqErrorMessage, RfqExecutionStatus, type RfqExecutionUpdate, RfqId, RfqKnownErrorCode, RfqKnownInboundType, type RfqOrderSide, type RfqQuoteAck, type RfqQuoteCancelAck, type RfqQuoteCancelMessage, RfqQuoteId, type RfqQuoteMessage, type RfqQuoteRequest, type RfqQuoterInboundMessage, RfqQuoterInboundMessageSchema, type RfqQuoterOutboundMessage, RfqRejectionCode, type RfqRequestedSize, RfqRequestedSizeUnit, RfqRequestorPublicId, RfqSide, type RfqSignedOrder, RfqStatus, type RfqTrade };