Release v8.0.0-beta.2

client/MIGRATION.md

@@ -0,0 +1,73 @@
+## @stacks/blockchain-api-client (<=7.x.x) → (8.x.x)
+
+## Breaking Changes
+
+This library is now generated with [openapi-typescript](https://openapi-ts.dev/openapi-fetch/) rather than [swagger-codegen](https://github.com/swagger-api/swagger-codegen). Several types which previously presented as the `any` type are now fixed, and the `@stacks/stacks-blockchain-api-types` package is no longer needed.
+
+
+This repo no longer includes a schema for the Stacks Blockchain RPC interface. An alternative client library for the RPC interface can be found at https://github.com/hirosystems/stacks.js/pull/1737.
+
+#### Configuration & Middleware
+
+```ts
+// old:
+import { TransactionsApi, Configuration } from '@stacks/blockchain-api-client';
+const client = new TransactionsApi(new Configuration({
+  basePath: 'https://api.mainnet.hiro.so',
+  middleware: [{
+    pre({url, init}) {
+      init.headers = new Headers(init.headers);
+      init.headers.set('x-custom-header', 'custom-value');
+      return Promise.resolve({ url, init });
+    }
+  }]
+}));
+
+
+// new:
+import { createClient } from '@stacks/blockchain-api-client';
+const client = createClient({
+  baseUrl: 'https://api.mainnet.hiro.so'
+});
+client.use({
+  onRequest({request}) {
+    request.headers.set('x-custom-header', 'custom-value');
+    return request;
+  }
+});
+```
+
+#### Performing Requests
+
+```ts
+// old:
+const blockTxs = await client.getTransactionsByBlock({
+  heightOrHash: 2000,
+  limit: 20,
+  offset: 100
+});
+console.log('Block transactions:', blockTxs);
+
+// new:
+const { data: blockTxs } = await client.GET('/extended/v2/blocks/{height_or_hash}/transactions', { 
+  params: { 
+    path: { height_or_hash: 2000 }, 
+    query: { limit: 20, offset: 100 },
+  }
+});
+console.log('Block transactions:', blockTxs);
+```
+
+#### Referencing Types
+
+```ts
+// old:
+import { MempoolTransactionStatsResponse } from '@stacks/blockchain-api-client';
+let response: MempoolTransactionStatsResponse;
+response = await client.getMempoolTransactionStats();
+
+// new:
+import { OperationResponse } from '@stacks/blockchain-api-client';
+let response: OperationResponse['/extended/v1/tx/mempool/stats'];
+response = (await client.GET('/extended/v1/tx/mempool/stats')).data;
+```

client/README.md

@@ -3,6 +3,10 @@
 
 A JS Client for the Stacks Blockchain API
 
+## Breaking changes from (<=7.x.x) → (8.x.x)
+
+See [MIGRATION.md](./MIGRATION.md) for details.
+
 ## Features
 
 This package provides the ability to:

client/src/generated/schema.d.ts

@@ -1812,7 +1812,7 @@ export interface operations {
                 offset?: number;
                 /** @description Results per page */
                 limit?: number;
-                type?: (("coinbase" | "token_transfer" | "smart_contract" | "contract_call" | "poison_microblock" | "tenure_change") | string)[];
+                type?: ("coinbase" | "token_transfer" | "smart_contract" | "contract_call" | "poison_microblock" | "tenure_change")[];
                 /**
                  * @description Include data from unanchored (i.e. unconfirmed) microblocks
                  * @example true
@@ -3177,7 +3177,7 @@ export interface operations {
     get_tx_list_details: {
         parameters: {
             query: {
-                tx_id: (string)[];
+                tx_id: string[];
                 /** @description Results per page */
                 event_limit?: number;
                 /** @description Result offset */
@@ -6496,7 +6496,7 @@ export interface operations {
                  */
                 tx_id?: string;
                 address?: string;
-                type?: (("smart_contract_log" | "stx_lock" | "stx_asset" | "fungible_token_asset" | "non_fungible_token_asset") | string)[];
+                type?: ("smart_contract_log" | "stx_lock" | "stx_asset" | "fungible_token_asset" | "non_fungible_token_asset")[];
                 /** @description Result offset */
                 offset?: number;
                 /** @description Results per page */
@@ -27255,7 +27255,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                height_or_hash: "latest" | string;
+                height_or_hash: "latest" | string | number;
             };
             cookie?: never;
         };
@@ -27321,7 +27321,7 @@ export interface operations {
             };
             header?: never;
             path: {
-                height_or_hash: "latest" | string;
+                height_or_hash: "latest" | string | number;
             };
             cookie?: never;
         };
