@hinkal/react-native 0.3.1

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

@@ -0,0 +1,2 @@
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+export declare const calculateSolanaNullifierCount: (hinkal: IHinkal, chainId: number, mintAddresses: string[], amountChanges: bigint[]) => Promise<number>;

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

@@ -0,0 +1,5 @@
+import "../../constants/chains.constants.mjs";
+import "../web3/events/getShieldedBalance.mjs";
+import "./solana.mjs";
+import "../utils/create-provider.mjs";
+import "@solana/web3.js";

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

@@ -0,0 +1 @@
+const e=require(`../utils/addresses.cjs`);var t=(t,n,r,i,a,o)=>{if(!t)return;let s;return o&&(s={tokenIn:{symbol:o[0]?.symbol,address:o[0]?.erc20TokenAddress.toLowerCase()},tokenOut:{symbol:o[1]?.symbol,address:o[1]?.erc20TokenAddress.toLowerCase()}}),{hashedOwner:e.hashEthereumAddress(a),chainId:n,timestamp:Date.now(),action:t,erc20TokenAddresses:r,erc20TokenAmount:i.map(String),swapPair:s}};exports.constructAdminData=t;

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

@@ -0,0 +1,3 @@
+import { AdminDataType, AdminTransactionType } from '../../types/admin.types';
+import { ERC20Token } from '../../types';
+export declare const constructAdminData: (action: AdminTransactionType | undefined, chainId: number, erc20TokenAddresses: string[], amountChanges: bigint[], ethereumAddress: string, swapPairTokens?: ERC20Token[]) => AdminDataType | undefined;

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

@@ -0,0 +1,26 @@
+import { hashEthereumAddress as e } from "../utils/addresses.mjs";
+//#region common/src/functions/pre-transaction/constructAdminData.ts
+var t = (t, n, r, i, a, o) => {
+	if (!t) return;
+	let s;
+	return o && (s = {
+		tokenIn: {
+			symbol: o[0]?.symbol,
+			address: o[0]?.erc20TokenAddress.toLowerCase()
+		},
+		tokenOut: {
+			symbol: o[1]?.symbol,
+			address: o[1]?.erc20TokenAddress.toLowerCase()
+		}
+	}), {
+		hashedOwner: e(a),
+		chainId: n,
+		timestamp: Date.now(),
+		action: t,
+		erc20TokenAddresses: r,
+		erc20TokenAmount: i.map(String),
+		swapPair: s
+	};
+};
+//#endregion
+export { t as constructAdminData };

package/common/src/functions/pre-transaction/convert-okx-instructions.cjs

@@ -0,0 +1 @@
+require("../../../../_virtual/_rolldown/runtime.cjs");let e=require(`@solana/web3.js`);var t=255,n=(n,r)=>{let i=[],a=[];return n.forEach(n=>{let o=Buffer.from(n.accounts.map(n=>{if(n.pubkey.toString()===r.toString())return t;let a=i.findIndex(e=>e.pubkey.toBase58()===n.pubkey);return a===-1?(i.push({pubkey:new e.PublicKey(n.pubkey),isSigner:!1,isWritable:n.isWritable}),i.length-1):(i[a].isWritable!==n.isWritable&&(i[a].isWritable=!0),a)})),s=Buffer.from(n.data,`base64`),c=i.findIndex(e=>e.pubkey.toBase58()===n.programId);c===-1?(i.push({pubkey:new e.PublicKey(n.programId),isSigner:!1,isWritable:!1}),a.push({data:s,programIndex:i.length-1,accountIndexes:o})):a.push({data:s,programIndex:c,accountIndexes:o})}),{hinkalInstructions:a,remainingAccounts:i}};exports.convertOKXToHinkalInstructions=n;

package/common/src/functions/pre-transaction/convert-okx-instructions.d.ts

@@ -0,0 +1,11 @@
+import { AccountMeta, PublicKey } from '@solana/web3.js';
+import { OKXSwapResponseInstruction } from '../../types/okx.types';
+export interface HinkalInstruction {
+    accountIndexes: Buffer;
+    data: Buffer;
+    programIndex: number;
+}
+export declare const convertOKXToHinkalInstructions: (okxInstructions: OKXSwapResponseInstruction[], cpiSignerAccount: PublicKey) => {
+    hinkalInstructions: HinkalInstruction[];
+    remainingAccounts: AccountMeta[];
+};

package/common/src/functions/pre-transaction/convert-okx-instructions.mjs

