@gurge/sdk 0.3.142 → 0.3.151

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

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

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

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

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

@@ -6,11 +6,11 @@ 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;
+	let m = 0n, h = p < 0n ? p : 0n, g = await a(s, f.feeToken, c) + h;
 	m = g < 0 ? f.flatFee : t(f.flatFee - g, 0n), m !== 0n && (await i(s, u, d, {
 		...f,
 		flatFee: m
-	}), l.push(r(f.feeToken === e ? void 0 : o.getContractWithFetcher(s, n.ERC20Contract, f.feeToken), c, m, !1)));
+	}), l.push(r(f.feeToken === e ? void 0 : o.getContractWithFetcherByChainId(s, n.ERC20Contract, f.feeToken), c, m, !1)));
 };
 //#endregion
 export { o as mergeWithFeeStructureEmporium };

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

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

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

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

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

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

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

@@ -1,33 +1,34 @@
 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";
+import { getCurrentTimeInSeconds as r } from "../utils/time.utils.mjs";
+import { Utxo as i } from "../../data-structures/utxo/Utxo.mjs";
 //#region libs/shared/common/src/functions/pre-transaction/outputUtxoProcessing.ts
-var i = (i, a, o, s, c = !0, l, u) => {
+var a = (r, a, o, s, c = !0, l, u) => {
 	let d = t(a), { erc20TokenAddress: f, mintAddress: p } = a[0];
 	if (c && o < 0n && d + o < 0n) throw Error(n.INSUFFICIENT_FUNDS_TO_TRANSACT);
-	let m = [new r({
+	let m = [new i({
 		amount: e(d + o, 0n),
 		erc20TokenAddress: f,
 		mintAddress: p,
-		nullifyingKey: i.getShieldedPrivateKey(),
+		nullifyingKey: r.getShieldedPrivateKey(),
 		timeStamp: s,
-		spendingPublicKey: i.getSpendingKeyPair().pubSpendingBJJPoint,
-		isNewStyle: !0
+		spendingPublicKey: r.getSpendingKeyPair().pubSpendingBJJPoint
 	})];
-	if (l !== void 0 && u !== void 0) {
-		let [e, t, n, , i] = l.split(",");
-		m.push(new r({
-			amount: u,
+	return l !== void 0 && u !== void 0 && l.forEach((e, t) => {
+		let [n, r, a, , , o] = e.split(",");
+		m.push(new i({
+			amount: u[t],
 			erc20TokenAddress: f,
 			mintAddress: p,
-			H0: [BigInt(t), BigInt(n)],
-			stealthAddress: e,
-			encryptionKey: i,
-			timeStamp: s,
-			isNewStyle: !0
+			H0: [BigInt(r), BigInt(a)],
+			stealthAddress: n,
+			encryptionKey: o,
+			timeStamp: s
 		}));
-	}
-	return { outputUtxos: m };
+	}), { outputUtxos: m };
+}, o = (e, t, n, i, o) => {
+	let s = r().toString();
+	return t.map((t, r) => a(e, t, n[r], s, !0, i, i === void 0 ? void 0 : o?.map((e) => e[r] ?? 0n)).outputUtxos);
 };
 //#endregion
-export { i as outputUtxoProcessing };
+export { o as buildOutputUtxos, a as outputUtxoProcessing };

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/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

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

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

@@ -0,0 +1,21 @@
+import { AddressLookupTableAccount, Connection, Finality, Keypair, PublicKey, TransactionInstruction, VersionedTransaction, VersionedTransactionResponse } from '@solana/web3.js';
+import { SubAccount } from '../../types/proxy.types';
+export declare const fetchSolanaTransaction: (connection: Connection, signature: string, finality?: Finality) => Promise<VersionedTransactionResponse | null>;
+export declare const estimateComputeUnitLimit: (connection: Connection, payerKey: PublicKey, instructions: TransactionInstruction[], lookupTableAccounts?: AddressLookupTableAccount[], requestHeapFrame?: boolean) => Promise<number>;
+export declare const getAccountsFromInstructions: (instructions: TransactionInstruction[], payerKey?: PublicKey, additionalAccounts?: PublicKey[], lookupTableAccounts?: AddressLookupTableAccount[]) => PublicKey[];
+export declare const handleSolanaTransactionError: (transactionResponse: VersionedTransactionResponse | null, signature?: string) => void;
+export declare const sendV0Transaction: (connection: Connection, instructions: TransactionInstruction[], payer: Keypair, signers: Keypair[], lookupTableAccounts?: AddressLookupTableAccount[], requestHeapFrame?: boolean) => Promise<string>;
+export declare const sendSignedV0Transaction: (connection: Connection, transaction: VersionedTransaction) => 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 buildProxyV0Transaction: (connection: Connection, signerPublicKey: PublicKey, instructions: TransactionInstruction[], lookupTableAccounts?: AddressLookupTableAccount[], feePayerPublicKey?: PublicKey) => Promise<VersionedTransaction>;
+export declare const serializeProxyV0Transaction: (connection: Connection, signerPublicKey: PublicKey, instructions: TransactionInstruction[], lookupTableAccounts?: AddressLookupTableAccount[], feePayerPublicKey?: PublicKey) => Promise<string>;
+export {};

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

@@ -3,7 +3,7 @@ import { COMPUTE_UNIT_PADDING_PERCENTAGE as t, MAX_COMPUTE_UNIT_LIMIT as n, MAX_
 import { Logger as a } from "../../error-handling/logger.mjs";
 import { AccountActions as o } from "../../data-structures/AccountActions/AccountActions.mjs";
 import { SolanaPriorityFeeMode as s } from "../../types/fee.types.mjs";
-import { getSolanaPriorityFee as c } from "../web3/getSolanaPriorityFee.mjs";
+import { getSolanaPriorityFeeFromServer as c } from "../../API/solana-priority-fee.mjs";
 import { pollForValue as l } from "../utils/process.utils.mjs";
 import { shouldRetryForSolanaError as u } from "../../error-handling/retrySolanaError.mjs";
 import { ComputeBudgetProgram as d, PublicKey as f, TransactionMessage as p, VersionedTransaction as m } from "@solana/web3.js";
@@ -65,10 +65,10 @@ var h = 5e3, g = 6e4, _ = async (e, t, n = "confirmed") => await l(() => e.getTr
 	}
 }, x = async (e, t, i, a, o, s = !1) => {
 	if (i.some((e) => e.programId.equals(d.programId))) return i.map((e) => e.programId.equals(d.programId) && e.data[0] === 2 ? d.setComputeUnitLimit({ units: n }) : e);
-	let l = i.filter((e) => !e.programId.equals(d.programId)), u = await v(e, t, l, a, s), f = d.setComputeUnitLimit({ units: u }), p = e.rpcEndpoint.includes("helius") ? await c(y(l, t, [d.programId], a), o) : 0;
+	let l = i.filter((e) => !e.programId.equals(d.programId)), u = await v(e, t, l, a, s), f = d.setComputeUnitLimit({ units: u }), p = await c(y(l, t, [d.programId], a), o);
 	return [
 		f,
-		d.setComputeUnitPrice({ microLamports: p }),
+		...p > 0 ? [d.setComputeUnitPrice({ microLamports: p })] : [],
 		...s ? [d.requestHeapFrame({ bytes: r })] : [],
 		...l
 	];
@@ -96,4 +96,4 @@ var h = 5e3, g = 6e4, _ = async (e, t, n = "confirmed") => await l(() => e.getTr
 	throw Error("Failed to send proxy v0 transaction due to expired blockheight after all retries");
 };
 //#endregion
-export { v as estimateComputeUnitLimit, _ as fetchSolanaTransaction, y as getAccountsFromInstructions, S as sendProxyV0Transaction };
+export { v as estimateComputeUnitLimit, _ as fetchSolanaTransaction, y as getAccountsFromInstructions, b as handleSolanaTransactionError, S as sendProxyV0Transaction };

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

@@ -0,0 +1,22 @@
+export declare const convertSolanaPublicSignals: (publicInputsArr: number[][], dimensions: {
+    tokenNumber: number;
+    nullifierAmount: number;
+    outputAmount: number;
+}) => {
+    outH1Ax: number[];
+    outH1Ay: number[];
+    outStealthAddress: number[];
+    message: number[];
+    swapperAccountAdditionalSeed: number[];
+    rootHash: number[];
+    signedMessageHash: number[];
+    mintAccountPart1: number[][];
+    mintAccountPart2: number[][];
+    amountChanges: number[][];
+    inNullifiers: number[][][];
+    outTimestamp: number[];
+    outCommitments: number[][][];
+    calldataHash: number[];
+    h0Ax: number[];
+    h0Ay: number[];
+};

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

@@ -1 +1 @@
-require(`../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../crypto/poseidon.cjs`);let t=require(`@solana/web3.js`),n=require(`@coral-xyz/anchor`);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,n)=>{let i=[r(`hinkal`),n.toBytes()],[a]=t.PublicKey.findProgramAddressSync(i,e);return a},s=(e,n)=>{let i=[r(`hinkal_merkle`),n.toBytes()],[a]=t.PublicKey.findProgramAddressSync(i,e);return a},c=(e,i,a)=>{let o=[r(`hinkal_swapper`),i.toBytes(),new Uint8Array(new n.BN(a.toString()).toArray(`be`,32))],[s]=t.PublicKey.findProgramAddressSync(o,e);return s},l=(t,n,r)=>c(t,n,e.poseidonFunction(r)),u=(e,n)=>{let i=[r(`hinkal_vault`),n.toBytes()],[a]=t.PublicKey.findProgramAddressSync(i,e);return a};exports.buildAnchorStealthAddressStructure=a,exports.encodeToByte32Array=i,exports.getMerkleAccountPublicKey=s,exports.getStorageAccountPublicKey=o,exports.getStorageVaultPublicKey=u,exports.getSwapperAccountPublicKey=c,exports.getSwapperAccountPublicKeyFromSalt=l;
+require(`../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../constants/protocol.constants.cjs`),t=require(`../../crypto/poseidon.cjs`);let n=require(`@solana/web3.js`),r=require(`@coral-xyz/anchor`);var i=e=>new TextEncoder().encode(e),a=e=>{let t=[],n=e;for(;n>0n;)t.unshift(Number(n%256n)),n/=256n;for(;t.length<32;)t.unshift(0);return t},o=e=>({h0X:a(e.H0x),h0Y:a(e.H0y),h1X:a(e.H1x),h1Y:a(e.H1y),stealthAddress:a(e.stealthAddress)}),s=(e,t,r)=>{let o=a(e),s=[i(`hinkal_nullifier`),t.toBytes(),new Uint8Array(o)],[c]=n.PublicKey.findProgramAddressSync(s,r);return c},c=(e,t)=>{let r=[i(`hinkal`),t.toBytes()],[a]=n.PublicKey.findProgramAddressSync(r,e);return a},l=(e,t)=>{let r=[i(`hinkal_merkle`),t.toBytes()],[a]=n.PublicKey.findProgramAddressSync(r,e);return a},u=327680n,d=e=>2n**(e-1n),f=e=>e/u,p=e=>e%u,m=(e,t,a)=>{let o=[i(`hinkal_root_bucket`),t.toBytes(),new Uint8Array(new r.BN(a.toString()).toArray(`le`,8))],[s]=n.PublicKey.findProgramAddressSync(o,e);return s},h=async(e,t)=>{let n=await e.account.merkle.fetch(t);return BigInt(`0x${Buffer.from(n.mIndex).toString(`hex`)}`)},g=async(t,n,r)=>{let i=await h(t,n)-d(e.MERKLE_LEVELS),a=f(i);return{current:m(t.programId,n,a),next:i%327680n+BigInt(r)>327680n?m(t.programId,n,a+1n):null}},_=(e,t,a)=>{let o=[i(`hinkal_swapper`),t.toBytes(),new Uint8Array(new r.BN(a.toString()).toArray(`be`,32))],[s]=n.PublicKey.findProgramAddressSync(o,e);return s},v=(e,n,r)=>_(e,n,t.poseidonFunction(r)),y=(e,t)=>{let r=[i(`hinkal_vault`),t.toBytes()],[a]=n.PublicKey.findProgramAddressSync(r,e);return a};exports.ROOT_BUCKET_CAP=u,exports.buildAnchorStealthAddressStructure=o,exports.encodeToByte32Array=a,exports.fetchSolanaMIndex=h,exports.getMerkleAccountPublicKey=l,exports.getMerkleMinimumIndex=d,exports.getNullifierAccount=s,exports.getRootBucketIndex=f,exports.getRootBucketPublicKey=m,exports.getRootBucketSlot=p,exports.getStorageAccountPublicKey=c,exports.getStorageVaultPublicKey=y,exports.getSwapperAccountPublicKey=_,exports.getSwapperAccountPublicKeyFromSalt=v,exports.resolveSolanaRootBuckets=g;

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

@@ -0,0 +1,27 @@
+import { Idl, Program } from '@coral-xyz/anchor';
+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 ROOT_BUCKET_CAP = 327680n;
+export declare const getMerkleMinimumIndex: (levels: bigint) => bigint;
+export declare const getRootBucketIndex: (relativeIndex: bigint) => bigint;
+export declare const getRootBucketSlot: (relativeIndex: bigint) => bigint;
+export declare const getRootBucketIndexFromAbsolute: (absoluteIndex: bigint, levels: bigint) => bigint;
+export declare const getRootBucketPublicKey: (programId: PublicKey, merkleAccount: PublicKey, bucketIndex: bigint) => PublicKey;
+export declare const fetchSolanaMIndex: (program: Program<Idl>, merkleAccount: PublicKey) => Promise<bigint>;
+export declare const resolveSolanaRootBuckets: (program: Program<Idl>, merkleAccount: PublicKey, insertCount: number) => Promise<{
+    current: PublicKey;
+    next: PublicKey | null;
+}>;
+export declare const resolveSolanaVerifyBucket: (programId: PublicKey, merkleAccount: PublicKey, rootIndexAbsolute: bigint) => 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 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 getInstructionsAccountPublicKey: (programId: PublicKey, originalDeployer: PublicKey, signer: PublicKey, id: bigint) => PublicKey;

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

@@ -1,33 +1,58 @@
-import { poseidonFunction as e } from "../../crypto/poseidon.mjs";
-import { PublicKey as t } from "@solana/web3.js";
-import { BN as n } from "@coral-xyz/anchor";
+import { MERKLE_LEVELS as e } from "../../constants/protocol.constants.mjs";
+import { poseidonFunction as t } from "../../crypto/poseidon.mjs";
+import { PublicKey as n } from "@solana/web3.js";
+import { BN as r } from "@coral-xyz/anchor";
 //#region libs/shared/common/src/functions/pre-transaction/solana.ts
-var r = (e) => new TextEncoder().encode(e), i = (e) => {
+var i = (e) => new TextEncoder().encode(e), a = (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, n) => {
-	let i = [r("hinkal"), n.toBytes()], [a] = t.findProgramAddressSync(i, e);
+}, o = (e) => ({
+	h0X: a(e.H0x),
+	h0Y: a(e.H0y),
+	h1X: a(e.H1x),
+	h1Y: a(e.H1y),
+	stealthAddress: a(e.stealthAddress)
+}), s = (e, t, r) => {
+	let o = a(e), s = [
+		i("hinkal_nullifier"),
+		t.toBytes(),
+		new Uint8Array(o)
+	], [c] = n.findProgramAddressSync(s, r);
+	return c;
+}, c = (e, t) => {
+	let r = [i("hinkal"), t.toBytes()], [a] = n.findProgramAddressSync(r, e);
 	return a;
-}, s = (e, n) => {
-	let i = [r("hinkal_merkle"), n.toBytes()], [a] = t.findProgramAddressSync(i, e);
+}, l = (e, t) => {
+	let r = [i("hinkal_merkle"), t.toBytes()], [a] = n.findProgramAddressSync(r, e);
 	return a;
-}, c = (e, i, a) => {
+}, u = 327680n, d = (e) => 2n ** (e - 1n), f = (e) => e / u, p = (e) => e % u, m = (e, t, a) => {
 	let o = [
-		r("hinkal_swapper"),
-		i.toBytes(),
-		new Uint8Array(new n(a.toString()).toArray("be", 32))
-	], [s] = t.findProgramAddressSync(o, e);
+		i("hinkal_root_bucket"),
+		t.toBytes(),
+		new Uint8Array(new r(a.toString()).toArray("le", 8))
+	], [s] = n.findProgramAddressSync(o, e);
 	return s;
-}, l = (t, n, r) => c(t, n, e(r)), u = (e, n) => {
-	let i = [r("hinkal_vault"), n.toBytes()], [a] = t.findProgramAddressSync(i, e);
+}, h = async (e, t) => {
+	let n = await e.account.merkle.fetch(t);
+	return BigInt(`0x${Buffer.from(n.mIndex).toString("hex")}`);
+}, g = async (t, n, r) => {
+	let i = await h(t, n) - d(e), a = f(i);
+	return {
+		current: m(t.programId, n, a),
+		next: i % 327680n + BigInt(r) > 327680n ? m(t.programId, n, a + 1n) : null
+	};
+}, _ = (e, t, a) => {
+	let o = [
+		i("hinkal_swapper"),
+		t.toBytes(),
+		new Uint8Array(new r(a.toString()).toArray("be", 32))
+	], [s] = n.findProgramAddressSync(o, e);
+	return s;
+}, v = (e, n, r) => _(e, n, t(r)), y = (e, t) => {
+	let r = [i("hinkal_vault"), t.toBytes()], [a] = n.findProgramAddressSync(r, e);
 	return a;
 };
 //#endregion
-export { a as buildAnchorStealthAddressStructure, i as encodeToByte32Array, s as getMerkleAccountPublicKey, o as getStorageAccountPublicKey, u as getStorageVaultPublicKey, c as getSwapperAccountPublicKey, l as getSwapperAccountPublicKeyFromSalt };
+export { u as ROOT_BUCKET_CAP, o as buildAnchorStealthAddressStructure, a as encodeToByte32Array, h as fetchSolanaMIndex, l as getMerkleAccountPublicKey, d as getMerkleMinimumIndex, s as getNullifierAccount, f as getRootBucketIndex, m as getRootBucketPublicKey, p as getRootBucketSlot, c as getStorageAccountPublicKey, y as getStorageVaultPublicKey, _ as getSwapperAccountPublicKey, v as getSwapperAccountPublicKeyFromSalt, g as resolveSolanaRootBuckets };

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

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

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

@@ -1,22 +1,23 @@
 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";
+import { getSolanaTokenProgramId as e } from "../utils/solanaMint.utils.mjs";
+import { PublicKey as t, SystemProgram as n } from "@solana/web3.js";
+import { createAssociatedTokenAccountInstruction as r, createTransferCheckedInstruction as i, createTransferInstruction as a, getAssociatedTokenAddress as o } 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)
+var s = async (s, c, l, u, d) => {
+	let { erc20TokenAddress: f, is2022Program: p, decimals: m } = u, h = [];
+	if (f === "11111111111111111111111111111111") return h.push(n.transfer({
+		fromPubkey: c,
+		toPubkey: l,
+		lamports: Number(d)
 	})), {
-		instructions: g,
-		programId: t.programId
+		instructions: h,
+		programId: n.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: _
+	let g = e(p), _ = new t(f), v = await o(_, c, !0, g), y = await o(_, l, !0, g);
+	return await s.getAccountInfo(y) || h.push(r(c, y, l, _, g)), p ? h.push(i(v, _, y, c, d, m, [], g)) : h.push(a(v, y, c, d, [], g)), {
+		instructions: h,
+		programId: g
 	};
 };
 //#endregion
-export { c as buildSolanaTransferInstructions };
+export { s as buildSolanaTransferInstructions };

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

@@ -0,0 +1 @@
+var e=e=>({amount:e.amount.toString(),erc20TokenAddress:e.erc20TokenAddress,mintAddress:e.mintAddress??``,timeStamp:e.timeStamp,stealthAddress:BigInt(e.getStealthAddress()).toString(),isBlocked:e.isBlocked,H0:[(e.H0?.[0]??0n).toString(),(e.H0?.[1]??0n).toString()]}),t=(e,t,n)=>{let r=n.map(BigInt),i=r.filter(t=>e.contains(t)).length;if(i>0&&i!==r.length)throw Error(`Only some pending leaves are already in the Merkle tree`);let a=e;return i!==r.length&&(a=e.clone(),r.forEach(e=>a.insert(e,a.getIndex()))),t.flat().forEach(e=>{if(e.amount>0n&&!a.contains(BigInt(e.getCommitment())))throw Error(`Input commitment ${e.getCommitment()} is not in the speculative Merkle tree`)}),a};exports.speculativeMerkleTree=t,exports.toSpeculativeUtxo=e;

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

@@ -0,0 +1,9 @@
+import { MerkleTree } from '../../data-structures/merkle-tree';
+import { Utxo } from '../../data-structures/utxo/Utxo';
+import { SpeculativeUtxo } from '../../types/remote-tx-build.types';
+export declare const toSpeculativeUtxo: (utxo: Utxo) => SpeculativeUtxo;
+/**
+ * The tree to prove against while the deposit that creates `pendingLeaves` is still in flight:
+ * the live tree with those leaves appended, or the live tree itself once the indexer caught up.
+ */
+export declare const speculativeMerkleTree: (merkleTree: MerkleTree<bigint>, inputUtxosArray: Utxo[][], pendingCommitments: string[]) => MerkleTree<bigint>;

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

@@ -0,0 +1,19 @@
+//#region libs/shared/common/src/functions/pre-transaction/speculativeUtxo.ts
+var e = (e) => ({
+	amount: e.amount.toString(),
+	erc20TokenAddress: e.erc20TokenAddress,
+	mintAddress: e.mintAddress ?? "",
+	timeStamp: e.timeStamp,
+	stealthAddress: BigInt(e.getStealthAddress()).toString(),
+	isBlocked: e.isBlocked,
+	H0: [(e.H0?.[0] ?? 0n).toString(), (e.H0?.[1] ?? 0n).toString()]
+}), t = (e, t, n) => {
+	let r = n.map(BigInt), i = r.filter((t) => e.contains(t)).length;
+	if (i > 0 && i !== r.length) throw Error("Only some pending leaves are already in the Merkle tree");
+	let a = e;
+	return i !== r.length && (a = e.clone(), r.forEach((e) => a.insert(e, a.getIndex()))), t.flat().forEach((e) => {
+		if (e.amount > 0n && !a.contains(BigInt(e.getCommitment()))) throw Error(`Input commitment ${e.getCommitment()} is not in the speculative Merkle tree`);
+	}), a;
+};
+//#endregion
+export { t as speculativeMerkleTree, e as toSpeculativeUtxo };

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-proof.cjs

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

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[][], onChainEncryptedOutput: string, onChainCreation: boolean[], proofAArr: number[], proofBArr: number[], proofCArr: number[], publicInputsArr: number[][]) => Promise<{
+    proofAccountPart1: PublicKey;
+    proofAccountPart2: PublicKey;
+    encryptedOutputsAccount: PublicKey;
+}>;

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

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

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/private-wallet/emporium.helpers.cjs

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

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

@@ -0,0 +1,53 @@
+import { ethers } from 'ethers';
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+import { AuthorizationData } from '../../types/hinkal.types';
+import { BridgeQuote } from '../../types/bridging-tx.types';
+type EncodableContract = {
+    address?: string;
+    target?: string | {
+        toString(): string;
+    };
+    interface: {
+        encodeFunctionData: (...args: any[]) => string;
+    };
+};
+export declare const emporiumOp: ({ contract, func, args, callDataString, invokeWallet, value, }: {
+    contract: EncodableContract | 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[], emporiumMessage?: bigint, signerAddress?: string, maxFee?: bigint) => Promise<string>;
+export declare const decodeEmporiumMetadata: (metadata: string) => {
+    v: number;
+    r: string;
+    s: string;
+    signerAddress: string;
+    ops: string[];
+    maxFee: bigint;
+    deadline: bigint;
+};
+export declare const signEmporiumCancelMessage: (chainId: number, emporiumAddress: string, privateKey: string, emporiumMessage: bigint) => Promise<{
+    v: number;
+    r: string;
+    s: string;
+}>;
+export declare const createTransferToEmporiumOp: (tokenContract: EncodableContract | 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: EncodableContract, to: string, amount: bigint, invokeWallet: boolean) => string;
+export declare const generateFundAndApproveOps: (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;
+export {};