@sabaaa1/common 0.1.14 → 0.2.28

package/common/src/functions/pre-transaction/getFlatFees.d.ts

@@ -0,0 +1,11 @@
+import { CallInfo, ExternalActionId } from '../../types';
+import { FeeInfo } from '../../types/fee.types';
+/**
+ * Infer INTERACTION type from given @param externalActionId and @param action
+ * and return `flatFee` along with `feeUnit` - the token corespond with the fee,
+ * `priceOfTransactionInToken`, and `priceOfTransactionInUSD`
+ */
+export declare const getFlatFees: (chainId: number, erc20Addresses: string[], externalActionId: ExternalActionId, amountChanges: bigint[], 
+/** if provided, gas will be estimated using this token */
+gasTokenAddress?: string, // TODO: Update all functions that call getFlatFees() to pass in this value explicitly (where it is needed)
+calls?: CallInfo[]) => Promise<FeeInfo>;

package/common/src/functions/pre-transaction/getFlatFees.mjs

@@ -0,0 +1,4 @@
+import "../../types/index.mjs";
+import "../utils/erc20tokenFunctions.mjs";
+import "./interaction-to-action.mjs";
+import "./process-gas-estimates.mjs";

package/common/src/functions/pre-transaction/getKycAndSignatureData.cjs

@@ -0,0 +1 @@
+const e=require(`./shouldPatchAccessTokenMerkleTree.cjs`),t=require(`./getSignatureDataForTransact.cjs`);var n=async(n,r,i,a,o)=>{let{patchAccessTokenMerkleTree:s,kycRequired:c,hasAccessToken:l}=await e.shouldPatchAccessTokenMerkleTree(n,r,i,a);return{patchAccessTokenMerkleTree:s,signatureData:await t.getSignatureDataForTransact(r,o,n.userKeys,c,l)}};exports.getKycAndSignatureData=n;

package/common/src/functions/pre-transaction/getKycAndSignatureData.d.ts

@@ -0,0 +1,5 @@
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+export declare const getKycAndSignatureData: (hinkal: IHinkal, chainId: number, erc20Addresses: string[], amountChanges: bigint[], ethereumAddress: string) => Promise<{
+    patchAccessTokenMerkleTree: boolean;
+    signatureData: import('../..').SignatureData;
+}>;

package/common/src/functions/pre-transaction/getKycAndSignatureData.mjs

@@ -0,0 +1,12 @@
+import { shouldPatchAccessTokenMerkleTree as e } from "./shouldPatchAccessTokenMerkleTree.mjs";
+import { getSignatureDataForTransact as t } from "./getSignatureDataForTransact.mjs";
+//#region libs/shared/common/src/functions/pre-transaction/getKycAndSignatureData.ts
+var n = async (n, r, i, a, o) => {
+	let { patchAccessTokenMerkleTree: s, kycRequired: c, hasAccessToken: l } = await e(n, r, i, a);
+	return {
+		patchAccessTokenMerkleTree: s,
+		signatureData: await t(r, o, n.userKeys, c, l)
+	};
+};
+//#endregion
+export { n as getKycAndSignatureData };

package/common/src/functions/pre-transaction/getSignatureDataForTransact.cjs

@@ -0,0 +1 @@
+const e=require(`../../constants/protocol.constants.cjs`),t=require(`../../API/API.cjs`);var n=async(n,r,i,a,o)=>!a||o?e.defaultSignatureData:(await t.API.getAccessTokenSignature(n,r,i.getAccessKey())).signatureData;exports.getSignatureDataForTransact=n;

package/common/src/functions/pre-transaction/getSignatureDataForTransact.mjs

@@ -0,0 +1,6 @@
+import { defaultSignatureData as e } from "../../constants/protocol.constants.mjs";
+import { API as t } from "../../API/API.mjs";
+//#region libs/shared/common/src/functions/pre-transaction/getSignatureDataForTransact.ts
+var n = async (n, r, i, a, o) => !a || o ? e : (await t.getAccessTokenSignature(n, r, i.getAccessKey())).signatureData;
+//#endregion
+export { n as getSignatureDataForTransact };

