@sabaaa1/common 0.1.14 → 0.2.28

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

@@ -0,0 +1,5 @@
+export declare const getAuthHeaders: (item: string) => {
+    Authorization: string;
+} | {
+    Authorization?: undefined;
+};

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

@@ -0,0 +1,7 @@
+//#region libs/shared/common/src/functions/utils/auth.utils.ts
+var e = (e) => {
+	let t = localStorage.getItem(e);
+	return t ? { Authorization: `Bearer ${t}` } : {};
+};
+//#endregion
+export { e as getAuthHeaders };

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

@@ -0,0 +1 @@
+require(`../../data-structures/utxo/Utxo.cjs`),require(`./addresses.cjs`),require(`../snarkjs/common.snarkjs.cjs`);

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

@@ -0,0 +1,15 @@
+import { FallbackRecipientUtxoPlan, StealthAddressStructure } from '../../types';
+interface BuildClaimableDepositPlanParams {
+    recipientAmounts: bigint[];
+    recipientAddresses: string[];
+    recipientInfos?: Array<string | undefined>;
+    nonce: bigint;
+    tokenAddress: string;
+    getShieldedPrivateKeyFromNonce: (nonce: bigint) => string;
+}
+export interface ClaimableDepositPlan {
+    stealthAddressStructures: StealthAddressStructure[];
+    fallbackRecipients: FallbackRecipientUtxoPlan[];
+}
+export declare const buildClaimableDepositPlan: ({ recipientAmounts, recipientAddresses, recipientInfos, nonce, tokenAddress, getShieldedPrivateKeyFromNonce, }: BuildClaimableDepositPlanParams) => ClaimableDepositPlan;
+export {};

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

@@ -0,0 +1,3 @@
+import "../../data-structures/utxo/Utxo.mjs";
+import "./addresses.mjs";
+import "../snarkjs/common.snarkjs.mjs";

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

@@ -0,0 +1 @@
+require(`@coral-xyz/anchor`),require(`buffer`);var e=e=>{if(e.length!==32||e.some(e=>!Number.isInteger(e)||e<0||e>=256))throw Error(`invalid bytes32 value`);return e.reduce((e,t)=>e*256n+BigInt(t),0n)};exports.convertBytes32ToBigInt=e;

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

@@ -0,0 +1,9 @@
+import "@coral-xyz/anchor";
+import "buffer";
+//#region libs/shared/common/src/functions/utils/bytes32.utils.ts
+var e = (e) => {
+	if (e.length !== 32 || e.some((e) => !Number.isInteger(e) || e < 0 || e >= 256)) throw Error("invalid bytes32 value");
+	return e.reduce((e, t) => e * 256n + BigInt(t), 0n);
+};
+//#endregion
+export { e as convertBytes32ToBigInt };

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

@@ -0,0 +1 @@
+const e=require(`../../constants/vite.constants.cjs`);require(`../../constants/index.cjs`);const t=require(`../../data-structures/cacheDevices/FileCacheDevice.cjs`),n=require(`../../data-structures/cacheDevices/LocalStorageCacheDevice.cjs`);require(`../../data-structures/cacheDevices/index.cjs`);var r=r=>{if(e.isNode){let e,n;r&&({useFileCache:e,cacheFilePath:n}=r);let i=require(`path`).resolve(process.cwd(),`hinkalCache.json`);return new t.FileCacheDevice(e,n??i)}else return new n.LocalStorageCacheDevice(r?.disableCaching,r?.serializedCache)};exports.createCacheDevice=r;

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

@@ -0,0 +1,3 @@
+import { HinkalConfig } from '../../types/hinkal.types';
+import { FileCacheDevice, LocalStorageCacheDevice } from '../../data-structures/cacheDevices';
+export declare const createCacheDevice: (hinkalConfig?: HinkalConfig) => FileCacheDevice | LocalStorageCacheDevice;

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

@@ -0,0 +1,17 @@
+import { __require as e } from "../../../../_virtual/_rolldown/runtime.mjs";
+import { isNode as t } from "../../constants/vite.constants.mjs";
+import "../../constants/index.mjs";
+import { FileCacheDevice as n } from "../../data-structures/cacheDevices/FileCacheDevice.mjs";
+import { LocalStorageCacheDevice as r } from "../../data-structures/cacheDevices/LocalStorageCacheDevice.mjs";
+import "../../data-structures/cacheDevices/index.mjs";
+//#region libs/shared/common/src/functions/utils/cacheDevice.utils.ts
+var i = (i) => {
+	if (t) {
+		let t, r;
+		i && ({useFileCache: t, cacheFilePath: r} = i);
+		let a = e("path").resolve(process.cwd(), "hinkalCache.json");
+		return new n(t, r ?? a);
+	} else return new r(i?.disableCaching, i?.serializedCache);
+};
+//#endregion
+export { i as createCacheDevice };

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

