@kapa123456789/sdk 0.0.39 → 0.0.40

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

@@ -0,0 +1,26 @@
+import { hashEthereumAddress as e } from "../utils/addresses.mjs";
+//#region libs/shared/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 libs/shared/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 libs/shared/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 libs/shared/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/erc20tokenFunctions.cjs`),n=require(`../utils/caseInsensitive.utils.cjs`),r=require(`../../error-handling/logger.cjs`),i=require(`./process-gas-estimates.cjs`);var a=async(a,o,s,c,l=[],u=0n,d)=>{let f=t.getERC20Token(o??e.defaultFeeToken,a);if(!f)throw Error(`failed to find feeToken`);let{priceOfTransactionInToken:p}=await i.processGasEstimates(a,f,c,s.some(e=>n.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 r.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 { getERC20Token as t } from "../utils/erc20tokenFunctions.mjs";
+import { caseInsensitiveEqual as n } from "../utils/caseInsensitive.utils.mjs";
+import { Logger as r } from "../../error-handling/logger.mjs";
+import { processGasEstimates as i } from "./process-gas-estimates.mjs";
+//#region libs/shared/common/src/functions/pre-transaction/getFeeStructure.ts
+var a = async (a, o, s, c, l = [], u = 0n, d) => {
+	let f = t(o ?? e, a);
+	if (!f) throw Error("failed to find feeToken");
+	let { priceOfTransactionInToken: p } = await i(a, f, c, s.some((e) => n(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 r.log(m), m;
+};
+//#endregion
+export { a as getFeeStructure };

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

@@ -0,0 +1,3 @@
+import { UserKeys } from '../../data-structures/crypto-keys';
+import { SignatureData } from '../../types/crypto.types';
+export declare const getSignatureDataForTransact: (currentChainId: number, ethereumAddress: string, userKeys: UserKeys, kycRequired: boolean, hasAccessToken: boolean) => Promise<SignatureData>;

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.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 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`),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,31 @@
+import { simulateVolatileTokenTransfer as e } from "../../API/simulate-transaction.mjs";
+import { Logger as t } from "../../error-handling/logger.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.d.ts

@@ -0,0 +1,22 @@
+export * from './interaction-to-action';
+export * from './outputUtxoProcessing';
+export * from './process-gas-estimates';
+export * from './getFlatFees';
+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/initTokenLimitIfNeeded.d.ts

@@ -0,0 +1,3 @@
+import { Program } from '@coral-xyz/anchor';
+import { Keypair, PublicKey } from '@solana/web3.js';
+export declare const initTokenLimitIfNeeded: (program: Program, originalDeployer: PublicKey, mint: PublicKey, signer: Keypair) => Promise<void>;

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

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

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/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.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, tokenId?: number, revertIfNegative?: boolean, recipientAddress?: string, recipientAmountChange?: bigint) => {
+    outputUtxos: Utxo[];
+};

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.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 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.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,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.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/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.fetchSolanaTransaction=u,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 {};