@solana/web3.js 2.0.0-experimental.a3f93f3 → 2.0.0-experimental.ac2f09a

package/README.md

@@ -62,8 +62,9 @@ const devnetRpc = createSolanaRpc({ transport: devnetTransport });
 Now, you can use it to call methods on your RPC server. For instance, here is how you would fetch an account's balance.
 
 ```ts
-const balanceInLamports = await devnetRpc.getBalance('11111111111111111111111111111111' as Base58EncodedAddress);
-console.log('Balance of account 11111111111111111111111111111111 in Lamports', balanceInLamports);
+const systemProgramAddress = '11111111111111111111111111111111' as Base58EncodedAddress;
+const balanceInLamports = await devnetRpc.getBalance(systemProgramAddress).send();
+console.log('Balance of System Program account in Lamports', balanceInLamports);
 ```
 
 ### Transactions
@@ -90,7 +91,7 @@ function handleSubmit() {
         // Typescript will upcast `address` to `Base58EncodedAddress`.
         assertIsBase58EncodedAddress(address);
         // At this point, `address` is a `Base58EncodedAddress` that can be used with the RPC.
-        const balanceInLamports = await rpc.getBalance(address);
+        const balanceInLamports = await rpc.getBalance(address).send();
     } catch (e) {
         // `address` turned out not to be a base58-encoded address
     }

package/dist/index.browser.cjs

@@ -3,6 +3,11 @@
 var keys = require('@solana/keys');
 var rpcCore = require('@solana/rpc-core');
 var rpcTransport = require('@solana/rpc-transport');
+var fastStableStringify = require('fast-stable-stringify');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var fastStableStringify__default = /*#__PURE__*/_interopDefault(fastStableStringify);
 
 // src/index.ts
 
@@ -41,12 +46,76 @@ var DEFAULT_RPC_CONFIG = {
     throw new SolanaJsonRpcIntegerOverflowError(methodName, keyPath, value);
   }
 };
+
+// src/rpc.ts
 function createSolanaRpc(config) {
   return rpcTransport.createJsonRpc({
     ...config,
     api: rpcCore.createSolanaRpcApi(DEFAULT_RPC_CONFIG)
   });
 }
