@gurge/sdk 0.2.32

package/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/data-structures/Hinkal/hinkalClaimUtxo.cjs

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

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

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

package/data-structures/Hinkal/hinkalClaimUtxo.mjs

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

package/data-structures/Hinkal/hinkalDeposit.cjs

@@ -0,0 +1 @@
+const e=require(`../../constants/chains.constants.cjs`),t=require(`../../constants/protocol.constants.cjs`),n=require(`../../types/hinkal.types.cjs`),r=require(`../../functions/utils/addresses.cjs`),i=require(`../../error-handling/error-codes.constants.cjs`),a=require(`../../API/admin-calls.cjs`),o=require(`../../functions/utils/time.utils.cjs`),s=require(`../utxo/Utxo.cjs`),c=require(`../../functions/utils/tron.utils.cjs`),l=require(`../../functions/utils/token-check.utils.cjs`),u=require(`../../functions/web3/events/getShieldedBalance.cjs`),d=require(`../../functions/pre-transaction/outputUtxoProcessing.cjs`),f=require(`../../functions/pre-transaction/constructAdminData.cjs`),p=require(`../../functions/utils/tronSimulation.utils.cjs`),m=require(`../../functions/snarkjs/constructGeneralZkProof.cjs`),h=require(`../../functions/web3/functionCalls/waitForErc20Approvals.cjs`),g=require(`../../functions/web3/functionCalls/transactCallDirect.cjs`);var _=async(e,t)=>({externalActionData:{externalActionId:0n,externalAddress:c.addressToHexFormat(await e.getEthereumAddressByChain(t)),externalActionMetadata:`0x00`},contractTransaction:void 0,contractToApprove:void 0}),v=async(e,t,n,r)=>{let i=[...await u.addPaddingToUtxos(e,t,n,r)],a=[],s=o.getCurrentTimeInSeconds().toString();for(let t=0;t<n.length;t+=1){let{outputUtxos:n}=d.outputUtxoProcessing(e.userKeys,i[t],r[t],s);a.push(n)}return{inputUtxosArray:i,outputUtxosArray:a}},y=async(n,r,i,a,o,s,l,u=!0,d=!1)=>{let f=n.getTronWeb(),{hinkalAddress:m,hinkalABI:g}=e.networkRegistry[r].contractData;if(!g)throw Error(`Hinkal ABI not found`);let _=c.evmHexToTronBase58Address(m),v=await n.getEthereumAddressByChain(r),{totalTrxValue:y,tokensNeedingApproval:b}=c.splitTronTokensByNative(i,a),{a:x,b:S,c:C}=c.parseZkCalldata(o),w=await c.reorderZkCallData(!0,o,l,s,!1);if(!w)throw Error(`Tron proof signature not found`);let T=[w.v,w.r,w.s],E=[l.tokenNumber,l.nullifierAmount,l.outputAmount],D=c.circomDataToArray(s),O=y>0n?Number(y):0;if(d){let e=c.createTronCallData(g,`transact`,[T,x,S,C,E,D]),{transaction:n}=await f.transactionBuilder.triggerSmartContract(_,``,{feeLimit:t.TRON_DEFAULT_FEE_LIMIT_SUN,callValue:O,input:e},[],v);return n}await c.approveTronTokens(f,v,_,b),b.size>0&&await h.waitForTronErc20Approvals(f,v,_,Array.from(b.entries()).map(([e,t])=>({tokenAddress:e,requiredAmount:t}))),u&&(await p.simulateTronTransaction(r,_,`transact`,g,[T,x,S,C,E,D],v,y>0n?y:void 0),await c.assertTronSufficientBalance(f,r,_,v,c.createTronCallData(g,`transact`,[T,x,S,C,E,D]),y));let k=await f.contract(g,_).transact(T,x,S,C,E,D).send({feeLimit:t.TRON_DEFAULT_FEE_LIMIT_SUN,callValue:O}),A=typeof k==`string`?k:k?.txid??k?.transaction?.txID;if(!A)throw Error(`Tron deposit failed (missing txid)`);return A},b=async(r,i,a,o=!0,s=!1)=>{let c=l.validateAndGetChainId(i),u=e.isTronLike(c),d=i.map(e=>e.erc20TokenAddress),[{externalActionData:f,contractTransaction:p,contractToApprove:h},{inputUtxosArray:b,outputUtxosArray:x}]=await Promise.all([_(r,c),v(r,c,d,a)]),{zkCallData:S,circomData:C,dimData:w}=await m.constructZkProof(r.merkleTreeHinkalByChain[c],b,x,r.userKeys,f.externalActionId,f.externalAddress,f.externalActionMetadata,r.generateProofRemotely,n.zeroFeeStructure,t.zeroAddress,c);return u?await y(r,c,i,a,S,C,w,o,s):await g.transactCallDirect(r,c,a,i,S,C,w,h,p,o,s)},x=async(o,c,u,d,p=!0,h=!1,v)=>{let b=l.validateAndGetChainId(c),x=e.isTronLike(b),S=c.map(e=>e.erc20TokenAddress),[C,w,T,,E]=d.split(`,`);if(!r.isValidPrivateAddress(d))throw Error(i.transactionErrorCodes.RECIPIENT_FORMAT_INCORRECT);let D=S.map(e=>[new s.Utxo({amount:0n,erc20TokenAddress:e,nullifyingKey:o.userKeys.getShieldedPrivateKey(),spendingPublicKey:o.userKeys.getSpendingKeyPair().pubSpendingBJJPoint,isNewStyle:!0}),new s.Utxo({amount:0n,erc20TokenAddress:e,nullifyingKey:o.userKeys.getShieldedPrivateKey(),spendingPublicKey:o.userKeys.getSpendingKeyPair().pubSpendingBJJPoint,isNewStyle:!0})]),O=S.map((e,t)=>[new s.Utxo({amount:u[t],erc20TokenAddress:e,H0:[BigInt(w),BigInt(T)],stealthAddress:C,encryptionKey:E,isNewStyle:!0})]),{externalActionData:k,contractTransaction:A,contractToApprove:j}=await _(o,b),{zkCallData:M,circomData:N,dimData:P}=await m.constructZkProof(o.merkleTreeHinkalByChain[b],D,O,o.userKeys,k.externalActionId,k.externalAddress,k.externalActionMetadata,o.generateProofRemotely,n.zeroFeeStructure,t.zeroAddress,b);if(x)return await y(o,b,c,u,M,N,P,p,h);let F=await g.transactCallDirect(o,b,u,c,M,N,P,j,A,p,h);return a.emitTxPublicData(f.constructAdminData(v,b,S,u,await o.getEthereumAddress())),F};exports.hinkalDeposit=b,exports.hinkalDepositForOther=x;

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

