@gurge/sdk 0.2.32

package/data-structures/Hinkal/Hinkal.mjs

@@ -0,0 +1,421 @@
+import { ContractType as e } from "../../types/ethereum-network.types.mjs";
+import { CustomJSONStringify as t } from "../../functions/utils/serialize.utils.mjs";
+import { isExtension as n } from "../../constants/vite.constants.mjs";
+import { HINKAL_SUPPORTED_CHAINS as r, WALLET_SUPPORTED_CHAINS as i, chainIds as a, currentSolanaChainId as o, currentTronChainId as s, isSameOnchainNetwork as c, isSolanaLike as l, isTronLike as u, networkRegistry as d, setHinkalTronChainId as f } from "../../constants/chains.constants.mjs";
+import { EventType as p, LoginMessageMode as m } from "../../types/hinkal.types.mjs";
+import { API as h } from "../../API/API.mjs";
+import { supportedPassportLinks as ee } from "../../constants/kyc.constants.mjs";
+import { transactionErrorCodes as te } from "../../error-handling/error-codes.constants.mjs";
+import { getErc20TokensForChain as ne } from "../../functions/utils/erc20tokenFunctions.mjs";
+import "../../API/index.mjs";
+import { poseidonFunction as re } from "../../crypto/poseidon.mjs";
+import { UserKeys as g } from "../crypto-keys/keys.mjs";
+import { validateAndGetChainId as _ } from "../../functions/utils/token-check.utils.mjs";
+import { privateTokensDB as v } from "../TokenDBs/PrivateTokensDB.mjs";
+import { getShieldedBalance as y } from "../../functions/web3/events/getShieldedBalance.mjs";
+import { getMerkleAccountPublicKey as b } from "../../functions/pre-transaction/solana.mjs";
+import { getContractWithFetcherByChainId as x } from "../../functions/web3/getContractMetadata.mjs";
+import { reloadPage as S } from "../../functions/utils/reloadPage.mjs";
+import { createCacheDevice as C } from "../../functions/utils/cacheDevice.utils.mjs";
+import { SolanaProviderAdapter as w } from "../../providers/SolanaProviderAdapter.mjs";
+import { storeAndGetSignatureFromEnclave as T } from "../../functions/utils/enclave-signature-storage.mjs";
+import { generateHashFromSeedPhrases as E } from "../../functions/utils/mnemonics.mjs";
+import { fetchSolanaMerkleTreeRootHash as D } from "../../functions/web3/fetchSolanaMerkleTreeRootHash.mjs";
+import { createTransaferEmporiumOpsBatch as O } from "../../functions/private-wallet/emporium.helpers.mjs";
+import { hinkalDeposit as k, hinkalDepositForOther as A } from "./hinkalDeposit.mjs";
+import { checkTokenLimitsUSD as j } from "../../functions/kyc/checkTokenLimitsUSD.mjs";
+import { hinkalDepositAndWithdraw as M } from "./hinkalDepositAndWithdraw.mjs";
+import { hinkalSolanaDeposit as N, hinkalSolanaDepositForOther as P, hinkalSolanaProoflessDepositWithPublicFee as F } from "./hinkalSolanaDeposit.mjs";
+import { hinkalSwap as I } from "./hinkalSwap.mjs";
+import { hinkalWithdraw as L } from "./hinkalWithdraw.mjs";
+import { MerkleTree as R } from "../merkle-tree/MerkleTree.mjs";
+import "../merkle-tree/index.mjs";
+import { resetMerkleTrees as z } from "./resetMerkleTrees.mjs";
+import { MultiThreadedUtxoUtils as B } from "../MultiThreadedUtxoUtils/MultiThreadedUtxoUtils.mjs";
+import { hinkalPrivateWallet as V } from "./hinkalPrivateWallet.mjs";
+import { getRecipientInfo as ie } from "./hinkalGetRecipientInfo.mjs";
+import { hinkalSignSubAccount as H } from "./hinkalSignSubAccount.mjs";
+import { hinkalActionReceive as U } from "./hinkalActionReceive.mjs";
+import "../TokenDBs/index.mjs";
+import { hinkalProoflessDeposit as W, hinkalProoflessDepositWithPublicFee as G } from "./hinkalProoflessDeposit.mjs";
+import { hinkalProxySwap as K } from "./hinkalProxySwap.mjs";
+import { hinkalMultiSendPrivateRecipients as q } from "./hinkalMultiSend.mjs";
+import { hinkalTransfer as J } from "./hinkalTransfer.mjs";
+import { hinkalProxyToPrivate as Y } from "./hinkalProxyToPrivate.mjs";
+import { TronProviderAdapter as X } from "../../providers/TronProviderAdapter.mjs";
+import { hinkalSolanaDepositAndWithdraw as ae } from "./hinkalSolanaDepositAndWithdraw.mjs";
+import { hinkalSolanaWithdraw as oe } from "./hinkalSolanaWithdraw.mjs";
+import { hinkalSolanaTransfer as se } from "./hinkalSolanaTransfer.mjs";
+import { hinkalSolanaSwap as ce } from "./hinkalSolanaSwap.mjs";
+import { hinkalSolanaProxySend as Z } from "./hinkalSolanaProxySend.mjs";
+import { hinkalSolanaProxySwap as le } from "./hinkalSolanaProxySwap.mjs";
+import { hinkalSolanaProxyShield as Q } from "./hinkalSolanaProxyShield.mjs";
+import { hinkalDepositAndBridge as ue } from "./hinkalDepositAndBridge.mjs";
+import { hinkalClaimUtxo as de } from "./hinkalClaimUtxo.mjs";
+import { hinkalSolanaProoflessDeposit as fe } from "./hinkalSolanaProoflessDeposit.mjs";
+import { hinkalSolanaClaimUtxo as pe } from "./hinkalSolanaClaimUtxo.mjs";
+import { hinkalWithdrawStuckUtxos as me } from "./hinkalWithdrawStuckUtxos.mjs";
+import { PublicKey as $ } from "@solana/web3.js";
+//#region libs/shared/common/src/data-structures/Hinkal/Hinkal.ts
+var he = class {
+	ethereumProviderAdapter;
+	solanaProviderAdapter;
+	tronProviderAdapter;
+	userKeys;
+	signingMessage = "Login to Hinkal Protocol";
+	privateTransferSigningMessage = "Login to Hinkal's Private Transfer App";
+	merkleTreeHinkalByChain = {};
+	nullifiersByChain = {};
+	encryptedOutputsByChain = {};
+	commitmentsSnapshotServiceByChain = {};
+	nullifierSnapshotServiceByChain = {};
+	utxoUtils;
+	lastCallState = /* @__PURE__ */ new Map();
+	cacheDevice;
+	generateProofRemotely;
+	disableMerkleTreeUpdates;
+	constructor(e) {
+		this.userKeys = new g(void 0), e?.tronChainOverride && f(e.tronChainOverride), r.forEach((e) => {
+			this.merkleTreeHinkalByChain[e] = R.create(re, 0n), this.nullifiersByChain[e] = /* @__PURE__ */ new Set(), this.encryptedOutputsByChain[e] = [];
+		}), this.generateProofRemotely = e?.generateProofRemotely ?? !0, this.utxoUtils = new B(), this.cacheDevice = C(e), this.disableMerkleTreeUpdates = e?.disableMerkleTreeUpdates ?? !1;
+	}
+	enforceRateLimit(e, n, r = 1e3) {
+		let i = Date.now(), a = t(n), o = this.lastCallState.get(e);
+		if (o && o.argsKey === a && i - o.timestamp < r) throw Error(`${e} was already called with the same arguments`);
+		this.lastCallState.set(e, {
+			timestamp: i,
+			argsKey: a
+		});
+	}
+	getProviderAdapter(e) {
+		let t = e;
+		t ||= this.ethereumProviderAdapter ? a.ethMainnet : this.solanaProviderAdapter ? o : a.tronMainnet;
+		let n;
+		if (n = l(t) ? this.solanaProviderAdapter : u(t) ? this.tronProviderAdapter : this.ethereumProviderAdapter, !n) throw Error("ProviderAdapter is not initialized");
+		return n;
+	}
+	async initProviderAdapter(e, t) {
+		let n = a.ethMainnet;
+		t instanceof w ? n = o : t instanceof X && (n = s), await this.updateProviderAdapter(n, t), t.initConnector(e);
+		let r = await t.connectAndPatchProvider(e);
+		await t.init(r), await this.setListeners();
+	}
+	getSigningMessage(e = m.PROTOCOL) {
+		switch (e) {
+			case m.PRIVATE_TRANSFER: return this.privateTransferSigningMessage;
+			case m.PROTOCOL:
+			default: return this.signingMessage;
+		}
+	}
+	async signHinkalMessage(e = m.PROTOCOL) {
+		let t = this.getSigningMessage(e);
+		return this.getProviderAdapter().signMessage(t);
+	}
+	async initUserKeys(e = m.PROTOCOL) {
+		this.userKeys = new g(await this.signHinkalMessage(e));
+	}
+	initUserKeysWithSignature(e) {
+		this.userKeys = new g(e);
+	}
+	async initUserKeysFromSeedPhrases(e) {
+		let t = E(e);
+		this.userKeys = new g(t);
+	}
+	async storeAndGetInitialSignature(e, t, n) {
+		let r = await this.getEthereumAddress();
+		if (!r) throw Error("Connected address not found");
+		return await T(r, e, t, n);
+	}
+	async resetMerkle(e) {
+		this.disableMerkleTreeUpdates || (e?.every((e) => this.isSelectedNetworkSupported(e)) ?? !0) && await z(this, e);
+	}
+	getTronWeb() {
+		let e = this.tronProviderAdapter;
+		if (!e) throw Error("Tron provider adapter not initialized");
+		if (!(e instanceof X)) throw Error("Tron provider adapter is not a TronProviderAdapter");
+		let t = e.getTronWeb();
+		if (!t) throw Error("TronWeb not available");
+		return t;
+	}
+	getSupportedChains() {
+		return this.ethereumProviderAdapter && this.solanaProviderAdapter ? i : this.ethereumProviderAdapter ? r.filter((e) => !l(e) && !u(e)) : this.solanaProviderAdapter ? r.filter((e) => l(e)) : this.tronProviderAdapter ? [s] : [];
+	}
+	async waitForTransaction(e, t, n = 1) {
+		return !!await this.getProviderAdapter(e).waitForTransaction(e, t, n);
+	}
+	getContract(e, t, n = void 0) {
+		return this.getProviderAdapter(e).getContract(e, t, n);
+	}
+	getContractWithFetcherByChainId(e, t, n = void 0) {
+		return x(e, t, n);
+	}
+	async signMessage(e) {
+		return await this.getProviderAdapter().signMessage(e);
+	}
+	async signTypedData(e, t, n) {
+		return await this.getProviderAdapter().signTypedData(e, t, n);
+	}
+	async signWithSubAccount(e, t, n, r) {
+		return H(e, t, n, r);
+	}
+	getContractWithSigner(e, t, n = "") {
+		return this.getProviderAdapter(e).getContractWithSigner(e, t, n);
+	}
+	getContractWithFetcher(e, t, n = "") {
+		return this.getProviderAdapter(e).getContractWithFetcher(e, t, n);
+	}
+	isSelectedNetworkSupported(e) {
+		return !!d[e];
+	}
+	async switchNetwork(e) {
+		let t = this.getProviderAdapter(), n = t.getChainId(), r = n !== void 0 && c(e.chainId, n);
+		if (!(e.chainId === n || r)) try {
+			await t.switchNetwork(e);
+		} catch {
+			throw Error(te.FAILED_TO_SWITCH_NETWORKS);
+		}
+	}
+	isPermitterAvailable(e) {
+		return this.getProviderAdapter(e).isPermitterAvailable();
+	}
+	async disconnectFromConnector() {
+		await this.ethereumProviderAdapter?.disconnectFromConnector(), await this.solanaProviderAdapter?.disconnectFromConnector(), await this.tronProviderAdapter?.disconnectFromConnector();
+	}
+	async resetProviderAdapters() {
+		this.ethereumProviderAdapter = void 0, this.solanaProviderAdapter = void 0, this.tronProviderAdapter = void 0;
+	}
+	async updateProviderAdapter(e, t) {
+		try {
+			l(e) ? (this.solanaProviderAdapter && this.solanaProviderAdapter.release(), this.solanaProviderAdapter = t) : u(e) ? (this.tronProviderAdapter && this.tronProviderAdapter.release(), this.tronProviderAdapter = t) : (this.ethereumProviderAdapter && this.ethereumProviderAdapter.release(), this.ethereumProviderAdapter = t);
+		} catch (e) {
+			throw console.error(e), Error("updateProviderAdapter failed, please try again.");
+		}
+	}
+	async setListeners() {
+		this.ethereumProviderAdapter?.setChainEventListener({
+			onAccountChanged: () => {
+				this.onAccountChanged();
+			},
+			onChainChanged: (e) => {
+				this.onChainChanged(e);
+			}
+		}), this.solanaProviderAdapter?.setChainEventListener({
+			onAccountChanged: () => {
+				this.onAccountChanged();
+			},
+			onChainChanged: (e) => {
+				this.onChainChanged(e);
+			}
+		}), this.tronProviderAdapter?.setChainEventListener({
+			onAccountChanged: () => {
+				this.onAccountChanged();
+			},
+			onChainChanged: (e) => {
+				this.onChainChanged(e);
+			}
+		});
+	}
+	async onAccountChanged() {
+		await this.ethereumProviderAdapter?.onAccountChanged(), await this.solanaProviderAdapter?.onAccountChanged(), await this.tronProviderAdapter?.onAccountChanged();
+		let e = p.AccountChanged;
+		typeof document < "u" ? document?.dispatchEvent(new Event(e)) : process?.emit("message", e, void 0);
+	}
+	async onChainChanged(e) {
+		e ? await this.getProviderAdapter(e).onChainChanged(e) : (await this.disconnectFromConnector(), S());
+	}
+	async monitorConnectedAddress(e) {
+		await h.monitor(await this.getEthereumAddressByChain(e));
+	}
+	async getBalances(e, t, n, r, i = !1, a, o = !1) {
+		return y(this, e, t, n, r, i, this.generateProofRemotely, a, o);
+	}
+	async getTotalBalance(e, t, r, i = !1, a, o = !1) {
+		let s = r ?? await this.getEthereumAddressByChain(e), c = t ?? this.userKeys, l = await this.getBalances(e, c.getShieldedPrivateKey(), c.getShieldedPublicKey(), s, i, a, o), u = n ? await v.getPrivateTokens(e, s) : ne(e), d = [];
+		return u.forEach((e) => {
+			let t = e.erc20TokenAddress.toLowerCase(), n = l.get(t), r = {
+				token: e,
+				balance: n?.balance ?? 0n,
+				timestamp: n?.timestamp || "0",
+				nfts: n?.nfts || []
+			};
+			d.push(r);
+		}), d;
+	}
+	async getStuckShieldedBalances(e, t, n) {
+		return (await this.getTotalBalance(e, t, n, !1, !1, !0)).filter((e) => e.balance > 0n);
+	}
+	getSupportedPassportLinks() {
+		return ee;
+	}
+	checkAccessToken(e, t) {
+		return Promise.resolve(!0);
+	}
+	checkExternalTokenLimitsUSD(e, t, n) {
+		return j(e, t, n);
+	}
+	async getHinkalTreeRootHash(t) {
+		if (l(t)) {
+			let { hinkalIdl: e, hinkalAddress: n, originalDeployer: r } = d[t].contractData;
+			if (!e || !n || !r) throw Error(`Missing Solana configuration for chain ${t}`);
+			let i = new $(r), a = b(new $(n), i);
+			return D(this.getSolanaProgram(e), a);
+		}
+		return this.getContractWithFetcherByChainId(t, e.HinkalContract).getRootHash();
+	}
+	async resetMerkleTreesIfNecessary(e) {
+		let t = (await Promise.all((e ?? this.getSupportedChains()).map(async (e) => {
+			let t = await this.getHinkalTreeRootHash(e);
+			return {
+				chainId: e,
+				needsReset: BigInt(t) !== this.merkleTreeHinkalByChain[e].getRootHash()
+			};
+		}))).filter((e) => e.needsReset).map((e) => e.chainId);
+		t.length > 0 && (console.log("resetting merkle tree in resetMerkleTreesIfNecessary for chains:", t), await this.resetMerkle(t));
+	}
+	async getEthereumAddress() {
+		let e = this.ethereumProviderAdapter ?? this.solanaProviderAdapter ?? this.tronProviderAdapter;
+		if (!e) throw Error("No provider adapter initialized");
+		return e.getAddress();
+	}
+	getEthereumAddressByChain(e) {
+		return this.getProviderAdapter(e).getAddress();
+	}
+	async getRandomRelay(e, t = !1) {
+		return (await h.getIdleRelay(e, t)).relay;
+	}
+	getGasPrice(e) {
+		let t = this.getProviderAdapter(e);
+		if (!t) throw Error("Illegal State of providerAdapter in Hinkal: no providerAdapter initialized");
+		return t.getGasPrice(e);
+	}
+	getAPI() {
+		return h;
+	}
+	snapshotsClearInterval() {
+		this.getSupportedChains().forEach((e) => {
+			this.commitmentsSnapshotServiceByChain[e]?.intervalClear(), this.nullifierSnapshotServiceByChain[e]?.intervalClear();
+		});
+	}
+	getRecipientInfo() {
+		return ie(this);
+	}
+	async deposit(e, t, n = !0, r = !1) {
+		return k(this, e, t, n, r);
+	}
+	async depositSolana(e, t, n = !1) {
+		return N(this, e, t, n);
+	}
+	async depositForOther(e, t, n, r = !0, i = !1, a) {
+		return this.enforceRateLimit(this.depositForOther.name, [
+			e,
+			t,
+			n
+		]), A(this, e, t, n, r, i, a);
+	}
+	async depositSolanaForOther(e, t, n, r = !1, i) {
+		return this.enforceRateLimit(this.depositSolanaForOther.name, [
+			e,
+			t,
+			n
+		]), P(this, e, t, n, r, i);
+	}
+	async depositAndWithdraw(e, t, n, r, i, a, o, s, c = !0) {
+		return l(_([e])) ? ae(this, e, t, n, r, i, a, o, s) : M(this, e, t, n, r, i, a, o, s, c);
+	}
+	async claimUtxo(e, t, n, r) {
+		return l(_([e])) ? pe(this, e, t, r, n) : de(this, e, t, r, n);
+	}
+	async depositAndBridge(e, t, n, r, i, a, o, s = !0) {
+		return ue(this, e, t, n, r, i, a, o, s);
+	}
+	async prooflessDeposit(e, t, n, r, i = !1) {
+		return l(_(e)) ? fe(this, e, t, n, r, i) : W(this, e, t, n, r, i);
+	}
+	async prooflessDepositWithPublicFee(e, t, n, r, i) {
+		let a = _([e]);
+		return l(a) ? F(this, e, t, n, r, i) : G(this, a, e, t, n, r, i);
+	}
+	getSolanaProgram(e) {
+		if (!this.solanaProviderAdapter) throw Error("No provider adapter initialized");
+		if (!("getSolanaProgram" in this.solanaProviderAdapter)) throw Error("Current provider adapter is not a Solana provider adapter");
+		return this.solanaProviderAdapter.getSolanaProgram(e);
+	}
+	getSolanaPublicKey() {
+		if (!this.solanaProviderAdapter) throw Error("No provider adapter initialized");
+		if (!("getSolanaPublicKey" in this.solanaProviderAdapter)) throw Error("Current provider adapter is not a Solana provider adapter");
+		return this.solanaProviderAdapter.getSolanaPublicKey();
+	}
+	async transfer(e, t, n, r, i, a) {
+		return this.enforceRateLimit(this.transfer.name, [
+			e,
+			t,
+			n
+		]), l(_(e)) ? se(this, e, t, n, r, i, a) : J(this, e, t, n, r, i, a);
+	}
+	async withdraw(e, t, n, r, i, a, o) {
+		return l(_(e)) ? oe(this, e, t, n, i, a, o) : L(this, e, t, n, r, i, a, o);
+	}
+	async withdrawStuckUtxos(e, t) {
+		return me(this, e, t);
+	}
+	async swap(e, t, n, r, i, a, o) {
+		return l(_(e)) ? this.swapSolana(e, t, r, i, a, o) : I(this, e, t, n, r, i, a, o);
+	}
+	async swapSolana(e, t, n, r, i, a) {
+		let o = JSON.parse(n), s = BigInt(o.swapperAccountSalt), { instructionLists: c, addressLookupTableAccount: l } = o.data;
+		return ce(this, e, t, s, c, l, r, i, a);
+	}
+	async actionReceive(e, t, n, r, i, a) {
+		if (!i) throw Error("subAccount is required");
+		return l(_(e)) ? Q(this, e[0], t[0], i, void 0, a) : U(this, e, t, n, r, i, a);
+	}
+	async actionPrivateWallet(e, t, n, r, i, a, o, s, c, l, u = !1, d, f, p) {
+		return this.enforceRateLimit(this.actionPrivateWallet.name, [
+			e,
+			t,
+			n,
+			r,
+			i,
+			a,
+			o,
+			s,
+			c,
+			p
+		]), V(this, e, t, n, r, i, a, o, s, c, l, u, d, f, p);
+	}
+	async proxySwap(e, t, n, r, i, a, o, s, c = !1, u, d) {
+		return l(_(e)) ? le(this, e, t, r, a, n, o, s, d) : K(this, e, t, n, r, i, a, o, s, c, u, d);
+	}
+	async proxyToPrivate(e, t, n, r, i, a, o) {
+		return l(_(e)) ? (this.enforceRateLimit(this.proxyToPrivate.name, [
+			e[0],
+			t[0],
+			n,
+			r
+		]), Q(this, e[0], t[0], n, r, o)) : Y(this, e, t, r, i, a, n, o);
+	}
+	async proxySend(e, t, n, r, i, a, o) {
+		let s = _(e);
+		if (l(s)) return Z(this, e[0], t[0], n, r, o);
+		let c = O(this, s, e.map((e) => e.erc20TokenAddress), t, r), u = e.map((e, n) => ({
+			token: e,
+			amount: -1n * t[n]
+		}));
+		return await this.actionPrivateWallet(s, [], [], [], c, u, n, i, a, void 0, void 0, void 0, o, void 0);
+	}
+	async multiSendPrivateRecipients(e, t, n) {
+		return this.enforceRateLimit(this.multiSendPrivateRecipients.name, [
+			e,
+			t,
+			n
+		]), q(this, e, t, n);
+	}
+	areMerkleTreeUpdatesDisabled() {
+		return this.disableMerkleTreeUpdates;
+	}
+	updateMerkleTreeUpdates(e) {
+		this.disableMerkleTreeUpdates = e;
+	}
+};
+//#endregion
+export { he as Hinkal };

