@hinkal/react-native 0.3.1

package/common/src/functions/web3/events/getInputUtxoAndBalance.mjs

@@ -0,0 +1,112 @@
+import { isSolanaLike as e, isTronLike as t } from "../../../constants/chains.constants.mjs";
+import { caseInsensitiveEqual as n } from "../../utils/caseInsensitive.utils.mjs";
+import { Utxo as r } from "../../../data-structures/utxo/Utxo.mjs";
+import { checkAddressNotUpdated as i } from "../../utils/upToDateState.mjs";
+import { getHinkalCache as a, resetCache as o, setHinkalCache as s } from "../../utils/cacheFunctions.mjs";
+import { encodeTokenWithId as c } from "../../utils/encodeTokenWithId.mjs";
+import { formatMintAddress as l } from "../../utils/solanaMint.utils.mjs";
+import { getInputUtxosEnclave as u } from "./getInputUtxosEnclave.mjs";
+import { hashEthereumAddress as d } from "../../utils/addresses.mjs";
+import { getScheduledTransactionsNullifierIndexes as f } from "../../../API/scheduled-transactions-calls.mjs";
+import { addressToHexFormat as p } from "../../utils/tron.utils.mjs";
+import { Mutex as m } from "async-mutex";
+//#region common/src/functions/web3/events/getInputUtxoAndBalance.ts
+var h = new m(), g = async (e, t) => e.allowParallelBalanceLocalDecryption ? t() : h.runExclusive(t), _ = (e) => e?.[0] === 0n && e?.[1] === 1n, v = async (e, t, n, r, a, o, c, l, u) => g(e, async () => {
+	u += 1;
+	let d = o.slice(u), { lastOutput: f, additionalEncryptedOutputs: p } = await e.utxoUtils.batchProcess(d, l, t, n), m = [...c, ...p];
+	return await i(e, r), s({
+		lastOutput: f,
+		encryptedOutputs: m
+	}, e, n, a), await e.utxoUtils.buildBatchProcess(m, t, n);
+}), y = async (e, t, n, r) => {
+	let { utxos: i, encryptedOutputs: a, lastOutput: o } = await u(e, n, t);
+	return s({
+		encryptedOutputs: a,
+		lastOutput: o
+	}, e, n, r), i;
+}, b = async (e, t, n, r, i, a, o, s, c) => {
+	try {
+		return await y(e, t, n, i);
+	} catch {
+		return v(e, t, n, r, i, a, o, s, c);
+	}
+}, x = (e) => {
+	if (Array.isArray(e)) return e;
+	if (e !== void 0) return [e];
+}, S = async (e, t, n) => await e.utxoUtils.batchFilterUtxosWithNullifier(t, n), C = (e, t, n, i, a, o, s, c) => {
+	for (e.sort((e, t) => e.amount <= t.amount ? 1 : -1); e.length < t || e.length > t && e.length < 6;) if (e.push(new r({
+		amount: 0n,
+		erc20TokenAddress: o,
+		mintAddress: c,
+		nullifyingKey: i,
+		spendingPublicKey: a,
+		isNewStyle: !0
+	})), n) for (; e.length > 6;) e.splice(e.length - 1);
+}, w = async ({ hinkal: e, chainId: t, passedShieldedPublicKey: n = void 0, ethAddress: r = void 0, resetCacheBefore: s = !1, allowRemoteDecryption: c = !1, useBlockedUtxos: l = !1 }) => {
+	let u = r ?? await e.getEthereumAddress(), d = n ?? e.userKeys.getShieldedPublicKey(), { userKeys: f } = e, p = e.encryptedOutputsByChain[t], m = e.nullifiersByChain[t], h = Array.from(p);
+	s && o(e, t, d);
+	let { encryptedOutputs: g, lastOutput: y } = a(e, t, d);
+	await i(e, u);
+	let x = y !== "", C = h.findIndex((e) => e.value === y), w = C > -1, T = !x && C === -1, E = e.areMerkleTreeUpdatesDisabled(), D = !E && (w || !c && T), O = !E && c && T, k = !D && !O, A = [];
+	D ? A = await v(e, f, t, u, d, h, g, y, C) : O ? A = await b(e, f, t, u, d, h, g, y, C) : k && (A = await e.utxoUtils.buildBatchProcess(g, f, t)), await i(e, u);
+	let j = await S(e, A, m);
+	return { inputUtxos: (l ? j.filter((e) => e.isBlocked) : j.filter((e) => !e.isBlocked)).filter((e) => !_(e.H0)) };
+}, T = async ({ hinkal: e, chainId: n, passedShieldedPublicKey: r = void 0, ethAddress: i = void 0, resetCacheBefore: a = !1, allowRemoteDecryption: o = !1 }) => {
+	let s = i ?? await e.getEthereumAddressByChain(n), c = d(t(n) ? p(s) : s), { inputUtxos: l } = await w({
+		hinkal: e,
+		chainId: n,
+		passedShieldedPublicKey: r,
+		ethAddress: s,
+		resetCacheBefore: a,
+		allowRemoteDecryption: o,
+		useBlockedUtxos: !0
+	});
+	if (!l.length) return { inputUtxos: [] };
+	let { indexes: u } = await f({
+		hashedEthereumAddress: c,
+		nullifiers: l.map((e) => e.getNullifier())
+	});
+	return { inputUtxos: u.map((e) => l[e]).filter((e) => !!e) };
+}, E = async ({ hinkal: t, tokenWithId: r, minInput: i = 2, sliceIfMore6: a = !0, chainId: o, passedShieldedPrivateKey: s = void 0, passedShieldedPublicKey: u = void 0, ethAddress: d = void 0, resetCacheBefore: f = !1, ensuredTokensWithId: p, allowRemoteDecryption: m = !1, useBlockedUtxos: h = !1 }) => {
+	let g = s ?? t.userKeys.getShieldedPrivateKey(), _ = t.userKeys.getSpendingKeyPair().pubSpendingBJJPoint, { inputUtxos: v } = h ? await T({
+		hinkal: t,
+		chainId: o,
+		ethAddress: d,
+		passedShieldedPrivateKey: s,
+		resetCacheBefore: f,
+		allowRemoteDecryption: m
+	}) : await w({
+		hinkal: t,
+		tokenWithId: r,
+		minInput: i,
+		sliceIfMore6: a,
+		chainId: o,
+		passedShieldedPrivateKey: s,
+		passedShieldedPublicKey: u,
+		ethAddress: d,
+		resetCacheBefore: f,
+		allowRemoteDecryption: m
+	}), y = x(r), b = /* @__PURE__ */ new Map();
+	v.forEach((e) => {
+		let t = e.getTokenAddress(o);
+		if (y && !y.some((e) => n(e.erc20TokenAddress, t))) return;
+		let r = c(o, {
+			erc20TokenAddress: t,
+			tokenId: 0
+		}), i = b.get(r) ?? [];
+		b.set(r, [...i, e]);
+	}), p?.forEach((e) => {
+		let t = c(o, {
+			erc20TokenAddress: e.erc20TokenAddress,
+			tokenId: 0
+		});
+		b.set(t, b.get(t) ?? []);
+	});
+	for (let [t, n] of b) {
+		let r = t.split("-")[0], s = Number(t.split("-")[1]), c = e(o), u = c ? r : void 0;
+		C(n, i, a, g, _, c ? l(r).compressedAddress.toLowerCase() : r.toLowerCase(), s, u);
+	}
+	return b;
+};
+//#endregion
+export { b as attemptGetInputUtxosRemotely, w as getInputUtxoAndBalance, T as getInputUtxoAndBalanceOfStuckUtxos, E as getInputUtxoAndBalancePerToken, y as getInputUtxosRemotely };

