@gurge/sdk 0.2.32

package/functions/utils/bit.operations.cjs

@@ -0,0 +1 @@
+var e=e=>e|2n**255n,t=e=>e&2n**255n-1n,n=e=>e>>255n&1n;exports.addHighestBitToNumber=e,exports.extractHighestBit=n,exports.takeOffHighestBit=t;

package/functions/utils/bit.operations.d.ts

@@ -0,0 +1,3 @@
+export declare const addHighestBitToNumber: (value: bigint) => bigint;
+export declare const takeOffHighestBit: (value: bigint) => bigint;
+export declare const extractHighestBit: (value: bigint) => bigint;

package/functions/utils/bit.operations.mjs

@@ -0,0 +1,4 @@
+//#region libs/shared/common/src/functions/utils/bit.operations.ts
+var e = (e) => e | 2n ** 255n, t = (e) => e & 2n ** 255n - 1n, n = (e) => e >> 255n & 1n;
+//#endregion
+export { e as addHighestBitToNumber, n as extractHighestBit, t as takeOffHighestBit };

package/functions/utils/buildClaimableDepositPlan.cjs

@@ -0,0 +1 @@
+const e=require(`./addresses.cjs`),t=require(`../web3/etherFunctions.cjs`),n=require(`../../data-structures/crypto-keys/keys.cjs`),r=require(`../../data-structures/utxo/Utxo.cjs`),i=require(`../snarkjs/common.snarkjs.cjs`);var a=({userKeys:a,recipientAmounts:o,recipientAddresses:s,recipientInfos:c,nonce:l,tokenAddress:u})=>{if(s.length!==o.length)throw Error(`recipientAddresses must have the same length as recipientAmounts`);if(c&&c.length!==o.length)throw Error(`recipientInfos must have the same length as recipientAmounts`);let d=c??Array(o.length).fill(void 0),f=0n,p=[];return{stealthAddressStructures:o.map((o,c)=>{let m=d[c];if(m){if(!e.isValidPrivateAddress(m))throw Error(`Invalid recipient info`);return e.constructStealthAddressStructure(m)}let h=l+f;f+=1n;let g=a.getClaimableSignatureFromNonce(h),_=new n.UserKeys(g),v=_.getShieldedPrivateKey(),y=_.getSpendingKeyPair().pubSpendingBJJPoint,b=new r.Utxo({amount:o,erc20TokenAddress:u,nullifyingKey:v,spendingPublicKey:y,isNewStyle:!0});return p.push({recipientIndex:c,recipientAddress:s[c],shieldedPrivateKey:v,claimableSignature:g,utxo:b}),i.calcStealthAddressStructure(b.randomization??n.UserKeys.findCorrectRandomization(t.randomBigInt(31),v),v,y)}),fallbackRecipients:p}};exports.buildClaimableDepositPlan=a;

package/functions/utils/buildClaimableDepositPlan.d.ts

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

package/functions/utils/buildClaimableDepositPlan.mjs

@@ -0,0 +1,39 @@
+import { constructStealthAddressStructure as e, isValidPrivateAddress as t } from "./addresses.mjs";
+import { randomBigInt as n } from "../web3/etherFunctions.mjs";
+import { UserKeys as r } from "../../data-structures/crypto-keys/keys.mjs";
+import { Utxo as i } from "../../data-structures/utxo/Utxo.mjs";
+import { calcStealthAddressStructure as a } from "../snarkjs/common.snarkjs.mjs";
+//#region libs/shared/common/src/functions/utils/buildClaimableDepositPlan.ts
+var o = ({ userKeys: o, recipientAmounts: s, recipientAddresses: c, recipientInfos: l, nonce: u, tokenAddress: d }) => {
+	if (c.length !== s.length) throw Error("recipientAddresses must have the same length as recipientAmounts");
+	if (l && l.length !== s.length) throw Error("recipientInfos must have the same length as recipientAmounts");
+	let f = l ?? Array(s.length).fill(void 0), p = 0n, m = [];
+	return {
+		stealthAddressStructures: s.map((s, l) => {
+			let h = f[l];
+			if (h) {
+				if (!t(h)) throw Error("Invalid recipient info");
+				return e(h);
+			}
+			let g = u + p;
+			p += 1n;
+			let _ = o.getClaimableSignatureFromNonce(g), v = new r(_), y = v.getShieldedPrivateKey(), b = v.getSpendingKeyPair().pubSpendingBJJPoint, x = new i({
+				amount: s,
+				erc20TokenAddress: d,
+				nullifyingKey: y,
+				spendingPublicKey: b,
+				isNewStyle: !0
+			});
+			return m.push({
+				recipientIndex: l,
+				recipientAddress: c[l],
+				shieldedPrivateKey: y,
+				claimableSignature: _,
+				utxo: x
+			}), a(x.randomization ?? r.findCorrectRandomization(n(31), y), y, b);
+		}),
+		fallbackRecipients: m
+	};
+};
+//#endregion
+export { o as buildClaimableDepositPlan };