@@ -0,0 +1 @@
+const e=require(`./serialize.utils.cjs`),t=require(`../../constants/chains.constants.cjs`),n=require(`../../types/ethereum-network.types.cjs`),r=require(`./getContractAddress.cjs`);require(`idb-keyval`);var i={encryptedOutputs:[],lastOutput:``},a=(e,t)=>({shortPublicKey:e.substring(0,25),shortHinkalAddress:t.substring(0,25)}),o=(e,t,n)=>`hinkalCache-${e}-${t}-${n}`,s=(n,r,s)=>{let{hinkalAddress:c}=t.networkRegistry[r].contractData;if(!r||!s||!c)throw Error(`GetHinkalCache: incorrect arguments`);let{shortPublicKey:l,shortHinkalAddress:u}=a(s,c);return JSON.parse(n.cacheDevice.get(o(r,l,u))??e.safeJsonStringify(i))},c=(n,r,i,s)=>{let{hinkalAddress:c}=t.networkRegistry[i].contractData;if(!i||!s||!c)throw Error(`SetHinkalCache: incorrect arguments`);let{shortPublicKey:l,shortHinkalAddress:u}=a(s,c);r.cacheDevice.set(o(i,l,u),e.safeJsonStringify(n))},l=(e,t,n)=>{c(i,e,t,n)},u=(e,t,n)=>`hinkalApprovalsCache-${e}-${t}-${n}`,d=(t,i,o,s)=>{let c=r.getContractAddress(i.getContract(o,n.ContractType.HinkalContract,void 0));if(!o||!s||!c)throw Error(`SetHinkalCache: incorrect arguments`);let{shortPublicKey:l,shortHinkalAddress:d}=a(s,c);i.cacheDevice.set(u(o,l,d),e.safeJsonStringify(t))},f=(t,o,s)=>{let c=r.getContractAddress(t.getContract(o,n.ContractType.HinkalContract,void 0));if(!o||!s||!c)throw Error(`GetHinkalCache: incorrect arguments`);let{shortPublicKey:l,shortHinkalAddress:d}=a(s,c);return JSON.parse(t.cacheDevice.get(u(o,l,d))??e.safeJsonStringify(i))},p=(e,t,n)=>{d({},e,t,n)};exports.getFilePath=o,exports.getHinkalCache=s,exports.getInHinkalAddressesCache=f,exports.getInHinkalAddressesFilePath=u,exports.resetCache=l,exports.resetInHinkalAddressesCache=p,exports.setHinkalCache=c,exports.setInHinkalAddressesCache=d;

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

@@ -0,0 +1,20 @@
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+import { DecodedTx } from '../../types/transactions.types';
+import { EncryptedOutputWithSign } from '../../types/commitments.types';
+export interface HinkalCacheInterface {
+    encryptedOutputs: EncryptedOutputWithSign[];
+    lastOutput: string;
+}
+export declare const getFilePath: (chainId: number, shortPublicKey: string, shortHinkalAddress: string) => string;
+export declare const getHinkalCache: (hinkal: IHinkal, chainId: number, shieldedPublicKey: string) => HinkalCacheInterface;
+export declare const setHinkalCache: (hinkalCache: HinkalCacheInterface, hinkal: IHinkal, chainId: number, shieldedPublicKey: string) => void;
+export declare const resetCache: (hinkal: IHinkal, chainId: number, shieldedPublicKey: string) => void;
+export declare const saveTxsCache: (txs: DecodedTx[], chainId: number, shieldedPublicKey: string, hinkalAddress: string, lastHash: string, hinkal: IHinkal) => Promise<void>;
+export declare const loadTxsCache: (chainId: number, shieldedPublicKey: string, hinkalAddress: string, hinkal: IHinkal) => Promise<{
+    decodedTxs: import('../..').DecodedTxWithUtxos<bigint, bigint>[];
+    lastHash: string | undefined;
+}>;
+export declare const getInHinkalAddressesFilePath: (chainId: number, shortPublicKey: string, shortHinkalAddress: string) => string;
+export declare const setInHinkalAddressesCache: (hinkalCache: Record<string, string>, hinkal: IHinkal, chainId: number, shieldedPublicKey: string) => void;
+export declare const getInHinkalAddressesCache: (hinkal: IHinkal, chainId: number, shieldedPublicKey: string) => Record<string, string>;
+export declare const resetInHinkalAddressesCache: (hinkal: IHinkal, chainId: number, shieldedPublicKey: string) => void;

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

@@ -0,0 +1,39 @@
+import { safeJsonStringify as e } from "./serialize.utils.mjs";
+import { networkRegistry as t } from "../../constants/chains.constants.mjs";
+import { ContractType as n } from "../../types/ethereum-network.types.mjs";
+import { getContractAddress as r } from "./getContractAddress.mjs";
+import "idb-keyval";
+//#region libs/shared/common/src/functions/utils/cacheFunctions.ts
+var i = {
+	encryptedOutputs: [],
+	lastOutput: ""
+}, a = (e, t) => ({
+	shortPublicKey: e.substring(0, 25),
+	shortHinkalAddress: t.substring(0, 25)
+}), o = (e, t, n) => `hinkalCache-${e}-${t}-${n}`, s = (n, r, s) => {
+	let { hinkalAddress: c } = t[r].contractData;
+	if (!r || !s || !c) throw Error("GetHinkalCache: incorrect arguments");
+	let { shortPublicKey: l, shortHinkalAddress: u } = a(s, c);
+	return JSON.parse(n.cacheDevice.get(o(r, l, u)) ?? e(i));
+}, c = (n, r, i, s) => {
+	let { hinkalAddress: c } = t[i].contractData;
+	if (!i || !s || !c) throw Error("SetHinkalCache: incorrect arguments");
+	let { shortPublicKey: l, shortHinkalAddress: u } = a(s, c);
+	r.cacheDevice.set(o(i, l, u), e(n));
+}, l = (e, t, n) => {
+	c(i, e, t, n);
+}, u = (e, t, n) => `hinkalApprovalsCache-${e}-${t}-${n}`, d = (t, i, o, s) => {
+	let c = r(i.getContract(o, n.HinkalContract, void 0));
+	if (!o || !s || !c) throw Error("SetHinkalCache: incorrect arguments");
+	let { shortPublicKey: l, shortHinkalAddress: d } = a(s, c);
+	i.cacheDevice.set(u(o, l, d), e(t));
+}, f = (t, o, s) => {
+	let c = r(t.getContract(o, n.HinkalContract, void 0));
+	if (!o || !s || !c) throw Error("GetHinkalCache: incorrect arguments");
+	let { shortPublicKey: l, shortHinkalAddress: d } = a(s, c);
+	return JSON.parse(t.cacheDevice.get(u(o, l, d)) ?? e(i));
+}, p = (e, t, n) => {
+	d({}, e, t, n);
+};
+//#endregion
+export { o as getFilePath, s as getHinkalCache, f as getInHinkalAddressesCache, u as getInHinkalAddressesFilePath, l as resetCache, p as resetInHinkalAddressesCache, c as setHinkalCache, d as setInHinkalAddressesCache };

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