package/common/src/functions/web3/events/getInputUtxosEnclave.cjs

@@ -0,0 +1 @@
+require("../../../../../_virtual/_rolldown/runtime.cjs");const e=require(`../../../constants/chains.constants.cjs`),t=require(`../../../data-structures/crypto-keys/keys.cjs`),n=require(`../../../data-structures/utxo/Utxo.cjs`),r=require(`../../utils/encryptInputForEnclave.cjs`),i=require(`../../utils/solanaMint.utils.cjs`),a=require(`../../utils/customEnclaveFunctionsRegister.cjs`),o=require(`../../utils/serialize-utxos.utils.cjs`);let s=require(`ethers`),c=require(`@solana/web3.js`);var l=e=>{if(!e)return;let t=s.ethers.getBytes(e);if(t.length!==32)return;let n=new c.PublicKey(t),r=n.toBase58(),{compressedAddress:a}=i.formatMintAddress(n);return{mintBase58:r,compressedAddress:a}},u=async(e,t,n)=>{let{keyCiphertext:i,inputCiphertext:a}=await r.makeEnclaveHandshakeAndEncryptUint8Array(n);return e.getAPI().decryptUtxoEnclaveCall(t,i,a)},d=async(r,i,c)=>{let d=c.getShieldedPrivateKey(),{privateKey:f,publicKey:p}=t.UserKeys.getEncryptionKeyPair(d),m=c.getSpendingKeyPair().pubSpendingBJJPoint,h=s.ethers.solidityPacked([`uint256`,`uint256`,`uint256`],[p,f,d]),g=s.ethers.getBytes(h),_=a.getCustomUtxoDecryptor(),{utxos:v,lastOutput:y,encryptedOutputs:b}=await(_?_(i,g):u(r,i,g));return{utxos:v.map(t=>{let r=t;if(e.isSolanaLike(i)){let e=l(t.mintAddress);if(!e)throw Error(`Invalid mint address`);r={...r,erc20TokenAddress:e.compressedAddress,mintAddress:e.mintBase58}}return new n.Utxo({...o.deserializeUtxoConstructorParams(r),nullifyingKey:d,spendingPublicKey:m})}),encryptedOutputs:b,lastOutput:y}};exports.getInputUtxosEnclave=d;

package/common/src/functions/web3/events/getInputUtxosEnclave.d.ts

@@ -0,0 +1,9 @@
+import { IHinkal } from '../../../data-structures/Hinkal/IHinkal';
+import { Utxo } from '../../../data-structures/utxo/Utxo';
+import { UserKeys } from '../../../data-structures/crypto-keys/keys';
+import { EncryptedOutputWithSign } from '../../../types/commitments.types';
+export declare const getInputUtxosEnclave: (hinkal: IHinkal, chainId: number, userKeys: UserKeys) => Promise<{
+    utxos: Utxo[];
+    encryptedOutputs: EncryptedOutputWithSign<boolean>[];
+    lastOutput: string;
+}>;

package/common/src/functions/web3/events/getInputUtxosEnclave.mjs

@@ -0,0 +1,56 @@
+import { isSolanaLike as e } from "../../../constants/chains.constants.mjs";
+import { UserKeys as t } from "../../../data-structures/crypto-keys/keys.mjs";
+import { Utxo as n } from "../../../data-structures/utxo/Utxo.mjs";
+import { makeEnclaveHandshakeAndEncryptUint8Array as r } from "../../utils/encryptInputForEnclave.mjs";
+import { formatMintAddress as i } from "../../utils/solanaMint.utils.mjs";
+import { getCustomUtxoDecryptor as a } from "../../utils/customEnclaveFunctionsRegister.mjs";
+import { deserializeUtxoConstructorParams as o } from "../../utils/serialize-utxos.utils.mjs";
+import { ethers as s } from "ethers";
+import { PublicKey as c } from "@solana/web3.js";
+//#region common/src/functions/web3/events/getInputUtxosEnclave.ts
+var l = (e) => {
+	if (!e) return;
+	let t = s.getBytes(e);
+	if (t.length !== 32) return;
+	let n = new c(t), r = n.toBase58(), { compressedAddress: a } = i(n);
+	return {
+		mintBase58: r,
+		compressedAddress: a
+	};
+}, u = async (e, t, n) => {
+	let { keyCiphertext: i, inputCiphertext: a } = await r(n);
+	return e.getAPI().decryptUtxoEnclaveCall(t, i, a);
+}, d = async (r, i, c) => {
+	let d = c.getShieldedPrivateKey(), { privateKey: f, publicKey: p } = t.getEncryptionKeyPair(d), m = c.getSpendingKeyPair().pubSpendingBJJPoint, h = s.solidityPacked([
+		"uint256",
+		"uint256",
+		"uint256"
+	], [
+		p,
+		f,
+		d
+	]), g = s.getBytes(h), _ = a(), { utxos: v, lastOutput: y, encryptedOutputs: b } = await (_ ? _(i, g) : u(r, i, g));
+	return {
+		utxos: v.map((t) => {
+			let r = t;
+			if (e(i)) {
+				let e = l(t.mintAddress);
+				if (!e) throw Error("Invalid mint address");
+				r = {
+					...r,
+					erc20TokenAddress: e.compressedAddress,
+					mintAddress: e.mintBase58
+				};
+			}
+			return new n({
+				...o(r),
+				nullifyingKey: d,
+				spendingPublicKey: m
+			});
+		}),
+		encryptedOutputs: b,
+		lastOutput: y
+	};
+};
+//#endregion
+export { d as getInputUtxosEnclave };

