@stacks/blockchain-api-client 7.4.0-nakamoto.4 → 7.4.0-nakamoto.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stacks/blockchain-api-client",
-  "version": "7.4.0-nakamoto.4",
+  "version": "7.4.0-nakamoto.5",
   "access": "public",
   "description": "Client for the Stacks Blockchain API",
   "homepage": "https://github.com/hirosystems/stacks-blockchain-api/tree/master/client#readme",

package/src/generated/apis/BlocksApi.ts

@@ -21,6 +21,9 @@ import {
     BlockListResponse,
     BlockListResponseFromJSON,
     BlockListResponseToJSON,
+    BurnBlock,
+    BurnBlockFromJSON,
+    BurnBlockToJSON,
     BurnBlockListResponse,
     BurnBlockListResponseFromJSON,
     BurnBlockListResponseToJSON,
@@ -57,11 +60,13 @@ export interface GetBlocksRequest {
     burnBlockHeight?: number;
 }
 
-export interface GetBurnBlockListRequest {
+export interface GetBurnBlockRequest {
+    heightOrHash: number | string;
+}
+
+export interface GetBurnBlocksRequest {
     limit?: number;
     offset?: number;
-    height?: number;
-    hash?: string;
 }
 
 /**
@@ -171,24 +176,38 @@ export interface BlocksApiInterface {
      */
     getBlocks(requestParameters: GetBlocksRequest, initOverrides?: RequestInit): Promise<NakamotoBlockListResponse>;
 
+    /**
+     * Retrieves a single burn block
+     * @summary Get burn block
+     * @param {number | string} heightOrHash filter by burn block height, hash, or the constant &#x60;latest&#x60; to filter for the most recent burn block
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof BlocksApiInterface
+     */
+    getBurnBlockRaw(requestParameters: GetBurnBlockRequest, initOverrides?: RequestInit): Promise<runtime.ApiResponse<BurnBlock>>;
+
+    /**
+     * Retrieves a single burn block
+     * Get burn block
+     */
+    getBurnBlock(requestParameters: GetBurnBlockRequest, initOverrides?: RequestInit): Promise<BurnBlock>;
+
     /**
      * Retrieves a list of recent burn blocks 
-     * @summary Get recent burn blocks
+     * @summary Get burn blocks
      * @param {number} [limit] max number of burn blocks to fetch
      * @param {number} [offset] index of first burn block to fetch
-     * @param {number} [height] filter by burn block height
-     * @param {string} [hash] filter by burn block hash or the constant \&#39;latest\&#39; to filter for the most recent burn block
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof BlocksApiInterface
      */
-    getBurnBlockListRaw(requestParameters: GetBurnBlockListRequest, initOverrides?: RequestInit): Promise<runtime.ApiResponse<BurnBlockListResponse>>;
+    getBurnBlocksRaw(requestParameters: GetBurnBlocksRequest, initOverrides?: RequestInit): Promise<runtime.ApiResponse<BurnBlockListResponse>>;
 
     /**
      * Retrieves a list of recent burn blocks 
-     * Get recent burn blocks
+     * Get burn blocks
      */
-    getBurnBlockList(requestParameters: GetBurnBlockListRequest, initOverrides?: RequestInit): Promise<BurnBlockListResponse>;
+    getBurnBlocks(requestParameters: GetBurnBlocksRequest, initOverrides?: RequestInit): Promise<BurnBlockListResponse>;
 
 }
 
@@ -405,11 +424,43 @@ export class BlocksApi extends runtime.BaseAPI implements BlocksApiInterface {
         return await response.value();
     }
 
+    /**
+     * Retrieves a single burn block
+     * Get burn block
+     */
+    async getBurnBlockRaw(requestParameters: GetBurnBlockRequest, initOverrides?: RequestInit): Promise<runtime.ApiResponse<BurnBlock>> {
+        if (requestParameters.heightOrHash === null || requestParameters.heightOrHash === undefined) {
+            throw new runtime.RequiredError('heightOrHash','Required parameter requestParameters.heightOrHash was null or undefined when calling getBurnBlock.');
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        const response = await this.request({
+            path: `/extended/v2/burn-blocks/{height_or_hash}`.replace(`{${"height_or_hash"}}`, encodeURIComponent(String(requestParameters.heightOrHash))),
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => BurnBlockFromJSON(jsonValue));
+    }
+
+    /**
+     * Retrieves a single burn block
+     * Get burn block
+     */
+    async getBurnBlock(requestParameters: GetBurnBlockRequest, initOverrides?: RequestInit): Promise<BurnBlock> {
+        const response = await this.getBurnBlockRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Retrieves a list of recent burn blocks 
-     * Get recent burn blocks
+     * Get burn blocks
      */
-    async getBurnBlockListRaw(requestParameters: GetBurnBlockListRequest, initOverrides?: RequestInit): Promise<runtime.ApiResponse<BurnBlockListResponse>> {
+    async getBurnBlocksRaw(requestParameters: GetBurnBlocksRequest, initOverrides?: RequestInit): Promise<runtime.ApiResponse<BurnBlockListResponse>> {
         const queryParameters: any = {};
 
         if (requestParameters.limit !== undefined) {
@@ -420,18 +471,10 @@ export class BlocksApi extends runtime.BaseAPI implements BlocksApiInterface {
             queryParameters['offset'] = requestParameters.offset;
         }
 
-        if (requestParameters.height !== undefined) {
-            queryParameters['height'] = requestParameters.height;
-        }
-
-        if (requestParameters.hash !== undefined) {
-            queryParameters['hash'] = requestParameters.hash;
-        }
-
         const headerParameters: runtime.HTTPHeaders = {};
 
         const response = await this.request({
-            path: `/extended/v1/burn_block`,
+            path: `/extended/v2/burn-blocks`,
             method: 'GET',
             headers: headerParameters,
             query: queryParameters,
@@ -442,10 +485,10 @@ export class BlocksApi extends runtime.BaseAPI implements BlocksApiInterface {
 
     /**
      * Retrieves a list of recent burn blocks 
-     * Get recent burn blocks
+     * Get burn blocks
      */
-    async getBurnBlockList(requestParameters: GetBurnBlockListRequest, initOverrides?: RequestInit): Promise<BurnBlockListResponse> {
-        const response = await this.getBurnBlockListRaw(requestParameters, initOverrides);
+    async getBurnBlocks(requestParameters: GetBurnBlocksRequest, initOverrides?: RequestInit): Promise<BurnBlockListResponse> {
+        const response = await this.getBurnBlocksRaw(requestParameters, initOverrides);
         return await response.value();
     }