@hinkal/common 0.2.31 → 0.2.32

package/functions/utils/solana-memo.mjs

@@ -0,0 +1,15 @@
+import { PublicKey as e, TransactionInstruction as t } from "@solana/web3.js";
+//#region libs/shared/common/src/functions/utils/solana-memo.ts
+var n = new e("MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr"), r = "hinkal-pal:", i = (e) => new t({
+	keys: [],
+	programId: n,
+	data: Buffer.from(`${r}${e.replace(/-/g, "")}`, "utf8")
+}), a = (e, t) => e.map((e) => {
+	if (!t.get(e.programIdIndex)?.equals(n)) return null;
+	let i = Buffer.from(e.data).toString("utf8");
+	if (!i.startsWith(r)) return null;
+	let a = i.slice(11);
+	return a.length === 32 ? `${a.slice(0, 8)}-${a.slice(8, 12)}-${a.slice(12, 16)}-${a.slice(16, 20)}-${a.slice(20, 32)}` : null;
+}).find((e) => e !== null) ?? null;
+//#endregion
+export { i as buildOrderIdMemoInstruction, a as extractOrderIdFromMemos };

package/functions/utils/solanaSendPreflight.utils.cjs

@@ -0,0 +1 @@
+const e=require(`../web3/etherFunctions.cjs`);var t=(t,n,r)=>{try{return t&&t[n]&&r?e.getAmountInWei(r,t[n]):0n}catch{return 0n}},n=(n,r,i,a,o,s)=>n.map((n,c)=>{let l=t(r,c,i);if(!(l>0n&&n.recipientSolBalanceLamports+l<n.systemRentExemptLamports))return``;let u=n.systemRentExemptLamports-n.recipientSolBalanceLamports,d=`0`;try{o&&u>0n&&(d=Number(e.getAmountInToken(o,u)).toFixed(6).replace(/\.?0+$/,``))}catch{d=`0`}return a.length===1?`Minimum amount to send is ${d} SOL`:`Minimum amount to send to recipient ${s?.[c]?s[c]-1:c+1} is ${d} SOL`});exports.buildSolanaRecipientRentErrorMessages=n;

package/functions/utils/solanaSendPreflight.utils.d.ts

@@ -0,0 +1,6 @@
+import { ERC20Token } from '../../types/token.types';
+export interface SolanaRecipientRentPreflightData {
+    systemRentExemptLamports: bigint;
+    recipientSolBalanceLamports: bigint;
+}
+export declare const buildSolanaRecipientRentErrorMessages: (recipientsData: SolanaRecipientRentPreflightData[], tokenAmounts: string[] | undefined, selectedToken: ERC20Token | undefined, validToAddresses: string[], solanaNativeToken: ERC20Token | undefined, rowNumbers?: number[]) => string[];

package/functions/utils/solanaSendPreflight.utils.mjs

@@ -0,0 +1,21 @@
+import { getAmountInToken as e, getAmountInWei as t } from "../web3/etherFunctions.mjs";
+//#region libs/shared/common/src/functions/utils/solanaSendPreflight.utils.ts
+var n = (e, n, r) => {
+	try {
+		return e && e[n] && r ? t(r, e[n]) : 0n;
+	} catch {
+		return 0n;
+	}
+}, r = (t, r, i, a, o, s) => t.map((t, c) => {
+	let l = n(r, c, i);
+	if (!(l > 0n && t.recipientSolBalanceLamports + l < t.systemRentExemptLamports)) return "";
+	let u = t.systemRentExemptLamports - t.recipientSolBalanceLamports, d = "0";
+	try {
+		o && u > 0n && (d = Number(e(o, u)).toFixed(6).replace(/\.?0+$/, ""));
+	} catch {
+		d = "0";
+	}
+	return a.length === 1 ? `Minimum amount to send is ${d} SOL` : `Minimum amount to send to recipient ${s?.[c] ? s[c] - 1 : c + 1} is ${d} SOL`;
+});
+//#endregion
+export { r as buildSolanaRecipientRentErrorMessages };

package/functions/utils/string.utils.cjs

