@kapa123456789/sdk 0.0.1

package/common/src/functions/kyc/zkMeHelper.mjs

@@ -0,0 +1,42 @@
+import { chainIds as e } from "../../constants/chains.constants.mjs";
+import { getHinkalZkMeProvider as t } from "../../data-structures/Hinkal/hinkalGetZkMeProvider.mjs";
+import { openDefaultPassportWindow as n } from "./openDefaultPassportWindow.mjs";
+import { ethers as r } from "ethers";
+//#region libs/shared/common/src/functions/kyc/zkMeHelper.ts
+async function i(e, t) {
+	if (e.origin === "https://widget.zk.me") {
+		if (e.data.method === "getUserAccounts") {
+			let n = await t.getUserAccounts();
+			e.source?.postMessage({
+				id: e.data.id,
+				message: "ok",
+				data: n
+			}, { targetOrigin: e.origin });
+		}
+		if (e.data.method === "getAccessToken") {
+			let n = await t.getAccessToken();
+			e.source?.postMessage({
+				id: e.data.id,
+				message: "ok",
+				data: n
+			}, { targetOrigin: e.origin });
+		}
+		if (e.data.method === "delegateTransaction") {
+			let n = e.data.params;
+			if (t.delegateTransaction) {
+				let r = await t.delegateTransaction(n);
+				e.source?.postMessage({
+					id: e.data.id,
+					message: "ok",
+					data: r
+				}, { targetOrigin: e.origin });
+			}
+		}
+	}
+}
+var a = async (a, o, s, c) => {
+	let l = t(a), u = await l.getAccessToken(), d = r.toBeHex(e.polygon);
+	window.addEventListener("message", (e) => i(e, l)), n(`${s}?mchNo=${c.merchId}&name=HinkalProtocol&chainId=${d}&accessToken=${u}`, o, 700, 510);
+};
+//#endregion
+export { a as zkMeKycHandler };

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

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

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

@@ -0,0 +1,4 @@
+import { AnchorProvider, Provider } from '@coral-xyz/anchor';
+import { Keypair, PublicKey } from '@solana/web3.js';
+export declare const getAddressLookupTableAccounts: (provider: AnchorProvider, addressLookupTableAccounts: string[] | undefined) => Promise<import('@solana/web3.js').AddressLookupTableAccount[] | undefined>;
+export declare const createAndExtendAddressLookupTable: (provider: Provider, accounts: PublicKey[], payer: Keypair) => Promise<PublicKey>;

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

@@ -0,0 +1,2 @@
+import "../../constants/protocol.constants.mjs";
+import "@solana/web3.js";

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

@@ -0,0 +1 @@
+const e=require(`../../constants/chains.constants.cjs`),t=require(`../../data-structures/crypto-keys/keys.cjs`),n=require(`../utils/solanaMint.utils.cjs`),r=require(`../../webworker/worker.registry.cjs`),i=require(`../../webworker/performTaskWithWorker.cjs`),a=require(`../snarkjs/generateZkProof.cjs`),o=require(`../../webworker/zkProofWorker/zkProofWorker.types.cjs`);var s=async(s,c,l,u)=>{let d=e.isSolanaLike(s),f=u.map(e=>e.map(e=>e.amount.toString())),p=u.map(e=>e.map(e=>e.timeStamp)),m=u.map(e=>e.map(e=>e.randomization.toString())),h=u.map(e=>e.map(e=>e.getConstructableParams())),g=u.map(e=>e.map(e=>e.amount===0n?`0`:BigInt(e.getCommitment()).toString())),_=await i.performTaskWithWorker({type:r.WorkerVariant.ZKProof,payload:{type:o.ZKProofWorkerActionType.BUILD_IN_NULLIFIERS,data:{inputUtxosSerialized:h}}}),v=c.getShieldedPrivateKey(),y=d?l.map(e=>{let{compressedAddress:t}=n.formatMintAddress(e);return BigInt(t).toString()}):l.map(e=>BigInt(e).toString());u.forEach((e,n)=>{e.forEach((e,r)=>{let i=e.getStealthAddress(),a=t.UserKeys.getStealthAddress(e.randomization,v);if(BigInt(i).toString()!==BigInt(a).toString())throw Error(`Commitment validation stealth mismatch at tokenIdx=${n}, utxoIdx=${r}`)})});let b={shieldedPrivateKey:v,erc20TokenAddresses:y,inAmounts:f,inTimeStamps:p,inRandomizations:m,inCommitments:g,inNullifiers:_};if(!l.length||!u[0]?.length)return;let{zkCallData:x}=await a.generateZkProof(s,`commitmentCalculator${l.length}x${u[0].length}`,b,!1);if(!Array.isArray(x?.[0])||!Array.isArray(x?.[1])||!Array.isArray(x?.[2]))throw Error(`Invalid zkCallData shape for commitment validation`);return{tokenAddresses:y,inAmounts:f,inTimeStamps:p,inRandomizations:m,inCommitments:g,inNullifiers:_,proof:{a:x[0],b:x[1],c:x[2]}}};exports.buildCommitmentValidationData=s;

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