@@ -0,0 +1 @@
+var e=(e,t)=>e===void 0||t===void 0||e===null||t===null?!1:e.toLowerCase()===t.toLowerCase(),t=(t,n)=>t.some(t=>e(t,n));exports.caseInsensitiveEqual=e,exports.lowerCaseIncludes=t;

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

@@ -0,0 +1,4 @@
+//#region libs/shared/common/src/functions/utils/caseInsensitive.utils.ts
+var e = (e, t) => e === void 0 || t === void 0 || e === null || t === null ? !1 : e.toLowerCase() === t.toLowerCase(), t = (t, n) => t.some((t) => e(t, n));
+//#endregion
+export { e as caseInsensitiveEqual, t as lowerCaseIncludes };

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

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../constants/chains.constants.cjs`);let t=require(`ethers`);var n=(n,r,i)=>{let{hinkalAddress:a}=e.networkRegistry[i].contractData,o=t.ethers.getBytes(n),s=o.slice(0,20),c=o.slice(20,21),[l,u,d,f]=[s,o.slice(21,37),c,o.slice(37)].map(e=>t.ethers.hexlify(e));return{from:BigInt(d)>0?r:a,to:l,value:BigInt(u),calldata:f}};exports.convertEmporiumOpToCallInfo=n;

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

@@ -0,0 +1,19 @@
+import { networkRegistry as e } from "../../constants/chains.constants.mjs";
+import { ethers as t } from "ethers";
+//#region libs/shared/common/src/functions/utils/convertEmporiumOpToCallInfo.ts
+var n = (n, r, i) => {
+	let { hinkalAddress: a } = e[i].contractData, o = t.getBytes(n), s = o.slice(0, 20), c = o.slice(20, 21), [l, u, d, f] = [
+		s,
+		o.slice(21, 37),
+		c,
+		o.slice(37)
+	].map((e) => t.hexlify(e));
+	return {
+		from: BigInt(d) > 0 ? r : a,
+		to: l,
+		value: BigInt(u),
+		calldata: f
+	};
+};
+//#endregion
+export { n as convertEmporiumOpToCallInfo };

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

@@ -0,0 +1 @@
+const e=require(`../../types/hinkal.types.cjs`),t=require(`../../types/external-action.types.cjs`);e.IntegrationProvider.UNISWAP,t.ExternalActionId.Uniswap,e.IntegrationProvider.ODOS,t.ExternalActionId.Odos,e.IntegrationProvider.ONEINCH,t.ExternalActionId.OneInch,e.IntegrationProvider.LIFI,t.ExternalActionId.Lifi,e.IntegrationProvider.OKX,t.ExternalActionId.Okx,e.IntegrationProvider.ALL,e.IntegrationProvider.NONE;

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

@@ -0,0 +1,4 @@
+import { IntegrationProvider as e } from "../../types/hinkal.types.mjs";
+import { ExternalActionId as t } from "../../types/external-action.types.mjs";
+e.UNISWAP, t.Uniswap, e.ODOS, t.Odos, e.ONEINCH, t.OneInch, e.LIFI, t.Lifi, e.OKX, t.Okx, e.ALL, e.NONE;
+//#endregion

package/common/src/functions/utils/create-provider.cjs

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../constants/chains.constants.cjs`);let t=require(`ethers`),n=require(`@solana/web3.js`);var r=n=>{let{fetchRpcUrl:r}=e.networkRegistry[n];if(!r)throw Error(`RPC URL not found for the specified chain ID`);return new t.JsonRpcProvider(r,n,{staticNetwork:!0})},i=(e,t=`confirmed`)=>new n.Connection(e,t);exports.createCustomSolanaConnection=i,exports.createJsonRpcProvider=r;

package/common/src/functions/utils/create-provider.d.ts

@@ -0,0 +1,4 @@
+import { Commitment, Connection, ConnectionConfig } from '@solana/web3.js';
+import { JsonRpcProvider } from 'ethers';
+export declare const createJsonRpcProvider: (chainId: number) => JsonRpcProvider;
+export declare const createCustomSolanaConnection: (endpoint: string, commitmentOrConfig?: Commitment | ConnectionConfig) => Connection;

package/common/src/functions/utils/create-provider.mjs

