@solana/web3.js 1.90.1 → 1.91.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solana/web3.js",
-  "version": "1.90.1",
+  "version": "1.91.0",
   "description": "Solana Javascript API",
   "keywords": [
     "api",

package/src/connection.ts

@@ -6355,7 +6355,7 @@ export class Connection {
   /**
    * Deregister an account notification callback
    *
-   * @param id client subscription id to deregister
+   * @param clientSubscriptionId client subscription id to deregister
    */
   async removeAccountChangeListener(
     clientSubscriptionId: ClientSubscriptionId,
@@ -6418,7 +6418,7 @@ export class Connection {
   /**
    * Deregister an account notification callback
    *
-   * @param id client subscription id to deregister
+   * @param clientSubscriptionId client subscription id to deregister
    */
   async removeProgramAccountChangeListener(
     clientSubscriptionId: ClientSubscriptionId,
@@ -6454,7 +6454,7 @@ export class Connection {
   /**
    * Deregister a logs callback.
    *
-   * @param id client subscription id to deregister.
+   * @param clientSubscriptionId client subscription id to deregister.
    */
   async removeOnLogsListener(
     clientSubscriptionId: ClientSubscriptionId,
@@ -6501,7 +6501,7 @@ export class Connection {
   /**
    * Deregister a slot notification callback
    *
-   * @param id client subscription id to deregister
+   * @param clientSubscriptionId client subscription id to deregister
    */
   async removeSlotChangeListener(
     clientSubscriptionId: ClientSubscriptionId,
@@ -6544,7 +6544,7 @@ export 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: ClientSubscriptionId,
@@ -6743,7 +6743,7 @@ export class Connection {
   /**
    * Deregister a signature notification callback
    *
-   * @param id client subscription id to deregister
+   * @param clientSubscriptionId client subscription id to deregister
    */
   async removeSignatureListener(
     clientSubscriptionId: ClientSubscriptionId,
@@ -6782,7 +6782,7 @@ export class Connection {
   /**
    * Deregister a root notification callback
    *
-   * @param id client subscription id to deregister
+   * @param clientSubscriptionId client subscription id to deregister
    */
   async removeRootChangeListener(
     clientSubscriptionId: ClientSubscriptionId,

package/src/programs/vote.ts

@@ -87,6 +87,15 @@ export type WithdrawFromVoteAccountParams = {
   toPubkey: PublicKey;
 };
 
+/**
+ * Update validator identity (node pubkey) vote account instruction params.
+ */
+export type UpdateValidatorIdentityParams = {
+  votePubkey: PublicKey;
+  authorizedWithdrawerPubkey: PublicKey;
+  nodePubkey: PublicKey;
+};
+
 /**
  * Vote Instruction class
  */
@@ -258,7 +267,11 @@ export type VoteInstructionType =
   // It would be preferable for this type to be `keyof VoteInstructionInputData`
   // but Typedoc does not transpile `keyof` expressions.
   // See https://github.com/TypeStrong/typedoc/issues/1894
-  'Authorize' | 'AuthorizeWithSeed' | 'InitializeAccount' | 'Withdraw';
+  | 'Authorize'
+  | 'AuthorizeWithSeed'
+  | 'InitializeAccount'
+  | 'Withdraw'
+  | 'UpdateValidatorIdentity';
 
 /** @internal */
 export type VoteAuthorizeWithSeedArgs = Readonly<{
@@ -286,6 +299,7 @@ type VoteInstructionInputData = {
   Withdraw: IInstructionInputData & {
     lamports: number;
   };
+  UpdateValidatorIdentity: IInstructionInputData;
 };
 
 const VOTE_INSTRUCTION_LAYOUTS = Object.freeze<{
@@ -315,6 +329,12 @@ const VOTE_INSTRUCTION_LAYOUTS = Object.freeze<{
       BufferLayout.ns64('lamports'),
     ]),
   },
+  UpdateValidatorIdentity: {
+    index: 4,
+    layout: BufferLayout.struct<
+      VoteInstructionInputData['UpdateValidatorIdentity']
+    >([BufferLayout.u32('instruction')]),
+  },
   AuthorizeWithSeed: {
     index: 10,
     layout: BufferLayout.struct<VoteInstructionInputData['AuthorizeWithSeed']>([
@@ -369,7 +389,7 @@ export class VoteProgram {
    *
    * 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
    */
-  static space: number = process.env.TEST_LIVE ? 3762 : 3731;
+  static space: number = 3762;
 
   /**
    * Generate an Initialize instruction.
@@ -535,9 +555,32 @@ export class VoteProgram {
   ): Transaction {
     if (params.lamports > currentVoteAccountBalance - rentExemptMinimum) {
       throw new Error(
-        'Withdraw will leave vote account with insuffcient funds.',
+        '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: UpdateValidatorIdentityParams,
+  ): Transaction {
+    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,
+    });
+  }
 }