@solana/web3.js 1.57.0 → 1.59.1

package/lib/index.d.ts

@@ -352,12 +352,17 @@ declare module '@solana/web3.js' {
     /** The message header, identifying signed and read-only `accountKeys` */
     header: MessageHeader;
     /** All the account keys used by this transaction */
-    accountKeys: string[];
+    accountKeys: string[] | PublicKey[];
     /** The hash of a recent ledger block */
     recentBlockhash: Blockhash;
     /** Instructions that will be executed in sequence and committed in one atomic transaction if all succeed. */
     instructions: CompiledInstruction[];
   };
+  export type CompileLegacyArgs = {
+    payerKey: PublicKey;
+    instructions: Array<TransactionInstruction>;
+    recentBlockhash: Blockhash;
+  };
   /**
    * List of instructions to be processed atomically
    */
@@ -372,6 +377,8 @@ declare module '@solana/web3.js' {
     get staticAccountKeys(): Array<PublicKey>;
     get compiledInstructions(): Array<MessageCompiledInstruction>;
     get addressTableLookups(): Array<MessageAddressTableLookup>;
+    getAccountKeys(): MessageAccountKeys;
+    static compile(args: CompileLegacyArgs): Message;
     isAccountSigner(index: number): boolean;
     isAccountWritable(index: number): boolean;
     isProgramId(index: number): boolean;
@@ -1395,6 +1402,17 @@ declare module '@solana/web3.js' {
     newAuthorizedPubkey: PublicKey;
     voteAuthorizationType: VoteAuthorizationType;
   };
+  /**
+   * AuthorizeWithSeed instruction params
+   */
+  export type AuthorizeVoteWithSeedParams = {
+    currentAuthorityDerivedKeyBasePubkey: PublicKey;
+    currentAuthorityDerivedKeyOwnerPubkey: PublicKey;
+    currentAuthorityDerivedKeySeed: string;
+    newAuthorizedPubkey: PublicKey;
+    voteAuthorizationType: VoteAuthorizationType;
+    votePubkey: PublicKey;
+  };
   /**
    * Withdraw from vote account transaction params
    */
@@ -1426,6 +1444,12 @@ declare module '@solana/web3.js' {
     static decodeAuthorize(
       instruction: TransactionInstruction,
     ): AuthorizeVoteParams;
+    /**
+     * Decode an authorize instruction and retrieve the instruction params.
+     */
+    static decodeAuthorizeWithSeed(
+      instruction: TransactionInstruction,
+    ): AuthorizeVoteWithSeedParams;
     /**
      * Decode a withdraw instruction and retrieve the instruction params.
      */
@@ -1438,6 +1462,7 @@ declare module '@solana/web3.js' {
    */
   export type VoteInstructionType =
     | 'Authorize'
+    | 'AuthorizeWithSeed'
     | 'InitializeAccount'
     | 'Withdraw';
   /**
@@ -1488,6 +1513,11 @@ declare module '@solana/web3.js' {
      * Generate a transaction that authorizes a new Voter or Withdrawer on the Vote account.
      */
     static authorize(params: AuthorizeVoteParams): Transaction;
+    /**
+     * Generate a transaction that authorizes a new Voter or Withdrawer on the Vote account
+     * where the current Voter or Withdrawer authority is a derived key.
+     */
+    static authorizeWithSeed(params: AuthorizeVoteWithSeedParams): Transaction;
     /**
      * Generate a transaction to withdraw from a Vote account.
      */
@@ -1528,6 +1558,13 @@ declare module '@solana/web3.js' {
     recentBlockhash: Blockhash;
     addressLookupTableAccounts?: Array<AddressLookupTableAccount>;
   };
+  export type GetAccountKeysArgs =
+    | {
+        accountKeysFromLookups: AccountKeysFromLookups;
+      }
+    | {
+        addressLookupTableAccounts: AddressLookupTableAccount[];
+      };
   export class MessageV0 {
     header: MessageHeader;
     staticAccountKeys: Array<PublicKey>;
@@ -1536,6 +1573,11 @@ declare module '@solana/web3.js' {
     addressTableLookups: Array<MessageAddressTableLookup>;
     constructor(args: MessageV0Args);
     get version(): 0;
+    get numAccountKeysFromLookups(): number;
+    getAccountKeys(args?: GetAccountKeysArgs): MessageAccountKeys;
+    resolveAddressTableLookups(
+      addressLookupTableAccounts: AddressLookupTableAccount[],
+    ): AccountKeysFromLookups;
     static compile(args: CompileV0Args): MessageV0;
     serialize(): Uint8Array;
     private serializeInstructions;
@@ -1804,6 +1846,33 @@ declare module '@solana/web3.js' {
     static populate(message: Message, signatures?: Array<string>): Transaction;
   }
 
+  export type TransactionMessageArgs = {
+    payerKey: PublicKey;
+    instructions: Array<TransactionInstruction>;
+    recentBlockhash: Blockhash;
+  };
+  export type DecompileArgs =
+    | {
+        accountKeysFromLookups: AccountKeysFromLookups;
+      }
+    | {
+        addressLookupTableAccounts: AddressLookupTableAccount[];
+      };
+  export class TransactionMessage {
+    payerKey: PublicKey;
+    instructions: Array<TransactionInstruction>;
+    recentBlockhash: Blockhash;
+    constructor(args: TransactionMessageArgs);
+    static decompile(
+      message: VersionedMessage,
+      args?: DecompileArgs,
+    ): TransactionMessage;
+    compileToLegacyMessage(): Message;
+    compileToV0Message(
+      addressLookupTableAccounts?: AddressLookupTableAccount[],
+    ): MessageV0;
+  }
+
   export type TransactionVersion = 'legacy' | 0;
   /**
    * Versioned transaction class
@@ -2190,6 +2259,21 @@ declare module '@solana/web3.js' {
     programId: string;
     data: [string, TransactionReturnDataEncoding];
   };
+  export type SimulateTransactionConfig = {
+    /** Optional parameter used to enable signature verification before simulation */
+    sigVerify?: boolean;
+    /** Optional parameter used to replace the simulated transaction's recent blockhash with the latest blockhash */
+    replaceRecentBlockhash?: boolean;
+    /** Optional parameter used to set the commitment level when selecting the latest block */
+    commitment?: Commitment;
+    /** Optional parameter used to specify a list of account addresses to return post simulation state for */
+    accounts?: {
+      encoding: 'base64';
+      addresses: string[];
+    };
+    /** Optional parameter used to specify the minimum block slot that can be used for simulation */
+    minContextSlot?: number;
+  };
   export type SimulatedTransactionResponse = {
     err: TransactionError | string | null;
     logs: Array<string> | null;
@@ -3568,20 +3652,40 @@ declare module '@solana/web3.js' {
     ): Promise<RpcResponseAndContext<number>>;
     /**
      * Simulate a transaction
+     *
+     * @deprecated Instead, call {@link simulateTransaction} with {@link
+     * VersionedTransaction} and {@link SimulateTransactionConfig} parameters
      */
     simulateTransaction(
       transactionOrMessage: Transaction | Message,
       signers?: Array<Signer>,
       includeAccounts?: boolean | Array<PublicKey>,
     ): Promise<RpcResponseAndContext<SimulatedTransactionResponse>>;
+    /**
+     * Simulate a transaction
+     */
+    simulateTransaction(
+      transaction: VersionedTransaction,
+      config?: SimulateTransactionConfig,
+    ): Promise<RpcResponseAndContext<SimulatedTransactionResponse>>;
     /**
      * Sign and send a transaction
+     *
+     * @deprecated Instead, call {@link sendTransaction} with a {@link
+     * VersionedTransaction}
      */
     sendTransaction(
       transaction: Transaction,
       signers: Array<Signer>,
       options?: SendOptions,
     ): Promise<TransactionSignature>;
+    /**
+     * Send a signed transaction
+     */
+    sendTransaction(
+      transaction: VersionedTransaction,
+      options?: SendOptions,
+    ): Promise<TransactionSignature>;
     /**
      * Send a transaction that has already been signed and serialized into the
      * wire format