@gala-chain/gswap-sdk 1.1.1 → 1.2.0-rc.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +42 -9
- package/dist/browser/_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/defineProperty.js +1 -0
- package/dist/browser/_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/toPrimitive.js +1 -0
- package/dist/browser/_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/toPropertyKey.js +1 -0
- package/dist/browser/_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/typeof.js +1 -0
- package/dist/browser/classes/apply_results.js +2 -0
- package/dist/browser/classes/apply_results.js.map +1 -0
- package/dist/browser/classes/assets.js +2 -0
- package/dist/browser/classes/assets.js.map +1 -0
- package/dist/browser/classes/dex_fees.js +2 -0
- package/dist/browser/classes/dex_fees.js.map +1 -0
- package/dist/browser/classes/error_catalog.js +2 -0
- package/dist/browser/classes/error_catalog.js.map +1 -0
- package/dist/browser/classes/error_phase_table.js +2 -0
- package/dist/browser/classes/error_phase_table.js.map +1 -0
- package/dist/browser/classes/error_phases.js +2 -0
- package/dist/browser/classes/error_phases.js.map +1 -0
- package/dist/browser/classes/gateway.js +2 -0
- package/dist/browser/classes/gateway.js.map +1 -0
- package/dist/browser/classes/gdex_stream.js +2 -0
- package/dist/browser/classes/gdex_stream.js.map +1 -0
- package/dist/browser/classes/gswap.js +2 -0
- package/dist/browser/classes/gswap.js.map +1 -0
- package/dist/browser/classes/gswap_sdk_error.js +2 -0
- package/dist/browser/classes/gswap_sdk_error.js.map +1 -0
- package/dist/browser/classes/http_client.js +2 -0
- package/dist/browser/classes/http_client.js.map +1 -0
- package/dist/browser/classes/pending_swap_fate.js +2 -0
- package/dist/browser/classes/pending_swap_fate.js.map +1 -0
- package/dist/browser/classes/pending_swaps.js +2 -0
- package/dist/browser/classes/pending_swaps.js.map +1 -0
- package/dist/browser/classes/pools.js +2 -0
- package/dist/browser/classes/pools.js.map +1 -0
- package/dist/browser/classes/positions.js +2 -0
- package/dist/browser/classes/positions.js.map +1 -0
- package/dist/browser/classes/quoting.js +2 -0
- package/dist/browser/classes/quoting.js.map +1 -0
- package/dist/browser/classes/shadow_submit.js +2 -0
- package/dist/browser/classes/shadow_submit.js.map +1 -0
- package/dist/browser/classes/signers.js +2 -0
- package/dist/browser/classes/signers.js.map +1 -0
- package/dist/browser/classes/storage_adapters.js +2 -0
- package/dist/browser/classes/storage_adapters.js.map +1 -0
- package/dist/browser/classes/submitted_transaction.js +2 -0
- package/dist/browser/classes/submitted_transaction.js.map +1 -0
- package/dist/browser/classes/swaps.js +2 -0
- package/dist/browser/classes/swaps.js.map +1 -0
- package/dist/browser/classes/symbols.js +2 -0
- package/dist/browser/classes/symbols.js.map +1 -0
- package/dist/browser/index.js +1 -5
- package/dist/browser/types/env.js +2 -0
- package/dist/browser/types/env.js.map +1 -0
- package/dist/browser/types/fees.js +2 -0
- package/dist/browser/types/fees.js.map +1 -0
- package/dist/browser/utils/axios_requestor.js +2 -0
- package/dist/browser/utils/axios_requestor.js.map +1 -0
- package/dist/browser/utils/chain_dto_signing.js +3 -0
- package/dist/browser/utils/chain_dto_signing.js.map +1 -0
- package/dist/browser/utils/class_key.js +2 -0
- package/dist/browser/utils/class_key.js.map +1 -0
- package/dist/browser/utils/classification.js +2 -0
- package/dist/browser/utils/classification.js.map +1 -0
- package/dist/browser/utils/confirmation_schedule.js +2 -0
- package/dist/browser/utils/confirmation_schedule.js.map +1 -0
- package/dist/browser/utils/confirmation_state.js +2 -0
- package/dist/browser/utils/confirmation_state.js.map +1 -0
- package/dist/browser/utils/debug.js +2 -0
- package/dist/browser/utils/debug.js.map +1 -0
- package/dist/browser/utils/dto_builders.js +2 -0
- package/dist/browser/utils/dto_builders.js.map +1 -0
- package/dist/browser/utils/eip712.js +4 -0
- package/dist/browser/utils/eip712.js.map +1 -0
- package/dist/browser/utils/error_brand.js +2 -0
- package/dist/browser/utils/error_brand.js.map +1 -0
- package/dist/browser/utils/ethers_provider.js +2 -0
- package/dist/browser/utils/ethers_provider.js.map +1 -0
- package/dist/browser/utils/failure_classification.js +2 -0
- package/dist/browser/utils/failure_classification.js.map +1 -0
- package/dist/browser/utils/failure_guards.js +2 -0
- package/dist/browser/utils/failure_guards.js.map +1 -0
- package/dist/browser/utils/failure_outcomes.js +2 -0
- package/dist/browser/utils/failure_outcomes.js.map +1 -0
- package/dist/browser/utils/failure_view.js +2 -0
- package/dist/browser/utils/failure_view.js.map +1 -0
- package/dist/browser/utils/fetch_failure.js +2 -0
- package/dist/browser/utils/fetch_failure.js.map +1 -0
- package/dist/browser/utils/lenient.js +2 -0
- package/dist/browser/utils/lenient.js.map +1 -0
- package/dist/browser/utils/ordering.js +2 -0
- package/dist/browser/utils/ordering.js.map +1 -0
- package/dist/browser/utils/pre_send.js +2 -0
- package/dist/browser/utils/pre_send.js.map +1 -0
- package/dist/browser/utils/reconnection.js +2 -0
- package/dist/browser/utils/reconnection.js.map +1 -0
- package/dist/browser/utils/server_message.js +2 -0
- package/dist/browser/utils/server_message.js.map +1 -0
- package/dist/browser/utils/shadow_errors.js +2 -0
- package/dist/browser/utils/shadow_errors.js.map +1 -0
- package/dist/browser/utils/signing.js +3 -0
- package/dist/browser/utils/signing.js.map +1 -0
- package/dist/browser/utils/submit_state.js +2 -0
- package/dist/browser/utils/submit_state.js.map +1 -0
- package/dist/browser/utils/tick_align.js +2 -0
- package/dist/browser/utils/tick_align.js.map +1 -0
- package/dist/browser/utils/tick_math.js +2 -0
- package/dist/browser/utils/tick_math.js.map +1 -0
- package/dist/browser/utils/tick_range.js +2 -0
- package/dist/browser/utils/tick_range.js.map +1 -0
- package/dist/browser/utils/ticks.js +2 -0
- package/dist/browser/utils/ticks.js.map +1 -0
- package/dist/browser/utils/transport.js +2 -0
- package/dist/browser/utils/transport.js.map +1 -0
- package/dist/browser/utils/typed_data.js +2 -0
- package/dist/browser/utils/typed_data.js.map +1 -0
- package/dist/browser/utils/unique_key.js +2 -0
- package/dist/browser/utils/unique_key.js.map +1 -0
- package/dist/browser/utils/unique_key_syntax.js +2 -0
- package/dist/browser/utils/unique_key_syntax.js.map +1 -0
- package/dist/browser/utils/validation.js +2 -0
- package/dist/browser/utils/validation.js.map +1 -0
- package/dist/browser/utils/wallet_rejection.js +2 -0
- package/dist/browser/utils/wallet_rejection.js.map +1 -0
- package/dist/browser/version.js +2 -0
- package/dist/browser/version.js.map +1 -0
- package/dist/browser/wallet.js +2 -0
- package/dist/browser/wallet.js.map +1 -0
- package/dist/index.cjs +8064 -2479
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +4659 -652
- package/dist/index.d.ts +4659 -652
- package/dist/index.mjs +7896 -2427
- package/dist/index.mjs.map +1 -1
- package/dist/wallet.cjs +159 -0
- package/dist/wallet.cjs.map +1 -0
- package/dist/wallet.d.cts +74 -0
- package/dist/wallet.d.ts +74 -0
- package/dist/wallet.mjs +156 -0
- package/dist/wallet.mjs.map +1 -0
- package/package.json +38 -10
- package/dist/browser/index.js.map +0 -1
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"gdex_stream.js","names":[],"sources":["../../../src/classes/gdex_stream.ts"],"sourcesContent":["import { GSWAP_ENVIRONMENTS } from '../types/env.js';\nimport { debugLog } from '../utils/debug.js';\nimport { ReconnectionBackoff } from '../utils/reconnection.js';\nimport { GSwapSDKError } from './gswap_sdk_error.js';\n\nconst GDEX_SUBPROTOCOL = 'gdex.jsonrpc.v1';\nconst RATE_LIMITED = -32003;\nconst MAX_RESUBSCRIBE_RATE_RETRIES = 5;\nconst WEBSOCKET_OPEN = 1;\n\n/** Options for {@link GdexStreamService}. */\nexport interface GdexStreamConfig {\n /** Stream endpoint. Defaults to production (`wss://dex-backend-prod1.defi.gala.com/ws`). */\n url?: string | undefined;\n /** Reconnect attempts after an unexpected close. Default 5. */\n reconnectAttempts?: number | undefined;\n /** Delay before the first reconnect attempt; doubles each attempt. Default 2000 ms. */\n reconnectDelayMs?: number | undefined;\n /** How long a request waits for its response. Default 15000 ms. */\n requestTimeoutMs?: number | undefined;\n /**\n * A standards-compatible WebSocket constructor. Required on Node.js older than 22, which has no\n * global `WebSocket` (pass the one from the `ws` package).\n */\n webSocketImpl?: unknown;\n /**\n * Presents `x-api-key` on the WebSocket upgrade request, which defi-backend uses to serve the\n * PRIVILEGED view (shadow swaps with the wallet unredacted). Without it, or with a wrong key, the\n * connection is simply public: the server never says whether a privileged mode exists.\n *\n * It must travel as an HTTP header, because the server reads no other credential, and a browser\n * `WebSocket` cannot set headers. So this option needs a constructor that accepts them as its\n * third argument (`{ headers }`): the `ws` package on Node.js, or React Native's built-in\n * `WebSocket`. It therefore REQUIRES `webSocketImpl` (the platform default is never assumed to\n * honor headers, and a key that is silently dropped would look like a working privileged\n * connection); the constructor throws otherwise. Use it from server-side code only: a key\n * shipped inside a browser or app bundle is not a secret. Browser clients stay public.\n */\n apiKey?: string | undefined;\n}\n\n/** The channels of the realtime stream. */\nexport type GdexChannel = 'pool' | 'balance' | 'poolCreated' | 'swap' | 'liquidity' | 'blocks';\n\n/** A pool named by its two token class keys (pipe form) and fee tier. */\nexport interface GdexPoolKey {\n token0ClassKey: string;\n token1ClassKey: string;\n fee: number;\n}\n\n/** A pool named either by its key or by its hash (`v2:<poolRef>` for a v2 pool). */\nexport type GdexPoolSelector = { pool: GdexPoolKey } | { poolHash: string };\n\n/** Options common to every subscription. */\nexport interface GdexSubscribeOptions {\n /** Send the current state right after the subscribe response. */\n snapshot?: boolean | undefined;\n /** Trim each event to these fields; identity and envelope fields always stay. */\n fields?: string[] | undefined;\n}\n\n/** Filters for {@link GdexStreamService.subscribeLiquidity}; all optional. */\nexport interface GdexLiquidityFilter {\n /** Only this pool, named by its key. */\n pool?: GdexPoolKey | undefined;\n /** Only this pool, named by its hash (`v2:<poolRef>` for a v2 pool). */\n poolHash?: string | undefined;\n /** Only events for this LP wallet (the position's owner). */\n owner?: string | undefined;\n /** Only this transaction. */\n transactionId?: string | undefined;\n /** Contract version filter. */\n version?: 'v1' | 'v2' | 'all' | undefined;\n}\n\n/** One committed add, remove or collect, as the `liquidity` channel reports it. */\nexport interface GdexLiquidityEvent {\n version: 'v1' | 'v2';\n pool: GdexPoolKey;\n poolHash: string;\n transactionId: string;\n /** `add`, `remove` or `collect`. */\n action: 'add' | 'remove' | 'collect';\n /** The position's owner (the LP wallet). */\n owner: string;\n /** v1: the position id. v2: the chain position key `<pool>|<tickLow>|<tickHigh>|<owner>`. */\n positionId?: string;\n tickLower?: number;\n tickUpper?: number;\n /** v2 only: the position's liquidity after the operation; `\"0\"` means it is closed. */\n liquidityAfter?: string;\n /** Principal moved: deposited by an add, withdrawn by a remove, `\"0\"` for a collect. */\n amount0: string;\n amount1: string;\n /** Fees paid out. v2: always present (`\"0\"` for an add). v1: present on a collect only. */\n fees0?: string;\n fees1?: string;\n /** v2 only. */\n token0Symbol?: string;\n token1Symbol?: string;\n blockNumber: number;\n timestamp: string;\n}\n\nconst LIQUIDITY_ACTIONS: readonly unknown[] = ['add', 'remove', 'collect'];\n\n/** Whether a stream payload carries every field of a {@link GdexLiquidityEvent}. */\nexport function isGdexLiquidityEvent(\n value: Record<string, unknown>,\n): value is Record<string, unknown> & GdexLiquidityEvent {\n const { pool } = value;\n return (\n (value['version'] === 'v1' || value['version'] === 'v2') &&\n typeof pool === 'object' &&\n pool !== null &&\n typeof value['poolHash'] === 'string' &&\n typeof value['transactionId'] === 'string' &&\n LIQUIDITY_ACTIONS.includes(value['action']) &&\n typeof value['owner'] === 'string' &&\n typeof value['amount0'] === 'string' &&\n typeof value['amount1'] === 'string' &&\n typeof value['blockNumber'] === 'number' &&\n typeof value['timestamp'] === 'string'\n );\n}\n\n/** A live subscription. */\nexport interface GdexSubscription {\n subscriptionId: string;\n unsubscribe(): Promise<void>;\n}\n\n/** A JSON-RPC error answered by the stream. */\nexport class GdexStreamError extends Error {\n /** The JSON-RPC error code. */\n readonly code: number;\n /** The error's optional `data` member, as the server sent it. */\n readonly data?: unknown;\n\n constructor(code: number, message: string, data?: unknown) {\n super(message);\n this.name = 'GdexStreamError';\n this.code = code;\n if (data !== undefined) this.data = data;\n }\n}\n\ninterface WebSocketLike {\n readonly readyState: number;\n send(data: string): void;\n close(code?: number, reason?: string): void;\n onopen: ((event: unknown) => void) | null;\n onmessage: ((event: { data: unknown }) => void) | null;\n onclose: ((event: { code?: number; reason?: string }) => void) | null;\n onerror: ((event: unknown) => void) | null;\n}\n\ninterface WebSocketConstructor {\n new (\n url: string,\n protocols?: string | string[],\n options?: { headers: Record<string, string> },\n ): WebSocketLike;\n}\n\ninterface PendingRequest {\n resolve(value: unknown): void;\n reject(error: Error): void;\n timeout: ReturnType<typeof setTimeout>;\n /**\n * Runs SYNCHRONOUSLY when the response frame is handled, before any frame that follows it in\n * the same read. Subscriptions register here: the server writes a snapshot right after the\n * subscribe response, and a runtime that delivers both frames without yielding to microtasks\n * (Node's `ws` does, for frames in one chunk) would otherwise drop the snapshot because the\n * awaiting caller has not registered the subscription yet.\n */\n onResult?: ((value: unknown) => void) | undefined;\n}\n\ntype EventCallback = (event: Record<string, unknown>) => void;\n\ninterface ActiveSubscription {\n serverId: string;\n readonly params: Record<string, unknown>;\n readonly callback: EventCallback;\n readonly handle: MutableGdexSubscription;\n active: boolean;\n}\n\ninterface MutableGdexSubscription extends GdexSubscription {\n subscriptionId: string;\n}\n\nfunction readSubscriptionId(value: unknown): string {\n const id =\n typeof value === 'object' && value !== null\n ? (value as { subscriptionId?: unknown }).subscriptionId\n : undefined;\n if (typeof id !== 'string') {\n throw new GdexStreamError(-32603, 'GDEX subscribe response is missing its subscriptionId');\n }\n return id;\n}\n\ninterface JsonRpcResponse {\n id?: unknown;\n method?: unknown;\n result?: unknown;\n error?: { code?: unknown; message?: unknown; data?: unknown };\n params?: unknown;\n}\n\n/**\n * Client for the gSwap realtime stream (gdex WebSocket Protocol v1): JSON-RPC 2.0 over one raw\n * WebSocket, with automatic reconnect and resubscribe.\n *\n * @example\n * ```typescript\n * const stream = new GdexStreamService();\n * await stream.connect();\n * await stream.subscribeLiquidity(event => console.log(event.action, event.owner), {\n * owner: 'client|618ae395c1c653111d3315be',\n * });\n * ```\n */\nexport class GdexStreamService {\n private readonly url: string;\n private readonly requestTimeoutMs: number;\n private readonly apiKey: string | undefined;\n private readonly webSocketConstructor: WebSocketConstructor;\n private readonly backoff: ReconnectionBackoff;\n private socket: WebSocketLike | undefined;\n private connectPromise: Promise<void> | undefined;\n private nextRequestId = 0;\n private readonly pending = new Map<number, PendingRequest>();\n private readonly subscriptionsByServerId = new Map<string, ActiveSubscription>();\n private readonly activeSubscriptions = new Set<ActiveSubscription>();\n private intentionalClose = false;\n private reconnecting = false;\n private reconnectTimer: ReturnType<typeof setTimeout> | undefined;\n private reconnectDelayResolve: (() => void) | undefined;\n\n constructor(config: GdexStreamConfig = {}) {\n this.url = config.url ?? GSWAP_ENVIRONMENTS.prod.dexBackendWsUrl;\n this.requestTimeoutMs = config.requestTimeoutMs ?? 15_000;\n this.backoff = new ReconnectionBackoff({\n maxAttempts: config.reconnectAttempts ?? 5,\n baseDelayMs: config.reconnectDelayMs ?? 2_000,\n });\n\n const implementation =\n config.webSocketImpl ?? (globalThis as { WebSocket?: unknown }).WebSocket;\n if (typeof implementation !== 'function') {\n throw new GSwapSDKError('STREAM_WEBSOCKET_UNAVAILABLE', {});\n }\n this.webSocketConstructor = implementation as WebSocketConstructor;\n if (config.apiKey !== undefined) {\n if (config.apiKey === '' || config.webSocketImpl === undefined) {\n throw new GSwapSDKError('STREAM_API_KEY_UNUSABLE', {});\n }\n this.apiKey = config.apiKey;\n }\n }\n\n /** Open the connection. Resolves at once when already connected. */\n connect(): Promise<void> {\n if (this.isConnected()) return Promise.resolve();\n if (this.connectPromise) return this.connectPromise;\n this.intentionalClose = false;\n this.clearReconnectTimer();\n this.connectPromise = this.openSocket();\n return this.connectPromise;\n }\n\n /** Close the connection and stop reconnecting. */\n disconnect(): void {\n this.intentionalClose = true;\n this.reconnecting = false;\n this.clearReconnectTimer();\n this.rejectPending(new GSwapSDKError('STREAM_DISCONNECTED', {}));\n const socket = this.socket;\n this.socket = undefined;\n this.connectPromise = undefined;\n socket?.close(1000, 'client disconnect');\n }\n\n /** `true` while the socket is open (false while connecting, reconnecting or after `disconnect()`). */\n isConnected(): boolean {\n return this.socket?.readyState === WEBSOCKET_OPEN;\n }\n\n /** Raw JSON-RPC escape hatch. */\n request<T = unknown>(method: string, params?: Record<string, unknown>): Promise<T> {\n return this.send<T>(method, params);\n }\n\n private send<T>(\n method: string,\n params: Record<string, unknown> | undefined,\n onResult?: (value: unknown) => void,\n ): Promise<T> {\n if (!this.isConnected() || !this.socket) {\n return Promise.reject(new GSwapSDKError('STREAM_NOT_CONNECTED', {}));\n }\n\n const id = ++this.nextRequestId;\n const frame: Record<string, unknown> = { jsonrpc: '2.0', id, method };\n if (params !== undefined) frame['params'] = params;\n\n return new Promise<T>((resolve, reject) => {\n const timeout = setTimeout(() => {\n this.pending.delete(id);\n reject(\n new GSwapSDKError('STREAM_REQUEST_TIMEOUT', { method, timeoutMs: this.requestTimeoutMs }),\n );\n }, this.requestTimeoutMs);\n this.pending.set(id, { resolve: (value) => resolve(value as T), reject, timeout, onResult });\n\n try {\n this.socket?.send(JSON.stringify(frame));\n } catch (error) {\n clearTimeout(timeout);\n this.pending.delete(id);\n reject(error instanceof Error ? error : new Error(String(error)));\n }\n });\n }\n\n /** `gdex_serverInfo`: the server's own description of itself, as it sends it. */\n serverInfo(): Promise<Record<string, unknown>> {\n return this.request('gdex_serverInfo');\n }\n\n /** `gdex_ping`: a round trip that answers `{ pong, serverTime }`. */\n ping(): Promise<{ pong: boolean; serverTime: string }> {\n return this.request('gdex_ping');\n }\n\n /** `gdex_getPool`: the current state of one pool, selected by its key or hash. */\n getPool(selector: GdexPoolSelector): Promise<Record<string, unknown>> {\n return this.request('gdex_getPool', selector);\n }\n\n /** `gdex_getBalance`: an owner's balances, or only the one of `tokenClassKey` when given. */\n getBalance(owner: string, tokenClassKey?: string): Promise<Record<string, unknown>> {\n return this.request(\n 'gdex_getBalance',\n tokenClassKey === undefined ? { owner } : { owner, tokenClassKey },\n );\n }\n\n /**\n * `gdex_getPositions`: an owner's positions, optionally in one pool, a page at a time. Pass the\n * returned `bookmark` back in as `bookmark` for the next page.\n */\n getPositions(opts: {\n owner: string;\n pool?: GdexPoolKey;\n poolHash?: string;\n limit?: number;\n bookmark?: string;\n }): Promise<{ positions: Record<string, unknown>[]; bookmark: string }> {\n return this.request('gdex_getPositions', opts);\n }\n\n /** `gdex_getBlockHeight`: the block number the server reports, with its timestamp. */\n getBlockHeight(): Promise<{ blockNumber: number; timestamp: string }> {\n return this.request('gdex_getBlockHeight');\n }\n\n /** `gdex_quote`: a quote over the stream; give exactly one of `amountIn` or `amountOut`. */\n quote(params: {\n tokenIn: string;\n tokenOut: string;\n fee?: number;\n amountIn?: string;\n amountOut?: string;\n }): Promise<Record<string, unknown>> {\n return this.request('gdex_quote', params);\n }\n\n /** `gdex_getToken`: the server's record of one token class, as it sends it. */\n getToken(tokenClassKey: string): Promise<Record<string, unknown>> {\n return this.request('gdex_getToken', { tokenClassKey });\n }\n\n /** One event per committed swap. Omit the pool to receive every pool's swaps. */\n subscribeSwaps(\n cb: (event: Record<string, unknown>) => void,\n opts: GdexSubscribeOptions & {\n pool?: GdexPoolKey;\n poolHash?: string;\n transactionId?: string;\n } = {},\n ): Promise<GdexSubscription> {\n return this.subscribe('swap', cb, opts);\n }\n\n /**\n * State changes of one pool (price, tick, reserves, liquidity). These events carry no acting wallet:\n * on v2 `creator` is whoever created the pool, not whoever just traded or added liquidity. For\n * \"who did it\", use {@link subscribeLiquidity} (`owner`) or {@link subscribeSwaps} (`sender`).\n */\n subscribePool(\n selector: GdexPoolSelector,\n cb: (event: Record<string, unknown>) => void,\n opts: GdexSubscribeOptions = {},\n ): Promise<GdexSubscription> {\n return this.subscribe('pool', cb, { ...selector, ...opts });\n }\n\n /** Balance changes of one wallet. */\n subscribeBalances(\n owner: string,\n cb: (event: Record<string, unknown>) => void,\n opts: GdexSubscribeOptions & { tokenClassKey?: string } = {},\n ): Promise<GdexSubscription> {\n return this.subscribe('balance', cb, { owner, ...opts });\n }\n\n /** Each newly created pool. */\n subscribePoolCreated(\n cb: (event: Record<string, unknown>) => void,\n opts: GdexSubscribeOptions & { tokenClassKey?: string } = {},\n ): Promise<GdexSubscription> {\n return this.subscribe('poolCreated', cb, opts);\n }\n\n /**\n * One event per committed AddLiquidity, RemoveLiquidity and CollectPositionFees, on both contract\n * versions. Every filter is optional; with none, every liquidity event arrives. These events never\n * appear on {@link subscribeSwaps}. There is no snapshot: read positions with {@link getPositions}.\n * Deduplicate by `transactionId` plus `positionId`: a v1 BatchSubmit can hold several operations\n * under one transaction id.\n */\n subscribeLiquidity(\n cb: (event: GdexLiquidityEvent) => void,\n opts: GdexSubscribeOptions & GdexLiquidityFilter = {},\n ): Promise<GdexSubscription> {\n return this.subscribe(\n 'liquidity',\n (event) => {\n if (isGdexLiquidityEvent(event)) cb(event);\n else debugLog('Ignoring a malformed liquidity event from the GDEX stream');\n },\n opts,\n );\n }\n\n /** Each block-height advance. */\n subscribeBlocks(\n cb: (event: Record<string, unknown>) => void,\n opts: GdexSubscribeOptions = {},\n ): Promise<GdexSubscription> {\n return this.subscribe('blocks', cb, opts);\n }\n\n private openSocket(): Promise<void> {\n return new Promise<void>((resolve, reject) => {\n let opened = false;\n const socket =\n this.apiKey === undefined\n ? new this.webSocketConstructor(this.url, GDEX_SUBPROTOCOL)\n : new this.webSocketConstructor(this.url, GDEX_SUBPROTOCOL, {\n headers: { 'x-api-key': this.apiKey },\n });\n this.socket = socket;\n\n socket.onopen = () => {\n if (this.socket !== socket) return;\n opened = true;\n this.connectPromise = undefined;\n if (!this.reconnecting) this.backoff.reset();\n debugLog('Connected to GDEX stream');\n resolve();\n };\n socket.onmessage = (event) => this.handleMessage(event.data);\n socket.onerror = () => {\n if (!opened) reject(new GSwapSDKError('STREAM_CONNECT_FAILED', { url: this.url }));\n };\n socket.onclose = (event) => {\n if (this.socket !== socket) return;\n this.socket = undefined;\n this.connectPromise = undefined;\n if (!opened) {\n reject(new GSwapSDKError('STREAM_CLOSED_BEFORE_CONNECT', { closeCode: event.code ?? 0 }));\n }\n this.rejectPending(\n new GSwapSDKError('STREAM_CONNECTION_CLOSED', { closeCode: event.code ?? 0 }),\n );\n if (!this.intentionalClose && !this.reconnecting) this.startReconnectLoop();\n };\n });\n }\n\n private handleMessage(data: unknown): void {\n if (typeof data !== 'string') {\n debugLog('Ignoring non-text GDEX WebSocket frame');\n return;\n }\n\n let message: JsonRpcResponse;\n try {\n message = JSON.parse(data) as JsonRpcResponse;\n } catch {\n debugLog('Ignoring invalid JSON from GDEX stream');\n return;\n }\n\n if (typeof message.id === 'number') {\n const pending = this.pending.get(message.id);\n if (!pending) return;\n clearTimeout(pending.timeout);\n this.pending.delete(message.id);\n if (message.error) {\n const code = typeof message.error.code === 'number' ? message.error.code : -32603;\n const errorMessage =\n typeof message.error.message === 'string' ? message.error.message : 'GDEX request failed';\n pending.reject(new GdexStreamError(code, errorMessage, message.error.data));\n } else {\n try {\n pending.onResult?.(message.result);\n } catch (error) {\n pending.reject(error instanceof Error ? error : new Error(String(error)));\n return;\n }\n pending.resolve(message.result);\n }\n return;\n }\n\n if (message.method !== 'gdex_subscription' || !this.isRecord(message.params)) return;\n const subscriptionId = message.params['subscription'];\n const result = message.params['result'];\n if (typeof subscriptionId !== 'string' || !this.isRecord(result)) return;\n const subscription = this.subscriptionsByServerId.get(subscriptionId);\n if (!subscription?.active) return;\n try {\n subscription.callback(result);\n } catch (error) {\n debugLog('GDEX subscription callback failed', error);\n }\n }\n\n private async subscribe(\n channel: GdexChannel,\n callback: EventCallback,\n options: object,\n ): Promise<GdexSubscription> {\n const params: Record<string, unknown> = { channel, ...options };\n const handle: MutableGdexSubscription = {\n subscriptionId: '',\n unsubscribe: async () => this.unsubscribe(subscription),\n };\n const subscription: ActiveSubscription = {\n serverId: '',\n params,\n callback,\n handle,\n active: true,\n };\n // Registered inside the response handler, not after the await: see PendingRequest.onResult.\n await this.send('gdex_subscribe', params, (value) => {\n const serverId = readSubscriptionId(value);\n subscription.serverId = serverId;\n handle.subscriptionId = serverId;\n this.activeSubscriptions.add(subscription);\n this.subscriptionsByServerId.set(serverId, subscription);\n });\n return handle;\n }\n\n private async unsubscribe(subscription: ActiveSubscription): Promise<void> {\n if (!subscription.active) return;\n subscription.active = false;\n this.activeSubscriptions.delete(subscription);\n this.subscriptionsByServerId.delete(subscription.serverId);\n if (this.isConnected()) {\n await this.request('gdex_unsubscribe', { subscriptionId: subscription.serverId });\n }\n }\n\n private startReconnectLoop(): void {\n if (this.reconnecting || this.intentionalClose) return;\n this.reconnecting = true;\n void this.reconnectLoop();\n }\n\n private async reconnectLoop(): Promise<void> {\n while (!this.intentionalClose && this.backoff.shouldRetry()) {\n const delay = this.backoff.nextDelayMs();\n this.backoff.recordAttempt();\n debugLog(\n `GDEX reconnect attempt ${this.backoff.attemptCount}/${this.backoff.maxAttempts} in ${delay}ms`,\n );\n await this.waitForReconnectDelay(delay);\n // `disconnect()` can run while the asynchronous delay is pending.\n if (this.intentionalClose) break;\n\n try {\n await this.openSocket();\n await this.resubscribeAll();\n this.backoff.reset();\n this.reconnecting = false;\n return;\n } catch (error) {\n debugLog(\n `GDEX reconnect failed: ${error instanceof Error ? error.message : String(error)}`,\n );\n }\n }\n this.reconnecting = false;\n if (!this.intentionalClose) debugLog('GDEX reconnection attempts exhausted');\n }\n\n private async resubscribeAll(): Promise<void> {\n this.subscriptionsByServerId.clear();\n for (const subscription of this.activeSubscriptions) {\n if (!subscription.active) continue;\n const params = { ...subscription.params, snapshot: true };\n const result = await this.resubscribeWithRateLimitRetry(params, (value) => {\n const serverId = readSubscriptionId(value);\n // The consumer can unsubscribe while the asynchronous subscribe request is pending.\n if (!subscription.active) return;\n subscription.serverId = serverId;\n subscription.handle.subscriptionId = serverId;\n this.subscriptionsByServerId.set(serverId, subscription);\n });\n if (!subscription.active) {\n await this.request('gdex_unsubscribe', { subscriptionId: result.subscriptionId });\n }\n }\n }\n\n private async resubscribeWithRateLimitRetry(\n params: Record<string, unknown>,\n onResult: (value: unknown) => void,\n ): Promise<{ subscriptionId: string }> {\n for (let attempt = 0; ; attempt++) {\n try {\n return await this.send('gdex_subscribe', params, onResult);\n } catch (error) {\n if (\n !(error instanceof GdexStreamError) ||\n error.code !== RATE_LIMITED ||\n attempt >= MAX_RESUBSCRIBE_RATE_RETRIES\n ) {\n throw error;\n }\n const retryAfterMs = this.readRetryAfterMs(error.data);\n debugLog(`GDEX resubscribe rate limited; retrying in ${retryAfterMs}ms`);\n await new Promise<void>((resolve) => setTimeout(resolve, retryAfterMs));\n }\n }\n }\n\n private waitForReconnectDelay(delay: number): Promise<void> {\n return new Promise((resolve) => {\n this.reconnectTimer = setTimeout(() => {\n this.reconnectTimer = undefined;\n this.reconnectDelayResolve = undefined;\n resolve();\n }, delay);\n this.reconnectDelayResolve = resolve;\n });\n }\n\n private clearReconnectTimer(): void {\n if (this.reconnectTimer !== undefined) clearTimeout(this.reconnectTimer);\n this.reconnectTimer = undefined;\n const resolve = this.reconnectDelayResolve;\n this.reconnectDelayResolve = undefined;\n resolve?.();\n }\n\n private rejectPending(error: Error): void {\n for (const pending of this.pending.values()) {\n clearTimeout(pending.timeout);\n pending.reject(error);\n }\n this.pending.clear();\n }\n\n private readRetryAfterMs(data: unknown): number {\n if (\n !this.isRecord(data) ||\n typeof data['retryAfterMs'] !== 'number' ||\n data['retryAfterMs'] < 0\n )\n return 1_000;\n return data['retryAfterMs'];\n }\n\n private isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n }\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
import e from"../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/defineProperty.js";import{Assets as t}from"./assets.js";import{DexFees as n}from"./dex_fees.js";import{ChainGateway as r}from"./gateway.js";import{GSWAP_ENVIRONMENTS as i}from"../types/env.js";import{GdexStreamService as a}from"./gdex_stream.js";import{HttpClient as o}from"./http_client.js";import{CanonicalSymbols as s,Symbols as c}from"./symbols.js";import{Pools as l}from"./pools.js";import{Positions as u}from"./positions.js";import{Quoting as d}from"./quoting.js";import{Swaps as f}from"./swaps.js";var p=class{constructor(a){e(this,`dexBackendBaseUrl`,void 0),e(this,`chainCallTimeoutMs`,void 0),e(this,`signer`,void 0),e(this,`walletAddress`,void 0),e(this,`gateway`,void 0),e(this,`symbols`,void 0),e(this,`quoting`,void 0),e(this,`pools`,void 0),e(this,`positions`,void 0),e(this,`swaps`,void 0),e(this,`assets`,void 0),e(this,`fees`,void 0),e(this,`dexBackendWsUrl`,void 0),e(this,`webSocketImpl`,void 0),e(this,`streamApiKey`,void 0),e(this,`streamClient`,void 0);let p=i[a?.env??`prod`];this.dexBackendBaseUrl=m(a?.dexBackendBaseUrl??p.dexBackendBaseUrl),this.chainCallTimeoutMs=a?.chainCallTimeoutMs??3e4,this.signer=a?.signer,this.walletAddress=a?.walletAddress;let h=new o(a?.httpRequestor,this.chainCallTimeoutMs,a?.wire);this.gateway=new r({dexBackendBaseUrl:this.dexBackendBaseUrl,chainCallTimeoutMs:this.chainCallTimeoutMs,...a?.wire===void 0?{}:{wire:a.wire},...a?.httpRequestor===void 0?{}:{httpRequestor:a.httpRequestor},...this.walletAddress===void 0?{}:{walletAddress:this.walletAddress}});let g={onInvalidEntry:a?.onInvalidEntry};this.symbols=new c(this.gateway,g);let _=a?.symbolResolution===`canonical`?new s:this.symbols;this.quoting=new d(this.gateway,_),this.pools=new l(this.gateway,_,g);let v={uniqueKeyPrefix:a?.uniqueKeyPrefix,...g};this.positions=new u(this.gateway,_,this.signer,this.walletAddress,v),this.swaps=new f(this.gateway,_,this.signer,this.walletAddress,v),this.assets=new t(this.dexBackendBaseUrl,h),this.fees=new n(this.gateway,this.signer),this.dexBackendWsUrl=a?.dexBackendWsUrl??(a?.dexBackendBaseUrl===void 0?p.dexBackendWsUrl:`${this.dexBackendBaseUrl.replace(/^http/u,`ws`)}/ws`),this.webSocketImpl=a?.webSocketImpl,this.streamApiKey=a?.streamApiKey}get stream(){return this.streamClient??(this.streamClient=new a({url:this.dexBackendWsUrl,...this.webSocketImpl===void 0?{}:{webSocketImpl:this.webSocketImpl},...this.streamApiKey===void 0?{}:{apiKey:this.streamApiKey}})),this.streamClient}};function m(e){return e.replace(/\/$/u,``)}export{p as GSwap};
|
|
2
|
+
//# sourceMappingURL=gswap.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"gswap.js","names":[],"sources":["../../../src/classes/gswap.ts"],"sourcesContent":["import { Assets } from './assets.js';\nimport { DexFees } from './dex_fees.js';\nimport { ChainGateway } from './gateway.js';\nimport { GdexStreamService } from './gdex_stream.js';\nimport { HttpClient } from './http_client.js';\nimport { Pools } from './pools.js';\nimport { Positions } from './positions.js';\nimport { Quoting } from './quoting.js';\nimport type { GalaChainSigner } from './signers.js';\nimport { CanonicalSymbols, Symbols } from './symbols.js';\nimport type { InvalidEntryHandler } from '../utils/lenient.js';\nimport { Swaps } from './swaps.js';\nimport type { HttpRequestor } from '../types/http_requestor.js';\nimport type { GSwapEnv } from '../types/env.js';\nimport type { WireOptions } from '../types/wire.js';\nimport { GSWAP_ENVIRONMENTS } from '../types/env.js';\n\n/** Options for constructing a backend-routed SDK client. */\nexport interface GSwapOptions {\n /** Signs every write. Without one, reads work and any write throws `NO_SIGNER`. */\n signer?: GalaChainSigner | undefined;\n /**\n * The selected account, sent as `X-Wallet-Address` on writes (attribution only; the chain\n * recovers the signer from the signature). Required for shadow writes.\n */\n walletAddress?: string | undefined;\n /** `'stage'` or `'prod'` swap backend preset; defaults to `'prod'`. */\n env?: GSwapEnv | undefined;\n /** Overrides the preset's swap backend base URL (a test or private deployment). */\n dexBackendBaseUrl?: string | undefined;\n /** HTTP transport for every request; defaults to the global `fetch`. */\n httpRequestor?: HttpRequestor | undefined;\n /** Request timeout in milliseconds (default 30 000); `Infinity` arms no timer. */\n chainCallTimeoutMs?: number | undefined;\n /** Query encoding and `User-Agent` of the read requests (see {@link WireOptions}). */\n wire?: WireOptions | undefined;\n /**\n * How tokens are turned into trading symbols. `'registry'` (default) reads the symbol registry\n * once (`GET /v2/trade/symbols`, cached) and accepts symbols or class keys. `'canonical'` makes\n * no registry request: the caller passes the backend's canonical trading symbols (from a quote,\n * an estimate or a position), reads send tokens and ticks exactly as given (composite keys\n * included) and the backend orients the pair; see {@link CanonicalSymbols}.\n */\n symbolResolution?: 'registry' | 'canonical' | undefined;\n /**\n * Told about every row of a pool, symbol or position list that was skipped as unusable (see\n * {@link InvalidEntryHandler}); without it such rows are skipped silently.\n */\n onInvalidEntry?: InvalidEntryHandler | undefined;\n /** Realtime stream endpoint. Defaults to the environment's, or is derived from `dexBackendBaseUrl`. */\n dexBackendWsUrl?: string | undefined;\n /** WebSocket constructor for the realtime stream; required on Node.js older than 22. */\n webSocketImpl?: unknown;\n /**\n * `x-api-key` for the privileged stream view; server-side only, and it requires `webSocketImpl`\n * (see `GdexStreamConfig.apiKey`).\n */\n streamApiKey?: string | undefined;\n /**\n * Prefix of every write's `uniqueKey` (`<prefix><uuid>`). Defaults to `galaswap-operation-`,\n * what frontend_v2 and wallet_extension send; defi-backend does not depend on it.\n */\n uniqueKeyPrefix?: string | undefined;\n}\n\n/**\n * Main entry point for the current GalaChainDex SDK: one client bundling the services that read\n * and write through the swap backend (`quoting`, `swaps`, `pools`, `positions`, `assets`,\n * `symbols`, `fees`, `stream`). See {@link GSwapOptions} for configuration.\n */\nexport class GSwap {\n /** The swap backend base URL every request goes to, without a trailing slash. */\n public readonly dexBackendBaseUrl: string;\n /** The request timeout in milliseconds (default 30 000; `Infinity` arms no timer). */\n public readonly chainCallTimeoutMs: number;\n /** The signer given at construction, if any. */\n public readonly signer: GalaChainSigner | undefined;\n /** The account given at construction, if any. */\n public readonly walletAddress: string | undefined;\n /** The chain-gateway client every other service reads and writes through. */\n public readonly gateway: ChainGateway;\n /** The trading-symbol registry. */\n public readonly symbols: Symbols;\n /** Read-only exact-input and exact-output quotes. */\n public readonly quoting: Quoting;\n /** Pool, slot0 and composite-pool reads. */\n public readonly pools: Pools;\n /** Position reads, liquidity estimates and liquidity / pool-creation writes. */\n public readonly positions: Positions;\n /** Queued swaps (`RequestTrade`), dark swaps and swap confirmation. */\n public readonly swaps: Swaps;\n /** User token balances. */\n public readonly assets: Assets;\n /** Network-fee quotes (DryRun) signed with this client's signer. */\n public readonly fees: DexFees;\n /** The realtime stream endpoint {@link GSwap.stream} connects to. */\n public readonly dexBackendWsUrl: string;\n private readonly webSocketImpl: unknown;\n private readonly streamApiKey: string | undefined;\n private streamClient: GdexStreamService | undefined;\n\n /**\n * Create an SDK client for prod (the default) or stage, or for a `dexBackendBaseUrl` of your own.\n *\n * @example\n * ```typescript\n * const gSwap = new GSwap({ env: 'stage' });\n * const symbols = await gSwap.symbols.list();\n * ```\n */\n constructor(options?: GSwapOptions) {\n const environment = GSWAP_ENVIRONMENTS[options?.env ?? 'prod'];\n this.dexBackendBaseUrl = trimTrailingSlash(\n options?.dexBackendBaseUrl ?? environment.dexBackendBaseUrl,\n );\n this.chainCallTimeoutMs = options?.chainCallTimeoutMs ?? 30_000;\n this.signer = options?.signer;\n this.walletAddress = options?.walletAddress;\n\n const httpClient = new HttpClient(\n options?.httpRequestor,\n this.chainCallTimeoutMs,\n options?.wire,\n );\n this.gateway = new ChainGateway({\n dexBackendBaseUrl: this.dexBackendBaseUrl,\n chainCallTimeoutMs: this.chainCallTimeoutMs,\n ...(options?.wire === undefined ? {} : { wire: options.wire }),\n ...(options?.httpRequestor === undefined ? {} : { httpRequestor: options.httpRequestor }),\n ...(this.walletAddress === undefined ? {} : { walletAddress: this.walletAddress }),\n });\n const lenient = { onInvalidEntry: options?.onInvalidEntry };\n this.symbols = new Symbols(this.gateway, lenient);\n // The services resolve tokens through the registry by default; the offline resolver sends the\n // caller's canonical symbols and keys as they are and never reads the registry.\n const resolver =\n options?.symbolResolution === 'canonical' ? new CanonicalSymbols() : this.symbols;\n this.quoting = new Quoting(this.gateway, resolver);\n this.pools = new Pools(this.gateway, resolver, lenient);\n const keyOptions = { uniqueKeyPrefix: options?.uniqueKeyPrefix, ...lenient };\n this.positions = new Positions(\n this.gateway,\n resolver,\n this.signer,\n this.walletAddress,\n keyOptions,\n );\n this.swaps = new Swaps(this.gateway, resolver, this.signer, this.walletAddress, keyOptions);\n this.assets = new Assets(this.dexBackendBaseUrl, httpClient);\n this.fees = new DexFees(this.gateway, this.signer);\n this.dexBackendWsUrl =\n options?.dexBackendWsUrl ??\n (options?.dexBackendBaseUrl === undefined\n ? environment.dexBackendWsUrl\n : `${this.dexBackendBaseUrl.replace(/^http/u, 'ws')}/ws`);\n this.webSocketImpl = options?.webSocketImpl;\n this.streamApiKey = options?.streamApiKey;\n }\n\n /**\n * The realtime stream client for this environment (created on first use, not connected until you\n * call `connect()`).\n *\n * @example\n * ```typescript\n * const gSwap = new GSwap({ env: 'stage' });\n * await gSwap.stream.connect();\n * await gSwap.stream.subscribeLiquidity((event) => console.log(event.action, event.amount0));\n * ```\n */\n get stream(): GdexStreamService {\n this.streamClient ??= new GdexStreamService({\n url: this.dexBackendWsUrl,\n ...(this.webSocketImpl === undefined ? {} : { webSocketImpl: this.webSocketImpl }),\n ...(this.streamApiKey === undefined ? {} : { apiKey: this.streamApiKey }),\n });\n return this.streamClient;\n }\n}\n\nfunction trimTrailingSlash(value: string): string {\n return value.replace(/\\/$/u, '');\n}\n"],"mappings":"6jBAsEA,IAAa,EAAb,KAAmB,CAwCjB,YAAY,EAAwB,CAtCpB,EAAA,KAAA,oBAAA,IAAA,EAAA,EAEA,EAAA,KAAA,qBAAA,IAAA,EAAA,EAEA,EAAA,KAAA,SAAA,IAAA,EAAA,EAEA,EAAA,KAAA,gBAAA,IAAA,EAAA,EAEA,EAAA,KAAA,UAAA,IAAA,EAAA,EAEA,EAAA,KAAA,UAAA,IAAA,EAAA,EAEA,EAAA,KAAA,UAAA,IAAA,EAAA,EAEA,EAAA,KAAA,QAAA,IAAA,EAAA,EAEA,EAAA,KAAA,YAAA,IAAA,EAAA,EAEA,EAAA,KAAA,QAAA,IAAA,EAAA,EAEA,EAAA,KAAA,SAAA,IAAA,EAAA,EAEA,EAAA,KAAA,OAAA,IAAA,EAAA,EAEA,EAAA,KAAA,kBAAA,IAAA,EAAA,EACC,EAAA,KAAA,gBAAA,IAAA,EAAA,EACA,EAAA,KAAA,eAAA,IAAA,EAAA,EACT,EAAA,KAAA,eAAA,IAAA,EAAA,EAYN,IAAM,EAAc,EAAmB,GAAS,KAAO,QACvD,KAAK,kBAAoB,EACvB,GAAS,mBAAqB,EAAY,iBAC5C,EACA,KAAK,mBAAqB,GAAS,oBAAsB,IACzD,KAAK,OAAS,GAAS,OACvB,KAAK,cAAgB,GAAS,cAE9B,IAAM,EAAa,IAAI,EACrB,GAAS,cACT,KAAK,mBACL,GAAS,IACX,EACA,KAAK,QAAU,IAAI,EAAa,CAC9B,kBAAmB,KAAK,kBACxB,mBAAoB,KAAK,mBACzB,GAAI,GAAS,OAAS,IAAA,GAAY,CAAC,EAAI,CAAE,KAAM,EAAQ,IAAK,EAC5D,GAAI,GAAS,gBAAkB,IAAA,GAAY,CAAC,EAAI,CAAE,cAAe,EAAQ,aAAc,EACvF,GAAI,KAAK,gBAAkB,IAAA,GAAY,CAAC,EAAI,CAAE,cAAe,KAAK,aAAc,CAClF,CAAC,EACD,IAAM,EAAU,CAAE,eAAgB,GAAS,cAAe,EAC1D,KAAK,QAAU,IAAI,EAAQ,KAAK,QAAS,CAAO,EAGhD,IAAM,EACJ,GAAS,mBAAqB,YAAc,IAAI,EAAqB,KAAK,QAC5E,KAAK,QAAU,IAAI,EAAQ,KAAK,QAAS,CAAQ,EACjD,KAAK,MAAQ,IAAI,EAAM,KAAK,QAAS,EAAU,CAAO,EACtD,IAAM,EAAa,CAAE,gBAAiB,GAAS,gBAAiB,GAAG,CAAQ,EAC3E,KAAK,UAAY,IAAI,EACnB,KAAK,QACL,EACA,KAAK,OACL,KAAK,cACL,CACF,EACA,KAAK,MAAQ,IAAI,EAAM,KAAK,QAAS,EAAU,KAAK,OAAQ,KAAK,cAAe,CAAU,EAC1F,KAAK,OAAS,IAAI,EAAO,KAAK,kBAAmB,CAAU,EAC3D,KAAK,KAAO,IAAI,EAAQ,KAAK,QAAS,KAAK,MAAM,EACjD,KAAK,gBACH,GAAS,kBACR,GAAS,oBAAsB,IAAA,GAC5B,EAAY,gBACZ,GAAG,KAAK,kBAAkB,QAAQ,SAAU,IAAI,EAAE,MACxD,KAAK,cAAgB,GAAS,cAC9B,KAAK,aAAe,GAAS,YAC/B,CAaA,IAAI,QAA4B,CAM9B,OALA,KAAK,eAAL,KAAK,aAAiB,IAAI,EAAkB,CAC1C,IAAK,KAAK,gBACV,GAAI,KAAK,gBAAkB,IAAA,GAAY,CAAC,EAAI,CAAE,cAAe,KAAK,aAAc,EAChF,GAAI,KAAK,eAAiB,IAAA,GAAY,CAAC,EAAI,CAAE,OAAQ,KAAK,YAAa,CACzE,CAAC,GACM,KAAK,YACd,CACF,EAEA,SAAS,EAAkB,EAAuB,CAChD,OAAO,EAAM,QAAQ,OAAQ,EAAE,CACjC"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
import{serverMessageOfBody as e}from"../utils/server_message.js";import{GSWAP_ERROR_BRAND as t}from"../utils/error_brand.js";import{toFailureView as n}from"../utils/failure_view.js";import{phaseOfView as r}from"./error_phase_table.js";import{GSWAP_ERROR_CATALOG as i,renderGSwapErrorTemplate as a}from"./error_catalog.js";import o from"../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/defineProperty.js";const s=426;var c=class n extends Error{constructor(e,t,n={}){super(a(i[e].template,t),n.cause===void 0?void 0:{cause:n.cause}),o(this,`code`,void 0),o(this,`params`,void 0),o(this,`retryAfterMs`,void 0),o(this,`status`,void 0),o(this,`body`,void 0),o(this,`bodyText`,void 0),o(this,`url`,void 0),o(this,`uniqueKey`,void 0),o(this,`requestTransactionId`,void 0),o(this,`applyTransactionId`,void 0),o(this,`blockNumber`,void 0),o(this,`phase`,void 0),o(this,`shadow`,void 0),o(this,`write`,void 0),o(this,`walletCode`,void 0),this.name=`GSwapSDKError`,this.code=e,this.params=t,this.retryAfterMs=n.retryAfterMs,this.status=n.status,this.body=typeof n.body==`string`?void 0:n.body,this.bodyText=typeof n.body==`string`?n.body:void 0,this.url=n.url,this.uniqueKey=n.uniqueKey,this.requestTransactionId=n.requestTransactionId,this.applyTransactionId=n.applyTransactionId,this.blockNumber=n.blockNumber,this.phase=n.phase??i[e].phase,this.shadow=n.shadow??!1,this.write=n.uniqueKey!==void 0&&n.uniqueKey!==``||n.write!==!1,this.walletCode=n.walletCode}get[t](){return!0}get notFound(){return this.status===404||this.code===`NO_POOL_AVAILABLE`||this.code===`UNKNOWN_TOKEN`}static noSignerError(){return new n(`NO_SIGNER`,{})}static noWalletAddressError(){return new n(`NO_WALLET_ADDRESS`,{})}static noPoolAvailableError(e,t,r,i){return new n(`NO_POOL_AVAILABLE`,{tokenIn:l(e),tokenOut:l(t),fee:u(r)},d(i))}static insufficientLiquidityError(e,t,r,i){return new n(`INSUFFICIENT_LIQUIDITY`,{tokenIn:l(e),tokenOut:l(t),fee:u(r)},d(i))}static fromGatewayBounce(e,t,r,i,a,o,s){let c={status:r,body:i,url:a,retryAfterMs:o,uniqueKey:s},l={serverMessage:t};switch(e){case`METHOD_NOT_ALLOWED`:return new n(`METHOD_NOT_ALLOWED`,l,c);case`SIGNATURE_INVALID`:return new n(`SIGNATURE_INVALID`,l,c);case`SIGNER_MISMATCH`:return new n(`SIGNER_MISMATCH`,l,c);case`DTO_INVALID`:return new n(`DTO_INVALID`,l,c);case`BOUNDS_VIOLATION`:return new n(`BOUNDS_VIOLATION`,l,c);case`SYMBOL_CONFLICT`:return new n(`SYMBOL_CONFLICT`,l,c);case`RATE_LIMITED`:return new n(`RATE_LIMITED`,l,c);case`CHAIN_DISPATCH_FAILED`:return new n(`CHAIN_DISPATCH_FAILED`,{...l,errorKey:h(i,`errorKey`)??``},c);default:return new n(`GATEWAY_REJECTED`,{gatewayCode:e,serverMessage:t},c)}}static fromChainError(e,t,r){return new n(`CHAIN_REJECTED`,{errorKey:e,serverMessage:t},r)}static unknownTokenError(e,t){return new n(`UNKNOWN_TOKEN`,{token:l(e)},d(t))}static confirmationTimeoutError(e,t){return new n(`CONFIRMATION_TIMEOUT`,{},{uniqueKey:e,cause:t})}static fromStatus(e,t={}){let{url:r,uniqueKey:i,write:a,serverMessage:o,body:s,retryAfterMs:c}=t,l=a??(i!==void 0&&i!==``);if(l&&(i===void 0||i===``))throw new n(`INVALID_UNIQUE_KEY`,{uniqueKey:i??``});let u={status:e,body:s,url:r,retryAfterMs:c,uniqueKey:l?i:void 0,write:l,phase:`post_send`};return e===426?new n(`UPDATE_REQUIRED`,{status:e},u):new n(`HTTP_ERROR`,{status:e,url:r??``,serverMessage:o??``},u)}static async fromErrorResponse(t,r){let i=await r.text(),a=g(i),o=m(a,`error`),s=h(o,`ErrorKey`),c=h(o,`Message`),l={status:r.status,body:a??i,url:t,write:!1};return r.status===426?new n(`UPDATE_REQUIRED`,{status:r.status},l):s!==void 0&&c!==void 0?new n(`CHAIN_REJECTED`,{errorKey:s,serverMessage:c},l):new n(`HTTP_ERROR`,{status:r.status,url:t,serverMessage:e(a)},l)}};function l(e){return typeof e==`string`?e:[e.collection,e.category,e.type,e.additionalKey].join(`$`)}function u(e){return e===void 0?`any`:String(e)}function d(e){return e===void 0?{}:{status:e.status,body:e.body??e.bodyText,url:e.url,phase:`post_send`,write:e.write}}function f(e,t){return e instanceof c&&(t===void 0||e.code===t)}function p(e){let t=n(e);return t!==void 0&&r(t)===`pre_send`}function m(e,t){if(typeof e!=`object`||!e||!(t in e))return;let n=e[t];return typeof n==`object`&&n?n:void 0}function h(e,t){if(typeof e!=`object`||!e||!(t in e))return;let n=e[t];return typeof n==`string`?n:void 0}function g(e){try{return JSON.parse(e)}catch{return}}export{c as GSwapSDKError,s as UPDATE_REQUIRED_STATUS,m as getObjectProperty,h as getStringProperty,f as isGSwapError,p as isPreSendError,g as parseJson};
|
|
2
|
+
//# sourceMappingURL=gswap_sdk_error.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"gswap_sdk_error.js","names":[],"sources":["../../../src/classes/gswap_sdk_error.ts"],"sourcesContent":["import type { GalaChainTokenClassKey } from '../types/token.js';\nimport type { HTTPResponse } from '../types/http_requestor.js';\nimport { GSWAP_ERROR_BRAND } from '../utils/error_brand.js';\nimport { toFailureView } from '../utils/failure_view.js';\nimport { phaseOfView } from './error_phase_table.js';\nimport { serverMessageOfBody } from '../utils/server_message.js';\nimport {\n GSWAP_ERROR_CATALOG,\n renderGSwapErrorTemplate,\n type GSwapErrorCode,\n type GSwapErrorParams,\n} from './error_catalog.js';\nimport type { GSwapErrorPhase } from './error_phases.js';\n\n/**\n * The HTTP status of a version wall: the backend refuses an app version that is too old (HTTP 426\n * Upgrade Required). It is `UPDATE_REQUIRED` on every request the SDK sends, whatever else the body\n * says; a confirmation read keeps `CONFIRMATION_FAILED` because the write it confirms may be applied.\n */\nexport const UPDATE_REQUIRED_STATUS = 426;\n\n/**\n * The facts of an error that are not placeholders of its message: where it happened and what the\n * server said. All optional; none is localized text.\n */\nexport interface GSwapErrorContext {\n /** The HTTP status of the response that caused the error. */\n status?: number | undefined;\n /**\n * The response body: parsed JSON when the failing response had it, else the raw text (which\n * the error then exposes as {@link GSwapSDKError.bodyText}).\n */\n body?: unknown;\n /** The URL the failing request went to. */\n url?: string | undefined;\n /** The `uniqueKey` of the write this error is about: the handle for `confirm()` and recovery. */\n uniqueKey?: string | undefined;\n /** The transaction id of the queued request, `null` when unknown. */\n requestTransactionId?: string | null | undefined;\n /** The transaction id of the apply, `null` when unknown. */\n applyTransactionId?: string | null | undefined;\n /** The block the apply landed in, `null` when unknown. */\n blockNumber?: number | null | undefined;\n /** How long to wait before retrying, from the server's `Retry-After`. */\n retryAfterMs?: number | undefined;\n /** The error that caused this one (a transport failure, a wallet rejection). */\n cause?: unknown;\n /**\n * The phase of THIS occurrence when it differs from the code's catalog phase (see\n * {@link GSwapErrorPhase}): for example `UNKNOWN_TOKEN` is `pre_send` from the symbol registry\n * but `post_send` when it is derived from a quote answer.\n */\n phase?: GSwapErrorPhase | undefined;\n /** True when the failing operation was on the shadow (dark) path; see {@link GSwapSDKError.shadow}. */\n shadow?: boolean | undefined;\n /**\n * `false` for the failure of a READ (see {@link GSwapSDKError.write}); anything else, including\n * absent, is a write (fail-closed). Ignored when `uniqueKey` is set: that is a write.\n */\n write?: boolean | undefined;\n /** The wallet's own code on the error a signer threw; see {@link GSwapSDKError.walletCode}. */\n walletCode?: number | string | undefined;\n}\n\n/** What {@link GSwapSDKError.fromStatus} may be told about the HTTP answer. */\nexport interface GSwapStatusErrorOptions {\n /** The URL the request went to. */\n url?: string | undefined;\n /** The signed `uniqueKey` of the WRITE the answer is for; its presence makes this a write. */\n uniqueKey?: string | undefined;\n /** Say it outright: `true` for a write (needs `uniqueKey`), `false` for a read. */\n write?: boolean | undefined;\n /** The server's own text, for `HTTP_ERROR.params.serverMessage` (`''` when none). */\n serverMessage?: string | undefined;\n /** The response body, kept as `error.body` (or `bodyText` for a string). */\n body?: unknown;\n /** How long the server asked to wait (`Retry-After`), in milliseconds. */\n retryAfterMs?: number | undefined;\n}\n\n/**\n * Error raised by the SDK for validation, gateway, chain, or transaction failures.\n *\n * Branch on {@link code} (stable) and render {@link params} through your own localization.\n * {@link message} is English generated from the catalog template for logs and developers: it\n * is not stable and must never be shown to a user or matched on.\n */\nexport class GSwapSDKError<C extends GSwapErrorCode = GSwapErrorCode> extends Error {\n /** The stable, machine-readable code. */\n public readonly code: C;\n /** The named placeholders of the error: a flat object of primitives, safe to localize with. */\n public readonly params: GSwapErrorParams<C>;\n /** The server's `Retry-After` in milliseconds (a `RATE_LIMITED` answer), when it sent one. */\n public readonly retryAfterMs: number | undefined;\n /** The HTTP status of the response that caused this error, when there was one. */\n public readonly status: number | undefined;\n /**\n * The response body parsed as JSON, when the failing response had one; `undefined` for a body\n * that was not JSON (see {@link bodyText}). Never part of {@link message}.\n */\n public readonly body: unknown;\n /**\n * The raw text of a failing response whose body was NOT JSON (a proxy's HTML 502, a WAF page,\n * an empty body). It is kept here for diagnostics and is never copied into {@link message},\n * so it cannot reach a user interface by accident.\n */\n public readonly bodyText: string | undefined;\n /** The URL the failing request went to, when there was one. */\n public readonly url: string | undefined;\n /** The `uniqueKey` of the write this error is about, when there is one. */\n public readonly uniqueKey: string | undefined;\n /** The transaction id of the queued request, when known. */\n public readonly requestTransactionId: string | null | undefined;\n /** The transaction id of the apply, when known. */\n public readonly applyTransactionId: string | null | undefined;\n /** The block the apply landed in, when known. */\n public readonly blockNumber: number | null | undefined;\n /**\n * How far the operation had got when this was thrown, against the request it exists to send\n * (see {@link GSwapErrorPhase}): `pre_send` means NOTHING was transmitted, so a write that\n * failed this way cannot have been queued; `in_flight` means the request left and no answer was\n * read; `post_send` means an answer was read or the write was already accepted. Every catalog\n * code declares its phase, and a throw site can refine it. Read it with\n * {@link isPreSendError}; `classifyFailure` already folds it into `outcome` and `retryable`.\n */\n public readonly phase: GSwapErrorPhase;\n /**\n * True when this error came from the shadow (dark) path: `swapShadow`, `submitSwapShadow` or\n * `ChainGateway.submitShadow`, whatever failed there (a validation error, the signer, the\n * transport, `SHADOW_NOT_QUEUED`). The classification is the same as on the public path; this\n * is how an app applies its own dark-swap policy (the wallet and frontend_v2 never offer a\n * public fallback or Retry after one). A shadow gateway refusal that RESOLVES (`{ ok: false }`)\n * is not an error and has no flag: the call itself says it was shadow.\n */\n public readonly shadow: boolean;\n /**\n * Whether this failure is a WRITE's, as the guards read it: `false` only for the failure of a\n * READ (a quote, a pool list, an apply-results read), which has no `uniqueKey` to confirm and\n * nothing pending, so a 5xx there is `transient` and retryable. It is `true` for everything else,\n * and always when {@link uniqueKey} is set. That is fail-closed: a failure that does not say it\n * is a read is judged a write, where a 5xx is `unknown` and never retried. Apps that carry an\n * error through their own wrapper copy this field next to `uniqueKey` (`FailureView.write`).\n */\n public readonly write: boolean;\n /**\n * On `SIGNING_FAILED`: the code the wallet put on the error its signer threw, when it set one: an\n * EIP-1193 / JSON-RPC number such as `4001` (the person declined) or `-32603`, or an ethers /\n * viem string such as `'ACTION_REJECTED'`. It is read from the `cause`'s own `code` and is\n * always a short primitive; `undefined` when the wallet sent none, and on every other code. It is\n * a typed field, not a param: it is data for an app's analytics or its own wallet-specific\n * wording, never part of `message`, and `params.reason` stays the stable thing to branch on.\n */\n public readonly walletCode: number | string | undefined;\n\n constructor(code: C, params: GSwapErrorParams<C>, context: GSwapErrorContext = {}) {\n super(\n renderGSwapErrorTemplate(GSWAP_ERROR_CATALOG[code].template, params),\n context.cause === undefined ? undefined : { cause: context.cause },\n );\n this.name = 'GSwapSDKError';\n this.code = code;\n this.params = params;\n this.retryAfterMs = context.retryAfterMs;\n this.status = context.status;\n this.body = typeof context.body === 'string' ? undefined : context.body;\n this.bodyText = typeof context.body === 'string' ? context.body : undefined;\n this.url = context.url;\n this.uniqueKey = context.uniqueKey;\n this.requestTransactionId = context.requestTransactionId;\n this.applyTransactionId = context.applyTransactionId;\n this.blockNumber = context.blockNumber;\n this.phase = context.phase ?? GSWAP_ERROR_CATALOG[code].phase;\n this.shadow = context.shadow ?? false;\n this.write =\n context.uniqueKey !== undefined && context.uniqueKey !== '' ? true : context.write !== false;\n this.walletCode = context.walletCode;\n }\n\n /**\n * The SDK error brand (`Symbol.for('@gala-chain/gswap-sdk/error')`), always `true`. The\n * dependency-free helpers (`isWalletUserRejection`, `isGSwapErrorLike`) recognise an SDK error\n * by it instead of `instanceof`, so they work across copies of the SDK and without importing\n * this class. It lives on the prototype: it is not an own property and is never copied or logged.\n */\n public get [GSWAP_ERROR_BRAND](): true {\n return true;\n }\n\n /**\n * True when the failure means \"that market, pool or position does not exist\" rather than\n * \"something went wrong\": an HTTP 404, a pair with no pool at any fee tier\n * (`NO_POOL_AVAILABLE`), or a token the DEX contract has no trading symbol for\n * (`UNKNOWN_TOKEN`). A pool that exists but is too thin (`INSUFFICIENT_LIQUIDITY`) is NOT\n * not-found.\n */\n public get notFound(): boolean {\n return (\n this.status === 404 || this.code === 'NO_POOL_AVAILABLE' || this.code === 'UNKNOWN_TOKEN'\n );\n }\n\n /** Create the standard missing-signer error. */\n public static noSignerError(): GSwapSDKError<'NO_SIGNER'> {\n return new GSwapSDKError('NO_SIGNER', {});\n }\n\n /** Create the error used when confirming a position write without a configured wallet address. */\n public static noWalletAddressError(): GSwapSDKError<'NO_WALLET_ADDRESS'> {\n return new GSwapSDKError('NO_WALLET_ADDRESS', {});\n }\n\n /**\n * Create the error used when no pool can quote the requested pair. `source` is the backend\n * answer that said so; its status and body are kept.\n */\n public static noPoolAvailableError(\n tokenIn: GalaChainTokenClassKey | string,\n tokenOut: GalaChainTokenClassKey | string,\n fee?: number,\n source?: GSwapSDKError,\n ): GSwapSDKError<'NO_POOL_AVAILABLE'> {\n return new GSwapSDKError(\n 'NO_POOL_AVAILABLE',\n { tokenIn: tokenText(tokenIn), tokenOut: tokenText(tokenOut), fee: feeText(fee) },\n sourceContext(source),\n );\n }\n\n /** Create the error used when a pool lacks liquidity for a quote. `source` as for {@link noPoolAvailableError}. */\n public static insufficientLiquidityError(\n tokenIn: GalaChainTokenClassKey | string,\n tokenOut: GalaChainTokenClassKey | string,\n fee?: number,\n source?: GSwapSDKError,\n ): GSwapSDKError<'INSUFFICIENT_LIQUIDITY'> {\n return new GSwapSDKError(\n 'INSUFFICIENT_LIQUIDITY',\n { tokenIn: tokenText(tokenIn), tokenOut: tokenText(tokenOut), fee: feeText(fee) },\n sourceContext(source),\n );\n }\n\n /**\n * Convert a chain-gateway bounce into a typed SDK error: the gateway's own code when the SDK\n * knows it, `GATEWAY_REJECTED` (with the code as `params.gatewayCode`) when it does not.\n * `serverMessage` is the gateway's English text: for logs, not for a user interface. For\n * `CHAIN_DISPATCH_FAILED`, `params.errorKey` is the chain's `ErrorKey` from the body's\n * top-level `errorKey` (`''` when the gateway sent none): map it, not the text.\n */\n public static fromGatewayBounce(\n gatewayCode: string,\n serverMessage: string,\n status: number,\n body: unknown,\n url: string,\n retryAfterMs?: number,\n uniqueKey?: string,\n ): GSwapSDKError {\n const context: GSwapErrorContext = { status, body, url, retryAfterMs, uniqueKey };\n const params = { serverMessage };\n switch (gatewayCode) {\n case 'METHOD_NOT_ALLOWED':\n return new GSwapSDKError('METHOD_NOT_ALLOWED', params, context);\n case 'SIGNATURE_INVALID':\n return new GSwapSDKError('SIGNATURE_INVALID', params, context);\n case 'SIGNER_MISMATCH':\n return new GSwapSDKError('SIGNER_MISMATCH', params, context);\n case 'DTO_INVALID':\n return new GSwapSDKError('DTO_INVALID', params, context);\n case 'BOUNDS_VIOLATION':\n return new GSwapSDKError('BOUNDS_VIOLATION', params, context);\n case 'SYMBOL_CONFLICT':\n return new GSwapSDKError('SYMBOL_CONFLICT', params, context);\n case 'RATE_LIMITED':\n return new GSwapSDKError('RATE_LIMITED', params, context);\n case 'CHAIN_DISPATCH_FAILED':\n // The gateway adds the chain's own machine-readable key as a top-level `errorKey`, only\n // when the chain supplied one; an older gateway sends none, which is the empty string.\n return new GSwapSDKError(\n 'CHAIN_DISPATCH_FAILED',\n { ...params, errorKey: getStringProperty(body, 'errorKey') ?? '' },\n context,\n );\n default:\n return new GSwapSDKError('GATEWAY_REJECTED', { gatewayCode, serverMessage }, context);\n }\n }\n\n /** Convert a GalaChain `Status: 0` response into a typed SDK error. */\n public static fromChainError(\n errorKey: string,\n serverMessage: string,\n context?: GSwapErrorContext,\n ): GSwapSDKError<'CHAIN_REJECTED'> {\n return new GSwapSDKError('CHAIN_REJECTED', { errorKey, serverMessage }, context);\n }\n\n /**\n * Create the error used when a token is not registered by the current DEX contract. `source` is\n * the backend answer that said so (a quote); its status, body and url are kept.\n */\n public static unknownTokenError(\n token: GalaChainTokenClassKey | string,\n source?: GSwapSDKError,\n ): GSwapSDKError<'UNKNOWN_TOKEN'> {\n return new GSwapSDKError('UNKNOWN_TOKEN', { token: tokenText(token) }, sourceContext(source));\n }\n\n /** Create the error used when apply-results confirmation does not arrive in time. */\n public static confirmationTimeoutError(\n uniqueKey: string,\n cause?: unknown,\n ): GSwapSDKError<'CONFIRMATION_TIMEOUT'> {\n return new GSwapSDKError('CONFIRMATION_TIMEOUT', {}, { uniqueKey, cause });\n }\n\n /**\n * Builds, synchronously, the error the SDK itself throws for an HTTP answer of this `status`\n * that has no gateway or chain code: `UPDATE_REQUIRED` for the version wall (426, whatever\n * else is true), `HTTP_ERROR` for every other status. It is for an app that holds a resolved\n * HTTP answer the SDK did not read (a v1 endpoint, an interceptor's rejection) and wants the\n * SDK's classification of it (`classifyFailure`) instead of building the error by hand.\n *\n * Reads and writes differ exactly as they do in the gateway (`classifyFailure`): a WRITE\n * carries the signed `uniqueKey` (the handle to confirm it), a READ carries none. Pass\n * `uniqueKey` for a write, or `write: true` with it; `write: false` builds a read and drops any\n * `uniqueKey`. `write: true` without a non-empty `uniqueKey` throws `INVALID_UNIQUE_KEY`: a\n * write error with no key would be classified as a read, which is a different answer. Either\n * way an answer was read, so the phase is `post_send`.\n *\n * @example\n * ```ts\n * const read = GSwapSDKError.fromStatus(503, { url });\n * classifyFailure(read); // { outcome: 'transient', retryable: true }\n * const write = GSwapSDKError.fromStatus(503, { url, uniqueKey });\n * classifyFailure(write); // { outcome: 'unknown', retryable: false }: it may have been queued\n * classifyFailure(GSwapSDKError.fromStatus(426)); // invalid_input: only an update helps\n * ```\n */\n public static fromStatus(\n status: number,\n options: GSwapStatusErrorOptions = {},\n ): GSwapSDKError<'UPDATE_REQUIRED' | 'HTTP_ERROR'> {\n const { url, uniqueKey, write, serverMessage, body, retryAfterMs } = options;\n const isWrite = write ?? (uniqueKey !== undefined && uniqueKey !== '');\n if (isWrite && (uniqueKey === undefined || uniqueKey === '')) {\n throw new GSwapSDKError('INVALID_UNIQUE_KEY', { uniqueKey: uniqueKey ?? '' });\n }\n const context: GSwapErrorContext = {\n status,\n body,\n url,\n retryAfterMs,\n uniqueKey: isWrite ? uniqueKey : undefined,\n write: isWrite,\n phase: 'post_send',\n };\n return status === UPDATE_REQUIRED_STATUS\n ? new GSwapSDKError('UPDATE_REQUIRED', { status }, context)\n : new GSwapSDKError(\n 'HTTP_ERROR',\n { status, url: url ?? '', serverMessage: serverMessage ?? '' },\n context,\n );\n }\n\n /** Convert an unexpected HTTP response into an SDK error. */\n public static async fromErrorResponse(\n url: string,\n response: HTTPResponse,\n ): Promise<GSwapSDKError> {\n const bodyText = await response.text();\n const bodyJson: unknown = parseJson(bodyText);\n const errorObject = getObjectProperty(bodyJson, 'error');\n const errorKey = getStringProperty(errorObject, 'ErrorKey');\n const message = getStringProperty(errorObject, 'Message');\n // Every request that goes through `HttpClient` is a READ (a quote, a list, an apply-results\n // GET); writes go through the gateway, which builds its own errors with the signed key.\n const context: GSwapErrorContext = {\n status: response.status,\n body: bodyJson ?? bodyText,\n url,\n write: false,\n };\n\n if (response.status === UPDATE_REQUIRED_STATUS) {\n return new GSwapSDKError('UPDATE_REQUIRED', { status: response.status }, context);\n }\n\n if (errorKey !== undefined && message !== undefined) {\n return new GSwapSDKError('CHAIN_REJECTED', { errorKey, serverMessage: message }, context);\n }\n\n return new GSwapSDKError(\n 'HTTP_ERROR',\n { status: response.status, url, serverMessage: serverMessageOfBody(bodyJson) },\n context,\n );\n }\n}\n\n/** A token as the text a param carries: a string as is, a class key as its `$` composite. */\nfunction tokenText(token: GalaChainTokenClassKey | string): string {\n return typeof token === 'string'\n ? token\n : [token.collection, token.category, token.type, token.additionalKey].join('$');\n}\n\nfunction feeText(fee: number | undefined): string {\n return fee === undefined ? 'any' : String(fee);\n}\n\n/**\n * The HTTP facts of the error a classified error was derived from. An error derived from a\n * backend answer is `post_send`: the answer was read.\n */\nfunction sourceContext(source: GSwapSDKError | undefined): GSwapErrorContext {\n if (source === undefined) return {};\n return {\n status: source.status,\n body: source.body ?? source.bodyText,\n url: source.url,\n phase: 'post_send',\n write: source.write,\n };\n}\n\n/** Any thrown value that is an SDK error, narrowed to the union of every code. */\nexport type AnyGSwapError = { [C in GSwapErrorCode]: GSwapSDKError<C> }[GSwapErrorCode];\n\n/**\n * True when `value` is an SDK error and, when `code` is given, carries exactly that code. With a\n * code, `error.params` narrows to that code's params.\n *\n * @example\n * ```ts\n * if (isGSwapError(error, 'NON_CANONICAL_PAIR')) {\n * t('errors.NON_CANONICAL_PAIR', error.params); // { token0, token1 }\n * }\n * ```\n */\nexport function isGSwapError(value: unknown): value is AnyGSwapError;\nexport function isGSwapError<C extends GSwapErrorCode>(\n value: unknown,\n code: C,\n): value is GSwapSDKError<C>;\nexport function isGSwapError(value: unknown, code?: GSwapErrorCode): boolean {\n return value instanceof GSwapSDKError && (code === undefined || value.code === code);\n}\n\n/**\n * True when `value` is an SDK error that was thrown BEFORE anything was transmitted\n * (`error.phase === 'pre_send'`): validation, symbol resolution, the signer, the wallet, a key\n * provider. A write that failed this way cannot have been queued, so the failure never calls for\n * \"confirm before you retry\". Every failure of an app-supplied callback that runs BEFORE the\n * request leaves reaches you as an SDK error of this kind (`SIGNING_FAILED`,\n * `KEY_PROVIDER_FAILED`, `TOKEN_RESOLUTION_FAILED`, the original error as `cause`), so an app\n * never needs an error class of its own to tell \"nothing was sent\" apart.\n *\n * Whether to offer Retry is `classifyFailure(error).retryable`, not this: a pre-send validation\n * error is pre-send too, and repeating the same call fails the same way.\n *\n * It also answers for a plain-object view of an SDK error (`{ code, phase? }`, see\n * `FailureView`): the view's own `phase`, else the catalog's phase for its `code`. It is a plain\n * `boolean`, not a type guard (a view is not a `GSwapSDKError`); use `isGSwapError` to narrow.\n *\n * @example\n * ```ts\n * if (isPreSendError(error)) markNothingSent(); // no pending swap to confirm\n * ```\n */\nexport function isPreSendError(value: unknown): boolean {\n const view = toFailureView(value);\n return view !== undefined && phaseOfView(view) === 'pre_send';\n}\n\n/** Narrow an object property without trusting a cast at a network boundary. */\nexport function getObjectProperty(\n value: unknown,\n property: string,\n): Record<string, unknown> | undefined {\n if (typeof value !== 'object' || value === null || !(property in value)) return undefined;\n const propertyValue = (value as Record<string, unknown>)[property];\n return typeof propertyValue === 'object' && propertyValue !== null\n ? (propertyValue as Record<string, unknown>)\n : undefined;\n}\n\n/** Read a string property from an unknown object. */\nexport function getStringProperty(value: unknown, property: string): string | undefined {\n if (typeof value !== 'object' || value === null || !(property in value)) return undefined;\n const propertyValue = (value as Record<string, unknown>)[property];\n return typeof propertyValue === 'string' ? propertyValue : undefined;\n}\n\n/** Parse a response body, preserving non-JSON text for error reporting. */\nexport function parseJson(text: string): unknown {\n try {\n return JSON.parse(text) as unknown;\n } catch {\n return undefined;\n }\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
import{GSwapSDKError as e}from"./gswap_sdk_error.js";import{buildQueryString as t,buildRequestHeaders as n,fetchRequestor as r,readResponseBody as i,requestWithTimeout as a}from"../utils/transport.js";import{debugLog as o}from"../utils/debug.js";var s=class{constructor(e=r,t=3e4,n={}){this.httpRequestor=e,this.timeoutMs=t,this.wire=n}async sendRequest(t,r,s,c,l,u){let d=`${r}${s}${c}`;o(`Sending request to ${d} with body:`,l);let f=!!l,p=await a(this.httpRequestor,d,{method:t,headers:n(this.wire,{json:f}),...f?{body:JSON.stringify(l)}:{},...u?.signal===void 0?{}:{signal:u.signal}},this.timeoutMs);if(!p.ok)throw await e.fromErrorResponse(d,p);let m=await i(p);return o(`Response from ${r}${s}${c}:`,m),m}async sendPostRequest(e,t,n,r){return this.sendRequest(`POST`,e,t,n,r)}async sendGetRequest(e,n,r,i,a){let o=i?`${r}?${t(i,this.wire.queryEncoding)}`:r;return this.sendRequest(`GET`,e,n,o,void 0,a)}};export{s as HttpClient};
|
|
2
|
+
//# sourceMappingURL=http_client.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http_client.js","names":[],"sources":["../../../src/classes/http_client.ts"],"sourcesContent":["import type { HttpRequestor } from '../types/http_requestor.js';\nimport type { WireOptions } from '../types/wire.js';\nimport { debugLog } from '../utils/debug.js';\nimport { GSwapSDKError } from './gswap_sdk_error.js';\nimport {\n buildQueryString,\n buildRequestHeaders,\n fetchRequestor,\n readResponseBody,\n requestWithTimeout,\n} from '../utils/transport.js';\n\nexport class HttpClient {\n /**\n * Create an HTTP client around fetch or an injected requestor. `wire` selects the query\n * encoding and the `User-Agent` (see {@link WireOptions}).\n */\n constructor(\n private readonly httpRequestor: HttpRequestor = fetchRequestor,\n private readonly timeoutMs = 30_000,\n private readonly wire: WireOptions = {},\n ) {}\n\n private async sendRequest<TReturnType>(\n method: 'POST' | 'GET',\n baseUrl: string,\n basePath: string,\n endpoint: string,\n body?: unknown,\n options?: Pick<RequestInit, 'signal'>,\n ): Promise<TReturnType> {\n const url = `${baseUrl}${basePath}${endpoint}`;\n debugLog(`Sending request to ${url} with body:`, body);\n\n const hasBody = Boolean(body);\n const response = await requestWithTimeout(\n this.httpRequestor,\n url,\n {\n method,\n // Content-Type describes a body, so a GET carries none: it also keeps a browser's\n // cross-origin GET a simple request instead of forcing a CORS preflight.\n headers: buildRequestHeaders(this.wire, { json: hasBody }),\n ...(hasBody ? { body: JSON.stringify(body) } : {}),\n ...(options?.signal === undefined ? {} : { signal: options.signal }),\n },\n this.timeoutMs,\n );\n\n if (!response.ok) {\n throw await GSwapSDKError.fromErrorResponse(url, response);\n }\n\n const json = await readResponseBody(response);\n debugLog(`Response from ${baseUrl}${basePath}${endpoint}:`, json);\n\n return json as TReturnType;\n }\n\n /** Send a JSON POST request and decode its response. */\n async sendPostRequest<TReturnType>(\n baseUrl: string,\n basePath: string,\n endpoint: string,\n body: unknown,\n ): Promise<TReturnType> {\n return this.sendRequest('POST', baseUrl, basePath, endpoint, body);\n }\n\n /** Send a GET request with URL-encoded query parameters and decode its response. */\n async sendGetRequest<TReturnType>(\n baseUrl: string,\n basePath: string,\n endpoint: string,\n params?: Record<string, string>,\n options?: Pick<RequestInit, 'signal'>,\n ): Promise<TReturnType> {\n const endpointWithParams = params\n ? `${endpoint}?${buildQueryString(params, this.wire.queryEncoding)}`\n : endpoint;\n\n return this.sendRequest('GET', baseUrl, basePath, endpointWithParams, undefined, options);\n }\n}\n"],"mappings":"sPAYA,IAAa,EAAb,KAAwB,CAKtB,YACE,EAAgD,EAChD,EAA6B,IAC7B,EAAqC,CAAC,EACtC,CAHiB,KAAA,cAAA,EACA,KAAA,UAAA,EACA,KAAA,KAAA,CAChB,CAEH,MAAc,YACZ,EACA,EACA,EACA,EACA,EACA,EACsB,CACtB,IAAM,EAAM,GAAG,IAAU,IAAW,IACpC,EAAS,sBAAsB,EAAI,aAAc,CAAI,EAErD,IAAM,EAAU,EAAQ,EAClB,EAAW,MAAM,EACrB,KAAK,cACL,EACA,CACE,SAGA,QAAS,EAAoB,KAAK,KAAM,CAAE,KAAM,CAAQ,CAAC,EACzD,GAAI,EAAU,CAAE,KAAM,KAAK,UAAU,CAAI,CAAE,EAAI,CAAC,EAChD,GAAI,GAAS,SAAW,IAAA,GAAY,CAAC,EAAI,CAAE,OAAQ,EAAQ,MAAO,CACpE,EACA,KAAK,SACP,EAEA,GAAI,CAAC,EAAS,GACZ,MAAM,MAAM,EAAc,kBAAkB,EAAK,CAAQ,EAG3D,IAAM,EAAO,MAAM,EAAiB,CAAQ,EAG5C,OAFA,EAAS,iBAAiB,IAAU,IAAW,EAAS,GAAI,CAAI,EAEzD,CACT,CAGA,MAAM,gBACJ,EACA,EACA,EACA,EACsB,CACtB,OAAO,KAAK,YAAY,OAAQ,EAAS,EAAU,EAAU,CAAI,CACnE,CAGA,MAAM,eACJ,EACA,EACA,EACA,EACA,EACsB,CACtB,IAAM,EAAqB,EACvB,GAAG,EAAS,GAAG,EAAiB,EAAQ,KAAK,KAAK,aAAa,IAC/D,EAEJ,OAAO,KAAK,YAAY,MAAO,EAAS,EAAU,EAAoB,IAAA,GAAW,CAAO,CAC1F,CACF"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
import{classifyFailure as e}from"../utils/failure_classification.js";const t=[`forget`,`forget_quietly`,`keep`],n={rejected:`forget`,invalid_input:`forget_quietly`,unknown:`keep`,not_queued:`keep`,not_sent:`keep`,transient:`keep`};function r(e){return Object.hasOwn(n,e)?n[e]:`keep`}function i(t){return r(e(t,{afterQueued:!0}).outcome)}export{t as PENDING_SWAP_FATES,i as pendingSwapFateFor,r as pendingSwapFateOfOutcome};
|
|
2
|
+
//# sourceMappingURL=pending_swap_fate.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pending_swap_fate.js","names":[],"sources":["../../../src/classes/pending_swap_fate.ts"],"sourcesContent":["import { classifyFailure } from '../utils/failure_classification.js';\nimport type { FailureOutcome } from '../utils/failure_outcomes.js';\n\n/**\n * What to do with a pending swap after confirming it failed (the answer of\n * {@link pendingSwapFateFor}).\n *\n * - `forget`: the chain REFUSED the trade, so it did not happen. Drop it AND tell the user.\n * - `forget_quietly`: the confirmation can never succeed (the key is refused: `invalid_input`).\n * Drop it without claiming anything about the trade.\n * - `keep`: the trade may still have been applied (a timeout, a broken connection, a gateway\n * hiccup, anything not proven). Leave it pending and look again later.\n *\n * This module holds the decision and nothing of the store, so an app shell that only needs the\n * fate pays for `classifyFailure` and this table, not for `PendingSwapStore`.\n */\nexport const PENDING_SWAP_FATES = ['forget', 'forget_quietly', 'keep'] as const;\n\n/** One member of {@link PENDING_SWAP_FATES}. */\nexport type PendingSwapFate = (typeof PENDING_SWAP_FATES)[number];\n\n/**\n * The fate of a pending swap for each failure OUTCOME. Only a chain rejection proves the trade did\n * not happen; an input that can never be confirmed is dropped quietly; every other outcome leaves\n * the trade possibly applied. Typed over `FailureOutcome`, so a new outcome does not compile until\n * it is decided here.\n */\nconst FATE_OF_OUTCOME = {\n rejected: 'forget',\n invalid_input: 'forget_quietly',\n unknown: 'keep',\n not_queued: 'keep',\n not_sent: 'keep',\n transient: 'keep',\n} as const satisfies Record<FailureOutcome, PendingSwapFate>;\n\n/**\n * {@link pendingSwapFateFor} from an outcome the app already holds (for example the\n * `classifyFailure(error).outcome` it stored on its own failure wrapper). An outcome this SDK\n * version does not know (a newer SDK at run time) is `keep`: never forget what may have happened.\n */\nexport function pendingSwapFateOfOutcome(outcome: FailureOutcome): PendingSwapFate {\n return Object.hasOwn(FATE_OF_OUTCOME, outcome) ? FATE_OF_OUTCOME[outcome] : 'keep';\n}\n\n/**\n * The fate of a queued swap whose confirmation (`confirmAppliedTrade`) just failed with `error`,\n * from the SDK's classification alone: `forget` for a chain rejection (`rejected`), `forget_quietly`\n * for a key that can never be confirmed (`invalid_input`), `keep` for every other outcome\n * (`unknown`, `not_queued`, `not_sent`, `transient`) and for any value the SDK cannot judge. It\n * accepts an SDK error or a plain-object view of one (see `FailureView`). It replaces the wallet's\n * `pendingSwapActionFor` and frontend_v2's `confirmationStanceOf`.\n *\n * @example\n * ```ts\n * try {\n * await confirmAppliedTrade(client, swap);\n * } catch (error) {\n * if ((await store.settle(swap.uniqueKey, error)) === 'forget') tellTheUserItFailed();\n * }\n * ```\n */\nexport function pendingSwapFateFor(error: unknown): PendingSwapFate {\n return pendingSwapFateOfOutcome(classifyFailure(error, { afterQueued: true }).outcome);\n}\n"],"mappings":"qEAgBA,MAAa,EAAqB,CAAC,SAAU,iBAAkB,MAAM,EAW/D,EAAkB,CACtB,SAAU,SACV,cAAe,iBACf,QAAS,OACT,WAAY,OACZ,SAAU,OACV,UAAW,MACb,EAOA,SAAgB,EAAyB,EAA0C,CACjF,OAAO,OAAO,OAAO,EAAiB,CAAO,EAAI,EAAgB,GAAW,MAC9E,CAmBA,SAAgB,EAAmB,EAAiC,CAClE,OAAO,EAAyB,EAAgB,EAAO,CAAE,YAAa,EAAK,CAAC,CAAC,CAAC,OAAO,CACvF"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
import{isValidUniqueKey as e}from"../utils/unique_key_syntax.js";import t from"../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/defineProperty.js";import{pendingSwapFateFor as n}from"./pending_swap_fate.js";const r=`pendingSwaps.v1`,i=6048e5,a=[`expired`,`invalid_unique_key`,`chain_rejected`,`unconfirmable`];var o=class{constructor(e,n={}){this.storage=e,t(this,`storageKey`,void 0),t(this,`darkFlagField`,void 0),t(this,`insertAt`,void 0),t(this,`listOrder`,void 0),t(this,`now`,void 0),t(this,`onPrune`,void 0),t(this,`queue`,Promise.resolve()),t(this,`toStored`,e=>({uniqueKey:e.uniqueKey,requestTransactionId:e.requestTransactionId,wallet:e.wallet,token0Symbol:e.token0Symbol,token1Symbol:e.token1Symbol,[this.darkFlagField]:e.isDarkSwap,createdAt:e.createdAt})),this.storageKey=n.storageKey??`pendingSwaps.v1`,this.darkFlagField=n.darkFlagField??`isDarkSwap`,this.insertAt=n.insertAt??`end`,this.listOrder=n.listOrder??`stored`,this.now=n.now??Date.now,this.onPrune=n.onPrune}remember(t){return e(t.uniqueKey)?this.enqueue(async e=>{let n=(await this.read(e)).filter(e=>e.uniqueKey!==t.uniqueKey).map(this.toStored),r=this.toStored(t);await e.set(this.storageKey,this.insertAt===`end`?[...n,r]:[r,...n])}):(this.report([{swap:t,reason:`invalid_unique_key`}]),Promise.resolve())}forget(e){return this.enqueue(async t=>{let n=await this.read(t);await t.set(this.storageKey,n.filter(t=>t.uniqueKey!==e).map(this.toStored))})}async settle(e,t){let r=n(t);if(r===`keep`)return r;let i=await this.enqueue(async t=>{let n=await this.read(t),r=n.find(t=>t.uniqueKey===e);if(r!==void 0)return await t.set(this.storageKey,n.filter(t=>t.uniqueKey!==e).map(this.toStored)),r});return i!==void 0&&this.report([{swap:i,reason:r===`forget`?`chain_rejected`:`unconfirmable`}]),r}async list(e){return await this.enqueue(async t=>{let n=await this.read(t),r=this.now(),i=[],a=[];for(let e of n){let t=this.pruneReasonOf(e,r);t===void 0?a.push(e):i.push({swap:e,reason:t})}i.length>0&&(await t.set(this.storageKey,a.map(this.toStored)),this.report(i));let o=a.filter(t=>t.wallet===e);return this.listOrder===`newest-first`?o.sort((e,t)=>t.createdAt-e.createdAt):o})??[]}pruneReasonOf(t,n){return e(t.uniqueKey)?n-t.createdAt<6048e5?void 0:`expired`:`invalid_unique_key`}report(e){for(let t of e)try{this.onPrune?.(t)}catch{}}enqueue(e){let t=this.storage;if(t===void 0)return Promise.resolve(void 0);let n=this.queue.then(async()=>{try{return await e(t)}catch{return}});return this.queue=n,n}async read(e){let t=await e.get(this.storageKey);if(!Array.isArray(t))return[];let n=[];for(let e of t){let t=this.fromStored(e);t!==void 0&&n.push(t)}return n}fromStored(e){if(typeof e!=`object`||!e)return;let t=e,n=t[this.darkFlagField],{uniqueKey:r,requestTransactionId:i,wallet:a,token0Symbol:o,token1Symbol:s,createdAt:c}=t;if(!(typeof r!=`string`||typeof i!=`string`&&i!==null||typeof a!=`string`||typeof o!=`string`||typeof s!=`string`||typeof n!=`boolean`||typeof c!=`number`||!Number.isFinite(c)))return{uniqueKey:r,requestTransactionId:i,wallet:a,token0Symbol:o,token1Symbol:s,isDarkSwap:n,createdAt:c}}};export{r as PENDING_SWAPS_STORAGE_KEY,i as PENDING_SWAP_EXPIRY_MS,a as PENDING_SWAP_PRUNE_REASONS,o as PendingSwapStore};
|
|
2
|
+
//# sourceMappingURL=pending_swaps.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pending_swaps.js","names":[],"sources":["../../../src/classes/pending_swaps.ts"],"sourcesContent":["import { isValidUniqueKey } from '../utils/unique_key_syntax.js';\nimport { pendingSwapFateFor, type PendingSwapFate } from './pending_swap_fate.js';\nimport type { StorageAdapter } from './storage_adapters.js';\n\n/** Key the wallet_extension has always used; its storage value is a plain array of entries. */\nexport const PENDING_SWAPS_STORAGE_KEY = 'pendingSwaps.v1';\n\n/** Entries older than this are dropped the next time a wallet's swaps are listed. */\nexport const PENDING_SWAP_EXPIRY_MS = 7 * 24 * 60 * 60 * 1000;\n\n/** A RequestTrade that was accepted by the gateway but whose outcome has not been read yet. */\nexport interface PendingSwap {\n uniqueKey: string;\n requestTransactionId: string | null;\n /** The wallet (account) that submitted the swap; `list` filters by it. */\n wallet: string;\n token0Symbol: string;\n token1Symbol: string;\n /** Whether the swap was a shadow (\"dark\") swap. */\n isDarkSwap: boolean;\n /** Epoch milliseconds when the swap was queued. */\n createdAt: number;\n}\n\n/**\n * Why the store dropped a pending swap (the `reason` of {@link PrunedPendingSwap}).\n *\n * - `expired`: older than {@link PENDING_SWAP_EXPIRY_MS}.\n * - `invalid_unique_key`: its `uniqueKey` is not a valid apply-results key (1 to 128 characters\n * of `A-Za-z0-9._:-`). `confirmAppliedTrade` refuses such a key with `INVALID_UNIQUE_KEY`\n * before reading anything and always will, so keeping the entry would retry it forever. The\n * SDK never signs such a key; an entry like this is corrupt or foreign.\n * - `chain_rejected`: {@link PendingSwapStore.settle} dropped it because a confirmation proved the\n * chain REFUSED the trade (`pendingSwapFateFor` is `forget`): it did not happen.\n * - `unconfirmable`: {@link PendingSwapStore.settle} dropped it because a confirmation failed in a\n * way that never changes (`forget_quietly`: the key itself is refused): nothing can be learned.\n */\nexport const PENDING_SWAP_PRUNE_REASONS = [\n 'expired',\n 'invalid_unique_key',\n 'chain_rejected',\n 'unconfirmable',\n] as const;\n\n/** One member of {@link PENDING_SWAP_PRUNE_REASONS}. */\nexport type PendingSwapPruneReason = (typeof PENDING_SWAP_PRUNE_REASONS)[number];\n\n/** A pending swap the store dropped, and why. */\nexport interface PrunedPendingSwap {\n swap: PendingSwap;\n reason: PendingSwapPruneReason;\n}\n\n/** Options for {@link PendingSwapStore}. */\nexport interface PendingSwapStoreOptions {\n /**\n * Called once per dropped entry (after the drop is persisted, for `list`; at once for a\n * `remember` that refuses an invalid key), so the app can tell the user or log why a swap it\n * was tracking is gone. Diagnostics only: what it does, or throws, never changes the store.\n */\n onPrune?: ((pruned: PrunedPendingSwap) => void) | undefined;\n /** Storage key. Default {@link PENDING_SWAPS_STORAGE_KEY}. */\n storageKey?: string | undefined;\n /**\n * The stored name of the dark-swap flag. `isDarkSwap` (default) is wallet_extension's shape;\n * `shadow` is frontend_v2's. Entries are always exposed to callers as `isDarkSwap`.\n */\n darkFlagField?: 'isDarkSwap' | 'shadow' | undefined;\n /**\n * Where `remember` puts a new entry in the stored array: `end` (default, wallet_extension) or\n * `start` (frontend_v2).\n */\n insertAt?: 'end' | 'start' | undefined;\n /**\n * The order of `list`: `stored` (default, wallet_extension: oldest first for `insertAt: 'end'`)\n * or `newest-first` (frontend_v2).\n */\n listOrder?: 'stored' | 'newest-first' | undefined;\n /** Clock, in epoch milliseconds. Defaults to `Date.now`. */\n now?: (() => number) | undefined;\n}\n\n/**\n * Remembers queued swaps so their outcome can be confirmed after the UI, popup or service worker\n * that submitted them is gone (`confirmAppliedTrade` with the stored `uniqueKey`).\n *\n * Guarantees:\n * - Persistence is best effort and NEVER throws: a failing or missing storage must not turn an\n * accepted request into a client-side resubmission. `list` resolves `[]` when storage fails.\n * - Operations of one store instance are serialized, so concurrent `remember` / `forget` calls\n * cannot lose each other's write (read-modify-write over an async adapter). Two store instances\n * over the same storage (for example popup and service worker) are not coordinated.\n * - Entries that do not match the expected shape are ignored and dropped on the next write.\n * - Entries expire after seven days (an entry exactly seven days old is expired; frontend_v2\n * kept it for that one millisecond); `list` removes them from storage, which frontend_v2 never\n * did on read.\n * - An entry whose `uniqueKey` is not a valid apply-results key is terminal, not pending:\n * `confirmAppliedTrade` fails it with `INVALID_UNIQUE_KEY` every time, so a resume loop would\n * retry it forever. `list` prunes it like an expired one, and `remember` refuses to save it;\n * both tell `onPrune` the reason (`PENDING_SWAP_PRUNE_REASONS`).\n * - New entries go to the end (or `insertAt: 'start'`); `list` returns the wallet's entries in\n * stored order (or `listOrder: 'newest-first'`).\n * - The stored shape is wallet_extension's by default; `storageKey`, `darkFlagField`, `insertAt`\n * and `listOrder` reproduce frontend_v2's. JSON key order inside an entry is not preserved.\n *\n * Passing no `storage` yields a store that remembers nothing.\n *\n * @example\n * ```ts\n * const store = new PendingSwapStore({\n * get: async (key) => (await chrome.storage.local.get(key))[key],\n * set: (key, value) => chrome.storage.local.set({ [key]: value }),\n * });\n * await store.remember({ uniqueKey, requestTransactionId, wallet, token0Symbol: 'GALA',\n * token1Symbol: 'GUSDC', isDarkSwap: false, createdAt: Date.now() });\n * for (const swap of await store.list(wallet)) await confirmAppliedTrade(client, swap);\n * ```\n */\nexport class PendingSwapStore {\n private readonly storageKey: string;\n private readonly darkFlagField: 'isDarkSwap' | 'shadow';\n private readonly insertAt: 'end' | 'start';\n private readonly listOrder: 'stored' | 'newest-first';\n private readonly now: () => number;\n private readonly onPrune: ((pruned: PrunedPendingSwap) => void) | undefined;\n private queue: Promise<unknown> = Promise.resolve();\n\n constructor(\n private readonly storage: StorageAdapter | undefined,\n options: PendingSwapStoreOptions = {},\n ) {\n this.storageKey = options.storageKey ?? PENDING_SWAPS_STORAGE_KEY;\n this.darkFlagField = options.darkFlagField ?? 'isDarkSwap';\n this.insertAt = options.insertAt ?? 'end';\n this.listOrder = options.listOrder ?? 'stored';\n this.now = options.now ?? Date.now;\n this.onPrune = options.onPrune;\n }\n\n /**\n * Saves (or replaces, by `uniqueKey`) a pending swap. A swap whose `uniqueKey` is not a valid\n * apply-results key is not saved (it could never be confirmed); it is reported to `onPrune` as\n * `invalid_unique_key`.\n */\n public remember(swap: PendingSwap): Promise<void> {\n if (!isValidUniqueKey(swap.uniqueKey)) {\n this.report([{ swap, reason: 'invalid_unique_key' }]);\n return Promise.resolve();\n }\n return this.enqueue(async (storage) => {\n const current = await this.read(storage);\n const others = current\n .filter((entry) => entry.uniqueKey !== swap.uniqueKey)\n .map(this.toStored);\n const stored = this.toStored(swap);\n await storage.set(\n this.storageKey,\n this.insertAt === 'end' ? [...others, stored] : [stored, ...others],\n );\n });\n }\n\n /** Removes a pending swap once its outcome is known. */\n public forget(uniqueKey: string): Promise<void> {\n return this.enqueue(async (storage) => {\n const current = await this.read(storage);\n await storage.set(\n this.storageKey,\n current.filter((entry) => entry.uniqueKey !== uniqueKey).map(this.toStored),\n );\n });\n }\n\n /**\n * Applies {@link pendingSwapFateFor} to a swap whose confirmation failed with `error`, and\n * returns the fate so the app can word it (tell the user on `forget`, say nothing on\n * `forget_quietly`, keep polling on `keep`):\n *\n * - `forget`: the entry is removed and `onPrune` hears `chain_rejected`.\n * - `forget_quietly`: the entry is removed and `onPrune` hears `unconfirmable`.\n * - `keep`: nothing changes and `onPrune` is not called.\n *\n * Like every store operation it is serialized and best effort: if storage fails the entry stays\n * (a later `settle` or `list` handles it) and the fate is still returned. A key that is not\n * stored (already forgotten) is not an error and `onPrune` is not called for it.\n */\n public async settle(uniqueKey: string, error: unknown): Promise<PendingSwapFate> {\n const fate = pendingSwapFateFor(error);\n if (fate === 'keep') return fate;\n const removed = await this.enqueue(async (storage) => {\n const current = await this.read(storage);\n const swap = current.find((entry) => entry.uniqueKey === uniqueKey);\n if (swap === undefined) return undefined;\n await storage.set(\n this.storageKey,\n current.filter((entry) => entry.uniqueKey !== uniqueKey).map(this.toStored),\n );\n return swap;\n });\n if (removed !== undefined) {\n this.report([\n { swap: removed, reason: fate === 'forget' ? 'chain_rejected' : 'unconfirmable' },\n ]);\n }\n return fate;\n }\n\n /**\n * The wallet's pending swaps that can still be confirmed (see `listOrder`). Entries that never\n * can be are pruned from storage, for every wallet, and reported to `onPrune`: expired ones\n * (`expired`) and ones whose `uniqueKey` is not a valid apply-results key\n * (`invalid_unique_key`: `confirmAppliedTrade` would fail `INVALID_UNIQUE_KEY` on it forever).\n */\n public async list(wallet: string): Promise<PendingSwap[]> {\n const result = await this.enqueue(async (storage) => {\n const current = await this.read(storage);\n const now = this.now();\n const pruned: PrunedPendingSwap[] = [];\n const kept: PendingSwap[] = [];\n for (const entry of current) {\n const reason = this.pruneReasonOf(entry, now);\n if (reason === undefined) kept.push(entry);\n else pruned.push({ swap: entry, reason });\n }\n if (pruned.length > 0) {\n await storage.set(this.storageKey, kept.map(this.toStored));\n this.report(pruned);\n }\n const mine = kept.filter((entry) => entry.wallet === wallet);\n return this.listOrder === 'newest-first'\n ? mine.sort((left, right) => right.createdAt - left.createdAt)\n : mine;\n });\n return result ?? [];\n }\n\n private pruneReasonOf(entry: PendingSwap, now: number): PendingSwapPruneReason | undefined {\n if (!isValidUniqueKey(entry.uniqueKey)) return 'invalid_unique_key';\n return now - entry.createdAt < PENDING_SWAP_EXPIRY_MS ? undefined : 'expired';\n }\n\n /** Tells `onPrune` about each dropped entry; the hook is diagnostics and cannot break the store. */\n private report(pruned: readonly PrunedPendingSwap[]): void {\n for (const entry of pruned) {\n try {\n this.onPrune?.(entry);\n } catch {\n // A diagnostics hook must not turn a store operation into a failure.\n }\n }\n }\n\n private enqueue<T>(operation: (storage: StorageAdapter) => Promise<T>): Promise<T | undefined> {\n const storage = this.storage;\n if (storage === undefined) return Promise.resolve(undefined);\n const run = this.queue.then(async () => {\n try {\n return await operation(storage);\n } catch {\n // Storage can be missing, full, or disappear while a context is closing. Persistence is\n // best effort by contract.\n return undefined;\n }\n });\n this.queue = run;\n return run;\n }\n\n private async read(storage: StorageAdapter): Promise<PendingSwap[]> {\n const value = await storage.get(this.storageKey);\n if (!Array.isArray(value)) return [];\n const entries: PendingSwap[] = [];\n for (const item of value as unknown[]) {\n const entry = this.fromStored(item);\n if (entry !== undefined) entries.push(entry);\n }\n return entries;\n }\n\n private readonly toStored = (swap: PendingSwap): Record<string, unknown> => ({\n uniqueKey: swap.uniqueKey,\n requestTransactionId: swap.requestTransactionId,\n wallet: swap.wallet,\n token0Symbol: swap.token0Symbol,\n token1Symbol: swap.token1Symbol,\n [this.darkFlagField]: swap.isDarkSwap,\n createdAt: swap.createdAt,\n });\n\n private fromStored(value: unknown): PendingSwap | undefined {\n if (value === null || typeof value !== 'object') return undefined;\n const entry = value as Record<string, unknown>;\n const flag = entry[this.darkFlagField];\n const { uniqueKey, requestTransactionId, wallet, token0Symbol, token1Symbol, createdAt } =\n entry;\n if (\n typeof uniqueKey !== 'string' ||\n !(typeof requestTransactionId === 'string' || requestTransactionId === null) ||\n typeof wallet !== 'string' ||\n typeof token0Symbol !== 'string' ||\n typeof token1Symbol !== 'string' ||\n typeof flag !== 'boolean' ||\n typeof createdAt !== 'number' ||\n !Number.isFinite(createdAt)\n ) {\n return undefined;\n }\n return {\n uniqueKey,\n requestTransactionId,\n wallet,\n token0Symbol,\n token1Symbol,\n isDarkSwap: flag,\n createdAt,\n };\n }\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
import e from"../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/defineProperty.js";import{GSwapSDKError as t}from"./gswap_sdk_error.js";import{validateFee as n}from"../utils/validation.js";import{HttpClient as r}from"./http_client.js";import{asEntryRecord as i,entryOk as a,entryRejected as o,finiteNumberOf as s,readEntries as c}from"../utils/lenient.js";import{orderSymbols as l,readOrderedSymbols as u}from"../utils/ordering.js";import{queryTokenOf as d,rawTokenOf as f,tradingSymbolOf as p}from"./symbols.js";var m=class{constructor(t,n,i={}){this.gateway=t,this.symbols=n,this.options=i,e(this,`http`,void 0),this.http=new r(t.httpRequestor,t.requestTimeoutMs??3e4,t.wire)}async getPools(e){let t=await this.http.sendGetRequest(this.gateway.dexBackendBaseUrl,`/v2/trade`,`/pools`,_(e),e?.signal===void 0?void 0:{signal:e.signal});return c(`pools`,t.data,x,e?.onInvalidEntry??this.options.onInvalidEntry)}async getPool(e,t,r){return n(r),this.getBackend(`/pool`,await this.backendParams(e,t,r))}async getSlot0(e,t,r){return n(r),this.getBackend(`/slot0`,await this.backendParams(e,t,r))}async getCompositePool(e,t,r){if(n(r),this.symbols.passthrough===!0)return this.getBackend(`/composite-pool`,{token0:f(e),token1:f(t),fee:String(r)});let i=await p(this.symbols,e),a=await p(this.symbols,t),o=u(l(i,a));return this.getBackend(`/composite-pool`,{token0:o.token0,token1:o.token1,fee:String(r)})}async backendParams(e,t,n){return{token0:await d(this.symbols,e),token1:await d(this.symbols,t),fee:String(n)}}async getBackend(e,n){try{return(await this.http.sendGetRequest(this.gateway.dexBackendBaseUrl,`/v2/trade`,e,n)).data}catch(e){throw e instanceof t?e:new t(`REQUEST_FAILED`,{operation:`pool`},{cause:e})}}};const h=[`tvl`,`volume1d`,`volume30d`],g=1e3;function _(e){if(e===void 0)return;let n={};if(e.search!==void 0){if(e.search.length>64)throw new t(`SEARCH_TOO_LONG`,{length:e.search.length,maxLength:64});n.search=e.search}if(e.sortBy!==void 0){if(!h.includes(e.sortBy))throw new t(`INVALID_SORT_BY`,{value:String(e.sortBy),allowed:h.join(`,`)});n.sortBy=e.sortBy}if(e.sortOrder!==void 0){if(e.sortOrder!==`asc`&&e.sortOrder!==`desc`)throw new t(`INVALID_SORT_ORDER`,{value:String(e.sortOrder)});n.sortOrder=e.sortOrder}if(e.page!==void 0){if(!Number.isInteger(e.page)||e.page<1)throw new t(`INVALID_PAGE`,{value:e.page});n.page=String(e.page)}if(e.limit!==void 0){if(!Number.isInteger(e.limit)||e.limit<1||e.limit>g)throw new t(`INVALID_LIMIT`,{value:e.limit,min:1,max:g});n.limit=String(e.limit)}return Object.keys(n).length===0?void 0:n}const v=[`poolName`,`token0CompositeKey`,`token1CompositeKey`,`token0Image`,`token1Image`,`creator`,`price`,`sqrtPrice`,`token0Tvl`,`token1Tvl`],y=[`tickSpacing`,`protocolFees`,`tradingFees`,`tick`,`volume1d`,`volume7d`,`volume30d`,`trades1d`,`fee24h`,`token0Price`,`token1Price`],b=[`fee`,`tvlUsd`,`apr1d`];function x(e){let t=i(e);if(t===void 0)return o(`the row is not an object`);for(let e of[`token0`,`token1`,`poolRef`])if(typeof t[e]!=`string`)return o(`${e} is not a string`);if(t.contractVersion!==void 0&&t.contractVersion!==`v2`)return o(`contractVersion is not v2`);let n={...t};for(let e of b){let r=t[e];if(r===void 0&&e!==`fee`)continue;let i=s(r);if(i===void 0)return o(`${e} is not a number`);n[e]=i}for(let e of v)if(t[e]!==void 0&&typeof t[e]!=`string`)return o(`${e} is not a string`);for(let e of y){let n=t[e];if(n!==void 0&&(typeof n!=`number`||!Number.isFinite(n)))return o(`${e} is not a number`)}return a(n)}export{m as Pools};
|
|
2
|
+
//# sourceMappingURL=pools.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pools.js","names":[],"sources":["../../../src/classes/pools.ts"],"sourcesContent":["import type { FEE_TIER } from '../types/fees.js';\nimport type { CompositePool, PoolInfo, PoolListInfo, Slot0 } from '../types/v2_results.js';\nimport type { WireOptions } from '../types/wire.js';\nimport {\n asEntryRecord,\n entryOk,\n entryRejected,\n finiteNumberOf,\n readEntries,\n type EntryParse,\n type InvalidEntryHandler,\n} from '../utils/lenient.js';\nimport { orderSymbols, readOrderedSymbols, type TokenRef } from '../utils/ordering.js';\nimport type { ChainGateway } from './gateway.js';\nimport { GSwapSDKError } from './gswap_sdk_error.js';\nimport { HttpClient } from './http_client.js';\nimport { queryTokenOf, rawTokenOf, tradingSymbolOf, type TokenResolver } from './symbols.js';\nimport { validateFee } from '../utils/validation.js';\n\ninterface BackendEnvelope<T> {\n data: T;\n}\n\ntype PoolGateway = Pick<ChainGateway, 'httpRequestor' | 'dexBackendBaseUrl'> & {\n requestTimeoutMs?: number | undefined;\n wire?: WireOptions | undefined;\n};\n\n/** The sort keys of `GET /v2/trade/pools`. */\nexport type PoolSortBy = 'tvl' | 'volume1d' | 'volume30d';\n\n/** Options of {@link Pools.getPools}. Omit all of `search`, `sortBy`, `sortOrder`, `page`, `limit` for the full, unsorted list. */\nexport interface PoolListOptions {\n signal?: AbortSignal | undefined;\n /** Case-insensitive match on the pair's symbols; `A/B` or `A B` matches either order. At most 64 characters. */\n search?: string | undefined;\n sortBy?: PoolSortBy | undefined;\n sortOrder?: 'asc' | 'desc' | undefined;\n /** 1-based page number; only meaningful together with `limit`. */\n page?: number | undefined;\n /** Rows per page, 1-1000; omitted returns every row. */\n limit?: number | undefined;\n /** Overrides the service-level handler for this call. */\n onInvalidEntry?: InvalidEntryHandler | undefined;\n}\n\n/** Read-only pool and current-price access for the current GalaChainDex contract. */\nexport class Pools {\n /**\n * Creates a pool service. `options.onInvalidEntry` is told about every pool row that was\n * skipped as unusable (see {@link InvalidEntryHandler}).\n *\n * @example\n * ```ts\n * const pools = new Pools(gateway, symbols);\n * ```\n */\n constructor(\n private readonly gateway: PoolGateway,\n private readonly symbols: TokenResolver,\n private readonly options: { onInvalidEntry?: InvalidEntryHandler | undefined } = {},\n ) {\n this.http = new HttpClient(\n gateway.httpRequestor,\n gateway.requestTimeoutMs ?? 30_000,\n gateway.wire,\n );\n }\n\n private readonly http: HttpClient;\n\n /**\n * Fetches current-contract pools from the swap backend, optionally searched, sorted and paged\n * by the backend. A row that is not a usable pool is skipped and reported to `onInvalidEntry`\n * instead of failing the whole list; an answer that is not a list at all is\n * `INVALID_CHAIN_RESPONSE`.\n *\n * @example\n * ```ts\n * const top = await service.getPools({ sortBy: 'tvl', sortOrder: 'desc', page: 1, limit: 8 });\n * console.log(top.length);\n * ```\n */\n public async getPools(options?: PoolListOptions): Promise<PoolListInfo[]> {\n const response = await this.http.sendGetRequest<BackendEnvelope<unknown>>(\n this.gateway.dexBackendBaseUrl,\n '/v2/trade',\n '/pools',\n poolListParams(options),\n options?.signal === undefined ? undefined : { signal: options.signal },\n );\n return readEntries(\n 'pools',\n response.data,\n parsePoolListInfo,\n options?.onInvalidEntry ?? this.options.onInvalidEntry,\n );\n }\n\n /**\n * Fetches one pool from the backend, preserving whether the request order was flipped.\n *\n * @example\n * ```ts\n * const pool = await service.getPool('GUSDC', 'GALA', 3000);\n * console.log(pool.flippedFromRequest);\n * ```\n */\n public async getPool(token0: TokenRef, token1: TokenRef, fee: FEE_TIER): Promise<PoolInfo> {\n validateFee(fee);\n return this.getBackend<PoolInfo>('/pool', await this.backendParams(token0, token1, fee));\n }\n\n /**\n * Fetches the current sqrt price, price, and tick for one pool.\n *\n * @example\n * ```ts\n * const slot0 = await service.getSlot0('GALA', 'GUSDC', 3000);\n * console.log(slot0.tick);\n * ```\n */\n public async getSlot0(token0: TokenRef, token1: TokenRef, fee: FEE_TIER): Promise<Slot0> {\n validateFee(fee);\n return this.getBackend<Slot0>('/slot0', await this.backendParams(token0, token1, fee));\n }\n\n /**\n * Fetches the complete chain composite pool snapshot, in canonical symbol order.\n *\n * @example\n * ```ts\n * const composite = await service.getCompositePool('GALA', 'GUSDC', 3000);\n * console.log(composite.positions?.length ?? 0);\n * ```\n */\n public async getCompositePool(\n token0: TokenRef,\n token1: TokenRef,\n fee: FEE_TIER,\n ): Promise<CompositePool> {\n validateFee(fee);\n if (this.symbols.passthrough === true) {\n return this.getBackend<CompositePool>('/composite-pool', {\n token0: rawTokenOf(token0),\n token1: rawTokenOf(token1),\n fee: String(fee),\n });\n }\n const first = await tradingSymbolOf(this.symbols, token0);\n const second = await tradingSymbolOf(this.symbols, token1);\n const ordered = readOrderedSymbols(orderSymbols(first, second));\n return this.getBackend<CompositePool>('/composite-pool', {\n token0: ordered.token0,\n token1: ordered.token1,\n fee: String(fee),\n });\n }\n\n private async backendParams(\n token0: TokenRef,\n token1: TokenRef,\n fee: FEE_TIER,\n ): Promise<Record<string, string>> {\n return {\n token0: await queryTokenOf(this.symbols, token0),\n token1: await queryTokenOf(this.symbols, token1),\n fee: String(fee),\n };\n }\n\n private async getBackend<T>(endpoint: string, params: Record<string, string>): Promise<T> {\n try {\n const response = await this.http.sendGetRequest<BackendEnvelope<T>>(\n this.gateway.dexBackendBaseUrl,\n '/v2/trade',\n endpoint,\n params,\n );\n return response.data;\n } catch (error: unknown) {\n if (error instanceof GSwapSDKError) throw error;\n throw new GSwapSDKError('REQUEST_FAILED', { operation: 'pool' }, { cause: error });\n }\n }\n}\n\nconst SORT_KEYS: readonly string[] = ['tvl', 'volume1d', 'volume30d'];\nconst MAX_SEARCH_LENGTH = 64;\nconst MAX_PAGE_SIZE = 1000;\n\n/** The pool-list query, in the order the apps write it: search, sortBy, sortOrder, page, limit. */\nfunction poolListParams(options: PoolListOptions | undefined): Record<string, string> | undefined {\n if (options === undefined) return undefined;\n const params: Record<string, string> = {};\n if (options.search !== undefined) {\n if (options.search.length > MAX_SEARCH_LENGTH) {\n throw new GSwapSDKError('SEARCH_TOO_LONG', {\n length: options.search.length,\n maxLength: MAX_SEARCH_LENGTH,\n });\n }\n params['search'] = options.search;\n }\n if (options.sortBy !== undefined) {\n if (!SORT_KEYS.includes(options.sortBy)) {\n throw new GSwapSDKError('INVALID_SORT_BY', {\n value: String(options.sortBy),\n allowed: SORT_KEYS.join(','),\n });\n }\n params['sortBy'] = options.sortBy;\n }\n if (options.sortOrder !== undefined) {\n if (options.sortOrder !== 'asc' && options.sortOrder !== 'desc') {\n throw new GSwapSDKError('INVALID_SORT_ORDER', { value: String(options.sortOrder) });\n }\n params['sortOrder'] = options.sortOrder;\n }\n if (options.page !== undefined) {\n if (!Number.isInteger(options.page) || options.page < 1) {\n throw new GSwapSDKError('INVALID_PAGE', { value: options.page });\n }\n params['page'] = String(options.page);\n }\n if (options.limit !== undefined) {\n if (!Number.isInteger(options.limit) || options.limit < 1 || options.limit > MAX_PAGE_SIZE) {\n throw new GSwapSDKError('INVALID_LIMIT', {\n value: options.limit,\n min: 1,\n max: MAX_PAGE_SIZE,\n });\n }\n params['limit'] = String(options.limit);\n }\n return Object.keys(params).length === 0 ? undefined : params;\n}\n\nconst OPTIONAL_POOL_STRINGS = [\n 'poolName',\n 'token0CompositeKey',\n 'token1CompositeKey',\n 'token0Image',\n 'token1Image',\n 'creator',\n 'price',\n 'sqrtPrice',\n 'token0Tvl',\n 'token1Tvl',\n] as const;\n\nconst OPTIONAL_POOL_NUMBERS = [\n 'tickSpacing',\n 'protocolFees',\n 'tradingFees',\n 'tick',\n 'volume1d',\n 'volume7d',\n 'volume30d',\n 'trades1d',\n 'fee24h',\n 'token0Price',\n 'token1Price',\n] as const;\n\n/** Fields the apps accept as a number or a numeric string (the wallet does `Number(row.x)`). */\nconst NUMERIC_POOL_FIELDS = ['fee', 'tvlUsd', 'apr1d'] as const;\n\n/**\n * Reads one pool-list row the way the apps do: the identity (`token0`, `token1`, `poolRef`) and\n * `fee` must be usable, every other field is optional but, when present, must have its type.\n * `fee`, `tvlUsd` and `apr1d` may arrive as numeric strings and are returned as numbers. Fields\n * the SDK does not know are kept.\n */\nfunction parsePoolListInfo(entry: unknown): EntryParse<PoolListInfo> {\n const row = asEntryRecord(entry);\n if (row === undefined) return entryRejected('the row is not an object');\n for (const key of ['token0', 'token1', 'poolRef'] as const) {\n if (typeof row[key] !== 'string') return entryRejected(`${key} is not a string`);\n }\n if (row['contractVersion'] !== undefined && row['contractVersion'] !== 'v2') {\n return entryRejected('contractVersion is not v2');\n }\n const normalized: Record<string, unknown> = { ...row };\n for (const key of NUMERIC_POOL_FIELDS) {\n const raw = row[key];\n if (raw === undefined && key !== 'fee') continue;\n const value = finiteNumberOf(raw);\n if (value === undefined) return entryRejected(`${key} is not a number`);\n normalized[key] = value;\n }\n for (const key of OPTIONAL_POOL_STRINGS) {\n if (row[key] !== undefined && typeof row[key] !== 'string') {\n return entryRejected(`${key} is not a string`);\n }\n }\n for (const key of OPTIONAL_POOL_NUMBERS) {\n const value = row[key];\n if (value !== undefined && (typeof value !== 'number' || !Number.isFinite(value))) {\n return entryRejected(`${key} is not a number`);\n }\n }\n return entryOk(normalized as unknown as PoolListInfo);\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
import{ALLOWED_FEE_TIERS_TEXT as e}from"./error_catalog.js";import t from"../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/defineProperty.js";import{GSwapSDKError as n,isGSwapError as r}from"./gswap_sdk_error.js";import{TICK_SPACING_BY_FEE as i}from"../types/fees.js";import{tickFromPrice as a}from"../utils/tick_math.js";import{isProposableTradingSymbol as o,validateFee as s,validateNumericAmount as c}from"../utils/validation.js";import{resolvePreSend as l,signPreSend as u}from"../utils/pre_send.js";import{HttpClient as d}from"./http_client.js";import{asEntryRecord as f,entryOk as p,entryRejected as m,readEntries as h}from"../utils/lenient.js";import{compositeKeyOf as g}from"../utils/class_key.js";import{parseTokenClassKey as _}from"../utils/ordering.js";import{rawTokenOf as v}from"./symbols.js";import{alignTickDown as y,alignTickUp as b,assertTickRange as x}from"../utils/ticks.js";import{assertUniqueKey as S,createUniqueKey as C,resolveUniqueKeyPrefix as w}from"../utils/unique_key.js";import{assertCanonicalV2Dto as T,buildAddLiquidityDto as E,buildCollectPositionFeesDto as D,buildCreatePoolDto as O,buildRemoveLiquidityDto as k}from"../utils/dto_builders.js";import A from"bignumber.js";function j(e){return{token0:e.token0,token1:e.token1,fee:e.fee,tickLower:e.tickLower,tickUpper:e.tickUpper}}var M=class{constructor(e,n,r,i,a={}){this.gateway=e,this.symbols=n,this.signer=r,this.walletAddress=i,t(this,`http`,void 0),t(this,`uniqueKeyPrefix`,void 0),t(this,`onInvalidEntry`,void 0),this.http=new d(e.httpRequestor,e.requestTimeoutMs??3e4,e.wire),this.uniqueKeyPrefix=w(a.uniqueKeyPrefix),this.onInvalidEntry=a.onInvalidEntry}async getUserPositions(e){let t=await this.get(`/positions`,{user:e});return h(`positions`,t.data,I,this.onInvalidEntry)}async getPosition(e,t){let n=await this.getNullable(`/position`,await this.positionParams(e),t);return n===null?null:L(n.data)}async readPosition(e,t){try{let n=await this.getPosition(e,t);return n===null?{kind:`not_found`}:{kind:`found`,data:n}}catch(e){if(t?.aborted===!0)throw e;return{kind:`unknown`,error:r(e)?e:new n(`REQUEST_FAILED`,{operation:`position`},{cause:e})}}}async positionParams(e){if(this.symbols.passthrough===!0)return{token0:v(e.token0),token1:v(e.token1),fee:`${e.fee}`,owner:e.owner,tickLower:`${e.tickLower}`,tickUpper:`${e.tickUpper}`};let t=await this.orderPair(e.token0,e.token1),n=this.canonicalTicks(e.tickLower,e.tickUpper,t.flipped);return{token0:t.token0.symbol,token1:t.token1.symbol,fee:`${e.fee}`,owner:e.owner,tickLower:`${n.tickLower}`,tickUpper:`${n.tickUpper}`}}async estimateAddLiquidity(e){return c(e.amount,`amount`),(await this.get(`/add-liq-estimate`,{token0:v(e.token0),token1:v(e.token1),fee:`${e.fee}`,tickLower:`${e.tickLower}`,tickUpper:`${e.tickUpper}`,amount:new A(e.amount).toFixed(),amountIsToken0:String(e.amountIsToken0)})).data}async estimateRemoveLiquidity(e){return c(e.liquidity,`liquidity`),(await this.get(`/remove-liq-estimate`,{token0:v(e.token0),token1:v(e.token1),fee:`${e.fee}`,tickLower:`${e.tickLower}`,tickUpper:`${e.tickUpper}`,liquidity:new A(e.liquidity).toFixed()})).data}async addLiquidityByTicks(e){return this.submitAddLiquidity(await this.buildAddLiquidity(e))}async buildAddLiquidity(e){s(e.fee);let t=await this.orderPair(e.token0,e.token1),n=this.canonicalTicks(e.tickLower,e.tickUpper,t.flipped);x(n.tickLower,n.tickUpper,e.fee),c(e.amount,`amount`);let r={token0:t.token0.symbol,token1:t.token1.symbol,fee:e.fee,tickLower:n.tickLower,tickUpper:n.tickUpper,uniqueKey:this.uniqueKeyFor(e.uniqueKey)};return t.flipped===e.amountIsToken0?E({...r,depositQuantityToken1:e.amount}):E({...r,depositQuantityToken0:e.amount})}async submitAddLiquidity(e){return T(`AddLiquidity`,e),this.submit(`AddLiquidity`,e,{kind:`add`,identity:j(e)})}async addLiquidityByPrice(e){s(e.fee),this.rejectNumber(e.minPrice,`minPrice`),this.rejectNumber(e.maxPrice,`maxPrice`);let t=new A(e.minPrice),r=new A(e.maxPrice);if(!t.isFinite()||!r.isFinite()||t.isLessThanOrEqualTo(0)||r.isLessThanOrEqualTo(0))throw new n(`INVALID_PRICE_BOUNDS`,{minPrice:String(e.minPrice),maxPrice:String(e.maxPrice)});if(t.isGreaterThan(r))throw new n(`PRICE_BOUNDS_ORDER`,{minPrice:String(e.minPrice),maxPrice:String(e.maxPrice)});let i=this.tickSpacing(e.fee),o=y(a(t),i),c=b(a(r),i);return this.addLiquidityByTicks({token0:e.token0,token1:e.token1,fee:e.fee,tickLower:o,tickUpper:c,amount:e.amount,amountIsToken0:e.amountIsToken0,uniqueKey:e.uniqueKey})}async removeLiquidity(e){return this.submitRemoveLiquidity(await this.buildRemoveLiquidity(e))}async buildRemoveLiquidity(e){s(e.fee);let t=await this.orderPair(e.token0,e.token1),r=this.canonicalTicks(e.tickLower,e.tickUpper,t.flipped);if(x(r.tickLower,r.tickUpper,e.fee),e.amount0!==void 0&&e.amount1!==void 0)throw new n(`AT_MOST_ONE_OF_ALLOWED`,{first:`amount0`,second:`amount1`});e.amount0!==void 0&&c(e.amount0,`amount0`),e.amount1!==void 0&&c(e.amount1,`amount1`);let[i,a]=t.flipped?[e.amount1,e.amount0]:[e.amount0,e.amount1];return k({token0:t.token0.symbol,token1:t.token1.symbol,fee:e.fee,tickLower:r.tickLower,tickUpper:r.tickUpper,uniqueKey:this.uniqueKeyFor(e.uniqueKey),withdrawalQuantityToken0:i,withdrawalQuantityToken1:a})}async submitRemoveLiquidity(e){T(`RemoveLiquidity`,e);let t=e.withdrawalQuantityToken0===void 0&&e.withdrawalQuantityToken1===void 0;return this.submit(`RemoveLiquidity`,e,{kind:t?`removeFull`:`removePartial`,identity:j(e)})}async collectPositionFees(e){return this.submitCollectPositionFees(await this.buildCollectPositionFees(e))}async buildCollectPositionFees(e){s(e.fee);let t=await this.orderPair(e.token0,e.token1),n=this.canonicalTicks(e.tickLower,e.tickUpper,t.flipped);return x(n.tickLower,n.tickUpper,e.fee),D({token0:t.token0.symbol,token1:t.token1.symbol,fee:e.fee,tickLower:n.tickLower,tickUpper:n.tickUpper,uniqueKey:this.uniqueKeyFor(e.uniqueKey)})}async submitCollectPositionFees(e){return T(`CollectPositionFees`,e),this.submit(`CollectPositionFees`,e,{kind:`collect`,identity:j(e)})}async createPool(e){return this.submitCreatePool(await this.buildCreatePool(e))}async buildCreatePool(e){let t=e.startingPrice!==void 0;if(t===(e.startingSqrtPrice!==void 0))throw new n(`EXACTLY_ONE_OF_REQUIRED`,{first:`startingPrice`,second:`startingSqrtPrice`});s(e.fee);let[r,i]=await Promise.all([this.resolveCreateToken(e.token0,e.token0Symbol),this.resolveCreateToken(e.token1,e.token1Symbol)]),a=r.symbol>i.symbol,[o,c]=a?[i,r]:[r,i],l=t?e.startingPrice:e.startingSqrtPrice;this.rejectNumber(l,t?`startingPrice`:`startingSqrtPrice`);let u=new A(l);if(!u.isFinite()||u.isLessThanOrEqualTo(0))throw new n(`INVALID_STARTING_PRICE`,{value:String(l)});let d=a?new A(1).dividedBy(u):u,f={token0Key:o.classKey,token1Key:c.classKey,token0Symbol:o.symbol,token1Symbol:c.symbol,fee:e.fee,uniqueKey:this.uniqueKeyFor(e.uniqueKey),name:e.name,isPrivate:e.isPrivate,privateAccess:e.privateAccess};return O(t?{...f,startingPrice:d}:{...f,startingSqrtPrice:d})}async submitCreatePool(e){T(`CreatePool`,e);let t=await this.submit(`CreatePool`,e,{kind:`createPool`,token0:e.token0Symbol,token1:e.token1Symbol,fee:e.fee});return this.symbols.invalidate?.(),t}async submit(e,t,r){if(this.signer===void 0)throw n.noSignerError();let i=await u(this.signer,e,t),a=this.walletAddress===void 0?{}:{walletAddress:this.walletAddress},o=this.walletAddress,s=this.buildPositionConfirmation(r,o),c={...a,...s===void 0?{}:{positionConfirmation:s}};return this.gateway.submit(e,i,c)}buildPositionConfirmation(e,t){if(e===void 0)return;if(e.kind===`createPool`){let{token0:t,token1:n,fee:r}=e;return async e=>await this.getNullable(`/pool`,{token0:t,token1:n,fee:`${r}`},e)===null?{confirmed:!1}:{confirmed:!0,position:null}}if(t===void 0)return;let{kind:n,identity:r}=e,i;return async e=>{let a=await this.getPosition({...r,owner:t},e);if(i===void 0)return i={liquidity:new A(a?.liquidity??0),fees:new A(a?.fees0??0).plus(new A(a?.fees1??0))},n===`removeFull`&&a===null?{confirmed:!0,position:null}:{confirmed:!1};switch(n){case`add`:return a!==null&&new A(a.liquidity).isGreaterThan(i.liquidity)?{confirmed:!0,position:a}:{confirmed:!1};case`removePartial`:return a!==null&&new A(a.liquidity).isLessThan(i.liquidity)?{confirmed:!0,position:a}:{confirmed:!1};case`removeFull`:return a===null?{confirmed:!0,position:null}:{confirmed:!1};case`collect`:{if(a===null)return{confirmed:!1};let e=new A(a.fees0??0).plus(new A(a.fees1??0));return e.isLessThan(i.fees)||i.fees.isZero()&&e.isZero()?{confirmed:!0,position:a}:{confirmed:!1}}}}}async get(e,t,n){return this.http.sendGetRequest(this.gateway.dexBackendBaseUrl,`/v2/trade`,e,t,n===void 0?void 0:{signal:n})}async getNullable(e,t,n){try{return await this.get(e,t,n)}catch(e){if(this.isNotFound(e))return null;throw e}}isNotFound(e){return e instanceof n&&e.status===404}canonicalTicks(e,t,n){return n?{tickLower:-t,tickUpper:-e}:{tickLower:e,tickUpper:t}}tickSpacing(t){let r=i[t];if(r===void 0)throw new n(`INVALID_FEE`,{field:`fee`,value:t,allowed:e});return r}rejectNumber(e,t){if(typeof e==`number`)throw new n(`AMOUNT_IS_JS_NUMBER`,{field:t})}uniqueKeyFor(e){return e===void 0?C(this.uniqueKeyPrefix):(S(e),e)}orderPair(e,t){return l(`${v(e)}/${v(t)}`,()=>this.symbols.orderPair(e,t))}async resolveCreateToken(e,t){try{let r=typeof e==`object`?g(e):e,i=await l(v(e),()=>this.symbols.resolve(r));if(t!==void 0&&t!==``&&t!==i.symbol)throw new n(`SYMBOL_DISAGREES_WITH_REGISTRY`,{token:v(e),suppliedSymbol:t,registeredSymbol:i.symbol});let a=this.tryParseClassKey(e);if(a===void 0&&i.collection===``)throw new n(`CREATE_POOL_NEEDS_CLASS_KEY`,{token:v(e)});return{symbol:i.symbol,classKey:a??_({collection:i.collection,category:i.category,type:i.type,additionalKey:i.additionalKey})}}catch(r){if(!(r instanceof n)||r.code!==`UNKNOWN_TOKEN`)throw r;let i;try{i=_(e)}catch{throw r}if(t===void 0||t===``)throw new n(`TOKEN_SYMBOL_NOT_REGISTERED`,{token:v(e)});if(!o(t))throw new n(`INVALID_TRADING_SYMBOL`,{symbol:t});return{symbol:t,classKey:i}}}tryParseClassKey(e){try{return _(e)}catch{return}}};const N=[`token0Symbol`,`token1Symbol`,`owner`,`liquidity`,`amount0`,`amount1`],P=[`fee`,`tickLower`,`tickUpper`],F=[`token0CompositeKey`,`token1CompositeKey`,`token0Image`,`token1Image`,`sqrtPrice`,`fees0`,`fees1`];function I(e){let t=f(e);if(t===void 0)return m(`the row is not an object`);for(let e of N)if(typeof t[e]!=`string`)return m(`${e} is not a string`);for(let e of P){let n=t[e];if(typeof n!=`number`||!Number.isFinite(n))return m(`${e} is not a number`)}if(typeof t.inRange!=`boolean`)return m(`inRange is not a boolean`);for(let e of F)if(t[e]!==void 0&&typeof t[e]!=`string`)return m(`${e} is not a string`);let n=t.currentTick;if(n!==void 0&&(typeof n!=`number`||!Number.isFinite(n)))return m(`currentTick is not a number`);let r=t.poolRef??t.pool??``;if(typeof r!=`string`)return m(`pool is not a string`);let i=Object.fromEntries([...F,`currentTick`].flatMap(e=>t[e]===void 0?[]:[[e,t[e]]]));return p({token0Symbol:t.token0Symbol,token1Symbol:t.token1Symbol,fee:t.fee,tickLower:t.tickLower,tickUpper:t.tickUpper,liquidity:t.liquidity,amount0:t.amount0,amount1:t.amount1,inRange:t.inRange,pool:r,owner:t.owner,...i})}function L(e){let t=I(e);if(t.ok)return t.value;throw new n(`INVALID_POSITION_RESPONSE`,{reason:t.reason},{body:e})}export{M as Positions};
|
|
2
|
+
//# sourceMappingURL=positions.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"positions.js","names":[],"sources":["../../../src/classes/positions.ts"],"sourcesContent":["import BigNumber from 'bignumber.js';\nimport { ALLOWED_FEE_TIERS_TEXT } from './error_catalog.js';\nimport { GSwapSDKError, isGSwapError } from './gswap_sdk_error.js';\nimport type { ChainGateway, ChainSubmitOptions } from './gateway.js';\nimport type { PositionConfirmationResult, SubmittedTransaction } from './submitted_transaction.js';\nimport { HttpClient } from './http_client.js';\nimport type { GalaChainSigner } from './signers.js';\nimport { rawTokenOf, type Symbols, type TokenResolver } from './symbols.js';\nimport type { NumericAmount, PriceIn } from '../types/amounts.js';\nimport type { FEE_TIER } from '../types/fees.js';\nimport { TICK_SPACING_BY_FEE } from '../types/fees.js';\nimport type {\n AddLiquidityDTO,\n CollectPositionFeesDTO,\n CreatePoolDTO,\n RemoveLiquidityDTO,\n} from '../types/v2_dtos.js';\nimport type {\n AddLiquidityEstimate,\n Position,\n RemoveLiquidityEstimate,\n} from '../types/v2_results.js';\nimport type { WireOptions } from '../types/wire.js';\nimport {\n asEntryRecord,\n entryOk,\n entryRejected,\n readEntries,\n type EntryParse,\n type InvalidEntryHandler,\n} from '../utils/lenient.js';\nimport { compositeKeyOf } from '../utils/class_key.js';\nimport { type TokenRef, parseTokenClassKey } from '../utils/ordering.js';\nimport { resolvePreSend, signPreSend } from '../utils/pre_send.js';\nimport {\n isProposableTradingSymbol,\n validateFee,\n validateNumericAmount,\n} from '../utils/validation.js';\nimport { tickFromPrice } from '../utils/tick_math.js';\nimport { alignTickDown, alignTickUp, assertTickRange } from '../utils/ticks.js';\nimport {\n assertCanonicalV2Dto,\n buildAddLiquidityDto,\n buildCollectPositionFeesDto,\n buildCreatePoolDto,\n buildRemoveLiquidityDto,\n} from '../utils/dto_builders.js';\nimport {\n assertUniqueKey,\n createUniqueKey,\n resolveUniqueKeyPrefix,\n type UniqueKeyOptions,\n} from '../utils/unique_key.js';\n\ntype PositionGateway = Pick<ChainGateway, 'httpRequestor' | 'dexBackendBaseUrl'> & {\n submit: (\n method: string,\n signedBody: Record<string, unknown>,\n options?: ChainSubmitOptions,\n ) => Promise<SubmittedTransaction<Position | null>>;\n requestTimeoutMs?: number | undefined;\n wire?: WireOptions | undefined;\n};\ntype PositionSymbols = TokenResolver & Pick<Symbols, 'orderPair'> & { invalidate?: () => void };\n\n/** Options of {@link Positions}: the `uniqueKey` prefix and a handler for skipped list rows. */\nexport interface PositionsOptions extends UniqueKeyOptions {\n /** Told about every position row of a list that was skipped as unusable. */\n onInvalidEntry?: InvalidEntryHandler | undefined;\n}\n\n/** A write's optional attempt identity. */\ninterface UniqueKeyArg {\n /**\n * The attempt's `uniqueKey` (1-128 characters of `A-Za-z0-9._:-`). Default: a fresh\n * `<uniqueKeyPrefix><uuid>`. Supply one to know the key before signing, or to retry the SAME\n * attempt after a lost response; never reuse it for another write.\n */\n uniqueKey?: string | undefined;\n}\n\n/** Arguments of {@link Positions.addLiquidityByTicks} and {@link Positions.buildAddLiquidity}. */\nexport interface AddLiquidityArgs extends UniqueKeyArg {\n token0: TokenRef;\n token1: TokenRef;\n fee: FEE_TIER;\n tickLower: number;\n tickUpper: number;\n amount: NumericAmount;\n /** Whether `amount` is of `token0` as the caller passed it (not of the canonical token0). */\n amountIsToken0: boolean;\n}\n\n/** Arguments of {@link Positions.removeLiquidity} and {@link Positions.buildRemoveLiquidity}. */\nexport interface RemoveLiquidityArgs extends UniqueKeyArg {\n token0: TokenRef;\n token1: TokenRef;\n fee: FEE_TIER;\n tickLower: number;\n tickUpper: number;\n /** Withdraw this much of the caller's `token0`; give at most one of `amount0` / `amount1`. */\n amount0?: NumericAmount | undefined;\n amount1?: NumericAmount | undefined;\n}\n\n/** Arguments of {@link Positions.collectPositionFees} and {@link Positions.buildCollectPositionFees}. */\nexport interface CollectPositionFeesArgs extends UniqueKeyArg {\n token0: TokenRef;\n token1: TokenRef;\n fee: FEE_TIER;\n tickLower: number;\n tickUpper: number;\n}\n\n/** Arguments of {@link Positions.createPool} and {@link Positions.buildCreatePool}. */\nexport interface CreatePoolArgs extends UniqueKeyArg {\n token0: TokenRef;\n token1: TokenRef;\n token0Symbol?: string | undefined;\n token1Symbol?: string | undefined;\n fee: FEE_TIER;\n startingPrice?: NumericAmount | undefined;\n startingSqrtPrice?: NumericAmount | undefined;\n /** Optional pool display name, sent as the DTO's `name`; omitted when undefined or empty. */\n name?: string | undefined;\n isPrivate?: boolean | undefined;\n privateAccess?: string[] | undefined;\n}\n\n/** The pool position a liquidity DTO names, as its confirmation needs it. */\nfunction identityOf(\n dto: Pick<CollectPositionFeesDTO, 'token0' | 'token1' | 'fee' | 'tickLower' | 'tickUpper'>,\n): PositionIdentity {\n return {\n token0: dto.token0,\n token1: dto.token1,\n fee: dto.fee,\n tickLower: dto.tickLower,\n tickUpper: dto.tickUpper,\n };\n}\n\n/**\n * The outcome of {@link Positions.readPosition}. Only `not_found` is chain-confirmed absence (the\n * backend answers HTTP 404 only when the chain itself found no such position); `unknown` is \"no\n * evidence either way\" — a transport failure, a gateway timeout, any other error status or an\n * answer that is not a position — and must never be read as a removal.\n */\nexport type PositionRead =\n | { kind: 'found'; data: Position }\n | { kind: 'not_found' }\n | { kind: 'unknown'; error: GSwapSDKError };\n\ninterface BackendEnvelope<TData> {\n data: TData;\n}\n\ninterface AddLiquidityEstimateWire {\n amount0: string;\n amount1: string;\n liquidity: string;\n token0Symbol: string;\n token1Symbol: string;\n tickLower: number;\n tickUpper: number;\n amountIsCanonicalToken0: boolean;\n}\n\ninterface RemoveLiquidityEstimateWire {\n amount0: string;\n amount1: string;\n}\n\ninterface ResolvedCreateToken {\n symbol: string;\n classKey: ReturnType<typeof parseTokenClassKey>;\n}\n\ninterface PositionIdentity {\n token0: string;\n token1: string;\n fee: FEE_TIER;\n tickLower: number;\n tickUpper: number;\n}\n\n/** Tells `submit()` how to prove a write's own effect for `SubmittedTransaction.confirm()`. */\ntype PositionSubmitConfirmation =\n | { kind: 'add' | 'removePartial' | 'removeFull' | 'collect'; identity: PositionIdentity }\n | { kind: 'createPool'; token0: string; token1: string; fee: FEE_TIER };\n\n/**\n * Manages current-contract concentrated-liquidity positions.\n *\n * @example\n * ```typescript\n * const positions = gSwap.positions;\n * const mine = await positions.getUserPositions('client|012345678901234567890123');\n * console.log(mine.length);\n * ```\n */\nexport class Positions {\n constructor(\n private readonly gateway: PositionGateway,\n private readonly symbols: PositionSymbols,\n private readonly signer?: GalaChainSigner,\n private readonly walletAddress?: string,\n options: PositionsOptions = {},\n ) {\n this.http = new HttpClient(\n gateway.httpRequestor,\n gateway.requestTimeoutMs ?? 30_000,\n gateway.wire,\n );\n this.uniqueKeyPrefix = resolveUniqueKeyPrefix(options.uniqueKeyPrefix);\n this.onInvalidEntry = options.onInvalidEntry;\n }\n\n private readonly http: HttpClient;\n private readonly uniqueKeyPrefix: string;\n private readonly onInvalidEntry: InvalidEntryHandler | undefined;\n\n /**\n * Gets all current-contract positions owned by an address.\n *\n * @param owner - GalaChain owner identity.\n * @returns Enriched positions from the v2 trade backend, token images included. A row that is\n * not a usable position is skipped and reported to `onInvalidEntry`.\n * @example\n * ```typescript\n * const positions = await gSwap.positions.getUserPositions('client|012345678901234567890123');\n * ```\n */\n async getUserPositions(owner: string): Promise<Position[]> {\n const response = await this.get<unknown>('/positions', { user: owner });\n return readEntries('positions', response.data, parsePosition, this.onInvalidEntry);\n }\n\n /**\n * Gets one position, normalizing a caller-supplied reversed pair to canonical symbol order.\n * Reversed pairs also invert the price axis, so `[lower, upper]` becomes `[-upper, -lower]`.\n *\n * @param args - Pair, owner, fee, and position tick range.\n * @returns The position, or `null` when the backend returns 404.\n * @example\n * ```typescript\n * const position = await gSwap.positions.getPosition({\n * token0: 'GALA', token1: 'GUSDC', owner: 'client|012345678901234567890123',\n * fee: 3000, tickLower: -19200, tickUpper: 12000,\n * });\n * ```\n */\n async getPosition(\n args: {\n token0: TokenRef;\n token1: TokenRef;\n fee: FEE_TIER;\n owner: string;\n tickLower: number;\n tickUpper: number;\n },\n signal?: AbortSignal,\n ): Promise<Position | null> {\n const response = await this.getNullable<unknown>(\n '/position',\n await this.positionParams(args),\n signal,\n );\n return response === null ? null : readPositionBody(response.data);\n }\n\n /**\n * Reads one position and classifies the outcome instead of throwing: `found` with the position\n * (fees included), `not_found` (the backend's HTTP 404, which it sends only when the chain\n * itself has no such position) or `unknown` (any other failure, carried as `error`). Use it\n * to confirm a write: `unknown` is \"no evidence either way\", never a confirmed absence.\n *\n * Only the caller's own abort rethrows. With a pass-through resolver ({@link CanonicalSymbols})\n * the pair and ticks go to the backend exactly as given and the backend orients them.\n *\n * @example\n * ```typescript\n * const read = await gSwap.positions.readPosition({\n * token0: 'GALA', token1: 'GUSDC', owner: 'client|012345678901234567890123',\n * fee: 3000, tickLower: -19200, tickUpper: 12000,\n * });\n * if (read.kind === 'found') console.log(read.data.fees0);\n * ```\n */\n async readPosition(\n args: {\n token0: TokenRef;\n token1: TokenRef;\n fee: FEE_TIER;\n owner: string;\n tickLower: number;\n tickUpper: number;\n },\n signal?: AbortSignal,\n ): Promise<PositionRead> {\n try {\n const position = await this.getPosition(args, signal);\n return position === null ? { kind: 'not_found' } : { kind: 'found', data: position };\n } catch (error: unknown) {\n if (signal?.aborted === true) throw error;\n return {\n kind: 'unknown',\n error: isGSwapError(error)\n ? error\n : new GSwapSDKError('REQUEST_FAILED', { operation: 'position' }, { cause: error }),\n };\n }\n }\n\n /**\n * The `/position` query: canonical symbols and canonical ticks after a client-side flip, or,\n * for a pass-through resolver, the caller's references and ticks untouched.\n */\n private async positionParams(args: {\n token0: TokenRef;\n token1: TokenRef;\n fee: FEE_TIER;\n owner: string;\n tickLower: number;\n tickUpper: number;\n }): Promise<Record<string, string>> {\n if (this.symbols.passthrough === true) {\n return {\n token0: rawTokenOf(args.token0),\n token1: rawTokenOf(args.token1),\n fee: `${args.fee}`,\n owner: args.owner,\n tickLower: `${args.tickLower}`,\n tickUpper: `${args.tickUpper}`,\n };\n }\n const pair = await this.orderPair(args.token0, args.token1);\n const ticks = this.canonicalTicks(args.tickLower, args.tickUpper, pair.flipped);\n return {\n token0: pair.token0.symbol,\n token1: pair.token1.symbol,\n fee: `${args.fee}`,\n owner: args.owner,\n tickLower: `${ticks.tickLower}`,\n tickUpper: `${ticks.tickUpper}`,\n };\n }\n\n /**\n * Estimates the other token amount and resulting liquidity for a deposit.\n *\n * @param args - Pair, tick range, deposit amount, and the amount's caller-side token index.\n * @returns Backend liquidity estimate.\n * @example\n * ```typescript\n * const estimate = await gSwap.positions.estimateAddLiquidity({\n * token0: 'GALA', token1: 'GUSDC', fee: 3000,\n * tickLower: -19200, tickUpper: 12000, amount: '100', amountIsToken0: true,\n * });\n * ```\n */\n async estimateAddLiquidity(args: {\n token0: TokenRef;\n token1: TokenRef;\n fee: FEE_TIER;\n tickLower: number;\n tickUpper: number;\n amount: NumericAmount;\n amountIsToken0: boolean;\n }): Promise<AddLiquidityEstimate> {\n validateNumericAmount(args.amount, 'amount');\n const response = await this.get<AddLiquidityEstimateWire>('/add-liq-estimate', {\n token0: rawTokenOf(args.token0),\n token1: rawTokenOf(args.token1),\n fee: `${args.fee}`,\n tickLower: `${args.tickLower}`,\n tickUpper: `${args.tickUpper}`,\n amount: new BigNumber(args.amount).toFixed(),\n amountIsToken0: String(args.amountIsToken0),\n });\n return response.data;\n }\n\n /**\n * Estimates token amounts released by burning liquidity.\n *\n * @param args - Pair, tick range, fee tier, and liquidity quantity.\n * @returns Estimated token0 and token1 quantities.\n * @example\n * ```typescript\n * const estimate = await gSwap.positions.estimateRemoveLiquidity({\n * token0: 'GALA', token1: 'GUSDC', fee: 3000,\n * tickLower: -19200, tickUpper: 12000, liquidity: '1000',\n * });\n * ```\n */\n async estimateRemoveLiquidity(args: {\n token0: TokenRef;\n token1: TokenRef;\n fee: FEE_TIER;\n tickLower: number;\n tickUpper: number;\n liquidity: NumericAmount;\n }): Promise<RemoveLiquidityEstimate> {\n validateNumericAmount(args.liquidity, 'liquidity');\n const response = await this.get<RemoveLiquidityEstimateWire>('/remove-liq-estimate', {\n token0: rawTokenOf(args.token0),\n token1: rawTokenOf(args.token1),\n fee: `${args.fee}`,\n tickLower: `${args.tickLower}`,\n tickUpper: `${args.tickUpper}`,\n liquidity: new BigNumber(args.liquidity).toFixed(),\n });\n return response.data;\n }\n\n /**\n * Adds liquidity using an explicit tick range. Exactly one canonical deposit field is emitted.\n *\n * @param args - Pair, fee, range, deposit amount, and caller-side token index.\n * @returns The synchronously submitted transaction.\n * @example\n * ```typescript\n * const tx = await gSwap.positions.addLiquidityByTicks({\n * token0: 'GALA', token1: 'GUSDC', fee: 3000,\n * tickLower: -19200, tickUpper: 12000, amount: '100', amountIsToken0: true,\n * });\n * await tx.confirm();\n * ```\n */\n async addLiquidityByTicks(args: AddLiquidityArgs) {\n return this.submitAddLiquidity(await this.buildAddLiquidity(args));\n }\n\n /**\n * Builds the AddLiquidity DTO that {@link addLiquidityByTicks} would sign, without signing or\n * sending it: to show in an approval popup, or to sign elsewhere. Submit exactly this DTO with\n * {@link submitAddLiquidity}. The pure counterpart, with canonical inputs and no resolution,\n * is `buildAddLiquidityDto`.\n *\n * @example\n * ```typescript\n * const dto = await gSwap.positions.buildAddLiquidity({\n * token0: 'GALA', token1: 'GUSDC', fee: 3000,\n * tickLower: -19200, tickUpper: 12000, amount: '100', amountIsToken0: true,\n * });\n * ```\n */\n async buildAddLiquidity(args: AddLiquidityArgs): Promise<AddLiquidityDTO> {\n validateFee(args.fee);\n const pair = await this.orderPair(args.token0, args.token1);\n const ticks = this.canonicalTicks(args.tickLower, args.tickUpper, pair.flipped);\n // Caller-facing checks first, so a refusal names the caller's own argument (`amount`).\n assertTickRange(ticks.tickLower, ticks.tickUpper, args.fee);\n validateNumericAmount(args.amount, 'amount');\n const base = {\n token0: pair.token0.symbol,\n token1: pair.token1.symbol,\n fee: args.fee,\n tickLower: ticks.tickLower,\n tickUpper: ticks.tickUpper,\n uniqueKey: this.uniqueKeyFor(args.uniqueKey),\n };\n return pair.flipped !== args.amountIsToken0\n ? buildAddLiquidityDto({ ...base, depositQuantityToken0: args.amount })\n : buildAddLiquidityDto({ ...base, depositQuantityToken1: args.amount });\n }\n\n /**\n * Signs and submits a DTO built by {@link buildAddLiquidity} or `buildAddLiquidityDto`; it must\n * be exactly what the builder produces. The returned transaction confirms by proving the\n * position's liquidity grew.\n */\n async submitAddLiquidity(dto: AddLiquidityDTO) {\n assertCanonicalV2Dto('AddLiquidity', dto);\n return this.submit('AddLiquidity', dto, { kind: 'add', identity: identityOf(dto) });\n }\n\n /**\n * Adds liquidity from prices, flooring the lower tick and ceiling the upper tick to fee spacing.\n * The resulting range is therefore no narrower than the requested price interval.\n *\n * @param args - Pair, fee, price range, deposit amount, and caller-side token index.\n * @returns The synchronously submitted transaction.\n * @example\n * ```typescript\n * const tx = await gSwap.positions.addLiquidityByPrice({\n * token0: 'GALA', token1: 'GUSDC', fee: 3000,\n * minPrice: '0.14', maxPrice: '0.16', amount: '100', amountIsToken0: true,\n * });\n * ```\n */\n async addLiquidityByPrice(args: {\n token0: TokenRef;\n token1: TokenRef;\n fee: FEE_TIER;\n minPrice: PriceIn;\n maxPrice: PriceIn;\n amount: NumericAmount;\n amountIsToken0: boolean;\n /** The attempt's `uniqueKey`; default a fresh one (see {@link AddLiquidityArgs.uniqueKey}). */\n uniqueKey?: string | undefined;\n }) {\n validateFee(args.fee);\n this.rejectNumber(args.minPrice, 'minPrice');\n this.rejectNumber(args.maxPrice, 'maxPrice');\n const minPrice = new BigNumber(args.minPrice);\n const maxPrice = new BigNumber(args.maxPrice);\n if (\n !minPrice.isFinite() ||\n !maxPrice.isFinite() ||\n minPrice.isLessThanOrEqualTo(0) ||\n maxPrice.isLessThanOrEqualTo(0)\n ) {\n throw new GSwapSDKError('INVALID_PRICE_BOUNDS', {\n minPrice: String(args.minPrice),\n maxPrice: String(args.maxPrice),\n });\n }\n if (minPrice.isGreaterThan(maxPrice)) {\n throw new GSwapSDKError('PRICE_BOUNDS_ORDER', {\n minPrice: String(args.minPrice),\n maxPrice: String(args.maxPrice),\n });\n }\n const spacing = this.tickSpacing(args.fee);\n const tickLower = alignTickDown(tickFromPrice(minPrice), spacing);\n const tickUpper = alignTickUp(tickFromPrice(maxPrice), spacing);\n return this.addLiquidityByTicks({\n token0: args.token0,\n token1: args.token1,\n fee: args.fee,\n tickLower,\n tickUpper,\n amount: args.amount,\n amountIsToken0: args.amountIsToken0,\n uniqueKey: args.uniqueKey,\n });\n }\n\n /**\n * Removes liquidity by withdrawing at most one canonical token quantity.\n * Omitting both amounts closes the position and sweeps all accrued fees.\n *\n * @param args - Pair, fee, range, and optional caller-side withdrawal amount.\n * @returns The synchronously submitted transaction.\n * @example\n * ```typescript\n * const tx = await gSwap.positions.removeLiquidity({\n * token0: 'GALA', token1: 'GUSDC', fee: 3000,\n * tickLower: -19200, tickUpper: 12000,\n * });\n * ```\n */\n async removeLiquidity(args: RemoveLiquidityArgs) {\n return this.submitRemoveLiquidity(await this.buildRemoveLiquidity(args));\n }\n\n /**\n * Builds the RemoveLiquidity DTO that {@link removeLiquidity} would sign, without signing or\n * sending it. Submit exactly this DTO with {@link submitRemoveLiquidity}. The pure counterpart\n * is `buildRemoveLiquidityDto`.\n */\n async buildRemoveLiquidity(args: RemoveLiquidityArgs): Promise<RemoveLiquidityDTO> {\n validateFee(args.fee);\n const pair = await this.orderPair(args.token0, args.token1);\n const ticks = this.canonicalTicks(args.tickLower, args.tickUpper, pair.flipped);\n assertTickRange(ticks.tickLower, ticks.tickUpper, args.fee);\n if (args.amount0 !== undefined && args.amount1 !== undefined) {\n throw new GSwapSDKError('AT_MOST_ONE_OF_ALLOWED', { first: 'amount0', second: 'amount1' });\n }\n if (args.amount0 !== undefined) validateNumericAmount(args.amount0, 'amount0');\n if (args.amount1 !== undefined) validateNumericAmount(args.amount1, 'amount1');\n // The caller's amount0 / amount1 follow the caller's pair; the DTO's follow the canonical one.\n const [canonical0, canonical1] = pair.flipped\n ? [args.amount1, args.amount0]\n : [args.amount0, args.amount1];\n return buildRemoveLiquidityDto({\n token0: pair.token0.symbol,\n token1: pair.token1.symbol,\n fee: args.fee,\n tickLower: ticks.tickLower,\n tickUpper: ticks.tickUpper,\n uniqueKey: this.uniqueKeyFor(args.uniqueKey),\n withdrawalQuantityToken0: canonical0,\n withdrawalQuantityToken1: canonical1,\n });\n }\n\n /**\n * Signs and submits a DTO built by {@link buildRemoveLiquidity} or `buildRemoveLiquidityDto`;\n * it must be exactly what the builder produces. A DTO with no withdrawal quantity closes the\n * position, and the returned transaction then confirms by proving the position is gone.\n */\n async submitRemoveLiquidity(dto: RemoveLiquidityDTO) {\n assertCanonicalV2Dto('RemoveLiquidity', dto);\n const isFullClose =\n dto.withdrawalQuantityToken0 === undefined && dto.withdrawalQuantityToken1 === undefined;\n return this.submit('RemoveLiquidity', dto, {\n kind: isFullClose ? 'removeFull' : 'removePartial',\n identity: identityOf(dto),\n });\n }\n\n /**\n * Collects all accrued fees for a position; the contract does not support partial collection.\n *\n * @param args - Pair, fee, and tick range identifying the position.\n * @returns The synchronously submitted transaction.\n * @example\n * ```typescript\n * const tx = await gSwap.positions.collectPositionFees({\n * token0: 'GALA', token1: 'GUSDC', fee: 3000,\n * tickLower: -19200, tickUpper: 12000,\n * });\n * ```\n */\n async collectPositionFees(args: CollectPositionFeesArgs) {\n return this.submitCollectPositionFees(await this.buildCollectPositionFees(args));\n }\n\n /**\n * Builds the CollectPositionFees DTO that {@link collectPositionFees} would sign, without\n * signing or sending it. Submit exactly this DTO with {@link submitCollectPositionFees}. The\n * pure counterpart is `buildCollectPositionFeesDto`.\n */\n async buildCollectPositionFees(args: CollectPositionFeesArgs): Promise<CollectPositionFeesDTO> {\n validateFee(args.fee);\n const pair = await this.orderPair(args.token0, args.token1);\n const ticks = this.canonicalTicks(args.tickLower, args.tickUpper, pair.flipped);\n assertTickRange(ticks.tickLower, ticks.tickUpper, args.fee);\n return buildCollectPositionFeesDto({\n token0: pair.token0.symbol,\n token1: pair.token1.symbol,\n fee: args.fee,\n tickLower: ticks.tickLower,\n tickUpper: ticks.tickUpper,\n uniqueKey: this.uniqueKeyFor(args.uniqueKey),\n });\n }\n\n /**\n * Signs and submits a DTO built by {@link buildCollectPositionFees} or\n * `buildCollectPositionFeesDto`; it must be exactly what the builder produces.\n */\n async submitCollectPositionFees(dto: CollectPositionFeesDTO) {\n assertCanonicalV2Dto('CollectPositionFees', dto);\n return this.submit('CollectPositionFees', dto, { kind: 'collect', identity: identityOf(dto) });\n }\n\n /**\n * Creates a pool, resolving registered trading symbols.\n * Reversed symbol order inverts the supplied starting price or square-root price.\n *\n * A token class key carries no symbol, so for a token being proposed into the v2\n * trading-symbol registry for the first time (no existing pool has registered it yet) the\n * caller MUST pass `token0Symbol`/`token1Symbol` (the token class's symbol, from the token\n * list or FetchTokenClasses). The SDK never derives a symbol from the key, and throws a\n * TOKEN_SYMBOL_NOT_REGISTERED error when an unregistered token has none. For an already-registered token a\n * supplied symbol must match the registered one.\n *\n * @param args - Token class keys or references, fee, exactly one starting price field, and privacy options.\n * @returns The synchronously submitted transaction.\n * @example\n * ```typescript\n * const tx = await gSwap.positions.createPool({\n * token0: 'GALA|Unit|none|none', token1: 'GUSDC|Unit|none|none', fee: 3000,\n * startingPrice: '0.15',\n * });\n * ```\n */\n async createPool(args: CreatePoolArgs) {\n return this.submitCreatePool(await this.buildCreatePool(args));\n }\n\n /**\n * Builds the CreatePool DTO that {@link createPool} would sign, without signing or sending it:\n * symbols resolved or proposed, the pair put in canonical order and the price inverted when it\n * was reversed. Submit exactly this DTO with {@link submitCreatePool}. The pure counterpart,\n * with canonical inputs, is `buildCreatePoolDto`.\n */\n async buildCreatePool(args: CreatePoolArgs): Promise<CreatePoolDTO> {\n const hasPrice = args.startingPrice !== undefined;\n const hasSqrtPrice = args.startingSqrtPrice !== undefined;\n if (hasPrice === hasSqrtPrice) {\n throw new GSwapSDKError('EXACTLY_ONE_OF_REQUIRED', {\n first: 'startingPrice',\n second: 'startingSqrtPrice',\n });\n }\n validateFee(args.fee);\n const [tokenA, tokenB] = await Promise.all([\n this.resolveCreateToken(args.token0, args.token0Symbol),\n this.resolveCreateToken(args.token1, args.token1Symbol),\n ]);\n const flipped = tokenA.symbol > tokenB.symbol;\n const [token0, token1] = flipped ? [tokenB, tokenA] : [tokenA, tokenB];\n const sourcePriceInput = hasPrice\n ? (args.startingPrice as NumericAmount)\n : (args.startingSqrtPrice as NumericAmount);\n this.rejectNumber(sourcePriceInput, hasPrice ? 'startingPrice' : 'startingSqrtPrice');\n const sourcePrice = new BigNumber(sourcePriceInput);\n if (!sourcePrice.isFinite() || sourcePrice.isLessThanOrEqualTo(0)) {\n throw new GSwapSDKError('INVALID_STARTING_PRICE', { value: String(sourcePriceInput) });\n }\n const canonicalPrice = flipped ? new BigNumber(1).dividedBy(sourcePrice) : sourcePrice;\n const shared = {\n token0Key: token0.classKey,\n token1Key: token1.classKey,\n token0Symbol: token0.symbol,\n token1Symbol: token1.symbol,\n fee: args.fee,\n uniqueKey: this.uniqueKeyFor(args.uniqueKey),\n name: args.name,\n isPrivate: args.isPrivate,\n privateAccess: args.privateAccess,\n };\n return hasPrice\n ? buildCreatePoolDto({ ...shared, startingPrice: canonicalPrice })\n : buildCreatePoolDto({ ...shared, startingSqrtPrice: canonicalPrice });\n }\n\n /**\n * Signs and submits a DTO built by {@link buildCreatePool} or `buildCreatePoolDto`; it must be\n * exactly what the builder produces. The returned transaction confirms by the pool existing, and\n * the cached symbol registry is dropped, since the pool may have registered new symbols.\n */\n async submitCreatePool(dto: CreatePoolDTO) {\n assertCanonicalV2Dto('CreatePool', dto);\n const transaction = await this.submit('CreatePool', dto, {\n kind: 'createPool',\n token0: dto.token0Symbol,\n token1: dto.token1Symbol,\n fee: dto.fee,\n });\n this.symbols.invalidate?.();\n return transaction;\n }\n\n private async submit(\n method: string,\n dto: Record<string, unknown>,\n confirmation?: PositionSubmitConfirmation,\n ) {\n if (this.signer === undefined) throw GSwapSDKError.noSignerError();\n const signed = await signPreSend(this.signer, method, dto);\n const submitOptions =\n this.walletAddress === undefined ? {} : { walletAddress: this.walletAddress };\n const owner = this.walletAddress;\n const positionConfirmation = this.buildPositionConfirmation(confirmation, owner);\n const options: ChainSubmitOptions = {\n ...submitOptions,\n ...(positionConfirmation === undefined ? {} : { positionConfirmation }),\n };\n return this.gateway.submit(method, signed, options);\n }\n\n /**\n * Builds a confirmation closure that proves the write's own effect, not just that a\n * position row exists (true before most of these writes run too, for any operation on a\n * pre-existing position — existence alone would false-confirm before the write executes,\n * and would never confirm a full close, whose whole point is that the position stops\n * existing).\n *\n * The \"before\" state is captured lazily, on the confirmation closure's own first poll —\n * not eagerly here in `submit()` — so confirming a write never adds an extra round-trip to\n * the write itself; the cost of establishing the baseline is paid by `confirm()`, only if\n * and when the caller actually asks to confirm.\n */\n private buildPositionConfirmation(\n confirmation: PositionSubmitConfirmation | undefined,\n owner: string | undefined,\n ): ((signal: AbortSignal) => Promise<PositionConfirmationResult>) | undefined {\n if (confirmation === undefined) return undefined;\n\n if (confirmation.kind === 'createPool') {\n const { token0, token1, fee } = confirmation;\n return async (signal) => {\n const pool = await this.getNullable<unknown>(\n '/pool',\n { token0, token1, fee: `${fee}` },\n signal,\n );\n return pool === null ? { confirmed: false } : { confirmed: true, position: null };\n };\n }\n\n if (owner === undefined) return undefined;\n const { kind, identity } = confirmation;\n let baseline: { liquidity: BigNumber; fees: BigNumber } | undefined;\n\n return async (signal) => {\n const current = await this.getPosition({ ...identity, owner }, signal);\n\n if (baseline === undefined) {\n // First poll only establishes the baseline to compare future polls against — it can\n // never itself be the confirmed outcome (nothing has been observed to change yet).\n baseline = {\n liquidity: new BigNumber(current?.liquidity ?? 0),\n fees: new BigNumber(current?.fees0 ?? 0).plus(new BigNumber(current?.fees1 ?? 0)),\n };\n // A full close starting from \"already gone\" (e.g. a retried confirm after the position\n // was already swept) is confirmed immediately rather than waiting for a change that\n // already happened.\n return kind === 'removeFull' && current === null\n ? { confirmed: true, position: null }\n : { confirmed: false };\n }\n\n switch (kind) {\n case 'add':\n return current !== null &&\n new BigNumber(current.liquidity).isGreaterThan(baseline.liquidity)\n ? { confirmed: true, position: current }\n : { confirmed: false };\n case 'removePartial':\n return current !== null && new BigNumber(current.liquidity).isLessThan(baseline.liquidity)\n ? { confirmed: true, position: current }\n : { confirmed: false };\n case 'removeFull':\n return current === null ? { confirmed: true, position: null } : { confirmed: false };\n case 'collect': {\n if (current === null) return { confirmed: false };\n const currentFees = new BigNumber(current.fees0 ?? 0).plus(\n new BigNumber(current.fees1 ?? 0),\n );\n if (currentFees.isLessThan(baseline.fees)) return { confirmed: true, position: current };\n // Nothing to sweep in the first place — a legitimate no-op collect never moves\n // fees, so \"still zero\" is the confirmed outcome, not an unconfirmed one.\n if (baseline.fees.isZero() && currentFees.isZero())\n return { confirmed: true, position: current };\n return { confirmed: false };\n }\n }\n };\n }\n\n private async get<TData>(\n endpoint: string,\n params: Record<string, string>,\n signal?: AbortSignal,\n ): Promise<BackendEnvelope<TData>> {\n return this.http.sendGetRequest<BackendEnvelope<TData>>(\n this.gateway.dexBackendBaseUrl,\n '/v2/trade',\n endpoint,\n params,\n signal === undefined ? undefined : { signal },\n );\n }\n\n private async getNullable<TData>(\n endpoint: string,\n params: Record<string, string>,\n signal?: AbortSignal,\n ): Promise<BackendEnvelope<TData> | null> {\n try {\n return await this.get<TData>(endpoint, params, signal);\n } catch (error: unknown) {\n if (this.isNotFound(error)) return null;\n throw error;\n }\n }\n\n private isNotFound(error: unknown): boolean {\n return error instanceof GSwapSDKError && error.status === 404;\n }\n\n private canonicalTicks(tickLower: number, tickUpper: number, flipped: boolean) {\n return flipped ? { tickLower: -tickUpper, tickUpper: -tickLower } : { tickLower, tickUpper };\n }\n\n private tickSpacing(fee: number): number {\n const spacing = (TICK_SPACING_BY_FEE as Record<number, number>)[fee];\n if (spacing === undefined) {\n throw new GSwapSDKError('INVALID_FEE', {\n field: 'fee',\n value: fee,\n allowed: ALLOWED_FEE_TIERS_TEXT,\n });\n }\n return spacing;\n }\n\n private rejectNumber(value: unknown, parameterName: string): void {\n if (typeof value === 'number') {\n throw new GSwapSDKError('AMOUNT_IS_JS_NUMBER', { field: parameterName });\n }\n }\n\n /** The caller's `uniqueKey` (validated), else a fresh one. */\n private uniqueKeyFor(supplied: string | undefined): string {\n if (supplied === undefined) return createUniqueKey(this.uniqueKeyPrefix);\n assertUniqueKey(supplied);\n return supplied;\n }\n\n /**\n * The pair in canonical order. A resolver failure that is not an SDK error (an app's own\n * resolver, an app requestor's rejection during the registry read) is `TOKEN_RESOLUTION_FAILED`.\n */\n private orderPair(a: TokenRef, b: TokenRef) {\n return resolvePreSend(`${rawTokenOf(a)}/${rawTokenOf(b)}`, () => this.symbols.orderPair(a, b));\n }\n\n private async resolveCreateToken(\n ref: TokenRef,\n symbolOverride?: string,\n ): Promise<ResolvedCreateToken> {\n try {\n const lookupRef = typeof ref === 'object' ? compositeKeyOf(ref) : ref;\n const resolved = await resolvePreSend(rawTokenOf(ref), () => this.symbols.resolve(lookupRef));\n if (\n symbolOverride !== undefined &&\n symbolOverride !== '' &&\n symbolOverride !== resolved.symbol\n ) {\n throw new GSwapSDKError('SYMBOL_DISAGREES_WITH_REGISTRY', {\n token: rawTokenOf(ref),\n suppliedSymbol: symbolOverride,\n registeredSymbol: resolved.symbol,\n });\n }\n const suppliedClassKey = this.tryParseClassKey(ref);\n if (suppliedClassKey === undefined && resolved.collection === '') {\n // An offline resolver knows a bare symbol but not its class key; a pool needs the key.\n throw new GSwapSDKError('CREATE_POOL_NEEDS_CLASS_KEY', { token: rawTokenOf(ref) });\n }\n return {\n symbol: resolved.symbol,\n classKey:\n suppliedClassKey ??\n parseTokenClassKey({\n collection: resolved.collection,\n category: resolved.category,\n type: resolved.type,\n additionalKey: resolved.additionalKey,\n }),\n };\n } catch (error: unknown) {\n if (!(error instanceof GSwapSDKError) || error.code !== 'UNKNOWN_TOKEN') {\n throw error;\n }\n let classKey: ReturnType<typeof parseTokenClassKey>;\n try {\n classKey = parseTokenClassKey(ref);\n } catch {\n throw error;\n }\n // First-time registration: a class key carries NO symbol (collection and symbol disagree\n // for many tokens, launchpad tokens all share collection `Token`, and some collections\n // contain `$`), so the symbol to propose must be supplied by the caller from the token\n // class / registry. Never derive it from the key.\n if (symbolOverride === undefined || symbolOverride === '') {\n throw new GSwapSDKError('TOKEN_SYMBOL_NOT_REGISTERED', { token: rawTokenOf(ref) });\n }\n if (!isProposableTradingSymbol(symbolOverride)) {\n throw new GSwapSDKError('INVALID_TRADING_SYMBOL', { symbol: symbolOverride });\n }\n return { symbol: symbolOverride, classKey };\n }\n }\n\n private tryParseClassKey(ref: TokenRef): ReturnType<typeof parseTokenClassKey> | undefined {\n try {\n return parseTokenClassKey(ref);\n } catch {\n return undefined;\n }\n }\n}\n\nconst REQUIRED_POSITION_STRINGS = [\n 'token0Symbol',\n 'token1Symbol',\n 'owner',\n 'liquidity',\n 'amount0',\n 'amount1',\n] as const;\nconst REQUIRED_POSITION_NUMBERS = ['fee', 'tickLower', 'tickUpper'] as const;\nconst OPTIONAL_POSITION_STRINGS = [\n 'token0CompositeKey',\n 'token1CompositeKey',\n 'token0Image',\n 'token1Image',\n 'sqrtPrice',\n 'fees0',\n 'fees1',\n] as const;\n\n/**\n * Reads one position row of `/positions` or `/position`: the pair, owner, range, liquidity and\n * amounts must be usable; the composite keys, token images, current tick and price, and the\n * escrowed fees are carried when present. `pool` is the pool reference (`poolRef` wins over\n * `pool`; `''` when the row names neither).\n */\nfunction parsePosition(value: unknown): EntryParse<Position> {\n const wire = asEntryRecord(value);\n if (wire === undefined) return entryRejected('the row is not an object');\n for (const key of REQUIRED_POSITION_STRINGS) {\n if (typeof wire[key] !== 'string') return entryRejected(`${key} is not a string`);\n }\n for (const key of REQUIRED_POSITION_NUMBERS) {\n const number = wire[key];\n if (typeof number !== 'number' || !Number.isFinite(number)) {\n return entryRejected(`${key} is not a number`);\n }\n }\n if (typeof wire['inRange'] !== 'boolean') return entryRejected('inRange is not a boolean');\n for (const key of OPTIONAL_POSITION_STRINGS) {\n if (wire[key] !== undefined && typeof wire[key] !== 'string') {\n return entryRejected(`${key} is not a string`);\n }\n }\n const currentTick = wire['currentTick'];\n if (\n currentTick !== undefined &&\n (typeof currentTick !== 'number' || !Number.isFinite(currentTick))\n ) {\n return entryRejected('currentTick is not a number');\n }\n const pool = wire['poolRef'] ?? wire['pool'] ?? '';\n if (typeof pool !== 'string') return entryRejected('pool is not a string');\n const optional = Object.fromEntries(\n [...OPTIONAL_POSITION_STRINGS, 'currentTick' as const].flatMap((key) =>\n wire[key] === undefined ? [] : [[key, wire[key]]],\n ),\n );\n return entryOk({\n token0Symbol: wire['token0Symbol'] as string,\n token1Symbol: wire['token1Symbol'] as string,\n fee: wire['fee'] as number,\n tickLower: wire['tickLower'] as number,\n tickUpper: wire['tickUpper'] as number,\n liquidity: wire['liquidity'] as string,\n amount0: wire['amount0'] as string,\n amount1: wire['amount1'] as string,\n inRange: wire['inRange'],\n pool,\n owner: wire['owner'] as string,\n ...optional,\n });\n}\n\n/** The position inside a `/position` answer, or `INVALID_CHAIN_RESPONSE` when it is not one. */\nfunction readPositionBody(data: unknown): Position {\n const parsed = parsePosition(data);\n if (parsed.ok) return parsed.value;\n throw new GSwapSDKError('INVALID_POSITION_RESPONSE', { reason: parsed.reason }, { body: data });\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
import{readServerMessage as e}from"../utils/server_message.js";import{ALLOWED_FEE_TIERS_TEXT as t}from"./error_catalog.js";import n from"../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/defineProperty.js";import{GSwapSDKError as r,isGSwapError as i}from"./gswap_sdk_error.js";import{ALL_FEE_TIERS as a}from"../types/fees.js";import{validateNumericAmount as o}from"../utils/validation.js";import{HttpClient as s}from"./http_client.js";import{queryTokenOf as c}from"./symbols.js";import l from"bignumber.js";var u=class{constructor(e,t){this.gateway=e,this.symbols=t,n(this,`http`,void 0),this.http=new s(e.httpRequestor,e.requestTimeoutMs??3e4,e.wire)}async quoteExactInput(e,t,n,r){return o(n,`amountIn`),this.quote(e,t,{amountIn:x(n)},r)}async quoteExactOutput(e,t,n,r){return o(n,`amountOut`),this.quote(e,t,{amountOut:x(n)},r)}async quote(e,t,n,r){b(r);let i={tokenIn:await c(this.symbols,e),tokenOut:await c(this.symbols,t),...n};r!==void 0&&(i.fee=String(r));try{return d((await this.http.sendGetRequest(this.gateway.dexBackendBaseUrl,`/v2/trade`,`/quote`,i)).data)}catch(n){throw y(n,e,t,r,{tokenIn:i.tokenIn??``,tokenOut:i.tokenOut??``})}}};function d(e){if(!m(e))throw new r(`INVALID_CHAIN_RESPONSE`,{resource:`quote`},{body:e});let t=e,n=t.currentPrice===void 0?p(t.currentSqrtPrice,t.tokenInIsToken0):new l(t.currentPrice),i=t.newPrice===void 0?p(t.newSqrtPrice,t.tokenInIsToken0):new l(t.newPrice),a=i.minus(n).dividedBy(n);return{contractVersion:t.contractVersion,fee:t.fee,amountIn:t.amountIn,amountOut:t.amountOut,...t.currentSqrtPrice===void 0?{}:{currentSqrtPrice:t.currentSqrtPrice},...t.newSqrtPrice===void 0?{}:{newSqrtPrice:t.newSqrtPrice},feeTier:t.fee,newTick:t.newTick,tradingFees:t.tradingFees,protocolFees:t.protocolFees,totalFees:t.totalFees,feeTokenSymbol:t.feeTokenSymbol,token0Symbol:t.token0Symbol,token1Symbol:t.token1Symbol,tokenInIsToken0:t.tokenInIsToken0,currentPrice:n,newPrice:i,priceImpact:a}}const f=l.clone({DECIMAL_PLACES:60});function p(e,t){let n=new f(e).pow(2);return t?n:new f(1).dividedBy(n)}function m(e){if(typeof e!=`object`||!e)return!1;let t=e;return t.contractVersion===`v2`&&typeof t.fee==`number`&&Number.isFinite(t.fee)&&[`amountIn`,`amountOut`,`tradingFees`,`protocolFees`,`totalFees`,`feeTokenSymbol`,`token0Symbol`,`token1Symbol`].every(e=>typeof t[e]==`string`)&&typeof t.newTick==`number`&&Number.isInteger(t.newTick)&&typeof t.tokenInIsToken0==`boolean`&&h(t.currentSqrtPrice)&&h(t.newSqrtPrice)&&h(t.currentPrice)&&h(t.newPrice)&&(t.currentSqrtPrice!==void 0||t.currentPrice!==void 0)&&(t.newSqrtPrice!==void 0||t.newPrice!==void 0)}function h(e){if(e===void 0)return!0;if(typeof e!=`string`)return!1;try{let t=new l(e);return t.isFinite()&&t.isGreaterThan(0)}catch{return!1}}const g=/no pool|no pools|pool does not exist/iu,_=/Token (\S+) has no trading symbol on the new DEX contract/u;function v(e,t,n,r){return e===t.tokenIn?n:e===t.tokenOut?r:e}function y(t,n,a,o,s){if(i(t)){let i=e(t)??``,c=_.exec(i)?.[1];return c===void 0?t.status===404||g.test(i)?r.noPoolAvailableError(n,a,o,t):t.status===400&&/insufficient liquidity/iu.test(i)?r.insufficientLiquidityError(n,a,o,t):t:r.unknownTokenError(v(c,s,n,a),t)}return new r(`REQUEST_FAILED`,{operation:`quote`},{cause:t})}function b(e){if(e!==void 0&&!a.some(t=>Number(t)===Number(e)))throw new r(`INVALID_FEE`,{field:`fee`,value:Number(e),allowed:t})}function x(e){return new l(e).toFixed()}export{u as Quoting};
|
|
2
|
+
//# sourceMappingURL=quoting.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"quoting.js","names":[],"sources":["../../../src/classes/quoting.ts"],"sourcesContent":["import BigNumber from 'bignumber.js';\nimport type { NumericAmount } from '../types/amounts.js';\nimport { ALL_FEE_TIERS } from '../types/fees.js';\nimport type { FEE_TIER } from '../types/fees.js';\nimport type { QuoteResult } from '../types/v2_results.js';\nimport type { TokenRef } from '../utils/ordering.js';\nimport { validateNumericAmount } from '../utils/validation.js';\nimport type { WireOptions } from '../types/wire.js';\nimport type { ChainGateway } from './gateway.js';\nimport { ALLOWED_FEE_TIERS_TEXT } from './error_catalog.js';\nimport { readServerMessage } from '../utils/server_message.js';\nimport { GSwapSDKError, isGSwapError } from './gswap_sdk_error.js';\nimport { HttpClient } from './http_client.js';\nimport { queryTokenOf, type TokenResolver } from './symbols.js';\n\ninterface QuoteWire {\n contractVersion: 'v2';\n fee: number;\n amountIn: string;\n amountOut: string;\n currentSqrtPrice?: string;\n newSqrtPrice?: string;\n currentPrice?: string;\n newPrice?: string;\n newTick: number;\n tradingFees: string;\n protocolFees: string;\n totalFees: string;\n feeTokenSymbol: string;\n token0Symbol: string;\n token1Symbol: string;\n tokenInIsToken0: boolean;\n}\n\ninterface BackendEnvelope<T> {\n data: T;\n}\n\n/** The transport a quote service reads through: the same shape `Pools` and `Symbols` take. */\ntype QuoteGateway = Pick<ChainGateway, 'httpRequestor' | 'dexBackendBaseUrl'> & {\n requestTimeoutMs?: number | undefined;\n wire?: WireOptions | undefined;\n};\n\n/** Read-only quote service backed by the v2 offline quote engine. */\nexport class Quoting {\n /**\n * Creates a quote service.\n *\n * @example\n * ```ts\n * const quoting = new Quoting(gateway, symbols); // a ChainGateway, or any { dexBackendBaseUrl, httpRequestor }\n * ```\n */\n constructor(\n private readonly gateway: QuoteGateway,\n private readonly symbols: TokenResolver,\n ) {\n this.http = new HttpClient(\n gateway.httpRequestor,\n gateway.requestTimeoutMs ?? 30_000,\n gateway.wire,\n );\n }\n\n private readonly http: HttpClient;\n\n /**\n * Quotes the output for a positive exact-input amount.\n *\n * @example\n * ```ts\n * const quote = await quoting.quoteExactInput('GALA', 'GUSDC', '100');\n * console.log(quote.amountOut);\n * ```\n */\n public async quoteExactInput(\n tokenIn: TokenRef,\n tokenOut: TokenRef,\n amountIn: NumericAmount,\n fee?: FEE_TIER,\n ): Promise<QuoteResult> {\n validateNumericAmount(amountIn, 'amountIn');\n return this.quote(tokenIn, tokenOut, { amountIn: toDecimalString(amountIn) }, fee);\n }\n\n /**\n * Quotes the input for a positive exact-output amount.\n *\n * @example\n * ```ts\n * const quote = await quoting.quoteExactOutput('GALA', 'GUSDC', '10', 3000);\n * console.log(quote.amountIn);\n * ```\n */\n public async quoteExactOutput(\n tokenIn: TokenRef,\n tokenOut: TokenRef,\n amountOut: NumericAmount,\n fee?: FEE_TIER,\n ): Promise<QuoteResult> {\n validateNumericAmount(amountOut, 'amountOut');\n return this.quote(tokenIn, tokenOut, { amountOut: toDecimalString(amountOut) }, fee);\n }\n\n private async quote(\n tokenIn: TokenRef,\n tokenOut: TokenRef,\n amount: { amountIn: string } | { amountOut: string },\n fee?: FEE_TIER,\n ): Promise<QuoteResult> {\n validateOptionalFee(fee);\n\n const params: Record<string, string> = {\n tokenIn: await queryTokenOf(this.symbols, tokenIn),\n tokenOut: await queryTokenOf(this.symbols, tokenOut),\n ...amount,\n };\n if (fee !== undefined) params['fee'] = String(fee);\n\n try {\n const response = await this.http.sendGetRequest<BackendEnvelope<QuoteWire>>(\n this.gateway.dexBackendBaseUrl,\n '/v2/trade',\n '/quote',\n params,\n );\n return mapQuote(response.data);\n } catch (error: unknown) {\n throw mapQuoteError(error, tokenIn, tokenOut, fee, {\n tokenIn: params['tokenIn'] ?? '',\n tokenOut: params['tokenOut'] ?? '',\n });\n }\n }\n}\n\nfunction mapQuote(value: unknown): QuoteResult {\n if (!isQuoteWire(value)) {\n throw new GSwapSDKError('INVALID_CHAIN_RESPONSE', { resource: 'quote' }, { body: value });\n }\n const wire = value;\n const currentPrice =\n wire.currentPrice !== undefined\n ? new BigNumber(wire.currentPrice)\n : orientPrice(wire.currentSqrtPrice!, wire.tokenInIsToken0);\n const newPrice =\n wire.newPrice !== undefined\n ? new BigNumber(wire.newPrice)\n : orientPrice(wire.newSqrtPrice!, wire.tokenInIsToken0);\n const priceImpact = newPrice.minus(currentPrice).dividedBy(currentPrice);\n\n return {\n contractVersion: wire.contractVersion,\n fee: wire.fee,\n amountIn: wire.amountIn,\n amountOut: wire.amountOut,\n ...(wire.currentSqrtPrice === undefined ? {} : { currentSqrtPrice: wire.currentSqrtPrice }),\n ...(wire.newSqrtPrice === undefined ? {} : { newSqrtPrice: wire.newSqrtPrice }),\n feeTier: wire.fee,\n newTick: wire.newTick,\n tradingFees: wire.tradingFees,\n protocolFees: wire.protocolFees,\n totalFees: wire.totalFees,\n feeTokenSymbol: wire.feeTokenSymbol,\n token0Symbol: wire.token0Symbol,\n token1Symbol: wire.token1Symbol,\n tokenInIsToken0: wire.tokenInIsToken0,\n currentPrice,\n newPrice,\n priceImpact,\n };\n}\n\n// The default BigNumber.DECIMAL_PLACES (20) underflows 1/poolPrice to exactly 0 for a\n// pool price above ~1e20 (a real, in-range price for a low-unit-value token quoted\n// against a high-value one) — 60dp matches the precision ticks.ts's DexMath already\n// uses for this same class of division.\nconst HighPrecision = BigNumber.clone({ DECIMAL_PLACES: 60 });\n\nfunction orientPrice(sqrtPrice: string, tokenInIsToken0: boolean): BigNumber {\n const poolPrice = new HighPrecision(sqrtPrice).pow(2);\n return tokenInIsToken0 ? poolPrice : new HighPrecision(1).dividedBy(poolPrice);\n}\n\nfunction isQuoteWire(value: unknown): value is QuoteWire {\n if (typeof value !== 'object' || value === null) return false;\n const wire = value as Record<string, unknown>;\n const requiredStrings = [\n 'amountIn',\n 'amountOut',\n 'tradingFees',\n 'protocolFees',\n 'totalFees',\n 'feeTokenSymbol',\n 'token0Symbol',\n 'token1Symbol',\n ];\n return (\n wire['contractVersion'] === 'v2' &&\n typeof wire['fee'] === 'number' &&\n Number.isFinite(wire['fee']) &&\n requiredStrings.every((key) => typeof wire[key] === 'string') &&\n typeof wire['newTick'] === 'number' &&\n Number.isInteger(wire['newTick']) &&\n typeof wire['tokenInIsToken0'] === 'boolean' &&\n optionalPositiveDecimal(wire['currentSqrtPrice']) &&\n optionalPositiveDecimal(wire['newSqrtPrice']) &&\n optionalPositiveDecimal(wire['currentPrice']) &&\n optionalPositiveDecimal(wire['newPrice']) &&\n (wire['currentSqrtPrice'] !== undefined || wire['currentPrice'] !== undefined) &&\n (wire['newSqrtPrice'] !== undefined || wire['newPrice'] !== undefined)\n );\n}\n\nfunction optionalPositiveDecimal(value: unknown): boolean {\n if (value === undefined) return true;\n if (typeof value !== 'string') return false;\n try {\n // bignumber.js 11+ throws on an unparseable value instead of constructing a NaN\n // instance — this validates an untrusted backend field, so an unparseable value\n // must fail validation cleanly (INVALID_CHAIN_RESPONSE), not throw raw.\n const decimal = new BigNumber(value);\n return decimal.isFinite() && decimal.isGreaterThan(0);\n } catch {\n return false;\n }\n}\n\n/**\n * The ways the backend says a pair has no market at all: no pool at ANY fee tier (\"No pools found\n * with sufficient liquidity\") or a missing pool (\"Pool does not exist on the new DEX contract\").\n * A pool that exists but is too thin says \"Insufficient liquidity: ...\" instead.\n */\nconst NO_MARKET_MESSAGE = /no pool|no pools|pool does not exist/iu;\n\n/**\n * A token the DEX contract never registered: the backend's symbol registry answers\n * `Token <token> has no trading symbol on the new DEX contract (no gcdex pool includes it yet).`\n * with an HTTP 400, naming the token exactly as the quote request sent it. That is a different\n * fact from \"no pool for this pair\" (the token itself is unknown), so it is `UNKNOWN_TOKEN` with\n * the token, not `NO_POOL_AVAILABLE`. Token class keys and symbols contain no whitespace.\n */\nconst NO_SYMBOL_MESSAGE = /Token (\\S+) has no trading symbol on the new DEX contract/u;\n\n/** The token the quote request named in the form the caller gave it, else as the backend echoed it. */\nfunction unknownTokenOf(\n echoed: string,\n queried: { tokenIn: string; tokenOut: string },\n tokenIn: TokenRef,\n tokenOut: TokenRef,\n): TokenRef {\n if (echoed === queried.tokenIn) return tokenIn;\n if (echoed === queried.tokenOut) return tokenOut;\n return echoed;\n}\n\nfunction mapQuoteError(\n error: unknown,\n tokenIn: TokenRef,\n tokenOut: TokenRef,\n fee: FEE_TIER | undefined,\n queried: { tokenIn: string; tokenOut: string },\n): GSwapSDKError {\n if (isGSwapError(error)) {\n // The backend's own English is read ONLY to classify its answer; it is never surfaced. The\n // SDK's generated `message` is never matched: its templates are not a contract.\n const message = readServerMessage(error) ?? '';\n const unregistered = NO_SYMBOL_MESSAGE.exec(message)?.[1];\n if (unregistered !== undefined) {\n return GSwapSDKError.unknownTokenError(\n unknownTokenOf(unregistered, queried, tokenIn, tokenOut),\n error,\n );\n }\n if (error.status === 404 || NO_MARKET_MESSAGE.test(message)) {\n return GSwapSDKError.noPoolAvailableError(tokenIn, tokenOut, fee, error);\n }\n if (error.status === 400 && /insufficient liquidity/iu.test(message)) {\n return GSwapSDKError.insufficientLiquidityError(tokenIn, tokenOut, fee, error);\n }\n return error;\n }\n return new GSwapSDKError('REQUEST_FAILED', { operation: 'quote' }, { cause: error });\n}\n\nfunction validateOptionalFee(fee: FEE_TIER | undefined): void {\n if (fee !== undefined && !ALL_FEE_TIERS.some((tier) => Number(tier) === Number(fee))) {\n throw new GSwapSDKError('INVALID_FEE', {\n field: 'fee',\n value: Number(fee),\n allowed: ALLOWED_FEE_TIERS_TEXT,\n });\n }\n}\n\nfunction toDecimalString(amount: NumericAmount): string {\n return new BigNumber(amount).toFixed();\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
import{GSwapSDKError as e,getStringProperty as t}from"./gswap_sdk_error.js";const n=[`SHADOW_UNAVAILABLE`,`SHADOW_UNSUPPORTED_TYPE`,`SHADOW_RELAY_REJECTED`],r=[`unavailable`,`disabled`,`rejected`,`unknown`];function i(e){return e===503?`unavailable`:e===400?`disabled`:`unknown`}function a(e,t){return t===`SHADOW_UNAVAILABLE`?`unavailable`:t===`SHADOW_RELAY_REJECTED`?`rejected`:t===`SHADOW_UNSUPPORTED_TYPE`?`disabled`:i(e)}function o(n,r,i){let{httpStatus:o,body:c}=i,l=s(c);if(o>=200&&o<300&&l?.error===!1){let t=s(l.data),i=typeof t?.transactionId==`string`?t.transactionId:void 0;if(n===`RequestTrade`){let n=r.uniqueKey;if(t?.mode!==`queued`||typeof n!=`string`||t.uniqueKey!==n)throw new e(`SHADOW_NOT_QUEUED`,{},{status:o,body:c,shadow:!0,...typeof n==`string`?{uniqueKey:n}:{}});return{ok:!0,bundleId:i??``,queued:{uniqueKey:n,requestTransactionId:i??null}}}if(t?.mode===`sync`)return{ok:!0,bundleId:i??``}}let u=a(o,t(c,`code`));return u===`rejected`?{ok:!1,kind:`rejected`,retryable:!1,message:t(c,`message`)??``}:u===`unavailable`?{ok:!1,kind:u,retryable:!0}:{ok:!1,kind:u,retryable:!1}}function s(e){return typeof e==`object`&&e?e:void 0}export{r as SHADOW_FAILURE_KINDS,n as SHADOW_SUBMIT_CODES,a as classifyShadowSubmitError,i as classifyShadowSubmitStatus,o as readShadowSubmitOutcome};
|
|
2
|
+
//# sourceMappingURL=shadow_submit.js.map
|