package/functions/utils/bytes32.utils.cjs

@@ -0,0 +1 @@
+require(`../../_virtual/_rolldown/runtime.cjs`);let e=require(`buffer`),t=require(`@coral-xyz/anchor`);var n=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)},r=n=>[...new t.BN(n.toString()).toArrayLike(e.Buffer,`be`,32)];exports.convertBigIntToBytes32=r,exports.convertBytes32ToBigInt=n;

package/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/functions/utils/bytes32.utils.mjs

@@ -0,0 +1,9 @@
+import { Buffer as e } from "buffer";
+import { BN as t } from "@coral-xyz/anchor";
+//#region libs/shared/common/src/functions/utils/bytes32.utils.ts
+var n = (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);
+}, r = (n) => [...new t(n.toString()).toArrayLike(e, "be", 32)];
+//#endregion
+export { r as convertBigIntToBytes32, n as convertBytes32ToBigInt };

package/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/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/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/functions/utils/cacheFunctions.cjs

@@ -0,0 +1 @@
+require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`./serialize.utils.cjs`),t=require(`../../constants/chains.constants.cjs`),n=require(`./getDataFromTransaction.cjs`);let r=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)=>`txsCache-${e}-${t}-${n}`,d=async(t,i,o,s,c,l)=>{if(!i||!o||!s)throw Error(`saveTxsCache: incorrect arguments`);let{shortPublicKey:d,shortHinkalAddress:f}=a(o,s),p=n.serializeDecodedTxs(t),m=u(i,d,f),h=e.safeJsonStringify({serializedTxs:p,lastHash:c});try{await(0,r.set)(m,h)}catch{l.cacheDevice.set(m,h)}},f={serializedTxs:[],lastHash:``},p=async(t,i,o,s)=>{if(!t||!i||!o)throw Error(`loadTxsCache: incorrect arguments`);let{shortPublicKey:c,shortHinkalAddress:l}=a(i,o),d=u(t,c,l),p;try{let e=await(0,r.get)(d);if(!e)throw Error(`Empty indexedDB cache`);p=e}catch{p=s.cacheDevice.get(d)}let{serializedTxs:m,lastHash:h}=JSON.parse(p??e.safeJsonStringify(f));return{decodedTxs:m.map(e=>n.deserializeDecodedTxs(e)),lastHash:h===``?void 0:h}};exports.getFilePath=o,exports.getHinkalCache=s,exports.loadTxsCache=p,exports.resetCache=l,exports.saveTxsCache=d,exports.setHinkalCache=c;

package/functions/utils/cacheFunctions.d.ts

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

package/functions/utils/cacheFunctions.mjs

