@agg-build/sdk 4.5.0 → 4.7.0

package/dist/index.d.mts

@@ -1226,11 +1226,11 @@ interface TSchema extends TKind, SchemaOptions {
  * Always carry a human-readable `message` alongside; the code is additive and
  * may be absent on rejections that pre-date this addition.
  */
-declare const QuoteErrorCodeTB: TUnion<[TLiteral<"quote_not_found">, TLiteral<"quote_expired">, TLiteral<"quote_already_executed">, TLiteral<"quote_cancelled">, TLiteral<"quote_user_mismatch">, TLiteral<"quote_app_blocked">, TLiteral<"quote_unfillable">, TLiteral<"quote_min_order_size">, TLiteral<"quote_stale_status">, TLiteral<"quote_stale_price">, TLiteral<"quote_insufficient_balance">, TLiteral<"quote_market_inactive">, TLiteral<"venue_not_executable">, TLiteral<"outcome_ambiguous">]>;
+declare const QuoteErrorCodeTB: TUnion<[TLiteral<"quote_not_found">, TLiteral<"quote_expired">, TLiteral<"quote_already_executed">, TLiteral<"quote_cancelled">, TLiteral<"quote_user_mismatch">, TLiteral<"quote_app_blocked">, TLiteral<"quote_unfillable">, TLiteral<"quote_min_order_size">, TLiteral<"quote_stale_status">, TLiteral<"quote_stale_price">, TLiteral<"quote_insufficient_balance">, TLiteral<"quote_market_inactive">, TLiteral<"quote_self_custody_unsupported_venue">, TLiteral<"quote_self_custody_app_fee">, TLiteral<"quote_self_custody_redeem_unsupported">, TLiteral<"venue_not_executable">, TLiteral<"outcome_ambiguous">]>;
 type QuoteErrorCode = Static<typeof QuoteErrorCodeTB>;
 declare const QuoteErrorTB: TObject<{
     message: TString;
-    code: TOptional<TUnion<[TLiteral<"quote_not_found">, TLiteral<"quote_expired">, TLiteral<"quote_already_executed">, TLiteral<"quote_cancelled">, TLiteral<"quote_user_mismatch">, TLiteral<"quote_app_blocked">, TLiteral<"quote_unfillable">, TLiteral<"quote_min_order_size">, TLiteral<"quote_stale_status">, TLiteral<"quote_stale_price">, TLiteral<"quote_insufficient_balance">, TLiteral<"quote_market_inactive">, TLiteral<"venue_not_executable">, TLiteral<"outcome_ambiguous">]>>;
+    code: TOptional<TUnion<[TLiteral<"quote_not_found">, TLiteral<"quote_expired">, TLiteral<"quote_already_executed">, TLiteral<"quote_cancelled">, TLiteral<"quote_user_mismatch">, TLiteral<"quote_app_blocked">, TLiteral<"quote_unfillable">, TLiteral<"quote_min_order_size">, TLiteral<"quote_stale_status">, TLiteral<"quote_stale_price">, TLiteral<"quote_insufficient_balance">, TLiteral<"quote_market_inactive">, TLiteral<"quote_self_custody_unsupported_venue">, TLiteral<"quote_self_custody_app_fee">, TLiteral<"quote_self_custody_redeem_unsupported">, TLiteral<"venue_not_executable">, TLiteral<"outcome_ambiguous">]>>;
 }>;
 type QuoteError = Static<typeof QuoteErrorTB>;
 
@@ -2164,6 +2164,82 @@ interface PersistedAuthSnapshot {
 }
 /** Auth lifecycle status for UI state machines. */
 type AuthStatus = "unknown" | "authenticated" | "unauthenticated";
+type SignatureRequestType = "eip712" | "personal_sign"
+/** EVM transaction — bridge legs and approvals. secp256k1. */
+ | "transaction"
+/** Solana transaction — bridge legs on SVM. ed25519, NOT secp256k1. */
+ | "solana_transaction" | "hl_l1_action"
+/**
+ * EIP-7702 authorization over `{ contractAddress, chainId, nonce }`.
+ *
+ * A signature over a RAW digest — `keccak(0x05 ‖ rlp([chainId, delegate,
+ * nonce]))` — not EIP-191 and not EIP-712. Many wallets do not expose this,
+ * and that is expected: reject it and the server falls back to asking the
+ * user to broadcast a plain approve instead.
+ */
+ | "eip7702_authorization";
+/** One payload the client must sign before a fill can proceed. */
+interface SignatureRequest {
+    /** Echo this back with the signature. */
+    stepId: string;
+    /** Payload shape. Discriminates how to sign — not which venue. */
+    type: SignatureRequestType;
+    venue: string;
+    /** The address that must produce this signature. Sign with this key, not another. */
+    signerAddress: string;
+    /** Absent for non-EVM payloads (e.g. Hyperliquid L1 actions). */
+    chainId?: number;
+    /** Sign verbatim. */
+    payload: unknown;
+    expiresAt: string;
+}
+/**
+ * Supplied by the partner. Receives a payload, returns a signature. The SDK
+ * never sees the key.
+ *
+ * Return a 0x-prefixed hex string for anything the wallet SIGNS:
+ *
+ * - `eip712` — `signTypedData` over `payload`.
+ * - `personal_sign` — `personal_sign` over `payload`.
+ * - `hl_l1_action` — Hyperliquid L1 action, EIP-712 in phantom-agent form.
+ * - `eip7702_authorization` — an EIP-7702 authorization over
+ *   `{ contractAddress, chainId, nonce }`. This is a signature over a RAW
+ *   digest, not EIP-191 and not EIP-712, and many wallets do not expose it.
+ *   **Throwing here does not help**: there is no reject verb, so a thrown
+ *   signer is indistinguishable from a slow user — the request simply expires
+ *   and the fill dies. If your wallet cannot produce this signature, declare
+ *   `approveMode: "user_broadcast"` on the fill instead and the approve is
+ *   requested as a `transaction` the user sends themselves. Handling this
+ *   request is what makes funding gasless.
+ *
+ * Return `{ txHash }` for anything the wallet BROADCASTS:
+ *
+ * - `transaction` — send it, then return the hash **immediately, without
+ *   awaiting the receipt**. The server watches for the mined receipt itself
+ *   and will not resume until it matches the request byte-for-byte.
+ */
+type SignerFn = (req: SignatureRequest) => Promise<string | {
+    txHash: string;
+}>;
+/**
+ * How long `fillSelfCustody` will keep waiting before giving up.
+ *
+ * Covers a first-time user: sign the wallet-setup batch, wait for it on-chain,
+ * then sign the order. Generous because the wait is a relayer transaction
+ * confirming, not a human deciding.
+ */
+declare const SELF_CUSTODY_FILL_TIMEOUT_MS: number;
+/** Gap between re-reads while an on-chain step is in flight. */
+declare const SELF_CUSTODY_POLL_INTERVAL_MS = 2000;
+/**
+ * States a run never leaves. Everything else means "still working".
+ *
+ * Typed against `ExecutionOverallState` so a typo'd or renamed literal (e.g.
+ * `cancelled` drifting to `canceled`) is a compile error instead of a state
+ * that silently stops being treated as terminal. Mirrors
+ * `ExecutionOverallStateTB` in the contract; keep the two in step.
+ */
+declare const TERMINAL_EXECUTION_STATES: ReadonlySet<ExecutionOverallState>;
 type SportsGameStatus = "scheduled" | "live" | "paused" | "finished" | "cancelled" | "postponed" | "unknown";
 interface SportsLiveParticipant {
     position: "first" | "second";
@@ -2213,6 +2289,17 @@ interface AggClientOptions {
      *  When authDelivery is "cookie-refresh", refresh tokens survive via HttpOnly cookies
      *  and the SDK attempts a silent refresh on cold start. Defaults to true. */
     persistSession?: boolean;
+    /**
+     * Supplies signatures for self-custodial fills. Required whenever
+     * `fillSelfCustody()` is called with `signingAddress` — the SDK never
+     * holds a key itself, so without this option a fill that needs a
+     * client-side signature cannot proceed. The signature requests never
+     * come back on `POST /execution/fill` itself: `fillSelfCustody()` polls
+     * `GET /execution/status` for them (`pendingSignatures`), signs each one
+     * with this function, and posts the result to
+     * `POST /execution/fill/:quoteId/signatures`.
+     */
+    signer?: SignerFn;
 }
 interface SiweMessageParams {
     domain: string;
@@ -2791,6 +2878,25 @@ interface ExecuteManagedParams {
         sellShares?: number;
         allowedVenues?: Venue[];
     };
+    /**
+     * Self-custody: the wallet that will sign this fill. Must be a wallet
+     * already linked to this account. Omit for managed custody (the default).
+     */
+    signingAddress?: string;
+    /**
+     * Self-custody only: which approve shape a cross-chain fill uses when the
+     * bridge needs an ERC20 approve. Omit (the default) for "sponsored" — we pay
+     * the gas, but the wallet must sign a one-time EIP-7702 authorization over a
+     * RAW DIGEST, which many wallets cannot produce. Send "user_broadcast" when
+     * yours cannot: the user sends the approve and pays their own gas. Only your
+     * client can know which applies — it is a property of the wallet software,
+     * not of the address or the chain.
+     *
+     * Worth surfacing in your UI: "user_broadcast" never establishes the
+     * delegation, so it charges gas on EVERY bridge. "sponsored" costs one
+     * signature once per chain, then is free.
+     */
+    approveMode?: "sponsored" | "user_broadcast";
 }
 interface ExecuteManagedResponse {
     quoteId: string;
@@ -2798,6 +2904,17 @@ interface ExecuteManagedResponse {
     status: "pending";
     redeemId?: string;
     message?: string;
+    /**
+     * What this fill is waiting to be signed, if anything. On the immediate
+     * `POST /execution/fill` response this is always absent or empty — even
+     * for a self-custody fill, the DAG parks asynchronously, after this
+     * response has already been sent. Real entries only ever come back from
+     * polling `GET /execution/status` or from the next
+     * `POST /execution/fill/:quoteId/signatures` response (this same shape,
+     * reused). Drive the whole round trip through `fillSelfCustody()` rather
+     * than reading this field on the fill response by hand.
+     */
+    pendingSignatures?: SignatureRequest[];
 }
 type LimitOrderTimeInForce = "GTC" | "GTD" | "FOK" | "FAK" | "IOC" | "ALO";
 interface PlaceLimitOrderParams {
@@ -3162,6 +3279,14 @@ interface ExecutionStatusResponse {
     dagProgress: ExecutionDagProgress | null;
     steps: ExecutionStatusStep[];
     orders: ExecutionStatusOrder[];
+    /**
+     * What this run is waiting to be signed, mirroring the fill response's
+     * field of the same name. This is the polling route `fillSelfCustody` reads
+     * while an on-chain step is in flight — a caller polling this route for
+     * progress learns about newly-parked steps here too, not just from the
+     * signatures endpoint.
+     */
+    pendingSignatures?: SignatureRequest[];
 }
 type ExecutionPositionsQuery = GetPositionsQuery & {
     mode?: ExecutionMode;
@@ -4038,6 +4163,8 @@ declare class AggClient {
     private authOptions?;
     /** In-flight refresh promise — serializes concurrent 401 retries so only one refresh runs. */
     private pendingRefresh;
+    /** Partner-supplied signature callback for self-custodial fills. The SDK never sees a key. */
+    private readonly signer?;
     constructor(options: AggClientOptions);
     private resolvePaperTradingAppId;
     private paperTradingAccountsPath;
@@ -4171,7 +4298,13 @@ declare class AggClient {
      * rollup (total cost, share-weighted avg price, to-win).
      */
     getExecutionOrders(params?: ExecutionOrdersQuery): Promise<PaginatedResponse<ExecutionOrderItem>>;
-    /** Get quote-scoped execution progress, DAG step state, and order leg terminal status. */
+    /**
+     * Get quote-scoped execution progress, DAG step state, and order leg
+     * terminal status. Also carries `pendingSignatures` — this is the route
+     * `fillSelfCustody` polls while an on-chain step is in flight, so a caller
+     * already polling this for progress learns about newly-parked steps here
+     * too, not just from the signatures endpoint.
+     */
     getExecutionStatus(params: ExecutionStatusQuery): Promise<ExecutionStatusResponse>;
     /** Unified user activity feed (trades, deposits, withdrawals, bridges, wallet ops). */
     getUserActivity(params?: UserActivityQuery): Promise<PaginatedResponse<UserActivityItem>>;
@@ -4238,6 +4371,13 @@ declare class AggClient {
     /** Get a single venue event by ID. Requires appId or admin auth. */
     getVenueEventById(id: string, options?: {
         signal?: AbortSignal;
+        /**
+         * Scope `marketCount` and the rolled-up `volume` to the whole matched
+         * cluster (default, `true`) or to this one venue event (`false`). Pair it
+         * with the same value on {@link getVenueMarkets} so the count matches the
+         * market list you render.
+         */
+        cluster?: boolean;
     }): Promise<VenueEvent>;
     /** Get normalized live score state for sports events. Requires appId or admin auth. */
     getSportsLive(eventIds: string[], options?: {
@@ -4253,6 +4393,13 @@ declare class AggClient {
     getVenueMarkets(options?: {
         venue?: Venue;
         venueEventId?: string;
+        /**
+         * Scope `venueEventId` to the whole matched cluster (default, `true`) or to
+         * that one venue event (`false`). Under the default, naming any member of a
+         * cluster returns every venue's markets for that real-world event with
+         * matched siblings folded into their anchor. Ignored without `venueEventId`.
+         */
+        cluster?: boolean;
         search?: string;
         matchStatus?: MatchStatus;
         status?: MarketStatus;
@@ -4405,6 +4552,27 @@ declare class AggClient {
     }): AggWebSocket;
     /** Execute a previously quoted managed trade. Returns pending order IDs. */
     executeManaged(params: ExecuteManagedParams): Promise<ExecuteManagedResponse>;
+    /** Submit signatures for a parked fill. Returns whatever is still outstanding. */
+    submitFillSignatures(quoteId: string, signatures: Array<{
+        stepId: string;
+        signature?: string;
+        txHash?: string;
+    }>): Promise<ExecuteManagedResponse & {
+        accepted?: number;
+    }>;
+    /**
+     * Execute a quote in self-custodial mode.
+     *
+     * Identical to `executeManaged` when the server can sign for the user. When
+     * it cannot, the DAG parks on a signature request instead — but that park
+     * always happens asynchronously, in the trade-executor process, so it can
+     * never show up on this `POST /execution/fill` response itself. This
+     * drives the round trip from there: poll `getExecutionStatus` while an
+     * on-chain step is in flight, sign whatever it hands back with the
+     * configured `signer`, post the signatures back, and repeat until the
+     * server reports nothing outstanding and the run reaches a terminal state.
+     */
+    fillSelfCustody(params: ExecuteManagedParams): Promise<ExecuteManagedResponse>;
     /** Place a managed limit order. Returns the venue-backed order state. */
     placeLimitOrder(params: PlaceLimitOrderParams): Promise<PlaceLimitOrderResponse>;
     /**
@@ -4581,4 +4749,4 @@ declare function aggregateMidpoint(midpoints: (number | null | undefined)[]): nu
 
 declare function createAggClient(options: AggClientOptions): AggClient;
 
-export { ACTIVE_VENUES, type Account, AccountProvider, AccountType, AggApiError, type AggApiErrorInit, type AggApiFieldError, type AggAuthDeliveryMode, type AggAuthProviderType, type AggAuthStartBody, type AggAuthStartResult, type AggAuthVerifyBody, AggClient, type AggClientAuthOptions, type AggClientSessionInput, type AggLinkAccountBody, type AggLinkAccountConfirmResult, type AggLinkAccountResult, type AggLinkAccountWalletConfirmBody, type AggSessionUser, AggWebSocket, type AggWebSocketCallbacks, type AggWebSocketOptions, type AggregatedOrderbookLevel, type AggregatedOrderbookResponse, type App, type AppClientConfigResponse, type AttributedOrderbook, type AttributedOrderbookLevel, type AuthCodeResponse, type AuthStatus, type AuthTokenResponse, type AuthUser, type BalanceRefillAttempt, type BalanceRefillAttemptStatus, type BalanceRefillPolicy, type BalanceRefillPolicyStatus, type BatchMidpointsResponse, type BatchOrderbooksResponse, type BookQuality, type BuildVenueUrlOpts, CONFIRMED_MATCH_STATUSES, type CancelManagedExecutionResponse, type Candle, CandleBuilder, type CandleInterval, type Category, Chain, type ChartBarsResponse, type ChartCandle, type ChartResolution, type ChartVenueCandles, type ComputeSplitsRequest, type ComputeSplitsResponse, type ComputeSplitsSelection, type CorrelatedMarketCascadeItem, type CorrelatedMarketCascadeResponse, type CorrelatedMarketQueryResult, type CorrelatedMarketSide, type CorrelatedMarketSignal, type CorrelatedMarketSignalBatch, type CorrelatedMarketSignalDirection, type CorrelatedMarketsStatus, type CreateApp, type CreateBalanceRefillPolicyParams, type CreatePaperTradingAccountParams, type CryptoReferencePriceError, type CryptoReferencePriceExternalMarketInput, type CryptoReferencePriceMarketInput, type CryptoReferencePriceResult, type CryptoReferencePriceSource, type CryptoReferencePriceTarget, type CryptoReferencePricesResponse, DEFAULT_BALANCE_REFILL_DAILY_CAP_RAW, DEFAULT_BALANCE_REFILL_MAX_FEE_RAW, type DepositAddressesPendingResponse, type DepositAddressesReadyResponse, type DepositAddressesResponse, type DepositAddressesSupportedChain, type DepositAddressesToken, type DepositStep, type DiagnosticCallback, type DiagnosticEvent, type ExecuteManagedParams, type ExecuteManagedRequest, type ExecuteManagedResponse, type ExecuteTradeRequest, type ExecuteTradeResponse, type ExecutionDagProgress, type ExecutionDisplayGroupStatus, type ExecutionDisplayStepKind, type ExecutionMode, type ExecutionOrderItem, type ExecutionOrdersQuery, type ExecutionOverallState, type ExecutionPositionGroup, type ExecutionPositionsQuery, type ExecutionStatusOrder, type ExecutionStatusQuery, type ExecutionStatusResponse, type ExecutionStatusStep, type GetBalanceQuery, type GetBalanceResponse, type GetCryptoReferencePricesOptions, type GetHoldingsQuery, type GetHoldingsResponse, type GetOrdersParams, type GetOrdersQuery, type GetPositionsParams, type GetPositionsQuery, type HelloResponse, IMAGE_SIZES, INACTIVE_VENUES, ImageSize, LIMIT_PRICE_RAW_SCALE, type LimitOrderTimeInForce, type LimitPriceSide, type LimitPriceTickAdjustment, type ListRecurringCryptoMarketsOptions, type ManagedBalancesParams, type MarkSource, type MarketPriceHistory, MarketStatus, MatchStatus, MatchType, type MatchedMidpoint, type MatchedMidpointOutcome, type MatchedOrderbookMarket, type MatchedVenueMarketOutcomeRef, type MidpointItem, type MidpointRow, type NewsFeedArticleFeedItem, type NewsFeedArticleFeedResponse, type NewsFeedArticleWithSummary, type NewsFeedLinkedMarket, type NewsFeedListResponse, type NewsFeedMarketFeedArticle, type NewsFeedMarketFeedItem, type NewsFeedMarketFeedResponse, type NewsFeedMarketNewsParams, type NewsFeedMarketNewsResponse, type NewsFeedMarketNewsResult, type NewsFeedPageOptions, type NewsFeedStatusResponse, type NonceResponse, type OrderListItem, type OrderListQuery, OrderStatus, OrderType, type Orderbook, type OrderbookBatchItemError, type OrderbookBatchItemErrorCode, type OrderbookBatchItemStatus, type OrderbookHistoryPoint, type OrderbookHistoryResponse, type OrderbookLevel, type OrderbookQuoteFill, type OrderbookQuoteParams, type OrderbookQuoteResponse, type OrderbookServiceUnavailableError, type OrderbookState, type OrderbooksOnlyError, type OutcomeMidpoint, type OutcomeMidpointRow, type OutcomeOrderbookResponse, type PaginatedResponse, type PaperTradingAccount, type PaperTradingAccountsPage, type PaperTradingAppOptions, type PaperTradingBalanceAdjustment, type PaperTradingBalanceResponse, type PaperTradingLiquidityStatus, type PaperTradingListParams, type PaperTradingMarkSource, type PaperTradingOrder, type PaperTradingOrdersPage, type PaperTradingPortfolio, type PaperTradingPosition, type PaperTradingPositionsPage, type PersistedAuthSnapshot, type PlaceLimitOrderParams, type PlaceLimitOrderResponse, type PlacePaperTradingOrderParams, type PositionGroup, type PositionRedeemStatus, type PricePoint, type PriceSource, type PricesHistoryResponse, type QuoteError, type QuoteErrorCode, RECURRENCE_CADENCES, type RampQuote, type RampQuoteRequest, type RampSessionRequest, type RampWidgetSession, type RecurrenceCadence, type RecurrenceFilter, type RecurringCryptoComparisonPoint, type RecurringCryptoComparisonPriceSource, type RecurringCryptoDuration, type RecurringCryptoDurationInput, type RecurringCryptoMarketMetrics, type RecurringCryptoMarketsResponse, type RecurringCryptoOrderbookDepthLevel, type RecurringCryptoOrderbookDepthSide, type RecurringCryptoOutcome, type RecurringCryptoOutcomeOrderbookDepth, type RecurringCryptoPriceComparison, type RecurringCryptoReferencePrice, type RecurringCryptoResolution, type RecurringCryptoSourceConfidence, type RecurringCryptoVenueMarket, type RecurringCryptoWindowComparisons, type RecurringCryptoWindowMarket, type RedeemLegResult, type RedeemLegStatus, type RedeemRequest, type RedeemResponse, type RequestedOrderbookMarket, type ResetPaperTradingAccountParams, type ResolveCorrelatedMarketsParams, type ResolveCorrelatedMarketsResponse, type ResolvedCorrelatedMarketsResponse, type RpcTokenResponse, type SafeParseFailure, type SafeParseResult, type SafeParseSuccess, type ServerWallet, type SetPaperTradingBalanceParams, type SettlementDiff, type SettlementDifference, type SettlementSource, type SetupDepositAddressStep, type SetupVenueKeyStep, type SimpleOrderbookLevel, type SmartRouteAllocation, type SmartRouteBridgeStep, type SmartRouteFeeBreakdown, type SmartRouteFill, type SmartRouteParams, type SmartRouteResponse, type SmartRouteSettlementLeg, type SmartRouteSettlementPlan, type SmartRouteSetupCostLine, type SmartRouteSide, type SmartRouteStatus, type SmartRouteVenueFill, type SplitsByAmountResult, type SportsGameStatus, type SportsLiveParticipant, type SportsLiveResponse, type SportsLiveState, type SyncBalancesResponse, TimeInForce, type TradeExecutorOrder, type TradeExecutorOrderListResponse, TradeSide$1 as TradeSide, type TradeSplit, type TradeStep, TurnstileChallengeError, type UnifiedBalanceResponse, type UpdateBalanceRefillPolicyParams, type UpdateUserBody, type UpsertVenueKey, type UserActivityBridge, type UserActivityDeposit, type UserActivityItem, type UserActivityQuery, type UserActivityRedeem, type UserActivityRedeemLeg, type UserActivityTrade, type UserActivityType, type UserActivityUserOp, type UserActivityWithdrawal, type UserHolding, type UserProfile, VENUES, VENUE_CHAIN_IDS, type ValidateBalanceOnClientStep, type ValidateManagedParams, type ValidateManagedRequest, type ValidateManagedResponse, type ValidateTradeRequest, type ValidateTradeResponse, Venue, type VenueEvent, type VenueEventListItem, type VenueEventWithMarkets, type VenueGeoPolicyEntry, type VenueGeoPolicyResponse, type VenueKeyStatus, type VenueKeySummary, type VenueMarket, type VenueMarketClusterNode, type VenueMarketListItem, type VenueMarketOutcome, type VenueMarketRef, type VenueOrderbookEntry, type VenueOrderbookLevel, type VenuePositionBalance, type VenuePriceInfo, type VenueSoloQuote, type VerifyBody, type VerifyResponse, type WalletChainBalance, type WalletTokenBalance, type WithdrawManagedParams, type WithdrawManagedRequest, type WithdrawManagedResponse, type WithdrawManagedSourceItem, type WithdrawPreviewParams, type WithdrawPreviewResponse, type WithdrawTokenSymbol, type WithdrawalExpected, type WithdrawalLeg, type WithdrawalLegStatus, type WithdrawalLegType, type WithdrawalLifecycleStatus, type WithdrawalQuoteParams, type WithdrawalQuoteResponse, type WithdrawalSource, type WithdrawalSourceItem, type WithdrawalSourceStatus, type WithdrawalSourceTokenSymbol, type WsArbFeedBatch, type WsArbFeedEntry, type WsArbMarketUpdate, type WsAttributedLevel, type WsAuthenticated, type WsBalanceUpdate, type WsCandleInterval, type WsClientMessage, type WsConnected, type WsError, type WsHeartbeat, type WsMarkSource, type WsMarketResolved, type WsOrderEvent, type WsOrderEventType, type WsOrderSubmitted, type WsOrderbookDelta, type WsOrderbookSnapshot, type WsRedeemEvent, type WsServerMessage, type WsSubscribed, type WsTrade, type WsUnsubscribed, type WsVenueBook, type WsVenueInfo, type WsVenueLevel, type WsWithdrawalLegStatus, type WsWithdrawalLifecycleEvent, type WsWithdrawalLifecycleLeg, type WsWithdrawalLifecycleStatus, adjustLimitPriceRawToTick, aggregateMidpoint, applyOrderbookDelta, buildVenueUrl, computeBestSplitsByAmount, computeChecksum, createAggClient, enumGuard, formatMarketQuestion, formatOutcomeLabel, formatOutcomeTitle, getBalanceRefillMaximumRaw, getEffectiveDisabledVenues, getWalletAddressFromUserProfile, hasShape, isAggApiError, isBalanceRefillWithinDailyCap, isEmail, isEnum, isFiniteNonNeg, isNonEmptyString, isVenueActive, isVenueDataVisible, isVenueInactive, mergeCandles, mergeClosedCandles, normalizeVenueMarketCluster, optimizedImageUrl, parse, parseEmail, parseEmailStrict, safeParse, snapshotToOrderbook, sortVenues };
+export { ACTIVE_VENUES, type Account, AccountProvider, AccountType, AggApiError, type AggApiErrorInit, type AggApiFieldError, type AggAuthDeliveryMode, type AggAuthProviderType, type AggAuthStartBody, type AggAuthStartResult, type AggAuthVerifyBody, AggClient, type AggClientAuthOptions, type AggClientOptions, type AggClientSessionInput, type AggLinkAccountBody, type AggLinkAccountConfirmResult, type AggLinkAccountResult, type AggLinkAccountWalletConfirmBody, type AggSessionUser, AggWebSocket, type AggWebSocketCallbacks, type AggWebSocketOptions, type AggregatedOrderbookLevel, type AggregatedOrderbookResponse, type App, type AppClientConfigResponse, type AttributedOrderbook, type AttributedOrderbookLevel, type AuthCodeResponse, type AuthStatus, type AuthTokenResponse, type AuthUser, type BalanceRefillAttempt, type BalanceRefillAttemptStatus, type BalanceRefillPolicy, type BalanceRefillPolicyStatus, type BatchMidpointsResponse, type BatchOrderbooksResponse, type BookQuality, type BuildVenueUrlOpts, CONFIRMED_MATCH_STATUSES, type CancelManagedExecutionResponse, type Candle, CandleBuilder, type CandleInterval, type Category, Chain, type ChartBarsResponse, type ChartCandle, type ChartResolution, type ChartVenueCandles, type ComputeSplitsRequest, type ComputeSplitsResponse, type ComputeSplitsSelection, type CorrelatedMarketCascadeItem, type CorrelatedMarketCascadeResponse, type CorrelatedMarketQueryResult, type CorrelatedMarketSide, type CorrelatedMarketSignal, type CorrelatedMarketSignalBatch, type CorrelatedMarketSignalDirection, type CorrelatedMarketsStatus, type CreateApp, type CreateBalanceRefillPolicyParams, type CreatePaperTradingAccountParams, type CryptoReferencePriceError, type CryptoReferencePriceExternalMarketInput, type CryptoReferencePriceMarketInput, type CryptoReferencePriceResult, type CryptoReferencePriceSource, type CryptoReferencePriceTarget, type CryptoReferencePricesResponse, DEFAULT_BALANCE_REFILL_DAILY_CAP_RAW, DEFAULT_BALANCE_REFILL_MAX_FEE_RAW, type DepositAddressesPendingResponse, type DepositAddressesReadyResponse, type DepositAddressesResponse, type DepositAddressesSupportedChain, type DepositAddressesToken, type DepositStep, type DiagnosticCallback, type DiagnosticEvent, type ExecuteManagedParams, type ExecuteManagedRequest, type ExecuteManagedResponse, type ExecuteTradeRequest, type ExecuteTradeResponse, type ExecutionDagProgress, type ExecutionDisplayGroupStatus, type ExecutionDisplayStepKind, type ExecutionMode, type ExecutionOrderItem, type ExecutionOrdersQuery, type ExecutionOverallState, type ExecutionPositionGroup, type ExecutionPositionsQuery, type ExecutionStatusOrder, type ExecutionStatusQuery, type ExecutionStatusResponse, type ExecutionStatusStep, type GetBalanceQuery, type GetBalanceResponse, type GetCryptoReferencePricesOptions, type GetHoldingsQuery, type GetHoldingsResponse, type GetOrdersParams, type GetOrdersQuery, type GetPositionsParams, type GetPositionsQuery, type HelloResponse, IMAGE_SIZES, INACTIVE_VENUES, ImageSize, LIMIT_PRICE_RAW_SCALE, type LimitOrderTimeInForce, type LimitPriceSide, type LimitPriceTickAdjustment, type ListRecurringCryptoMarketsOptions, type ManagedBalancesParams, type MarkSource, type MarketPriceHistory, MarketStatus, MatchStatus, MatchType, type MatchedMidpoint, type MatchedMidpointOutcome, type MatchedOrderbookMarket, type MatchedVenueMarketOutcomeRef, type MidpointItem, type MidpointRow, type NewsFeedArticleFeedItem, type NewsFeedArticleFeedResponse, type NewsFeedArticleWithSummary, type NewsFeedLinkedMarket, type NewsFeedListResponse, type NewsFeedMarketFeedArticle, type NewsFeedMarketFeedItem, type NewsFeedMarketFeedResponse, type NewsFeedMarketNewsParams, type NewsFeedMarketNewsResponse, type NewsFeedMarketNewsResult, type NewsFeedPageOptions, type NewsFeedStatusResponse, type NonceResponse, type OrderListItem, type OrderListQuery, OrderStatus, OrderType, type Orderbook, type OrderbookBatchItemError, type OrderbookBatchItemErrorCode, type OrderbookBatchItemStatus, type OrderbookHistoryPoint, type OrderbookHistoryResponse, type OrderbookLevel, type OrderbookQuoteFill, type OrderbookQuoteParams, type OrderbookQuoteResponse, type OrderbookServiceUnavailableError, type OrderbookState, type OrderbooksOnlyError, type OutcomeMidpoint, type OutcomeMidpointRow, type OutcomeOrderbookResponse, type PaginatedResponse, type PaperTradingAccount, type PaperTradingAccountsPage, type PaperTradingAppOptions, type PaperTradingBalanceAdjustment, type PaperTradingBalanceResponse, type PaperTradingLiquidityStatus, type PaperTradingListParams, type PaperTradingMarkSource, type PaperTradingOrder, type PaperTradingOrdersPage, type PaperTradingPortfolio, type PaperTradingPosition, type PaperTradingPositionsPage, type PersistedAuthSnapshot, type PlaceLimitOrderParams, type PlaceLimitOrderResponse, type PlacePaperTradingOrderParams, type PositionGroup, type PositionRedeemStatus, type PricePoint, type PriceSource, type PricesHistoryResponse, type QuoteError, type QuoteErrorCode, RECURRENCE_CADENCES, type RampQuote, type RampQuoteRequest, type RampSessionRequest, type RampWidgetSession, type RecurrenceCadence, type RecurrenceFilter, type RecurringCryptoComparisonPoint, type RecurringCryptoComparisonPriceSource, type RecurringCryptoDuration, type RecurringCryptoDurationInput, type RecurringCryptoMarketMetrics, type RecurringCryptoMarketsResponse, type RecurringCryptoOrderbookDepthLevel, type RecurringCryptoOrderbookDepthSide, type RecurringCryptoOutcome, type RecurringCryptoOutcomeOrderbookDepth, type RecurringCryptoPriceComparison, type RecurringCryptoReferencePrice, type RecurringCryptoResolution, type RecurringCryptoSourceConfidence, type RecurringCryptoVenueMarket, type RecurringCryptoWindowComparisons, type RecurringCryptoWindowMarket, type RedeemLegResult, type RedeemLegStatus, type RedeemRequest, type RedeemResponse, type RequestedOrderbookMarket, type ResetPaperTradingAccountParams, type ResolveCorrelatedMarketsParams, type ResolveCorrelatedMarketsResponse, type ResolvedCorrelatedMarketsResponse, type RpcTokenResponse, SELF_CUSTODY_FILL_TIMEOUT_MS, SELF_CUSTODY_POLL_INTERVAL_MS, type SafeParseFailure, type SafeParseResult, type SafeParseSuccess, type ServerWallet, type SetPaperTradingBalanceParams, type SettlementDiff, type SettlementDifference, type SettlementSource, type SetupDepositAddressStep, type SetupVenueKeyStep, type SignatureRequest, type SignatureRequestType, type SignerFn, type SimpleOrderbookLevel, type SmartRouteAllocation, type SmartRouteBridgeStep, type SmartRouteFeeBreakdown, type SmartRouteFill, type SmartRouteParams, type SmartRouteResponse, type SmartRouteSettlementLeg, type SmartRouteSettlementPlan, type SmartRouteSetupCostLine, type SmartRouteSide, type SmartRouteStatus, type SmartRouteVenueFill, type SplitsByAmountResult, type SportsGameStatus, type SportsLiveParticipant, type SportsLiveResponse, type SportsLiveState, type SyncBalancesResponse, TERMINAL_EXECUTION_STATES, TimeInForce, type TradeExecutorOrder, type TradeExecutorOrderListResponse, TradeSide$1 as TradeSide, type TradeSplit, type TradeStep, TurnstileChallengeError, type UnifiedBalanceResponse, type UpdateBalanceRefillPolicyParams, type UpdateUserBody, type UpsertVenueKey, type UserActivityBridge, type UserActivityDeposit, type UserActivityItem, type UserActivityQuery, type UserActivityRedeem, type UserActivityRedeemLeg, type UserActivityTrade, type UserActivityType, type UserActivityUserOp, type UserActivityWithdrawal, type UserHolding, type UserProfile, VENUES, VENUE_CHAIN_IDS, type ValidateBalanceOnClientStep, type ValidateManagedParams, type ValidateManagedRequest, type ValidateManagedResponse, type ValidateTradeRequest, type ValidateTradeResponse, Venue, type VenueEvent, type VenueEventListItem, type VenueEventWithMarkets, type VenueGeoPolicyEntry, type VenueGeoPolicyResponse, type VenueKeyStatus, type VenueKeySummary, type VenueMarket, type VenueMarketClusterNode, type VenueMarketListItem, type VenueMarketOutcome, type VenueMarketRef, type VenueOrderbookEntry, type VenueOrderbookLevel, type VenuePositionBalance, type VenuePriceInfo, type VenueSoloQuote, type VerifyBody, type VerifyResponse, type WalletChainBalance, type WalletTokenBalance, type WithdrawManagedParams, type WithdrawManagedRequest, type WithdrawManagedResponse, type WithdrawManagedSourceItem, type WithdrawPreviewParams, type WithdrawPreviewResponse, type WithdrawTokenSymbol, type WithdrawalExpected, type WithdrawalLeg, type WithdrawalLegStatus, type WithdrawalLegType, type WithdrawalLifecycleStatus, type WithdrawalQuoteParams, type WithdrawalQuoteResponse, type WithdrawalSource, type WithdrawalSourceItem, type WithdrawalSourceStatus, type WithdrawalSourceTokenSymbol, type WsArbFeedBatch, type WsArbFeedEntry, type WsArbMarketUpdate, type WsAttributedLevel, type WsAuthenticated, type WsBalanceUpdate, type WsCandleInterval, type WsClientMessage, type WsConnected, type WsError, type WsHeartbeat, type WsMarkSource, type WsMarketResolved, type WsOrderEvent, type WsOrderEventType, type WsOrderSubmitted, type WsOrderbookDelta, type WsOrderbookSnapshot, type WsRedeemEvent, type WsServerMessage, type WsSubscribed, type WsTrade, type WsUnsubscribed, type WsVenueBook, type WsVenueInfo, type WsVenueLevel, type WsWithdrawalLegStatus, type WsWithdrawalLifecycleEvent, type WsWithdrawalLifecycleLeg, type WsWithdrawalLifecycleStatus, adjustLimitPriceRawToTick, aggregateMidpoint, applyOrderbookDelta, buildVenueUrl, computeBestSplitsByAmount, computeChecksum, createAggClient, enumGuard, formatMarketQuestion, formatOutcomeLabel, formatOutcomeTitle, getBalanceRefillMaximumRaw, getEffectiveDisabledVenues, getWalletAddressFromUserProfile, hasShape, isAggApiError, isBalanceRefillWithinDailyCap, isEmail, isEnum, isFiniteNonNeg, isNonEmptyString, isVenueActive, isVenueDataVisible, isVenueInactive, mergeCandles, mergeClosedCandles, normalizeVenueMarketCluster, optimizedImageUrl, parse, parseEmail, parseEmailStrict, safeParse, snapshotToOrderbook, sortVenues };

package/dist/index.d.ts

@@ -1226,11 +1226,11 @@ interface TSchema extends TKind, SchemaOptions {
  * Always carry a human-readable `message` alongside; the code is additive and
  * may be absent on rejections that pre-date this addition.
  */
-declare const QuoteErrorCodeTB: TUnion<[TLiteral<"quote_not_found">, TLiteral<"quote_expired">, TLiteral<"quote_already_executed">, TLiteral<"quote_cancelled">, TLiteral<"quote_user_mismatch">, TLiteral<"quote_app_blocked">, TLiteral<"quote_unfillable">, TLiteral<"quote_min_order_size">, TLiteral<"quote_stale_status">, TLiteral<"quote_stale_price">, TLiteral<"quote_insufficient_balance">, TLiteral<"quote_market_inactive">, TLiteral<"venue_not_executable">, TLiteral<"outcome_ambiguous">]>;
+declare const QuoteErrorCodeTB: TUnion<[TLiteral<"quote_not_found">, TLiteral<"quote_expired">, TLiteral<"quote_already_executed">, TLiteral<"quote_cancelled">, TLiteral<"quote_user_mismatch">, TLiteral<"quote_app_blocked">, TLiteral<"quote_unfillable">, TLiteral<"quote_min_order_size">, TLiteral<"quote_stale_status">, TLiteral<"quote_stale_price">, TLiteral<"quote_insufficient_balance">, TLiteral<"quote_market_inactive">, TLiteral<"quote_self_custody_unsupported_venue">, TLiteral<"quote_self_custody_app_fee">, TLiteral<"quote_self_custody_redeem_unsupported">, TLiteral<"venue_not_executable">, TLiteral<"outcome_ambiguous">]>;
 type QuoteErrorCode = Static<typeof QuoteErrorCodeTB>;
 declare const QuoteErrorTB: TObject<{
     message: TString;
-    code: TOptional<TUnion<[TLiteral<"quote_not_found">, TLiteral<"quote_expired">, TLiteral<"quote_already_executed">, TLiteral<"quote_cancelled">, TLiteral<"quote_user_mismatch">, TLiteral<"quote_app_blocked">, TLiteral<"quote_unfillable">, TLiteral<"quote_min_order_size">, TLiteral<"quote_stale_status">, TLiteral<"quote_stale_price">, TLiteral<"quote_insufficient_balance">, TLiteral<"quote_market_inactive">, TLiteral<"venue_not_executable">, TLiteral<"outcome_ambiguous">]>>;
+    code: TOptional<TUnion<[TLiteral<"quote_not_found">, TLiteral<"quote_expired">, TLiteral<"quote_already_executed">, TLiteral<"quote_cancelled">, TLiteral<"quote_user_mismatch">, TLiteral<"quote_app_blocked">, TLiteral<"quote_unfillable">, TLiteral<"quote_min_order_size">, TLiteral<"quote_stale_status">, TLiteral<"quote_stale_price">, TLiteral<"quote_insufficient_balance">, TLiteral<"quote_market_inactive">, TLiteral<"quote_self_custody_unsupported_venue">, TLiteral<"quote_self_custody_app_fee">, TLiteral<"quote_self_custody_redeem_unsupported">, TLiteral<"venue_not_executable">, TLiteral<"outcome_ambiguous">]>>;
 }>;
 type QuoteError = Static<typeof QuoteErrorTB>;
 
@@ -2164,6 +2164,82 @@ interface PersistedAuthSnapshot {
 }
 /** Auth lifecycle status for UI state machines. */
 type AuthStatus = "unknown" | "authenticated" | "unauthenticated";
+type SignatureRequestType = "eip712" | "personal_sign"
+/** EVM transaction — bridge legs and approvals. secp256k1. */
+ | "transaction"
+/** Solana transaction — bridge legs on SVM. ed25519, NOT secp256k1. */
+ | "solana_transaction" | "hl_l1_action"
+/**
+ * EIP-7702 authorization over `{ contractAddress, chainId, nonce }`.
+ *
+ * A signature over a RAW digest — `keccak(0x05 ‖ rlp([chainId, delegate,
+ * nonce]))` — not EIP-191 and not EIP-712. Many wallets do not expose this,
+ * and that is expected: reject it and the server falls back to asking the
+ * user to broadcast a plain approve instead.
+ */
+ | "eip7702_authorization";
+/** One payload the client must sign before a fill can proceed. */
+interface SignatureRequest {
+    /** Echo this back with the signature. */
+    stepId: string;
+    /** Payload shape. Discriminates how to sign — not which venue. */
+    type: SignatureRequestType;
+    venue: string;
+    /** The address that must produce this signature. Sign with this key, not another. */
+    signerAddress: string;
+    /** Absent for non-EVM payloads (e.g. Hyperliquid L1 actions). */
+    chainId?: number;
+    /** Sign verbatim. */
+    payload: unknown;
+    expiresAt: string;
+}
+/**
+ * Supplied by the partner. Receives a payload, returns a signature. The SDK
+ * never sees the key.
+ *
+ * Return a 0x-prefixed hex string for anything the wallet SIGNS:
+ *
+ * - `eip712` — `signTypedData` over `payload`.
+ * - `personal_sign` — `personal_sign` over `payload`.
+ * - `hl_l1_action` — Hyperliquid L1 action, EIP-712 in phantom-agent form.
+ * - `eip7702_authorization` — an EIP-7702 authorization over
+ *   `{ contractAddress, chainId, nonce }`. This is a signature over a RAW
+ *   digest, not EIP-191 and not EIP-712, and many wallets do not expose it.
+ *   **Throwing here does not help**: there is no reject verb, so a thrown
+ *   signer is indistinguishable from a slow user — the request simply expires
+ *   and the fill dies. If your wallet cannot produce this signature, declare
+ *   `approveMode: "user_broadcast"` on the fill instead and the approve is
+ *   requested as a `transaction` the user sends themselves. Handling this
+ *   request is what makes funding gasless.
+ *
+ * Return `{ txHash }` for anything the wallet BROADCASTS:
+ *
+ * - `transaction` — send it, then return the hash **immediately, without
+ *   awaiting the receipt**. The server watches for the mined receipt itself
+ *   and will not resume until it matches the request byte-for-byte.
+ */
+type SignerFn = (req: SignatureRequest) => Promise<string | {
+    txHash: string;
+}>;
+/**
+ * How long `fillSelfCustody` will keep waiting before giving up.
+ *
+ * Covers a first-time user: sign the wallet-setup batch, wait for it on-chain,
+ * then sign the order. Generous because the wait is a relayer transaction
+ * confirming, not a human deciding.
+ */
+declare const SELF_CUSTODY_FILL_TIMEOUT_MS: number;
+/** Gap between re-reads while an on-chain step is in flight. */
+declare const SELF_CUSTODY_POLL_INTERVAL_MS = 2000;
+/**
+ * States a run never leaves. Everything else means "still working".
+ *
+ * Typed against `ExecutionOverallState` so a typo'd or renamed literal (e.g.
+ * `cancelled` drifting to `canceled`) is a compile error instead of a state
+ * that silently stops being treated as terminal. Mirrors
+ * `ExecutionOverallStateTB` in the contract; keep the two in step.
+ */
+declare const TERMINAL_EXECUTION_STATES: ReadonlySet<ExecutionOverallState>;
 type SportsGameStatus = "scheduled" | "live" | "paused" | "finished" | "cancelled" | "postponed" | "unknown";
 interface SportsLiveParticipant {
     position: "first" | "second";
@@ -2213,6 +2289,17 @@ interface AggClientOptions {
      *  When authDelivery is "cookie-refresh", refresh tokens survive via HttpOnly cookies
      *  and the SDK attempts a silent refresh on cold start. Defaults to true. */
     persistSession?: boolean;
+    /**
+     * Supplies signatures for self-custodial fills. Required whenever
+     * `fillSelfCustody()` is called with `signingAddress` — the SDK never
+     * holds a key itself, so without this option a fill that needs a
+     * client-side signature cannot proceed. The signature requests never
+     * come back on `POST /execution/fill` itself: `fillSelfCustody()` polls
+     * `GET /execution/status` for them (`pendingSignatures`), signs each one
+     * with this function, and posts the result to
+     * `POST /execution/fill/:quoteId/signatures`.
+     */
+    signer?: SignerFn;
 }
 interface SiweMessageParams {
     domain: string;
@@ -2791,6 +2878,25 @@ interface ExecuteManagedParams {
         sellShares?: number;
         allowedVenues?: Venue[];
     };
+    /**
+     * Self-custody: the wallet that will sign this fill. Must be a wallet
+     * already linked to this account. Omit for managed custody (the default).
+     */
+    signingAddress?: string;
+    /**
+     * Self-custody only: which approve shape a cross-chain fill uses when the
+     * bridge needs an ERC20 approve. Omit (the default) for "sponsored" — we pay
+     * the gas, but the wallet must sign a one-time EIP-7702 authorization over a
+     * RAW DIGEST, which many wallets cannot produce. Send "user_broadcast" when
+     * yours cannot: the user sends the approve and pays their own gas. Only your
+     * client can know which applies — it is a property of the wallet software,
+     * not of the address or the chain.
+     *
+     * Worth surfacing in your UI: "user_broadcast" never establishes the
+     * delegation, so it charges gas on EVERY bridge. "sponsored" costs one
+     * signature once per chain, then is free.
+     */
+    approveMode?: "sponsored" | "user_broadcast";
 }
 interface ExecuteManagedResponse {
     quoteId: string;
@@ -2798,6 +2904,17 @@ interface ExecuteManagedResponse {
     status: "pending";
     redeemId?: string;
     message?: string;
+    /**
+     * What this fill is waiting to be signed, if anything. On the immediate
+     * `POST /execution/fill` response this is always absent or empty — even
+     * for a self-custody fill, the DAG parks asynchronously, after this
+     * response has already been sent. Real entries only ever come back from
+     * polling `GET /execution/status` or from the next
+     * `POST /execution/fill/:quoteId/signatures` response (this same shape,
+     * reused). Drive the whole round trip through `fillSelfCustody()` rather
+     * than reading this field on the fill response by hand.
+     */
+    pendingSignatures?: SignatureRequest[];
 }
 type LimitOrderTimeInForce = "GTC" | "GTD" | "FOK" | "FAK" | "IOC" | "ALO";
 interface PlaceLimitOrderParams {
@@ -3162,6 +3279,14 @@ interface ExecutionStatusResponse {
     dagProgress: ExecutionDagProgress | null;
     steps: ExecutionStatusStep[];
     orders: ExecutionStatusOrder[];
+    /**
+     * What this run is waiting to be signed, mirroring the fill response's
+     * field of the same name. This is the polling route `fillSelfCustody` reads
+     * while an on-chain step is in flight — a caller polling this route for
+     * progress learns about newly-parked steps here too, not just from the
+     * signatures endpoint.
+     */
+    pendingSignatures?: SignatureRequest[];
 }
 type ExecutionPositionsQuery = GetPositionsQuery & {
     mode?: ExecutionMode;
@@ -4038,6 +4163,8 @@ declare class AggClient {
     private authOptions?;
     /** In-flight refresh promise — serializes concurrent 401 retries so only one refresh runs. */
     private pendingRefresh;
+    /** Partner-supplied signature callback for self-custodial fills. The SDK never sees a key. */
+    private readonly signer?;
     constructor(options: AggClientOptions);
     private resolvePaperTradingAppId;
     private paperTradingAccountsPath;
@@ -4171,7 +4298,13 @@ declare class AggClient {
      * rollup (total cost, share-weighted avg price, to-win).
      */
     getExecutionOrders(params?: ExecutionOrdersQuery): Promise<PaginatedResponse<ExecutionOrderItem>>;
-    /** Get quote-scoped execution progress, DAG step state, and order leg terminal status. */
+    /**
+     * Get quote-scoped execution progress, DAG step state, and order leg
+     * terminal status. Also carries `pendingSignatures` — this is the route
+     * `fillSelfCustody` polls while an on-chain step is in flight, so a caller
+     * already polling this for progress learns about newly-parked steps here
+     * too, not just from the signatures endpoint.
+     */
     getExecutionStatus(params: ExecutionStatusQuery): Promise<ExecutionStatusResponse>;
     /** Unified user activity feed (trades, deposits, withdrawals, bridges, wallet ops). */
     getUserActivity(params?: UserActivityQuery): Promise<PaginatedResponse<UserActivityItem>>;
@@ -4238,6 +4371,13 @@ declare class AggClient {
     /** Get a single venue event by ID. Requires appId or admin auth. */
     getVenueEventById(id: string, options?: {
         signal?: AbortSignal;
+        /**
+         * Scope `marketCount` and the rolled-up `volume` to the whole matched
+         * cluster (default, `true`) or to this one venue event (`false`). Pair it
+         * with the same value on {@link getVenueMarkets} so the count matches the
+         * market list you render.
+         */
+        cluster?: boolean;
     }): Promise<VenueEvent>;
     /** Get normalized live score state for sports events. Requires appId or admin auth. */
     getSportsLive(eventIds: string[], options?: {
@@ -4253,6 +4393,13 @@ declare class AggClient {
     getVenueMarkets(options?: {
         venue?: Venue;
         venueEventId?: string;
+        /**
+         * Scope `venueEventId` to the whole matched cluster (default, `true`) or to
+         * that one venue event (`false`). Under the default, naming any member of a
+         * cluster returns every venue's markets for that real-world event with
+         * matched siblings folded into their anchor. Ignored without `venueEventId`.
+         */
+        cluster?: boolean;
         search?: string;
         matchStatus?: MatchStatus;
         status?: MarketStatus;
@@ -4405,6 +4552,27 @@ declare class AggClient {
     }): AggWebSocket;
     /** Execute a previously quoted managed trade. Returns pending order IDs. */
     executeManaged(params: ExecuteManagedParams): Promise<ExecuteManagedResponse>;
+    /** Submit signatures for a parked fill. Returns whatever is still outstanding. */
+    submitFillSignatures(quoteId: string, signatures: Array<{
+        stepId: string;
+        signature?: string;
+        txHash?: string;
+    }>): Promise<ExecuteManagedResponse & {
+        accepted?: number;
+    }>;
+    /**
+     * Execute a quote in self-custodial mode.
+     *
+     * Identical to `executeManaged` when the server can sign for the user. When
+     * it cannot, the DAG parks on a signature request instead — but that park
+     * always happens asynchronously, in the trade-executor process, so it can
+     * never show up on this `POST /execution/fill` response itself. This
+     * drives the round trip from there: poll `getExecutionStatus` while an
+     * on-chain step is in flight, sign whatever it hands back with the
+     * configured `signer`, post the signatures back, and repeat until the
+     * server reports nothing outstanding and the run reaches a terminal state.
+     */
+    fillSelfCustody(params: ExecuteManagedParams): Promise<ExecuteManagedResponse>;
     /** Place a managed limit order. Returns the venue-backed order state. */
     placeLimitOrder(params: PlaceLimitOrderParams): Promise<PlaceLimitOrderResponse>;
     /**
@@ -4581,4 +4749,4 @@ declare function aggregateMidpoint(midpoints: (number | null | undefined)[]): nu
 
 declare function createAggClient(options: AggClientOptions): AggClient;
 
-export { ACTIVE_VENUES, type Account, AccountProvider, AccountType, AggApiError, type AggApiErrorInit, type AggApiFieldError, type AggAuthDeliveryMode, type AggAuthProviderType, type AggAuthStartBody, type AggAuthStartResult, type AggAuthVerifyBody, AggClient, type AggClientAuthOptions, type AggClientSessionInput, type AggLinkAccountBody, type AggLinkAccountConfirmResult, type AggLinkAccountResult, type AggLinkAccountWalletConfirmBody, type AggSessionUser, AggWebSocket, type AggWebSocketCallbacks, type AggWebSocketOptions, type AggregatedOrderbookLevel, type AggregatedOrderbookResponse, type App, type AppClientConfigResponse, type AttributedOrderbook, type AttributedOrderbookLevel, type AuthCodeResponse, type AuthStatus, type AuthTokenResponse, type AuthUser, type BalanceRefillAttempt, type BalanceRefillAttemptStatus, type BalanceRefillPolicy, type BalanceRefillPolicyStatus, type BatchMidpointsResponse, type BatchOrderbooksResponse, type BookQuality, type BuildVenueUrlOpts, CONFIRMED_MATCH_STATUSES, type CancelManagedExecutionResponse, type Candle, CandleBuilder, type CandleInterval, type Category, Chain, type ChartBarsResponse, type ChartCandle, type ChartResolution, type ChartVenueCandles, type ComputeSplitsRequest, type ComputeSplitsResponse, type ComputeSplitsSelection, type CorrelatedMarketCascadeItem, type CorrelatedMarketCascadeResponse, type CorrelatedMarketQueryResult, type CorrelatedMarketSide, type CorrelatedMarketSignal, type CorrelatedMarketSignalBatch, type CorrelatedMarketSignalDirection, type CorrelatedMarketsStatus, type CreateApp, type CreateBalanceRefillPolicyParams, type CreatePaperTradingAccountParams, type CryptoReferencePriceError, type CryptoReferencePriceExternalMarketInput, type CryptoReferencePriceMarketInput, type CryptoReferencePriceResult, type CryptoReferencePriceSource, type CryptoReferencePriceTarget, type CryptoReferencePricesResponse, DEFAULT_BALANCE_REFILL_DAILY_CAP_RAW, DEFAULT_BALANCE_REFILL_MAX_FEE_RAW, type DepositAddressesPendingResponse, type DepositAddressesReadyResponse, type DepositAddressesResponse, type DepositAddressesSupportedChain, type DepositAddressesToken, type DepositStep, type DiagnosticCallback, type DiagnosticEvent, type ExecuteManagedParams, type ExecuteManagedRequest, type ExecuteManagedResponse, type ExecuteTradeRequest, type ExecuteTradeResponse, type ExecutionDagProgress, type ExecutionDisplayGroupStatus, type ExecutionDisplayStepKind, type ExecutionMode, type ExecutionOrderItem, type ExecutionOrdersQuery, type ExecutionOverallState, type ExecutionPositionGroup, type ExecutionPositionsQuery, type ExecutionStatusOrder, type ExecutionStatusQuery, type ExecutionStatusResponse, type ExecutionStatusStep, type GetBalanceQuery, type GetBalanceResponse, type GetCryptoReferencePricesOptions, type GetHoldingsQuery, type GetHoldingsResponse, type GetOrdersParams, type GetOrdersQuery, type GetPositionsParams, type GetPositionsQuery, type HelloResponse, IMAGE_SIZES, INACTIVE_VENUES, ImageSize, LIMIT_PRICE_RAW_SCALE, type LimitOrderTimeInForce, type LimitPriceSide, type LimitPriceTickAdjustment, type ListRecurringCryptoMarketsOptions, type ManagedBalancesParams, type MarkSource, type MarketPriceHistory, MarketStatus, MatchStatus, MatchType, type MatchedMidpoint, type MatchedMidpointOutcome, type MatchedOrderbookMarket, type MatchedVenueMarketOutcomeRef, type MidpointItem, type MidpointRow, type NewsFeedArticleFeedItem, type NewsFeedArticleFeedResponse, type NewsFeedArticleWithSummary, type NewsFeedLinkedMarket, type NewsFeedListResponse, type NewsFeedMarketFeedArticle, type NewsFeedMarketFeedItem, type NewsFeedMarketFeedResponse, type NewsFeedMarketNewsParams, type NewsFeedMarketNewsResponse, type NewsFeedMarketNewsResult, type NewsFeedPageOptions, type NewsFeedStatusResponse, type NonceResponse, type OrderListItem, type OrderListQuery, OrderStatus, OrderType, type Orderbook, type OrderbookBatchItemError, type OrderbookBatchItemErrorCode, type OrderbookBatchItemStatus, type OrderbookHistoryPoint, type OrderbookHistoryResponse, type OrderbookLevel, type OrderbookQuoteFill, type OrderbookQuoteParams, type OrderbookQuoteResponse, type OrderbookServiceUnavailableError, type OrderbookState, type OrderbooksOnlyError, type OutcomeMidpoint, type OutcomeMidpointRow, type OutcomeOrderbookResponse, type PaginatedResponse, type PaperTradingAccount, type PaperTradingAccountsPage, type PaperTradingAppOptions, type PaperTradingBalanceAdjustment, type PaperTradingBalanceResponse, type PaperTradingLiquidityStatus, type PaperTradingListParams, type PaperTradingMarkSource, type PaperTradingOrder, type PaperTradingOrdersPage, type PaperTradingPortfolio, type PaperTradingPosition, type PaperTradingPositionsPage, type PersistedAuthSnapshot, type PlaceLimitOrderParams, type PlaceLimitOrderResponse, type PlacePaperTradingOrderParams, type PositionGroup, type PositionRedeemStatus, type PricePoint, type PriceSource, type PricesHistoryResponse, type QuoteError, type QuoteErrorCode, RECURRENCE_CADENCES, type RampQuote, type RampQuoteRequest, type RampSessionRequest, type RampWidgetSession, type RecurrenceCadence, type RecurrenceFilter, type RecurringCryptoComparisonPoint, type RecurringCryptoComparisonPriceSource, type RecurringCryptoDuration, type RecurringCryptoDurationInput, type RecurringCryptoMarketMetrics, type RecurringCryptoMarketsResponse, type RecurringCryptoOrderbookDepthLevel, type RecurringCryptoOrderbookDepthSide, type RecurringCryptoOutcome, type RecurringCryptoOutcomeOrderbookDepth, type RecurringCryptoPriceComparison, type RecurringCryptoReferencePrice, type RecurringCryptoResolution, type RecurringCryptoSourceConfidence, type RecurringCryptoVenueMarket, type RecurringCryptoWindowComparisons, type RecurringCryptoWindowMarket, type RedeemLegResult, type RedeemLegStatus, type RedeemRequest, type RedeemResponse, type RequestedOrderbookMarket, type ResetPaperTradingAccountParams, type ResolveCorrelatedMarketsParams, type ResolveCorrelatedMarketsResponse, type ResolvedCorrelatedMarketsResponse, type RpcTokenResponse, type SafeParseFailure, type SafeParseResult, type SafeParseSuccess, type ServerWallet, type SetPaperTradingBalanceParams, type SettlementDiff, type SettlementDifference, type SettlementSource, type SetupDepositAddressStep, type SetupVenueKeyStep, type SimpleOrderbookLevel, type SmartRouteAllocation, type SmartRouteBridgeStep, type SmartRouteFeeBreakdown, type SmartRouteFill, type SmartRouteParams, type SmartRouteResponse, type SmartRouteSettlementLeg, type SmartRouteSettlementPlan, type SmartRouteSetupCostLine, type SmartRouteSide, type SmartRouteStatus, type SmartRouteVenueFill, type SplitsByAmountResult, type SportsGameStatus, type SportsLiveParticipant, type SportsLiveResponse, type SportsLiveState, type SyncBalancesResponse, TimeInForce, type TradeExecutorOrder, type TradeExecutorOrderListResponse, TradeSide$1 as TradeSide, type TradeSplit, type TradeStep, TurnstileChallengeError, type UnifiedBalanceResponse, type UpdateBalanceRefillPolicyParams, type UpdateUserBody, type UpsertVenueKey, type UserActivityBridge, type UserActivityDeposit, type UserActivityItem, type UserActivityQuery, type UserActivityRedeem, type UserActivityRedeemLeg, type UserActivityTrade, type UserActivityType, type UserActivityUserOp, type UserActivityWithdrawal, type UserHolding, type UserProfile, VENUES, VENUE_CHAIN_IDS, type ValidateBalanceOnClientStep, type ValidateManagedParams, type ValidateManagedRequest, type ValidateManagedResponse, type ValidateTradeRequest, type ValidateTradeResponse, Venue, type VenueEvent, type VenueEventListItem, type VenueEventWithMarkets, type VenueGeoPolicyEntry, type VenueGeoPolicyResponse, type VenueKeyStatus, type VenueKeySummary, type VenueMarket, type VenueMarketClusterNode, type VenueMarketListItem, type VenueMarketOutcome, type VenueMarketRef, type VenueOrderbookEntry, type VenueOrderbookLevel, type VenuePositionBalance, type VenuePriceInfo, type VenueSoloQuote, type VerifyBody, type VerifyResponse, type WalletChainBalance, type WalletTokenBalance, type WithdrawManagedParams, type WithdrawManagedRequest, type WithdrawManagedResponse, type WithdrawManagedSourceItem, type WithdrawPreviewParams, type WithdrawPreviewResponse, type WithdrawTokenSymbol, type WithdrawalExpected, type WithdrawalLeg, type WithdrawalLegStatus, type WithdrawalLegType, type WithdrawalLifecycleStatus, type WithdrawalQuoteParams, type WithdrawalQuoteResponse, type WithdrawalSource, type WithdrawalSourceItem, type WithdrawalSourceStatus, type WithdrawalSourceTokenSymbol, type WsArbFeedBatch, type WsArbFeedEntry, type WsArbMarketUpdate, type WsAttributedLevel, type WsAuthenticated, type WsBalanceUpdate, type WsCandleInterval, type WsClientMessage, type WsConnected, type WsError, type WsHeartbeat, type WsMarkSource, type WsMarketResolved, type WsOrderEvent, type WsOrderEventType, type WsOrderSubmitted, type WsOrderbookDelta, type WsOrderbookSnapshot, type WsRedeemEvent, type WsServerMessage, type WsSubscribed, type WsTrade, type WsUnsubscribed, type WsVenueBook, type WsVenueInfo, type WsVenueLevel, type WsWithdrawalLegStatus, type WsWithdrawalLifecycleEvent, type WsWithdrawalLifecycleLeg, type WsWithdrawalLifecycleStatus, adjustLimitPriceRawToTick, aggregateMidpoint, applyOrderbookDelta, buildVenueUrl, computeBestSplitsByAmount, computeChecksum, createAggClient, enumGuard, formatMarketQuestion, formatOutcomeLabel, formatOutcomeTitle, getBalanceRefillMaximumRaw, getEffectiveDisabledVenues, getWalletAddressFromUserProfile, hasShape, isAggApiError, isBalanceRefillWithinDailyCap, isEmail, isEnum, isFiniteNonNeg, isNonEmptyString, isVenueActive, isVenueDataVisible, isVenueInactive, mergeCandles, mergeClosedCandles, normalizeVenueMarketCluster, optimizedImageUrl, parse, parseEmail, parseEmailStrict, safeParse, snapshotToOrderbook, sortVenues };
+export { ACTIVE_VENUES, type Account, AccountProvider, AccountType, AggApiError, type AggApiErrorInit, type AggApiFieldError, type AggAuthDeliveryMode, type AggAuthProviderType, type AggAuthStartBody, type AggAuthStartResult, type AggAuthVerifyBody, AggClient, type AggClientAuthOptions, type AggClientOptions, type AggClientSessionInput, type AggLinkAccountBody, type AggLinkAccountConfirmResult, type AggLinkAccountResult, type AggLinkAccountWalletConfirmBody, type AggSessionUser, AggWebSocket, type AggWebSocketCallbacks, type AggWebSocketOptions, type AggregatedOrderbookLevel, type AggregatedOrderbookResponse, type App, type AppClientConfigResponse, type AttributedOrderbook, type AttributedOrderbookLevel, type AuthCodeResponse, type AuthStatus, type AuthTokenResponse, type AuthUser, type BalanceRefillAttempt, type BalanceRefillAttemptStatus, type BalanceRefillPolicy, type BalanceRefillPolicyStatus, type BatchMidpointsResponse, type BatchOrderbooksResponse, type BookQuality, type BuildVenueUrlOpts, CONFIRMED_MATCH_STATUSES, type CancelManagedExecutionResponse, type Candle, CandleBuilder, type CandleInterval, type Category, Chain, type ChartBarsResponse, type ChartCandle, type ChartResolution, type ChartVenueCandles, type ComputeSplitsRequest, type ComputeSplitsResponse, type ComputeSplitsSelection, type CorrelatedMarketCascadeItem, type CorrelatedMarketCascadeResponse, type CorrelatedMarketQueryResult, type CorrelatedMarketSide, type CorrelatedMarketSignal, type CorrelatedMarketSignalBatch, type CorrelatedMarketSignalDirection, type CorrelatedMarketsStatus, type CreateApp, type CreateBalanceRefillPolicyParams, type CreatePaperTradingAccountParams, type CryptoReferencePriceError, type CryptoReferencePriceExternalMarketInput, type CryptoReferencePriceMarketInput, type CryptoReferencePriceResult, type CryptoReferencePriceSource, type CryptoReferencePriceTarget, type CryptoReferencePricesResponse, DEFAULT_BALANCE_REFILL_DAILY_CAP_RAW, DEFAULT_BALANCE_REFILL_MAX_FEE_RAW, type DepositAddressesPendingResponse, type DepositAddressesReadyResponse, type DepositAddressesResponse, type DepositAddressesSupportedChain, type DepositAddressesToken, type DepositStep, type DiagnosticCallback, type DiagnosticEvent, type ExecuteManagedParams, type ExecuteManagedRequest, type ExecuteManagedResponse, type ExecuteTradeRequest, type ExecuteTradeResponse, type ExecutionDagProgress, type ExecutionDisplayGroupStatus, type ExecutionDisplayStepKind, type ExecutionMode, type ExecutionOrderItem, type ExecutionOrdersQuery, type ExecutionOverallState, type ExecutionPositionGroup, type ExecutionPositionsQuery, type ExecutionStatusOrder, type ExecutionStatusQuery, type ExecutionStatusResponse, type ExecutionStatusStep, type GetBalanceQuery, type GetBalanceResponse, type GetCryptoReferencePricesOptions, type GetHoldingsQuery, type GetHoldingsResponse, type GetOrdersParams, type GetOrdersQuery, type GetPositionsParams, type GetPositionsQuery, type HelloResponse, IMAGE_SIZES, INACTIVE_VENUES, ImageSize, LIMIT_PRICE_RAW_SCALE, type LimitOrderTimeInForce, type LimitPriceSide, type LimitPriceTickAdjustment, type ListRecurringCryptoMarketsOptions, type ManagedBalancesParams, type MarkSource, type MarketPriceHistory, MarketStatus, MatchStatus, MatchType, type MatchedMidpoint, type MatchedMidpointOutcome, type MatchedOrderbookMarket, type MatchedVenueMarketOutcomeRef, type MidpointItem, type MidpointRow, type NewsFeedArticleFeedItem, type NewsFeedArticleFeedResponse, type NewsFeedArticleWithSummary, type NewsFeedLinkedMarket, type NewsFeedListResponse, type NewsFeedMarketFeedArticle, type NewsFeedMarketFeedItem, type NewsFeedMarketFeedResponse, type NewsFeedMarketNewsParams, type NewsFeedMarketNewsResponse, type NewsFeedMarketNewsResult, type NewsFeedPageOptions, type NewsFeedStatusResponse, type NonceResponse, type OrderListItem, type OrderListQuery, OrderStatus, OrderType, type Orderbook, type OrderbookBatchItemError, type OrderbookBatchItemErrorCode, type OrderbookBatchItemStatus, type OrderbookHistoryPoint, type OrderbookHistoryResponse, type OrderbookLevel, type OrderbookQuoteFill, type OrderbookQuoteParams, type OrderbookQuoteResponse, type OrderbookServiceUnavailableError, type OrderbookState, type OrderbooksOnlyError, type OutcomeMidpoint, type OutcomeMidpointRow, type OutcomeOrderbookResponse, type PaginatedResponse, type PaperTradingAccount, type PaperTradingAccountsPage, type PaperTradingAppOptions, type PaperTradingBalanceAdjustment, type PaperTradingBalanceResponse, type PaperTradingLiquidityStatus, type PaperTradingListParams, type PaperTradingMarkSource, type PaperTradingOrder, type PaperTradingOrdersPage, type PaperTradingPortfolio, type PaperTradingPosition, type PaperTradingPositionsPage, type PersistedAuthSnapshot, type PlaceLimitOrderParams, type PlaceLimitOrderResponse, type PlacePaperTradingOrderParams, type PositionGroup, type PositionRedeemStatus, type PricePoint, type PriceSource, type PricesHistoryResponse, type QuoteError, type QuoteErrorCode, RECURRENCE_CADENCES, type RampQuote, type RampQuoteRequest, type RampSessionRequest, type RampWidgetSession, type RecurrenceCadence, type RecurrenceFilter, type RecurringCryptoComparisonPoint, type RecurringCryptoComparisonPriceSource, type RecurringCryptoDuration, type RecurringCryptoDurationInput, type RecurringCryptoMarketMetrics, type RecurringCryptoMarketsResponse, type RecurringCryptoOrderbookDepthLevel, type RecurringCryptoOrderbookDepthSide, type RecurringCryptoOutcome, type RecurringCryptoOutcomeOrderbookDepth, type RecurringCryptoPriceComparison, type RecurringCryptoReferencePrice, type RecurringCryptoResolution, type RecurringCryptoSourceConfidence, type RecurringCryptoVenueMarket, type RecurringCryptoWindowComparisons, type RecurringCryptoWindowMarket, type RedeemLegResult, type RedeemLegStatus, type RedeemRequest, type RedeemResponse, type RequestedOrderbookMarket, type ResetPaperTradingAccountParams, type ResolveCorrelatedMarketsParams, type ResolveCorrelatedMarketsResponse, type ResolvedCorrelatedMarketsResponse, type RpcTokenResponse, SELF_CUSTODY_FILL_TIMEOUT_MS, SELF_CUSTODY_POLL_INTERVAL_MS, type SafeParseFailure, type SafeParseResult, type SafeParseSuccess, type ServerWallet, type SetPaperTradingBalanceParams, type SettlementDiff, type SettlementDifference, type SettlementSource, type SetupDepositAddressStep, type SetupVenueKeyStep, type SignatureRequest, type SignatureRequestType, type SignerFn, type SimpleOrderbookLevel, type SmartRouteAllocation, type SmartRouteBridgeStep, type SmartRouteFeeBreakdown, type SmartRouteFill, type SmartRouteParams, type SmartRouteResponse, type SmartRouteSettlementLeg, type SmartRouteSettlementPlan, type SmartRouteSetupCostLine, type SmartRouteSide, type SmartRouteStatus, type SmartRouteVenueFill, type SplitsByAmountResult, type SportsGameStatus, type SportsLiveParticipant, type SportsLiveResponse, type SportsLiveState, type SyncBalancesResponse, TERMINAL_EXECUTION_STATES, TimeInForce, type TradeExecutorOrder, type TradeExecutorOrderListResponse, TradeSide$1 as TradeSide, type TradeSplit, type TradeStep, TurnstileChallengeError, type UnifiedBalanceResponse, type UpdateBalanceRefillPolicyParams, type UpdateUserBody, type UpsertVenueKey, type UserActivityBridge, type UserActivityDeposit, type UserActivityItem, type UserActivityQuery, type UserActivityRedeem, type UserActivityRedeemLeg, type UserActivityTrade, type UserActivityType, type UserActivityUserOp, type UserActivityWithdrawal, type UserHolding, type UserProfile, VENUES, VENUE_CHAIN_IDS, type ValidateBalanceOnClientStep, type ValidateManagedParams, type ValidateManagedRequest, type ValidateManagedResponse, type ValidateTradeRequest, type ValidateTradeResponse, Venue, type VenueEvent, type VenueEventListItem, type VenueEventWithMarkets, type VenueGeoPolicyEntry, type VenueGeoPolicyResponse, type VenueKeyStatus, type VenueKeySummary, type VenueMarket, type VenueMarketClusterNode, type VenueMarketListItem, type VenueMarketOutcome, type VenueMarketRef, type VenueOrderbookEntry, type VenueOrderbookLevel, type VenuePositionBalance, type VenuePriceInfo, type VenueSoloQuote, type VerifyBody, type VerifyResponse, type WalletChainBalance, type WalletTokenBalance, type WithdrawManagedParams, type WithdrawManagedRequest, type WithdrawManagedResponse, type WithdrawManagedSourceItem, type WithdrawPreviewParams, type WithdrawPreviewResponse, type WithdrawTokenSymbol, type WithdrawalExpected, type WithdrawalLeg, type WithdrawalLegStatus, type WithdrawalLegType, type WithdrawalLifecycleStatus, type WithdrawalQuoteParams, type WithdrawalQuoteResponse, type WithdrawalSource, type WithdrawalSourceItem, type WithdrawalSourceStatus, type WithdrawalSourceTokenSymbol, type WsArbFeedBatch, type WsArbFeedEntry, type WsArbMarketUpdate, type WsAttributedLevel, type WsAuthenticated, type WsBalanceUpdate, type WsCandleInterval, type WsClientMessage, type WsConnected, type WsError, type WsHeartbeat, type WsMarkSource, type WsMarketResolved, type WsOrderEvent, type WsOrderEventType, type WsOrderSubmitted, type WsOrderbookDelta, type WsOrderbookSnapshot, type WsRedeemEvent, type WsServerMessage, type WsSubscribed, type WsTrade, type WsUnsubscribed, type WsVenueBook, type WsVenueInfo, type WsVenueLevel, type WsWithdrawalLegStatus, type WsWithdrawalLifecycleEvent, type WsWithdrawalLifecycleLeg, type WsWithdrawalLifecycleStatus, adjustLimitPriceRawToTick, aggregateMidpoint, applyOrderbookDelta, buildVenueUrl, computeBestSplitsByAmount, computeChecksum, createAggClient, enumGuard, formatMarketQuestion, formatOutcomeLabel, formatOutcomeTitle, getBalanceRefillMaximumRaw, getEffectiveDisabledVenues, getWalletAddressFromUserProfile, hasShape, isAggApiError, isBalanceRefillWithinDailyCap, isEmail, isEnum, isFiniteNonNeg, isNonEmptyString, isVenueActive, isVenueDataVisible, isVenueInactive, mergeCandles, mergeClosedCandles, normalizeVenueMarketCluster, optimizedImageUrl, parse, parseEmail, parseEmailStrict, safeParse, snapshotToOrderbook, sortVenues };

package/dist/index.js

@@ -90,6 +90,9 @@ __export(index_exports, {
   OrderStatus: () => OrderStatus,
   OrderType: () => OrderType,
   RECURRENCE_CADENCES: () => RECURRENCE_CADENCES,
+  SELF_CUSTODY_FILL_TIMEOUT_MS: () => SELF_CUSTODY_FILL_TIMEOUT_MS,
+  SELF_CUSTODY_POLL_INTERVAL_MS: () => SELF_CUSTODY_POLL_INTERVAL_MS,
+  TERMINAL_EXECUTION_STATES: () => TERMINAL_EXECUTION_STATES,
   TimeInForce: () => TimeInForce,
   TradeSide: () => TradeSide,
   TurnstileChallengeError: () => TurnstileChallengeError,
@@ -818,6 +821,21 @@ function isAggApiError(value) {
   return value instanceof AggApiError;
 }
 
+// src/types.ts
+var SELF_CUSTODY_FILL_TIMEOUT_MS = 5 * 6e4;
+var SELF_CUSTODY_POLL_INTERVAL_MS = 2e3;
+var TERMINAL_EXECUTION_STATES = /* @__PURE__ */ new Set(["filled", "partially_filled", "failed", "cancelled", "expired"]);
+var RECURRENCE_CADENCES = [
+  "PT5M",
+  "PT10M",
+  "PT15M",
+  "PT1H",
+  "P1D",
+  "P1W",
+  "P1M",
+  "P1Y"
+];
+
 // src/orderbook-utils.ts
 var PRICE_KEY_SCALE = 1e9;
 function crc32(str) {
@@ -1838,6 +1856,7 @@ var AggClient = class {
     this.appId = options.appId;
     this.adminKey = options.adminKey;
     this.apiKey = options.apiKey;
+    this.signer = options.signer;
     this.baseUrl = options.baseUrl.replace(/\/$/, "");
     this.wsUrl = options.wsUrl;
     this.authOptions = options.auth;
@@ -2481,7 +2500,13 @@ Issued At: ${issuedAt}`;
       });
     });
   }
-  /** Get quote-scoped execution progress, DAG step state, and order leg terminal status. */
+  /**
+   * Get quote-scoped execution progress, DAG step state, and order leg
+   * terminal status. Also carries `pendingSignatures` — this is the route
+   * `fillSelfCustody` polls while an on-chain step is in flight, so a caller
+   * already polling this for progress learns about newly-parked steps here
+   * too, not just from the signatures endpoint.
+   */
   getExecutionStatus(params) {
     return __async(this, null, function* () {
       const query = { quoteId: params.quoteId };
@@ -2694,7 +2719,7 @@ Issued At: ${issuedAt}`;
         // Opt into the lean response (no embedded `venueMarkets`) — markets are
         // fetched separately via GET /venue-markets. Empty `expand` (no `markets`
         // token) tells the API to omit the deprecated embedded array.
-        query: { expand: "" },
+        query: __spreadValues({ expand: "" }, (options == null ? void 0 : options.cluster) === false ? { cluster: "false" } : {}),
         signal: options == null ? void 0 : options.signal
       });
     });
@@ -2822,6 +2847,7 @@ Issued At: ${issuedAt}`;
       const query = {};
       if (options == null ? void 0 : options.venue) query.venue = options.venue;
       if (options == null ? void 0 : options.venueEventId) query.venueEventId = options.venueEventId;
+      if ((options == null ? void 0 : options.cluster) === false) query.cluster = "false";
       if ((_a = options == null ? void 0 : options.search) == null ? void 0 : _a.trim()) query.search = options.search.trim();
       if (options == null ? void 0 : options.matchStatus) query.matchStatus = options.matchStatus;
       if (options == null ? void 0 : options.status) query.status = options.status;
@@ -3151,6 +3177,87 @@ Issued At: ${issuedAt}`;
       });
     });
   }
+  /** Submit signatures for a parked fill. Returns whatever is still outstanding. */
+  submitFillSignatures(quoteId, signatures) {
+    return __async(this, null, function* () {
+      return this.request(`/execution/fill/${encodeURIComponent(quoteId)}/signatures`, {
+        method: "POST",
+        body: JSON.stringify({ signatures })
+      });
+    });
+  }
+  /**
+   * Execute a quote in self-custodial mode.
+   *
+   * Identical to `executeManaged` when the server can sign for the user. When
+   * it cannot, the DAG parks on a signature request instead — but that park
+   * always happens asynchronously, in the trade-executor process, so it can
+   * never show up on this `POST /execution/fill` response itself. This
+   * drives the round trip from there: poll `getExecutionStatus` while an
+   * on-chain step is in flight, sign whatever it hands back with the
+   * configured `signer`, post the signatures back, and repeat until the
+   * server reports nothing outstanding and the run reaches a terminal state.
+   */
+  fillSelfCustody(params) {
+    return __async(this, null, function* () {
+      var _a, _b, _c;
+      if (this.signer && !params.signingAddress) {
+        throw new Error(
+          "fillSelfCustody requires `signingAddress` \u2014 the wallet that will sign this fill."
+        );
+      }
+      if (params.signingAddress && !this.signer) {
+        throw new Error(
+          "This fill requires client-side signatures, but no `signer` was passed to createAggClient(). Provide one to trade in self-custodial mode."
+        );
+      }
+      const first = yield this.executeManaged(params);
+      if (!this.signer && !params.signingAddress) return first;
+      const signer = this.signer;
+      const quoteId = first.quoteId;
+      let pending = (_a = first.pendingSignatures) != null ? _a : [];
+      let lastKey = "";
+      const deadline = Date.now() + SELF_CUSTODY_FILL_TIMEOUT_MS;
+      for (; ; ) {
+        if (Date.now() > deadline) {
+          throw new Error(`Fill for quote ${quoteId} did not finish within the timeout.`);
+        }
+        if (pending.length === 0) {
+          yield new Promise((r) => setTimeout(r, SELF_CUSTODY_POLL_INTERVAL_MS));
+          const polled = yield this.getExecutionStatus({ quoteId });
+          if (TERMINAL_EXECUTION_STATES.has(polled.overallState)) {
+            if (polled.overallState !== "filled" && polled.overallState !== "partially_filled") {
+              throw new Error(`Fill for quote ${quoteId} ended as ${polled.overallState}.`);
+            }
+            return __spreadProps(__spreadValues({}, first), { pendingSignatures: [] });
+          }
+          pending = (_b = polled.pendingSignatures) != null ? _b : [];
+          continue;
+        }
+        const key = pending.map((p) => p.stepId).sort().join(",");
+        if (key === lastKey) {
+          throw new Error(
+            `Fill for quote ${quoteId} did not advance \u2014 still awaiting steps [${key}] after signing them.`
+          );
+        }
+        lastKey = key;
+        const signatures = [];
+        for (const req of pending) {
+          if (Date.now() > new Date(req.expiresAt).getTime()) {
+            throw new Error(
+              `Signature request ${req.stepId} for quote ${quoteId} expired at ${req.expiresAt}; the fill must be re-quoted.`
+            );
+          }
+          const signed = yield signer(req);
+          signatures.push(
+            typeof signed === "string" ? { stepId: req.stepId, signature: signed } : { stepId: req.stepId, txHash: signed.txHash }
+          );
+        }
+        const next = yield this.submitFillSignatures(quoteId, signatures);
+        pending = (_c = next.pendingSignatures) != null ? _c : [];
+      }
+    });
+  }
   /** Place a managed limit order. Returns the venue-backed order state. */
   placeLimitOrder(params) {
     return __async(this, null, function* () {
@@ -3339,18 +3446,6 @@ Issued At: ${issuedAt}`;
 // src/best-split.ts
 var computeBestSplitsByAmount2 = computeBestSplitsByAmount;
 
-// src/types.ts
-var RECURRENCE_CADENCES = [
-  "PT5M",
-  "PT10M",
-  "PT15M",
-  "PT1H",
-  "P1D",
-  "P1W",
-  "P1M",
-  "P1Y"
-];
-
 // src/candle-builder.ts
 var INTERVAL_SECS = {
   "1m": 60,
@@ -3562,6 +3657,9 @@ function createAggClient(options) {
   OrderStatus,
   OrderType,
   RECURRENCE_CADENCES,
+  SELF_CUSTODY_FILL_TIMEOUT_MS,
+  SELF_CUSTODY_POLL_INTERVAL_MS,
+  TERMINAL_EXECUTION_STATES,
   TimeInForce,
   TradeSide,
   TurnstileChallengeError,

package/dist/index.mjs

@@ -690,6 +690,21 @@ function isAggApiError(value) {
   return value instanceof AggApiError;
 }
 
+// src/types.ts
+var SELF_CUSTODY_FILL_TIMEOUT_MS = 5 * 6e4;
+var SELF_CUSTODY_POLL_INTERVAL_MS = 2e3;
+var TERMINAL_EXECUTION_STATES = /* @__PURE__ */ new Set(["filled", "partially_filled", "failed", "cancelled", "expired"]);
+var RECURRENCE_CADENCES = [
+  "PT5M",
+  "PT10M",
+  "PT15M",
+  "PT1H",
+  "P1D",
+  "P1W",
+  "P1M",
+  "P1Y"
+];
+
 // src/orderbook-utils.ts
 var PRICE_KEY_SCALE = 1e9;
 function crc32(str) {
@@ -1710,6 +1725,7 @@ var AggClient = class {
     this.appId = options.appId;
     this.adminKey = options.adminKey;
     this.apiKey = options.apiKey;
+    this.signer = options.signer;
     this.baseUrl = options.baseUrl.replace(/\/$/, "");
     this.wsUrl = options.wsUrl;
     this.authOptions = options.auth;
@@ -2353,7 +2369,13 @@ Issued At: ${issuedAt}`;
       });
     });
   }
-  /** Get quote-scoped execution progress, DAG step state, and order leg terminal status. */
+  /**
+   * Get quote-scoped execution progress, DAG step state, and order leg
+   * terminal status. Also carries `pendingSignatures` — this is the route
+   * `fillSelfCustody` polls while an on-chain step is in flight, so a caller
+   * already polling this for progress learns about newly-parked steps here
+   * too, not just from the signatures endpoint.
+   */
   getExecutionStatus(params) {
     return __async(this, null, function* () {
       const query = { quoteId: params.quoteId };
@@ -2566,7 +2588,7 @@ Issued At: ${issuedAt}`;
         // Opt into the lean response (no embedded `venueMarkets`) — markets are
         // fetched separately via GET /venue-markets. Empty `expand` (no `markets`
         // token) tells the API to omit the deprecated embedded array.
-        query: { expand: "" },
+        query: __spreadValues({ expand: "" }, (options == null ? void 0 : options.cluster) === false ? { cluster: "false" } : {}),
         signal: options == null ? void 0 : options.signal
       });
     });
@@ -2694,6 +2716,7 @@ Issued At: ${issuedAt}`;
       const query = {};
       if (options == null ? void 0 : options.venue) query.venue = options.venue;
       if (options == null ? void 0 : options.venueEventId) query.venueEventId = options.venueEventId;
+      if ((options == null ? void 0 : options.cluster) === false) query.cluster = "false";
       if ((_a = options == null ? void 0 : options.search) == null ? void 0 : _a.trim()) query.search = options.search.trim();
       if (options == null ? void 0 : options.matchStatus) query.matchStatus = options.matchStatus;
       if (options == null ? void 0 : options.status) query.status = options.status;
@@ -3023,6 +3046,87 @@ Issued At: ${issuedAt}`;
       });
     });
   }
+  /** Submit signatures for a parked fill. Returns whatever is still outstanding. */
+  submitFillSignatures(quoteId, signatures) {
+    return __async(this, null, function* () {
+      return this.request(`/execution/fill/${encodeURIComponent(quoteId)}/signatures`, {
+        method: "POST",
+        body: JSON.stringify({ signatures })
+      });
+    });
+  }
+  /**
+   * Execute a quote in self-custodial mode.
+   *
+   * Identical to `executeManaged` when the server can sign for the user. When
+   * it cannot, the DAG parks on a signature request instead — but that park
+   * always happens asynchronously, in the trade-executor process, so it can
+   * never show up on this `POST /execution/fill` response itself. This
+   * drives the round trip from there: poll `getExecutionStatus` while an
+   * on-chain step is in flight, sign whatever it hands back with the
+   * configured `signer`, post the signatures back, and repeat until the
+   * server reports nothing outstanding and the run reaches a terminal state.
+   */
+  fillSelfCustody(params) {
+    return __async(this, null, function* () {
+      var _a, _b, _c;
+      if (this.signer && !params.signingAddress) {
+        throw new Error(
+          "fillSelfCustody requires `signingAddress` \u2014 the wallet that will sign this fill."
+        );
+      }
+      if (params.signingAddress && !this.signer) {
+        throw new Error(
+          "This fill requires client-side signatures, but no `signer` was passed to createAggClient(). Provide one to trade in self-custodial mode."
+        );
+      }
+      const first = yield this.executeManaged(params);
+      if (!this.signer && !params.signingAddress) return first;
+      const signer = this.signer;
+      const quoteId = first.quoteId;
+      let pending = (_a = first.pendingSignatures) != null ? _a : [];
+      let lastKey = "";
+      const deadline = Date.now() + SELF_CUSTODY_FILL_TIMEOUT_MS;
+      for (; ; ) {
+        if (Date.now() > deadline) {
+          throw new Error(`Fill for quote ${quoteId} did not finish within the timeout.`);
+        }
+        if (pending.length === 0) {
+          yield new Promise((r) => setTimeout(r, SELF_CUSTODY_POLL_INTERVAL_MS));
+          const polled = yield this.getExecutionStatus({ quoteId });
+          if (TERMINAL_EXECUTION_STATES.has(polled.overallState)) {
+            if (polled.overallState !== "filled" && polled.overallState !== "partially_filled") {
+              throw new Error(`Fill for quote ${quoteId} ended as ${polled.overallState}.`);
+            }
+            return __spreadProps(__spreadValues({}, first), { pendingSignatures: [] });
+          }
+          pending = (_b = polled.pendingSignatures) != null ? _b : [];
+          continue;
+        }
+        const key = pending.map((p) => p.stepId).sort().join(",");
+        if (key === lastKey) {
+          throw new Error(
+            `Fill for quote ${quoteId} did not advance \u2014 still awaiting steps [${key}] after signing them.`
+          );
+        }
+        lastKey = key;
+        const signatures = [];
+        for (const req of pending) {
+          if (Date.now() > new Date(req.expiresAt).getTime()) {
+            throw new Error(
+              `Signature request ${req.stepId} for quote ${quoteId} expired at ${req.expiresAt}; the fill must be re-quoted.`
+            );
+          }
+          const signed = yield signer(req);
+          signatures.push(
+            typeof signed === "string" ? { stepId: req.stepId, signature: signed } : { stepId: req.stepId, txHash: signed.txHash }
+          );
+        }
+        const next = yield this.submitFillSignatures(quoteId, signatures);
+        pending = (_c = next.pendingSignatures) != null ? _c : [];
+      }
+    });
+  }
   /** Place a managed limit order. Returns the venue-backed order state. */
   placeLimitOrder(params) {
     return __async(this, null, function* () {
@@ -3211,18 +3315,6 @@ Issued At: ${issuedAt}`;
 // src/best-split.ts
 var computeBestSplitsByAmount2 = computeBestSplitsByAmount;
 
-// src/types.ts
-var RECURRENCE_CADENCES = [
-  "PT5M",
-  "PT10M",
-  "PT15M",
-  "PT1H",
-  "P1D",
-  "P1W",
-  "P1M",
-  "P1Y"
-];
-
 // src/candle-builder.ts
 var INTERVAL_SECS = {
   "1m": 60,
@@ -3433,6 +3525,9 @@ export {
   OrderStatus,
   OrderType,
   RECURRENCE_CADENCES,
+  SELF_CUSTODY_FILL_TIMEOUT_MS,
+  SELF_CUSTODY_POLL_INTERVAL_MS,
+  TERMINAL_EXECUTION_STATES,
   TimeInForce,
   TradeSide,
   TurnstileChallengeError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/sdk",
-  "version": "4.5.0",
+  "version": "4.7.0",
   "description": "Vanilla TypeScript client for the AGG prediction market aggregator (auth, markets, orderbooks, charts, trading, managed execution, WebSockets). Works in browsers, Node.js, and React Native.",
   "sideEffects": false,
   "license": "MIT",