@alephium/web3 0.5.0-rc.2 → 0.5.0-rc.20

package/src/api/api-explorer.ts

@@ -9,10 +9,26 @@
  * ---------------------------------------------------------------
  */
 
+export interface AcceptedTransaction {
+  /** @format 32-byte-hash */
+  hash: string
+  /** @format block-hash */
+  blockHash: string
+  /** @format int64 */
+  timestamp: number
+  inputs?: Input[]
+  outputs?: Output[]
+  /** @format int32 */
+  gasAmount: number
+  /** @format uint256 */
+  gasPrice: string
+  coinbase: boolean
+  type: string
+}
+
 export interface AddressBalance {
   /** @format uint256 */
   balance: string
-
   /** @format uint256 */
   lockedBalance: string
 }
@@ -20,10 +36,8 @@ export interface AddressBalance {
 export interface AddressInfo {
   /** @format uint256 */
   balance: string
-
   /** @format uint256 */
   lockedBalance: string
-
   /** @format int32 */
   txNumber: number
 }
@@ -31,21 +45,17 @@ export interface AddressInfo {
 export interface AssetOutput {
   /** @format int32 */
   hint: number
-
   /** @format 32-byte-hash */
   key: string
-
   /** @format uint256 */
   attoAlphAmount: string
+  /** @format address */
   address: string
   tokens?: Token[]
-
   /** @format int64 */
   lockTime?: number
-
   /** @format hex-string */
   message?: string
-
   /** @format 32-byte-hash */
   spent?: string
   type: string
@@ -58,60 +68,31 @@ export interface BadRequest {
 export interface BlockEntryLite {
   /** @format block-hash */
   hash: string
-
   /** @format int64 */
   timestamp: number
-
   /** @format int32 */
   chainFrom: number
-
   /** @format int32 */
   chainTo: number
-
   /** @format int32 */
   height: number
-
   /** @format int32 */
   txNumber: number
   mainChain: boolean
-
   /** @format bigint */
   hashRate: string
 }
 
-export interface ConfirmedTransaction {
-  /** @format 32-byte-hash */
-  hash: string
-
-  /** @format block-hash */
-  blockHash: string
-
-  /** @format int64 */
-  timestamp: number
-  inputs?: Input[]
-  outputs?: Output[]
-
-  /** @format int32 */
-  gasAmount: number
-
-  /** @format uint256 */
-  gasPrice: string
-  coinbase: boolean
-  type: string
-}
-
 export interface ContractOutput {
   /** @format int32 */
   hint: number
-
   /** @format 32-byte-hash */
   key: string
-
   /** @format uint256 */
   attoAlphAmount: string
+  /** @format address */
   address: string
   tokens?: Token[]
-
   /** @format 32-byte-hash */
   spent?: string
   type: string
@@ -120,12 +101,12 @@ export interface ContractOutput {
 export interface Event {
   /** @format block-hash */
   blockHash: string
-
   /** @format 32-byte-hash */
   txHash: string
+  /** @format address */
   contractAddress: string
+  /** @format address */
   inputAddress?: string
-
   /** @format int32 */
   eventIndex: number
   fields?: Val[]
@@ -145,14 +126,12 @@ export interface Hashrate {
 
 export interface Input {
   outputRef: OutputRef
-
   /** @format hex-string */
   unlockScript?: string
-
   /** @format 32-byte-hash */
   txHashRef?: string
+  /** @format address */
   address?: string
-
   /** @format uint256 */
   attoAlphAmount?: string
   tokens?: Token[]
@@ -178,6 +157,23 @@ export interface LogbackValue {
   level: string
 }
 
+export interface MempoolTransaction {
+  /** @format 32-byte-hash */
+  hash: string
+  /** @format int32 */
+  chainFrom: number
+  /** @format int32 */
+  chainTo: number
+  inputs?: Input[]
+  outputs?: Output[]
+  /** @format int32 */
+  gasAmount: number
+  /** @format uint256 */
+  gasPrice: string
+  /** @format int64 */
+  lastSeen: number
+}
+
 export interface NotFound {
   detail: string
   resource: string
@@ -188,18 +184,33 @@ export type Output = AssetOutput | ContractOutput
 export interface OutputRef {
   /** @format int32 */
   hint: number
-
   /** @format 32-byte-hash */
   key: string
 }
 
-export interface PerChainCount {
+export interface PendingTransaction {
+  /** @format 32-byte-hash */
+  hash: string
   /** @format int32 */
   chainFrom: number
-
   /** @format int32 */
   chainTo: number
+  inputs?: Input[]
+  outputs?: Output[]
+  /** @format int32 */
+  gasAmount: number
+  /** @format uint256 */
+  gasPrice: string
+  /** @format int64 */
+  lastSeen: number
+  type: string
+}
 
+export interface PerChainCount {
+  /** @format int32 */
+  chainFrom: number
+  /** @format int32 */
+  chainTo: number
   /** @format int64 */
   count: number
 }
@@ -207,13 +218,10 @@ export interface PerChainCount {
 export interface PerChainDuration {
   /** @format int32 */
   chainFrom: number
-
   /** @format int32 */
   chainTo: number
-
   /** @format int64 */
   duration: number
-
   /** @format int64 */
   value: number
 }
@@ -221,13 +229,10 @@ export interface PerChainDuration {
 export interface PerChainHeight {
   /** @format int32 */
   chainFrom: number
-
   /** @format int32 */
   chainTo: number
-
   /** @format int64 */
   height: number
-
   /** @format int64 */
   value: number
 }
@@ -245,7 +250,6 @@ export interface ServiceUnavailable {
 export interface TimedCount {
   /** @format int64 */
   timestamp: number
-
   /** @format int64 */
   totalCountAllChains: number
 }
@@ -253,7 +257,6 @@ export interface TimedCount {
 export interface Token {
   /** @format 32-byte-hash */
   id: string
-
   /** @format uint256 */
   amount: string
 }
@@ -261,19 +264,14 @@ export interface Token {
 export interface TokenSupply {
   /** @format int64 */
   timestamp: number
-
   /** @format uint256 */
   total: string
-
   /** @format uint256 */
   circulating: string
-
   /** @format uint256 */
   reserved: string
-
   /** @format uint256 */
   locked: string
-
   /** @format uint256 */
   maximum: string
 }
@@ -281,52 +279,25 @@ export interface TokenSupply {
 export interface Transaction {
   /** @format 32-byte-hash */
   hash: string
-
   /** @format block-hash */
   blockHash: string
-
   /** @format int64 */
   timestamp: number
   inputs?: Input[]
   outputs?: Output[]
-
   /** @format int32 */
   gasAmount: number
-
   /** @format uint256 */
   gasPrice: string
   coinbase: boolean
 }
 
-export type TransactionLike = ConfirmedTransaction | UnconfirmedTransaction
+export type TransactionLike = AcceptedTransaction | PendingTransaction
 
 export interface Unauthorized {
   detail: string
 }
 
-export interface UnconfirmedTransaction {
-  /** @format 32-byte-hash */
-  hash: string
-
-  /** @format int32 */
-  chainFrom: number
-
-  /** @format int32 */
-  chainTo: number
-  inputs?: Input[]
-  outputs?: Output[]
-
-  /** @format int32 */
-  gasAmount: number
-
-  /** @format uint256 */
-  gasPrice: string
-
-  /** @format int64 */
-  lastSeen: number
-  type: string
-}
-
 export type Val = ValAddress | ValArray | ValBool | ValByteVec | ValI256 | ValU256
 
 export interface ValAddress {
@@ -407,7 +378,8 @@ type CancelToken = Symbol | string | number
 export enum ContentType {
   Json = 'application/json',
   FormData = 'multipart/form-data',
-  UrlEncoded = 'application/x-www-form-urlencoded'
+  UrlEncoded = 'application/x-www-form-urlencoded',
+  Text = 'text/plain'
 }
 
 export class HttpClient<SecurityDataType = unknown> {
@@ -432,16 +404,16 @@ export class HttpClient<SecurityDataType = unknown> {
     this.securityData = data
   }
 
-  private encodeQueryParam(key: string, value: any) {
+  protected encodeQueryParam(key: string, value: any) {
     const encodedKey = encodeURIComponent(key)
     return `${encodedKey}=${encodeURIComponent(typeof value === 'number' ? value : `${value}`)}`
   }
 
-  private addQueryParam(query: QueryParamsType, key: string) {
+  protected addQueryParam(query: QueryParamsType, key: string) {
     return this.encodeQueryParam(key, query[key])
   }
 
-  private addArrayQueryParam(query: QueryParamsType, key: string) {
+  protected addArrayQueryParam(query: QueryParamsType, key: string) {
     const value = query[key]
     return value.map((v: any) => this.encodeQueryParam(key, v)).join('&')
   }
@@ -462,6 +434,7 @@ export class HttpClient<SecurityDataType = unknown> {
   private contentFormatters: Record<ContentType, (input: any) => any> = {
     [ContentType.Json]: (input: any) =>
       input !== null && (typeof input === 'object' || typeof input === 'string') ? JSON.stringify(input) : input,
+    [ContentType.Text]: (input: any) => (input !== null && typeof input !== 'string' ? JSON.stringify(input) : input),
     [ContentType.FormData]: (input: any) =>
       Object.keys(input || {}).reduce((formData, key) => {
         const property = input[key]
@@ -478,7 +451,7 @@ export class HttpClient<SecurityDataType = unknown> {
     [ContentType.UrlEncoded]: (input: any) => this.toQueryString(input)
   }
 
-  private mergeRequestParams(params1: RequestParams, params2?: RequestParams): RequestParams {
+  protected mergeRequestParams(params1: RequestParams, params2?: RequestParams): RequestParams {
     return {
       ...this.baseApiParams,
       ...params1,
@@ -491,7 +464,7 @@ export class HttpClient<SecurityDataType = unknown> {
     }
   }
 
-  private createAbortSignal = (cancelToken: CancelToken): AbortSignal | undefined => {
+  protected createAbortSignal = (cancelToken: CancelToken): AbortSignal | undefined => {
     if (this.abortControllers.has(cancelToken)) {
       const abortController = this.abortControllers.get(cancelToken)
       if (abortController) {
@@ -538,10 +511,10 @@ export class HttpClient<SecurityDataType = unknown> {
     return this.customFetch(`${baseUrl || this.baseUrl || ''}${path}${queryString ? `?${queryString}` : ''}`, {
       ...requestParams,
       headers: {
-        ...(type && type !== ContentType.FormData ? { 'Content-Type': type } : {}),
-        ...(requestParams.headers || {})
+        ...(requestParams.headers || {}),
+        ...(type && type !== ContentType.FormData ? { 'Content-Type': type } : {})
       },
-      signal: cancelToken ? this.createAbortSignal(cancelToken) : void 0,
+      signal: cancelToken ? this.createAbortSignal(cancelToken) : requestParams.signal,
       body: typeof body === 'undefined' || body === null ? null : payloadFormatter(body)
     }).then(async (response) => {
       const r = response as HttpResponse<T, E>
@@ -586,7 +559,23 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
      * @name GetBlocks
      * @request GET:/blocks
      */
-    getBlocks: (query?: { page?: number; limit?: number; reverse?: boolean }, params: RequestParams = {}) =>
+    getBlocks: (
+      query?: {
+        /**
+         * Page number
+         * @format int32
+         */
+        page?: number
+        /**
+         * Number of items per page
+         * @format int32
+         */
+        limit?: number
+        /** Reverse pagination */
+        reverse?: boolean
+      },
+      params: RequestParams = {}
+    ) =>
       this.request<ListBlocks, BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>({
         path: `/blocks`,
         method: 'GET',
@@ -619,7 +608,20 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
      */
     getBlocksBlockHashTransactions: (
       blockHash: string,
-      query?: { page?: number; limit?: number; reverse?: boolean },
+      query?: {
+        /**
+         * Page number
+         * @format int32
+         */
+        page?: number
+        /**
+         * Number of items per page
+         * @format int32
+         */
+        limit?: number
+        /** Reverse pagination */
+        reverse?: boolean
+      },
       params: RequestParams = {}
     ) =>
       this.request<Transaction[], BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>({
@@ -671,7 +673,20 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
      */
     getAddressesAddressTransactions: (
       address: string,
-      query?: { page?: number; limit?: number; reverse?: boolean },
+      query?: {
+        /**
+         * Page number
+         * @format int32
+         */
+        page?: number
+        /**
+         * Number of items per page
+         * @format int32
+         */
+        limit?: number
+        /** Reverse pagination */
+        reverse?: boolean
+      },
       params: RequestParams = {}
     ) =>
       this.request<Transaction[], BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>({
@@ -690,7 +705,20 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
      * @request POST:/addresses/transactions
      */
     postAddressesTransactions: (
-      query?: { page?: number; limit?: number; reverse?: boolean },
+      query?: {
+        /**
+         * Page number
+         * @format int32
+         */
+        page?: number
+        /**
+         * Number of items per page
+         * @format int32
+         */
+        limit?: number
+        /** Reverse pagination */
+        reverse?: boolean
+      },
       data?: string[],
       params: RequestParams = {}
     ) =>
@@ -713,7 +741,30 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
      */
     getAddressesAddressTimerangedTransactions: (
       address: string,
-      query: { fromTs: number; toTs: number; page?: number; limit?: number; reverse?: boolean },
+      query: {
+        /**
+         * @format int64
+         * @min 0
+         */
+        fromTs: number
+        /**
+         * @format int64
+         * @min 0
+         */
+        toTs: number
+        /**
+         * Page number
+         * @format int32
+         */
+        page?: number
+        /**
+         * Number of items per page
+         * @format int32
+         */
+        limit?: number
+        /** Reverse pagination */
+        reverse?: boolean
+      },
       params: RequestParams = {}
     ) =>
       this.request<Transaction[], BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>({
@@ -740,15 +791,18 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
       }).then(convertHttpResponse),
 
     /**
-     * @description List unconfirmed transactions of a given address
+     * @description List mempool transactions of a given address
      *
      * @tags Addresses
-     * @name GetAddressesAddressUnconfirmedTransactions
-     * @request GET:/addresses/{address}/unconfirmed-transactions
+     * @name GetAddressesAddressMempoolTransactions
+     * @request GET:/addresses/{address}/mempool/transactions
      */
-    getAddressesAddressUnconfirmedTransactions: (address: string, params: RequestParams = {}) =>
-      this.request<TransactionLike[], BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>({
-        path: `/addresses/${address}/unconfirmed-transactions`,
+    getAddressesAddressMempoolTransactions: (address: string, params: RequestParams = {}) =>
+      this.request<
+        MempoolTransaction[],
+        BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable
+      >({
+        path: `/addresses/${address}/mempool/transactions`,
         method: 'GET',
         format: 'json',
         ...params
@@ -794,7 +848,20 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
     getAddressesAddressTokensTokenIdTransactions: (
       address: string,
       tokenId: string,
-      query?: { page?: number; limit?: number; reverse?: boolean },
+      query?: {
+        /**
+         * Page number
+         * @format int32
+         */
+        page?: number
+        /**
+         * Number of items per page
+         * @format int32
+         */
+        limit?: number
+        /** Reverse pagination */
+        reverse?: boolean
+      },
       params: RequestParams = {}
     ) =>
       this.request<Transaction[], BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>({
@@ -846,7 +913,18 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
      */
     getAddressesAddressExportTransactionsCsv: (
       address: string,
-      query: { fromTs: number; toTs: number },
+      query: {
+        /**
+         * @format int64
+         * @min 0
+         */
+        fromTs: number
+        /**
+         * @format int64
+         * @min 0
+         */
+        toTs: number
+      },
       params: RequestParams = {}
     ) =>
       this.request<string, BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>({
@@ -894,7 +972,23 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
      * @name GetInfosSupply
      * @request GET:/infos/supply
      */
-    getInfosSupply: (query?: { page?: number; limit?: number; reverse?: boolean }, params: RequestParams = {}) =>
+    getInfosSupply: (
+      query?: {
+        /**
+         * Page number
+         * @format int32
+         */
+        page?: number
+        /**
+         * Number of items per page
+         * @format int32
+         */
+        limit?: number
+        /** Reverse pagination */
+        reverse?: boolean
+      },
+      params: RequestParams = {}
+    ) =>
       this.request<TokenSupply[], BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>({
         path: `/infos/supply`,
         method: 'GET',
@@ -990,20 +1084,36 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
         }
       ).then(convertHttpResponse)
   }
-  unconfirmedTransactions = {
+  mempool = {
     /**
-     * @description list unconfirmed transactions
+     * @description list mempool transactions
      *
-     * @tags Transactions
-     * @name GetUnconfirmedTransactions
-     * @request GET:/unconfirmed-transactions
+     * @tags Mempool
+     * @name GetMempoolTransactions
+     * @request GET:/mempool/transactions
      */
-    getUnconfirmedTransactions: (
-      query?: { page?: number; limit?: number; reverse?: boolean },
+    getMempoolTransactions: (
+      query?: {
+        /**
+         * Page number
+         * @format int32
+         */
+        page?: number
+        /**
+         * Number of items per page
+         * @format int32
+         */
+        limit?: number
+        /** Reverse pagination */
+        reverse?: boolean
+      },
       params: RequestParams = {}
     ) =>
-      this.request<TransactionLike[], BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>({
-        path: `/unconfirmed-transactions`,
+      this.request<
+        MempoolTransaction[],
+        BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable
+      >({
+        path: `/mempool/transactions`,
         method: 'GET',
         query: query,
         format: 'json',
@@ -1018,7 +1128,23 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
      * @name GetTokens
      * @request GET:/tokens
      */
-    getTokens: (query?: { page?: number; limit?: number; reverse?: boolean }, params: RequestParams = {}) =>
+    getTokens: (
+      query?: {
+        /**
+         * Page number
+         * @format int32
+         */
+        page?: number
+        /**
+         * Number of items per page
+         * @format int32
+         */
+        limit?: number
+        /** Reverse pagination */
+        reverse?: boolean
+      },
+      params: RequestParams = {}
+    ) =>
       this.request<string[], BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>({
         path: `/tokens`,
         method: 'GET',
@@ -1036,7 +1162,20 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
      */
     getTokensTokenIdTransactions: (
       tokenId: string,
-      query?: { page?: number; limit?: number; reverse?: boolean },
+      query?: {
+        /**
+         * Page number
+         * @format int32
+         */
+        page?: number
+        /**
+         * Number of items per page
+         * @format int32
+         */
+        limit?: number
+        /** Reverse pagination */
+        reverse?: boolean
+      },
       params: RequestParams = {}
     ) =>
       this.request<Transaction[], BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>({
@@ -1057,7 +1196,19 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
      * @request GET:/charts/hashrates
      */
     getChartsHashrates: (
-      query: { fromTs: number; toTs: number; 'interval-type': IntervalType },
+      query: {
+        /**
+         * @format int64
+         * @min 0
+         */
+        fromTs: number
+        /**
+         * @format int64
+         * @min 0
+         */
+        toTs: number
+        'interval-type': IntervalType
+      },
       params: RequestParams = {}
     ) =>
       this.request<Hashrate[], BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>({
@@ -1077,7 +1228,19 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
      * @request GET:/charts/transactions-count
      */
     getChartsTransactionsCount: (
-      query: { fromTs: number; toTs: number; 'interval-type': IntervalType },
+      query: {
+        /**
+         * @format int64
+         * @min 0
+         */
+        fromTs: number
+        /**
+         * @format int64
+         * @min 0
+         */
+        toTs: number
+        'interval-type': IntervalType
+      },
       params: RequestParams = {}
     ) =>
       this.request<TimedCount[], BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>({
@@ -1097,7 +1260,19 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
      * @request GET:/charts/transactions-count-per-chain
      */
     getChartsTransactionsCountPerChain: (
-      query: { fromTs: number; toTs: number; 'interval-type': IntervalType },
+      query: {
+        /**
+         * @format int64
+         * @min 0
+         */
+        fromTs: number
+        /**
+         * @format int64
+         * @min 0
+         */
+        toTs: number
+        'interval-type': IntervalType
+      },
       params: RequestParams = {}
     ) =>
       this.request<
@@ -1136,7 +1311,20 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
      */
     getContractEventsContractAddressContractAddress: (
       contractAddress: string,
-      query?: { page?: number; limit?: number; reverse?: boolean },
+      query?: {
+        /**
+         * Page number
+         * @format int32
+         */
+        page?: number
+        /**
+         * Number of items per page
+         * @format int32
+         */
+        limit?: number
+        /** Reverse pagination */
+        reverse?: boolean
+      },
       params: RequestParams = {}
     ) =>
       this.request<Event[], BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>({
@@ -1157,7 +1345,20 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
     getContractEventsContractAddressContractAddressInputAddressInputAddress: (
       contractAddress: string,
       inputAddress: string,
-      query?: { page?: number; limit?: number; reverse?: boolean },
+      query?: {
+        /**
+         * Page number
+         * @format int32
+         */
+        page?: number
+        /**
+         * Number of items per page
+         * @format int32
+         */
+        limit?: number
+        /** Reverse pagination */
+        reverse?: boolean
+      },
       params: RequestParams = {}
     ) =>
       this.request<Event[], BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>({