@kapa123456789/sdk 0.0.39 → 0.0.40

package/common/src/functions/utils/tron.utils.mjs

@@ -0,0 +1,149 @@
+import { chainIds as e, networkRegistry as t } from "../../constants/chains.constants.mjs";
+import { TRON_DEFAULT_FEE_LIMIT_SUN as n } from "../../constants/protocol.constants.mjs";
+import { ENCLAVE_URL as r } from "../snarkjs/constant.mjs";
+import { httpClient as i } from "../../data-structures/http/HttpClient.mjs";
+import { ethers as a } from "ethers";
+import { TronWeb as o } from "tronweb";
+//#region libs/shared/common/src/functions/utils/tron.utils.ts
+var s = 1000n, c = (e, n) => {
+	let r = t[e].fetchRpcUrl, i = n ? new o({
+		fullHost: r,
+		privateKey: n
+	}) : new o({ fullHost: r });
+	return n || i.setAddress("T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb"), i;
+}, l = (e) => e?.startsWith("T") ? e : o.address.fromHex(e), u = (e) => {
+	if (e.startsWith("0x")) return e;
+	if (e.startsWith("41")) return e.replace("41", "0x");
+	if (e.startsWith("T")) return u(o.address.toHex(e));
+	throw Error("Failed to convert address to hex format");
+}, d = (t) => {
+	if (t === e.tronNile) return "https://nile.trongrid.io";
+	if (t === e.tronMainnet) return "https://api.trongrid.io";
+	throw Error(`Unsupported Tron chain for wallet RPC: ${t}`);
+}, f = (e, t) => e.map((e) => Array.isArray(e) ? f(e, t) : t(e)), p = (e, t, n) => {
+	let r = new a.Interface(e);
+	if (!r.getFunction(t)) throw Error(`${t} ABI is missing for Tron call data creation`);
+	let i = f(n, (e) => typeof e == "string" && e.startsWith("T") ? u(e) : e);
+	return r.encodeFunctionData(t, i);
+}, m = (e, t, n) => e ? BigInt(Math.max((e[t] ?? 0) - (e[n] ?? 0), 0)) : 0n, h = (e, t) => {
+	let n = e.find((e) => e.key === t);
+	if (!n || typeof n.value != "number") throw Error(`Missing Tron chain parameter: ${t}`);
+	return BigInt(n.value);
+}, g = async (e) => {
+	let t = `${d(e)}/wallet/getchainparameters`, n = await i.post(t, {});
+	if (!n?.chainParameter?.length) throw Error("Failed to fetch Tron chain parameters from wallet RPC");
+	return n.chainParameter;
+}, _ = async (e, t) => {
+	let n = `${d(e)}/wallet/getaccountresource`, r = u(t), a = r.startsWith("0x") ? `41${r.slice(2)}` : r;
+	return await i.post(n, {
+		address: a,
+		visible: !1
+	});
+}, v = async (e, t, r, i, a, o) => {
+	let c = {
+		input: a,
+		callValue: Number(o),
+		feeLimit: n
+	}, [l, u] = await Promise.all([e.transactionBuilder.estimateEnergy(r, "", c, [], i), e.transactionBuilder.triggerConstantContract(r, "", c, [], i)]), d = await g(t), f = h(d, "getEnergyFee"), p = h(d, "getTransactionFee"), v = await _(t, i), y = BigInt(l?.energy_required ?? u?.energy_used ?? 0), b = m(v, "EnergyLimit", "EnergyUsed"), x = (y > b ? y - b : 0n) * f, S = BigInt(Math.ceil((u?.transaction?.raw_data_hex?.length ?? 0) / 2)), C = m(v, "freeNetLimit", "freeNetUsed") + m(v, "NetLimit", "NetUsed"), w = x + (S > C ? S - C : 0n) * p, T = w + w * s / 10000n;
+	return T > BigInt(1e9) ? BigInt(n) : T;
+}, y = (e) => {
+	let t = e[0].map(BigInt), n = e[1][0].map(BigInt), r = e[1][1].map(BigInt), i = e[2].map(BigInt), a = e[3].map(BigInt);
+	return {
+		a: t,
+		b: [[n[1], n[0]], [r[1], r[0]]],
+		c: i,
+		publicSignals: a
+	};
+}, b = (e, t) => {
+	let n = a.AbiCoder.defaultAbiCoder().encode([
+		"uint16",
+		"uint16",
+		"uint16",
+		"uint256"
+	], [
+		e.tokenNumber,
+		e.nullifierAmount,
+		e.outputAmount,
+		t
+	]);
+	return BigInt(a.keccak256(n));
+}, x = async (e, t, n, o, s, c) => {
+	let l = b(s, c), u = e.map(String), d = n.map(String), f = o.map(String), p = {
+		a: u,
+		b: [t[0].map(String), t[1].map(String)],
+		c: d,
+		inputs: f,
+		verifier_id: String(l)
+	}, m = await i.post(`${r}/sign-proof`, p), { v: h, r: g, s: _ } = a.Signature.from(m.signature.trim());
+	return {
+		v: h,
+		r: g,
+		s: _
+	};
+}, S = (e) => [
+	e.rootHashHinkal,
+	e.erc20TokenAddresses,
+	e.tokenIds,
+	e.amountChanges,
+	e.onChainCreation,
+	e.slippageValues,
+	e.inputNullifiers,
+	e.outCommitments,
+	e.encryptedOutputs,
+	[
+		e.feeStructure.feeToken,
+		e.feeStructure.flatFee,
+		e.feeStructure.variableRate
+	],
+	e.timeStamp,
+	[
+		e.stealthAddressStructure.extraRandomization,
+		e.stealthAddressStructure.stealthAddress,
+		e.stealthAddressStructure.H0,
+		e.stealthAddressStructure.H1
+	],
+	e.rootHashAccessToken,
+	e.calldataHash,
+	e.publicSignalCount,
+	e.relay,
+	e.externalAddress,
+	e.externalActionId,
+	e.externalActionMetadata,
+	[
+		e.hinkalLogicArgs.hinkalLogicAction,
+		e.hinkalLogicArgs.inHinkalAddress,
+		e.hinkalLogicArgs.executeApprovalChanges,
+		e.hinkalLogicArgs.doPreTxApproval,
+		e.hinkalLogicArgs.useApprovalUtxoData.map((e) => [
+			e.approvalChanges,
+			e.externalApprovalAddresses,
+			e.conversionInHinkalAddress
+		])
+	],
+	[
+		e.hookData.preHookContract,
+		e.hookData.hookContract,
+		e.hookData.preHookMetadata,
+		e.hookData.postHookMetadata
+	],
+	[
+		e.signatureData.v,
+		e.signatureData.r,
+		e.signatureData.s,
+		e.signatureData.accessKey,
+		e.signatureData.nonce,
+		e.signatureData.ethereumAddress
+	],
+	e.originalSender
+], C = async (e, t, n, r, i = !0) => {
+	if (e) {
+		let { a: e, b: a, c: o, publicSignals: s } = y(t), c = await x(e, a, o, s, n, BigInt(r.externalActionId)), l = {
+			v: c.v,
+			r: c.r,
+			s: c.s
+		};
+		return i && (t[1] = [[t[1][0][1], t[1][0][0]], [t[1][1][1], t[1][1][0]]]), l;
+	}
+};
+//#endregion
+export { u as addressToHexFormat, S as circomDataToArray, p as createTronCallData, c as createTronWeb, v as estimateTronFeeSunWithPadding, l as evmHexToTronBase58Address, y as parseZkCalldata, C as reorderZkCallData };

