@kapa123456789/sdk 0.0.39 → 0.0.40

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

@@ -0,0 +1,21 @@
+import "../../constants/chains.constants.mjs";
+import { poseidonHash as e } from "../../crypto/poseidon.mjs";
+import { caseInsensitiveEqual as t } from "./caseInsensitive.utils.mjs";
+import { Utxo as n } from "../../data-structures/utxo/Utxo.mjs";
+import { convertBytes32ToBigInt as r } from "./bytes32.utils.mjs";
+import { BorshCoder as i, EventParser as a } from "@coral-xyz/anchor";
+import { PublicKey as o } from "@solana/web3.js";
+//#region libs/shared/common/src/functions/utils/getUtxosFromReceiptSolana.ts
+var s = (s, c, l, u) => [...new a(c.programId, new i(c.idl)).parseLogs(s.meta?.logMessages ?? [])].filter(({ name: e }) => t(e, "newCommitment")).filter(({ data: e }) => e.encryptedOutput.length === 0).map((t) => {
+	let { onChainData: i } = t.data, [a, s, c, u, , , , d] = i.map(r), [, f, p] = i, m = new o([...f.slice(16), ...p.slice(16)]), h = e(s, c), g = new n({
+		amount: a,
+		timeStamp: d.toString(),
+		randomization: u,
+		shieldedPrivateKey: l.getShieldedPrivateKey(),
+		mintAddress: m.toBase58(),
+		erc20TokenAddress: h
+	});
+	return g.getStealthAddress(), g;
+}).filter((e) => t(e.erc20TokenAddress, u));
+//#endregion
+export { s as getOnChainUtxosFromReceiptSolana };

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

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

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

@@ -0,0 +1,2 @@
+import { ParsedInLogicMetadata } from '../../types/hinkal.types';
+export declare const encodeParsedInLogicMetadata: (metadata: ParsedInLogicMetadata) => string;

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

@@ -0,0 +1,66 @@
+export * from './amounts.utils';
+export * from './cacheFunctions';
+export * from './create-provider';
+export * from './external-action.utils';
+export * from './erc20tokenFunctions';
+export * from './requireEnv';
+export * from './resolve-sync.utils';
+export * from './convertIntegrationProviderToExternalActionId';
+export * from '../pre-transaction';
+export * from './evmNetworkFunctions';
+export * from './userAgent';
+export * from './getDataFromTransaction';
+export * from './reloadPage';
+export * from './string.utils';
+export * from './nickname.utils';
+export * from './caseInsensitive.utils';
+export * from './time.utils';
+export * from './cacheDevice.utils';
+export * from './process.utils';
+export * from './getBlockExplorerUrl';
+export * from './involves-permit2-op';
+export * from './upToDateState';
+export * from './serialize.utils';
+export * from './convertEmporiumOpToCallInfo';
+export * from './getRecipientInfoFromUserKeys';
+export * from './publicBalance.utils';
+export * from './rpc-int-encode';
+export * from './token-check.utils';
+export * from './arraysMatch';
+export * from './addresses';
+export * from './trimFieldValues';
+export * from './walletBalances.utils';
+export * from './mutexes.utils';
+export * from './nftTokenFunctions';
+export * from './inLogicMetadata';
+export * from './networks.utils';
+export * from './is-valid-url';
+export * from './postToOffscreen';
+export * from './get-signature-header';
+export * from './solanaMint.utils';
+export * from './prepareHinkal';
+export * from './bytes32.utils';
+export * from './getUtxosFromReceipt.utils';
+export * from './getUtxosFromReceiptSolana';
+export * from './fees.utils';
+export * from './proxyAvatar.utils';
+export * from './validateUsername';
+export * from './enclave-utxo-storage';
+export * from './enclave-signature-storage';
+export * from './serialize-utxos.utils';
+export * from './tx-confirmation.utils';
+export * from './buildClaimableDepositPlan';
+export * from './pay-routing.utils';
+export * from './formatter';
+export * from './tron.utils';
+export * from './tronSimulation.utils';
+export * from './getSignerFromContract';
+export * from './getContractAddress';
+export * from './deposit-claimable.utils';
+export * from './transfer-claimable.utils';
+export * from './auth.utils';
+export * from './getWalletGroupKey.utils';
+export * from './encryptInputForEnclave';
+export * from './dispatchBalanceRefreshes';
+export * from './lifi.utils';
+export * from './enclave-recipient-info-storage';

package/common/src/functions/utils/involves-permit2-op.cjs

