@kapa123456789/sdk 0.0.1

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,50 @@
+import { poseidonFunction as e } from "../../crypto/poseidon.mjs";
+import { BN as t } from "@coral-xyz/anchor";
+import { PublicKey as n } from "@solana/web3.js";
+//#region libs/shared/common/src/functions/pre-transaction/solana.ts
+var r = (e) => new TextEncoder().encode(e), i = (e) => {
+	let t = [], n = e;
+	for (; n > 0n;) t.unshift(Number(n % 256n)), n /= 256n;
+	for (; t.length < 32;) t.unshift(0);
+	return t;
+}, a = (e) => ({
+	extraRandomization: i(e.extraRandomization),
+	stealthAddress: i(e.stealthAddress),
+	h0: i(e.H0),
+	h1: i(e.H1)
+}), o = (e, t) => {
+	let i = [r("hinkal"), t.toBytes()], [a] = n.findProgramAddressSync(i, e);
+	return a;
+}, s = (e, t) => {
+	let i = [r("hinkal_merkle"), t.toBytes()], [a] = n.findProgramAddressSync(i, e);
+	return a;
+}, c = (e, t) => {
+	let i = [r("hinkal_merkle_access_token"), t.toBytes()], [a] = n.findProgramAddressSync(i, e);
+	return a;
+}, l = (e, i, a) => {
+	let o = [
+		r("hinkal_swapper"),
+		i.toBytes(),
+		new Uint8Array(new t(a.toString()).toArray("be", 32))
+	], [s] = n.findProgramAddressSync(o, e);
+	return s;
+}, u = (t, n, r) => l(t, n, e(r)), d = (e, t) => {
+	let i = [r("hinkal_vault"), t.toBytes()], [a] = n.findProgramAddressSync(i, e);
+	return a;
+}, f = (e, t, a) => {
+	let o = i(e), s = [
+		r("hinkal_access_keys"),
+		a.toBytes(),
+		new Uint8Array(o)
+	], [c] = n.findProgramAddressSync(s, t);
+	return c;
+}, p = (e, t, i) => {
+	let a = [
+		r("hinkal_token_limit"),
+		t.toBytes(),
+		i.toBytes()
+	], [o] = n.findProgramAddressSync(a, e);
+	return o;
+};
+//#endregion
+export { a as buildAnchorStealthAddressStructure, i as encodeToByte32Array, f as getAccessTokenAccountPublicKey, c as getAccessTokenMerkleAccountPublicKey, s as getMerkleAccountPublicKey, o as getStorageAccountPublicKey, d as getStorageVaultPublicKey, l as getSwapperAccountPublicKey, u as getSwapperAccountPublicKeyFromSalt, p as getTokenLimitStorageAccountPublicKey };

