@solana/web3.js 1.18.1 → 1.19.1

package/lib/index.d.ts

@@ -545,6 +545,20 @@ declare module '@solana/web3.js' {
     /** Maximum transaction signatures to return (between 1 and 1,000, default: 1,000). */
     limit?: number;
   };
+  /**
+   * Options for getSignaturesForAddress
+   */
+  export type SignaturesForAddressOptions = {
+    /**
+     * Start searching backwards from this transaction signature.
+     * @remark If not provided the search starts from the highest max confirmed block.
+     */
+    before?: TransactionSignature;
+    /** Search until this transaction signature is reached, if found before `limit`. */
+    until?: TransactionSignature;
+    /** Maximum transaction signatures to return (between 1 and 1,000, default: 1,000). */
+    limit?: number;
+  };
   /**
    * RPC Response with extra contextual information
    */
@@ -1681,6 +1695,19 @@ declare module '@solana/web3.js' {
       options?: ConfirmedSignaturesForAddress2Options,
       commitment?: Finality,
     ): Promise<Array<ConfirmedSignatureInfo>>;
+    /**
+     * Returns confirmed signatures for transactions involving an
+     * address backwards in time from the provided signature or most recent confirmed block
+     *
+     *
+     * @param address queried address
+     * @param options
+     */
+    getSignaturesForAddress(
+      address: PublicKey,
+      options?: SignaturesForAddressOptions,
+      commitment?: Finality,
+    ): Promise<Array<ConfirmedSignatureInfo>>;
     /**
      * Fetch the contents of a Nonce account from the cluster, return with context
      */

package/lib/index.esm.js

@@ -2940,6 +2940,17 @@ const GetConfirmedSignaturesForAddress2RpcResult = jsonRpcResult(array(type({
   memo: nullable(string()),
   blockTime: optional(nullable(number()))
 })));
+/**
+ * Expected JSON RPC response for the "getSignaturesForAddress" message
+ */
+
+const GetSignaturesForAddressRpcResult = jsonRpcResult(array(type({
+  signature: string(),
+  slot: number(),
+  err: TransactionErrorResult,
+  memo: nullable(string()),
+  blockTime: optional(nullable(number()))
+})));
 /***
  * Expected JSON RPC response for the "accountNotification" message
  */
@@ -4525,6 +4536,28 @@ class Connection {
 
     return res.result;
   }
+  /**
+   * Returns confirmed signatures for transactions involving an
+   * address backwards in time from the provided signature or most recent confirmed block
+   *
+   *
+   * @param address queried address
+   * @param options
+   */
+
+
+  async getSignaturesForAddress(address, options, commitment) {
+    const args = this._buildArgsAtLeastConfirmed([address.toBase58()], commitment, undefined, options);
+
+    const unsafeRes = await this._rpcRequest('getSignaturesForAddress', args);
+    const res = create(unsafeRes, GetSignaturesForAddressRpcResult);
+
+    if ('error' in res) {
+      throw new Error('failed to get signatures for address: ' + res.error.message);
+    }
+
+    return res.result;
+  }
   /**
    * Fetch the contents of a Nonce account from the cluster, return with context
    */