@@ -0,0 +1 @@
+const e=require(`../../constants/permit2.constants.cjs`);var t=t=>t.some(t=>e.uniswapWorkaroundAddresses.some(e=>t.toLowerCase().includes(e.slice(2).toLowerCase())));exports.uniswapWorkaround=t;

package/common/src/functions/utils/involves-permit2-op.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Uniswap appends extra data at the end of the calldada,
+ * which can cause permit and V3 pool approvals to fail.
+ * This function checks whether a workaround is needed by detecting
+ * if any operation includes a known Uniswap-related address.
+ */
+export declare const uniswapWorkaround: (ops: string[]) => boolean;

package/common/src/functions/utils/involves-permit2-op.mjs

@@ -0,0 +1,5 @@
+import { uniswapWorkaroundAddresses as e } from "../../constants/permit2.constants.mjs";
+//#region libs/shared/common/src/functions/utils/involves-permit2-op.ts
+var t = (t) => t.some((t) => e.some((e) => t.toLowerCase().includes(e.slice(2).toLowerCase())));
+//#endregion
+export { t as uniswapWorkaround };

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

@@ -0,0 +1,8 @@
+/**
+ * Formats URL correctly for use retrieving assets hosted on IPFS.
+ *
+ * @param ipfsUrl - The IFPS URL pointed at the asset.
+ * @param subdomainSupported - Boolean indicating whether the URL should be formatted with subdomains or not.
+ * @returns A formatted URL, with the user's preferred IPFS gateway and format (subdomain or not), pointing to an asset hosted on IPFS.
+ */
+export declare const getFormattedIpfsUrl: (ipfsUrl: string, subdomainSupported: boolean) => string;

package/common/src/functions/utils/is-valid-url.d.ts

@@ -0,0 +1 @@
+export declare const isValidUrl: (url?: string) => boolean;

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

@@ -0,0 +1,3 @@
+import { ERC20Token } from '../../types/token.types';
+export declare const getLifiScanURL: (txHash: string) => string;
+export declare const getEquivalentNativeToken: (sourceChainId: number, destChainId: number, fullTokenList: ERC20Token[]) => ERC20Token | undefined;

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

@@ -0,0 +1 @@
+export declare const memoizeFunc: <T extends any[], R>(fn: (...args: T) => R) => (...args: T) => R;

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

@@ -0,0 +1 @@
+const e=require(`../../constants/protocol.constants.cjs`),t=require(`../../crypto/poseidon.cjs`),n=require(`../../data-structures/merkle-tree/MerkleTree.cjs`);var r=e=>new Map(Object.entries(e).map(([e,t])=>[BigInt(e),BigInt(t)])),i=i=>{let a=r(i.tree),o=i.reverseTree?r(i.reverseTree):void 0;return n.MerkleTree.createWithData(a,o,BigInt(i.index),BigInt(i.count),t.poseidonFunction,e.MERKLE_LEVELS,0n)};exports.contructMerkleTreeFromSerialized=i;

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

@@ -0,0 +1,2 @@
+import { MerkleTree, MerkleTreeJson } from '../../data-structures/merkle-tree/MerkleTree';
+export declare const contructMerkleTreeFromSerialized: (merkleTreeSerialized: MerkleTreeJson) => MerkleTree<bigint>;

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

