@gala-chain/launchpad-sdk 9.0.0-rc.0 → 9.0.0-rc.2

package/dist/services/realtime/event-catalog.d.ts

@@ -0,0 +1,456 @@
+/**
+ * The realtime event catalog: the one table the StreamWebSocketService routes by.
+ *
+ * - {@link STREAM_EVENTS}: the wire names (what the client emits, what the server emits).
+ * - {@link EVENT_ROUTES}: every event the server emits, with how a duplicate is recognised.
+ *   It is typed against {@link RealtimeEventPayloads}, so an event added to the payload map without a route
+ *   (or the reverse) does not compile.
+ * - the room-scoped event lists: which events a token room, a comment room and the global feed deliver.
+ * - the callback-object tables ({@link StreamEventCallbacks}, {@link GlobalFeedEventCallbacks}): one
+ *   `onX` key per event, so the object form of subscribing is the same registry as the method form.
+ *
+ * @category WebSocket
+ * @since 9.0.0
+ */
+import type { SiteConfigState } from '../../types/global-feed.dto';
+import type { RealtimeEventName, RealtimeEventPayloads } from '../../types/realtime-events.dto';
+/**
+ * Stream event names used by the backend.
+ *
+ * Client to server names are snake_case (`@SubscribeMessage` handlers); server to client names are
+ * SCREAMING_CASE, except the acknowledgements and the connection events, which are lowercase.
+ */
+export declare const STREAM_EVENTS: {
+    readonly SUBSCRIBE: "subscribe_token";
+    readonly UNSUBSCRIBE: "unsubscribe_token";
+    readonly SUBSCRIBE_COMMENT: "subscribe_comment";
+    readonly UNSUBSCRIBE_COMMENT: "unsubscribe_comment";
+    readonly SUBSCRIBE_GLOBAL_FEED: "subscribe_global_feed";
+    readonly UNSUBSCRIBE_GLOBAL_FEED: "unsubscribe_global_feed";
+    readonly SUBSCRIBE_EVENTS_FIREHOSE: "subscribe_events_firehose";
+    readonly UNSUBSCRIBE_EVENTS_FIREHOSE: "unsubscribe_events_firehose";
+    readonly AUTHENTICATE: "authenticate";
+    readonly SEND_CHAT: "send_stream_chat";
+    readonly SEND_REACTION: "SEND_STREAM_REACTION";
+    readonly TYPING_START: "typing_start";
+    readonly TYPING_STOP: "typing_stop";
+    readonly STREAM_STATUS: "STREAM_STATUS";
+    readonly RECORDING_STATUS: "RECORDING_STATUS";
+    readonly RECORDINGS_COUNT_UPDATED: "RECORDINGS_COUNT_UPDATED";
+    readonly SIMULCAST_STATUS: "SIMULCAST_STATUS";
+    readonly DOWNLOAD_READY: "DOWNLOAD_READY";
+    readonly STREAM_COUNTDOWN_UPDATED: "STREAM_COUNTDOWN_UPDATED";
+    readonly STREAM_LANGUAGE_UPDATED: "STREAM_LANGUAGE_UPDATED";
+    readonly VIEWER_COUNT: "VIEWER_COUNT";
+    readonly STREAM_CONTROL_STATUS_CHANGED: "STREAM_CONTROL_STATUS_CHANGED";
+    readonly STREAM_GLOBAL_STATUS: "STREAM_GLOBAL_STATUS";
+    readonly ENGAGEMENT_STATS_UPDATED: "ENGAGEMENT_STATS_UPDATED";
+    readonly CHAT_MESSAGE: "STREAM_CHAT_MESSAGE";
+    readonly CHAT_SENT: "STREAM_CHAT_SENT";
+    readonly CHAT_UPDATED: "STREAM_CHAT_UPDATED";
+    readonly CHAT_DELETED: "STREAM_CHAT_DELETED";
+    readonly CHAT_PINNED: "STREAM_CHAT_PINNED";
+    readonly CHAT_UNPINNED: "STREAM_CHAT_UNPINNED";
+    readonly CHAT_STATUS: "CHAT_STATUS_CHANGED";
+    readonly SLOW_MODE_CHANGED: "SLOW_MODE_CHANGED";
+    readonly CHAT_GLOBAL_STATUS: "STREAM_CHAT_GLOBAL_STATUS";
+    readonly USER_TYPING: "USER_TYPING";
+    readonly CHAT_ERROR: "stream_chat_error";
+    readonly REACTION: "STREAM_REACTION";
+    readonly REACTION_ERROR: "stream_reaction_error";
+    readonly CONTENT_REACTION_ADDED: "CONTENT_REACTION_ADDED";
+    readonly CONTENT_REACTION_REMOVED: "CONTENT_REACTION_REMOVED";
+    readonly COMMENT_CREATED: "COMMENT_CREATED";
+    readonly COMMENT_UPDATED: "COMMENT_UPDATED";
+    readonly COMMENT_DELETED: "COMMENT_DELETED";
+    readonly TRADE_EXECUTED: "TRADE_EXECUTED";
+    readonly TRADE_UPDATE_NOTIFY: "TRADE_UPDATE_NOTIFY";
+    readonly BALANCE_UPDATED: "BALANCE_UPDATED";
+    readonly STATS_UPDATED: "STATS_UPDATED";
+    readonly USER_BANNED: "USER_BANNED";
+    readonly USER_UNBANNED: "USER_UNBANNED";
+    readonly BAN_ENFORCEMENT: "BAN_ENFORCEMENT";
+    readonly TOKEN_BANNED: "TOKEN_BANNED";
+    readonly TOKEN_UNBANNED: "TOKEN_UNBANNED";
+    readonly CONTENT_FLAGGED: "CONTENT_FLAGGED";
+    readonly FLAG_RESOLVED: "FLAG_RESOLVED";
+    readonly AI_MODERATION_COMPLETE: "AI_MODERATION_COMPLETE";
+    readonly AI_MODERATION_FAILED: "AI_MODERATION_FAILED";
+    readonly MODERATOR_INVITE_CREATED: "MODERATOR_INVITE_CREATED";
+    readonly MODERATOR_ADDED: "MODERATOR_ADDED";
+    readonly MODERATOR_REMOVED: "MODERATOR_REMOVED";
+    readonly MODERATOR_ROLE_UPDATED: "MODERATOR_ROLE_UPDATED";
+    readonly OVERSEER_ADDED: "OVERSEER_ADDED";
+    readonly OVERSEER_REMOVED: "OVERSEER_REMOVED";
+    readonly POOL_CREATED: "POOL_CREATED";
+    readonly POOL_METADATA_UPDATED: "POOL_METADATA_UPDATED";
+    readonly POOL_SOCIAL_LINKS_UPDATED: "POOL_SOCIAL_LINKS_UPDATED";
+    readonly POOL_BADGE_ASSIGNED: "POOL_BADGE_ASSIGNED";
+    readonly TOKEN_CONFIG_UPDATED: "TOKEN_CONFIG_UPDATED";
+    readonly HOLDER_COUNT_UPDATED: "HOLDER_COUNT_UPDATED";
+    readonly USER_PROFILE_UPDATED: "USER_PROFILE_UPDATED";
+    readonly API_KEY_CREATED: "API_KEY_CREATED";
+    readonly API_KEY_UPDATED: "API_KEY_UPDATED";
+    readonly API_KEY_REVOKED: "API_KEY_REVOKED";
+    readonly SITE_CONFIG_CHANGED: "SITE_CONFIG_CHANGED";
+    readonly COMMENTS_GLOBAL_STATUS: "COMMENTS_GLOBAL_STATUS";
+    readonly WEBHOOKS_GLOBAL_STATUS: "WEBHOOKS_GLOBAL_STATUS";
+    readonly AI_MODERATION_GLOBAL_STATUS: "AI_MODERATION_GLOBAL_STATUS";
+    readonly EVENT: "EVENT";
+    readonly CONNECTION: "connection";
+    readonly CHAT_AUTHENTICATED: "authenticated";
+    readonly CHAT_AUTH_ERROR: "stream_chat_auth_error";
+    readonly EXCEPTION: "exception";
+    readonly STREAM_SUBSCRIBED: "token_subscribed";
+    readonly STREAM_UNSUBSCRIBED: "token_unsubscribed";
+    readonly ROOM_SUBSCRIBED: "room_subscribed";
+    readonly ROOM_LEFT: "room_left";
+    readonly GLOBAL_FEED_SUBSCRIBED: "global_feed_subscribed";
+    readonly GLOBAL_FEED_UNSUBSCRIBED: "global_feed_unsubscribed";
+    readonly EVENTS_FIREHOSE_SUBSCRIBED: "events_firehose_subscribed";
+    readonly EVENTS_FIREHOSE_UNSUBSCRIBED: "events_firehose_unsubscribed";
+};
+/**
+ * How one incoming event is routed.
+ */
+export interface EventRoute {
+    /**
+     * Where the event's token comes from. `'payload'` (default): `payload.tokenName`; `'room'`: the
+     * `token:{name}` in `payload.room`; `'none'`: the event is not about one token.
+     */
+    readonly token?: 'payload' | 'room' | 'none';
+    /**
+     * The backend sends this event through two rooms a client can be in at once (and the room-exclusion it
+     * uses does not cover that pair): the key names one occurrence, and a second occurrence with the same
+     * key within {@link DUPLICATE_WINDOW_MS} is dropped.
+     */
+    readonly duplicateKey?: (payload: Record<string, unknown>) => string | undefined;
+}
+/** How long a second copy of the same occurrence is recognised as a duplicate. */
+export declare const DUPLICATE_WINDOW_MS = 5000;
+/**
+ * Every event the server emits and how it is routed. Absent fields mean the default: the token is
+ * `payload.tokenName`, and an occurrence arrives once.
+ */
+export declare const EVENT_ROUTES: {
+    readonly STREAM_STATUS: {};
+    readonly RECORDING_STATUS: {};
+    readonly RECORDINGS_COUNT_UPDATED: {};
+    readonly SIMULCAST_STATUS: {};
+    readonly DOWNLOAD_READY: {};
+    readonly STREAM_COUNTDOWN_UPDATED: {};
+    readonly STREAM_LANGUAGE_UPDATED: {};
+    readonly VIEWER_COUNT: {};
+    readonly STREAM_CONTROL_STATUS_CHANGED: {};
+    readonly STREAM_GLOBAL_STATUS: {
+        readonly token: "none";
+    };
+    readonly ENGAGEMENT_STATS_UPDATED: {};
+    readonly STREAM_CHAT_MESSAGE: {};
+    readonly STREAM_CHAT_SENT: {};
+    readonly STREAM_CHAT_UPDATED: {};
+    readonly STREAM_CHAT_DELETED: {};
+    readonly STREAM_CHAT_PINNED: {};
+    readonly STREAM_CHAT_UNPINNED: {};
+    readonly CHAT_STATUS_CHANGED: {};
+    readonly SLOW_MODE_CHANGED: {};
+    readonly STREAM_CHAT_GLOBAL_STATUS: {
+        readonly token: "none";
+    };
+    readonly USER_TYPING: {};
+    readonly stream_chat_error: {};
+    readonly STREAM_REACTION: {};
+    readonly stream_reaction_error: {};
+    readonly CONTENT_REACTION_ADDED: {};
+    readonly CONTENT_REACTION_REMOVED: {};
+    readonly COMMENT_CREATED: {};
+    readonly COMMENT_UPDATED: {};
+    readonly COMMENT_DELETED: {};
+    readonly TRADE_EXECUTED: {};
+    readonly TRADE_UPDATE_NOTIFY: {
+        readonly token: "none";
+    };
+    readonly BALANCE_UPDATED: {};
+    readonly STATS_UPDATED: {};
+    readonly USER_BANNED: {};
+    readonly USER_UNBANNED: {};
+    readonly BAN_ENFORCEMENT: {};
+    readonly TOKEN_BANNED: {};
+    readonly TOKEN_UNBANNED: {};
+    readonly CONTENT_FLAGGED: {
+        readonly duplicateKey: (payload: Record<string, unknown>) => string | undefined;
+    };
+    readonly FLAG_RESOLVED: {
+        readonly duplicateKey: (payload: Record<string, unknown>) => string | undefined;
+    };
+    readonly AI_MODERATION_COMPLETE: {
+        readonly duplicateKey: (payload: Record<string, unknown>) => string | undefined;
+    };
+    readonly AI_MODERATION_FAILED: {
+        readonly duplicateKey: (payload: Record<string, unknown>) => string | undefined;
+    };
+    readonly MODERATOR_INVITE_CREATED: {};
+    readonly MODERATOR_ADDED: {};
+    readonly MODERATOR_REMOVED: {};
+    readonly MODERATOR_ROLE_UPDATED: {};
+    readonly OVERSEER_ADDED: {
+        readonly token: "none";
+        readonly duplicateKey: (payload: Record<string, unknown>) => string | undefined;
+    };
+    readonly OVERSEER_REMOVED: {
+        readonly token: "none";
+        readonly duplicateKey: (payload: Record<string, unknown>) => string | undefined;
+    };
+    readonly POOL_CREATED: {
+        readonly duplicateKey: (payload: Record<string, unknown>) => string | undefined;
+    };
+    readonly POOL_METADATA_UPDATED: {};
+    readonly POOL_SOCIAL_LINKS_UPDATED: {};
+    readonly POOL_BADGE_ASSIGNED: {};
+    readonly TOKEN_CONFIG_UPDATED: {};
+    readonly HOLDER_COUNT_UPDATED: {};
+    readonly USER_PROFILE_UPDATED: {
+        readonly token: "none";
+    };
+    readonly API_KEY_CREATED: {
+        readonly token: "none";
+    };
+    readonly API_KEY_UPDATED: {
+        readonly token: "none";
+    };
+    readonly API_KEY_REVOKED: {
+        readonly token: "none";
+    };
+    readonly SITE_CONFIG_CHANGED: {
+        readonly token: "none";
+    };
+    readonly COMMENTS_GLOBAL_STATUS: {
+        readonly token: "none";
+    };
+    readonly WEBHOOKS_GLOBAL_STATUS: {
+        readonly token: "none";
+    };
+    readonly AI_MODERATION_GLOBAL_STATUS: {
+        readonly token: "none";
+    };
+    readonly EVENT: {
+        readonly token: "none";
+    };
+    readonly connection: {
+        readonly token: "none";
+    };
+    readonly authenticated: {
+        readonly token: "none";
+    };
+    readonly stream_chat_auth_error: {
+        readonly token: "none";
+    };
+    readonly exception: {
+        readonly token: "none";
+    };
+    readonly token_subscribed: {};
+    readonly token_unsubscribed: {
+        readonly token: "room";
+    };
+    readonly room_subscribed: {
+        readonly token: "none";
+    };
+    readonly room_left: {
+        readonly token: "none";
+    };
+    readonly global_feed_subscribed: {
+        readonly token: "none";
+    };
+    readonly global_feed_unsubscribed: {
+        readonly token: "none";
+    };
+    readonly events_firehose_subscribed: {
+        readonly token: "none";
+    };
+    readonly events_firehose_unsubscribed: {
+        readonly token: "none";
+    };
+};
+/** The routes as a plain map (an event name to its route). */
+export declare function routeOf(name: RealtimeEventName): EventRoute;
+/** Every event name the service listens for, once each. */
+export declare const REALTIME_EVENT_NAMES: RealtimeEventName[];
+/** The token a payload is about, or `undefined` when the event is not about one token. */
+export declare function tokenOfPayload(name: RealtimeEventName, payload: Record<string, unknown>): string | undefined;
+/**
+ * An event the SDK derives from another. The backend folds a token's countdown and language into
+ * `TOKEN_CONFIG_UPDATED` (it no longer emits `STREAM_COUNTDOWN_UPDATED` / `STREAM_LANGUAGE_UPDATED`), so the
+ * subscribers of those two are fed from the config delta.
+ */
+export type DerivedEvent = {
+    readonly name: 'STREAM_COUNTDOWN_UPDATED';
+    readonly payload: RealtimeEventPayloads['STREAM_COUNTDOWN_UPDATED'];
+} | {
+    readonly name: 'STREAM_LANGUAGE_UPDATED';
+    readonly payload: RealtimeEventPayloads['STREAM_LANGUAGE_UPDATED'];
+};
+/** The events derived from one incoming occurrence. */
+export declare function deriveEvents(name: RealtimeEventName, payload: Record<string, unknown>): DerivedEvent[];
+/** The `token:` prefix of a token room. */
+export declare const TOKEN_ROOM_PREFIX = "token:";
+/** The `comment:` prefix of a comment room. */
+export declare const COMMENT_ROOM_PREFIX = "comment:";
+/** The global feed room. */
+export declare const GLOBAL_FEED_ROOM = "global:feed";
+/** The overseers' events firehose room. */
+export declare const EVENTS_FIREHOSE_ROOM = "global:events_firehose";
+/** The emit that joins or leaves a room. */
+export interface RoomRequest {
+    readonly event: string;
+    readonly payload?: {
+        readonly tokenName: string;
+    };
+}
+/** The join and leave emits of a room, from its name. */
+export declare function roomRequests(room: string): {
+    readonly join: RoomRequest;
+    readonly leave: RoomRequest;
+};
+/**
+ * Rooms only an authenticated overseer socket can join: the server rejects the join of any other socket
+ * with an `exception`, so the service joins them once the socket is authenticated.
+ */
+export declare function roomNeedsAuthentication(room: string): boolean;
+/** Whether an incoming event is the server's answer to a room join. */
+export declare function isRoomAcknowledgement(name: RealtimeEventName): boolean;
+/** The site-wide switches, and the `SiteConfigState` field each event sets. */
+export declare const SITE_SWITCH_EVENTS: Readonly<Partial<Record<RealtimeEventName, keyof SiteConfigState>>>;
+/** The events a token room delivers (and that the server tags with the token). */
+export declare const TOKEN_ROOM_EVENTS: readonly ["STREAM_STATUS", "RECORDING_STATUS", "RECORDINGS_COUNT_UPDATED", "SIMULCAST_STATUS", "DOWNLOAD_READY", "STREAM_COUNTDOWN_UPDATED", "STREAM_LANGUAGE_UPDATED", "VIEWER_COUNT", "STREAM_CONTROL_STATUS_CHANGED", "ENGAGEMENT_STATS_UPDATED", "STREAM_CHAT_MESSAGE", "STREAM_CHAT_SENT", "STREAM_CHAT_UPDATED", "STREAM_CHAT_DELETED", "STREAM_CHAT_PINNED", "STREAM_CHAT_UNPINNED", "CHAT_STATUS_CHANGED", "SLOW_MODE_CHANGED", "USER_TYPING", "stream_chat_error", "STREAM_REACTION", "stream_reaction_error", "CONTENT_REACTION_ADDED", "CONTENT_REACTION_REMOVED", "TRADE_EXECUTED", "BALANCE_UPDATED", "STATS_UPDATED", "TOKEN_BANNED", "TOKEN_UNBANNED", "CONTENT_FLAGGED", "FLAG_RESOLVED", "MODERATOR_INVITE_CREATED", "MODERATOR_ADDED", "MODERATOR_REMOVED", "MODERATOR_ROLE_UPDATED", "POOL_METADATA_UPDATED", "POOL_SOCIAL_LINKS_UPDATED", "POOL_BADGE_ASSIGNED", "TOKEN_CONFIG_UPDATED", "HOLDER_COUNT_UPDATED", "token_subscribed", "token_unsubscribed"];
+/** The events the comment room delivers. */
+export declare const COMMENT_ROOM_EVENTS: readonly ["COMMENT_CREATED", "COMMENT_UPDATED", "COMMENT_DELETED"];
+/** The token events the global feed delivers (the same payloads as the token room). */
+export declare const FEED_TOKEN_EVENTS: readonly ["STREAM_STATUS", "TRADE_EXECUTED", "HOLDER_COUNT_UPDATED", "POOL_BADGE_ASSIGNED", "VIEWER_COUNT", "TOKEN_CONFIG_UPDATED", "STATS_UPDATED", "POOL_CREATED"];
+/** The site configuration events the global feed delivers. */
+export declare const FEED_SITE_CONFIG_EVENTS: readonly ["SITE_CONFIG_CHANGED", "STREAM_GLOBAL_STATUS", "STREAM_CHAT_GLOBAL_STATUS", "COMMENTS_GLOBAL_STATUS", "WEBHOOKS_GLOBAL_STATUS", "AI_MODERATION_GLOBAL_STATUS"];
+/** A token room event. */
+export type TokenRoomEventName = (typeof TOKEN_ROOM_EVENTS)[number];
+/** A comment room event. */
+export type CommentRoomEventName = (typeof COMMENT_ROOM_EVENTS)[number];
+/** A token event of the global feed. */
+export type FeedTokenEventName = (typeof FEED_TOKEN_EVENTS)[number];
+/** Any event of the global feed. */
+export type FeedEventName = FeedTokenEventName | (typeof FEED_SITE_CONFIG_EVENTS)[number];
+/**
+ * One occurrence of a global feed token event, named: `subscribeFeedTokenEvents` hands these to one
+ * callback, which tells them apart by `event` instead of by the shape of the payload.
+ */
+export type FeedTokenEvent = {
+    [K in FeedTokenEventName]: {
+        readonly event: K;
+        readonly data: RealtimeEventPayloads[K];
+    };
+}[FeedTokenEventName];
+/** Whether joining a token room delivers this event. */
+export declare function isTokenRoomEvent(name: RealtimeEventName): name is TokenRoomEventName;
+/** Whether joining a token's comment room delivers this event. */
+export declare function isCommentRoomEvent(name: RealtimeEventName): name is CommentRoomEventName;
+/**
+ * The `onX` keys of a callback object, each naming the event it receives.
+ */
+export declare const STREAM_CALLBACK_EVENTS: {
+    readonly onStreamStatus: "STREAM_STATUS";
+    readonly onStreamSubscribed: "token_subscribed";
+    readonly onStreamUnsubscribed: "token_unsubscribed";
+    readonly onViewerCount: "VIEWER_COUNT";
+    readonly onStreamGlobalStatus: "STREAM_GLOBAL_STATUS";
+    readonly onCountdownUpdated: "STREAM_COUNTDOWN_UPDATED";
+    readonly onLanguageUpdated: "STREAM_LANGUAGE_UPDATED";
+    readonly onRecordingStatus: "RECORDING_STATUS";
+    readonly onRecordingsCountUpdated: "RECORDINGS_COUNT_UPDATED";
+    readonly onSimulcastStatus: "SIMULCAST_STATUS";
+    readonly onDownloadReady: "DOWNLOAD_READY";
+    readonly onStreamControlStatusChanged: "STREAM_CONTROL_STATUS_CHANGED";
+    readonly onChatMessage: "STREAM_CHAT_MESSAGE";
+    readonly onChatSent: "STREAM_CHAT_SENT";
+    readonly onChatUpdated: "STREAM_CHAT_UPDATED";
+    readonly onChatDeleted: "STREAM_CHAT_DELETED";
+    readonly onChatError: "stream_chat_error";
+    readonly onChatStatus: "CHAT_STATUS_CHANGED";
+    readonly onChatSlowMode: "SLOW_MODE_CHANGED";
+    readonly onChatGlobalStatus: "STREAM_CHAT_GLOBAL_STATUS";
+    readonly onChatAuthenticated: "authenticated";
+    readonly onChatAuthError: "stream_chat_auth_error";
+    readonly onChatPinned: "STREAM_CHAT_PINNED";
+    readonly onChatUnpinned: "STREAM_CHAT_UNPINNED";
+    readonly onTypingIndicator: "USER_TYPING";
+    readonly onReaction: "STREAM_REACTION";
+    readonly onReactionError: "stream_reaction_error";
+    readonly onContentReactionAdded: "CONTENT_REACTION_ADDED";
+    readonly onContentReactionRemoved: "CONTENT_REACTION_REMOVED";
+    readonly onCommentCreated: "COMMENT_CREATED";
+    readonly onCommentUpdated: "COMMENT_UPDATED";
+    readonly onCommentDeleted: "COMMENT_DELETED";
+    readonly onUserBanned: "USER_BANNED";
+    readonly onUserUnbanned: "USER_UNBANNED";
+    readonly onBanEnforcement: "BAN_ENFORCEMENT";
+    readonly onTokenBanned: "TOKEN_BANNED";
+    readonly onTokenUnbanned: "TOKEN_UNBANNED";
+    readonly onContentFlagged: "CONTENT_FLAGGED";
+    readonly onFlagResolved: "FLAG_RESOLVED";
+    readonly onAIModerationComplete: "AI_MODERATION_COMPLETE";
+    readonly onAIModerationFailed: "AI_MODERATION_FAILED";
+    readonly onModeratorInviteCreated: "MODERATOR_INVITE_CREATED";
+    readonly onModeratorAdded: "MODERATOR_ADDED";
+    readonly onModeratorRemoved: "MODERATOR_REMOVED";
+    readonly onModeratorRoleUpdated: "MODERATOR_ROLE_UPDATED";
+    readonly onOverseerAdded: "OVERSEER_ADDED";
+    readonly onOverseerRemoved: "OVERSEER_REMOVED";
+    readonly onTradeExecuted: "TRADE_EXECUTED";
+    readonly onTradeUpdateNotify: "TRADE_UPDATE_NOTIFY";
+    readonly onBalanceUpdated: "BALANCE_UPDATED";
+    readonly onStatsUpdated: "STATS_UPDATED";
+    readonly onEngagementStatsUpdated: "ENGAGEMENT_STATS_UPDATED";
+    readonly onPoolCreated: "POOL_CREATED";
+    readonly onPoolMetadataUpdated: "POOL_METADATA_UPDATED";
+    readonly onPoolSocialLinksUpdated: "POOL_SOCIAL_LINKS_UPDATED";
+    readonly onPoolBadgeAssigned: "POOL_BADGE_ASSIGNED";
+    readonly onHolderCountUpdated: "HOLDER_COUNT_UPDATED";
+    readonly onTokenConfigUpdated: "TOKEN_CONFIG_UPDATED";
+    readonly onUserProfileUpdated: "USER_PROFILE_UPDATED";
+    readonly onApiKeyCreated: "API_KEY_CREATED";
+    readonly onApiKeyUpdated: "API_KEY_UPDATED";
+    readonly onApiKeyRevoked: "API_KEY_REVOKED";
+    readonly onException: "exception";
+};
+/**
+ * Callbacks for stream events, one optional `onX` per event. Passed to `subscribeToStream(token, callbacks)`
+ * they become subscribers of that token (and the room is joined for as long as one of them is registered);
+ * passed to `connectStreamWebSocket(callbacks)` they become subscribers of the event on every token.
+ * Each registered callback is its own subscriber: no callback replaces another.
+ */
+export type StreamEventCallbacks = {
+    [K in keyof typeof STREAM_CALLBACK_EVENTS]?: (event: RealtimeEventPayloads[(typeof STREAM_CALLBACK_EVENTS)[K]]) => void | Promise<void>;
+};
+/** The `onX` keys of a global feed callback object. */
+export declare const FEED_CALLBACK_EVENTS: {
+    readonly onGlobalFeedSubscribed: "global_feed_subscribed";
+    readonly onGlobalFeedUnsubscribed: "global_feed_unsubscribed";
+    readonly onStreamStatus: "STREAM_STATUS";
+    readonly onTradeExecuted: "TRADE_EXECUTED";
+    readonly onHolderCountUpdated: "HOLDER_COUNT_UPDATED";
+    readonly onPoolBadgeAssigned: "POOL_BADGE_ASSIGNED";
+    readonly onViewerCount: "VIEWER_COUNT";
+    readonly onTokenConfigUpdated: "TOKEN_CONFIG_UPDATED";
+    readonly onStatsUpdated: "STATS_UPDATED";
+    readonly onPoolCreated: "POOL_CREATED";
+    readonly onSiteConfigChanged: "SITE_CONFIG_CHANGED";
+    readonly onStreamGlobalStatus: "STREAM_GLOBAL_STATUS";
+    readonly onStreamChatGlobalStatus: "STREAM_CHAT_GLOBAL_STATUS";
+    readonly onCommentsGlobalStatus: "COMMENTS_GLOBAL_STATUS";
+    readonly onWebhooksGlobalStatus: "WEBHOOKS_GLOBAL_STATUS";
+    readonly onAIModerationGlobalStatus: "AI_MODERATION_GLOBAL_STATUS";
+};
+/**
+ * Callbacks for the global feed, one optional `onX` per feed event. Each registered callback is its own
+ * subscriber; the feed room is joined while any is registered.
+ */
+export type GlobalFeedEventCallbacks = {
+    [K in keyof typeof FEED_CALLBACK_EVENTS]?: (event: RealtimeEventPayloads[(typeof FEED_CALLBACK_EVENTS)[K]]) => void | Promise<void>;
+};
+//# sourceMappingURL=event-catalog.d.ts.map