@@ -1 +1 @@
-const e=require(`../../constants/chains.constants.cjs`);function t(e){return e?.toLowerCase().split(` `).map(e=>e.charAt(0).toUpperCase()+e.substring(1)).join(` `)}function n(e){return e.charAt(0).toUpperCase()+e.slice(1)}function r(e){return!e||e===null||Array.isArray(e)&&e.length===0?!0:Object.keys(e).length===0&&e.constructor===Object}var i=e=>{e.startsWith(`0x`)&&(e=e.slice(2));let t=[];for(let n=0;n<e.length;n+=2){let r=parseInt(e.slice(n,n+2),16);t.push(r)}return new TextDecoder(`utf-8`).decode(new Uint8Array(t))},a=(t,n)=>{let r=`${t}-${n}`;return e.isSolanaLike(n)||e.isTronLike(n)?r:r.toLowerCase()},o=(t,n,r=!1)=>{let i=`${t}-${n}`;if(r){let{hinkalAddress:t}=e.networkRegistry[n].contractData;return`${i}-${t}`.toLowerCase()}return i.toLowerCase()},s=e=>{let[,t]=e.split(`-`);return Number(t)},c=e=>{let[t]=e.split(`-`);return t},l=(e,t,n)=>{if(!t||!n)throw Error(`oldPart and newPart must be provided`);return e.toLowerCase().split(t.toLowerCase()).join(n.toLowerCase())},u=e=>!e||e.trim().length===0?null:e.toLowerCase().replace(/\b\w/g,e=>e.toUpperCase()),d=e=>e?/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(e):!1;exports.capitalizeFirstLetter=n,exports.capitalizeName=u,exports.getAddressFromStateKey=c,exports.getChainIdFromStateKey=s,exports.getStateKey=o,exports.getTokenStateKey=a,exports.hexToUtf8=i,exports.isNullOrEmpty=r,exports.replaceAllInstances=l,exports.toTitleCase=t,exports.validateEmail=d;
+const e=require(`../../constants/chains.constants.cjs`);function t(e){return e?.toLowerCase().split(` `).map(e=>e.charAt(0).toUpperCase()+e.substring(1)).join(` `)}function n(e){return e.charAt(0).toUpperCase()+e.slice(1)}function r(e){return!e||e===null||Array.isArray(e)&&e.length===0?!0:Object.keys(e).length===0&&e.constructor===Object}var i=e=>{e.startsWith(`0x`)&&(e=e.slice(2));let t=[];for(let n=0;n<e.length;n+=2){let r=parseInt(e.slice(n,n+2),16);t.push(r)}return new TextDecoder(`utf-8`).decode(new Uint8Array(t))},a=(t,n)=>{let r=`${t}-${n}`;return e.isSolanaLike(n)||e.isTronLike(n)?r:r.toLowerCase()},o=(t,n,r=!1)=>{let i=`${t}-${n}`;if(r){let{hinkalAddress:t}=e.networkRegistry[n].contractData;return`${i}-${t}`.toLowerCase()}return i.toLowerCase()},s=e=>{let[,t]=e.split(`-`);return Number(t)},c=e=>{let[t]=e.split(`-`);return t},l=(e,t,n)=>{if(!t||!n)throw Error(`oldPart and newPart must be provided`);return e.toLowerCase().split(t.toLowerCase()).join(n.toLowerCase())},u=e=>!e||e.trim().length===0?null:e.toLowerCase().replace(/\b\w/g,e=>e.toUpperCase()),d=e=>e?/^[^\s@]+@[^\s@]+\.[a-zA-Z]{2,}$/.test(e):!1;exports.capitalizeFirstLetter=n,exports.capitalizeName=u,exports.getAddressFromStateKey=c,exports.getChainIdFromStateKey=s,exports.getStateKey=o,exports.getTokenStateKey=a,exports.hexToUtf8=i,exports.isNullOrEmpty=r,exports.replaceAllInstances=l,exports.toTitleCase=t,exports.validateEmail=d;

package/functions/utils/string.utils.mjs

@@ -36,6 +36,6 @@ var o = (e) => {
 }, d = (e, t, n) => {
 	if (!t || !n) throw Error("oldPart and newPart must be provided");
 	return e.toLowerCase().split(t.toLowerCase()).join(n.toLowerCase());
-}, f = (e) => !e || e.trim().length === 0 ? null : e.toLowerCase().replace(/\b\w/g, (e) => e.toUpperCase()), p = (e) => e ? /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(e) : !1;
+}, f = (e) => !e || e.trim().length === 0 ? null : e.toLowerCase().replace(/\b\w/g, (e) => e.toUpperCase()), p = (e) => e ? /^[^\s@]+@[^\s@]+\.[a-zA-Z]{2,}$/.test(e) : !1;
 //#endregion
 export { i as capitalizeFirstLetter, f as capitalizeName, u as getAddressFromStateKey, l as getChainIdFromStateKey, c as getStateKey, s as getTokenStateKey, o as hexToUtf8, a as isNullOrEmpty, d as replaceAllInstances, r as toTitleCase, p as validateEmail };

package/functions/utils/time.utils.cjs