package/data-structures/Hinkal/IHinkal.d.ts

@@ -0,0 +1,98 @@
+import { FeeStructure, LoginMessageMode } from '../../types/hinkal.types';
+import { ContractType, EthereumNetwork } from '../../types/ethereum-network.types';
+import { EncryptedOutputWithSign } from '../../types/commitments.types';
+import { ExternalActionId } from '../../types/external-action.types';
+import { IMultiThreadedUtxoUtils } from '../../types/IMultiThreadedUtxoUtils';
+import { ERC20Token, PrivateRecipientInfo, TokenBalance, TokenChanges } from '../../types/token.types';
+import { ethers } from 'ethers';
+import { Types as TronWebTypes, TronWeb } from 'tronweb';
+import { UserKeys } from '../crypto-keys/keys';
+import { IProviderAdapter } from '../provider-adapter/IProviderAdapter';
+import { ClientCommitmentsSnapshotService, ClientNullifierSnapshotService, ClientSolanaCommitmentsSnapshotService, ClientSolanaNullifierSnapshotService } from '../snapshot';
+import { MerkleTree } from '../merkle-tree';
+import { IAPI } from '../../API/API';
+import { ICacheDevice } from '../../types/ICacheDevice';
+import { StealthAddressStructure, TypedData } from '../../types/circom-data.types';
+import { SubAccount } from '../../types/proxy.types';
+import { AdminTransactionType } from '../../types/admin.types';
+import { Idl, Program } from '@coral-xyz/anchor';
+import { PublicKey } from '@solana/web3.js';
+import { BridgeRecipient } from '../../types/bridging-tx.types';
+import { Utxo } from '../utxo/Utxo';
+export interface IHinkal<ConnectorType = unknown> {
+    userKeys: UserKeys;
+    readonly signingMessage: string;
+    readonly privateTransferSigningMessage: string;
+    merkleTreeHinkalByChain: Record<number, MerkleTree<bigint>>;
+    nullifiersByChain: Record<number, Set<string>>;
+    encryptedOutputsByChain: Record<number, EncryptedOutputWithSign[]>;
+    commitmentsSnapshotServiceByChain: Record<number, ClientCommitmentsSnapshotService | ClientSolanaCommitmentsSnapshotService | undefined>;
+    nullifierSnapshotServiceByChain: Record<number, ClientNullifierSnapshotService | ClientSolanaNullifierSnapshotService | undefined>;
+    generateProofRemotely: boolean;
+    utxoUtils: IMultiThreadedUtxoUtils;
+    cacheDevice: ICacheDevice;
+    getBalances(chainId: number, passedShieldedPrivateKey: string, passedShieldedPublicKey: string, ethAddress: string, resetCacheBefore?: boolean, updateTokensListBefore?: boolean): Promise<Map<string, TokenBalance>>;
+    getTotalBalance(chainId: number, userKeys?: UserKeys, ethAddress?: string, resetCacheBefore?: boolean, updateTokensListBefore?: boolean, useBlockedUtxos?: boolean): Promise<TokenBalance[]>;
+    getStuckShieldedBalances(chainId: number, userKeys?: UserKeys, ethAddress?: string): Promise<TokenBalance[]>;
+    getSupportedPassportLinks(): string[];
+    checkAccessToken(chainId: number, accessKeyOverride?: string): Promise<boolean>;
+    checkExternalTokenLimitsUSD(chainId: number, tokenAddresses: string[], amounts: bigint[]): Promise<boolean>;
+    getSupportedChains(): number[];
+    getEthereumAddress(): Promise<string>;
+    getEthereumAddressByChain(chainId: number): Promise<string>;
+    getHinkalTreeRootHash(chainId: number): Promise<bigint>;
+    resetMerkleTreesIfNecessary(chainIdsToCheck?: number[]): Promise<void>;
+    resetMerkle(chainIds?: number[]): Promise<void>;
+    getRandomRelay(chainId: number, markAsPending?: boolean): Promise<string | undefined>;
+    getGasPrice(chainId: number): Promise<bigint>;
+    getAPI(): IAPI;
+    snapshotsClearInterval(): void;
+    getRecipientInfo(): string;
+    deposit(erc20Tokens: ERC20Token[], amountChanges: bigint[], preEstimateGas?: boolean, returnTxData?: boolean): Promise<ethers.TransactionResponse | ethers.TransactionRequest | string | TronWebTypes.Transaction<TronWebTypes.TriggerSmartContract>>;
+    depositForOther(erc20Tokens: ERC20Token[], amountChanges: bigint[], recepinetInfo: string, preEstimateGas?: boolean, returnTxData?: boolean, action?: AdminTransactionType): Promise<ethers.TransactionResponse | ethers.TransactionRequest | string | TronWebTypes.Transaction<TronWebTypes.TriggerSmartContract>>;
+    claimUtxo(erc20Token: ERC20Token, utxo: Utxo, claimableSignature?: string, feeStructureOverride?: FeeStructure): Promise<string>;
+    depositAndWithdraw(erc20Token: ERC20Token, recipientAmounts: bigint[], recipientAddresses: string[], txCompletionTime?: number, feeStructureOverride?: FeeStructure, ref?: string, action?: AdminTransactionType, dashboardAccountId?: string, preEstimateGas?: boolean): Promise<string>;
+    depositAndBridge(erc20Token: ERC20Token, recipientBridges: BridgeRecipient[], txCompletionTime?: number, feeStructureOverride?: FeeStructure, ref?: string, action?: AdminTransactionType, dashboardAccountId?: string, preEstimateGas?: boolean): Promise<string>;
+    prooflessDeposit(erc20Tokens: ERC20Token[], amountChanges: bigint[], stealthAddressStructures?: StealthAddressStructure[], action?: AdminTransactionType, returnTxData?: boolean): Promise<string | ethers.TransactionRequest | TronWebTypes.Transaction<TronWebTypes.TriggerSmartContract>>;
+    prooflessDepositWithPublicFee(erc20Token: ERC20Token, amounts: bigint[], stealthAddressStructures: StealthAddressStructure[], feeAmount: bigint, action?: AdminTransactionType): Promise<string>;
+    getSolanaProgram(idl: Idl): Program;
+    getSolanaPublicKey(): PublicKey;
+    depositSolana(amount: bigint, token: ERC20Token): Promise<string>;
+    depositSolanaForOther(amount: bigint, token: ERC20Token, recipientInfo: string, returnTxData?: boolean, action?: AdminTransactionType): Promise<string>;
+    transfer(erc20Tokens: ERC20Token[], amountChanges: bigint[], recipientAddress: string, feeToken?: string, feeStructureOverride?: FeeStructure, action?: AdminTransactionType): Promise<string>;
+    withdraw(erc20Tokens: ERC20Token[], deltaAmounts: bigint[], recipientAddress: string, isRelayerOff: boolean, feeToken?: string, feeStructureOverride?: FeeStructure, action?: AdminTransactionType): Promise<ethers.TransactionResponse | string>;
+    withdrawStuckUtxos(erc20Token: ERC20Token, recipientAddress: string): Promise<string[]>;
+    swap(erc20Tokens: ERC20Token[], deltaAmounts: bigint[], externalActionId: ExternalActionId, swapData: string, feeToken?: string, feeStructureOverride?: FeeStructure, action?: AdminTransactionType): Promise<string>;
+    getProviderAdapter(chainId?: number): IProviderAdapter;
+    getTronWeb(): TronWeb;
+    getSigningMessage(mode?: LoginMessageMode): string;
+    signHinkalMessage(mode?: LoginMessageMode): Promise<string>;
+    initUserKeys(mode?: LoginMessageMode): Promise<void>;
+    initUserKeysWithSignature(signature: string): void;
+    initUserKeysFromSeedPhrases(seedPhrases: string[]): Promise<void>;
+    storeAndGetInitialSignature(authSignature: string, isSolanaLedger: boolean, txMessageForSolanaLedger?: string): Promise<string>;
+    initProviderAdapter(connector: ConnectorType, providerAdapter: IProviderAdapter<ConnectorType>): Promise<void>;
+    disconnectFromConnector(): Promise<void>;
+    resetProviderAdapters(): Promise<void>;
+    setListeners(providerAdapter: IProviderAdapter): Promise<void>;
+    waitForTransaction(chainId: number, transactionHash: string, confirmations?: number): Promise<boolean>;
+    getContract(chainId: number, contractType: ContractType, contractAddress?: string): ethers.Contract;
+    getContractWithSigner(chainId: number, contractType: ContractType, contractAddress?: string): ethers.Contract;
+    getContractWithFetcher(chainId: number, contractType: ContractType, contractAddress?: string): ethers.Contract;
+    getContractWithFetcherByChainId(chainId: number, contractType: ContractType, contractAddress?: string): ethers.Contract;
+    isSelectedNetworkSupported(chainId: number): boolean;
+    switchNetwork(network: EthereumNetwork): Promise<unknown>;
+    monitorConnectedAddress(chainId: number): Promise<void>;
+    isPermitterAvailable(chainId: number): boolean;
+    signMessage(message: string): Promise<string>;
+    signTypedData(domain: ethers.TypedDataDomain, types: Record<string, ethers.TypedDataField[]>, value: Record<string, unknown>): Promise<string>;
+    signWithSubAccount(chainId: number, messageToSign: string | undefined, typedData: TypedData | undefined, subAccount: SubAccount): Promise<string>;
+    actionPrivateWallet(chainId: number, erc20Tokens: ERC20Token[], deltaAmounts: bigint[], onChainCreation: boolean[], ops: string[], emporiumTokenChanges: TokenChanges<bigint>[], subAccount?: SubAccount, feeToken?: string, feeStructureOverride?: FeeStructure, relayOverride?: string, autoDepositBack?: boolean, maxGasInDollar?: string, action?: AdminTransactionType, privateRecipientInfo?: PrivateRecipientInfo): Promise<string>;
+    actionReceive(erc20Tokens: ERC20Token[], deltaAmounts: bigint[], feeTokens?: string, feeStructureOverride?: FeeStructure, subAccount?: SubAccount, action?: AdminTransactionType): Promise<string>;
+    proxySwap(erc20Tokens: ERC20Token[], deltaAmounts: bigint[], externalActionId: ExternalActionId, swapData: string, isTheSameChainSwap: boolean, subAccount: SubAccount, feeToken?: string, feeStructureOverride?: FeeStructure, autoDepositBack?: boolean, maxGasInDollar?: string, action?: AdminTransactionType): Promise<string>;
+    proxyToPrivate(erc20Tokens: ERC20Token[], deltaAmountsBase: bigint[], subAccount: SubAccount, recipientInfo: string, feeToken?: string, feeStructureOverride?: FeeStructure, action?: AdminTransactionType): Promise<string>;
+    proxySend(erc20Tokens: ERC20Token[], amounts: bigint[], subAccount: SubAccount, recipientAddress: string, feeToken?: string, feeStructureOverride?: FeeStructure, action?: AdminTransactionType): Promise<string>;
+    multiSendPrivateRecipients(erc20Tokens: ERC20Token[], amounts: bigint[], extendedRecipientInfos?: string[]): Promise<string>;
+    areMerkleTreeUpdatesDisabled(): boolean;
+    updateMerkleTreeUpdates(value: boolean): void;
+}