@@ -0,0 +1,6 @@
+import { ethers } from 'ethers';
+import { Types as TronWebTypes } from 'tronweb';
+import { IHinkal } from './IHinkal';
+import { AdminTransactionType, ERC20Token } from '../../types';
+export declare const hinkalDeposit: (hinkal: IHinkal, erc20Tokens: ERC20Token[], amountChanges: bigint[], preEstimateGas?: boolean, returnTxData?: boolean) => Promise<ethers.TransactionResponse | ethers.TransactionRequest | string | TronWebTypes.Transaction<TronWebTypes.TriggerSmartContract>>;
+export declare const hinkalDepositForOther: (hinkal: IHinkal, erc20Tokens: ERC20Token[], amountChanges: bigint[], recipientInfo: string, preEstimateGas?: boolean, returnTxData?: boolean, action?: AdminTransactionType) => Promise<ethers.TransactionResponse | ethers.TransactionRequest | string | TronWebTypes.Transaction<TronWebTypes.TriggerSmartContract>>;

package/data-structures/Hinkal/hinkalDeposit.mjs

@@ -0,0 +1,121 @@
+import { isTronLike as e, networkRegistry as t } from "../../constants/chains.constants.mjs";
+import { TRON_DEFAULT_FEE_LIMIT_SUN as n, zeroAddress as r } from "../../constants/protocol.constants.mjs";
+import { zeroFeeStructure as i } from "../../types/hinkal.types.mjs";
+import { isValidPrivateAddress as a } from "../../functions/utils/addresses.mjs";
+import { transactionErrorCodes as o } from "../../error-handling/error-codes.constants.mjs";
+import { emitTxPublicData as s } from "../../API/admin-calls.mjs";
+import { getCurrentTimeInSeconds as c } from "../../functions/utils/time.utils.mjs";
+import { Utxo as l } from "../utxo/Utxo.mjs";
+import { addressToHexFormat as u, approveTronTokens as d, assertTronSufficientBalance as f, circomDataToArray as p, createTronCallData as m, evmHexToTronBase58Address as h, parseZkCalldata as g, reorderZkCallData as _, splitTronTokensByNative as v } from "../../functions/utils/tron.utils.mjs";
+import { validateAndGetChainId as y } from "../../functions/utils/token-check.utils.mjs";
+import { addPaddingToUtxos as b } from "../../functions/web3/events/getShieldedBalance.mjs";
+import { outputUtxoProcessing as x } from "../../functions/pre-transaction/outputUtxoProcessing.mjs";
+import { constructAdminData as S } from "../../functions/pre-transaction/constructAdminData.mjs";
+import { simulateTronTransaction as C } from "../../functions/utils/tronSimulation.utils.mjs";
+import { constructZkProof as w } from "../../functions/snarkjs/constructGeneralZkProof.mjs";
+import { waitForTronErc20Approvals as T } from "../../functions/web3/functionCalls/waitForErc20Approvals.mjs";
+import { transactCallDirect as E } from "../../functions/web3/functionCalls/transactCallDirect.mjs";
+//#region libs/shared/common/src/data-structures/Hinkal/hinkalDeposit.ts
+var D = async (e, t) => ({
+	externalActionData: {
+		externalActionId: 0n,
+		externalAddress: u(await e.getEthereumAddressByChain(t)),
+		externalActionMetadata: "0x00"
+	},
+	contractTransaction: void 0,
+	contractToApprove: void 0
+}), O = async (e, t, n, r) => {
+	let i = [...await b(e, t, n, r)], a = [], o = c().toString();
+	for (let t = 0; t < n.length; t += 1) {
+		let { outputUtxos: n } = x(e.userKeys, i[t], r[t], o);
+		a.push(n);
+	}
+	return {
+		inputUtxosArray: i,
+		outputUtxosArray: a
+	};
+}, k = async (e, r, i, a, o, s, c, l = !0, u = !1) => {
+	let y = e.getTronWeb(), { hinkalAddress: b, hinkalABI: x } = t[r].contractData;
+	if (!x) throw Error("Hinkal ABI not found");
+	let S = h(b), w = await e.getEthereumAddressByChain(r), { totalTrxValue: E, tokensNeedingApproval: D } = v(i, a), { a: O, b: k, c: A } = g(o), j = await _(!0, o, c, s, !1);
+	if (!j) throw Error("Tron proof signature not found");
+	let M = [
+		j.v,
+		j.r,
+		j.s
+	], N = [
+		c.tokenNumber,
+		c.nullifierAmount,
+		c.outputAmount
+	], P = p(s), F = E > 0n ? Number(E) : 0;
+	if (u) {
+		let e = m(x, "transact", [
+			M,
+			O,
+			k,
+			A,
+			N,
+			P
+		]), { transaction: t } = await y.transactionBuilder.triggerSmartContract(S, "", {
+			feeLimit: n,
+			callValue: F,
+			input: e
+		}, [], w);
+		return t;
+	}
+	await d(y, w, S, D), D.size > 0 && await T(y, w, S, Array.from(D.entries()).map(([e, t]) => ({
+		tokenAddress: e,
+		requiredAmount: t
+	}))), l && (await C(r, S, "transact", x, [
+		M,
+		O,
+		k,
+		A,
+		N,
+		P
+	], w, E > 0n ? E : void 0), await f(y, r, S, w, m(x, "transact", [
+		M,
+		O,
+		k,
+		A,
+		N,
+		P
+	]), E));
+	let I = await y.contract(x, S).transact(M, O, k, A, N, P).send({
+		feeLimit: n,
+		callValue: F
+	}), L = typeof I == "string" ? I : I?.txid ?? I?.transaction?.txID;
+	if (!L) throw Error("Tron deposit failed (missing txid)");
+	return L;
+}, A = async (t, n, a, o = !0, s = !1) => {
+	let c = y(n), l = e(c), u = n.map((e) => e.erc20TokenAddress), [{ externalActionData: d, contractTransaction: f, contractToApprove: p }, { inputUtxosArray: m, outputUtxosArray: h }] = await Promise.all([D(t, c), O(t, c, u, a)]), { zkCallData: g, circomData: _, dimData: v } = await w(t.merkleTreeHinkalByChain[c], m, h, t.userKeys, d.externalActionId, d.externalAddress, d.externalActionMetadata, t.generateProofRemotely, i, r, c);
+	return l ? await k(t, c, n, a, g, _, v, o, s) : await E(t, c, a, n, g, _, v, p, f, o, s);
+}, j = async (t, n, c, u, d = !0, f = !1, p) => {
+	let m = y(n), h = e(m), g = n.map((e) => e.erc20TokenAddress), [_, v, b, , x] = u.split(",");
+	if (!a(u)) throw Error(o.RECIPIENT_FORMAT_INCORRECT);
+	let C = g.map((e) => [new l({
+		amount: 0n,
+		erc20TokenAddress: e,
+		nullifyingKey: t.userKeys.getShieldedPrivateKey(),
+		spendingPublicKey: t.userKeys.getSpendingKeyPair().pubSpendingBJJPoint,
+		isNewStyle: !0
+	}), new l({
+		amount: 0n,
+		erc20TokenAddress: e,
+		nullifyingKey: t.userKeys.getShieldedPrivateKey(),
+		spendingPublicKey: t.userKeys.getSpendingKeyPair().pubSpendingBJJPoint,
+		isNewStyle: !0
+	})]), T = g.map((e, t) => [new l({
+		amount: c[t],
+		erc20TokenAddress: e,
+		H0: [BigInt(v), BigInt(b)],
+		stealthAddress: _,
+		encryptionKey: x,
+		isNewStyle: !0
+	})]), { externalActionData: O, contractTransaction: A, contractToApprove: j } = await D(t, m), { zkCallData: M, circomData: N, dimData: P } = await w(t.merkleTreeHinkalByChain[m], C, T, t.userKeys, O.externalActionId, O.externalAddress, O.externalActionMetadata, t.generateProofRemotely, i, r, m);
+	if (h) return await k(t, m, n, c, M, N, P, d, f);
+	let F = await E(t, m, c, n, M, N, P, j, A, d, f);
+	return s(S(p, m, g, c, await t.getEthereumAddress())), F;
+};
+//#endregion
+export { A as hinkalDeposit, j as hinkalDepositForOther };