@@ -28697,7 +28697,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                height_or_hash: "latest" | string;
+                height_or_hash: "latest" | string | number;
             };
             cookie?: never;
         };
@@ -28739,7 +28739,7 @@ export interface operations {
             };
             header?: never;
             path: {
-                height_or_hash: "latest" | string;
+                height_or_hash: "latest" | string | number;
             };
             cookie?: never;
         };

client/src/index.ts

@@ -10,3 +10,4 @@ export * from './common';
 export * from './socket-io';
 export * from './ws';
 export type * from './types';
+export * from 'openapi-fetch';

client/src/types.d.ts

@@ -1,14 +1,25 @@
-import type { operations } from "./generated/schema";
+import type { operations, paths } from './generated/schema';
+
+type Extract200Response<T> = T extends { 200: infer R } ? R : never;
+type ExtractOperationResponse<T extends keyof operations> = Extract200Response<operations[T]['responses']> extends { content: { 'application/json': infer U } } ? U : never;
+type PathResponse<T extends keyof paths> = paths[T]['get'] extends { responses: infer R } ? Extract200Response<R> extends { content: { 'application/json': infer U } } ? U : never : never;
+
+export type OperationResponse = {
+  [K in keyof operations]: ExtractOperationResponse<K>;
+} & {
+  [P in keyof paths]: PathResponse<P>;
+};
+
+export type Transaction = OperationResponse['get_transaction_list']['results'][number];
+export type MempoolTransaction = OperationResponse['get_mempool_transaction_list']['results'][number];
+export type Block = OperationResponse['get_block_by_height'];
+export type Microblock = OperationResponse['get_microblock_by_hash'];
+export type NakamotoBlock = OperationResponse['get_block'];
+export type BurnBlock = OperationResponse['get_burn_blocks']['results'][number];
+export type SmartContract = OperationResponse['get_contract_by_id'];
+export type AddressTransactionWithTransfers = OperationResponse['get_account_transactions_with_transfers']['results'][number];
+export type AddressStxBalanceResponse = OperationResponse['get_account_stx_balance'];
 
-export type Transaction = operations['get_transaction_list']['responses']['200']['content']['application/json']['results'][number];
-export type MempoolTransaction = operations['get_mempool_transaction_list']['responses']['200']['content']['application/json']['results'][number];
-export type Block = operations['get_block_by_height']['responses']['200']['content']['application/json'];
-export type Microblock = operations['get_microblock_by_hash']['responses']['200']['content']['application/json'];
-export type NakamotoBlock = operations['get_block']['responses']['200']['content']['application/json'];
-export type BurnBlock = operations['get_burn_blocks']['responses']['200']['content']['application/json']['results'][number];
-export type SmartContract = operations['get_contract_by_id']['responses']['200']['content']['application/json'];
-export type AddressTransactionWithTransfers = operations['get_account_transactions_with_transfers']['responses']['200']['content']['application/json']['results'][number];
-export type AddressStxBalanceResponse = operations['get_account_stx_balance']['responses']['200']['content']['application/json'];
 export type RpcAddressTxNotificationParams = AddressTransactionWithTransfers & {
   address: string;
   tx_id: string;