@alephium/web3 1.7.3 → 1.7.4

package/dist/src/api/api-alephium.d.ts

@@ -818,6 +818,90 @@ export interface RevealMnemonic {
 export interface RevealMnemonicResult {
     mnemonic: string;
 }
+/** RichAssetInput */
+export interface RichAssetInput {
+    /** @format int32 */
+    hint: number;
+    /** @format 32-byte-hash */
+    key: string;
+    /** @format hex-string */
+    unlockScript: string;
+    /** @format uint256 */
+    attoAlphAmount: string;
+    /** @format address */
+    address: string;
+    tokens: Token[];
+}
+/** RichBlockAndEvents */
+export interface RichBlockAndEvents {
+    block: RichBlockEntry;
+    events: ContractEventByBlockHash[];
+}
+/** RichBlockEntry */
+export interface RichBlockEntry {
+    /** @format block-hash */
+    hash: string;
+    /** @format int64 */
+    timestamp: number;
+    /** @format int32 */
+    chainFrom: number;
+    /** @format int32 */
+    chainTo: number;
+    /** @format int32 */
+    height: number;
+    deps: string[];
+    transactions: RichTransaction[];
+    /** @format hex-string */
+    nonce: string;
+    version: number;
+    /** @format 32-byte-hash */
+    depStateHash: string;
+    /** @format 32-byte-hash */
+    txsHash: string;
+    /** @format hex-string */
+    target: string;
+    ghostUncles: GhostUncleBlockEntry[];
+}
+/** RichBlocksAndEventsPerTimeStampRange */
+export interface RichBlocksAndEventsPerTimeStampRange {
+    blocksAndEvents: RichBlockAndEvents[][];
+}
+/** RichContractInput */
+export interface RichContractInput {
+    /** @format int32 */
+    hint: number;
+    /** @format 32-byte-hash */
+    key: string;
+    /** @format uint256 */
+    attoAlphAmount: string;
+    /** @format address */
+    address: string;
+    tokens: Token[];
+}
+/** RichTransaction */
+export interface RichTransaction {
+    unsigned: RichUnsignedTx;
+    scriptExecutionOk: boolean;
+    contractInputs: RichContractInput[];
+    generatedOutputs: Output[];
+    inputSignatures: string[];
+    scriptSignatures: string[];
+}
+/** RichUnsignedTx */
+export interface RichUnsignedTx {
+    /** @format 32-byte-hash */
+    txId: string;
+    version: number;
+    networkId: number;
+    /** @format script */
+    scriptOpt?: string;
+    /** @format int32 */
+    gasAmount: number;
+    /** @format uint256 */
+    gasPrice: string;
+    inputs: RichAssetInput[];
+    fixedOutputs: FixedAssetOutput[];
+}
 /** Script */
 export interface Script {
     code: string;
@@ -1205,7 +1289,7 @@ export declare class HttpClient<SecurityDataType = unknown> {
 }
 /**
  * @title Alephium API
- * @version 3.6.2
+ * @version 3.7.0
  * @baseUrl ../
  */
 export declare class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDataType> {
@@ -1562,6 +1646,26 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              */
             toTs?: number;
         }, params?: RequestParams) => Promise<BlocksAndEventsPerTimeStampRange>;
+        /**
+         * No description
+         *
+         * @tags Blockflow
+         * @name GetBlockflowRichBlocks
+         * @summary Given a time interval, list blocks containing events and transactions with enriched input information when node indexes are enabled.
+         * @request GET:/blockflow/rich-blocks
+         */
+        getBlockflowRichBlocks: (query: {
+            /**
+             * @format int64
+             * @min 0
+             */
+            fromTs: number;
+            /**
+             * @format int64
+             * @min 0
+             */
+            toTs?: number;
+        }, params?: RequestParams) => Promise<RichBlocksAndEventsPerTimeStampRange>;
         /**
          * No description
          *
@@ -1589,6 +1693,15 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request GET:/blockflow/blocks-with-events/{block_hash}
          */
         getBlockflowBlocksWithEventsBlockHash: (blockHash: string, params?: RequestParams) => Promise<BlockAndEvents>;
+        /**
+         * No description
+         *
+         * @tags Blockflow
+         * @name GetBlockflowRichBlocksBlockHash
+         * @summary Get a block containing events and transactions with enriched input information when node indexes are enabled.
+         * @request GET:/blockflow/rich-blocks/{block_hash}
+         */
+        getBlockflowRichBlocksBlockHash: (blockHash: string, params?: RequestParams) => Promise<RichBlockAndEvents>;
         /**
          * No description
          *

package/dist/src/api/api-alephium.js

@@ -151,7 +151,7 @@ class HttpClient {
 exports.HttpClient = HttpClient;
 /**
  * @title Alephium API
- * @version 3.6.2
+ * @version 3.7.0
  * @baseUrl ../
  */
 class Api extends HttpClient {
@@ -661,6 +661,21 @@ class Api extends HttpClient {
                 format: 'json',
                 ...params
             }).then(utils_1.convertHttpResponse),
+            /**
+             * No description
+             *
+             * @tags Blockflow
+             * @name GetBlockflowRichBlocks
+             * @summary Given a time interval, list blocks containing events and transactions with enriched input information when node indexes are enabled.
+             * @request GET:/blockflow/rich-blocks
+             */
+            getBlockflowRichBlocks: (query, params = {}) => this.request({
+                path: `/blockflow/rich-blocks`,
+                method: 'GET',
+                query: query,
+                format: 'json',
+                ...params
+            }).then(utils_1.convertHttpResponse),
             /**
              * No description
              *
@@ -703,6 +718,20 @@ class Api extends HttpClient {
                 format: 'json',
                 ...params
             }).then(utils_1.convertHttpResponse),
+            /**
+             * No description
+             *
+             * @tags Blockflow
+             * @name GetBlockflowRichBlocksBlockHash
+             * @summary Get a block containing events and transactions with enriched input information when node indexes are enabled.
+             * @request GET:/blockflow/rich-blocks/{block_hash}
+             */
+            getBlockflowRichBlocksBlockHash: (blockHash, params = {}) => this.request({
+                path: `/blockflow/rich-blocks/${blockHash}`,
+                method: 'GET',
+                format: 'json',
+                ...params
+            }).then(utils_1.convertHttpResponse),
             /**
              * No description
              *

package/dist/src/api/api-explorer.d.ts

@@ -162,6 +162,7 @@ export interface AssetOutput {
 }
 /** NFT */
 export interface NFT {
+    id: string;
     type: string;
 }
 /** AcceptedTransaction */
@@ -187,6 +188,13 @@ export interface AcceptedTransaction {
     /** @format int64 */
     timestamp: number;
 }
+/** HolderInfo */
+export interface HolderInfo {
+    /** @format address */
+    address: string;
+    /** @format uint256 */
+    balance: string;
+}
 /** TokenSupply */
 export interface TokenSupply {
     /** @format uint256 */
@@ -278,6 +286,8 @@ export declare enum TokenStdInterfaceId {
 export interface ExplorerInfo {
     releaseVersion: string;
     commit: string;
+    /** @format int64 */
+    lastHoldersUpdate: number;
     /** @format int32 */
     migrationsVersion: number;
     /** @format int64 */
@@ -323,6 +333,7 @@ export interface Transaction {
 }
 /** FungibleToken */
 export interface FungibleToken {
+    id: string;
     type: string;
 }
 /** GhostUncle */
@@ -1045,6 +1056,28 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              */
             'interface-id'?: TokenStdInterfaceId | string;
         }, params?: RequestParams) => Promise<TokenInfo[]>;
+        /**
+         * @description Get a sorted list of top addresses by {token_id} balance. Updates once per day.
+         *
+         * @tags Tokens
+         * @name GetTokensHoldersTokenTokenId
+         * @request GET:/tokens/holders/token/{token_id}
+         */
+        getTokensHoldersTokenTokenId: (tokenId: string, query?: {
+            /**
+             * Page number
+             * @format int32
+             * @min 1
+             */
+            page?: number;
+            /**
+             * Number of items per page
+             * @format int32
+             * @min 0
+             * @max 100
+             */
+            limit?: number;
+        }, params?: RequestParams) => Promise<HolderInfo[]>;
         /**
          * @description List token transactions
          *
@@ -1097,6 +1130,28 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              */
             limit?: number;
         }, params?: RequestParams) => Promise<string[]>;