@@ -0,0 +1,55 @@
+import { safeJsonStringify as e } from "./serialize.utils.mjs";
+import { networkRegistry as t } from "../../constants/chains.constants.mjs";
+import { deserializeDecodedTxs as n, serializeDecodedTxs as r } from "./getDataFromTransaction.mjs";
+import { get as i, set as a } from "idb-keyval";
+//#region libs/shared/common/src/functions/utils/cacheFunctions.ts
+var o = {
+	encryptedOutputs: [],
+	lastOutput: ""
+}, s = (e, t) => ({
+	shortPublicKey: e.substring(0, 25),
+	shortHinkalAddress: t.substring(0, 25)
+}), c = (e, t, n) => `hinkalCache-${e}-${t}-${n}`, l = (n, r, i) => {
+	let { hinkalAddress: a } = t[r].contractData;
+	if (!r || !i || !a) throw Error("GetHinkalCache: incorrect arguments");
+	let { shortPublicKey: l, shortHinkalAddress: u } = s(i, a);
+	return JSON.parse(n.cacheDevice.get(c(r, l, u)) ?? e(o));
+}, u = (n, r, i, a) => {
+	let { hinkalAddress: o } = t[i].contractData;
+	if (!i || !a || !o) throw Error("SetHinkalCache: incorrect arguments");
+	let { shortPublicKey: l, shortHinkalAddress: u } = s(a, o);
+	r.cacheDevice.set(c(i, l, u), e(n));
+}, d = (e, t, n) => {
+	u(o, e, t, n);
+}, f = (e, t, n) => `txsCache-${e}-${t}-${n}`, p = async (t, n, i, o, c, l) => {
+	if (!n || !i || !o) throw Error("saveTxsCache: incorrect arguments");
+	let { shortPublicKey: u, shortHinkalAddress: d } = s(i, o), p = r(t), m = f(n, u, d), h = e({
+		serializedTxs: p,
+		lastHash: c
+	});
+	try {
+		await a(m, h);
+	} catch {
+		l.cacheDevice.set(m, h);
+	}
+}, m = {
+	serializedTxs: [],
+	lastHash: ""
+}, h = async (t, r, a, o) => {
+	if (!t || !r || !a) throw Error("loadTxsCache: incorrect arguments");
+	let { shortPublicKey: c, shortHinkalAddress: l } = s(r, a), u = f(t, c, l), d;
+	try {
+		let e = await i(u);
+		if (!e) throw Error("Empty indexedDB cache");
+		d = e;
+	} catch {
+		d = o.cacheDevice.get(u);
+	}
+	let { serializedTxs: p, lastHash: h } = JSON.parse(d ?? e(m));
+	return {
+		decodedTxs: p.map((e) => n(e)),
+		lastHash: h === "" ? void 0 : h
+	};
+};
+//#endregion
+export { c as getFilePath, l as getHinkalCache, h as loadTxsCache, d as resetCache, p as saveTxsCache, u as setHinkalCache };

package/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)),n=(e,t)=>e.some(e=>e.toLowerCase().startsWith(t.toLowerCase()));exports.caseInsensitiveEqual=e,exports.lowerCaseIncludes=t,exports.lowerCaseStartsWith=n;

package/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/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)), n = (e, t) => e.some((e) => e.toLowerCase().startsWith(t.toLowerCase()));
+//#endregion
+export { e as caseInsensitiveEqual, t as lowerCaseIncludes, n as lowerCaseStartsWith };

package/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/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/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/functions/utils/convertIntegrationProviderToExternalActionId.cjs

@@ -0,0 +1 @@
+const e=require(`../../types/external-action.types.cjs`),t=require(`../../types/hinkal.types.cjs`);var n={[t.IntegrationProvider.UNISWAP]:e.ExternalActionId.Uniswap,[t.IntegrationProvider.ODOS]:e.ExternalActionId.Odos,[t.IntegrationProvider.ONEINCH]:e.ExternalActionId.OneInch,[t.IntegrationProvider.LIFI]:e.ExternalActionId.Lifi,[t.IntegrationProvider.OKX]:e.ExternalActionId.Okx,[t.IntegrationProvider.ALL]:void 0,[t.IntegrationProvider.NONE]:void 0},r=e=>n[e];exports.convertIntegrationProviderToExternalActionId=r;

package/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/functions/utils/convertIntegrationProviderToExternalActionId.mjs

@@ -0,0 +1,14 @@
+import { ExternalActionId as e } from "../../types/external-action.types.mjs";
+import { IntegrationProvider as t } from "../../types/hinkal.types.mjs";
+//#region libs/shared/common/src/functions/utils/convertIntegrationProviderToExternalActionId.ts
+var n = {
+	[t.UNISWAP]: e.Uniswap,
+	[t.ODOS]: e.Odos,
+	[t.ONEINCH]: e.OneInch,
+	[t.LIFI]: e.Lifi,
+	[t.OKX]: e.Okx,
+	[t.ALL]: void 0,
+	[t.NONE]: void 0
+}, r = (e) => n[e];
+//#endregion
+export { r as convertIntegrationProviderToExternalActionId };

package/functions/utils/create-provider.cjs

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

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

@@ -0,0 +1,5 @@
+import { CustomSolanaConnection } from '../../providers/CustomSolanaConnection';
+import { Commitment, 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) => CustomSolanaConnection;

package/functions/utils/create-provider.mjs

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

package/functions/utils/customEnclaveFunctionsRegister.cjs

@@ -0,0 +1 @@
+var e,t,n=t=>{e=t},r=()=>e,i=e=>{t=e},a=()=>t;exports.getCustomProofGenerator=r,exports.getCustomUtxoDecryptor=a,exports.setCustomProofGenerator=n,exports.setCustomUtxoDecryptor=i;

package/functions/utils/customEnclaveFunctionsRegister.d.ts

