@gurge/sdk 0.3.4 → 0.3.7

package/common/src/data-structures/event-service/solana/AbstractSolanaSnapshotService.d.ts

@@ -0,0 +1,21 @@
+import { AbstractSolanaEventService } from './AbstractSolanaEventService';
+import { SolanaBlockchainEventEmitter } from './SolanaBlockchainEventEmitter';
+export interface SolanaSnapshot<SnapshotPayloadType> {
+    readonly latestBlockNumber: number;
+    readonly payload: SnapshotPayloadType;
+}
+export declare abstract class AbstractSolanaSnapshotService<EventType, SnapshotPayloadType, SerializedSnapshotType> extends AbstractSolanaEventService<EventType> {
+    private savedLatestSlot;
+    protected constructor(solanaBlockchainEventEmitter: SolanaBlockchainEventEmitter, eventName: string);
+    init(): Promise<void>;
+    retrieveEventsFromLatestBlock(): Promise<void>;
+    private loadSnapshot;
+    protected saveSnapshot(): Promise<unknown>;
+    protected afterEventsAccepted(eventsCount: number): Promise<void>;
+    protected abstract getSnapshotPayload(): SnapshotPayloadType;
+    protected abstract populateSnapshot(snapshot: SolanaSnapshot<SnapshotPayloadType>): void;
+    protected abstract serializeSnapshot(snapshot: SolanaSnapshot<SnapshotPayloadType>): SerializedSnapshotType;
+    protected abstract deserializeSnapshot(serializedSnapshot: SerializedSnapshotType): SolanaSnapshot<SnapshotPayloadType>;
+    protected abstract fetchSnapshot(): Promise<SerializedSnapshotType>;
+    protected abstract persistSnapshot(serializedSnapshot: SerializedSnapshotType): Promise<unknown>;
+}

package/common/src/data-structures/event-service/solana/ClientSolanaBlockchainEventEmitter.d.ts

@@ -0,0 +1,11 @@
+import { Connection, PublicKey } from '@solana/web3.js';
+import { Idl } from '@coral-xyz/anchor';
+import { SolanaBlockchainEventEmitter } from './SolanaBlockchainEventEmitter';
+import { Mutex } from 'async-mutex';
+import { ClientEventHelper } from '../helpers/ClientEventHelper';
+export declare class ClientSolanaBlockchainEventEmitter extends SolanaBlockchainEventEmitter {
+    clientEventHelper: ClientEventHelper;
+    constructor(chainId: number, connection: Connection, programId: PublicKey, initialSlot: number, eventsFetchingMutex: Mutex, maxPageSize?: number, idl?: Idl);
+    protected clear(): void;
+    protected startUpdateListener(): void;
+}

package/common/src/data-structures/event-service/solana/PollingSolanaBlockchainEventEmitter.d.ts

@@ -0,0 +1,6 @@
+import { SolanaBlockchainEventEmitter } from './SolanaBlockchainEventEmitter';
+export declare class PollingSolanaBlockchainEventEmitter extends SolanaBlockchainEventEmitter {
+    private pollingEventHelper;
+    protected clear(): void;
+    protected startUpdateListener(): void;
+}

package/common/src/data-structures/event-service/solana/SolanaBlockchainEventEmitter.d.ts

