@gurge/sdk 0.3.142 → 0.3.151

package/common/src/data-structures/private-balances/HinkalPrivateBalanceController.d.ts

@@ -0,0 +1,25 @@
+import { PrivateBalancesState } from '../../types/balances.types';
+import { IHinkal } from '../Hinkal/IHinkal';
+export declare class HinkalPrivateBalanceController {
+    private privateBalancesState;
+    private readonly privateBalancesListeners;
+    private readonly hinkal;
+    private readonly unsubscribeBalanceChange;
+    private readonly pollIntervalId;
+    private pollInFlight;
+    constructor(hinkal: IHinkal);
+    getSnapshot(): PrivateBalancesState;
+    onPrivateBalancesWithUSDChange(callback: (state: PrivateBalancesState) => void): () => void;
+    dispose(): void;
+    private pollRemoteBalances;
+    private applyRefreshFromBalanceChangeEvent;
+    private dispatch;
+    private getAddressAndChain;
+    private hasCache;
+    private getBalancesWithUsdValues;
+    private handleCached;
+    private applyFreshBalances;
+    private handleFresh;
+    private getSupportedChainsToUpdate;
+    private refreshInternal;
+}

package/common/src/data-structures/private-balances/HinkalPrivateBalanceController.mjs

@@ -1,24 +1,27 @@
 import { getAmountInToken as e } from "../../functions/web3/etherFunctions.mjs";
 import { checkAddressNotUpdated as t } from "../../functions/utils/upToDateState.mjs";
-import { PrivateBalanceUpdateType as n } from "../../types/balances.types.mjs";
-import { Logger as r } from "../../error-handling/logger.mjs";
+import { Logger as n } from "../../error-handling/logger.mjs";
+import { PrivateBalanceUpdateType as r } from "../../types/balances.types.mjs";
 import { getTokenStateKey as i } from "../../functions/utils/string.utils.mjs";
-import { balanceChangedHandler as a } from "./BalanceChangedHandler.mjs";
-import { privateBalancesStorage as o } from "../IndexedDB/private-balances-db.mjs";
-import { pricesStorage as s } from "../IndexedDB/prices-db.mjs";
-import { privateBalancesReducer as c } from "./privateBalancesReducer.mjs";
+import { REMOTE_BALANCE_POLL_INTERVAL_MS as a } from "../../constants/balance.constants.mjs";
+import { balanceChangedHandler as o } from "./BalanceChangedHandler.mjs";
+import { privateBalancesStorage as s } from "../IndexedDB/private-balances-db.mjs";
+import { pricesStorage as c } from "../IndexedDB/prices-db.mjs";
+import { privateBalancesReducer as l } from "./privateBalancesReducer.mjs";
 //#region libs/shared/common/src/data-structures/private-balances/HinkalPrivateBalanceController.ts