+
+// src/rpc-request-coalescer.ts
+function getRpcTransportWithRequestCoalescing(transport, getDeduplicationKey) {
+  let coalescedRequestsByDeduplicationKey;
+  return async function makeCoalescedHttpRequest(config) {
+    const { payload, signal } = config;
+    const deduplicationKey = getDeduplicationKey(payload);
+    if (deduplicationKey === void 0) {
+      return await transport(config);
+    }
+    if (!coalescedRequestsByDeduplicationKey) {
+      Promise.resolve().then(() => {
+        coalescedRequestsByDeduplicationKey = void 0;
+      });
+      coalescedRequestsByDeduplicationKey = {};
+    }
+    if (coalescedRequestsByDeduplicationKey[deduplicationKey] == null) {
+      const abortController = new AbortController();
+      coalescedRequestsByDeduplicationKey[deduplicationKey] = {
+        abortController,
+        numConsumers: 0,
+        responsePromise: transport({
+          ...config,
+          signal: abortController.signal
+        })
+      };
+    }
+    const coalescedRequest = coalescedRequestsByDeduplicationKey[deduplicationKey];
+    coalescedRequest.numConsumers++;
+    if (signal) {
+      const responsePromise = coalescedRequest.responsePromise;
+      return await new Promise((resolve, reject) => {
+        const handleAbort = (e) => {
+          signal.removeEventListener("abort", handleAbort);
+          coalescedRequest.numConsumers -= 1;
+          if (coalescedRequest.numConsumers === 0) {
+            const abortController = coalescedRequest.abortController;
+            abortController.abort();
+          }
+          const abortError = new DOMException(e.target.reason, "AbortError");
+          reject(abortError);
+        };
+        signal.addEventListener("abort", handleAbort);
+        responsePromise.then(resolve).finally(() => {
+          signal.removeEventListener("abort", handleAbort);
+        });
+      });
+    } else {
+      return await coalescedRequest.responsePromise;
+    }
+  };
+}
+function getSolanaRpcPayloadDeduplicationKey(payload) {
+  if (payload == null || typeof payload !== "object" || Array.isArray(payload)) {
+    return;
+  }
+  if ("jsonrpc" in payload && payload.jsonrpc === "2.0" && "method" in payload && "params" in payload) {
+    return fastStableStringify__default.default([payload.method, payload.params]);
+  }
+}
+
+// src/rpc-transport.ts
 function normalizeHeaders(headers) {
   const out = {};
   for (const headerName in headers) {
@@ -55,16 +124,19 @@ function normalizeHeaders(headers) {
   return out;
 }
 function createDefaultRpcTransport(config) {
-  return rpcTransport.createHttpTransport({
-    ...config,
-    headers: {
-      ...config.headers ? normalizeHeaders(config.headers) : void 0,
-      ...{
-        // Keep these headers lowercase so they will override any user-supplied headers above.
-        "solana-client": `js/${"2.0.0-development"}` ?? "UNKNOWN"
+  return getRpcTransportWithRequestCoalescing(
+    rpcTransport.createHttpTransport({
+      ...config,
+      headers: {
+        ...config.headers ? normalizeHeaders(config.headers) : void 0,
+        ...{
+          // Keep these headers lowercase so they will override any user-supplied headers above.
+          "solana-client": `js/${"2.0.0-development"}` ?? "UNKNOWN"
+        }
       }
-    }
-  });
+    }),
+    getSolanaRpcPayloadDeduplicationKey
+  );
 }
 
 exports.createDefaultRpcTransport = createDefaultRpcTransport;

package/dist/index.browser.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/rpc.ts","../src/rpc-integer-overflow-error.ts","../src/rpc-default-config.ts","../src/rpc-transport.ts"],"names":[],"mappings":";AAAA,cAAc;;;ACAd,SAA2B,0BAA0B;;;ACA9C,IAAM,oCAAN,cAAgD,MAAM;AAAA,EAIzD,YAAY,YAAoB,SAA8B,OAAe;AACzE,UAAM,eAAe,OAAO,QAAQ,CAAC,MAAM,WAAW,QAAQ,CAAC,IAAI,SAAS,QAAQ,CAAC,GAAG,EAAE,KAAK;AAC/F,QAAI,UAAU;AACd,UAAM,YAAY,cAAc;AAChC,UAAM,gBAAgB,cAAc;AACpC,QAAI,aAAa,KAAK,iBAAiB,IAAI;AACvC,gBAAU,cAAc;AAAA,IAC5B,WAAW,aAAa,KAAK,iBAAiB,IAAI;AAC9C,gBAAU,cAAc;AAAA,IAC5B,WAAW,aAAa,KAAK,iBAAiB,IAAI;AAC9C,gBAAU,cAAc;AAAA,IAC5B,OAAO;AACH,gBAAU,cAAc;AAAA,IAC5B;AACA,UAAM,OACF,QAAQ,SAAS,IACX,QACK,MAAM,CAAC,EACP,IAAI,cAAa,OAAO,aAAa,WAAW,IAAI,cAAc,QAAS,EAC3E,KAAK,GAAG,IACb;AACV;AAAA,MACI,OAAO,6BAA6B,0BAC7B,OAAO,cAAc,WAAW,YAAY;AAAA,IAGvD;AACA,SAAK,UAAU;AACf,SAAK,aAAa;AAClB,SAAK,QAAQ;AAAA,EACjB;AAAA,EACA,IAAI,OAAO;AACP,WAAO;AAAA,EACX;AACJ;;;ACnCO,IAAM,qBAAwE;AAAA,EACjF,kBAAkB,YAAY,SAAS,OAAO;AAC1C,UAAM,IAAI,kCAAkC,YAAY,SAAS,KAAK;AAAA,EAC1E;AACJ;;;AFJA,SAAS,qBAAqB;AAGvB,SAAS,gBAAgB,QAAiF;AAC7G,SAAO,cAAgC;AAAA,IACnC,GAAG;AAAA,IACH,KAAK,mBAAmB,kBAAkB;AAAA,EAC9C,CAAC;AACL;;;AGXA,SAAS,2BAA2B;AAMpC,SAAS,iBACL,SACiD;AACjD,QAAM,MAA8B,CAAC;AACrC,aAAW,cAAc,SAAS;AAC9B,QAAI,WAAW,YAAY,CAAC,IAAI,QAAQ,UAAU;AAAA,EACtD;AACA,SAAO;AACX;AAEO,SAAS,0BAA0B,QAAkE;AACxG,SAAO,oBAAoB;AAAA,IACvB,GAAG;AAAA,IACH,SAAS;AAAA,MACL,GAAI,OAAO,UAAU,iBAAiB,OAAO,OAAO,IAAI;AAAA,MACxD,GAAI;AAAA;AAAA,QAEA,iBAAiB,MAAM,yBAAiB;AAAA,MAC5C;AAAA,IACJ;AAAA,EACJ,CAAC;AACL","sourcesContent":["export * from '@solana/keys';\nexport * from './rpc';\nexport * from './rpc-transport';\n","import { SolanaRpcMethods, createSolanaRpcApi } from '@solana/rpc-core';\nimport { DEFAULT_RPC_CONFIG } from './rpc-default-config';\n\nimport { createJsonRpc } from '@solana/rpc-transport';\nimport type { Rpc } from '@solana/rpc-transport/dist/types/json-rpc-types';\n\nexport function createSolanaRpc(config: Omit<Parameters<typeof createJsonRpc>[0], 'api'>): Rpc<SolanaRpcMethods> {\n    return createJsonRpc<SolanaRpcMethods>({\n        ...config,\n        api: createSolanaRpcApi(DEFAULT_RPC_CONFIG),\n    });\n}\n","export class SolanaJsonRpcIntegerOverflowError extends Error {\n    readonly methodName: string;\n    readonly keyPath: (number | string)[];\n    readonly value: bigint;\n    constructor(methodName: string, keyPath: (number | string)[], value: bigint) {\n        const argPosition = (typeof keyPath[0] === 'number' ? keyPath[0] : parseInt(keyPath[0], 10)) + 1;\n        let ordinal = '';\n        const lastDigit = argPosition % 10;\n        const lastTwoDigits = argPosition % 100;\n        if (lastDigit == 1 && lastTwoDigits != 11) {\n            ordinal = argPosition + 'st';\n        } else if (lastDigit == 2 && lastTwoDigits != 12) {\n            ordinal = argPosition + 'nd';\n        } else if (lastDigit == 3 && lastTwoDigits != 13) {\n            ordinal = argPosition + 'rd';\n        } else {\n            ordinal = argPosition + 'th';\n        }\n        const path =\n            keyPath.length > 1\n                ? keyPath\n                      .slice(1)\n                      .map(pathPart => (typeof pathPart === 'number' ? `[${pathPart}]` : pathPart))\n                      .join('.')\n                : null;\n        super(\n            `The ${ordinal} argument to the \\`${methodName}\\` RPC method` +\n                `${path ? ` at path \\`${path}\\`` : ''} was \\`${value}\\`. This number is ` +\n                'unsafe for use with the Solana JSON-RPC because it exceeds ' +\n                '`Number.MAX_SAFE_INTEGER`.'\n        );\n        this.keyPath = keyPath;\n        this.methodName = methodName;\n        this.value = value;\n    }\n    get name() {\n        return 'SolanaJsonRpcIntegerOverflowError';\n    }\n}\n","import { createSolanaRpcApi } from '@solana/rpc-core';\nimport { SolanaJsonRpcIntegerOverflowError } from './rpc-integer-overflow-error';\n\nexport const DEFAULT_RPC_CONFIG: Partial<Parameters<typeof createSolanaRpcApi>[0]> = {\n    onIntegerOverflow(methodName, keyPath, value) {\n        throw new SolanaJsonRpcIntegerOverflowError(methodName, keyPath, value);\n    },\n};\n","import { createHttpTransport } from '@solana/rpc-transport';\nimport { IRpcTransport } from '@solana/rpc-transport/dist/types/transports/transport-types';\n\n/**\n * Lowercasing header names makes it easier to override user-supplied headers.\n */\nfunction normalizeHeaders<T extends Record<string, string>>(\n    headers: T\n): { [K in keyof T & string as Lowercase<K>]: T[K] } {\n    const out: Record<string, string> = {};\n    for (const headerName in headers) {\n        out[headerName.toLowerCase()] = headers[headerName];\n    }\n    return out as { [K in keyof T & string as Lowercase<K>]: T[K] };\n}\n\nexport function createDefaultRpcTransport(config: Parameters<typeof createHttpTransport>[0]): IRpcTransport {\n    return createHttpTransport({\n        ...config,\n        headers: {\n            ...(config.headers ? normalizeHeaders(config.headers) : undefined),\n            ...({\n                // Keep these headers lowercase so they will override any user-supplied headers above.\n                'solana-client': `js/${__VERSION__}` ?? 'UNKNOWN',\n            } as { [overrideHeader: string]: string }),\n        },\n    });\n}\n"]}
+{"version":3,"sources":["../src/index.ts","../src/rpc.ts","../src/rpc-integer-overflow-error.ts","../src/rpc-default-config.ts","../src/rpc-transport.ts","../src/rpc-request-coalescer.ts","../src/rpc-request-deduplication.ts"],"names":[],"mappings":"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","sourcesContent":["export * from '@solana/keys';\nexport * from './rpc';\nexport * from './rpc-transport';\n","import { createSolanaRpcApi, SolanaRpcMethods } from '@solana/rpc-core';\nimport { createJsonRpc } from '@solana/rpc-transport';\nimport type { Rpc } from '@solana/rpc-transport/dist/types/json-rpc-types';\n\nimport { DEFAULT_RPC_CONFIG } from './rpc-default-config';\n\nexport function createSolanaRpc(config: Omit<Parameters<typeof createJsonRpc>[0], 'api'>): Rpc<SolanaRpcMethods> {\n    return createJsonRpc<SolanaRpcMethods>({\n        ...config,\n        api: createSolanaRpcApi(DEFAULT_RPC_CONFIG),\n    });\n}\n","export class SolanaJsonRpcIntegerOverflowError extends Error {\n    readonly methodName: string;\n    readonly keyPath: (number | string)[];\n    readonly value: bigint;\n    constructor(methodName: string, keyPath: (number | string)[], value: bigint) {\n        const argPosition = (typeof keyPath[0] === 'number' ? keyPath[0] : parseInt(keyPath[0], 10)) + 1;\n        let ordinal = '';\n        const lastDigit = argPosition % 10;\n        const lastTwoDigits = argPosition % 100;\n        if (lastDigit == 1 && lastTwoDigits != 11) {\n            ordinal = argPosition + 'st';\n        } else if (lastDigit == 2 && lastTwoDigits != 12) {\n            ordinal = argPosition + 'nd';\n        } else if (lastDigit == 3 && lastTwoDigits != 13) {\n            ordinal = argPosition + 'rd';\n        } else {\n            ordinal = argPosition + 'th';\n        }\n        const path =\n            keyPath.length > 1\n                ? keyPath\n                      .slice(1)\n                      .map(pathPart => (typeof pathPart === 'number' ? `[${pathPart}]` : pathPart))\n                      .join('.')\n                : null;\n        super(\n            `The ${ordinal} argument to the \\`${methodName}\\` RPC method` +\n                `${path ? ` at path \\`${path}\\`` : ''} was \\`${value}\\`. This number is ` +\n                'unsafe for use with the Solana JSON-RPC because it exceeds ' +\n                '`Number.MAX_SAFE_INTEGER`.'\n        );\n        this.keyPath = keyPath;\n        this.methodName = methodName;\n        this.value = value;\n    }\n    get name() {\n        return 'SolanaJsonRpcIntegerOverflowError';\n    }\n}\n","import { createSolanaRpcApi } from '@solana/rpc-core';\n\nimport { SolanaJsonRpcIntegerOverflowError } from './rpc-integer-overflow-error';\n\nexport const DEFAULT_RPC_CONFIG: Partial<Parameters<typeof createSolanaRpcApi>[0]> = {\n    onIntegerOverflow(methodName, keyPath, value) {\n        throw new SolanaJsonRpcIntegerOverflowError(methodName, keyPath, value);\n    },\n};\n","import { createHttpTransport } from '@solana/rpc-transport';\nimport { IRpcTransport } from '@solana/rpc-transport/dist/types/transports/transport-types';\n\nimport { getRpcTransportWithRequestCoalescing } from './rpc-request-coalescer';\nimport { getSolanaRpcPayloadDeduplicationKey } from './rpc-request-deduplication';\n\n/**\n * Lowercasing header names makes it easier to override user-supplied headers.\n */\nfunction normalizeHeaders<T extends Record<string, string>>(\n    headers: T\n): { [K in keyof T & string as Lowercase<K>]: T[K] } {\n    const out: Record<string, string> = {};\n    for (const headerName in headers) {\n        out[headerName.toLowerCase()] = headers[headerName];\n    }\n    return out as { [K in keyof T & string as Lowercase<K>]: T[K] };\n}\n\nexport function createDefaultRpcTransport(config: Parameters<typeof createHttpTransport>[0]): IRpcTransport {\n    return getRpcTransportWithRequestCoalescing(\n        createHttpTransport({\n            ...config,\n            headers: {\n                ...(config.headers ? normalizeHeaders(config.headers) : undefined),\n                ...({\n                    // Keep these headers lowercase so they will override any user-supplied headers above.\n                    'solana-client': `js/${__VERSION__}` ?? 'UNKNOWN',\n                } as { [overrideHeader: string]: string }),\n            },\n        }),\n        getSolanaRpcPayloadDeduplicationKey\n    );\n}\n","import { IRpcTransport } from '@solana/rpc-transport/dist/types/transports/transport-types';\n\ntype CoalescedRequest = {\n    readonly abortController: AbortController;\n    numConsumers: number;\n    readonly responsePromise: Promise<unknown>;\n};\n\ntype GetDeduplicationKeyFn = (payload: unknown) => string | undefined;\n\nexport function getRpcTransportWithRequestCoalescing(\n    transport: IRpcTransport,\n    getDeduplicationKey: GetDeduplicationKeyFn\n): IRpcTransport {\n    let coalescedRequestsByDeduplicationKey: Record<string, CoalescedRequest> | undefined;\n    return async function makeCoalescedHttpRequest<TResponse>(\n        config: Parameters<IRpcTransport>[0]\n    ): Promise<TResponse> {\n        const { payload, signal } = config;\n        const deduplicationKey = getDeduplicationKey(payload);\n        if (deduplicationKey === undefined) {\n            return await transport(config);\n        }\n        if (!coalescedRequestsByDeduplicationKey) {\n            Promise.resolve().then(() => {\n                coalescedRequestsByDeduplicationKey = undefined;\n            });\n            coalescedRequestsByDeduplicationKey = {};\n        }\n        if (coalescedRequestsByDeduplicationKey[deduplicationKey] == null) {\n            const abortController = new AbortController();\n            coalescedRequestsByDeduplicationKey[deduplicationKey] = {\n                abortController,\n                numConsumers: 0,\n                responsePromise: transport<TResponse>({\n                    ...config,\n                    signal: abortController.signal,\n                }),\n            };\n        }\n        const coalescedRequest = coalescedRequestsByDeduplicationKey[deduplicationKey];\n        coalescedRequest.numConsumers++;\n        if (signal) {\n            const responsePromise = coalescedRequest.responsePromise as Promise<TResponse>;\n            return await new Promise<TResponse>((resolve, reject) => {\n                const handleAbort = (e: AbortSignalEventMap['abort']) => {\n                    signal.removeEventListener('abort', handleAbort);\n                    coalescedRequest.numConsumers -= 1;\n                    if (coalescedRequest.numConsumers === 0) {\n                        const abortController = coalescedRequest.abortController;\n                        abortController.abort();\n                    }\n                    const abortError = new DOMException((e.target as AbortSignal).reason, 'AbortError');\n                    reject(abortError);\n                };\n                signal.addEventListener('abort', handleAbort);\n                responsePromise.then(resolve).finally(() => {\n                    signal.removeEventListener('abort', handleAbort);\n                });\n            });\n        } else {\n            return (await coalescedRequest.responsePromise) as TResponse;\n        }\n    };\n}\n","// eslint-disable-next-line @typescript-eslint/ban-ts-comment\n// @ts-ignore\nimport fastStableStringify from 'fast-stable-stringify';\n\nexport function getSolanaRpcPayloadDeduplicationKey(payload: unknown): string | undefined {\n    if (payload == null || typeof payload !== 'object' || Array.isArray(payload)) {\n        return;\n    }\n    if ('jsonrpc' in payload && payload.jsonrpc === '2.0' && 'method' in payload && 'params' in payload) {\n        return fastStableStringify([payload.method, payload.params]);\n    }\n}\n"]}

package/dist/index.browser.js

@@ -1,6 +1,7 @@
 export * from '@solana/keys';
 import { createSolanaRpcApi } from '@solana/rpc-core';
 import { createJsonRpc, createHttpTransport } from '@solana/rpc-transport';
+import fastStableStringify from 'fast-stable-stringify';
 
 // src/index.ts
 
@@ -39,12 +40,76 @@ var DEFAULT_RPC_CONFIG = {
     throw new SolanaJsonRpcIntegerOverflowError(methodName, keyPath, value);
   }
 };
+
+// src/rpc.ts
 function createSolanaRpc(config) {
   return createJsonRpc({
     ...config,
     api: createSolanaRpcApi(DEFAULT_RPC_CONFIG)
   });
 }
+
+// src/rpc-request-coalescer.ts
+function getRpcTransportWithRequestCoalescing(transport, getDeduplicationKey) {
+  let coalescedRequestsByDeduplicationKey;
+  return async function makeCoalescedHttpRequest(config) {
+    const { payload, signal } = config;
+    const deduplicationKey = getDeduplicationKey(payload);
+    if (deduplicationKey === void 0) {
+      return await transport(config);
+    }
+    if (!coalescedRequestsByDeduplicationKey) {
+      Promise.resolve().then(() => {
+        coalescedRequestsByDeduplicationKey = void 0;
+      });
+      coalescedRequestsByDeduplicationKey = {};
+    }
+    if (coalescedRequestsByDeduplicationKey[deduplicationKey] == null) {
+      const abortController = new AbortController();
+      coalescedRequestsByDeduplicationKey[deduplicationKey] = {
+        abortController,
+        numConsumers: 0,
+        responsePromise: transport({
+          ...config,
+          signal: abortController.signal
+        })
+      };
+    }
+    const coalescedRequest = coalescedRequestsByDeduplicationKey[deduplicationKey];
+    coalescedRequest.numConsumers++;
+    if (signal) {
+      const responsePromise = coalescedRequest.responsePromise;
+      return await new Promise((resolve, reject) => {
+        const handleAbort = (e) => {
+          signal.removeEventListener("abort", handleAbort);
+          coalescedRequest.numConsumers -= 1;
+          if (coalescedRequest.numConsumers === 0) {
+            const abortController = coalescedRequest.abortController;
+            abortController.abort();
+          }
+          const abortError = new DOMException(e.target.reason, "AbortError");
+          reject(abortError);
+        };
+        signal.addEventListener("abort", handleAbort);
+        responsePromise.then(resolve).finally(() => {
+          signal.removeEventListener("abort", handleAbort);
+        });
+      });
+    } else {
+      return await coalescedRequest.responsePromise;
+    }
+  };
+}
+function getSolanaRpcPayloadDeduplicationKey(payload) {
+  if (payload == null || typeof payload !== "object" || Array.isArray(payload)) {
+    return;
+  }
+  if ("jsonrpc" in payload && payload.jsonrpc === "2.0" && "method" in payload && "params" in payload) {
+    return fastStableStringify([payload.method, payload.params]);
+  }
+}
+
+// src/rpc-transport.ts
 function normalizeHeaders(headers) {
   const out = {};
   for (const headerName in headers) {
@@ -53,18 +118,19 @@ function normalizeHeaders(headers) {
   return out;
 }
 function createDefaultRpcTransport(config) {
-  return createHttpTransport({
-    ...config,
-    headers: {
-      ...config.headers ? normalizeHeaders(config.headers) : void 0,
-      ...{
-        // Keep these headers lowercase so they will override any user-supplied headers above.
-        "solana-client": `js/${"2.0.0-development"}` ?? "UNKNOWN"
+  return getRpcTransportWithRequestCoalescing(
+    createHttpTransport({
+      ...config,
+      headers: {
+        ...config.headers ? normalizeHeaders(config.headers) : void 0,
+        ...{
+          // Keep these headers lowercase so they will override any user-supplied headers above.
+          "solana-client": `js/${"2.0.0-development"}` ?? "UNKNOWN"
+        }
       }
-    }
-  });
+    }),
+    getSolanaRpcPayloadDeduplicationKey
+  );
 }
 
 export { createDefaultRpcTransport, createSolanaRpc };
-//# sourceMappingURL=out.js.map
-//# sourceMappingURL=index.browser.js.map

package/dist/index.browser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/rpc.ts","../src/rpc-integer-overflow-error.ts","../src/rpc-default-config.ts","../src/rpc-transport.ts"],"names":[],"mappings":";AAAA,cAAc;;;ACAd,SAA2B,0BAA0B;;;ACA9C,IAAM,oCAAN,cAAgD,MAAM;AAAA,EAIzD,YAAY,YAAoB,SAA8B,OAAe;AACzE,UAAM,eAAe,OAAO,QAAQ,CAAC,MAAM,WAAW,QAAQ,CAAC,IAAI,SAAS,QAAQ,CAAC,GAAG,EAAE,KAAK;AAC/F,QAAI,UAAU;AACd,UAAM,YAAY,cAAc;AAChC,UAAM,gBAAgB,cAAc;AACpC,QAAI,aAAa,KAAK,iBAAiB,IAAI;AACvC,gBAAU,cAAc;AAAA,IAC5B,WAAW,aAAa,KAAK,iBAAiB,IAAI;AAC9C,gBAAU,cAAc;AAAA,IAC5B,WAAW,aAAa,KAAK,iBAAiB,IAAI;AAC9C,gBAAU,cAAc;AAAA,IAC5B,OAAO;AACH,gBAAU,cAAc;AAAA,IAC5B;AACA,UAAM,OACF,QAAQ,SAAS,IACX,QACK,MAAM,CAAC,EACP,IAAI,cAAa,OAAO,aAAa,WAAW,IAAI,cAAc,QAAS,EAC3E,KAAK,GAAG,IACb;AACV;AAAA,MACI,OAAO,6BAA6B,0BAC7B,OAAO,cAAc,WAAW,YAAY;AAAA,IAGvD;AACA,SAAK,UAAU;AACf,SAAK,aAAa;AAClB,SAAK,QAAQ;AAAA,EACjB;AAAA,EACA,IAAI,OAAO;AACP,WAAO;AAAA,EACX;AACJ;;;ACnCO,IAAM,qBAAwE;AAAA,EACjF,kBAAkB,YAAY,SAAS,OAAO;AAC1C,UAAM,IAAI,kCAAkC,YAAY,SAAS,KAAK;AAAA,EAC1E;AACJ;;;AFJA,SAAS,qBAAqB;AAGvB,SAAS,gBAAgB,QAAiF;AAC7G,SAAO,cAAgC;AAAA,IACnC,GAAG;AAAA,IACH,KAAK,mBAAmB,kBAAkB;AAAA,EAC9C,CAAC;AACL;;;AGXA,SAAS,2BAA2B;AAMpC,SAAS,iBACL,SACiD;AACjD,QAAM,MAA8B,CAAC;AACrC,aAAW,cAAc,SAAS;AAC9B,QAAI,WAAW,YAAY,CAAC,IAAI,QAAQ,UAAU;AAAA,EACtD;AACA,SAAO;AACX;AAEO,SAAS,0BAA0B,QAAkE;AACxG,SAAO,oBAAoB;AAAA,IACvB,GAAG;AAAA,IACH,SAAS;AAAA,MACL,GAAI,OAAO,UAAU,iBAAiB,OAAO,OAAO,IAAI;AAAA,MACxD,GAAI;AAAA;AAAA,QAEA,iBAAiB,MAAM,yBAAiB;AAAA,MAC5C;AAAA,IACJ;AAAA,EACJ,CAAC;AACL","sourcesContent":["export * from '@solana/keys';\nexport * from './rpc';\nexport * from './rpc-transport';\n","import { SolanaRpcMethods, createSolanaRpcApi } from '@solana/rpc-core';\nimport { DEFAULT_RPC_CONFIG } from './rpc-default-config';\n\nimport { createJsonRpc } from '@solana/rpc-transport';\nimport type { Rpc } from '@solana/rpc-transport/dist/types/json-rpc-types';\n\nexport function createSolanaRpc(config: Omit<Parameters<typeof createJsonRpc>[0], 'api'>): Rpc<SolanaRpcMethods> {\n    return createJsonRpc<SolanaRpcMethods>({\n        ...config,\n        api: createSolanaRpcApi(DEFAULT_RPC_CONFIG),\n    });\n}\n","export class SolanaJsonRpcIntegerOverflowError extends Error {\n    readonly methodName: string;\n    readonly keyPath: (number | string)[];\n    readonly value: bigint;\n    constructor(methodName: string, keyPath: (number | string)[], value: bigint) {\n        const argPosition = (typeof keyPath[0] === 'number' ? keyPath[0] : parseInt(keyPath[0], 10)) + 1;\n        let ordinal = '';\n        const lastDigit = argPosition % 10;\n        const lastTwoDigits = argPosition % 100;\n        if (lastDigit == 1 && lastTwoDigits != 11) {\n            ordinal = argPosition + 'st';\n        } else if (lastDigit == 2 && lastTwoDigits != 12) {\n            ordinal = argPosition + 'nd';\n        } else if (lastDigit == 3 && lastTwoDigits != 13) {\n            ordinal = argPosition + 'rd';\n        } else {\n            ordinal = argPosition + 'th';\n        }\n        const path =\n            keyPath.length > 1\n                ? keyPath\n                      .slice(1)\n                      .map(pathPart => (typeof pathPart === 'number' ? `[${pathPart}]` : pathPart))\n                      .join('.')\n                : null;\n        super(\n            `The ${ordinal} argument to the \\`${methodName}\\` RPC method` +\n                `${path ? ` at path \\`${path}\\`` : ''} was \\`${value}\\`. This number is ` +\n                'unsafe for use with the Solana JSON-RPC because it exceeds ' +\n                '`Number.MAX_SAFE_INTEGER`.'\n        );\n        this.keyPath = keyPath;\n        this.methodName = methodName;\n        this.value = value;\n    }\n    get name() {\n        return 'SolanaJsonRpcIntegerOverflowError';\n    }\n}\n","import { createSolanaRpcApi } from '@solana/rpc-core';\nimport { SolanaJsonRpcIntegerOverflowError } from './rpc-integer-overflow-error';\n\nexport const DEFAULT_RPC_CONFIG: Partial<Parameters<typeof createSolanaRpcApi>[0]> = {\n    onIntegerOverflow(methodName, keyPath, value) {\n        throw new SolanaJsonRpcIntegerOverflowError(methodName, keyPath, value);\n    },\n};\n","import { createHttpTransport } from '@solana/rpc-transport';\nimport { IRpcTransport } from '@solana/rpc-transport/dist/types/transports/transport-types';\n\n/**\n * Lowercasing header names makes it easier to override user-supplied headers.\n */\nfunction normalizeHeaders<T extends Record<string, string>>(\n    headers: T\n): { [K in keyof T & string as Lowercase<K>]: T[K] } {\n    const out: Record<string, string> = {};\n    for (const headerName in headers) {\n        out[headerName.toLowerCase()] = headers[headerName];\n    }\n    return out as { [K in keyof T & string as Lowercase<K>]: T[K] };\n}\n\nexport function createDefaultRpcTransport(config: Parameters<typeof createHttpTransport>[0]): IRpcTransport {\n    return createHttpTransport({\n        ...config,\n        headers: {\n            ...(config.headers ? normalizeHeaders(config.headers) : undefined),\n            ...({\n                // Keep these headers lowercase so they will override any user-supplied headers above.\n                'solana-client': `js/${__VERSION__}` ?? 'UNKNOWN',\n            } as { [overrideHeader: string]: string }),\n        },\n    });\n}\n"]}
+{"version":3,"sources":["../src/index.ts","../src/rpc.ts","../src/rpc-integer-overflow-error.ts","../src/rpc-default-config.ts","../src/rpc-transport.ts","../src/rpc-request-coalescer.ts","../src/rpc-request-deduplication.ts"],"names":[],"mappings":"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","sourcesContent":["export * from '@solana/keys';\nexport * from './rpc';\nexport * from './rpc-transport';\n","import { createSolanaRpcApi, SolanaRpcMethods } from '@solana/rpc-core';\nimport { createJsonRpc } from '@solana/rpc-transport';\nimport type { Rpc } from '@solana/rpc-transport/dist/types/json-rpc-types';\n\nimport { DEFAULT_RPC_CONFIG } from './rpc-default-config';\n\nexport function createSolanaRpc(config: Omit<Parameters<typeof createJsonRpc>[0], 'api'>): Rpc<SolanaRpcMethods> {\n    return createJsonRpc<SolanaRpcMethods>({\n        ...config,\n        api: createSolanaRpcApi(DEFAULT_RPC_CONFIG),\n    });\n}\n","export class SolanaJsonRpcIntegerOverflowError extends Error {\n    readonly methodName: string;\n    readonly keyPath: (number | string)[];\n    readonly value: bigint;\n    constructor(methodName: string, keyPath: (number | string)[], value: bigint) {\n        const argPosition = (typeof keyPath[0] === 'number' ? keyPath[0] : parseInt(keyPath[0], 10)) + 1;\n        let ordinal = '';\n        const lastDigit = argPosition % 10;\n        const lastTwoDigits = argPosition % 100;\n        if (lastDigit == 1 && lastTwoDigits != 11) {\n            ordinal = argPosition + 'st';\n        } else if (lastDigit == 2 && lastTwoDigits != 12) {\n            ordinal = argPosition + 'nd';\n        } else if (lastDigit == 3 && lastTwoDigits != 13) {\n            ordinal = argPosition + 'rd';\n        } else {\n            ordinal = argPosition + 'th';\n        }\n        const path =\n            keyPath.length > 1\n                ? keyPath\n                      .slice(1)\n                      .map(pathPart => (typeof pathPart === 'number' ? `[${pathPart}]` : pathPart))\n                      .join('.')\n                : null;\n        super(\n            `The ${ordinal} argument to the \\`${methodName}\\` RPC method` +\n                `${path ? ` at path \\`${path}\\`` : ''} was \\`${value}\\`. This number is ` +\n                'unsafe for use with the Solana JSON-RPC because it exceeds ' +\n                '`Number.MAX_SAFE_INTEGER`.'\n        );\n        this.keyPath = keyPath;\n        this.methodName = methodName;\n        this.value = value;\n    }\n    get name() {\n        return 'SolanaJsonRpcIntegerOverflowError';\n    }\n}\n","import { createSolanaRpcApi } from '@solana/rpc-core';\n\nimport { SolanaJsonRpcIntegerOverflowError } from './rpc-integer-overflow-error';\n\nexport const DEFAULT_RPC_CONFIG: Partial<Parameters<typeof createSolanaRpcApi>[0]> = {\n    onIntegerOverflow(methodName, keyPath, value) {\n        throw new SolanaJsonRpcIntegerOverflowError(methodName, keyPath, value);\n    },\n};\n","import { createHttpTransport } from '@solana/rpc-transport';\nimport { IRpcTransport } from '@solana/rpc-transport/dist/types/transports/transport-types';\n\nimport { getRpcTransportWithRequestCoalescing } from './rpc-request-coalescer';\nimport { getSolanaRpcPayloadDeduplicationKey } from './rpc-request-deduplication';\n\n/**\n * Lowercasing header names makes it easier to override user-supplied headers.\n */\nfunction normalizeHeaders<T extends Record<string, string>>(\n    headers: T\n): { [K in keyof T & string as Lowercase<K>]: T[K] } {\n    const out: Record<string, string> = {};\n    for (const headerName in headers) {\n        out[headerName.toLowerCase()] = headers[headerName];\n    }\n    return out as { [K in keyof T & string as Lowercase<K>]: T[K] };\n}\n\nexport function createDefaultRpcTransport(config: Parameters<typeof createHttpTransport>[0]): IRpcTransport {\n    return getRpcTransportWithRequestCoalescing(\n        createHttpTransport({\n            ...config,\n            headers: {\n                ...(config.headers ? normalizeHeaders(config.headers) : undefined),\n                ...({\n                    // Keep these headers lowercase so they will override any user-supplied headers above.\n                    'solana-client': `js/${__VERSION__}` ?? 'UNKNOWN',\n                } as { [overrideHeader: string]: string }),\n            },\n        }),\n        getSolanaRpcPayloadDeduplicationKey\n    );\n}\n","import { IRpcTransport } from '@solana/rpc-transport/dist/types/transports/transport-types';\n\ntype CoalescedRequest = {\n    readonly abortController: AbortController;\n    numConsumers: number;\n    readonly responsePromise: Promise<unknown>;\n};\n\ntype GetDeduplicationKeyFn = (payload: unknown) => string | undefined;\n\nexport function getRpcTransportWithRequestCoalescing(\n    transport: IRpcTransport,\n    getDeduplicationKey: GetDeduplicationKeyFn\n): IRpcTransport {\n    let coalescedRequestsByDeduplicationKey: Record<string, CoalescedRequest> | undefined;\n    return async function makeCoalescedHttpRequest<TResponse>(\n        config: Parameters<IRpcTransport>[0]\n    ): Promise<TResponse> {\n        const { payload, signal } = config;\n        const deduplicationKey = getDeduplicationKey(payload);\n        if (deduplicationKey === undefined) {\n            return await transport(config);\n        }\n        if (!coalescedRequestsByDeduplicationKey) {\n            Promise.resolve().then(() => {\n                coalescedRequestsByDeduplicationKey = undefined;\n            });\n            coalescedRequestsByDeduplicationKey = {};\n        }\n        if (coalescedRequestsByDeduplicationKey[deduplicationKey] == null) {\n            const abortController = new AbortController();\n            coalescedRequestsByDeduplicationKey[deduplicationKey] = {\n                abortController,\n                numConsumers: 0,\n                responsePromise: transport<TResponse>({\n                    ...config,\n                    signal: abortController.signal,\n                }),\n            };\n        }\n        const coalescedRequest = coalescedRequestsByDeduplicationKey[deduplicationKey];\n        coalescedRequest.numConsumers++;\n        if (signal) {\n            const responsePromise = coalescedRequest.responsePromise as Promise<TResponse>;\n            return await new Promise<TResponse>((resolve, reject) => {\n                const handleAbort = (e: AbortSignalEventMap['abort']) => {\n                    signal.removeEventListener('abort', handleAbort);\n                    coalescedRequest.numConsumers -= 1;\n                    if (coalescedRequest.numConsumers === 0) {\n                        const abortController = coalescedRequest.abortController;\n                        abortController.abort();\n                    }\n                    const abortError = new DOMException((e.target as AbortSignal).reason, 'AbortError');\n                    reject(abortError);\n                };\n                signal.addEventListener('abort', handleAbort);\n                responsePromise.then(resolve).finally(() => {\n                    signal.removeEventListener('abort', handleAbort);\n                });\n            });\n        } else {\n            return (await coalescedRequest.responsePromise) as TResponse;\n        }\n    };\n}\n","// eslint-disable-next-line @typescript-eslint/ban-ts-comment\n// @ts-ignore\nimport fastStableStringify from 'fast-stable-stringify';\n\nexport function getSolanaRpcPayloadDeduplicationKey(payload: unknown): string | undefined {\n    if (payload == null || typeof payload !== 'object' || Array.isArray(payload)) {\n        return;\n    }\n    if ('jsonrpc' in payload && payload.jsonrpc === '2.0' && 'method' in payload && 'params' in payload) {\n        return fastStableStringify([payload.method, payload.params]);\n    }\n}\n"]}

package/dist/index.development.js

@@ -178,6 +178,83 @@ this.globalThis.solanaWeb3 = (function (exports) {
     }
   });
 
+  // ../../node_modules/.pnpm/fast-stable-stringify@1.0.0/node_modules/fast-stable-stringify/index.js
+  var require_fast_stable_stringify = __commonJS({
+    "../../node_modules/.pnpm/fast-stable-stringify@1.0.0/node_modules/fast-stable-stringify/index.js"(exports, module) {
+      init_env_shim();
+      var objToString = Object.prototype.toString;
+      var objKeys = Object.keys || function(obj) {
+        var keys = [];
+        for (var name in obj) {
+          keys.push(name);
+        }
+        return keys;
+      };
+      function stringify(val, isArrayProp) {
+        var i, max, str, keys, key, propVal, toStr;
+        if (val === true) {
+          return "true";
+        }
+        if (val === false) {
+          return "false";
+        }
+        switch (typeof val) {
+          case "object":
+            if (val === null) {
+              return null;
+            } else if (val.toJSON && typeof val.toJSON === "function") {
+              return stringify(val.toJSON(), isArrayProp);
+            } else {
+              toStr = objToString.call(val);
+              if (toStr === "[object Array]") {
+                str = "[";
+                max = val.length - 1;
+                for (i = 0; i < max; i++) {
+                  str += stringify(val[i], true) + ",";
+                }
+                if (max > -1) {
+                  str += stringify(val[i], true);
+                }
+                return str + "]";
+              } else if (toStr === "[object Object]") {
+                keys = objKeys(val).sort();
+                max = keys.length;
+                str = "";
+                i = 0;
+                while (i < max) {
+                  key = keys[i];
+                  propVal = stringify(val[key], false);
+                  if (propVal !== void 0) {
+                    if (str) {
+                      str += ",";
+                    }
+                    str += JSON.stringify(key) + ":" + propVal;
+                  }
+                  i++;
+                }
+                return "{" + str + "}";
+              } else {
+                return JSON.stringify(val);
+              }
+            }
+          case "function":
+          case "undefined":
+            return isArrayProp ? null : void 0;
+          case "string":
+            return JSON.stringify(val);
+          default:
+            return isFinite(val) ? val : null;
+        }
+      }
+      module.exports = function(val) {
+        var returnVal = stringify(val, false);
+        if (returnVal !== void 0) {
+          return "" + returnVal;
+        }
+      };
+    }
+  });
+
   // src/index.ts
   init_env_shim();
 
@@ -210,6 +287,7 @@ this.globalThis.solanaWeb3 = (function (exports) {
 
   // ../rpc-core/dist/index.browser.js
   init_env_shim();
+  __toESM(require_bs58(), 1);
   function visitNode(value, keyPath, onIntegerOverflow) {
     if (Array.isArray(value)) {
       return value.map(
@@ -237,7 +315,30 @@ this.globalThis.solanaWeb3 = (function (exports) {
   }
   var KEYPATH_WILDCARD = {};
   var ALLOWED_NUMERIC_KEYPATHS = {
-    getInflationReward: [[KEYPATH_WILDCARD, "commission"]]
+    getBlockTime: [[]],
+    getInflationReward: [[KEYPATH_WILDCARD, "commission"]],
+    getRecentPerformanceSamples: [[KEYPATH_WILDCARD, "samplePeriodSecs"]],
+    getTransaction: [
+      ["meta", "preTokenBalances", KEYPATH_WILDCARD, "accountIndex"],
+      ["meta", "preTokenBalances", KEYPATH_WILDCARD, "uiTokenAmount", "decimals"],
+      ["meta", "postTokenBalances", KEYPATH_WILDCARD, "accountIndex"],
+      ["meta", "postTokenBalances", KEYPATH_WILDCARD, "uiTokenAmount", "decimals"],
+      ["meta", "rewards", KEYPATH_WILDCARD, "commission"],
+      ["meta", "innerInstructions", KEYPATH_WILDCARD, "index"],
+      ["meta", "innerInstructions", KEYPATH_WILDCARD, "instructions", KEYPATH_WILDCARD, "programIdIndex"],
+      ["meta", "innerInstructions", KEYPATH_WILDCARD, "instructions", KEYPATH_WILDCARD, "accounts", KEYPATH_WILDCARD],
+      ["transaction", "message", "addressTableLookups", KEYPATH_WILDCARD, "writableIndexes", KEYPATH_WILDCARD],
+      ["transaction", "message", "addressTableLookups", KEYPATH_WILDCARD, "readonlyIndexes", KEYPATH_WILDCARD],
+      ["transaction", "message", "instructions", KEYPATH_WILDCARD, "programIdIndex"],
+      ["transaction", "message", "instructions", KEYPATH_WILDCARD, "accounts", KEYPATH_WILDCARD],
+      ["transaction", "message", "header", "numReadonlySignedAccounts"],
+      ["transaction", "message", "header", "numReadonlyUnsignedAccounts"],
+      ["transaction", "message", "header", "numRequiredSignatures"]
+    ],
+    getVoteAccounts: [
+      ["current", KEYPATH_WILDCARD, "commission"],
+      ["delinquent", KEYPATH_WILDCARD, "commission"]
+    ]
   };
   function getNextAllowedKeypaths(keyPaths, property) {
     return keyPaths.filter((keyPath) => keyPath[0] === KEYPATH_WILDCARD && typeof property === "number" || keyPath[0] === property).map((keyPath) => keyPath.slice(1));
@@ -294,46 +395,6 @@ this.globalThis.solanaWeb3 = (function (exports) {
     });
   }
 
-  // src/rpc-default-config.ts
-  init_env_shim();
-
-  // src/rpc-integer-overflow-error.ts
-  init_env_shim();
-  var SolanaJsonRpcIntegerOverflowError = class extends Error {
-    constructor(methodName, keyPath, value) {
-      const argPosition = (typeof keyPath[0] === "number" ? keyPath[0] : parseInt(keyPath[0], 10)) + 1;
-      let ordinal = "";
-      const lastDigit = argPosition % 10;
-      const lastTwoDigits = argPosition % 100;
-      if (lastDigit == 1 && lastTwoDigits != 11) {
-        ordinal = argPosition + "st";
-      } else if (lastDigit == 2 && lastTwoDigits != 12) {
-        ordinal = argPosition + "nd";
-      } else if (lastDigit == 3 && lastTwoDigits != 13) {
-        ordinal = argPosition + "rd";
-      } else {
-        ordinal = argPosition + "th";
-      }
-      const path = keyPath.length > 1 ? keyPath.slice(1).map((pathPart) => typeof pathPart === "number" ? `[${pathPart}]` : pathPart).join(".") : null;
-      super(
-        `The ${ordinal} argument to the \`${methodName}\` RPC method${path ? ` at path \`${path}\`` : ""} was \`${value}\`. This number is unsafe for use with the Solana JSON-RPC because it exceeds \`Number.MAX_SAFE_INTEGER\`.`
-      );
-      this.keyPath = keyPath;
-      this.methodName = methodName;
-      this.value = value;
-    }
-    get name() {
-      return "SolanaJsonRpcIntegerOverflowError";
-    }
-  };
-
-  // src/rpc-default-config.ts
-  var DEFAULT_RPC_CONFIG = {
-    onIntegerOverflow(methodName, keyPath, value) {
-      throw new SolanaJsonRpcIntegerOverflowError(methodName, keyPath, value);
-    }
-  };
-
   // ../rpc-transport/dist/index.browser.js
   init_env_shim();
   var SolanaJsonRpcError = class extends Error {
@@ -399,6 +460,7 @@ this.globalThis.solanaWeb3 = (function (exports) {
   function createJsonRpc(rpcConfig) {
     return makeProxy(rpcConfig);
   }
+  var e = globalThis.fetch;
   var SolanaHttpError = class extends Error {
     constructor(details) {
       super(`HTTP error (${details.statusCode}): ${details.message}`);
@@ -457,7 +519,6 @@ this.globalThis.solanaWeb3 = (function (exports) {
     }
     return out;
   }
-  var e = globalThis.fetch;
   function createHttpTransport({ httpAgentNodeOnly, headers, url }) {
     if (headers) {
       assertIsAllowedHttpRequestHeaders(headers);
@@ -498,6 +559,46 @@ this.globalThis.solanaWeb3 = (function (exports) {
     };
   }
 
+  // src/rpc-default-config.ts
+  init_env_shim();
+
+  // src/rpc-integer-overflow-error.ts
+  init_env_shim();
+  var SolanaJsonRpcIntegerOverflowError = class extends Error {
+    constructor(methodName, keyPath, value) {
+      const argPosition = (typeof keyPath[0] === "number" ? keyPath[0] : parseInt(keyPath[0], 10)) + 1;
+      let ordinal = "";
+      const lastDigit = argPosition % 10;
+      const lastTwoDigits = argPosition % 100;
+      if (lastDigit == 1 && lastTwoDigits != 11) {
+        ordinal = argPosition + "st";
+      } else if (lastDigit == 2 && lastTwoDigits != 12) {
+        ordinal = argPosition + "nd";
+      } else if (lastDigit == 3 && lastTwoDigits != 13) {
+        ordinal = argPosition + "rd";
+      } else {
+        ordinal = argPosition + "th";
+      }
+      const path = keyPath.length > 1 ? keyPath.slice(1).map((pathPart) => typeof pathPart === "number" ? `[${pathPart}]` : pathPart).join(".") : null;
+      super(
+        `The ${ordinal} argument to the \`${methodName}\` RPC method${path ? ` at path \`${path}\`` : ""} was \`${value}\`. This number is unsafe for use with the Solana JSON-RPC because it exceeds \`Number.MAX_SAFE_INTEGER\`.`
+      );
+      this.keyPath = keyPath;
+      this.methodName = methodName;
+      this.value = value;
+    }
+    get name() {
+      return "SolanaJsonRpcIntegerOverflowError";
+    }
+  };
+
+  // src/rpc-default-config.ts
+  var DEFAULT_RPC_CONFIG = {
+    onIntegerOverflow(methodName, keyPath, value) {
+      throw new SolanaJsonRpcIntegerOverflowError(methodName, keyPath, value);
+    }
+  };
+
   // src/rpc.ts
   function createSolanaRpc(config) {
     return createJsonRpc({
@@ -508,6 +609,73 @@ this.globalThis.solanaWeb3 = (function (exports) {
 
   // src/rpc-transport.ts
   init_env_shim();
+
+  // src/rpc-request-coalescer.ts
+  init_env_shim();
+  function getRpcTransportWithRequestCoalescing(transport, getDeduplicationKey) {
+    let coalescedRequestsByDeduplicationKey;
+    return async function makeCoalescedHttpRequest(config) {
+      const { payload, signal } = config;
+      const deduplicationKey = getDeduplicationKey(payload);
+      if (deduplicationKey === void 0) {
+        return await transport(config);
+      }
+      if (!coalescedRequestsByDeduplicationKey) {
+        Promise.resolve().then(() => {
+          coalescedRequestsByDeduplicationKey = void 0;
+        });
+        coalescedRequestsByDeduplicationKey = {};
+      }
+      if (coalescedRequestsByDeduplicationKey[deduplicationKey] == null) {
+        const abortController = new AbortController();
+        coalescedRequestsByDeduplicationKey[deduplicationKey] = {
+          abortController,
+          numConsumers: 0,
+          responsePromise: transport({
+            ...config,
+            signal: abortController.signal
+          })
+        };
+      }
+      const coalescedRequest = coalescedRequestsByDeduplicationKey[deduplicationKey];
+      coalescedRequest.numConsumers++;
+      if (signal) {
+        const responsePromise = coalescedRequest.responsePromise;
+        return await new Promise((resolve, reject) => {
+          const handleAbort = (e2) => {
+            signal.removeEventListener("abort", handleAbort);
+            coalescedRequest.numConsumers -= 1;
+            if (coalescedRequest.numConsumers === 0) {
+              const abortController = coalescedRequest.abortController;
+              abortController.abort();
+            }
+            const abortError = new DOMException(e2.target.reason, "AbortError");
+            reject(abortError);
+          };
+          signal.addEventListener("abort", handleAbort);
+          responsePromise.then(resolve).finally(() => {
+            signal.removeEventListener("abort", handleAbort);
+          });
+        });
+      } else {
+        return await coalescedRequest.responsePromise;
+      }
+    };
+  }
+
+  // src/rpc-request-deduplication.ts
+  init_env_shim();
+  var import_fast_stable_stringify = __toESM(require_fast_stable_stringify(), 1);
+  function getSolanaRpcPayloadDeduplicationKey(payload) {
+    if (payload == null || typeof payload !== "object" || Array.isArray(payload)) {
+      return;
+    }
+    if ("jsonrpc" in payload && payload.jsonrpc === "2.0" && "method" in payload && "params" in payload) {
+      return (0, import_fast_stable_stringify.default)([payload.method, payload.params]);
+    }
+  }
+
+  // src/rpc-transport.ts
   function normalizeHeaders2(headers) {
     const out = {};
     for (const headerName in headers) {
@@ -516,16 +684,19 @@ this.globalThis.solanaWeb3 = (function (exports) {
     return out;
   }
   function createDefaultRpcTransport(config) {
-    return createHttpTransport({
-      ...config,
-      headers: {
-        ...config.headers ? normalizeHeaders2(config.headers) : void 0,
-        ...{
-          // Keep these headers lowercase so they will override any user-supplied headers above.
-          "solana-client": `js/${"2.0.0-development"}` ?? "UNKNOWN"
+    return getRpcTransportWithRequestCoalescing(
+      createHttpTransport({
+        ...config,
+        headers: {
+          ...config.headers ? normalizeHeaders2(config.headers) : void 0,
+          ...{
+            // Keep these headers lowercase so they will override any user-supplied headers above.
+            "solana-client": `js/${"2.0.0-development"}` ?? "UNKNOWN"
+          }
         }
-      }
-    });
+      }),
+      getSolanaRpcPayloadDeduplicationKey
+    );
   }
 
   exports.assertIsBase58EncodedAddress = assertIsBase58EncodedAddress;