package/common/src/functions/pre-transaction/getSolanaCalldataHash.cjs

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../constants/protocol.constants.cjs`);let t=require(`ethers`),n=require(`@coral-xyz/anchor`);var r=(r,i,a,o,s,c,l,u)=>{let d=new n.BN(s.toString()),f=new n.BN(c.toString()),p=o.reduce((e,t)=>[...e,...new n.BN(t.length).toArray(`be`,8),...t],[]),m=l.reduce((e,t)=>{let r=[...new n.BN(t.programIndex).toArray(`be`,1),...new n.BN(t.accountIndexes.length).toArray(`be`,8),...t.accountIndexes,...new n.BN(t.data.length).toArray(`be`,8),...t.data];return[...e,...r]},[]),h=u.reduce((e,t)=>[...e,+!!t.isWritable,...t.pubkey.toBytes()],[]),g=[r.tokenNumber,r.nullifierAmount,r.outputAmount,...i.toBytes(),...a.toBytes(),...p,...d.toArray(`be`,8),...f.toArray(`be`,8),...m,...h];return BigInt(t.ethers.sha256(new Uint8Array(g)))%e.CIRCOM_P};exports.getSolanaCalldataHash=r;

package/common/src/functions/pre-transaction/getSolanaCalldataHash.mjs

@@ -0,0 +1,38 @@
+import { CIRCOM_P as e } from "../../constants/protocol.constants.mjs";
+import { ethers as t } from "ethers";
+import { BN as n } from "@coral-xyz/anchor";
+//#region libs/shared/common/src/functions/pre-transaction/getSolanaCalldataHash.ts
+var r = (r, i, a, o, s, c, l, u) => {
+	let d = new n(s.toString()), f = new n(c.toString()), p = o.reduce((e, t) => [
+		...e,
+		...new n(t.length).toArray("be", 8),
+		...t
+	], []), m = l.reduce((e, t) => {
+		let r = [
+			...new n(t.programIndex).toArray("be", 1),
+			...new n(t.accountIndexes.length).toArray("be", 8),
+			...t.accountIndexes,
+			...new n(t.data.length).toArray("be", 8),
+			...t.data
+		];
+		return [...e, ...r];
+	}, []), h = u.reduce((e, t) => [
+		...e,
+		+!!t.isWritable,
+		...t.pubkey.toBytes()
+	], []), g = [
+		r.tokenNumber,
+		r.nullifierAmount,
+		r.outputAmount,
+		...i.toBytes(),
+		...a.toBytes(),
+		...p,
+		...d.toArray("be", 8),
+		...f.toArray("be", 8),
+		...m,
+		...h
+	];
+	return BigInt(t.sha256(new Uint8Array(g))) % e;
+};
+//#endregion
+export { r as getSolanaCalldataHash };

package/common/src/functions/pre-transaction/getVolatileTransferAmount.cjs

@@ -0,0 +1 @@
+const e=require(`../../API/simulate-transaction.cjs`),t=require(`../../error-handling/logger.cjs`);require(`../../error-handling/index.cjs`);const n=require(`../../data-structures/token-price-fetcher/TokenChecker.cjs`);var r=async(r,i,a,o)=>{try{let t=i.map((e,t)=>{let r=a[t];return e&&n.TokenChecker.isPotentiallyVolatile(e)?{tokenAddress:e.erc20TokenAddress,amount:r.toString(),...o===void 0?{}:{targetAddress:o},originalIndex:t}:null}).filter(e=>e!==null);if(t.length===0)return a;let s=await e.simulateVolatileTokenTransfer(r,t);return a.map((e,n)=>{let r=t.findIndex(e=>e.originalIndex===n);if(r!==-1&&s[r].success){let t=s[r].balanceDifference;return t?BigInt(t):e}return e})}catch(e){return t.Logger.error(`Volatile transfer simulation failed:`,e),a}};exports.modifyVolatileTokenAmountChanges=r;

package/common/src/functions/pre-transaction/getVolatileTransferAmount.d.ts

@@ -0,0 +1,9 @@
+import { ERC20Token } from '../../types/token.types';
+/**
+ * Adjusts the token amount changes for volatile tokens based on actual transfer simulation results.
+ *
+ * This function identifies potentially volatile tokens with negative amount changes,
+ * simulates their transfers to estimate the real balance impact, and then updates
+ * the original `amountChanges` array accordingly with the simulated balance differences.
+ */
+export declare const modifyVolatileTokenAmountChanges: (chainId: number, tokens: ERC20Token[], amountChanges: bigint[], targetAddress?: string) => Promise<bigint[]>;

package/common/src/functions/pre-transaction/getVolatileTransferAmount.mjs

@@ -0,0 +1,32 @@
+import { simulateVolatileTokenTransfer as e } from "../../API/simulate-transaction.mjs";
+import { Logger as t } from "../../error-handling/logger.mjs";
+import "../../error-handling/index.mjs";
+import { TokenChecker as n } from "../../data-structures/token-price-fetcher/TokenChecker.mjs";
+//#region libs/shared/common/src/functions/pre-transaction/getVolatileTransferAmount.ts
+var r = async (r, i, a, o) => {
+	try {
+		let t = i.map((e, t) => {
+			let r = a[t];
+			return e && n.isPotentiallyVolatile(e) ? {
+				tokenAddress: e.erc20TokenAddress,
+				amount: r.toString(),
+				...o === void 0 ? {} : { targetAddress: o },
+				originalIndex: t
+			} : null;
+		}).filter((e) => e !== null);
+		if (t.length === 0) return a;
+		let s = await e(r, t);
+		return a.map((e, n) => {
+			let r = t.findIndex((e) => e.originalIndex === n);
+			if (r !== -1 && s[r].success) {
+				let t = s[r].balanceDifference;
+				return t ? BigInt(t) : e;
+			}
+			return e;
+		});
+	} catch (e) {
+		return t.error("Volatile transfer simulation failed:", e), a;
+	}
+};
+//#endregion
+export { r as modifyVolatileTokenAmountChanges };

package/common/src/functions/pre-transaction/index.cjs

@@ -0,0 +1 @@
+require(`./solana.cjs`),require(`./outputUtxoProcessing.cjs`),require(`./interaction-to-action.cjs`),require(`./process-gas-estimates.cjs`),require(`./getFlatFees.cjs`),require(`./outputApprovalDataProcessing.cjs`),require(`./getVolatileTransferAmount.cjs`),require(`./constructAdminData.cjs`),require(`./calculateSolanaNullifierCount.cjs`),require(`./addressTableLookup.cjs`),require(`./convert-okx-instructions.cjs`),require(`./sendV0Transaction.cjs`),require(`./store-proof.cjs`),require(`./sendInitNullifiersTransaction.cjs`),require(`./initTokenLimitIfNeeded.cjs`),require(`./recipientUtxoProcessing.cjs`),require(`./store-instructions.cjs`),require(`./ensureAmountChanges.cjs`),require(`./getFeeStructure.cjs`),require(`./getKycAndSignatureData.cjs`),require(`./waitForDepositedUtxosInMerkleTree.cjs`),require(`./buildCommitmentValidationData.cjs`);

package/common/src/functions/pre-transaction/index.d.ts

@@ -0,0 +1,23 @@
+export * from './interaction-to-action';
+export * from './outputUtxoProcessing';
+export * from './process-gas-estimates';
+export * from './getFlatFees';
+export * from './outputApprovalDataProcessing';
+export * from './getVolatileTransferAmount';
+export * from './constructAdminData';
+export * from './solana';
+export * from './calculateSolanaNullifierCount';
+export * from './addressTableLookup';
+export * from './solana-public-signals';
+export * from './convert-okx-instructions';
+export * from './sendV0Transaction';
+export * from './store-proof';
+export * from './sendInitNullifiersTransaction';
+export * from './initTokenLimitIfNeeded';
+export * from './recipientUtxoProcessing';
+export * from './store-instructions';
+export * from './ensureAmountChanges';
+export * from './getFeeStructure';
+export * from './getKycAndSignatureData';
+export * from './waitForDepositedUtxosInMerkleTree';
+export * from './buildCommitmentValidationData';

package/common/src/functions/pre-transaction/index.mjs

@@ -0,0 +1,22 @@
+import "./solana.mjs";
+import "./outputUtxoProcessing.mjs";
+import "./interaction-to-action.mjs";
+import "./process-gas-estimates.mjs";
+import "./getFlatFees.mjs";
+import "./outputApprovalDataProcessing.mjs";
+import "./getVolatileTransferAmount.mjs";
+import "./constructAdminData.mjs";
+import "./calculateSolanaNullifierCount.mjs";
+import "./addressTableLookup.mjs";
+import "./convert-okx-instructions.mjs";
+import "./sendV0Transaction.mjs";
+import "./store-proof.mjs";
+import "./sendInitNullifiersTransaction.mjs";
+import "./initTokenLimitIfNeeded.mjs";
+import "./recipientUtxoProcessing.mjs";
+import "./store-instructions.mjs";
+import "./ensureAmountChanges.mjs";
+import "./getFeeStructure.mjs";
+import "./getKycAndSignatureData.mjs";
+import "./waitForDepositedUtxosInMerkleTree.mjs";
+import "./buildCommitmentValidationData.mjs";

package/common/src/functions/pre-transaction/initTokenLimitIfNeeded.cjs

@@ -0,0 +1 @@
+require(`../../constants/protocol.constants.cjs`),require(`./solana.cjs`),require(`./sendV0Transaction.cjs`);

package/common/src/functions/pre-transaction/initTokenLimitIfNeeded.mjs

@@ -0,0 +1,3 @@
+import "../../constants/protocol.constants.mjs";
+import "./solana.mjs";
+import "./sendV0Transaction.mjs";

package/common/src/functions/pre-transaction/interaction-to-action.cjs

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

package/common/src/functions/pre-transaction/interaction-to-action.mjs

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

package/common/src/functions/pre-transaction/merge-with-fee-structure-emporium.cjs

@@ -0,0 +1 @@
+const e=require(`../../constants/protocol.constants.cjs`),t=require(`../../types/ethereum-network.types.cjs`),n=require(`../utils/amounts.utils.cjs`),r=require(`../private-wallet/emporium.helpers.cjs`),i=require(`./merge-with-fee-structure.cjs`),a=require(`../web3/getPublicAddressBalance.cjs`);var o=async(o,s,c,l,u,d,f,p)=>{let m=0n,h=p<0n?p:0n,g=await a.getPublicAddressBalance(o,s,f.feeToken,c)+h;m=g<0?f.flatFee:n.maxBigInt(f.flatFee-g,0n),m!==0n&&(i.mergeWithFeeStructure(s,u,d,{...f,flatFee:m}),l.push(r.createTransferToEmporiumOp(f.feeToken===e.zeroAddress?void 0:o.getContractWithFetcher(s,t.ContractType.ERC20Contract,f.feeToken),c,m,!1)))};exports.mergeWithFeeStructureEmporium=o;

package/common/src/functions/pre-transaction/merge-with-fee-structure-emporium.d.ts

@@ -0,0 +1,3 @@
+import { FeeStructure } from '../../types/hinkal.types';
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+export declare const mergeWithFeeStructureEmporium: (hinkal: IHinkal, chainId: number, walletAddress: string, emporiumOps: string[], erc20Addresses: string[], amountChanges: bigint[], feeStructure: FeeStructure, feeTokenChange: bigint) => Promise<void>;

package/common/src/functions/pre-transaction/merge-with-fee-structure-emporium.mjs

@@ -0,0 +1,16 @@
+import { zeroAddress as e } from "../../constants/protocol.constants.mjs";
+import { ContractType as t } from "../../types/ethereum-network.types.mjs";
+import { maxBigInt as n } from "../utils/amounts.utils.mjs";
+import { createTransferToEmporiumOp as r } from "../private-wallet/emporium.helpers.mjs";
+import { mergeWithFeeStructure as i } from "./merge-with-fee-structure.mjs";
+import { getPublicAddressBalance as a } from "../web3/getPublicAddressBalance.mjs";
+//#region libs/shared/common/src/functions/pre-transaction/merge-with-fee-structure-emporium.ts
+var o = async (o, s, c, l, u, d, f, p) => {
+	let m = 0n, h = p < 0n ? p : 0n, g = await a(o, s, f.feeToken, c) + h;
+	m = g < 0 ? f.flatFee : n(f.flatFee - g, 0n), m !== 0n && (i(s, u, d, {
+		...f,
+		flatFee: m
+	}), l.push(r(f.feeToken === e ? void 0 : o.getContractWithFetcher(s, t.ERC20Contract, f.feeToken), c, m, !1)));
+};
+//#endregion
+export { o as mergeWithFeeStructureEmporium };

package/common/src/functions/pre-transaction/merge-with-fee-structure.cjs

@@ -0,0 +1 @@
+const e=require(`../utils/erc20tokenFunctions.cjs`),t=require(`../utils/caseInsensitive.utils.cjs`),n=require(`../../error-handling/customErrors/FeeOverTransactionValueError.cjs`),r=require(`../../error-handling/logger.cjs`);var i=(i,a,o,s)=>{r.Logger.log(`amount changes before merge`,{amountChanges:o});let c=a.findIndex(e=>t.caseInsensitiveEqual(e,s.feeToken));if(c===-1){a.push(s.feeToken),o.push(-1n*s.flatFee),r.Logger.log(`amount changes after merge`,{amountChanges:o});return}if(o[c]>0&&o[c]<s.flatFee)throw new n.FeeOverTransactionValueError({totalFeeWEI:s.flatFee,feeUnit:e.getERC20Token(s.feeToken,i)});o[c]-=s.flatFee,r.Logger.log(`amount changes after merge`,{amountChanges:o})};exports.mergeWithFeeStructure=i;

package/common/src/functions/pre-transaction/merge-with-fee-structure.mjs

@@ -0,0 +1,20 @@
+import { getERC20Token as e } from "../utils/erc20tokenFunctions.mjs";
+import { caseInsensitiveEqual as t } from "../utils/caseInsensitive.utils.mjs";
+import { FeeOverTransactionValueError as n } from "../../error-handling/customErrors/FeeOverTransactionValueError.mjs";
+import { Logger as r } from "../../error-handling/logger.mjs";
+//#region libs/shared/common/src/functions/pre-transaction/merge-with-fee-structure.ts
+var i = (i, a, o, s) => {
+	r.log("amount changes before merge", { amountChanges: o });
+	let c = a.findIndex((e) => t(e, s.feeToken));
+	if (c === -1) {
+		a.push(s.feeToken), o.push(-1n * s.flatFee), r.log("amount changes after merge", { amountChanges: o });
+		return;
+	}
+	if (o[c] > 0 && o[c] < s.flatFee) throw new n({
+		totalFeeWEI: s.flatFee,
+		feeUnit: e(s.feeToken, i)
+	});
+	o[c] -= s.flatFee, r.log("amount changes after merge", { amountChanges: o });
+};
+//#endregion
+export { i as mergeWithFeeStructure };

package/common/src/functions/pre-transaction/outputApprovalDataProcessing.cjs

@@ -0,0 +1 @@
+const e=require(`../../types/hinkal.types.cjs`),t=require(`../utils/amounts.utils.cjs`),n=require(`../../error-handling/error-codes.constants.cjs`),r=require(`../utils/caseInsensitive.utils.cjs`),i=require(`../utils/processUseApprovalUtxoData.cjs`);var a=(a,o,s,c,l,u)=>{if(u&&u>0)throw Error(n.transactionErrorCodes.INSUFFICIENT_FUNDS);let d=t.countTotalAmountInUtxos(s),{erc20TokenAddress:f}=s[0],p=a.getApprovedUtxosForToken(f,o).filter(e=>!r.caseInsensitiveEqual(e.interactionAddress,l)),m=e.defaultUseApprovalUTXOData(3,0n);if(c<0n&&d+c<0n){let e=-(d+c);for(let t=0;t<Math.min(p.length,3)&&e!==0n;t+=1){let n=p[t],r=n.amount>=e?-e:-n.amount;e+=r,m.approvalChanges[t]=r,m.externalApprovalAddresses[t]=n.interactionAddress,m.conversionInHinkalAddress[t]=n.inHinkalAddress}if(e!==0n)throw Error(n.transactionErrorCodes.INSUFFICIENT_FUNDS)}return{useApprovalUtxoData:i.isUseApprovalDataEmpty(m)?void 0:m}};exports.outputApprovalDataProcessing=a;

package/common/src/functions/pre-transaction/outputApprovalDataProcessing.d.ts

@@ -0,0 +1,10 @@
+import { Utxo } from '../../data-structures/utxo/Utxo';
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+export declare const outputApprovalDataProcessing: (hinkal: IHinkal, chainId: number, inputUtxos: Utxo[], amountChange: bigint, interactionToIgnore?: string, // in case of inside transact, we do not want take approvals we already approved for this interaction
+tokenId?: number) => {
+    useApprovalUtxoData: {
+        approvalChanges: bigint[];
+        externalApprovalAddresses: string[];
+        conversionInHinkalAddress: bigint[];
+    } | undefined;
+};

package/common/src/functions/pre-transaction/outputApprovalDataProcessing.mjs

@@ -0,0 +1,21 @@
+import { defaultUseApprovalUTXOData as e } from "../../types/hinkal.types.mjs";
+import { countTotalAmountInUtxos as t } from "../utils/amounts.utils.mjs";
+import { transactionErrorCodes as n } from "../../error-handling/error-codes.constants.mjs";
+import { caseInsensitiveEqual as r } from "../utils/caseInsensitive.utils.mjs";
+import { isUseApprovalDataEmpty as i } from "../utils/processUseApprovalUtxoData.mjs";
+//#region libs/shared/common/src/functions/pre-transaction/outputApprovalDataProcessing.ts
+var a = (a, o, s, c, l, u) => {
+	if (u && u > 0) throw Error(n.INSUFFICIENT_FUNDS);
+	let d = t(s), { erc20TokenAddress: f } = s[0], p = a.getApprovedUtxosForToken(f, o).filter((e) => !r(e.interactionAddress, l)), m = e(3, 0n);
+	if (c < 0n && d + c < 0n) {
+		let e = -(d + c);
+		for (let t = 0; t < Math.min(p.length, 3) && e !== 0n; t += 1) {
+			let n = p[t], r = n.amount >= e ? -e : -n.amount;
+			e += r, m.approvalChanges[t] = r, m.externalApprovalAddresses[t] = n.interactionAddress, m.conversionInHinkalAddress[t] = n.inHinkalAddress;
+		}
+		if (e !== 0n) throw Error(n.INSUFFICIENT_FUNDS);
+	}
+	return { useApprovalUtxoData: i(m) ? void 0 : m };
+};
+//#endregion
+export { a as outputApprovalDataProcessing };

package/common/src/functions/pre-transaction/outputUtxoProcessing.cjs

@@ -0,0 +1 @@
+const e=require(`../utils/amounts.utils.cjs`),t=require(`../../error-handling/error-codes.constants.cjs`),n=require(`../../data-structures/utxo/Utxo.cjs`);var r=(r,i,a,o,s,c=!0,l,u)=>{let d=e.countTotalAmountInUtxos(i),{erc20TokenAddress:f,mintAddress:p}=i[0];if(c&&a<0n&&d+a<0n)throw Error(t.transactionErrorCodes.INSUFFICIENT_FUNDS_TO_TRANSACT);let m=[new n.Utxo({amount:e.bigintMax(d+a,0n),erc20TokenAddress:f,mintAddress:p,shieldedPrivateKey:r.getShieldedPrivateKey(),timeStamp:o,tokenId:s})];if(l!==void 0&&u!==void 0){let[e,t,r]=l.split(`,`);m.push(new n.Utxo({amount:u,erc20TokenAddress:f,randomization:BigInt(e),stealthAddress:t,encryptionKey:r,timeStamp:o}))}return{outputUtxos:m}};exports.outputUtxoProcessing=r;

package/common/src/functions/pre-transaction/outputUtxoProcessing.mjs

@@ -0,0 +1,30 @@
+import { bigintMax as e, countTotalAmountInUtxos as t } from "../utils/amounts.utils.mjs";
+import { transactionErrorCodes as n } from "../../error-handling/error-codes.constants.mjs";
+import { Utxo as r } from "../../data-structures/utxo/Utxo.mjs";
+//#region libs/shared/common/src/functions/pre-transaction/outputUtxoProcessing.ts
+var i = (i, a, o, s, c, l = !0, u, d) => {
+	let f = t(a), { erc20TokenAddress: p, mintAddress: m } = a[0];
+	if (l && o < 0n && f + o < 0n) throw Error(n.INSUFFICIENT_FUNDS_TO_TRANSACT);
+	let h = [new r({
+		amount: e(f + o, 0n),
+		erc20TokenAddress: p,
+		mintAddress: m,
+		shieldedPrivateKey: i.getShieldedPrivateKey(),
+		timeStamp: s,
+		tokenId: c
+	})];
+	if (u !== void 0 && d !== void 0) {
+		let [e, t, n] = u.split(",");
+		h.push(new r({
+			amount: d,
+			erc20TokenAddress: p,
+			randomization: BigInt(e),
+			stealthAddress: t,
+			encryptionKey: n,
+			timeStamp: s
+		}));
+	}
+	return { outputUtxos: h };
+};
+//#endregion
+export { i as outputUtxoProcessing };

package/common/src/functions/pre-transaction/process-gas-estimates.cjs

@@ -0,0 +1 @@
+const e=require(`../utils/amounts.utils.cjs`),t=require(`../web3/etherFunctions.cjs`),n=require(`../../error-handling/logError.cjs`),r=require(`../../API/getGasEstimates.cjs`);var i=async(i,a,o,s,c,l=[],u)=>{let d,f;try{({priceOfTransactionInUSD:d,priceOfTransactionInToken:f}=await r.getGasEstimates(i,a.erc20TokenAddress,o,s,l.map(({from:e,to:t,calldata:n,value:r})=>({from:e,to:t,calldata:n,value:`${r}`})),c,u))}catch(e){n.logError(`processGasEstimates error:`,e)}let p=f?t.getAmountInWei(a,e.getValueFirstNDigit(f,a.decimals)):void 0;return{priceOfTransactionInUSD:d,priceOfTransactionInToken:p}};exports.processGasEstimates=i;

package/common/src/functions/pre-transaction/process-gas-estimates.mjs

@@ -0,0 +1,25 @@
+import { getValueFirstNDigit as e } from "../utils/amounts.utils.mjs";
+import { getAmountInWei as t } from "../web3/etherFunctions.mjs";
+import { logError as n } from "../../error-handling/logError.mjs";
+import { getGasEstimates as r } from "../../API/getGasEstimates.mjs";
+//#region libs/shared/common/src/functions/pre-transaction/process-gas-estimates.ts
+var i = async (i, a, o, s, c, l = [], u) => {
+	let d, f;
+	try {
+		({priceOfTransactionInUSD: d, priceOfTransactionInToken: f} = await r(i, a.erc20TokenAddress, o, s, l.map(({ from: e, to: t, calldata: n, value: r }) => ({
+			from: e,
+			to: t,
+			calldata: n,
+			value: `${r}`
+		})), c, u));
+	} catch (e) {
+		n("processGasEstimates error:", e);
+	}
+	let p = f ? t(a, e(f, a.decimals)) : void 0;
+	return {
+		priceOfTransactionInUSD: d,
+		priceOfTransactionInToken: p
+	};
+};
+//#endregion
+export { i as processGasEstimates };

package/common/src/functions/pre-transaction/recipientUtxoProcessing.cjs

@@ -0,0 +1 @@
+const e=require(`../utils/caseInsensitive.utils.cjs`),t=require(`../../data-structures/utxo/Utxo.cjs`);var n=(n,r,i,a)=>{let{recipientInfo:o,amount:s,token:c}=n,[l,u,d]=o.split(`,`),f=r.findIndex(t=>t.find(t=>e.caseInsensitiveEqual(t.erc20TokenAddress,n?.token.erc20TokenAddress))!==void 0),p=new t.Utxo({amount:s,erc20TokenAddress:c.erc20TokenAddress,timeStamp:a,randomization:BigInt(l),stealthAddress:u,encryptionKey:d});if(f===-1)throw Error(`Private recipient index not found`);r.forEach((e,n)=>{if(n===f)e.push(p),i[n]+=s;else{let n=new t.Utxo({amount:0n,erc20TokenAddress:e[0].erc20TokenAddress,timeStamp:a,randomization:BigInt(l),stealthAddress:u,encryptionKey:d});e.push(n)}})};exports.recipientUtxoProcessing=n;

package/common/src/functions/pre-transaction/recipientUtxoProcessing.mjs

@@ -0,0 +1,30 @@
+import { caseInsensitiveEqual as e } from "../utils/caseInsensitive.utils.mjs";
+import { Utxo as t } from "../../data-structures/utxo/Utxo.mjs";
+//#region libs/shared/common/src/functions/pre-transaction/recipientUtxoProcessing.ts
+var n = (n, r, i, a) => {
+	let { recipientInfo: o, amount: s, token: c } = n, [l, u, d] = o.split(","), f = r.findIndex((t) => t.find((t) => e(t.erc20TokenAddress, n?.token.erc20TokenAddress)) !== void 0), p = new t({
+		amount: s,
+		erc20TokenAddress: c.erc20TokenAddress,
+		timeStamp: a,
+		randomization: BigInt(l),
+		stealthAddress: u,
+		encryptionKey: d
+	});
+	if (f === -1) throw Error("Private recipient index not found");
+	r.forEach((e, n) => {
+		if (n === f) e.push(p), i[n] += s;
+		else {
+			let n = new t({
+				amount: 0n,
+				erc20TokenAddress: e[0].erc20TokenAddress,
+				timeStamp: a,
+				randomization: BigInt(l),
+				stealthAddress: u,
+				encryptionKey: d
+			});
+			e.push(n);
+		}
+	});
+};
+//#endregion
+export { n as recipientUtxoProcessing };

package/common/src/functions/pre-transaction/sendInitNullifiersTransaction.cjs

@@ -0,0 +1 @@
+require(`./solana.cjs`),require(`./sendV0Transaction.cjs`),require(`../utils/bytes32.utils.cjs`);

package/common/src/functions/pre-transaction/sendInitNullifiersTransaction.mjs

@@ -0,0 +1,3 @@
+import "./solana.mjs";
+import "./sendV0Transaction.mjs";
+import "../utils/bytes32.utils.mjs";

package/common/src/functions/pre-transaction/sendV0Transaction.cjs

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../utils/serialize.utils.cjs`),t=require(`../../constants/protocol.constants.cjs`),n=require(`../../data-structures/AccountActions/AccountActions.cjs`),r=require(`../../types/fee.types.cjs`),i=require(`../web3/getSolanaPriorityFee.cjs`),a=require(`../utils/process.utils.cjs`),o=require(`../../error-handling/retrySolanaError.cjs`);let s=require(`@solana/web3.js`);require(`@solana/spl-token`);var c=5e3,l=6e4,u=async(e,t,n=`confirmed`)=>await a.pollForValue(()=>e.getTransaction(t,{commitment:n,maxSupportedTransactionVersion:0}),{timeoutMs:l,intervalMs:c})??null,d=async(e,n,r,i)=>{try{let{blockhash:a}=await e.getLatestBlockhash(),o=new s.VersionedTransaction(new s.TransactionMessage({payerKey:n,recentBlockhash:a,instructions:[s.ComputeBudgetProgram.setComputeUnitLimit({units:t.MAX_COMPUTE_UNIT_LIMIT}),...r]}).compileToV0Message(i)),{unitsConsumed:c}=(await e.simulateTransaction(o,{sigVerify:!1,replaceRecentBlockhash:!0})).value;if(!c)return t.MAX_COMPUTE_UNIT_LIMIT;let l=Math.ceil(c*(1+t.COMPUTE_UNIT_PADDING_PERCENTAGE));return Math.max(t.MIN_COMPUTE_UNIT_LIMIT,Math.min(l,t.MAX_COMPUTE_UNIT_LIMIT))}catch{return t.MAX_COMPUTE_UNIT_LIMIT}},f=(e,t,n,r)=>{let i=new Set;return t&&i.add(t.toBase58()),n?.forEach(e=>i.add(e.toBase58())),e.forEach(e=>{i.add(e.programId.toBase58()),e.keys.forEach(e=>{i.add(e.pubkey.toBase58())})}),r&&r.forEach(e=>{i.add(e.key.toBase58()),e.state.addresses.forEach(e=>{i.add(e.toBase58())})}),[...i].map(e=>new s.PublicKey(e))},p=t=>{if(!t)throw Error(`Failed to fetch Solana transaction details for signature`);if(t.meta?.err){let n=e.safeJsonStringify(t.meta.err);throw Error(`Solana transaction failed on-chain: ${n}`)}},m=async(e,t,n,r,a)=>{let o=n.filter(e=>!e.programId.equals(s.ComputeBudgetProgram.programId)),c=await d(e,t,o,r),l=s.ComputeBudgetProgram.setComputeUnitLimit({units:c}),u=e.rpcEndpoint.includes(`helius`)?await i.getSolanaPriorityFee(f(o,t,[s.ComputeBudgetProgram.programId],r),a):0;return[l,s.ComputeBudgetProgram.setComputeUnitPrice({microLamports:u}),...o]},h=async({connection:e,chainId:t,subAccount:i,payerPublicKey:a,instructions:c,lookupTableAccounts:l})=>{let d=n.AccountActions.getPrivateKeyFromSubAccount(t,i);if(!d)throw Error(`Private key is not available`);for(let t=0;t<10;t+=1){let i=t===9;try{let t=await m(e,a,c,l,i?r.SolanaPriorityFeeMode.HIGH:r.SolanaPriorityFeeMode.RECOMMENDED),{blockhash:o,lastValidBlockHeight:f}=await e.getLatestBlockhash(),h=new s.VersionedTransaction(new s.TransactionMessage({payerKey:a,recentBlockhash:o,instructions:t}).compileToV0Message(l)),g=await n.AccountActions.sendAndSignSolanaTransactionFromPrivateKey(e,d,h,!0);return await e.confirmTransaction({signature:g,blockhash:o,lastValidBlockHeight:f},`confirmed`),p(await u(e,g)),g}catch(e){if(o.shouldRetryForSolanaError(e)&&!i)continue;throw e}}throw Error(`Failed to send proxy v0 transaction due to expired blockheight after all retries`)};exports.estimateComputeUnitLimit=d,exports.fetchSolanaTransaction=u,exports.getAccountsFromInstructions=f,exports.sendProxyV0Transaction=h;

