@hinkal/common 0.2.40 → 0.3.2

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 { ChainBalanceFetchingLock } from '../../../mutexes/chainBalanceRwLock';
+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: ChainBalanceFetchingLock;
+    constructor(chainId: number, connection: Connection, programId: PublicKey, initialSlot: number, isServer: boolean, eventsFetchingMutex: ChainBalanceFetchingLock, 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.cjs

@@ -0,0 +1 @@
+const e=require(`../../../../_virtual/_rolldown/runtime.cjs`);let t=require(`axios`);t=e.__toESM(t);var n=class{axiosInstance;constructor(){this.axiosInstance=t.default.create()}async get(e,t){return(await this.axiosInstance.get(e,t)).data}async post(e,t,n){return(await this.axiosInstance.post(e,t,n)).data}async put(e,t,n){return(await this.axiosInstance.put(e,t,n)).data}async patch(e,t,n){return(await this.axiosInstance.patch(e,t,n)).data}async delete(e,t){return(await this.axiosInstance.delete(e,t)).data}};exports.BasicHttpClient=n;

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

@@ -0,0 +1,22 @@
+export * from './ValueCache';
+export * from './crypto-keys';
+export * from './Hinkal';
+export * from './private-balances';
+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/private-balances/BalanceChangedHandler.cjs

@@ -0,0 +1 @@
+var e=class{listeners=new Set;subscribe(e){return this.listeners.add(e),()=>this.listeners.delete(e)}dispatch(e){this.listeners.forEach(t=>t(e))}},t=new e;exports.BalanceChangedHandler=e,exports.balanceChangedHandler=t;

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

@@ -0,0 +1,9 @@
+import { PrivateBalanceUpdateEventType } from '../../types';
+type BalanceChangeListener = (detail?: PrivateBalanceUpdateEventType) => void;
+export declare class BalanceChangedHandler {
+    private readonly listeners;
+    subscribe(listener: BalanceChangeListener): () => void;
+    dispatch(detail: PrivateBalanceUpdateEventType): void;
+}
+export declare const balanceChangedHandler: BalanceChangedHandler;
+export {};

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

@@ -0,0 +1,12 @@
+//#region libs/shared/common/src/data-structures/private-balances/BalanceChangedHandler.ts
+var e = class {
+	listeners = /* @__PURE__ */ new Set();
+	subscribe(e) {
+		return this.listeners.add(e), () => this.listeners.delete(e);
+	}
+	dispatch(e) {
+		this.listeners.forEach((t) => t(e));
+	}
+}, t = new e();
+//#endregion
+export { e as BalanceChangedHandler, t as balanceChangedHandler };

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

@@ -0,0 +1 @@
+const e=require(`../../functions/web3/etherFunctions.cjs`),t=require(`../../functions/utils/upToDateState.cjs`),n=require(`../../error-handling/logger.cjs`),r=require(`../../types/balances.types.cjs`),i=require(`../../functions/utils/string.utils.cjs`),a=require(`./BalanceChangedHandler.cjs`),o=require(`../IndexedDB/private-balances-db.cjs`),s=require(`../IndexedDB/prices-db.cjs`),c=require(`./privateBalancesReducer.cjs`);var l=class{privateBalancesState={};privateBalancesListeners=new Set;hinkal;unsubscribeBalanceChange;constructor(e){this.hinkal=e,this.unsubscribeBalanceChange=a.balanceChangedHandler.subscribe(e=>{this.applyRefreshFromBalanceChangeEvent(e).catch(e=>{n.Logger.error(`Private balance refresh from balance change failed:`,e)})})}getSnapshot(){return this.privateBalancesState}onPrivateBalancesWithUSDChange(e){return this.privateBalancesListeners.add(e),()=>this.privateBalancesListeners.delete(e)}dispose(){this.unsubscribeBalanceChange(),this.privateBalancesListeners.clear()}async applyRefreshFromBalanceChangeEvent(e){if(!e){await this.refreshInternal(r.PrivateBalanceUpdateType.FreshWithoutLoader);return}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.privateBalancesReducer(this.privateBalancesState,e);let t=this.privateBalancesState;this.privateBalancesListeners.forEach(e=>e(t))}async getAddressAndChain(e){try{return{ethAdd:e?.ethereumAddress??await this.hinkal.getEthereumAddress(),userKeys:e?.userKeys??this.hinkal.userKeys}}catch{return{ethAdd:void 0,userKeys:void 0}}}async hasCache(e,t){return await o.privateBalancesStorage.getBalancesByWallet(e,t)!==void 0}async getBalancesWithUsdValues(t,r){try{if(!r)return[];let n=t.map(e=>e.token.erc20TokenAddress);if(!n.length)return[];let i=await s.pricesStorage.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.getAmountInToken(t.token,i))*r;return{...t,usdValue:o}}catch{return{...t,usdValue:0}}})]}catch{return n.Logger.log(`Error fetching private token balances`),[]}}handleCached=async(r,a)=>{try{await t.checkAddressNotUpdated(this.hinkal,r),this.dispatch({type:`SET_BALANCES`,chainId:a,balances:void 0});let n=await o.privateBalancesStorage.getBalancesByWallet(r,a),c=await s.pricesStorage.getPrices();if(await t.checkAddressNotUpdated(this.hinkal,r),!n||(this.dispatch({type:`SET_BALANCES`,chainId:a,balances:n}),!c))return;let l=n.map(t=>{let n=i.getTokenStateKey(t.token.erc20TokenAddress,a);return{...t,usdValue:c[n]?Number(e.getAmountInToken(t.token,t.balance))*c[n]:0}});this.dispatch({type:`SET_USD_BALANCES`,chainId:a,balances:l})}catch(e){n.Logger.error(`Error refreshing cached private balance:`,e)}};handleFresh=async(e,r,i,a,s,c)=>{let l=s;try{await t.checkAddressNotUpdated(this.hinkal,e);let n=await this.hasCache(e,r);await t.checkAddressNotUpdated(this.hinkal,e),l=s||!n,l&&this.dispatch({type:`SET_LOADING`,chainId:r,newValue:!0}),await t.checkAddressNotUpdated(this.hinkal,e),a&&await this.hinkal.resetMerkle([r]);let u=await this.hinkal.getTotalBalance(r,i,e,a,c);await t.checkAddressNotUpdated(this.hinkal,e);let d=u.filter(e=>e.balance>0n);this.dispatch({type:`SET_BALANCES`,chainId:r,balances:d}),await o.privateBalancesStorage.setBalances(e,r,d),await t.checkAddressNotUpdated(this.hinkal,e),l&&(this.dispatch({type:`SET_USD_LOADING`,chainId:r,newValue:!0}),this.dispatch({type:`SET_LOADING`,chainId:r,newValue:!1})),await t.checkAddressNotUpdated(this.hinkal,e);let f=await this.getBalancesWithUsdValues(d,r);await t.checkAddressNotUpdated(this.hinkal,e),f.length>0&&this.dispatch({type:`SET_USD_BALANCES`,chainId:r,balances:f})}catch(e){n.Logger.error(`Error refreshing private balance:`,e)}finally{l&&(this.dispatch({type:`SET_LOADING`,chainId:r,newValue:!1}),this.dispatch({type:`SET_USD_LOADING`,chainId:r,newValue:!1}))}};getSupportedChainsToUpdate(e){let t=this.hinkal.getSupportedChains();return e?t.includes(e)?[e]:[]:t}async refreshInternal(e=r.PrivateBalanceUpdateType.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 r.PrivateBalanceUpdateType.OnlyCache:await this.handleCached(o,t);break;case r.PrivateBalanceUpdateType.Fresh:await this.handleFresh(o,t,s,n,!0,i);break;case r.PrivateBalanceUpdateType.FreshWithoutLoader:await this.handleFresh(o,t,s,n,!1,i);break;default:break}}))}};exports.HinkalPrivateBalanceController=l;

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