package/common/src/functions/web3/events/getShieldedBalance.cjs

@@ -0,0 +1 @@
+require("../../../../../_virtual/_rolldown/runtime.cjs");const e=require(`../../../constants/vite.constants.cjs`),t=require(`../../../constants/chains.constants.cjs`),n=require(`../../utils/caseInsensitive.utils.cjs`),r=require(`../../../error-handling/error-codes.constants.cjs`),i=require(`../etherFunctions.cjs`),a=require(`../../../data-structures/utxo/Utxo.cjs`),o=require(`../../../error-handling/customErrors/ErrorWithAmount.cjs`);require(`../../../error-handling/customErrors/index.cjs`);const s=require(`../../utils/encodeTokenWithId.cjs`),c=require(`../../utils/solanaMint.utils.cjs`),l=require(`./getInputUtxoAndBalance.cjs`),u=require(`../../../data-structures/TokenDBs/PrivateTokensDB.cjs`),d=require(`../../utils/map.utils.cjs`),f=require(`../../utils/mutexes.utils.cjs`),p=require(`../../utils/erc20tokenFunctions.cjs`);let m=require(`async-mutex`);var h=async(t,r,i,a,o,s=!1,c,h=!1,g=!1)=>d.getOrCreateMapValue(t.balanceFetchingMutexByChain,r,()=>new m.Mutex).runExclusive(async()=>f.getChainBalanceFetchingMutex(r).runShared(async()=>{let{inputUtxos:d}=g?await l.getInputUtxoAndBalanceOfStuckUtxos({hinkal:t,chainId:r,ethAddress:o,passedShieldedPrivateKey:i,resetCacheBefore:s,allowRemoteDecryption:c}):await l.getInputUtxoAndBalance({hinkal:t,sliceIfMore6:!1,chainId:r,passedShieldedPrivateKey:i,passedShieldedPublicKey:a,ethAddress:o,resetCacheBefore:s,allowRemoteDecryption:c});h&&e.isExtension&&await u.privateTokensDB.fetchAndUpdatePrivateTokens(d.map(e=>e.getTokenAddress(r)).filter(e=>e!==void 0),r,o);let f=(e.isExtension?await u.privateTokensDB.getPrivateTokens(r,o):await p.getErc20TokensForChainAPI(r)).map(e=>({token:e,balance:d.reduce((t,i)=>{let a=e.erc20TokenAddress;return n.caseInsensitiveEqual(a,i.getTokenAddress(r))?t+i.amount:t},0n),timestamp:d.filter(t=>n.caseInsensitiveEqual(t.getTokenAddress(r),e.erc20TokenAddress))[0]?.timeStamp,nfts:[]})),m=new Map;return f.forEach(e=>{m.set(e.token.erc20TokenAddress.toLowerCase(),e)}),m})),g=async(e,n,u,d,f=6,m=u.map(()=>0),h=!1,g=!1)=>{let{userKeys:_}=e,v=_.getSpendingKeyPair().pubSpendingBJJPoint,y=[],b=[];if(u.length===0)return[];if(h){for(let e=0;e<u.length;e+=1){let r=t.isSolanaLike(n),i=r?u[e]:void 0,o=r?c.formatMintAddress(u[e]).compressedAddress:u[e];y.push(Array.from({length:f},()=>new a.Utxo({amount:0n,erc20TokenAddress:o,mintAddress:i,nullifyingKey:_.getShieldedPrivateKey(),spendingPublicKey:v,isNewStyle:!0})))}return y}let x=await l.getInputUtxoAndBalancePerToken({hinkal:e,sliceIfMore6:!1,ensuredTokensWithId:u.map((e,t)=>({erc20TokenAddress:u[t],tokenId:m[t]})),allowRemoteDecryption:e.generateProofRemotely,useBlockedUtxos:g,chainId:n}),S=0;for(let e=0;e<u.length;e+=1){let t=x.get(s.encodeTokenWithId(n,{erc20TokenAddress:u[e],tokenId:m[e]}))??[];if(!t)throw Error(`Missing utxos for token`);S=Math.max(t.length,S),b.push(t)}if(S===2)return b;for(let[e,s]of b.entries())if(s.length>f){let t=s.slice(0,f),a=t.reduce((e,t)=>e+t.amount,0n);if(d[e]<0n&&a<-d[e]){let t=await p.getErc20TokenFromAPI(n,u[e]);if(!t)throw Error(`Token not found`);let s=t.decimals===18?6:2,c=Number(i.getAmountWithPrecision(a,t,s));throw new o.ErrorWithAmount(c,`${r.DIRECTLY_SHOW_MESSAGE_ERROR_CODES.UTXO_LIMITATIONS}. Please try again with ${c} ${t.symbol}, including gas fees.`)}y.push(t)}else if(s.length<=f){let r=[...s],i=f-s.length;for(;i>0;){--i;let o=t.isSolanaLike(n),s=o?u[e]:void 0,l=o?c.formatMintAddress(u[e]).compressedAddress:u[e];r.push(new a.Utxo({amount:0n,erc20TokenAddress:l,mintAddress:s,nullifyingKey:_.getShieldedPrivateKey(),spendingPublicKey:v,isNewStyle:!0}))}y.push(r)}return y};exports.addPaddingToUtxos=g,exports.getShieldedBalance=h;

