@solana/web3.js 1.41.9 → 1.41.11

package/lib/index.iife.js

@@ -13876,6 +13876,36 @@ var solanaWeb3 = (function (exports) {
 	  }
 	}
 
+	const END_OF_BUFFER_ERROR_MESSAGE = 'Reached end of buffer unexpectedly';
+	/**
+	 * Delegates to `Array#shift`, but throws if the array is zero-length.
+	 */
+
+	function guardedShift(byteArray) {
+	  if (byteArray.length === 0) {
+	    throw new Error(END_OF_BUFFER_ERROR_MESSAGE);
+	  }
+
+	  return byteArray.shift();
+	}
+	/**
+	 * Delegates to `Array#splice`, but throws if the section being spliced out extends past the end of
+	 * the array.
+	 */
+
+	function guardedSplice(byteArray, ...args) {
+	  var _args$;
+
+	  const [start] = args;
+
+	  if (args.length === 2 // Implies that `deleteCount` was supplied
+	  ? start + ((_args$ = args[1]) !== null && _args$ !== void 0 ? _args$ : 0) > byteArray.length : start >= byteArray.length) {
+	    throw new Error(END_OF_BUFFER_ERROR_MESSAGE);
+	  }
+
+	  return byteArray.splice(...args);
+	}
+
 	/**
 	 * The message header, identifying signed and read-only account
 	 */
