@gurge/sdk 0.2.32

package/functions/utils/publicBalance.utils.d.ts

@@ -0,0 +1,7 @@
+import { ethers } from 'ethers';
+import { ERC20Token, TokenBalance } from '../../types/token.types';
+export declare const getPublicBalance: (provider: ethers.JsonRpcProvider, ethereumAddress: string, token: ERC20Token) => Promise<TokenBalance | null>;
+export declare const getPublicBalancesOfTokens: (chainId: number, ethereumAddress: string, tokens?: ERC20Token[]) => Promise<TokenBalance[]>;
+export declare const getPublicBalanceByTokenAddress: (chainId: number, ethereumAddress: string, tokenAddress: string) => Promise<bigint | null>;
+export declare const getPublicTransactionCount: (chainId: number, address: string) => Promise<number>;
+export declare const getSolanaPublicBalances: (chainId: number, ethereumAddress: string, tokensToUpdate: ERC20Token[]) => Promise<TokenBalance[]>;

package/functions/utils/publicBalance.utils.mjs

@@ -0,0 +1,102 @@
+import { isSolanaLike as e, networkRegistry as t } from "../../constants/chains.constants.mjs";
+import { TokenType as n, zeroAddress as r } from "../../constants/protocol.constants.mjs";
+import { httpClient as i } from "../../data-structures/http/HttpClient.mjs";
+import "../../data-structures/http/index.mjs";
+import { isValidSolanaPublicKey as a } from "./addresses.mjs";
+import { ERC1155ABI as o, ERC721ABI as s } from "../../externalABIs/index.mjs";
+import { getErc20TokensForChain as c, isNFTToken as l } from "./erc20tokenFunctions.mjs";
+import { Logger as u } from "../../error-handling/logger.mjs";
+import { createCustomSolanaConnection as d, createJsonRpcProvider as f } from "./create-provider.mjs";
+import { ERC20ABI as p } from "../../externalABIs/swapAbi.mjs";
+import { getFormattedIpfsUrl as m } from "./ipfs.mjs";
+import { ethers as h } from "ethers";
+import { Connection as g, PublicKey as _ } from "@solana/web3.js";
+import { TOKEN_2022_PROGRAM_ID as v, TOKEN_PROGRAM_ID as y, getAssociatedTokenAddress as b } from "@solana/spl-token";
+//#region libs/shared/common/src/functions/utils/publicBalance.utils.ts
+var x = async (e, t, n) => {
+	try {
+		let i = n.erc20TokenAddress, a, o = new h.Contract(n.erc20TokenAddress, p, e);
+		a = i === r ? await e.getBalance(t) : await o?.balanceOf(t);
+		let s = a;
+		return s <= 0n ? null : {
+			token: n,
+			balance: s
+		};
+	} catch {
+		return null;
+	}
+}, S = async (e, t) => {
+	let r = t.nftTokenType === n.ERC721, a = new h.Contract(t.erc20TokenAddress, r ? s : o, e), { tokenIds: c } = t;
+	if (!c?.length) return null;
+	let l = await Promise.all(c.map(async (e) => {
+		try {
+			let t = await a[r ? "tokenURI" : "uri"](e), n = t.startsWith("ipfs://") ? m(t, !1) : t, o = r ? n : n.replace("{id}", e);
+			if (o) {
+				let t = await i.get(o);
+				return t?.image?.startsWith("ipfs://") && (t.image = m(t.image, !1)), {
+					image: t.image,
+					tokenId: Number(e),
+					name: t.name
+				};
+			}
+			return { tokenId: Number(e) };
+		} catch {
+			return { tokenId: Number(e) };
+		}
+	}));
+	return {
+		token: t,
+		balance: c?.length ? BigInt(c.length) : 0n,
+		nfts: l
+	};
+}, C = async (e, t, n) => {
+	let r = n ?? c(e), i = f(e);
+	return (await Promise.all(r.map(async (e) => l(e) ? S(i, e) : x(i, t, e)))).filter((e) => e !== null);
+}, w = async (e, t, n) => {
+	try {
+		let i = f(e), a = new h.Contract(n, p, i), o;
+		return o = n === r ? await i.getBalance(t) : await a?.balanceOf(t), o;
+	} catch {
+		return u.error(`Failed to fetch public balance for address ${t}`), null;
+	}
+}, T = async (n, r) => {
+	try {
+		if (e(n)) {
+			if (!a(r)) return 0;
+			let { fetchRpcUrl: e } = t[n];
+			return e ? (await new g(e).getSignaturesForAddress(new _(r))).length : 0;
+		}
+		return a(r) ? 0 : await f(n).getTransactionCount(r);
+	} catch (e) {
+		return u.error(`Failed to fetch transaction count for address ${r} on chain ${n}`, e), 0;
+	}
+}, E = async (e, n, r) => {
+	let i = d(t[e].fetchRpcUrl ?? "");
+	return (await Promise.all(r.map(async (e) => {
+		if (l(e)) return {
+			token: e,
+			balance: 1n,
+			nfts: [{
+				image: e.logoURI,
+				tokenId: 0,
+				name: e.symbol
+			}]
+		};
+		if (e.erc20TokenAddress === "11111111111111111111111111111111") return {
+			token: e,
+			balance: BigInt(await i.getBalance(new _(n)))
+		};
+		let t = await b(new _(e.erc20TokenAddress), new _(n), !0, e.is2022Program ? v : y);
+		if (!await i.getAccountInfo(t)) return {
+			token: e,
+			balance: 0n
+		};
+		let r = await i.getTokenAccountBalance(t);
+		return {
+			token: e,
+			balance: BigInt(r.value.amount)
+		};
+	}))).filter((e) => e.balance > 0n);
+};
+//#endregion
+export { x as getPublicBalance, w as getPublicBalanceByTokenAddress, C as getPublicBalancesOfTokens, T as getPublicTransactionCount, E as getSolanaPublicBalances };