@@ -0,0 +1,34 @@
+import { PublicKey as e } from "@solana/web3.js";
+//#region common/src/functions/pre-transaction/convert-okx-instructions.ts
+var t = 255, n = (n, r) => {
+	let i = [], a = [];
+	return n.forEach((n) => {
+		let o = Buffer.from(n.accounts.map((n) => {
+			if (n.pubkey.toString() === r.toString()) return t;
+			let a = i.findIndex((e) => e.pubkey.toBase58() === n.pubkey);
+			return a === -1 ? (i.push({
+				pubkey: new e(n.pubkey),
+				isSigner: !1,
+				isWritable: n.isWritable
+			}), i.length - 1) : (i[a].isWritable !== n.isWritable && (i[a].isWritable = !0), a);
+		})), s = Buffer.from(n.data, "base64"), c = i.findIndex((e) => e.pubkey.toBase58() === n.programId);
+		c === -1 ? (i.push({
+			pubkey: new e(n.programId),
+			isSigner: !1,
+			isWritable: !1
+		}), a.push({
+			data: s,
+			programIndex: i.length - 1,
+			accountIndexes: o
+		})) : a.push({
+			data: s,
+			programIndex: c,
+			accountIndexes: o
+		});
+	}), {
+		hinkalInstructions: a,
+		remainingAccounts: i
+	};
+};
+//#endregion
+export { n as convertOKXToHinkalInstructions };

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

@@ -0,0 +1 @@
+require("../../../../_virtual/_rolldown/runtime.cjs");const e=require(`../../constants/protocol.constants.cjs`),t=require(`../snarkjs/common.snarkjs.cjs`);let n=require(`lodash`);var r=(r,i,a)=>{let o=t.calcAmountChanges(r,i),s=a.map(t=>t<0n?e.CIRCOM_P+t:t);if(o.length!==s.length||!(0,n.isEqual)(o,s))throw Error(`Amount changes are not equal`)};exports.ensureAmountChanges=r;

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

@@ -0,0 +1,2 @@
+import { Utxo } from '../../data-structures/utxo/Utxo';
+export declare const ensureAmountChanges: (inputUtxos: Utxo[][], outputUtxos: Utxo[][], amountChanges: bigint[]) => void;

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

@@ -0,0 +1,10 @@
+import { CIRCOM_P as e } from "../../constants/protocol.constants.mjs";
+import { calcAmountChanges as t } from "../snarkjs/common.snarkjs.mjs";
+import { isEqual as n } from "lodash";
+//#region common/src/functions/pre-transaction/ensureAmountChanges.ts
+var r = (r, i, a) => {
+	let o = t(r, i), s = a.map((t) => t < 0n ? e + t : t);
+	if (o.length !== s.length || !n(o, s)) throw Error("Amount changes are not equal");
+};
+//#endregion
+export { r as ensureAmountChanges };

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

@@ -0,0 +1 @@
+const e=require(`../../constants/chains.constants.cjs`),t=require(`../../types/external-action.types.cjs`);var n=(n,r)=>{let{contractData:i}=e.networkRegistry[n],a;switch(r){case t.ExternalActionId.Uniswap:a=i?.uniswapExternalActionAddress;break;case t.ExternalActionId.Odos:a=i?.odosExternalActionInstanceAddress;break;case t.ExternalActionId.OneInch:a=i?.oneInchExternalActionInstanceAddress;break;case t.ExternalActionId.Lifi:a=i?.hinkalAddress;break;default:a=i?.uniswapExternalActionAddress;break}if(!a)throw Error(`No external Address set during swap`);return a};exports.getExternalSwapAddress=n;

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

@@ -0,0 +1,2 @@
+import { ExternalActionId } from '../../types/external-action.types';
+export declare const getExternalSwapAddress: (chainId: number, externalActionId: ExternalActionId) => string;

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

@@ -0,0 +1,27 @@
+import { networkRegistry as e } from "../../constants/chains.constants.mjs";
+import { ExternalActionId as t } from "../../types/external-action.types.mjs";
+//#region common/src/functions/pre-transaction/getExternalSwapAddress.ts
+var n = (n, r) => {
+	let { contractData: i } = e[n], a;
+	switch (r) {
+		case t.Uniswap:
+			a = i?.uniswapExternalActionAddress;
+			break;
+		case t.Odos:
+			a = i?.odosExternalActionInstanceAddress;
+			break;
+		case t.OneInch:
+			a = i?.oneInchExternalActionInstanceAddress;
+			break;
+		case t.Lifi:
+			a = i?.hinkalAddress;
+			break;
+		default:
+			a = i?.uniswapExternalActionAddress;
+			break;
+	}
+	if (!a) throw Error("No external Address set during swap");
+	return a;
+};
+//#endregion
+export { n as getExternalSwapAddress };

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