package/common/src/functions/web3/events/getShieldedBalance.d.ts

@@ -0,0 +1,18 @@
+import { TokenBalance } from '../../../types/token.types';
+import { Utxo } from '../../../data-structures/utxo/Utxo';
+import { IHinkal } from '../../../data-structures/Hinkal/IHinkal';
+/**
+ *
+ * @param UserKeys to access user's encryption keys
+ * @returns shielded balance
+ */
+export declare const getShieldedBalance: (hinkal: IHinkal, chainId: number, passedShieldedPrivateKey: string, passedShieldedPublicKey: string, ethAddress: string, resetCacheBefore?: boolean, allowRemoteDecryption?: boolean, updateTokensListBefore?: boolean, useBlockedUtxos?: boolean) => Promise<Map<string, TokenBalance>>;
+/**
+ *
+ * @param hinkal hinkal instance to get userKeys
+ * @param erc20Addresses array of erc20 tokens
+ * @param amountChanges array of token amounts
+ * @param maxInput to pad until maxInput number
+ * @returns return padded UTXOs for every erc20 token
+ */
+export declare const addPaddingToUtxos: (hinkal: IHinkal, chainId: number, erc20Addresses: string[], amountChanges: bigint[], maxInput?: number, tokenIds?: number[], forceEmptyUtxos?: boolean, useBlockedUtxos?: boolean) => Promise<Utxo[][]>;

package/common/src/functions/web3/events/getShieldedBalance.mjs

@@ -0,0 +1,114 @@
+import { isExtension as e } from "../../../constants/vite.constants.mjs";
+import { isSolanaLike as t } from "../../../constants/chains.constants.mjs";
+import { caseInsensitiveEqual as n } from "../../utils/caseInsensitive.utils.mjs";
+import { DIRECTLY_SHOW_MESSAGE_ERROR_CODES as r } from "../../../error-handling/error-codes.constants.mjs";
+import { getAmountWithPrecision as i } from "../etherFunctions.mjs";
+import { Utxo as a } from "../../../data-structures/utxo/Utxo.mjs";
+import { ErrorWithAmount as o } from "../../../error-handling/customErrors/ErrorWithAmount.mjs";
+import "../../../error-handling/customErrors/index.mjs";
+import { encodeTokenWithId as s } from "../../utils/encodeTokenWithId.mjs";
+import { formatMintAddress as c } from "../../utils/solanaMint.utils.mjs";
+import { getInputUtxoAndBalance as l, getInputUtxoAndBalanceOfStuckUtxos as u, getInputUtxoAndBalancePerToken as d } from "./getInputUtxoAndBalance.mjs";
+import { privateTokensDB as f } from "../../../data-structures/TokenDBs/PrivateTokensDB.mjs";
+import { getOrCreateMapValue as p } from "../../utils/map.utils.mjs";
+import { getChainBalanceFetchingMutex as m } from "../../utils/mutexes.utils.mjs";
+import { getErc20TokenFromAPI as h, getErc20TokensForChainAPI as g } from "../../utils/erc20tokenFunctions.mjs";
+import { Mutex as _ } from "async-mutex";
+//#region common/src/functions/web3/events/getShieldedBalance.ts
+var v = async (t, r, i, a, o, s = !1, c, d = !1, h = !1) => p(t.balanceFetchingMutexByChain, r, () => new _()).runExclusive(async () => m(r).runShared(async () => {
+	let { inputUtxos: p } = h ? await u({
+		hinkal: t,
+		chainId: r,
+		ethAddress: o,
+		passedShieldedPrivateKey: i,
+		resetCacheBefore: s,
+		allowRemoteDecryption: c
+	}) : await l({
+		hinkal: t,
+		sliceIfMore6: !1,
+		chainId: r,
+		passedShieldedPrivateKey: i,
+		passedShieldedPublicKey: a,
+		ethAddress: o,
+		resetCacheBefore: s,
+		allowRemoteDecryption: c
+	});
+	d && e && await f.fetchAndUpdatePrivateTokens(p.map((e) => e.getTokenAddress(r)).filter((e) => e !== void 0), r, o);
+	let m = (e ? await f.getPrivateTokens(r, o) : await g(r)).map((e) => ({
+		token: e,
+		balance: p.reduce((t, i) => {
+			let a = e.erc20TokenAddress;
+			return n(a, i.getTokenAddress(r)) ? t + i.amount : t;
+		}, 0n),
+		timestamp: p.filter((t) => n(t.getTokenAddress(r), e.erc20TokenAddress))[0]?.timeStamp,
+		nfts: []
+	})), _ = /* @__PURE__ */ new Map();
+	return m.forEach((e) => {
+		_.set(e.token.erc20TokenAddress.toLowerCase(), e);
+	}), _;
+})), y = async (e, n, l, u, f = 6, p = l.map(() => 0), m = !1, g = !1) => {
+	let { userKeys: _ } = e, v = _.getSpendingKeyPair().pubSpendingBJJPoint, y = [], b = [];
+	if (l.length === 0) return [];
+	if (m) {
+		for (let e = 0; e < l.length; e += 1) {
+			let r = t(n), i = r ? l[e] : void 0, o = r ? c(l[e]).compressedAddress : l[e];
+			y.push(Array.from({ length: f }, () => new a({
+				amount: 0n,
+				erc20TokenAddress: o,
+				mintAddress: i,
+				nullifyingKey: _.getShieldedPrivateKey(),
+				spendingPublicKey: v,
+				isNewStyle: !0
+			})));
+		}
+		return y;
+	}
+	let x = await d({
+		hinkal: e,
+		sliceIfMore6: !1,
+		ensuredTokensWithId: l.map((e, t) => ({
+			erc20TokenAddress: l[t],
+			tokenId: p[t]
+		})),
+		allowRemoteDecryption: e.generateProofRemotely,
+		useBlockedUtxos: g,
+		chainId: n
+	}), S = 0;
+	for (let e = 0; e < l.length; e += 1) {
+		let t = x.get(s(n, {
+			erc20TokenAddress: l[e],
+			tokenId: p[e]
+		})) ?? [];
+		if (!t) throw Error("Missing utxos for token");
+		S = Math.max(t.length, S), b.push(t);
+	}
+	if (S === 2) return b;
+	for (let [e, s] of b.entries()) if (s.length > f) {
+		let t = s.slice(0, f), a = t.reduce((e, t) => e + t.amount, 0n);
+		if (u[e] < 0n && a < -u[e]) {
+			let t = await h(n, l[e]);
+			if (!t) throw Error("Token not found");
+			let s = t.decimals === 18 ? 6 : 2, c = Number(i(a, t, s));
+			throw new o(c, `${r.UTXO_LIMITATIONS}. Please try again with ${c} ${t.symbol}, including gas fees.`);
+		}
+		y.push(t);
+	} else if (s.length <= f) {
+		let r = [...s], i = f - s.length;
+		for (; i > 0;) {
+			--i;
+			let o = t(n), s = o ? l[e] : void 0, u = o ? c(l[e]).compressedAddress : l[e];
+			r.push(new a({
+				amount: 0n,
+				erc20TokenAddress: u,
+				mintAddress: s,
+				nullifyingKey: _.getShieldedPrivateKey(),
+				spendingPublicKey: v,
+				isNewStyle: !0
+			}));
+		}
+		y.push(r);
+	}
+	return y;
+};
+//#endregion
+export { y as addPaddingToUtxos, v as getShieldedBalance };