@@ -0,0 +1,10 @@
+import { MERKLE_LEVELS as e } from "../../constants/protocol.constants.mjs";
+import { poseidonFunction as t } from "../../crypto/poseidon.mjs";
+import { MerkleTree as n } from "../../data-structures/merkle-tree/MerkleTree.mjs";
+//#region libs/shared/common/src/functions/utils/merkleTree.utils.ts
+var r = (e) => new Map(Object.entries(e).map(([e, t]) => [BigInt(e), BigInt(t)])), i = (i) => {
+	let a = r(i.tree), o = i.reverseTree ? r(i.reverseTree) : void 0;
+	return n.createWithData(a, o, BigInt(i.index), BigInt(i.count), t, e, 0n);
+};
+//#endregion
+export { i as contructMerkleTreeFromSerialized };

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

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`);let e=require(`async-mutex`);var t=new Map,n=n=>(t.has(n)||t.set(n,new e.Mutex),t.get(n)??new e.Mutex);exports.getChainBalanceFetchingMutex=n;

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

@@ -0,0 +1,2 @@
+import { Mutex } from 'async-mutex';
+export declare const getChainBalanceFetchingMutex: (chainId: number) => Mutex;

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

@@ -0,0 +1,5 @@
+import { Mutex as e } from "async-mutex";
+//#region libs/shared/common/src/functions/utils/mutexes.utils.ts
+var t = /* @__PURE__ */ new Map(), n = (n) => (t.has(n) || t.set(n, new e()), t.get(n) ?? new e());
+//#endregion
+export { n as getChainBalanceFetchingMutex };

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

@@ -0,0 +1 @@
+export declare const getNetworkName: (chainId: number) => string;

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

@@ -0,0 +1,2 @@
+import { RPCSimulationAssetChange } from '../../types/tenderly.api.types';
+export declare const extractTokenIdsFromAssetChanges: (assetChanges: RPCSimulationAssetChange[]) => Record<string, string[]>;

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

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

package/common/src/functions/utils/pay-routing.utils.d.ts

@@ -0,0 +1,4 @@
+import { PrivateSendAllocation } from '../../API';
+import { RecipientRequest, RecipientRoutingResult } from '../../types';
+export declare const mapRecipientRequests: (recipientAddresses: string[], recipientAmounts: bigint[]) => RecipientRequest[];
+export declare const splitRecipientsByAllocations: (recipients: RecipientRequest[], allocations: PrivateSendAllocation[]) => RecipientRoutingResult;

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

@@ -0,0 +1 @@
+var e=(e,t)=>{window.parent&&window.parent.postMessage({type:e,payload:t},`*`)};exports.postToOffscreen=e;

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

@@ -0,0 +1,2 @@
+import { MessagesFromOffscreen } from '../../types/offscreen.types';
+export declare const postToOffscreen: (type: MessagesFromOffscreen, payload: any) => void;

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

@@ -0,0 +1,9 @@
+//#region libs/shared/common/src/functions/utils/postToOffscreen.ts
+var e = (e, t) => {
+	window.parent && window.parent.postMessage({
+		type: e,
+		payload: t
+	}, "*");
+};
+//#endregion
+export { e as postToOffscreen };

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

@@ -0,0 +1,11 @@
+import { ethers } from 'ethers';
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+import { SolanaWallet } from '../../types/solana.types';
+export declare const createSigner: (privateKey: string) => ethers.Wallet;
+export declare const createVoidSigner: (address: string) => ethers.VoidSigner;
+export declare const prepareHinkal: (hinkal: IHinkal, signer: ethers.Wallet) => Promise<void>;
+export declare const prepareEthersProviderAdapter: (hinkal: IHinkal, ethereumAddress: string) => Promise<void>;
+export declare const createVoidSolanaWallet: (hinkal: IHinkal) => SolanaWallet;
+export declare const prepareSolanaProviderAdapter: (hinkal: IHinkal, ethereumAddress: string) => Promise<void>;
+export declare const prepareHinkalWithSignature: (hinkal: IHinkal, ethereumAddress: string, signature: string) => Promise<void>;
+export declare const prepareHinkalFromSeedPhrases: (hinkal: IHinkal, seedPhrases: string[]) => Promise<void>;

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

@@ -0,0 +1 @@
+var e=e=>new Promise(t=>{setTimeout(t,e)}),t=async(t,n={})=>{let r=n.intervalMs??5e3,i=n.timeoutMs??6e4,a=Math.floor(i/r)+1;for(let n=0;n<a;n+=1){try{let e=await t();if(e!=null)return e}catch{}n<a-1&&await e(r)}};exports.pollForValue=t;

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

@@ -0,0 +1,13 @@
+/** pause execution for a number of miliseconds */
+export declare const wait: (miliseconds: number) => Promise<unknown>;
+type PollForValueOptions = {
+    intervalMs?: number;
+    timeoutMs?: number;
+};
+export declare const pollForValue: <T>(fetcher: () => Promise<T | null | undefined>, options?: PollForValueOptions) => Promise<T | undefined>;
+/** only call function once with a given number of milliseconds
+ * Ex: let debounceMyFunc = debounce(myFunc, 1000);
+ * debounceMyFunc(); debounceMyFunc();
+ */
+export declare function debounce(func: (...args: any[]) => void, debounceForMs: number): (...args: any[]) => void;
+export {};

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

@@ -0,0 +1,15 @@
+//#region libs/shared/common/src/functions/utils/process.utils.ts
+var e = (e) => new Promise((t) => {
+	setTimeout(t, e);
+}), t = async (t, n = {}) => {
+	let r = n.intervalMs ?? 5e3, i = n.timeoutMs ?? 6e4, a = Math.floor(i / r) + 1;
+	for (let n = 0; n < a; n += 1) {
+		try {
+			let e = await t();
+			if (e != null) return e;
+		} catch {}
+		n < a - 1 && await e(r);
+	}
+};
+//#endregion
+export { t as pollForValue };

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

@@ -0,0 +1,2 @@
+export declare const PROXY_AVATAR_INDEX_COUNT = 353;
+export declare const getRandomProxyAvatarIndex: () => number;

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

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`),require(`../../constants/chains.constants.cjs`);const e=require(`../../constants/protocol.constants.cjs`);require(`./erc20tokenFunctions.cjs`);const t=require(`../../externalABIs/swapAbi.cjs`);let n=require(`ethers`);require(`@solana/web3.js`),require(`@solana/spl-token`);var r=async(r,i,a)=>{try{let o=a.erc20TokenAddress,s,c=new n.ethers.Contract(a.erc20TokenAddress,t.ERC20ABI,r);s=o===e.zeroAddress?await r.getBalance(i):await c?.balanceOf(i);let l=s;return l<=0n?null:{token:a,balance:l}}catch{return null}};exports.getPublicBalance=r;