@@ -0,0 +1,42 @@
+import { Connection, PublicKey } from '@solana/web3.js';
+import { Idl } from '@coral-xyz/anchor';
+import { Mutex } from 'async-mutex';
+import { EventProcessorFunction } from '../../../types/events.types';
+import { BlockchainEvent } from '../../BlockchainEvent/BlockchainEvent';
+export declare abstract class SolanaBlockchainEventEmitter {
+    private readonly _chainId;
+    readonly connection: Connection;
+    readonly programId: PublicKey;
+    private _latestSlot;
+    private _initialSlot;
+    onEventsProcessed?: (acceptedEventCount: number) => void;
+    private eventProcessors;
+    private readonly maxPageSize?;
+    private _isReady;
+    protected isServer: boolean;
+    private inProgress;
+    private anchorParser?;
+    private anchorCoder?;
+    protected eventsFetchingMutex: Mutex;
+    constructor(chainId: number, connection: Connection, programId: PublicKey, initialSlot: number, isServer: boolean, eventsFetchingMutex: Mutex, maxPageSize?: number);
+    get chainId(): number;
+    get latestBlockNumber(): number;
+    get isReady(): boolean;
+    setIdl(idl: Idl): void;
+    syncFromAtMost(slot: number): void;
+    protected advanceLatestBlockNumber(slot: number): void;
+    intervalClear(): void;
+    init(): Promise<void>;
+    private requireReady;
+    addEventProcessorFunction(eventProcessorFunction: EventProcessorFunction): void;
+    getEventsInRange(fromSlot: number, toSlot: number): Promise<BlockchainEvent[]>;
+    getLastBlockNumberForEventRequest(): Promise<number>;
+    retrieveEvents(fromBlock: number, useForce?: boolean, initialLoading?: boolean): Promise<boolean>;
+    private getProgramEvents;
+    private parseTransactionForEvents;
+    private parseLogsForEvents;
+    private parseCpiForEvents;
+    protected processEvents(events: BlockchainEvent[], scannedToBlock?: number): Promise<void>;
+    protected abstract clear(): void;
+    protected abstract startUpdateListener(): void;
+}

package/common/src/data-structures/http/BasicHttpClient.d.ts

@@ -0,0 +1,11 @@
+import { AxiosRequestConfig } from 'axios';
+import { HttpClient } from '../../types/http.types';
+export declare class BasicHttpClient implements HttpClient {
+    private axiosInstance;
+    constructor();
+    get<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    post<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    put<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    patch<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    delete<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
+}

package/common/src/data-structures/http/HttpClient.d.ts

@@ -0,0 +1,10 @@
+import { HttpClient } from '../../types/http.types';
+declare const httpClient: {
+    setHttpClient: (client: HttpClient) => void;
+    get: <T = any>(url: string, config?: any) => Promise<T>;
+    post: <T = any>(url: string, data?: any, config?: any) => Promise<T>;
+    put: <T = any>(url: string, data?: any, config?: any) => Promise<T>;
+    patch: <T = any>(url: string, data?: any, config?: any) => Promise<T>;
+    delete: <T = any>(url: string, config?: any) => Promise<T>;
+};
+export { httpClient };

package/common/src/data-structures/http/index.d.ts

@@ -0,0 +1,2 @@
+export * from './HttpClient';
+export * from './BasicHttpClient';

package/common/src/data-structures/index.d.ts

@@ -0,0 +1,21 @@
+export * from './ValueCache';
+export * from './crypto-keys';
+export * from './Hinkal';
+export * from './merkle-tree';
+export * from './provider-adapter/IProviderAdapter';
+export * from './event-service';
+export * from './utxo/Utxo';
+export * from './custom-token-registry/CustomTokenRegistry';
+export * from './token-price-fetcher';
+export * from './transactions-manager';
+export * from './MultiThreadedUtxoUtils/MultiThreadedUtxoUtils';
+export * from './cacheDevices';
+export * from './IndexedDB';
+export * from './TokenDBs';
+export * from './presale';
+export * from './snapshot';
+export * from './http';
+export * from './ApprovalDBs';
+export * from './BlockchainEvent/BlockchainEvent';
+export * from './AccountActions';
+export * from './WalletManager';

package/common/src/data-structures/merkle-tree/MerkleTree.d.ts