@@ -0,0 +1 @@
+const e=require(`../../constants/fees.constants.cjs`),t=require(`../utils/caseInsensitive.utils.cjs`),n=require(`../../error-handling/logger.cjs`),r=require(`../utils/erc20tokenFunctions.cjs`),i=require(`./process-gas-estimates.cjs`);var a=async(a,o,s,c,l=[],u=0n,d)=>{let f=await r.getErc20TokenFromAPI(a,o??e.defaultFeeToken);if(!f)throw Error(`failed to find feeToken`);let{priceOfTransactionInToken:p}=await i.processGasEstimates(a,f,c,s.some(e=>t.caseInsensitiveEqual(e,o))?s.length+1:s.length,void 0,l,d);if(p===void 0)throw Error(`failed to process gas estimates`);let m={feeToken:f.erc20TokenAddress,flatFee:p,variableRate:u};return n.Logger.log(m),m};exports.getFeeStructure=a;

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

@@ -0,0 +1,5 @@
+import { FeeStructure } from '../../types/hinkal.types';
+import { ExternalActionId } from '../../types/external-action.types';
+import { CallInfo } from '../../types/API.types';
+import { SolanaTransactionParams } from '../../types/solana.types';
+export declare const getFeeStructure: (chainId: number, feeTokenAddress: string | undefined, erc20Addresses: string[], externalActionId: ExternalActionId, calls?: CallInfo[], variableRate?: bigint, solanaTransactionParams?: SolanaTransactionParams) => Promise<FeeStructure>;

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

@@ -0,0 +1,20 @@
+import { defaultFeeToken as e } from "../../constants/fees.constants.mjs";
+import { caseInsensitiveEqual as t } from "../utils/caseInsensitive.utils.mjs";
+import { Logger as n } from "../../error-handling/logger.mjs";
+import { getErc20TokenFromAPI as r } from "../utils/erc20tokenFunctions.mjs";
+import { processGasEstimates as i } from "./process-gas-estimates.mjs";
+//#region common/src/functions/pre-transaction/getFeeStructure.ts
+var a = async (a, o, s, c, l = [], u = 0n, d) => {
+	let f = await r(a, o ?? e);
+	if (!f) throw Error("failed to find feeToken");
+	let { priceOfTransactionInToken: p } = await i(a, f, c, s.some((e) => t(e, o)) ? s.length + 1 : s.length, void 0, l, d);
+	if (p === void 0) throw Error("failed to process gas estimates");
+	let m = {
+		feeToken: f.erc20TokenAddress,
+		flatFee: p,
+		variableRate: u
+	};
+	return n.log(m), m;
+};
+//#endregion
+export { a as getFeeStructure };

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