package/common/src/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/common/src/functions/utils/publicBalance.utils.mjs

@@ -0,0 +1,23 @@
+import "../../constants/chains.constants.mjs";
+import { zeroAddress as e } from "../../constants/protocol.constants.mjs";
+import "./erc20tokenFunctions.mjs";
+import { ERC20ABI as t } from "../../externalABIs/swapAbi.mjs";
+import { ethers as n } from "ethers";
+import "@solana/web3.js";
+import "@solana/spl-token";
+//#region libs/shared/common/src/functions/utils/publicBalance.utils.ts
+var r = async (r, i, a) => {
+	try {
+		let o = a.erc20TokenAddress, s, c = new n.Contract(a.erc20TokenAddress, t, r);
+		s = o === e ? await r.getBalance(i) : await c?.balanceOf(i);
+		let l = s;
+		return l <= 0n ? null : {
+			token: a,
+			balance: l
+		};
+	} catch {
+		return null;
+	}
+};
+//#endregion
+export { r as getPublicBalance };

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

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

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

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

package/common/src/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/common/src/functions/utils/requireEnv.d.ts

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

package/common/src/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};exports.getSequence=t,exports.resolveSync=e;

package/common/src/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/common/src/functions/utils/resolve-sync.utils.mjs

@@ -0,0 +1,20 @@
+//#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;
+};
+//#endregion
+export { t as getSequence, e as resolveSync };

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

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

package/common/src/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/common/src/functions/utils/serialize.utils.cjs

@@ -0,0 +1 @@
+var e=(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),t=e=>JSON.stringify(e,(e,t)=>typeof t==`bigint`?`bigint:${t.toString()}`:t),n=e=>JSON.parse(e,(e,t)=>typeof t==`string`&&t.startsWith(`bigint:`)?BigInt(t.slice(7)):t);exports.CustomJSONParse=n,exports.CustomJSONStringify=t,exports.safeJsonStringify=e;

package/common/src/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/common/src/functions/utils/serialize.utils.mjs

@@ -0,0 +1,7 @@
+//#region libs/shared/common/src/functions/utils/serialize.utils.ts
+var e = (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), t = (e) => JSON.stringify(e, (e, t) => typeof t == "bigint" ? `bigint:${t.toString()}` : t), n = (e) => JSON.parse(e, (e, t) => typeof t == "string" && t.startsWith("bigint:") ? BigInt(t.slice(7)) : t);
+//#endregion
+export { n as CustomJSONParse, t as CustomJSONStringify, e as safeJsonStringify };

package/common/src/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.formatMintAddress=i;

package/common/src/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/common/src/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 { i as formatMintAddress };

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

@@ -0,0 +1 @@
+const e=require(`../../constants/chains.constants.cjs`);var t=(t,n)=>{let r=`${t}-${n}`;return e.isSolanaLike(n)||e.isTronLike(n)?r:r.toLowerCase()},n=(t,n,r=!1)=>{let i=`${t}-${n}`;if(r){let{hinkalAddress:t}=e.networkRegistry[n].contractData;return`${i}-${t}`.toLowerCase()}return i.toLowerCase()},r=(e,t,n)=>{if(!t||!n)throw Error(`oldPart and newPart must be provided`);return e.toLowerCase().split(t.toLowerCase()).join(n.toLowerCase())};exports.getStateKey=n,exports.getTokenStateKey=t,exports.replaceAllInstances=r;