package/common/src/functions/pre-transaction/sendV0Transaction.d.ts

@@ -0,0 +1,18 @@
+import { AddressLookupTableAccount, Connection, Finality, Keypair, PublicKey, TransactionInstruction, VersionedTransactionResponse } from '@solana/web3.js';
+import { SubAccount } from '../../types/proxy.types';
+export declare const fetchSolanaTransaction: (connection: Connection, signature: string, finality?: Finality) => Promise<VersionedTransactionResponse | null>;
+export declare const estimateComputeUnitLimit: (connection: Connection, payerKey: PublicKey, instructions: TransactionInstruction[], lookupTableAccounts?: AddressLookupTableAccount[]) => Promise<number>;
+export declare const getAccountsFromInstructions: (instructions: TransactionInstruction[], payerKey?: PublicKey, additionalAccounts?: PublicKey[], lookupTableAccounts?: AddressLookupTableAccount[]) => PublicKey[];
+export declare const sendV0Transaction: (connection: Connection, instructions: TransactionInstruction[], payer: Keypair, signers: Keypair[], lookupTableAccounts?: AddressLookupTableAccount[]) => Promise<string>;
+export declare const ensureAtaExists: (connection: Connection, payer: Keypair, mintPubkey: PublicKey | null, owner: PublicKey) => Promise<PublicKey | null>;
+type SendProxyV0TransactionParams = {
+    connection: Connection;
+    chainId: number;
+    subAccount: SubAccount;
+    payerPublicKey: PublicKey;
+    instructions: TransactionInstruction[];
+    lookupTableAccounts?: AddressLookupTableAccount[];
+};
+export declare const sendProxyV0Transaction: ({ connection, chainId, subAccount, payerPublicKey, instructions, lookupTableAccounts, }: SendProxyV0TransactionParams) => Promise<string>;
+export declare const serializeProxyV0Transaction: (connection: Connection, payerPublicKey: PublicKey, instructions: TransactionInstruction[], lookupTableAccounts?: AddressLookupTableAccount[]) => Promise<string>;
+export {};

