@solana/web3.js 1.90.1 → 1.91.0

package/lib/index.d.ts

@@ -1274,6 +1274,14 @@ type WithdrawFromVoteAccountParams = {
     lamports: number;
     toPubkey: PublicKey;
 };
+/**
+ * Update validator identity (node pubkey) vote account instruction params.
+ */
+type UpdateValidatorIdentityParams = {
+    votePubkey: PublicKey;
+    authorizedWithdrawerPubkey: PublicKey;
+    nodePubkey: PublicKey;
+};
 /**
  * Vote Instruction class
  */
@@ -1302,7 +1310,7 @@ export class VoteInstruction {
 /**
  * An enumeration of valid VoteInstructionType's
  */
-type VoteInstructionType = 'Authorize' | 'AuthorizeWithSeed' | 'InitializeAccount' | 'Withdraw';
+type VoteInstructionType = 'Authorize' | 'AuthorizeWithSeed' | 'InitializeAccount' | 'Withdraw' | 'UpdateValidatorIdentity';
 /**
  * VoteAuthorize type
  */
@@ -1369,6 +1377,10 @@ export class VoteProgram {
      * `withdraw` method directly.
      */
     static safeWithdraw(params: WithdrawFromVoteAccountParams, currentVoteAccountBalance: number, rentExemptMinimum: number): Transaction;
+    /**
+     * Generate a transaction to update the validator identity (node pubkey) of a Vote account.
+     */
+    static updateValidatorIdentity(params: UpdateValidatorIdentityParams): Transaction;
 }
 
 /**
@@ -3611,7 +3623,7 @@ export class Connection {
     /**
      * Deregister an account notification callback
      *
-     * @param id client subscription id to deregister
+     * @param clientSubscriptionId client subscription id to deregister
      */
     removeAccountChangeListener(clientSubscriptionId: ClientSubscriptionId): Promise<void>;
     /**
@@ -3628,7 +3640,7 @@ export class Connection {
     /**
      * Deregister an account notification callback
      *
-     * @param id client subscription id to deregister
+     * @param clientSubscriptionId client subscription id to deregister
      */
     removeProgramAccountChangeListener(clientSubscriptionId: ClientSubscriptionId): Promise<void>;
     /**
@@ -3638,7 +3650,7 @@ export class Connection {
     /**
      * Deregister a logs callback.
      *
-     * @param id client subscription id to deregister.
+     * @param clientSubscriptionId client subscription id to deregister.
      */
     removeOnLogsListener(clientSubscriptionId: ClientSubscriptionId): Promise<void>;
     /**
@@ -3651,7 +3663,7 @@ export class Connection {
     /**
      * Deregister a slot notification callback
      *
-     * @param id client subscription id to deregister
+     * @param clientSubscriptionId client subscription id to deregister
      */
     removeSlotChangeListener(clientSubscriptionId: ClientSubscriptionId): Promise<void>;
     /**
@@ -3665,7 +3677,7 @@ export class Connection {
     /**
      * Deregister a slot update notification callback
      *
-     * @param id client subscription id to deregister
+     * @param clientSubscriptionId client subscription id to deregister
      */
     removeSlotUpdateListener(clientSubscriptionId: ClientSubscriptionId): Promise<void>;
     _buildArgs(args: Array<any>, override?: Commitment, encoding?: 'jsonParsed' | 'base64', extra?: any): Array<any>;
@@ -3692,7 +3704,7 @@ export class Connection {
     /**
      * Deregister a signature notification callback
      *
-     * @param id client subscription id to deregister
+     * @param clientSubscriptionId client subscription id to deregister
      */
     removeSignatureListener(clientSubscriptionId: ClientSubscriptionId): Promise<void>;
     /**
@@ -3705,7 +3717,7 @@ export class Connection {
     /**
      * Deregister a root notification callback
      *
-     * @param id client subscription id to deregister
+     * @param clientSubscriptionId client subscription id to deregister
      */
     removeRootChangeListener(clientSubscriptionId: ClientSubscriptionId): Promise<void>;
 }

package/lib/index.esm.js

@@ -8366,7 +8366,7 @@ class Connection {
   /**
    * Deregister an account notification callback
    *
-   * @param id client subscription id to deregister
+   * @param clientSubscriptionId client subscription id to deregister
    */
   async removeAccountChangeListener(clientSubscriptionId) {
     await this._unsubscribeClientSubscription(clientSubscriptionId, 'account change');
@@ -8412,7 +8412,7 @@ class Connection {
   /**
    * Deregister an account notification callback
    *
-   * @param id client subscription id to deregister
+   * @param clientSubscriptionId client subscription id to deregister
    */
   async removeProgramAccountChangeListener(clientSubscriptionId) {
     await this._unsubscribeClientSubscription(clientSubscriptionId, 'program account change');
@@ -8436,7 +8436,7 @@ class Connection {
   /**
    * Deregister a logs callback.
    *
-   * @param id client subscription id to deregister.
+   * @param clientSubscriptionId client subscription id to deregister.
    */
   async removeOnLogsListener(clientSubscriptionId) {
     await this._unsubscribeClientSubscription(clientSubscriptionId, 'logs');
@@ -8481,7 +8481,7 @@ class Connection {
   /**
    * Deregister a slot notification callback
    *
-   * @param id client subscription id to deregister
+   * @param clientSubscriptionId client subscription id to deregister
    */
   async removeSlotChangeListener(clientSubscriptionId) {
     await this._unsubscribeClientSubscription(clientSubscriptionId, 'slot change');
@@ -8516,7 +8516,7 @@ class Connection {
   /**
    * Deregister a slot update notification callback
    *
-   * @param id client subscription id to deregister
+   * @param clientSubscriptionId client subscription id to deregister
    */
   async removeSlotUpdateListener(clientSubscriptionId) {
     await this._unsubscribeClientSubscription(clientSubscriptionId, 'slot update');
@@ -8666,7 +8666,7 @@ class Connection {
   /**
    * Deregister a signature notification callback
    *
-   * @param id client subscription id to deregister
+   * @param clientSubscriptionId client subscription id to deregister
    */
   async removeSignatureListener(clientSubscriptionId) {
     await this._unsubscribeClientSubscription(clientSubscriptionId, 'signature result');
@@ -8700,7 +8700,7 @@ class Connection {
   /**
    * Deregister a root notification callback
    *
-   * @param id client subscription id to deregister
+   * @param clientSubscriptionId client subscription id to deregister
    */
   async removeRootChangeListener(clientSubscriptionId) {
     await this._unsubscribeClientSubscription(clientSubscriptionId, 'root change');
@@ -10318,6 +10318,10 @@ class VoteInit {
  * Withdraw from vote account transaction params
  */
 
+/**
+ * Update validator identity (node pubkey) vote account instruction params.
+ */
+
 /**
  * Vote Instruction class
  */
@@ -10464,6 +10468,10 @@ const VOTE_INSTRUCTION_LAYOUTS = Object.freeze({
     index: 3,
     layout: BufferLayout.struct([BufferLayout.u32('instruction'), BufferLayout.ns64('lamports')])
   },
+  UpdateValidatorIdentity: {
+    index: 4,
+    layout: BufferLayout.struct([BufferLayout.u32('instruction')])
+  },
   AuthorizeWithSeed: {
     index: 10,
     layout: BufferLayout.struct([BufferLayout.u32('instruction'), voteAuthorizeWithSeedArgs()])
@@ -10681,10 +10689,41 @@ class VoteProgram {
    */
   static safeWithdraw(params, currentVoteAccountBalance, rentExemptMinimum) {
     if (params.lamports > currentVoteAccountBalance - rentExemptMinimum) {
-      throw new Error('Withdraw will leave vote account with insuffcient funds.');
+      throw new Error('Withdraw will leave vote account with insufficient funds.');
     }
     return VoteProgram.withdraw(params);
   }
+
+  /**
+   * Generate a transaction to update the validator identity (node pubkey) of a Vote account.
+   */
+  static updateValidatorIdentity(params) {
+    const {
+      votePubkey,
+      authorizedWithdrawerPubkey,
+      nodePubkey
+    } = params;
+    const type = VOTE_INSTRUCTION_LAYOUTS.UpdateValidatorIdentity;
+    const data = encodeData(type);
+    const keys = [{
+      pubkey: votePubkey,
+      isSigner: false,
+      isWritable: true
+    }, {
+      pubkey: nodePubkey,
+      isSigner: true,
+      isWritable: false
+    }, {
+      pubkey: authorizedWithdrawerPubkey,
+      isSigner: true,
+      isWritable: false
+    }];
+    return new Transaction().add({
+      keys,
+      programId: this.programId,
+      data
+    });
+  }
 }
 VoteProgram.programId = new PublicKey('Vote111111111111111111111111111111111111111');
 /**
@@ -10696,7 +10735,7 @@ VoteProgram.programId = new PublicKey('Vote1111111111111111111111111111111111111
  *
  * KEEP IN SYNC WITH `VoteState::size_of()` in https://github.com/solana-labs/solana/blob/a474cb24b9238f5edcc982f65c0b37d4a1046f7e/sdk/program/src/vote/state/mod.rs#L340-L342
  */
-VoteProgram.space = 3731;
+VoteProgram.space = 3762;
 
 const VALIDATOR_INFO_KEY = new PublicKey('Va1idator1nfo111111111111111111111111111111');