package/common/src/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/common/src/functions/utils/string.utils.mjs

@@ -0,0 +1,18 @@
+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
+var r = (n, r) => {
+	let i = `${n}-${r}`;
+	return e(r) || t(r) ? i : i.toLowerCase();
+}, i = (e, t, r = !1) => {
+	let i = `${e}-${t}`;
+	if (r) {
+		let { hinkalAddress: e } = n[t].contractData;
+		return `${i}-${e}`.toLowerCase();
+	}
+	return i.toLowerCase();
+}, a = (e, t, n) => {
+	if (!t || !n) throw Error("oldPart and newPart must be provided");
+	return e.toLowerCase().split(t.toLowerCase()).join(n.toLowerCase());
+};
+//#endregion
+export { i as getStateKey, r as getTokenStateKey, a as replaceAllInstances };

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

@@ -0,0 +1 @@
+var e=(e=1e3)=>new Promise(t=>{setTimeout(()=>{t(void 0)},e)}),t=()=>Math.floor(Date.now()/1e3);exports.getCurrentTimeInSeconds=t,exports.waitLittle=e;

package/common/src/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/common/src/functions/utils/time.utils.mjs

@@ -0,0 +1,8 @@
+//#region libs/shared/common/src/functions/utils/time.utils.ts
+var e = (e = 1e3) => new Promise((t) => {
+	setTimeout(() => {
+		t(void 0);
+	}, e);
+}), t = () => Math.floor(Date.now() / 1e3);
+//#endregion
+export { t as getCurrentTimeInSeconds, e as waitLittle };

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

@@ -0,0 +1 @@
+const e=require(`../../error-handling/error-codes.constants.cjs`),t=require(`./caseInsensitive.utils.cjs`);var n=t=>{if(t.length===0)throw Error(`Token array cannot be empty`);let n=t.map(e=>e.chainId),r=n[0];if(!n.every(e=>e===r))throw Error(e.transactionErrorCodes.TOKENS_DO_NOT_BELONG_SAME_CHAIN);return r},r=(e,n)=>!e||!n?!1:t.caseInsensitiveEqual(e.erc20TokenAddress,n.erc20TokenAddress)&&e.chainId===n.chainId;exports.isSameERC20Token=r,exports.validateAndGetChainId=n;

package/common/src/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/common/src/functions/utils/token-check.utils.mjs

@@ -0,0 +1,11 @@
+import { transactionErrorCodes as e } from "../../error-handling/error-codes.constants.mjs";
+import { caseInsensitiveEqual as t } from "./caseInsensitive.utils.mjs";
+//#region libs/shared/common/src/functions/utils/token-check.utils.ts
+var n = (t) => {
+	if (t.length === 0) throw Error("Token array cannot be empty");
+	let n = t.map((e) => e.chainId), r = n[0];
+	if (!n.every((e) => e === r)) throw Error(e.TOKENS_DO_NOT_BELONG_SAME_CHAIN);
+	return r;
+}, r = (e, n) => !e || !n ? !1 : t(e.erc20TokenAddress, n.erc20TokenAddress) && e.chainId === n.chainId;
+//#endregion
+export { r as isSameERC20Token, n as validateAndGetChainId };

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