@@ -0,0 +1,4 @@
+import { DimDataType } from '../../types/circom-data.types';
+import { AccountMeta, PublicKey } from '@solana/web3.js';
+import { HinkalInstruction } from './convert-okx-instructions';
+export declare const getSolanaCalldataHash: (dimensions: DimDataType, recipient: PublicKey, signer: PublicKey, encryptedOutputs: number[][], relayerFee: bigint, variableRate: bigint, instructions: HinkalInstruction[], remainingAccounts: AccountMeta[]) => bigint;

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 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(`../../error-handling/logger.cjs`),t=require(`../../API/simulate-transaction.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 e=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(e.length===0)return a;let s=await t.simulateVolatileTokenTransfer(r,e);return a.map((t,n)=>{let r=e.findIndex(e=>e.originalIndex===n);if(r!==-1&&s[r].success){let e=s[r].balanceDifference;return e?BigInt(e):t}return t})}catch(t){return e.Logger.error(`Volatile transfer simulation failed:`,t),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 { Logger as e } from "../../error-handling/logger.mjs";
+import { simulateVolatileTokenTransfer as t } from "../../API/simulate-transaction.mjs";
+import "../../error-handling/index.mjs";
+import { TokenChecker as n } from "../../data-structures/token-price-fetcher/TokenChecker.mjs";
+//#region common/src/functions/pre-transaction/getVolatileTransferAmount.ts
+var r = async (r, i, a, o) => {
+	try {
+		let e = 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 (e.length === 0) return a;
+		let s = await t(r, e);
+		return a.map((t, n) => {
+			let r = e.findIndex((e) => e.originalIndex === n);
+			if (r !== -1 && s[r].success) {
+				let e = s[r].balanceDifference;
+				return e ? BigInt(e) : t;
+			}
+			return t;
+		});
+	} catch (t) {
+		return e.error("Volatile transfer simulation failed:", t), a;
+	}
+};
+//#endregion
+export { r as modifyVolatileTokenAmountChanges };

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

@@ -0,0 +1 @@
+require(`./outputUtxoProcessing.cjs`),require(`./solana.cjs`),require(`./interaction-to-action.cjs`),require(`./process-gas-estimates.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(`./recipientUtxoProcessing.cjs`),require(`./store-instructions.cjs`),require(`./ensureAmountChanges.cjs`),require(`./getFeeStructure.cjs`),require(`./waitForDepositedUtxosInMerkleTree.cjs`),require(`./buildCommitmentValidationData.cjs`);

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

@@ -0,0 +1,19 @@
+export * from './interaction-to-action';
+export * from './outputUtxoProcessing';
+export * from './process-gas-estimates';
+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 './recipientUtxoProcessing';
+export * from './store-instructions';
+export * from './ensureAmountChanges';
+export * from './getFeeStructure';
+export * from './waitForDepositedUtxosInMerkleTree';
+export * from './buildCommitmentValidationData';

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

@@ -0,0 +1,18 @@
+import "./outputUtxoProcessing.mjs";
+import "./solana.mjs";
+import "./interaction-to-action.mjs";
+import "./process-gas-estimates.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 "./recipientUtxoProcessing.mjs";
+import "./store-instructions.mjs";
+import "./ensureAmountChanges.mjs";
+import "./getFeeStructure.mjs";
+import "./waitForDepositedUtxosInMerkleTree.mjs";
+import "./buildCommitmentValidationData.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.d.ts

@@ -0,0 +1,2 @@
+import { ExternalActionId, INTERACTION } from '../../types';
+export declare const getInteractionFromAction: (externalActionId: ExternalActionId) => INTERACTION;

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(`../utils/amounts.utils.cjs`),n=require(`../../types/ethereum-network.types.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:t.maxBigInt(f.flatFee-g,0n),m!==0n&&(await i.mergeWithFeeStructure(s,u,d,{...f,flatFee:m}),l.push(r.createTransferToEmporiumOp(f.feeToken===e.zeroAddress?void 0:o.getContractWithFetcher(s,n.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 { maxBigInt as t } from "../utils/amounts.utils.mjs";
+import { ContractType as n } from "../../types/ethereum-network.types.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 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 : t(f.flatFee - g, 0n), m !== 0n && (await i(s, u, d, {
+		...f,
+		flatFee: m
+	}), l.push(r(f.feeToken === e ? void 0 : o.getContractWithFetcher(s, n.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/caseInsensitive.utils.cjs`),t=require(`../../error-handling/customErrors/FeeOverTransactionValueError.cjs`),n=require(`../../error-handling/logger.cjs`),r=require(`../utils/erc20tokenFunctions.cjs`);require(`../utils/index.cjs`);var i=async(i,a,o,s)=>{n.Logger.log(`amount changes before merge`,{amountChanges:o});let c=a.findIndex(t=>e.caseInsensitiveEqual(t,s.feeToken));if(c===-1){a.push(s.feeToken),o.push(-1n*s.flatFee),n.Logger.log(`amount changes after merge`,{amountChanges:o});return}if(o[c]>0&&o[c]<s.flatFee){let e=await r.getErc20TokenFromAPI(i,s.feeToken);throw new t.FeeOverTransactionValueError({totalFeeWEI:s.flatFee,feeUnit:e})}o[c]-=s.flatFee,n.Logger.log(`amount changes after merge`,{amountChanges:o})};exports.mergeWithFeeStructure=i;

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

@@ -0,0 +1,2 @@
+import { FeeStructure } from '../../types/hinkal.types';
+export declare const mergeWithFeeStructure: (chainId: number, erc20Addresses: string[], amountChanges: bigint[], feeStructure: FeeStructure) => Promise<void>;

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

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

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=!0,c,l)=>{let u=e.countTotalAmountInUtxos(i),{erc20TokenAddress:d,mintAddress:f}=i[0];if(s&&a<0n&&u+a<0n)throw Error(t.transactionErrorCodes.INSUFFICIENT_FUNDS_TO_TRANSACT);let p=[new n.Utxo({amount:e.bigintMax(u+a,0n),erc20TokenAddress:d,mintAddress:f,nullifyingKey:r.getShieldedPrivateKey(),timeStamp:o,spendingPublicKey:r.getSpendingKeyPair().pubSpendingBJJPoint,isNewStyle:!0})];if(c!==void 0&&l!==void 0){let[e,t,r,,i]=c.split(`,`);p.push(new n.Utxo({amount:l,erc20TokenAddress:d,mintAddress:f,H0:[BigInt(t),BigInt(r)],stealthAddress:e,encryptionKey:i,timeStamp:o,isNewStyle:!0}))}return{outputUtxos:p}};exports.outputUtxoProcessing=r;

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