@@ -1 +1 @@
-var e=(e=1e3)=>new Promise(t=>{setTimeout(()=>{t(void 0)},e)}),t=()=>Math.floor(Date.now()/1e3),n=e=>new Date(e).toISOString(),r=()=>{let e=new Date,t=new Date(Date.UTC(e.getUTCFullYear(),e.getUTCMonth(),e.getUTCDate(),6,0,0,0));return e<t?new Date(t.setUTCDate(t.getUTCDate()-1)):t},i=()=>{let e=r(),t=new Date(e);return t.setUTCDate(t.getUTCDate()-6),t},a=()=>{let e=r(),t=(e.getUTCDay()+6)%7,n=new Date(e);return n.setUTCDate(e.getUTCDate()-t),n.setUTCHours(6,0,0,0),n},o=()=>{let e=a();return e.setUTCDate(e.getUTCDate()-7),e},s=()=>{let e=new Date,t=new Date(e);return t.setUTCHours(6,0,0,0),t<=e&&t.setUTCDate(t.getUTCDate()+1),t.getTime()-e.getTime()},c=()=>{let e=new Date,t=new Date(e);return t.setUTCHours(8,0,0,0),t<=e&&t.setUTCDate(t.getUTCDate()+1),t.getTime()-e.getTime()},l=()=>{let e=new Date,t=new Date(Date.UTC(e.getUTCFullYear(),e.getUTCMonth(),e.getUTCDate(),6,0,0,0));return e<t&&t.setUTCDate(t.getUTCDate()-1),t},u=()=>{let e=new Date,t=new Date(e);return t.setUTCHours(6,0,0,0),t<=e&&t.setUTCDate(t.getUTCDate()+1),t.toISOString()},d=e=>{let t=new Date().getFullYear()===e.getFullYear()?{month:`long`,day:`numeric`}:{month:`long`,day:`numeric`,year:`numeric`};return e.toLocaleDateString(void 0,t)},f=e=>{try{let t=new Date(e);if(Number.isNaN(t.getTime()))return``;let n=t.getDate(),r=t.getFullYear();return`${t.toLocaleString(`en-US`,{month:`short`})} ${n}, ${r}, ${String(t.getHours()).padStart(2,`0`)}:${String(t.getMinutes()).padStart(2,`0`)}`}catch{return``}};exports.formatDate=d,exports.formatTxTimestamp=f,exports.getCurrentDayStart=l,exports.getCurrentTimeInSeconds=t,exports.getCurrentWeekStart=a,exports.getDelayUntilUtc8=c,exports.getEffectiveSevenDaysAgo=i,exports.getEffectiveToday=r,exports.getNextDayDelay=s,exports.getNextDayISO=u,exports.getPreviousWeekStart=o,exports.msToISOString=n,exports.waitLittle=e;
+var e=1e3*60*60*24,t=(e=1e3)=>new Promise(t=>{setTimeout(()=>{t(void 0)},e)}),n=()=>Math.floor(Date.now()/1e3),r=e=>new Date(e).toISOString(),i=()=>{let e=new Date,t=new Date(Date.UTC(e.getUTCFullYear(),e.getUTCMonth(),e.getUTCDate(),6,0,0,0));return e<t?new Date(t.setUTCDate(t.getUTCDate()-1)):t},a=()=>{let e=i(),t=new Date(e);return t.setUTCDate(t.getUTCDate()-6),t},o=()=>{let e=i(),t=(e.getUTCDay()+6)%7,n=new Date(e);return n.setUTCDate(e.getUTCDate()-t),n.setUTCHours(6,0,0,0),n},s=()=>{let e=o();return e.setUTCDate(e.getUTCDate()-7),e},c=()=>{let e=new Date,t=new Date(e);return t.setUTCHours(6,0,0,0),t<=e&&t.setUTCDate(t.getUTCDate()+1),t.getTime()-e.getTime()},l=()=>{let e=new Date,t=new Date(e);return t.setUTCHours(8,0,0,0),t<=e&&t.setUTCDate(t.getUTCDate()+1),t.getTime()-e.getTime()},u=()=>{let e=new Date,t=new Date(Date.UTC(e.getUTCFullYear(),e.getUTCMonth(),e.getUTCDate(),6,0,0,0));return e<t&&t.setUTCDate(t.getUTCDate()-1),t},d=(e=new Date)=>new Date(Date.UTC(e.getUTCFullYear(),e.getUTCMonth(),e.getUTCDate())),f=()=>{let e=new Date,t=new Date(e);return t.setUTCHours(6,0,0,0),t<=e&&t.setUTCDate(t.getUTCDate()+1),t.toISOString()},p=e=>{let t=new Date().getFullYear()===e.getFullYear()?{month:`long`,day:`numeric`}:{month:`long`,day:`numeric`,year:`numeric`};return e.toLocaleDateString(void 0,t)},m=e=>{try{let t=new Date(e);if(Number.isNaN(t.getTime()))return``;let n=t.getDate(),r=t.getFullYear();return`${t.toLocaleString(`en-US`,{month:`short`})} ${n}, ${r}, ${String(t.getHours()).padStart(2,`0`)}:${String(t.getMinutes()).padStart(2,`0`)}`}catch{return``}},h=e=>{let t=new Date,n=new Date(e),r=t.getTime()-n.getTime(),i=Math.floor(r/1e3),a=Math.floor(i/60),o=Math.floor(a/60),s=Math.floor(o/24),c=Math.floor(s/7),l=Math.floor(s/30),u=Math.floor(s/365);return i<60?`${Math.max(1,i)} sec${i===1?``:`s`} ago`:a<60?`${a} min${a===1?``:`s`} ago`:o<24?`${o} hour${o===1?``:`s`} ago`:s<7?`${s} day${s===1?``:`s`} ago`:c<4?`${c} week${c===1?``:`s`} ago`:l<12?`${l} month${l===1?``:`s`} ago`:`${u} year${u===1?``:`s`} ago`},g=(e,t)=>e.getFullYear()===t.getFullYear()&&e.getMonth()===t.getMonth()&&e.getDate()===t.getDate(),_=e=>e.toLocaleDateString(`en-US`,{month:`short`,day:`numeric`,year:`numeric`}),v=(t,n)=>(new Date().getTime()-t.getTime())/e<=n;exports.MS_PER_DAY=e,exports.calculateRelativeTime=h,exports.formatDate=p,exports.formatTimestampDate=_,exports.formatTxTimestamp=m,exports.getCurrentDayStart=u,exports.getCurrentTimeInSeconds=n,exports.getCurrentWeekStart=o,exports.getDelayUntilUtc8=l,exports.getEffectiveSevenDaysAgo=a,exports.getEffectiveToday=i,exports.getNextDayDelay=c,exports.getNextDayISO=f,exports.getPreviousWeekStart=s,exports.getUtcDayStart=d,exports.isSameDay=g,exports.isWithinDays=v,exports.msToISOString=r,exports.waitLittle=t;

package/functions/utils/time.utils.d.ts

@@ -1,3 +1,4 @@
+export declare const MS_PER_DAY: number;
 export declare const waitLittle: (time?: number) => Promise<unknown>;
 export declare const getCurrentTimeInSeconds: () => number;
 export declare const msToISOString: (ms: number) => string;
@@ -8,6 +9,11 @@ export declare const getPreviousWeekStart: () => Date;
 export declare const getNextDayDelay: () => number;
 export declare const getDelayUntilUtc8: () => number;
 export declare const getCurrentDayStart: () => Date;
+export declare const getUtcDayStart: (date?: Date) => Date;
 export declare const getNextDayISO: () => string;
 export declare const formatDate: (date: Date) => string;
 export declare const formatTxTimestamp: (input: string) => string;