package/data-structures/Hinkal/handleAutoDepositBack.cjs

@@ -0,0 +1 @@
+const e=require(`../../types/external-action.types.cjs`),t=require(`../../constants/chains.constants.cjs`),n=require(`../../types/transactions.types.cjs`),r=require(`../../types/admin.types.cjs`),i=require(`../../types/activities.types.cjs`),a=require(`../../types/transaction.types.cjs`),o=require(`../../types/offscreen.types.cjs`);require(`../../types/index.cjs`);const s=require(`../../functions/utils/caseInsensitive.utils.cjs`),c=require(`../../API/API.cjs`),l=require(`../../error-handling/error-codes.constants.cjs`),u=require(`../../functions/web3/etherFunctions.cjs`),d=require(`../../functions/utils/erc20tokenFunctions.cjs`),f=require(`../../functions/utils/time.utils.cjs`),p=require(`../../error-handling/customErrors/ErrorWithTx.cjs`),m=require(`../../error-handling/logger.cjs`),h=require(`../../functions/utils/create-provider.cjs`),g=require(`../../error-handling/get-error.message.cjs`);require(`../../error-handling/index.cjs`);const _=require(`../../functions/pre-transaction/getVolatileTransferAmount.cjs`),v=require(`../../functions/pre-transaction/getFeeStructure.cjs`),y=require(`../../functions/utils/convertEmporiumOpToCallInfo.cjs`),b=require(`../../functions/utils/postToOffscreen.cjs`),x=require(`../../functions/utils/fees.utils.cjs`),S=require(`../../functions/private-wallet/emporium.helpers.cjs`),C=require(`../../functions/auto-deposit-back-helpers/get-tokens-to-deposit-back.cjs`),w=require(`../../functions/auto-deposit-back-helpers/get-gas-token-records.cjs`),T=require(`../../functions/auto-deposit-back-helpers/select-gas-token.cjs`),ee=require(`../../functions/auto-deposit-back-helpers/update-hinkal.cjs`);require(`../../functions/index.cjs`);const E=require(`../IndexedDB/activity-db.cjs`);require(`../IndexedDB/index.cjs`);var D=3*1e3,O=13*1e3,k=async(k,A,j,M,N,P,F,I)=>{if(!j||F.length===0)return;let L;try{let a=h.createJsonRpcProvider(A);await f.waitLittle(A===t.chainIds.ethMainnet?O:D);let p=await C.getTokensToDepositBack(F,N,j,a);if(!p.length){b.postToOffscreen(o.MessagesFromOffscreen.AutoShieldTxStatus,{message:l.transactionErrorCodes.AUTO_SHIELD_SKIPPED});return}let m=x.getGasTokenSymbols(A).map(e=>d.getERC20TokenBySymbol(e,A)).filter(e=>e!==void 0),{prices:g}=await c.API.getTokenPrices(A,m.map(e=>e.erc20TokenAddress)),R=new Map(g.map((e,t)=>[m[t].erc20TokenAddress.toLowerCase(),e])),z=p.map(({token:e})=>e),B=p.map(({balance:e})=>e),V=z.map(({erc20TokenAddress:e})=>e),H=S.createTransaferEmporiumOpsBatch(k,A,V,await _.modifyVolatileTokenAmountChanges(A,z,B,j)),U=await v.getFeeStructure(A,N,V,e.ExternalActionId.Emporium,H.map(e=>y.convertEmporiumOpToCallInfo(e,j,A))),{flatFee:W}=U??{},G=d.getERC20Token(U.feeToken,A);if(!G)return;let K=u.getAmountInToken(G,W),q=(R.get(G.erc20TokenAddress.toLowerCase())??0)*Number(K),J=await T.selectGasToken(N,q,A,z,H,await w.getGasTokenRecords(m,A,k,j,a,R),U,V,j);if(!J)return;let{feeToken:Y,feeStructure:X}=J??{};if(P&&Number(P)<q){b.postToOffscreen(o.MessagesFromOffscreen.AutoShieldTxStatus,{message:l.gasErrorCodes.GAS_PRICE_EXCEEDS_AUTOSHIELD_LIMIT});return}let Z=z.findIndex(e=>s.caseInsensitiveEqual(e.erc20TokenAddress,Y));Z!==-1&&(B[Z]-=X?.flatFee??0n);let{hinkalAddress:Q}=t.networkRegistry[A].contractData,$={activityType:i.ActivityTypes.AUTO_SHIELD,chainId:A,from:j,to:Q,gasInDollar:q.toString(),tokensReceive:z.map((e,t)=>({amount:u.getAmountInToken(e,B[t]),token:e}))};L=await E.activityStorage.saveTxRequest($),b.postToOffscreen(o.MessagesFromOffscreen.AutoShieldTxStatus,{status:n.TransactionStatus.Loading}),ee.updateHinkal(I,A,k);let te={id:0,success:!0,txHash:await k.actionReceive(z,B,Y,X,M,r.AdminTransactionType.AutoShield)};await E.activityStorage.updatePendingTransactions(te,L),b.postToOffscreen(o.MessagesFromOffscreen.AutoShieldTxStatus,{status:n.TransactionStatus.Confirmed,activityRequest:$})}catch(e){let t;e instanceof p.ErrorWithRelayerTransaction&&(t=e.txHash);let r={error:e,id:0,success:!1,...t?{erroredTx:t}:{}};L&&await E.activityStorage.updatePendingTransactions(r,L),b.postToOffscreen(o.MessagesFromOffscreen.AutoShieldTxStatus,{status:n.TransactionStatus.Failed,error:g.getErrorMessageFromTransactionRequest(e,a.TransactionRequestType.ReceiveFromShieldedAccount)}),m.Logger.error(`Error in auto deposit back:`,e)}};exports.handleAutoDepositBack=k;