@@ -0,0 +1,18 @@
+import { NewZkCallDataType } from '../../types/snark.types';
+import { RemoteProofType } from '../../types/remote-proof.types';
+import { EncryptedOutputWithSign } from '../../types/commitments.types';
+import { IUtxoConstructor } from '../../data-structures/utxo/Utxo';
+export type ProofGeneratorFn = (input: any, circuitWasm: string, circuitZkey: string) => Promise<{
+    proof: RemoteProofType;
+    publicSignals: string[];
+    zkCallData: NewZkCallDataType;
+}>;
+export type UtxoDecryptorFn = (chainId: number, keysData: Uint8Array) => Promise<{
+    utxos: IUtxoConstructor<string>[];
+    encryptedOutputs: EncryptedOutputWithSign[];
+    lastOutput: string;
+}>;
+export declare const setCustomProofGenerator: (fn: ProofGeneratorFn) => void;
+export declare const getCustomProofGenerator: () => ProofGeneratorFn | undefined;
+export declare const setCustomUtxoDecryptor: (fn: UtxoDecryptorFn) => void;
+export declare const getCustomUtxoDecryptor: () => UtxoDecryptorFn | undefined;

package/functions/utils/customEnclaveFunctionsRegister.mjs

@@ -0,0 +1,8 @@
+//#region libs/shared/common/src/functions/utils/customEnclaveFunctionsRegister.ts
+var e, t, n = (t) => {
+	e = t;
+}, r = () => e, i = (e) => {
+	t = e;
+}, a = () => t;
+//#endregion
+export { r as getCustomProofGenerator, a as getCustomUtxoDecryptor, n as setCustomProofGenerator, i as setCustomUtxoDecryptor };

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

@@ -0,0 +1 @@
+const e=require(`../../constants/chains.constants.cjs`),t=require(`../../constants/protocol.constants.cjs`),n=require(`../../error-handling/error-codes.constants.cjs`);require(`../../constants/index.cjs`);const r=require(`../../data-structures/utxo/Utxo.cjs`),i=require(`./solanaMint.utils.cjs`),a=require(`./token-check.utils.cjs`);require(`../../error-handling/index.cjs`);const o=require(`../pre-transaction/sendV0Transaction.cjs`);require(`../pre-transaction/index.cjs`);const s=require(`./getUtxosFromReceipt.utils.cjs`),c=require(`./getUtxosFromReceiptSolana.cjs`),l=require(`./tx-confirmation.utils.cjs`),u=require(`./buildClaimableDepositPlan.cjs`);var d=10000n,f=e=>{if(e.isNewStyle&&e.H0)return e.H0[0];if(e.randomization!==void 0)return e.randomization},p=(e,t)=>{if(e.amount!==t.amount)return!1;let n=f(t),r=f(e);return n!==void 0&&r!==void 0&&n===r},m=async({chainId:t,fallbackRecipients:n,hinkal:a,senderAddress:s,tokenAddress:l,txHash:u})=>{let{hinkalIdl:d}=e.networkRegistry[t].contractData;if(!d)throw Error(`No IDL configured for Solana program on this network`);let f=a.getSolanaProgram(d);await f.provider.connection.confirmTransaction(u,`finalized`);let m=await o.fetchSolanaTransaction(f.provider.connection,u,`finalized`);if(!m)throw Error(`Could not fetch Solana transaction for signature ${u}`);let{compressedAddress:h}=i.formatMintAddress(l),g=[...c.getOnChainUtxosFromReceiptSolana(m,f,a.userKeys,h)],_=[];return n.forEach(({recipientIndex:e,recipientAddress:n,shieldedPrivateKey:i,claimableSignature:a,utxo:o})=>{let c=g.find(e=>p(e,o));if(!c)throw Error(`Could not match deposited UTXO for recipient index ${e}.`);g.splice(g.indexOf(c),1);let l=r.Utxo.createFrom(c,{nullifyingKey:i,spendingPublicKey:o.spendingPublicKey,isNewStyle:o.isNewStyle});l.getStealthAddress(),_.push({chainId:t,senderAddress:s,recipientAddress:n,claimableSignature:a,utxo:l})}),_},h=async({chainId:e,fallbackRecipients:t,hinkal:n,senderAddress:i,tokenAddress:a,txHash:o})=>{let c=await l.waitForEthereumTransactionConfirmation(e,o);if(!c)throw Error(`Could not fetch receipt for tx ${o}`);let u=[...s.getOnChainUtxosFromReceipt(c,n,e,a)],d=[];return t.forEach(({recipientIndex:t,recipientAddress:n,shieldedPrivateKey:a,claimableSignature:o,utxo:s})=>{let c=u.find(e=>p(e,s));if(!c)throw Error(`Could not match deposited UTXO for recipient index ${t}.`);u.splice(u.indexOf(c),1),d.push({chainId:e,senderAddress:i,recipientAddress:n,claimableSignature:o,utxo:r.Utxo.createFrom(c,{nullifyingKey:a,spendingPublicKey:s.spendingPublicKey,isNewStyle:s.isNewStyle})})}),d},g=async(r,i,o,s,c,l,f)=>{if(o.length===0)throw Error(`recipientAmounts must not be empty`);if(s.length!==o.length)throw Error(`recipientAddresses must have the same length as recipientAmounts`);if(l&&l.length!==o.length)throw Error(`recipientInfos must have the same length as recipientAmounts`);if(c<0n)throw Error(`nonce must be non-negative`);let p=a.validateAndGetChainId([i]),g=await r.getEthereumAddressByChain(p),_=i.erc20TokenAddress,v=o.reduce((e,t)=>{if(t<=0n)throw Error(n.transactionErrorCodes.RECIPIENT_AMOUNT_INVALID);return e+t},0n)*t.PAY_SEND_VARIABLE_RATE/d,{stealthAddressStructures:y,fallbackRecipients:b}=u.buildClaimableDepositPlan({userKeys:r.userKeys,recipientAmounts:o,recipientAddresses:s,recipientInfos:l,nonce:c,tokenAddress:_}),x;return x=v>0n?await r.prooflessDepositWithPublicFee(i,o,y,v,f):await r.prooflessDeposit(o.map(()=>i),o,y,f,!0),b.length===0?{pendingEnclaveUtxos:[],txHash:x}:{pendingEnclaveUtxos:e.isSolanaLike(p)?await m({chainId:p,fallbackRecipients:b,hinkal:r,senderAddress:g,tokenAddress:_,txHash:x}):await h({chainId:p,fallbackRecipients:b,hinkal:r,senderAddress:g,tokenAddress:_,txHash:x}),txHash:x}};exports.depositClaimableUtxos=g;

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

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

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