@@ -0,0 +1,82 @@
+export type MerkleTreeJson = {
+    tree: Record<string, string>;
+    reverseTree?: Record<string, string>;
+    count: string;
+    index: string;
+};
+/**
+ * Merkle tree implementation that allows the user to insert in specific places in the tree
+ *
+ */
+export declare class MerkleTree<T> {
+    private hashFunction;
+    private levels;
+    private defaultNodeValue;
+    /**
+     * the map where the items are stored
+     */
+    private readonly tree;
+    /**
+     * amount of elements inserted inside the bottom row of the tree
+     */
+    private count;
+    /**
+     * the maximum index inserted into the tree
+     * used together with count to make sure that the merkle tree is complete.
+     * meaning that there aren't any missing elements between getStartIndex() and index
+     */
+    private index;
+    private reverseTree;
+    static createWithData<T>(tree: Map<bigint, T>, reverseTree: Map<T, bigint> | undefined, index: bigint, count: bigint, hashFunction: (a: T, b: T) => T, levels: bigint, defaultNodeValue: T): MerkleTree<T>;
+    /**
+     * @param hashFunction the hashFunction used to fill the upper layers of the merkle tree
+     * @param levels the amount of layers in the merkle tree
+     * @param defaultNodeValue the default value of an empty node in the merkle tree
+     */
+    static create<T>(hashFunction: (a: T, b: T) => T, defaultNodeValue: T, levels?: bigint): MerkleTree<T>;
+    private createReverseTree;
+    private constructor();
+    /**
+     * get starting nodeIndex from which inserts are allowed
+     */
+    getStartIndex(): bigint;
+    /**
+     * implementation of logarithm2 function from merkle contract
+     */
+    logarithm2(a: bigint): bigint;
+    bigIntMax(a: bigint, b: bigint): bigint;
+    private forceInsert;
+    /**
+     * insert value into the merkle tree
+     * @param value the value to insert
+     * @param nodeIndex the index to insert the value, you can get starting index from getStartIndex()
+     * @throws will throw RangeError if nodeIndex is less than getStartIndex()
+     */
+    insert(value: T, nodeIndex: bigint): void;
+    remove(nodeIndex: bigint): void;
+    private completenessCheck;
+    /**
+     * get root hash of the merkle tree
+     * @returns the hash, if the merkle tree is empty, will return
+     * @throws will throw MerkleTreeIncompleteError if there are missing elements in the tree
+     */
+    getRootHash(): T | undefined;
+    getMerkleData(): Map<bigint, T>;
+    getValue(index: bigint): T | undefined;
+    getSiblingIndex(index: bigint): bigint;
+    /**
+     * get sibling hashes needed by main.circom
+     * @throws will throw MerkleTreeIncompleteError if there are missing elements in the tree
+     */
+    getSiblingHashesForVerification(item: T): bigint[] | T[];
+    /**
+     * get item's sibling hashes side
+     * @returns sibling's indexes
+     * @throws will throw MerkleTreeIncompleteError if there are missing elements in the tree
+     */
+    getSiblingSides(item: T): bigint[];
+    toJSON(): MerkleTreeJson;
+    toJSONLite(): MerkleTreeJson;
+    clone(): MerkleTree<T>;
+    getIndex(): bigint;
+}

package/common/src/data-structures/merkle-tree/MerkleTreeIncompleteError.d.ts

@@ -0,0 +1,3 @@
+export declare class MerkleTreeIncompleteError extends Error {
+    constructor();
+}

package/common/src/data-structures/merkle-tree/index.d.ts

@@ -0,0 +1,2 @@
+export * from './MerkleTree';
+export * from './MerkleTreeIncompleteError';

package/common/src/data-structures/presale/PresaleContractWrapper.d.ts