package/functions/utils/reloadPage.cjs

@@ -0,0 +1 @@
+var e=()=>window.location.reload();exports.reloadPage=e;

package/functions/utils/reloadPage.d.ts

@@ -0,0 +1 @@
+export declare const reloadPage: () => void;

package/functions/utils/reloadPage.mjs

@@ -0,0 +1,4 @@
+//#region libs/shared/common/src/functions/utils/reloadPage.ts
+var e = () => window.location.reload();
+//#endregion
+export { e as reloadPage };

package/functions/utils/requireEnv.cjs

@@ -0,0 +1 @@
+var e=e=>{let t=process.env[e];return t===void 0&&(console.log(`Error: ${e} environment variable not set`),process.exitCode=1,process.exit()),t};exports.requireEnv=e;

package/functions/utils/requireEnv.d.ts

@@ -0,0 +1 @@
+export declare const requireEnv: (environmentVariableName: string) => string;

package/functions/utils/requireEnv.mjs

@@ -0,0 +1,7 @@
+//#region libs/shared/common/src/functions/utils/requireEnv.ts
+var e = (e) => {
+	let t = process.env[e];
+	return t === void 0 && (console.log(`Error: ${e} environment variable not set`), process.exitCode = 1, process.exit()), t;
+};
+//#endregion
+export { e as requireEnv };

package/functions/utils/resolve-sync.utils.cjs

@@ -0,0 +1 @@
+var e=e=>e.reduce((e,t)=>e.then(()=>t()),Promise.resolve()),t=(e,t,n)=>{let r=[];if(n){let i=e;for(;i<=t;){let e=Math.min(i+n-1,t);r.push({from:i,to:e}),i=e+1}}else r.push({from:e,to:t});return r},n=(e,t=100)=>new Promise((n,r)=>{setTimeout(async()=>{try{await e(),n(0)}catch(e){r(e)}},t)});exports.getSequence=t,exports.promisify=n,exports.resolveSync=e;

package/functions/utils/resolve-sync.utils.d.ts

@@ -0,0 +1,6 @@
+export declare const resolveSync: (promiseFns: (() => Promise<any>)[]) => Promise<void>;
+export declare const getSequence: (fromBlockNumber: number, lastBlockNumber: number, maxPageSize: number | undefined) => {
+    from: number;
+    to: number;
+}[];
+export declare const promisify: (callback: () => Promise<any>, timeout?: number) => Promise<unknown>;

package/functions/utils/resolve-sync.utils.mjs

