@solana/rpc-subscriptions 2.0.0-20241006045741

package/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2023 Solana Labs, Inc
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,54 @@
+[![npm][npm-image]][npm-url]
+[![npm-downloads][npm-downloads-image]][npm-url]
+[![semantic-release][semantic-release-image]][semantic-release-url]
+<br />
+[![code-style-prettier][code-style-prettier-image]][code-style-prettier-url]
+
+[code-style-prettier-image]: https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square
+[code-style-prettier-url]: https://github.com/prettier/prettier
+[npm-downloads-image]: https://img.shields.io/npm/dm/@solana/rpc-subscriptions/rc.svg?style=flat
+[npm-image]: https://img.shields.io/npm/v/@solana/rpc-subscriptions/rc.svg?style=flat
+[npm-url]: https://www.npmjs.com/package/@solana/rpc-subscriptions/v/rc
+[semantic-release-image]: https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg
+[semantic-release-url]: https://github.com/semantic-release/semantic-release
+
+# @solana/rpc-subscriptions
+
+This package contains types that implement RPC subscriptions as required by the Solana RPC. Additionally, it incorporates some useful defaults that make working with subscriptions easier, more performant, and more reliable. It can be used standalone, but it is also exported as part of the Solana JavaScript SDK [`@solana/web3.js@rc`](https://github.com/solana-labs/solana-web3.js/tree/master/packages/library).
+
+## Functions
+
+### `createDefaultRpcSubscriptionsChannelCreator(config)`
+
+Creates a function that returns new subscription channels when called.
+
+#### Arguments
+
+A config object with the following properties:
+
+-   `intervalMs`: The number of milliseconds to wait since the last message sent or received over the channel before sending a ping message to keep the channel open.
+-   `maxSubscriptionsPerChannel`: The number of subscribers that may share a channel before a new channel must be created. Set this to the maximum number of subscriptions that your RPC provider recommends making over a single connection.
+-   `minChannels`: The number of channels to create before reusing a channel for a new subscription.
+-   `sendBufferHighWatermark`: The number of bytes of data to admint into the `WebSocket` buffer before buffering data on the client. -`url`: The URL of the web socket server. Must use the `ws` or `wss` protocols.
+
+### `getChannelPoolingChannelCreator(createChannel, { maxSubscriptionsPerChannel, minChannels })`
+
+Given a channel creator, will return a new channel creator with the following behavior.
+
+1. When called, returns an `RpcSubscriptionsChannel`. Adds that channel to a pool.
+2. When called again, creates and returns new `RpcSubscriptionChannels` up to the number specified by `minChannels`.
+3. When `minChannels` channels have been created, subsequent calls vend whichever existing channel from the pool has the fewest subscribers, or the next one in rotation in the event of a tie.
+4. Once all channels carry the number of subscribers specified by the number `maxSubscriptionsPerChannel`, new channels in excess of `minChannel` will be created, returned, and added to the pool.
+5. A channel will be destroyed once all of its subscribers' abort signals fire.
+
+### `getRpcSubscriptionsChannelWithJSONSerialization(channel)`
+
+Given an `RpcSubscriptionsChannel`, will return a new channel that parses data published to the `'message'` channel as JSON, and JSON-stringifies messages sent via the `send(message)` method.
+
+### `getRpcSubscriptionsChannelWithAutoping(channel)`
+
+Given an `RpcSubscriptionsChannel`, will return a new channel that sends a ping message to the inner channel if a message has not been sent or received in the last `intervalMs`. In web browsers, this implementation sends no ping when the network is down, and sends a ping immediately upon the network coming back up.
+
+### `getRpcSubscriptionsTransportWithSubscriptionCoalescing(transport)`
+
+Given an `RpcSubscriptionsTransport`, will return a new transport that coalesces identical subscriptions into a single subscription request to the server. The determination of whether a subscription is the same as another is based on the `subscriptionConfigurationHash` returned by its `RpcSubscriptionsPlan`. The subscription will only be aborted once all subscribers abort, or there is an error.

package/dist/index.browser.cjs

@@ -0,0 +1,358 @@
+'use strict';
+
+var rpcSubscriptionsApi = require('@solana/rpc-subscriptions-api');
+var rpcSubscriptionsSpec = require('@solana/rpc-subscriptions-spec');
+var errors = require('@solana/errors');
+var rpcSubscriptionsChannelWebsocket = require('@solana/rpc-subscriptions-channel-websocket');
+var functional = require('@solana/functional');
+
+// src/index.ts
+function createSolanaJsonRpcIntegerOverflowError(methodName, keyPath, value) {
+  let argumentLabel = "";
+  if (typeof keyPath[0] === "number") {
+    const argPosition = keyPath[0] + 1;
+    const lastDigit = argPosition % 10;
+    const lastTwoDigits = argPosition % 100;
+    if (lastDigit == 1 && lastTwoDigits != 11) {
+      argumentLabel = argPosition + "st";
+    } else if (lastDigit == 2 && lastTwoDigits != 12) {
+      argumentLabel = argPosition + "nd";
+    } else if (lastDigit == 3 && lastTwoDigits != 13) {
+      argumentLabel = argPosition + "rd";
+    } else {
+      argumentLabel = argPosition + "th";
+    }
+  } else {
+    argumentLabel = `\`${keyPath[0].toString()}\``;
+  }
+  const path = keyPath.length > 1 ? keyPath.slice(1).map((pathPart) => typeof pathPart === "number" ? `[${pathPart}]` : pathPart).join(".") : void 0;
+  const error = new errors.SolanaError(errors.SOLANA_ERROR__RPC__INTEGER_OVERFLOW, {
+    argumentLabel,
+    keyPath,
+    methodName,
+    optionalPathLabel: path ? ` at path \`${path}\`` : "",
+    value,
+    ...path !== void 0 ? { path } : void 0
+  });
+  errors.safeCaptureStackTrace(error, createSolanaJsonRpcIntegerOverflowError);
+  return error;
+}
+
+// src/rpc-default-config.ts
+var DEFAULT_RPC_SUBSCRIPTIONS_CONFIG = {
+  defaultCommitment: "confirmed",
+  onIntegerOverflow(request, keyPath, value) {
+    throw createSolanaJsonRpcIntegerOverflowError(request.methodName, keyPath, value);
+  }
+};
+
+// src/rpc-subscriptions-autopinger.ts
+var PING_PAYLOAD = {
+  jsonrpc: "2.0",
+  method: "ping"
+};
+function getRpcSubscriptionsChannelWithAutoping({
+  abortSignal: callerAbortSignal,
+  channel,
+  intervalMs
+}) {
+  let intervalId;
+  function sendPing() {
+    channel.send(PING_PAYLOAD);
+  }
+  function restartPingTimer() {
+    clearInterval(intervalId);
+    intervalId = setInterval(sendPing, intervalMs);
+  }
+  const pingerAbortController = new AbortController();
+  pingerAbortController.signal.addEventListener("abort", () => {
+    clearInterval(intervalId);
+  });
+  callerAbortSignal.addEventListener("abort", () => {
+    pingerAbortController.abort();
+  });
+  channel.on(
+    "error",
+    () => {
+      pingerAbortController.abort();
+    },
+    { signal: pingerAbortController.signal }
+  );
+  channel.on("message", restartPingTimer, { signal: pingerAbortController.signal });
+  if (globalThis.navigator.onLine) {
+    restartPingTimer();
+  }
+  {
+    globalThis.window.addEventListener(
+      "offline",
+      function handleOffline() {
+        clearInterval(intervalId);
+      },
+      { signal: pingerAbortController.signal }
+    );
+    globalThis.window.addEventListener(
+      "online",
+      function handleOnline() {
+        sendPing();
+        restartPingTimer();
+      },
+      { signal: pingerAbortController.signal }
+    );
+  }
+  return {
+    ...channel,
+    send(...args) {
+      if (!pingerAbortController.signal.aborted) {
+        restartPingTimer();
+      }
+      return channel.send(...args);
+    }
+  };
+}
+
+// src/rpc-subscriptions-channel-pool-internal.ts
+function createChannelPool() {
+  return {
+    entries: [],
+    freeChannelIndex: -1
+  };
+}
+
+// src/rpc-subscriptions-channel-pool.ts
+function getChannelPoolingChannelCreator(createChannel, { maxSubscriptionsPerChannel, minChannels }) {
+  const pool = createChannelPool();
+  function recomputeFreeChannelIndex() {
+    if (pool.entries.length < minChannels) {
+      pool.freeChannelIndex = -1;
+      return;
+    }
+    let mostFreeChannel;
+    for (let ii = 0; ii < pool.entries.length; ii++) {
+      const nextPoolIndex = (pool.freeChannelIndex + ii + 2) % pool.entries.length;
+      const nextPoolEntry = (
+        // Start from the item two positions after the current item. This way, the
+        // search will finish on the item after the current one. This ensures that, if
+        // any channels tie for having the most capacity, the one that will be chosen is
+        // the one immediately to the current one's right (wrapping around).
+        pool.entries[nextPoolIndex]
+      );
+      if (nextPoolEntry.subscriptionCount < maxSubscriptionsPerChannel && (!mostFreeChannel || mostFreeChannel.subscriptionCount >= nextPoolEntry.subscriptionCount)) {
+        mostFreeChannel = {
+          poolIndex: nextPoolIndex,
+          subscriptionCount: nextPoolEntry.subscriptionCount
+        };
+      }
+    }
+    pool.freeChannelIndex = mostFreeChannel?.poolIndex ?? -1;
+  }
+  return function getExistingChannelWithMostCapacityOrCreateChannel({ abortSignal }) {
+    let poolEntry;
+    function destroyPoolEntry() {
+      const index = pool.entries.findIndex((entry) => entry === poolEntry);
+      pool.entries.splice(index, 1);
+      poolEntry.dispose();
+      recomputeFreeChannelIndex();
+    }
+    if (pool.freeChannelIndex === -1) {
+      const abortController = new AbortController();
+      const newChannelPromise = createChannel({ abortSignal: abortController.signal });
+      newChannelPromise.then((newChannel) => {
+        newChannel.on("error", destroyPoolEntry, { signal: abortController.signal });
+      }).catch(destroyPoolEntry);
+      poolEntry = {
+        channel: newChannelPromise,
+        dispose() {
+          abortController.abort();
+        },
+        subscriptionCount: 0
+      };
+      pool.entries.push(poolEntry);
+    } else {
+      poolEntry = pool.entries[pool.freeChannelIndex];
+    }
+    poolEntry.subscriptionCount++;
+    abortSignal.addEventListener("abort", function destroyConsumer() {
+      poolEntry.subscriptionCount--;
+      if (poolEntry.subscriptionCount === 0) {
+        destroyPoolEntry();
+      } else if (pool.freeChannelIndex !== -1) {
+        pool.freeChannelIndex--;
+        recomputeFreeChannelIndex();
+      }
+    });
+    recomputeFreeChannelIndex();
+    return poolEntry.channel;
+  };
+}
+
+// src/rpc-subscriptions-json.ts
+function getRpcSubscriptionsChannelWithJSONSerialization(channel) {
+  return Object.freeze({
+    ...channel,
+    on(type, listener, options) {
+      if (type !== "message") {
+        return channel.on(type, listener, options);
+      }
+      return channel.on(
+        "message",
+        function deserializingListener(message) {
+          const deserializedMessage = JSON.parse(message);
+          listener(deserializedMessage);
+        },
+        options
+      );
+    },
+    send(message) {
+      const serializedMessage = JSON.stringify(message);
+      return channel.send(serializedMessage);
+    }
+  });
+}
+
+// src/rpc-subscriptions-channel.ts
+function createDefaultRpcSubscriptionsChannelCreator(config) {
+  if (/^wss?:/i.test(config.url) === false) {
+    const protocolMatch = config.url.match(/^([^:]+):/);
+    throw new DOMException(
+      protocolMatch ? `Failed to construct 'WebSocket': The URL's scheme must be either 'ws' or 'wss'. '${protocolMatch[1]}:' is not allowed.` : `Failed to construct 'WebSocket': The URL '${config.url}' is invalid.`
+    );
+  }
+  const { intervalMs, ...rest } = config;
+  const createDefaultRpcSubscriptionsChannel = ({ abortSignal }) => {
+    return rpcSubscriptionsChannelWebsocket.createWebSocketChannel({
+      ...rest,
+      sendBufferHighWatermark: config.sendBufferHighWatermark ?? // Let 128KB of data into the WebSocket buffer before buffering it in the app.
+      131072,
+      signal: abortSignal
+    }).then(getRpcSubscriptionsChannelWithJSONSerialization).then(
+      (channel) => getRpcSubscriptionsChannelWithAutoping({
+        abortSignal,
+        channel,
+        intervalMs: intervalMs ?? 5e3
+      })
+    );
+  };
+  return getChannelPoolingChannelCreator(createDefaultRpcSubscriptionsChannel, {
+    maxSubscriptionsPerChannel: config.maxSubscriptionsPerChannel ?? // TODO: Determine this experimentally
+    1e3,
+    minChannels: config.minChannels ?? 1
+  });
+}
+
+// src/rpc-subscriptions-coalescer.ts
+function getRpcSubscriptionsTransportWithSubscriptionCoalescing(transport) {
+  const cache = /* @__PURE__ */ new Map();
+  return function rpcSubscriptionsTransportWithSubscriptionCoalescing(config) {
+    const { subscriptionConfigurationHash, signal } = config;
+    if (subscriptionConfigurationHash === void 0) {
+      return transport(config);
+    }
+    let cachedDataPublisherPromise = cache.get(subscriptionConfigurationHash);
+    if (!cachedDataPublisherPromise) {
+      const abortController = new AbortController();
+      const dataPublisherPromise = transport({
+        ...config,
+        signal: abortController.signal
+      });
+      dataPublisherPromise.then((dataPublisher) => {
+        dataPublisher.on(
+          "error",
+          () => {
+            cache.delete(subscriptionConfigurationHash);
+            abortController.abort();
+          },
+          { signal: abortController.signal }
+        );
+      });
+      cache.set(
+        subscriptionConfigurationHash,
+        cachedDataPublisherPromise = {
+          abortController,
+          dataPublisherPromise,
+          numSubscribers: 0
+        }
+      );
+    }
+    cachedDataPublisherPromise.numSubscribers++;
+    signal.addEventListener(
+      "abort",
+      () => {
+        cachedDataPublisherPromise.numSubscribers--;
+        if (cachedDataPublisherPromise.numSubscribers === 0) {
+          queueMicrotask(() => {
+            if (cachedDataPublisherPromise.numSubscribers === 0) {
+              cache.delete(subscriptionConfigurationHash);
+              cachedDataPublisherPromise.abortController.abort();
+            }
+          });
+        }
+      },
+      { signal: cachedDataPublisherPromise.abortController.signal }
+    );
+    return cachedDataPublisherPromise.dataPublisherPromise;
+  };
+}
+
+// src/rpc-subscriptions-transport.ts
+function createDefaultRpcSubscriptionsTransport({
+  createChannel
+}) {
+  return functional.pipe(
+    createRpcSubscriptionsTransportFromChannelCreator(
+      createChannel
+    ),
+    (transport) => getRpcSubscriptionsTransportWithSubscriptionCoalescing(transport)
+  );
+}
+function createRpcSubscriptionsTransportFromChannelCreator(createChannel) {
+  return async ({ executeSubscriptionPlan, signal }) => {
+    const channel = await createChannel({ abortSignal: signal });
+    return await executeSubscriptionPlan({ channel, signal });
+  };
+}
+
+// src/rpc-subscriptions.ts
+function createSolanaRpcSubscriptionsImpl(clusterUrl, config) {
+  const transport = createDefaultRpcSubscriptionsTransport({
+    createChannel: createDefaultRpcSubscriptionsChannelCreator({ ...config, url: clusterUrl })
+  });
+  return createSolanaRpcSubscriptionsFromTransport(transport);
+}
+function createSolanaRpcSubscriptions(clusterUrl, config) {
+  return createSolanaRpcSubscriptionsImpl(clusterUrl, config);
+}
+function createSolanaRpcSubscriptions_UNSTABLE(clusterUrl, config) {
+  return createSolanaRpcSubscriptionsImpl(
+    clusterUrl,
+    config
+  );
+}
+function createSolanaRpcSubscriptionsFromTransport(transport) {
+  return rpcSubscriptionsSpec.createSubscriptionRpc({
+    api: rpcSubscriptionsApi.createSolanaRpcSubscriptionsApi(DEFAULT_RPC_SUBSCRIPTIONS_CONFIG),
+    transport
+  });
+}
+
+exports.DEFAULT_RPC_SUBSCRIPTIONS_CONFIG = DEFAULT_RPC_SUBSCRIPTIONS_CONFIG;
+exports.createDefaultRpcSubscriptionsChannelCreator = createDefaultRpcSubscriptionsChannelCreator;
+exports.createDefaultRpcSubscriptionsTransport = createDefaultRpcSubscriptionsTransport;
+exports.createRpcSubscriptionsTransportFromChannelCreator = createRpcSubscriptionsTransportFromChannelCreator;
+exports.createSolanaRpcSubscriptions = createSolanaRpcSubscriptions;
+exports.createSolanaRpcSubscriptionsFromTransport = createSolanaRpcSubscriptionsFromTransport;
+exports.createSolanaRpcSubscriptions_UNSTABLE = createSolanaRpcSubscriptions_UNSTABLE;
+exports.getRpcSubscriptionsChannelWithJSONSerialization = getRpcSubscriptionsChannelWithJSONSerialization;
+Object.keys(rpcSubscriptionsApi).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return rpcSubscriptionsApi[k]; }
+  });
+});
+Object.keys(rpcSubscriptionsSpec).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return rpcSubscriptionsSpec[k]; }
+  });
+});
+//# sourceMappingURL=index.browser.cjs.map
+//# sourceMappingURL=index.browser.cjs.map