package/data-structures/Hinkal/hinkalDepositAndBridge.cjs

@@ -0,0 +1 @@
+const e=require(`../../types/external-action.types.cjs`),t=require(`../../constants/chains.constants.cjs`),n=require(`../../constants/protocol.constants.cjs`),r=require(`../../types/scheduled-transactions.types.cjs`);require(`../../types/index.cjs`);const i=require(`../../functions/utils/caseInsensitive.utils.cjs`),a=require(`../../functions/utils/addresses.cjs`),o=require(`../../API/API.cjs`),s=require(`../../constants/addresses.constants.cjs`),c=require(`../../error-handling/error-codes.constants.cjs`),l=require(`../../functions/utils/erc20tokenFunctions.cjs`),u=require(`../../functions/utils/time.utils.cjs`),d=require(`../utxo/Utxo.cjs`),f=require(`../../functions/utils/token-check.utils.cjs`),p=require(`../../functions/pre-transaction/constructAdminData.cjs`),m=require(`../../functions/pre-transaction/getFeeStructure.cjs`),h=require(`../../functions/pre-transaction/waitForDepositedUtxosInMerkleTree.cjs`),g=require(`../../functions/pre-transaction/buildCommitmentValidationData.cjs`);require(`../../functions/pre-transaction/index.cjs`);const _=require(`../../functions/utils/convertEmporiumOpToCallInfo.cjs`),v=require(`../../functions/utils/fees.utils.cjs`);require(`../../functions/utils/index.cjs`);const y=require(`../../functions/private-wallet/emporium.helpers.cjs`),b=require(`../../functions/snarkjs/constructGeneralZkProof.cjs`),x=require(`../../functions/web3/functionCalls/transactCallRelayer.cjs`),S=require(`../../API/deposit-and-withdraw-status-calls.cjs`),C=require(`./hinkalDepositOnChainUtxos.cjs`);require(`../../functions/index.cjs`);var w=async(a,l,f,m,h,_,C,w,T,E,D)=>{if(m.length===0)throw Error(`No recipients to bridge`);let O=f.erc20TokenAddress,{contractData:k}=t.networkRegistry[l],{emporiumAddress:A}=k;if(!A)throw Error(`No Emporium Address`);let j=s.SWAP_ROUTER_ADDRESSES[e.ExternalActionId.Lifi][l];if(!j)throw Error(`LIFI not configured for chain ${l}`);let M=await a.getRandomRelay(l);if(!M)throw Error(c.transactionErrorCodes.RELAYER_NOT_AVAILABLE);let N=await a.getEthereumAddressByChain(l),P=u.getCurrentTimeInSeconds().toString(),F=a.generateProofRemotely?5:1,I=[];for(let t=0;t<m.length;t+=F){let r=m.slice(t,t+F),s=await Promise.all(r.map(async({utxo:t,nativeUtxo:r,bridgeAmount:s,quote:c,temporarySubAccount:u,recipientAddress:m})=>{await o.API.addTemporaryWalletNonce(l,_,u.index);let x=c.nativeFee>0n&&!i.caseInsensitiveEqual(O,n.zeroAddress),S=[O],C=[-t.amount],w=[!1],T=new d.Utxo({amount:0n,erc20TokenAddress:O,nullifyingKey:a.userKeys.getShieldedPrivateKey(),timeStamp:P,...t.isNewStyle?{spendingPublicKey:a.userKeys.getSpendingKeyPair().pubSpendingBJJPoint,isNewStyle:!0}:{isNewStyle:!1}}),D=[[t,T]],k=[[T]];if(x&&r){let e=new d.Utxo({amount:0n,erc20TokenAddress:n.zeroAddress,nullifyingKey:a.userKeys.getShieldedPrivateKey(),timeStamp:P,...r.isNewStyle?{spendingPublicKey:a.userKeys.getSpendingKeyPair().pubSpendingBJJPoint,isNewStyle:!0}:{isNewStyle:!1}});S.push(n.zeroAddress),C.push(-r.amount),w.push(!1),D.push([r,e]),k.push([e])}let F=y.createLifiBridgeOps(a,l,u.ethAddress,j,O,t.amount,s,c),I=await v.calculateModifiedFeeStructure(l,f,s,h),L=p.constructAdminData(E,l,S,[-t.amount],N),[{zkCallData:R,circomData:z,dimData:B},V,H]=await Promise.all([b.constructZkProof(a.merkleTreeHinkalByChain[l],D,k,a.userKeys,e.ExternalActionId.Emporium,A,F,a.generateProofRemotely,I,M??n.zeroAddress,l,w,void 0,void 0,u.privateKey),y.getAuthorizationDataIfNeeded(l,u.privateKey),g.buildCommitmentValidationData(l,a.userKeys,S,D)]);return{zkCallData:R,dimData:B,circomData:z,commitmentValidationData:H,authorizationData:V,recipientAddress:m,adminData:L}}));I.push(...s)}await S.safeUpdateDepositAndWithdrawStatus({id:C,chainId:l,hashedEthereumAddress:_,phase:r.DepositAndWithdrawPhase.BEFORE_SCHEDULE_WITHDRAW});let L=await x.transactCallRelayerBatch(l,I,_,w,T,D);return await S.safeUpdateDepositAndWithdrawStatus({id:C,chainId:l,hashedEthereumAddress:_,phase:r.DepositAndWithdrawPhase.AFTER_SCHEDULE_WITHDRAW,scheduleId:L}),L},T=async(t,r,o,c,u,d,p,g,v=!0)=>{let b=r.erc20TokenAddress,x=f.validateAndGetChainId([r]),S=g?a.hashString(g):void 0,T=a.hashEthereumAddress(await t.getEthereumAddressByChain(x)),E=s.SWAP_ROUTER_ADDRESSES[e.ExternalActionId.Lifi][x];if(!E)throw Error(`LIFI router not configured`);let D;if(u)D=u;else{let r=o[0],i=y.createLifiBridgeOps(t,x,r.temporarySubAccount.ethAddress,E,b,r.bridgeAmount,r.bridgeAmount,r.quote).map(e=>_.convertEmporiumOpToCallInfo(e,r.temporarySubAccount.ethAddress,x));D=await m.getFeeStructure(x,b,[b],e.ExternalActionId.Emporium,i,n.PAY_SEND_VARIABLE_RATE)}let O={feeToken:D.feeToken,flatFee:0n,variableRate:0n},k=o.reduce((e,t)=>e+t.quote.nativeFee,0n)>0n&&!i.caseInsensitiveEqual(b,n.zeroAddress),A=o.map(e=>e.bridgeAmount),j=o.map(e=>e.recipientAddress),{userDepositedUtxos:M,statusId:N,depositTxHash:P}=await C.hinkalDepositOnChainUtxos(t,x,r,A,j,D,T,v),F=[];if(k){let e=l.getERC20Token(n.zeroAddress,x);if(!e)throw Error(`No native token`);let{userDepositedUtxos:r}=await C.hinkalDepositOnChainUtxos(t,x,e,o.map(e=>e.quote.nativeFee),j,O,T,v);F=r}return await h.waitForDepositedUtxosInMerkleTree(t,x,[...M,...F]),await w(t,x,r,o.map((e,t)=>({...e,utxo:M[t].utxo,nativeUtxo:k?F[t]?.utxo:void 0})),D,T,N,c,d,p,S),P};exports.hinkalDepositAndBridge=T;

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

