@gearbox-protocol/sdk 11.12.0 → 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/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/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>;
+}

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

@@ -1,9 +1,9 @@
 import type { GearboxSDK } from "../GearboxSDK.js";
-import type { BaseContractOptions } from "./BaseContract.js";
+import type { BaseContractArgs } from "./BaseContract.js";
 import { BaseContract } from "./BaseContract.js";
 declare const abi: unknown[];
 type abi = typeof abi;
 export declare class PlaceholderContract extends BaseContract<abi> {
-    constructor(sdk: GearboxSDK, args: Omit<BaseContractOptions<abi>, "abi">);
+    constructor(sdk: GearboxSDK, args: Omit<BaseContractArgs<abi>, "abi">);
 }
 export {};

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

@@ -1,21 +1,7 @@
-import type { Address, PublicClient } from "viem";
-import type { NetworkType } from "../chain/index.js";
 import type { GearboxSDK } from "../GearboxSDK.js";
 import type { PluginsMap } from "../plugins/index.js";
-export declare class SDKConstruct<const Plugins extends PluginsMap = {}> {
-    #private;
+import { Construct } from "./Construct.js";
+export declare class SDKConstruct<const Plugins extends PluginsMap = {}> extends Construct {
     readonly sdk: GearboxSDK<Plugins>;
     constructor(sdk: GearboxSDK<Plugins>);
-    get networkType(): NetworkType;
-    get client(): PublicClient;
-    /**
-     * Indicates that contract state needs to be updated
-     */
-    get dirty(): boolean;
-    protected set dirty(value: boolean);
-    protected labelAddress(address: Address): string;
-    /**
-     * Returns list of addresses that should be watched for events to sync state
-     */
-    get watchAddresses(): Set<Address>;
 }

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

@@ -1,5 +1,4 @@
-import type { Address } from "viem";
-import type { GearboxSDK } from "../GearboxSDK.js";
+import type { Address, Chain, PublicClient, Transport } from "viem";
 import { type PhantomTokenContractType } from "../index.js";
 import type { Asset } from "../router/index.js";
 import { AddressMap } from "../utils/index.js";
@@ -16,7 +15,7 @@ export interface TokenMetaDataExtended extends TokenMetaData {
 }
 export declare class TokensMeta extends AddressMap<TokenMetaDataExtended> {
     #private;
-    constructor(sdk: GearboxSDK);
+    constructor(client: PublicClient<Transport, Chain>);
     symbol(token: Address): string;
     decimals(token: Address): number;
     /**

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

@@ -1,5 +1,6 @@
-export * from "./AddressLabeller.js";
 export * from "./BaseContract.js";
+export * from "./ChainContractsRegister.js";
+export * from "./Construct.js";
 export * from "./PlaceholderContract.js";
 export * from "./SDKConstruct.js";
 export * from "./TokensMeta.js";

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

@@ -41,3 +41,53 @@ export declare enum VotingContractStatus {
     ALLOWED = 1,
     UNVOTE_ONLY = 2
 }
+export type ParsedCallArgs = Record<string, string>;
+export interface ParsedCall {
+    chainId: number;
+    target: Address;
+    contractType: string;
+    label: string;
+    functionName: string;
+    args: ParsedCallArgs;
+}
+export interface IBaseContract {
+    /**
+     * Contract address
+     **/
+    readonly address: Address;
+    /**
+     * Contract type (parsed bytes32 or empty string)
+     **/
+    readonly contractType: string;
+    /**
+     * Contract version
+     **/
+    readonly version: number;
+    /**
+     * Internal name, for labeling purposes
+     * However, other contracts may add more labels, so prefer use labeling methods instead
+     **/
+    readonly name: string;
+    /**
+     * Indicates that contract state diverged from onchain state and needs to be updated
+     */
+    dirty: boolean;
+    /**
+     * 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)
+     **/
+    parseFunctionData: (calldata: Hex) => ParsedCall;
+    /**
+     * Same as {@link parseFunctionData}, but throws if error occurs
+     **/
+    mustParseFunctionData: (calldata: Hex) => ParsedCall;
+    /**
+     * Converts contract calldata to some human-friendly string
+     * This is safe function which should not throw
+     **/
+    stringifyFunctionData: (calldata: Hex) => string;
+    /**
+     * Same as {@link stringifyFunctionData}, but throws if error occurs
+     **/
+    mustStringifyFunctionData: (calldata: Hex) => string;
+}

package/dist/types/sdk/core/BotListV3Contract.d.ts

@@ -314,7 +314,7 @@ type abi = typeof abi;
 export declare class BotListContract extends BaseContract<abi> {
     #private;
     constructor(sdk: GearboxSDK, address: Address);
-    protected parseFunctionParams(params: DecodeFunctionDataReturnType<abi>): Array<string> | undefined;
+    protected stringifyFunctionParams(params: DecodeFunctionDataReturnType<abi>): string[];
     syncState(toBlock: bigint): Promise<void>;
     processLog(log: Log<bigint, number, false, undefined, undefined, abi, ContractEventName<abi>>): void;
     get approvedCreditManagers(): Set<Address>;