@@ -0,0 +1,21 @@
+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;
+    constructor(hinkal: IHinkal);
+    getSnapshot(): PrivateBalancesState;
+    onPrivateBalancesWithUSDChange(callback: (state: PrivateBalancesState) => void): () => void;
+    dispose(): void;
+    private applyRefreshFromBalanceChangeEvent;
+    private dispatch;
+    private getAddressAndChain;
+    private hasCache;
+    private getBalancesWithUsdValues;
+    private handleCached;
+    private handleFresh;
+    private getSupportedChainsToUpdate;
+    private refreshInternal;
+}

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

@@ -0,0 +1,183 @@
+import { getAmountInToken as e } from "../../functions/web3/etherFunctions.mjs";
+import { checkAddressNotUpdated as t } from "../../functions/utils/upToDateState.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";
+//#region libs/shared/common/src/data-structures/private-balances/HinkalPrivateBalanceController.ts
+var l = class {
+	privateBalancesState = {};
+	privateBalancesListeners = /* @__PURE__ */ new Set();
+	hinkal;
+	unsubscribeBalanceChange;
+	constructor(e) {
+		this.hinkal = e, this.unsubscribeBalanceChange = a.subscribe((e) => {
+			this.applyRefreshFromBalanceChangeEvent(e).catch((e) => {
+				n.error("Private balance refresh from balance change failed:", e);
+			});
+		});
+	}
+	getSnapshot() {
+		return this.privateBalancesState;
+	}
+	onPrivateBalancesWithUSDChange(e) {
+		return this.privateBalancesListeners.add(e), () => this.privateBalancesListeners.delete(e);
+	}
+	dispose() {
+		this.unsubscribeBalanceChange(), this.privateBalancesListeners.clear();
+	}
+	async applyRefreshFromBalanceChangeEvent(e) {
+		if (!e) {
+			await this.refreshInternal(r.FreshWithoutLoader);
+			return;
+		}
+		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);
+		let t = this.privateBalancesState;
+		this.privateBalancesListeners.forEach((e) => e(t));
+	}
+	async getAddressAndChain(e) {
+		try {
+			return {
+				ethAdd: e?.ethereumAddress ?? await this.hinkal.getEthereumAddress(),
+				userKeys: e?.userKeys ?? this.hinkal.userKeys
+			};
+		} catch {
+			return {
+				ethAdd: void 0,
+				userKeys: void 0
+			};
+		}
+	}
+	async hasCache(e, t) {
+		return await o.getBalancesByWallet(e, t) !== void 0;
+	}
+	async getBalancesWithUsdValues(t, r) {
+		try {
+			if (!r) return [];
+			let n = t.map((e) => e.token.erc20TokenAddress);
+			if (!n.length) return [];
+			let i = await s.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;
+					return {
+						...t,
+						usdValue: o
+					};
+				} catch {
+					return {
+						...t,
+						usdValue: 0
+					};
+				}
+			})];
+		} catch {
+			return n.log("Error fetching private token balances"), [];
+		}
+	}
+	handleCached = async (r, a) => {
+		try {
+			await t(this.hinkal, r), this.dispatch({
+				type: "SET_BALANCES",
+				chainId: a,
+				balances: void 0
+			});
+			let n = await o.getBalancesByWallet(r, a), c = await s.getPrices();
+			if (await t(this.hinkal, r), !n || (this.dispatch({
+				type: "SET_BALANCES",
+				chainId: a,
+				balances: n
+			}), !c)) 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
+				};
+			});
+			this.dispatch({
+				type: "SET_USD_BALANCES",
+				chainId: a,
+				balances: l
+			});
+		} catch (e) {
+			n.error("Error refreshing cached private balance:", e);
+		}
+	};
+	handleFresh = async (e, r, i, a, s, c) => {
+		let l = s;
+		try {
+			await t(this.hinkal, e);
+			let n = await this.hasCache(e, r);
+			await t(this.hinkal, e), l = s || !n, l && this.dispatch({
+				type: "SET_LOADING",
+				chainId: r,
+				newValue: !0
+			}), await t(this.hinkal, e), a && await this.hinkal.resetMerkle([r]);
+			let u = await this.hinkal.getTotalBalance(r, i, e, a, c);
+			await t(this.hinkal, e);
+			let d = u.filter((e) => e.balance > 0n);
+			this.dispatch({
+				type: "SET_BALANCES",
+				chainId: r,
+				balances: d
+			}), await o.setBalances(e, r, d), await t(this.hinkal, e), l && (this.dispatch({
+				type: "SET_USD_LOADING",
+				chainId: r,
+				newValue: !0
+			}), this.dispatch({
+				type: "SET_LOADING",
+				chainId: r,
+				newValue: !1
+			})), await t(this.hinkal, e);
+			let f = await this.getBalancesWithUsdValues(d, r);
+			await t(this.hinkal, e), f.length > 0 && this.dispatch({
+				type: "SET_USD_BALANCES",
+				chainId: r,
+				balances: f
+			});
+		} catch (e) {
+			n.error("Error refreshing private balance:", e);
+		} finally {
+			l && (this.dispatch({
+				type: "SET_LOADING",
+				chainId: r,
+				newValue: !1
+			}), this.dispatch({
+				type: "SET_USD_LOADING",
+				chainId: r,
+				newValue: !1
+			}));
+		}
+	};
+	getSupportedChainsToUpdate(e) {
+		let t = this.hinkal.getSupportedChains();
+		return e ? t.includes(e) ? [e] : [] : t;
+	}
+	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 r.OnlyCache:
+					await this.handleCached(o, t);
+					break;
+				case r.Fresh:
+					await this.handleFresh(o, t, s, n, !0, i);
+					break;
+				case r.FreshWithoutLoader:
+					await this.handleFresh(o, t, s, n, !1, i);
+					break;
+				default: break;
+			}
+		}));
+	}
+};
+//#endregion
+export { l as HinkalPrivateBalanceController };