@@ -0,0 +1,106 @@
+import { isSolanaLike as e, networkRegistry as t } from "../../constants/chains.constants.mjs";
+import { PAY_SEND_VARIABLE_RATE as n } from "../../constants/protocol.constants.mjs";
+import { transactionErrorCodes as r } from "../../error-handling/error-codes.constants.mjs";
+import "../../constants/index.mjs";
+import { Utxo as i } from "../../data-structures/utxo/Utxo.mjs";
+import { formatMintAddress as a } from "./solanaMint.utils.mjs";
+import { validateAndGetChainId as o } from "./token-check.utils.mjs";
+import "../../error-handling/index.mjs";
+import { fetchSolanaTransaction as s } from "../pre-transaction/sendV0Transaction.mjs";
+import "../pre-transaction/index.mjs";
+import { getOnChainUtxosFromReceipt as c } from "./getUtxosFromReceipt.utils.mjs";
+import { getOnChainUtxosFromReceiptSolana as l } from "./getUtxosFromReceiptSolana.mjs";
+import { waitForEthereumTransactionConfirmation as u } from "./tx-confirmation.utils.mjs";
+import { buildClaimableDepositPlan as d } from "./buildClaimableDepositPlan.mjs";
+//#region libs/shared/common/src/functions/utils/deposit-claimable.utils.ts
+var f = 10000n, p = (e) => {
+	if (e.isNewStyle && e.H0) return e.H0[0];
+	if (e.randomization !== void 0) return e.randomization;
+}, m = (e, t) => {
+	if (e.amount !== t.amount) return !1;
+	let n = p(t), r = p(e);
+	return n !== void 0 && r !== void 0 && n === r;
+}, h = async ({ chainId: e, fallbackRecipients: n, hinkal: r, senderAddress: o, tokenAddress: c, txHash: u }) => {
+	let { hinkalIdl: d } = t[e].contractData;
+	if (!d) throw Error("No IDL configured for Solana program on this network");
+	let f = r.getSolanaProgram(d);
+	await f.provider.connection.confirmTransaction(u, "finalized");
+	let p = await s(f.provider.connection, u, "finalized");
+	if (!p) throw Error(`Could not fetch Solana transaction for signature ${u}`);
+	let { compressedAddress: h } = a(c), g = [...l(p, f, r.userKeys, h)], _ = [];
+	return n.forEach(({ recipientIndex: t, recipientAddress: n, shieldedPrivateKey: r, claimableSignature: a, utxo: s }) => {
+		let c = g.find((e) => m(e, s));
+		if (!c) throw Error(`Could not match deposited UTXO for recipient index ${t}.`);
+		g.splice(g.indexOf(c), 1);
+		let l = i.createFrom(c, {
+			nullifyingKey: r,
+			spendingPublicKey: s.spendingPublicKey,
+			isNewStyle: s.isNewStyle
+		});
+		l.getStealthAddress(), _.push({
+			chainId: e,
+			senderAddress: o,
+			recipientAddress: n,
+			claimableSignature: a,
+			utxo: l
+		});
+	}), _;
+}, g = async ({ chainId: e, fallbackRecipients: t, hinkal: n, senderAddress: r, tokenAddress: a, txHash: o }) => {
+	let s = await u(e, o);
+	if (!s) throw Error(`Could not fetch receipt for tx ${o}`);
+	let l = [...c(s, n, e, a)], d = [];
+	return t.forEach(({ recipientIndex: t, recipientAddress: n, shieldedPrivateKey: a, claimableSignature: o, utxo: s }) => {
+		let c = l.find((e) => m(e, s));
+		if (!c) throw Error(`Could not match deposited UTXO for recipient index ${t}.`);
+		l.splice(l.indexOf(c), 1), d.push({
+			chainId: e,
+			senderAddress: r,
+			recipientAddress: n,
+			claimableSignature: o,
+			utxo: i.createFrom(c, {
+				nullifyingKey: a,
+				spendingPublicKey: s.spendingPublicKey,
+				isNewStyle: s.isNewStyle
+			})
+		});
+	}), d;
+}, _ = async (t, i, a, s, c, l, u) => {
+	if (a.length === 0) throw Error("recipientAmounts must not be empty");
+	if (s.length !== a.length) throw Error("recipientAddresses must have the same length as recipientAmounts");
+	if (l && l.length !== a.length) throw Error("recipientInfos must have the same length as recipientAmounts");
+	if (c < 0n) throw Error("nonce must be non-negative");
+	let p = o([i]), m = await t.getEthereumAddressByChain(p), _ = i.erc20TokenAddress, v = a.reduce((e, t) => {
+		if (t <= 0n) throw Error(r.RECIPIENT_AMOUNT_INVALID);
+		return e + t;
+	}, 0n) * n / f, { stealthAddressStructures: y, fallbackRecipients: b } = d({
+		userKeys: t.userKeys,
+		recipientAmounts: a,
+		recipientAddresses: s,
+		recipientInfos: l,
+		nonce: c,
+		tokenAddress: _
+	}), x;
+	return x = v > 0n ? await t.prooflessDepositWithPublicFee(i, a, y, v, u) : await t.prooflessDeposit(a.map(() => i), a, y, u, !0), b.length === 0 ? {
+		pendingEnclaveUtxos: [],
+		txHash: x
+	} : {
+		pendingEnclaveUtxos: e(p) ? await h({
+			chainId: p,
+			fallbackRecipients: b,
+			hinkal: t,
+			senderAddress: m,
+			tokenAddress: _,
+			txHash: x
+		}) : await g({
+			chainId: p,
+			fallbackRecipients: b,
+			hinkal: t,
+			senderAddress: m,
+			tokenAddress: _,
+			txHash: x
+		}),
+		txHash: x
+	};
+};
+//#endregion
+export { _ as depositClaimableUtxos };