package/common/src/functions/utils/tronSimulation.utils.cjs

@@ -0,0 +1 @@
+const e=require(`../../constants/chains.constants.cjs`),t=require(`../../data-structures/http/HttpClient.cjs`),n=require(`./tron.utils.cjs`);var r=async(r,i,a,o,s,c,l)=>{let u=n.addressToHexFormat(i),d=n.addressToHexFormat(c),f=e.networkRegistry[r].fetchRpcUrl;if(!f)throw Error(`missing rpc url for tron simulation`);let p=n.createTronCallData(o,a,s),m=await t.httpClient.post(f,{jsonrpc:`2.0`,id:1,method:`eth_call`,params:[{from:d,to:u,data:p,value:l?`0x${(l??0n).toString(16)}`:void 0},`latest`]});if(m.error){let e=m.error.message||`Unknown revert`;throw Error(`Tron Transaction Simulation reverted: ${e}`)}};exports.simulateTronTransaction=r;

package/common/src/functions/utils/tronSimulation.utils.d.ts

@@ -0,0 +1 @@
+export declare const simulateTronTransaction: (chainId: number, contractAddress: string, functionName: string, abi: any, args: unknown[], from: string, value?: bigint) => Promise<void>;

package/common/src/functions/utils/tronSimulation.utils.mjs

