@agg-build/sdk 4.8.1 → 4.9.2

package/dist/index.d.mts

@@ -23,37 +23,14 @@ declare const VENUE_CHAIN_IDS: Partial<Record<Venue, number>>;
  * Re-activating a venue is therefore an intentional code change here rather
  * than a runtime configuration toggle.
  */
-declare const ACTIVE_VENUES: readonly [Venue.kalshi, Venue.polymarket, Venue.limitless, Venue.opinion, Venue.predict, Venue.probable, Venue.myriad, Venue.hyperliquid, Venue.novig];
+declare const ACTIVE_VENUES: readonly [Venue.kalshi, Venue.polymarket, Venue.limitless, Venue.opinion, Venue.predict, Venue.probable, Venue.myriad, Venue.hyperliquid, Venue.novig, Venue.prophetx];
 /**
- * Venues excluded from new user-facing activity. Kalshi and Novig have both
- * left this set — each is fully active (data + execution) — leaving ProphetX
- * as the only member.
- *
- * - `prophetx` — NOT YET LAUNCHED, and SANDBOX-ONLY: production `/auth/login`
- *   rejects our credentials, so every ProphetX row is sandbox data. It now has
- *   a live orderbook feed and a live aggKey extractor, so it DOES join
- *   cross-venue clusters and can reach `VenueEvent.arbReturn`, which is public
- *   and sortable. Membership here is therefore load-bearing rather than
- *   cosmetic, and it must not reach end users until real credentials exist.
- *   `PROPHET_X_DATA_VISIBLE=true` un-hides it on staging for API verification
- *   (see `dataVisibleVenues` in `@app/runtime-config`).
- *
- *   NOTE this set only applies where there is NO app context. An App row is
- *   authoritative, and its `disabledVenues` is stamped from this constant at
- *   CREATE time only — an app created before a venue joined this list keeps a
- *   list without it, and no restart repairs that (bootstrap deliberately does
- *   not clobber an existing row). Adding a venue here needs a one-time
- *   `UPDATE "App" SET "disabledVenues" = array_append(...)` to match.
- *
- * Membership here does NOT stop ingestion: the Rust engine gates discovery on
- * credentials, so Novig data keeps flowing into `VenueEvent`/`VenueMarket` and
- * keeps being matched. This set governs the API read layer and execution only.
- *
- * Global activity is separate from partner access: Novig remains in
- * DEFAULT_DISABLED_VENUES and is enabled only by a super-admin removing it
- * from one App.disabledVenues list.
+ * Venues excluded from new user-facing activity. The set is currently empty:
+ * ProphetX has discovery, live books, and a sandbox clearinghouse execution
+ * provider. Partner rollout is controlled separately through
+ * DEFAULT_DISABLED_VENUES and App.disabledVenues.
  */
-declare const INACTIVE_VENUES: readonly [Venue.prophetx];
+declare const INACTIVE_VENUES: readonly [];
 /** Whether a venue may participate in new user-facing activity. */
 declare function isVenueActive(venue: string): boolean;
 /** Whether a venue is intentionally retained only for wind-down/history flows. */
@@ -535,6 +512,21 @@ type UnifiedBalanceResponse = {
         portfolioValueCents?: number | undefined;
         updatedAt: string;
     }[];
