@gurge/sdk 0.2.32

package/functions/utils/transfer-claimable.utils.mjs

@@ -0,0 +1,93 @@
+import { isSolanaLike as e, networkRegistry as t } from "../../constants/chains.constants.mjs";
+import { RELAYER_TX_CONFIRMATION_TIMEOUT as n } from "../../constants/tx-confirmation.constants.mjs";
+import "../../constants/index.mjs";
+import { UserKeys as r } from "../../data-structures/crypto-keys/keys.mjs";
+import { waitLittle as i } from "./time.utils.mjs";
+import "../../data-structures/crypto-keys/index.mjs";
+import { ErrorWithIndex as a } from "../../error-handling/customErrors/ErrorWithIndex.mjs";
+import { formatMintAddress as o } from "./solanaMint.utils.mjs";
+import { Logger as s } from "../../error-handling/logger.mjs";
+import { validateAndGetChainId as c } from "./token-check.utils.mjs";
+import { getErrorMessage as l } from "../../error-handling/get-error.message.mjs";
+import "../../error-handling/index.mjs";
+import { fetchSolanaTransaction as u } from "../pre-transaction/sendV0Transaction.mjs";
+import "../pre-transaction/index.mjs";
+import { getRecipientInfoFromUserKeys as d } from "./getRecipientInfoFromUserKeys.mjs";
+import { getUtxosFromReceipt as f } from "./getUtxosFromReceipt.utils.mjs";
+import { getUtxosFromReceiptSolana as p } from "./getUtxosFromReceiptSolana.mjs";
+import { waitForEthereumTransactionConfirmation as m, waitForTransactionConfirmation as h } from "./tx-confirmation.utils.mjs";
+//#region libs/shared/common/src/functions/utils/transfer-claimable.utils.ts
+var g = async (e, n, r, i, a, s, c) => {
+	let { hinkalIdl: l } = t[e].contractData;
+	if (!l) throw Error("No IDL configured for Solana program on this network");
+	let d = r.getSolanaProgram(l);
+	await d.provider.connection.confirmTransaction(n, "finalized");
+	let f = await u(d.provider.connection, n, "finalized");
+	if (!f) throw Error(`Could not fetch Solana transaction for signature ${n}`);
+	let { compressedAddress: m } = o(c), h = p(f, d, i, m)[0];
+	if (!h) throw Error("Could not find recipient UTXO in Solana tx for claimable transfer");
+	return {
+		chainId: e,
+		senderAddress: s,
+		recipientAddress: a.recipientAddress,
+		utxo: h
+	};
+}, _ = async (e, t, r, i, a, o, s) => {
+	let c = f(await m(e, t, { evmTimeoutMs: n }), r, e, s, i)[0];
+	if (!c) throw Error("Could not find recipient UTXO in EVM txHash for claimable transfer");
+	return {
+		chainId: e,
+		senderAddress: o,
+		recipientAddress: a.recipientAddress,
+		utxo: c
+	};
+}, v = (e, t, n, i, a) => {
+	if (e.recipientInfo) return { recipientInfo: e.recipientInfo };
+	let o = t - n, s = i + BigInt(o), c = a.userKeys.getClaimableSignatureFromNonce(s), l = new r(c), u = l.getShieldedPrivateKey();
+	return {
+		recipientInfo: d(l),
+		recipientKeys: l,
+		recipientShieldedPrivateKey: u,
+		claimableSignature: c
+	};
+}, y = async (t, r, o, u, d, f, p, m) => {
+	if (o.length === 0) return {
+		pendingEnclaveUtxos: [],
+		txHashes: [],
+		failedRecipientErrorMessage: void 0
+	};
+	if (o.length !== u.length) throw Error("recipients and allocations length mismatch");
+	let y = c([r]), b = await t.getEthereumAddressByChain(y), x = o.map((e, t) => ({
+		recipient: e,
+		recipientInfo: u[t]?.recipientInfo
+	})), S = x.filter((e) => !!e.recipientInfo), C = x.filter((e) => !e.recipientInfo), w = [], T = [], E, D = [...S, ...C];
+	for (let o = 0; o < D.length; o += 1) try {
+		let a = D[o], s = !!a.recipientInfo, { recipientInfo: c, recipientKeys: l, recipientShieldedPrivateKey: u, claimableSignature: x } = v(a, o, S.length, d, t), C = await t.transfer([r], [-a.recipient.amount], c, f, p, m);
+		if (T.push(C), s) await h(r.chainId, C, {
+			solanaCommitment: "finalized",
+			evmTimeoutMs: n
+		});
+		else {
+			if (!l || !u) throw Error("Missing recipient keys for fallback claimable transfer");
+			let n = e(y) ? await g(y, C, t, l, a.recipient, b, r.erc20TokenAddress) : await _(y, C, t, u, a.recipient, b, r.erc20TokenAddress);
+			w.push({
+				...n,
+				claimableSignature: x
+			});
+		}
+		o < D.length - 1 && (await i(2e3), await t.resetMerkleTreesIfNecessary([r.chainId]));
+	} catch (e) {
+		s.log("Error in transferClaimableUtxos loop", {
+			error: e,
+			index: o
+		}), E = new a(o, l(e)), T.push("");
+		break;
+	}
+	return {
+		pendingEnclaveUtxos: w,
+		txHashes: T,
+		failedRecipientErrorMessage: E
+	};
+};
+//#endregion
+export { y as transferClaimableUtxos };