@@ -0,0 +1,4 @@
+import { IHinkal } from './IHinkal';
+import { AdminTransactionType, BridgeRecipient, ERC20Token } from '../../types';
+import { FeeStructure } from '../../types/hinkal.types';
+export declare const hinkalDepositAndBridge: (hinkal: IHinkal, erc20Token: ERC20Token, recipients: BridgeRecipient[], txCompletionTime?: number, feeStructureOverride?: FeeStructure, ref?: string, action?: AdminTransactionType, dashboardAccountId?: string, preEstimateGas?: boolean) => Promise<string>;

package/data-structures/Hinkal/hinkalDepositAndBridge.mjs

@@ -0,0 +1,123 @@
+import { ExternalActionId as e } from "../../types/external-action.types.mjs";
+import { networkRegistry as t } from "../../constants/chains.constants.mjs";
+import { PAY_SEND_VARIABLE_RATE as n, zeroAddress as r } from "../../constants/protocol.constants.mjs";
+import { DepositAndWithdrawPhase as i } from "../../types/scheduled-transactions.types.mjs";
+import "../../types/index.mjs";
+import { caseInsensitiveEqual as a } from "../../functions/utils/caseInsensitive.utils.mjs";
+import { hashEthereumAddress as o, hashString as s } from "../../functions/utils/addresses.mjs";
+import { API as c } from "../../API/API.mjs";
+import { SWAP_ROUTER_ADDRESSES as l } from "../../constants/addresses.constants.mjs";
+import { transactionErrorCodes as u } from "../../error-handling/error-codes.constants.mjs";
+import { getERC20Token as d } from "../../functions/utils/erc20tokenFunctions.mjs";
+import { getCurrentTimeInSeconds as f } from "../../functions/utils/time.utils.mjs";
+import { Utxo as p } from "../utxo/Utxo.mjs";
+import { validateAndGetChainId as m } from "../../functions/utils/token-check.utils.mjs";
+import { constructAdminData as h } from "../../functions/pre-transaction/constructAdminData.mjs";
+import { getFeeStructure as g } from "../../functions/pre-transaction/getFeeStructure.mjs";
+import { waitForDepositedUtxosInMerkleTree as _ } from "../../functions/pre-transaction/waitForDepositedUtxosInMerkleTree.mjs";
+import { buildCommitmentValidationData as v } from "../../functions/pre-transaction/buildCommitmentValidationData.mjs";
+import "../../functions/pre-transaction/index.mjs";
+import { convertEmporiumOpToCallInfo as y } from "../../functions/utils/convertEmporiumOpToCallInfo.mjs";
+import { calculateModifiedFeeStructure as b } from "../../functions/utils/fees.utils.mjs";
+import "../../functions/utils/index.mjs";
+import { createLifiBridgeOps as x, getAuthorizationDataIfNeeded as S } from "../../functions/private-wallet/emporium.helpers.mjs";
+import { constructZkProof as C } from "../../functions/snarkjs/constructGeneralZkProof.mjs";
+import { transactCallRelayerBatch as w } from "../../functions/web3/functionCalls/transactCallRelayer.mjs";
+import { safeUpdateDepositAndWithdrawStatus as T } from "../../API/deposit-and-withdraw-status-calls.mjs";
+import { hinkalDepositOnChainUtxos as E } from "./hinkalDepositOnChainUtxos.mjs";
+import "../../functions/index.mjs";
+//#region libs/shared/common/src/data-structures/Hinkal/hinkalDepositAndBridge.ts
+var D = async (n, o, s, d, m, g, _, y, E, D, O) => {
+	if (d.length === 0) throw Error("No recipients to bridge");
+	let k = s.erc20TokenAddress, { contractData: A } = t[o], { emporiumAddress: j } = A;
+	if (!j) throw Error("No Emporium Address");
+	let M = l[e.Lifi][o];
+	if (!M) throw Error(`LIFI not configured for chain ${o}`);
+	let N = await n.getRandomRelay(o);
+	if (!N) throw Error(u.RELAYER_NOT_AVAILABLE);
+	let P = await n.getEthereumAddressByChain(o), F = f().toString(), I = n.generateProofRemotely ? 5 : 1, L = [];
+	for (let t = 0; t < d.length; t += I) {
+		let i = d.slice(t, t + I), l = await Promise.all(i.map(async ({ utxo: t, nativeUtxo: i, bridgeAmount: l, quote: u, temporarySubAccount: d, recipientAddress: f }) => {
+			await c.addTemporaryWalletNonce(o, g, d.index);
+			let _ = u.nativeFee > 0n && !a(k, r), y = [k], w = [-t.amount], T = [!1], E = new p({
+				amount: 0n,
+				erc20TokenAddress: k,
+				nullifyingKey: n.userKeys.getShieldedPrivateKey(),
+				timeStamp: F,
+				...t.isNewStyle ? {
+					spendingPublicKey: n.userKeys.getSpendingKeyPair().pubSpendingBJJPoint,
+					isNewStyle: !0
+				} : { isNewStyle: !1 }
+			}), O = [[t, E]], A = [[E]];
+			if (_ && i) {
+				let e = new p({
+					amount: 0n,
+					erc20TokenAddress: r,
+					nullifyingKey: n.userKeys.getShieldedPrivateKey(),
+					timeStamp: F,
+					...i.isNewStyle ? {
+						spendingPublicKey: n.userKeys.getSpendingKeyPair().pubSpendingBJJPoint,
+						isNewStyle: !0
+					} : { isNewStyle: !1 }
+				});
+				y.push(r), w.push(-i.amount), T.push(!1), O.push([i, e]), A.push([e]);
+			}
+			let I = x(n, o, d.ethAddress, M, k, t.amount, l, u), L = await b(o, s, l, m), R = h(D, o, y, [-t.amount], P), [{ zkCallData: z, circomData: B, dimData: V }, H, U] = await Promise.all([
+				C(n.merkleTreeHinkalByChain[o], O, A, n.userKeys, e.Emporium, j, I, n.generateProofRemotely, L, N ?? r, o, T, void 0, void 0, d.privateKey),
+				S(o, d.privateKey),
+				v(o, n.userKeys, y, O)
+			]);
+			return {
+				zkCallData: z,
+				dimData: V,
+				circomData: B,
+				commitmentValidationData: U,
+				authorizationData: H,
+				recipientAddress: f,
+				adminData: R
+			};
+		}));
+		L.push(...l);
+	}
+	await T({
+		id: _,
+		chainId: o,
+		hashedEthereumAddress: g,
+		phase: i.BEFORE_SCHEDULE_WITHDRAW
+	});
+	let R = await w(o, L, g, y, E, O);
+	return await T({
+		id: _,
+		chainId: o,
+		hashedEthereumAddress: g,
+		phase: i.AFTER_SCHEDULE_WITHDRAW,
+		scheduleId: R
+	}), R;
+}, O = async (t, i, c, u, f, p, h, v, b = !0) => {
+	let S = i.erc20TokenAddress, C = m([i]), w = v ? s(v) : void 0, T = o(await t.getEthereumAddressByChain(C)), O = l[e.Lifi][C];
+	if (!O) throw Error("LIFI router not configured");
+	let k;
+	if (f) k = f;
+	else {
+		let r = c[0], i = x(t, C, r.temporarySubAccount.ethAddress, O, S, r.bridgeAmount, r.bridgeAmount, r.quote).map((e) => y(e, r.temporarySubAccount.ethAddress, C));
+		k = await g(C, S, [S], e.Emporium, i, n);
+	}
+	let A = {
+		feeToken: k.feeToken,
+		flatFee: 0n,
+		variableRate: 0n
+	}, j = c.reduce((e, t) => e + t.quote.nativeFee, 0n) > 0n && !a(S, r), M = c.map((e) => e.bridgeAmount), N = c.map((e) => e.recipientAddress), { userDepositedUtxos: P, statusId: F, depositTxHash: I } = await E(t, C, i, M, N, k, T, b), L = [];
+	if (j) {
+		let e = d(r, C);
+		if (!e) throw Error("No native token");
+		let { userDepositedUtxos: n } = await E(t, C, e, c.map((e) => e.quote.nativeFee), N, A, T, b);
+		L = n;
+	}
+	return await _(t, C, [...P, ...L]), await D(t, C, i, c.map((e, t) => ({
+		...e,
+		utxo: P[t].utxo,
+		nativeUtxo: j ? L[t]?.utxo : void 0
+	})), k, T, F, u, p, h, w), I;
+};
+//#endregion
+export { O as hinkalDepositAndBridge };

