@solana/web3.js 1.90.0 → 1.91.0

package/lib/index.d.ts

@@ -844,8 +844,8 @@ export class StakeProgram {
      * Max space of a Stake account
      *
      * This is generated from the solana-stake-program StakeState struct as
-     * `StakeState::size_of()`:
-     * https://docs.rs/solana-stake-program/latest/solana_stake_program/stake_state/enum.StakeState.html
+     * `StakeStateV2::size_of()`:
+     * https://docs.rs/solana-stake-program/latest/solana_stake_program/stake_state/enum.StakeStateV2.html
      */
     static space: number;
     /**
@@ -880,12 +880,12 @@ export class StakeProgram {
     /**
      * Generate a Transaction that splits Stake tokens into another stake account
      */
-    static split(params: SplitStakeParams): Transaction;
+    static split(params: SplitStakeParams, rentExemptReserve: number): Transaction;
     /**
      * Generate a Transaction that splits Stake tokens into another account
      * derived from a base public key and seed
      */
-    static splitWithSeed(params: SplitStakeWithSeedParams): Transaction;
+    static splitWithSeed(params: SplitStakeWithSeedParams, rentExemptReserve?: number): Transaction;
     /**
      * Generate a Transaction that merges Stake accounts.
      */
@@ -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');
@@ -10101,12 +10101,14 @@ class StakeProgram {
   /**
    * Generate a Transaction that splits Stake tokens into another stake account
    */
-  static split(params) {
+  static split(params,
+  // Compute the cost of allocating the new stake account in lamports
+  rentExemptReserve) {
     const transaction = new Transaction();
     transaction.add(SystemProgram.createAccount({
       fromPubkey: params.authorizedPubkey,
       newAccountPubkey: params.splitStakePubkey,
-      lamports: 0,
+      lamports: rentExemptReserve,
       space: this.space,
       programId: this.programId
     }));
@@ -10117,7 +10119,9 @@ class StakeProgram {
    * Generate a Transaction that splits Stake tokens into another account
    * derived from a base public key and seed
    */
-  static splitWithSeed(params) {
+  static splitWithSeed(params,
+  // If this stake account is new, compute the cost of allocating it in lamports
+  rentExemptReserve) {
     const {
       stakePubkey,
       authorizedPubkey,
@@ -10134,6 +10138,13 @@ class StakeProgram {
       space: this.space,
       programId: this.programId
     }));
+    if (rentExemptReserve && rentExemptReserve > 0) {
+      transaction.add(SystemProgram.transfer({
+        fromPubkey: params.authorizedPubkey,
+        toPubkey: splitStakePubkey,
+        lamports: rentExemptReserve
+      }));
+    }
     return transaction.add(this.splitInstruction({
       stakePubkey,
       authorizedPubkey,
@@ -10264,8 +10275,8 @@ StakeProgram.programId = new PublicKey('Stake11111111111111111111111111111111111
  * Max space of a Stake account
  *
  * This is generated from the solana-stake-program StakeState struct as
- * `StakeState::size_of()`:
- * https://docs.rs/solana-stake-program/latest/solana_stake_program/stake_state/enum.StakeState.html
+ * `StakeStateV2::size_of()`:
+ * https://docs.rs/solana-stake-program/latest/solana_stake_program/stake_state/enum.StakeStateV2.html
  */
 StakeProgram.space = 200;
 
@@ -10307,6 +10318,10 @@ class VoteInit {
  * Withdraw from vote account transaction params
  */
 
+/**
+ * Update validator identity (node pubkey) vote account instruction params.
+ */
+
 /**
  * Vote Instruction class
  */
@@ -10453,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()])
@@ -10670,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');
 /**
@@ -10685,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');