package/common/src/functions/web3/events/getTransactionLogEvents.cjs

@@ -0,0 +1 @@
+require(`../../utils/index.cjs`),require(`ethers`);

package/common/src/functions/web3/events/getTransactionLogEvents.d.ts

@@ -0,0 +1,13 @@
+import { ethers } from 'ethers';
+type ABIType = ConstructorParameters<typeof ethers.Interface>[0];
+export declare function getTransactionLogEvents(chainId: number, txHash: string, contractAddress: string, contractABI: ABIType): Promise<{
+    transactionHash: string;
+    from: string;
+    to: string | null;
+    blockNumber: number;
+    events: {
+        name: string;
+        args: ethers.Result;
+    }[];
+}>;
+export {};

package/common/src/functions/web3/events/getTransactionLogEvents.mjs

@@ -0,0 +1,2 @@
+import "../../utils/index.mjs";
+import "ethers";

package/common/src/functions/web3/events/index.cjs

@@ -0,0 +1 @@
+require(`./getInputUtxoAndBalance.cjs`),require(`./getShieldedBalance.cjs`),require(`./getTransactionLogEvents.cjs`);

package/common/src/functions/web3/events/index.d.ts

@@ -0,0 +1,3 @@
+export * from './getInputUtxoAndBalance';
+export * from './getShieldedBalance';
+export * from './getTransactionLogEvents';

package/common/src/functions/web3/events/index.mjs

@@ -0,0 +1,3 @@
+import "./getInputUtxoAndBalance.mjs";
+import "./getShieldedBalance.mjs";
+import "./getTransactionLogEvents.mjs";

package/common/src/functions/web3/fetchSolanaMerkleTreeRootHash.cjs

@@ -0,0 +1 @@
+const e=require(`../utils/bytes32.utils.cjs`);require(`../utils/index.cjs`);var t=async(t,n)=>{let r=await t.account.merkle.fetch(n,`confirmed`),i=Number(e.convertBytes32ToBigInt(r.rootIndex));return e.convertBytes32ToBigInt(r.roots.at(i-1))};exports.fetchSolanaMerkleTreeRootHash=t;

package/common/src/functions/web3/fetchSolanaMerkleTreeRootHash.d.ts

@@ -0,0 +1,3 @@
+import { Program } from '@coral-xyz/anchor';
+import { PublicKey } from '@solana/web3.js';
+export declare const fetchSolanaMerkleTreeRootHash: (hinkalProgram: Program, merkleTreePublicKey: PublicKey) => Promise<bigint>;

package/common/src/functions/web3/fetchSolanaMerkleTreeRootHash.mjs

@@ -0,0 +1,9 @@
+import { convertBytes32ToBigInt as e } from "../utils/bytes32.utils.mjs";
+import "../utils/index.mjs";
+//#region common/src/functions/web3/fetchSolanaMerkleTreeRootHash.ts
+var t = async (t, n) => {
+	let r = await t.account.merkle.fetch(n, "confirmed"), i = Number(e(r.rootIndex));
+	return e(r.roots.at(i - 1));
+};
+//#endregion
+export { t as fetchSolanaMerkleTreeRootHash };

package/common/src/functions/web3/functionCalls/approveToken.cjs