package/common/src/functions/pre-transaction/sendV0Transaction.mjs

@@ -0,0 +1,81 @@
+import { safeJsonStringify as e } from "../utils/serialize.utils.mjs";
+import { COMPUTE_UNIT_PADDING_PERCENTAGE as t, MAX_COMPUTE_UNIT_LIMIT as n, MIN_COMPUTE_UNIT_LIMIT as r } from "../../constants/protocol.constants.mjs";
+import { AccountActions as i } from "../../data-structures/AccountActions/AccountActions.mjs";
+import { SolanaPriorityFeeMode as a } from "../../types/fee.types.mjs";
+import { getSolanaPriorityFee as o } from "../web3/getSolanaPriorityFee.mjs";
+import { pollForValue as s } from "../utils/process.utils.mjs";
+import { shouldRetryForSolanaError as c } from "../../error-handling/retrySolanaError.mjs";
+import { ComputeBudgetProgram as l, PublicKey as u, TransactionMessage as d, VersionedTransaction as f } from "@solana/web3.js";
+import "@solana/spl-token";
+//#region libs/shared/common/src/functions/pre-transaction/sendV0Transaction.ts
+var p = 5e3, m = 6e4, h = async (e, t, n = "confirmed") => await s(() => e.getTransaction(t, {
+	commitment: n,
+	maxSupportedTransactionVersion: 0
+}), {
+	timeoutMs: m,
+	intervalMs: p
+}) ?? null, g = async (e, i, a, o) => {
+	try {
+		let { blockhash: s } = await e.getLatestBlockhash(), c = new f(new d({
+			payerKey: i,
+			recentBlockhash: s,
+			instructions: [l.setComputeUnitLimit({ units: n }), ...a]
+		}).compileToV0Message(o)), { unitsConsumed: u } = (await e.simulateTransaction(c, {
+			sigVerify: !1,
+			replaceRecentBlockhash: !0
+		})).value;
+		if (!u) return n;
+		let p = Math.ceil(u * (1 + t));
+		return Math.max(r, Math.min(p, n));
+	} catch {
+		return n;
+	}
+}, _ = (e, t, n, r) => {
+	let i = /* @__PURE__ */ new Set();
+	return t && i.add(t.toBase58()), n?.forEach((e) => i.add(e.toBase58())), e.forEach((e) => {
+		i.add(e.programId.toBase58()), e.keys.forEach((e) => {
+			i.add(e.pubkey.toBase58());
+		});
+	}), r && r.forEach((e) => {
+		i.add(e.key.toBase58()), e.state.addresses.forEach((e) => {
+			i.add(e.toBase58());
+		});
+	}), [...i].map((e) => new u(e));
+}, v = (t) => {
+	if (!t) throw Error("Failed to fetch Solana transaction details for signature");
+	if (t.meta?.err) {
+		let n = e(t.meta.err);
+		throw Error(`Solana transaction failed on-chain: ${n}`);
+	}
+}, y = async (e, t, n, r, i) => {
+	let a = n.filter((e) => !e.programId.equals(l.programId)), s = await g(e, t, a, r), c = l.setComputeUnitLimit({ units: s }), u = e.rpcEndpoint.includes("helius") ? await o(_(a, t, [l.programId], r), i) : 0;
+	return [
+		c,
+		l.setComputeUnitPrice({ microLamports: u }),
+		...a
+	];
+}, b = async ({ connection: e, chainId: t, subAccount: n, payerPublicKey: r, instructions: o, lookupTableAccounts: s }) => {
+	let l = i.getPrivateKeyFromSubAccount(t, n);
+	if (!l) throw Error("Private key is not available");
+	for (let t = 0; t < 10; t += 1) {
+		let n = t === 9;
+		try {
+			let t = await y(e, r, o, s, n ? a.HIGH : a.RECOMMENDED), { blockhash: c, lastValidBlockHeight: u } = await e.getLatestBlockhash(), p = new f(new d({
+				payerKey: r,
+				recentBlockhash: c,
+				instructions: t
+			}).compileToV0Message(s)), m = await i.sendAndSignSolanaTransactionFromPrivateKey(e, l, p, !0);
+			return await e.confirmTransaction({
+				signature: m,
+				blockhash: c,
+				lastValidBlockHeight: u
+			}, "confirmed"), v(await h(e, m)), m;
+		} catch (e) {
+			if (c(e) && !n) continue;
+			throw e;
+		}
+	}
+	throw Error("Failed to send proxy v0 transaction due to expired blockheight after all retries");
+};
+//#endregion
+export { g as estimateComputeUnitLimit, h as fetchSolanaTransaction, _ as getAccountsFromInstructions, b as sendProxyV0Transaction };