@@ -0,0 +1,5 @@
+import { UserKeys } from '../../data-structures/crypto-keys/keys';
+import { Utxo } from '../../data-structures/utxo/Utxo';
+export declare const outputUtxoProcessing: (userKeys: UserKeys, inputUtxos: Utxo[], amountChange: bigint, timeStamp?: string, revertIfNegative?: boolean, recipientAddress?: string, recipientAmountChange?: bigint) => {
+    outputUtxos: Utxo[];
+};

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

@@ -0,0 +1,33 @@
+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 common/src/functions/pre-transaction/outputUtxoProcessing.ts
+var i = (i, a, o, s, c = !0, l, u) => {
+	let d = t(a), { erc20TokenAddress: f, mintAddress: p } = a[0];
+	if (c && o < 0n && d + o < 0n) throw Error(n.INSUFFICIENT_FUNDS_TO_TRANSACT);
+	let m = [new r({
+		amount: e(d + o, 0n),
+		erc20TokenAddress: f,
+		mintAddress: p,
+		nullifyingKey: i.getShieldedPrivateKey(),
+		timeStamp: s,
+		spendingPublicKey: i.getSpendingKeyPair().pubSpendingBJJPoint,
+		isNewStyle: !0
+	})];
+	if (l !== void 0 && u !== void 0) {
+		let [e, t, n, , i] = l.split(",");
+		m.push(new r({
+			amount: u,
+			erc20TokenAddress: f,
+			mintAddress: p,
+			H0: [BigInt(t), BigInt(n)],
+			stealthAddress: e,
+			encryptionKey: i,
+			timeStamp: s,
+			isNewStyle: !0
+		}));
+	}
+	return { outputUtxos: m };
+};
+//#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.d.ts

@@ -0,0 +1,5 @@
+import { CallInfo, ERC20Token, ExternalActionId, SolanaTransactionParams } from '../../types';
+export declare const processGasEstimates: (chainId: number, tokenForGasFee: ERC20Token, externalActionId: ExternalActionId, erc20TokenAddressLength: number, gasAmount?: number, calls?: CallInfo<bigint>[], solanaTransactionParams?: SolanaTransactionParams) => Promise<{
+    priceOfTransactionInUSD: number | undefined;
+    priceOfTransactionInToken: bigint | undefined;
+}>;

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 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,,f]=o.split(`,`),p=r.findIndex(t=>t.find(t=>e.caseInsensitiveEqual(t.erc20TokenAddress,n?.token.erc20TokenAddress))!==void 0),m=new t.Utxo({amount:s,erc20TokenAddress:c.erc20TokenAddress,timeStamp:a,H0:[BigInt(u),BigInt(d)],stealthAddress:l,encryptionKey:f,isNewStyle:!0});if(p===-1)throw Error(`Private recipient index not found`);r.forEach((e,n)=>{if(n===p)e.push(m),i[n]+=s;else{let n=new t.Utxo({amount:0n,erc20TokenAddress:e[0].erc20TokenAddress,timeStamp:a,H0:[BigInt(u),BigInt(d)],stealthAddress:l,encryptionKey:f,isNewStyle:!0});e.push(n)}})};exports.recipientUtxoProcessing=n;

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

@@ -0,0 +1,3 @@
+import { Utxo } from '../../data-structures/utxo/Utxo';
+import { PrivateRecipientInfo } from '../../types/token.types';
+export declare const recipientUtxoProcessing: (privateRecipientInfo: PrivateRecipientInfo, outputUtxosArray: Utxo[][], deltaChanges: bigint[], timeStamp: string) => void;

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

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

@@ -0,0 +1,11 @@
+import { Program } from '@coral-xyz/anchor';
+import { Connection, Keypair, PublicKey } from '@solana/web3.js';
+interface CreatedNullifierAccount {
+    account: PublicKey;
+    nullifier: number[];
+}
+export declare const sendInitNullifiersTransaction: (connection: Connection, program: Program, originalDeployer: PublicKey, signer: Keypair, nullifiers: number[][]) => Promise<{
+    signature: string;
+    createdAccounts: Array<CreatedNullifierAccount>;
+}>;
+export {};

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

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[], requestHeapFrame?: boolean) => 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[], requestHeapFrame?: boolean) => 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 {};