@@ -0,0 +1,25 @@
+import { networkRegistry as e } from "../../constants/chains.constants.mjs";
+import { httpClient as t } from "../../data-structures/http/HttpClient.mjs";
+import { addressToHexFormat as n, createTronCallData as r } from "./tron.utils.mjs";
+//#region libs/shared/common/src/functions/utils/tronSimulation.utils.ts
+var i = async (i, a, o, s, c, l, u) => {
+	let d = n(a), f = n(l), p = e[i].fetchRpcUrl;
+	if (!p) throw Error("missing rpc url for tron simulation");
+	let m = r(s, o, c), h = await t.post(p, {
+		jsonrpc: "2.0",
+		id: 1,
+		method: "eth_call",
+		params: [{
+			from: f,
+			to: d,
+			data: m,
+			value: u ? `0x${(u ?? 0n).toString(16)}` : void 0
+		}, "latest"]
+	});
+	if (h.error) {
+		let e = h.error.message || "Unknown revert";
+		throw Error(`Tron Transaction Simulation reverted: ${e}`);
+	}
+};
+//#endregion
+export { i as simulateTronTransaction };

package/common/src/functions/utils/tx-confirmation.utils.cjs

@@ -0,0 +1 @@
+const e=require(`../../constants/chains.constants.cjs`),t=require(`../../error-handling/error-codes.constants.cjs`),n=require(`../../error-handling/logger.cjs`),r=require(`./create-provider.cjs`),i=require(`../../constants/tx-confirmation.constants.cjs`);var a=`confirmed`,o=async(e,n,a={})=>{let{evmConfirmations:o=1,evmTimeoutMs:s=i.TX_CONFIRMATION_TIMEOUT_EXTENDED}=a,c=n.startsWith(`0x`)?n:`0x${n}`,l=await r.createJsonRpcProvider(e).waitForTransaction(c,o,s);if(!l||l.status!==1)throw Error(t.transactionErrorCodes.TRANSACTION_NOT_CONFIRMED);return l},s=async(t,n,i={})=>{let{solanaCommitment:o=a}=i,{fetchRpcUrl:s}=e.networkRegistry[t];if(!s)throw Error(`RPC URL not found for the specified chain ID`);let c=await r.createCustomSolanaConnection(s,o).confirmTransaction(n,o);if(c.value.err)throw Error(`Transaction failed`);return c},c=async(t,r,i={})=>{try{if(e.isSolanaLike(t)){await s(t,r,i);return}await o(t,r.startsWith(`0x`)?r:`0x${r}`,i)}catch(e){throw n.Logger.error(`waitForTransactionConfirmation failed`,{chainId:t,txHash:r,error:e}),e}};exports.waitForEthereumTransactionConfirmation=o,exports.waitForTransactionConfirmation=c;

package/common/src/functions/utils/tx-confirmation.utils.d.ts