package/data-structures/Hinkal/hinkalDepositAndWithdraw.cjs

@@ -0,0 +1 @@
+const e=require(`../../types/external-action.types.cjs`),t=require(`../../constants/chains.constants.cjs`),n=require(`../../constants/protocol.constants.cjs`),r=require(`../../types/scheduled-transactions.types.cjs`);require(`../../types/index.cjs`);const i=require(`../../functions/utils/caseInsensitive.utils.cjs`),a=require(`../../functions/utils/addresses.cjs`),o=require(`../../error-handling/error-codes.constants.cjs`),s=require(`../../functions/utils/time.utils.cjs`),c=require(`../utxo/Utxo.cjs`),l=require(`../../functions/utils/tron.utils.cjs`),u=require(`../../functions/utils/token-check.utils.cjs`),d=require(`../../functions/pre-transaction/constructAdminData.cjs`),f=require(`../../functions/pre-transaction/getFeeStructure.cjs`),p=require(`../../functions/pre-transaction/waitForDepositedUtxosInMerkleTree.cjs`),m=require(`../../functions/pre-transaction/buildCommitmentValidationData.cjs`);require(`../../functions/pre-transaction/index.cjs`);const h=require(`../../functions/utils/fees.utils.cjs`),g=require(`../../functions/snarkjs/constructGeneralZkProof.cjs`),_=require(`../../functions/web3/functionCalls/transactCallRelayer.cjs`),v=require(`../../API/deposit-and-withdraw-status-calls.cjs`),y=require(`./hinkalDepositOnChainUtxos.cjs`);require(`../../functions/index.cjs`);var b=async(e,a,u,f,p,y,b,x,S,C,w,T)=>{let E=t.isTronLike(a);if(f.length===0)throw Error(`userDepositedUtxos must not be empty`);let D=u.erc20TokenAddress,[O,k]=await Promise.all([e.getRandomRelay(a),e.getEthereumAddressByChain(a)]);if(!O)throw Error(o.transactionErrorCodes.RELAYER_NOT_AVAILABLE);let A=s.getCurrentTimeInSeconds().toString(),j=e.generateProofRemotely&&!E?5:1,M=[],N=l.addressToHexFormat(k);for(let t=0;t<f.length;t+=j){let r=f.slice(t,t+j),o=await Promise.all(r.map(async({recipientAddress:r,utxo:o},s)=>{let f=t+s,_=l.addressToHexFormat(r),v=new c.Utxo({amount:0n,erc20TokenAddress:D,nullifyingKey:e.userKeys.getShieldedPrivateKey(),timeStamp:A,...o.isNewStyle?{spendingPublicKey:e.userKeys.getSpendingKeyPair().pubSpendingBJJPoint,isNewStyle:!0}:{isNewStyle:!1}}),b=[[i.caseInsensitiveEqual(o.erc20TokenAddress,D)?o:c.Utxo.createFrom(o,{erc20TokenAddress:D}),v]],x=[[v]],S={externalActionId:0n,externalAddress:_,externalActionMetadata:`0x00`},C=d.constructAdminData(w,a,[D],[-o.amount],N),T=await h.calculateModifiedFeeStructure(a,u,p[f],y),[{zkCallData:k,circomData:j,dimData:M},P]=await Promise.all([g.constructZkProof(e.merkleTreeHinkalByChain[a],b,x,e.userKeys,S.externalActionId,S.externalAddress,S.externalActionMetadata,e.generateProofRemotely,T,O??n.zeroAddress,a),m.buildCommitmentValidationData(a,e.userKeys,[D],b)]);return{zkCallData:k,dimData:M,circomData:j,commitmentValidationData:P,adminData:C,recipientAddress:r,tronProofSignature:await l.reorderZkCallData(E,k,M,j)}}));M.push(...o)}await v.safeUpdateDepositAndWithdrawStatus({id:x,chainId:a,hashedEthereumAddress:b,phase:r.DepositAndWithdrawPhase.BEFORE_SCHEDULE_WITHDRAW});let P=await _.transactCallRelayerBatch(a,M,b,S,C,T);return await v.safeUpdateDepositAndWithdrawStatus({id:x,chainId:a,hashedEthereumAddress:b,phase:r.DepositAndWithdrawPhase.AFTER_SCHEDULE_WITHDRAW,scheduleId:P}),P},x=async(t,n,r,i,o,s,c,d,m,h=!0)=>{let g=u.validateAndGetChainId([n]),_=m?a.hashString(m):void 0,v=n.erc20TokenAddress,x=a.hashEthereumAddress(l.addressToHexFormat(await t.getEthereumAddressByChain(g))),S=s??await f.getFeeStructure(g,v,[v],e.ExternalActionId.Transact,[],10n),{userDepositedUtxos:C,statusId:w,depositTxHash:T}=await y.hinkalDepositOnChainUtxos(t,g,n,r,i,S,x,h);return await p.waitForDepositedUtxosInMerkleTree(t,g,C),await b(t,g,n,C,r,S,x,w,o,c,d,_),T};exports.hinkalDepositAndWithdraw=x,exports.hinkalWithdrawBatch=b;

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

