@solana/web3.js 1.32.0 → 1.34.0

package/module.flow.js

@@ -664,6 +664,11 @@ declare module "@solana/web3.js" {
      * preflight commitment level
      */
     preflightCommitment?: Commitment,
+
+    /**
+     * Maximum number of times for the RPC node to retry sending the transaction to the leader.
+     */
+    maxRetries?: number,
     ...
   };
 
@@ -685,6 +690,11 @@ declare module "@solana/web3.js" {
      * preflight commitment level
      */
     preflightCommitment?: Commitment,
+
+    /**
+     * Maximum number of times for the RPC node to retry sending the transaction to the leader.
+     */
+    maxRetries?: number,
     ...
   };
 
@@ -1036,8 +1046,14 @@ declare module "@solana/web3.js" {
 
   /**
    * Metadata for a parsed confirmed transaction on the ledger
+   * @deprecated [object Object],[object Object],[object Object]
    */
-  declare export type ParsedConfirmedTransactionMeta = {
+  declare export type ParsedConfirmedTransactionMeta = ParsedTransactionMeta;
+
+  /**
+   * Metadata for a parsed transaction on the ledger
+   */
+  declare export type ParsedTransactionMeta = {
     /**
      * The fee charged for processing the transaction
      */
@@ -1296,8 +1312,14 @@ declare module "@solana/web3.js" {
 
   /**
    * A parsed and confirmed transaction on the ledger
+   * @deprecated [object Object],[object Object],[object Object]
    */
-  declare export type ParsedConfirmedTransaction = {
+  declare export type ParsedConfirmedTransaction = ParsedTransactionWithMeta;
+
+  /**
+   * A parsed transaction on the ledger with meta
+   */
+  declare export type ParsedTransactionWithMeta = {
     /**
      * The slot during which the transaction was processed
      */
@@ -1311,7 +1333,7 @@ declare module "@solana/web3.js" {
     /**
      * Metadata produced from the transaction
      */
-    meta: ParsedConfirmedTransactionMeta | null,
+    meta: ParsedTransactionMeta | null,
 
     /**
      * The unix timestamp of when the transaction was processed
@@ -1446,9 +1468,9 @@ declare module "@solana/web3.js" {
   };
 
   /**
-   * A ConfirmedBlock on the ledger with signatures only
+   * A Block on the ledger with signatures only
    */
-  declare export type ConfirmedBlockSignatures = {
+  declare export type BlockSignatures = {
     /**
      * Blockhash of this block
      */
@@ -2419,6 +2441,7 @@ account: AccountInfo<Buffer | ParsedAccountData>,...
 blockhash: Blockhash,
 feeCalculator: FeeCalculator,...
 }>>}
+ * @deprecated [object Object],[object Object],[object Object]
  */
     getRecentBlockhashAndContext(commitment?: Commitment): Promise<
       RpcResponseAndContext<{
@@ -2436,6 +2459,7 @@ feeCalculator: FeeCalculator,...
 
     /**
      * Fetch the fee calculator for a recent blockhash from the cluster, return with context
+     * @deprecated [object Object],[object Object],[object Object]
      */
     getFeeCalculatorForBlockhash(
       blockhash: Blockhash,
@@ -2456,6 +2480,7 @@ feeCalculator: FeeCalculator,...
 blockhash: Blockhash,
 feeCalculator: FeeCalculator,...
 }>}
+ * @deprecated [object Object],[object Object],[object Object]
  */
     getRecentBlockhash(commitment?: Commitment): Promise<{
       blockhash: Blockhash,
@@ -2463,6 +2488,34 @@ feeCalculator: FeeCalculator,...
       ...
     }>;
 
+    /**
+ * Fetch the latest blockhash from the cluster
+ * @return {Promise<{
+blockhash: Blockhash,
+lastValidBlockHeight: number,...
+}>}
+ */
+    getLatestBlockhash(commitment?: Commitment): Promise<{
+      blockhash: Blockhash,
+      lastValidBlockHeight: number,
+      ...
+    }>;
+
+    /**
+ * Fetch the latest blockhash from the cluster
+ * @return {Promise<{
+blockhash: Blockhash,
+lastValidBlockHeight: number,...
+}>}
+ */
+    getLatestBlockhashAndContext(commitment?: Commitment): Promise<
+      RpcResponseAndContext<{
+        blockhash: Blockhash,
+        lastValidBlockHeight: number,
+        ...
+      }>
+    >;
+
     /**
      * Fetch the node version
      */
@@ -2485,7 +2538,7 @@ feeCalculator: FeeCalculator,...
     ): Promise<BlockResponse | null>;
 
     /**
-     * Fetch a processed transaction from the cluster.
+     * Fetch a confirmed or finalized transaction from the cluster.
      */
     getTransaction(
       signature: string,
@@ -2495,6 +2548,22 @@ feeCalculator: FeeCalculator,...
       }
     ): Promise<TransactionResponse | null>;
 
+    /**
+     * Fetch parsed transaction details for a confirmed or finalized transaction
+     */
+    getParsedTransaction(
+      signature: TransactionSignature,
+      commitment?: Finality
+    ): Promise<ParsedConfirmedTransaction | null>;
+
+    /**
+     * Fetch parsed transaction details for a batch of confirmed transactions
+     */
+    getParsedTransactions(
+      signatures: TransactionSignature[],
+      commitment?: Finality
+    ): Promise<(ParsedConfirmedTransaction | null)[]>;
+
     /**
      * Fetch a list of Transactions and transaction statuses from the cluster
      * for a confirmed block.
@@ -2514,16 +2583,26 @@ feeCalculator: FeeCalculator,...
       commitment?: Finality
     ): Promise<Array<number>>;
 
+    /**
+     * Fetch a list of Signatures from the cluster for a block, excluding rewards
+     */
+    getBlockSignatures(
+      slot: number,
+      commitment?: Finality
+    ): Promise<BlockSignatures>;
+
     /**
      * Fetch a list of Signatures from the cluster for a confirmed block, excluding rewards
+     * @deprecated [object Object],[object Object],[object Object]
      */
     getConfirmedBlockSignatures(
       slot: number,
       commitment?: Finality
-    ): Promise<ConfirmedBlockSignatures>;
+    ): Promise<BlockSignatures>;
 
     /**
      * Fetch a transaction details for a confirmed transaction
+     * @deprecated [object Object],[object Object],[object Object]
      */
     getConfirmedTransaction(
       signature: TransactionSignature,
@@ -2532,6 +2611,7 @@ feeCalculator: FeeCalculator,...
 
     /**
      * Fetch parsed transaction details for a confirmed transaction
+     * @deprecated [object Object],[object Object],[object Object]
      */
     getParsedConfirmedTransaction(
       signature: TransactionSignature,
@@ -2540,6 +2620,7 @@ feeCalculator: FeeCalculator,...
 
     /**
      * Fetch parsed transaction details for a batch of confirmed transactions
+     * @deprecated [object Object],[object Object],[object Object]
      */
     getParsedConfirmedTransactions(
       signatures: TransactionSignature[],
@@ -4001,6 +4082,177 @@ feeCalculator: FeeCalculator,...
       buffer: Buffer | Uint8Array | Array<number>
     ): VoteAccount;
   }
+
+  /**
+   * Vote account info
+   */
+  declare export class VoteInit {
+    nodePubkey: PublicKey;
+    authorizedVoter: PublicKey;
+    authorizedWithdrawer: PublicKey;
+    commission: number;
+    constructor(
+      nodePubkey: PublicKey,
+      authorizedVoter: PublicKey,
+      authorizedWithdrawer: PublicKey,
+      commission: number
+    ): this;
+  }
+
+  /**
+   * Create vote account transaction params
+   */
+  declare export type CreateVoteAccountParams = {
+    fromPubkey: PublicKey,
+    votePubkey: PublicKey,
+    voteInit: VoteInit,
+    lamports: number,
+    ...
+  };
+
+  /**
+   * InitializeAccount instruction params
+   */
+  declare export type InitializeAccountParams = {
+    votePubkey: PublicKey,
+    nodePubkey: PublicKey,
+    voteInit: VoteInit,
+    ...
+  };
+
+  /**
+   * 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
+   */
+  declare export type WithdrawFromVoteAccountParams = {
+    votePubkey: PublicKey,
+    authorizedWithdrawerPubkey: PublicKey,
+    lamports: number,
+    toPubkey: PublicKey,
+    ...
+  };
+
+  /**
+   * Vote Instruction class
+   */
+  declare export class VoteInstruction {
+    /**
+     * Decode a vote instruction and retrieve the instruction type.
+     */
+    static decodeInstructionType(
+      instruction: TransactionInstruction
+    ): VoteInstructionType;
+
+    /**
+     * Decode an initialize vote instruction and retrieve the instruction params.
+     */
+    static decodeInitializeAccount(
+      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.
+     */
+    static decodeWithdraw(
+      instruction: TransactionInstruction
+    ): WithdrawFromVoteAccountParams;
+  }
+
+  /**
+   * An enumeration of valid VoteInstructionType's
+   */
+  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
+   */
+  declare export class VoteProgram {
+    /**
+     * Public key that identifies the Vote program
+     */
+    static programId: PublicKey;
+
+    /**
+     * Max space of a Vote account
+     *
+     * This is generated from the solana-vote-program VoteState struct as
+     * `VoteState::size_of()`:
+     * https://docs.rs/solana-vote-program/1.9.5/solana_vote_program/vote_state/struct.VoteState.html#method.size_of
+     */
+    static space: number;
+
+    /**
+     * Generate an Initialize instruction.
+     */
+    static initializeAccount(
+      params: InitializeAccountParams
+    ): TransactionInstruction;
+
+    /**
+     * Generate a transaction that creates a new Vote account.
+     */
+    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.
+     */
+    static withdraw(params: WithdrawFromVoteAccountParams): Transaction;
+  }
   declare export var SYSVAR_CLOCK_PUBKEY: PublicKey;
   declare export var SYSVAR_EPOCH_SCHEDULE_PUBKEY: PublicKey;
   declare export var SYSVAR_INSTRUCTIONS_PUBKEY: PublicKey;

package/package.json

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