@@ -0,0 +1,28 @@
+//#region libs/shared/common/src/functions/utils/resolve-sync.utils.ts
+var e = (e) => e.reduce((e, t) => e.then(() => t()), Promise.resolve()), t = (e, t, n) => {
+	let r = [];
+	if (n) {
+		let i = e;
+		for (; i <= t;) {
+			let e = Math.min(i + n - 1, t);
+			r.push({
+				from: i,
+				to: e
+			}), i = e + 1;
+		}
+	} else r.push({
+		from: e,
+		to: t
+	});
+	return r;
+}, n = (e, t = 100) => new Promise((n, r) => {
+	setTimeout(async () => {
+		try {
+			await e(), n(0);
+		} catch (e) {
+			r(e);
+		}
+	}, t);
+});
+//#endregion
+export { t as getSequence, n as promisify, e as resolveSync };

package/functions/utils/rpc-int-encode.cjs

@@ -0,0 +1 @@
+require(`../../_virtual/_rolldown/runtime.cjs`);let e=require(`ethers`);var t=t=>e.ethers.toBeHex(t);exports.rpcIntEncode=t;

package/functions/utils/rpc-int-encode.d.ts

@@ -0,0 +1 @@
+export declare const rpcIntEncode: (value: string | number | bigint) => string;

package/functions/utils/rpc-int-encode.mjs

@@ -0,0 +1,5 @@
+import { ethers as e } from "ethers";
+//#region libs/shared/common/src/functions/utils/rpc-int-encode.ts
+var t = (t) => e.toBeHex(t);
+//#endregion
+export { t as rpcIntEncode };

package/functions/utils/serialize-utxos.utils.cjs

@@ -0,0 +1 @@
+var e=e=>({...e,amount:e.amount.toString(),randomization:e.randomization?.toString(),spendingPublicKey:e.spendingPublicKey?.map(e=>e.toString()),H0:e.H0?[e.H0[0].toString(),e.H0[1].toString()]:void 0}),t=e=>({...e,amount:BigInt(e.amount),randomization:e.randomization?BigInt(e.randomization):void 0,spendingPublicKey:e.spendingPublicKey?.map(e=>BigInt(e)),H0:e.H0?[BigInt(e.H0[0]),BigInt(e.H0[1])]:void 0});exports.deserializeUtxoConstructorParams=t,exports.serializeUtxoConstructorParams=e;

package/functions/utils/serialize-utxos.utils.d.ts

@@ -0,0 +1,3 @@
+import { IUtxoConstructor } from '../../data-structures/utxo/Utxo';
+export declare const serializeUtxoConstructorParams: (params: IUtxoConstructor<bigint>) => IUtxoConstructor<string>;
+export declare const deserializeUtxoConstructorParams: (params: IUtxoConstructor<string>) => IUtxoConstructor<bigint>;

package/functions/utils/serialize-utxos.utils.mjs

@@ -0,0 +1,16 @@
+//#region libs/shared/common/src/functions/utils/serialize-utxos.utils.ts
+var e = (e) => ({
+	...e,
+	amount: e.amount.toString(),
+	randomization: e.randomization?.toString(),
+	spendingPublicKey: e.spendingPublicKey?.map((e) => e.toString()),
+	H0: e.H0 ? [e.H0[0].toString(), e.H0[1].toString()] : void 0
+}), t = (e) => ({
+	...e,
+	amount: BigInt(e.amount),
+	randomization: e.randomization ? BigInt(e.randomization) : void 0,
+	spendingPublicKey: e.spendingPublicKey?.map((e) => BigInt(e)),
+	H0: e.H0 ? [BigInt(e.H0[0]), BigInt(e.H0[1])] : void 0
+});
+//#endregion
+export { t as deserializeUtxoConstructorParams, e as serializeUtxoConstructorParams };

package/functions/utils/serialize.utils.cjs

@@ -0,0 +1 @@
+var e=t=>typeof t==`bigint`?t.toString():typeof t!=`object`||!t?t:Array.isArray(t)?t.map(t=>e(t)):t instanceof Date?t.toISOString():Object.fromEntries(Object.entries(t).map(([t,n])=>[t,e(n)])),t=(e,t=null,n)=>JSON.stringify(e,(e,n)=>{let r=typeof t==`function`?t(e,n):n;return typeof r==`bigint`?r.toString():r},n),n=e=>JSON.stringify(e,(e,t)=>typeof t==`bigint`?`bigint:${t.toString()}`:t),r=e=>JSON.parse(e,(e,t)=>typeof t==`string`&&t.startsWith(`bigint:`)?BigInt(t.slice(7)):t);exports.CustomJSONParse=r,exports.CustomJSONStringify=n,exports.safeJsonStringify=t,exports.toJsonSafe=e;