package/functions/utils/trimFieldValues.cjs

@@ -0,0 +1 @@
+var e=[{value:1e9,unit:`b`},{value:1e6,unit:`m`},{value:1e3,unit:`k`}],t=(t,n=e,r=!0)=>{n.sort((e,t)=>t.value-e.value);let i=r?`$`:``;if(t<n[n.length-1].value)return`$${t.toFixed(2)}`;for(let e of n)if(t>=e.value)return`${i}${(Math.round(100*t/e.value)/100).toFixed(2)+e.unit}`;return`${i}${t}`};exports.trimFieldValues=t;

package/functions/utils/trimFieldValues.d.ts

@@ -0,0 +1,4 @@
+export declare const trimFieldValues: (value: number, demarcations?: {
+    value: number;
+    unit: string;
+}[], showDollarSign?: boolean) => string;

package/functions/utils/trimFieldValues.mjs

@@ -0,0 +1,23 @@
+//#region libs/shared/common/src/functions/utils/trimFieldValues.ts
+var e = [
+	{
+		value: 1e9,
+		unit: "b"
+	},
+	{
+		value: 1e6,
+		unit: "m"
+	},
+	{
+		value: 1e3,
+		unit: "k"
+	}
+], t = (t, n = e, r = !0) => {
+	n.sort((e, t) => t.value - e.value);
+	let i = r ? "$" : "";
+	if (t < n[n.length - 1].value) return `$${t.toFixed(2)}`;
+	for (let e of n) if (t >= e.value) return `${i}${(Math.round(100 * t / e.value) / 100).toFixed(2) + e.unit}`;
+	return `${i}${t}`;
+};
+//#endregion
+export { t as trimFieldValues };

package/functions/utils/tron.utils.cjs