@@ -0,0 +1,4 @@
+import { UserKeys } from '../../data-structures/crypto-keys/keys';
+import { Utxo } from '../../data-structures/utxo/Utxo';
+import { CommitmentValidationDataType } from '../../types';
+export declare const buildCommitmentValidationData: (chainId: number, userKeys: UserKeys, erc20Addresses: string[], inputUtxosArray: Utxo[][]) => Promise<CommitmentValidationDataType | undefined>;

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

@@ -0,0 +1,53 @@
+import { isSolanaLike as e } from "../../constants/chains.constants.mjs";
+import { UserKeys as t } from "../../data-structures/crypto-keys/keys.mjs";
+import { formatMintAddress as n } from "../utils/solanaMint.utils.mjs";
+import { WorkerVariant as r } from "../../webworker/worker.registry.mjs";
+import { performTaskWithWorker as i } from "../../webworker/performTaskWithWorker.mjs";
+import { generateZkProof as a } from "../snarkjs/generateZkProof.mjs";
+import { ZKProofWorkerActionType as o } from "../../webworker/zkProofWorker/zkProofWorker.types.mjs";
+//#region libs/shared/common/src/functions/pre-transaction/buildCommitmentValidationData.ts
+var s = async (s, c, l, u) => {
+	let d = e(s), f = u.map((e) => e.map((e) => e.amount.toString())), p = u.map((e) => e.map((e) => e.timeStamp)), m = u.map((e) => e.map((e) => e.randomization.toString())), h = u.map((e) => e.map((e) => e.getConstructableParams())), g = u.map((e) => e.map((e) => e.amount === 0n ? "0" : BigInt(e.getCommitment()).toString())), _ = await i({
+		type: r.ZKProof,
+		payload: {
+			type: o.BUILD_IN_NULLIFIERS,
+			data: { inputUtxosSerialized: h }
+		}
+	}), v = c.getShieldedPrivateKey(), y = d ? l.map((e) => {
+		let { compressedAddress: t } = n(e);
+		return BigInt(t).toString();
+	}) : l.map((e) => BigInt(e).toString());
+	u.forEach((e, n) => {
+		e.forEach((e, r) => {
+			let i = e.getStealthAddress(), a = t.getStealthAddress(e.randomization, v);
+			if (BigInt(i).toString() !== BigInt(a).toString()) throw Error(`Commitment validation stealth mismatch at tokenIdx=${n}, utxoIdx=${r}`);
+		});
+	});
+	let b = {
+		shieldedPrivateKey: v,
+		erc20TokenAddresses: y,
+		inAmounts: f,
+		inTimeStamps: p,
+		inRandomizations: m,
+		inCommitments: g,
+		inNullifiers: _
+	};
+	if (!l.length || !u[0]?.length) return;
+	let { zkCallData: x } = await a(s, `commitmentCalculator${l.length}x${u[0].length}`, b, !1);
+	if (!Array.isArray(x?.[0]) || !Array.isArray(x?.[1]) || !Array.isArray(x?.[2])) throw Error("Invalid zkCallData shape for commitment validation");
+	return {
+		tokenAddresses: y,
+		inAmounts: f,
+		inTimeStamps: p,
+		inRandomizations: m,
+		inCommitments: g,
+		inNullifiers: _,
+		proof: {
+			a: x[0],
+			b: x[1],
+			c: x[2]
+		}
+	};
+};
+//#endregion
+export { s as buildCommitmentValidationData };

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

@@ -0,0 +1 @@
+require(`../../constants/chains.constants.cjs`),require(`./solana.cjs`),require(`../web3/events/getShieldedBalance.cjs`),require(`../utils/create-provider.cjs`),require(`@solana/web3.js`);

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 "./solana.mjs";
+import "../web3/events/getShieldedBalance.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 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.cjs

@@ -0,0 +1 @@
+require(`../../types/index.cjs`),require(`../utils/erc20tokenFunctions.cjs`),require(`./interaction-to-action.cjs`),require(`./process-gas-estimates.cjs`);

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.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`);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(`./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,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/index.mjs

@@ -0,0 +1,21 @@
+import "./solana.mjs";
+import "./outputUtxoProcessing.mjs";
+import "./interaction-to-action.mjs";
+import "./process-gas-estimates.mjs";
+import "./getFlatFees.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.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/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.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(`../../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;