@@ -0,0 +1,6 @@
+import { IHinkal } from './IHinkal';
+import { AdminTransactionType, ERC20Token, RecipientUtxo } from '../../types';
+import { FeeStructure } from '../../types/hinkal.types';
+export declare const hinkalWithdrawBatch: (hinkal: IHinkal, chainId: number, erc20Token: ERC20Token, userDepositedUtxos: RecipientUtxo[], recipientAmounts: bigint[], feeStructure: FeeStructure, hashedEthereumAddress: string, statusId: string | undefined, txCompletionTime?: number, ref?: string, action?: AdminTransactionType, hashedDashboardAccountId?: string) => Promise<string>;
+export declare const hinkalDepositAndWithdraw: (hinkal: IHinkal, erc20Token: ERC20Token, recipientAmounts: bigint[], recipientAddresses: string[], txCompletionTime?: number, feeStructureOverride?: FeeStructure, // Should be passed fee for only one withdraw transaction, multiplication happening in this function
+ref?: string, action?: AdminTransactionType, dashboardAccountId?: string, preEstimateGas?: boolean) => Promise<string>;

package/data-structures/Hinkal/hinkalDepositAndWithdraw.mjs

@@ -0,0 +1,78 @@
+import { ExternalActionId as e } from "../../types/external-action.types.mjs";
+import { isTronLike as t } from "../../constants/chains.constants.mjs";
+import { zeroAddress as n } from "../../constants/protocol.constants.mjs";
+import { DepositAndWithdrawPhase as r } from "../../types/scheduled-transactions.types.mjs";
+import "../../types/index.mjs";
+import { caseInsensitiveEqual as i } from "../../functions/utils/caseInsensitive.utils.mjs";
+import { hashEthereumAddress as a, hashString as o } from "../../functions/utils/addresses.mjs";
+import { transactionErrorCodes as s } from "../../error-handling/error-codes.constants.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 { constructAdminData as p } from "../../functions/pre-transaction/constructAdminData.mjs";
+import { getFeeStructure as m } from "../../functions/pre-transaction/getFeeStructure.mjs";
+import { waitForDepositedUtxosInMerkleTree as h } from "../../functions/pre-transaction/waitForDepositedUtxosInMerkleTree.mjs";
+import { buildCommitmentValidationData as g } from "../../functions/pre-transaction/buildCommitmentValidationData.mjs";
+import "../../functions/pre-transaction/index.mjs";
+import { calculateModifiedFeeStructure as _ } from "../../functions/utils/fees.utils.mjs";
+import { constructZkProof as v } from "../../functions/snarkjs/constructGeneralZkProof.mjs";
+import { transactCallRelayerBatch as y } from "../../functions/web3/functionCalls/transactCallRelayer.mjs";
+import { safeUpdateDepositAndWithdrawStatus as b } from "../../API/deposit-and-withdraw-status-calls.mjs";
+import { hinkalDepositOnChainUtxos as x } from "./hinkalDepositOnChainUtxos.mjs";
+import "../../functions/index.mjs";
+//#region libs/shared/common/src/data-structures/Hinkal/hinkalDepositAndWithdraw.ts
+var S = async (e, a, o, f, m, h, x, S, C, w, T, E) => {
+	let D = t(a);
+	if (f.length === 0) throw Error("userDepositedUtxos must not be empty");
+	let O = o.erc20TokenAddress, [k, A] = await Promise.all([e.getRandomRelay(a), e.getEthereumAddressByChain(a)]);
+	if (!k) throw Error(s.RELAYER_NOT_AVAILABLE);
+	let j = c().toString(), M = e.generateProofRemotely && !D ? 5 : 1, N = [], P = u(A);
+	for (let t = 0; t < f.length; t += M) {
+		let r = f.slice(t, t + M), s = await Promise.all(r.map(async ({ recipientAddress: r, utxo: s }, c) => {
+			let f = t + c, y = u(r), b = new l({
+				amount: 0n,
+				erc20TokenAddress: O,
+				nullifyingKey: e.userKeys.getShieldedPrivateKey(),
+				timeStamp: j,
+				...s.isNewStyle ? {
+					spendingPublicKey: e.userKeys.getSpendingKeyPair().pubSpendingBJJPoint,
+					isNewStyle: !0
+				} : { isNewStyle: !1 }
+			}), x = [[i(s.erc20TokenAddress, O) ? s : l.createFrom(s, { erc20TokenAddress: O }), b]], S = [[b]], C = {
+				externalActionId: 0n,
+				externalAddress: y,
+				externalActionMetadata: "0x00"
+			}, w = p(T, a, [O], [-s.amount], P), E = await _(a, o, m[f], h), [{ zkCallData: A, circomData: M, dimData: N }, F] = await Promise.all([v(e.merkleTreeHinkalByChain[a], x, S, e.userKeys, C.externalActionId, C.externalAddress, C.externalActionMetadata, e.generateProofRemotely, E, k ?? n, a), g(a, e.userKeys, [O], x)]);
+			return {
+				zkCallData: A,
+				dimData: N,
+				circomData: M,
+				commitmentValidationData: F,
+				adminData: w,
+				recipientAddress: r,
+				tronProofSignature: await d(D, A, N, M)
+			};
+		}));
+		N.push(...s);
+	}
+	await b({
+		id: S,
+		chainId: a,
+		hashedEthereumAddress: x,
+		phase: r.BEFORE_SCHEDULE_WITHDRAW
+	});
+	let F = await y(a, N, x, C, w, E);
+	return await b({
+		id: S,
+		chainId: a,
+		hashedEthereumAddress: x,
+		phase: r.AFTER_SCHEDULE_WITHDRAW,
+		scheduleId: F
+	}), F;
+}, C = async (t, n, r, i, s, c, l, d, p, g = !0) => {
+	let _ = f([n]), v = p ? o(p) : void 0, y = n.erc20TokenAddress, b = a(u(await t.getEthereumAddressByChain(_))), C = c ?? await m(_, y, [y], e.Transact, [], 10n), { userDepositedUtxos: w, statusId: T, depositTxHash: E } = await x(t, _, n, r, i, C, b, g);
+	return await h(t, _, w), await S(t, _, n, w, r, C, b, T, s, l, d, v), E;
+};
+//#endregion
+export { C as hinkalDepositAndWithdraw, S as hinkalWithdrawBatch };