+    /**
+     * Paper-account summary. Present only when the request resolved to paper
+     * mode; absent in a live response. Mirrors `UnifiedBalanceResponseSchemaTB`
+     * in `typebox/schemas/trading.ts` — keep the two in sync. All dollars.
+     */
+    paper?: {
+        startingBalance: number;
+        cashBalance: number;
+        positionsValue: number;
+        /** Banked P&L from closed trades — account-level, not summable from positions. */
+        realizedPnl: number;
+        unrealizedPnl: number;
+        /** realized + unrealized. */
+        earnings: number;
+    };
 };
 type UserHolding = {
     venue: Venue;
@@ -2021,11 +2013,24 @@ declare class AggWebSocket {
     private isOrderbookDebugEnabled;
 }
 
+/** App-level paper/live mode. An app is one or the other, never both. */
+type AppTradingMode = "live" | "paper";
 interface AppClientConfigResponse {
     disabledVenues: Venue[];
     disabledCategoryPresets: string[];
     earlyAccessEnabled: boolean;
     authOptions: AppClientAuthOption[];
+    /**
+     * Server-owned execution mode. Prefer this over any locally-configured
+     * `trading.executionMode` — the API enforces it regardless of what the
+     * client sends, and end users cannot change it.
+     */
+    tradingMode: AppTradingMode;
+    /**
+     * One-time simulated balance granted on first paper use, in dollars.
+     * Interpolate this into paper copy rather than hardcoding a figure.
+     */
+    paperStartingBalance: number;
 }
 interface VenueGeoPolicyEntry {
     venue: Venue;
@@ -3631,6 +3636,10 @@ interface SmartRouteFill {
 }
 /** Per-venue routing result with fills and chain info. */
 interface SmartRouteVenueFill {
+    /** CH executable price and normalized input, in micro-USDC. */
+    limitPriceMicroUsdc?: string;
+    inAmount?: string;
+    outAmount?: string;
     venue: string;
     venueMarketId: string;
     venueMarketOutcomeId: string;
@@ -3640,6 +3649,9 @@ interface SmartRouteVenueFill {
     noPrice: number;
     fills: SmartRouteFill[];
     venueQty: number;
+    /** Inclusive fee/reserve funding budget. For fee display, use the route's
+     * feeBreakdown.venueFees and executionReserve instead. */
+    venueFee?: number;
 }
 interface SmartRouteAllocation {
     sourceChainId: string;
@@ -3774,6 +3786,10 @@ interface SmartRouteSetupCostLine {
 interface SmartRouteFeeBreakdown {
     rawExecCost: number;
     venueFees: number;
+    /** Additional CH funding reserve for slippage or possible venue charges.
+     * Excluded from venueFees and totalCost; included in funding allocations.
+     * Only the unused portion is released after execution. */
+    executionReserve?: number;
     bridgeFees: number;
     executionGas: number;
     totalCost: number;
@@ -3913,6 +3929,12 @@ interface RedeemLegResult {
 }
 interface RedeemRequest {
     venueMarketOutcomeIds: string[];
+    /**
+     * Trading mode. Defaults to live, matching the other execution methods.
+     * Honoured on a live app; ignored on a paper app, which has no real-money
+     * path and always settles on paper.
+     */
+    mode?: ExecutionMode;
 }
 interface RedeemResponse {
     redeemId: string;
@@ -4185,7 +4207,7 @@ type UserAuthResult = {
     user: UserProfile;
 };
 declare class AggClient {
-    private appId?;
+    private _appId?;
     private adminKey?;
     private apiKey?;
     private baseUrl;
@@ -4243,6 +4265,12 @@ declare class AggClient {
     /** Clear the user access token, refresh token, and user info. Broadcasts cross-tab logout. */
     clearAccessToken(): void;
     private broadcastAuth;
+    /**
+     * The App this client speaks for, or `undefined` for an admin-key-only
+     * client. Exposed so callers can scope per-app caches by it — app config is
+     * app-scoped data, and two clients sharing one cache must not share entries.
+     */
+    get appId(): string | undefined;
     /** Current auth lifecycle status. */
     get authStatus(): AuthStatus;
     /** Whether a user access token is currently set. */
@@ -4677,7 +4705,11 @@ declare class AggClient {
     getRampQuotes(params: RampQuoteRequest): Promise<RampQuote[]>;
     /** Create a ramp widget session for checkout. */
     createRampSession(params: RampSessionRequest): Promise<RampWidgetSession>;
-    /** Initiate KYC verification for a venue. Returns a KYC URL to redirect the user to. */
+    /** Authoritative shared Novig/ProphetX KYC status for the current managed wallet. */
+    getSharedKycStatus(): Promise<{
+        verified: boolean;
+    }>;
+    /** Start shared KYC; already-verified wallets need no redirect. Kalshi v2 is not applicable. */
     initiateKyc(venue: string, redirectUri: string): Promise<{
         status: string;
         kycUrl?: string;
@@ -4808,4 +4840,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 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, toChecksumAddress };
+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 AppTradingMode, 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, toChecksumAddress };

package/dist/index.d.ts

@@ -23,37 +23,14 @@ declare const VENUE_CHAIN_IDS: Partial<Record<Venue, number>>;
  * Re-activating a venue is therefore an intentional code change here rather
  * than a runtime configuration toggle.
  */
-declare const ACTIVE_VENUES: readonly [Venue.kalshi, Venue.polymarket, Venue.limitless, Venue.opinion, Venue.predict, Venue.probable, Venue.myriad, Venue.hyperliquid, Venue.novig];
+declare const ACTIVE_VENUES: readonly [Venue.kalshi, Venue.polymarket, Venue.limitless, Venue.opinion, Venue.predict, Venue.probable, Venue.myriad, Venue.hyperliquid, Venue.novig, Venue.prophetx];
 /**
- * Venues excluded from new user-facing activity. Kalshi and Novig have both
- * left this set — each is fully active (data + execution) — leaving ProphetX
- * as the only member.
- *
- * - `prophetx` — NOT YET LAUNCHED, and SANDBOX-ONLY: production `/auth/login`
- *   rejects our credentials, so every ProphetX row is sandbox data. It now has
- *   a live orderbook feed and a live aggKey extractor, so it DOES join
- *   cross-venue clusters and can reach `VenueEvent.arbReturn`, which is public
- *   and sortable. Membership here is therefore load-bearing rather than
- *   cosmetic, and it must not reach end users until real credentials exist.
- *   `PROPHET_X_DATA_VISIBLE=true` un-hides it on staging for API verification
- *   (see `dataVisibleVenues` in `@app/runtime-config`).
- *
- *   NOTE this set only applies where there is NO app context. An App row is
- *   authoritative, and its `disabledVenues` is stamped from this constant at
- *   CREATE time only — an app created before a venue joined this list keeps a
- *   list without it, and no restart repairs that (bootstrap deliberately does
- *   not clobber an existing row). Adding a venue here needs a one-time
- *   `UPDATE "App" SET "disabledVenues" = array_append(...)` to match.
- *
- * Membership here does NOT stop ingestion: the Rust engine gates discovery on
- * credentials, so Novig data keeps flowing into `VenueEvent`/`VenueMarket` and
- * keeps being matched. This set governs the API read layer and execution only.
- *
- * Global activity is separate from partner access: Novig remains in
- * DEFAULT_DISABLED_VENUES and is enabled only by a super-admin removing it
- * from one App.disabledVenues list.
+ * Venues excluded from new user-facing activity. The set is currently empty:
+ * ProphetX has discovery, live books, and a sandbox clearinghouse execution
+ * provider. Partner rollout is controlled separately through
+ * DEFAULT_DISABLED_VENUES and App.disabledVenues.
  */
-declare const INACTIVE_VENUES: readonly [Venue.prophetx];
+declare const INACTIVE_VENUES: readonly [];
 /** Whether a venue may participate in new user-facing activity. */
 declare function isVenueActive(venue: string): boolean;
 /** Whether a venue is intentionally retained only for wind-down/history flows. */
@@ -535,6 +512,21 @@ type UnifiedBalanceResponse = {
         portfolioValueCents?: number | undefined;
         updatedAt: string;
     }[];
+    /**
+     * Paper-account summary. Present only when the request resolved to paper
+     * mode; absent in a live response. Mirrors `UnifiedBalanceResponseSchemaTB`
+     * in `typebox/schemas/trading.ts` — keep the two in sync. All dollars.
+     */
+    paper?: {
+        startingBalance: number;
+        cashBalance: number;
+        positionsValue: number;
+        /** Banked P&L from closed trades — account-level, not summable from positions. */
+        realizedPnl: number;
+        unrealizedPnl: number;
+        /** realized + unrealized. */
+        earnings: number;
+    };
 };
 type UserHolding = {
     venue: Venue;
@@ -2021,11 +2013,24 @@ declare class AggWebSocket {
     private isOrderbookDebugEnabled;
 }
 
+/** App-level paper/live mode. An app is one or the other, never both. */
+type AppTradingMode = "live" | "paper";
 interface AppClientConfigResponse {
     disabledVenues: Venue[];
     disabledCategoryPresets: string[];
     earlyAccessEnabled: boolean;
     authOptions: AppClientAuthOption[];
+    /**
+     * Server-owned execution mode. Prefer this over any locally-configured
+     * `trading.executionMode` — the API enforces it regardless of what the
+     * client sends, and end users cannot change it.
+     */
+    tradingMode: AppTradingMode;
+    /**
+     * One-time simulated balance granted on first paper use, in dollars.
+     * Interpolate this into paper copy rather than hardcoding a figure.
+     */
+    paperStartingBalance: number;
 }
 interface VenueGeoPolicyEntry {
     venue: Venue;
@@ -3631,6 +3636,10 @@ interface SmartRouteFill {
 }
 /** Per-venue routing result with fills and chain info. */
 interface SmartRouteVenueFill {
+    /** CH executable price and normalized input, in micro-USDC. */
+    limitPriceMicroUsdc?: string;
+    inAmount?: string;
+    outAmount?: string;
     venue: string;
     venueMarketId: string;
     venueMarketOutcomeId: string;
@@ -3640,6 +3649,9 @@ interface SmartRouteVenueFill {
     noPrice: number;
     fills: SmartRouteFill[];
     venueQty: number;
+    /** Inclusive fee/reserve funding budget. For fee display, use the route's
+     * feeBreakdown.venueFees and executionReserve instead. */
+    venueFee?: number;
 }
 interface SmartRouteAllocation {
     sourceChainId: string;
@@ -3774,6 +3786,10 @@ interface SmartRouteSetupCostLine {
 interface SmartRouteFeeBreakdown {
     rawExecCost: number;
     venueFees: number;
+    /** Additional CH funding reserve for slippage or possible venue charges.
+     * Excluded from venueFees and totalCost; included in funding allocations.
+     * Only the unused portion is released after execution. */
+    executionReserve?: number;
     bridgeFees: number;
     executionGas: number;
     totalCost: number;
@@ -3913,6 +3929,12 @@ interface RedeemLegResult {
 }
 interface RedeemRequest {
     venueMarketOutcomeIds: string[];
+    /**
+     * Trading mode. Defaults to live, matching the other execution methods.
+     * Honoured on a live app; ignored on a paper app, which has no real-money
+     * path and always settles on paper.
+     */
+    mode?: ExecutionMode;
 }
 interface RedeemResponse {
     redeemId: string;
@@ -4185,7 +4207,7 @@ type UserAuthResult = {
     user: UserProfile;
 };
 declare class AggClient {
-    private appId?;
+    private _appId?;
     private adminKey?;
     private apiKey?;
     private baseUrl;
@@ -4243,6 +4265,12 @@ declare class AggClient {
     /** Clear the user access token, refresh token, and user info. Broadcasts cross-tab logout. */
     clearAccessToken(): void;
     private broadcastAuth;
+    /**
+     * The App this client speaks for, or `undefined` for an admin-key-only
+     * client. Exposed so callers can scope per-app caches by it — app config is
+     * app-scoped data, and two clients sharing one cache must not share entries.
+     */
+    get appId(): string | undefined;
     /** Current auth lifecycle status. */
     get authStatus(): AuthStatus;
     /** Whether a user access token is currently set. */
@@ -4677,7 +4705,11 @@ declare class AggClient {
     getRampQuotes(params: RampQuoteRequest): Promise<RampQuote[]>;
     /** Create a ramp widget session for checkout. */
     createRampSession(params: RampSessionRequest): Promise<RampWidgetSession>;
-    /** Initiate KYC verification for a venue. Returns a KYC URL to redirect the user to. */
+    /** Authoritative shared Novig/ProphetX KYC status for the current managed wallet. */
+    getSharedKycStatus(): Promise<{
+        verified: boolean;
+    }>;
+    /** Start shared KYC; already-verified wallets need no redirect. Kalshi v2 is not applicable. */
     initiateKyc(venue: string, redirectUri: string): Promise<{
         status: string;
         kycUrl?: string;
@@ -4808,4 +4840,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 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, toChecksumAddress };
+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 AppTradingMode, 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, toChecksumAddress };

package/dist/index.js

@@ -170,7 +170,8 @@ var VENUE_CHAIN_IDS = {
   ["predict" /* predict */]: 56,
   ["myriad" /* myriad */]: 56,
   ["hyperliquid" /* hyperliquid */]: 1337,
-  ["novig" /* novig */]: 792703809
+  ["novig" /* novig */]: 792703809,
+  ["prophetx" /* prophetx */]: 792703809
 };
 var ACTIVE_VENUES = [
   "kalshi" /* kalshi */,
@@ -181,9 +182,10 @@ var ACTIVE_VENUES = [
   "probable" /* probable */,
   "myriad" /* myriad */,
   "hyperliquid" /* hyperliquid */,
-  "novig" /* novig */
+  "novig" /* novig */,
+  "prophetx" /* prophetx */
 ];
-var INACTIVE_VENUES = ["prophetx" /* prophetx */];
+var INACTIVE_VENUES = [];
 var DEFAULT_DISABLED_VENUES = ["novig" /* novig */, "prophetx" /* prophetx */];
 var ACTIVE_VENUE_SET = new Set(ACTIVE_VENUES);
 var INACTIVE_VENUE_SET = new Set(INACTIVE_VENUES);
@@ -1990,21 +1992,21 @@ var AggClient = class {
     if (!options.appId && !options.adminKey) {
       throw new Error("AggClient requires at least one of appId or adminKey");
     }
-    this.appId = options.appId;
+    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;
-    this.storageKey = `agg_auth_${(_a = this.appId) != null ? _a : "default"}`;
+    this.storageKey = `agg_auth_${(_a = this._appId) != null ? _a : "default"}`;
     this.authDelivery = (_b = options.authDelivery) != null ? _b : "body";
     this.shouldPersistSession = options.persistSession !== false;
     this.restoreSession();
     this.initAuthChannel();
   }
   resolvePaperTradingAppId(appId) {
-    const resolvedAppId = appId != null ? appId : this.appId;
+    const resolvedAppId = appId != null ? appId : this._appId;
     if (!resolvedAppId) {
       throw new Error(
         "Paper trading account methods require appId in client options or method options"
@@ -2092,7 +2094,7 @@ var AggClient = class {
     var _a;
     if (typeof globalThis.BroadcastChannel === "undefined") return;
     try {
-      this.authChannel = new BroadcastChannel(`agg_auth_${(_a = this.appId) != null ? _a : "default"}`);
+      this.authChannel = new BroadcastChannel(`agg_auth_${(_a = this._appId) != null ? _a : "default"}`);
       this.authChannel.onmessage = (event) => {
         var _a2;
         const { type } = (_a2 = event.data) != null ? _a2 : {};
@@ -2153,8 +2155,8 @@ var AggClient = class {
   rawFetch(path, init) {
     return __async(this, null, function* () {
       const headers = (init == null ? void 0 : init.body) != null ? { "Content-Type": "application/json" } : {};
-      if (this.appId) {
-        headers["x-app-id"] = this.appId;
+      if (this._appId) {
+        headers["x-app-id"] = this._appId;
       }
       if (this.adminKey) {
         headers["x-admin-key"] = this.adminKey;
@@ -2293,6 +2295,14 @@ var AggClient = class {
     } catch (e) {
     }
   }
+  /**
+   * The App this client speaks for, or `undefined` for an admin-key-only
+   * client. Exposed so callers can scope per-app caches by it — app config is
+   * app-scoped data, and two clients sharing one cache must not share entries.
+   */
+  get appId() {
+    return this._appId;
+  }
   /** Current auth lifecycle status. */
   get authStatus() {
     return this._authStatus;
@@ -3305,7 +3315,7 @@ Issued At: ${issuedAt}`;
       throw new Error("AggClient.createWebSocket() requires wsUrl to be set in client options");
     }
     const url = new URL(this.wsUrl);
-    if (this.appId) url.searchParams.set("appId", this.appId);
+    if (this._appId) url.searchParams.set("appId", this._appId);
     return new AggWebSocket({
       url: url.toString(),
       callbacks,
@@ -3582,7 +3592,13 @@ Issued At: ${issuedAt}`;
       });
     });
   }
-  /** Initiate KYC verification for a venue. Returns a KYC URL to redirect the user to. */
+  /** Authoritative shared Novig/ProphetX KYC status for the current managed wallet. */
+  getSharedKycStatus() {
+    return __async(this, null, function* () {
+      return this.request("/kyc/status");
+    });
+  }
+  /** Start shared KYC; already-verified wallets need no redirect. Kalshi v2 is not applicable. */
   initiateKyc(venue, redirectUri) {
     return __async(this, null, function* () {
       return this.request(`/kyc/${venue}`, {

package/dist/index.mjs

@@ -38,7 +38,8 @@ var VENUE_CHAIN_IDS = {
   ["predict" /* predict */]: 56,
   ["myriad" /* myriad */]: 56,
   ["hyperliquid" /* hyperliquid */]: 1337,
-  ["novig" /* novig */]: 792703809
+  ["novig" /* novig */]: 792703809,
+  ["prophetx" /* prophetx */]: 792703809
 };
 var ACTIVE_VENUES = [
   "kalshi" /* kalshi */,
@@ -49,9 +50,10 @@ var ACTIVE_VENUES = [
   "probable" /* probable */,
   "myriad" /* myriad */,
   "hyperliquid" /* hyperliquid */,
-  "novig" /* novig */
+  "novig" /* novig */,
+  "prophetx" /* prophetx */
 ];
-var INACTIVE_VENUES = ["prophetx" /* prophetx */];
+var INACTIVE_VENUES = [];
 var DEFAULT_DISABLED_VENUES = ["novig" /* novig */, "prophetx" /* prophetx */];
 var ACTIVE_VENUE_SET = new Set(ACTIVE_VENUES);
 var INACTIVE_VENUE_SET = new Set(INACTIVE_VENUES);
@@ -1858,21 +1860,21 @@ var AggClient = class {
     if (!options.appId && !options.adminKey) {
       throw new Error("AggClient requires at least one of appId or adminKey");
     }
-    this.appId = options.appId;
+    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;
-    this.storageKey = `agg_auth_${(_a = this.appId) != null ? _a : "default"}`;
+    this.storageKey = `agg_auth_${(_a = this._appId) != null ? _a : "default"}`;
     this.authDelivery = (_b = options.authDelivery) != null ? _b : "body";
     this.shouldPersistSession = options.persistSession !== false;
     this.restoreSession();
     this.initAuthChannel();
   }
   resolvePaperTradingAppId(appId) {
-    const resolvedAppId = appId != null ? appId : this.appId;
+    const resolvedAppId = appId != null ? appId : this._appId;
     if (!resolvedAppId) {
       throw new Error(
         "Paper trading account methods require appId in client options or method options"
@@ -1960,7 +1962,7 @@ var AggClient = class {
     var _a;
     if (typeof globalThis.BroadcastChannel === "undefined") return;
     try {
-      this.authChannel = new BroadcastChannel(`agg_auth_${(_a = this.appId) != null ? _a : "default"}`);
+      this.authChannel = new BroadcastChannel(`agg_auth_${(_a = this._appId) != null ? _a : "default"}`);
       this.authChannel.onmessage = (event) => {
         var _a2;
         const { type } = (_a2 = event.data) != null ? _a2 : {};
@@ -2021,8 +2023,8 @@ var AggClient = class {
   rawFetch(path, init) {
     return __async(this, null, function* () {
       const headers = (init == null ? void 0 : init.body) != null ? { "Content-Type": "application/json" } : {};
-      if (this.appId) {
-        headers["x-app-id"] = this.appId;
+      if (this._appId) {
+        headers["x-app-id"] = this._appId;
       }
       if (this.adminKey) {
         headers["x-admin-key"] = this.adminKey;
@@ -2161,6 +2163,14 @@ var AggClient = class {
     } catch (e) {
     }
   }
+  /**
+   * The App this client speaks for, or `undefined` for an admin-key-only
+   * client. Exposed so callers can scope per-app caches by it — app config is
+   * app-scoped data, and two clients sharing one cache must not share entries.
+   */
+  get appId() {
+    return this._appId;
+  }
   /** Current auth lifecycle status. */
   get authStatus() {
     return this._authStatus;
@@ -3173,7 +3183,7 @@ Issued At: ${issuedAt}`;
       throw new Error("AggClient.createWebSocket() requires wsUrl to be set in client options");
     }
     const url = new URL(this.wsUrl);
-    if (this.appId) url.searchParams.set("appId", this.appId);
+    if (this._appId) url.searchParams.set("appId", this._appId);
     return new AggWebSocket({
       url: url.toString(),
       callbacks,
@@ -3450,7 +3460,13 @@ Issued At: ${issuedAt}`;
       });
     });
   }
-  /** Initiate KYC verification for a venue. Returns a KYC URL to redirect the user to. */
+  /** Authoritative shared Novig/ProphetX KYC status for the current managed wallet. */
+  getSharedKycStatus() {
+    return __async(this, null, function* () {
+      return this.request("/kyc/status");
+    });
+  }
+  /** Start shared KYC; already-verified wallets need no redirect. Kalshi v2 is not applicable. */
   initiateKyc(venue, redirectUri) {
     return __async(this, null, function* () {
       return this.request(`/kyc/${venue}`, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/sdk",
-  "version": "4.8.1",
+  "version": "4.9.2",
   "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",