@kapa123456789/sdk 0.0.9 → 0.0.12

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

@@ -0,0 +1,20 @@
+import { ERC20Token } from '../../types/token.types';
+export declare const ethToWei: (amount: string) => bigint;
+export declare const randomBigInt: (numberOfBytes: number) => bigint;
+export declare const getAmountInToken: (token: ERC20Token, amount: bigint) => string;
+export declare const getAmountInWei: (token: ERC20Token, amount: string) => bigint;
+/**
+ * Convert a decimal number into bigint through string method and return a bigint and number of decimal places.
+ * @param decimal
+ * @returns a tuple of [ theBigInt, numberOfDecimalPlaces]
+ */
+export declare const toBigIntWithDecimals: (decimal: number) => [bigint, number];
+/** Return getAmountInWei or 0 if error */
+export declare const getAmountInWeiOrZero: (token: ERC20Token, amount: string) => bigint;
+export declare const getAmountWithPrecision: (balance: bigint, token: ERC20Token, precision: number) => string;
+export declare const calculateDollarValue: (token: ERC20Token, tokenAmount: bigint, tokenPriceDollar: number, precision: number) => {
+    totalValueDollarsBigInt: bigint;
+    precision: number;
+};
+/** Returns same as getAmountWithPrecision but '0' if empty */
+export declare const getAmountWithPrecisionOrZero: (token: ERC20Token | undefined, amount: bigint | undefined) => string;

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

@@ -0,0 +1,21 @@
+import { transactionErrorCodes as e } from "../../error-handling/error-codes.constants.mjs";
+import { ethers as t } from "ethers";
+//#region libs/shared/common/src/functions/web3/etherFunctions.ts
+var n = (e) => BigInt(t.hexlify(t.randomBytes(e))), r = (e, n) => t.formatUnits(n, e.decimals), i = (n, r) => {
+	let i = 10 ** (18 - n.decimals);
+	try {
+		return t.parseUnits(r) / BigInt(i);
+	} catch {
+		throw Error(e.DECIMALS_LIMIT);
+	}
+}, a = (n, r, i) => {
+	let a = t.formatUnits(n, r.decimals), o = BigInt(10 ** (18 - i));
+	try {
+		let e = t.parseUnits(a) / o;
+		return t.formatUnits(e, i);
+	} catch {
+		throw Error(e.DECIMALS_LIMIT);
+	}
+};
+//#endregion
+export { r as getAmountInToken, i as getAmountInWei, a as getAmountWithPrecision, n as randomBigInt };

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

@@ -0,0 +1 @@
+const e=require(`../../../types/hinkal.types.cjs`);require(`../../../types/index.cjs`);var t=new Set,n=n=>{if(typeof document<`u`){let t=e=>{e instanceof CustomEvent?n(e.detail??{}):n({})};return document.addEventListener(e.EventType.BalanceChange,t),()=>document.removeEventListener(e.EventType.BalanceChange,t)}return t.add(n),()=>{t.delete(n)}},r=n=>{let r=e.EventType.BalanceChange,i=new CustomEvent(r,{detail:n});typeof document<`u`?document.dispatchEvent(i):t.forEach(e=>{e(n)})};exports.balanceChangedHandler=r,exports.subscribeToBalanceChange=n;

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

@@ -0,0 +1,5 @@
+import { PrivateBalanceUpdateEventType } from '../../../types';
+type BalanceChangeListener = (detail?: PrivateBalanceUpdateEventType) => void;
+export declare const subscribeToBalanceChange: (listener: BalanceChangeListener) => (() => void);
+export declare const balanceChangedHandler: (detail: PrivateBalanceUpdateEventType) => void;
+export {};

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

@@ -0,0 +1,21 @@
+import { EventType as e } from "../../../types/hinkal.types.mjs";
+import "../../../types/index.mjs";
+//#region libs/shared/common/src/functions/web3/events/balanceChangedHandler.ts
+var t = /* @__PURE__ */ new Set(), n = (n) => {
+	if (typeof document < "u") {
+		let t = (e) => {
+			e instanceof CustomEvent ? n(e.detail ?? {}) : n({});
+		};
+		return document.addEventListener(e.BalanceChange, t), () => document.removeEventListener(e.BalanceChange, t);
+	}
+	return t.add(n), () => {
+		t.delete(n);
+	};
+}, r = (n) => {
+	let r = e.BalanceChange, i = new CustomEvent(r, { detail: n });
+	typeof document < "u" ? document.dispatchEvent(i) : t.forEach((e) => {
+		e(n);
+	});
+};
+//#endregion
+export { r as balanceChangedHandler, n as subscribeToBalanceChange };

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

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

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