@@ -0,0 +1 @@
+require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../constants/chains.constants.cjs`),t=require(`../../constants/protocol.constants.cjs`),n=require(`../../data-structures/http/HttpClient.cjs`),r=require(`../snarkjs/constant.cjs`),i=require(`./caseInsensitive.utils.cjs`),a=require(`../../externalABIs/index.cjs`),o=require(`../../error-handling/error-codes.constants.cjs`),s=require(`../../error-handling/logger.cjs`);let c=require(`ethers`),l=require(`tronweb`);var u=[`https://nile.trongrid.io`,`https://api.shasta.trongrid.io`],d=2000n,f=t=>{let n=t.toLowerCase();return u.some(e=>n.includes(e))?e.chainIds.tronNile:e.chainIds.tronMainnet},p=e=>{let t=e.trim(),n=t.startsWith(`0x`)?t.slice(2):t;if(!/^[0-9a-fA-F]{64}$/.test(n))throw Error(`Tron private key must be 32 bytes (64 hex characters), with or without 0x prefix`);return n},m=(t,n)=>{let r=e.networkRegistry[t].fetchRpcUrl,i=n?p(n):void 0,a=i?new l.TronWeb({fullHost:r,privateKey:i}):new l.TronWeb({fullHost:r});return n||a.setAddress(`T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb`),a},h=e=>e?.startsWith(`T`)?e:l.TronWeb.address.fromHex(e),g=e=>{if(e.startsWith(`0x`))return e;if(e.startsWith(`41`))return e.replace(`41`,`0x`);if(e.startsWith(`T`))return g(l.TronWeb.address.toHex(e));throw Error(`Failed to convert address to hex format`)},_=e=>e?.startsWith(`T`)?g(e):e,v=t=>{if(t===e.chainIds.tronNile)return`https://nile.trongrid.io`;if(t===e.chainIds.tronMainnet)return`https://api.trongrid.io`;throw Error(`Unsupported Tron chain for wallet RPC: ${t}`)},y=(e,t)=>e.map(e=>Array.isArray(e)?y(e,t):t(e)),b=(e,t,n)=>{let r=new c.ethers.Interface(e);if(!r.getFunction(t))throw Error(`${t} ABI is missing for Tron call data creation`);let i=y(n,e=>typeof e==`string`&&e.startsWith(`T`)?g(e):e);return r.encodeFunctionData(t,i)},x=(e,t,n)=>e?BigInt(Math.max((e[t]??0)-(e[n]??0),0)):0n,S=(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)},C=async e=>{let t=`${v(e)}/wallet/getchainparameters`,r=await n.httpClient.post(t,{});if(!r?.chainParameter?.length)throw Error(`Failed to fetch Tron chain parameters from wallet RPC`);return r.chainParameter},w=async(e,t)=>{let r=`${v(e)}/wallet/getaccountresource`,i=g(t),a=i.startsWith(`0x`)?`41${i.slice(2)}`:i;return await n.httpClient.post(r,{address:a,visible:!1})},T=async(e,n,r,i,a,o)=>{let s={input:a,callValue:Number(o),feeLimit:t.TRON_DEFAULT_FEE_LIMIT_SUN},[c,l]=await Promise.all([e.transactionBuilder.estimateEnergy(r,``,s,[],i),e.transactionBuilder.triggerConstantContract(r,``,s,[],i)]),u=await C(n),f=S(u,`getEnergyFee`),p=S(u,`getTransactionFee`),m=await w(n,i),h=BigInt(c?.energy_required??l?.energy_used??0),g=x(m,`EnergyLimit`,`EnergyUsed`),_=(h>g?h-g:0n)*f,v=BigInt(Math.ceil((l?.transaction?.raw_data_hex?.length??0)/2)),y=x(m,`freeNetLimit`,`freeNetUsed`)+x(m,`NetLimit`,`NetUsed`),b=_+(v>y?v-y:0n)*p,T=b+b*d/10000n;return T>BigInt(1e9)?BigInt(t.TRON_DEFAULT_FEE_LIMIT_SUN):T},E=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}},D=(e,t)=>{let n=c.ethers.AbiCoder.defaultAbiCoder().encode([`uint16`,`uint16`,`uint16`,`uint256`],[e.tokenNumber,e.nullifierAmount,e.outputAmount,t]);return BigInt(c.ethers.keccak256(n))},O=async(e,t,i,a,o,s)=>{let l=D(o,s),u=e.map(String),d=i.map(String),f=a.map(String),p={a:u,b:[t[0].map(String),t[1].map(String)],c:d,inputs:f,verifier_id:String(l)},m=await n.httpClient.post(`${r.ENCLAVE_URL}/sign-proof`,p),{v:h,r:g,s:_}=c.ethers.Signature.from(m.signature.trim());return{v:h,r:g,s:_}},k=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],A=async(e,t,n,r,i=!0)=>{if(e){let{a:e,b:a,c:o,publicSignals:s}=E(t),c=await O(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}},j=(e,n)=>{let r=0n,a=new Map;for(let o=0;o<e.length;o+=1)if(i.caseInsensitiveEqual(e[o].erc20TokenAddress,t.zeroAddress))r+=n[o];else{let t=h(e[o].erc20TokenAddress);a.set(t,(a.get(t)??0n)+n[o])}return{totalTrxValue:r,tokensNeedingApproval:a}},M=async(e,n,r,i,a,c)=>{let l=BigInt(await e.trx.getBalance(i)),u=BigInt(t.TRON_DEFAULT_FEE_LIMIT_SUN);try{u=await T(e,n,r,i,a,c)}catch(e){s.Logger.error(`Error estimating Tron deposit fee`,e)}if(l<c+u)throw Error(o.insufficientResourcesErrorCodes.INSUFFICIENT_TRON_BALANCE_FOR_FEE)},N=async(e,n,r,i)=>{let o=Array.from(i.entries());for(let i=0;i<o.length;i+=1){let[s,c]=o[i],l=await e.contract(a.ERC20ABI,s).allowance(n,r).call({from:n});if(BigInt(String(l))<c){let{transaction:i}=await e.transactionBuilder.triggerSmartContract(s,`approve(address,uint256)`,{feeLimit:t.TRON_DEFAULT_FEE_LIMIT_SUN},[{type:`address`,value:r},{type:`uint256`,value:c.toString()}],n),a=await e.trx.sign(i),o=await e.trx.sendRawTransaction(a);if(!o.result){let e=o.code??`UNKNOWN`,t=o.message?Buffer.from(o.message,`hex`).toString():`no message`;throw Error(`Tron token approval failed: ${e} - ${t}`)}}}};exports.addressToHexFormat=g,exports.approveTronTokens=N,exports.assertTronSufficientBalance=M,exports.circomDataToArray=k,exports.createTronCallData=b,exports.createTronWeb=m,exports.detectTronChainIdFromHost=f,exports.estimateTronFeeSunWithPadding=T,exports.evmHexToTronBase58Address=h,exports.fetchTronAccountResources=w,exports.fetchTronChainParameters=C,exports.generateProofSignatureRemotely=O,exports.getAvailableResource=x,exports.getChainParameterValue=S,exports.getVerifierId=D,exports.normalizeTronAddr=_,exports.normalizeTronPrivateKey=p,exports.parseZkCalldata=E,exports.reorderZkCallData=A,exports.splitTronTokensByNative=j;