@@ -0,0 +1,11 @@
+import { networkRegistry as e } from "../../constants/chains.constants.mjs";
+import { JsonRpcProvider as t } from "ethers";
+import { Connection as n } from "@solana/web3.js";
+//#region libs/shared/common/src/functions/utils/create-provider.ts
+var r = (n) => {
+	let { fetchRpcUrl: r } = e[n];
+	if (!r) throw Error("RPC URL not found for the specified chain ID");
+	return new t(r, n, { staticNetwork: !0 });
+}, i = (e, t = "confirmed") => new n(e, t);
+//#endregion
+export { i as createCustomSolanaConnection, r as createJsonRpcProvider };

package/common/src/functions/utils/deposit-claimable.utils.cjs

@@ -0,0 +1 @@
+require(`../../types/index.cjs`),require(`../../data-structures/utxo/Utxo.cjs`),require(`./solanaMint.utils.cjs`),require(`./addresses.cjs`),require(`./token-check.utils.cjs`),require(`../../error-handling/index.cjs`),require(`../pre-transaction/index.cjs`),require(`../../constants/index.cjs`),require(`./getUtxosFromReceipt.utils.cjs`),require(`./getUtxosFromReceiptSolana.cjs`),require(`./tx-confirmation.utils.cjs`),require(`./buildClaimableDepositPlan.cjs`);

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

@@ -0,0 +1,6 @@
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+import { ERC20Token, PendingEnclaveUtxo } from '../../types';
+export declare const depositClaimableUtxos: (hinkal: IHinkal, erc20Token: ERC20Token, recipientAmounts: bigint[], recipientAddresses: string[], nonce: bigint, recipientInfos?: Array<string | undefined>) => Promise<{
+    pendingEnclaveUtxos: PendingEnclaveUtxo[];
+    txHash: string;
+}>;

package/common/src/functions/utils/deposit-claimable.utils.mjs

@@ -0,0 +1,12 @@
+import "../../types/index.mjs";
+import "../../data-structures/utxo/Utxo.mjs";
+import "./solanaMint.utils.mjs";
+import "./addresses.mjs";
+import "./token-check.utils.mjs";
+import "../../error-handling/index.mjs";
+import "../pre-transaction/index.mjs";
+import "../../constants/index.mjs";
+import "./getUtxosFromReceipt.utils.mjs";
+import "./getUtxosFromReceiptSolana.mjs";
+import "./tx-confirmation.utils.mjs";
+import "./buildClaimableDepositPlan.mjs";

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

@@ -0,0 +1 @@
+require(`./upToDateState.cjs`),require(`../../error-handling/logger.cjs`),require(`../../mutexes/mutex.cjs`),require(`../web3/events/balanceChangedHandler.cjs`);

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

@@ -0,0 +1,4 @@
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+export declare const initialMerkleAndPrivateBalanceRefresh: (hinkal: IHinkal, skipMerkleReset?: boolean) => Promise<void>;
+export declare const refreshPrivateBalance: (hinkal: IHinkal, makeHardRefresh?: boolean) => Promise<void>;
+export declare const hardRefreshPrivateBalance: (hinkal: IHinkal) => Promise<void>;

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

@@ -0,0 +1,4 @@
+import "./upToDateState.mjs";
+import "../../error-handling/logger.mjs";
+import "../../mutexes/mutex.mjs";
+import "../web3/events/balanceChangedHandler.mjs";

package/common/src/functions/utils/enclave-signature-storage.cjs

@@ -0,0 +1 @@
+require(`./encryptInputForEnclave.cjs`),require(`../../API/enclaveSignatureCalls.cjs`);

package/common/src/functions/utils/enclave-signature-storage.d.ts

@@ -0,0 +1,2 @@
+export declare const storeSignatureInEnclave: (ethAddress: string, signature: string) => Promise<void>;
+export declare const getSignatureFromEnclave: (ethAddress: string, authSignature: string) => Promise<string | undefined>;

package/common/src/functions/utils/enclave-signature-storage.mjs

@@ -0,0 +1,2 @@
+import "./encryptInputForEnclave.mjs";
+import "../../API/enclaveSignatureCalls.mjs";

package/common/src/functions/utils/enclave-utxo-storage.cjs

@@ -0,0 +1 @@
+require(`../../data-structures/utxo/Utxo.cjs`),require(`./encryptInputForEnclave.cjs`),require(`../../API/enclaveUtxoCalls.cjs`),require(`../../error-handling/logger.cjs`);

package/common/src/functions/utils/enclave-utxo-storage.d.ts

@@ -0,0 +1,6 @@
+import { IUtxoConstructor, Utxo } from '../../data-structures/utxo/Utxo';
+export type UtxoConstructorParamsWithSenderAddress = IUtxoConstructor<string> & {
+    senderAddress: string;
+};
+export declare const storeUtxoInEnclave: (senderAddress: string, recipientEthAddress: string, utxo: Utxo, chainId: number) => Promise<void>;
+export declare const getUtxosFromEnclave: (ethAddress: string, signature: string, chainId: number, isSolanaLedger: boolean, txMessageForSolanaLedger?: string) => Promise<UtxoConstructorParamsWithSenderAddress[]>;

package/common/src/functions/utils/enclave-utxo-storage.mjs

@@ -0,0 +1,4 @@
+import "../../data-structures/utxo/Utxo.mjs";
+import "./encryptInputForEnclave.mjs";
+import "../../API/enclaveUtxoCalls.mjs";
+import "../../error-handling/logger.mjs";

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

@@ -0,0 +1 @@
+const e=require(`../../constants/chains.constants.cjs`);var t=(t,n)=>{let r=`${n.erc20TokenAddress}-${n.tokenId}`;return e.isSolanaLike(t)?r:r.toLowerCase()};exports.encodeTokenWithId=t;

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

