@kapa123456789/sdk 0.0.39 → 0.0.40

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/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.d.ts

@@ -0,0 +1,2 @@
+export declare const convertBytes32ToBigInt: (bytes32: number[]) => bigint;
+export declare const convertBigIntToBytes32: (value: bigint) => number[];

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`),t=require(`../../data-structures/cacheDevices/FileCacheDevice.cjs`),n=require(`../../data-structures/cacheDevices/LocalStorageCacheDevice.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,15 @@
+import { __require as e } from "../../../../_virtual/_rolldown/runtime.mjs";
+import { isNode as t } from "../../constants/vite.constants.mjs";
+import { FileCacheDevice as n } from "../../data-structures/cacheDevices/FileCacheDevice.mjs";
+import { LocalStorageCacheDevice as r } from "../../data-structures/cacheDevices/LocalStorageCacheDevice.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`);require(`idb-keyval`);var n={encryptedOutputs:[],lastOutput:``},r=(e,t)=>({shortPublicKey:e.substring(0,25),shortHinkalAddress:t.substring(0,25)}),i=(e,t,n)=>`hinkalCache-${e}-${t}-${n}`,a=(a,o,s)=>{let{hinkalAddress:c}=t.networkRegistry[o].contractData;if(!o||!s||!c)throw Error(`GetHinkalCache: incorrect arguments`);let{shortPublicKey:l,shortHinkalAddress:u}=r(s,c);return JSON.parse(a.cacheDevice.get(i(o,l,u))??e.safeJsonStringify(n))},o=(n,a,o,s)=>{let{hinkalAddress:c}=t.networkRegistry[o].contractData;if(!o||!s||!c)throw Error(`SetHinkalCache: incorrect arguments`);let{shortPublicKey:l,shortHinkalAddress:u}=r(s,c);a.cacheDevice.set(i(o,l,u),e.safeJsonStringify(n))},s=(e,t,r)=>{o(n,e,t,r)};exports.getHinkalCache=a,exports.resetCache=s,exports.setHinkalCache=o;

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,25 @@
+import { safeJsonStringify as e } from "./serialize.utils.mjs";
+import { networkRegistry as t } from "../../constants/chains.constants.mjs";
+import "idb-keyval";
+//#region libs/shared/common/src/functions/utils/cacheFunctions.ts
+var n = {
+	encryptedOutputs: [],
+	lastOutput: ""
+}, r = (e, t) => ({
+	shortPublicKey: e.substring(0, 25),
+	shortHinkalAddress: t.substring(0, 25)
+}), i = (e, t, n) => `hinkalCache-${e}-${t}-${n}`, a = (a, o, s) => {
+	let { hinkalAddress: c } = t[o].contractData;
+	if (!o || !s || !c) throw Error("GetHinkalCache: incorrect arguments");
+	let { shortPublicKey: l, shortHinkalAddress: u } = r(s, c);
+	return JSON.parse(a.cacheDevice.get(i(o, l, u)) ?? e(n));
+}, o = (n, a, o, s) => {
+	let { hinkalAddress: c } = t[o].contractData;
+	if (!o || !s || !c) throw Error("SetHinkalCache: incorrect arguments");
+	let { shortPublicKey: l, shortHinkalAddress: u } = r(s, c);
+	a.cacheDevice.set(i(o, l, u), e(n));
+}, s = (e, t, r) => {
+	o(n, e, t, r);
+};
+//#endregion
+export { a as getHinkalCache, s as resetCache, o as setHinkalCache };

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.d.ts

@@ -0,0 +1,3 @@
+export declare const caseInsensitiveEqual: (a?: string | null, b?: string | null) => boolean;
+export declare const lowerCaseIncludes: (array: string[], address?: string) => boolean;
+export declare const lowerCaseStartsWith: (array: string[], s: string) => boolean;

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.d.ts