package/functions/utils/tron.utils.d.ts

@@ -0,0 +1,42 @@
+import { ethers } from 'ethers';
+import { CircomDataType, DimDataType } from '../../types/circom-data.types';
+import { NewZkCallDataType } from '../../types/snark.types';
+import { TronAccountResources, TronChainParameter } from '../../types/tron.types';
+import { TronWeb } from 'tronweb';
+import { ERC20Token } from '../../types/token.types';
+export declare const detectTronChainIdFromHost: (fullNodeHost: string) => number;
+export declare const normalizeTronPrivateKey: (privateKey: string) => string;
+export declare const createTronWeb: (chainId: number, privateKey?: string) => TronWeb;
+export declare const evmHexToTronBase58Address: (addr: string) => string;
+export declare const addressToHexFormat: (addr: string) => string;
+export declare const normalizeTronAddr: (addr: string) => string;
+export declare const createTronCallData: (abi: ethers.InterfaceAbi, functionName: string, args: unknown[]) => string;
+export declare const getAvailableResource: (resources: TronAccountResources | undefined, limitKey: string, usedKey: string) => bigint;
+export declare const getChainParameterValue: (params: TronChainParameter[], key: string) => bigint;
+export declare const fetchTronChainParameters: (chainId: number) => Promise<TronChainParameter[]>;
+export declare const fetchTronAccountResources: (chainId: number, ownerAddress: string) => Promise<TronAccountResources>;
+export declare const estimateTronFeeSunWithPadding: (tronWeb: TronWeb, chainId: number, contractAddress: string, ownerAddress: string, callData: string, callValueSun: bigint) => Promise<bigint>;
+export declare const parseZkCalldata: (zkCallData: NewZkCallDataType) => {
+    a: bigint[];
+    b: bigint[][];
+    c: bigint[];
+    publicSignals: bigint[];
+};
+export declare const getVerifierId: (dimensionsArg: DimDataType, externalActionId: bigint) => bigint;
+export declare const generateProofSignatureRemotely: (a: bigint[], b: bigint[][], c: bigint[], input: bigint[], dimensionsArg: DimDataType, externalActionId: bigint) => Promise<{
+    v: number;
+    r: string;
+    s: string;
+}>;
+export declare const circomDataToArray: (circomData: CircomDataType) => (string | number | bigint | (string | number)[] | string[][] | (string | bigint)[] | (bigint | boolean | import('../..').HinkalLogicAction | bigint[] | (string[] | bigint[])[][])[] | undefined)[];
+export declare const reorderZkCallData: (isTron: boolean, zkCallData: NewZkCallDataType, dimData: DimDataType, circomData: CircomDataType, modifyZkCallData?: boolean) => Promise<{
+    v: number;
+    r: string;
+    s: string;
+} | undefined>;
+export declare const splitTronTokensByNative: (erc20Tokens: ERC20Token[], amountChanges: bigint[]) => {
+    totalTrxValue: bigint;
+    tokensNeedingApproval: Map<string, bigint>;
+};
+export declare const assertTronSufficientBalance: (tronWeb: TronWeb, chainId: number, contractBase58: string, ownerAddress: string, callData: string, totalTrxValue: bigint) => Promise<void>;
+export declare const approveTronTokens: (tronWeb: TronWeb, ethereumAddress: string, spenderBase58: string, tokensNeedingApproval: Map<string, bigint>) => Promise<void>;