@@ -0,0 +1,10 @@
+import { Commitment } from '@solana/web3.js';
+type TxConfirmationOptions = {
+    evmConfirmations?: number;
+    evmTimeoutMs?: number;
+    solanaCommitment?: Commitment;
+};
+export declare const waitForEthereumTransactionConfirmation: (chainId: number, txHash: string, opts?: TxConfirmationOptions) => Promise<import('ethers').TransactionReceipt>;
+export declare const waitForSolanaTransactionConfirmation: (chainId: number, txHash: string, opts?: TxConfirmationOptions) => Promise<import('@solana/web3.js').RpcResponseAndContext<import('@solana/web3.js').SignatureResult>>;
+export declare const waitForTransactionConfirmation: (chainId: number, txHash: string, opts?: TxConfirmationOptions) => Promise<void>;
+export {};

package/common/src/functions/utils/tx-confirmation.utils.mjs

@@ -0,0 +1,33 @@
+import { isSolanaLike as e, networkRegistry as t } from "../../constants/chains.constants.mjs";
+import { transactionErrorCodes as n } from "../../error-handling/error-codes.constants.mjs";
+import { Logger as r } from "../../error-handling/logger.mjs";
+import { createCustomSolanaConnection as i, createJsonRpcProvider as a } from "./create-provider.mjs";
+import { TX_CONFIRMATION_TIMEOUT_EXTENDED as o } from "../../constants/tx-confirmation.constants.mjs";
+//#region libs/shared/common/src/functions/utils/tx-confirmation.utils.ts
+var s = "confirmed", c = async (e, t, r = {}) => {
+	let { evmConfirmations: i = 1, evmTimeoutMs: s = o } = r, c = t.startsWith("0x") ? t : `0x${t}`, l = await a(e).waitForTransaction(c, i, s);
+	if (!l || l.status !== 1) throw Error(n.TRANSACTION_NOT_CONFIRMED);
+	return l;
+}, l = async (e, n, r = {}) => {
+	let { solanaCommitment: a = s } = r, { fetchRpcUrl: o } = t[e];
+	if (!o) throw Error("RPC URL not found for the specified chain ID");
+	let c = await i(o, a).confirmTransaction(n, a);
+	if (c.value.err) throw Error("Transaction failed");
+	return c;
+}, u = async (t, n, i = {}) => {
+	try {
+		if (e(t)) {
+			await l(t, n, i);
+			return;
+		}
+		await c(t, n.startsWith("0x") ? n : `0x${n}`, i);
+	} catch (e) {
+		throw r.error("waitForTransactionConfirmation failed", {
+			chainId: t,
+			txHash: n,
+			error: e
+		}), e;
+	}
+};
+//#endregion
+export { c as waitForEthereumTransactionConfirmation, u as waitForTransactionConfirmation };

package/common/src/functions/utils/upToDateState.cjs

@@ -0,0 +1 @@
+const e=require(`../../error-handling/error-codes.constants.cjs`),t=require(`./caseInsensitive.utils.cjs`);var n=async(n,r)=>{if(!t.caseInsensitiveEqual(await n.getEthereumAddress(),r))throw Error(e.transactionErrorCodes.ERROR_MESSAGE_CHAIN_ADDRESS_CHANGED);return!0};exports.checkAddressNotUpdated=n;

package/common/src/functions/utils/upToDateState.d.ts

@@ -0,0 +1,2 @@
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+export declare const checkAddressNotUpdated: (hinkal: IHinkal, oldEthAddress: string) => Promise<boolean>;

package/common/src/functions/utils/upToDateState.mjs

@@ -0,0 +1,9 @@
+import { transactionErrorCodes as e } from "../../error-handling/error-codes.constants.mjs";
+import { caseInsensitiveEqual as t } from "./caseInsensitive.utils.mjs";
+//#region libs/shared/common/src/functions/utils/upToDateState.ts
+var n = async (n, r) => {
+	if (!t(await n.getEthereumAddress(), r)) throw Error(e.ERROR_MESSAGE_CHAIN_ADDRESS_CHANGED);
+	return !0;
+};
+//#endregion
+export { n as checkAddressNotUpdated };