@@ -0,0 +1,38 @@
+import { IHinkal } from '../../../data-structures/Hinkal/IHinkal';
+import { UserKeys } from '../../../data-structures/crypto-keys/keys';
+import { Utxo } from '../../../data-structures/utxo/Utxo';
+import { EncryptedOutputWithSign } from '../../../types/commitments.types';
+import { TokenWithId } from '../../../types/token-with-id.types';
+interface IGetInputUtxos {
+    hinkal: IHinkal;
+    chainId: number;
+    tokenWithId?: TokenWithId | TokenWithId[];
+    minInput?: number;
+    sliceIfMore6?: boolean;
+    tokenId?: number;
+    passedShieldedPrivateKey?: string;
+    passedShieldedPublicKey?: string;
+    ethAddress?: string;
+    resetCacheBefore?: boolean;
+    allowRemoteDecryption?: boolean;
+    ensuredTokensWithId?: TokenWithId[];
+    useBlockedUtxos?: boolean;
+}
+export declare const getInputUtxosRemotely: (hinkal: IHinkal, userKeys: UserKeys, currentChainId: number, shieldedPublicKey: string) => Promise<Utxo[]>;
+export declare const attemptGetInputUtxosRemotely: (hinkal: IHinkal, userKeys: UserKeys, currentChainId: number, ethereumAddress: string, shieldedPublicKey: string, hinkalOutputs: EncryptedOutputWithSign<boolean>[], cachedEncryptedOutputs: EncryptedOutputWithSign<boolean>[], lastOutput: string, lastOutputIndex: number) => Promise<Utxo[]>;
+/**
+ *
+ * @param hinkal instance of the hinkal class
+ * @param erc20TokenAddress erc20 token address
+ * @param minInput min number of input UTXOs
+ * @param sliceIfMore6 max upper bound on input UTXOs controller
+ * @returns UTXOs for particular erc20 token address
+ */
+export declare const getInputUtxoAndBalance: ({ hinkal, chainId, passedShieldedPublicKey, ethAddress, resetCacheBefore, allowRemoteDecryption, useBlockedUtxos, }: IGetInputUtxos) => Promise<{
+    inputUtxos: Utxo[];
+}>;
+export declare const getInputUtxoAndBalanceOfStuckUtxos: ({ hinkal, chainId, passedShieldedPublicKey, ethAddress, resetCacheBefore, allowRemoteDecryption, }: IGetInputUtxos) => Promise<{
+    inputUtxos: Utxo[];
+}>;
+export declare const getInputUtxoAndBalancePerToken: ({ hinkal, tokenWithId, minInput, sliceIfMore6, chainId, passedShieldedPrivateKey, passedShieldedPublicKey, ethAddress, resetCacheBefore, ensuredTokensWithId, allowRemoteDecryption, useBlockedUtxos, }: IGetInputUtxos) => Promise<Map<string, Utxo[]>>;
+export {};

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