package/functions/utils/dispatchBalanceRefreshes.cjs

@@ -0,0 +1 @@
+const e=require(`../../types/balances.types.cjs`),t=require(`./upToDateState.cjs`),n=require(`../../error-handling/logger.cjs`),r=require(`../../mutexes/mutex.cjs`),i=require(`../web3/events/balanceChangedHandler.cjs`);var a=async(a,o=!1)=>{let s=await a.getEthereumAddress();i.balanceChangedHandler({updateType:e.PrivateBalanceUpdateType.OnlyCache,balanceChangeState:{ethereumAddress:s}}),await r.resetStateMutex.runExclusive(async()=>{try{await t.checkAddressNotUpdated(a,s),o||(await a.resetMerkle(),await t.checkAddressNotUpdated(a,s)),i.balanceChangedHandler({updateType:e.PrivateBalanceUpdateType.FreshWithoutLoader,balanceChangeState:{ethereumAddress:s,userKeys:a.userKeys},updateTokensListBefore:!0})}catch(e){n.Logger.log(`resetMerkleAndRefreshPrivateBalance error`,e)}})},o=async(n,a=!1)=>{let o=await n.getEthereumAddress();await r.resetStateMutex.runExclusive(async()=>{let{userKeys:r}=n;await t.checkAddressNotUpdated(n,o),await n.resetMerkleTreesIfNecessary(),await t.checkAddressNotUpdated(n,o),i.balanceChangedHandler({updateType:e.PrivateBalanceUpdateType.Fresh,balanceChangeState:{ethereumAddress:o,userKeys:r},updateTokensListBefore:!0,resetCacheBefore:a})})},s=async e=>{await o(e,!0)};exports.hardRefreshPrivateBalance=s,exports.initialMerkleAndPrivateBalanceRefresh=a,exports.refreshPrivateBalance=o;

