@kapa123456789/sdk 0.0.41 → 0.0.42

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

@@ -0,0 +1,239 @@
+import { PrivateBalanceUpdateType as e } from "../../types/balances.types.mjs";
+import { getAmountInToken as t } from "../../functions/web3/etherFunctions.mjs";
+import { checkAddressNotUpdated as n } from "../../functions/utils/upToDateState.mjs";
+import { Logger as r } from "../../error-handling/logger.mjs";
+import { getTokenStateKey as i } from "../../functions/utils/string.utils.mjs";
+import { isSameERC20Token as a } from "../../functions/utils/token-check.utils.mjs";
+import { subscribeToBalanceChange as o } from "../../functions/web3/events/balanceChangedHandler.mjs";
+import { privateBalancesStorage as s } from "../IndexedDB/private-balances-db.mjs";
+import { pricesStorage as c } from "../IndexedDB/prices-db.mjs";
+//#region libs/shared/common/src/data-structures/Hinkal/HinkalPrivateBalanceController.ts
+var l = (e, t) => {
+	switch (t.type) {
+		case "SET_BALANCES": {
+			let n = e[t.chainId];
+			if (t.balances === void 0) {
+				let n = { ...e };
+				return delete n[t.chainId], Object.keys(n).length > 0 ? n : {};
+			}
+			if (n === void 0) return {
+				...e,
+				[t.chainId]: t.balances
+			};
+			let r = t.balances, i = r.filter((e) => !n.some((t) => a(e.token, t.token))), o = n.map((e) => ({
+				...e,
+				balance: r.find((t) => a(t.token, e.token))?.balance ?? 0n
+			})).filter((e) => e.balance > 0n);
+			return o = [...o, ...i], {
+				...e,
+				[t.chainId]: o
+			};
+		}
+		case "SET_USD_BALANCES": {
+			let n = e[t.chainId];
+			if (n === void 0 || t.balances === void 0) return e;
+			let r = t.balances, i = n.map((e) => ({
+				...e,
+				usdValue: r.find((t) => a(t.token, e.token))?.usdValue ?? 0
+			}));
+			return {
+				...e,
+				[t.chainId]: i
+			};
+		}
+		case "CLEAR_BALANCES": {
+			if (t.chainId === void 0) return {};
+			let n = { ...e };
+			return delete n[t.chainId], Object.keys(n).length > 0 ? n : {};
+		}
+		case "SET_LOADING": {
+			let n = e[t.chainId];
+			if (n === void 0) return e;
+			if (n.length === 0 && t.newValue) return {
+				...e,
+				[t.chainId]: void 0
+			};
+			let r = n.map((e) => ({
+				...e,
+				isBalanceLoading: t.newValue
+			}));
+			return {
+				...e,
+				[t.chainId]: r
+			};
+		}
+		case "SET_USD_LOADING": {
+			let n = e[t.chainId];
+			if (n === void 0) return e;
+			let r = n.map((e) => ({
+				...e,
+				isUsdValueLoading: t.newValue
+			}));
+			return {
+				...e,
+				[t.chainId]: r
+			};
+		}
+		default: return e;
+	}
+}, u = class {
+	privateBalancesState = {};
+	privateBalancesListeners = /* @__PURE__ */ new Set();
+	constructor(e) {
+		this.hinkal = e, o((e) => {
+			this.applyRefreshFromBalanceChangeEvent(e).catch((e) => {
+				r.error("Private balance refresh from balance change failed:", e);
+			});
+		});
+	}
+	getSnapshot() {
+		return this.privateBalancesState;
+	}
+	onPrivateBalancesWithUSDChange(e) {
+		return this.privateBalancesListeners.add(e), () => this.privateBalancesListeners.delete(e);
+	}
+	async applyRefreshFromBalanceChangeEvent(t) {
+		if (!t) {
+			await this.refreshInternal(e.FreshWithoutLoader);
+			return;
+		}
+		let { updateType: n, balanceChangeState: r, chainIdToUpdate: i, resetCacheBefore: a, updateTokensListBefore: o } = t;
+		await this.refreshInternal(n, r, a, o, i);
+	}
+	dispatch(e) {
+		this.privateBalancesState = l(this.privateBalancesState, e);
+		let t = this.privateBalancesState;
+		this.privateBalancesListeners.forEach((e) => e(t));
+	}
+	async getAddressAndChain(e) {
+		return {
+			ethAdd: e?.ethereumAddress ?? await this.hinkal.getEthereumAddress(),
+			userKeys: e?.userKeys ?? this.hinkal.userKeys
+		};
+	}
+	async hasCache(e, t) {
+		return await s.getBalancesByWallet(e, t) !== void 0;
+	}
+	async getBalancesWithUsdValues(e, n) {
+		try {
+			if (!n) return [];
+			let r = e.map((e) => e.token.erc20TokenAddress);
+			if (!r.length) return [];
+			let i = await c.getAndUpdatePrices(n, r), a = new Map(r.map((e, t) => [e, i[t]]));
+			return [...e.map((e) => {
+				try {
+					let n = e.token.erc20TokenAddress, r = a.get(n) ?? 0, i = e.balance, o = Number(t(e.token, i)) * r;
+					return {
+						...e,
+						usdValue: o
+					};
+				} catch {
+					return {
+						...e,
+						usdValue: 0
+					};
+				}
+			})];
+		} catch {
+			return r.log("Error fetching private token balances"), [];
+		}
+	}
+	handleCached = async (e, a) => {
+		try {
+			await n(this.hinkal, e), this.dispatch({
+				type: "SET_BALANCES",
+				chainId: a,
+				balances: void 0
+			});
+			let r = await s.getBalancesByWallet(e, a), o = await c.getPrices();
+			if (await n(this.hinkal, e), !r || (this.dispatch({
+				type: "SET_BALANCES",
+				chainId: a,
+				balances: r
+			}), !o)) return;
+			let l = r.map((e) => {
+				let n = i(e.token.erc20TokenAddress, a);
+				return {
+					...e,
+					usdValue: o[n] ? Number(t(e.token, e.balance)) * o[n] : 0
+				};
+			});
+			this.dispatch({
+				type: "SET_USD_BALANCES",
+				chainId: a,
+				balances: l
+			});
+		} catch (e) {
+			r.error("Error refreshing cached private balance:", e);
+		}
+	};
+	handleFresh = async (e, t, i, a, o, c) => {
+		let l = o;
+		try {
+			await n(this.hinkal, e);
+			let r = await this.hasCache(e, t);
+			await n(this.hinkal, e), l = o || !r, l && this.dispatch({
+				type: "SET_LOADING",
+				chainId: t,
+				newValue: !0
+			}), await n(this.hinkal, e), a && await this.hinkal.resetMerkle([t]);
+			let u = await this.hinkal.getTotalBalance(t, i, e, a, c);
+			await n(this.hinkal, e);
+			let d = u.filter((e) => e.balance > 0n);
+			this.dispatch({
+				type: "SET_BALANCES",
+				chainId: t,
+				balances: d
+			}), await s.setBalances(e, t, d), await n(this.hinkal, e), l && (this.dispatch({
+				type: "SET_USD_LOADING",
+				chainId: t,
+				newValue: !0
+			}), this.dispatch({
+				type: "SET_LOADING",
+				chainId: t,
+				newValue: !1
+			})), await n(this.hinkal, e);
+			let f = await this.getBalancesWithUsdValues(d, t);
+			await n(this.hinkal, e), f.length > 0 && this.dispatch({
+				type: "SET_USD_BALANCES",
+				chainId: t,
+				balances: f
+			});
+		} catch (e) {
+			r.error("Error refreshing private balance:", e);
+		} finally {
+			l && (this.dispatch({
+				type: "SET_LOADING",
+				chainId: t,
+				newValue: !1
+			}), this.dispatch({
+				type: "SET_USD_LOADING",
+				chainId: t,
+				newValue: !1
+			}));
+		}
+	};
+	getSupportedChainsToUpdate(e) {
+		let t = this.hinkal.getSupportedChains();
+		return e ? t.includes(e) ? [e] : [] : t;
+	}
+	async refreshInternal(t = e.FreshWithoutLoader, n, r = !1, i = !1, a) {
+		let { ethAdd: o, userKeys: s } = await this.getAddressAndChain(n);
+		!o || !s?.getShieldedPublicKey() || await Promise.all(this.getSupportedChainsToUpdate(a).map(async (n) => {
+			switch (t) {
+				case e.OnlyCache:
+					await this.handleCached(o, n);
+					break;
+				case e.Fresh:
+					await this.handleFresh(o, n, s, r, !0, i);
+					break;
+				case e.FreshWithoutLoader:
+					await this.handleFresh(o, n, s, r, !1, i);
+					break;
+				default: break;
+			}
+		}));
+	}
+};
+//#endregion
+export { u as HinkalPrivateBalanceController };

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