@@ -0,0 +1,8 @@
+import { isSolanaLike as e } from "../../constants/chains.constants.mjs";
+//#region libs/shared/common/src/functions/utils/encodeTokenWithId.ts
+var t = (t, n) => {
+	let r = `${n.erc20TokenAddress}-${n.tokenId}`;
+	return e(t) ? r : r.toLowerCase();
+};
+//#endregion
+export { t as encodeTokenWithId };

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

@@ -0,0 +1 @@
+const e=require(`../../../../_virtual/_rolldown/runtime.cjs`),t=require(`./serialize.utils.cjs`),n=require(`../snarkjs/constant.cjs`),r=require(`../../data-structures/http/HttpClient.cjs`);require(`../../data-structures/http/index.cjs`);let i=require(`ethers`),a=require(`libsodium-wrappers`);a=e.__toESM(a);let o=require(`node-forge`);o=e.__toESM(o);var s=async()=>(await r.httpClient.get(`${n.ENCLAVE_URL}/handshake`)).public_key,c=e=>typeof e==`bigint`||typeof e==`number`?e.toString():e,l=e=>o.util.hexToBytes(e.replace(`0x`,``)),u=e=>{let t=structuredClone(e);return Object.entries(t).forEach(([e,n])=>{t[e]=c(n),Array.isArray(n)&&(Array.isArray(n[0])?t[e]=n.map(e=>e.map(c)):t[e]=n.map(c))}),t},d=(e,t)=>{let n=new Uint8Array(Buffer.from(e,`base64`)),r=a.default.crypto_box_seal(t,n);return Buffer.from(r).toString(`base64`)},f=(e,t)=>{let n=a.default.randombytes_buf(a.default.crypto_secretbox_NONCEBYTES),r=a.default.crypto_secretbox_easy(t,n,e),s=l(i.ethers.hexlify(n)+i.ethers.hexlify(r).slice(2));return o.util.encode64(s)},p=(e,t)=>{let n=a.default.randombytes_buf(a.default.crypto_secretbox_KEYBYTES);return{keyCiphertext:d(t,n),inputCiphertext:f(n,e)}},m=(e,n)=>{let r=typeof e==`string`?e:t.safeJsonStringify(u(e));return p(new TextEncoder().encode(r),n)},h=async e=>m(e,await s()),g=async e=>p(e,await s());exports.makeEnclaveHandshakeAndEncryptInput=h,exports.makeEnclaveHandshakeAndEncryptUint8Array=g;

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

@@ -0,0 +1,31 @@
+import { safeJsonStringify as e } from "./serialize.utils.mjs";
+import { ENCLAVE_URL as t } from "../snarkjs/constant.mjs";
+import { httpClient as n } from "../../data-structures/http/HttpClient.mjs";
+import "../../data-structures/http/index.mjs";
+import { ethers as r } from "ethers";
+import i from "libsodium-wrappers";
+import * as a from "node-forge";
+//#region libs/shared/common/src/functions/utils/encryptInputForEnclave.ts
+var o = async () => (await n.get(`${t}/handshake`)).public_key, s = (e) => typeof e == "bigint" || typeof e == "number" ? e.toString() : e, c = (e) => a.util.hexToBytes(e.replace("0x", "")), l = (e) => {
+	let t = structuredClone(e);
+	return Object.entries(t).forEach(([e, n]) => {
+		t[e] = s(n), Array.isArray(n) && (Array.isArray(n[0]) ? t[e] = n.map((e) => e.map(s)) : t[e] = n.map(s));
+	}), t;
+}, u = (e, t) => {
+	let n = new Uint8Array(Buffer.from(e, "base64")), r = i.crypto_box_seal(t, n);
+	return Buffer.from(r).toString("base64");
+}, d = (e, t) => {
+	let n = i.randombytes_buf(i.crypto_secretbox_NONCEBYTES), o = i.crypto_secretbox_easy(t, n, e), s = c(r.hexlify(n) + r.hexlify(o).slice(2));
+	return a.util.encode64(s);
+}, f = (e, t) => {
+	let n = i.randombytes_buf(i.crypto_secretbox_KEYBYTES);
+	return {
+		keyCiphertext: u(t, n),
+		inputCiphertext: d(n, e)
+	};
+}, p = (t, n) => {
+	let r = typeof t == "string" ? t : e(l(t));
+	return f(new TextEncoder().encode(r), n);
+}, m = async (e) => p(e, await o()), h = async (e) => f(e, await o());
+//#endregion
+export { m as makeEnclaveHandshakeAndEncryptInput, h as makeEnclaveHandshakeAndEncryptUint8Array };

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

@@ -0,0 +1 @@
+const e=require(`./serialize.utils.cjs`);function t(e,t){return Object.values(e).includes(t)}function n(n,r,i=!1){if(t(n,r))return r;let a=`Value ${e.safeJsonStringify(r)} is not a valid member of enum ${e.safeJsonStringify(n)}.`;if(i)throw Error(a)}exports.toEnumValue=n;

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

@@ -0,0 +1,12 @@
+import { safeJsonStringify as e } from "./serialize.utils.mjs";
+//#region libs/shared/common/src/functions/utils/enum.utils.ts
+function t(e, t) {
+	return Object.values(e).includes(t);
+}
+function n(n, r, i = !1) {
+	if (t(n, r)) return r;
+	let a = `Value ${e(r)} is not a valid member of enum ${e(n)}.`;
+	if (i) throw Error(a);
+}
+//#endregion
+export { n as toEnumValue };

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