package/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/functions/utils/dispatchBalanceRefreshes.mjs

@@ -0,0 +1,44 @@
+import { PrivateBalanceUpdateType as e } from "../../types/balances.types.mjs";
+import { checkAddressNotUpdated as t } from "./upToDateState.mjs";
+import { Logger as n } from "../../error-handling/logger.mjs";
+import { resetStateMutex as r } from "../../mutexes/mutex.mjs";
+import { balanceChangedHandler as i } from "../web3/events/balanceChangedHandler.mjs";
+//#region libs/shared/common/src/functions/utils/dispatchBalanceRefreshes.ts
+var a = async (a, o = !1) => {
+	let s = await a.getEthereumAddress();
+	i({
+		updateType: e.OnlyCache,
+		balanceChangeState: { ethereumAddress: s }
+	}), await r.runExclusive(async () => {
+		try {
+			await t(a, s), o || (await a.resetMerkle(), await t(a, s)), i({
+				updateType: e.FreshWithoutLoader,
+				balanceChangeState: {
+					ethereumAddress: s,
+					userKeys: a.userKeys
+				},
+				updateTokensListBefore: !0
+			});
+		} catch (e) {
+			n.log("resetMerkleAndRefreshPrivateBalance error", e);
+		}
+	});
+}, o = async (n, a = !1) => {
+	let o = await n.getEthereumAddress();
+	await r.runExclusive(async () => {
+		let { userKeys: r } = n;
+		await t(n, o), await n.resetMerkleTreesIfNecessary(), await t(n, o), i({
+			updateType: e.Fresh,
+			balanceChangeState: {
+				ethereumAddress: o,
+				userKeys: r
+			},
+			updateTokensListBefore: !0,
+			resetCacheBefore: a
+		});
+	});
+}, s = async (e) => {
+	await o(e, !0);
+};
+//#endregion
+export { s as hardRefreshPrivateBalance, a as initialMerkleAndPrivateBalanceRefresh, o as refreshPrivateBalance };

package/functions/utils/enclave-recipient-info-storage.cjs

@@ -0,0 +1 @@
+require(`../../constants/pay.constants.cjs`);const e=require(`../../API/enclaveRecipientInfoCalls.cjs`),t=require(`./encryptInputForEnclave.cjs`);var n=async(n,r,i,a)=>{let o=n.userKeys.getSignature(),{keyCiphertext:s,inputCiphertext:c}=await t.makeEnclaveHandshakeAndEncryptUint8Array(new TextEncoder().encode(o));await e.storeRecipientInfosViaEnclave({ethAddress:r,encryptedSignature:c,key:s,targetCount:20,isSolanaLedger:i,txMessageForSolanaLedger:a})};exports.ensureRecipientInfoPool=n;

package/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, isSolanaLedger: boolean, txMessageForSolanaLedger: string | undefined) => Promise<void>;

package/functions/utils/enclave-recipient-info-storage.mjs

@@ -0,0 +1,17 @@
+import "../../constants/pay.constants.mjs";
+import { storeRecipientInfosViaEnclave as e } from "../../API/enclaveRecipientInfoCalls.mjs";
+import { makeEnclaveHandshakeAndEncryptUint8Array as t } from "./encryptInputForEnclave.mjs";
+//#region libs/shared/common/src/functions/utils/enclave-recipient-info-storage.ts
+var n = async (n, r, i, a) => {
+	let o = n.userKeys.getSignature(), { keyCiphertext: s, inputCiphertext: c } = await t(new TextEncoder().encode(o));
+	await e({
+		ethAddress: r,
+		encryptedSignature: c,
+		key: s,
+		targetCount: 20,
+		isSolanaLedger: i,
+		txMessageForSolanaLedger: a
+	});
+};
+//#endregion
+export { n as ensureRecipientInfoPool };

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