package/data-structures/Hinkal/hinkalDepositOnChainUtxos.cjs

@@ -0,0 +1 @@
+const e=require(`../../types/ethereum-network.types.cjs`),t=require(`../../constants/chains.constants.cjs`),n=require(`../../types/scheduled-transactions.types.cjs`);require(`../../types/index.cjs`);const r=require(`../../functions/utils/tron.utils.cjs`),i=require(`../../functions/utils/getUtxosFromReceipt.utils.cjs`),a=require(`../../functions/utils/tx-confirmation.utils.cjs`),o=require(`../../functions/web3/functionCalls/transactCallDirect.cjs`),s=require(`../../functions/web3/functionCalls/transactCallDirectTron.cjs`),c=require(`../../API/deposit-and-withdraw-status-calls.cjs`),l=require(`./prepareDepositOnChainUtxosZkProof.cjs`);var u=async(u,d,f,p,m,h,g,_=!0)=>{let v=t.isTronLike(d),y=f.erc20TokenAddress,{zkCallData:b,circomData:x,dimData:S,totalAmount:C,utxoAmounts:w,hinkalWrapperAddress:T,hinkalWrapperABI:E,depositOnChainUtxosExternalActionAddress:D,depositOnChainUtxosExternalActionABI:O}=await l.prepareDepositOnChainUtxosZkProof(u,d,f,p,h),k=(await c.updateDepositAndWithdrawStatus({chainId:d,hashedEthereumAddress:g,phase:n.DepositAndWithdrawPhase.BEFORE_DEPOSIT})).id??void 0,A;if(v){let e=u.getTronWeb();A=await s.transactCallDirectTron(u,d,C,f,b,x,S,e.contract(O,r.evmHexToTronBase58Address(D)),e.contract(E,r.evmHexToTronBase58Address(T)),_)}else{let t=u.getContractWithSigner(d,e.ContractType.HinkalWrapper);A=(await o.transactCallDirect(u,d,C,f,b,x,S,u.getContractWithSigner(d,e.ContractType.DepositOnChainUtxos),t,_)).hash}if(!A)throw Error(`Deposit transaction hash not found`);let j=await a.waitForEthereumTransactionConfirmation(d,A);await c.safeUpdateDepositAndWithdrawStatus({id:k,chainId:d,hashedEthereumAddress:g,phase:n.DepositAndWithdrawPhase.AFTER_DEPOSIT,depositTxHash:A});let M=i.getOnChainUtxosFromReceipt(j,u,d,y);if(M.length===0)throw Error(`No UTXOs found in deposit transaction. Check contract address and ABI.`);let N=[],P=[...M];return m.forEach((e,t)=>{let n=w[t],r=P.find(e=>e.amount===n);if(!r)throw Error(`Could not find newly created UTXO with amount ${n} for recipient ${e}.`);N.push({recipientAddress:e,utxo:r});let i=P.indexOf(r);P.splice(i,1)}),{userDepositedUtxos:N,statusId:k,depositTxHash:A}};exports.hinkalDepositOnChainUtxos=u;

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

@@ -0,0 +1,8 @@
+import { IHinkal } from './IHinkal';
+import { ERC20Token, RecipientUtxo } from '../../types';
+import { FeeStructure } from '../../types/hinkal.types';
+export declare const hinkalDepositOnChainUtxos: (hinkal: IHinkal, chainId: number, erc20Token: ERC20Token, recipientAmounts: bigint[], recipientAddresses: string[], feeStructure: FeeStructure, hashedEthereumAddress: string, preEstimateGas?: boolean) => Promise<{
+    userDepositedUtxos: RecipientUtxo[];
+    statusId?: string;
+    depositTxHash: string;
+}>;

package/data-structures/Hinkal/hinkalDepositOnChainUtxos.mjs