package/dist/index.browser.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/rpc-integer-overflow-error.ts","../src/rpc-default-config.ts","../src/rpc-subscriptions-autopinger.ts","../src/rpc-subscriptions-channel-pool-internal.ts","../src/rpc-subscriptions-channel-pool.ts","../src/rpc-subscriptions-json.ts","../src/rpc-subscriptions-channel.ts","../src/rpc-subscriptions-coalescer.ts","../src/rpc-subscriptions-transport.ts","../src/rpc-subscriptions.ts"],"names":["SolanaError","SOLANA_ERROR__RPC__INTEGER_OVERFLOW","safeCaptureStackTrace","createWebSocketChannel","pipe","createSubscriptionRpc","createSolanaRpcSubscriptionsApi"],"mappings":"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","file":"index.browser.cjs","sourcesContent":["import { safeCaptureStackTrace, SOLANA_ERROR__RPC__INTEGER_OVERFLOW, SolanaError } from '@solana/errors';\nimport type { KeyPath } from '@solana/rpc-transformers';\n\nexport function createSolanaJsonRpcIntegerOverflowError(\n    methodName: string,\n    keyPath: KeyPath,\n    value: bigint,\n): SolanaError<typeof SOLANA_ERROR__RPC__INTEGER_OVERFLOW> {\n    let argumentLabel = '';\n    if (typeof keyPath[0] === 'number') {\n        const argPosition = keyPath[0] + 1;\n        const lastDigit = argPosition % 10;\n        const lastTwoDigits = argPosition % 100;\n        if (lastDigit == 1 && lastTwoDigits != 11) {\n            argumentLabel = argPosition + 'st';\n        } else if (lastDigit == 2 && lastTwoDigits != 12) {\n            argumentLabel = argPosition + 'nd';\n        } else if (lastDigit == 3 && lastTwoDigits != 13) {\n            argumentLabel = argPosition + 'rd';\n        } else {\n            argumentLabel = argPosition + 'th';\n        }\n    } else {\n        argumentLabel = `\\`${keyPath[0].toString()}\\``;\n    }\n    const path =\n        keyPath.length > 1\n            ? keyPath\n                  .slice(1)\n                  .map(pathPart => (typeof pathPart === 'number' ? `[${pathPart}]` : pathPart))\n                  .join('.')\n            : undefined;\n    const error = new SolanaError(SOLANA_ERROR__RPC__INTEGER_OVERFLOW, {\n        argumentLabel,\n        keyPath: keyPath as readonly (number | string | symbol)[],\n        methodName,\n        optionalPathLabel: path ? ` at path \\`${path}\\`` : '',\n        value,\n        ...(path !== undefined ? { path } : undefined),\n    });\n    safeCaptureStackTrace(error, createSolanaJsonRpcIntegerOverflowError);\n    return error;\n}\n","import type { createSolanaRpcSubscriptionsApi } from '@solana/rpc-subscriptions-api';\n\nimport { createSolanaJsonRpcIntegerOverflowError } from './rpc-integer-overflow-error';\n\nexport const DEFAULT_RPC_SUBSCRIPTIONS_CONFIG: Partial<\n    NonNullable<Parameters<typeof createSolanaRpcSubscriptionsApi>[0]>\n> = {\n    defaultCommitment: 'confirmed',\n    onIntegerOverflow(request, keyPath, value) {\n        throw createSolanaJsonRpcIntegerOverflowError(request.methodName, keyPath, value);\n    },\n};\n","import type { RpcSubscriptionsChannel } from '@solana/rpc-subscriptions-spec';\n\ntype Config<TChannel extends RpcSubscriptionsChannel<unknown, unknown>> = Readonly<{\n    abortSignal: AbortSignal;\n    channel: TChannel;\n    intervalMs: number;\n}>;\n\nconst PING_PAYLOAD = {\n    jsonrpc: '2.0',\n    method: 'ping',\n} as const;\n\nexport function getRpcSubscriptionsChannelWithAutoping<TChannel extends RpcSubscriptionsChannel<object, unknown>>({\n    abortSignal: callerAbortSignal,\n    channel,\n    intervalMs,\n}: Config<TChannel>): TChannel {\n    let intervalId: ReturnType<typeof setInterval> | undefined;\n    function sendPing() {\n        channel.send(PING_PAYLOAD);\n    }\n    function restartPingTimer() {\n        clearInterval(intervalId);\n        intervalId = setInterval(sendPing, intervalMs);\n    }\n    const pingerAbortController = new AbortController();\n    pingerAbortController.signal.addEventListener('abort', () => {\n        clearInterval(intervalId);\n    });\n    callerAbortSignal.addEventListener('abort', () => {\n        pingerAbortController.abort();\n    });\n    channel.on(\n        'error',\n        () => {\n            pingerAbortController.abort();\n        },\n        { signal: pingerAbortController.signal },\n    );\n    channel.on('message', restartPingTimer, { signal: pingerAbortController.signal });\n    if (!__BROWSER__ || globalThis.navigator.onLine) {\n        restartPingTimer();\n    }\n    if (__BROWSER__) {\n        globalThis.window.addEventListener(\n            'offline',\n            function handleOffline() {\n                clearInterval(intervalId);\n            },\n            { signal: pingerAbortController.signal },\n        );\n        globalThis.window.addEventListener(\n            'online',\n            function handleOnline() {\n                sendPing();\n                restartPingTimer();\n            },\n            { signal: pingerAbortController.signal },\n        );\n    }\n    return {\n        ...channel,\n        send(...args) {\n            if (!pingerAbortController.signal.aborted) {\n                restartPingTimer();\n            }\n            return channel.send(...args);\n        },\n    };\n}\n","import { RpcSubscriptionsChannel } from '@solana/rpc-subscriptions-spec';\n\nexport type ChannelPoolEntry = {\n    channel: PromiseLike<RpcSubscriptionsChannel<unknown, unknown>> | RpcSubscriptionsChannel<unknown, unknown>;\n    readonly dispose: () => void;\n    subscriptionCount: number;\n};\n\ntype ChannelPool = { readonly entries: ChannelPoolEntry[]; freeChannelIndex: number };\n\nexport function createChannelPool(): ChannelPool {\n    return {\n        entries: [],\n        freeChannelIndex: -1,\n    };\n}\n","import { RpcSubscriptionsChannelCreator } from '@solana/rpc-subscriptions-spec';\n\nimport { ChannelPoolEntry, createChannelPool } from './rpc-subscriptions-channel-pool-internal';\n\ntype Config = Readonly<{\n    maxSubscriptionsPerChannel: number;\n    minChannels: number;\n}>;\n\nexport function getChannelPoolingChannelCreator<\n    TChannelCreator extends RpcSubscriptionsChannelCreator<unknown, unknown>,\n>(createChannel: TChannelCreator, { maxSubscriptionsPerChannel, minChannels }: Config): TChannelCreator {\n    const pool = createChannelPool();\n    /**\n     * This function advances the free channel index to the pool entry with the most capacity. It\n     * sets the index to `-1` if all channels are full.\n     */\n    function recomputeFreeChannelIndex() {\n        if (pool.entries.length < minChannels) {\n            // Don't set the free channel index until the pool fills up; we want to keep creating\n            // channels before we start rotating among them.\n            pool.freeChannelIndex = -1;\n            return;\n        }\n        let mostFreeChannel: Readonly<{ poolIndex: number; subscriptionCount: number }> | undefined;\n        for (let ii = 0; ii < pool.entries.length; ii++) {\n            const nextPoolIndex = (pool.freeChannelIndex + ii + 2) % pool.entries.length;\n            const nextPoolEntry =\n                // Start from the item two positions after the current item. This way, the\n                // search will finish on the item after the current one. This ensures that, if\n                // any channels tie for having the most capacity, the one that will be chosen is\n                // the one immediately to the current one's right (wrapping around).\n                pool.entries[nextPoolIndex];\n            if (\n                nextPoolEntry.subscriptionCount < maxSubscriptionsPerChannel &&\n                (!mostFreeChannel || mostFreeChannel.subscriptionCount >= nextPoolEntry.subscriptionCount)\n            ) {\n                mostFreeChannel = {\n                    poolIndex: nextPoolIndex,\n                    subscriptionCount: nextPoolEntry.subscriptionCount,\n                };\n            }\n        }\n        pool.freeChannelIndex = mostFreeChannel?.poolIndex ?? -1;\n    }\n    return function getExistingChannelWithMostCapacityOrCreateChannel({ abortSignal }) {\n        let poolEntry: ChannelPoolEntry;\n        function destroyPoolEntry() {\n            const index = pool.entries.findIndex(entry => entry === poolEntry);\n            pool.entries.splice(index, 1);\n            poolEntry.dispose();\n            recomputeFreeChannelIndex();\n        }\n        if (pool.freeChannelIndex === -1) {\n            const abortController = new AbortController();\n            const newChannelPromise = createChannel({ abortSignal: abortController.signal });\n            newChannelPromise\n                .then(newChannel => {\n                    newChannel.on('error', destroyPoolEntry, { signal: abortController.signal });\n                })\n                .catch(destroyPoolEntry);\n            poolEntry = {\n                channel: newChannelPromise,\n                dispose() {\n                    abortController.abort();\n                },\n                subscriptionCount: 0,\n            };\n            pool.entries.push(poolEntry);\n        } else {\n            poolEntry = pool.entries[pool.freeChannelIndex];\n        }\n        /**\n         * A note about subscription counts.\n         * Because of https://github.com/solana-labs/solana/pull/18943, two subscriptions for\n         * materially the same notification will be coalesced on the server. This means they will be\n         * assigned the same subscription id, and will occupy one subscription slot. We can't tell,\n         * from here, whether a subscription will be treated in this way or not, so we\n         * unconditionally increment the subscription count every time a subscription request is\n         * made. This may result in subscription channels being treated as out-of-capacity when in\n         * fact they are not.\n         */\n        poolEntry.subscriptionCount++;\n        abortSignal.addEventListener('abort', function destroyConsumer() {\n            poolEntry.subscriptionCount--;\n            if (poolEntry.subscriptionCount === 0) {\n                destroyPoolEntry();\n            } else if (pool.freeChannelIndex !== -1) {\n                // Back the free channel index up one position, and recompute it.\n                pool.freeChannelIndex--;\n                recomputeFreeChannelIndex();\n            }\n        });\n        recomputeFreeChannelIndex();\n        return poolEntry.channel;\n    } as TChannelCreator;\n}\n","import { RpcSubscriptionsChannel } from '@solana/rpc-subscriptions-spec';\n\nexport function getRpcSubscriptionsChannelWithJSONSerialization(\n    channel: RpcSubscriptionsChannel<string, string>,\n): RpcSubscriptionsChannel<unknown, unknown> {\n    return Object.freeze({\n        ...channel,\n        on(type, listener, options) {\n            if (type !== 'message') {\n                return channel.on(type, listener, options);\n            }\n            return channel.on(\n                'message',\n                function deserializingListener(message: string) {\n                    const deserializedMessage = JSON.parse(message);\n                    listener(deserializedMessage);\n                },\n                options,\n            );\n        },\n        send(message) {\n            const serializedMessage = JSON.stringify(message);\n            return channel.send(serializedMessage);\n        },\n    } as RpcSubscriptionsChannel<unknown, unknown>);\n}\n","import { createWebSocketChannel } from '@solana/rpc-subscriptions-channel-websocket';\nimport type { ClusterUrl } from '@solana/rpc-types';\n\nimport { getRpcSubscriptionsChannelWithAutoping } from './rpc-subscriptions-autopinger';\nimport { getChannelPoolingChannelCreator } from './rpc-subscriptions-channel-pool';\nimport { RpcSubscriptionsChannelCreatorFromClusterUrl } from './rpc-subscriptions-clusters';\nimport { getRpcSubscriptionsChannelWithJSONSerialization } from './rpc-subscriptions-json';\n\nexport type DefaultRpcSubscriptionsChannelConfig<TClusterUrl extends ClusterUrl> = Readonly<{\n    intervalMs?: number;\n    maxSubscriptionsPerChannel?: number;\n    minChannels?: number;\n    sendBufferHighWatermark?: number;\n    url: TClusterUrl;\n}>;\n\nexport function createDefaultRpcSubscriptionsChannelCreator<TClusterUrl extends ClusterUrl>(\n    config: DefaultRpcSubscriptionsChannelConfig<TClusterUrl>,\n): RpcSubscriptionsChannelCreatorFromClusterUrl<TClusterUrl, unknown, unknown> {\n    if (/^wss?:/i.test(config.url) === false) {\n        const protocolMatch = config.url.match(/^([^:]+):/);\n        throw new DOMException(\n            protocolMatch\n                ? \"Failed to construct 'WebSocket': The URL's scheme must be either 'ws' or \" +\n                  `'wss'. '${protocolMatch[1]}:' is not allowed.`\n                : `Failed to construct 'WebSocket': The URL '${config.url}' is invalid.`,\n        );\n    }\n    const { intervalMs, ...rest } = config;\n    const createDefaultRpcSubscriptionsChannel = (({ abortSignal }) => {\n        return createWebSocketChannel({\n            ...rest,\n            sendBufferHighWatermark:\n                config.sendBufferHighWatermark ??\n                // Let 128KB of data into the WebSocket buffer before buffering it in the app.\n                131_072,\n            signal: abortSignal,\n        })\n            .then(getRpcSubscriptionsChannelWithJSONSerialization)\n            .then(channel =>\n                getRpcSubscriptionsChannelWithAutoping({\n                    abortSignal,\n                    channel,\n                    intervalMs: intervalMs ?? 5_000,\n                }),\n            );\n    }) as RpcSubscriptionsChannelCreatorFromClusterUrl<TClusterUrl, unknown, unknown>;\n    return getChannelPoolingChannelCreator(createDefaultRpcSubscriptionsChannel, {\n        maxSubscriptionsPerChannel:\n            config.maxSubscriptionsPerChannel ??\n            // TODO: Determine this experimentally\n            1_000,\n        minChannels: config.minChannels ?? 1,\n    });\n}\n","import { RpcSubscriptionsTransport } from '@solana/rpc-subscriptions-spec';\nimport { DataPublisher } from '@solana/subscribable';\n\ntype CacheEntry = {\n    readonly abortController: AbortController;\n    readonly dataPublisherPromise: Promise<DataPublisher>;\n    numSubscribers: number;\n};\n\nexport function getRpcSubscriptionsTransportWithSubscriptionCoalescing<TTransport extends RpcSubscriptionsTransport>(\n    transport: TTransport,\n): TTransport {\n    const cache = new Map<string, CacheEntry>();\n    return function rpcSubscriptionsTransportWithSubscriptionCoalescing(config) {\n        const { subscriptionConfigurationHash, signal } = config;\n        if (subscriptionConfigurationHash === undefined) {\n            return transport(config);\n        }\n        let cachedDataPublisherPromise = cache.get(subscriptionConfigurationHash);\n        if (!cachedDataPublisherPromise) {\n            const abortController = new AbortController();\n            const dataPublisherPromise = transport({\n                ...config,\n                signal: abortController.signal,\n            });\n            dataPublisherPromise.then(dataPublisher => {\n                dataPublisher.on(\n                    'error',\n                    () => {\n                        cache.delete(subscriptionConfigurationHash);\n                        abortController.abort();\n                    },\n                    { signal: abortController.signal },\n                );\n            });\n            cache.set(\n                subscriptionConfigurationHash,\n                (cachedDataPublisherPromise = {\n                    abortController,\n                    dataPublisherPromise,\n                    numSubscribers: 0,\n                }),\n            );\n        }\n        cachedDataPublisherPromise.numSubscribers++;\n        signal.addEventListener(\n            'abort',\n            () => {\n                cachedDataPublisherPromise.numSubscribers--;\n                if (cachedDataPublisherPromise.numSubscribers === 0) {\n                    queueMicrotask(() => {\n                        if (cachedDataPublisherPromise.numSubscribers === 0) {\n                            cache.delete(subscriptionConfigurationHash);\n                            cachedDataPublisherPromise.abortController.abort();\n                        }\n                    });\n                }\n            },\n            { signal: cachedDataPublisherPromise.abortController.signal },\n        );\n        return cachedDataPublisherPromise.dataPublisherPromise;\n    } as TTransport;\n}\n","import { pipe } from '@solana/functional';\nimport { RpcSubscriptionsChannelCreator, RpcSubscriptionsTransport } from '@solana/rpc-subscriptions-spec';\nimport { ClusterUrl } from '@solana/rpc-types';\n\nimport {\n    RpcSubscriptionsChannelCreatorDevnet,\n    RpcSubscriptionsChannelCreatorFromClusterUrl,\n    RpcSubscriptionsChannelCreatorMainnet,\n    RpcSubscriptionsChannelCreatorTestnet,\n    RpcSubscriptionsTransportDevnet,\n    RpcSubscriptionsTransportFromClusterUrl,\n    RpcSubscriptionsTransportMainnet,\n    RpcSubscriptionsTransportTestnet,\n} from './rpc-subscriptions-clusters';\nimport { getRpcSubscriptionsTransportWithSubscriptionCoalescing } from './rpc-subscriptions-coalescer';\n\nexport type DefaultRpcSubscriptionsTransportConfig<TClusterUrl extends ClusterUrl> = Readonly<{\n    createChannel: RpcSubscriptionsChannelCreatorFromClusterUrl<TClusterUrl, unknown, unknown>;\n}>;\n\nexport function createDefaultRpcSubscriptionsTransport<TClusterUrl extends ClusterUrl>({\n    createChannel,\n}: DefaultRpcSubscriptionsTransportConfig<TClusterUrl>) {\n    return pipe(\n        createRpcSubscriptionsTransportFromChannelCreator(\n            createChannel,\n        ) as RpcSubscriptionsTransport as RpcSubscriptionsTransportFromClusterUrl<TClusterUrl>,\n        transport => getRpcSubscriptionsTransportWithSubscriptionCoalescing(transport),\n    );\n}\n\nexport function createRpcSubscriptionsTransportFromChannelCreator<\n    TChannelCreator extends RpcSubscriptionsChannelCreator<TOutboundMessage, TInboundMessage>,\n    TInboundMessage,\n    TOutboundMessage,\n>(createChannel: TChannelCreator) {\n    return (async ({ executeSubscriptionPlan, signal }) => {\n        const channel = await createChannel({ abortSignal: signal });\n        return await executeSubscriptionPlan({ channel, signal });\n    }) as TChannelCreator extends RpcSubscriptionsChannelCreatorDevnet<TOutboundMessage, TInboundMessage>\n        ? RpcSubscriptionsTransportDevnet\n        : TChannelCreator extends RpcSubscriptionsChannelCreatorTestnet<TOutboundMessage, TInboundMessage>\n          ? RpcSubscriptionsTransportTestnet\n          : TChannelCreator extends RpcSubscriptionsChannelCreatorMainnet<TOutboundMessage, TInboundMessage>\n            ? RpcSubscriptionsTransportMainnet\n            : RpcSubscriptionsTransport;\n}\n","import type { SolanaRpcSubscriptionsApi, SolanaRpcSubscriptionsApiUnstable } from '@solana/rpc-subscriptions-api';\nimport { createSolanaRpcSubscriptionsApi } from '@solana/rpc-subscriptions-api';\nimport {\n    createSubscriptionRpc,\n    RpcSubscriptionsApiMethods,\n    type RpcSubscriptionsTransport,\n} from '@solana/rpc-subscriptions-spec';\nimport { ClusterUrl } from '@solana/rpc-types';\n\nimport { DEFAULT_RPC_SUBSCRIPTIONS_CONFIG } from './rpc-default-config';\nimport {\n    createDefaultRpcSubscriptionsChannelCreator,\n    DefaultRpcSubscriptionsChannelConfig,\n} from './rpc-subscriptions-channel';\nimport type { RpcSubscriptionsFromTransport } from './rpc-subscriptions-clusters';\nimport {\n    createDefaultRpcSubscriptionsTransport,\n    DefaultRpcSubscriptionsTransportConfig,\n} from './rpc-subscriptions-transport';\n\ninterface DefaultRpcSubscriptionsConfig<TClusterUrl extends ClusterUrl>\n    extends DefaultRpcSubscriptionsTransportConfig<TClusterUrl>,\n        DefaultRpcSubscriptionsChannelConfig<TClusterUrl> {}\n\nfunction createSolanaRpcSubscriptionsImpl<TClusterUrl extends ClusterUrl, TApi extends RpcSubscriptionsApiMethods>(\n    clusterUrl: TClusterUrl,\n    config?: Omit<DefaultRpcSubscriptionsConfig<TClusterUrl>, 'url'>,\n) {\n    const transport = createDefaultRpcSubscriptionsTransport({\n        createChannel: createDefaultRpcSubscriptionsChannelCreator({ ...config, url: clusterUrl }),\n    });\n    return createSolanaRpcSubscriptionsFromTransport<typeof transport, TApi>(transport);\n}\n\nexport function createSolanaRpcSubscriptions<TClusterUrl extends ClusterUrl>(\n    clusterUrl: TClusterUrl,\n    config?: Omit<DefaultRpcSubscriptionsConfig<TClusterUrl>, 'url'>,\n) {\n    return createSolanaRpcSubscriptionsImpl<TClusterUrl, SolanaRpcSubscriptionsApi>(clusterUrl, config);\n}\n\nexport function createSolanaRpcSubscriptions_UNSTABLE<TClusterUrl extends ClusterUrl>(\n    clusterUrl: TClusterUrl,\n    config?: Omit<DefaultRpcSubscriptionsTransportConfig<TClusterUrl>, 'url'>,\n) {\n    return createSolanaRpcSubscriptionsImpl<TClusterUrl, SolanaRpcSubscriptionsApi & SolanaRpcSubscriptionsApiUnstable>(\n        clusterUrl,\n        config,\n    );\n}\n\nexport function createSolanaRpcSubscriptionsFromTransport<\n    TTransport extends RpcSubscriptionsTransport,\n    TApi extends RpcSubscriptionsApiMethods = SolanaRpcSubscriptionsApi,\n>(transport: TTransport) {\n    return createSubscriptionRpc({\n        api: createSolanaRpcSubscriptionsApi<TApi>(DEFAULT_RPC_SUBSCRIPTIONS_CONFIG),\n        transport,\n    }) as RpcSubscriptionsFromTransport<TApi, TTransport>;\n}\n"]}