@@ -0,0 +1,23 @@
+import { ERC20Token } from '../../types/token.types';
+import { ethers } from 'ethers';
+export declare class PresaleContractWrapper {
+    contract: ethers.Contract;
+    eventsFrom: number;
+    constructor(signerOrProvider: ethers.Signer | ethers.Provider, chainId: number);
+    deposit(token: ERC20Token, amount: bigint, minHINK: bigint): Promise<ethers.ContractTransaction>;
+    withdraw(token: string, amount: bigint): Promise<ethers.ContractTransaction>;
+    moveToNextStage(overrides?: ethers.Overrides): Promise<ethers.ContractTransaction>;
+    estimateMoveToNextStageGas(): Promise<bigint>;
+    getTotalDeposit(): Promise<bigint>;
+    getDeposits(depositor: string, token: ERC20Token): Promise<bigint>;
+    getTotalHINK(depositor: string): Promise<bigint>;
+    getCurrentPresaleStageIndex(): Promise<number>;
+    getCurrentMaxDepositAmount(): Promise<bigint>;
+    currentPresaleStage(): Promise<{
+        amountToRaise: bigint;
+        priceMultiplier: bigint;
+    }>;
+    calculateHINK(amount: bigint): Promise<bigint>;
+    queryDeposits(): Promise<(ethers.EventLog | ethers.Log)[]>;
+    onEvent(eventName: string, handleEvent: ethers.Listener): void;
+}

package/common/src/data-structures/presale/index.d.ts

@@ -0,0 +1 @@
+export * from './PresaleContractWrapper';

package/common/src/data-structures/provider-adapter/IProviderAdapter.d.ts

@@ -0,0 +1,40 @@
+import { ContractType, EthereumNetwork } from '../../types/ethereum-network.types';
+import { ethers } from 'ethers';
+import { Call } from '../../types/eip5792.types';
+import { Transaction } from '@solana/web3.js';
+export interface ChainEventListener {
+    onAccountChanged(): void;
+    onChainChanged(chainId?: number): void;
+}
+export interface IProviderAdapter<ConnectorType = unknown> {
+    initConnector(connector: ConnectorType): void;
+    initSigner?(signer: ethers.Signer): void;
+    init(chainId?: number): Promise<void>;
+    initConfig?(config?: any): Promise<void> | void;
+    connectToConnector(connector: ConnectorType): Promise<number>;
+    disconnectFromConnector(): Promise<void>;
+    connectAndPatchProvider(connector: ConnectorType): Promise<number>;
+    getChainId(): number | undefined;
+    waitForTransaction(chainId: number, transactionHash: string, confirmations: number): Promise<boolean>;
+    signMessage(message: string | Uint8Array): Promise<string>;
+    getAddress(): Promise<string>;
+    setChainEventListener(chainEventListener: ChainEventListener): void;
+    release(): void;
+    getContract(chainId: number, contractType: ContractType, contractAddress?: string): ethers.Contract;
+    getContractWithSigner(chainId: number, contract: ContractType, contractAddress?: string): ethers.Contract;
+    getContractWithFetcher(chainId: number, contract: ContractType, contractAddress?: string): ethers.Contract;
+    sendTransaction(tx: ethers.TransactionRequest): Promise<ethers.TransactionResponse>;
+    switchNetwork(network: EthereumNetwork): Promise<unknown>;
+    onAccountChanged(): Promise<unknown>;
+    onChainChanged(chainId?: number): Promise<unknown>;
+    isPermitterAvailable(): boolean;
+    getGasPrice(chainId: number): Promise<bigint>;
+    signTypedData(domain: ethers.TypedDataDomain, types: Record<string, ethers.TypedDataField[]>, value: Record<string, unknown>): Promise<string>;
+    sendBatchCallsTransaction?(chainId: number, calls: Call[]): Promise<ethers.TransactionResponse>;
+    supportsBatchCall?(chainId: number): Promise<boolean>;
+    signTransactionWithoutBroadcast?(tx: Transaction): Promise<{
+        signature: string;
+        transactionMessageB64: string;
+    }>;
+    isSolanaLedger?(): boolean;
+}

package/common/src/data-structures/snapshot/SnapshotFetcherService.d.ts