package/functions/utils/tron.utils.mjs

@@ -0,0 +1,197 @@
+import { chainIds as e, networkRegistry as t } from "../../constants/chains.constants.mjs";
+import { TRON_DEFAULT_FEE_LIMIT_SUN as n, zeroAddress as r } from "../../constants/protocol.constants.mjs";
+import { httpClient as i } from "../../data-structures/http/HttpClient.mjs";
+import { ENCLAVE_URL as a } from "../snarkjs/constant.mjs";
+import { caseInsensitiveEqual as o } from "./caseInsensitive.utils.mjs";
+import { ERC20ABI as s } from "../../externalABIs/index.mjs";
+import { insufficientResourcesErrorCodes as c } from "../../error-handling/error-codes.constants.mjs";
+import { Logger as l } from "../../error-handling/logger.mjs";
+import { ethers as u } from "ethers";
+import { TronWeb as d } from "tronweb";
+//#region libs/shared/common/src/functions/utils/tron.utils.ts
+var f = ["https://nile.trongrid.io", "https://api.shasta.trongrid.io"], p = 2000n, m = (t) => {
+	let n = t.toLowerCase();
+	return f.some((e) => n.includes(e)) ? e.tronNile : e.tronMainnet;
+}, h = (e) => {
+	let t = e.trim(), n = t.startsWith("0x") ? t.slice(2) : t;
+	if (!/^[0-9a-fA-F]{64}$/.test(n)) throw Error("Tron private key must be 32 bytes (64 hex characters), with or without 0x prefix");
+	return n;
+}, g = (e, n) => {
+	let r = t[e].fetchRpcUrl, i = n ? h(n) : void 0, a = i ? new d({
+		fullHost: r,
+		privateKey: i
+	}) : new d({ fullHost: r });
+	return n || a.setAddress("T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb"), a;
+}, _ = (e) => e?.startsWith("T") ? e : d.address.fromHex(e), v = (e) => {
+	if (e.startsWith("0x")) return e;
+	if (e.startsWith("41")) return e.replace("41", "0x");
+	if (e.startsWith("T")) return v(d.address.toHex(e));
+	throw Error("Failed to convert address to hex format");
+}, y = (e) => e?.startsWith("T") ? v(e) : e, b = (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}`);
+}, x = (e, t) => e.map((e) => Array.isArray(e) ? x(e, t) : t(e)), S = (e, t, n) => {
+	let r = new u.Interface(e);
+	if (!r.getFunction(t)) throw Error(`${t} ABI is missing for Tron call data creation`);
+	let i = x(n, (e) => typeof e == "string" && e.startsWith("T") ? v(e) : e);
+	return r.encodeFunctionData(t, i);
+}, C = (e, t, n) => e ? BigInt(Math.max((e[t] ?? 0) - (e[n] ?? 0), 0)) : 0n, w = (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);
+}, T = async (e) => {
+	let t = `${b(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;
+}, E = async (e, t) => {
+	let n = `${b(e)}/wallet/getaccountresource`, r = v(t), a = r.startsWith("0x") ? `41${r.slice(2)}` : r;
+	return await i.post(n, {
+		address: a,
+		visible: !1
+	});
+}, D = async (e, t, r, i, a, o) => {
+	let s = {
+		input: a,
+		callValue: Number(o),
+		feeLimit: n
+	}, [c, l] = await Promise.all([e.transactionBuilder.estimateEnergy(r, "", s, [], i), e.transactionBuilder.triggerConstantContract(r, "", s, [], i)]), u = await T(t), d = w(u, "getEnergyFee"), f = w(u, "getTransactionFee"), m = await E(t, i), h = BigInt(c?.energy_required ?? l?.energy_used ?? 0), g = C(m, "EnergyLimit", "EnergyUsed"), _ = (h > g ? h - g : 0n) * d, v = BigInt(Math.ceil((l?.transaction?.raw_data_hex?.length ?? 0) / 2)), y = C(m, "freeNetLimit", "freeNetUsed") + C(m, "NetLimit", "NetUsed"), b = _ + (v > y ? v - y : 0n) * f, x = b + b * p / 10000n;
+	return x > BigInt(1e9) ? BigInt(n) : x;
+}, O = (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
+	};
+}, k = (e, t) => {
+	let n = u.AbiCoder.defaultAbiCoder().encode([
+		"uint16",
+		"uint16",
+		"uint16",
+		"uint256"
+	], [
+		e.tokenNumber,
+		e.nullifierAmount,
+		e.outputAmount,
+		t
+	]);
+	return BigInt(u.keccak256(n));
+}, A = async (e, t, n, r, o, s) => {
+	let c = k(o, s), l = e.map(String), d = n.map(String), f = r.map(String), p = {
+		a: l,
+		b: [t[0].map(String), t[1].map(String)],
+		c: d,
+		inputs: f,
+		verifier_id: String(c)
+	}, m = await i.post(`${a}/sign-proof`, p), { v: h, r: g, s: _ } = u.Signature.from(m.signature.trim());
+	return {
+		v: h,
+		r: g,
+		s: _
+	};
+}, j = (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
+], M = async (e, t, n, r, i = !0) => {
+	if (e) {
+		let { a: e, b: a, c: o, publicSignals: s } = O(t), c = await A(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;
+	}
+}, N = (e, t) => {
+	let n = 0n, i = /* @__PURE__ */ new Map();
+	for (let a = 0; a < e.length; a += 1) if (o(e[a].erc20TokenAddress, r)) n += t[a];
+	else {
+		let n = _(e[a].erc20TokenAddress);
+		i.set(n, (i.get(n) ?? 0n) + t[a]);
+	}
+	return {
+		totalTrxValue: n,
+		tokensNeedingApproval: i
+	};
+}, P = async (e, t, r, i, a, o) => {
+	let s = BigInt(await e.trx.getBalance(i)), u = BigInt(n);
+	try {
+		u = await D(e, t, r, i, a, o);
+	} catch (e) {
+		l.error("Error estimating Tron deposit fee", e);
+	}
+	if (s < o + u) throw Error(c.INSUFFICIENT_TRON_BALANCE_FOR_FEE);
+}, F = async (e, t, r, i) => {
+	let a = Array.from(i.entries());
+	for (let i = 0; i < a.length; i += 1) {
+		let [o, c] = a[i], l = await e.contract(s, o).allowance(t, r).call({ from: t });
+		if (BigInt(String(l)) < c) {
+			let { transaction: i } = await e.transactionBuilder.triggerSmartContract(o, "approve(address,uint256)", { feeLimit: n }, [{
+				type: "address",
+				value: r
+			}, {
+				type: "uint256",
+				value: c.toString()
+			}], t), a = await e.trx.sign(i), s = await e.trx.sendRawTransaction(a);
+			if (!s.result) {
+				let e = s.code ?? "UNKNOWN", t = s.message ? Buffer.from(s.message, "hex").toString() : "no message";
+				throw Error(`Tron token approval failed: ${e} - ${t}`);
+			}
+		}
+	}
+};
+//#endregion
+export { v as addressToHexFormat, F as approveTronTokens, P as assertTronSufficientBalance, j as circomDataToArray, S as createTronCallData, g as createTronWeb, m as detectTronChainIdFromHost, D as estimateTronFeeSunWithPadding, _ as evmHexToTronBase58Address, E as fetchTronAccountResources, T as fetchTronChainParameters, A as generateProofSignatureRemotely, C as getAvailableResource, w as getChainParameterValue, k as getVerifierId, y as normalizeTronAddr, h as normalizeTronPrivateKey, O as parseZkCalldata, M as reorderZkCallData, N as splitTronTokensByNative };

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

package/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/functions/utils/tx-confirmation.utils.mjs

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

package/functions/utils/upToDateState.cjs

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

package/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/functions/utils/upToDateState.mjs

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

package/functions/utils/userAgent.cjs

@@ -0,0 +1 @@
+require(`../../_virtual/_rolldown/runtime.cjs`);var e=new(require(`ua-parser-js`)).UAParser,t=17,n=()=>{let{name:n,version:r}=e.getBrowser(),i=parseInt(r?.split(`.`)[0]??`0`,10);return!(n===`Safari`&&i&&t>i)},r=()=>{let{type:t}=e.getDevice();return t===`mobile`||t===`tablet`};exports.browserSupported=n,exports.isMobileDevice=r;

package/functions/utils/userAgent.d.ts

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

package/functions/utils/userAgent.mjs

@@ -0,0 +1,11 @@
+import { UAParser as e } from "ua-parser-js";
+//#region libs/shared/common/src/functions/utils/userAgent.ts
+var t = new e(), n = 17, r = () => {
+	let { name: e, version: r } = t.getBrowser(), i = parseInt(r?.split(".")[0] ?? "0", 10);
+	return !(e === "Safari" && i && n > i);
+}, i = () => {
+	let { type: e } = t.getDevice();
+	return e === "mobile" || e === "tablet";
+};
+//#endregion
+export { r as browserSupported, i as isMobileDevice };

package/functions/utils/validateUsername.cjs

@@ -0,0 +1 @@
+var e=(e,t)=>{let n=e.trim();return n?n.length<1||n.length>20?{isValid:!1,message:`Username must be between 1 and 20 characters`}:/^User \d+$/.test(n)?{isValid:!1,message:`'User number' formatted usernames are reserved`}:t?{isValid:!0,message:`Username available`}:{isValid:!1,message:`Username is already taken`}:{isValid:!1,message:null}};exports.validateUsername=e;

package/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/functions/utils/validateUsername.mjs

@@ -0,0 +1,22 @@
+//#region libs/shared/common/src/functions/utils/validateUsername.ts
+var e = (e, t) => {
+	let n = e.trim();
+	return n ? n.length < 1 || n.length > 20 ? {
+		isValid: !1,
+		message: "Username must be between 1 and 20 characters"
+	} : /^User \d+$/.test(n) ? {
+		isValid: !1,
+		message: "'User number' formatted usernames are reserved"
+	} : t ? {
+		isValid: !0,
+		message: "Username available"
+	} : {
+		isValid: !1,
+		message: "Username is already taken"
+	} : {
+		isValid: !1,
+		message: null
+	};
+};
+//#endregion
+export { e as validateUsername };

package/functions/utils/walletBalances.utils.cjs

@@ -0,0 +1 @@
+const e=require(`../web3/etherFunctions.cjs`);var t=(t,n,r,i,a)=>{try{return!r||!t?!0:i?a?+t*a<=+n:!0:e.getAmountInWei(r,t)<=e.getAmountInWei(r,n)}catch{return!0}};exports.hasEnoughBalance=t;

package/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/functions/utils/walletBalances.utils.mjs

@@ -0,0 +1,11 @@
+import { getAmountInWei as e } from "../web3/etherFunctions.mjs";
+//#region libs/shared/common/src/functions/utils/walletBalances.utils.ts
+var t = (t, n, r, i, a) => {
+	try {
+		return !r || !t ? !0 : i ? a ? +t * a <= +n : !0 : e(r, t) <= e(r, n);
+	} catch {
+		return !0;
+	}
+};
+//#endregion
+export { t as hasEnoughBalance };

package/functions/web3/EIP-712.cjs

@@ -0,0 +1 @@
+require(`../../_virtual/_rolldown/runtime.cjs`);let e=require(`ethers`);var t=(e,n,r)=>n.reduce((n,{name:i,type:a})=>{let o=e[i];if(a.endsWith(`[]`)){let e=a.slice(0,-2);if(r[e]&&Array.isArray(o)){let s=o.reduce((n,i,a)=>({...n,[a]:{value:t(i,r[e],r),type:e}}),{});return{...n,[i]:{value:s,type:a}}}return{...n,[i]:{value:o,type:a}}}return r[a]?{...n,[i]:{value:t(o,r[a],r),type:a}}:{...n,[i]:{value:o,type:a}}},{}),n=(e,n,r)=>{let i=t(e,n[r],n);return{primaryType:{value:r,type:`string`},...i}},r=function(e){return e.Permit=`Permit`,e.PermitWithExpiry=`PermitWithExpiry`,e.PermitBatch=`PermitBatch`,e.PermitBatchTransferFrom=`PermitBatchTransferFrom`,e.PermitSingle=`PermitSingle`,e.PermitTransferFrom=`PermitTransferFrom`,e.PermitWitnessTransferFrom=`PermitWitnessTransferFrom`,e}(r||{}),i=[`Permit`,`PermitWithExpiry`,`PermitBatch`,`PermitBatchTransferFrom`,`PermitSingle`,`PermitTransferFrom`,`PermitWitnessTransferFrom`],a=(e,t)=>{let n;switch(t){case r.PermitSingle:case r.PermitBatch:n=e.details;break;case r.PermitBatchTransferFrom:case r.PermitTransferFrom:case r.PermitWitnessTransferFrom:n=e.permitted;break;default:break}if(n)return Array.isArray(n)?n:[n]},o=(e,t,n)=>{if(!Object.keys(t).some(e=>i.includes(e)))return{isPermit:!1,tokenDetails:[]};let r=a(e,n);return r?{isPermit:!0,tokenDetails:r}:{isPermit:!0,tokenDetails:[]}},s=(t,n,r,i)=>{let{isPermit:a,tokenDetails:s}=o(t,n,i);if(!a)return{isPermit:!1};let c;if(s.length)c=r.verifyingContract;else{let t=r.verifyingContract;t&&s.push({token:t,amount:e.ethers.MaxUint256.toString()})}return{isPermit:a,tokenDetails:s,spender:c}};exports.decodeMessage=t,exports.getDecodedMessage=n,exports.getPermitInfo=s;

package/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 {};