@@ -0,0 +1,2 @@
+import { CallInfo } from '../../types/API.types';
+export declare const convertEmporiumOpToCallInfo: (op: string, walletAddress: string, chainId: number) => CallInfo;

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.d.ts

@@ -0,0 +1,3 @@
+import { IntegrationProvider } from '../../types/hinkal.types';
+import { ExternalActionId } from '../../types/external-action.types';
+export declare const convertIntegrationProviderToExternalActionId: (integrationProvider: IntegrationProvider) => ExternalActionId | undefined;

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.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/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/enclave-recipient-info-storage.d.ts

@@ -0,0 +1,2 @@
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+export declare const ensureRecipientInfoPool: (hinkal: IHinkal, address: string) => Promise<void>;

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-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/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.d.ts

@@ -0,0 +1,2 @@
+import { TokenWithId } from '../../types/token-with-id.types';
+export declare const encodeTokenWithId: (chainId: number, tokenWithId: TokenWithId) => string;

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`);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=o.util.decode64(e),r=o.asn1.fromDer(o.util.createBuffer(n)),i=o.pki.publicKeyFromAsn1(r),a=o.util.binary.raw.encode(t),s=i.encrypt(a,`RSA-OAEP`,{md:o.md.sha1.create(),mgf1:{md:o.md.sha1.create()}});return o.util.encode64(s)},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.d.ts

@@ -0,0 +1,8 @@
+export declare const makeEnclaveHandshakeAndEncryptInput: (input: any) => Promise<{
+    keyCiphertext: string;
+    inputCiphertext: string;
+}>;
+export declare const makeEnclaveHandshakeAndEncryptUint8Array: (inputUint8Array: Uint8Array) => Promise<{
+    keyCiphertext: string;
+    inputCiphertext: string;
+}>;

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

@@ -0,0 +1,33 @@
+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 { 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 = a.util.decode64(e), r = a.asn1.fromDer(a.util.createBuffer(n)), i = a.pki.publicKeyFromAsn1(r), o = a.util.binary.raw.encode(t), s = i.encrypt(o, "RSA-OAEP", {
+		md: a.md.sha1.create(),
+		mgf1: { md: a.md.sha1.create() }
+	});
+	return a.util.encode64(s);
+}, 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.d.ts

@@ -0,0 +1,9 @@
+/** Verifies that the value is in the enumType specified */
+export declare function isInEnum<T>(enumType: T, value: any): value is T[keyof T];
+/** Converts a string value to an Enum member
+ *  If a value can't be matched to a valid option in the enum, returns undefined (or throws if throwIfInvalid = true) */
+export declare function toEnumValue<T>(e: T, value: any, throwIfInvalid?: boolean): T[keyof T] | undefined;
+/** returns first item in an enum that is included somewhere in the target string
+ * e.g. enumInString(ErrorCode, '001-badpassword: error') => ErrorCode.BadPassword
+ */
+export declare function enumInString<T extends Record<string, string>>(enumType: T, searchString: any): T[keyof T] | undefined;

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`),n=require(`../../data-structures/custom-token-registry/CustomTokenRegistry.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,15 @@
+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 overlayTokenWithRegistryData: (token: ERC20Token, chainId: number) => ERC20Token;
+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,11 @@
+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 { customTokenRegistry as n } from "../../data-structures/custom-token-registry/CustomTokenRegistry.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.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/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.d.ts

@@ -0,0 +1,3 @@
+import { ExternalActionId } from '../../types/external-action.types';
+export declare const getExternalActionIdHash: (externalActionId: ExternalActionId | 0n) => bigint;
+export declare const getExternalActionIdFromNumber: (externalActionIdNumber: string | bigint) => ExternalActionId | undefined;

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.d.ts

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

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.d.ts

@@ -0,0 +1,5 @@
+export declare const getSignatureHeader: (signature?: string) => {
+    headers: {
+        'x-user-signature': string | undefined;
+    };
+};

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.d.ts

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

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`);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.d.ts

