@solana/web3.js 1.87.6 → 1.89.0

package/lib/index.native.js

@@ -1152,6 +1152,8 @@ const VersionedMessage = {
   }
 };
 
+/** @internal */
+
 /**
  * Transaction signature as base-58 encoded string
  */
@@ -1241,20 +1243,25 @@ class TransactionInstruction {
 // For backward compatibility; an unfortunate consequence of being
 // forced to over-export types by the documentation generator.
 // See https://github.com/solana-labs/solana/pull/25820
+
 /**
  * Blockhash-based transactions have a lifetime that are defined by
  * the blockhash they include. Any transaction whose blockhash is
  * too old will be rejected.
  */
+
 /**
  * Use these options to construct a durable nonce transaction.
  */
+
 /**
  * Nonce information to be used to build an offline Transaction.
  */
+
 /**
  * @internal
  */
+
 /**
  * Transaction class
  */
@@ -1767,29 +1774,31 @@ class Transaction {
    *
    * @param {boolean} [requireAllSignatures=true] Require a fully signed Transaction
    */
-  verifySignatures(requireAllSignatures) {
-    return this._verifySignatures(this.serializeMessage(), requireAllSignatures === undefined ? true : requireAllSignatures);
+  verifySignatures(requireAllSignatures = true) {
+    const signatureErrors = this._getMessageSignednessErrors(this.serializeMessage(), requireAllSignatures);
+    return !signatureErrors;
   }
 
   /**
    * @internal
    */
-  _verifySignatures(signData, requireAllSignatures) {
+  _getMessageSignednessErrors(message, requireAllSignatures) {
+    const errors = {};
     for (const {
       signature,
       publicKey
     } of this.signatures) {
       if (signature === null) {
         if (requireAllSignatures) {
-          return false;
+          (errors.missing ||= []).push(publicKey);
         }
       } else {
-        if (!verify(signature, signData, publicKey.toBytes())) {
-          return false;
+        if (!verify(signature, message, publicKey.toBytes())) {
+          (errors.invalid ||= []).push(publicKey);
         }
       }
     }
-    return true;
+    return errors.invalid || errors.missing ? errors : undefined;
   }
 
   /**
@@ -1808,8 +1817,18 @@ class Transaction {
       verifySignatures: true
     }, config);
     const signData = this.serializeMessage();
-    if (verifySignatures && !this._verifySignatures(signData, requireAllSignatures)) {
-      throw new Error('Signature verification failed');
+    if (verifySignatures) {
+      const sigErrors = this._getMessageSignednessErrors(signData, requireAllSignatures);
+      if (sigErrors) {
+        let errorMessage = 'Signature verification failed.';
+        if (sigErrors.invalid) {
+          errorMessage += `\nInvalid signature for public key${sigErrors.invalid.length === 1 ? '' : '(s)'} [\`${sigErrors.invalid.map(p => p.toBase58()).join('`, `')}\`].`;
+        }
+        if (sigErrors.missing) {
+          errorMessage += `\nMissing signature for public key${sigErrors.missing.length === 1 ? '' : '(s)'} [\`${sigErrors.missing.map(p => p.toBase58()).join('`, `')}\`].`;
+        }
+        throw new Error(errorMessage);
+      }
     }
     return this._serialize(signData);
   }
@@ -3794,6 +3813,7 @@ function versionedMessageFromResponse(version, response) {
  */
 
 // Deprecated as of v1.5.5
+
 /**
  * A subset of Commitment levels, which are at least optimistically confirmed
  * <pre>
@@ -3801,6 +3821,7 @@ function versionedMessageFromResponse(version, response) {
  *   'finalized': Query the most recent block which has been finalized by the cluster
  * </pre>
  */
+
 /**
  * Filter for largest accounts query
  * <pre>
@@ -3808,70 +3829,92 @@ function versionedMessageFromResponse(version, response) {
  *   'nonCirculating': Return the largest accounts that are not part of the circulating supply
  * </pre>
  */
+
 /**
  * Configuration object for changing `getAccountInfo` query behavior
  */
+
 /**
  * Configuration object for changing `getBalance` query behavior
  */
+
 /**
  * Configuration object for changing `getBlock` query behavior
  */
+
 /**
  * Configuration object for changing `getBlock` query behavior
  */
+
 /**
  * Configuration object for changing `getStakeMinimumDelegation` query behavior
  */
+
 /**
  * Configuration object for changing `getBlockHeight` query behavior
  */
+
 /**
  * Configuration object for changing `getEpochInfo` query behavior
  */
+
 /**
  * Configuration object for changing `getInflationReward` query behavior
  */
+
 /**
  * Configuration object for changing `getLatestBlockhash` query behavior
  */
+
 /**
  * Configuration object for changing `isBlockhashValid` query behavior
  */
+
 /**
  * Configuration object for changing `getSlot` query behavior
  */
+
 /**
  * Configuration object for changing `getSlotLeader` query behavior
  */
+
 /**
  * Configuration object for changing `getTransaction` query behavior
  */
+
 /**
  * Configuration object for changing `getTransaction` query behavior
  */
+
 /**
  * Configuration object for changing `getLargestAccounts` query behavior
  */
+
 /**
  * Configuration object for changing `getSupply` request behavior
  */
+
 /**
  * Configuration object for changing query behavior
  */
+
 /**
  * Information describing a cluster node
  */
+
 /**
  * Information describing a vote account
  */
+
 /**
  * A collection of cluster vote accounts
  */
+
 /**
  * Network Inflation
  * (see https://docs.solana.com/implemented-proposals/ed_overview)
  */
+
 const GetInflationGovernorResult = superstruct.type({
   foundation: superstruct.number(),
   foundationTerm: superstruct.number(),
@@ -5599,7 +5642,9 @@ class Connection {
     return res.result;
   }
 
-  /** @deprecated Instead, call `confirmTransaction` and pass in {@link TransactionConfirmationStrategy} */ // eslint-disable-next-line no-dupe-class-members
+  /** @deprecated Instead, call `confirmTransaction` and pass in {@link TransactionConfirmationStrategy} */
+  // eslint-disable-next-line no-dupe-class-members
+
   // eslint-disable-next-line no-dupe-class-members
   async confirmTransaction(strategy, commitment) {
     let rawSignature;
@@ -6394,21 +6439,28 @@ class Connection {
   /**
    * @deprecated Instead, call `getBlock` using a `GetVersionedBlockConfig` by
    * setting the `maxSupportedTransactionVersion` property.
-   */ // eslint-disable-next-line no-dupe-class-members
+   */
+  // eslint-disable-next-line no-dupe-class-members
+
   /**
    * @deprecated Instead, call `getBlock` using a `GetVersionedBlockConfig` by
    * setting the `maxSupportedTransactionVersion` property.
    */
   // eslint-disable-next-line no-dupe-class-members
+
   /**
    * Fetch a processed block from the cluster.
    */
   // eslint-disable-next-line no-dupe-class-members
+
   // eslint-disable-next-line no-dupe-class-members
+
   // eslint-disable-next-line no-dupe-class-members
+
   /**
    * Fetch a processed block from the cluster.
-   */ // eslint-disable-next-line no-dupe-class-members
+   */
+  // eslint-disable-next-line no-dupe-class-members
   async getBlock(slot, rawConfig) {
     const {
       commitment,
@@ -6547,10 +6599,13 @@ class Connection {
 
   /**
    * Fetch a confirmed or finalized transaction from the cluster.
-   */ // eslint-disable-next-line no-dupe-class-members
+   */
+  // eslint-disable-next-line no-dupe-class-members
+
   /**
    * Fetch a confirmed or finalized transaction from the cluster.
-   */ // eslint-disable-next-line no-dupe-class-members
+   */
+  // eslint-disable-next-line no-dupe-class-members
   async getTransaction(signature, rawConfig) {
     const {
       commitment,
@@ -6629,12 +6684,15 @@ class Connection {
    * Fetch transaction details for a batch of confirmed transactions.
    * Similar to {@link getParsedTransactions} but returns a {@link
    * VersionedTransactionResponse}.
-   */ // eslint-disable-next-line no-dupe-class-members
+   */
+  // eslint-disable-next-line no-dupe-class-members
+
   /**
    * Fetch transaction details for a batch of confirmed transactions.
    * Similar to {@link getParsedTransactions} but returns a {@link
    * VersionedTransactionResponse}.
-   */ // eslint-disable-next-line no-dupe-class-members
+   */
+  // eslint-disable-next-line no-dupe-class-members
   async getTransactions(signatures, commitmentOrConfig) {
     const {
       commitment,
@@ -7060,10 +7118,13 @@ class Connection {
 
   /**
    * Simulate a transaction
-   */ // eslint-disable-next-line no-dupe-class-members
+   */
+  // eslint-disable-next-line no-dupe-class-members
+
   /**
    * Simulate a transaction
-   */ // eslint-disable-next-line no-dupe-class-members
+   */
+  // eslint-disable-next-line no-dupe-class-members
   async simulateTransaction(transactionOrMessage, configOrSigners, includeAccounts) {
     if ('message' in transactionOrMessage) {
       const versionedTx = transactionOrMessage;
@@ -7115,7 +7176,6 @@ class Connection {
         if (!transaction.signature) {
           throw new Error('!signature'); // should never happen
         }
-
         const signature = transaction.signature.toString('base64');
         if (!this._blockhashInfo.simulatedSignatures.includes(signature) && !this._blockhashInfo.transactionSignatures.includes(signature)) {
           // The signature of this transaction has not been seen before with the
@@ -7176,10 +7236,13 @@ class Connection {
 
   /**
    * Send a signed transaction
-   */ // eslint-disable-next-line no-dupe-class-members
+   */
+  // eslint-disable-next-line no-dupe-class-members
+
   /**
    * Sign and send a transaction
-   */ // eslint-disable-next-line no-dupe-class-members
+   */
+  // eslint-disable-next-line no-dupe-class-members
   async sendTransaction(transaction, signersOrOptions, options) {
     if ('version' in transaction) {
       if (signersOrOptions && Array.isArray(signersOrOptions)) {
@@ -7204,7 +7267,6 @@ class Connection {
         if (!transaction.signature) {
           throw new Error('!signature'); // should never happen
         }
-
         const signature = transaction.signature.toString('base64');
         if (!this._blockhashInfo.transactionSignatures.includes(signature)) {
           // The signature of this transaction has not been seen before with the
@@ -7588,7 +7650,6 @@ class Connection {
   args) {
     const clientSubscriptionId = this._nextClientSubscriptionId++;
     const hash = fastStableStringify$1([subscriptionConfig.method, args], true /* isArrayProp */);
-
     const existingSubscription = this._subscriptionsByHash[hash];
     if (existingSubscription === undefined) {
       this._subscriptionsByHash[hash] = {
@@ -7671,7 +7732,6 @@ class Connection {
     'base64' /* encoding */, filters ? {
       filters: filters
     } : undefined /* extra */);
-
     return this._makeSubscription({
       callback,
       method: 'programSubscribe',
@@ -7696,7 +7756,6 @@ class Connection {
       mentions: [filter.toString()]
     } : filter], commitment || this._commitment || 'finalized' // Apply connection/server default.
     );
-
     return this._makeSubscription({
       callback,
       method: 'logsSubscribe',
@@ -7877,7 +7936,6 @@ class Connection {
   onSignature(signature, callback, commitment) {
     const args = this._buildArgs([signature], commitment || this._commitment || 'finalized' // Apply connection/server default.
     );
-
     const clientSubscriptionId = this._makeSubscription({
       callback: (notification, context) => {
         if (notification.type === 'status') {
@@ -7916,7 +7974,6 @@ class Connection {
       ...options,
       commitment: options && options.commitment || this._commitment || 'finalized' // Apply connection/server default.
     };
-
     const args = this._buildArgs([signature], commitment, undefined /* encoding */, extra);
     const clientSubscriptionId = this._makeSubscription({
       callback: (notification, context) => {
@@ -9279,7 +9336,7 @@ class StakeProgram {
     if (custodianPubkey) {
       keys.push({
         pubkey: custodianPubkey,
-        isSigner: false,
+        isSigner: true,
         isWritable: false
       });
     }
@@ -9327,7 +9384,7 @@ class StakeProgram {
     if (custodianPubkey) {
       keys.push({
         pubkey: custodianPubkey,
-        isSigner: false,
+        isSigner: true,
         isWritable: false
       });
     }
@@ -9492,7 +9549,7 @@ class StakeProgram {
     if (custodianPubkey) {
       keys.push({
         pubkey: custodianPubkey,
-        isSigner: false,
+        isSigner: true,
         isWritable: false
       });
     }
@@ -10183,7 +10240,9 @@ function clusterApiUrl(cluster, tls) {
 /**
  * @deprecated Calling `sendAndConfirmRawTransaction()` without a `confirmationStrategy`
  * is no longer supported and will be removed in a future version.
- */ // eslint-disable-next-line no-redeclare
+ */
+// eslint-disable-next-line no-redeclare
+
 // eslint-disable-next-line no-redeclare
 async function sendAndConfirmRawTransaction(connection, rawTransaction, confirmationStrategyOrConfirmOptions, maybeConfirmOptions) {
   let confirmationStrategy;