@@ -0,0 +1,14 @@
+import { ISnapshotsResponse } from '../../API/fetchCommitmentsCache';
+export declare class SnapshotFetcherService {
+    private chainId;
+    private contractAddress;
+    private snapshotsPromise;
+    private lastFetchedAt;
+    private readonly cacheDurationMs;
+    constructor(chainId: number, contractAddress: string, cacheDurationMs?: number);
+    private fetchSnapshots;
+    private ensureSnapshots;
+    getAll(forceRefresh?: boolean): Promise<ISnapshotsResponse>;
+    getCommitments(forceRefresh?: boolean): Promise<import('../../API/fetchCommitmentsCache').ICommitmentsTreeSnapshot>;
+    getNullifiers(forceRefresh?: boolean): Promise<import('../../API/fetchCommitmentsCache').INullifiersSnapshot>;
+}

package/common/src/data-structures/snapshot/evm-snapshots/ClientCommitmentsSnapshotService.d.ts

@@ -0,0 +1,8 @@
+import { AbstractCommitmentsSnapshotService, BlockchainEventEmitter, CommitmentsSerializedSnapshot } from '../../event-service';
+import { SnapshotFetcherService } from '../SnapshotFetcherService';
+export declare class ClientCommitmentsSnapshotService extends AbstractCommitmentsSnapshotService {
+    private snapshotsService;
+    constructor(hinkalEventEmitter: BlockchainEventEmitter, snapshotsFetcher: SnapshotFetcherService);
+    protected fetchSnapshot(): Promise<CommitmentsSerializedSnapshot>;
+    protected persistSnapshot(_serializedSnapshot: CommitmentsSerializedSnapshot): Promise<unknown>;
+}

package/common/src/data-structures/snapshot/evm-snapshots/ClientNullifierSnapshotService.d.ts

@@ -0,0 +1,8 @@
+import { AbstractNullifierSnapshotService, BlockchainEventEmitter, NullifierSerializedSnapshot } from '../../event-service';
+import { SnapshotFetcherService } from '../SnapshotFetcherService';
+export declare class ClientNullifierSnapshotService extends AbstractNullifierSnapshotService {
+    private snapshotsService;
+    constructor(hinkalEventEmitter: BlockchainEventEmitter, snapshotsFetcher: SnapshotFetcherService);
+    protected fetchSnapshot(): Promise<NullifierSerializedSnapshot>;
+    protected persistSnapshot(_serializedSnapshot: NullifierSerializedSnapshot): Promise<unknown>;
+}

package/common/src/data-structures/snapshot/index.d.ts

@@ -0,0 +1,5 @@
+export * from './SnapshotFetcherService';
+export * from './solana-snapshots/ClientSolanaCommitmentsSnapshotService';
+export * from './solana-snapshots/ClientSolanaNullifierSnapshotService';
+export * from './evm-snapshots/ClientCommitmentsSnapshotService';
+export * from './evm-snapshots/ClientNullifierSnapshotService';

package/common/src/data-structures/snapshot/solana-snapshots/ClientSolanaCommitmentsSnapshotService.d.ts

@@ -0,0 +1,8 @@
+import { AbstractSolanaCommitmentsSnapshotService, SolanaBlockchainEventEmitter, SolanaCommitmentsSerializedSnapshot } from '../../event-service';
+import { SnapshotFetcherService } from '../SnapshotFetcherService';
+export declare class ClientSolanaCommitmentsSnapshotService extends AbstractSolanaCommitmentsSnapshotService {
+    private snapshotsService;
+    constructor(commitmentsEventEmitter: SolanaBlockchainEventEmitter, snapshotFetcher: SnapshotFetcherService);
+    protected fetchSnapshot(): Promise<SolanaCommitmentsSerializedSnapshot>;
+    protected persistSnapshot(_serializedSnapshot: SolanaCommitmentsSerializedSnapshot): Promise<unknown>;
+}

package/common/src/data-structures/snapshot/solana-snapshots/ClientSolanaNullifierSnapshotService.d.ts

