dequanto 0.2.37 → 0.2.40

package/lib/types/gen/Generator.d.ts

@@ -45,6 +45,14 @@ export declare class Generator {
         implementation: `0x${string}`;
         contractName: string;
     }>;
+    static generateFromJson(artifact: string): Promise<{
+        main: string;
+        sources: any[];
+        platform: string;
+        address: `0x${string}`;
+        implementation: `0x${string}`;
+        contractName: string;
+    }>;
     /**
      * @deprecated Was possible to generate the Contract Class based on the meta information header in TS file
      */

package/lib/types/indexer/BlocksTxIndexer.d.ts

@@ -3,13 +3,13 @@ import { Web3Client } from '../clients/Web3Client';
 import { TPlatform } from '../models/TPlatform';
 import { TEth } from '../models/TEth';
 export interface IBlocksTxIndexerOptions {
-    /** Name of the indexer */
+    /** Indexer name */
     name?: string;
-    /** Save indexer progress (visited blocks) to a file */
+    /** Saves indexer progress (visited blocks) to a file */
     persistence?: boolean;
-    /** Load transactions from the block and provide them to the visitor method */
+    /** Loads transactions from the block and provides them to the visitor method */
     loadTransactions?: boolean;
-    /** Load receipts from the block and provide them to the visitor method */
+    /** Loads receipts from the block and provides them to the visitor method */
     loadReceipts?: boolean;
     client?: Web3Client;
     logProgress?: boolean;

package/lib/types/indexer/EventsIndexer.d.ts

@@ -13,9 +13,9 @@ export declare class EventsIndexer<TContract extends ContractBase> {
         store?: IEventsIndexerStore;
         storeMeta?: IEventsIndexerMetaStore;
         fs?: {
-            /** Is used as a base directory. Later the ContractName and the address(es) hash will be appended */
+            /** Used as the base directory. Later, the contract name and address hash are appended */
             directory?: string;
-            /** The events will be splitted into multiple files by block range */
+            /** Events are split into multiple files by block range */
             rangeSeconds?: number;
             blockTimeAvg?: number;
         };
@@ -29,9 +29,9 @@ export declare class EventsIndexer<TContract extends ContractBase> {
         store?: IEventsIndexerStore;
         storeMeta?: IEventsIndexerMetaStore;
         fs?: {
-            /** Is used as a base directory. Later the ContractName and the address(es) hash will be appended */
+            /** Used as the base directory. Later, the contract name and address hash are appended */
             directory?: string;
-            /** The events will be splitted into multiple files by block range */
+            /** Events are split into multiple files by block range */
             rangeSeconds?: number;
             blockTimeAvg?: number;
         };

package/lib/types/indexer/PendingTxIndexer.d.ts

@@ -2,7 +2,7 @@ import { Web3Client } from '../clients/Web3Client';
 import { TPlatform } from '../models/TPlatform';
 import { TEth } from '../models/TEth';
 export interface IPendingTxIndexerOptions {
-    /** Name of the indexer */
+    /** Indexer name */
     name?: string;
 }
 export type TPendingTxListener = (client: Web3Client, tx: TEth.Tx) => Promise<void>;

package/lib/types/indexer/handlers/BlocksWalker.d.ts

@@ -30,8 +30,8 @@ export declare class BlocksWalker {
     constructor(params: IBlockIndexer);
     start(from?: number | Date, to?: number | Date): Promise<void>;
     /**
-     *  Can be called each time we get a new block from blockchain,
-     *  the walker will process its current blocks and up until the specified number
+     *  Can be called each time we get a new block from the blockchain,
+     *  the walker will process its current blocks up to the specified number
      *  @param nr Number is not included: [from, end)
      */
     processUntil(nr: number): Promise<any>;

package/lib/types/indexer/storage/FsEventsIndexerStore.d.ts

@@ -9,9 +9,9 @@ export declare class FsEventsIndexerStore<T extends ContractBase> implements IEv
         name?: string;
         initialBlockNumber?: number;
         fs?: {
-            /** Base directory, in case the path is calculated from chain, name and addresses */
+            /** Base directory when the path is calculated from chain, name, and addresses */
             directory?: string;
-            /** Relative final directory path to be used as is for store files */
+            /** Relative final directory path to use as is for store files */
             path?: string;
             rangeSeconds?: number;
             blockTimeAvg?: number;
@@ -28,9 +28,9 @@ export declare class FsEventsIndexerStore<T extends ContractBase> implements IEv
         name?: string;
         initialBlockNumber?: number;
         fs?: {
-            /** Base directory, in case the path is calculated from chain, name and addresses */
+            /** Base directory when the path is calculated from chain, name, and addresses */
             directory?: string;
-            /** Relative final directory path to be used as is for store files */
+            /** Relative final directory path to use as is for store files */
             path?: string;
             rangeSeconds?: number;
             blockTimeAvg?: number;

package/lib/types/ns/providers/INsProvider.d.ts

@@ -2,7 +2,7 @@ import { TAddress } from '../../models/TAddress';
 import { TPlatform } from '../../models/TPlatform';
 export interface INsProviderOptions {
     /**
-     * Loop over each chain the provider supports.
+     * Loop over each chain the provider supports
      * @default: true
      */
     multichain?: boolean;

package/lib/types/rpc/Rpc.d.ts

@@ -106,7 +106,7 @@ export declare class Rpc extends RpcBase {
     eth_accounts(): Promise<TEth.Address[]>;
     /**
      * Presents a structured data message for the user to sign. <metamask>
-     * Presents a data message for the user to sign in a structured and readable format and returns the signed response. Introduced By [EIP-712](https://eips.ethereum.org/EIPS/eip-712).
+     * Presents a data message for the user to sign in a structured and readable format and returns the signed response. Introduced by [EIP-712](https://eips.ethereum.org/EIPS/eip-712)
      * @param address - The address of the requested signing account.
      * @param typedData -
      * @returns Signature -
@@ -175,7 +175,7 @@ export declare class Rpc extends RpcBase {
      * Returns transaction base fee per gas and effective priority fee per gas for the requested/supported block range.
      * @param blockCount - Requested range of blocks. Clients will return less than the requested range if not all blocks are available.
      * @param newestBlock - Highest block of the requested range.
-     * @param rewardPercentiles - A monotonically increasing list of percentile values. For each block in the requested range, the transactions will be sorted in ascending order by effective tip per gas and the coresponding effective tip for the percentile will be determined, accounting for gas consumed.
+     * @param rewardPercentiles - A monotonically increasing list of percentile values. For each block in the requested range, the transactions will be sorted in ascending order by effective tip per gas and the corresponding effective tip for the percentile will be determined, accounting for gas consumed
      * @returns feeHistoryResult - Fee history for the returned block range. This can be a subsection of the requested range if not all blocks are available.
      */
     eth_feeHistory(blockCount: bigint, newestBlock: DataLike<RpcTypes.BlockNumberOrTag>, rewardPercentiles: number[]): Promise<{

package/lib/types/services/TimelockService/ITimelockService.d.ts

@@ -19,7 +19,7 @@ export interface ITimelockService {
     }>;
     /** Schedules-Wait-Execute a task distinguished by the unique task name
      *
-     * 1. if schedule doesn't exist, create it
+     * 1. if the schedule does not exist, create it
      * 2. if schedule date NOT yet ready, exit
      * 3. if schedule date IS ready, execute it
      * 4. if executed, exit
@@ -32,7 +32,7 @@ export interface ITimelockService {
     }>;
     /** Schedules-Wait-Execute a task distinguished by the unique task name
      *
-     * 1. if schedule doesn't exist, create it
+     * 1. if the schedule does not exist, create it
      * 2. if schedule date NOT yet ready, exit
      * 3. if schedule date IS ready, execute it
      * 4. if executed, exit

package/lib/types/services/TimelockService/TimelockService.d.ts

@@ -36,7 +36,7 @@ export declare class TimelockService implements ITimelockService {
     }>;
     /** Schedules-Wait-Execute a task distinguished by the unique task name
      *
-     * 1. if schedule doesn't exist, create it
+     * 1. if the schedule does not exist, create it
      * 2. if schedule date NOT yet ready, exit
      * 3. if schedule date IS ready, execute it
      * 4. if executed, exit
@@ -55,7 +55,7 @@ export declare class TimelockService implements ITimelockService {
     }>;
     /** Schedules-Wait-Execute a task distinguished by the unique task name
      *
-     * 1. if schedule doesn't exist, create it
+     * 1. if the schedule does not exist, create it
      * 2. if schedule date NOT yet ready, exit
      * 3. if schedule date IS ready, execute it
      * 4. if executed, exit

package/lib/types/services/TimelockService/TimelockServiceFallbackSafe.d.ts

@@ -26,7 +26,7 @@ export declare class TimelockServiceFallbackSafe implements ITimelockService {
     }>;
     /** Schedules-Wait-Execute a task distinguished by the unique task name
      *
-     * 1. if schedule doesn't exist, create it
+     * 1. if the schedule does not exist, create it
      * 2. if schedule date NOT yet ready, exit
      * 3. if schedule date IS ready, execute it
      * 4. if executed, exit
@@ -39,7 +39,7 @@ export declare class TimelockServiceFallbackSafe implements ITimelockService {
     }>;
     /** Schedules-Wait-Execute a task distinguished by the unique task name
      *
-     * 1. if schedule doesn't exist, create it
+     * 1. if the schedule does not exist, create it
      * 2. if schedule date NOT yet ready, exit
      * 3. if schedule date IS ready, execute it
      * 4. if executed, exit

package/lib/types/solidity/SlotsParser/SourceFile.d.ts

@@ -20,7 +20,7 @@ export declare class SourceFile {
     private reapplyParents;
     getImports(): Promise<TSourceFileImport[]>;
     /**
-     * @returns Inheritance chain: From base (root) class to the most derived class.
+     * @returns Inheritance chain: from the base (root) class to the most derived class
      */
     getContractInheritanceChain(name?: string): Promise<TSourceFileContract[]>;
     getContract(name?: string): Promise<ContractDefinition>;

package/lib/types/solidity/storage/SlotFixedArray.d.ts

@@ -2,7 +2,7 @@ import { ISlotVarDefinition } from '../SlotsParser/models';
 import { ASlotsStorageHandler } from './SlotsStorageHandler';
 export declare abstract class ASlotFixedArray extends ASlotsStorageHandler {
     static supports(slot: ISlotVarDefinition): boolean;
-    /** @TODO doesnt support complex arrays  */
+    /** @TODO Does not support complex arrays */
     protected getCursorFor(idx: number): Promise<{
         slot: number | bigint;
         position: number;

package/lib/types/tokens/TokenDataProvider.d.ts

@@ -18,14 +18,14 @@ export declare class TokenDataProvider {
     getToken(address: TAddress, chainLookup?: boolean): Promise<IToken>;
     getKnownToken(mix: string): Promise<IToken>;
     /**
-     *  Adds and saves the token to dequanto configuration.
+     * Adds and saves the token to the dequanto configuration
      */
     addKnownToken(token: IToken): Promise<any>;
     isNative(token: IToken): boolean;
     isNative(address: TAddress): boolean;
     isNative(symbol: string): boolean;
     getNative(platform: TPlatform): IToken;
-    /** Download tokens with various exchange/swap providers and merge them into one collection. */
+    /** Download tokens with various exchange/swap providers and merge them into one collection */
     redownload(): Promise<ITokenProvider[]>;
     getTokenByAddress(address: TAddress, chainLookup?: boolean): Promise<[IToken, ITokenProvider]>;
     getTokenBySymbol(symbol: string, chainLookup?: boolean): Promise<[IToken, ITokenProvider]>;

package/lib/types/tokens/TokensService.d.ts

@@ -21,7 +21,7 @@ export declare class TokensService {
     isNative(address: TAddress): boolean;
     isNative(symbol: string): boolean;
     getNative(platform?: TPlatform): IToken;
-    /** Download tokens with various exchange/swap providers and merge them into one collection. */
+    /** Download tokens with various exchange/swap providers and merge them into one collection */
     redownload(): Promise<ITokenProvider[]>;
     getTokenByAddress(address: TAddress, chainLookup?: boolean): Promise<[IToken, ITokenProvider]>;
     getTokenBySymbol(symbol: string, chainLookup?: boolean): Promise<[IToken, ITokenProvider]>;

package/lib/types/txs/ITxBuilderOptions.d.ts

@@ -11,7 +11,7 @@ export interface ITxBuilderNonceOptions {
      * 1: Used nonce of the first pending transaction will
      * 2: second pending transaction
      * ...
-     * In any case MAX is the count of pending transactions, so any value is safe.
+     * In any case, MAX is the count of pending transactions, so any value is safe
      */
     noncePending?: number;
 }

package/lib/types/txs/TxNonceManager.d.ts

@@ -12,7 +12,7 @@ export declare class TxNonceManager {
     protected constructor(platform: TPlatform, account: TAddress);
     static create(client: Web3Client, account: IAccount | TAddress): TxNonceManager;
     /**
-     * Pick current nonce without incrementing. TxDataBuilder will call the incrementCursor after the tx signed.
+     * Pick the current nonce without incrementing. TxDataBuilder will call incrementCursor after the tx is signed
      * */
     pickNonce(client: Web3Client): Promise<bigint>;
     incrementCursor(): void;

package/lib/types/txs/TxWriter.d.ts

@@ -40,7 +40,7 @@ export interface ITxWriterOptions {
     retries?: number;
     retryDelay?: number;
     safeTransport?: ISafeServiceTransport;
-    /** Tx Data will be saved to the store(e.g. a File), and will wait until the signature appears in the store. */
+    /** Tx data will be saved to the store, e.g. a file, and wait until the signature appears in the store */
     sigTransport?: string;
     /** Optionally disable waiting for the transport response */
     sigTransportWait?: boolean;
@@ -48,10 +48,10 @@ export interface ITxWriterOptions {
     txOutput?: string;
     /** Proceed the Tx up to the signature */
     signOnly?: boolean;
-    /** Provide a pre-signed signature for this transaction data. */
+    /** Provide a pre-signed signature for this transaction data */
     signature?: TEth.Hex;
     /**
-     * The callback is executed on error, to give the opportunity to build a new Tx to resubmit the tx.
+     * The callback is executed on error to allow building a new tx for resubmission
      * @param tx - current TxWriter object
      * @param error - current Error with receipt(if any)
      * @param errCount - num of errors already handled
@@ -64,7 +64,7 @@ export interface ITxWriterOptions {
      */
     silent?: boolean;
     /**
-     * Custom agent to process the transaction data.
+     * Custom agent to process the transaction data
      */
     agent?: ITxWriterAgent;
 }

package/lib/types/txs/receipt/TxLogParser.d.ts

@@ -7,7 +7,7 @@ export declare class TxLogParser {
     topics: TxTopicProvider;
     constructor(topics?: TxTopicProvider);
     /**
-     *  Sparse arrays will contain NULLs for unparsed log items.
+     * Sparse arrays will contain NULLs for unparsed log items
      *  Per default dense arrays - only with known logs - are returned
      */
     parse(receipt: {

package/lib/types/utils/$date.d.ts

@@ -24,7 +24,7 @@ export declare class DateTool {
     setSeconds(v: number): this;
     setMinutes(v: number): this;
     setHours(h: number, min?: number, sec?: number, ms?: number): this;
-    /** Sets the numeric day-of-the-month value of the Date object using local time. */
+    /** Sets the numeric day-of-the-month value of the Date object using local time */
     setDate(v: number): this;
     setMonth(v: number): this;
     setFullYear(v: number): this;

package/lib/types/utils/$hex.d.ts

@@ -2,7 +2,7 @@ import { TEth } from '../models/TEth';
 export declare namespace $hex {
     const ZERO = "0x";
     /**
-     * Adds '00' bytes to the hex string.
+     * Adds '00' bytes to the hex string
      * @param hex
      * @param byteSize Min bytes count in the hex string
      */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "dequanto",
-    "version": "0.2.37",
+    "version": "0.2.40",
     "author": {
         "name": "Alex Kit",
         "email": "alex.kit@atmajs.com"

package/readme.md

@@ -1,83 +1,105 @@
-# dequanto
-
-[![Documentation Link](https://img.shields.io/badge/%E2%9D%93-documentation-green.svg)](https://docs.0xweb.org/dequanto)
-[![CircleCI](https://circleci.com/gh/0xweb-org/dequanto.svg?style=svg)](https://circleci.com/gh/0xweb-org/dequanto)
-[![NPM version](https://badge.fury.io/js/dequanto.svg)](http://badge.fury.io/js/dequanto)
-
-<p align='center'>
-    <img src='assets/background.jpg'/>
-</p>
-
-
-A flexible and all-in-one library for EVM Blockchain Developers and Consumers. Based on your requirements and expertise, this library can either fully abstract the Blockchain Layer with autogenerated classes for contract communication or give you direct access to low-level methods.
-
-This library includes numerous classes to cover all facets of blockchain development. Here’s a summary of some key features:
-
-### ✨ Generate ES6 classes with TypeScript support
-
-Create contract clients based on ABI or source code, which can be automatically retrieved from blockchain explorers by address.
-
-> This can serve as an all-in-one tool for submitting transactions, querying contracts, or fetching events, as the contract clients handle the underlying steps.
-
----
-
-### 🌐 RPC Clients
-
-A robust communication layer to connect to blockchain nodes. You can add multiple nodes (private or public) to the pool to manage
-
-- **request balancing**
-- **throttling**
-- **rate limits**
-- **automatic retries**
-
-### 🏗️ Transaction Builder
-
-Provides fine-tuning for transaction submission. Supports Gnosis {Safe}, Account Abstraction Transactions and Flashbots.
-
-### 💠 Etherscan & Co Clients
-
-An integrated API for blockchain explorers.
-
-### 🔎 Event Indexer
-
-An easy-to-use indexer for fetching contract events with file persistence layer and pause-resume progress.
-
-### 👀 Event and Transaction Watcher
-
-Listen to events and monitor transactions in real-time.
-
-### 🔢 Native **`BigInt`** Types with **`BigFloat`** Support for Mantissa Math
-
-### 📦 Pre-generated OpenZeppelin Contracts
-
-
-## ⬇️ Installation
-
-### Using 0xweb CLI
-
-You can use the [0xweb](https://github.com/0xweb-org/0xweb) tool to install contracts and dependencies.
-
-### NPM
-
-Install the library using npm:
-
-```
-npm i dequanto
-```
-
-The package includes three types of source files:
-
-1. **Compiled CommonJS (CJS) Files**: Located at `node_modules/dequanto/lib/cjs/*/**.js`
-2. **Compiled ESM (Modules)**: Located at `node_modules/dequanto/lib/esm/*/**.mjs`
-3. **TypeScript Sources**: Located at `node_modules/dequanto/src/*/**.ts`
-
-Node and Build environments will automatically detect between 1 and 2 based on your project setup.
-
-
-### 🛠️ Configuration
-
-While the library includes configurations for various blockchains and {Safe} infrastructure, you may need to set custom RPC URLs, Blockchain Explorer API Keys, and other settings. This can be done in a **YAML** configuration file that loads when the application starts.
-
-----
-
-🏁 (c) 2024 0xweb.org
+# dequanto
+
+[![Documentation](https://img.shields.io/badge/documentation-green.svg)](https://docs.0xweb.org/dequanto)
+[![CircleCI](https://circleci.com/gh/0xweb-org/dequanto.svg?style=svg)](https://circleci.com/gh/0xweb-org/dequanto)
+[![NPM version](https://badge.fury.io/js/dequanto.svg)](http://badge.fury.io/js/dequanto)
+
+<p align="center">
+    <img src="assets/background.jpg" alt="dequanto" />
+</p>
+
+`dequanto` is a TypeScript toolkit for EVM development. It can generate typed contract clients from ABI or Solidity sources, submit and monitor transactions, query RPC nodes, read blockchain explorer data, index events, and work with common Ethereum data formats.
+
+The library can be used at different abstraction levels:
+
+- Use generated contract classes for typed calls, transactions, and event parsing
+- Use RPC clients directly when you need low-level node access
+- Use transaction builders for fine-grained signing and submission flows
+- Use storage, ABI, and bytecode utilities when inspecting contracts or chain data
+
+## Features
+
+### Typed Contract Clients
+
+Generate ES6/TypeScript classes from ABI, compiled artifacts, Solidity files, or verified source code fetched from blockchain explorers. Generated clients can call read methods, submit transactions, parse logs, and expose typed helpers around contract metadata.
+
+### RPC Clients
+
+Connect to one or more blockchain nodes through a shared client layer. The RPC client supports node pools, request balancing, throttling, rate limits, and automatic retries.
+
+### Transactions
+
+Build, sign, submit, and wait for transactions with lower-level control over transaction data. The transaction layer also includes support for Gnosis Safe, Account Abstraction, and Flashbots flows.
+
+### Explorer Integration
+
+Use Etherscan-compatible explorers and related APIs to fetch ABIs, source code, contract creation metadata, token data, and other chain information.
+
+### Event Indexing
+
+Fetch and persist contract events with resumable progress. The event indexer is designed for long-running indexing jobs that need file-backed state.
+
+### Watchers
+
+Subscribe to contract events and monitor transactions in real time.
+
+### Numeric Utilities
+
+Work with native `bigint` values and `BigFloat` helpers for mantissa-based math.
+
+### Prebuilt Contracts
+
+Use pre-generated TypeScript wrappers for commonly used contracts, including OpenZeppelin contracts.
+
+## Installation
+
+Install the package from npm:
+
+```bash
+npm i dequanto
+```
+
+The package ships with:
+
+- CommonJS files under `node_modules/dequanto/lib/cjs`
+- ESM files under `node_modules/dequanto/lib/esm`
+- TypeScript declarations under `node_modules/dequanto/lib/types`
+- TypeScript sources under `node_modules/dequanto/src`
+
+Node and build tools can resolve the correct entry point through the package exports.
+
+## 0xweb CLI
+
+You can also use the [0xweb](https://github.com/0xweb-org/0xweb) CLI to generate contract clients and install contract dependencies.
+
+## Configuration
+
+`dequanto` includes default configuration for several chains and Safe infrastructure. For project-specific settings, add RPC URLs, explorer API keys, and other overrides through YAML config files.
+
+## Development
+
+Useful repository commands:
+
+```bash
+npm run typecheck
+npm run build
+npm test
+```
+
+The main validation command for TypeScript changes is:
+
+```bash
+npm run typecheck -- --pretty false
+```
+
+## Documentation
+
+Full documentation is available at:
+
+```text
+https://docs.0xweb.org/dequanto
+```
+
+## License
+
+Copyright (c) 2026 0xweb.org

package/src/abi/$abiCoder.ts

@@ -60,7 +60,7 @@ export namespace $abiCoder {
             }
 
             if ('components' in abi) {
-                // unwrap array to object
+                // Unwrap the array to an object
                 let result = {};
                 for (let i = 0; i < abi.components.length; i++) {
                     let component = abi.components[i];

package/src/abi/Logger.ts

@@ -9,7 +9,7 @@ export class Logger {
     }
 
     throwArgumentError (message, localVar, value) {
-        throw new Error(`${message}: Invalid ${localVar}: ${value}`)
+        throw new Error(`${message}: invalid ${localVar}: ${value}`)
     }
 
     throwError (message, name, params) {

package/src/abi/abi-coder-packed.ts

@@ -63,14 +63,14 @@ function _pack(type: string, value: any, isArray?: boolean): Uint8Array {
         return $buffer.concat(buffers);
     }
 
-    throw new Error(`AbiCoder: Invalid type ${type}`);
+    throw new Error(`AbiCoder: invalid type ${type}`);
 }
 
-// @TODO: Array Enum
+// @TODO: Array enum
 
 /**
  *   Computes the [[link-solc-packed]] representation of %%values%%
- *   respectively to their %%types%%.
+ *   respectively to their %%types%%
  *
  *   @example:
  *       addr = "0x8ba1f109551bd432803012645ac136ddd64dba72"