package/common/src/functions/pre-transaction/solanaTransfer.utils.cjs

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`),require(`../../constants/protocol.constants.cjs`);let e=require(`@solana/web3.js`),t=require(`@solana/spl-token`);var n=async(n,r,i,a,o)=>{let{erc20TokenAddress:s,is2022Program:c,decimals:l}=a,u=[];if(s===`11111111111111111111111111111111`)return u.push(e.SystemProgram.transfer({fromPubkey:r,toPubkey:i,lamports:Number(o)})),{instructions:u,programId:e.SystemProgram.programId};let d=c?t.TOKEN_2022_PROGRAM_ID:t.TOKEN_PROGRAM_ID,f=new e.PublicKey(s),p=await(0,t.getAssociatedTokenAddress)(f,r,!0,d),m=await(0,t.getAssociatedTokenAddress)(f,i,!0,d);return await n.getAccountInfo(m)||u.push((0,t.createAssociatedTokenAccountInstruction)(r,m,i,f,d)),c?u.push((0,t.createTransferCheckedInstruction)(p,f,m,r,o,l,[],d)):u.push((0,t.createTransferInstruction)(p,m,r,o,[],d)),{instructions:u,programId:d}};exports.buildSolanaTransferInstructions=n;

package/common/src/functions/pre-transaction/solanaTransfer.utils.d.ts

@@ -0,0 +1,6 @@
+import { Connection, PublicKey, TransactionInstruction } from '@solana/web3.js';
+import { ERC20Token } from '../../types/token.types';
+export declare const buildSolanaTransferInstructions: (connection: Connection, fromPubkey: PublicKey, toPubkey: PublicKey, token: ERC20Token, amount: bigint) => Promise<{
+    instructions: TransactionInstruction[];
+    programId: PublicKey;
+}>;

package/common/src/functions/pre-transaction/solanaTransfer.utils.mjs

@@ -0,0 +1,22 @@
+import "../../constants/protocol.constants.mjs";
+import { PublicKey as e, SystemProgram as t } from "@solana/web3.js";
+import { TOKEN_2022_PROGRAM_ID as n, TOKEN_PROGRAM_ID as r, createAssociatedTokenAccountInstruction as i, createTransferCheckedInstruction as a, createTransferInstruction as o, getAssociatedTokenAddress as s } from "@solana/spl-token";
+//#region libs/shared/common/src/functions/pre-transaction/solanaTransfer.utils.ts
+var c = async (c, l, u, d, f) => {
+	let { erc20TokenAddress: p, is2022Program: m, decimals: h } = d, g = [];
+	if (p === "11111111111111111111111111111111") return g.push(t.transfer({
+		fromPubkey: l,
+		toPubkey: u,
+		lamports: Number(f)
+	})), {
+		instructions: g,
+		programId: t.programId
+	};
+	let _ = m ? n : r, v = new e(p), y = await s(v, l, !0, _), b = await s(v, u, !0, _);
+	return await c.getAccountInfo(b) || g.push(i(l, b, u, v, _)), m ? g.push(a(y, v, b, l, f, h, [], _)) : g.push(o(y, b, l, f, [], _)), {
+		instructions: g,
+		programId: _
+	};
+};
+//#endregion
+export { c as buildSolanaTransferInstructions };

package/common/src/functions/pre-transaction/store-instructions.cjs

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

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

@@ -0,0 +1,4 @@
+import { Program } from '@coral-xyz/anchor';
+import { HinkalInstruction } from './convert-okx-instructions';
+import { Connection, Keypair, PublicKey } from '@solana/web3.js';
+export declare const storeInstructions: (connection: Connection, hinkalProgram: Program, signer: Keypair, originalDeployer: PublicKey, id: bigint, instructions: HinkalInstruction[]) => Promise<PublicKey>;

package/common/src/functions/pre-transaction/store-instructions.mjs

@@ -0,0 +1,2 @@
+import "./solana.mjs";
+import "./sendV0Transaction.mjs";

package/common/src/functions/pre-transaction/store-proof.cjs

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

package/common/src/functions/pre-transaction/store-proof.d.ts

@@ -0,0 +1,7 @@
+import { Program } from '@coral-xyz/anchor';
+import { Connection, Keypair, PublicKey } from '@solana/web3.js';
+export declare const storeProof: (connection: Connection, hinkalProgram: Program, signer: Keypair, originalDeployer: PublicKey, id: bigint, encryptedOutputs: number[][], proofAArr: number[], proofBArr: number[], proofCArr: number[], publicInputsArr: number[][]) => Promise<{
+    proofAccountPart1: PublicKey;
+    proofAccountPart2: PublicKey;
+    encryptedOutputsAccount: PublicKey;
+}>;

package/common/src/functions/pre-transaction/store-proof.mjs

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

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

@@ -0,0 +1 @@
+const e=require(`../utils/time.utils.cjs`);var t=60,n=(e,t)=>{if(!e.length)return!0;let n=new Set(t.map(e=>e.toString()));return e.every(({utxo:e})=>{let t=BigInt(e.getCommitment());return n.has(t.toString())})},r=(e,t,n=20)=>{let r=e.merkleTreeHinkalByChain[t],i=r.getStartIndex(),{count:a}=r.toJSON(),o=BigInt(a);if(o===0n)return[];let s=r.getMerkleData(),c=[],l=o<BigInt(n)?o:BigInt(n);for(let e=0n;e<l;e+=1n){let t=i+o-1n-e,n=s.get(t);n&&n!==0n&&c.push(n)}return c},i=async(i,a,o)=>{if(o.length){for(let s=0;s<t;s+=1){if(n(o,r(i,a)))return;await e.waitLittle()}throw Error(`Timeout while waiting for deposited UTXOs to appear in Merkle tree.`)}};exports.waitForDepositedUtxosInMerkleTree=i;

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

@@ -0,0 +1,3 @@
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+import { RecipientUtxo } from '../../types';
+export declare const waitForDepositedUtxosInMerkleTree: (hinkal: IHinkal, chainId: number, userDepositedUtxos: RecipientUtxo[]) => Promise<void>;

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

@@ -0,0 +1,29 @@
+import { waitLittle as e } from "../utils/time.utils.mjs";
+//#region libs/shared/common/src/functions/pre-transaction/waitForDepositedUtxosInMerkleTree.ts
+var t = 60, n = (e, t) => {
+	if (!e.length) return !0;
+	let n = new Set(t.map((e) => e.toString()));
+	return e.every(({ utxo: e }) => {
+		let t = BigInt(e.getCommitment());
+		return n.has(t.toString());
+	});
+}, r = (e, t, n = 20) => {
+	let r = e.merkleTreeHinkalByChain[t], i = r.getStartIndex(), { count: a } = r.toJSON(), o = BigInt(a);
+	if (o === 0n) return [];
+	let s = r.getMerkleData(), c = [], l = o < BigInt(n) ? o : BigInt(n);
+	for (let e = 0n; e < l; e += 1n) {
+		let t = i + o - 1n - e, n = s.get(t);
+		n && n !== 0n && c.push(n);
+	}
+	return c;
+}, i = async (i, a, o) => {
+	if (o.length) {
+		for (let s = 0; s < t; s += 1) {
+			if (n(o, r(i, a))) return;
+			await e();
+		}
+		throw Error("Timeout while waiting for deposited UTXOs to appear in Merkle tree.");
+	}
+};
+//#endregion
+export { i as waitForDepositedUtxosInMerkleTree };

package/common/src/functions/private-wallet/emporium.helpers.cjs

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../constants/chains.constants.cjs`),t=require(`../../constants/protocol.constants.cjs`),n=require(`../../types/ethereum-network.types.cjs`),r=require(`../utils/caseInsensitive.utils.cjs`),i=require(`../utils/getContractAddress.cjs`),a=require(`../../error-handling/logger.cjs`),o=require(`../utils/create-provider.cjs`),s=require(`../../data-structures/AccountActions/AccountActions.cjs`);require(`../utils/index.cjs`);let c=require(`ethers`);var l=({contract:e,func:t,args:n,callDataString:r,invokeWallet:a,value:o})=>{let s=new Uint8Array,l=r?c.ethers.getBytesCopy(r):new Uint8Array;if(typeof e==`object`){if(s=c.ethers.getBytesCopy(i.getContractAddress(e)),r?.length&&r?.length>0)throw Error(`If function and args are providedm no calldata is needed`);t&&n&&!r&&(l=c.ethers.getBytesCopy(e.interface.encodeFunctionData(t,n)))}else s=c.ethers.getBytesCopy(e);let u=c.ethers.getBytesCopy(new Uint8Array([+!!a])),d=c.ethers.zeroPadValue(c.ethers.toBeHex(o??0n),16),f=c.ethers.concat([s,u,d,l]);return c.ethers.hexlify(f)},u=async(e,n,r,i,a,o)=>{let l=r?await s.AccountActions.signTypedDataFromPrivateKey(e,r,{name:`Emporium`,version:`1.0.0`,chainId:e,verifyingContract:n},{EmporiumSignature:[{name:`message`,type:`uint256`}]},{message:a}):void 0,{v:u,r:d,s:f}=l?c.ethers.Signature.from(l):{v:0,r:c.ethers.ZeroHash,s:c.ethers.ZeroHash};return c.ethers.AbiCoder.defaultAbiCoder().encode([`tuple(uint8 v,bytes32 r, bytes32 s, uint256 message, address signerAddress, bytes[] ops)`],[{v:u,r:d,s:f,message:a??0n,signerAddress:o??t.zeroAddress,ops:i}])},d=(e,t,n,r)=>l(e?{contract:e,func:`transfer`,args:[t,n],invokeWallet:r}:{contract:t,value:n,invokeWallet:r}),f=(e,a,o,s,c)=>{let l=e.getContractWithFetcher(a,n.ContractType.HinkalContract);return o.map((o,u)=>d(r.caseInsensitiveEqual(o,t.zeroAddress)?void 0:e.getContractWithFetcher(a,n.ContractType.ERC20Contract,o),c??i.getContractAddress(l),s[u],!0))},p=(e,t,n,r)=>l({contract:e,func:`approve`,args:[t,n],invokeWallet:r}),m=(e,i,a,o,s,c,l,u)=>{let f=[];for(let s=0;s<a.length;s+=1){let c=a[s],u=r.caseInsensitiveEqual(c,t.zeroAddress)?void 0:e.getContractWithFetcher(i,n.ContractType.ERC20Contract,c);f.push(d(u,l,o[s],!1))}if(u)for(let a=0;a<s.length;a+=1){let o=s[a];if(!r.caseInsensitiveEqual(o,t.zeroAddress)){let t=e.getContractWithFetcher(i,n.ContractType.ERC20Contract,o);f.push(p(t,u,c[a],!0))}}return f},h=(e,n,i,a,o,s,c,u)=>{let d=[],f=[o],p=[s];u.nativeFee>0n&&!r.caseInsensitiveEqual(o,t.zeroAddress)&&(f.push(t.zeroAddress),p.push(u.nativeFee));let h=m(e,n,f,p,[o],[c],i,a);d.push(...h);let g=u.nativeFee;return r.caseInsensitiveEqual(o,t.zeroAddress)&&(g+=c),d.push(l({contract:a,callDataString:u.calldata,value:g>0n?g:void 0,invokeWallet:!0})),d},g=`0xef0100`,_=async(e,t)=>{try{let n=o.createJsonRpcProvider(e),r=await n.getCode(t);if(r===`0x`||!r)return{delegated:!1,implementation:void 0,nonce:void 0};if(r.toLowerCase().startsWith(g)&&r.length===48){let e=`0x${r.slice(8)}`,i=await n.getTransactionCount(t);return{delegated:!0,implementation:c.ethers.getAddress(e),nonce:i}}else throw Error(`checkEOAWithDelegation: It is a contract`)}catch(e){throw a.Logger.error(`checkEOAWithDelegation error`,{error:e}),e}},v=n=>{let{hinkalWalletAddress:i}=e.networkRegistry[n].contractData;if(!i||r.caseInsensitiveEqual(i,t.zeroAddress))throw Error(`Hinkal Wallet Address is not set`);return i},y=async(t,n)=>{if(t===e.chainIds.localhost||!n)return;let{delegated:i,implementation:a}=await _(t,s.AccountActions.getSignerAddressFromPrivateKey(t,n)),o=v(t);if(!i||!r.caseInsensitiveEqual(a,o)){let e=await s.AccountActions.authorizeDelegation(t,n,o);return{v:e.signature.v.toString(),r:e.signature.r,s:e.signature.s,nonce:e.nonce.toString(),address:o,chainId:String(t)}}};exports.checkEOAWithDelegation=_,exports.createApproveEmporiumOp=p,exports.createLifiBridgeOps=h,exports.createTransaferEmporiumOpsBatch=f,exports.createTransferToEmporiumOp=d,exports.emporiumOp=l,exports.encodeEmporiumMetadata=u,exports.generateFundAndApproveOps=m,exports.getAuthorizationDataIfNeeded=y;

