@gearbox-protocol/sdk 11.11.3 → 12.0.0-next.1

package/dist/types/plugins/adapters/contracts/TraderJoeRouterAdapterContract.d.ts

@@ -1,5 +1,5 @@
 import { type Address } from "viem";
-import type { GearboxSDK } from "../../../sdk/index.js";
+import type { ConstructOptions } from "../../../sdk/index.js";
 import type { AbstractAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 import type { TraderJoePoolVersion } from "./types.js";
@@ -344,6 +344,6 @@ export declare class TraderJoeRouterAdapterContract extends AbstractAdapterContr
         binStep: number;
         poolVersion: TraderJoePoolVersion;
     }[];
-    constructor(sdk: GearboxSDK, args: Omit<AbstractAdapterContractOptions<abi>, "abi">);
+    constructor(options: ConstructOptions, args: Omit<AbstractAdapterContractOptions<abi>, "abi">);
 }
 export {};

package/dist/types/plugins/adapters/contracts/UniswapV2AdapterContract.d.ts

@@ -1,5 +1,5 @@
 import { type Address, type DecodeFunctionDataReturnType } from "viem";
-import type { GearboxSDK } from "../../../sdk/index.js";
+import type { ConstructOptions } from "../../../sdk/index.js";
 import type { AbstractAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 declare const abi: readonly [{
@@ -210,7 +210,7 @@ export declare class UniswapV2AdapterContract extends AbstractAdapterContract<ab
         token0: Address;
         token1: Address;
     }[];
-    constructor(sdk: GearboxSDK, args: Omit<AbstractAdapterContractOptions<abi>, "abi">);
-    protected parseFunctionParams(params: DecodeFunctionDataReturnType<abi>): string[] | undefined;
+    constructor(options: ConstructOptions, args: Omit<AbstractAdapterContractOptions<abi>, "abi">);
+    protected stringifyFunctionParams(params: DecodeFunctionDataReturnType<abi>): string[];
 }
 export {};

package/dist/types/plugins/adapters/contracts/UniswapV3AdapterContract.d.ts

@@ -1,5 +1,5 @@
 import { type Address, type DecodeFunctionDataReturnType } from "viem";
-import type { GearboxSDK } from "../../../sdk/index.js";
+import type { ConstructOptions } from "../../../sdk/index.js";
 import type { AbstractAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 declare const abi: readonly [{
@@ -376,8 +376,8 @@ export declare class UniswapV3AdapterContract extends AbstractAdapterContract<ab
         token1: Address;
         fee: number;
     }[];
-    constructor(sdk: GearboxSDK, args: Omit<AbstractAdapterContractOptions<abi>, "abi">);
-    protected parseFunctionParams(params: DecodeFunctionDataReturnType<abi>): string[] | undefined;
+    constructor(options: ConstructOptions, args: Omit<AbstractAdapterContractOptions<abi>, "abi">);
+    protected stringifyFunctionParams(params: DecodeFunctionDataReturnType<abi>): string[];
     private trackInputPath;
     private trackOutputPath;
 }

package/dist/types/plugins/adapters/contracts/UniswapV4AdapterContract.d.ts

@@ -1,5 +1,5 @@
 import { type Address } from "viem";
-import type { GearboxSDK } from "../../../sdk/index.js";
+import type { ConstructOptions } from "../../../sdk/index.js";
 import type { AbstractAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 declare const abi: readonly [{
@@ -315,6 +315,6 @@ export declare class UniswapV4AdapterContract extends AbstractAdapterContract<ab
         tickSpacing: number;
         hooks: Address;
     }[];
-    constructor(sdk: GearboxSDK, args: Omit<AbstractAdapterContractOptions<abi>, "abi">);
+    constructor(options: ConstructOptions, args: Omit<AbstractAdapterContractOptions<abi>, "abi">);
 }
 export {};

package/dist/types/plugins/adapters/contracts/UpshiftVaultAdapterContract.d.ts

@@ -1,5 +1,5 @@
 import { type Address } from "viem";
-import type { GearboxSDK } from "../../../sdk/index.js";
+import type { ConstructOptions } from "../../../sdk/index.js";
 import type { AbstractAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 declare const abi: readonly [{
@@ -278,6 +278,6 @@ export declare class UpshiftVaultAdapterContract extends AbstractAdapterContract
     readonly vault: Address;
     readonly asset: Address;
     readonly stakedPhantomToken: Address;
-    constructor(sdk: GearboxSDK, args: Omit<AbstractAdapterContractOptions<abi>, "abi">);
+    constructor(options: ConstructOptions, args: Omit<AbstractAdapterContractOptions<abi>, "abi">);
 }
 export {};

package/dist/types/plugins/adapters/contracts/VelodromeV2AdapterContract.d.ts

@@ -1,5 +1,5 @@
 import { type Address } from "viem";
-import type { GearboxSDK } from "../../../sdk/index.js";
+import type { ConstructOptions } from "../../../sdk/index.js";
 import type { AbstractAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 declare const abi: readonly [{
@@ -242,6 +242,6 @@ export declare class VelodromeV2RouterAdapterContract extends AbstractAdapterCon
         stable: boolean;
         factory: Address;
     }[];
-    constructor(sdk: GearboxSDK, args: Omit<AbstractAdapterContractOptions<abi>, "abi">);
+    constructor(options: ConstructOptions, args: Omit<AbstractAdapterContractOptions<abi>, "abi">);
 }
 export {};

package/dist/types/plugins/adapters/contracts/WstETHV1AdapterContract.d.ts

@@ -1,5 +1,5 @@
 import { type Address } from "viem";
-import type { GearboxSDK } from "../../../sdk/index.js";
+import type { ConstructOptions } from "../../../sdk/index.js";
 import type { AbstractAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 declare const abi: readonly [{
@@ -122,6 +122,6 @@ declare const abi: readonly [{
 type abi = typeof abi;
 export declare class WstETHV1AdapterContract extends AbstractAdapterContract<abi> {
     readonly stETH: Address;
-    constructor(sdk: GearboxSDK, args: Omit<AbstractAdapterContractOptions<abi>, "abi">);
+    constructor(options: ConstructOptions, args: Omit<AbstractAdapterContractOptions<abi>, "abi">);
 }
 export {};

package/dist/types/plugins/adapters/contracts/YearnV2AdapterContract.d.ts

@@ -1,5 +1,5 @@
 import { type Address } from "viem";
-import type { GearboxSDK } from "../../../sdk/index.js";
+import type { ConstructOptions } from "../../../sdk/index.js";
 import type { AbstractAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 declare const abi: readonly [{
@@ -180,6 +180,6 @@ declare const abi: readonly [{
 type abi = typeof abi;
 export declare class YearnV2RouterAdapterContract extends AbstractAdapterContract<abi> {
     readonly token: Address;
-    constructor(sdk: GearboxSDK, args: Omit<AbstractAdapterContractOptions<abi>, "abi">);
+    constructor(options: ConstructOptions, args: Omit<AbstractAdapterContractOptions<abi>, "abi">);
 }
 export {};

package/dist/types/plugins/bots/BotsPlugin.d.ts

@@ -1,23 +1,13 @@
-import { type Address } from "viem";
 import type { IGearboxSDKPlugin } from "../../sdk/index.js";
-import { AddressMap, BasePlugin } from "../../sdk/index.js";
-import { PartialLiquidationBotV300Contract } from "./PartialLiquidationBotV300Contract.js";
+import { BasePlugin } from "../../sdk/index.js";
 import { PartialLiquidationBotV310Contract } from "./PartialLiquidationBotV310Contract.js";
-import { type BotParameters, type BotState, type BotsPluginState, type BotsPluginStateHuman, type MigrationBotState } from "./types.js";
-export declare class UnsupportedBotVersionError extends Error {
-    readonly state: BotState;
-    constructor(state: BotState);
-}
-export type PartialLiquidationBotContract = PartialLiquidationBotV300Contract | PartialLiquidationBotV310Contract;
+import { type BotsPluginState, type BotsPluginStateHuman, type MigrationBotState } from "./types.js";
 export declare class BotsPlugin extends BasePlugin<BotsPluginState> implements IGearboxSDKPlugin<BotsPluginState> {
     #private;
     get loaded(): boolean;
+    get bots(): PartialLiquidationBotV310Contract[];
     load(force?: boolean): Promise<BotsPluginState>;
-    findDeployedPartialLiquidationBots(): Promise<AddressMap<BotParameters>>;
     stateHuman(raw?: boolean): BotsPluginStateHuman;
-    get botsByMarket(): AddressMap<PartialLiquidationBotContract[]>;
-    botsByMarketConfigurator(mc: Address): PartialLiquidationBotContract[];
-    get allBots(): PartialLiquidationBotContract[];
     get state(): BotsPluginState;
     hydrate(state: BotsPluginState): void;
     static getMigrationBotData(chainId: number): MigrationBotState | undefined;

package/dist/types/plugins/bots/PartialLiquidationBotV310Contract.d.ts

@@ -1,7 +1,6 @@
-import type { Address } from "abitype";
-import type { GearboxSDK } from "../../sdk/index.js";
-import { PartialLiquidationBotBaseContract } from "./PartialLiquidationBotBaseContract.js";
-import type { BotState } from "./types.js";
+import { type Address, type Hex } from "viem";
+import { BaseContract, type GearboxSDK } from "../../sdk/index.js";
+import { type BotStateV310Human } from "./types.js";
 declare const abi: readonly [{
     readonly type: "function";
     readonly name: "contractType";
@@ -193,7 +192,21 @@ declare const abi: readonly [{
     readonly inputs: readonly [];
 }];
 type abi = typeof abi;
-export declare class PartialLiquidationBotV310Contract extends PartialLiquidationBotBaseContract<abi> {
-    constructor(sdk: GearboxSDK, args: BotState, marketConfigurator: Address);
+export interface PartialLiquidationBotV310Params {
+    addr: Address;
+    version: bigint;
+    contractType: string;
+    serializedParams: Hex;
+}
+export declare class PartialLiquidationBotV310Contract extends BaseContract<abi> {
+    #private;
+    readonly treasury: Address;
+    readonly minHealthFactor: number;
+    readonly maxHealthFactor: number;
+    readonly premiumScaleFactor: number;
+    readonly feeScaleFactor: number;
+    constructor(sdk: GearboxSDK, args: PartialLiquidationBotV310Params);
+    stateHuman(raw?: boolean): BotStateV310Human;
+    get state(): PartialLiquidationBotV310Params;
 }
 export {};

package/dist/types/plugins/bots/deserializePartialLiquidationBotParams.d.ts

@@ -0,0 +1,3 @@
+import type { BaseParams } from "../../sdk/index.js";
+import type { BotParameters } from "./types.js";
+export default function deserializePartialLiquidationBotParams(params: Pick<BaseParams, "serializedParams">): BotParameters;

package/dist/types/plugins/bots/index.d.ts

@@ -1,6 +1,5 @@
 export * from "./abi/index.js";
 export * from "./BotsPlugin.js";
 export * from "./config.js";
-export * from "./PartialLiquidationBotV300Contract.js";
 export * from "./PartialLiquidationBotV310Contract.js";
 export * from "./types.js";

package/dist/types/plugins/bots/types.d.ts

@@ -1,8 +1,6 @@
-import type { AbiParametersToPrimitiveTypes, ExtractAbiFunction } from "abitype";
 import type { Address } from "viem";
-import type { peripheryCompressorAbi } from "../../abi/compressors/peripheryCompressor.js";
-import type { BaseContractStateHuman, Unarray } from "../../sdk/index.js";
-export type BotState = Unarray<AbiParametersToPrimitiveTypes<ExtractAbiFunction<typeof peripheryCompressorAbi, "getBots">["outputs"]>>;
+import type { BaseContractStateHuman } from "../../sdk/index.js";
+import type { PartialLiquidationBotV310Params } from "./PartialLiquidationBotV310Contract.js";
 export interface BotParameters {
     treasury: Address;
     minHealthFactor: number;
@@ -10,6 +8,7 @@ export interface BotParameters {
     premiumScaleFactor: number;
     feeScaleFactor: number;
 }
+export declare const BOT_PARTIAL_LIQUIDATION = "BOT::PARTIAL_LIQUIDATION";
 export declare const BOT_PARAMS_ABI: readonly [{
     readonly type: "address";
     readonly name: "treasury";
@@ -26,32 +25,20 @@ export declare const BOT_PARAMS_ABI: readonly [{
     readonly type: "uint16";
     readonly name: "feeScaleFactor";
 }];
-export declare const LIQUIDATION_BOT_TYPES: readonly ["PARTIAL_LIQUIDATION_BOT", "DELEVERAGE_BOT_PEGGED", "DELEVERAGE_BOT_LV", "DELEVERAGE_BOT_HV"];
-export type LiquidationBotType = (typeof LIQUIDATION_BOT_TYPES)[number];
-export interface BotStateBaseHuman extends BaseContractStateHuman {
+export interface BotStateV310Human extends BaseContractStateHuman {
     treasury: Address;
     minHealthFactor: string;
     maxHealthFactor: string;
     premiumScaleFactor: string;
     feeScaleFactor: string;
-    requiredPermissions: string;
 }
-export interface BotStateV300Human extends BotStateBaseHuman {
-    botType: LiquidationBotType;
-}
-export type BotStateV310Human = BotStateBaseHuman;
-export type BotStateHuman = BotStateV300Human | BotStateV310Human;
+export type BotStateHuman = BotStateV310Human;
+export type BotState = PartialLiquidationBotV310Params;
 export interface BotsPluginStateHuman {
-    /**
-     * Mapping market configurator to bot states
-     */
-    bots: Record<string, BotStateHuman[]>;
+    bots: BotStateHuman[];
 }
 export interface BotsPluginState {
-    /**
-     * Mapping market configurator address to bot states
-     */
-    bots: Record<Address, BotState[]>;
+    bots: BotState[];
 }
 export type BotBaseType = "LIQUIDATION_PROTECTION" | "MIGRATION";
 export declare const MIGRATION_BOT_TYPES: readonly ["MIGRATION_BOT"];

package/dist/types/sdk/GearboxSDK.d.ts

@@ -1,8 +1,8 @@
-import type { Address, Hex } from "viem";
+import type { Address } from "viem";
 import { type PublicClient, type Transport } from "viem";
 import type { HttpRpcClientOptions } from "viem/utils";
-import type { BaseContract, BaseState, IBaseContract } from "./base/index.js";
-import { AddressLabeller, TokensMeta } from "./base/index.js";
+import type { BaseState, IBaseContract } from "./base/index.js";
+import { ChainContractsRegister } from "./base/index.js";
 import type { GearboxChain, NetworkType } from "./chain/chains.js";
 import type { VersionRange } from "./constants/index.js";
 import type { IAddressProviderContract } from "./core/index.js";
@@ -12,8 +12,7 @@ import { PriceFeedRegister } from "./market/pricefeeds/index.js";
 import type { SDKOptions } from "./options.js";
 import { type PluginsMap } from "./plugins/index.js";
 import { type IRouterContract } from "./router/index.js";
-import type { GearboxState, GearboxStateHuman, ILogger, MultiCall } from "./types/index.js";
-import { AddressMap } from "./utils/index.js";
+import type { GearboxState, GearboxStateHuman } from "./types/index.js";
 /**
  * State version, checked duryng hydration
  */
@@ -64,29 +63,14 @@ export type SDKHooks = {
     syncState: [SyncStateOptions];
     rehydrate: [SyncStateOptions];
 };
-export declare class GearboxSDK<const Plugins extends PluginsMap = {}> {
+export declare class GearboxSDK<const Plugins extends PluginsMap = {}> extends ChainContractsRegister {
     #private;
     readonly plugins: Plugins;
-    readonly logger?: ILogger;
     readonly gasLimit: bigint | undefined;
-    readonly addressLabels: AddressLabeller;
-    /**
-     * Interest rate models can be reused across chain (and SDK operates on chain level)
-     * TODO: use whatever interface is necessary for InterestRateModels
-     */
-    readonly interestRateModels: AddressMap<BaseContract<readonly unknown[]>>;
     /**
      * Will throw an error if contract type is not supported, otherwise will try to use generic contract first, if possible
      */
     readonly strictContractTypes: boolean;
-    /**
-     * All contracts known to sdk
-     */
-    readonly contracts: AddressMap<BaseContract<any>>;
-    /**
-     * Token metadata such as symbol and decimals
-     */
-    readonly tokensMeta: TokensMeta;
     addHook: <K extends keyof SDKHooks>(hookName: K, fn: (...args: SDKHooks[K]) => void | Promise<void>) => void;
     removeHook: <K extends keyof SDKHooks>(hookName: K, fn: (...args: SDKHooks[K]) => void | Promise<void>) => void;
     static attach<const Plugins extends PluginsMap>(options: SDKOptions<Plugins> & ClientOptions & Partial<NetworkOptions>): Promise<GearboxSDK<Plugins>>;
@@ -101,56 +85,7 @@ export declare class GearboxSDK<const Plugins extends PluginsMap = {}> {
      * Rehydrate existing SDK from new state without re-creating instance
      */
     rehydrate(state: GearboxState<Plugins>): Promise<void>;
-    get client(): PublicClient<Transport, GearboxChain>;
-    /**
-     * Replaces client inflight
-     * You're responsible for all inconsistencies between new and old client
-     * @param options
-     */
-    replaceClient(options: ClientOptions, network?: NetworkOptions): void;
     get networkType(): NetworkType;
-    get chain(): GearboxChain;
-    get chainId(): number;
-    /**
-     * Converts contract call into some human-friendly string
-     * This method is safe and should not throw
-     * @param address
-     * @param calldata
-     * @returns
-     */
-    parseFunctionData(address: Address, calldata: Hex): string;
-    /**
-     * Converts multicalls into some human-friendly strings
-     * This method is safe and should not throw
-     * @param address
-     * @param calldata
-     * @returns
-     */
-    parseMultiCall(calls: MultiCall[]): string[];
-    /**
-     * Return args, function, type and address name from contract call
-     * @param address
-     * @param calldata
-     * @returns
-     */
-    parseFunctionDataToObject(address: Address, calldata: Hex): {
-        address: `0x${string}`;
-        type: string;
-        args: any[];
-        functionName: any;
-    } | null;
-    /**
-     * Converts multicalls into call info
-     * @param address
-     * @param calldata
-     * @returns
-     */
-    parseMultiCallToObject(calls: MultiCall[]): ({
-        address: `0x${string}`;
-        type: string;
-        args: any[];
-        functionName: any;
-    } | null)[];
     stateHuman(raw?: boolean): GearboxStateHuman;
     get state(): GearboxState<Plugins>;
     /**
@@ -180,10 +115,4 @@ export declare class GearboxSDK<const Plugins extends PluginsMap = {}> {
     } | {
         creditFacade: Address | BaseState | IBaseContract;
     } | VersionRange): IRouterContract;
-    /**
-     * Helper to get human-friendly label for address
-     * @param address
-     * @returns
-     */
-    labelAddress(address: Address): string;
 }

package/dist/types/sdk/accountMigration/types.d.ts

@@ -1,6 +1,5 @@
 import type { Address, GetContractReturnType, PublicClient, WalletClient } from "viem";
 import type { accountMigratorPreviewerV310Abi } from "../../abi/migration.js";
-import type { SDKConstruct } from "../base/SDKConstruct.js";
 import type { Asset, RouterCASlice } from "../router/index.js";
 export interface MigrateCreditAccountProps {
     /**
@@ -47,7 +46,7 @@ export interface PreviewCreditAccountMigrationProps {
     expectedTargetQuota: Array<Asset>;
 }
 export type PreviewMigrationResult = Awaited<ReturnType<GetContractReturnType<typeof accountMigratorPreviewerV310Abi, PublicClient>["simulate"]["previewMigration"]>>["result"];
-export interface IMigrateCreditAccountsService extends SDKConstruct {
+export interface IMigrateCreditAccountsService {
     /**
      * Preview delayed withdrawal for a given credit account
      * @param props - {@link PreviewCreditAccountMigrationProps}

package/dist/types/sdk/accounts/types.d.ts

@@ -1,8 +1,8 @@
 import type { Address, ContractFunctionArgs, GetContractReturnType, Hex, PublicClient } from "viem";
 import type { creditAccountCompressorAbi } from "../../abi/compressors/creditAccountCompressor.js";
 import type { iWithdrawalCompressorV310Abi } from "../../abi/IWithdrawalCompressorV310.js";
-import type { ConnectedBotData, CreditAccountData } from "../base/index.js";
-import type { SDKConstruct } from "../base/SDKConstruct.js";
+import type { ConnectedBotData, Construct, CreditAccountData } from "../base/index.js";
+import type { GearboxSDK } from "../GearboxSDK.js";
 import type { CreditSuite, OnDemandPriceUpdates, PriceUpdateV300, PriceUpdateV310, UpdatePriceFeedsResult } from "../market/index.js";
 import type { Asset, CreditAccountTokensSlice, RouterCASlice, RouterCloseResult } from "../router/index.js";
 import type { MultiCall, RawTx } from "../types/index.js";
@@ -407,7 +407,8 @@ export type GetConnectedMigrationBotsResult = {
     })[];
     botAddress: Address;
 } | undefined;
-export interface ICreditAccountsService extends SDKConstruct {
+export interface ICreditAccountsService extends Construct {
+    sdk: GearboxSDK;
     /**
      * Returns single credit account data, or undefined if it's not found
      * Performs all necessary price feed updates under the hood

package/dist/types/sdk/base/BaseContract.d.ts

@@ -1,58 +1,102 @@
-import type { Abi, Address, Client, ContractEventName, ContractFunctionName, DecodeFunctionDataReturnType, EncodeFunctionDataParameters, GetContractReturnType, Hex, Log } from "viem";
-import type { GearboxSDK } from "../GearboxSDK.js";
-import type { BaseContractStateHuman, ILogger, RawTx } from "../types/index.js";
-import { SDKConstruct } from "./SDKConstruct.js";
-export interface BaseContractOptions<abi extends Abi | readonly unknown[]> {
+import type { Abi, Address, Chain, ContractEventName, ContractFunctionName, DecodeFunctionDataReturnType, EncodeFunctionDataParameters, GetContractReturnType, Hex, Log, PublicClient, Transport } from "viem";
+import { BaseError, type ContractEventArgs, type GetContractEventsReturnType } from "viem";
+import type { BaseContractStateHuman, RawTx } from "../types/index.js";
+import { Construct, type ConstructOptions } from "./Construct.js";
+import type { IBaseContract, ParsedCall, ParsedCallArgs } from "./types.js";
+export interface BaseContractArgs<abi extends Abi | readonly unknown[]> {
     abi: abi;
     addr: Address;
     name?: string;
     version?: number | bigint;
     contractType?: string;
 }
-export interface IBaseContract {
+export interface ContractParseErrorOptions {
     address: Address;
-    contractType: string;
-    version: number;
-    name: string;
-    dirty: boolean;
+    callData: Hex;
+    contractName?: string;
 }
-export declare abstract class BaseContract<abi extends Abi | readonly unknown[]> extends SDKConstruct implements IBaseContract {
-    #private;
-    readonly contract: GetContractReturnType<abi, {
-        public: Client;
-    }, Address>;
+export declare class ContractParseError extends BaseError {
+    readonly address: Address;
+    readonly callData: Hex;
+    readonly selector: Hex;
+    constructor(cause: Error, options: ContractParseErrorOptions);
+}
+export declare class BaseContract<abi extends Abi | readonly unknown[]> extends Construct implements IBaseContract {
+    readonly contract: GetContractReturnType<abi, PublicClient<Transport, Chain>, Address>;
     readonly abi: abi;
-    readonly logger?: ILogger;
     readonly contractType: string;
-    version: number;
-    constructor(sdk: GearboxSDK, args: BaseContractOptions<abi>);
-    get address(): Address;
-    set address(address: Address);
-    get name(): string;
-    set name(name: string);
+    readonly version: number;
+    readonly address: Address;
+    readonly name: string;
+    constructor({ client, logger }: ConstructOptions, args: BaseContractArgs<abi>);
     stateHuman(_?: boolean): BaseContractStateHuman;
     /**
      * Updates (or not) contract's internal state from event
      * @param _log
      */
     processLog(_log: Log<bigint, number, false, undefined, undefined, abi, ContractEventName<abi>>): void;
+    /**
+     * Return parsed args and function name from calldata belonging to this contract
+     * Target of the call is always this contract, but args can be parsed into calls to other contracts (de-facto recursive ParsedCall)
+     * @param calldata
+     * @returns
+     */
+    parseFunctionData(calldata: Hex): ParsedCall;
+    /**
+     * Same as {@link parseFunctionData}, but throws {@link ContractParseError} if error occurs
+     * @param callData
+     * @returns
+     */
+    mustParseFunctionData(callData: Hex): ParsedCall;
+    /**
+     * Parses viem-decoded contract function arguments to a map of named arguments
+     * This default implementation uses abi-based parsing, you can override it,
+     * but use this super implementation as fallback
+     * @param params
+     * @returns
+     */
+    protected parseFunctionParams(params: DecodeFunctionDataReturnType<abi>): ParsedCallArgs;
     /**
      * Converts contract calldata to some human-friendly string
      * This is safe function which should not throw
      * @param calldata
      * @returns
      */
-    parseFunctionData(calldata: Hex): string;
-    mustParseFunctionData(calldata: Hex): string;
+    stringifyFunctionData(calldata: Hex): string;
     /**
-     * Return args and function name from calldata
+     * Same as {@link stingifyFunctionData}, but throws if error occurs
      * @param calldata
      * @returns
      */
-    parseFunctionDataToObject(calldata: Hex): DecodeFunctionDataReturnType<abi, ContractFunctionName<abi, import("viem").AbiStateMutability>>;
-    protected parseFunctionParams(_params: DecodeFunctionDataReturnType<abi>): Array<string> | undefined;
-    getVersion(): Promise<number>;
+    mustStringifyFunctionData(calldata: Hex): string;
+    /**
+     * Pretty-prints values of function arguments (do not include parameter names)
+     * Can be overriden in classes, but use this super implementation as fallback
+     *
+     * @param decoded - Function arguments decoded by viem
+     * @returns
+     */
+    protected stringifyFunctionParams(decoded: DecodeFunctionDataReturnType<abi>): string[];
+    protected wrapParseCall(functionName: string, args: Record<string, string>): ParsedCall;
+    /**
+     * Creates a raw transaction for a function in this contract
+     * @param parameters
+     * @returns
+     */
     createRawTx<functionName extends ContractFunctionName<abi> | undefined = undefined>(parameters: Omit<EncodeFunctionDataParameters<abi, functionName>, "abi"> & {
         description?: string;
     }): RawTx;
+    /**
+     * Get events in safe manner, by bisecting block range if needed
+     *
+     * @deprecated TODO: this should be moved to viem transport
+     *
+     * @param eventName
+     * @param fromBlock
+     * @param toBlock
+     * @param args
+     * @param chunkSize
+     * @returns
+     */
+    getEvents<EventName extends ContractEventName<abi>>(eventName: EventName, fromBlock: bigint, toBlock: bigint, args?: ContractEventArgs<abi, EventName extends ContractEventName<abi> ? EventName : ContractEventName<abi>> | undefined, chunkSize?: number): Promise<GetContractEventsReturnType<abi, EventName, undefined, bigint, bigint>>;
 }

package/dist/types/sdk/base/ChainContractsRegister.d.ts

@@ -0,0 +1,57 @@
+import type { Abi, Address, Chain, Hex, PublicClient, Transport } from "viem";
+import type { MultiCall } from "../types/index.js";
+import type { ILogger } from "../types/logger.js";
+import type { BaseContract } from "./BaseContract.js";
+import { TokensMeta } from "./TokensMeta.js";
+import type { ParsedCall } from "./types.js";
+export type ContractOrInterface<T> = T extends Abi | readonly unknown[] ? BaseContract<T> : T;
+export declare class ChainContractsRegister {
+    #private;
+    static for(client: PublicClient<Transport, Chain>, logger?: ILogger): ChainContractsRegister;
+    private readonly contracts;
+    private readonly labels;
+    readonly client: PublicClient<Transport, Chain>;
+    /**
+     * Token metadata such as symbol and decimals
+     */
+    readonly tokensMeta: TokensMeta;
+    readonly logger?: ILogger;
+    constructor(client: PublicClient<Transport, Chain>, logger?: ILogger);
+    getContract<T = unknown[]>(address: Address): ContractOrInterface<T> | undefined;
+    mustGetContract<T = unknown[]>(address: Address): ContractOrInterface<T>;
+    setContract(address: Address, contract: BaseContract<any>): void;
+    setAddressLabel(address: Address, label: string | ((oldLabel?: string) => string)): void;
+    labelAddress(address: Address): string;
+    get chain(): Chain;
+    get chainId(): number;
+    /**
+     * Converts contract call into some human-friendly string
+     * This method is safe and should not throw
+     * @param address
+     * @param calldata
+     * @returns
+     */
+    stringifyFunctionData(address: Address, calldata: Hex): string;
+    /**
+     * Converts multicalls into some human-friendly strings
+     * This method is safe and should not throw
+     * @param address
+     * @param calldata
+     * @returns
+     */
+    stringifyMultiCall(calls: MultiCall[]): string[];
+    /**
+     * Return args, function, type and address name from contract call
+     * @param address
+     * @param calldata
+     * @returns
+     */
+    parseFunctionData(address: Address, calldata: Hex): ParsedCall;
+    /**
+     * Converts multicalls into call info
+     * @param address
+     * @param calldata
+     * @returns
+     */
+    parseMultiCall(calls: MultiCall[]): ParsedCall[];
+}

package/dist/types/sdk/base/Construct.d.ts

@@ -0,0 +1,38 @@
+import type { Address, Chain, PublicClient, Transport } from "viem";
+import type { NetworkType } from "../chain/index.js";
+import type { ILogger } from "../types/index.js";
+import { ChainContractsRegister } from "./ChainContractsRegister.js";
+import type { TokensMeta } from "./TokensMeta.js";
+export interface ConstructOptions {
+    client: PublicClient<Transport, Chain>;
+    logger?: ILogger;
+}
+export declare class Construct {
+    #private;
+    readonly logger?: ILogger;
+    readonly client: PublicClient<Transport, Chain>;
+    readonly register: ChainContractsRegister;
+    constructor({ client, logger }: ConstructOptions);
+    get chain(): Chain;
+    get chainId(): number;
+    get networkType(): NetworkType;
+    /**
+     * Indicates that contract state diverged from onchain state and needs to be updated
+     */
+    get dirty(): boolean;
+    protected set dirty(value: boolean);
+    /**
+     * Syntax sugar for rgister.tokensMeta
+     */
+    protected get tokensMeta(): TokensMeta;
+    /**
+     * Syntax suggar for getting contract labels
+     * @param address
+     * @returns
+     */
+    protected labelAddress(address: Address): string;
+    /**
+     * Returns list of addresses that should be watched for events to sync state
+     */
+    get watchAddresses(): Set<Address>;
+}