+        /**
+         * @description Get a sorted list of top addresses by ALPH balance. Updates once per day.
+         *
+         * @tags Tokens
+         * @name GetTokensHoldersAlph
+         * @request GET:/tokens/holders/alph
+         */
+        getTokensHoldersAlph: (query?: {
+            /**
+             * Page number
+             * @format int32
+             * @min 1
+             */
+            page?: number;
+            /**
+             * Number of items per page
+             * @format int32
+             * @min 0
+             * @max 100
+             */
+            limit?: number;
+        }, params?: RequestParams) => Promise<HolderInfo[]>;
         /**
          * @description Return metadata for the given nft tokens, if metadata doesn't exist or token isn't a nft, it won't be in the output list
          *

package/dist/src/api/api-explorer.js

@@ -680,6 +680,20 @@ class Api extends HttpClient {
                 format: 'json',
                 ...params
             }).then(utils_1.convertHttpResponse),
+            /**
+             * @description Get a sorted list of top addresses by {token_id} balance. Updates once per day.
+             *
+             * @tags Tokens
+             * @name GetTokensHoldersTokenTokenId
+             * @request GET:/tokens/holders/token/{token_id}
+             */
+            getTokensHoldersTokenTokenId: (tokenId, query, params = {}) => this.request({
+                path: `/tokens/holders/token/${tokenId}`,
+                method: 'GET',
+                query: query,
+                format: 'json',
+                ...params
+            }).then(utils_1.convertHttpResponse),
             /**
              * @description List token transactions
              *
@@ -723,6 +737,20 @@ class Api extends HttpClient {
                 format: 'json',
                 ...params
             }).then(utils_1.convertHttpResponse),
+            /**
+             * @description Get a sorted list of top addresses by ALPH balance. Updates once per day.
+             *
+             * @tags Tokens
+             * @name GetTokensHoldersAlph
+             * @request GET:/tokens/holders/alph
+             */
+            getTokensHoldersAlph: (query, params = {}) => this.request({
+                path: `/tokens/holders/alph`,
+                method: 'GET',
+                query: query,
+                format: 'json',
+                ...params
+            }).then(utils_1.convertHttpResponse),
             /**
              * @description Return metadata for the given nft tokens, if metadata doesn't exist or token isn't a nft, it won't be in the output list
              *

package/dist/src/contract/contract.d.ts

@@ -303,7 +303,9 @@ export declare function subscribeContractEvent<F extends Fields, M extends Contr
 export declare function subscribeContractEvents(contract: Contract, instance: ContractInstance, options: EventSubscribeOptions<ContractEvent<any>>, fromCount?: number): EventSubscription;
 export declare function callMethod<I extends ContractInstance, F extends Fields, A extends Arguments, R>(contract: ContractFactory<I, F>, instance: ContractInstance, methodName: string, params: Optional<CallContractParams<A>, 'args'>, getContractByCodeHash: (codeHash: string) => Contract): Promise<CallContractResult<R>>;
 export declare function signExecuteMethod<I extends ContractInstance, F extends Fields, A extends Arguments, R>(contract: ContractFactory<I, F>, instance: ContractInstance, methodName: string, params: Optional<SignExecuteContractMethodParams<A>, 'args'>): Promise<SignExecuteScriptTxResult>;
-export declare function multicallMethods<I extends ContractInstance, F extends Fields>(contract: ContractFactory<I, F>, instance: ContractInstance, callss: Record<string, Optional<CallContractParams<any>, 'args'>>[], getContractByCodeHash: (codeHash: string) => Contract): Promise<Record<string, CallContractResult<any>>[] | Record<string, CallContractResult<any>>>;
+type Calls = Record<string, Optional<CallContractParams<any>, 'args'>>;
+export declare function multicallMethods<I extends ContractInstance, F extends Fields>(contract: ContractFactory<I, F>, instance: ContractInstance, _callss: Calls | Calls[], getContractByCodeHash: (codeHash: string) => Contract): Promise<Record<string, CallContractResult<any>>[] | Record<string, CallContractResult<any>>>;
 export declare function getContractEventsCurrentCount(contractAddress: Address): Promise<number>;
 export declare const getContractIdFromUnsignedTx: (nodeProvider: NodeProvider, unsignedTx: string) => Promise<HexString>;
 export declare const getTokenIdFromUnsignedTx: (nodeProvider: NodeProvider, unsignedTx: string) => Promise<HexString>;
+export {};

package/dist/src/contract/contract.js

@@ -1328,7 +1328,8 @@ function toFieldsSig(contractName, functionSig) {
         isMutable: [false].concat(functionSig.paramIsMutable)
     };
 }
-async function multicallMethods(contract, instance, callss, getContractByCodeHash) {
+async function multicallMethods(contract, instance, _callss, getContractByCodeHash) {
+    const callss = Array.isArray(_callss) ? _callss : [_callss];
     const callEntries = callss.map((calls) => Object.entries(calls));
     const callsParams = callEntries.map((entries) => {
         return entries.map((entry) => {
@@ -1340,7 +1341,7 @@ async function multicallMethods(contract, instance, callss, getContractByCodeHas
     });
     const result = await (0, global_1.getCurrentNodeProvider)().contracts.postContractsMulticallContract({ calls: callsParams.flat() });
     let callResultIndex = 0;
-    return callsParams.map((calls, index0) => {
+    const results = callsParams.map((calls, index0) => {
         const callsResult = {};
         const entries = callEntries[`${index0}`];
         calls.forEach((call, index1) => {
@@ -1352,6 +1353,7 @@ async function multicallMethods(contract, instance, callss, getContractByCodeHas
         });
         return callsResult;
     });
+    return Array.isArray(_callss) ? results : results[0];
 }
 exports.multicallMethods = multicallMethods;
 async function getContractEventsCurrentCount(contractAddress) {

package/dist/src/utils/utils.d.ts

@@ -33,4 +33,7 @@ export type Eq<X, Y> = _Eq<{
 }>;
 export declare function assertType<T extends true>(): void;
 export type Optional<T, K extends keyof T> = Pick<Partial<T>, K> & Omit<T, K>;
+export type Narrow<type> = (unknown extends type ? unknown : never) | (type extends Function ? type : never) | (type extends bigint | boolean | number | string ? type : never) | (type extends [] ? [] : never) | {
+    [K in keyof type]: Narrow<type[K]>;
+};
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alephium/web3",
-  "version": "1.7.3",
+  "version": "1.7.4",
   "description": "A JS/TS library to interact with the Alephium platform",
   "license": "GPL",
   "main": "dist/src/index.js",
@@ -33,8 +33,8 @@
   },
   "author": "Alephium dev <dev@alephium.org>",
   "config": {
-    "alephium_version": "3.6.2",
-    "explorer_backend_version": "2.0.0"
+    "alephium_version": "3.7.0",
+    "explorer_backend_version": "2.2.3"
   },
   "type": "commonjs",
   "dependencies": {

package/src/api/api-alephium.ts

@@ -926,6 +926,97 @@ export interface RevealMnemonicResult {
   mnemonic: string
 }
 
+/** RichAssetInput */
+export interface RichAssetInput {
+  /** @format int32 */
+  hint: number
+  /** @format 32-byte-hash */
+  key: string
+  /** @format hex-string */
+  unlockScript: string
+  /** @format uint256 */
+  attoAlphAmount: string
+  /** @format address */
+  address: string
+  tokens: Token[]
+}
+
+/** RichBlockAndEvents */
+export interface RichBlockAndEvents {
+  block: RichBlockEntry
+  events: ContractEventByBlockHash[]
+}
+
+/** RichBlockEntry */
+export interface RichBlockEntry {
+  /** @format block-hash */
+  hash: string
+  /** @format int64 */
+  timestamp: number
+  /** @format int32 */
+  chainFrom: number
+  /** @format int32 */
+  chainTo: number
+  /** @format int32 */
+  height: number
+  deps: string[]
+  transactions: RichTransaction[]
+  /** @format hex-string */
+  nonce: string
+  version: number
+  /** @format 32-byte-hash */
+  depStateHash: string
+  /** @format 32-byte-hash */
+  txsHash: string
+  /** @format hex-string */
+  target: string
+  ghostUncles: GhostUncleBlockEntry[]
+}
+
+/** RichBlocksAndEventsPerTimeStampRange */
+export interface RichBlocksAndEventsPerTimeStampRange {
+  blocksAndEvents: RichBlockAndEvents[][]
+}
+
+/** RichContractInput */
+export interface RichContractInput {
+  /** @format int32 */
+  hint: number
+  /** @format 32-byte-hash */
+  key: string
+  /** @format uint256 */
+  attoAlphAmount: string
+  /** @format address */
+  address: string
+  tokens: Token[]
+}
+
+/** RichTransaction */
+export interface RichTransaction {
+  unsigned: RichUnsignedTx
+  scriptExecutionOk: boolean
+  contractInputs: RichContractInput[]
+  generatedOutputs: Output[]
+  inputSignatures: string[]
+  scriptSignatures: string[]
+}
+
+/** RichUnsignedTx */
+export interface RichUnsignedTx {
+  /** @format 32-byte-hash */
+  txId: string
+  version: number
+  networkId: number
+  /** @format script */
+  scriptOpt?: string
+  /** @format int32 */
+  gasAmount: number
+  /** @format uint256 */
+  gasPrice: string
+  inputs: RichAssetInput[]
+  fixedOutputs: FixedAssetOutput[]
+}
+
 /** Script */
 export interface Script {
   code: string
@@ -1512,7 +1603,7 @@ export class HttpClient<SecurityDataType = unknown> {
 
 /**
  * @title Alephium API
- * @version 3.6.2
+ * @version 3.7.0
  * @baseUrl ../
  */
 export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDataType> {
@@ -2169,6 +2260,40 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
         ...params
       }).then(convertHttpResponse),
 
+    /**
+     * No description
+     *
+     * @tags Blockflow
+     * @name GetBlockflowRichBlocks
+     * @summary Given a time interval, list blocks containing events and transactions with enriched input information when node indexes are enabled.
+     * @request GET:/blockflow/rich-blocks
+     */
+    getBlockflowRichBlocks: (
+      query: {
+        /**
+         * @format int64
+         * @min 0
+         */
+        fromTs: number
+        /**
+         * @format int64
+         * @min 0
+         */
+        toTs?: number
+      },
+      params: RequestParams = {}
+    ) =>
+      this.request<
+        RichBlocksAndEventsPerTimeStampRange,
+        BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable
+      >({
+        path: `/blockflow/rich-blocks`,
+        method: 'GET',
+        query: query,
+        format: 'json',
+        ...params
+      }).then(convertHttpResponse),
+
     /**
      * No description
      *
@@ -2217,6 +2342,24 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
         ...params
       }).then(convertHttpResponse),
 
+    /**
+     * No description
+     *
+     * @tags Blockflow
+     * @name GetBlockflowRichBlocksBlockHash
+     * @summary Get a block containing events and transactions with enriched input information when node indexes are enabled.
+     * @request GET:/blockflow/rich-blocks/{block_hash}
+     */
+    getBlockflowRichBlocksBlockHash: (blockHash: string, params: RequestParams = {}) =>
+      this.request<RichBlockAndEvents, BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>(
+        {
+          path: `/blockflow/rich-blocks/${blockHash}`,
+          method: 'GET',
+          format: 'json',
+          ...params
+        }
+      ).then(convertHttpResponse),
+
     /**
      * No description
      *

package/src/api/api-explorer.ts

@@ -190,6 +190,7 @@ export interface AssetOutput {
 
 /** NFT */
 export interface NFT {
+  id: string
   type: string
 }
 
@@ -217,6 +218,14 @@ export interface AcceptedTransaction {
   timestamp: number
 }
 
+/** HolderInfo */
+export interface HolderInfo {
+  /** @format address */
+  address: string
+  /** @format uint256 */
+  balance: string
+}
+
 /** TokenSupply */
 export interface TokenSupply {
   /** @format uint256 */
@@ -317,6 +326,8 @@ export enum TokenStdInterfaceId {
 export interface ExplorerInfo {
   releaseVersion: string
   commit: string
+  /** @format int64 */
+  lastHoldersUpdate: number
   /** @format int32 */
   migrationsVersion: number
   /** @format int64 */
@@ -367,6 +378,7 @@ export interface Transaction {
 
 /** FungibleToken */
 export interface FungibleToken {
+  id: string
   type: string
 }
 
@@ -1588,6 +1600,40 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
         ...params
       }).then(convertHttpResponse),
 
+    /**
+     * @description Get a sorted list of top addresses by {token_id} balance. Updates once per day.
+     *
+     * @tags Tokens
+     * @name GetTokensHoldersTokenTokenId
+     * @request GET:/tokens/holders/token/{token_id}
+     */
+    getTokensHoldersTokenTokenId: (
+      tokenId: string,
+      query?: {
+        /**
+         * Page number
+         * @format int32
+         * @min 1
+         */
+        page?: number
+        /**
+         * Number of items per page
+         * @format int32
+         * @min 0
+         * @max 100
+         */
+        limit?: number
+      },
+      params: RequestParams = {}
+    ) =>
+      this.request<HolderInfo[], BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>({
+        path: `/tokens/holders/token/${tokenId}`,
+        method: 'GET',
+        query: query,
+        format: 'json',
+        ...params
+      }).then(convertHttpResponse),
+
     /**
      * @description List token transactions
      *
@@ -1676,6 +1722,39 @@ export class Api<SecurityDataType extends unknown> extends HttpClient<SecurityDa
         ...params
       }).then(convertHttpResponse),
 
+    /**
+     * @description Get a sorted list of top addresses by ALPH balance. Updates once per day.
+     *
+     * @tags Tokens
+     * @name GetTokensHoldersAlph
+     * @request GET:/tokens/holders/alph
+     */
+    getTokensHoldersAlph: (
+      query?: {
+        /**
+         * Page number
+         * @format int32
+         * @min 1
+         */
+        page?: number
+        /**
+         * Number of items per page
+         * @format int32
+         * @min 0
+         * @max 100
+         */
+        limit?: number
+      },
+      params: RequestParams = {}
+    ) =>
+      this.request<HolderInfo[], BadRequest | Unauthorized | NotFound | InternalServerError | ServiceUnavailable>({
+        path: `/tokens/holders/alph`,
+        method: 'GET',
+        query: query,
+        format: 'json',
+        ...params
+      }).then(convertHttpResponse),
+
     /**
      * @description Return metadata for the given nft tokens, if metadata doesn't exist or token isn't a nft, it won't be in the output list
      *