@@ -0,0 +1 @@
+require("../../../../../_virtual/_rolldown/runtime.cjs");const e=require(`../../../constants/chains.constants.cjs`),t=require(`../../../constants/protocol.constants.cjs`),n=require(`../../../types/ethereum-network.types.cjs`),r=require(`../../../types/token.types.cjs`),i=require(`../../utils/getContractAddress.cjs`),a=require(`../../utils/getSignerFromContract.cjs`),o=require(`./recoverTransactionFromError.cjs`);let s=require(`ethers`);var c=async(e,t,n)=>{let r=a.getSignerFromContract(n);return await n.allowance(await r.getAddress(),t.target)>=e},l=async(t,n,r,o,s)=>{if(e.getNonLocalhostChainId(n)!==e.chainIds.ethMainnet||o.symbol.toLowerCase()!==`usdt`||BigInt(await s.allowance(await a.getSignerFromContract(s).getAddress(),r.target))===0n)return;let c=await s.approve(i.getContractAddress(r),0n);c&&`hash`in c&&await t.waitForTransaction(n,c.hash)},u=async(u,d,f,p,m)=>{let h=u.getContractWithSigner(d,n.ContractType.ERC20Contract,m.erc20TokenAddress),g=m.approvalType??r.ApprovalType.Classic;if(g===r.ApprovalType.Classic||!u.isPermitterAvailable(d)){if(await c(p,f,h))return;await l(u,d,f,m,h);let t=d===e.chainIds.base?2:1;try{let e=await h.approve(i.getContractAddress(f),p);e&&`hash`in e&&await u.waitForTransaction(d,e.hash,t)}catch(e){if(!e?.transactionHash||!await o.recoverTransactionFromError(a.getProviderFromContract(h),e.transactionHash,t))throw e}return}let _=await u.getEthereumAddressByChain(d),v=u.getContract(d,n.ContractType.PermitterContract),y=await u.getContractWithFetcher(d,n.ContractType.ContractWithNonces,m.erc20TokenAddress).nonces(_),b=BigInt(Date.now()+t.permitSignatureValidFor)/1000n,x={owner:_,holder:_,spender:i.getContractAddress(v),value:p,nonce:y,deadline:b,expiry:b,allowed:!0},{v:S,r:C,s:w}=s.ethers.Signature.from(await u.signTypedData({name:await h.name(),chainId:d,version:`1`,verifyingContract:m.erc20TokenAddress},{Permit:g===r.ApprovalType.ERC20Permit?[{name:`owner`,type:`address`},{name:`spender`,type:`address`},{name:`value`,type:`uint256`},{name:`nonce`,type:`uint256`},{name:`deadline`,type:`uint256`}]:[{name:`holder`,type:`address`},{name:`spender`,type:`address`},{name:`nonce`,type:`uint256`},{name:`expiry`,type:`uint256`},{name:`allowed`,type:`bool`}]},x));if(g===r.ApprovalType.ERC20Permit){let e=new s.ethers.Interface([`function permit(address owner,address spender,uint256 value,uint256 deadline,uint8 v,bytes32 r,bytes32 s) external`]);return s.ethers.getBytesCopy(e.encodeFunctionData(`permit`,[x.owner,x.spender,x.value,x.deadline,S,s.ethers.getBytesCopy(C),s.ethers.getBytesCopy(w)])).slice(4)}let T=new s.ethers.Interface([`function permit(address holder,address spender,uint256 nonce,uint256 expiry,bool allowed,uint8 v,bytes32 r,bytes32 s) external`]);return s.ethers.getBytesCopy(T.encodeFunctionData(`permit`,[x.holder,x.spender,x.nonce,x.expiry,x.allowed,S,s.ethers.getBytesCopy(C),s.ethers.getBytesCopy(w)])).slice(4)};exports.approveTokenToHinkal=u;

package/common/src/functions/web3/functionCalls/approveToken.d.ts

@@ -0,0 +1,4 @@
+import { ethers } from 'ethers';
+import { IHinkal } from '../../../data-structures/Hinkal/IHinkal';
+import { ERC20Token } from '../../../types/token.types';
+export declare const approveTokenToHinkal: (hinkal: IHinkal, chainId: number, contractToApprove: ethers.Contract, amount: bigint, token: ERC20Token) => Promise<Uint8Array | undefined>;

package/common/src/functions/web3/functionCalls/approveToken.mjs

@@ -0,0 +1,113 @@
+import { chainIds as e, getNonLocalhostChainId as t } from "../../../constants/chains.constants.mjs";
+import { permitSignatureValidFor as n } from "../../../constants/protocol.constants.mjs";
+import { ContractType as r } from "../../../types/ethereum-network.types.mjs";
+import { ApprovalType as i } from "../../../types/token.types.mjs";
+import { getContractAddress as a } from "../../utils/getContractAddress.mjs";
+import { getProviderFromContract as o, getSignerFromContract as s } from "../../utils/getSignerFromContract.mjs";
+import { recoverTransactionFromError as c } from "./recoverTransactionFromError.mjs";
+import { ethers as l } from "ethers";
+//#region common/src/functions/web3/functionCalls/approveToken.ts
+var u = async (e, t, n) => {
+	let r = s(n);
+	return await n.allowance(await r.getAddress(), t.target) >= e;
+}, d = async (n, r, i, o, c) => {
+	if (t(r) !== e.ethMainnet || o.symbol.toLowerCase() !== "usdt" || BigInt(await c.allowance(await s(c).getAddress(), i.target)) === 0n) return;
+	let l = await c.approve(a(i), 0n);
+	l && "hash" in l && await n.waitForTransaction(r, l.hash);
+}, f = async (t, s, f, p, m) => {
+	let h = t.getContractWithSigner(s, r.ERC20Contract, m.erc20TokenAddress), g = m.approvalType ?? i.Classic;
+	if (g === i.Classic || !t.isPermitterAvailable(s)) {
+		if (await u(p, f, h)) return;
+		await d(t, s, f, m, h);
+		let n = s === e.base ? 2 : 1;
+		try {
+			let e = await h.approve(a(f), p);
+			e && "hash" in e && await t.waitForTransaction(s, e.hash, n);
+		} catch (e) {
+			if (!e?.transactionHash || !await c(o(h), e.transactionHash, n)) throw e;
+		}
+		return;
+	}
+	let _ = await t.getEthereumAddressByChain(s), v = t.getContract(s, r.PermitterContract), y = await t.getContractWithFetcher(s, r.ContractWithNonces, m.erc20TokenAddress).nonces(_), b = BigInt(Date.now() + n) / 1000n, x = {
+		owner: _,
+		holder: _,
+		spender: a(v),
+		value: p,
+		nonce: y,
+		deadline: b,
+		expiry: b,
+		allowed: !0
+	}, { v: S, r: C, s: w } = l.Signature.from(await t.signTypedData({
+		name: await h.name(),
+		chainId: s,
+		version: "1",
+		verifyingContract: m.erc20TokenAddress
+	}, { Permit: g === i.ERC20Permit ? [
+		{
+			name: "owner",
+			type: "address"
+		},
+		{
+			name: "spender",
+			type: "address"
+		},
+		{
+			name: "value",
+			type: "uint256"
+		},
+		{
+			name: "nonce",
+			type: "uint256"
+		},
+		{
+			name: "deadline",
+			type: "uint256"
+		}
+	] : [
+		{
+			name: "holder",
+			type: "address"
+		},
+		{
+			name: "spender",
+			type: "address"
+		},
+		{
+			name: "nonce",
+			type: "uint256"
+		},
+		{
+			name: "expiry",
+			type: "uint256"
+		},
+		{
+			name: "allowed",
+			type: "bool"
+		}
+	] }, x));
+	if (g === i.ERC20Permit) {
+		let e = new l.Interface(["function permit(address owner,address spender,uint256 value,uint256 deadline,uint8 v,bytes32 r,bytes32 s) external"]);
+		return l.getBytesCopy(e.encodeFunctionData("permit", [
+			x.owner,
+			x.spender,
+			x.value,
+			x.deadline,
+			S,
+			l.getBytesCopy(C),
+			l.getBytesCopy(w)
+		])).slice(4);
+	}
+	let T = new l.Interface(["function permit(address holder,address spender,uint256 nonce,uint256 expiry,bool allowed,uint8 v,bytes32 r,bytes32 s) external"]);
+	return l.getBytesCopy(T.encodeFunctionData("permit", [
+		x.holder,
+		x.spender,
+		x.nonce,
+		x.expiry,
+		x.allowed,
+		S,
+		l.getBytesCopy(C),
+		l.getBytesCopy(w)
+	])).slice(4);
+};
+//#endregion
+export { f as approveTokenToHinkal };