package/data-structures/Hinkal/handleAutoDepositBack.d.ts

@@ -0,0 +1,3 @@
+import { IHinkal } from './IHinkal';
+import { CircomDataType, SubAccount, TokenChanges } from '../../types';
+export declare const handleAutoDepositBack: (hinkal: IHinkal, chainId: number, walletAddress: string | undefined, subAccount: SubAccount, feeToken: string | undefined, maxGasInDollar: string | undefined, emporiumTokenChanges: TokenChanges<bigint>[], circomData: CircomDataType) => Promise<void>;

package/data-structures/Hinkal/handleAutoDepositBack.mjs

@@ -0,0 +1,93 @@
+import { ExternalActionId as e } from "../../types/external-action.types.mjs";
+import { chainIds as t, networkRegistry as n } from "../../constants/chains.constants.mjs";
+import { TransactionStatus as r } from "../../types/transactions.types.mjs";
+import { AdminTransactionType as i } from "../../types/admin.types.mjs";
+import { ActivityTypes as a } from "../../types/activities.types.mjs";
+import { TransactionRequestType as o } from "../../types/transaction.types.mjs";
+import { MessagesFromOffscreen as s } from "../../types/offscreen.types.mjs";
+import "../../types/index.mjs";
+import { caseInsensitiveEqual as c } from "../../functions/utils/caseInsensitive.utils.mjs";
+import { API as l } from "../../API/API.mjs";
+import { gasErrorCodes as u, transactionErrorCodes as d } from "../../error-handling/error-codes.constants.mjs";
+import { getAmountInToken as f } from "../../functions/web3/etherFunctions.mjs";
+import { getERC20Token as p, getERC20TokenBySymbol as m } from "../../functions/utils/erc20tokenFunctions.mjs";
+import { waitLittle as h } from "../../functions/utils/time.utils.mjs";
+import { ErrorWithRelayerTransaction as g } from "../../error-handling/customErrors/ErrorWithTx.mjs";
+import { Logger as _ } from "../../error-handling/logger.mjs";
+import { createJsonRpcProvider as ee } from "../../functions/utils/create-provider.mjs";
+import { getErrorMessageFromTransactionRequest as v } from "../../error-handling/get-error.message.mjs";
+import "../../error-handling/index.mjs";
+import { modifyVolatileTokenAmountChanges as y } from "../../functions/pre-transaction/getVolatileTransferAmount.mjs";
+import { getFeeStructure as b } from "../../functions/pre-transaction/getFeeStructure.mjs";
+import { convertEmporiumOpToCallInfo as x } from "../../functions/utils/convertEmporiumOpToCallInfo.mjs";
+import { postToOffscreen as S } from "../../functions/utils/postToOffscreen.mjs";
+import { getGasTokenSymbols as C } from "../../functions/utils/fees.utils.mjs";
+import { createTransaferEmporiumOpsBatch as w } from "../../functions/private-wallet/emporium.helpers.mjs";
+import { getTokensToDepositBack as T } from "../../functions/auto-deposit-back-helpers/get-tokens-to-deposit-back.mjs";
+import { getGasTokenRecords as E } from "../../functions/auto-deposit-back-helpers/get-gas-token-records.mjs";
+import { selectGasToken as D } from "../../functions/auto-deposit-back-helpers/select-gas-token.mjs";
+import { updateHinkal as O } from "../../functions/auto-deposit-back-helpers/update-hinkal.mjs";
+import "../../functions/index.mjs";
+import { activityStorage as k } from "../IndexedDB/activity-db.mjs";
+import "../IndexedDB/index.mjs";
+//#region libs/shared/common/src/data-structures/Hinkal/handleAutoDepositBack.ts
+var te = 3 * 1e3, ne = 13 * 1e3, A = async (A, j, M, N, P, F, I, L) => {
+	if (!M || I.length === 0) return;
+	let R;
+	try {
+		let o = ee(j);
+		await h(j === t.ethMainnet ? ne : te);
+		let g = await T(I, P, M, o);
+		if (!g.length) {
+			S(s.AutoShieldTxStatus, { message: d.AUTO_SHIELD_SKIPPED });
+			return;
+		}
+		let _ = C(j).map((e) => m(e, j)).filter((e) => e !== void 0), { prices: v } = await l.getTokenPrices(j, _.map((e) => e.erc20TokenAddress)), z = new Map(v.map((e, t) => [_[t].erc20TokenAddress.toLowerCase(), e])), B = g.map(({ token: e }) => e), V = g.map(({ balance: e }) => e), H = B.map(({ erc20TokenAddress: e }) => e), U = w(A, j, H, await y(j, B, V, M)), W = await b(j, P, H, e.Emporium, U.map((e) => x(e, M, j))), { flatFee: G } = W ?? {}, K = p(W.feeToken, j);
+		if (!K) return;
+		let q = f(K, G), J = (z.get(K.erc20TokenAddress.toLowerCase()) ?? 0) * Number(q), Y = await D(P, J, j, B, U, await E(_, j, A, M, o, z), W, H, M);
+		if (!Y) return;
+		let { feeToken: X, feeStructure: Z } = Y ?? {};
+		if (F && Number(F) < J) {
+			S(s.AutoShieldTxStatus, { message: u.GAS_PRICE_EXCEEDS_AUTOSHIELD_LIMIT });
+			return;
+		}
+		let Q = B.findIndex((e) => c(e.erc20TokenAddress, X));
+		Q !== -1 && (V[Q] -= Z?.flatFee ?? 0n);
+		let { hinkalAddress: re } = n[j].contractData, $ = {
+			activityType: a.AUTO_SHIELD,
+			chainId: j,
+			from: M,
+			to: re,
+			gasInDollar: J.toString(),
+			tokensReceive: B.map((e, t) => ({
+				amount: f(e, V[t]),
+				token: e
+			}))
+		};
+		R = await k.saveTxRequest($), S(s.AutoShieldTxStatus, { status: r.Loading }), O(L, j, A);
+		let ie = {
+			id: 0,
+			success: !0,
+			txHash: await A.actionReceive(B, V, X, Z, N, i.AutoShield)
+		};
+		await k.updatePendingTransactions(ie, R), S(s.AutoShieldTxStatus, {
+			status: r.Confirmed,
+			activityRequest: $
+		});
+	} catch (e) {
+		let t;
+		e instanceof g && (t = e.txHash);
+		let n = {
+			error: e,
+			id: 0,
+			success: !1,
+			...t ? { erroredTx: t } : {}
+		};
+		R && await k.updatePendingTransactions(n, R), S(s.AutoShieldTxStatus, {
+			status: r.Failed,
+			error: v(e, o.ReceiveFromShieldedAccount)
+		}), _.error("Error in auto deposit back:", e);
+	}
+};
+//#endregion
+export { A as handleAutoDepositBack };

