@stacks/blockchain-api-client 7.12.0-beta.1 → 7.13.0-beta.1

package/package.json

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

package/src/generated/.openapi-generator/FILES

@@ -4,6 +4,7 @@ apis/BlocksApi.ts
 apis/BurnBlocksApi.ts
 apis/FaucetsApi.ts
 apis/FeesApi.ts
+apis/FungibleTokensApi.ts
 apis/InfoApi.ts
 apis/MempoolApi.ts
 apis/MicroblocksApi.ts
@@ -61,6 +62,8 @@ models/CoreNodeInfoResponse.ts
 models/CoreNodePoxResponse.ts
 models/FeeRate.ts
 models/FeeRateRequest.ts
+models/FtHolderEntry.ts
+models/FungibleTokenHolderList.ts
 models/GetRawTransactionResult.ts
 models/GetStxSupplyLegacyFormatResponse.ts
 models/GetStxSupplyResponse.ts

package/src/generated/apis/FungibleTokensApi.ts

@@ -0,0 +1,89 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Stacks Blockchain API
+ * Welcome to the API reference overview for the [Stacks Blockchain API](https://docs.hiro.so/stacks-blockchain-api).  [Download Postman collection](https://hirosystems.github.io/stacks-blockchain-api/collection.json) 
+ *
+ * The version of the OpenAPI document: STACKS_API_VERSION
+ * 
+ *
+ * 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 {
+    FungibleTokenHolderList,
+    FungibleTokenHolderListFromJSON,
+    FungibleTokenHolderListToJSON,
+} from '../models';
+
+export interface GetFtHoldersRequest {
+    token: string;
+}
+
+/**
+ * FungibleTokensApi - interface
+ * 
+ * @export
+ * @interface FungibleTokensApiInterface
+ */
+export interface FungibleTokensApiInterface {
+    /**
+     * Retrieves the list of Fungible Token holders for a given token ID. Specify `stx` for the `token` parameter to get the list of STX holders. 
+     * @summary Fungible token holders
+     * @param {string} token fungible token identifier
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof FungibleTokensApiInterface
+     */
+    getFtHoldersRaw(requestParameters: GetFtHoldersRequest, initOverrides?: RequestInit): Promise<runtime.ApiResponse<FungibleTokenHolderList>>;
+
+    /**
+     * Retrieves the list of Fungible Token holders for a given token ID. Specify `stx` for the `token` parameter to get the list of STX holders. 
+     * Fungible token holders
+     */
+    getFtHolders(requestParameters: GetFtHoldersRequest, initOverrides?: RequestInit): Promise<FungibleTokenHolderList>;
+
+}
+
+/**
+ * 
+ */
+export class FungibleTokensApi extends runtime.BaseAPI implements FungibleTokensApiInterface {
+
+    /**
+     * Retrieves the list of Fungible Token holders for a given token ID. Specify `stx` for the `token` parameter to get the list of STX holders. 
+     * Fungible token holders
+     */
+    async getFtHoldersRaw(requestParameters: GetFtHoldersRequest, initOverrides?: RequestInit): Promise<runtime.ApiResponse<FungibleTokenHolderList>> {
+        if (requestParameters.token === null || requestParameters.token === undefined) {
+            throw new runtime.RequiredError('token','Required parameter requestParameters.token was null or undefined when calling getFtHolders.');
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        const response = await this.request({
+            path: `/extended/v1/tokens/ft/{token}/holders`.replace(`{${"token"}}`, encodeURIComponent(String(requestParameters.token))),
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => FungibleTokenHolderListFromJSON(jsonValue));
+    }
+
+    /**
+     * Retrieves the list of Fungible Token holders for a given token ID. Specify `stx` for the `token` parameter to get the list of STX holders. 
+     * Fungible token holders
+     */
+    async getFtHolders(requestParameters: GetFtHoldersRequest, initOverrides?: RequestInit): Promise<FungibleTokenHolderList> {
+        const response = await this.getFtHoldersRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}

package/src/generated/apis/TransactionsApi.ts

@@ -100,7 +100,14 @@ export interface GetTransactionListRequest {
     limit?: number;
     offset?: number;
     type?: Array<GetTransactionListTypeEnum>;
+    fromAddress?: string;
+    toAddress?: string;
     sortBy?: GetTransactionListSortByEnum;
+    startTime?: number;
+    endTime?: number;
+    contractId?: string;
+    functionName?: string;
+    nonce?: number;
     order?: GetTransactionListOrderEnum;
     unanchored?: boolean;
 }
@@ -312,7 +319,14 @@ export interface TransactionsApiInterface {
      * @param {number} [limit] max number of transactions to fetch
      * @param {number} [offset] index of first transaction to fetch
      * @param {Array<'coinbase' | 'token_transfer' | 'smart_contract' | 'contract_call' | 'poison_microblock' | 'tenure_change'>} [type] Filter by transaction type
+     * @param {string} [fromAddress] Option to filter results by sender address
+     * @param {string} [toAddress] Option to filter results by recipient address
      * @param {'block_height' | 'burn_block_time' | 'fee'} [sortBy] Option to sort results by block height, timestamp, or fee
+     * @param {number} [startTime] Filter by transactions after this timestamp (unix timestamp in seconds)
+     * @param {number} [endTime] Filter by transactions before this timestamp (unix timestamp in seconds)
+     * @param {string} [contractId] Filter by contract call transactions involving this contract ID
+     * @param {string} [functionName] Filter by contract call transactions involving this function name
+     * @param {number} [nonce] Filter by transactions with this nonce
      * @param {'asc' | 'desc'} [order] Option to sort results in ascending or descending order
      * @param {boolean} [unanchored] Include transaction data from unanchored (i.e. unconfirmed) microblocks
      * @param {*} [options] Override http request option.
@@ -817,10 +831,38 @@ export class TransactionsApi extends runtime.BaseAPI implements TransactionsApiI
             queryParameters['type'] = requestParameters.type;
         }
 
+        if (requestParameters.fromAddress !== undefined) {
+            queryParameters['from_address'] = requestParameters.fromAddress;
+        }
+
+        if (requestParameters.toAddress !== undefined) {
+            queryParameters['to_address'] = requestParameters.toAddress;
+        }
+
         if (requestParameters.sortBy !== undefined) {
             queryParameters['sort_by'] = requestParameters.sortBy;
         }
 
+        if (requestParameters.startTime !== undefined) {
+            queryParameters['start_time'] = requestParameters.startTime;
+        }
+
+        if (requestParameters.endTime !== undefined) {
+            queryParameters['end_time'] = requestParameters.endTime;
+        }
+
+        if (requestParameters.contractId !== undefined) {
+            queryParameters['contract_id'] = requestParameters.contractId;
+        }
+
+        if (requestParameters.functionName !== undefined) {
+            queryParameters['function_name'] = requestParameters.functionName;
+        }
+
+        if (requestParameters.nonce !== undefined) {
+            queryParameters['nonce'] = requestParameters.nonce;
+        }
+
         if (requestParameters.order !== undefined) {
             queryParameters['order'] = requestParameters.order;
         }

package/src/generated/apis/index.ts

@@ -5,6 +5,7 @@ export * from './BlocksApi';
 export * from './BurnBlocksApi';
 export * from './FaucetsApi';
 export * from './FeesApi';
+export * from './FungibleTokensApi';
 export * from './InfoApi';
 export * from './MempoolApi';
 export * from './MicroblocksApi';

package/src/generated/models/FtHolderEntry.ts

@@ -0,0 +1,64 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Stacks Blockchain API
+ * Welcome to the API reference overview for the [Stacks Blockchain API](https://docs.hiro.so/stacks-blockchain-api).  [Download Postman collection](https://hirosystems.github.io/stacks-blockchain-api/collection.json) 
+ *
+ * The version of the OpenAPI document: STACKS_API_VERSION
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import { exists, mapValues } from '../runtime';
+/**
+ * 
+ * @export
+ * @interface FtHolderEntry
+ */
+export interface FtHolderEntry {
+    /**
+     * 
+     * @type {string}
+     * @memberof FtHolderEntry
+     */
+    address: string;
+    /**
+     * 
+     * @type {string}
+     * @memberof FtHolderEntry
+     */
+    balance: string;
+}
+
+export function FtHolderEntryFromJSON(json: any): FtHolderEntry {
+    return FtHolderEntryFromJSONTyped(json, false);
+}
+
+export function FtHolderEntryFromJSONTyped(json: any, ignoreDiscriminator: boolean): FtHolderEntry {
+    if ((json === undefined) || (json === null)) {
+        return json;
+    }
+    return {
+        
+        'address': json['address'],
+        'balance': json['balance'],
+    };
+}
+
+export function FtHolderEntryToJSON(value?: FtHolderEntry | null): any {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === null) {
+        return null;
+    }
+    return {
+        
+        'address': value.address,
+        'balance': value.balance,
+    };
+}
+

package/src/generated/models/FungibleTokenHolderList.ts

@@ -0,0 +1,95 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Stacks Blockchain API
+ * Welcome to the API reference overview for the [Stacks Blockchain API](https://docs.hiro.so/stacks-blockchain-api).  [Download Postman collection](https://hirosystems.github.io/stacks-blockchain-api/collection.json) 
+ *
+ * The version of the OpenAPI document: STACKS_API_VERSION
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import { exists, mapValues } from '../runtime';
+import {
+    FtHolderEntry,
+    FtHolderEntryFromJSON,
+    FtHolderEntryFromJSONTyped,
+    FtHolderEntryToJSON,
+} from './';
+
+/**
+ * List of Fungible Token holders
+ * @export
+ * @interface FungibleTokenHolderList
+ */
+export interface FungibleTokenHolderList {
+    /**
+     * The number of holders to return
+     * @type {number}
+     * @memberof FungibleTokenHolderList
+     */
+    limit: number;
+    /**
+     * The number to holders to skip (starting at `0`)
+     * @type {number}
+     * @memberof FungibleTokenHolderList
+     */
+    offset: number;
+    /**
+     * The number of holders available
+     * @type {number}
+     * @memberof FungibleTokenHolderList
+     */
+    total: number;
+    /**
+     * The total supply of the token (the sum of all balances)
+     * @type {string}
+     * @memberof FungibleTokenHolderList
+     */
+    total_supply: string;
+    /**
+     * 
+     * @type {Array<FtHolderEntry>}
+     * @memberof FungibleTokenHolderList
+     */
+    results: Array<FtHolderEntry>;
+}
+
+export function FungibleTokenHolderListFromJSON(json: any): FungibleTokenHolderList {
+    return FungibleTokenHolderListFromJSONTyped(json, false);
+}
+
+export function FungibleTokenHolderListFromJSONTyped(json: any, ignoreDiscriminator: boolean): FungibleTokenHolderList {
+    if ((json === undefined) || (json === null)) {
+        return json;
+    }
+    return {
+        
+        'limit': json['limit'],
+        'offset': json['offset'],
+        'total': json['total'],
+        'total_supply': json['total_supply'],
+        'results': ((json['results'] as Array<any>).map(FtHolderEntryFromJSON)),
+    };
+}
+
+export function FungibleTokenHolderListToJSON(value?: FungibleTokenHolderList | null): any {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === null) {
+        return null;
+    }
+    return {
+        
+        'limit': value.limit,
+        'offset': value.offset,
+        'total': value.total,
+        'total_supply': value.total_supply,
+        'results': ((value.results as Array<any>).map(FtHolderEntryToJSON)),
+    };
+}
+

package/src/generated/models/index.ts

@@ -43,6 +43,8 @@ export * from './CoreNodeInfoResponse';
 export * from './CoreNodePoxResponse';
 export * from './FeeRate';
 export * from './FeeRateRequest';
+export * from './FtHolderEntry';
+export * from './FungibleTokenHolderList';
 export * from './GetRawTransactionResult';
 export * from './GetStxSupplyLegacyFormatResponse';
 export * from './GetStxSupplyResponse';