package/common/src/functions/web3/functionCalls/approveTokensToHinkal.cjs

@@ -0,0 +1 @@
+const e=require(`../../../constants/protocol.constants.cjs`),t=require(`./approveToken.cjs`);var n=async(n,r,i,a,o)=>{for(let s=0;s<o.length;s+=1){let c=o[s],l=a[s];c>0n&&l.erc20TokenAddress!==e.zeroAddress&&await t.approveTokenToHinkal(n,r,i,c,l)}};exports.approveTokensToHinkal=n;

package/common/src/functions/web3/functionCalls/approveTokensToHinkal.d.ts

@@ -0,0 +1,4 @@
+import { ethers } from 'ethers';
+import { IHinkal } from '../../../data-structures/Hinkal/IHinkal';
+import { ERC20Token } from '../../../types/token.types';
+export declare const approveTokensToHinkal: (hinkal: IHinkal, chainId: number, contractForApproval: ethers.Contract, tokensToApprove: ERC20Token[], amounts: bigint[]) => Promise<void>;

package/common/src/functions/web3/functionCalls/approveTokensToHinkal.mjs

@@ -0,0 +1,11 @@
+import { zeroAddress as e } from "../../../constants/protocol.constants.mjs";
+import { approveTokenToHinkal as t } from "./approveToken.mjs";
+//#region common/src/functions/web3/functionCalls/approveTokensToHinkal.ts
+var n = async (n, r, i, a, o) => {
+	for (let s = 0; s < o.length; s += 1) {
+		let c = o[s], l = a[s];
+		c > 0n && l.erc20TokenAddress !== e && await t(n, r, i, c, l);
+	}
+};
+//#endregion
+export { n as approveTokensToHinkal };

package/common/src/functions/web3/functionCalls/constructBatchCall.cjs

@@ -0,0 +1 @@
+require("../../../../../_virtual/_rolldown/runtime.cjs");const e=require(`../../../externalABIs/index.cjs`),t=require(`../../utils/getContractAddress.cjs`);let n=require(`ethers`);var r=(t,r)=>new n.ethers.Interface(e.ERC20ABI).encodeFunctionData(`approve`,[t,r]),i=(e,t,n,r)=>r.encodeFunctionData(`transact`,[e[0],e[1],e[2],t,n]),a=(e,t,n,r,i)=>i.encodeFunctionData(`prooflessDeposit`,[e,t,n,r]),o=(e,t,i,a,o,s)=>{let c=[];for(let a=0;a<e.length;a+=1){let o=e[a],s=t[a];o!==n.ethers.ZeroAddress&&s>0n&&c.push({to:o,value:`0x0`,data:r(i,s)})}return c.push({to:a,value:s>0n?`0x${s.toString(16)}`:`0x0`,data:o}),c},s=(e,a,o,s,c,l,u,d)=>{let f=[];for(let t=0;t<e.length;t+=1){let i=e[t],s=a[t];i!==n.ethers.ZeroAddress&&s>0n&&f.push({to:i,value:`0x0`,data:r(o,s)})}return f.push({to:t.getContractAddress(s),value:d>0n?`0x${d.toString(16)}`:`0x0`,data:i(c,l,u,s.interface)}),f},c=(e,t,n,r,i,a,o,s)=>e.encodeFunctionData(`prooflessDeposit`,[t,n,r,i,a,o,s]),l=(e,t,n,r,i,a,s,l,u,d,f,p)=>o(e,t,n,n,c(r,i,a,s,l,u,d,f),p),u=(e,n,r,i,s,c,l,u,d)=>{let f=a(s,c,l,u,i.interface);return o(e,n,r,t.getContractAddress(i),f,d)};exports.buildApproveAndDepositWrapperCalls=l,exports.buildApproveAndProoflessDepositCalls=u,exports.buildApproveAndTransactCalls=s;

package/common/src/functions/web3/functionCalls/constructBatchCall.d.ts