package/common/src/data-structures/private-balances/index.cjs

@@ -0,0 +1 @@
+require(`./BalanceChangedHandler.cjs`),require(`./privateBalancesReducer.cjs`),require(`./HinkalPrivateBalanceController.cjs`);

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/index.mjs

@@ -0,0 +1,3 @@
+import "./BalanceChangedHandler.mjs";
+import "./privateBalancesReducer.mjs";
+import "./HinkalPrivateBalanceController.mjs";

package/common/src/data-structures/private-balances/privateBalancesReducer.cjs

@@ -0,0 +1 @@
+const e=require(`../../functions/utils/token-check.utils.cjs`);var t=(t,n)=>{switch(n.type){case`SET_BALANCES`:{let r=t[n.chainId];if(n.balances===void 0){let e={...t};return delete e[n.chainId],Object.keys(e).length>0?e:{}}if(r===void 0)return{...t,[n.chainId]:n.balances};let i=n.balances,a=i.filter(t=>!r.some(n=>e.isSameERC20Token(t.token,n.token))),o=r.map(t=>({...t,balance:i.find(n=>e.isSameERC20Token(n.token,t.token))?.balance??0n})).filter(e=>e.balance>0n);return o=[...o,...a],{...t,[n.chainId]:o}}case`SET_USD_BALANCES`:{let r=t[n.chainId];if(r===void 0||n.balances===void 0)return t;let i=n.balances,a=r.map(t=>({...t,usdValue:i.find(n=>e.isSameERC20Token(n.token,t.token))?.usdValue??0}));return{...t,[n.chainId]:a}}case`CLEAR_BALANCES`:{if(n.chainId===void 0)return{};let e={...t};return delete e[n.chainId],Object.keys(e).length>0?e:{}}case`SET_LOADING`:{let e=t[n.chainId];if(e===void 0)return t;if(e.length===0&&n.newValue)return{...t,[n.chainId]:void 0};let r=e.map(e=>({...e,isBalanceLoading:n.newValue}));return{...t,[n.chainId]:r}}case`SET_USD_LOADING`:{let e=t[n.chainId];if(e===void 0)return t;let r=e.map(e=>({...e,isUsdValueLoading:n.newValue}));return{...t,[n.chainId]:r}}default:return t}};exports.privateBalancesReducer=t;

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/private-balances/privateBalancesReducer.mjs

