fix: docs for txlistinternal api endpoint (#73)

# What ❔

Improved docs for txlistinternal api endpoint

## Why ❔

It's more user friendly to have separate swagger definitions for
txlistinternal endpoint without params, with address and with txHash
param.

## Checklist

<!-- Check your PR fulfills the following items. -->
<!-- For draft PRs check the boxes as you complete them. -->

- [X] PR title corresponds to the body of PR (we generate changelog
entries from PRs).
- [X] Tests for the changes have been added / updated.
- [X] Documentation comments have been added / updated.

packages/api/src/api/api.controller.spec.ts

@@ -108,6 +108,20 @@ describe("ApiController", () => {
     });
   });
 
+  describe("getInternalTransactions", () => {
+    it("returns null as it is defined only to appear in docs and cannot be called", async () => {
+      const result = await controller.getInternalTransactions(
+        {
+          page: 1,
+          offset: 10,
+          maxLimit: 10000,
+        },
+        { sort: SortingOrder.Desc }
+      );
+      expect(result).toBe(null);
+    });
+  });
+
   describe("getAccountInternalTransactions", () => {
     it("returns null as it is defined only to appear in docs and cannot be called", async () => {
       const result = await controller.getAccountInternalTransactions(

packages/api/src/api/api.controller.ts

@@ -232,14 +232,45 @@ export class ApiController {
     return null;
   }
 
+  @ApiTags("Account API")
+  @Get("api?module=account&action=txlistinternal")
+  @ApiOperation({ summary: "Retrieve internal transactions" })
+  @ApiQuery({
+    name: "startblock",
+    type: "integer",
+    description: "The block number to start searching for internal transactions",
+    example: 0,
+    required: false,
+  })
+  @ApiQuery({
+    name: "endblock",
+    type: "integer",
+    description: "The block number to stop searching for internal transactions",
+    example: 99999999,
+    required: false,
+  })
+  @ApiExtraModels(AccountInternalTransactionDto)
+  @ApiOkResponse({
+    description: "Internal transactions list",
+    type: AccountInternalTransactionsResponseDto,
+  })
+  public async getInternalTransactions(
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    @Query() pagingOptions: PagingOptionsWithMaxItemsLimitDto,
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    @Query() sortingOptions: SortingOptionsDto
+  ): Promise<AccountInternalTransactionsResponseDto> {
+    return null;
+  }
+
   @ApiTags("Account API")
   @Get("api?module=account&action=txlistinternal&address=")
   @ApiOperation({ summary: "Retrieve internal transactions for a given address" })
   @ApiQuery({
     name: "address",
     description: "The address to filter internal transactions by",
     example: constants.addressWithInternalTx,
-    required: false,
+    required: true,
   })
   @ApiQuery({
     name: "startblock",
@@ -276,7 +307,7 @@ export class ApiController {
     name: "txhash",
     description: "The transaction hash to filter internal transaction by",
     example: constants.addressTxWithInternalTransfers,
-    required: false,
+    required: true,
   })
   @ApiQuery({
     name: "startblock",