package/dist/services/realtime/event-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-catalog.d.ts","sourceRoot":"","sources":["../../../src/services/realtime/event-catalog.ts"],"names":[],"mappings":"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"}

package/dist/services/shared/pagination-helpers.d.ts

@@ -95,11 +95,28 @@ export declare function buildPaginationMeta(total: number, page?: number, limit?
  * ```
  */
 export declare function buildFlattenedPaginationMeta<T>(items: T[], total?: number): PaginationMeta;
+/**
+ * How each launchpad-backend path parameter is spelled in a URL (launchpad-backend-service-v3
+ * origin/main). Lowercased only where the backend normalizes the value itself, so the SDK's
+ * spelling can never select something the backend's would not; every other value is sent exactly
+ * as given:
+ * - `tokenName`: lowercase (the pool lookup's `normalizeTokenName`; token names are lowercase);
+ * - `address`, `userAddress`: lowercase (`normalizeAddress` / `GalaChainAddressField` on every
+ *   route that takes one: bans, overseers, user summary, cache flushes);
+ * - `assetId`, `targetId`: as given (Mux asset and simulcast target ids, mixed-case and compared
+ *   exactly);
+ * - `id`: as given (numeric invite ids);
+ * - `code`: as given (invite codes are matched exactly; the backend generates lowercase hex).
+ *
+ * @since 9.0.0
+ */
+export declare const PATH_PARAM_CASING: Readonly<Record<string, 'lowercase' | 'as given'>>;
 /**
  * Build endpoint URL with path parameters
  *
- * Replaces :param placeholders in URL templates with provided values.
- * Values are lowercased and URI-encoded for safety.
+ * Replaces :param placeholders in URL templates with provided values, URI-encoded, each spelled
+ * as {@link PATH_PARAM_CASING} says. A parameter that table does not name is refused (a
+ * programming error: decide its casing there first).
  *
  * @param template - URL template with :param placeholders
  * @param params - Parameters to substitute
@@ -110,11 +127,11 @@ export declare function buildFlattenedPaginationMeta<T>(items: T[], total?: numb
  * const url = buildEndpoint('/api/:tokenName/status', { tokenName: 'MyToken' });
  * // Returns: '/api/mytoken/status'
  *
- * const url = buildEndpoint('/api/:tokenName/assets/:assetId', {
+ * const url = buildEndpoint('/v1/tokens/:tokenName/recordings/:assetId', {
  *   tokenName: 'MyToken',
- *   assetId: '12345'
+ *   assetId: 'Ab3xYz00',
  * });
- * // Returns: '/api/mytoken/assets/12345'
+ * // Returns: '/v1/tokens/mytoken/recordings/Ab3xYz00'
  * ```
  */
 export declare function buildEndpoint(template: string, params: Record<string, string>): string;

package/dist/services/shared/pagination-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pagination-helpers.d.ts","sourceRoot":"","sources":["../../../src/services/shared/pagination-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,MAAM,GAClB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAaxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,EAAE,KAAK,GAAE,MAAW,GAAG,cAAc,CAOvG;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,GAAE,MAAqB,GAAG,cAAc,CAOxG;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAMtF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,GAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB"}
+{"version":3,"file":"pagination-helpers.d.ts","sourceRoot":"","sources":["../../../src/services/shared/pagination-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,MAAM,GAClB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAaxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,EAAE,KAAK,GAAE,MAAW,GAAG,cAAc,CAOvG;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,GAAE,MAAqB,GAAG,cAAc,CAOxG;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,CAAC,CAQhF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAUtF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,GAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB"}

package/dist/services/shared/service-validators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-validators.d.ts","sourceRoot":"","sources":["../../../src/services/shared/service-validators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAc9D,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,IAAI,wBAAwB,EAChD,sBAAsB,IAAI,0BAA0B,EACpD,sBAAsB,EACtB,sBAAsB,IAAI,0BAA0B,EACpD,uBAAuB,IAAI,2BAA2B,EACtD,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,IAAI,0BAA0B,EACpD,oBAAoB,IAAI,wBAAwB,EAChD,oBAAoB,EACpB,gCAAgC,IAAI,oCAAoC,GACzE,MAAM,gCAAgC,CAAC;AAExC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAOnG;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gCAAgC,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAa1G;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAI9G;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,IAAI,CASN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAWN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,IAAI,CAUN;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnE,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,eAAe,EAAE,CAAC,EAClB,SAAS,GAAE,MAAiB,GAC3B,IAAI,CAIN"}
+{"version":3,"file":"service-validators.d.ts","sourceRoot":"","sources":["../../../src/services/shared/service-validators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAc9D,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,IAAI,wBAAwB,EAChD,sBAAsB,IAAI,0BAA0B,EACpD,sBAAsB,EACtB,sBAAsB,IAAI,0BAA0B,EACpD,uBAAuB,IAAI,2BAA2B,EACtD,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,IAAI,0BAA0B,EACpD,oBAAoB,IAAI,wBAAwB,EAChD,oBAAoB,EACpB,gCAAgC,IAAI,oCAAoC,GACzE,MAAM,gCAAgC,CAAC;AAExC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAOnG;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gCAAgC,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAS1G;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAI9G;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,IAAI,CASN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAWN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,IAAI,CAUN;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnE,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,eAAe,EAAE,CAAC,EAClB,SAAS,GAAE,MAAiB,GAC3B,IAAI,CAIN"}

package/dist/signing/signers.d.ts

@@ -1,3 +1,4 @@
+import { type Eip1193Provider } from 'ethers';
 import { BrowserWalletSigner as CoreBrowserWalletSigner, GalaWalletSigner as CoreGalaWalletSigner, PrivateKeySigner as CorePrivateKeySigner, type EIP712Types } from '@gala-chain/gala-core-sdk';
 import type { EIP712Domain, LaunchpadSigner, SignedTypedDataBody } from './types';
 interface GalaWalletProvider {
@@ -50,8 +51,40 @@ export declare class PrivateKeySigner extends CorePrivateKeySigner implements La
  * console.log(body.signature);
  */
 export declare class GalaWalletSigner extends CoreGalaWalletSigner implements LaunchpadSigner {
+    /** The `wallet` option: the Gala Wallet object typed data is signed through (`window.gala` when absent). */
+    private readonly typedDataWallet;
+    /**
+     * The Ethereum account of the KEY the wallet must have active when `verifyActiveAccount` is on
+     * (`undefined` when the check is off).
+     */
+    private readonly verifiedKey;
+    /**
+     * Same arguments as gala-core-sdk's `GalaWalletSigner` (`scheme`, `selectAddress`, `wallet`), and:
+     *
+     * - `verifyActiveAccount` (default `false`): before every typed-data signature, refuse unless the
+     *   wallet's active account is this signer's key. See {@link GalaWalletSigner.signTypedData}.
+     *   The key is `walletAddress` when that is an Ethereum account (`0x...` / `eth|...`), else
+     *   `selectAddress` when that is one; a signer that names no key cannot be verified and is refused
+     *   at construction (`INVALID_SIGNER_OPTIONS`).
+     *
+     * @since 9.0.0
+     */
+    constructor(walletAddress: string, options?: ConstructorParameters<typeof CoreGalaWalletSigner>[1] & {
+        verifyActiveAccount?: boolean | undefined;
+    });
     /**
-     * Sign a launchpad DTO through Gala Wallet.
+     * With `verifyActiveAccount`, the first step is the active-account check (below); the RPC order is
+     * then the check (`window.gala.address`, else `eth_accounts` when the wallet has not reported an
+     * account yet), `setAddress`, `eth_signTypedData`. A mismatch, or a wallet reporting no account,
+     * is `WALLET_ACCOUNT_CHANGED` and nothing is signed. The check runs before this signer's own
+     * `setAddress`, so it sees the account the person has active, not one this signer just selected;
+     * another signer's select on the same wallet object in flight at that moment is not observable.
+     *
+     * Sign a launchpad DTO through Gala Wallet. Gala Wallet holds one current account, so the
+     * account is selected first (`setAddress`, where the wallet offers it, with `selectAddress` or
+     * else the Ethereum account the request names) and the select-then-sign pair is serialized per
+     * wallet object with every other signer and provider that signs through it (gala-core-sdk's
+     * `withGalaWalletIdentity`). The wallet is the `wallet` option, else `window.gala`.
      *
      * @example
      * const body = await signer.signTypedData('BuyWithNative', { amount: '1' });
@@ -90,6 +123,29 @@ export declare class BrowserWalletSigner extends CoreBrowserWalletSigner impleme
      * console.log(body.domain.chainId);
      */
     signTypedData(method: string, rawDto: Record<string, unknown>): Promise<SignedTypedDataBody>;
+    /**
+     * A signer for a browser app that holds the wallet's raw EIP-1193 provider (`window.ethereum`,
+     * an EIP-6963 announcement's `provider`) rather than an ethers provider. It builds the ethers
+     * `BrowserProvider` the typed-data path reads the network and the account from, and keeps the raw
+     * `request` for the DEX signatures (`signObject`). The bytes signed are exactly those of
+     * `new BrowserWalletSigner({ request, getNetwork, getSigner }, key)` over that `BrowserProvider`:
+     * domain `{ name: network.name, chainId: Number(network.chainId) }`, signed by the account the
+     * wallet has selected (`getSigner()`), refused with `WALLET_ACCOUNT_CHANGED` when that is not
+     * `keyAddress`.
+     *
+     * @param provider - The wallet's EIP-1193 provider.
+     * @param keyAddress - The account of the KEY that signs: `0x` plus 40 hex digits, or `eth|` plus
+     *   40 hex digits (with or without `0x`). Not a `client|` alias: an alias names no key (it is the
+     *   `walletAddress` the SDK declares beside this signer).
+     * @param options - As the constructor's (`{ scheme: 'eip712' }` for the DEX methods).
+     * @throws GalaSDKError `INVALID_WALLET_ADDRESS` when `keyAddress` names no Ethereum account.
+     * @since 9.0.0
+     *
+     * @example
+     * const signer = BrowserWalletSigner.fromEip1193(window.ethereum, '0x70997970C51812dc3A010C7d01b50e0d17dc79C8');
+     * const sdk = new LaunchpadSDK({ signer, walletAddress: 'client|618ae395c1c653111d3315be' });
+     */
+    static fromEip1193(provider: Eip1193Provider, keyAddress: string, options?: ConstructorParameters<typeof CoreBrowserWalletSigner>[2]): BrowserWalletSigner;
 }
 export type { BrowserWalletProvider };
 //# sourceMappingURL=signers.d.ts.map

package/dist/signing/signers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signers.d.ts","sourceRoot":"","sources":["../../src/signing/signers.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,IAAI,uBAAuB,EAC9C,gBAAgB,IAAI,oBAAoB,EACxC,gBAAgB,IAAI,oBAAoB,EAExC,KAAK,WAAW,EACjB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAEjB,UAAU,kBAAkB;IAC1B,OAAO,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzE;AAMD,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED,UAAU,yBAAyB;IACjC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,aAAa,CACX,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC,CAAC;CACpB;AAED,UAAU,qBAAsB,SAAQ,kBAAkB;IACxD,UAAU,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC5C,SAAS,IAAI,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACjD;AAkDD;;;;;;;;GAQG;AACH,qBAAa,gBACX,SAAQ,oBACR,YAAW,eAAe;IAE1B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,wFAAwF;IACxF,SAAgB,aAAa,EAAE,MAAM,CAAC;gBAE1B,UAAU,EAAE,MAAM;IAO9B;;;;;;OAMG;IACU,aAAa,CACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,mBAAmB,CAAC;CAMhC;AAED;;;;;;;GAOG;AACH,qBAAa,gBACX,SAAQ,oBACR,YAAW,eAAe;IAE1B;;;;;;OAMG;IACU,aAAa,CACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,mBAAmB,CAAC;IAiB/B;;;;;OAKG;YACW,gBAAgB;CAU/B;AAED;;;;;;;GAOG;AACH,qBAAa,mBACX,SAAQ,uBACR,YAAW,eAAe;IAE1B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAwB;IAE1D;;;;OAIG;gBAED,QAAQ,EAAE,qBAAqB,EAC/B,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,qBAAqB,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC,CAAC;IAMpE;;;;;;OAMG;IACU,aAAa,CACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,mBAAmB,CAAC;CAqBhC;AAED,YAAY,EAAE,qBAAqB,EAAE,CAAC"}
+{"version":3,"file":"signers.d.ts","sourceRoot":"","sources":["../../src/signing/signers.ts"],"names":[],"mappings":"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"}

package/dist/types/api-key.dto.d.ts

@@ -217,7 +217,7 @@ export interface UpdateApiKeyOptions {
 export interface ListApiKeysOptions {
     /**
      * Cursor token for fetching the next page (omit for first page).
-     * Use the `nextCursor` from the previous response's `pageInfo`.
+     * Use the `endCursor` from the previous response's `pageInfo`.
      */
     cursor?: string;
     /**