@@ -0,0 +1,73 @@
+import { isSameERC20Token as e } from "../../functions/utils/token-check.utils.mjs";
+//#region libs/shared/common/src/data-structures/private-balances/privateBalancesReducer.ts
+var t = (t, n) => {
+	switch (n.type) {
+		case "SET_BALANCES": {
+			let r = t[n.chainId];
+			if (n.balances === void 0) {
+				let e = { ...t };
+				return delete e[n.chainId], Object.keys(e).length > 0 ? e : {};
+			}
+			if (r === void 0) return {
+				...t,
+				[n.chainId]: n.balances
+			};
+			let i = n.balances, a = i.filter((t) => !r.some((n) => e(t.token, n.token))), o = r.map((t) => ({
+				...t,
+				balance: i.find((n) => e(n.token, t.token))?.balance ?? 0n
+			})).filter((e) => e.balance > 0n);
+			return o = [...o, ...a], {
+				...t,
+				[n.chainId]: o
+			};
+		}
+		case "SET_USD_BALANCES": {
+			let r = t[n.chainId];
+			if (r === void 0 || n.balances === void 0) return t;
+			let i = n.balances, a = r.map((t) => ({
+				...t,
+				usdValue: i.find((n) => e(n.token, t.token))?.usdValue ?? 0
+			}));
+			return {
+				...t,
+				[n.chainId]: a
+			};
+		}
+		case "CLEAR_BALANCES": {
+			if (n.chainId === void 0) return {};
+			let e = { ...t };
+			return delete e[n.chainId], Object.keys(e).length > 0 ? e : {};
+		}
+		case "SET_LOADING": {
+			let e = t[n.chainId];
+			if (e === void 0) return t;
+			if (e.length === 0 && n.newValue) return {
+				...t,
+				[n.chainId]: void 0
+			};
+			let r = e.map((e) => ({
+				...e,
+				isBalanceLoading: n.newValue
+			}));
+			return {
+				...t,
+				[n.chainId]: r
+			};
+		}
+		case "SET_USD_LOADING": {
+			let e = t[n.chainId];
+			if (e === void 0) return t;
+			let r = e.map((e) => ({
+				...e,
+				isUsdValueLoading: n.newValue
+			}));
+			return {
+				...t,
+				[n.chainId]: r
+			};
+		}
+		default: return t;
+	}
+};
+//#endregion
+export { t as privateBalancesReducer };

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