@@ -0,0 +1,8 @@
+import { AbstractSolanaNullifierSnapshotService, SolanaBlockchainEventEmitter, SolanaNullifierSerializedSnapshot } from '../../event-service';
+import { SnapshotFetcherService } from '../SnapshotFetcherService';
+export declare class ClientSolanaNullifierSnapshotService extends AbstractSolanaNullifierSnapshotService {
+    private snapshotsService;
+    constructor(nullifierEventEmitter: SolanaBlockchainEventEmitter, snapshotFetcher: SnapshotFetcherService);
+    protected fetchSnapshot(): Promise<SolanaNullifierSerializedSnapshot>;
+    protected persistSnapshot(_serializedSnapshot: SolanaNullifierSerializedSnapshot): Promise<unknown>;
+}

package/common/src/data-structures/token-price-fetcher/TokenChecker.d.ts

@@ -0,0 +1,9 @@
+import { ERC20Token } from '../../types/token.types';
+export declare class TokenChecker {
+    static isBeefyStakeToken: (token: ERC20Token) => boolean;
+    static isStakeToken: (token: ERC20Token) => boolean;
+    static isAaveToken: (token: ERC20Token) => boolean | undefined;
+    static isKinzaToken: (token: ERC20Token) => boolean;
+    static isPotentiallyVolatile: (token: ERC20Token) => boolean;
+    static isPotentiallySpamToken(token: ERC20Token): boolean;
+}

package/common/src/data-structures/token-price-fetcher/index.d.ts

@@ -0,0 +1 @@
+export * from './TokenChecker';

package/common/src/data-structures/transactions-manager/history/history.types.d.ts

@@ -0,0 +1,16 @@
+import { TokenBalance } from '../../../types';
+export declare enum TransactionType {
+    DEPOSIT = 0,
+    WITHDRAW = 1,
+    SWAP = 2,
+    UNKNOWN = 3
+}
+export interface TransactionDetails {
+    type: TransactionType;
+}
+export type HistoryTokenBalance = TokenBalance | {
+    token: {
+        erc20TokenAddress: string;
+    };
+    balance: bigint;
+};

package/common/src/data-structures/transactions-manager/index.d.ts

@@ -0,0 +1 @@
+export * from './history/history.types';

package/common/src/data-structures/utxo/Utxo.d.ts

@@ -0,0 +1,69 @@
+import { JubPoint } from '../../crypto/babyJub';
+export type IUtxoConstructor<T = bigint> = {
+    amount: T;
+    erc20TokenAddress: string;
+    mintAddress?: string;
+    timeStamp?: string;
+    nullifyingKey?: string;
+    spendingPublicKey?: T[];
+    randomization?: T;
+    H0?: JubPoint<T>;
+    stealthAddress?: string;
+    encryptionKey?: string;
+    isBlocked?: boolean;
+    isNewStyle?: boolean;
+    commitment?: string;
+    nullifier?: string;
+};
+/**
+ * UTXO class for transactions
+ */
+export declare class Utxo {
+    amount: bigint;
+    erc20TokenAddress: string;
+    mintAddress?: string;
+    timeStamp: string;
+    nullifyingKey?: string;
+    spendingPublicKey?: bigint[];
+    randomization?: bigint;
+    H0?: JubPoint;
+    stealthAddress?: string;
+    encryptionKey?: string;
+    commitment?: string;
+    nullifier?: string;
+    isBlocked: boolean;
+    isNewStyle?: boolean;
+    /**
+     * creates new UTXO instance
+     * @param amount UTXO amount
+     * @param erc20TokenAddress contract address of ERC-20/ERC-721 token
+     * @param timeStamp timestamp
+     * @param nullifyingKeykey for nullification
+     * @param spendingPublicKey spending public key
+     * @param randomization randomization parameter
+     * @param H0 BJJ point
+     * @param stealthAddress  stealth address as a parameter(e.g. in case of transfers we will not know private key and randomization of payee
+     * @param encryptionKey  encryption public key
+     * @param commitment [optional] commitment value if already computed
+     * @param nullifier [optional] nullifier value if already computed
+     * @param isBlocked [optional] whether the UTXO is blocked
+     */
+    constructor({ amount, erc20TokenAddress, mintAddress, timeStamp, nullifyingKey, spendingPublicKey, randomization, H0, stealthAddress, encryptionKey, commitment, nullifier, isBlocked, isNewStyle, }: IUtxoConstructor);
+    static createFrom(utxoToCreateFrom: Utxo, patch: Partial<IUtxoConstructor>): Utxo;
+    getConstructableParams(): IUtxoConstructor;
+    getBasicUtxoParams(): IUtxoConstructor;
+    /**
+     * @returns commitment hash of the UTXO instance
+     */
+    getCommitment(): string;
+    /**
+     * @returns nullifier hash of the UTXO instance
+     */
+    getNullifier(): string;
+    /**
+     * @returns stealth address from randomization and private shieldedPrivateKey
+     */
+    getStealthAddress(): string;
+    getTokenAddress(chainId: number): string;
+    getEncryptionKey(): string;
+}