@@ -13974,32 +14004,28 @@ var solanaWeb3 = (function (exports) {
 	  static from(buffer$1) {
 	    // Slice up wire data
 	    let byteArray = [...buffer$1];
-	    const numRequiredSignatures = byteArray.shift();
-	    const numReadonlySignedAccounts = byteArray.shift();
-	    const numReadonlyUnsignedAccounts = byteArray.shift();
+	    const numRequiredSignatures = guardedShift(byteArray);
+	    const numReadonlySignedAccounts = guardedShift(byteArray);
+	    const numReadonlyUnsignedAccounts = guardedShift(byteArray);
 	    const accountCount = decodeLength(byteArray);
 	    let accountKeys = [];
 
 	    for (let i = 0; i < accountCount; i++) {
-	      const account = byteArray.slice(0, PUBKEY_LENGTH);
-	      byteArray = byteArray.slice(PUBKEY_LENGTH);
+	      const account = guardedSplice(byteArray, 0, PUBKEY_LENGTH);
 	      accountKeys.push(bs58$1.encode(buffer.Buffer.from(account)));
 	    }
 
-	    const recentBlockhash = byteArray.slice(0, PUBKEY_LENGTH);
-	    byteArray = byteArray.slice(PUBKEY_LENGTH);
+	    const recentBlockhash = guardedSplice(byteArray, 0, PUBKEY_LENGTH);
 	    const instructionCount = decodeLength(byteArray);
 	    let instructions = [];
 
 	    for (let i = 0; i < instructionCount; i++) {
-	      const programIdIndex = byteArray.shift();
+	      const programIdIndex = guardedShift(byteArray);
 	      const accountCount = decodeLength(byteArray);
-	      const accounts = byteArray.slice(0, accountCount);
-	      byteArray = byteArray.slice(accountCount);
+	      const accounts = guardedSplice(byteArray, 0, accountCount);
 	      const dataLength = decodeLength(byteArray);
-	      const dataSlice = byteArray.slice(0, dataLength);
+	      const dataSlice = guardedSplice(byteArray, 0, dataLength);
 	      const data = bs58$1.encode(buffer.Buffer.from(dataSlice));
-	      byteArray = byteArray.slice(dataLength);
 	      instructions.push({
 	        programIdIndex,
 	        accounts,
@@ -14028,9 +14054,21 @@ var solanaWeb3 = (function (exports) {
 	  }
 	}
 
+	/**
+	 * Transaction signature as base-58 encoded string
+	 */
+
+	exports.TransactionStatus = void 0;
 	/**
 	 * Default (empty) signature
 	 */
+
+	(function (TransactionStatus) {
+	  TransactionStatus[TransactionStatus["BLOCKHEIGHT_EXCEEDED"] = 0] = "BLOCKHEIGHT_EXCEEDED";
+	  TransactionStatus[TransactionStatus["PROCESSED"] = 1] = "PROCESSED";
+	  TransactionStatus[TransactionStatus["TIMED_OUT"] = 2] = "TIMED_OUT";
+	})(exports.TransactionStatus || (exports.TransactionStatus = {}));
+
 	const DEFAULT_SIGNATURE = buffer.Buffer.alloc(SIGNATURE_LENGTH_IN_BYTES).fill(0);
 	/**
 	 * Account metadata used to define instructions
@@ -14121,10 +14159,23 @@ var solanaWeb3 = (function (exports) {
 	    this.feePayer = void 0;
 	    this.instructions = [];
 	    this.recentBlockhash = void 0;
+	    this.lastValidBlockHeight = void 0;
 	    this.nonceInfo = void 0;
 	    this._message = void 0;
 	    this._json = void 0;
-	    opts && Object.assign(this, opts);
+
+	    if (!opts) {
+	      return;
+	    } else if (Object.prototype.hasOwnProperty.call(opts, 'lastValidBlockHeight')) {
+	      const newOpts = opts;
+	      Object.assign(this, newOpts);
+	      this.recentBlockhash = newOpts.blockhash;
+	      this.lastValidBlockHeight = newOpts.lastValidBlockHeight;
+	    } else {
+	      const oldOpts = opts;
+	      Object.assign(this, oldOpts);
+	      this.recentBlockhash = oldOpts.recentBlockhash;
+	    }
 	  }
 	  /**
 	   * @internal
@@ -14657,8 +14708,7 @@ var solanaWeb3 = (function (exports) {
 	    let signatures = [];
 
 	    for (let i = 0; i < signatureCount; i++) {
-	      const signature = byteArray.slice(0, SIGNATURE_LENGTH_IN_BYTES);
-	      byteArray = byteArray.slice(SIGNATURE_LENGTH_IN_BYTES);
+	      const signature = guardedSplice(byteArray, 0, SIGNATURE_LENGTH_IN_BYTES);
 	      signatures.push(bs58$1.encode(buffer.Buffer.from(signature)));
 	    }
 
@@ -14734,7 +14784,11 @@ var solanaWeb3 = (function (exports) {
 	    maxRetries: options.maxRetries
 	  };
 	  const signature = await connection.sendTransaction(transaction, signers, sendOptions);
-	  const status = (await connection.confirmTransaction(signature, options && options.commitment)).value;
+	  const status = transaction.recentBlockhash != null && transaction.lastValidBlockHeight != null ? (await connection.confirmTransaction({
+	    signature: signature,
+	    blockhash: transaction.recentBlockhash,
+	    lastValidBlockHeight: transaction.lastValidBlockHeight
+	  }, options && options.commitment)).value : (await connection.confirmTransaction(signature, options && options.commitment)).value;
 
 	  if (status.err) {
 	    throw new Error(`Transaction ${signature} failed (${JSON.stringify(status)})`);
@@ -24938,16 +24992,28 @@ var solanaWeb3 = (function (exports) {
 
 	const MS_PER_SLOT = 1000 / NUM_SLOTS_PER_SECOND;
 
-	function promiseTimeout(promise, timeoutMs) {
-	  let timeoutId;
-	  const timeoutPromise = new Promise(resolve => {
-	    timeoutId = setTimeout(() => resolve(null), timeoutMs);
-	  });
-	  return Promise.race([promise, timeoutPromise]).then(result => {
-	    clearTimeout(timeoutId);
-	    return result;
-	  });
+	class TransactionExpiredBlockheightExceededError extends Error {
+	  constructor(signature) {
+	    super(`Signature ${signature} has expired: block height exceeded.`);
+	    this.signature = void 0;
+	    this.signature = signature;
+	  }
+
 	}
+	Object.defineProperty(TransactionExpiredBlockheightExceededError.prototype, 'name', {
+	  value: 'TransactionExpiredBlockheightExceededError'
+	});
+	class TransactionExpiredTimeoutError extends Error {
+	  constructor(signature, timeoutSeconds) {
+	    super(`Transaction was not confirmed in ${timeoutSeconds.toFixed(2)} seconds. It is ` + 'unknown if it succeeded or failed. Check signature ' + `${signature} using the Solana Explorer or CLI tools.`);
+	    this.signature = void 0;
+	    this.signature = signature;
+	  }
+
+	}
+	Object.defineProperty(TransactionExpiredTimeoutError.prototype, 'name', {
+	  value: 'TransactionExpiredTimeoutError'
+	});
 
 	function makeWebsocketUrl(endpoint) {
 	  let url = new URL(endpoint);
@@ -26417,67 +26483,124 @@ var solanaWeb3 = (function (exports) {
 
 	    return res.result;
 	  }
-	  /**
-	   * Confirm the transaction identified by the specified signature.
-	   */
 
+	  // eslint-disable-next-line no-dupe-class-members
+	  async confirmTransaction(strategy, commitment) {
+	    let rawSignature;
+
+	    if (typeof strategy == 'string') {
+	      rawSignature = strategy;
+	    } else {
+	      const config = strategy;
+	      rawSignature = config.signature;
+	    }
 
-	  async confirmTransaction(signature, commitment) {
 	    let decodedSignature;
 
 	    try {
-	      decodedSignature = bs58$1.decode(signature);
+	      decodedSignature = bs58$1.decode(rawSignature);
 	    } catch (err) {
-	      throw new Error('signature must be base58 encoded: ' + signature);
+	      throw new Error('signature must be base58 encoded: ' + rawSignature);
 	    }
 
 	    assert$c(decodedSignature.length === 64, 'signature has invalid length');
-	    const start = Date.now();
 	    const subscriptionCommitment = commitment || this.commitment;
+	    let timeoutId;
 	    let subscriptionId;
-	    let response = null;
-	    const confirmPromise = new Promise((resolve, reject) => {
+	    let done = false;
+	    const confirmationPromise = new Promise((resolve, reject) => {
 	      try {
-	        subscriptionId = this.onSignature(signature, (result, context) => {
+	        subscriptionId = this.onSignature(rawSignature, (result, context) => {
 	          subscriptionId = undefined;
-	          response = {
+	          const response = {
 	            context,
 	            value: result
 	          };
-	          resolve(null);
+	          done = true;
+	          resolve({
+	            __type: exports.TransactionStatus.PROCESSED,
+	            response
+	          });
 	        }, subscriptionCommitment);
 	      } catch (err) {
 	        reject(err);
 	      }
 	    });
-	    let timeoutMs = this._confirmTransactionInitialTimeout || 60 * 1000;
-
-	    switch (subscriptionCommitment) {
-	      case 'processed':
-	      case 'recent':
-	      case 'single':
-	      case 'confirmed':
-	      case 'singleGossip':
-	        {
-	          timeoutMs = this._confirmTransactionInitialTimeout || 30 * 1000;
-	          break;
+
+	    const checkBlockHeight = async () => {
+	      try {
+	        const blockHeight = await this.getBlockHeight(commitment);
+	        return blockHeight;
+	      } catch (_e) {
+	        return -1;
+	      }
+	    };
+
+	    const expiryPromise = new Promise(resolve => {
+	      if (typeof strategy === 'string') {
+	        let timeoutMs = this._confirmTransactionInitialTimeout || 60 * 1000;
+
+	        switch (subscriptionCommitment) {
+	          case 'processed':
+	          case 'recent':
+	          case 'single':
+	          case 'confirmed':
+	          case 'singleGossip':
+	            {
+	              timeoutMs = this._confirmTransactionInitialTimeout || 30 * 1000;
+	              break;
+	            }
 	        }
-	    }
+
+	        timeoutId = setTimeout(() => resolve({
+	          __type: exports.TransactionStatus.TIMED_OUT,
+	          timeoutMs
+	        }), timeoutMs);
+	      } else {
+	        let config = strategy;
+
+	        (async () => {
+	          let currentBlockHeight = await checkBlockHeight();
+	          if (done) return;
+
+	          while (currentBlockHeight <= config.lastValidBlockHeight) {
+	            await sleep(1000);
+	            if (done) return;
+	            currentBlockHeight = await checkBlockHeight();
+	            if (done) return;
+	          }
+
+	          resolve({
+	            __type: exports.TransactionStatus.BLOCKHEIGHT_EXCEEDED
+	          });
+	        })();
+	      }
+	    });
+	    let result;
 
 	    try {
-	      await promiseTimeout(confirmPromise, timeoutMs);
+	      const outcome = await Promise.race([confirmationPromise, expiryPromise]);
+
+	      switch (outcome.__type) {
+	        case exports.TransactionStatus.BLOCKHEIGHT_EXCEEDED:
+	          throw new TransactionExpiredBlockheightExceededError(rawSignature);
+
+	        case exports.TransactionStatus.PROCESSED:
+	          result = outcome.response;
+	          break;
+
+	        case exports.TransactionStatus.TIMED_OUT:
+	          throw new TransactionExpiredTimeoutError(rawSignature, outcome.timeoutMs / 1000);
+	      }
 	    } finally {
+	      clearTimeout(timeoutId);
+
 	      if (subscriptionId) {
 	        this.removeSignatureListener(subscriptionId);
 	      }
 	    }
 
-	    if (response === null) {
-	      const duration = (Date.now() - start) / 1000;
-	      throw new Error(`Transaction was not confirmed in ${duration.toFixed(2)} seconds. It is unknown if it succeeded or failed. Check signature ${signature} using the Solana Explorer or CLI tools.`);
-	    }
-
-	    return response;
+	    return result;
 	  }
 	  /**
 	   * Return the list of nodes that are currently participating in the cluster
@@ -29594,10 +29717,8 @@ var solanaWeb3 = (function (exports) {
 	    const configKeys = [];
 
 	    for (let i = 0; i < 2; i++) {
-	      const publicKey = new PublicKey(byteArray.slice(0, PUBKEY_LENGTH));
-	      byteArray = byteArray.slice(PUBKEY_LENGTH);
-	      const isSigner = byteArray.slice(0, 1)[0] === 1;
-	      byteArray = byteArray.slice(1);
+	      const publicKey = new PublicKey(guardedSplice(byteArray, 0, PUBKEY_LENGTH));
+	      const isSigner = guardedShift(byteArray) === 1;
 	      configKeys.push({
 	        publicKey,
 	        isSigner