package/common/src/functions/pre-transaction/shouldPatchAccessTokenMerkleTree.cjs

@@ -0,0 +1 @@
+var e=async(e,t,n,r,i)=>{let[a,o]=await Promise.all([e.checkTokenRegistry(t,n,r),e.checkAccessToken(t,i)]);return{patchAccessTokenMerkleTree:a&&!o,hasAccessToken:o,kycRequired:a}};exports.shouldPatchAccessTokenMerkleTree=e;

package/common/src/functions/pre-transaction/shouldPatchAccessTokenMerkleTree.d.ts

@@ -0,0 +1,6 @@
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+export declare const shouldPatchAccessTokenMerkleTree: (hinkal: IHinkal, chainId: number, erc20Addresses: string[], amountChanges: bigint[], accessKeyOverride?: string) => Promise<{
+    patchAccessTokenMerkleTree: boolean;
+    hasAccessToken: boolean;
+    kycRequired: boolean;
+}>;

package/common/src/functions/pre-transaction/shouldPatchAccessTokenMerkleTree.mjs

@@ -0,0 +1,11 @@
+//#region libs/shared/common/src/functions/pre-transaction/shouldPatchAccessTokenMerkleTree.ts
+var e = async (e, t, n, r, i) => {
+	let [a, o] = await Promise.all([e.checkTokenRegistry(t, n, r), e.checkAccessToken(t, i)]);
+	return {
+		patchAccessTokenMerkleTree: a && !o,
+		hasAccessToken: o,
+		kycRequired: a
+	};
+};
+//#endregion
+export { e as shouldPatchAccessTokenMerkleTree };