@@ -0,0 +1 @@
+require(`../../constants/chains.constants.cjs`);const e=require(`../../constants/protocol.constants.cjs`),t=require(`../../constants/token-data/ERC20Registry.cjs`);require(`../../constants/token-data/index.cjs`);const n=require(`../../data-structures/custom-token-registry/CustomTokenRegistry.cjs`);require(`../web3/etherFunctions.cjs`),require(`../../constants/tokens.constants.cjs`);var r=e=>{let r=t.getERC20Registry(e),i=n.customTokenRegistry.getCustomTokens(e);return[...r,...i]},i=(e,t,n)=>(n??r(t))?.find(t=>e===void 0?!1:t.erc20TokenAddress.toLowerCase()===e.toLowerCase()),a=(e,t)=>r(t)?.find(t=>e===void 0?!1:t.symbol.toLowerCase()===e.toLowerCase()),o=t=>t.nftTokenType===e.TokenType.ERC721||t.nftTokenType===e.TokenType.ERC1155||t.nftTokenType===e.TokenType.MetaplexNFT||t.nftTokenType===e.TokenType.Token2022NFT||t.nftTokenType===e.TokenType.CompressedNFT;exports.getERC20Token=i,exports.getERC20TokenBySymbol=a,exports.getErc20TokensForChain=r,exports.isNFTToken=o;

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

@@ -0,0 +1,14 @@
+import { ERC20Token, TokenChanges } from '../../types/token.types';
+export declare const getErc20TokensForChain: (chainId: number) => ERC20Token[];
+export declare const getERC20Token: (address: string, chainId: number, fromList?: ERC20Token[]) => ERC20Token | undefined;
+export declare const getERC20TokenBySymbol: (symbol: string, chainId: number) => ERC20Token | undefined;
+export declare const aggregateTokenChanges: (tokenChanges: TokenChanges<bigint>[]) => TokenChanges<bigint>[];
+export declare const formatTokenChangesList: (tokenChanges: TokenChanges<bigint>[]) => {
+    token: ERC20Token;
+    amount: string;
+    nftIds: string[] | undefined;
+}[];
+export declare const isNFTToken: (token: ERC20Token) => boolean;
+export declare const isArcNativeToken: (token: ERC20Token) => boolean;
+export declare const searchCompareFunction: (token: ERC20Token, searchString: string) => boolean;
+export declare const sortTokens: (tokens: ERC20Token[]) => ERC20Token[];

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

@@ -0,0 +1,14 @@
+import "../../constants/chains.constants.mjs";
+import { TokenType as e } from "../../constants/protocol.constants.mjs";
+import { getERC20Registry as t } from "../../constants/token-data/ERC20Registry.mjs";
+import "../../constants/token-data/index.mjs";
+import { customTokenRegistry as n } from "../../data-structures/custom-token-registry/CustomTokenRegistry.mjs";
+import "../web3/etherFunctions.mjs";
+import "../../constants/tokens.constants.mjs";
+//#region libs/shared/common/src/functions/utils/erc20tokenFunctions.ts
+var r = (e) => {
+	let r = t(e), i = n.getCustomTokens(e);
+	return [...r, ...i];
+}, i = (e, t, n) => (n ?? r(t))?.find((t) => e === void 0 ? !1 : t.erc20TokenAddress.toLowerCase() === e.toLowerCase()), a = (e, t) => r(t)?.find((t) => e === void 0 ? !1 : t.symbol.toLowerCase() === e.toLowerCase()), o = (t) => t.nftTokenType === e.ERC721 || t.nftTokenType === e.ERC1155 || t.nftTokenType === e.MetaplexNFT || t.nftTokenType === e.Token2022NFT || t.nftTokenType === e.CompressedNFT;
+//#endregion
+export { i as getERC20Token, a as getERC20TokenBySymbol, r as getErc20TokensForChain, o as isNFTToken };

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

@@ -0,0 +1 @@
+require(`../../constants/index.cjs`);

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

@@ -0,0 +1,3 @@
+import { EthereumNetwork, EthereumNetworkType } from '../../types';
+export declare const getNetworkObject: (chainId: number) => EthereumNetwork;
+export declare const getNetworkType: (network: EthereumNetwork) => EthereumNetworkType;

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

@@ -0,0 +1 @@
+import "../../constants/index.mjs";