package/data-structures/Hinkal/hinkalActionReceive.cjs

@@ -0,0 +1 @@
+const e=require(`../../types/external-action.types.cjs`),t=require(`../../functions/utils/token-check.utils.cjs`),n=require(`../../functions/pre-transaction/getVolatileTransferAmount.cjs`),r=require(`../AccountActions/AccountActions.cjs`),i=require(`../../functions/pre-transaction/getFeeStructure.cjs`),a=require(`../../functions/utils/convertEmporiumOpToCallInfo.cjs`),o=require(`../../functions/private-wallet/emporium.helpers.cjs`);var s=async(s,c,l,u,d,f,p)=>{if(!f)throw Error(`hinkalActionReceive: subAccount should be provided`);if(!u)throw Error(`Fee token is required in hinkalActionReceive`);let m=t.validateAndGetChainId(c),h=r.AccountActions.getAddressFromSubAccount(m,f);if(!h)throw Error(`Public account address is not available`);let g=c.map(e=>e.erc20TokenAddress),_=await n.modifyVolatileTokenAmountChanges(m,c,l,h),v=o.createTransaferEmporiumOpsBatch(s,m,g,_),y=d??await i.getFeeStructure(m,u,g,e.ExternalActionId.Emporium,v.map(e=>a.convertEmporiumOpToCallInfo(e,h,m))),b=c.map((e,t)=>({token:e,amount:-1n*_[t]}));return s.actionPrivateWallet(m,c,_,_.map(()=>!1),v,b,f,u,y,void 0,void 0,void 0,p,void 0)};exports.hinkalActionReceive=s;

package/data-structures/Hinkal/hinkalActionReceive.d.ts

@@ -0,0 +1,7 @@
+import { IHinkal } from './IHinkal';
+import { FeeStructure } from '../../types/hinkal.types';
+import { ERC20Token } from '../../types/token.types';
+import { SubAccount } from '../../types/proxy.types';
+import { AdminTransactionType } from '../../types/admin.types';
+export declare const hinkalActionReceive: (hinkal: IHinkal, erc20Tokens: ERC20Token[], deltaAmountsBase: bigint[], // should be positive
+feeToken?: string, feeStructureOverride?: FeeStructure, subAccount?: SubAccount, action?: AdminTransactionType) => Promise<string>;