package/functions/utils/serialize.utils.d.ts

@@ -0,0 +1,10 @@
+type JsonReplacer = ((key: string, value: any) => any) | null;
+/**
+ * Deep-clones a value into plain JSON-serializable data: every `bigint` becomes a decimal string.
+ * Use with `res.json(...)` so Express never hits "Do not know how to serialize a BigInt".
+ */
+export declare const toJsonSafe: (value: unknown) => unknown;
+export declare const safeJsonStringify: (value: unknown, replacer?: JsonReplacer, space?: string | number) => string;
+export declare const CustomJSONStringify: (args: any) => string;
+export declare const CustomJSONParse: (stringifiedJSON: string) => any;
+export {};

package/functions/utils/serialize.utils.mjs

@@ -0,0 +1,7 @@
+//#region libs/shared/common/src/functions/utils/serialize.utils.ts
+var e = (t) => typeof t == "bigint" ? t.toString() : typeof t != "object" || !t ? t : Array.isArray(t) ? t.map((t) => e(t)) : t instanceof Date ? t.toISOString() : Object.fromEntries(Object.entries(t).map(([t, n]) => [t, e(n)])), t = (e, t = null, n) => JSON.stringify(e, (e, n) => {
+	let r = typeof t == "function" ? t(e, n) : n;
+	return typeof r == "bigint" ? r.toString() : r;
+}, n), n = (e) => JSON.stringify(e, (e, t) => typeof t == "bigint" ? `bigint:${t.toString()}` : t), r = (e) => JSON.parse(e, (e, t) => typeof t == "string" && t.startsWith("bigint:") ? BigInt(t.slice(7)) : t);
+//#endregion
+export { r as CustomJSONParse, n as CustomJSONStringify, t as safeJsonStringify, e as toJsonSafe };

package/functions/utils/solana-memo.cjs