package/common/src/functions/private-wallet/emporium.helpers.d.ts

@@ -0,0 +1,37 @@
+import { ethers } from 'ethers';
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+import { AuthorizationData } from '../../types/hinkal.types';
+import { BridgeQuote } from '../../types/bridging-tx.types';
+export declare const emporiumOp: ({ contract, func, args, callDataString, invokeWallet, value, }: {
+    contract: ethers.BaseContract | string;
+    func?: string;
+    args?: unknown[];
+    callDataString?: string;
+    invokeWallet?: boolean;
+    value?: bigint;
+}) => string;
+export declare const encodeEmporiumMetadata: (chainId: number, emporiumAddress: string, privateKey: string | undefined, ops: string[], message?: bigint, signerAddress?: string) => Promise<string>;
+export declare const decodeEmporiumMetadata: (metadata: string) => {
+    v: number;
+    r: string;
+    s: string;
+    message: bigint;
+    signerAddress: string;
+    ops: string[];
+};
+export declare const createTransferToEmporiumOp: (tokenContract: ethers.Contract | undefined, to: string, amount: bigint, invokeWallet: boolean) => string;
+export declare const createTransaferEmporiumOpsBatch: (hinkal: IHinkal, chainId: number, erc20TokenAddresses: string[], amounts: bigint[], to?: string) => string[];
+export declare const createApproveEmporiumOp: (tokenContract: ethers.Contract, to: string, amount: bigint, invokeWallet: boolean) => string;
+export declare const generateFundAndApproveOps: (hinkal: IHinkal, chainId: number, erc20AddressesToFund: string[], fundAmounts: bigint[], approveTokenAddresses: string[], approveAmounts: bigint[], walletAddress: string, spenderAddress: string | undefined) => string[];
+export declare const createLifiBridgeOps: (hinkal: IHinkal, chainId: number, fromAddress: string, lifiRouterAddress: string, tokenAddress: string, fundAmount: bigint, bridgeAmount: bigint, quote: BridgeQuote) => string[];
+export declare const checkEOAWithDelegation: (chainId: number, eoaAddress: string) => Promise<{
+    delegated: boolean;
+    implementation: undefined;
+    nonce: undefined;
+} | {
+    delegated: boolean;
+    implementation: string;
+    nonce: number;
+}>;
+export declare const getAuthorizationDataIfNeeded: (chainId: number, privateKey: string | undefined) => Promise<AuthorizationData | undefined>;
+export declare const recoverAuthorizationData: (authorizationData: AuthorizationData | undefined) => ethers.Authorization | undefined;