package/common/src/functions/utils/external-action.utils.cjs

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../constants/protocol.constants.cjs`);let t=require(`ethers`);var n=n=>n===0n?0n:BigInt(t.ethers.id(n))%e.CIRCOM_P;exports.getExternalActionIdHash=n;

package/common/src/functions/utils/external-action.utils.mjs

@@ -0,0 +1,6 @@
+import { CIRCOM_P as e } from "../../constants/protocol.constants.mjs";
+import { ethers as t } from "ethers";
+//#region libs/shared/common/src/functions/utils/external-action.utils.ts
+var n = (n) => n === 0n ? 0n : BigInt(t.id(n)) % e;
+//#endregion
+export { n as getExternalActionIdHash };

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

@@ -0,0 +1 @@
+const e=require(`../../constants/chains.constants.cjs`),t=require(`../../constants/protocol.constants.cjs`),n=require(`../../constants/fees.constants.cjs`),r=require(`../../types/hinkal.types.cjs`),i=require(`./erc20tokenFunctions.cjs`);var a=(e,t)=>{if(e.length!==t.length)throw Error(`length mismatch`);let n=e.findIndex(e=>e!==0n);return n===-1?r.defaultFeeStructure:{feeToken:t[n],flatFee:e[n],variableRate:0n}},o=r=>{if(!r)return n.EXTENDED_NON_NATIVE_GAS_COST_TOKEN_SYMBOL_OPTIONS;let a=t.zeroAddress;e.isSolanaLike(r)&&(a=t.solanaNativeAddress);let o=i.getERC20Token(a,r)?.symbol;return e.isSolanaLike(r)&&o?[o]:o&&!n.NON_NATIVE_GAS_COST_TOKEN_SYMBOL_OPTIONS(r).includes(o)?[o,...n.NON_NATIVE_GAS_COST_TOKEN_SYMBOL_OPTIONS(r)]:n.NON_NATIVE_GAS_COST_TOKEN_SYMBOL_OPTIONS(r)},s=(e,t)=>{let r=e*t.variableRate/n.BPS_DENOMINATOR;return t.flatFee+r};exports.calculateTotalFee=s,exports.generateFeeStructure=a,exports.getGasTokenSymbols=o;

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

@@ -0,0 +1,5 @@
+import { FeeStructure } from '../../types/hinkal.types';
+export declare const generateFeeStructure: (flatFees: bigint[], erc20TokenAddresses: string[]) => FeeStructure<bigint>;
+export declare const getGasTokenSymbols: (chainId: number | undefined) => string[];
+export declare const calculateTotalFee: (amount: bigint, feeStructure: FeeStructure) => bigint;
+export declare const calculateWithdrawalAmount: (amountWithFee: bigint, feeStructure: FeeStructure) => bigint;

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

@@ -0,0 +1,26 @@
+import { isSolanaLike as e } from "../../constants/chains.constants.mjs";
+import { solanaNativeAddress as t, zeroAddress as n } from "../../constants/protocol.constants.mjs";
+import { BPS_DENOMINATOR as r, EXTENDED_NON_NATIVE_GAS_COST_TOKEN_SYMBOL_OPTIONS as i, NON_NATIVE_GAS_COST_TOKEN_SYMBOL_OPTIONS as a } from "../../constants/fees.constants.mjs";
+import { defaultFeeStructure as o } from "../../types/hinkal.types.mjs";
+import { getERC20Token as s } from "./erc20tokenFunctions.mjs";
+//#region libs/shared/common/src/functions/utils/fees.utils.ts
+var c = (e, t) => {
+	if (e.length !== t.length) throw Error("length mismatch");
+	let n = e.findIndex((e) => e !== 0n);
+	return n === -1 ? o : {
+		feeToken: t[n],
+		flatFee: e[n],
+		variableRate: 0n
+	};
+}, l = (r) => {
+	if (!r) return i;
+	let o = n;
+	e(r) && (o = t);
+	let c = s(o, r)?.symbol;
+	return e(r) && c ? [c] : c && !a(r).includes(c) ? [c, ...a(r)] : a(r);
+}, u = (e, t) => {
+	let n = e * t.variableRate / r;
+	return t.flatFee + n;
+};
+//#endregion
+export { u as calculateTotalFee, c as generateFeeStructure, l as getGasTokenSymbols };

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

@@ -0,0 +1 @@
+require(`../../error-handling/index.cjs`);

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

@@ -0,0 +1 @@
+export declare const formatUSDNumber: (amount: number | null | undefined) => string;

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

@@ -0,0 +1 @@
+import "../../error-handling/index.mjs";

package/common/src/functions/utils/get-signature-header.cjs

@@ -0,0 +1 @@
+var e=e=>({headers:{"x-user-signature":e}});exports.getSignatureHeader=e;

package/common/src/functions/utils/get-signature-header.mjs

@@ -0,0 +1,4 @@
+//#region libs/shared/common/src/functions/utils/get-signature-header.ts
+var e = (e) => ({ headers: { "x-user-signature": e } });
+//#endregion
+export { e as getSignatureHeader };

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

@@ -0,0 +1 @@
+require(`../../constants/chains.constants.cjs`);

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

@@ -0,0 +1 @@
+import "../../constants/chains.constants.mjs";

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

@@ -0,0 +1 @@
+var e=e=>{let{target:t}=e;if(typeof t!=`string`)throw Error(`ENS contract addresses not supported`);return t};exports.getContractAddress=e;

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

@@ -0,0 +1,2 @@
+import { ethers } from 'ethers';
+export declare const getContractAddress: (contract: ethers.BaseContract) => string;

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

@@ -0,0 +1,8 @@
+//#region libs/shared/common/src/functions/utils/getContractAddress.ts
+var e = (e) => {
+	let { target: t } = e;
+	if (typeof t != "string") throw Error("ENS contract addresses not supported");
+	return t;
+};
+//#endregion
+export { e as getContractAddress };

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

@@ -0,0 +1,33 @@
+import { DecodedTx, DecodedTxWithUtxos } from '../../types';
+export declare const deserializeDecodedTxs: (decodedTx: DecodedTxWithUtxos<string, string>) => DecodedTxWithUtxos;
+export declare const serializeDecodedTxs: (decodedTxs: DecodedTx[]) => {
+    input: string;
+    decodedInput: {
+        amountChanges: string[];
+        flatFees: string[];
+        externalActionId: string;
+        stealthAddressStructure: {
+            extraRandomization: string;
+            stealthAddress: string;
+            H0: string;
+            H1: string;
+        };
+        erc20TokenAddresses: string[];
+        externalActionMetadata: string;
+        encryptedOutputs: string[];
+        hookData: import('../..').HookDataType;
+    };
+    status: string;
+    blockNumber: number;
+    timeStamp: number;
+    isError: string;
+    methodId: string;
+    logs: {
+        topics: readonly string[];
+        data: string;
+    }[];
+    hash: string;
+    gas: number;
+    gasPrice: number;
+    contract?: string;
+}[];

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

@@ -0,0 +1 @@
+const e=require(`../../constants/protocol.constants.cjs`),t=require(`../../data-structures/crypto-keys/keys.cjs`),n=require(`../../data-structures/utxo/Utxo.cjs`);require(`../../data-structures/crypto-keys/index.cjs`);var r=r=>{let i=r.getShieldedPrivateKey(),a=t.UserKeys.getEncryptionKeyPair(i).publicKey,o=new n.Utxo({amount:0n,erc20TokenAddress:e.zeroAddress,shieldedPrivateKey:i}),{randomization:s}=o,c=o.getStealthAddress(),{h0:l,h1:u}=t.UserKeys.getStealthAddressCompressedPoints(s,i);return`${s},${c},${a},${l},${u}`};exports.getRecipientInfoFromUserKeys=r;

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

@@ -0,0 +1,15 @@
+import { zeroAddress as e } from "../../constants/protocol.constants.mjs";
+import { UserKeys as t } from "../../data-structures/crypto-keys/keys.mjs";
+import { Utxo as n } from "../../data-structures/utxo/Utxo.mjs";
+import "../../data-structures/crypto-keys/index.mjs";
+//#region libs/shared/common/src/functions/utils/getRecipientInfoFromUserKeys.ts
+var r = (r) => {
+	let i = r.getShieldedPrivateKey(), a = t.getEncryptionKeyPair(i).publicKey, o = new n({
+		amount: 0n,
+		erc20TokenAddress: e,
+		shieldedPrivateKey: i
+	}), { randomization: s } = o, c = o.getStealthAddress(), { h0: l, h1: u } = t.getStealthAddressCompressedPoints(s, i);
+	return `${s},${c},${a},${l},${u}`;
+};
+//#endregion
+export { r as getRecipientInfoFromUserKeys };

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

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`);let e=require(`ethers`);var t=t=>{let{runner:n}=t;if(!(n instanceof e.ethers.AbstractSigner))throw Error(`expected signer`);return n},n=e=>{let{runner:t}=e;if(!t)throw Error(`expected provider`);return t.provider??t};exports.getProviderFromContract=n,exports.getSignerFromContract=t;

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

