@kapa123456789/sdk 0.0.1

package/common/src/data-structures/Hinkal/Hinkal.mjs

@@ -0,0 +1,425 @@
+import { CustomJSONStringify as e } from "../../functions/utils/serialize.utils.mjs";
+import { isExtension as t } from "../../constants/vite.constants.mjs";
+import { HINKAL_SUPPORTED_CHAINS as n, WALLET_SUPPORTED_CHAINS as r, chainIds as i, currentTronChainId as a, isSolanaLike as o, isTronLike as s, networkRegistry as c } from "../../constants/chains.constants.mjs";
+import { EventType as l, LoginMessageMode as u } from "../../types/hinkal.types.mjs";
+import { ContractType as d } from "../../types/ethereum-network.types.mjs";
+import { poseidonFunction as f } from "../../crypto/poseidon.mjs";
+import { getAccessTokenMerkleAccountPublicKey as p, getMerkleAccountPublicKey as m } from "../../functions/pre-transaction/solana.mjs";
+import { hinkalCheckSolanaTokenRegistry as ee } from "./hinkalCheckSolanaTokenRegistry.mjs";
+import { checkHinkalAccessToken as te } from "../../functions/web3/functionCalls/accessTokenCalls.mjs";
+import { transactionErrorCodes as h } from "../../error-handling/error-codes.constants.mjs";
+import { getErc20TokensForChain as g } from "../../functions/utils/erc20tokenFunctions.mjs";
+import { UserKeys as _ } from "../crypto-keys/keys.mjs";
+import { API as v } from "../../API/API.mjs";
+import { validateAndGetChainId as y } from "../../functions/utils/token-check.utils.mjs";
+import { privateTokensDB as ne } from "../TokenDBs/PrivateTokensDB.mjs";
+import { getShieldedBalance as re } from "../../functions/web3/events/getShieldedBalance.mjs";
+import { supportedPassportLinks as b } from "../../constants/kyc.constants.mjs";
+import { reloadPage as x } from "../../functions/utils/reloadPage.mjs";
+import { createCacheDevice as S } from "../../functions/utils/cacheDevice.utils.mjs";
+import { getContractWithFetcherByChainId as C } from "../../functions/web3/getContractMetadata.mjs";
+import { SolanaProviderAdapter as w } from "../../providers/SolanaProviderAdapter.mjs";
+import { hinkalCheckTokenRegistry as T, hinkalCheckTronTokenRegistry as E } from "./hinkalCheckTokenRegistry.mjs";
+import { MerkleTree as D } from "../merkle-tree/MerkleTree.mjs";
+import "../merkle-tree/index.mjs";
+import { fetchSolanaMerkleTreeRootHash as O } from "../../functions/web3/fetchSolanaMerkleTreeRootHash.mjs";
+import { hinkalDeposit as k, hinkalDepositForOther as A } from "./hinkalDeposit.mjs";
+import { createTransaferEmporiumOpsBatch as j } from "../../functions/private-wallet/emporium.helpers.mjs";
+import "../../API/index.mjs";
+import { checkTokenLimitsUSD as M } from "../../functions/kyc/checkTokenLimitsUSD.mjs";
+import { hinkalDepositAndWithdraw as N } from "./hinkalDepositAndWithdraw.mjs";
+import { hinkalSolanaDeposit as P, hinkalSolanaDepositForOther as F } from "./hinkalSolanaDeposit.mjs";
+import { hinkalSwap as I } from "./hinkalSwap.mjs";
+import { hinkalWithdraw as L } from "./hinkalWithdraw.mjs";
+import { resetMerkleTrees as R } from "./resetMerkleTrees.mjs";
+import { MultiThreadedUtxoUtils as z } from "../MultiThreadedUtxoUtils/MultiThreadedUtxoUtils.mjs";
+import { hinkalPrivateWallet as ie } from "./hinkalPrivateWallet.mjs";
+import { getRecipientInfo as B } from "./hinkalGetRecipientInfo.mjs";
+import { hinkalSignSubAccount as V } from "./hinkalSignSubAccount.mjs";
+import { hinkalActionReceive as H } from "./hinkalActionReceive.mjs";
+import "../TokenDBs/index.mjs";
+import { hinkalProoflessDeposit as U } from "./hinkalProoflessDeposit.mjs";
+import { hinkalProxySwap as W } from "./hinkalProxySwap.mjs";
+import { hinkalMultiSendPrivateRecipients as G } from "./hinkalMultiSend.mjs";
+import { hinkalTransfer as K } from "./hinkalTransfer.mjs";
+import { hinkalProxyToPrivate as q } from "./hinkalProxyToPrivate.mjs";
+import { TronProviderAdapter as J } from "../../providers/TronProviderAdapter.mjs";
+import { hinkalSolanaDepositAndWithdraw as Y } from "./hinkalSolanaDepositAndWithdraw.mjs";
+import { hinkalSolanaWithdraw as ae } from "./hinkalSolanaWithdraw.mjs";
+import { hinkalSolanaTransfer as oe } from "./hinkalSolanaTransfer.mjs";
+import { hinkalSolanaSwap as se } from "./hinkalSolanaSwap.mjs";
+import { hinkalSolanaProxySend as ce } from "./hinkalSolanaProxySend.mjs";
+import { hinkalSolanaProxySwap as le } from "./hinkalSolanaProxySwap.mjs";
+import { hinkalSolanaProxyShield as X } from "./hinkalSolanaProxyShield.mjs";
+import { hinkalDepositAndBridge as ue } from "./hinkalDepositAndBridge.mjs";
+import { hinkalClaimUtxo as de } from "./hinkalClaimUtxo.mjs";
+import { hinkalSolanaProoflessDeposit as Z } from "./hinkalSolanaProoflessDeposit.mjs";
+import { hinkalSolanaClaimUtxo as fe } from "./hinkalSolanaClaimUtxo.mjs";
+import { hinkalWithdrawStuckUtxos as pe } from "./hinkalWithdrawStuckUtxos.mjs";
+import { ethers as Q } from "ethers";
+import { PublicKey as $ } from "@solana/web3.js";
+//#region libs/shared/common/src/data-structures/Hinkal/Hinkal.ts
+var me = class {
+	ethereumProviderAdapter;
+	solanaProviderAdapter;
+	tronProviderAdapter;
+	userKeys;
+	signingMessage = "Login to Hinkal Protocol";
+	privateTransferSigningMessage = "Login to Hinkal's Private Transfer App";
+	merkleTreeHinkalByChain = {};
+	merkleTreeAccessTokenByChain = {};
+	nullifiersByChain = {};
+	encryptedOutputsByChain = {};
+	commitmentsSnapshotServiceByChain = {};
+	nullifierSnapshotServiceByChain = {};
+	accessTokenSnapshotServiceByChain = {};
+	utxoUtils;
+	lastCallState = /* @__PURE__ */ new Map();
+	cacheDevice;
+	generateProofRemotely;
+	disableMerkleTreeUpdates;
+	constructor(e) {
+		this.userKeys = new _(void 0), n.forEach((e) => {
+			this.merkleTreeHinkalByChain[e] = D.create(f, 0n), this.merkleTreeAccessTokenByChain[e] = D.create(f, 0n), this.nullifiersByChain[e] = /* @__PURE__ */ new Set(), this.encryptedOutputsByChain[e] = [];
+		}), this.generateProofRemotely = e?.generateProofRemotely ?? !0, this.utxoUtils = new z(), this.cacheDevice = S(e), this.disableMerkleTreeUpdates = e?.disableMerkleTreeUpdates ?? !1;
+	}
+	enforceRateLimit(t, n, r = 1e3) {
+		let i = Date.now(), a = e(n), o = this.lastCallState.get(t);
+		if (o && o.argsKey === a && i - o.timestamp < r) throw Error(`${t} was already called with the same arguments`);
+		this.lastCallState.set(t, {
+			timestamp: i,
+			argsKey: a
+		});
+	}
+	getProviderAdapter(e) {
+		let t = e;
+		t ||= this.ethereumProviderAdapter ? i.ethMainnet : this.solanaProviderAdapter ? i.solanaMainnet : i.tronMainnet;
+		let n;
+		if (n = o(t) ? this.solanaProviderAdapter : s(t) ? this.tronProviderAdapter : this.ethereumProviderAdapter, !n) throw Error("ProviderAdapter is not initialized");
+		return n;
+	}
+	async initProviderAdapter(e, t) {
+		let n = i.ethMainnet;
+		t instanceof w ? n = i.solanaMainnet : t instanceof J && (n = a), await this.updateProviderAdapter(n, t), t.initConnector(e);
+		let r = await t.connectAndPatchProvider(e);
+		await t.init(r), await this.setListeners();
+	}
+	getSigningMessage(e = u.PROTOCOL) {
+		switch (e) {
+			case u.PRIVATE_TRANSFER: return this.privateTransferSigningMessage;
+			case u.PROTOCOL:
+			default: return this.signingMessage;
+		}
+	}
+	async initUserKeys(e = u.PROTOCOL) {
+		let t = this.getSigningMessage(e);
+		this.userKeys = new _(await this.getProviderAdapter().signMessage(t));
+	}
+	initUserKeysWithSignature(e) {
+		this.userKeys = new _(e);
+	}
+	async initUserKeysFromSeedPhrases(e) {
+		let t = e.join(" "), n = Q.toUtf8Bytes(t), r = Q.keccak256(n);
+		this.userKeys = new _(r);
+	}
+	async resetMerkle(e) {
+		this.disableMerkleTreeUpdates || (e?.every((e) => this.isSelectedNetworkSupported(e)) ?? !0) && await R(this, e);
+	}
+	getTronWeb() {
+		let e = this.tronProviderAdapter;
+		if (!e) throw Error("Tron provider adapter not initialized");
+		if (!(e instanceof J)) 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 ? r : this.ethereumProviderAdapter ? n.filter((e) => !o(e) && !s(e)) : this.solanaProviderAdapter ? n.filter((e) => o(e)) : this.tronProviderAdapter ? n.filter((e) => s(e)) : [];
+	}
+	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 C(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 V(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 !!c[e];
+	}
+	async switchNetwork(e) {
+		try {
+			await this.getProviderAdapter().switchNetwork(e);
+		} catch {
+			throw Error(h.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 {
+			o(e) ? (this.solanaProviderAdapter && this.solanaProviderAdapter.release(), this.solanaProviderAdapter = t) : s(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 = l.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(), x());
+	}
+	async monitorConnectedAddress(e) {
+		await v.monitor(await this.getEthereumAddressByChain(e));
+	}
+	async getBalances(e, t, n, r, i = !1, a, o = !1) {
+		return re(this, e, t, n, r, i, this.generateProofRemotely, a, o);
+	}
+	async getTotalBalance(e, n, r, i = !1, a, o = !1) {
+		let s = r ?? await this.getEthereumAddressByChain(e), c = n ?? this.userKeys, l = await this.getBalances(e, c.getShieldedPrivateKey(), c.getShieldedPublicKey(), s, i, a, o), u = t ? await ne.getPrivateTokens(e, s) : g(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, r = !1, i = !1) {
+		return (await this.getTotalBalance(e, t, n, r, i, !0)).filter((e) => e.balance > 0n);
+	}
+	getSupportedPassportLinks() {
+		return b;
+	}
+	checkAccessToken(e, t) {
+		return te(this, e, t);
+	}
+	checkExternalTokenLimitsUSD(e, t, n) {
+		return M(e, t, n);
+	}
+	async getHinkalTreeRootHash(e) {
+		if (o(e)) {
+			let { hinkalIdl: t, hinkalAddress: n, originalDeployer: r } = c[e].contractData;
+			if (!t || !n || !r) throw Error(`Missing Solana configuration for chain ${e}`);
+			let i = new $(r), a = m(new $(n), i);
+			return O(this.getSolanaProgram(t), a);
+		}
+		return this.getContractWithFetcherByChainId(e, d.HinkalContract).getRootHash();
+	}
+	async getAccessTokenTreeRootHash(e) {
+		if (o(e)) {
+			let { hinkalIdl: t, hinkalAddress: n, originalDeployer: r } = c[e].contractData;
+			if (!t || !n || !r) throw Error(`Missing Solana configuration for chain ${e}`);
+			let i = new $(r), a = p(new $(n), i);
+			return O(this.getSolanaProgram(t), a);
+		}
+		return this.getContractWithFetcherByChainId(e, d.AccessTokenContract).getRootHash();
+	}
+	async resetMerkleTreesIfNecessary(e) {
+		let t = (await Promise.all((e ?? this.getSupportedChains()).map(async (e) => {
+			let [t, n] = await Promise.all([this.getHinkalTreeRootHash(e), this.getAccessTokenTreeRootHash(e)]);
+			return {
+				chainId: e,
+				needsReset: BigInt(t) !== this.merkleTreeHinkalByChain[e].getRootHash() || BigInt(n) !== this.merkleTreeAccessTokenByChain[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 v.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 v;
+	}
+	snapshotsClearInterval() {
+		this.getSupportedChains().forEach((e) => {
+			this.commitmentsSnapshotServiceByChain[e]?.intervalClear(), this.accessTokenSnapshotServiceByChain[e]?.intervalClear(), this.nullifierSnapshotServiceByChain[e]?.intervalClear();
+		});
+	}
+	checkTokenRegistry(e, t, n) {
+		if (o(e)) {
+			let { hinkalIdl: r, hinkalAddress: i, originalDeployer: a } = c[e].contractData;
+			if (!r || !i || !a) throw Error("missing solana data");
+			return ee(this.getSolanaProgram(r), new $(a), t, n);
+		}
+		return s(e) ? E(t, n, e) : T(this.getContractWithFetcher(e, d.HinkalHelperContract), t, n);
+	}
+	getRecipientInfo() {
+		return B(this);
+	}
+	async deposit(e, t, n = !0, r = !1) {
+		return k(this, e, t, n, r);
+	}
+	async depositSolana(e, t) {
+		return P(this, e, t);
+	}
+	async depositForOther(e, t, n, r = !0, i = !1) {
+		return this.enforceRateLimit(this.depositForOther.name, [
+			e,
+			t,
+			n
+		]), A(this, e, t, n, r, i);
+	}
+	async depositSolanaForOther(e, t, n) {
+		return this.enforceRateLimit(this.depositSolanaForOther.name, [
+			e,
+			t,
+			n
+		]), F(this, e, t, n);
+	}
+	async depositAndWithdraw(e, t, n, r, i, a, s, c, l = !0) {
+		return o(y([e])) ? Y(this, e, t, n, r, i, a, s, c) : N(this, e, t, n, r, i, a, s, c, l);
+	}
+	async claimUtxo(e, t, n, r) {
+		return o(y([e])) ? fe(this, e, t, n, r) : de(this, e, t, n, r);
+	}
+	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) {
+		return o(y(e)) ? Z(this, e, t, n, r) : U(this, e, t, n, r);
+	}
+	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 o(y(e)) ? oe(this, e, t, n, r, i, a) : K(this, e, t, n, r, i, a);
+	}
+	async withdraw(e, t, n, r, i, a, s) {
+		return o(y(e)) ? ae(this, e, t, n, i, a, s) : L(this, e, t, n, r, i, a, s);
+	}
+	async withdrawStuckUtxos(e, t) {
+		return pe(this, e, t);
+	}
+	async swap(e, t, n, r, i, a, s) {
+		return o(y(e)) ? this.swapSolana(e, t, r, i, a) : I(this, e, t, n, r, i, a, s);
+	}
+	async swapSolana(e, t, n, r, i) {
+		let a = JSON.parse(n), o = BigInt(a.swapperAccountSalt), { instructionLists: s, addressLookupTableAccount: c } = a.data;
+		return se(this, e, t, o, s, c, r, i);
+	}
+	async actionReceive(e, t, n, r, i, a) {
+		if (!i) throw Error("subAccount is required");
+		return o(y(e)) ? X(this, e[0], t[0], i, void 0, a) : H(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
+		]), ie(this, e, t, n, r, i, a, o, s, c, l, u, d, f, p);
+	}
+	async proxySwap(e, t, n, r, i, a, s, c, l = !1, u, d) {
+		return o(y(e)) ? le(this, e, t, r, a, n, s, c, d) : W(this, e, t, n, r, i, a, s, c, l, u, d);
+	}
+	async proxyToPrivate(e, t, n, r, i, a, s) {
+		return o(y(e)) ? (this.enforceRateLimit(this.proxyToPrivate.name, [
+			e[0],
+			t[0],
+			n,
+			r
+		]), X(this, e[0], t[0], n, r, s)) : q(this, e, t, r, i, a, n, s);
+	}
+	async proxySend(e, t, n, r, i, a, s) {
+		let c = y(e);
+		if (o(c)) return ce(this, e[0], t[0], n, r, s);
+		let l = j(this, c, e.map((e) => e.erc20TokenAddress), t, r), u = e.map((e, n) => ({
+			token: e,
+			amount: -1n * t[n]
+		}));
+		return await this.actionPrivateWallet(c, [], [], [], l, u, n, i, a, void 0, void 0, void 0, s, void 0);
+	}
+	async multiSendPrivateRecipients(e, t, n) {
+		return this.enforceRateLimit(this.multiSendPrivateRecipients.name, [
+			e,
+			t,
+			n
+		]), G(this, e, t, n);
+	}
+	areMerkleTreeUpdatesDisabled() {
+		return this.disableMerkleTreeUpdates;
+	}
+	updateMerkleTreeUpdates(e) {
+		this.disableMerkleTreeUpdates = e;
+	}
+};
+//#endregion
+export { me as Hinkal };

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

@@ -0,0 +1,99 @@
+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 { UserKeys } from '../crypto-keys/keys';
+import { IProviderAdapter } from '../provider-adapter/IProviderAdapter';
+import { ClientAccessTokenSnapshotService, ClientCommitmentsSnapshotService, ClientNullifierSnapshotService, ClientSolanaAccessTokenSnapshotService, 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';
+import { TronWeb } from 'tronweb';
+export interface IHinkal<ConnectorType = unknown> {
+    userKeys: UserKeys;
+    readonly signingMessage: string;
+    readonly privateTransferSigningMessage: string;
+    merkleTreeHinkalByChain: Record<number, MerkleTree<bigint>>;
+    merkleTreeAccessTokenByChain: 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>;
+    accessTokenSnapshotServiceByChain: Record<number, ClientAccessTokenSnapshotService | ClientSolanaAccessTokenSnapshotService | 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, resetCacheBefore?: boolean, updateTokensListBefore?: boolean): 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>;
+    getAccessTokenTreeRootHash(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;
+    checkTokenRegistry(chainId: number, erc20Addresses: string[], amountChanges: bigint[]): Promise<boolean>;
+    getRecipientInfo(): string;
+    deposit(erc20Tokens: ERC20Token[], amountChanges: bigint[], preEstimateGas?: boolean, returnTxData?: boolean): Promise<ethers.TransactionResponse | ethers.TransactionRequest>;
+    depositForOther(erc20Tokens: ERC20Token[], amountChanges: bigint[], recepinetInfo: string, preEstimateGas?: boolean, returnTxData?: boolean): Promise<ethers.TransactionResponse | ethers.TransactionRequest>;
+    claimUtxo(erc20Token: ERC20Token, utxo: Utxo, feeStructureOverride?: FeeStructure, action?: AdminTransactionType): 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): Promise<string>;
+    getSolanaProgram(idl: Idl): Program;
+    getSolanaPublicKey(): PublicKey;
+    depositSolana(amount: bigint, token: ERC20Token): Promise<string>;
+    depositSolanaForOther(amount: bigint, token: ERC20Token, recipientInfo: string): 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;
+    initUserKeys(mode?: LoginMessageMode): Promise<void>;
+    initUserKeysWithSignature(signature: string): void;
+    initUserKeysFromSeedPhrases(seedPhrases: string[]): Promise<void>;
+    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/common/src/data-structures/Hinkal/handleAutoDepositBack.cjs

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

package/common/src/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/common/src/data-structures/Hinkal/handleAutoDepositBack.mjs

@@ -0,0 +1,93 @@
+import { chainIds as e, networkRegistry as t } from "../../constants/chains.constants.mjs";
+import { ExternalActionId as n } from "../../types/external-action.types.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 { gasErrorCodes as c, transactionErrorCodes as l } from "../../error-handling/error-codes.constants.mjs";
+import { getAmountInToken as u } from "../../functions/web3/etherFunctions.mjs";
+import { getERC20Token as d, getERC20TokenBySymbol as f } from "../../functions/utils/erc20tokenFunctions.mjs";
+import { caseInsensitiveEqual as p } from "../../functions/utils/caseInsensitive.utils.mjs";
+import { waitLittle as m } from "../../functions/utils/time.utils.mjs";
+import { ErrorWithRelayerTransaction as h } from "../../error-handling/customErrors/ErrorWithTx.mjs";
+import { API as g } from "../../API/API.mjs";
+import { Logger as _ } from "../../error-handling/logger.mjs";
+import { getGasTokenSymbols as ee } from "../../functions/utils/fees.utils.mjs";
+import { createJsonRpcProvider as v } from "../../functions/utils/create-provider.mjs";
+import { getErrorMessageFromTransactionRequest as y } from "../../error-handling/get-error.message.mjs";
+import "../../error-handling/index.mjs";
+import { modifyVolatileTokenAmountChanges as b } from "../../functions/pre-transaction/getVolatileTransferAmount.mjs";
+import { getFeeStructure as x } from "../../functions/pre-transaction/getFeeStructure.mjs";
+import { convertEmporiumOpToCallInfo as S } from "../../functions/utils/convertEmporiumOpToCallInfo.mjs";
+import { postToOffscreen as C } from "../../functions/utils/postToOffscreen.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 = v(j);
+		await m(j === e.ethMainnet ? ne : te);
+		let h = await T(I, P, M, o);
+		if (!h.length) {
+			C(s.AutoShieldTxStatus, { message: l.AUTO_SHIELD_SKIPPED });
+			return;
+		}
+		let _ = ee(j).map((e) => f(e, j)).filter((e) => e !== void 0), { prices: y } = await g.getTokenPrices(j, _.map((e) => e.erc20TokenAddress)), z = new Map(y.map((e, t) => [_[t].erc20TokenAddress.toLowerCase(), e])), B = h.map(({ token: e }) => e), V = h.map(({ balance: e }) => e), H = B.map(({ erc20TokenAddress: e }) => e), U = w(A, j, H, await b(j, B, V, M)), W = await x(j, P, H, n.Emporium, U.map((e) => S(e, M, j))), { flatFee: G } = W ?? {}, K = d(W.feeToken, j);
+		if (!K) return;
+		let q = u(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) {
+			C(s.AutoShieldTxStatus, { message: c.GAS_PRICE_EXCEEDS_AUTOSHIELD_LIMIT });
+			return;
+		}
+		let Q = B.findIndex((e) => p(e.erc20TokenAddress, X));
+		Q !== -1 && (V[Q] -= Z?.flatFee ?? 0n);
+		let { hinkalAddress: re } = t[j].contractData, $ = {
+			activityType: a.AUTO_SHIELD,
+			chainId: j,
+			from: M,
+			to: re,
+			gasInDollar: J.toString(),
+			tokensReceive: B.map((e, t) => ({
+				amount: u(e, V[t]),
+				token: e
+			}))
+		};
+		R = await k.saveTxRequest($), C(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), C(s.AutoShieldTxStatus, {
+			status: r.Confirmed,
+			activityRequest: $
+		});
+	} catch (e) {
+		let t;
+		e instanceof h && (t = e.txHash);
+		let n = {
+			error: e,
+			id: 0,
+			success: !1,
+			...t ? { erroredTx: t } : {}
+		};
+		R && await k.updatePendingTransactions(n, R), C(s.AutoShieldTxStatus, {
+			status: r.Failed,
+			error: y(e, o.ReceiveFromShieldedAccount)
+		}), _.error("Error in auto deposit back:", e);
+	}
+};
+//#endregion
+export { A as handleAutoDepositBack };

package/common/src/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/common/src/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>;