package/common/src/error-handling/customErrors/ErrorWithAmount.d.ts

@@ -0,0 +1,4 @@
+export declare class ErrorWithAmount extends Error {
+    amount: number;
+    constructor(providedAmount: number, message: string);
+}

package/common/src/error-handling/customErrors/ErrorWithIndex.d.ts

@@ -0,0 +1,4 @@
+export declare class ErrorWithIndex extends Error {
+    failedTxIndex: number;
+    constructor(providedIndex: number, message: string);
+}

package/common/src/error-handling/customErrors/ErrorWithTx.d.ts

@@ -0,0 +1,4 @@
+export declare class ErrorWithRelayerTransaction extends Error {
+    txHash: string | undefined;
+    constructor(message: string, txHash: string | undefined);
+}

package/common/src/error-handling/customErrors/FeeOverTransactionValueError.d.ts

@@ -0,0 +1,9 @@
+import { ERC20Token } from '../../types';
+export interface FeeOverTransactionValueErrorData {
+    totalFeeWEI: bigint;
+    feeUnit: ERC20Token | undefined;
+}
+export declare class FeeOverTransactionValueError extends Error {
+    data: FeeOverTransactionValueErrorData;
+    constructor(data: FeeOverTransactionValueErrorData);
+}

package/common/src/error-handling/customErrors/HttpError.d.ts

@@ -0,0 +1,4 @@
+export declare class HttpError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}

package/common/src/error-handling/customErrors/SimulationFailureError.d.ts

@@ -0,0 +1,10 @@
+export declare class SimulationFailureError extends Error {
+    errorStructure: {
+        error?: string;
+        errorReason?: string;
+    };
+    constructor(data: {
+        error?: string;
+        errorReason?: string;
+    });
+}

package/common/src/error-handling/customErrors/customErrors.helpers.d.ts

@@ -0,0 +1,5 @@
+import { ErrorCategory } from '../types';
+import { FeeOverTransactionValueError } from './FeeOverTransactionValueError';
+export declare const getGenericFeeOverTransactionValueErrorMessage: (error: FeeOverTransactionValueError, type?: ErrorCategory) => string;
+/** If the error is a known gas err type, rethrow it, otherwise throw a new Error */
+export declare const rethrowKnownGasErrorIfPossible: (err: unknown, fallbackErrorMsg: string) => never;

package/common/src/error-handling/customErrors/index.d.ts

@@ -0,0 +1,7 @@
+export * from './ErrorWithAmount';
+export * from './FeeOverTransactionValueError';
+export * from './customErrors.helpers';
+export * from './SimulationFailureError';
+export * from './ErrorWithTx';
+export * from './ErrorWithIndex';
+export * from './HttpError';