@solana/web3.js 1.69.0 → 1.70.0

package/lib/index.d.ts

@@ -1,6 +1,8 @@
 /// <reference types="node" />
 declare module '@solana/web3.js' {
   import {Buffer} from 'buffer';
+  import {Agent} from 'http';
+  import {Agent as Agent$1} from 'https';
   import * as nodeFetch from 'node-fetch';
 
   export class Struct {
@@ -3272,6 +3274,12 @@ declare module '@solana/web3.js' {
    * Configuration for instantiating a Connection
    */
   type ConnectionConfig = {
+    /**
+     * An `http.Agent` that will be used to manage socket connections (eg. to implement connection
+     * persistence). Set this to `false` to create a connection that uses no agent. This applies to
+     * Node environments only.
+     */
+    httpAgent?: Agent | Agent$1 | false;
     /** Optional commitment level */
     commitment?: Commitment;
     /** Optional endpoint URL to the fullnode JSON RPC PubSub WebSocket Endpoint */

package/lib/index.esm.js

@@ -8,11 +8,11 @@ import { serialize, deserialize, deserializeUnchecked } from 'borsh';
 import * as BufferLayout from '@solana/buffer-layout';
 import { blob } from '@solana/buffer-layout';
 import { toBigIntLE, toBufferLE } from 'bigint-buffer';
+import https, { Agent } from 'https';
 import { coerce, instance, string, tuple, literal, unknown, union, type, optional, any, number, array, nullable, create, boolean, record, assert as assert$1 } from 'superstruct';
 import { Client } from 'rpc-websockets';
 import RpcClient from 'jayson/lib/client/browser';
 import http from 'http';
-import https from 'https';
 import * as nodeFetch from 'node-fetch';
 import { keccak_256 } from '@noble/hashes/sha3';
 import { hmac } from '@noble/hashes/hmac';
@@ -3916,14 +3916,34 @@ const BlockProductionResponseStruct = jsonRpcResultAndContext(type({
  * A performance sample
  */
 
-function createRpcClient(url, httpHeaders, customFetch, fetchMiddleware, disableRetryOnRateLimit) {
+function createRpcClient(url, httpHeaders, customFetch, fetchMiddleware, disableRetryOnRateLimit, httpAgent) {
   const fetch = customFetch ? customFetch : fetchImpl;
   let agentManager;
 
   {
-    agentManager = new AgentManager(url.startsWith('https:')
-    /* useHttps */
-    );
+    if (httpAgent == null) {
+      {
+        agentManager = new AgentManager(url.startsWith('https:')
+        /* useHttps */
+        );
+      }
+    } else {
+      if (httpAgent !== false) {
+        const isHttps = url.startsWith('https:');
+
+        if (isHttps && !(httpAgent instanceof Agent)) {
+          throw new Error('The endpoint `' + url + '` can only be paired with an `https.Agent`. You have, instead, supplied an ' + '`http.Agent` through `httpAgent`.');
+        } else if (!isHttps && httpAgent instanceof Agent) {
+          throw new Error('The endpoint `' + url + '` can only be paired with an `http.Agent`. You have, instead, supplied an ' + '`https.Agent` through `httpAgent`.');
+        }
+
+        agentManager = {
+          requestEnd() {},
+
+          requestStart: () => httpAgent
+        };
+      }
+    }
   }
 
   let fetchWithMiddleware;
@@ -4833,6 +4853,7 @@ class Connection {
     let fetch;
     let fetchMiddleware;
     let disableRetryOnRateLimit;
+    let httpAgent;
 
     if (commitmentOrConfig && typeof commitmentOrConfig === 'string') {
       this._commitment = commitmentOrConfig;
@@ -4844,11 +4865,12 @@ class Connection {
       fetch = commitmentOrConfig.fetch;
       fetchMiddleware = commitmentOrConfig.fetchMiddleware;
       disableRetryOnRateLimit = commitmentOrConfig.disableRetryOnRateLimit;
+      httpAgent = commitmentOrConfig.httpAgent;
     }
 
     this._rpcEndpoint = assertEndpointUrl(endpoint);
     this._rpcWsEndpoint = wsEndpoint || makeWebsocketUrl(endpoint);
-    this._rpcClient = createRpcClient(endpoint, httpHeaders, fetch, fetchMiddleware, disableRetryOnRateLimit);
+    this._rpcClient = createRpcClient(endpoint, httpHeaders, fetch, fetchMiddleware, disableRetryOnRateLimit, httpAgent);
     this._rpcRequest = createRpcRequest(this._rpcClient);
     this._rpcBatchRequest = createRpcBatchRequest(this._rpcClient);
     this._rpcWebSocket = new Client(this._rpcWsEndpoint, {