package/common/src/functions/utils/userAgent.d.ts

@@ -0,0 +1 @@
+export declare const browserSupported: () => boolean;

package/common/src/functions/utils/validateUsername.d.ts

@@ -0,0 +1,5 @@
+export interface UsernameValidationResult {
+    isValid: boolean;
+    message: string | null;
+}
+export declare const validateUsername: (username: string, isAvailable: boolean) => UsernameValidationResult;

package/common/src/functions/utils/walletBalances.utils.d.ts

@@ -0,0 +1,2 @@
+import { ERC20Token } from '../../types/token.types';
+export declare const hasEnoughBalance: (tokenAmount: string, maxPossibleAmount: string, token: ERC20Token | undefined, isDollarMode: boolean, tokenPriceDollar: number | undefined) => boolean;

package/common/src/functions/web3/EIP-712.d.ts

@@ -0,0 +1,23 @@
+import { ethers } from 'ethers';
+import { DecodedTypedMessageValue } from '../../types/message.types';
+export declare const decodeMessage: (message: Record<string, any>, typeDefinition: ethers.TypedDataField[], types: Record<string, ethers.TypedDataField[]>) => Record<string, DecodedTypedMessageValue>;
+export declare const getDecodedMessage: (message: Record<string, any>, types: Record<string, ethers.TypedDataField[]>, primaryType: string) => {
+    primaryType: {
+        value: string;
+        type: string;
+    };
+};
+type TokenDetail = {
+    token: string;
+    amount: string;
+};
+export declare const getPermitInfo: (message: Record<string, any>, types: Record<string, ethers.TypedDataField[]>, domain: Record<string, unknown>, primaryType: string) => {
+    isPermit: boolean;
+    tokenDetails?: undefined;
+    spender?: undefined;
+} | {
+    isPermit: true;
+    tokenDetails: TokenDetail[];
+    spender: string | undefined;
+};
+export {};

package/common/src/functions/web3/connectors.utils.d.ts

@@ -0,0 +1,7 @@
+import { Connector } from 'wagmi';
+import { WalletGroup } from '../connectors.types';
+export declare const isInjectedConnector: (c: Connector) => boolean;
+export declare const isMockConnector: (c: Connector) => boolean;
+export declare const isSolanaConnector: (c: Connector) => boolean;
+export declare const isTronConnector: (c: Connector) => boolean;
+export declare const groupConnectorsByWallet: (connectors: Connector[]) => WalletGroup[];

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

@@ -0,0 +1 @@
+export declare const hmacSha512: (key: string | Uint8Array, data: Uint8Array) => Promise<Uint8Array>;

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

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../error-handling/error-codes.constants.cjs`);let t=require(`ethers`);var n=e=>BigInt(t.ethers.hexlify(t.ethers.randomBytes(e))),r=(e,n)=>t.ethers.formatUnits(n,e.decimals),i=(n,r)=>{let i=10**(18-n.decimals);try{return t.ethers.parseUnits(r)/BigInt(i)}catch{throw Error(e.transactionErrorCodes.DECIMALS_LIMIT)}},a=(n,r,i)=>{let a=t.ethers.formatUnits(n,r.decimals),o=BigInt(10**(18-i));try{let e=t.ethers.parseUnits(a)/o;return t.ethers.formatUnits(e,i)}catch{throw Error(e.transactionErrorCodes.DECIMALS_LIMIT)}};exports.getAmountInToken=r,exports.getAmountInWei=i,exports.getAmountWithPrecision=a,exports.randomBigInt=n;

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`);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,20 @@
+import { EventType as e } from "../../../types/hinkal.types.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.getInputUtxoAndBalance=v,exports.getInputUtxoAndBalanceOfStuckUtxos=y,exports.getInputUtxoAndBalancePerToken=b;

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 { S as getInputUtxoAndBalance, C as getInputUtxoAndBalanceOfStuckUtxos, w as getInputUtxoAndBalancePerToken };

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`),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[][]>;