@@ -0,0 +1,3 @@
+import { ethers } from 'ethers';
+export declare const getSignerFromContract: (contract: ethers.Contract) => ethers.AbstractSigner<any>;
+export declare const getProviderFromContract: (contract: ethers.Contract) => ethers.Provider;

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

@@ -0,0 +1,13 @@
+import { ethers as e } from "ethers";
+//#region libs/shared/common/src/functions/utils/getSignerFromContract.ts
+var t = (t) => {
+	let { runner: n } = t;
+	if (!(n instanceof e.AbstractSigner)) throw Error("expected signer");
+	return n;
+}, n = (e) => {
+	let { runner: t } = e;
+	if (!t) throw Error("expected provider");
+	return t.provider ?? t;
+};
+//#endregion
+export { n as getProviderFromContract, t as getSignerFromContract };

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

@@ -0,0 +1 @@
+require(`../../constants/chains.constants.cjs`);const e=require(`../../types/ethereum-network.types.cjs`),t=require(`./amounts.utils.cjs`);require(`../../types/index.cjs`);const n=require(`./caseInsensitive.utils.cjs`);require(`../../data-structures/crypto-keys/keys.cjs`);const r=require(`./getContractAddress.cjs`);require(`../../data-structures/crypto-keys/encryptDecryptUtxo.cjs`);const i=require(`../../data-structures/crypto-keys/decodeUTXO.cjs`);require(`ethers`);var a=(a,o,s,c)=>{let l=o.getContractWithFetcher(s,e.ContractType.HinkalContract),u=l.interface,d=o.userKeys.getShieldedPrivateKey(),f=r.getContractAddress(l);return a.logs.filter(e=>n.caseInsensitiveEqual(e.address,f)).map(e=>{try{let r=u.parseLog(e);if(r?.name===`NewCommitment`){let{encryptedOutput:e,index:a}=r.args;if(t.toBigInt(a)<0n){let t=i.decodeUtxo(e,d,s);if(n.caseInsensitiveEqual(t.erc20TokenAddress,c))return t}}}catch{return null}return null}).filter(e=>e!==null)};exports.getOnChainUtxosFromReceipt=a;

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

@@ -0,0 +1,6 @@
+import { ethers } from 'ethers';
+import { Utxo } from '../../data-structures/utxo/Utxo';
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+export declare const getOnChainUtxosFromReceipt: (receipt: ethers.TransactionReceipt, hinkal: IHinkal, chainId: number, tokenAddress: string) => Utxo[];
+export declare const getUtxosFromReceipt: (receipt: ethers.TransactionReceipt, hinkal: IHinkal, chainId: number, tokenAddress: string, shieldedPrivateKey: string) => Utxo[];
+export declare const getOutputCommitmentsFromEvmReceipt: (chainId: number, receipt: ethers.TransactionReceipt) => string[];