@@ -0,0 +1,111 @@
+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 libs/shared/common/src/functions/web3/events/getInputUtxoAndBalance.ts
+var h = new m(), g = async (e, t, n, r, a, o, c, l, u) => h.runExclusive(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);
+}), _ = 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;
+}, v = async (e, t, n, r, i, a, o, s, c) => {
+	try {
+		return await _(e, t, n, i);
+	} catch {
+		return g(e, t, n, r, i, a, o, s, c);
+	}
+}, y = (e) => {
+	if (Array.isArray(e)) return e;
+	if (e !== void 0) return [e];
+}, b = async (e, t, n) => await e.utxoUtils.batchFilterUtxosWithNullifier(t, n), x = (e, t, n, i, a, o, s) => {
+	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: a,
+		mintAddress: s,
+		shieldedPrivateKey: i,
+		tokenId: o
+	})), n) for (; e.length > 6;) e.splice(e.length - 1);
+}, S = 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: _, lastOutput: y } = a(e, t, d);
+	await i(e, u);
+	let x = y !== "", S = h.findIndex((e) => e.value === y), C = S > -1, w = !x && S === -1, T = e.areMerkleTreeUpdatesDisabled(), E = !T && (C || !c && w), D = !T && c && w, O = !E && !D, k = [];
+	E ? k = await g(e, f, t, u, d, h, _, y, S) : D ? k = await v(e, f, t, u, d, h, _, y, S) : O && (k = await e.utxoUtils.buildBatchProcess(_, f, t)), await i(e, u);
+	let A = await b(e, k, m);
+	return { inputUtxos: l ? A.filter((e) => e.isBlocked) : A.filter((e) => !e.isBlocked) };
+}, C = 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 S({
+		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) };
+}, w = 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(), { inputUtxos: _ } = h ? await C({
+		hinkal: t,
+		chainId: o,
+		ethAddress: d,
+		passedShieldedPrivateKey: s,
+		resetCacheBefore: f,
+		allowRemoteDecryption: m
+	}) : await S({
+		hinkal: t,
+		tokenWithId: r,
+		minInput: i,
+		sliceIfMore6: a,
+		chainId: o,
+		passedShieldedPrivateKey: s,
+		passedShieldedPublicKey: u,
+		ethAddress: d,
+		resetCacheBefore: f,
+		allowRemoteDecryption: m
+	}), v = y(r), b = /* @__PURE__ */ new Map();
+	_.forEach((e) => {
+		let t = e.getTokenAddress(o);
+		if (v && !v.some((r) => n(r.erc20TokenAddress, t) && r.tokenId === e.tokenId)) return;
+		let r = c(o, {
+			erc20TokenAddress: t,
+			tokenId: e.tokenId
+		}), i = b.get(r) ?? [];
+		b.set(r, [...i, e]);
+	}), p?.forEach((e) => {
+		let t = c(o, {
+			erc20TokenAddress: e.erc20TokenAddress,
+			tokenId: e.tokenId
+		});
+		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;
+		x(n, i, a, g, c ? l(r).compressedAddress.toLowerCase() : r.toLowerCase(), s, u);
+	}
+	return b;
+};
+//#endregion
+export { v as attemptGetInputUtxosRemotely, S as getInputUtxoAndBalance, C as getInputUtxoAndBalanceOfStuckUtxos, w as getInputUtxoAndBalancePerToken, _ 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`);let a=require(`ethers`),o=require(`@solana/web3.js`);var s=e=>{if(!e)return;let t=a.ethers.getBytes(e);if(t.length!==32)return;let n=new o.PublicKey(t),r=n.toBase58(),{compressedAddress:s}=i.formatMintAddress(n);return{mintBase58:r,compressedAddress:s}},c=async(i,o,c)=>{let l=c.getShieldedPrivateKey(),{privateKey:u,publicKey:d}=t.UserKeys.getEncryptionKeyPair(l),f=a.ethers.solidityPacked([`uint256`,`uint256`,`uint256`],[d,u,l]),{keyCiphertext:p,inputCiphertext:m}=await r.makeEnclaveHandshakeAndEncryptUint8Array(a.ethers.getBytes(f)),{utxos:h,lastOutput:g,encryptedOutputs:_}=await i.getAPI().decryptUtxoEnclaveCall(o,p,m);return{utxos:h.map(t=>{let r=t;if(e.isSolanaLike(o)){let e=s(t.mintAddress);if(!e)throw Error(`Invalid mint address`);r={...r,erc20TokenAddress:e.compressedAddress,mintAddress:e.mintBase58}}return new n.Utxo({...r,amount:BigInt(r.amount),randomization:r.randomization?BigInt(r.randomization):void 0,shieldedPrivateKey:l})}),encryptedOutputs:_,lastOutput:g}};exports.getInputUtxosEnclave=c;

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

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

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

@@ -0,0 +1,52 @@
+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 { ethers as a } from "ethers";
+import { PublicKey as o } from "@solana/web3.js";
+//#region libs/shared/common/src/functions/web3/events/getInputUtxosEnclave.ts
+var s = (e) => {
+	if (!e) return;
+	let t = a.getBytes(e);
+	if (t.length !== 32) return;
+	let n = new o(t), r = n.toBase58(), { compressedAddress: s } = i(n);
+	return {
+		mintBase58: r,
+		compressedAddress: s
+	};
+}, c = async (i, o, c) => {
+	let l = c.getShieldedPrivateKey(), { privateKey: u, publicKey: d } = t.getEncryptionKeyPair(l), f = a.solidityPacked([
+		"uint256",
+		"uint256",
+		"uint256"
+	], [
+		d,
+		u,
+		l
+	]), { keyCiphertext: p, inputCiphertext: m } = await r(a.getBytes(f)), { utxos: h, lastOutput: g, encryptedOutputs: _ } = await i.getAPI().decryptUtxoEnclaveCall(o, p, m);
+	return {
+		utxos: h.map((t) => {
+			let r = t;
+			if (e(o)) {
+				let e = s(t.mintAddress);
+				if (!e) throw Error("Invalid mint address");
+				r = {
+					...r,
+					erc20TokenAddress: e.compressedAddress,
+					mintAddress: e.mintBase58
+				};
+			}
+			return new n({
+				...r,
+				amount: BigInt(r.amount),
+				randomization: r.randomization ? BigInt(r.randomization) : void 0,
+				shieldedPrivateKey: l
+			});
+		}),
+		encryptedOutputs: _,
+		lastOutput: g
+	};
+};
+//#endregion
+export { c as getInputUtxosEnclave };

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

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

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

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

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

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

@@ -0,0 +1,4 @@
+import "./getInputUtxoAndBalance.mjs";
+import "./getShieldedBalance.mjs";
+import "./balanceChangedHandler.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 libs/shared/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/accessTokenCalls.cjs

@@ -0,0 +1 @@
+require(`../../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../../constants/chains.constants.cjs`),t=require(`../../../types/ethereum-network.types.cjs`),n=require(`../../pre-transaction/solana.cjs`);require(`../../../types/index.cjs`);let r=require(`@solana/web3.js`);var i=async(e,n,r)=>{let i=r??e.userKeys.getAccessKey();return(await e.getContractWithFetcher(n,t.ContractType.AccessTokenContract).hasToken(i))[0]},a=async(t,i,a)=>{let o=a??t.userKeys.getAccessKey(),{hinkalIdl:s,originalDeployer:c}=e.networkRegistry[i].contractData;if(!s||!c)throw Error(`missing hinkal data`);let l=new r.PublicKey(c),u=t.getSolanaProgram(s),d=n.getAccessTokenAccountPublicKey(BigInt(o),u.programId,l);if(!await u.provider.connection.getAccountInfo(d))return!1;let{isAdded:f}=await u.account.accesskeyAccount.fetch(d);return f},o=async(t,n,r)=>e.isTronLike(n)?!0:e.isSolanaLike(n)?a(t,n,r):i(t,n,r);exports.checkHinkalAccessToken=o;

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

@@ -0,0 +1,2 @@
+import { IHinkal } from '../../../data-structures/Hinkal/IHinkal';
+export declare const checkHinkalAccessToken: (hinkal: IHinkal, chainId: number, accessKeyOverride?: string) => Promise<any>;

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

@@ -0,0 +1,19 @@
+import { isSolanaLike as e, isTronLike as t, networkRegistry as n } from "../../../constants/chains.constants.mjs";
+import { ContractType as r } from "../../../types/ethereum-network.types.mjs";
+import { getAccessTokenAccountPublicKey as i } from "../../pre-transaction/solana.mjs";
+import "../../../types/index.mjs";
+import { PublicKey as a } from "@solana/web3.js";
+//#region libs/shared/common/src/functions/web3/functionCalls/accessTokenCalls.ts
+var o = async (e, t, n) => {
+	let i = n ?? e.userKeys.getAccessKey();
+	return (await e.getContractWithFetcher(t, r.AccessTokenContract).hasToken(i))[0];
+}, s = async (e, t, r) => {
+	let o = r ?? e.userKeys.getAccessKey(), { hinkalIdl: s, originalDeployer: c } = n[t].contractData;
+	if (!s || !c) throw Error("missing hinkal data");
+	let l = new a(c), u = e.getSolanaProgram(s), d = i(BigInt(o), u.programId, l);
+	if (!await u.provider.connection.getAccountInfo(d)) return !1;
+	let { isAdded: f } = await u.account.accesskeyAccount.fetch(d);
+	return f;
+}, c = async (n, r, i) => t(r) ? !0 : e(r) ? s(n, r, i) : o(n, r, i);
+//#endregion
+export { c as checkHinkalAccessToken };

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>;