@@ -0,0 +1 @@
+const e=require(`./encryptInputForEnclave.cjs`),t=require(`../../API/enclaveSignatureCalls.cjs`);var n=async(n,r,i,a)=>{let{keyCiphertext:o,inputCiphertext:s}=await e.makeEnclaveHandshakeAndEncryptInput(r),{signature:c}=await t.storeAndGetSignatureEnclaveCall(n,s,o,i,a);return c};exports.storeAndGetSignatureFromEnclave=n;

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

@@ -0,0 +1 @@
+export declare const storeAndGetSignatureFromEnclave: (ethAddress: string, authSignature: string, isSolanaLedger: boolean, txMessageForSolanaLedger?: string) => Promise<string>;

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

@@ -0,0 +1,9 @@
+import { makeEnclaveHandshakeAndEncryptInput as e } from "./encryptInputForEnclave.mjs";
+import { storeAndGetSignatureEnclaveCall as t } from "../../API/enclaveSignatureCalls.mjs";
+//#region libs/shared/common/src/functions/utils/enclave-signature-storage.ts
+var n = async (n, r, i, a) => {
+	let { keyCiphertext: o, inputCiphertext: s } = await e(r), { signature: c } = await t(n, s, o, i, a);
+	return c;
+};
+//#endregion
+export { n as storeAndGetSignatureFromEnclave };

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

@@ -0,0 +1 @@
+const e=require(`../../API/enclaveUtxoCalls.cjs`),t=require(`../../data-structures/utxo/Utxo.cjs`),n=require(`./encryptInputForEnclave.cjs`),r=require(`../../error-handling/logger.cjs`),i=require(`./serialize-utxos.utils.cjs`);var a=e=>{let n=new Set,r=[];for(let a of e){let e=new t.Utxo(i.deserializeUtxoConstructorParams(a)).getCommitment();n.has(e)||(n.add(e),r.push(a))}return r},o=async(t,r,a,o,s)=>{let{keyCiphertext:c,inputCiphertext:l}=await n.makeEnclaveHandshakeAndEncryptInput({...i.serializeUtxoConstructorParams(a.getConstructableParams()),senderAddress:t,...s?{claimableSignature:s}:{}});await e.storeUtxoEnclaveCall(r,l,c,o)},s=async(t,i,o,s,c)=>{try{let{keyCiphertext:r,inputCiphertext:l}=await n.makeEnclaveHandshakeAndEncryptInput(i),{utxos:u}=await e.getUtxosEnclaveCall(t,l,r,o,s,c);return a(u)}catch{return r.Logger.log(`failed to fetch utxos from gcp`),[]}};exports.getUtxosFromEnclave=s,exports.storeUtxoInEnclave=o;

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

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

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

@@ -0,0 +1,30 @@
+import { getUtxosEnclaveCall as e, storeUtxoEnclaveCall as t } from "../../API/enclaveUtxoCalls.mjs";
+import { Utxo as n } from "../../data-structures/utxo/Utxo.mjs";
+import { makeEnclaveHandshakeAndEncryptInput as r } from "./encryptInputForEnclave.mjs";
+import { Logger as i } from "../../error-handling/logger.mjs";
+import { deserializeUtxoConstructorParams as a, serializeUtxoConstructorParams as o } from "./serialize-utxos.utils.mjs";
+//#region libs/shared/common/src/functions/utils/enclave-utxo-storage.ts
+var s = (e) => {
+	let t = /* @__PURE__ */ new Set(), r = [];
+	for (let i of e) {
+		let e = new n(a(i)).getCommitment();
+		t.has(e) || (t.add(e), r.push(i));
+	}
+	return r;
+}, c = async (e, n, i, a, s) => {
+	let { keyCiphertext: c, inputCiphertext: l } = await r({
+		...o(i.getConstructableParams()),
+		senderAddress: e,
+		...s ? { claimableSignature: s } : {}
+	});
+	await t(n, l, c, a);
+}, l = async (t, n, a, o, c) => {
+	try {
+		let { keyCiphertext: i, inputCiphertext: l } = await r(n), { utxos: u } = await e(t, l, i, a, o, c);
+		return s(u);
+	} catch {
+		return i.log("failed to fetch utxos from gcp"), [];
+	}
+};
+//#endregion
+export { l as getUtxosFromEnclave, c as storeUtxoInEnclave };

package/functions/utils/encodeTokenWithId.cjs

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

package/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/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}-0`;
+	return e(t) ? r : r.toLowerCase();
+};
+//#endregion
+export { t as encodeTokenWithId };