@solana/web3.js 1.32.0 → 1.34.0

package/lib/index.d.ts

@@ -535,6 +535,8 @@ declare module '@solana/web3.js' {
     skipPreflight?: boolean;
     /** preflight commitment level */
     preflightCommitment?: Commitment;
+    /** Maximum number of times for the RPC node to retry sending the transaction to the leader. */
+    maxRetries?: number;
   };
   /**
    * Options for confirming transactions
@@ -546,6 +548,8 @@ declare module '@solana/web3.js' {
     commitment?: Commitment;
     /** preflight commitment level */
     preflightCommitment?: Commitment;
+    /** Maximum number of times for the RPC node to retry sending the transaction to the leader. */
+    maxRetries?: number;
   };
   /**
    * Options for getConfirmedSignaturesForAddress2
@@ -765,8 +769,14 @@ declare module '@solana/web3.js' {
   };
   /**
    * Metadata for a parsed confirmed transaction on the ledger
+   *
+   * @deprecated Deprecated since Solana v1.8.0. Please use {@link ParsedTransactionMeta} instead.
+   */
+  export type ParsedConfirmedTransactionMeta = ParsedTransactionMeta;
+  /**
+   * Metadata for a parsed transaction on the ledger
    */
-  export type ParsedConfirmedTransactionMeta = {
+  export type ParsedTransactionMeta = {
     /** The fee charged for processing the transaction */
     fee: number;
     /** An array of cross program invoked parsed instructions */
@@ -895,14 +905,20 @@ declare module '@solana/web3.js' {
   };
   /**
    * A parsed and confirmed transaction on the ledger
+   *
+   * @deprecated Deprecated since Solana v1.8.0. Please use {@link ParsedTransactionWithMeta} instead.
    */
-  export type ParsedConfirmedTransaction = {
+  export type ParsedConfirmedTransaction = ParsedTransactionWithMeta;
+  /**
+   * A parsed transaction on the ledger with meta
+   */
+  export type ParsedTransactionWithMeta = {
     /** The slot during which the transaction was processed */
     slot: number;
     /** The details of the transaction */
     transaction: ParsedTransaction;
     /** Metadata produced from the transaction */
-    meta: ParsedConfirmedTransactionMeta | null;
+    meta: ParsedTransactionMeta | null;
     /** The unix timestamp of when the transaction was processed */
     blockTime?: number | null;
   };
@@ -968,9 +984,9 @@ declare module '@solana/web3.js' {
     blockTime: number | null;
   };
   /**
-   * A ConfirmedBlock on the ledger with signatures only
+   * A Block on the ledger with signatures only
    */
-  export type ConfirmedBlockSignatures = {
+  export type BlockSignatures = {
     /** Blockhash of this block */
     blockhash: Blockhash;
     /** Blockhash of this block's parent */
@@ -1644,6 +1660,8 @@ declare module '@solana/web3.js' {
     /**
      * Fetch a recent blockhash from the cluster, return with context
      * @return {Promise<RpcResponseAndContext<{blockhash: Blockhash, feeCalculator: FeeCalculator}>>}
+     *
+     * @deprecated Deprecated since Solana v1.8.0. Please use {@link getLatestBlockhash} instead.
      */
     getRecentBlockhashAndContext(commitment?: Commitment): Promise<
       RpcResponseAndContext<{
@@ -1658,6 +1676,8 @@ declare module '@solana/web3.js' {
     getRecentPerformanceSamples(limit?: number): Promise<Array<PerfSample>>;
     /**
      * Fetch the fee calculator for a recent blockhash from the cluster, return with context
+     *
+     * @deprecated Deprecated since Solana v1.8.0. Please use {@link getFeeForMessage} instead.
      */
     getFeeCalculatorForBlockhash(
       blockhash: Blockhash,
@@ -1673,11 +1693,31 @@ declare module '@solana/web3.js' {
     /**
      * Fetch a recent blockhash from the cluster
      * @return {Promise<{blockhash: Blockhash, feeCalculator: FeeCalculator}>}
+     *
+     * @deprecated Deprecated since Solana v1.8.0. Please use {@link getLatestBlockhash} instead.
      */
     getRecentBlockhash(commitment?: Commitment): Promise<{
       blockhash: Blockhash;
       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
      */
@@ -1696,7 +1736,7 @@ declare module '@solana/web3.js' {
       },
     ): Promise<BlockResponse | null>;
     /**
-     * Fetch a processed transaction from the cluster.
+     * Fetch a confirmed or finalized transaction from the cluster.
      */
     getTransaction(
       signature: string,
@@ -1704,6 +1744,20 @@ declare module '@solana/web3.js' {
         commitment?: Finality;
       },
     ): 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.
@@ -1722,15 +1776,26 @@ declare module '@solana/web3.js' {
       endSlot?: number,
       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 Deprecated since Solana v1.8.0. Please use {@link getBlockSignatures} instead.
      */
     getConfirmedBlockSignatures(
       slot: number,
       commitment?: Finality,
-    ): Promise<ConfirmedBlockSignatures>;
+    ): Promise<BlockSignatures>;
     /**
      * Fetch a transaction details for a confirmed transaction
+     *
+     * @deprecated Deprecated since Solana v1.8.0. Please use {@link getTransaction} instead.
      */
     getConfirmedTransaction(
       signature: TransactionSignature,
@@ -1738,6 +1803,8 @@ declare module '@solana/web3.js' {
     ): Promise<ConfirmedTransaction | null>;
     /**
      * Fetch parsed transaction details for a confirmed transaction
+     *
+     * @deprecated Deprecated since Solana v1.8.0. Please use {@link getParsedTransaction} instead.
      */
     getParsedConfirmedTransaction(
       signature: TransactionSignature,
@@ -1745,6 +1812,8 @@ declare module '@solana/web3.js' {
     ): Promise<ParsedConfirmedTransaction | null>;
     /**
      * Fetch parsed transaction details for a batch of confirmed transactions
+     *
+     * @deprecated Deprecated since Solana v1.8.0. Please use {@link getParsedTransactions} instead.
      */
     getParsedConfirmedTransactions(
       signatures: TransactionSignature[],
@@ -2879,6 +2948,147 @@ declare module '@solana/web3.js' {
     ): VoteAccount;
   }
 
+  /**
+   * Vote account info
+   */
+  export class VoteInit {
+    nodePubkey: PublicKey;
+    authorizedVoter: PublicKey;
+    authorizedWithdrawer: PublicKey;
+    commission: number; /** [0, 100] */
+    constructor(
+      nodePubkey: PublicKey,
+      authorizedVoter: PublicKey,
+      authorizedWithdrawer: PublicKey,
+      commission: number,
+    );
+  }
+  /**
+   * Create vote account transaction params
+   */
+  export type CreateVoteAccountParams = {
+    fromPubkey: PublicKey;
+    votePubkey: PublicKey;
+    voteInit: VoteInit;
+    lamports: number;
+  };
+  /**
+   * InitializeAccount instruction params
+   */
+  export type InitializeAccountParams = {
+    votePubkey: PublicKey;
+    nodePubkey: PublicKey;
+    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
+   */
+  export type WithdrawFromVoteAccountParams = {
+    votePubkey: PublicKey;
+    authorizedWithdrawerPubkey: PublicKey;
+    lamports: number;
+    toPubkey: PublicKey;
+  };
+  /**
+   * Vote Instruction class
+   */
+  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
+   */
+  export type VoteInstructionType =
+    | 'Authorize'
+    | 'InitializeAccount'
+    | 'Withdraw';
+  /**
+   * VoteAuthorize type
+   */
+  export type VoteAuthorizationType = {
+    /** The VoteAuthorize index (from solana-vote-program) */
+    index: number;
+  };
+  /**
+   * An enumeration of valid VoteAuthorization layouts.
+   */
+  export const VoteAuthorizationLayout: Readonly<{
+    Voter: {
+      index: number;
+    };
+    Withdrawer: {
+      index: number;
+    };
+  }>;
+  /**
+   * Factory class for transactions to interact with the Vote program
+   */
+  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;
+  }
+
   export const SYSVAR_CLOCK_PUBKEY: PublicKey;
   export const SYSVAR_EPOCH_SCHEDULE_PUBKEY: PublicKey;
   export const SYSVAR_INSTRUCTIONS_PUBKEY: PublicKey;