@@ -0,0 +1,54 @@
+import { ContractType as e } from "../../types/ethereum-network.types.mjs";
+import { isTronLike as t } from "../../constants/chains.constants.mjs";
+import { DepositAndWithdrawPhase as n } from "../../types/scheduled-transactions.types.mjs";
+import "../../types/index.mjs";
+import { evmHexToTronBase58Address as r } from "../../functions/utils/tron.utils.mjs";
+import { getOnChainUtxosFromReceipt as i } from "../../functions/utils/getUtxosFromReceipt.utils.mjs";
+import { waitForEthereumTransactionConfirmation as a } from "../../functions/utils/tx-confirmation.utils.mjs";
+import { transactCallDirect as o } from "../../functions/web3/functionCalls/transactCallDirect.mjs";
+import { transactCallDirectTron as s } from "../../functions/web3/functionCalls/transactCallDirectTron.mjs";
+import { safeUpdateDepositAndWithdrawStatus as c, updateDepositAndWithdrawStatus as l } from "../../API/deposit-and-withdraw-status-calls.mjs";
+import { prepareDepositOnChainUtxosZkProof as u } from "./prepareDepositOnChainUtxosZkProof.mjs";
+//#region libs/shared/common/src/data-structures/Hinkal/hinkalDepositOnChainUtxos.ts
+var d = async (d, f, p, m, h, g, _, v = !0) => {
+	let y = t(f), b = p.erc20TokenAddress, { zkCallData: x, circomData: S, dimData: C, totalAmount: w, utxoAmounts: T, hinkalWrapperAddress: E, hinkalWrapperABI: D, depositOnChainUtxosExternalActionAddress: O, depositOnChainUtxosExternalActionABI: k } = await u(d, f, p, m, g), A = (await l({
+		chainId: f,
+		hashedEthereumAddress: _,
+		phase: n.BEFORE_DEPOSIT
+	})).id ?? void 0, j;
+	if (y) {
+		let e = d.getTronWeb();
+		j = await s(d, f, w, p, x, S, C, e.contract(k, r(O)), e.contract(D, r(E)), v);
+	} else {
+		let t = d.getContractWithSigner(f, e.HinkalWrapper);
+		j = (await o(d, f, w, p, x, S, C, d.getContractWithSigner(f, e.DepositOnChainUtxos), t, v)).hash;
+	}
+	if (!j) throw Error("Deposit transaction hash not found");
+	let M = await a(f, j);
+	await c({
+		id: A,
+		chainId: f,
+		hashedEthereumAddress: _,
+		phase: n.AFTER_DEPOSIT,
+		depositTxHash: j
+	});
+	let N = i(M, d, f, b);
+	if (N.length === 0) throw Error("No UTXOs found in deposit transaction. Check contract address and ABI.");
+	let P = [], F = [...N];
+	return h.forEach((e, t) => {
+		let n = T[t], r = F.find((e) => e.amount === n);
+		if (!r) throw Error(`Could not find newly created UTXO with amount ${n} for recipient ${e}.`);
+		P.push({
+			recipientAddress: e,
+			utxo: r
+		});
+		let i = F.indexOf(r);
+		F.splice(i, 1);
+	}), {
+		userDepositedUtxos: P,
+		statusId: A,
+		depositTxHash: j
+	};
+};
+//#endregion
+export { d as hinkalDepositOnChainUtxos };

package/data-structures/Hinkal/hinkalGetRecipientInfo.cjs

@@ -0,0 +1 @@
+const e=require(`../../functions/utils/getRecipientInfoFromUserKeys.cjs`);var t=t=>{if(!t)throw Error(`No hinkal provided`);let{userKeys:n}=t;return e.getRecipientInfoFromUserKeys(n)};exports.getRecipientInfo=t;

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

@@ -0,0 +1,2 @@
+import { IHinkal } from './IHinkal';
+export declare const getRecipientInfo: (hinkal: IHinkal) => string;

package/data-structures/Hinkal/hinkalGetRecipientInfo.mjs

@@ -0,0 +1,9 @@
+import { getRecipientInfoFromUserKeys as e } from "../../functions/utils/getRecipientInfoFromUserKeys.mjs";
+//#region libs/shared/common/src/data-structures/Hinkal/hinkalGetRecipientInfo.ts
+var t = (t) => {
+	if (!t) throw Error("No hinkal provided");
+	let { userKeys: n } = t;
+	return e(n);
+};
+//#endregion
+export { t as getRecipientInfo };

package/data-structures/Hinkal/hinkalGetZkMeProvider.cjs

@@ -0,0 +1 @@
+const e=require(`../../API/API.cjs`);var t=t=>({async getAccessToken(){return e.API.getZkMeAccessToken()},async getUserAccounts(){return[await t.getEthereumAddress()]},async delegateTransaction(e){let n=t.getProviderAdapter(Number(e.chainId)),r={...e,chainId:Number(e.chainId),type:e.type?e.type:void 0,maxPriorityFeePerGas:e.maxPriorityFeePerGas?e.maxPriorityFeePerGas:void 0,maxFeePerGas:e.maxFeePerGas?e.maxFeePerGas:void 0};return(await n.sendTransaction(r)).hash}});exports.getHinkalZkMeProvider=t;

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

@@ -0,0 +1,28 @@
+import { IHinkal } from './IHinkal';
+export type ZkMeTransactionRequest = {
+    type: null | number;
+    from: string;
+    to: string;
+    data: string;
+    chainId: string;
+    gasLimit: string;
+    gasPrice: string;
+    maxFeePerGas: string | null;
+    maxPriorityFeePerGas: string | null;
+};
+export declare const getHinkalZkMeProvider: (hinkal: IHinkal) => {
+    getAccessToken(): Promise<any>;
+    getUserAccounts(): Promise<string[]>;
+    delegateTransaction(tx: ZkMeTransactionRequest): Promise<string>;
+};
+export type ZkMeProvider = ReturnType<typeof getHinkalZkMeProvider>;
+export type ZkMeWidgetMessageBody = {
+    id?: string;
+    channelId: string;
+    method?: 'getUserAccounts' | 'delegateTransaction' | 'signMessage' | 'getAccessToken';
+    params?: ZkMeTransactionRequest | string;
+    kycResults?: 'matching' | 'mismatch';
+    verifiedAddress?: string;
+    event?: 'close' | 'finished';
+    email?: string;
+};

package/data-structures/Hinkal/hinkalGetZkMeProvider.mjs

@@ -0,0 +1,22 @@
+import { API as e } from "../../API/API.mjs";
+//#region libs/shared/common/src/data-structures/Hinkal/hinkalGetZkMeProvider.ts
+var t = (t) => ({
+	async getAccessToken() {
+		return e.getZkMeAccessToken();
+	},
+	async getUserAccounts() {
+		return [await t.getEthereumAddress()];
+	},
+	async delegateTransaction(e) {
+		let n = t.getProviderAdapter(Number(e.chainId)), r = {
+			...e,
+			chainId: Number(e.chainId),
+			type: e.type ? e.type : void 0,
+			maxPriorityFeePerGas: e.maxPriorityFeePerGas ? e.maxPriorityFeePerGas : void 0,
+			maxFeePerGas: e.maxFeePerGas ? e.maxFeePerGas : void 0
+		};
+		return (await n.sendTransaction(r)).hash;
+	}
+});
+//#endregion
+export { t as getHinkalZkMeProvider };

package/data-structures/Hinkal/hinkalMultiSend.cjs

@@ -0,0 +1 @@
+const e=require(`../../functions/utils/addresses.cjs`),t=require(`../../error-handling/error-codes.constants.cjs`);var n=async(n,r,i,a)=>{let o;return a&&(o=a.map(n=>{if(!e.isValidPrivateAddress(n))throw Error(t.transactionErrorCodes.RECIPIENT_FORMAT_INCORRECT);return e.constructStealthAddressStructure(n)})),n.prooflessDeposit(r,i,o)};exports.hinkalMultiSendPrivateRecipients=n;