+export declare const calculateRelativeTime: (targetDate: string) => string;
+export declare const isSameDay: (a: Date, b: Date) => boolean;
+export declare const formatTimestampDate: (date: Date) => string;
+export declare const isWithinDays: (date: Date, days: number) => boolean;

package/functions/utils/time.utils.mjs

@@ -1,33 +1,33 @@
 //#region libs/shared/common/src/functions/utils/time.utils.ts
-var e = (e = 1e3) => new Promise((t) => {
+var e = 1e3 * 60 * 60 * 24, t = (e = 1e3) => new Promise((t) => {
 	setTimeout(() => {
 		t(void 0);
 	}, e);
-}), t = () => Math.floor(Date.now() / 1e3), n = (e) => new Date(e).toISOString(), r = () => {
+}), n = () => Math.floor(Date.now() / 1e3), r = (e) => new Date(e).toISOString(), i = () => {
 	let e = /* @__PURE__ */ new Date(), t = new Date(Date.UTC(e.getUTCFullYear(), e.getUTCMonth(), e.getUTCDate(), 6, 0, 0, 0));
 	return e < t ? new Date(t.setUTCDate(t.getUTCDate() - 1)) : t;
-}, i = () => {
-	let e = r(), t = new Date(e);
-	return t.setUTCDate(t.getUTCDate() - 6), t;
 }, a = () => {
-	let e = r(), t = (e.getUTCDay() + 6) % 7, n = new Date(e);
-	return n.setUTCDate(e.getUTCDate() - t), n.setUTCHours(6, 0, 0, 0), n;
+	let e = i(), t = new Date(e);
+	return t.setUTCDate(t.getUTCDate() - 6), t;
 }, o = () => {
-	let e = a();
-	return e.setUTCDate(e.getUTCDate() - 7), e;
+	let e = i(), t = (e.getUTCDay() + 6) % 7, n = new Date(e);
+	return n.setUTCDate(e.getUTCDate() - t), n.setUTCHours(6, 0, 0, 0), n;
 }, s = () => {
+	let e = o();
+	return e.setUTCDate(e.getUTCDate() - 7), e;
+}, c = () => {
 	let e = /* @__PURE__ */ new Date(), t = new Date(e);
 	return t.setUTCHours(6, 0, 0, 0), t <= e && t.setUTCDate(t.getUTCDate() + 1), t.getTime() - e.getTime();
-}, c = () => {
+}, l = () => {
 	let e = /* @__PURE__ */ new Date(), t = new Date(e);
 	return t.setUTCHours(8, 0, 0, 0), t <= e && t.setUTCDate(t.getUTCDate() + 1), t.getTime() - e.getTime();
-}, l = () => {
+}, u = () => {
 	let e = /* @__PURE__ */ new Date(), t = new Date(Date.UTC(e.getUTCFullYear(), e.getUTCMonth(), e.getUTCDate(), 6, 0, 0, 0));
 	return e < t && t.setUTCDate(t.getUTCDate() - 1), t;
-}, u = () => {
+}, d = (e = /* @__PURE__ */ new Date()) => new Date(Date.UTC(e.getUTCFullYear(), e.getUTCMonth(), e.getUTCDate())), f = () => {
 	let e = /* @__PURE__ */ new Date(), t = new Date(e);
 	return t.setUTCHours(6, 0, 0, 0), t <= e && t.setUTCDate(t.getUTCDate() + 1), t.toISOString();
-}, d = (e) => {
+}, p = (e) => {
 	let t = (/* @__PURE__ */ new Date()).getFullYear() === e.getFullYear() ? {
 		month: "long",
 		day: "numeric"
@@ -37,7 +37,7 @@ var e = (e = 1e3) => new Promise((t) => {
 		year: "numeric"
 	};
 	return e.toLocaleDateString(void 0, t);
-}, f = (e) => {
+}, m = (e) => {
 	try {
 		let t = new Date(e);
 		if (Number.isNaN(t.getTime())) return "";
@@ -46,6 +46,13 @@ var e = (e = 1e3) => new Promise((t) => {
 	} catch {
 		return "";
 	}
-};
+}, h = (e) => {
+	let t = /* @__PURE__ */ new Date(), n = new Date(e), r = t.getTime() - n.getTime(), i = Math.floor(r / 1e3), a = Math.floor(i / 60), o = Math.floor(a / 60), s = Math.floor(o / 24), c = Math.floor(s / 7), l = Math.floor(s / 30), u = Math.floor(s / 365);
+	return i < 60 ? `${Math.max(1, i)} sec${i === 1 ? "" : "s"} ago` : a < 60 ? `${a} min${a === 1 ? "" : "s"} ago` : o < 24 ? `${o} hour${o === 1 ? "" : "s"} ago` : s < 7 ? `${s} day${s === 1 ? "" : "s"} ago` : c < 4 ? `${c} week${c === 1 ? "" : "s"} ago` : l < 12 ? `${l} month${l === 1 ? "" : "s"} ago` : `${u} year${u === 1 ? "" : "s"} ago`;
+}, g = (e, t) => e.getFullYear() === t.getFullYear() && e.getMonth() === t.getMonth() && e.getDate() === t.getDate(), _ = (e) => e.toLocaleDateString("en-US", {
+	month: "short",
+	day: "numeric",
+	year: "numeric"
+}), v = (t, n) => ((/* @__PURE__ */ new Date()).getTime() - t.getTime()) / e <= n;
 //#endregion
-export { d as formatDate, f as formatTxTimestamp, l as getCurrentDayStart, t as getCurrentTimeInSeconds, a as getCurrentWeekStart, c as getDelayUntilUtc8, i as getEffectiveSevenDaysAgo, r as getEffectiveToday, s as getNextDayDelay, u as getNextDayISO, o as getPreviousWeekStart, n as msToISOString, e as waitLittle };
+export { e as MS_PER_DAY, h as calculateRelativeTime, p as formatDate, _ as formatTimestampDate, m as formatTxTimestamp, u as getCurrentDayStart, n as getCurrentTimeInSeconds, o as getCurrentWeekStart, l as getDelayUntilUtc8, a as getEffectiveSevenDaysAgo, i as getEffectiveToday, c as getNextDayDelay, f as getNextDayISO, s as getPreviousWeekStart, d as getUtcDayStart, g as isSameDay, v as isWithinDays, r as msToISOString, t as waitLittle };

package/functions/utils/token-check.utils.cjs

@@ -1 +1 @@
-const e=require(`./caseInsensitive.utils.cjs`),t=require(`../../API/API.cjs`),n=require(`../../error-handling/error-codes.constants.cjs`);var r=async(e,n)=>{let r=await t.API.tokensInfoCall(e,n),i=[];return r.forEach((e,t)=>{(!e||!e.balanceStorageOffset||!e.allowanceStorageOffset)&&i.push(n[t])}),i},i=e=>{if(e.length===0)throw Error(`Token array cannot be empty`);let t=e.map(e=>e.chainId),r=t[0];if(!t.every(e=>e===r))throw Error(n.transactionErrorCodes.TOKENS_DO_NOT_BELONG_SAME_CHAIN);return r},a=(t,n)=>!t||!n?!1:e.caseInsensitiveEqual(t.erc20TokenAddress,n.erc20TokenAddress)&&t.chainId===n.chainId;exports.checkTokensForShielding=r,exports.isSameERC20Token=a,exports.validateAndGetChainId=i;
+const e=require(`./caseInsensitive.utils.cjs`),t=require(`../../API/API.cjs`),n=require(`../../constants/token-data/ERC20Registry.cjs`),r=require(`../../error-handling/error-codes.constants.cjs`);var i=async(e,n)=>{let r=await t.API.tokensInfoCall(e,n),i=[];return r.forEach((e,t)=>{(!e||!e.balanceStorageOffset||!e.allowanceStorageOffset)&&i.push(n[t])}),i},a=e=>{if(e.length===0)throw Error(`Token array cannot be empty`);let t=e.map(e=>e.chainId),n=t[0];if(!t.every(e=>e===n))throw Error(r.transactionErrorCodes.TOKENS_DO_NOT_BELONG_SAME_CHAIN);return n},o=(t,n)=>!t||!n?!1:e.caseInsensitiveEqual(t.erc20TokenAddress,n.erc20TokenAddress)&&t.chainId===n.chainId,s=(t,r)=>r.every(r=>n.getERC20Registry(t).some(({erc20TokenAddress:t})=>e.caseInsensitiveEqual(t,r)));exports.areErc20TokensInRegistry=s,exports.checkTokensForShielding=i,exports.isSameERC20Token=o,exports.validateAndGetChainId=a;

package/functions/utils/token-check.utils.d.ts

@@ -2,3 +2,4 @@ import { ERC20Token } from '../../types/token.types';
 export declare const checkTokensForShielding: (chainId: number, erc20Addresses: string[]) => Promise<string[]>;
 export declare const validateAndGetChainId: (tokens: ERC20Token[]) => number;
 export declare const isSameERC20Token: (a?: ERC20Token, b?: ERC20Token) => boolean;
+export declare const areErc20TokensInRegistry: (chainId: number, erc20TokenAddresses: string[]) => boolean;

package/functions/utils/token-check.utils.mjs

@@ -1,17 +1,18 @@
 import { caseInsensitiveEqual as e } from "./caseInsensitive.utils.mjs";
 import { API as t } from "../../API/API.mjs";
-import { transactionErrorCodes as n } from "../../error-handling/error-codes.constants.mjs";
+import { getERC20Registry as n } from "../../constants/token-data/ERC20Registry.mjs";
+import { transactionErrorCodes as r } from "../../error-handling/error-codes.constants.mjs";
 //#region libs/shared/common/src/functions/utils/token-check.utils.ts
-var r = async (e, n) => {
+var i = async (e, n) => {
 	let r = await t.tokensInfoCall(e, n), i = [];
 	return r.forEach((e, t) => {
 		(!e || !e.balanceStorageOffset || !e.allowanceStorageOffset) && i.push(n[t]);
 	}), i;
-}, i = (e) => {
+}, a = (e) => {
 	if (e.length === 0) throw Error("Token array cannot be empty");
-	let t = e.map((e) => e.chainId), r = t[0];
-	if (!t.every((e) => e === r)) throw Error(n.TOKENS_DO_NOT_BELONG_SAME_CHAIN);
-	return r;
-}, a = (t, n) => !t || !n ? !1 : e(t.erc20TokenAddress, n.erc20TokenAddress) && t.chainId === n.chainId;
+	let t = e.map((e) => e.chainId), n = t[0];
+	if (!t.every((e) => e === n)) throw Error(r.TOKENS_DO_NOT_BELONG_SAME_CHAIN);
+	return n;
+}, o = (t, n) => !t || !n ? !1 : e(t.erc20TokenAddress, n.erc20TokenAddress) && t.chainId === n.chainId, s = (t, r) => r.every((r) => n(t).some(({ erc20TokenAddress: t }) => e(t, r)));
 //#endregion
-export { r as checkTokensForShielding, a as isSameERC20Token, i as validateAndGetChainId };
+export { s as areErc20TokensInRegistry, i as checkTokensForShielding, o as isSameERC20Token, a as validateAndGetChainId };

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

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

package/functions/utils/transfer-claimable.utils.d.ts

@@ -0,0 +1,9 @@
+import { ErrorWithIndex } from '../../error-handling';
+import { PrivateSendAllocation } from '../../API';
+import { AdminTransactionType, ERC20Token, FeeStructure, PendingEnclaveUtxo, RecipientRequest } from '../../types';
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+export declare const transferClaimableUtxos: (hinkal: IHinkal, token: ERC20Token, recipients: RecipientRequest[], allocations: PrivateSendAllocation[], baseNonce: bigint, feeToken?: string, feeStructure?: FeeStructure, action?: AdminTransactionType) => Promise<{
+    pendingEnclaveUtxos: PendingEnclaveUtxo[];
+    txHashes: string[];
+    failedRecipientErrorMessage: ErrorWithIndex | undefined;
+}>;

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/tron.utils.cjs

@@ -1 +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`);let i=require(`ethers`),a=require(`tronweb`);var o=[`https://nile.trongrid.io`,`https://api.shasta.trongrid.io`],s=1000n,c=t=>{let n=t.toLowerCase();return o.some(e=>n.includes(e))?e.chainIds.tronNile:e.chainIds.tronMainnet},l=(t,n)=>{let r=e.networkRegistry[t].fetchRpcUrl,i=n?new a.TronWeb({fullHost:r,privateKey:n}):new a.TronWeb({fullHost:r});return n||i.setAddress(`T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb`),i},u=e=>e?.startsWith(`T`)?e:a.TronWeb.address.fromHex(e),d=e=>{if(e.startsWith(`0x`))return e;if(e.startsWith(`41`))return e.replace(`41`,`0x`);if(e.startsWith(`T`))return d(a.TronWeb.address.toHex(e));throw Error(`Failed to convert address to hex format`)},f=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}`)},p=(e,t)=>e.map(e=>Array.isArray(e)?p(e,t):t(e)),m=(e,t,n)=>{let r=new i.ethers.Interface(e);if(!r.getFunction(t))throw Error(`${t} ABI is missing for Tron call data creation`);let a=p(n,e=>typeof e==`string`&&e.startsWith(`T`)?d(e):e);return r.encodeFunctionData(t,a)},h=(e,t,n)=>e?BigInt(Math.max((e[t]??0)-(e[n]??0),0)):0n,g=(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)},_=async e=>{let t=`${f(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},v=async(e,t)=>{let r=`${f(e)}/wallet/getaccountresource`,i=d(t),a=i.startsWith(`0x`)?`41${i.slice(2)}`:i;return await n.httpClient.post(r,{address:a,visible:!1})},y=async(e,n,r,i,a,o)=>{let c={input:a,callValue:Number(o),feeLimit:t.TRON_DEFAULT_FEE_LIMIT_SUN},[l,u]=await Promise.all([e.transactionBuilder.estimateEnergy(r,``,c,[],i),e.transactionBuilder.triggerConstantContract(r,``,c,[],i)]),d=await _(n),f=g(d,`getEnergyFee`),p=g(d,`getTransactionFee`),m=await v(n,i),y=BigInt(l?.energy_required??u?.energy_used??0),b=h(m,`EnergyLimit`,`EnergyUsed`),x=(y>b?y-b:0n)*f,S=BigInt(Math.ceil((u?.transaction?.raw_data_hex?.length??0)/2)),C=h(m,`freeNetLimit`,`freeNetUsed`)+h(m,`NetLimit`,`NetUsed`),w=x+(S>C?S-C:0n)*p,T=w+w*s/10000n;return T>BigInt(1e9)?BigInt(t.TRON_DEFAULT_FEE_LIMIT_SUN):T},b=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}},x=(e,t)=>{let n=i.ethers.AbiCoder.defaultAbiCoder().encode([`uint16`,`uint16`,`uint16`,`uint256`],[e.tokenNumber,e.nullifierAmount,e.outputAmount,t]);return BigInt(i.ethers.keccak256(n))},S=async(e,t,a,o,s,c)=>{let l=x(s,c),u=e.map(String),d=a.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 n.httpClient.post(`${r.ENCLAVE_EC2_URL}/sign-proof`,p),{v:h,r:g,s:_}=i.ethers.Signature.from(m.signature.trim());return{v:h,r:g,s:_}},C=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],w=async(e,t,n,r,i=!0)=>{if(e){let{a:e,b:a,c:o,publicSignals:s}=b(t),c=await S(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}};exports.addressToHexFormat=d,exports.circomDataToArray=C,exports.createTronCallData=m,exports.createTronWeb=l,exports.detectTronChainIdFromHost=c,exports.estimateTronFeeSunWithPadding=y,exports.evmHexToTronBase58Address=u,exports.fetchTronAccountResources=v,exports.fetchTronChainParameters=_,exports.generateProofSignatureRemotely=S,exports.getAvailableResource=h,exports.getChainParameterValue=g,exports.getVerifierId=x,exports.parseZkCalldata=b,exports.reorderZkCallData=w;
+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=>e.startsWith(`0x`)?h(e):e,_=e=>{if(e.startsWith(`0x`))return e;if(e.startsWith(`41`))return e.replace(`41`,`0x`);if(e.startsWith(`T`))return _(l.TronWeb.address.toHex(e));throw Error(`Failed to convert address to hex format`)},v=e=>e?.startsWith(`T`)?_(e):e,y=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}`)},b=(e,t)=>e.map(e=>Array.isArray(e)?b(e,t):t(e)),x=(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=b(n,e=>typeof e==`string`&&e.startsWith(`T`)?_(e):e);return r.encodeFunctionData(t,i)},S=(e,t,n)=>e?BigInt(Math.max((e[t]??0)-(e[n]??0),0)):0n,C=(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)},w=async e=>{let t=`${y(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},T=async(e,t)=>{let r=`${y(e)}/wallet/getaccountresource`,i=_(t),a=i.startsWith(`0x`)?`41${i.slice(2)}`:i;return await n.httpClient.post(r,{address:a,visible:!1})},E=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 w(n),f=C(u,`getEnergyFee`),p=C(u,`getTransactionFee`),m=await T(n,i),h=BigInt(c?.energy_required??l?.energy_used??0),g=S(m,`EnergyLimit`,`EnergyUsed`),_=(h>g?h-g:0n)*f,v=BigInt(Math.ceil((l?.transaction?.raw_data_hex?.length??0)/2)),y=S(m,`freeNetLimit`,`freeNetUsed`)+S(m,`NetLimit`,`NetUsed`),b=_+(v>y?v-y:0n)*p,x=b+b*d/10000n;return x>BigInt(1e9)?BigInt(t.TRON_DEFAULT_FEE_LIMIT_SUN):x},D=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}},O=(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))},k=async(e,t,i,a,o,s)=>{let l=O(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:_}},A=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],j=async(e,t,n,r,i=!0)=>{if(e){let{a:e,b:a,c:o,publicSignals:s}=D(t),c=await k(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}},M=(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}},N=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 E(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)},P=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=_,exports.approveTronTokens=P,exports.assertTronSufficientBalance=N,exports.circomDataToArray=A,exports.createTronCallData=x,exports.createTronWeb=m,exports.detectTronChainIdFromHost=f,exports.estimateTronFeeSunWithPadding=E,exports.evmHexToTronBase58Address=h,exports.fetchTronAccountResources=T,exports.fetchTronChainParameters=w,exports.generateProofSignatureRemotely=k,exports.getAvailableResource=S,exports.getChainParameterValue=C,exports.getVerifierId=O,exports.normalizeTronAddr=v,exports.normalizeTronPrivateKey=p,exports.parseZkCalldata=D,exports.reorderZkCallData=j,exports.splitTronTokensByNative=M,exports.toTronBase58IfHex=g;

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