package/common/src/functions/pre-transaction/solana-public-signals.d.ts

@@ -0,0 +1,20 @@
+export declare const convertSolanaPublicSignals: (publicInputsArr: number[][], dimensions: {
+    tokenNumber: number;
+    nullifierAmount: number;
+    outputAmount: number;
+}) => {
+    swapperAccountAdditionalSeed: number[];
+    extraRandomizedStealthAddress: number[];
+    extraRandomizedStealthAddressSigns: number[];
+    extraRandomizedStealthAddressH0Ay: number[];
+    extraRandomizedStealthAddressH1Ay: number[];
+    rootHash: number[];
+    mintAccountPart1: number[][];
+    mintAccountPart2: number[][];
+    inNullifiers: number[][][];
+    outTimestamp: number[];
+    extraRandomization: number[];
+    amountChanges: number[][];
+    outCommitments: number[][][];
+    calldataHash: number[];
+};

package/common/src/functions/pre-transaction/solana.cjs

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../crypto/poseidon.cjs`);let t=require(`@coral-xyz/anchor`),n=require(`@solana/web3.js`);var r=e=>new TextEncoder().encode(e),i=e=>{let t=[],n=e;for(;n>0n;)t.unshift(Number(n%256n)),n/=256n;for(;t.length<32;)t.unshift(0);return t},a=e=>({extraRandomization:i(e.extraRandomization),stealthAddress:i(e.stealthAddress),h0:i(e.H0),h1:i(e.H1)}),o=(e,t)=>{let i=[r(`hinkal`),t.toBytes()],[a]=n.PublicKey.findProgramAddressSync(i,e);return a},s=(e,t)=>{let i=[r(`hinkal_merkle`),t.toBytes()],[a]=n.PublicKey.findProgramAddressSync(i,e);return a},c=(e,t)=>{let i=[r(`hinkal_merkle_access_token`),t.toBytes()],[a]=n.PublicKey.findProgramAddressSync(i,e);return a},l=(e,i,a)=>{let o=[r(`hinkal_swapper`),i.toBytes(),new Uint8Array(new t.BN(a.toString()).toArray(`be`,32))],[s]=n.PublicKey.findProgramAddressSync(o,e);return s},u=(t,n,r)=>l(t,n,e.poseidonFunction(r)),d=(e,t)=>{let i=[r(`hinkal_vault`),t.toBytes()],[a]=n.PublicKey.findProgramAddressSync(i,e);return a},f=(e,t,a)=>{let o=i(e),s=[r(`hinkal_access_keys`),a.toBytes(),new Uint8Array(o)],[c]=n.PublicKey.findProgramAddressSync(s,t);return c},p=(e,t,i)=>{let a=[r(`hinkal_token_limit`),t.toBytes(),i.toBytes()],[o]=n.PublicKey.findProgramAddressSync(a,e);return o};exports.buildAnchorStealthAddressStructure=a,exports.encodeToByte32Array=i,exports.getAccessTokenAccountPublicKey=f,exports.getAccessTokenMerkleAccountPublicKey=c,exports.getMerkleAccountPublicKey=s,exports.getStorageAccountPublicKey=o,exports.getStorageVaultPublicKey=d,exports.getSwapperAccountPublicKey=l,exports.getSwapperAccountPublicKeyFromSalt=u,exports.getTokenLimitStorageAccountPublicKey=p;

package/common/src/functions/pre-transaction/solana.d.ts

@@ -0,0 +1,18 @@
+import { AnchorStealthAddressStructure, StealthAddressStructure } from '../../types/circom-data.types';
+import { PublicKey } from '@solana/web3.js';
+export declare const encodeToByte32Array: (value: bigint) => number[];
+export declare const buildAnchorStealthAddressStructure: (structure: StealthAddressStructure) => AnchorStealthAddressStructure;
+export declare const getNullifierAccount: (nullifier: bigint, originalDeployer: PublicKey, programId: PublicKey) => PublicKey;
+export declare const getStorageAccountPublicKey: (programId: PublicKey, originalDeployer: PublicKey) => PublicKey;
+export declare const getMerkleAccountPublicKey: (programId: PublicKey, originalDeployer: PublicKey) => PublicKey;
+export declare const getAccessTokenMerkleAccountPublicKey: (programId: PublicKey, originalDeployer: PublicKey) => PublicKey;
+export declare const getAccessTokenStorageAccountPublicKey: (programId: PublicKey, originalDeployer: PublicKey) => PublicKey;
+export declare const getSwapperAccountPublicKey: (programId: PublicKey, originalDeployer: PublicKey, swapperAccountAdditionalSeed: bigint) => PublicKey;
+export declare const getSwapperAccountPublicKeyFromSalt: (programId: PublicKey, originalDeployer: PublicKey, swapperAccountSalt: bigint) => PublicKey;
+export declare const getStorageVaultPublicKey: (programId: PublicKey, originalDeployer: PublicKey) => PublicKey;
+export declare const getAccessTokenAccountPublicKey: (accessKey: bigint, programId: PublicKey, originalDeployer: PublicKey) => PublicKey;
+export declare const getProofAccountPart1PublicKey: (programId: PublicKey, originalDeployer: PublicKey, signer: PublicKey, id: bigint) => PublicKey;
+export declare const getProofAccountPart2PublicKey: (programId: PublicKey, originalDeployer: PublicKey, signer: PublicKey, id: bigint) => PublicKey;
+export declare const getEncryptedOutputsAccountPublicKey: (programId: PublicKey, originalDeployer: PublicKey, signer: PublicKey, id: bigint) => PublicKey;
+export declare const getTokenLimitStorageAccountPublicKey: (programId: PublicKey, originalDeployer: PublicKey, mint: PublicKey) => PublicKey;
+export declare const getInstructionsAccountPublicKey: (programId: PublicKey, originalDeployer: PublicKey, signer: PublicKey, id: bigint) => PublicKey;