@@ -0,0 +1,2 @@
+import { UserKeys } from '../../data-structures/crypto-keys';
+export declare const getRecipientInfoFromUserKeys: (userKeys: UserKeys) => string;

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

@@ -0,0 +1,14 @@
+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";
+//#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`),n=require(`./caseInsensitive.utils.cjs`),r=require(`./getContractAddress.cjs`),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[];

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

@@ -0,0 +1,28 @@
+import "../../constants/chains.constants.mjs";
+import { ContractType as e } from "../../types/ethereum-network.types.mjs";
+import { toBigInt as t } from "./amounts.utils.mjs";
+import { caseInsensitiveEqual as n } from "./caseInsensitive.utils.mjs";
+import { getContractAddress as r } from "./getContractAddress.mjs";
+import { decodeUtxo as i } from "../../data-structures/crypto-keys/decodeUTXO.mjs";
+import "ethers";
+//#region libs/shared/common/src/functions/utils/getUtxosFromReceipt.utils.ts
+var a = (a, o, s, c) => {
+	let l = o.getContractWithFetcher(s, e.HinkalContract), u = l.interface, d = o.userKeys.getShieldedPrivateKey(), f = r(l);
+	return a.logs.filter((e) => n(e.address, f)).map((e) => {
+		try {
+			let r = u.parseLog(e);
+			if (r?.name === "NewCommitment") {
+				let { encryptedOutput: e, index: a } = r.args;
+				if (t(a) < 0n) {
+					let t = i(e, d, s);
+					if (n(t.erc20TokenAddress, c)) return t;
+				}
+			}
+		} catch {
+			return null;
+		}
+		return null;
+	}).filter((e) => e !== null);
+};
+//#endregion
+export { a as getOnChainUtxosFromReceipt };

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

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`),require(`../../constants/chains.constants.cjs`);const e=require(`../../crypto/poseidon.cjs`),t=require(`./caseInsensitive.utils.cjs`),n=require(`../../data-structures/utxo/Utxo.cjs`),r=require(`./bytes32.utils.cjs`);let i=require(`@coral-xyz/anchor`),a=require(`@solana/web3.js`);var o=(o,s,c,l)=>[...new i.EventParser(s.programId,new i.BorshCoder(s.idl)).parseLogs(o.meta?.logMessages??[])].filter(({name:e})=>t.caseInsensitiveEqual(e,`newCommitment`)).filter(({data:e})=>e.encryptedOutput.length===0).map(t=>{let{onChainData:i}=t.data,[o,s,l,u,,,,d]=i.map(r.convertBytes32ToBigInt),[,f,p]=i,m=new a.PublicKey([...f.slice(16),...p.slice(16)]),h=e.poseidonHash(s,l),g=new n.Utxo({amount:o,timeStamp:d.toString(),randomization:u,shieldedPrivateKey:c.getShieldedPrivateKey(),mintAddress:m.toBase58(),erc20TokenAddress:h});return g.getStealthAddress(),g}).filter(e=>t.caseInsensitiveEqual(e.erc20TokenAddress,l));exports.getOnChainUtxosFromReceiptSolana=o;

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

@@ -0,0 +1,7 @@
+import { TransactionResponse, VersionedTransactionResponse } from '@solana/web3.js';
+import { Utxo } from '../../data-structures/utxo/Utxo';
+import { Program } from '@coral-xyz/anchor';
+import { UserKeys } from '../../data-structures/crypto-keys/keys';
+export declare const getOnChainUtxosFromReceiptSolana: (tx: VersionedTransactionResponse | TransactionResponse, hinkalProgram: Program, userKeys: UserKeys, tokenAddress: string) => Utxo[];
+export declare const getUtxosFromReceiptSolana: (tx: VersionedTransactionResponse | TransactionResponse, hinkalProgram: Program, userKeys: UserKeys, tokenAddress: string) => Utxo[];
+export declare const getOutputCommitmentsFromSolanaReceipt: (chainId: number, tx: VersionedTransactionResponse | TransactionResponse) => string[];