@@ -0,0 +1,39 @@
+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<{
+        signature: string;
+        transactionMessageB64: string;
+    }>;
+    isSolanaLedger?(): boolean;
+}

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

@@ -0,0 +1 @@
+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 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.mjs

@@ -0,0 +1,17 @@
+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 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 = (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 { i as TokenChecker };

package/common/src/data-structures/utxo/Utxo.cjs

@@ -0,0 +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;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

@@ -0,0 +1,106 @@
+import { isSolanaLike as e } from "../../constants/chains.constants.mjs";
+import { poseidonHash as t } from "../../crypto/poseidon.mjs";
+import { randomBigInt as n } from "../../functions/web3/etherFunctions.mjs";
+import { UserKeys as r } from "../crypto-keys/keys.mjs";
+import { getCurrentTimeInSeconds as i } from "../../functions/utils/time.utils.mjs";
+//#region libs/shared/common/src/data-structures/utxo/Utxo.ts
+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().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("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(...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(this.nullifyingKey, e);
+			this.nullifier = t(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.getStealthAddress(this.H0, this.nullifyingKey, this.spendingPublicKey);
+		}
+		return this.stealthAddress;
+	}
+	getTokenAddress(t) {
+		let n = e(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.getEncryptionKeyPair(this.nullifyingKey).publicKey;
+	}
+};
+//#endregion
+export { a as Utxo };

package/common/src/error-handling/customErrors/customErrors.helpers.cjs

@@ -0,0 +1 @@
+const e=require(`../../functions/utils/amounts.utils.cjs`);require(`../error-codes.constants.cjs`);const t=require(`../../functions/web3/etherFunctions.cjs`);require(`./FeeOverTransactionValueError.cjs`);const n=require(`../types.cjs`);var r=(r,i)=>{let{totalFeeWEI:a,feeUnit:o}=r.data;if(!o)return r.message;let s=t.getAmountInToken(o,a),c=`transact`,l=`an equivalent of `;return i===n.ErrorCategory.WITHDRAW&&(c=`withdraw`,l=``),`Fees are over transaction value. Please ${c} at least ${l} ${e.fixDecimalsAmount(Number(s))} of ${o?.symbol} (subject to real-time price)`};exports.getGenericFeeOverTransactionValueErrorMessage=r;