@nemtus/symbol-rest-api-client-fetch 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 NEMTUS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,268 @@
+# @nemtus/symbol-rest-api-client-fetch
+
+Symbol REST API client for TypeScript, generated with OpenAPI Generator (`typescript-fetch`). No runtime dependencies — uses the native Fetch API.
+
+Part of the [`nemtus/symbol-rest-api-client`](https://github.com/nemtus/symbol-rest-api-client) monorepo (this package lives in `clients/typescript-fetch`). The sister package [`@nemtus/symbol-rest-api-client-axios`](https://www.npmjs.com/package/@nemtus/symbol-rest-api-client-axios) provides an axios-based variant.
+
+> Formerly published as `@nemtus/symbol-sdk-openapi-generator-typescript-fetch` (now deprecated). This client targets the [`@nemtus/symbol-openapi`](https://www.npmjs.com/package/@nemtus/symbol-openapi) spec `1.0.5`.
+
+Note: Currently, This is a very experimental level.
+
+| Type | Status/Link |
+| --------- | -------------------- |
+| CI status | [![CI typescript-fetch](https://github.com/nemtus/symbol-rest-api-client/actions/workflows/ci-typescript-fetch.yml/badge.svg)](https://github.com/nemtus/symbol-rest-api-client/actions/workflows/ci-typescript-fetch.yml) |
+| Latest npm publish status | [![CD typescript-fetch](https://github.com/nemtus/symbol-rest-api-client/actions/workflows/cd-typescript-fetch.yml/badge.svg)](https://github.com/nemtus/symbol-rest-api-client/actions/workflows/cd-typescript-fetch.yml) |
+| npm package link | [https://www.npmjs.com/package/@nemtus/symbol-rest-api-client-fetch](https://www.npmjs.com/package/@nemtus/symbol-rest-api-client-fetch) |
+
+## For package users
+
+### Install
+
+```bash
+npm install @nemtus/symbol-rest-api-client-fetch
+```
+
+### Usage
+
+Example with no requestParameters
+
+```typescript
+import {
+  Configuration,
+  ConfigurationParameters,
+  NodeInfoDTO,
+  NodeRoutesApi,
+} from '@nemtus/symbol-rest-api-client-fetch';
+
+const configurationParameters: ConfigurationParameters = {
+  basePath: 'https://symbol-main-1.nemtus.com:3001',
+};
+const configuration: Configuration = new Configuration(configurationParameters);
+const nodeRoutesApi: NodeRoutesApi = new NodeRoutesApi(configuration);
+const response: NodeInfoDTO = await nodeRoutesApi.getNodeInfo();
+console.dir(response, { depth: null });
+/* Example: 
+{
+  version: 16777991,
+  publicKey: '2CEFBCE2E5EA5DD5BA61B302C33002CDA1EDB122EFD18713AF02ABFA9C73A28C',
+  networkGenerationHashSeed: '57F7DA205008026C776CB6AED843393F04CD458E0AA2D9F1D5F31A402072B2D6',
+  roles: 3,
+  port: 7900,
+  networkIdentifier: 104,
+  friendlyName: 'NEMTUS',
+  host: 'symbol-main-1.nemtus.com',
+  nodePublicKey: 'B56A3C73CA345A00CDDC84CFDF711CD67B2CCE10BEB82CB74835086774FE587F',
+}
+*/
+```
+
+Example with requestParameters
+
+```typescript
+import {
+  AccountInfoDTO,
+  AccountRoutesApi,
+  AccountRoutesApiGetAccountInfoRequest,
+  Configuration,
+  ConfigurationParameters,
+} from '@nemtus/symbol-rest-api-client-fetch';
+
+const configurationParameters: ConfigurationParameters = {
+  basePath: 'https://symbol-main-1.nemtus.com:3001',
+};
+const configuration: Configuration = new Configuration(configurationParameters);
+const accountRoutesApi: AccountRoutesApi = new AccountRoutesApi(configuration);
+const requestParameters: AccountRoutesApiGetAccountInfoRequest = {
+  accountId: 'NCSIOEWE2364XXP65426W3RUGBRYOAGR3KMMCIA',
+};
+const response: AccountInfoDTO = await accountRoutesApi.getAccountInfo(requestParameters);
+console.dir(response, { depth: null });
+// Example: 
+/*
+{
+  account: {
+    version: 1,
+    address: '68A48712C4D6FDCBDDFEEF35EB6E3430638700D1DA98C120',
+    addressHeight: '1',
+    publicKey: 'B86304B01045894ED9250B3DCD6313DC2EC0DD529B4E864EA376A2F341D3CFD4',
+    publicKeyHeight: '447',
+    accountType: 1,
+    supplementalPublicKeys: {
+      linked: {
+        publicKey: '5F87A37D1EAD570F4D0FD4C11A9D5EED5ABE82EF2E992B97CCDAC84F241470E0'
+      },
+      vrf: {
+        publicKey: '806E9448598C922B371DA8CFD7E16E8F5F53594B3AECE13F0708778A4480A752'
+      }
+    },
+    activityBuckets: [
+      {
+        startHeight: '1447200',
+        totalFeesPaid: '0',
+        beneficiaryCount: 0,
+        rawScore: '476538883720'
+      },
+      {
+        startHeight: '1446480',
+        totalFeesPaid: '0',
+        beneficiaryCount: 1,
+        rawScore: '476509686441'
+      },
+      {
+        startHeight: '1445760',
+        totalFeesPaid: '0',
+        beneficiaryCount: 1,
+        rawScore: '476481049034'
+      },
+      {
+        startHeight: '1445040',
+        totalFeesPaid: '0',
+        beneficiaryCount: 1,
+        rawScore: '476353869759'
+      },
+      {
+        startHeight: '1444320',
+        totalFeesPaid: '0',
+        beneficiaryCount: 1,
+        rawScore: '476325431930'
+      }
+    ],
+    mosaics: [
+      { id: '6BED913FA20223F8', amount: '516203401572' },
+      { id: '24F7CF825DBCDD42', amount: '499999886' },
+      { id: '310378C18A140D1B', amount: '923' },
+      { id: '6AE25FA5E8CA0646', amount: '1000000000' }
+    ],
+    importance: '476509686441',
+    importanceHeight: '1447200'
+  },
+  id: '60517BE5CCA17918A561056D'
+}
+*/
+```
+
+Example with CDN
+
+```html
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Document</title>
+    <!-- Load from CDN or a single file bundled with webpack -->
+    <script src="https://cdn.jsdelivr.net/npm/@nemtus/symbol-rest-api-client-fetch@1.0.0/index.min.js"></script>
+  </head>
+  <body>
+    <script>
+      (async () => {
+        const symbolSdk = window.symbolSdkOpenAPIGeneratorTypeScriptFetch;
+        const configurationParameters = {
+          basePath: 'http://symbol-main-1.nemtus.com:3000',
+        };
+        const configuration = new symbolSdk.Configuration(configurationParameters);
+
+        const nodeRoutesApi = new symbolSdk.NodeRoutesApi(configuration);
+        const responseNodeInfo = await nodeRoutesApi.getNodeInfo();
+        console.log(responseNodeInfo);
+
+        const accountRoutesApi = new symbolSdk.AccountRoutesApi(configuration);
+        const requestParameters = {
+          accountId: 'NCSIOEWE2364XXP65426W3RUGBRYOAGR3KMMCIA',
+        };
+        const responseAccountInfo = await accountRoutesApi.getAccountInfo(requestParameters);
+        console.log(responseAccountInfo);
+      })();
+    </script>
+  </body>
+</html>
+```
+
+## For Package Developers
+
+### 0. Prerequisite
+
+- Clone the monorepo and change into this client's directory
+
+```bash
+git clone git@github.com:nemtus/symbol-rest-api-client.git
+cd symbol-rest-api-client/clients/typescript-fetch
+```
+
+or
+
+```bash
+git clone https://github.com/nemtus/symbol-rest-api-client.git
+cd symbol-rest-api-client/clients/typescript-fetch
+```
+
+All commands below are run from this client directory (`clients/typescript-fetch`); there is no root `package.json`.
+
+- Install Java
+
+If you don't have java installed, you need to install it (required by the OpenAPI Generator).
+
+### 1. Install the OpenAPI spec package
+
+This project consumes the OpenAPI spec from the
+[`@nemtus/symbol-openapi`](https://www.npmjs.com/package/@nemtus/symbol-openapi) npm package (a
+devDependency), which is built and published from the [`nemtus/symbol`](https://github.com/nemtus/symbol/tree/dev/openapi)
+mirror fork. `npm ci` installs the bundled `openapi3.yml` into
+`node_modules/@nemtus/symbol-openapi/` — no HTTP fetch is required. (Previously this spec was
+downloaded as a release asset, and before that built locally from a git submodule, which pulled in
+vulnerable build tooling.)
+
+```bash
+npm ci
+```
+
+To bump the spec, bump the `@nemtus/symbol-openapi` version in `package.json` (or merge the
+Dependabot PR) and regenerate.
+
+### 2. Generate REST API Client Code
+
+```bash
+npm run openapi:set:version
+npm run openapi:generate
+npm run build
+```
+
+Then, REST API client code will be generated in `src/api` and bundled into `dist`.
+Do not edit `src/api` manually.
+
+### 3. Tests
+
+#### Test for CDN with Playwright
+
+```bash
+cd tests/browser-cdn
+npm ci
+npx playwright install chromium
+npm run test
+```
+
+#### Test for Node.js CommonJS JavaScript with vitest
+
+```bash
+cd tests/nodejs-javascript
+npm ci
+npm run test
+```
+
+#### Test for Node.js ES Modules TypeScript with vitest
+
+```bash
+cd tests/nodejs-typescript
+npm ci
+npm run test
+```
+
+## We use
+
+- [@nemtus/symbol-openapi](https://www.npmjs.com/package/@nemtus/symbol-openapi) (built/published from the [nemtus/symbol](https://github.com/nemtus/symbol/tree/dev/openapi) mirror fork) for the `openapi3.yml` spec
+- [OpenAPI Generator](https://openapi-generator.tech/) to generate REST API client codes
+  - Especially [typescript-fetch Generator](https://openapi-generator.tech/docs/generators/typescript-fetch)
+- [cosmos-client/cosmos-client-ts](https://github.com/cosmos-client/cosmos-client-ts) as a reference of package structure
+
+We would like to thank all the contributors to the above tools.

package/cjs/api/apis/AccountRoutesApi.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Catapult REST Endpoints
+ * OpenAPI Specification of catapult-rest
+ *
+ * The version of the OpenAPI document: 1.0.5
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import * as runtime from '../runtime';
+import type { AccountIds, AccountInfoDTO, AccountOrderByEnum, AccountPage, MerkleStateInfoDTO, Order } from '../models/index';
+export interface GetAccountInfoRequest {
+    accountId: string;
+}
+export interface GetAccountInfoMerkleRequest {
+    accountId: string;
+}
+export interface GetAccountsInfoRequest {
+    accountIds?: AccountIds;
+}
+export interface SearchAccountsRequest {
+    address?: string;
+    pageSize?: number;
+    pageNumber?: number;
+    offset?: string;
+    order?: Order;
+    orderBy?: AccountOrderByEnum;
+    mosaicId?: string;
+}
+/**
+ *
+ */
+export declare class AccountRoutesApi extends runtime.BaseAPI {
+    /**
+     * Retrieves account data for a given account identifier. The response contains the account state including balance, importance, public key, linked keys, and activity buckets.  The `accountId` path parameter accepts either a public key or a Base32-encoded address.
+     * Get account information
+     */
+    getAccountInfoRaw(requestParameters: GetAccountInfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AccountInfoDTO>>;
+    /**
+     * Retrieves account data for a given account identifier. The response contains the account state including balance, importance, public key, linked keys, and activity buckets.  The `accountId` path parameter accepts either a public key or a Base32-encoded address.
+     * Get account information
+     */
+    getAccountInfo(requestParameters: GetAccountInfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AccountInfoDTO>;
+    /**
+     * Retrieves the Merkle proof data for a given account. The Merkle path can be used to independently verify that the account state is included in the block state hash.  If no account state entry exists for the supplied account ID, the endpoint still returns a Merkle proof response, but it is a negative proof showing that no account state entry exists for the requested account.  The `accountId` path parameter accepts either a public key or a Base32-encoded address.
+     * Get account Merkle information
+     */
+    getAccountInfoMerkleRaw(requestParameters: GetAccountInfoMerkleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MerkleStateInfoDTO>>;
+    /**
+     * Retrieves the Merkle proof data for a given account. The Merkle path can be used to independently verify that the account state is included in the block state hash.  If no account state entry exists for the supplied account ID, the endpoint still returns a Merkle proof response, but it is a negative proof showing that no account state entry exists for the requested account.  The `accountId` path parameter accepts either a public key or a Base32-encoded address.
+     * Get account Merkle information
+     */
+    getAccountInfoMerkle(requestParameters: GetAccountInfoMerkleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MerkleStateInfoDTO>;
+    /**
+     * Retrieves account data for multiple accounts in a single request. This is the batch equivalent of the single-account endpoint.  The request body accepts either an array of public keys or an array of addresses (not both). If both `publicKeys` and `addresses` are provided, the request is invalid and the server returns `409` error.
+     * Get accounts information
+     */
+    getAccountsInfoRaw(requestParameters: GetAccountsInfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<AccountInfoDTO>>>;
+    /**
+     * Retrieves account data for multiple accounts in a single request. This is the batch equivalent of the single-account endpoint.  The request body accepts either an array of public keys or an array of addresses (not both). If both `publicKeys` and `addresses` are provided, the request is invalid and the server returns `409` error.
+     * Get accounts information
+     */
+    getAccountsInfo(requestParameters?: GetAccountsInfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<AccountInfoDTO>>;
+    /**
+     * Returns a paginated list of accounts matching the given criteria.  Results can be filtered by `address` and `mosaicId` (mosaic ownership), and ordered by `id` or `balance`. Standard pagination parameters (`pageSize`, `pageNumber`, `offset`, `order`) apply. The `orderBy` parameter supports `id` and `balance`; when using `orderBy=balance`, the `mosaicId` filter is required. The `offset` value must match the `orderBy` field.
+     * Search accounts
+     */
+    searchAccountsRaw(requestParameters: SearchAccountsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AccountPage>>;
+    /**
+     * Returns a paginated list of accounts matching the given criteria.  Results can be filtered by `address` and `mosaicId` (mosaic ownership), and ordered by `id` or `balance`. Standard pagination parameters (`pageSize`, `pageNumber`, `offset`, `order`) apply. The `orderBy` parameter supports `id` and `balance`; when using `orderBy=balance`, the `mosaicId` filter is required. The `offset` value must match the `orderBy` field.
+     * Search accounts
+     */
+    searchAccounts(requestParameters?: SearchAccountsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AccountPage>;
+}

package/cjs/api/apis/AccountRoutesApi.js

@@ -0,0 +1,209 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Catapult REST Endpoints
+ * OpenAPI Specification of catapult-rest
+ *
+ * The version of the OpenAPI document: 1.0.5
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountRoutesApi = void 0;
+const runtime = __importStar(require("../runtime"));
+const index_1 = require("../models/index");
+/**
+ *
+ */
+class AccountRoutesApi extends runtime.BaseAPI {
+    /**
+     * Retrieves account data for a given account identifier. The response contains the account state including balance, importance, public key, linked keys, and activity buckets.  The `accountId` path parameter accepts either a public key or a Base32-encoded address.
+     * Get account information
+     */
+    getAccountInfoRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['accountId'] == null) {
+                throw new runtime.RequiredError('accountId', 'Required parameter "accountId" was null or undefined when calling getAccountInfo().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            let urlPath = `/accounts/{accountId}`;
+            urlPath = urlPath.replace(`{${"accountId"}}`, encodeURIComponent(String(requestParameters['accountId'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.AccountInfoDTOFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Retrieves account data for a given account identifier. The response contains the account state including balance, importance, public key, linked keys, and activity buckets.  The `accountId` path parameter accepts either a public key or a Base32-encoded address.
+     * Get account information
+     */
+    getAccountInfo(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getAccountInfoRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Retrieves the Merkle proof data for a given account. The Merkle path can be used to independently verify that the account state is included in the block state hash.  If no account state entry exists for the supplied account ID, the endpoint still returns a Merkle proof response, but it is a negative proof showing that no account state entry exists for the requested account.  The `accountId` path parameter accepts either a public key or a Base32-encoded address.
+     * Get account Merkle information
+     */
+    getAccountInfoMerkleRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['accountId'] == null) {
+                throw new runtime.RequiredError('accountId', 'Required parameter "accountId" was null or undefined when calling getAccountInfoMerkle().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            let urlPath = `/accounts/{accountId}/merkle`;
+            urlPath = urlPath.replace(`{${"accountId"}}`, encodeURIComponent(String(requestParameters['accountId'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.MerkleStateInfoDTOFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Retrieves the Merkle proof data for a given account. The Merkle path can be used to independently verify that the account state is included in the block state hash.  If no account state entry exists for the supplied account ID, the endpoint still returns a Merkle proof response, but it is a negative proof showing that no account state entry exists for the requested account.  The `accountId` path parameter accepts either a public key or a Base32-encoded address.
+     * Get account Merkle information
+     */
+    getAccountInfoMerkle(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getAccountInfoMerkleRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Retrieves account data for multiple accounts in a single request. This is the batch equivalent of the single-account endpoint.  The request body accepts either an array of public keys or an array of addresses (not both). If both `publicKeys` and `addresses` are provided, the request is invalid and the server returns `409` error.
+     * Get accounts information
+     */
+    getAccountsInfoRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            let urlPath = `/accounts`;
+            const response = yield this.request({
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: (0, index_1.AccountIdsToJSON)(requestParameters['accountIds']),
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(index_1.AccountInfoDTOFromJSON));
+        });
+    }
+    /**
+     * Retrieves account data for multiple accounts in a single request. This is the batch equivalent of the single-account endpoint.  The request body accepts either an array of public keys or an array of addresses (not both). If both `publicKeys` and `addresses` are provided, the request is invalid and the server returns `409` error.
+     * Get accounts information
+     */
+    getAccountsInfo() {
+        return __awaiter(this, arguments, void 0, function* (requestParameters = {}, initOverrides) {
+            const response = yield this.getAccountsInfoRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Returns a paginated list of accounts matching the given criteria.  Results can be filtered by `address` and `mosaicId` (mosaic ownership), and ordered by `id` or `balance`. Standard pagination parameters (`pageSize`, `pageNumber`, `offset`, `order`) apply. The `orderBy` parameter supports `id` and `balance`; when using `orderBy=balance`, the `mosaicId` filter is required. The `offset` value must match the `orderBy` field.
+     * Search accounts
+     */
+    searchAccountsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const queryParameters = {};
+            if (requestParameters['address'] != null) {
+                queryParameters['address'] = requestParameters['address'];
+            }
+            if (requestParameters['pageSize'] != null) {
+                queryParameters['pageSize'] = requestParameters['pageSize'];
+            }
+            if (requestParameters['pageNumber'] != null) {
+                queryParameters['pageNumber'] = requestParameters['pageNumber'];
+            }
+            if (requestParameters['offset'] != null) {
+                queryParameters['offset'] = requestParameters['offset'];
+            }
+            if (requestParameters['order'] != null) {
+                queryParameters['order'] = requestParameters['order'];
+            }
+            if (requestParameters['orderBy'] != null) {
+                queryParameters['orderBy'] = requestParameters['orderBy'];
+            }
+            if (requestParameters['mosaicId'] != null) {
+                queryParameters['mosaicId'] = requestParameters['mosaicId'];
+            }
+            const headerParameters = {};
+            let urlPath = `/accounts`;
+            const response = yield this.request({
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.AccountPageFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Returns a paginated list of accounts matching the given criteria.  Results can be filtered by `address` and `mosaicId` (mosaic ownership), and ordered by `id` or `balance`. Standard pagination parameters (`pageSize`, `pageNumber`, `offset`, `order`) apply. The `orderBy` parameter supports `id` and `balance`; when using `orderBy=balance`, the `mosaicId` filter is required. The `offset` value must match the `orderBy` field.
+     * Search accounts
+     */
+    searchAccounts() {
+        return __awaiter(this, arguments, void 0, function* (requestParameters = {}, initOverrides) {
+            const response = yield this.searchAccountsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+}
+exports.AccountRoutesApi = AccountRoutesApi;

package/cjs/api/apis/BlockRoutesApi.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Catapult REST Endpoints
+ * OpenAPI Specification of catapult-rest
+ *
+ * The version of the OpenAPI document: 1.0.5
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import * as runtime from '../runtime';
+import type { BlockInfoDTO, BlockOrderByEnum, BlockPage, MerkleProofInfoDTO, Order } from '../models/index';
+export interface GetBlockByHeightRequest {
+    height: string;
+}
+export interface GetMerkleReceiptsRequest {
+    height: string;
+    hash: string;
+}
+export interface GetMerkleTransactionRequest {
+    height: string;
+    hash: string;
+}
+export interface SearchBlocksRequest {
+    signerPublicKey?: string;
+    beneficiaryAddress?: string;
+    pageSize?: number;
+    pageNumber?: number;
+    offset?: string;
+    order?: Order;
+    orderBy?: BlockOrderByEnum;
+    fromTimestamp?: string;
+    toTimestamp?: string;
+}
+/**
+ *
+ */
+export declare class BlockRoutesApi extends runtime.BaseAPI {
+    /**
+     * Returns the block at the given height. The response includes the block header, harvester signature, and block metadata (hash, total fee, generation hash, transaction and statement counts).  If the block is an importance block, the response additionally contains voting-eligible and harvesting-eligible account counts, total voting balance, and the previous importance block hash.
+     * Get block information
+     */
+    getBlockByHeightRaw(requestParameters: GetBlockByHeightRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BlockInfoDTO>>;
+    /**
+     * Returns the block at the given height. The response includes the block header, harvester signature, and block metadata (hash, total fee, generation hash, transaction and statement counts).  If the block is an importance block, the response additionally contains voting-eligible and harvesting-eligible account counts, total voting balance, and the previous importance block hash.
+     * Get block information
+     */
+    getBlockByHeight(requestParameters: GetBlockByHeightRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BlockInfoDTO>;
+    /**
+     * Returns the [Merkle path](https://docs.symbol.dev/concepts/data-validation.html#merkle-proof) for a [receipt statement or resolution](https://docs.symbol.dev/concepts/receipt.html) linked to a block. The `hash` parameter is the receipt statement hash, not the transaction hash. The Merkle path is the minimum number of nodes needed to calculate the Merkle root.  Steps to calculate the Merkle root: 1. proofHash = hash (leaf). 2. Concatenate proofHash with the first unprocessed item from the merklePath list as follows: - `left`: the item hash is concatenated before the proofHash (proofHash = sha_256(item.hash + proofHash)). - `right`: the item hash is concatenated after the proofHash (proofHash = sha_256(proofHash + item.hash)). 3. Repeat 2. for every item in the merklePath list. 4. Compare if the calculated proofHash equals the one recorded in the [block header](https://docs.symbol.dev/concepts/block.html) (`block.receiptsHash`) to verify if the statement was linked with the block.
+     * Get the Merkle path for a given receipt statement hash and block
+     */
+    getMerkleReceiptsRaw(requestParameters: GetMerkleReceiptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MerkleProofInfoDTO>>;
+    /**
+     * Returns the [Merkle path](https://docs.symbol.dev/concepts/data-validation.html#merkle-proof) for a [receipt statement or resolution](https://docs.symbol.dev/concepts/receipt.html) linked to a block. The `hash` parameter is the receipt statement hash, not the transaction hash. The Merkle path is the minimum number of nodes needed to calculate the Merkle root.  Steps to calculate the Merkle root: 1. proofHash = hash (leaf). 2. Concatenate proofHash with the first unprocessed item from the merklePath list as follows: - `left`: the item hash is concatenated before the proofHash (proofHash = sha_256(item.hash + proofHash)). - `right`: the item hash is concatenated after the proofHash (proofHash = sha_256(proofHash + item.hash)). 3. Repeat 2. for every item in the merklePath list. 4. Compare if the calculated proofHash equals the one recorded in the [block header](https://docs.symbol.dev/concepts/block.html) (`block.receiptsHash`) to verify if the statement was linked with the block.
+     * Get the Merkle path for a given receipt statement hash and block
+     */
+    getMerkleReceipts(requestParameters: GetMerkleReceiptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MerkleProofInfoDTO>;
+    /**
+     * Returns the [Merkle path](https://docs.symbol.dev/concepts/data-validation.html#merkle-proof) for a [transaction](https://docs.symbol.dev/concepts/transaction.html) included in a block. The Merkle path is the minimum number of nodes needed to calculate the Merkle root.  Steps to calculate the Merkle root: 1. proofHash = hash (leaf). 2. Concatenate proofHash with the first unprocessed item from the merklePath list as follows: - `left`: the item hash is concatenated before the proofHash (proofHash = sha_256(item.hash + proofHash)). - `right`: the item hash is concatenated after the proofHash (proofHash = sha_256(proofHash + item.hash)). 3. Repeat 2. for every item in the merklePath list. 4. Compare if the calculated proofHash equals the one recorded in the [block header](https://docs.symbol.dev/concepts/block.html) (`block.transactionsHash`) to verify if the transaction was included in the block.
+     * Get the Merkle path for a given transaction and block
+     */
+    getMerkleTransactionRaw(requestParameters: GetMerkleTransactionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MerkleProofInfoDTO>>;
+    /**
+     * Returns the [Merkle path](https://docs.symbol.dev/concepts/data-validation.html#merkle-proof) for a [transaction](https://docs.symbol.dev/concepts/transaction.html) included in a block. The Merkle path is the minimum number of nodes needed to calculate the Merkle root.  Steps to calculate the Merkle root: 1. proofHash = hash (leaf). 2. Concatenate proofHash with the first unprocessed item from the merklePath list as follows: - `left`: the item hash is concatenated before the proofHash (proofHash = sha_256(item.hash + proofHash)). - `right`: the item hash is concatenated after the proofHash (proofHash = sha_256(proofHash + item.hash)). 3. Repeat 2. for every item in the merklePath list. 4. Compare if the calculated proofHash equals the one recorded in the [block header](https://docs.symbol.dev/concepts/block.html) (`block.transactionsHash`) to verify if the transaction was included in the block.
+     * Get the Merkle path for a given transaction and block
+     */
+    getMerkleTransaction(requestParameters: GetMerkleTransactionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MerkleProofInfoDTO>;
+    /**
+     * Returns a paginated list of blocks matching the given criteria.  Results can be filtered by harvester (`signerPublicKey`), `beneficiaryAddress`, and timestamp range. Standard pagination parameters (`pageSize`, `pageNumber`, `offset`, `order`) apply. The `orderBy` parameter supports `id` and `height`. The `offset` value must match the `orderBy` field.
+     * Search blocks
+     */
+    searchBlocksRaw(requestParameters: SearchBlocksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BlockPage>>;
+    /**
+     * Returns a paginated list of blocks matching the given criteria.  Results can be filtered by harvester (`signerPublicKey`), `beneficiaryAddress`, and timestamp range. Standard pagination parameters (`pageSize`, `pageNumber`, `offset`, `order`) apply. The `orderBy` parameter supports `id` and `height`. The `offset` value must match the `orderBy` field.
+     * Search blocks
+     */
+    searchBlocks(requestParameters?: SearchBlocksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BlockPage>;
+}