@acta-markets/ts-sdk 0.0.1-beta

package/dist/ws/types.d.ts

@@ -0,0 +1,900 @@
+/**
+ * WebSocket protocol types for Acta RFQ server.
+ *
+ * Source of truth:
+ * - docs/state-machines-eng.md (protocol spec)
+ * - rust-backend/shared/src/types/ws.rs (as-built reference)
+ *
+ * Notes:
+ * - UUIDs are represented as strings in JSON.
+ * - Rust uses u64 in many places; we model them as `number` for now.
+ *   If/when we need precision beyond JS safe integer, we can migrate to `bigint | string`.
+ */
+import type { Address } from "@solana/addresses";
+export type UuidString = string;
+export type RequestId = string;
+export type PubkeyBase58 = string;
+export type SignatureBase58 = string;
+export type ErrorMessage = string;
+export type ErrorCode = string;
+export type AuthRequiredAction = string;
+export type UserRole = string;
+export type QuoteLockedReason = string;
+export type RfqStateError = string;
+export type RateLimitReason = string;
+export type DbFeature = string;
+export type WsU64 = number;
+export type WsU32 = number;
+export type WsI64 = number;
+/** Values: "pending" | "submitted" | "confirmed" | "failed" | "not_found". */
+export type OrderStatusValue = string;
+/** Values: "active" | "pending_signature" | "enqueued". */
+export type MyActiveRfqState = string;
+/** Values: "quote_expired". */
+export type HelloFeatureFlag = string;
+/** Values: "covered_call" | "cash_secured_put". */
+export type PositionType = string;
+/** Values: "none" | "open" | "funded" | "liquidated" | "settled". */
+export type PositionStatus = string;
+/** Values: "pending" | "best" | "outbid" | "filled" | "expired". */
+export type MakerQuoteStatus = string;
+/** Values: "expired" | "expiring_soon". */
+export type QuoteRefreshReason = string;
+/** Values: "requested" | "risk_check" | "rfq_accepted". */
+export type QuoteCancelledReason = string;
+/** Values: "valid_until_passed" | "rfq_expired" | "rfq_cancelled". */
+export type QuoteExpiredReason = string;
+/** Values: "signature_timeout" | "tx_failed". */
+export type RfqAvailableAgainReason = string;
+/** 32-byte orderId encoded as 64-char hex string. */
+export type OrderIdHex32 = string;
+/** Values: "stats" | "rfqs" | "trades" | "positions" | "chain_events" | "markets". */
+export type WsChannel = string;
+export type ProtocolVersion = string;
+export type HelloMessage = {
+    protocol_version: ProtocolVersion;
+    features: HelloFeatureFlag[];
+    client_name?: string;
+    client_version?: string;
+};
+export type WelcomeMessage = {
+    protocol_version: ProtocolVersion;
+    server_version: string;
+    min_supported_version: string;
+    enabled_features: HelloFeatureFlag[];
+    server_time_unix_ms?: WsU64;
+};
+export type VersionMismatchMessage = {
+    requested_version: ProtocolVersion;
+    server_version: ProtocolVersion;
+    min_supported_version: ProtocolVersion;
+    message: ErrorMessage;
+};
+export type ClientMessage = {
+    type: "Hello";
+    data: HelloMessage;
+} | {
+    type: "StartAuth";
+    data: {
+        pubkey: string;
+    };
+} | {
+    type: "AuthChallenge";
+    data: AuthChallengeData;
+} | {
+    type: "Quote";
+    data: QuoteMessage;
+} | {
+    type: "CancelQuote";
+    data: {
+        rfq_id: UuidString;
+    };
+} | {
+    type: "IndicativePricesResponse";
+    data: IndicativePricesResponseMessage;
+} | {
+    type: "RfqRequest";
+    data: RfqRequestMessage;
+} | {
+    type: "AcceptQuote";
+    data: AcceptQuoteMessage;
+} | {
+    type: "SubmitSignedSponsoredTx";
+    data: {
+        order_id: OrderIdHex32;
+        tx_base64: string;
+    };
+} | {
+    type: "CancelRfq";
+    data: {
+        rfq_id: UuidString;
+    };
+} | {
+    type: "GetIndicativePrices";
+    data: GetIndicativePricesMessage;
+} | {
+    type: "GetPositions";
+} | {
+    type: "GetMarkets";
+} | {
+    type: "GetMarketDescriptors";
+    data: GetMarketDescriptorsMessage;
+} | {
+    type: "GetExpiries";
+    data: GetExpiriesMessage;
+} | {
+    type: "GetTokens";
+    data: GetTokensMessage;
+} | {
+    type: "GetMyActiveRfqs";
+} | {
+    type: "GetOrderStatus";
+    data: GetOrderStatusMessage;
+} | {
+    type: "GetActiveRfqs";
+} | {
+    type: "GetMakerPositions";
+    data: GetMakerPositionsMessage;
+} | {
+    type: "GetMyQuotes";
+    data: GetMyQuotesMessage;
+} | {
+    type: "GetMarketsForMaker";
+    data: GetMarketsForMakerMessage;
+} | {
+    type: "GetMakerBalances";
+} | {
+    type: "GetSubscriptions";
+} | {
+    type: "CancelAllQuotes";
+    data: CancelAllQuotesMessage;
+} | {
+    type: "Ping";
+} | {
+    type: "Subscribe";
+    data: {
+        channels: WsChannel[];
+        markets?: string[];
+    };
+} | {
+    type: "Unsubscribe";
+    data: {
+        channels: WsChannel[];
+    };
+};
+export type GetMarketDescriptorsMessage = {
+    active_only?: boolean;
+};
+export type GetTokensMessage = {
+    active_only?: boolean;
+};
+export type GetExpiriesMessage = {
+    underlying_mint?: Address<string>;
+    quote_mint?: Address<string>;
+    is_put?: boolean | null;
+};
+export type GetOrderStatusMessage = {
+    order_id: OrderIdHex32;
+};
+export type GetMakerPositionsMessage = {
+    market?: string;
+    underlying_mint?: string;
+    status?: string[];
+    min_expiry_ts?: WsU64;
+};
+export type GetMyQuotesMessage = {
+    active_only?: boolean;
+};
+export type GetMarketsForMakerMessage = {
+    underlying_mints?: string[];
+    quote_mints?: string[];
+    min_expiry_ts?: WsU64;
+    max_expiry_ts?: WsU64;
+    is_put?: boolean;
+    include_stats?: boolean;
+};
+export type CancelAllQuotesMessage = {
+    market?: string;
+};
+export type AuthChallengeData = {
+    /** Human-readable SIWS-style challenge text (sign UTF-8 bytes of this string). */
+    challenge: string;
+    signature: string;
+    pubkey: string;
+};
+export type QuoteMessage = {
+    rfq_id: UuidString;
+    /** Strike for this quote (must be one of server-provided strike options when present). */
+    strike: WsU64;
+    price: WsU64;
+    valid_until: WsU64;
+    /** u64 nonce (little-endian on-chain) used in the orderId preimage. */
+    nonce: WsU64;
+    /** 32-byte orderId (sha256) encoded as hex (64 chars). */
+    order_id: OrderIdHex32;
+    signature: string;
+};
+export type MarketDescriptor = {
+    chain_id: WsU64;
+    program_id: Address<string>;
+    market_pda: Address<string>;
+    underlying_mint: Address<string>;
+    quote_mint: Address<string>;
+    expiry_ts: WsU64;
+    is_put: boolean;
+    collateral_mint: Address<string>;
+    settlement_mint: Address<string>;
+};
+export type RfqRequestMessage = {
+    market: Address<string>;
+    position_type: PositionType;
+    strike: WsU64;
+    quantity: WsU64;
+    timeout_seconds: WsU32;
+    /** Optional idempotency key; echoed back in RfqCreated. */
+    client_request_id?: RequestId;
+};
+export type AcceptQuoteMessage = {
+    rfq_id: UuidString;
+    maker: Address<string>;
+    /** 32-byte orderId (sha256) encoded as hex (64 chars). */
+    order_id: OrderIdHex32;
+};
+export type ServerMessage = {
+    type: "Welcome";
+    data: WelcomeMessage;
+} | {
+    type: "VersionMismatch";
+    data: VersionMismatchMessage;
+} | {
+    type: "AuthRequest";
+    data: {
+        challenge: string;
+    };
+} | {
+    type: "AuthSuccess";
+    data: {
+        session_id: string;
+    };
+} | {
+    type: "AuthError";
+    data: {
+        reason: ErrorMessage;
+    };
+} | {
+    type: "RfqCreated";
+    data: RfqCreatedMessage;
+} | {
+    type: "RfqBroadcast";
+    data: RfqBroadcastMessage;
+} | {
+    type: "QuoteReceived";
+    data: QuoteReceivedMessage;
+} | {
+    type: "QuotesUpdate";
+    data: QuotesUpdateMessage;
+} | {
+    type: "QuoteRefreshRequested";
+    data: QuoteRefreshRequestedMessage;
+} | {
+    type: "IndicativePricesRequest";
+    data: IndicativePricesRequestMessage;
+} | {
+    type: "IndicativePrices";
+    data: IndicativePricesMessage;
+} | {
+    type: "QuoteAcknowledged";
+    data: QuoteAcknowledgedMessage;
+} | {
+    type: "QuoteBestStatus";
+    data: QuoteBestStatusMessage;
+} | {
+    type: "QuoteOutbid";
+    data: QuoteOutbidMessage;
+} | {
+    type: "QuoteSelected";
+    data: QuoteSelectedMessage;
+} | {
+    type: "QuoteFilled";
+    data: QuoteFilledMessage;
+} | {
+    type: "QuoteCancelled";
+    data: QuoteCancelledMessage;
+} | {
+    type: "RfqAvailableAgain";
+    data: RfqAvailableAgainMessage;
+} | {
+    type: "RfqClosed";
+    data: RfqClosedMessage;
+} | {
+    type: "QuoteExpired";
+    data: QuoteExpiredMessage;
+} | {
+    type: "ActiveRfqs";
+    data: {
+        rfqs: ActiveRfqInfo[];
+    };
+} | {
+    type: "MakerPositions";
+    data: MakerPositionsMessage;
+} | {
+    type: "MyQuotes";
+    data: MyQuotesMessage;
+} | {
+    type: "MakerMarkets";
+    data: MakerMarketsMessage;
+} | {
+    type: "MakerBalances";
+    data: MakerBalancesMessage;
+} | {
+    type: "Subscriptions";
+    data: SubscriptionsMessage;
+} | {
+    type: "OrderAccepted";
+    data: {
+        order_id: OrderIdHex32;
+    };
+} | {
+    type: "SponsoredTxToSign";
+    data: {
+        order_id: OrderIdHex32;
+        tx_base64: string;
+        signature_deadline: WsU64;
+    };
+} | {
+    type: "OrderSubmitted";
+    data: {
+        order_id: OrderIdHex32;
+        tx_signature: string;
+        order_version: WsU64;
+    };
+} | {
+    type: "OrderConfirmed";
+    data: {
+        order_id: OrderIdHex32;
+        position_pda: string;
+        order_version: WsU64;
+    };
+} | {
+    type: "OrderFailed";
+    data: {
+        order_id: OrderIdHex32;
+        reason: ErrorMessage;
+        order_version: WsU64;
+    };
+} | {
+    type: "MarketCreated";
+    data: MarketInfo;
+} | {
+    type: "MarketFinalized";
+    data: {
+        market_pda: string;
+        settlement_price: WsU64;
+    };
+} | {
+    type: "ChainEvent";
+    data: ChainEventMessage;
+} | {
+    type: "Snapshot";
+    data: SnapshotMessage;
+} | {
+    type: "MyActiveRfqs";
+    data: MyActiveRfqsMessage;
+} | {
+    type: "OrderStatus";
+    data: OrderStatusMessage;
+} | {
+    type: "Positions";
+    data: PositionsMessage;
+} | {
+    type: "Markets";
+    data: MarketsMessage;
+} | {
+    type: "MarketDescriptors";
+    data: MarketDescriptorsMessage;
+} | {
+    type: "Expiries";
+    data: ExpiriesMessage;
+} | {
+    type: "Tokens";
+    data: TokensMessage;
+} | {
+    type: "TradeExecuted";
+    data: TradeExecutedMessage;
+} | {
+    type: "PositionUpdated";
+    data: PositionUpdatedMessage;
+} | {
+    type: "StatsUpdate";
+    data: StatsUpdateMessage;
+} | {
+    type: "Pong";
+    data: {
+        server_time_unix_ms: WsU64;
+    };
+} | {
+    type: "Error";
+    data: ServerError;
+};
+export type MarketDescriptorInfo = {
+    market: MarketDescriptor;
+    underlying_oracle_pda: PubkeyBase58;
+    quote_oracle_pda: PubkeyBase58;
+    underlying_decimals: number;
+    quote_decimals: number;
+    underlying_symbol?: string;
+    quote_symbol?: string;
+};
+export type TokenInfo = {
+    mint: Address<string>;
+    decimals: number;
+    symbol?: string;
+};
+export type RfqCreatedMessage = {
+    rfq_id: UuidString;
+    rfq_version: WsU64;
+    client_request_id?: RequestId;
+    expires_at: WsU64;
+    created_at: WsU64;
+    /** Server-defined order options (strike inventory). */
+    order_options?: RfqOrderOption[];
+};
+export type QuoteRefreshRequestedMessage = {
+    rfq_id: UuidString;
+    strike: WsU64;
+    /** The backend is asking the maker to produce a quote with valid_until >= min_valid_until. */
+    min_valid_until: WsU64;
+    reason: QuoteRefreshReason;
+};
+export type ServerError = {
+    type: "unauthenticated";
+    data: {
+        action: AuthRequiredAction;
+    };
+} | {
+    type: "unauthorized";
+    data: {
+        role: UserRole;
+        action: AuthRequiredAction;
+    };
+} | {
+    type: "rfq_not_found";
+} | {
+    type: "rfq_not_active";
+} | {
+    type: "invalid_state";
+    data: {
+        state: RfqStateError;
+    };
+} | {
+    type: "quote_locked";
+    data: {
+        reason: QuoteLockedReason;
+    };
+} | {
+    type: "quote_not_found";
+} | {
+    type: "quote_expired";
+} | {
+    type: "invalid_strike";
+} | {
+    type: "invalid_valid_until";
+} | {
+    type: "order_id_mismatch";
+} | {
+    type: "signature_timeout";
+} | {
+    type: "oracle_not_ready";
+} | {
+    type: "oracle_price_stale";
+    data: {
+        age_seconds: WsU64;
+    };
+} | {
+    type: "oracle_price_not_ready";
+} | {
+    type: "invalid_position_type";
+} | {
+    type: "invalid_market";
+    data: {
+        pubkey: string;
+    };
+} | {
+    type: "market_metadata_incomplete";
+    data: {
+        details: string;
+    };
+} | {
+    type: "token_metadata_incomplete";
+    data: {
+        details: string;
+    };
+} | {
+    type: "rate_limit";
+    data: RateLimitReason;
+} | {
+    type: "internal_error";
+} | {
+    type: "kernel_not_available";
+} | {
+    type: "db_disabled";
+    data: {
+        feature: DbFeature;
+    };
+} | {
+    type: "server_shutting_down";
+} | {
+    type: "generic";
+    data: {
+        code: ErrorCode;
+        message: ErrorMessage;
+    };
+};
+/** Confirms quote was received and validated. */
+export type QuoteAcknowledgedMessage = {
+    rfq_id: UuidString;
+    order_id: OrderIdHex32;
+    /** Present if this quote replaced a previous quote for the same RFQ. */
+    replaced_order_id?: OrderIdHex32;
+};
+/** Indicates whether your quote is currently the best (highest price). */
+export type QuoteBestStatusMessage = {
+    rfq_id: UuidString;
+    order_id: OrderIdHex32;
+    is_best: boolean;
+    current_best_price?: WsU64;
+};
+/** Your quote was outbid by another maker. */
+export type QuoteOutbidMessage = {
+    rfq_id: UuidString;
+    order_id: OrderIdHex32;
+    /** Your quoted price. Competitor's price is NOT disclosed. */
+    your_price: WsU64;
+    current_best_price?: WsU64;
+};
+/** Your quote was selected by the taker. */
+export type QuoteSelectedMessage = {
+    rfq_id: UuidString;
+    order_id: OrderIdHex32;
+    taker: PubkeyBase58;
+    price: WsU64;
+    quantity: WsU64;
+    strike: WsU64;
+    signature_deadline: WsU64;
+};
+/** Your quote was selected and executed on-chain. */
+export type QuoteFilledMessage = {
+    rfq_id: UuidString;
+    order_id: OrderIdHex32;
+    taker: PubkeyBase58;
+    price: WsU64;
+    quantity: WsU64;
+    strike: WsU64;
+    position_pda: PubkeyBase58;
+    tx_signature: SignatureBase58;
+    filled_at: WsU64;
+};
+/** Server removed your quote(s) for this RFQ. */
+export type QuoteCancelledMessage = {
+    rfq_id: UuidString;
+    order_ids: OrderIdHex32[];
+    reason: QuoteCancelledReason;
+    cancelled_at: WsU64;
+};
+/** Values: "expired" | "taker_cancelled" | "filled" | "market_expired" | "ladder_timeout". */
+export type RfqClosedReason = string;
+/** Values: "expired" | "outbid" | "cancelled" | "filled". */
+export type QuoteFinalStatus = string;
+/** RFQ terminal event. */
+export type RfqClosedMessage = {
+    rfq_id: UuidString;
+    rfq_version: WsU64;
+    reason: RfqClosedReason;
+    your_quote?: {
+        order_id: OrderIdHex32;
+        status: QuoteFinalStatus;
+        price: WsU64;
+    } | null;
+    winner?: {
+        maker: PubkeyBase58;
+        price: WsU64;
+        tx_signature?: SignatureBase58;
+    } | null;
+    closed_at: WsU64;
+};
+/** RFQ is available again (selected quote failed/expired). */
+export type RfqAvailableAgainMessage = {
+    rfq_id: UuidString;
+    rfq_version: WsU64;
+    /** Reason: "signature_timeout" | "tx_failed" */
+    reason: RfqAvailableAgainReason;
+    /** When the RFQ became available again (unix seconds). */
+    available_again_at: WsU64;
+};
+/** Your quote expired. */
+export type QuoteExpiredMessage = {
+    rfq_id: UuidString;
+    order_id: OrderIdHex32;
+    reason: QuoteExpiredReason;
+};
+export type MakerPositionsMessage = {
+    positions: MakerPositionInfo[];
+};
+export type MakerPositionInfo = {
+    pda: string;
+    market: string;
+    position_type: PositionType;
+    status: PositionStatus;
+    strike: WsU64;
+    quantity: WsU64;
+    price: WsU64;
+    collateral_locked: WsU64;
+    created_at: WsU64;
+    expiry_ts: WsU64;
+};
+export type MyQuotesMessage = {
+    quotes: MakerQuoteInfo[];
+};
+export type MakerQuoteInfo = {
+    rfq_id: UuidString;
+    order_id: OrderIdHex32;
+    market: string;
+    strike: WsU64;
+    price: WsU64;
+    quantity: WsU64;
+    valid_until: WsU64;
+    /** "pending" | "best" | "outbid" | "filled" | "expired" | "cancelled" */
+    status: MakerQuoteStatus;
+    created_at: WsU64;
+};
+export type MakerMarketsMessage = {
+    markets: MakerMarketInfo[];
+};
+export type MakerMarketInfo = {
+    market_pda: string;
+    underlying_mint: string;
+    quote_mint: string;
+    expiry_ts: WsU64;
+    is_put: boolean;
+    is_finalized: boolean;
+    underlying_symbol?: string;
+    quote_symbol?: string;
+    stats?: MarketStats;
+};
+export type MarketStats = {
+    volume_24h: WsU64;
+    trades_24h: WsU32;
+};
+export type MakerBalancesMessage = {
+    balances_by_mint: Record<string, MakerMintBalance>;
+};
+export type MakerMintBalance = {
+    total: WsU64;
+    locked_as_collateral: WsU64;
+    available: WsU64;
+};
+export type SubscriptionsMessage = {
+    channels: WsChannel[];
+    markets?: string[];
+};
+export type IndicativePricesRequestMessage = {
+    request_id: RequestId;
+    market: MarketDescriptor;
+    position_type: PositionType;
+    strikes: WsU64[];
+};
+export type IndicativePricesResponseMessage = {
+    request_id: RequestId;
+    market: Address<string>;
+    position_type: PositionType;
+    prices: Array<{
+        strike: WsU64;
+        price: WsU64;
+    }>;
+};
+export type GetIndicativePricesMessage = {
+    market: Address<string>;
+    position_type: PositionType;
+};
+export type IndicativePricesMessage = {
+    market: Address<string>;
+    position_type: PositionType;
+    updated_at: WsU64;
+    is_stale: boolean;
+    strikes: Array<{
+        strike: WsU64;
+        best_price?: WsU64 | null;
+    }>;
+};
+export type RfqBroadcastMessage = {
+    rfq_id: UuidString;
+    market: MarketDescriptor;
+    position_type: PositionType;
+    /** RFQ base strike (informational/reference). */
+    strike: WsU64;
+    quantity: WsU64;
+    expires_at: WsU64;
+    taker: Address<string>;
+    /**
+     * Server-defined order options (strike inventory).
+     * Makers must quote only these strikes.
+     */
+    order_options: RfqOrderOption[];
+};
+export type QuoteReceivedMessage = {
+    rfq_id: UuidString;
+    strike: WsU64;
+    maker: Address<string>;
+    price: WsU64;
+    valid_until: WsU64;
+    /** u64 nonce used in the orderId preimage. */
+    nonce: WsU64;
+    /** Order ID hex string (64 chars). */
+    order_id: OrderIdHex32;
+};
+export type QuotesUpdateMessage = {
+    rfq_id: UuidString;
+    quotes: QuoteReceivedMessage[];
+};
+export type PositionsMessage = {
+    positions: PositionInfo[];
+};
+export type MarketsMessage = {
+    markets: MarketInfo[];
+};
+export type MarketDescriptorsMessage = {
+    markets: MarketDescriptorInfo[];
+};
+export type ExpiriesMessage = {
+    expiries_ts: WsU64[];
+};
+export type TokensMessage = {
+    underlyings: TokenInfo[];
+    quotes_by_underlying: Record<Address<string>, TokenInfo[]>;
+};
+export type SnapshotMessage = {
+    stats: GlobalStats;
+    active_rfqs: ActiveRfqInfo[];
+    positions?: PositionInfo[];
+    recent_trades?: TradeInfo[];
+    markets: MarketInfo[];
+};
+export type MyActiveRfqsMessage = {
+    rfqs: MyActiveRfqInfo[];
+};
+export type OrderStatusMessage = {
+    order_id: OrderIdHex32;
+    status: OrderStatusValue;
+    rfq_id?: UuidString | null;
+    tx_signature?: string | null;
+    position_pda?: string | null;
+    error_reason?: string | null;
+};
+export type GlobalStats = {
+    total_volume_24h: WsU64;
+    total_trades_24h: WsU32;
+    total_price_24h: WsU64;
+    active_markets: WsU32;
+    active_makers: WsU32;
+    active_rfqs: WsU32;
+};
+export type ActiveRfqInfo = {
+    rfq_id: UuidString;
+    market: string;
+    position_type: PositionType;
+    strike: WsU64;
+    quantity: WsU64;
+    expires_at: WsU64;
+    quotes_count: WsU32;
+    /** Best (highest) quoted price observed for this RFQ. */
+    best_price: WsU64 | null;
+    order_options: RfqOrderOption[];
+};
+export type MyActiveRfqInfo = {
+    rfq_id: UuidString;
+    market: string;
+    position_type: PositionType;
+    strike: WsU64;
+    quantity: WsU64;
+    state: MyActiveRfqState;
+    locked_order_id?: OrderIdHex32 | null;
+    expires_at: WsU64;
+    quotes_count: WsU32;
+    best_price?: WsU64 | null;
+};
+export type RfqOrderOption = {
+    strike: WsU64;
+};
+export type PositionInfo = {
+    pda: string;
+    market: string;
+    position_type: PositionType;
+    status: PositionStatus;
+    strike: WsU64;
+    quantity: WsU64;
+    price: WsU64;
+    created_at: WsU64;
+};
+export type TradeInfo = {
+    id: UuidString;
+    market: string;
+    position_type: PositionType;
+    strike: WsU64;
+    quantity: WsU64;
+    price: WsU64;
+    taker: string;
+    maker: string;
+    tx_signature: string;
+    executed_at: WsU64;
+};
+export type MarketInfo = {
+    pda: string;
+    underlying: string;
+    quote: string;
+    expiry_ts: WsU64;
+    is_put: boolean;
+};
+export type TradeExecutedMessage = {
+    trade: TradeInfo;
+    stats_delta?: StatsDelta | null;
+};
+export type PositionUpdatedMessage = {
+    position: PositionInfo;
+    update_type: PositionUpdateType;
+};
+/** Values: "created" | "funded" | "settled" | "liquidated". */
+export type PositionUpdateType = string;
+export type StatsUpdateMessage = {
+    stats: GlobalStats;
+};
+export type StatsDelta = {
+    volume_added?: WsU64 | null;
+    trades_added?: WsU32 | null;
+    price_added?: WsU64 | null;
+};
+export type ChainEventMessage = {
+    event_type: "PositionOpened";
+    signature: string;
+    slot: WsU64;
+    market: string;
+    maker: string;
+    taker: string;
+    position_type: PositionType;
+    strike: WsU64;
+    quantity: WsU64;
+    price: WsU64;
+    /** 32-byte orderId (sha256) encoded as hex (64 chars). */
+    order_id: OrderIdHex32;
+} | {
+    event_type: "MarketCreated";
+    signature: string;
+    slot: WsU64;
+    market: string;
+    underlying_mint: string;
+    quote_mint: string;
+    expiry_ts: WsU64;
+    is_put: boolean;
+} | {
+    event_type: "MarketFinalized";
+    signature: string;
+    slot: WsU64;
+    market: string;
+    settlement_price: WsU64;
+} | {
+    event_type: "MakerRegistered";
+    signature: string;
+    slot: WsU64;
+    owner: string;
+    maker_pda: string;
+    quote_signing: string;
+} | {
+    event_type: "PositionSettled";
+    signature: string;
+    slot: WsU64;
+    position: string;
+} | {
+    event_type: "PositionLiquidated";
+    signature: string;
+    slot: WsU64;
+    position: string;
+};