@@ -0,0 +1,7 @@
+import { ethers } from 'ethers';
+import { CircomDataType, DimDataType, StealthAddressStructure } from '../../../types/circom-data.types';
+import { NewZkCallDataType } from '../../../types/snark.types';
+import { Call } from '../../../types/eip5792.types';
+export declare const buildApproveAndTransactCalls: (tokenAddresses: string[], amounts: bigint[], spenderAddress: string, contractForTransaction: ethers.Contract, zkCallData: NewZkCallDataType, dimData: DimDataType, circomData: CircomDataType, ethValue: bigint) => Call[];
+export declare const buildApproveAndDepositWrapperCalls: (tokenAddresses: string[], amounts: bigint[], wrapperAddress: string, wrapperInterface: ethers.Interface, feeRecipient: string, feeToken: string, feeAmount: bigint, depositErc20Addresses: string[], depositAmounts: bigint[], depositTokenIds: bigint[], stealthAddressStructures: StealthAddressStructure[], ethValue: bigint) => Call[];
+export declare const buildApproveAndProoflessDepositCalls: (tokenAddresses: string[], amounts: bigint[], spenderAddress: string, contractForTransaction: ethers.Contract, prooflessDepositTokenAddresses: string[], prooflessDepositAmountChanges: bigint[], prooflessDepositTokenIds: bigint[], stealthAddressStructures: StealthAddressStructure[], ethValue: bigint) => Call[];

package/common/src/functions/web3/functionCalls/constructBatchCall.mjs

@@ -0,0 +1,59 @@
+import { ERC20ABI as e } from "../../../externalABIs/index.mjs";
+import { getContractAddress as t } from "../../utils/getContractAddress.mjs";
+import { ethers as n } from "ethers";
+//#region common/src/functions/web3/functionCalls/constructBatchCall.ts
+var r = (t, r) => new n.Interface(e).encodeFunctionData("approve", [t, r]), i = (e, t, n, r) => r.encodeFunctionData("transact", [
+	e[0],
+	e[1],
+	e[2],
+	t,
+	n
+]), a = (e, t, n, r, i) => i.encodeFunctionData("prooflessDeposit", [
+	e,
+	t,
+	n,
+	r
+]), o = (e, t, i, a, o, s) => {
+	let c = [];
+	for (let a = 0; a < e.length; a += 1) {
+		let o = e[a], s = t[a];
+		o !== n.ZeroAddress && s > 0n && c.push({
+			to: o,
+			value: "0x0",
+			data: r(i, s)
+		});
+	}
+	return c.push({
+		to: a,
+		value: s > 0n ? `0x${s.toString(16)}` : "0x0",
+		data: o
+	}), c;
+}, s = (e, a, o, s, c, l, u, d) => {
+	let f = [];
+	for (let t = 0; t < e.length; t += 1) {
+		let i = e[t], s = a[t];
+		i !== n.ZeroAddress && s > 0n && f.push({
+			to: i,
+			value: "0x0",
+			data: r(o, s)
+		});
+	}
+	return f.push({
+		to: t(s),
+		value: d > 0n ? `0x${d.toString(16)}` : "0x0",
+		data: i(c, l, u, s.interface)
+	}), f;
+}, c = (e, t, n, r, i, a, o, s) => e.encodeFunctionData("prooflessDeposit", [
+	t,
+	n,
+	r,
+	i,
+	a,
+	o,
+	s
+]), l = (e, t, n, r, i, a, s, l, u, d, f, p) => o(e, t, n, n, c(r, i, a, s, l, u, d, f), p), u = (e, n, r, i, s, c, l, u, d) => {
+	let f = a(s, c, l, u, i.interface);
+	return o(e, n, r, t(i), f, d);
+};
+//#endregion
+export { l as buildApproveAndDepositWrapperCalls, u as buildApproveAndProoflessDepositCalls, s as buildApproveAndTransactCalls };

package/common/src/functions/web3/functionCalls/estimateGasRelayer.d.ts

@@ -0,0 +1,4 @@
+import { CircomDataType, DimDataType } from '../../../types/circom-data.types';
+import { NewZkCallDataType } from '../../../types/snark.types';
+import { AuthorizationData } from '../../../types/hinkal.types';
+export declare const estimateGasRelayer: (chainId: number, newZkCallData: NewZkCallDataType, dimData: DimDataType, circomData: CircomDataType, authorizationData?: AuthorizationData) => Promise<bigint>;

package/common/src/functions/web3/functionCalls/getRootHash.d.ts

@@ -0,0 +1,2 @@
+import { Contract } from 'ethers';
+export declare const getRootHash: (merkleTreeContract: Contract) => Promise<bigint>;

package/common/src/functions/web3/functionCalls/recoverTransactionFromError.cjs

@@ -0,0 +1 @@
+const e=require(`../../utils/time.utils.cjs`),t=require(`../../../types/transactions.types.cjs`);require(`../../../types/index.cjs`);var n=1*1e3,r=30*1e3,i=async(i,a,o=0)=>{if((await i.getTransactionReceipt(a))?.status!==t.TransactionReceiptStatus.Succeeded)return;o>0&&await i.waitForTransaction(a,o);let s=r/n,c=null;for(let t=0;t<s;t+=1){try{if(c=await i.getTransaction(a),c)break}catch{}t<s-1&&await e.waitLittle(n)}return c??void 0};exports.recoverTransactionFromError=i;

package/common/src/functions/web3/functionCalls/recoverTransactionFromError.d.ts

@@ -0,0 +1,2 @@
+import { ethers } from 'ethers';
+export declare const recoverTransactionFromError: (provider: ethers.Provider, transactionHash: string, confirmations?: number) => Promise<ethers.TransactionResponse | undefined>;

package/common/src/functions/web3/functionCalls/recoverTransactionFromError.mjs

@@ -0,0 +1,18 @@
+import { waitLittle as e } from "../../utils/time.utils.mjs";
+import { TransactionReceiptStatus as t } from "../../../types/transactions.types.mjs";
+import "../../../types/index.mjs";
+//#region common/src/functions/web3/functionCalls/recoverTransactionFromError.ts
+var n = 1 * 1e3, r = 30 * 1e3, i = async (i, a, o = 0) => {
+	if ((await i.getTransactionReceipt(a))?.status !== t.Succeeded) return;
+	o > 0 && await i.waitForTransaction(a, o);
+	let s = r / n, c = null;
+	for (let t = 0; t < s; t += 1) {
+		try {
+			if (c = await i.getTransaction(a), c) break;
+		} catch {}
+		t < s - 1 && await e(n);
+	}
+	return c ?? void 0;
+};
+//#endregion
+export { i as recoverTransactionFromError };