@solana/web3.js 1.90.0 → 1.90.2

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.
      */

package/lib/index.esm.js

@@ -676,6 +676,31 @@ class CompiledKeys {
   }
 }
 
+const END_OF_BUFFER_ERROR_MESSAGE = 'Reached end of buffer unexpectedly';
+
+/**
+ * Delegates to `Array#shift`, but throws if the array is zero-length.
+ */
+function guardedShift(byteArray) {
+  if (byteArray.length === 0) {
+    throw new Error(END_OF_BUFFER_ERROR_MESSAGE);
+  }
+  return byteArray.shift();
+}
+
+/**
+ * Delegates to `Array#splice`, but throws if the section being spliced out extends past the end of
+ * the array.
+ */
+function guardedSplice(byteArray, ...args) {
+  const [start] = args;
+  if (args.length === 2 // Implies that `deleteCount` was supplied
+  ? start + (args[1] ?? 0) > byteArray.length : start >= byteArray.length) {
+    throw new Error(END_OF_BUFFER_ERROR_MESSAGE);
+  }
+  return byteArray.splice(...args);
+}
+
 /**
  * An instruction to execute by a program
  *
@@ -817,32 +842,28 @@ class Message {
   static from(buffer) {
     // Slice up wire data
     let byteArray = [...buffer];
-    const numRequiredSignatures = byteArray.shift();
+    const numRequiredSignatures = guardedShift(byteArray);
     if (numRequiredSignatures !== (numRequiredSignatures & VERSION_PREFIX_MASK)) {
       throw new Error('Versioned messages must be deserialized with VersionedMessage.deserialize()');
     }
-    const numReadonlySignedAccounts = byteArray.shift();
-    const numReadonlyUnsignedAccounts = byteArray.shift();
+    const numReadonlySignedAccounts = guardedShift(byteArray);
+    const numReadonlyUnsignedAccounts = guardedShift(byteArray);
     const accountCount = decodeLength(byteArray);
     let accountKeys = [];
     for (let i = 0; i < accountCount; i++) {
-      const account = byteArray.slice(0, PUBLIC_KEY_LENGTH);
-      byteArray = byteArray.slice(PUBLIC_KEY_LENGTH);
+      const account = guardedSplice(byteArray, 0, PUBLIC_KEY_LENGTH);
       accountKeys.push(new PublicKey(Buffer.from(account)));
     }
-    const recentBlockhash = byteArray.slice(0, PUBLIC_KEY_LENGTH);
-    byteArray = byteArray.slice(PUBLIC_KEY_LENGTH);
+    const recentBlockhash = guardedSplice(byteArray, 0, PUBLIC_KEY_LENGTH);
     const instructionCount = decodeLength(byteArray);
     let instructions = [];
     for (let i = 0; i < instructionCount; i++) {
-      const programIdIndex = byteArray.shift();
+      const programIdIndex = guardedShift(byteArray);
       const accountCount = decodeLength(byteArray);
-      const accounts = byteArray.slice(0, accountCount);
-      byteArray = byteArray.slice(accountCount);
+      const accounts = guardedSplice(byteArray, 0, accountCount);
       const dataLength = decodeLength(byteArray);
-      const dataSlice = byteArray.slice(0, dataLength);
+      const dataSlice = guardedSplice(byteArray, 0, dataLength);
       const data = bs58.encode(Buffer.from(dataSlice));
-      byteArray = byteArray.slice(dataLength);
       instructions.push({
         programIdIndex,
         accounts,
@@ -1047,30 +1068,30 @@ class MessageV0 {
   }
   static deserialize(serializedMessage) {
     let byteArray = [...serializedMessage];
-    const prefix = byteArray.shift();
+    const prefix = guardedShift(byteArray);
     const maskedPrefix = prefix & VERSION_PREFIX_MASK;
     assert(prefix !== maskedPrefix, `Expected versioned message but received legacy message`);
     const version = maskedPrefix;
     assert(version === 0, `Expected versioned message with version 0 but found version ${version}`);
     const header = {
-      numRequiredSignatures: byteArray.shift(),
-      numReadonlySignedAccounts: byteArray.shift(),
-      numReadonlyUnsignedAccounts: byteArray.shift()
+      numRequiredSignatures: guardedShift(byteArray),
+      numReadonlySignedAccounts: guardedShift(byteArray),
+      numReadonlyUnsignedAccounts: guardedShift(byteArray)
     };
     const staticAccountKeys = [];
     const staticAccountKeysLength = decodeLength(byteArray);
     for (let i = 0; i < staticAccountKeysLength; i++) {
-      staticAccountKeys.push(new PublicKey(byteArray.splice(0, PUBLIC_KEY_LENGTH)));
+      staticAccountKeys.push(new PublicKey(guardedSplice(byteArray, 0, PUBLIC_KEY_LENGTH)));
     }
-    const recentBlockhash = bs58.encode(byteArray.splice(0, PUBLIC_KEY_LENGTH));
+    const recentBlockhash = bs58.encode(guardedSplice(byteArray, 0, PUBLIC_KEY_LENGTH));
     const instructionCount = decodeLength(byteArray);
     const compiledInstructions = [];
     for (let i = 0; i < instructionCount; i++) {
-      const programIdIndex = byteArray.shift();
+      const programIdIndex = guardedShift(byteArray);
       const accountKeyIndexesLength = decodeLength(byteArray);
-      const accountKeyIndexes = byteArray.splice(0, accountKeyIndexesLength);
+      const accountKeyIndexes = guardedSplice(byteArray, 0, accountKeyIndexesLength);
       const dataLength = decodeLength(byteArray);
-      const data = new Uint8Array(byteArray.splice(0, dataLength));
+      const data = new Uint8Array(guardedSplice(byteArray, 0, dataLength));
       compiledInstructions.push({
         programIdIndex,
         accountKeyIndexes,
@@ -1080,11 +1101,11 @@ class MessageV0 {
     const addressTableLookupsCount = decodeLength(byteArray);
     const addressTableLookups = [];
     for (let i = 0; i < addressTableLookupsCount; i++) {
-      const accountKey = new PublicKey(byteArray.splice(0, PUBLIC_KEY_LENGTH));
+      const accountKey = new PublicKey(guardedSplice(byteArray, 0, PUBLIC_KEY_LENGTH));
       const writableIndexesLength = decodeLength(byteArray);
-      const writableIndexes = byteArray.splice(0, writableIndexesLength);
+      const writableIndexes = guardedSplice(byteArray, 0, writableIndexesLength);
       const readonlyIndexesLength = decodeLength(byteArray);
-      const readonlyIndexes = byteArray.splice(0, readonlyIndexesLength);
+      const readonlyIndexes = guardedSplice(byteArray, 0, readonlyIndexesLength);
       addressTableLookups.push({
         accountKey,
         writableIndexes,
@@ -1875,8 +1896,7 @@ class Transaction {
     const signatureCount = decodeLength(byteArray);
     let signatures = [];
     for (let i = 0; i < signatureCount; i++) {
-      const signature = byteArray.slice(0, SIGNATURE_LENGTH_IN_BYTES);
-      byteArray = byteArray.slice(SIGNATURE_LENGTH_IN_BYTES);
+      const signature = guardedSplice(byteArray, 0, SIGNATURE_LENGTH_IN_BYTES);
       signatures.push(bs58.encode(Buffer.from(signature)));
     }
     return Transaction.populate(Message.from(byteArray), signatures);
@@ -2051,7 +2071,7 @@ class VersionedTransaction {
     const signatures = [];
     const signaturesLength = decodeLength(byteArray);
     for (let i = 0; i < signaturesLength; i++) {
-      signatures.push(new Uint8Array(byteArray.splice(0, SIGNATURE_LENGTH_IN_BYTES)));
+      signatures.push(new Uint8Array(guardedSplice(byteArray, 0, SIGNATURE_LENGTH_IN_BYTES)));
     }
     const message = VersionedMessage.deserialize(new Uint8Array(byteArray));
     return new VersionedTransaction(message, signatures);
@@ -5791,7 +5811,7 @@ const LogsNotificationResult = type({
 
 /** @internal */
 const COMMON_HTTP_HEADERS = {
-  'solana-client': `js/${"0.0.0-development" }`
+  'solana-client': `js/${"1.90.2" }`
 };
 
 /**
@@ -10101,12 +10121,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 +10139,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 +10158,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 +10295,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;
 
@@ -10740,10 +10771,8 @@ class ValidatorInfo {
     if (configKeyCount !== 2) return null;
     const configKeys = [];
     for (let i = 0; i < 2; i++) {
-      const publicKey = new PublicKey(byteArray.slice(0, PUBLIC_KEY_LENGTH));
-      byteArray = byteArray.slice(PUBLIC_KEY_LENGTH);
-      const isSigner = byteArray.slice(0, 1)[0] === 1;
-      byteArray = byteArray.slice(1);
+      const publicKey = new PublicKey(guardedSplice(byteArray, 0, PUBLIC_KEY_LENGTH));
+      const isSigner = guardedShift(byteArray) === 1;
       configKeys.push({
         publicKey,
         isSigner