@@ -3,10 +3,14 @@ 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 toTronBase58IfHex: (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;
@@ -25,9 +29,15 @@ export declare const generateProofSignatureRemotely: (a: bigint[], b: bigint[][]
     r: string;
     s: string;
 }>;
-export declare const circomDataToArray: (circomData: CircomDataType) => (string | number | bigint | (string | number)[] | (string | bigint)[] | string[][] | (bigint | boolean | bigint[] | import('../..').HinkalLogicAction | (string[] | bigint[])[][])[] | undefined)[];
+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

@@ -1,55 +1,63 @@
 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 { httpClient as r } from "../../data-structures/http/HttpClient.mjs";
-import { ENCLAVE_EC2_URL as i } from "../snarkjs/constant.mjs";
-import { ethers as a } from "ethers";
-import { TronWeb as o } from "tronweb";
+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 s = ["https://nile.trongrid.io", "https://api.shasta.trongrid.io"], c = 1000n, l = (t) => {
+var f = ["https://nile.trongrid.io", "https://api.shasta.trongrid.io"], p = 2000n, m = (t) => {
 	let n = t.toLowerCase();
-	return s.some((e) => n.includes(e)) ? e.tronNile : e.tronMainnet;
-}, u = (e, n) => {
-	let r = t[e].fetchRpcUrl, i = n ? new o({
+	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: n
-	}) : new o({ fullHost: r });
-	return n || i.setAddress("T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb"), i;
-}, d = (e) => e?.startsWith("T") ? e : o.address.fromHex(e), f = (e) => {
+		privateKey: i
+	}) : new d({ fullHost: r });
+	return n || a.setAddress("T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb"), a;
+}, _ = (e) => e?.startsWith("T") ? e : d.address.fromHex(e), v = (e) => e.startsWith("0x") ? _(e) : e, y = (e) => {
 	if (e.startsWith("0x")) return e;
 	if (e.startsWith("41")) return e.replace("41", "0x");
-	if (e.startsWith("T")) return f(o.address.toHex(e));
+	if (e.startsWith("T")) return y(d.address.toHex(e));
 	throw Error("Failed to convert address to hex format");
-}, p = (t) => {
+}, b = (e) => e?.startsWith("T") ? y(e) : e, x = (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}`);
-}, m = (e, t) => e.map((e) => Array.isArray(e) ? m(e, t) : t(e)), h = (e, t, n) => {
-	let r = new a.Interface(e);
+}, S = (e, t) => e.map((e) => Array.isArray(e) ? S(e, t) : t(e)), C = (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 = m(n, (e) => typeof e == "string" && e.startsWith("T") ? f(e) : e);
+	let i = S(n, (e) => typeof e == "string" && e.startsWith("T") ? y(e) : e);
 	return r.encodeFunctionData(t, i);
-}, g = (e, t, n) => e ? BigInt(Math.max((e[t] ?? 0) - (e[n] ?? 0), 0)) : 0n, _ = (e, t) => {
+}, w = (e, t, n) => e ? BigInt(Math.max((e[t] ?? 0) - (e[n] ?? 0), 0)) : 0n, T = (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);
-}, v = async (e) => {
-	let t = `${p(e)}/wallet/getchainparameters`, n = await r.post(t, {});
+}, E = async (e) => {
+	let t = `${x(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;
-}, y = async (e, t) => {
-	let n = `${p(e)}/wallet/getaccountresource`, i = f(t), a = i.startsWith("0x") ? `41${i.slice(2)}` : i;
-	return await r.post(n, {
+}, D = async (e, t) => {
+	let n = `${x(e)}/wallet/getaccountresource`, r = y(t), a = r.startsWith("0x") ? `41${r.slice(2)}` : r;
+	return await i.post(n, {
 		address: a,
 		visible: !1
 	});
-}, b = async (e, t, r, i, a, o) => {
+}, O = async (e, t, r, i, a, o) => {
 	let s = {
 		input: a,
 		callValue: Number(o),
 		feeLimit: n
-	}, [l, u] = await Promise.all([e.transactionBuilder.estimateEnergy(r, "", s, [], i), e.transactionBuilder.triggerConstantContract(r, "", s, [], i)]), d = await v(t), f = _(d, "getEnergyFee"), p = _(d, "getTransactionFee"), m = await y(t, i), h = BigInt(l?.energy_required ?? u?.energy_used ?? 0), b = g(m, "EnergyLimit", "EnergyUsed"), x = (h > b ? h - b : 0n) * f, S = BigInt(Math.ceil((u?.transaction?.raw_data_hex?.length ?? 0) / 2)), C = g(m, "freeNetLimit", "freeNetUsed") + g(m, "NetLimit", "NetUsed"), w = x + (S > C ? S - C : 0n) * p, T = w + w * c / 10000n;
-	return T > BigInt(1e9) ? BigInt(n) : T;
-}, x = (e) => {
+	}, [c, l] = await Promise.all([e.transactionBuilder.estimateEnergy(r, "", s, [], i), e.transactionBuilder.triggerConstantContract(r, "", s, [], i)]), u = await E(t), d = T(u, "getEnergyFee"), f = T(u, "getTransactionFee"), m = await D(t, i), h = BigInt(c?.energy_required ?? l?.energy_used ?? 0), g = w(m, "EnergyLimit", "EnergyUsed"), _ = (h > g ? h - g : 0n) * d, v = BigInt(Math.ceil((l?.transaction?.raw_data_hex?.length ?? 0) / 2)), y = w(m, "freeNetLimit", "freeNetUsed") + w(m, "NetLimit", "NetUsed"), b = _ + (v > y ? v - y : 0n) * f, x = b + b * p / 10000n;
+	return x > BigInt(1e9) ? BigInt(n) : x;
+}, k = (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,
@@ -57,8 +65,8 @@ var s = ["https://nile.trongrid.io", "https://api.shasta.trongrid.io"], c = 1000
 		c: i,
 		publicSignals: a
 	};
-}, S = (e, t) => {
-	let n = a.AbiCoder.defaultAbiCoder().encode([
+}, A = (e, t) => {
+	let n = u.AbiCoder.defaultAbiCoder().encode([
 		"uint16",
 		"uint16",
 		"uint16",
@@ -69,21 +77,21 @@ var s = ["https://nile.trongrid.io", "https://api.shasta.trongrid.io"], c = 1000
 		e.outputAmount,
 		t
 	]);
-	return BigInt(a.keccak256(n));
-}, C = async (e, t, n, o, s, c) => {
-	let l = S(s, c), u = e.map(String), d = n.map(String), f = o.map(String), p = {
-		a: u,
+	return BigInt(u.keccak256(n));
+}, j = async (e, t, n, r, o, s) => {
+	let c = A(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(l)
-	}, m = await r.post(`${i}/sign-proof`, p), { v: h, r: g, s: _ } = a.Signature.from(m.signature.trim());
+		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: _
 	};
-}, w = (e) => [
+}, M = (e) => [
 	e.rootHashHinkal,
 	e.erc20TokenAddresses,
 	e.tokenIds,
@@ -138,15 +146,52 @@ var s = ["https://nile.trongrid.io", "https://api.shasta.trongrid.io"], c = 1000
 		e.signatureData.ethereumAddress
 	],
 	e.originalSender
-], T = async (e, t, n, r, i = !0) => {
+], N = async (e, t, n, r, i = !0) => {
 	if (e) {
-		let { a: e, b: a, c: o, publicSignals: s } = x(t), c = await C(e, a, o, s, n, BigInt(r.externalActionId)), l = {
+		let { a: e, b: a, c: o, publicSignals: s } = k(t), c = await j(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;
 	}
+}, P = (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
+	};
+}, F = async (e, t, r, i, a, o) => {
+	let s = BigInt(await e.trx.getBalance(i)), u = BigInt(n);
+	try {
+		u = await O(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);
+}, I = 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 { f as addressToHexFormat, w as circomDataToArray, h as createTronCallData, u as createTronWeb, l as detectTronChainIdFromHost, b as estimateTronFeeSunWithPadding, d as evmHexToTronBase58Address, y as fetchTronAccountResources, v as fetchTronChainParameters, C as generateProofSignatureRemotely, g as getAvailableResource, _ as getChainParameterValue, S as getVerifierId, x as parseZkCalldata, T as reorderZkCallData };
+export { y as addressToHexFormat, I as approveTronTokens, F as assertTronSufficientBalance, M as circomDataToArray, C as createTronCallData, g as createTronWeb, m as detectTronChainIdFromHost, O as estimateTronFeeSunWithPadding, _ as evmHexToTronBase58Address, D as fetchTronAccountResources, E as fetchTronChainParameters, j as generateProofSignatureRemotely, w as getAvailableResource, T as getChainParameterValue, A as getVerifierId, b as normalizeTronAddr, h as normalizeTronPrivateKey, k as parseZkCalldata, N as reorderZkCallData, P as splitTronTokensByNative, v as toTronBase58IfHex };

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

@@ -1 +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.createCustomRpcProvider(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;
+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;