@@ -0,0 +1,9 @@
+import { ErrorWithIndex } from '../../error-handling';
+import { PrivateSendAllocation } from '../../API';
+import { 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) => Promise<{
+    pendingEnclaveUtxos: PendingEnclaveUtxo[];
+    txHashes: string[];
+    failedRecipientErrorMessage: ErrorWithIndex | undefined;
+}>;

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

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

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

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../constants/chains.constants.cjs`),t=require(`../../constants/protocol.constants.cjs`),n=require(`../snarkjs/constant.cjs`),r=require(`../../data-structures/http/HttpClient.cjs`);let i=require(`ethers`),a=require(`tronweb`);var o=1000n,s=(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},c=e=>e?.startsWith(`T`)?e:a.TronWeb.address.fromHex(e),l=e=>{if(e.startsWith(`0x`))return e;if(e.startsWith(`41`))return e.replace(`41`,`0x`);if(e.startsWith(`T`))return l(a.TronWeb.address.toHex(e));throw Error(`Failed to convert address to hex format`)},u=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}`)},d=(e,t)=>e.map(e=>Array.isArray(e)?d(e,t):t(e)),f=(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=d(n,e=>typeof e==`string`&&e.startsWith(`T`)?l(e):e);return r.encodeFunctionData(t,a)},p=(e,t,n)=>e?BigInt(Math.max((e[t]??0)-(e[n]??0),0)):0n,m=(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)},h=async e=>{let t=`${u(e)}/wallet/getchainparameters`,n=await r.httpClient.post(t,{});if(!n?.chainParameter?.length)throw Error(`Failed to fetch Tron chain parameters from wallet RPC`);return n.chainParameter},g=async(e,t)=>{let n=`${u(e)}/wallet/getaccountresource`,i=l(t),a=i.startsWith(`0x`)?`41${i.slice(2)}`:i;return await r.httpClient.post(n,{address:a,visible:!1})},_=async(e,n,r,i,a,s)=>{let c={input:a,callValue:Number(s),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 h(n),f=m(d,`getEnergyFee`),_=m(d,`getTransactionFee`),v=await g(n,i),y=BigInt(l?.energy_required??u?.energy_used??0),b=p(v,`EnergyLimit`,`EnergyUsed`),x=(y>b?y-b:0n)*f,S=BigInt(Math.ceil((u?.transaction?.raw_data_hex?.length??0)/2)),C=p(v,`freeNetLimit`,`freeNetUsed`)+p(v,`NetLimit`,`NetUsed`),w=x+(S>C?S-C:0n)*_,T=w+w*o/10000n;return T>BigInt(1e9)?BigInt(t.TRON_DEFAULT_FEE_LIMIT_SUN):T},v=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}},y=(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))},b=async(e,t,a,o,s,c)=>{let l=y(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 r.httpClient.post(`${n.ENCLAVE_URL}/sign-proof`,p),{v:h,r:g,s:_}=i.ethers.Signature.from(m.signature.trim());return{v:h,r:g,s:_}},x=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],S=async(e,t,n,r,i=!0)=>{if(e){let{a:e,b:a,c:o,publicSignals:s}=v(t),c=await b(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=l,exports.circomDataToArray=x,exports.createTronCallData=f,exports.createTronWeb=s,exports.estimateTronFeeSunWithPadding=_,exports.evmHexToTronBase58Address=c,exports.parseZkCalldata=v,exports.reorderZkCallData=S;

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

@@ -0,0 +1,33 @@
+import { ethers } from 'ethers';
+import { CircomDataType, DimDataType } from '../../types/circom-data.types';
+import { NewZkCallDataType } from '../../types/snark.types';
+import { TronAccountResources, TronChainParameter } from '../../types/tron.types';
+import { TronWeb } from 'tronweb';
+export declare const detectTronChainIdFromHost: (fullNodeHost: string) => number;
+export declare const createTronWeb: (chainId: number, privateKey?: string) => TronWeb;
+export declare const evmHexToTronBase58Address: (addr: string) => string;
+export declare const addressToHexFormat: (addr: string) => string;
+export declare const createTronCallData: (abi: ethers.InterfaceAbi, functionName: string, args: unknown[]) => string;
+export declare const getAvailableResource: (resources: TronAccountResources | undefined, limitKey: string, usedKey: string) => bigint;
+export declare const getChainParameterValue: (params: TronChainParameter[], key: string) => bigint;
+export declare const fetchTronChainParameters: (chainId: number) => Promise<TronChainParameter[]>;
+export declare const fetchTronAccountResources: (chainId: number, ownerAddress: string) => Promise<TronAccountResources>;
+export declare const estimateTronFeeSunWithPadding: (tronWeb: TronWeb, chainId: number, contractAddress: string, ownerAddress: string, callData: string, callValueSun: bigint) => Promise<bigint>;
+export declare const parseZkCalldata: (zkCallData: NewZkCallDataType) => {
+    a: bigint[];
+    b: bigint[][];
+    c: bigint[];
+    publicSignals: bigint[];
+};
+export declare const getVerifierId: (dimensionsArg: DimDataType, externalActionId: bigint) => bigint;
+export declare const generateProofSignatureRemotely: (a: bigint[], b: bigint[][], c: bigint[], input: bigint[], dimensionsArg: DimDataType, externalActionId: bigint) => Promise<{
+    v: number;
+    r: string;
+    s: string;
+}>;
+export declare const circomDataToArray: (circomData: CircomDataType) => (string | number | bigint | (string | number)[] | (string | bigint)[] | string[][] | (bigint | boolean | bigint[] | import('../..').HinkalLogicAction | (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>;