@@ -0,0 +1 @@
+require(`../../_virtual/_rolldown/runtime.cjs`);let e=require(`@solana/web3.js`);var t=new e.PublicKey(`MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr`),n=`hinkal-pal:`,r=r=>new e.TransactionInstruction({keys:[],programId:t,data:Buffer.from(`${n}${r.replace(/-/g,``)}`,`utf8`)}),i=(e,r)=>e.map(e=>{if(!r.get(e.programIdIndex)?.equals(t))return null;let i=Buffer.from(e.data).toString(`utf8`);if(!i.startsWith(n))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;exports.buildOrderIdMemoInstruction=r,exports.extractOrderIdFromMemos=i;

package/functions/utils/solana-memo.d.ts

@@ -0,0 +1,3 @@
+import { MessageAccountKeys, MessageCompiledInstruction, TransactionInstruction } from '@solana/web3.js';
+export declare const buildOrderIdMemoInstruction: (orderId: string) => TransactionInstruction;
+export declare const extractOrderIdFromMemos: (instructions: MessageCompiledInstruction[], accountKeys: MessageAccountKeys) => string | null;

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

@@ -0,0 +1 @@
+require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../crypto/poseidon.cjs`);let t=require(`ethers`),n=require(`@solana/web3.js`);var r=e=>{let n=e.toBytes();return BigInt(t.ethers.hexlify(n))},i=t=>{let i=typeof t==`string`?new n.PublicKey(t):t,a=r(i),o=a/2n**128n,s=a%2n**128n;return{mintAccountPart1:o,mintAccountPart2:s,compressedAddress:e.poseidonHash(o,s),mintPublicKey:i}};exports.convertPublicKeyToBigint=r,exports.formatMintAddress=i;

package/functions/utils/solanaMint.utils.d.ts

@@ -0,0 +1,10 @@
+import { PublicKey } from '@solana/web3.js';
+type FormattedMintAddress = {
+    mintAccountPart1: bigint;
+    mintAccountPart2: bigint;
+    compressedAddress: string;
+    mintPublicKey: PublicKey;
+};
+export declare const convertPublicKeyToBigint: (key: PublicKey) => bigint;
+export declare const formatMintAddress: (mint: PublicKey | string) => FormattedMintAddress;
+export {};

package/functions/utils/solanaMint.utils.mjs

@@ -0,0 +1,18 @@
+import { poseidonHash as e } from "../../crypto/poseidon.mjs";
+import { ethers as t } from "ethers";
+import { PublicKey as n } from "@solana/web3.js";
+//#region libs/shared/common/src/functions/utils/solanaMint.utils.ts
+var r = (e) => {
+	let n = e.toBytes();
+	return BigInt(t.hexlify(n));
+}, i = (t) => {
+	let i = typeof t == "string" ? new n(t) : t, a = r(i), o = a / 2n ** 128n, s = a % 2n ** 128n;
+	return {
+		mintAccountPart1: o,
+		mintAccountPart2: s,
+		compressedAddress: e(o, s),
+		mintPublicKey: i
+	};
+};
+//#endregion
+export { r as convertPublicKeyToBigint, i as formatMintAddress };

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

@@ -0,0 +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@]+\.[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.d.ts

@@ -0,0 +1,16 @@
+/** Capitalize the first letter of each word
+ * "This is an example" => "This Is An Example"
+ */
+export declare function toTitleCase(str: string): string;
+/** Capitalize the first letter of a string */
+export declare function capitalizeFirstLetter(str: string): string;
+/** Returns true if a value is null, undefined, or an empty object, array (length 0), or string (e.g. '') */
+export declare function isNullOrEmpty(obj: unknown): boolean;
+export declare const hexToUtf8: (hex: string) => string;
+export declare const getTokenStateKey: (address: string, chainId: number) => string;
+export declare const getStateKey: (address: string, chainId: number, withHinkalContractAddress?: boolean) => string;
+export declare const getChainIdFromStateKey: (stateKey: string) => number;
+export declare const getAddressFromStateKey: (stateKey: string) => string;
+export declare const replaceAllInstances: (text: string, oldPart: string, newPart: string) => string;
+export declare const capitalizeName: (name: string | undefined | null) => string | null;
+export declare const validateEmail: (email: string | undefined | null) => boolean;

package/functions/utils/string.utils.mjs

@@ -0,0 +1,41 @@
+import { isSolanaLike as e, isTronLike as t, networkRegistry as n } from "../../constants/chains.constants.mjs";
+//#region libs/shared/common/src/functions/utils/string.utils.ts
+function r(e) {
+	return e?.toLowerCase().split(" ").map((e) => e.charAt(0).toUpperCase() + e.substring(1)).join(" ");
+}
+function i(e) {
+	return e.charAt(0).toUpperCase() + e.slice(1);
+}
+function a(e) {
+	return !e || e === null || Array.isArray(e) && e.length === 0 ? !0 : Object.keys(e).length === 0 && e.constructor === Object;
+}
+var o = (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));
+}, s = (n, r) => {
+	let i = `${n}-${r}`;
+	return e(r) || t(r) ? i : i.toLowerCase();
+}, c = (e, t, r = !1) => {
+	let i = `${e}-${t}`;
+	if (r) {
+		let { hinkalAddress: e } = n[t].contractData;
+		return `${i}-${e}`.toLowerCase();
+	}
+	return i.toLowerCase();
+}, l = (e) => {
+	let [, t] = e.split("-");
+	return Number(t);
+}, u = (e) => {
+	let [t] = e.split("-");
+	return t;
+}, 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@]+\.[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

@@ -0,0 +1 @@
+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

@@ -0,0 +1,19 @@
+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;
+export declare const getEffectiveToday: () => Date;
+export declare const getEffectiveSevenDaysAgo: () => Date;
+export declare const getCurrentWeekStart: () => Date;
+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

@@ -0,0 +1,58 @@
+//#region libs/shared/common/src/functions/utils/time.utils.ts
+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 = /* @__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;
+}, 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 = /* @__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();
+}, 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();
+}, 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;
+}, 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();
+}, p = (e) => {
+	let t = (/* @__PURE__ */ 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 = /* @__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 { 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

@@ -0,0 +1 @@
+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

@@ -0,0 +1,5 @@
+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

@@ -0,0 +1,18 @@
+import { caseInsensitiveEqual as e } from "./caseInsensitive.utils.mjs";
+import { API as t } from "../../API/API.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 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;
+}, 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.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 { 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;
+}>;