@@ -0,0 +1,102 @@
+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 { PrivateBalancesState } from '../../types/balances.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[]>;
+    privateBalancesWithUSD: PrivateBalancesState;
+    onPrivateBalancesWithUSDChange(callback: (state: PrivateBalancesState) => void): () => void;
+    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`),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`),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`),E=require(`../IndexedDB/activity-db.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,89 @@
+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 { 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 { 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 { activityStorage as k } from "../IndexedDB/activity-db.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>;

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

@@ -0,0 +1,21 @@
+import { ExternalActionId as e } from "../../types/external-action.types.mjs";
+import { validateAndGetChainId as t } from "../../functions/utils/token-check.utils.mjs";
+import { modifyVolatileTokenAmountChanges as n } from "../../functions/pre-transaction/getVolatileTransferAmount.mjs";
+import { AccountActions as r } from "../AccountActions/AccountActions.mjs";
+import { getFeeStructure as i } from "../../functions/pre-transaction/getFeeStructure.mjs";
+import { convertEmporiumOpToCallInfo as a } from "../../functions/utils/convertEmporiumOpToCallInfo.mjs";
+import { createTransaferEmporiumOpsBatch as o } from "../../functions/private-wallet/emporium.helpers.mjs";
+//#region libs/shared/common/src/data-structures/Hinkal/hinkalActionReceive.ts
+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(c), h = r.getAddressFromSubAccount(m, f);
+	if (!h) throw Error("Public account address is not available");
+	let g = c.map((e) => e.erc20TokenAddress), _ = await n(m, c, l, h), v = o(s, m, g, _), y = d ?? await i(m, u, g, e.Emporium, v.map((e) => a(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);
+};
+//#endregion
+export { s as hinkalActionReceive };

package/common/src/data-structures/Hinkal/hinkalCheckSolanaTokenRegistry.cjs

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../functions/utils/amounts.utils.cjs`),t=require(`../../functions/pre-transaction/solana.cjs`);let n=require(`@solana/web3.js`);var r=async(r,i,a,o)=>{for(let s=0;s<a.length;s+=1){let c=t.getTokenLimitStorageAccountPublicKey(r.programId,i,new n.PublicKey(a[s]));if(!await r.provider.connection.getAccountInfo(c,`confirmed`))continue;let l=BigInt((await r.account.tokenLimitStorageAccount.fetch(c,`confirmed`)).amountLimit.toString());if(l!==0n&&e.absBigInt(o[s])>l)return!0}return!1};exports.hinkalCheckSolanaTokenRegistry=r;

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

@@ -0,0 +1,3 @@
+import { Program } from '@coral-xyz/anchor';
+import { PublicKey } from '@solana/web3.js';
+export declare const hinkalCheckSolanaTokenRegistry: (hinkalProgram: Program, originalDeployer: PublicKey, mintAddresses: string[], amountChanges: bigint[]) => Promise<boolean>;

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

@@ -0,0 +1,15 @@
+import { absBigInt as e } from "../../functions/utils/amounts.utils.mjs";
+import { getTokenLimitStorageAccountPublicKey as t } from "../../functions/pre-transaction/solana.mjs";
+import { PublicKey as n } from "@solana/web3.js";
+//#region libs/shared/common/src/data-structures/Hinkal/hinkalCheckSolanaTokenRegistry.ts
+var r = async (r, i, a, o) => {
+	for (let s = 0; s < a.length; s += 1) {
+		let c = t(r.programId, i, new n(a[s]));
+		if (!await r.provider.connection.getAccountInfo(c, "confirmed")) continue;
+		let l = BigInt((await r.account.tokenLimitStorageAccount.fetch(c, "confirmed")).amountLimit.toString());
+		if (l !== 0n && e(o[s]) > l) return !0;
+	}
+	return !1;
+};
+//#endregion
+export { r as hinkalCheckSolanaTokenRegistry };

package/common/src/data-structures/Hinkal/hinkalCheckTokenRegistry.cjs

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../constants/chains.constants.cjs`),t=require(`../../functions/utils/tron.utils.cjs`),n=require(`../../functions/utils/create-provider.cjs`);let r=require(`ethers`);var i=async(e,t,n)=>await e.checkTokenRegistry(t,n),a=t=>{let i=e.networkRegistry[t].contractData,a=n.createJsonRpcProvider(t);if(!i.hinkalHelperAddress||!i.hinkalHelperABI)throw Error(`hinkal helpercontract data not found`);return new r.ethers.Contract(i.hinkalHelperAddress,i.hinkalHelperABI,a)},o=async(n,r,i)=>{let a=t.createTronWeb(i),{contractData:o}=e.networkRegistry[i],{hinkalHelperAddress:s,hinkalHelperABI:c}=o;if(!s||!c)throw Error(`hinkal helper contract data not found`);let l=a.contract(c,t.evmHexToTronBase58Address(s)),u=n.map(t.evmHexToTronBase58Address);return!!await l.checkTokenRegistry(u,r.map(String)).call()};exports.createHinkalHelperFromData=a,exports.hinkalCheckTokenRegistry=i,exports.hinkalCheckTronTokenRegistry=o;

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

@@ -0,0 +1,4 @@
+import { ethers } from 'ethers';
+export declare const hinkalCheckTokenRegistry: (hinkalHelper: ethers.Contract, erc20Addresses: string[], amountChanges: bigint[]) => Promise<boolean>;
+export declare const createHinkalHelperFromData: (chainId: number) => ethers.Contract;
+export declare const hinkalCheckTronTokenRegistry: (erc20Addresses: string[], amountChanges: bigint[], chainId: number) => Promise<boolean>;

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

@@ -0,0 +1,17 @@
+import { networkRegistry as e } from "../../constants/chains.constants.mjs";
+import { createTronWeb as t, evmHexToTronBase58Address as n } from "../../functions/utils/tron.utils.mjs";
+import { createJsonRpcProvider as r } from "../../functions/utils/create-provider.mjs";
+import { ethers as i } from "ethers";
+//#region libs/shared/common/src/data-structures/Hinkal/hinkalCheckTokenRegistry.ts
+var a = async (e, t, n) => await e.checkTokenRegistry(t, n), o = (t) => {
+	let n = e[t].contractData, a = r(t);
+	if (!n.hinkalHelperAddress || !n.hinkalHelperABI) throw Error("hinkal helpercontract data not found");
+	return new i.Contract(n.hinkalHelperAddress, n.hinkalHelperABI, a);
+}, s = async (r, i, a) => {
+	let o = t(a), { contractData: s } = e[a], { hinkalHelperAddress: c, hinkalHelperABI: l } = s;
+	if (!c || !l) throw Error("hinkal helper contract data not found");
+	let u = o.contract(l, n(c)), d = r.map(n);
+	return !!await u.checkTokenRegistry(d, i.map(String)).call();
+};
+//#endregion
+export { o as createHinkalHelperFromData, a as hinkalCheckTokenRegistry, s as hinkalCheckTronTokenRegistry };

package/common/src/data-structures/Hinkal/hinkalClaimUtxo.cjs

@@ -0,0 +1 @@
+const e=require(`../../constants/chains.constants.cjs`),t=require(`../../constants/protocol.constants.cjs`),n=require(`../../types/ethereum-network.types.cjs`),r=require(`../../types/external-action.types.cjs`),i=require(`../../types/admin.types.cjs`),a=require(`../../error-handling/error-codes.constants.cjs`),o=require(`../../functions/utils/caseInsensitive.utils.cjs`),s=require(`../crypto-keys/keys.cjs`),c=require(`../../functions/utils/time.utils.cjs`),l=require(`../utxo/Utxo.cjs`),u=require(`../../functions/utils/tron.utils.cjs`),d=require(`../../functions/utils/token-check.utils.cjs`),f=require(`../../functions/pre-transaction/outputUtxoProcessing.cjs`),p=require(`../../functions/pre-transaction/constructAdminData.cjs`),m=require(`../../functions/pre-transaction/getFeeStructure.cjs`),h=require(`../../functions/pre-transaction/shouldPatchAccessTokenMerkleTree.cjs`),g=require(`../../functions/pre-transaction/getSignatureDataForTransact.cjs`),_=require(`../../functions/pre-transaction/buildCommitmentValidationData.cjs`),v=require(`../../functions/snarkjs/constructGeneralZkProof.cjs`),y=require(`../../functions/web3/functionCalls/transactCallRelayer.cjs`);var b=async(b,x,S,C,w)=>{let T=d.validateAndGetChainId([x]),ee=e.isTronLike(T),E=x.erc20TokenAddress,D=u.addressToHexFormat(await b.getEthereumAddressByChain(T));if(!o.caseInsensitiveEqual(E,S.erc20TokenAddress))throw Error(`Off-chain UTXO token mismatch`);if(!S.shieldedPrivateKey)throw Error(`Claimable UTXO shieldedPrivateKey is missing`);let O=new s.UserKeys(void 0,S.shieldedPrivateKey),k=b.getRecipientInfo(),A=l.Utxo.createFrom(S,{shieldedPrivateKey:O.getShieldedPrivateKey()}),j=new l.Utxo({amount:0n,erc20TokenAddress:A.erc20TokenAddress,mintAddress:A.mintAddress,tokenId:A.tokenId,shieldedPrivateKey:O.getShieldedPrivateKey()}),M=[E],N=C??await m.getFeeStructure(T,E,[E],r.ExternalActionId.Transact);if(!o.caseInsensitiveEqual(N.feeToken,E))throw Error(`Claim fee token mismatch: fee must be paid from claimed UTXO token`);let P=N.variableRate>0n?N.variableRate:t.HINKAL_PRIVATE_SEND_VARIABLE_RATE;if(A.amount<=N.flatFee)throw Error(a.transactionErrorCodes.INSUFFICIENT_FUNDS_TO_TRANSACT);let F=A.amount-N.flatFee,I=F*P/10000n,L=F-I;if(L<=0n)throw Error(a.transactionErrorCodes.RECIPIENT_AMOUNT_INVALID);let R={feeToken:N.feeToken,flatFee:N.flatFee+I,variableRate:0n},z=[-A.amount],B=await b.getRandomRelay(T,!0);if(!B)throw Error(a.transactionErrorCodes.RELAYER_NOT_AVAILABLE);let V={externalActionId:0n,externalAddress:B??D,externalActionMetadata:`0x00`},H=[[A,j]],U=[],W=c.getCurrentTimeInSeconds().toString(),{outputUtxos:G}=f.outputUtxoProcessing(O,H[0],z[0],W,A.tokenId,!0,k,L);U.push(G);let{patchAccessTokenMerkleTree:K,kycRequired:q,hasAccessToken:J}=await h.shouldPatchAccessTokenMerkleTree(b,T,M,z,O.getAccessKey()),Y=await g.getSignatureDataForTransact(T,D,O,q,J),X=`swapperM${z.length}x${H[0].length}x2`,[{zkCallData:Z,circomData:Q,dimData:$},te]=await Promise.all([v.constructZkProof(b.merkleTreeHinkalByChain[T],b.merkleTreeAccessTokenByChain[T],H,U,O,X,V.externalActionId,V.externalAddress,V.externalActionMetadata,b.generateProofRemotely,B,T,void 0,void 0,void 0,K,void 0,R,b.getContractWithFetcher(T,n.ContractType.HinkalHelperContract),Y),_.buildCommitmentValidationData(T,O,M,H)]),ne=await u.reorderZkCallData(ee,Z,$,Q);return y.transactCallRelayer(T,Z,$,Q,te,void 0,void 0,p.constructAdminData(w??i.AdminTransactionType.ClaimUtxo,T,M,z,D),ne)};exports.hinkalClaimUtxo=b;

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

@@ -0,0 +1,6 @@
+import { ERC20Token } from '../../types/token.types';
+import { IHinkal } from './IHinkal';
+import { FeeStructure } from '../../types/hinkal.types';
+import { AdminTransactionType } from '../../types/admin.types';
+import { Utxo } from '../utxo/Utxo';
+export declare const hinkalClaimUtxo: (hinkal: IHinkal, erc20Token: ERC20Token, utxo: Utxo, feeStructureOverride?: FeeStructure, action?: AdminTransactionType) => Promise<string>;

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

@@ -0,0 +1,54 @@
+import { isTronLike as e } from "../../constants/chains.constants.mjs";
+import { HINKAL_PRIVATE_SEND_VARIABLE_RATE as t } from "../../constants/protocol.constants.mjs";
+import { ContractType as n } from "../../types/ethereum-network.types.mjs";
+import { ExternalActionId as r } from "../../types/external-action.types.mjs";
+import { AdminTransactionType as i } from "../../types/admin.types.mjs";
+import { transactionErrorCodes as a } from "../../error-handling/error-codes.constants.mjs";
+import { caseInsensitiveEqual as o } from "../../functions/utils/caseInsensitive.utils.mjs";
+import { UserKeys as s } from "../crypto-keys/keys.mjs";
+import { getCurrentTimeInSeconds as c } from "../../functions/utils/time.utils.mjs";
+import { Utxo as l } from "../utxo/Utxo.mjs";
+import { addressToHexFormat as u, reorderZkCallData as d } from "../../functions/utils/tron.utils.mjs";
+import { validateAndGetChainId as f } from "../../functions/utils/token-check.utils.mjs";
+import { outputUtxoProcessing as p } from "../../functions/pre-transaction/outputUtxoProcessing.mjs";
+import { constructAdminData as m } from "../../functions/pre-transaction/constructAdminData.mjs";
+import { getFeeStructure as h } from "../../functions/pre-transaction/getFeeStructure.mjs";
+import { shouldPatchAccessTokenMerkleTree as g } from "../../functions/pre-transaction/shouldPatchAccessTokenMerkleTree.mjs";
+import { getSignatureDataForTransact as _ } from "../../functions/pre-transaction/getSignatureDataForTransact.mjs";
+import { buildCommitmentValidationData as ee } from "../../functions/pre-transaction/buildCommitmentValidationData.mjs";
+import { constructZkProof as v } from "../../functions/snarkjs/constructGeneralZkProof.mjs";
+import { transactCallRelayer as y } from "../../functions/web3/functionCalls/transactCallRelayer.mjs";
+//#region libs/shared/common/src/data-structures/Hinkal/hinkalClaimUtxo.ts
+var b = async (b, x, S, C, te) => {
+	let w = f([x]), T = e(w), E = x.erc20TokenAddress, D = u(await b.getEthereumAddressByChain(w));
+	if (!o(E, S.erc20TokenAddress)) throw Error("Off-chain UTXO token mismatch");
+	if (!S.shieldedPrivateKey) throw Error("Claimable UTXO shieldedPrivateKey is missing");
+	let O = new s(void 0, S.shieldedPrivateKey), k = b.getRecipientInfo(), A = l.createFrom(S, { shieldedPrivateKey: O.getShieldedPrivateKey() }), j = new l({
+		amount: 0n,
+		erc20TokenAddress: A.erc20TokenAddress,
+		mintAddress: A.mintAddress,
+		tokenId: A.tokenId,
+		shieldedPrivateKey: O.getShieldedPrivateKey()
+	}), M = [E], N = C ?? await h(w, E, [E], r.Transact);
+	if (!o(N.feeToken, E)) throw Error("Claim fee token mismatch: fee must be paid from claimed UTXO token");
+	let P = N.variableRate > 0n ? N.variableRate : t;
+	if (A.amount <= N.flatFee) throw Error(a.INSUFFICIENT_FUNDS_TO_TRANSACT);
+	let F = A.amount - N.flatFee, I = F * P / 10000n, L = F - I;
+	if (L <= 0n) throw Error(a.RECIPIENT_AMOUNT_INVALID);
+	let R = {
+		feeToken: N.feeToken,
+		flatFee: N.flatFee + I,
+		variableRate: 0n
+	}, z = [-A.amount], B = await b.getRandomRelay(w, !0);
+	if (!B) throw Error(a.RELAYER_NOT_AVAILABLE);
+	let V = {
+		externalActionId: 0n,
+		externalAddress: B ?? D,
+		externalActionMetadata: "0x00"
+	}, H = [[A, j]], U = [], W = c().toString(), { outputUtxos: G } = p(O, H[0], z[0], W, A.tokenId, !0, k, L);
+	U.push(G);
+	let { patchAccessTokenMerkleTree: K, kycRequired: q, hasAccessToken: J } = await g(b, w, M, z, O.getAccessKey()), Y = await _(w, D, O, q, J), X = `swapperM${z.length}x${H[0].length}x2`, [{ zkCallData: Z, circomData: Q, dimData: $ }, ne] = await Promise.all([v(b.merkleTreeHinkalByChain[w], b.merkleTreeAccessTokenByChain[w], H, U, O, X, V.externalActionId, V.externalAddress, V.externalActionMetadata, b.generateProofRemotely, B, w, void 0, void 0, void 0, K, void 0, R, b.getContractWithFetcher(w, n.HinkalHelperContract), Y), ee(w, O, M, H)]), re = await d(T, Z, $, Q);
+	return y(w, Z, $, Q, ne, void 0, void 0, m(te ?? i.ClaimUtxo, w, M, z, D), re);
+};
+//#endregion
+export { b as hinkalClaimUtxo };

package/common/src/data-structures/Hinkal/hinkalDeposit.cjs

@@ -0,0 +1 @@
+const e=require(`../../constants/protocol.constants.cjs`),t=require(`../../types/ethereum-network.types.cjs`),n=require(`../../types/admin.types.cjs`),r=require(`../../error-handling/error-codes.constants.cjs`),i=require(`../../functions/utils/time.utils.cjs`),a=require(`../utxo/Utxo.cjs`),o=require(`../../functions/utils/addresses.cjs`),s=require(`../../functions/utils/token-check.utils.cjs`),c=require(`../../functions/web3/events/getShieldedBalance.cjs`),l=require(`../../functions/pre-transaction/outputUtxoProcessing.cjs`),u=require(`../../functions/pre-transaction/constructAdminData.cjs`),d=require(`../../functions/pre-transaction/getKycAndSignatureData.cjs`),f=require(`../../functions/snarkjs/constructGeneralZkProof.cjs`),p=require(`../../functions/web3/functionCalls/transactCallDirect.cjs`),m=require(`../../API/admin-calls.cjs`);var h=async(e,t,n,r)=>{let i=await e.getEthereumAddressByChain(t),{patchAccessTokenMerkleTree:a,signatureData:o}=await d.getKycAndSignatureData(e,t,n,r,i);return{signatureData:o,externalActionData:{externalActionId:0n,externalAddress:i,externalActionMetadata:`0x00`},contractTransaction:void 0,contractToApprove:void 0,patchAccessTokenMerkleTree:a}},g=async(e,t,n,r)=>{let a=[...await c.addPaddingToUtxos(e,t,n,r)],o=[],s=i.getCurrentTimeInSeconds().toString();for(let t=0;t<n.length;t+=1){let{outputUtxos:n}=l.outputUtxoProcessing(e.userKeys,a[t],r[t],s);o.push(n)}return{inputUtxosArray:a,outputUtxosArray:o}},_=async(r,i,a,o=!0,c=!1)=>{let l=s.validateAndGetChainId(i),d=i.map(e=>e.erc20TokenAddress),[{externalActionData:_,contractTransaction:v,contractToApprove:y,patchAccessTokenMerkleTree:b,signatureData:x},{inputUtxosArray:S,outputUtxosArray:C}]=await Promise.all([h(r,l,d,a),g(r,l,d,a)]),w=`swapperM${a.length.toString()}x${S[0].length}x1`,{zkCallData:T,circomData:E,dimData:D}=await f.constructZkProof(r.merkleTreeHinkalByChain[l],r.merkleTreeAccessTokenByChain[l],S,C,r.userKeys,w,_.externalActionId,_.externalAddress,_.externalActionMetadata,r.generateProofRemotely,e.zeroAddress,l,void 0,void 0,void 0,b,void 0,void 0,r.getContractWithFetcher(l,t.ContractType.HinkalHelperContract),x),O=await p.transactCallDirect(r,l,a,i,T,E,D,y,v,o,c);return m.emitTxPublicData(u.constructAdminData(n.AdminTransactionType.Onboarding,l,d,a,await r.getEthereumAddress())),O},v=async(i,c,l,d,g=!0,_=!1)=>{let v=s.validateAndGetChainId(c),y=c.map(e=>e.erc20TokenAddress),[b,x,S]=d.split(`,`);if(!o.isValidPrivateAddress(d))throw Error(r.transactionErrorCodes.RECIPIENT_FORMAT_INCORRECT);let C=y.map(e=>[new a.Utxo({amount:0n,erc20TokenAddress:e,shieldedPrivateKey:i.userKeys.getShieldedPrivateKey()}),new a.Utxo({amount:0n,erc20TokenAddress:e,shieldedPrivateKey:i.userKeys.getShieldedPrivateKey()})]),w=`swapperM${l.length.toString()}x${C[0].length}x1`,T=y.map((e,t)=>[new a.Utxo({amount:l[t],erc20TokenAddress:e,randomization:BigInt(b),stealthAddress:x,encryptionKey:S})]),{externalActionData:E,contractTransaction:D,contractToApprove:O,patchAccessTokenMerkleTree:k}=await h(i,v,y,l),{zkCallData:A,circomData:j,dimData:M}=await f.constructZkProof(i.merkleTreeHinkalByChain[v],i.merkleTreeAccessTokenByChain[v],C,T,i.userKeys,w,E.externalActionId,E.externalAddress,E.externalActionMetadata,i.generateProofRemotely,e.zeroAddress,v,void 0,void 0,void 0,k,void 0,void 0,i.getContractWithFetcher(v,t.ContractType.HinkalHelperContract)),N=await p.transactCallDirect(i,v,l,c,A,j,M,O,D,g,_);return m.emitTxPublicData(u.constructAdminData(n.AdminTransactionType.PaymentLink,v,y,l,await i.getEthereumAddress())),N};exports.hinkalDeposit=_,exports.hinkalDepositForOther=v;

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

@@ -0,0 +1,4 @@
+import { IHinkal } from './IHinkal';
+import { ERC20Token } from '../../types';
+export declare const hinkalDeposit: (hinkal: IHinkal, erc20Tokens: ERC20Token[], amountChanges: bigint[], preEstimateGas?: boolean, returnTxData?: boolean) => Promise<import('ethers').TransactionRequest | import('ethers').TransactionResponse>;
+export declare const hinkalDepositForOther: (hinkal: IHinkal, erc20Tokens: ERC20Token[], amountChanges: bigint[], recipinetInfo: string, preEstimateGas?: boolean, returnTxData?: boolean) => Promise<import('ethers').TransactionRequest | import('ethers').TransactionResponse>;