@solana/web3.js 1.3.1 → 1.4.1

package/lib/index.d.ts

@@ -840,6 +840,57 @@ declare module '@solana/web3.js' {
     /** stake inactive during the epoch */
     inactive: number;
   };
+  /**
+   * Data slice argument for getProgramAccounts
+   */
+  export type DataSlice = {
+    /** offset of data slice */
+    offset: number;
+    /** length of data slice */
+    length: number;
+  };
+  /**
+   * Memory comparison filter for getProgramAccounts
+   */
+  export type MemcmpFilter = {
+    memcmp: {
+      /** offset into program account data to start comparison */
+      offset: number;
+      /** data to match, as base-58 encoded string and limited to less than 129 bytes */
+      bytes: string;
+    };
+  };
+  /**
+   * Data size comparison filter for getProgramAccounts
+   */
+  export type DataSizeFilter = {
+    /** Size of data for program account data length comparison */
+    dataSize: number;
+  };
+  /**
+   * A filter object for getProgramAccounts
+   */
+  export type GetProgramAccountsFilter = MemcmpFilter | DataSizeFilter;
+  /**
+   * Configuration object for getProgramAccounts requests
+   */
+  export type GetProgramAccountsConfig = {
+    /** Optional commitment level */
+    commitment?: Commitment;
+    /** Optional encoding for account data (default base64) */
+    encoding?: 'base64' | 'jsonParsed';
+    /** Optional data slice to limit the returned account data */
+    dataSlice?: DataSlice;
+    /** Optional array of filters to apply to accounts */
+    filters?: GetProgramAccountsFilter[];
+  };
+  /**
+   * Configuration object for getParsedProgramAccounts
+   */
+  export type GetParsedProgramAccountsConfig = Exclude<
+    GetProgramAccountsConfig,
+    'encoding' | 'dataSlice'
+  >;
   /**
    * Information describing an account
    */
@@ -1125,7 +1176,7 @@ declare module '@solana/web3.js' {
      */
     getProgramAccounts(
       programId: PublicKey,
-      commitment?: Commitment,
+      configOrCommitment?: GetProgramAccountsConfig | Commitment,
     ): Promise<
       Array<{
         pubkey: PublicKey;
@@ -1139,7 +1190,7 @@ declare module '@solana/web3.js' {
      */
     getParsedProgramAccounts(
       programId: PublicKey,
-      commitment?: Commitment,
+      configOrCommitment?: GetParsedProgramAccountsConfig | Commitment,
     ): Promise<
       Array<{
         pubkey: PublicKey;

package/lib/index.esm.js

@@ -3505,8 +3505,29 @@ class Connection {
    */
 
 
-  async getProgramAccounts(programId, commitment) {
-    const args = this._buildArgs([programId.toBase58()], commitment, 'base64');
+  async getProgramAccounts(programId, configOrCommitment) {
+    const extra = {};
+    let commitment;
+    let encoding;
+
+    if (configOrCommitment) {
+      if (typeof configOrCommitment === 'string') {
+        commitment = configOrCommitment;
+      } else {
+        commitment = configOrCommitment.commitment;
+        encoding = configOrCommitment.encoding;
+
+        if (configOrCommitment.dataSlice) {
+          extra.dataSlice = configOrCommitment.dataSlice;
+        }
+
+        if (configOrCommitment.filters) {
+          extra.filters = configOrCommitment.filters;
+        }
+      }
+    }
+
+    const args = this._buildArgs([programId.toBase58()], commitment, encoding || 'base64', extra);
 
     const unsafeRes = await this._rpcRequest('getProgramAccounts', args);
     const res = create(unsafeRes, jsonRpcResult(array(KeyedAccountInfoResult)));
@@ -3524,8 +3545,23 @@ class Connection {
    */
 
 
-  async getParsedProgramAccounts(programId, commitment) {
-    const args = this._buildArgs([programId.toBase58()], commitment, 'jsonParsed');
+  async getParsedProgramAccounts(programId, configOrCommitment) {
+    const extra = {};
+    let commitment;
+
+    if (configOrCommitment) {
+      if (typeof configOrCommitment === 'string') {
+        commitment = configOrCommitment;
+      } else {
+        commitment = configOrCommitment.commitment;
+
+        if (configOrCommitment.filters) {
+          extra.filters = configOrCommitment.filters;
+        }
+      }
+    }
+
+    const args = this._buildArgs([programId.toBase58()], commitment, 'jsonParsed', extra);
 
     const unsafeRes = await this._rpcRequest('getProgramAccounts', args);
     const res = create(unsafeRes, jsonRpcResult(array(KeyedParsedAccountInfoResult)));