@solana/web3.js 1.33.0 → 1.34.0

package/module.flow.js

@@ -4120,6 +4120,21 @@ lastValidBlockHeight: number,...
     ...
   };
 
+  /**
+   * Authorize instruction params
+   */
+  declare export type AuthorizeVoteParams = {
+    votePubkey: PublicKey,
+
+    /**
+     * Current vote or withdraw authority, depending on `voteAuthorizationType`
+     */
+    authorizedPubkey: PublicKey,
+    newAuthorizedPubkey: PublicKey,
+    voteAuthorizationType: VoteAuthorizationType,
+    ...
+  };
+
   /**
    * Withdraw from vote account transaction params
    */
@@ -4149,6 +4164,13 @@ lastValidBlockHeight: number,...
       instruction: TransactionInstruction
     ): InitializeAccountParams;
 
+    /**
+     * Decode an authorize instruction and retrieve the instruction params.
+     */
+    static decodeAuthorize(
+      instruction: TransactionInstruction
+    ): AuthorizeVoteParams;
+
     /**
      * Decode a withdraw instruction and retrieve the instruction params.
      */
@@ -4160,7 +4182,36 @@ lastValidBlockHeight: number,...
   /**
    * An enumeration of valid VoteInstructionType's
    */
-  declare export type VoteInstructionType = "InitializeAccount" | "Withdraw";
+  declare export type VoteInstructionType =
+    | "Authorize"
+    | "InitializeAccount"
+    | "Withdraw";
+
+  /**
+   * VoteAuthorize type
+   */
+  declare export type VoteAuthorizationType = {
+    /**
+     * The VoteAuthorize index (from solana-vote-program)
+     */
+    index: number,
+    ...
+  };
+
+  /**
+   * An enumeration of valid VoteAuthorization layouts.
+   */
+  declare export var VoteAuthorizationLayout: $ReadOnly<{
+    Voter: {
+      index: number,
+      ...
+    },
+    Withdrawer: {
+      index: number,
+      ...
+    },
+    ...
+  }>;
 
   /**
    * Factory class for transactions to interact with the Vote program
@@ -4192,6 +4243,11 @@ lastValidBlockHeight: number,...
      */
     static createAccount(params: CreateVoteAccountParams): Transaction;
 
+    /**
+     * Generate a transaction that authorizes a new Voter or Withdrawer on the Vote account.
+     */
+    static authorize(params: AuthorizeVoteParams): Transaction;
+
     /**
      * Generate a transaction to withdraw from a Vote account.
      */

package/package.json

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

package/src/vote-program.ts

@@ -49,6 +49,17 @@ export type InitializeAccountParams = {
   voteInit: VoteInit;
 };
 
+/**
+ * Authorize instruction params
+ */
+export type AuthorizeVoteParams = {
+  votePubkey: PublicKey;
+  /** Current vote or withdraw authority, depending on `voteAuthorizationType` */
+  authorizedPubkey: PublicKey;
+  newAuthorizedPubkey: PublicKey;
+  voteAuthorizationType: VoteAuthorizationType;
+};
+
 /**
  * Withdraw from vote account transaction params
  */
@@ -120,6 +131,30 @@ export class VoteInstruction {
     };
   }
 
+  /**
+   * Decode an authorize instruction and retrieve the instruction params.
+   */
+  static decodeAuthorize(
+    instruction: TransactionInstruction,
+  ): AuthorizeVoteParams {
+    this.checkProgramId(instruction.programId);
+    this.checkKeyLength(instruction.keys, 3);
+
+    const {newAuthorized, voteAuthorizationType} = decodeData(
+      VOTE_INSTRUCTION_LAYOUTS.Authorize,
+      instruction.data,
+    );
+
+    return {
+      votePubkey: instruction.keys[0].pubkey,
+      authorizedPubkey: instruction.keys[2].pubkey,
+      newAuthorizedPubkey: new PublicKey(newAuthorized),
+      voteAuthorizationType: {
+        index: voteAuthorizationType,
+      },
+    };
+  }
+
   /**
    * Decode a withdraw instruction and retrieve the instruction params.
    */
@@ -166,7 +201,10 @@ export class VoteInstruction {
 /**
  * An enumeration of valid VoteInstructionType's
  */
-export type VoteInstructionType = 'InitializeAccount' | 'Withdraw';
+export type VoteInstructionType =
+  | 'Authorize'
+  | 'InitializeAccount'
+  | 'Withdraw';
 
 const VOTE_INSTRUCTION_LAYOUTS: {
   [type in VoteInstructionType]: InstructionType;
@@ -178,6 +216,14 @@ const VOTE_INSTRUCTION_LAYOUTS: {
       Layout.voteInit(),
     ]),
   },
+  Authorize: {
+    index: 1,
+    layout: BufferLayout.struct([
+      BufferLayout.u32('instruction'),
+      Layout.publicKey('newAuthorized'),
+      BufferLayout.u32('voteAuthorizationType'),
+    ]),
+  },
   Withdraw: {
     index: 3,
     layout: BufferLayout.struct([
@@ -187,6 +233,26 @@ const VOTE_INSTRUCTION_LAYOUTS: {
   },
 });
 
+/**
+ * VoteAuthorize type
+ */
+export type VoteAuthorizationType = {
+  /** The VoteAuthorize index (from solana-vote-program) */
+  index: number;
+};
+
+/**
+ * An enumeration of valid VoteAuthorization layouts.
+ */
+export const VoteAuthorizationLayout = Object.freeze({
+  Voter: {
+    index: 0,
+  },
+  Withdrawer: {
+    index: 1,
+  },
+});
+
 /**
  * Factory class for transactions to interact with the Vote program
  */
@@ -267,6 +333,36 @@ export class VoteProgram {
     );
   }
 
+  /**
+   * Generate a transaction that authorizes a new Voter or Withdrawer on the Vote account.
+   */
+  static authorize(params: AuthorizeVoteParams): Transaction {
+    const {
+      votePubkey,
+      authorizedPubkey,
+      newAuthorizedPubkey,
+      voteAuthorizationType,
+    } = params;
+
+    const type = VOTE_INSTRUCTION_LAYOUTS.Authorize;
+    const data = encodeData(type, {
+      newAuthorized: toBuffer(newAuthorizedPubkey.toBuffer()),
+      voteAuthorizationType: voteAuthorizationType.index,
+    });
+
+    const keys = [
+      {pubkey: votePubkey, isSigner: false, isWritable: true},
+      {pubkey: SYSVAR_CLOCK_PUBKEY, isSigner: false, isWritable: false},
+      {pubkey: authorizedPubkey, isSigner: true, isWritable: false},
+    ];
+
+    return new Transaction().add({
+      keys,
+      programId: this.programId,
+      data,
+    });
+  }
+
   /**
    * Generate a transaction to withdraw from a Vote account.
    */