-var l = class {
+var u = class {
 	privateBalancesState = {};
 	privateBalancesListeners = /* @__PURE__ */ new Set();
 	hinkal;
 	unsubscribeBalanceChange;
+	pollIntervalId;
+	pollInFlight = !1;
 	constructor(e) {
-		this.hinkal = e, this.unsubscribeBalanceChange = a.subscribe((e) => {
+		this.hinkal = e, this.unsubscribeBalanceChange = o.subscribe((e) => {
 			this.applyRefreshFromBalanceChangeEvent(e).catch((e) => {
-				r.error("Private balance refresh from balance change failed:", e);
+				n.error("Private balance refresh from balance change failed:", e);
 			});
-		});
+		}), this.pollIntervalId = setInterval(() => this.pollRemoteBalances(), a);
 	}
 	getSnapshot() {
 		return this.privateBalancesState;
@@ -27,18 +30,25 @@ var l = class {
 		return this.privateBalancesListeners.add(e), () => this.privateBalancesListeners.delete(e);
 	}
 	dispose() {
-		this.unsubscribeBalanceChange(), this.privateBalancesListeners.clear();
+		clearInterval(this.pollIntervalId), this.unsubscribeBalanceChange(), this.privateBalancesListeners.clear();
+	}
+	pollRemoteBalances() {
+		this.privateBalancesListeners.size !== 0 && (!this.hinkal.generateProofRemotely || this.pollInFlight || (this.pollInFlight = !0, this.refreshInternal(r.FreshWithoutLoader, void 0, !1, !0).catch((e) => {
+			n.error("Remote private balance poll failed:", e);
+		}).finally(() => {
+			this.pollInFlight = !1;
+		})));
 	}
 	async applyRefreshFromBalanceChangeEvent(e) {
 		if (!e) {
-			await this.refreshInternal(n.FreshWithoutLoader);
+			await this.refreshInternal(r.FreshWithoutLoader);
 			return;
 		}
-		let { updateType: t, balanceChangeState: r, chainIdToUpdate: i, resetCacheBefore: a, updateTokensListBefore: o } = e;
-		await this.refreshInternal(t, r, a, o, i);
+		let { updateType: t, balanceChangeState: n, chainIdToUpdate: i, resetCacheBefore: a, updateTokensListBefore: o } = e;
+		await this.refreshInternal(t, n, a, o, i);
 	}
 	dispatch(e) {
-		this.privateBalancesState = c(this.privateBalancesState, e);
+		this.privateBalancesState = l(this.privateBalancesState, e);
 		let t = this.privateBalancesState;
 		this.privateBalancesListeners.forEach((e) => e(t));
 	}
@@ -56,14 +66,14 @@ var l = class {
 		}
 	}
 	async hasCache(e, t) {
-		return await o.getBalancesByWallet(e, t) !== void 0;
+		return await s.getBalancesByWallet(e, t) !== void 0;
 	}
-	async getBalancesWithUsdValues(t, n) {
+	async getBalancesWithUsdValues(t, r) {
 		try {
-			if (!n) return [];
-			let r = t.map((e) => e.token.erc20TokenAddress);
-			if (!r.length) return [];
-			let i = await s.getAndUpdatePrices(n, r), a = new Map(r.map((e, t) => [e, i[t]]));
+			if (!r) return [];
+			let n = t.map((e) => e.token.erc20TokenAddress);
+			if (!n.length) return [];
+			let i = await c.getAndUpdatePrices(r, n), a = new Map(n.map((e, t) => [e, i[t]]));
 			return [...t.map((t) => {
 				try {
 					let n = t.token.erc20TokenAddress, r = a.get(n) ?? 0, i = t.balance, o = Number(e(t.token, i)) * r;
@@ -79,27 +89,27 @@ var l = class {
 				}
 			})];
 		} catch {
-			return r.log("Error fetching private token balances"), [];
+			return n.log("Error fetching private token balances"), [];
 		}
 	}
-	handleCached = async (n, a) => {
+	handleCached = async (r, a) => {
 		try {
-			await t(this.hinkal, n), this.dispatch({
+			await t(this.hinkal, r), this.dispatch({
 				type: "SET_BALANCES",
 				chainId: a,
 				balances: void 0
 			});
-			let r = await o.getBalancesByWallet(n, a), c = await s.getPrices();
-			if (await t(this.hinkal, n), !r || (this.dispatch({
+			let n = await s.getBalancesByWallet(r, a), o = await c.getPrices();
+			if (await t(this.hinkal, r), !n || (this.dispatch({
 				type: "SET_BALANCES",
 				chainId: a,
-				balances: r
-			}), !c)) return;
-			let l = r.map((t) => {
+				balances: n
+			}), !o)) return;
+			let l = n.map((t) => {
 				let n = i(t.token.erc20TokenAddress, a);
 				return {
 					...t,
-					usdValue: c[n] ? Number(e(t.token, t.balance)) * c[n] : 0
+					usdValue: o[n] ? Number(e(t.token, t.balance)) * o[n] : 0
 				};
 			});
 			this.dispatch({
@@ -108,76 +118,80 @@ var l = class {
 				balances: l
 			});
 		} catch (e) {
-			r.error("Error refreshing cached private balance:", e);
+			n.error("Error refreshing cached private balance:", e);
 		}
 	};
-	handleFresh = async (e, n, i, a, s, c) => {
-		let l = s;
+	applyFreshBalances = async (e, n, r, i) => {
+		let a = r.filter((e) => e.balance > 0n);
+		this.dispatch({
+			type: "SET_BALANCES",
+			chainId: n,
+			balances: a
+		}), await s.setBalances(e, n, a), await t(this.hinkal, e), i && (this.dispatch({
+			type: "SET_USD_LOADING",
+			chainId: n,
+			newValue: !0
+		}), this.dispatch({
+			type: "SET_LOADING",
+			chainId: n,
+			newValue: !1
+		})), await t(this.hinkal, e);
+		let o = await this.getBalancesWithUsdValues(a, n);
+		await t(this.hinkal, e), o.length > 0 && this.dispatch({
+			type: "SET_USD_BALANCES",
+			chainId: n,
+			balances: o
+		});
+	};
+	handleFresh = async (e, r, i, a, o, s) => {
+		let c = /* @__PURE__ */ new Set();
 		try {
-			await t(this.hinkal, e);
-			let r = await this.hasCache(e, n);
-			await t(this.hinkal, e), l = s || !r, l && this.dispatch({
+			await t(this.hinkal, e), await Promise.all(r.map(async (t) => {
+				(o || !await this.hasCache(e, t)) && c.add(t);
+			})), await t(this.hinkal, e), c.forEach((e) => this.dispatch({
 				type: "SET_LOADING",
-				chainId: n,
-				newValue: !0
-			}), await t(this.hinkal, e), a && await this.hinkal.resetMerkle([n]);
-			let u = await this.hinkal.getTotalBalance(n, i, e, a, c);
-			await t(this.hinkal, e);
-			let d = u.filter((e) => e.balance > 0n);
-			this.dispatch({
-				type: "SET_BALANCES",
-				chainId: n,
-				balances: d
-			}), await o.setBalances(e, n, d), await t(this.hinkal, e), l && (this.dispatch({
-				type: "SET_USD_LOADING",
-				chainId: n,
+				chainId: e,
 				newValue: !0
-			}), this.dispatch({
-				type: "SET_LOADING",
-				chainId: n,
-				newValue: !1
-			})), await t(this.hinkal, e);
-			let f = await this.getBalancesWithUsdValues(d, n);
-			await t(this.hinkal, e), f.length > 0 && this.dispatch({
-				type: "SET_USD_BALANCES",
-				chainId: n,
-				balances: f
-			});
+			})), a && await this.hinkal.resetMerkle(r);
+			let n = await this.hinkal.getTotalBalances(r, i, e, a, s);
+			await t(this.hinkal, e), await Promise.all([...n].map(([t, n]) => this.applyFreshBalances(e, t, n, c.has(t))));
 		} catch (e) {
-			r.error("Error refreshing private balance:", e);
+			n.error("Error refreshing private balance:", e);
 		} finally {
-			l && (this.dispatch({
-				type: "SET_LOADING",
-				chainId: n,
-				newValue: !1
-			}), this.dispatch({
-				type: "SET_USD_LOADING",
-				chainId: n,
-				newValue: !1
-			}));
+			c.forEach((e) => {
+				this.dispatch({
+					type: "SET_LOADING",
+					chainId: e,
+					newValue: !1
+				}), this.dispatch({
+					type: "SET_USD_LOADING",
+					chainId: e,
+					newValue: !1
+				});
+			});
 		}
 	};
 	getSupportedChainsToUpdate(e) {
 		let t = this.hinkal.getSupportedChains();
 		return e ? t.includes(e) ? [e] : [] : t;
 	}
-	async refreshInternal(e = n.FreshWithoutLoader, t, r = !1, i = !1, a) {
+	async refreshInternal(e = r.FreshWithoutLoader, t, n = !1, i = !1, a) {
 		let { ethAdd: o, userKeys: s } = await this.getAddressAndChain(t);
-		!o || !s?.getShieldedPublicKey() || await Promise.all(this.getSupportedChainsToUpdate(a).map(async (t) => {
-			switch (e) {
-				case n.OnlyCache:
-					await this.handleCached(o, t);
-					break;
-				case n.Fresh:
-					await this.handleFresh(o, t, s, r, !0, i);
-					break;
-				case n.FreshWithoutLoader:
-					await this.handleFresh(o, t, s, r, !1, i);
-					break;
-				default: break;
-			}
-		}));
+		if (!o || !s?.getShieldedPublicKey()) return;
+		let c = this.getSupportedChainsToUpdate(a);
+		if (c.length !== 0) switch (e) {
+			case r.OnlyCache:
+				await Promise.all(c.map((e) => this.handleCached(o, e)));
+				break;
+			case r.Fresh:
+				await this.handleFresh(o, c, s, n, !0, i);
+				break;
+			case r.FreshWithoutLoader:
+				await this.handleFresh(o, c, s, n, !1, i);
+				break;
+			default: break;
+		}
 	}
 };
 //#endregion
-export { l as HinkalPrivateBalanceController };
+export { u as HinkalPrivateBalanceController };

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

@@ -0,0 +1,3 @@
+export * from './BalanceChangedHandler';
+export * from './HinkalPrivateBalanceController';
+export * from './privateBalancesReducer';

package/common/src/data-structures/private-balances/privateBalancesReducer.d.ts

@@ -0,0 +1,2 @@
+import { PrivateBalancesAction, PrivateBalancesState } from '../../types/balances.types';
+export declare const privateBalancesReducer: (currentState: PrivateBalancesState, action: PrivateBalancesAction) => PrivateBalancesState;

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

@@ -0,0 +1,36 @@
+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>;
+    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<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.cjs

@@ -1 +1 @@
-const e=require(`../../constants/chains.constants.cjs`),t=require(`../../constants/protocol.constants.cjs`);var n=class{static isBeefyStakeToken=e=>e.name.includes(`-Boost`)&&e.symbol.includes(`-Boost`);static isStakeToken=e=>this.isBeefyStakeToken(e);static isAaveToken=e=>e.aaveToken;static isKinzaToken=e=>e.name.startsWith(`Kinza`);static isPotentiallyVolatile=n=>n.erc20TokenAddress===t.zeroAddress?!1:n.isVolatile||!e.isSolanaLike(n.chainId)&&!e.isTronLike(n.chainId)&&(n.balanceStorageOffset===void 0||n.allowanceStorageOffset===void 0);static isPotentiallySpamToken(e){let{name:t,symbol:n}=e,r=`${t} ${n}`,i=/(?:https?:\/\/|www\.)/i,a=/\.(?:com|io|app|org|net|co|xyz|link|site|top|in|ru|cn|me|biz|info|online|club|tech|to|cloud)(?=[^\w]|$)/i,o=/\b(?:t\.me|discord\.(?:gg|com)|twitter\.com|x\.com|telegram\.(?:me|org))\b/i,s=/@[^\s]+\.[^\s]+/i,c=/\p{Extended_Pictographic}/u,l=/[\u{1F1E6}-\u{1F1FF}]{2}/u,u=/[#*0-9]\uFE0F?\u20E3/u,d=i.test(r),f=a.test(r),p=o.test(r),m=s.test(r),h=c.test(r)||l.test(r)||u.test(r);return d||f||p||m||h}};exports.TokenChecker=n;
+const e=require(`../../constants/chains.constants.cjs`),t=require(`../../constants/protocol.constants.cjs`),n=require(`../../constants/tokens.constants.cjs`);var r=class{static isBeefyStakeToken=e=>e.name.includes(`-Boost`)&&e.symbol.includes(`-Boost`);static isStakeToken=e=>this.isBeefyStakeToken(e);static isAaveToken=e=>e.aaveToken;static isKinzaToken=e=>e.name.startsWith(`Kinza`);static isToken2022=e=>!!e.is2022Program;static isPotentiallyVolatile=r=>r.erc20TokenAddress===t.zeroAddress||n.NON_STANDARD_STORAGE_TOKENS.has(r.erc20TokenAddress.toLowerCase())?!1:r.isVolatile||!e.isSolanaLike(r.chainId)&&!e.isTronLike(r.chainId)&&(r.balanceStorageOffset===void 0||r.allowanceStorageOffset===void 0);static isPotentiallySpamToken(e){let{name:t,symbol:n}=e,r=`${t} ${n}`,i=/(?:https?:\/\/|www\.)/i,a=/\.(?:com|io|app|org|net|co|xyz|link|site|top|in|ru|cn|me|biz|info|online|club|tech|to|cloud)(?=[^\w]|$)/i,o=/\b(?:t\.me|discord\.(?:gg|com)|twitter\.com|x\.com|telegram\.(?:me|org))\b/i,s=/@[^\s]+\.[^\s]+/i,c=/\p{Extended_Pictographic}/u,l=/[\u{1F1E6}-\u{1F1FF}]{2}/u,u=/[#*0-9]\uFE0F?\u20E3/u,d=i.test(r),f=a.test(r),p=o.test(r),m=s.test(r),h=c.test(r)||l.test(r)||u.test(r);return d||f||p||m||h}};exports.TokenChecker=r;

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

@@ -0,0 +1,10 @@
+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 isToken2022: (token: ERC20Token) => boolean;
+    static isPotentiallyVolatile: (token: ERC20Token) => boolean;
+    static isPotentiallySpamToken(token: ERC20Token): boolean;
+}

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

@@ -1,16 +1,18 @@
 import { isSolanaLike as e, isTronLike as t } from "../../constants/chains.constants.mjs";
 import { zeroAddress as n } from "../../constants/protocol.constants.mjs";
+import { NON_STANDARD_STORAGE_TOKENS as r } from "../../constants/tokens.constants.mjs";
 //#region libs/shared/common/src/data-structures/token-price-fetcher/TokenChecker.ts
-var r = class {
+var i = class {
 	static isBeefyStakeToken = (e) => e.name.includes("-Boost") && e.symbol.includes("-Boost");
 	static isStakeToken = (e) => this.isBeefyStakeToken(e);
 	static isAaveToken = (e) => e.aaveToken;
 	static isKinzaToken = (e) => e.name.startsWith("Kinza");
-	static isPotentiallyVolatile = (r) => r.erc20TokenAddress === n ? !1 : r.isVolatile || !e(r.chainId) && !t(r.chainId) && (r.balanceStorageOffset === void 0 || r.allowanceStorageOffset === void 0);
+	static isToken2022 = (e) => !!e.is2022Program;
+	static isPotentiallyVolatile = (i) => i.erc20TokenAddress === n || r.has(i.erc20TokenAddress.toLowerCase()) ? !1 : i.isVolatile || !e(i.chainId) && !t(i.chainId) && (i.balanceStorageOffset === void 0 || i.allowanceStorageOffset === void 0);
 	static isPotentiallySpamToken(e) {
 		let { name: t, symbol: n } = e, r = `${t} ${n}`, i = /(?:https?:\/\/|www\.)/i, a = /\.(?:com|io|app|org|net|co|xyz|link|site|top|in|ru|cn|me|biz|info|online|club|tech|to|cloud)(?=[^\w]|$)/i, o = /\b(?:t\.me|discord\.(?:gg|com)|twitter\.com|x\.com|telegram\.(?:me|org))\b/i, s = /@[^\s]+\.[^\s]+/i, c = /\p{Extended_Pictographic}/u, l = /[\u{1F1E6}-\u{1F1FF}]{2}/u, u = /[#*0-9]\uFE0F?\u20E3/u, d = i.test(r), f = a.test(r), p = o.test(r), m = s.test(r), h = c.test(r) || l.test(r) || u.test(r);
 		return d || f || p || m || h;
 	}
 };
 //#endregion
-export { r as TokenChecker };
+export { i as TokenChecker };

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.cjs

@@ -1 +1 @@
-const e=require(`../../constants/chains.constants.cjs`),t=require(`../../crypto/poseidon.cjs`),n=require(`../../functions/web3/etherFunctions.cjs`),r=require(`../crypto-keys/keys.cjs`),i=require(`../../functions/utils/time.utils.cjs`);var a=class a{amount;erc20TokenAddress;mintAddress;timeStamp;nullifyingKey;spendingPublicKey;randomization;H0;stealthAddress;encryptionKey;commitment;nullifier;isBlocked;isNewStyle;constructor({amount:e,erc20TokenAddress:t,mintAddress:a,timeStamp:o,nullifyingKey:s,spendingPublicKey:c,randomization:l,H0:u,stealthAddress:d,encryptionKey:f,commitment:p=void 0,nullifier:m=void 0,isBlocked:h=!1,isNewStyle:g=!1}){if(this.amount=e,this.erc20TokenAddress=t,this.mintAddress=a,this.timeStamp=o??i.getCurrentTimeInSeconds().toString(),this.nullifyingKey=s,this.spendingPublicKey=c,this.stealthAddress=d,this.encryptionKey=f,this.commitment=p,this.nullifier=m,this.isBlocked=h,this.isNewStyle=g,g)if(u!==void 0)this.H0=u;else{let e=l??(s?r.UserKeys.findCorrectRandomization(n.randomBigInt(31),s):void 0);if(this.H0=e?r.UserKeys.findH0(e,s):void 0,!this.H0)throw Error(`New-style UTXO requires H0 or nullifyingKey`)}else if(this.randomization=l??(s?r.UserKeys.findCorrectRandomization(n.randomBigInt(31),s):void 0),!this.randomization)throw Error(`Old-style UTXO requires randomization or nullifyingKey`)}static createFrom(e,t){return new a({...e.getConstructableParams(),nullifier:void 0,commitment:void 0,...t})}getConstructableParams(){return{amount:this.amount,erc20TokenAddress:this.erc20TokenAddress,mintAddress:this.mintAddress,timeStamp:this.timeStamp,nullifyingKey:this.nullifyingKey,spendingPublicKey:this.spendingPublicKey,stealthAddress:this.stealthAddress,encryptionKey:this.encryptionKey,commitment:this.commitment,nullifier:this.nullifier,isBlocked:this.isBlocked,isNewStyle:this.isNewStyle,...this.isNewStyle?{H0:this.H0}:{randomization:this.randomization}}}getBasicUtxoParams(){return{amount:this.amount,erc20TokenAddress:this.erc20TokenAddress,mintAddress:this.mintAddress,timeStamp:this.timeStamp,stealthAddress:this.stealthAddress,commitment:this.commitment,nullifier:this.nullifier,isBlocked:this.isBlocked,isNewStyle:this.isNewStyle,...this.isNewStyle?{H0:this.H0}:{randomization:this.randomization}}}getCommitment(){if(!this.commitment){let e=[this.amount,this.erc20TokenAddress,BigInt(this.getStealthAddress()),this.timeStamp];this.commitment=t.poseidonHash(...e)}return this.commitment}getNullifier(){if(!this.nullifier){if(!this.nullifyingKey)throw Error(`No Nullifiers if private key is not provided`);let e=this.getCommitment(),n=t.poseidonHash(this.nullifyingKey,e);this.nullifier=t.poseidonHash(e,n)}return this.nullifier}getStealthAddress(){if(!this.stealthAddress){if(!this.nullifyingKey)throw Error(`No stealth address in UTXO if private key is not provided`);if(this.isNewStyle){if(!this.H0)throw Error(`No H0 point provided`);this.stealthAddress=r.UserKeys.getStealthAddressNewStyle(this.H0,this.nullifyingKey,this.spendingPublicKey)}else{if(!this.randomization)throw Error(`No randomization provided`);this.stealthAddress=r.UserKeys.getStealthAddress(this.randomization,this.nullifyingKey)}}return this.stealthAddress}getTokenAddress(t){let n=e.isSolanaLike(t)?this.mintAddress:this.erc20TokenAddress;if(!n)throw Error(`No token address provided`);return n}getEncryptionKey(){if(!this.nullifyingKey){if(!this.encryptionKey)throw Error(`No encryption key provided in UTXO`);return this.encryptionKey}return r.UserKeys.getEncryptionKeyPair(this.nullifyingKey).publicKey}};exports.Utxo=a;
+const e=require(`../../constants/chains.constants.cjs`),t=require(`../../crypto/poseidon.cjs`),n=require(`../../functions/web3/etherFunctions.cjs`),r=require(`../crypto-keys/keys.cjs`),i=require(`../../functions/utils/time.utils.cjs`);var a=class a{amount;erc20TokenAddress;mintAddress;timeStamp;nullifyingKey;spendingPublicKey;H0;stealthAddress;encryptionKey;commitment;nullifier;isBlocked;constructor({amount:e,erc20TokenAddress:t,mintAddress:a,timeStamp:o,nullifyingKey:s,spendingPublicKey:c,randomization:l,H0:u,stealthAddress:d,encryptionKey:f,commitment:p=void 0,nullifier:m=void 0,isBlocked:h=!1}){if(this.amount=e,this.erc20TokenAddress=t,this.mintAddress=a,this.timeStamp=o??i.getCurrentTimeInSeconds().toString(),this.nullifyingKey=s,this.spendingPublicKey=c,this.stealthAddress=d,this.encryptionKey=f,this.commitment=p,this.nullifier=m,this.isBlocked=h,u!==void 0)this.H0=u;else{let e=l??(s?r.UserKeys.findCorrectRandomization(n.randomBigInt(31),s):void 0);if(this.H0=e?r.UserKeys.findH0(e,s):void 0,!this.H0)throw Error(`UTXO requires H0 or nullifyingKey`)}}static createFrom(e,t){return new a({...e.getConstructableParams(),nullifier:void 0,commitment:void 0,...t})}getConstructableParams(){return{amount:this.amount,erc20TokenAddress:this.erc20TokenAddress,mintAddress:this.mintAddress,timeStamp:this.timeStamp,nullifyingKey:this.nullifyingKey,spendingPublicKey:this.spendingPublicKey,stealthAddress:this.stealthAddress,encryptionKey:this.encryptionKey,commitment:this.commitment,nullifier:this.nullifier,isBlocked:this.isBlocked,H0:this.H0}}getBasicUtxoParams(){return{amount:this.amount,erc20TokenAddress:this.erc20TokenAddress,mintAddress:this.mintAddress,timeStamp:this.timeStamp,stealthAddress:this.stealthAddress,commitment:this.commitment,nullifier:this.nullifier,isBlocked:this.isBlocked,H0:this.H0}}getCommitment(){if(!this.commitment){let e=[this.amount,this.erc20TokenAddress,BigInt(this.getStealthAddress()),this.timeStamp];this.commitment=t.poseidonHash(...e)}return this.commitment}getNullifier(){if(!this.nullifier){if(!this.nullifyingKey)throw Error(`No Nullifiers if private key is not provided`);let e=this.getCommitment(),n=t.poseidonHash(this.nullifyingKey,e);this.nullifier=t.poseidonHash(e,n)}return this.nullifier}getStealthAddress(){if(!this.stealthAddress){if(!this.nullifyingKey)throw Error(`No stealth address in UTXO if private key is not provided`);if(!this.H0)throw Error(`No H0 point provided`);this.stealthAddress=r.UserKeys.getStealthAddress(this.H0,this.nullifyingKey,this.spendingPublicKey)}return this.stealthAddress}getTokenAddress(t){let n=e.isSolanaLike(t)?this.mintAddress:this.erc20TokenAddress;if(!n)throw Error(`No token address provided`);return n}getEncryptionKey(){if(!this.nullifyingKey){if(!this.encryptionKey)throw Error(`No encryption key provided in UTXO`);return this.encryptionKey}return r.UserKeys.getEncryptionKeyPair(this.nullifyingKey).publicKey}};exports.Utxo=a;

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

@@ -0,0 +1,66 @@
+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;
+    commitment?: string;
+    nullifier?: string;
+};
+/**
+ * UTXO class for transactions
+ */
+export declare class Utxo {
+    amount: bigint;
+    erc20TokenAddress: string;
+    mintAddress?: string;
+    timeStamp: string;
+    nullifyingKey?: string;
+    spendingPublicKey?: bigint[];
+    H0?: JubPoint;
+    stealthAddress?: string;
+    encryptionKey?: string;
+    commitment?: string;
+    nullifier?: string;
+    isBlocked: 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, }: 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/data-structures/utxo/Utxo.mjs

@@ -11,21 +11,18 @@ var a = class a {
 	timeStamp;
 	nullifyingKey;
 	spendingPublicKey;
-	randomization;
 	H0;
 	stealthAddress;
 	encryptionKey;
 	commitment;
 	nullifier;
 	isBlocked;
-	isNewStyle;
-	constructor({ amount: e, erc20TokenAddress: t, mintAddress: a, timeStamp: o, nullifyingKey: s, spendingPublicKey: c, randomization: l, H0: u, stealthAddress: d, encryptionKey: f, commitment: p = void 0, nullifier: m = void 0, isBlocked: h = !1, isNewStyle: g = !1 }) {
-		if (this.amount = e, this.erc20TokenAddress = t, this.mintAddress = a, this.timeStamp = o ?? i().toString(), this.nullifyingKey = s, this.spendingPublicKey = c, this.stealthAddress = d, this.encryptionKey = f, this.commitment = p, this.nullifier = m, this.isBlocked = h, this.isNewStyle = g, g) if (u !== void 0) this.H0 = u;
+	constructor({ amount: e, erc20TokenAddress: t, mintAddress: a, timeStamp: o, nullifyingKey: s, spendingPublicKey: c, randomization: l, H0: u, stealthAddress: d, encryptionKey: f, commitment: p = void 0, nullifier: m = void 0, isBlocked: h = !1 }) {
+		if (this.amount = e, this.erc20TokenAddress = t, this.mintAddress = a, this.timeStamp = o ?? i().toString(), this.nullifyingKey = s, this.spendingPublicKey = c, this.stealthAddress = d, this.encryptionKey = f, this.commitment = p, this.nullifier = m, this.isBlocked = h, u !== void 0) this.H0 = u;
 		else {
 			let e = l ?? (s ? r.findCorrectRandomization(n(31), s) : void 0);
-			if (this.H0 = e ? r.findH0(e, s) : void 0, !this.H0) throw Error("New-style UTXO requires H0 or nullifyingKey");
+			if (this.H0 = e ? r.findH0(e, s) : void 0, !this.H0) throw Error("UTXO requires H0 or nullifyingKey");
 		}
-		else if (this.randomization = l ?? (s ? r.findCorrectRandomization(n(31), s) : void 0), !this.randomization) throw Error("Old-style UTXO requires randomization or nullifyingKey");
 	}
 	static createFrom(e, t) {
 		return new a({
@@ -48,8 +45,7 @@ var a = class a {
 			commitment: this.commitment,
 			nullifier: this.nullifier,
 			isBlocked: this.isBlocked,
-			isNewStyle: this.isNewStyle,
-			...this.isNewStyle ? { H0: this.H0 } : { randomization: this.randomization }
+			H0: this.H0
 		};
 	}
 	getBasicUtxoParams() {
@@ -62,8 +58,7 @@ var a = class a {
 			commitment: this.commitment,
 			nullifier: this.nullifier,
 			isBlocked: this.isBlocked,
-			isNewStyle: this.isNewStyle,
-			...this.isNewStyle ? { H0: this.H0 } : { randomization: this.randomization }
+			H0: this.H0
 		};
 	}
 	getCommitment() {
@@ -89,13 +84,8 @@ var a = class a {
 	getStealthAddress() {
 		if (!this.stealthAddress) {
 			if (!this.nullifyingKey) throw Error("No stealth address in UTXO if private key is not provided");
-			if (this.isNewStyle) {
-				if (!this.H0) throw Error("No H0 point provided");
-				this.stealthAddress = r.getStealthAddressNewStyle(this.H0, this.nullifyingKey, this.spendingPublicKey);
-			} else {
-				if (!this.randomization) throw Error("No randomization provided");
-				this.stealthAddress = r.getStealthAddress(this.randomization, this.nullifyingKey);
-			}
+			if (!this.H0) throw Error("No H0 point provided");
+			this.stealthAddress = r.getStealthAddress(this.H0, this.nullifyingKey, this.spendingPublicKey);
 		}
 		return this.stealthAddress;
 	}

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);
+}