@gala-chain/launchpad-sdk 5.0.4-beta.6 → 5.0.4-beta.60

package/dist/constants/endpoints.d.ts

@@ -0,0 +1,776 @@
+/**
+ * API Endpoint Constants
+ *
+ * Centralized definition of all launchpad-backend API endpoints.
+ * This prevents magic strings scattered throughout the codebase and
+ * makes it easier to update endpoints when the backend API changes.
+ *
+ * @category Constants
+ * @since 3.6.0
+ */
+/**
+ * Launchpad Backend API Endpoints (v1 token-centric structure)
+ */
+export declare const ENDPOINTS: {
+    /** POST /v1/tokens/:tokenName/image - Upload token image (JWT owner only) */
+    readonly UPLOAD_IMAGE: "/v1/tokens/:tokenName/image";
+    /** GET /v1/tokens - Fetch paginated token pools (Public) */
+    readonly FETCH_POOLS: "/v1/tokens";
+    /** GET /v1/tokens/:tokenName - Get full token pool data with streaming fields (Public) */
+    readonly GET_TOKEN: "/v1/tokens/:tokenName";
+    /** GET /v1/holders?tokenName=X - Get token distribution with percentages (Public) */
+    readonly GET_TOKEN_DISTRIBUTION: "/v1/holders";
+    /** GET /v1/tokens/:tokenName/badges - Get token badges (Public) */
+    readonly GET_TOKEN_BADGES: "/v1/tokens/:tokenName/badges";
+    /** GET /v1/chart?tokenName=X&from=Y&to=Z&resolution=W - Get historical chart data (Public) */
+    readonly CHART: "/v1/chart";
+    /** GET /v1/tokens/:tokenName/recordings/:assetId - Get recording details (JWT) */
+    readonly GET_RECORDING_DETAILS: "/v1/tokens/:tokenName/recordings/:assetId";
+    /** GET /v1/tokens/:tokenName/trades - Get trades for a specific token (Public) */
+    readonly GET_TRADES: "/v1/tokens/:tokenName/trades";
+    /** GET /v1/users/:address - Get user profile (Public) */
+    readonly GET_PROFILE: "/v1/users/:address";
+    /** PUT /v1/users/me - Update own profile (JWT) */
+    readonly UPDATE_PROFILE: "/v1/users/me";
+    /** GET /v1/users/me - Get current authenticated user profile (JWT) */
+    readonly GET_CURRENT_USER: "/v1/users/me";
+    /** GET /v1/users/:address/tokens - Get user's created tokens (Public) */
+    readonly GET_TOKEN_LIST: "/v1/users/:address/tokens";
+    /** GET /v1/users/:address/tokens - Get tokens user holds (Public) */
+    readonly GET_TOKENS_HELD: "/v1/users/:address/tokens";
+    /** GET /v1/users/:address/gala-balance - Get user's GALA balance (Public) */
+    readonly GET_GALA_BALANCE: "/v1/users/:address/gala-balance";
+    /** GET /v1/users/:address/balances - Get user's token balances (Public) */
+    readonly USER_BALANCES: "/v1/users/:address/balances";
+    /** GET /v1/users/:address/report - Get user profile report (Overseer only) */
+    readonly USER_REPORT: "/v1/users/:address/report";
+    /** GET /v1/users/me/managed-tokens - Get all tokens user can manage (JWT) */
+    readonly GET_MANAGED_TOKENS: "/v1/users/me/managed-tokens";
+    /** POST /v1/utils/validate-token - Validate token name and symbol availability (Public) */
+    readonly VALIDATE_TOKEN: "/v1/utils/validate-token";
+    /** POST /v1/tokens/:tokenName - Update token config (Owner/Admin) */
+    readonly UPDATE_TOKEN_CONFIG: "/v1/tokens/:tokenName";
+    /** GET /v1/tokens/:tokenName/stats - Get token engagement stats (Public) */
+    readonly TOKEN_STATS: "/v1/tokens/:tokenName/stats";
+    /** PUT /v1/tokens/:tokenName - Update token config (Owner/Admin) */
+    readonly TOKEN_CONFIG: "/v1/tokens/:tokenName";
+    /** GET /v1/tokens/:tokenName/holders - Get top holders or specific user holder data (Public) */
+    readonly GET_HOLDERS: "/v1/tokens/:tokenName/holders";
+    /** GET /oembed - Get oEmbed data for general endpoint (Public, bot agents) */
+    readonly OEMBED: "/oembed";
+    /** GET /oembed/buy-sell/:tokenName - Get oEmbed for buy/sell view (Public, bot agents) */
+    readonly OEMBED_BUY_SELL: "/oembed/buy-sell/:tokenName";
+    /** GET /oembed/t/:tokenName - Get oEmbed for token view (Public, bot agents) */
+    readonly OEMBED_TOKEN: "/oembed/t/:tokenName";
+    /** GET /oembed/profile/:address - Get oEmbed for user profile (Public, bot agents) */
+    readonly OEMBED_PROFILE: "/oembed/profile/:address";
+    /** GET /oembed/u/:address - Get oEmbed for user view (Public, bot agents) */
+    readonly OEMBED_USER: "/oembed/u/:address";
+};
+/**
+ * Type-safe endpoint keys
+ */
+export type EndpointKey = keyof typeof ENDPOINTS;
+/**
+ * Type-safe endpoint values
+ */
+export type EndpointValue = typeof ENDPOINTS[EndpointKey];
+/**
+ * DEX API Platform Endpoints (for dexApiHttp)
+ *
+ * These endpoints are served by the DEX API platform (dex-api-platform-*),
+ * NOT the launchpad backend. They use dexApiHttp client.
+ *
+ * @since 4.0.18
+ */
+export declare const DEX_API_ENDPOINTS: {
+    /** Get user's referral URL */
+    readonly GET_REFERRAL_URL: "/v1/users/referrals/url";
+    /** Get user's referrals list (paginated) */
+    readonly GET_REFERRALS: "/v1/users/referrals";
+    /** Get user's referrals summary (counts and reward totals) */
+    readonly GET_REFERRALS_SUMMARY: "/v1/users/referrals/summary";
+};
+/**
+ * Type-safe DEX API endpoint keys
+ */
+export type DexApiEndpointKey = keyof typeof DEX_API_ENDPOINTS;
+/**
+ * Type-safe DEX API endpoint values
+ */
+export type DexApiEndpointValue = typeof DEX_API_ENDPOINTS[DexApiEndpointKey];
+/**
+ * Live Streaming Endpoints (v5.1.0+, migrated to /v1/tokens/:tokenName/ structure in v7.x.0+)
+ *
+ * Base path: /v1/tokens/:tokenName/
+ * Controller: StreamActionsController, RecordingController
+ *
+ * Migration (v7.x.0+): Stream action endpoints moved from nested /stream/ path to action-based naming
+ * - /v1/tokens/:tokenName/stream/start → /v1/tokens/:tokenName/start-stream
+ * - /v1/tokens/:tokenName/stream/stop → /v1/tokens/:tokenName/stop-stream
+ * - /v1/tokens/:tokenName/stream/reset-key → /v1/tokens/:tokenName/reset-key
+ *
+ * @since 5.1.0
+ * @since 7.x.0 - Modernized to action-based naming pattern
+ */
+export declare const STREAMING_ENDPOINTS: {
+    /** POST /v1/tokens/:tokenName/start-stream - Start a stream (JWT) */
+    readonly START_STREAM: "/v1/tokens/:tokenName/start-stream";
+    /** POST /v1/tokens/:tokenName/stop-stream - Stop an active stream (JWT) */
+    readonly STOP_STREAM: "/v1/tokens/:tokenName/stop-stream";
+    /** POST /v1/tokens/:tokenName/stream/disable - Disable stream (Admin) */
+    readonly DISABLE_STREAM: "/v1/tokens/:tokenName/stream/disable";
+    /** POST /v1/tokens/:tokenName/stream/enable - Enable stream (Admin) */
+    readonly ENABLE_STREAM: "/v1/tokens/:tokenName/stream/enable";
+    /** POST /v1/tokens/:tokenName/reset-key - Reset stream key (JWT) */
+    readonly RESET_STREAM_KEY: "/v1/tokens/:tokenName/reset-key";
+    /** GET /v1/tokens/:tokenName/recordings - Get recordings (Public) */
+    readonly GET_RECORDINGS: "/v1/tokens/:tokenName/recordings";
+    /** GET /v1/tokens/:tokenName/recordings/:assetId/download - Get download status/URL (JWT) */
+    readonly GET_RECORDING_DOWNLOAD: "/v1/tokens/:tokenName/recordings/:assetId/download";
+    /** DELETE /v1/tokens/:tokenName/recordings/:assetId - Delete recording (JWT) */
+    readonly DELETE_RECORDING: "/v1/tokens/:tokenName/recordings/:assetId";
+    /** GET /v1/tokens/:tokenName/stream/simulcast - Get simulcast targets (Public) */
+    readonly GET_SIMULCAST_TARGETS: "/v1/tokens/:tokenName/stream/simulcast";
+    /** POST /v1/tokens/:tokenName/stream/simulcast - Add simulcast target (JWT) */
+    readonly ADD_SIMULCAST_TARGET: "/v1/tokens/:tokenName/stream/simulcast";
+    /** DELETE /v1/tokens/:tokenName/stream/simulcast/:targetId - Remove target (JWT) */
+    readonly REMOVE_SIMULCAST_TARGET: "/v1/tokens/:tokenName/stream/simulcast/:targetId";
+    /** GET /v1/config - Get global status (Public) */
+    readonly GET_GLOBAL_STREAMING_STATUS: "/v1/config";
+    /** POST /v1/config - Update global config (Admin) */
+    readonly DISABLE_GLOBAL_STREAMING: "/v1/config";
+    /** POST /v1/config - Update global config (Admin) */
+    readonly ENABLE_GLOBAL_STREAMING: "/v1/config";
+    /** GET /v1/tokens/:tokenName/role - Get user's role for stream (Optional JWT) */
+    readonly GET_STREAM_ROLE: "/v1/tokens/:tokenName/role";
+    /** GET /v1/roles - Get all available roles and permissions (Public) */
+    readonly GET_AVAILABLE_ROLES: "/v1/roles";
+    /** GET /v1/tokens/:tokenName/access - Check user's studio access (Optional JWT) */
+    readonly GET_TOKEN_ACCESS: "/v1/tokens/:tokenName/access";
+    /** GET /v1/tokens/:tokenName/credentials - Get stream credentials (JWT, requires START_STREAM permission) */
+    readonly GET_STREAM_CREDENTIALS: "/v1/tokens/:tokenName/credentials";
+};
+/**
+ * Type-safe streaming endpoint keys
+ */
+export type StreamingEndpointKey = keyof typeof STREAMING_ENDPOINTS;
+/**
+ * Session Authentication Endpoints (v5.2.0+)
+ *
+ * Base path: /auth/
+ * Controller: AuthController
+ *
+ * JWT-based session authentication flow:
+ * 1. POST /auth/login - Sign message and get JWT token
+ * 2. Use Bearer token for authenticated requests
+ * 3. POST /auth/refresh - Get new token before expiry
+ * 4. POST /auth/logout - Invalidate token (client-side)
+ *
+ * @since 5.2.0
+ */
+export declare const AUTH_ENDPOINTS: {
+    /** POST /auth/login - Authenticate with wallet signature (Public) */
+    readonly LOGIN: "/auth/login";
+    /** POST /auth/logout - Logout and invalidate token (JWT) */
+    readonly LOGOUT: "/auth/logout";
+    /** POST /auth/refresh - Refresh access token (JWT) */
+    readonly REFRESH: "/auth/refresh";
+    /** GET /auth/session - Get current session info (JWT) */
+    readonly SESSION: "/auth/session";
+};
+/**
+ * Type-safe auth endpoint keys
+ */
+export type AuthEndpointKey = keyof typeof AUTH_ENDPOINTS;
+/**
+ * Token Ban Endpoints (v5.5.0+, migrated to /v1/tokens/:tokenName/bans structure)
+ *
+ * Base path: /v1/tokens/:tokenName/bans/
+ * Controller: UserBanController
+ *
+ * Per-token bans: Owner (JWT) or Admin (API key) can manage
+ *
+ * @since 5.5.0
+ */
+export declare const BAN_ENDPOINTS: {
+    /** POST /v1/tokens/:tokenName/bans - Create a ban (JWT or Admin) */
+    readonly CREATE_BAN: "/v1/tokens/:tokenName/bans";
+    /** GET /v1/tokens/:tokenName/bans - List all bans (JWT or Admin) */
+    readonly LIST_BANS: "/v1/tokens/:tokenName/bans";
+    /** GET /v1/tokens/:tokenName/bans/:userAddress - Get ban status (JWT or Admin) */
+    readonly GET_BAN: "/v1/tokens/:tokenName/bans/:userAddress";
+    /** DELETE /v1/tokens/:tokenName/bans/:userAddress - Remove a ban (JWT or Admin) */
+    readonly REMOVE_BAN: "/v1/tokens/:tokenName/bans/:userAddress";
+    /** GET /v1/tokens/:tokenName/active-users - Get active users (JWT or Admin) */
+    readonly GET_ACTIVE_USERS: "/v1/tokens/:tokenName/active-users";
+};
+/**
+ * Global User Ban Endpoints (v6.x.0+)
+ *
+ * Base path: /v1/user-bans
+ * Controller: GlobalUserBanController
+ *
+ * Platform-wide user bans for blocking users across all tokens.
+ * Authorization: Admin API key OR authenticated Overseer (JWT)
+ *
+ * @since 6.x.0
+ */
+export declare const USER_BAN_ENDPOINTS: {
+    /** POST /v1/user-bans - Ban user globally (Admin OR Overseer) */
+    readonly CREATE_GLOBAL_BAN: "/v1/user-bans";
+    /** GET /v1/user-bans - List global user bans (Admin OR Overseer) */
+    readonly LIST_GLOBAL_BANS: "/v1/user-bans";
+    /** GET /v1/user-bans/:userAddress - Get global ban status (Public) */
+    readonly GET_GLOBAL_BAN: "/v1/user-bans/:userAddress";
+    /** DELETE /v1/user-bans/:userAddress - Remove global ban (Admin OR Overseer) */
+    readonly REMOVE_GLOBAL_BAN: "/v1/user-bans/:userAddress";
+};
+/**
+ * Type-safe ban endpoint keys
+ */
+export type BanEndpointKey = keyof typeof BAN_ENDPOINTS;
+/**
+ * Type-safe global user ban endpoint keys
+ */
+export type UserBanEndpointKey = keyof typeof USER_BAN_ENDPOINTS;
+/**
+ * API Key Management Endpoints (v5.6.0+)
+ *
+ * Base path: /v1/api-keys
+ * Controller: ApiKeyController
+ *
+ * User-managed API keys for delegating permissions to third-party services.
+ * Keys are shown only once on creation (raw key never stored).
+ *
+ * All endpoints require JWT authentication - only key owner can manage.
+ *
+ * @since 5.6.0
+ */
+export declare const API_KEY_ENDPOINTS: {
+    /** POST /v1/api-keys - Create new API key (returns raw key ONCE) */
+    readonly CREATE: "/v1/api-keys";
+    /** GET /v1/api-keys - List all API keys for authenticated user */
+    readonly LIST: "/v1/api-keys";
+    /** GET /v1/api-keys/:id - Get API key details */
+    readonly GET: "/v1/api-keys/:id";
+    /** PATCH /v1/api-keys/:id - Update API key metadata/permissions */
+    readonly UPDATE: "/v1/api-keys/:id";
+    /** DELETE /v1/api-keys/:id - Revoke an API key */
+    readonly REVOKE: "/v1/api-keys/:id";
+};
+/**
+ * Type-safe API key endpoint keys
+ */
+export type ApiKeyEndpointKey = keyof typeof API_KEY_ENDPOINTS;
+/**
+ * Moderator Invite Endpoints (v5.7.0+, flattened in v6.0.0+)
+ *
+ * Base path: /v1/moderator-invites
+ * Controllers: ModeratorInvitesController, ModeratedTokensController
+ *
+ * Magic link-based moderator delegation for stream management.
+ * Token owners create invites, share links, moderators claim access.
+ * Flattened API routes for cleaner REST structure.
+ *
+ * @since 5.7.0
+ * @since 6.0.0 - Flattened routes: /v1/moderators → /v1/moderator-invites and /v1/moderated-tokens
+ */
+export declare const MODERATOR_ENDPOINTS: {
+    /** POST /v1/moderator-invites - Create a moderator invite (JWT owner) */
+    readonly CREATE_INVITE: "/v1/moderator-invites";
+    /** POST /v1/moderator-invites/claim - Claim an invite (JWT) */
+    readonly CLAIM_INVITE: "/v1/moderator-invites/claim";
+    /** GET /v1/moderated-tokens - Get tokens user moderates (JWT) */
+    readonly GET_MODERATED_TOKENS: "/v1/moderated-tokens";
+    /** GET /v1/moderator-invites - List invites for a token (JWT owner) */
+    readonly LIST_INVITES: "/v1/moderator-invites";
+    /** DELETE /v1/moderator-invites/:id - Revoke an invite (JWT owner) */
+    readonly REVOKE_INVITE: "/v1/moderator-invites/:id";
+    /** PATCH /v1/moderator-invites/:id/role - Update invite role (JWT owner) */
+    readonly UPDATE_INVITE_ROLE: "/v1/moderator-invites/:id/role";
+    /** PATCH /v1/moderator-invites/:id - Update invite role and/or description (JWT owner) */
+    readonly UPDATE_INVITE: "/v1/moderator-invites/:id";
+    /** GET /v1/moderator-invites/code/:code - Get invite by code (Public) */
+    readonly GET_INVITE_BY_CODE: "/v1/moderator-invites/code/:code";
+};
+/**
+ * Type-safe moderator endpoint keys
+ */
+export type ModeratorEndpointKey = keyof typeof MODERATOR_ENDPOINTS;
+/**
+ * Unified Content Flag/Report Endpoints (v5.8.0+, consolidated in v6.1.0, flattened in v6.2.0)
+ *
+ * Unified endpoint for all flag operations (formerly split across token-scoped and global).
+ *
+ * Authorization model:
+ * - Overseers/Admins: Can list ALL flags without tokenName filter
+ * - Token Owners/Moderators: Can list flags for specific tokens (tokenName required in query)
+ * - Anyone: Can create flags (tokenName provided in request body)
+ *
+ * Two-tier flag system:
+ * - Chat/Comment: One-click flag (reason optional) - Owner/Moderator review
+ * - Stream: Modal required (reason required) - Admin API key only
+ *
+ * @since 5.8.0
+ * @since 6.1.0 - Consolidated token-scoped and global endpoints into single /v1/flags
+ * @since 6.2.0 - Flattened to /v1/content-flags with tokenName in body/query
+ */
+export declare const FLAG_ENDPOINTS: {
+    /** POST /v1/content-flags - Create a flag/report (JWT - any user, tokenName in body) */
+    readonly CREATE: "/v1/content-flags";
+    /** GET /v1/content-flags - List flags (Overseer sees all; non-overseer must provide tokenName query param) */
+    readonly LIST: "/v1/content-flags";
+    /** POST /v1/content-flags/:id/dismiss - Dismiss a flag (Admin OR Overseer OR Token Owner/Moderator) */
+    readonly DISMISS: "/v1/content-flags/:id/dismiss";
+    /** POST /v1/content-flags/:id/action - Take action on flag (Admin OR Overseer OR Token Owner/Moderator) */
+    readonly ACTION: "/v1/content-flags/:id/action";
+};
+/**
+ * Type-safe flag endpoint keys
+ */
+export type FlagEndpointKey = keyof typeof FLAG_ENDPOINTS;
+/**
+ * Overseer Endpoints (v5.9.0+, flattened in v6.0.0+)
+ *
+ * Base paths:
+ * - /v1/overseer-invites - Invite management
+ * - /v1/overseers - Overseer management
+ * - /v1/overseer-summary - Platform summary
+ * - /v1/users - User list (merged from /v1/overseer/users)
+ * - /v1/users/:address/summary - User admin summary (merged from /v1/overseer/users/:address)
+ *
+ * Controllers: OverseerInvitesController, OverseerController, OverseerSummaryController, UserController
+ *
+ * Global platform oversight for Gala employees with MANAGER-level access to ALL tokens.
+ * Unlike moderators (token-scoped), overseers have platform-wide access.
+ * Flattened API routes for cleaner REST structure.
+ *
+ * Authorization:
+ * - Invite management: Admin API key OR existing Overseer (JWT)
+ * - Claiming: Any authenticated user (JWT)
+ * - Get invite by code: Public
+ * - Check own status: Any authenticated user (JWT)
+ *
+ * @since 5.9.0
+ * @since 6.0.0 - Flattened routes: /v1/overseer → /v1/overseer-invites, /v1/overseers, /v1/overseer-summary, /v1/users
+ */
+export declare const OVERSEER_ENDPOINTS: {
+    /** POST /v1/overseer-invites - Create an overseer invite (Admin OR Overseer) */
+    readonly CREATE_INVITE: "/v1/overseer-invites";
+    /** GET /v1/overseer-invites - List overseer invites (Admin OR Overseer) */
+    readonly LIST_INVITES: "/v1/overseer-invites";
+    /** GET /v1/overseer-invites/code/:code - Get invite by code (Public) */
+    readonly GET_INVITE_BY_CODE: "/v1/overseer-invites/code/:code";
+    /** POST /v1/overseer-invites/claim - Claim an invite (JWT) */
+    readonly CLAIM_INVITE: "/v1/overseer-invites/claim";
+    /** DELETE /v1/overseer-invites/:id - Revoke an invite (Admin OR Overseer) */
+    readonly REVOKE_INVITE: "/v1/overseer-invites/:id";
+    /** GET /v1/overseers - List all overseers (Admin OR Overseer) */
+    readonly LIST_OVERSEERS: "/v1/overseers";
+    /** POST /v1/overseers - Create overseer directly (Admin OR Overseer) */
+    readonly CREATE_OVERSEER_DIRECT: "/v1/overseers";
+    /** DELETE /v1/overseers/:address - Revoke an overseer (Admin OR Overseer) */
+    readonly REVOKE_OVERSEER: "/v1/overseers/:address";
+    /** GET /v1/overseers/me - Check own overseer status (JWT) */
+    readonly GET_MY_STATUS: "/v1/overseers/me";
+    /** GET /v1/overseer-summary - Get platform summary (Admin OR Overseer) */
+    readonly GET_SUMMARY: "/v1/overseer-summary";
+    /** GET /v1/overseer-summary/bans - Get ban stats (Admin OR Overseer) */
+    readonly GET_BAN_STATS: "/v1/overseer-summary/bans";
+    /** GET /v1/overseer-summary/token-bans - Get token ban stats (Admin OR Overseer) */
+    readonly GET_TOKEN_BAN_STATS: "/v1/overseer-summary/token-bans";
+    /** GET /v1/overseer-summary/invites - Get invite stats (Admin OR Overseer) */
+    readonly GET_INVITE_STATS: "/v1/overseer-summary/invites";
+    /** GET /v1/overseer-summary/flags - Get flag stats (Admin OR Overseer) */
+    readonly GET_FLAG_STATS: "/v1/overseer-summary/flags";
+    /** GET /v1/overseer-summary/users - Get user stats (Admin OR Overseer) */
+    readonly GET_USER_STATS: "/v1/overseer-summary/users";
+    /** GET /v1/users - List users with activity metrics (Admin OR Overseer) */
+    readonly LIST_USERS: "/v1/users";
+    /** GET /v1/users/:address/summary - Get user profile and summary (Admin OR Overseer) */
+    readonly GET_USER_SUMMARY: "/v1/users/:address/summary";
+    /** DELETE /v1/cache/flush/address/:address - Flush cache by address (Admin OR Overseer) */
+    readonly FLUSH_CACHE_BY_ADDRESS: "/v1/cache/flush/address/:address";
+    /** DELETE /v1/cache/flush/token/:tokenName - Flush cache by token (Admin OR Overseer) */
+    readonly FLUSH_CACHE_BY_TOKEN: "/v1/cache/flush/token/:tokenName";
+    /** DELETE /v1/cache/flush/all - Flush all cache (Admin OR Overseer, requires confirm=true) */
+    readonly FLUSH_ALL_CACHE: "/v1/cache/flush/all";
+    /** DELETE /v1/cache/flush/wallet-aliases/:address - Flush wallet-alias cache for one address (Admin OR Overseer) */
+    readonly FLUSH_WALLET_ALIAS_BY_ADDRESS: "/v1/cache/flush/wallet-aliases/:address";
+    /** DELETE /v1/cache/flush/wallet-aliases - Flush all wallet-alias cache entries (Admin OR Overseer, requires confirm=true) */
+    readonly FLUSH_WALLET_ALIASES: "/v1/cache/flush/wallet-aliases";
+};
+/**
+ * Type-safe overseer endpoint keys
+ */
+export type OverseerEndpointKey = keyof typeof OVERSEER_ENDPOINTS;
+/**
+ * Token Ban Endpoints (v6.x.0+)
+ *
+ * Base path: /v1/token-bans
+ * Controller: TokenBanController
+ *
+ * Platform-wide token banning for overseers. Banned tokens are hidden from ALL
+ * listings (including creator's profile) and have actions blocked (comments,
+ * streaming, chat). Trading is NOT blocked (GalaChain handles that).
+ *
+ * Authorization: Admin API key OR authenticated Overseer (JWT)
+ *
+ * @since 6.x.0
+ */
+export declare const TOKEN_BAN_ENDPOINTS: {
+    /** POST /v1/token-bans - Ban a token (Admin OR Overseer) */
+    readonly CREATE_BAN: "/v1/token-bans";
+    /** GET /v1/token-bans - List all token bans (Admin OR Overseer) */
+    readonly LIST_BANS: "/v1/token-bans";
+    /** GET /v1/token-bans/:tokenName - Get ban details (Admin OR Overseer) */
+    readonly GET_BAN: "/v1/token-bans/:tokenName";
+    /** DELETE /v1/token-bans/:tokenName - Remove token ban (Admin OR Overseer) */
+    readonly REMOVE_BAN: "/v1/token-bans/:tokenName";
+};
+/**
+ * Type-safe token ban endpoint keys
+ */
+export type TokenBanEndpointKey = keyof typeof TOKEN_BAN_ENDPOINTS;
+/**
+ * Content Reaction Endpoints (v5.12.0+, deprecated)
+ *
+ * Base path: /reactions (legacy)
+ * Controller: ContentReactionsController
+ *
+ * Persistent reactions on pool messages (chat and comments).
+ * Unlike stream reactions (ephemeral emoji bursts), content reactions
+ * are stored and displayed as counts/previews on messages.
+ *
+ * Deprecated: Use TOKEN_REACTION_ENDPOINTS instead
+ *
+ * @since 5.12.0
+ * @deprecated Use TOKEN_REACTION_ENDPOINTS
+ */
+export declare const REACTION_ENDPOINTS: {
+    /** Deprecated: Use TOKEN_REACTION_ENDPOINTS.ADD_REACTION instead */
+    readonly ADD_REACTION: "/reactions";
+    /** Deprecated: Use TOKEN_REACTION_ENDPOINTS.REMOVE_REACTION instead */
+    readonly REMOVE_REACTION: "/reactions/:messageId/:reactionType";
+};
+/**
+ * Type-safe reaction endpoint keys
+ */
+export type ReactionEndpointKey = keyof typeof REACTION_ENDPOINTS;
+/**
+ * Token-Agnostic Content Reaction Endpoints (v6.x.0+, migrated to /v1/reactions in v9.x.0+)
+ *
+ * Base path: /v1/reactions
+ * Controller: ContentReactionsController
+ *
+ * Persistent reactions on messages (chat and comments).
+ * Unlike stream reactions (ephemeral emoji bursts), content reactions
+ * are stored and displayed as counts/previews on messages.
+ *
+ * Token context is resolved from the messageId on the backend,
+ * so tokenName is optional in request bodies.
+ *
+ * @since 6.x.0
+ * @since 9.x.0 - Migrated from /v1/tokens/:tokenName/reactions to /v1/reactions
+ */
+export declare const TOKEN_REACTION_ENDPOINTS: {
+    /** POST /v1/reactions - Add a reaction (JWT or API key) */
+    readonly ADD_REACTION: "/v1/reactions";
+    /** DELETE /v1/reactions - Remove reaction (JWT or API key) */
+    readonly REMOVE_REACTION: "/v1/reactions";
+};
+/**
+ * Type-safe token reaction endpoint keys
+ */
+export type TokenReactionEndpointKey = keyof typeof TOKEN_REACTION_ENDPOINTS;
+/**
+ * Trades Query Endpoints (v6.2.0+)
+ *
+ * Dedicated endpoint for trade queries with flexible filtering.
+ * Supports filtering by tokenName, userAddress, or both.
+ *
+ * @since 6.2.0
+ */
+export declare const TRADES_QUERY_ENDPOINTS: {
+    /** GET /v1/trades - Fetch trades with tokenName/userAddress filters (Public) */
+    readonly GET_TRADES: "/v1/trades";
+};
+/**
+ * Type-safe trades query endpoint keys
+ */
+export type TradesQueryEndpointKey = keyof typeof TRADES_QUERY_ENDPOINTS;
+/**
+ * Unified Messages Endpoints (v7.0.0+)
+ *
+ * Base path: /v1/messages
+ * Controller: MessagesController
+ *
+ * Unified endpoint for all message types (CHAT and COMMENT).
+ * Replaces the separate /v1/comments, /v1/chat-messages, and
+ * /v1/tokens/:tokenName/messages endpoints.
+ *
+ * Query parameters:
+ * - type: 'CHAT' | 'COMMENT' - Filter by message type
+ * - tokenName: string - Filter by token
+ * - userAddress: string - Filter by user
+ * - limit: number - Pagination limit
+ * - cursor: string - Pagination cursor
+ *
+ * @since 7.0.0
+ */
+export declare const MESSAGES_ENDPOINTS: {
+    /** GET /v1/messages - Query messages with type/tokenName/userAddress filters (Public) */
+    readonly GET_MESSAGES: "/v1/messages";
+    /** POST /v1/messages - Create a message (JWT) - type required in body */
+    readonly CREATE_MESSAGE: "/v1/messages";
+    /** PUT /v1/messages/:id - Update a message (JWT, author only) */
+    readonly UPDATE_MESSAGE: "/v1/messages/:id";
+    /** DELETE /v1/messages/:id - Delete a message (JWT or API key) */
+    readonly DELETE_MESSAGE: "/v1/messages/:id";
+    /** GET /v1/messages/pinned - Get pinned message for a token (Public) */
+    readonly GET_PINNED: "/v1/messages/pinned";
+    /** POST /v1/messages/:id/pin - Pin a message (Owner/Mod) */
+    readonly PIN_MESSAGE: "/v1/messages/:id/pin";
+    /** POST /v1/messages/:id/unpin - Unpin a message (Owner/Mod) */
+    readonly UNPIN_MESSAGE: "/v1/messages/:id/unpin";
+    /** GET /v1/messages/stats - Get platform-wide message statistics (Admin OR Overseer) */
+    readonly GET_MESSAGE_STATS: "/v1/messages/stats";
+};
+/**
+ * Type-safe messages endpoint keys
+ */
+export type MessagesEndpointKey = keyof typeof MESSAGES_ENDPOINTS;
+/**
+ * Restricted Token Names Endpoints (v7.0.0+)
+ *
+ * Base path: /v1/restricted-token-names
+ * Controller: RestrictedNamesController
+ *
+ * Simplified API for managing restricted token names.
+ * Stores a single newline-separated text blob of restricted words.
+ * Only overseers can view/manage these restrictions.
+ *
+ * @since 7.0.0 - Simplified from CRUD to GET/PUT
+ */
+export declare const RESTRICTED_NAMES_ENDPOINTS: {
+    /** GET /v1/restricted-token-names - Get restricted names content (Overseer only) */
+    readonly GET: "/v1/restricted-token-names";
+    /** PUT /v1/restricted-token-names - Update restricted names content (Overseer only) */
+    readonly UPDATE: "/v1/restricted-token-names";
+};
+/**
+ * Type-safe restricted names endpoint keys
+ */
+export type RestrictedNamesEndpointKey = keyof typeof RESTRICTED_NAMES_ENDPOINTS;
+/**
+ * Token-Scoped Trades Endpoints (v6.x.0+)
+ *
+ * Base path: /v1/tokens/:tokenName/trades
+ * Controller: TokenTradesController
+ *
+ * Fetch trades for a specific token.
+ * Public - no authentication required.
+ *
+ * @since 6.x.0
+ */
+export declare const TOKEN_TRADES_ENDPOINTS: {
+    /** GET /v1/tokens/:tokenName/trades - Get trades for token (Public) */
+    readonly GET_TRADES: "/v1/tokens/:tokenName/trades";
+};
+/**
+ * Type-safe token trades endpoint keys
+ */
+export type TokenTradesEndpointKey = keyof typeof TOKEN_TRADES_ENDPOINTS;
+/**
+ * Global Trades Query Endpoints (v6.x.0+)
+ *
+ * Base path: /v1/trades
+ * Controller: TradesController
+ *
+ * Query trades across all tokens with optional filtering by tokenName or userAddress.
+ * Public - no authentication required.
+ *
+ * @since 6.x.0
+ */
+export declare const GLOBAL_TRADES_ENDPOINTS: {
+    /** GET /v1/trades - Query trades globally (Public) */
+    readonly GET_TRADES: "/v1/trades";
+};
+/**
+ * Type-safe global trades endpoint keys
+ */
+export type GlobalTradesEndpointKey = keyof typeof GLOBAL_TRADES_ENDPOINTS;
+/**
+ * Webhook Endpoints (v6.x.0+)
+ *
+ * Base paths:
+ * - /v1/webhooks - Production webhooks
+ * - /v1/dev/webhooks - Development/testing webhooks
+ *
+ * External integrations (Mux, etc.) and developer testing.
+ *
+ * @since 6.x.0
+ */
+export declare const WEBHOOK_ENDPOINTS: {
+    /** POST /v1/webhooks/mux - Mux streaming webhook (Public) */
+    readonly MUX_WEBHOOK: "/v1/webhooks/mux";
+    /** POST /v1/dev/webhooks/simulate - Simulate webhook for testing (JWT) */
+    readonly SIMULATE_WEBHOOK: "/v1/dev/webhooks/simulate";
+};
+/**
+ * Type-safe webhook endpoint keys
+ */
+export type WebhookEndpointKey = keyof typeof WEBHOOK_ENDPOINTS;
+/**
+ * Chat Status Endpoints (v7.0.0+)
+ *
+ * Chat status operations for enabling/disabling chat on streams.
+ * These are separate from message CRUD (which uses MESSAGES_ENDPOINTS).
+ *
+ * Per-token endpoints: /live/:tokenName/chat
+ * Global endpoints: /live/chat
+ *
+ * @since 7.0.0
+ */
+export declare const CHAT_STATUS_ENDPOINTS: {
+    /** GET /live/:tokenName/chat - Get chat status (Public) */
+    readonly GET_STATUS: "/live/:tokenName/chat";
+    /** POST /live/:tokenName/chat - Enable chat (Admin or Owner) */
+    readonly ENABLE: "/live/:tokenName/chat";
+    /** POST /live/:tokenName/chat - Disable chat (Admin or Owner) */
+    readonly DISABLE: "/live/:tokenName/chat";
+    /** GET /live/chat - Get global chat status (Public) */
+    readonly GET_GLOBAL_STATUS: "/live/chat";
+    /** POST /live/chat - Enable global chat (Admin) */
+    readonly ENABLE_GLOBAL: "/live/chat";
+    /** POST /live/chat - Disable global chat (Admin) */
+    readonly DISABLE_GLOBAL: "/live/chat";
+    /** PATCH /live/:tokenName/chat/slow-mode - Set slow mode interval (Mod/Manager/Owner) */
+    readonly SLOW_MODE: "/live/:tokenName/chat/slow-mode";
+    /** GET /live/:tokenName/engagement-stats - Get engagement stats (Public) */
+    readonly GET_ENGAGEMENT_STATS: "/live/:tokenName/engagement-stats";
+};
+/**
+ * Type-safe chat status endpoint keys
+ */
+export type ChatStatusEndpointKey = keyof typeof CHAT_STATUS_ENDPOINTS;
+/**
+ * Events Ingress Endpoints (v8.2.0+)
+ *
+ * Base path: /v1/events
+ * Controller: EventsController
+ *
+ * SDK-side event batching for tracking user activities, transactions, and interactions.
+ * Events are buffered client-side and submitted in batches to reduce network overhead.
+ *
+ * @since 8.2.0
+ */
+export declare const EVENTS_ENDPOINTS: {
+    /** POST /v1/events - Submit batch of events (Public, SDK batching) */
+    readonly SUBMIT: "/v1/events";
+    /** GET /v1/events - Query historical events (Overseer only) */
+    readonly QUERY: "/v1/events";
+};
+/**
+ * Type-safe events endpoint keys
+ */
+export type EventsEndpointKey = keyof typeof EVENTS_ENDPOINTS;
+/**
+ * AI Moderation Endpoints (v6.15.0+)
+ *
+ * Base path: /v1/ai-moderation
+ * Controller: AIModerationController
+ *
+ * Manages AI-powered content moderation with tiered scanning
+ * for cost optimization. Quick scans for initial assessment, detailed
+ * scans for content requiring closer review.
+ *
+ * Authorization: Admin API key OR authenticated Overseer (JWT)
+ *
+ * @since 6.15.0
+ */
+export declare const AI_MODERATION_ENDPOINTS: {
+    /** GET /v1/ai-moderation/settings - Get AI moderation settings */
+    readonly GET_SETTINGS: "/v1/ai-moderation/settings";
+    /** POST /v1/ai-moderation/settings - Update AI moderation settings */
+    readonly UPDATE_SETTINGS: "/v1/ai-moderation/settings";
+    /** GET /v1/ai-moderation/flags/:flagId - Get AI moderation for a flag */
+    readonly GET_MODERATION: "/v1/ai-moderation/flags/:flagId";
+    /** POST /v1/ai-moderation/flags/:flagId/analyze - Trigger AI moderation for a flag */
+    readonly TRIGGER_MODERATION: "/v1/ai-moderation/flags/:flagId/analyze";
+    /** GET /v1/ai-moderation/status - Get AI system status */
+    readonly GET_STATUS: "/v1/ai-moderation/status";
+};
+/**
+ * Type-safe AI moderation endpoint keys
+ */
+export type AIModerationEndpointKey = keyof typeof AI_MODERATION_ENDPOINTS;
+/**
+ * Platform Stats Endpoints (v9.0.0+)
+ *
+ * Base path: /v1/stats
+ * Controller: StatsController
+ *
+ * Platform-wide statistics including trading volume and token counts.
+ * Public endpoint - no authentication required.
+ *
+ * @since 9.0.0
+ */
+export declare const STATS_ENDPOINTS: {
+    /** GET /v1/stats - Get platform-wide statistics */
+    readonly GET_STATS: "/v1/stats";
+};
+/**
+ * Type-safe stats endpoint keys
+ */
+export type StatsEndpointKey = keyof typeof STATS_ENDPOINTS;
+/**
+ * Trading Quotes Endpoints (v9.1.0+)
+ *
+ * Base path: /v1/trading
+ * Controller: TradingQuotesController
+ *
+ * Backend-proxied trading quote endpoints that use local bonding curve math
+ * and caching. Faster than direct GalaChain calls.
+ *
+ * All endpoints are @Public() — no authentication required.
+ *
+ * @since 9.1.0
+ */
+export declare const TRADING_QUOTE_ENDPOINTS: {
+    /** GET /v1/trading/fee - Fetch launchpad fee (cached 1 hour, Public) */
+    readonly GET_FEE: "/v1/trading/fee";
+    /** GET /v1/trading/sale-details?tokenName= - Fetch sale details (cached 10s, Public) */
+    readonly GET_SALE_DETAILS: "/v1/trading/sale-details";
+    /** GET /v1/trading/quote?tokenName=&amount=&type=&method= - Get trade quote (local math, no chain call, Public) */
+    readonly GET_QUOTE: "/v1/trading/quote";
+    /** GET /v1/trading/premint-quote?amount= - Get pre-mint quote (supply=0, no chain call, Public) */
+    readonly GET_PREMINT_QUOTE: "/v1/trading/premint-quote";
+};
+/**
+ * Type-safe trading quote endpoint keys
+ */
+export type TradingQuoteEndpointKey = keyof typeof TRADING_QUOTE_ENDPOINTS;
+/**
+ * Weekly Challenge Endpoints (v9.0.0+)
+ *
+ * Base path: /weekly-challenge
+ * Controller: WeeklyChallengeController
+ *
+ * Weekly challenge leaderboard tracking token market cap increases.
+ * Public endpoint - no authentication required.
+ *
+ * @since 9.0.0
+ */
+export declare const WEEKLY_CHALLENGE_ENDPOINTS: {
+    /** GET /weekly-challenge - Get current weekly challenge leaderboard */
+    readonly GET_LEADERBOARD: "/weekly-challenge";
+    /** GET /weekly-challenge/history/:vaultAddress - Get token's weekly history */
+    readonly GET_TOKEN_HISTORY: "/weekly-challenge/history/:vaultAddress";
+};
+/**
+ * Type-safe weekly challenge endpoint keys
+ */
+export type WeeklyChallengeEndpointKey = keyof typeof WEEKLY_CHALLENGE_ENDPOINTS;
+//# sourceMappingURL=endpoints.d.ts.map