@solana/web3.js 1.68.1 → 1.70.0

package/lib/index.cjs.js

@@ -11,11 +11,11 @@ var sha256 = require('@noble/hashes/sha256');
 var borsh = require('borsh');
 var BufferLayout = require('@solana/buffer-layout');
 var bigintBuffer = require('bigint-buffer');
+var https = require('https');
 var superstruct = require('superstruct');
 var rpcWebsockets = require('rpc-websockets');
 var RpcClient = require('jayson/lib/client/browser');
 var http = require('http');
-var https = require('https');
 var nodeFetch = require('node-fetch');
 var sha3 = require('@noble/hashes/sha3');
 var hmac = require('@noble/hashes/hmac');
@@ -45,9 +45,9 @@ var ed25519__namespace = /*#__PURE__*/_interopNamespace(ed25519);
 var BN__default = /*#__PURE__*/_interopDefaultLegacy(BN);
 var bs58__default = /*#__PURE__*/_interopDefaultLegacy(bs58);
 var BufferLayout__namespace = /*#__PURE__*/_interopNamespace(BufferLayout);
+var https__default = /*#__PURE__*/_interopDefaultLegacy(https);
 var RpcClient__default = /*#__PURE__*/_interopDefaultLegacy(RpcClient);
 var http__default = /*#__PURE__*/_interopDefaultLegacy(http);
-var https__default = /*#__PURE__*/_interopDefaultLegacy(https);
 var nodeFetch__namespace = /*#__PURE__*/_interopNamespace(nodeFetch);
 var secp256k1__namespace = /*#__PURE__*/_interopNamespace(secp256k1);
 
@@ -2245,6 +2245,7 @@ async function sendAndConfirmTransaction(connection, transaction, signers, optio
 
   if (transaction.recentBlockhash != null && transaction.lastValidBlockHeight != null) {
     status = (await connection.confirmTransaction({
+      abortSignal: options === null || options === void 0 ? void 0 : options.abortSignal,
       signature: signature,
       blockhash: transaction.recentBlockhash,
       lastValidBlockHeight: transaction.lastValidBlockHeight
@@ -2255,12 +2256,17 @@ async function sendAndConfirmTransaction(connection, transaction, signers, optio
     } = transaction.nonceInfo;
     const nonceAccountPubkey = nonceInstruction.keys[0].pubkey;
     status = (await connection.confirmTransaction({
+      abortSignal: options === null || options === void 0 ? void 0 : options.abortSignal,
       minContextSlot: transaction.minNonceContextSlot,
       nonceAccountPubkey,
       nonceValue: transaction.nonceInfo.nonce,
       signature
     }, options && options.commitment)).value;
   } else {
+    if ((options === null || options === void 0 ? void 0 : options.abortSignal) != null) {
+      console.warn('sendAndConfirmTransaction(): A transaction with a deprecated confirmation strategy was ' + 'supplied along with an `abortSignal`. Only transactions having `lastValidBlockHeight` ' + 'or a combination of `nonceInfo` and `minNonceContextSlot` are abortable.');
+    }
+
     status = (await connection.confirmTransaction(signature, options && options.commitment)).value;
   }
 
@@ -3473,7 +3479,7 @@ function nextPowerOfTwo(n) {
 /**
  * Epoch schedule
  * (see https://docs.solana.com/terminology#epoch)
- * Can be retrieved with the {@link connection.getEpochSchedule} method
+ * Can be retrieved with the {@link Connection.getEpochSchedule} method
  */
 
 
@@ -3748,13 +3754,10 @@ function extractCommitmentFromConfig(commitmentOrConfig) {
   };
 }
 /**
- * A strategy for confirming durable nonce transactions.
+ * @internal
  */
 
 
-/**
- * @internal
- */
 function createRpcResult(result) {
   return superstruct.union([superstruct.type({
     jsonrpc: superstruct.literal('2.0'),
@@ -3946,14 +3949,34 @@ const BlockProductionResponseStruct = jsonRpcResultAndContext(superstruct.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 https.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 https.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;
@@ -4863,6 +4886,7 @@ class Connection {
     let fetch;
     let fetchMiddleware;
     let disableRetryOnRateLimit;
+    let httpAgent;
 
     if (commitmentOrConfig && typeof commitmentOrConfig === 'string') {
       this._commitment = commitmentOrConfig;
@@ -4874,11 +4898,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 rpcWebsockets.Client(this._rpcWsEndpoint, {
@@ -5369,7 +5394,14 @@ class Connection {
     if (typeof strategy == 'string') {
       rawSignature = strategy;
     } else {
+      var _config$abortSignal;
+
       const config = strategy;
+
+      if ((_config$abortSignal = config.abortSignal) !== null && _config$abortSignal !== void 0 && _config$abortSignal.aborted) {
+        return Promise.reject(config.abortSignal.reason);
+      }
+
       rawSignature = config.signature;
     }
 
@@ -5401,6 +5433,22 @@ class Connection {
     }
   }
 
+  getCancellationPromise(signal) {
+    return new Promise((_, reject) => {
+      if (signal == null) {
+        return;
+      }
+
+      if (signal.aborted) {
+        reject(signal.reason);
+      } else {
+        signal.addEventListener('abort', () => {
+          reject(signal.reason);
+        });
+      }
+    });
+  }
+
   getTransactionConfirmationPromise({
     commitment,
     signature
@@ -5519,6 +5567,7 @@ class Connection {
   async confirmTransactionUsingBlockHeightExceedanceStrategy({
     commitment,
     strategy: {
+      abortSignal,
       lastValidBlockHeight,
       signature
     }
@@ -5557,10 +5606,11 @@ class Connection {
       commitment,
       signature
     });
+    const cancellationPromise = this.getCancellationPromise(abortSignal);
     let result;
 
     try {
-      const outcome = await Promise.race([confirmationPromise, expiryPromise]);
+      const outcome = await Promise.race([cancellationPromise, confirmationPromise, expiryPromise]);
 
       if (outcome.__type === exports.TransactionStatus.PROCESSED) {
         result = outcome.response;
@@ -5578,6 +5628,7 @@ class Connection {
   async confirmTransactionUsingDurableNonceStrategy({
     commitment,
     strategy: {
+      abortSignal,
       minContextSlot,
       nonceAccountPubkey,
       nonceValue,
@@ -5635,10 +5686,11 @@ class Connection {
       commitment,
       signature
     });
+    const cancellationPromise = this.getCancellationPromise(abortSignal);
     let result;
 
     try {
-      const outcome = await Promise.race([confirmationPromise, expiryPromise]);
+      const outcome = await Promise.race([cancellationPromise, confirmationPromise, expiryPromise]);
 
       if (outcome.__type === exports.TransactionStatus.PROCESSED) {
         result = outcome.response;