@sabaaa1/common 0.1.14 → 0.2.28

package/common/src/data-structures/Hinkal/hinkalGetZkMeProvider.d.ts

@@ -0,0 +1,28 @@
+import { IHinkal } from './IHinkal';
+export type ZkMeTransactionRequest = {
+    type: null | number;
+    from: string;
+    to: string;
+    data: string;
+    chainId: string;
+    gasLimit: string;
+    gasPrice: string;
+    maxFeePerGas: string | null;
+    maxPriorityFeePerGas: string | null;
+};
+export declare const getHinkalZkMeProvider: (hinkal: IHinkal) => {
+    getAccessToken(): Promise<any>;
+    getUserAccounts(): Promise<string[]>;
+    delegateTransaction(tx: ZkMeTransactionRequest): Promise<string>;
+};
+export type ZkMeProvider = ReturnType<typeof getHinkalZkMeProvider>;
+export type ZkMeWidgetMessageBody = {
+    id?: string;
+    channelId: string;
+    method?: 'getUserAccounts' | 'delegateTransaction' | 'signMessage' | 'getAccessToken';
+    params?: ZkMeTransactionRequest | string;
+    kycResults?: 'matching' | 'mismatch';
+    verifiedAddress?: string;
+    event?: 'close' | 'finished';
+    email?: string;
+};

package/common/src/data-structures/Hinkal/hinkalGetZkMeProvider.mjs

@@ -0,0 +1,22 @@
+import { API as e } from "../../API/API.mjs";
+//#region libs/shared/common/src/data-structures/Hinkal/hinkalGetZkMeProvider.ts
+var t = (t) => ({
+	async getAccessToken() {
+		return e.getZkMeAccessToken();
+	},
+	async getUserAccounts() {
+		return [await t.getEthereumAddress()];
+	},
+	async delegateTransaction(e) {
+		let n = t.getProviderAdapter(Number(e.chainId)), r = {
+			...e,
+			chainId: Number(e.chainId),
+			type: e.type ? e.type : void 0,
+			maxPriorityFeePerGas: e.maxPriorityFeePerGas ? e.maxPriorityFeePerGas : void 0,
+			maxFeePerGas: e.maxFeePerGas ? e.maxFeePerGas : void 0
+		};
+		return (await n.sendTransaction(r)).hash;
+	}
+});
+//#endregion
+export { t as getHinkalZkMeProvider };

package/common/src/data-structures/Hinkal/hinkalMultiSend.cjs

@@ -0,0 +1 @@
+const e=require(`../../error-handling/error-codes.constants.cjs`),t=require(`../../functions/utils/addresses.cjs`);var n=async(n,r,i,a)=>{let o;return a&&(o=a.map(n=>{if(!t.isValidPrivateAddress(n))throw Error(e.transactionErrorCodes.RECIPIENT_FORMAT_INCORRECT);return t.constructStealthAddressStructure(n)})),n.prooflessDeposit(r,i,o)};exports.hinkalMultiSendPrivateRecipients=n;

package/common/src/data-structures/Hinkal/hinkalMultiSend.d.ts

@@ -0,0 +1,3 @@
+import { IHinkal } from './IHinkal';
+import { ERC20Token } from '../../types/token.types';
+export declare const hinkalMultiSendPrivateRecipients: (hinkal: IHinkal, erc20Tokens: ERC20Token[], amounts: bigint[], extendedRecipientInfos?: string[]) => Promise<string>;

package/common/src/data-structures/Hinkal/hinkalMultiSend.mjs

@@ -0,0 +1,12 @@
+import { transactionErrorCodes as e } from "../../error-handling/error-codes.constants.mjs";
+import { constructStealthAddressStructure as t, isValidPrivateAddress as n } from "../../functions/utils/addresses.mjs";
+//#region libs/shared/common/src/data-structures/Hinkal/hinkalMultiSend.ts
+var r = async (r, i, a, o) => {
+	let s;
+	return o && (s = o.map((r) => {
+		if (!n(r)) throw Error(e.RECIPIENT_FORMAT_INCORRECT);
+		return t(r);
+	})), r.prooflessDeposit(i, a, s);
+};
+//#endregion
+export { r as hinkalMultiSendPrivateRecipients };

package/common/src/data-structures/Hinkal/hinkalPrivateWallet.cjs

@@ -0,0 +1 @@
+const e=require(`../../constants/chains.constants.cjs`),t=require(`../../types/hinkal.types.cjs`),n=require(`../../types/ethereum-network.types.cjs`),r=require(`../../types/external-action.types.cjs`),i=require(`../../types/admin.types.cjs`),a=require(`../../error-handling/error-codes.constants.cjs`),o=require(`../../functions/utils/caseInsensitive.utils.cjs`),s=require(`../../functions/utils/time.utils.cjs`),c=require(`../../functions/utils/addresses.cjs`),l=require(`../../functions/web3/events/getShieldedBalance.cjs`),u=require(`../../functions/pre-transaction/outputUtxoProcessing.cjs`),d=require(`../../functions/pre-transaction/outputApprovalDataProcessing.cjs`);require(`../../error-handling/index.cjs`);const f=require(`../../functions/pre-transaction/constructAdminData.cjs`),p=require(`../AccountActions/AccountActions.cjs`),m=require(`../../functions/pre-transaction/recipientUtxoProcessing.cjs`),h=require(`../../functions/pre-transaction/getFeeStructure.cjs`),g=require(`../../functions/pre-transaction/getKycAndSignatureData.cjs`),_=require(`../../functions/pre-transaction/buildCommitmentValidationData.cjs`);require(`../../functions/pre-transaction/index.cjs`);const v=require(`../../functions/utils/involves-permit2-op.cjs`),y=require(`../../functions/utils/convertEmporiumOpToCallInfo.cjs`),b=require(`../../functions/snarkjs/constructEmporiumProof.cjs`),x=require(`../../functions/web3/functionCalls/transactCallRelayer.cjs`),S=require(`../../functions/pre-transaction/merge-with-fee-structure.cjs`),C=require(`../../functions/pre-transaction/merge-with-fee-structure-emporium.cjs`),w=require(`./handleAutoDepositBack.cjs`);var T=async(e,t,n,r,i,a,o)=>{let c=[...await l.addPaddingToUtxos(e,t,n,r)],f=[],p=s.getCurrentTimeInSeconds().toString();for(let o=0;o<n.length;o+=1){let{outputUtxos:n}=u.outputUtxoProcessing(e.userKeys,c[o],r[o],p,void 0,!1);f.push(n);let{useApprovalUtxoData:s}=d.outputApprovalDataProcessing(e,t,c[o],r[o]);s&&(i.doPreTxApproval=!0,i.useApprovalUtxoData[o]=s,i.interactionAddress=a,i.inHinkalAddress=e.userKeys.getInHinkalAddress(a))}return o&&m.recipientUtxoProcessing(o,f,r,p),{inputUtxosArray:c,outputUtxosArray:f}},E=async(s,l,u,d,m,E,D,O,k,A,j,M=!1,N,P,F)=>{if(F&&!c.isValidPrivateAddress(F.recipientInfo))throw Error(a.transactionErrorCodes.RECIPIENT_FORMAT_INCORRECT);if(D.length>0&&!O)throw Error(`Subaccount is required for private wallet transactions`);let I=u.map(e=>e.erc20TokenAddress),L=await s.getEthereumAddressByChain(l),R=O?p.AccountActions.getAddressFromSubAccount(l,O):void 0,{contractData:z}=e.networkRegistry[l],{emporiumAddress:B}=z;if(!B)throw Error(`No Emporium Address Provided`);let V=A??await h.getFeeStructure(l,k,I,r.ExternalActionId.Emporium,E.map(e=>y.convertEmporiumOpToCallInfo(e,R??``,l)));for(R?await C.mergeWithFeeStructureEmporium(s,l,R,E,I,d,V,D.find(e=>o.caseInsensitiveEqual(e.token.erc20TokenAddress,V.feeToken))?.amount??0n):S.mergeWithFeeStructure(l,I,d,V);m.length<I.length;)m.push(!1);let H=t.defaultHinkalLogicArgs(d.length,s.userKeys),[{inputUtxosArray:U,outputUtxosArray:W},G,{patchAccessTokenMerkleTree:K,signatureData:q}]=await Promise.all([T(s,l,I,d,H,B,F),j??await s.getRandomRelay(l,!0),g.getKycAndSignatureData(s,l,I,d,L)]);if(!G)throw Error(a.transactionErrorCodes.RELAYER_NOT_AVAILABLE);let J=O?p.AccountActions.getPrivateKeyFromSubAccount(l,O):void 0,[{zkCallData:Y,circomData:X,dimData:Z,authorizationData:Q},$]=await Promise.all([b.constructEmporiumProof(s.merkleTreeHinkalByChain[l],s.merkleTreeAccessTokenByChain[l],I,I.map(()=>0),U,W,s.userKeys,d.length,U.length>0?U[0].length:0,B,E,s.generateProofRemotely,G,l,m,void 0,J,H,K,void 0,V,s.getContractWithFetcher(l,n.ContractType.HinkalHelperContract),q),_.buildCommitmentValidationData(l,s.userKeys,I,U)]),ee=await x.transactCallRelayer(l,Y,Z,X,$,v.uniswapWorkaround(E),Q,f.constructAdminData(P,l,D.map(e=>e.token.erc20TokenAddress),D.map(e=>e.amount),L,P===i.AdminTransactionType.PublicSwap?D.map(({token:e})=>e):void 0));return M&&O&&w.handleAutoDepositBack(s,l,R,O,V.feeToken,N,D,X),ee};exports.hinkalPrivateWallet=E;

package/common/src/data-structures/Hinkal/hinkalPrivateWallet.d.ts

@@ -0,0 +1,6 @@
+import { IHinkal } from './IHinkal';
+import { FeeStructure } from '../../types/hinkal.types';
+import { ERC20Token, PrivateRecipientInfo, TokenChanges } from '../../types/token.types';
+import { SubAccount } from '../../types/proxy.types';
+import { AdminTransactionType } from '../../types/admin.types';
+export declare const hinkalPrivateWallet: (hinkal: IHinkal, chainId: number, erc20Tokens: ERC20Token[], deltaChanges: bigint[], onChainCreation: boolean[], ops: string[], emporiumTokenChanges: TokenChanges<bigint>[], subAccount?: SubAccount, feeToken?: string, feeStructureOverride?: FeeStructure, relayOverride?: string, autoDepositBack?: boolean, maxGasInDollar?: string, action?: AdminTransactionType, privateRecipientInfo?: PrivateRecipientInfo) => Promise<string>;

package/common/src/data-structures/Hinkal/hinkalPrivateWallet.mjs

@@ -0,0 +1,58 @@
+import { networkRegistry as e } from "../../constants/chains.constants.mjs";
+import { defaultHinkalLogicArgs as t } from "../../types/hinkal.types.mjs";
+import { ContractType as n } from "../../types/ethereum-network.types.mjs";
+import { ExternalActionId as r } from "../../types/external-action.types.mjs";
+import { AdminTransactionType as i } from "../../types/admin.types.mjs";
+import { transactionErrorCodes as a } from "../../error-handling/error-codes.constants.mjs";
+import { caseInsensitiveEqual as o } from "../../functions/utils/caseInsensitive.utils.mjs";
+import { getCurrentTimeInSeconds as s } from "../../functions/utils/time.utils.mjs";
+import { isValidPrivateAddress as c } from "../../functions/utils/addresses.mjs";
+import { addPaddingToUtxos as l } from "../../functions/web3/events/getShieldedBalance.mjs";
+import { outputUtxoProcessing as u } from "../../functions/pre-transaction/outputUtxoProcessing.mjs";
+import { outputApprovalDataProcessing as d } from "../../functions/pre-transaction/outputApprovalDataProcessing.mjs";
+import "../../error-handling/index.mjs";
+import { constructAdminData as f } from "../../functions/pre-transaction/constructAdminData.mjs";
+import { AccountActions as p } from "../AccountActions/AccountActions.mjs";
+import { recipientUtxoProcessing as m } from "../../functions/pre-transaction/recipientUtxoProcessing.mjs";
+import { getFeeStructure as h } from "../../functions/pre-transaction/getFeeStructure.mjs";
+import { getKycAndSignatureData as g } from "../../functions/pre-transaction/getKycAndSignatureData.mjs";
+import { buildCommitmentValidationData as _ } from "../../functions/pre-transaction/buildCommitmentValidationData.mjs";
+import "../../functions/pre-transaction/index.mjs";
+import { uniswapWorkaround as v } from "../../functions/utils/involves-permit2-op.mjs";
+import { convertEmporiumOpToCallInfo as y } from "../../functions/utils/convertEmporiumOpToCallInfo.mjs";
+import { constructEmporiumProof as b } from "../../functions/snarkjs/constructEmporiumProof.mjs";
+import { transactCallRelayer as x } from "../../functions/web3/functionCalls/transactCallRelayer.mjs";
+import { mergeWithFeeStructure as S } from "../../functions/pre-transaction/merge-with-fee-structure.mjs";
+import { mergeWithFeeStructureEmporium as C } from "../../functions/pre-transaction/merge-with-fee-structure-emporium.mjs";
+import { handleAutoDepositBack as w } from "./handleAutoDepositBack.mjs";
+//#region libs/shared/common/src/data-structures/Hinkal/hinkalPrivateWallet.ts
+var T = async (e, t, n, r, i, a, o) => {
+	let c = [...await l(e, t, n, r)], f = [], p = s().toString();
+	for (let o = 0; o < n.length; o += 1) {
+		let { outputUtxos: n } = u(e.userKeys, c[o], r[o], p, void 0, !1);
+		f.push(n);
+		let { useApprovalUtxoData: s } = d(e, t, c[o], r[o]);
+		s && (i.doPreTxApproval = !0, i.useApprovalUtxoData[o] = s, i.interactionAddress = a, i.inHinkalAddress = e.userKeys.getInHinkalAddress(a));
+	}
+	return o && m(o, f, r, p), {
+		inputUtxosArray: c,
+		outputUtxosArray: f
+	};
+}, E = async (s, l, u, d, m, E, D, O, k, A, j, M = !1, N, P, F) => {
+	if (F && !c(F.recipientInfo)) throw Error(a.RECIPIENT_FORMAT_INCORRECT);
+	if (D.length > 0 && !O) throw Error("Subaccount is required for private wallet transactions");
+	let I = u.map((e) => e.erc20TokenAddress), L = await s.getEthereumAddressByChain(l), R = O ? p.getAddressFromSubAccount(l, O) : void 0, { contractData: z } = e[l], { emporiumAddress: B } = z;
+	if (!B) throw Error("No Emporium Address Provided");
+	let V = A ?? await h(l, k, I, r.Emporium, E.map((e) => y(e, R ?? "", l)));
+	for (R ? await C(s, l, R, E, I, d, V, D.find((e) => o(e.token.erc20TokenAddress, V.feeToken))?.amount ?? 0n) : S(l, I, d, V); m.length < I.length;) m.push(!1);
+	let H = t(d.length, s.userKeys), [{ inputUtxosArray: U, outputUtxosArray: W }, G, { patchAccessTokenMerkleTree: K, signatureData: q }] = await Promise.all([
+		T(s, l, I, d, H, B, F),
+		j ?? await s.getRandomRelay(l, !0),
+		g(s, l, I, d, L)
+	]);
+	if (!G) throw Error(a.RELAYER_NOT_AVAILABLE);
+	let J = O ? p.getPrivateKeyFromSubAccount(l, O) : void 0, [{ zkCallData: Y, circomData: X, dimData: Z, authorizationData: Q }, $] = await Promise.all([b(s.merkleTreeHinkalByChain[l], s.merkleTreeAccessTokenByChain[l], I, I.map(() => 0), U, W, s.userKeys, d.length, U.length > 0 ? U[0].length : 0, B, E, s.generateProofRemotely, G, l, m, void 0, J, H, K, void 0, V, s.getContractWithFetcher(l, n.HinkalHelperContract), q), _(l, s.userKeys, I, U)]), ee = await x(l, Y, Z, X, $, v(E), Q, f(P, l, D.map((e) => e.token.erc20TokenAddress), D.map((e) => e.amount), L, P === i.PublicSwap ? D.map(({ token: e }) => e) : void 0));
+	return M && O && w(s, l, R, O, V.feeToken, N, D, X), ee;
+};
+//#endregion
+export { E as hinkalPrivateWallet };

package/common/src/data-structures/Hinkal/hinkalProoflessDeposit.cjs

@@ -0,0 +1 @@
+const e=require(`../../constants/chains.constants.cjs`),t=require(`../../constants/protocol.constants.cjs`),n=require(`../../types/ethereum-network.types.cjs`),r=require(`../../error-handling/error-codes.constants.cjs`),i=require(`../../functions/web3/etherFunctions.cjs`),a=require(`../../functions/utils/caseInsensitive.utils.cjs`),o=require(`../utxo/Utxo.cjs`),s=require(`../../functions/utils/getContractAddress.cjs`),c=require(`../../functions/utils/tron.utils.cjs`),l=require(`../../error-handling/logger.cjs`),u=require(`../../functions/utils/token-check.utils.cjs`),d=require(`../../functions/snarkjs/common.snarkjs.cjs`),f=require(`../../functions/pre-transaction/constructAdminData.cjs`),p=require(`../../externalABIs/index.cjs`),m=require(`../../functions/utils/tx-confirmation.utils.cjs`),h=require(`../../functions/utils/tronSimulation.utils.cjs`),g=require(`../../functions/web3/functionCalls/constructBatchCall.cjs`),_=require(`../../functions/web3/functionCalls/waitForErc20Approvals.cjs`),v=require(`../../API/admin-calls.cjs`);var y=(e,t)=>{let n=[],r=0;for(let i=0;i<e.length;i+=1){let a=!1;for(let o=0;o<r;o+=1)if(u.isSameERC20Token(n[o].token,e[i])){n[o].balance+=t[i],a=!0;break}a||(n[r]={token:e[i],balance:t[i]},r+=1)}return n},b=async(e,r,i,o)=>{for(let s=0;s<o.length;s+=1)a.caseInsensitiveEqual(o[s].token.erc20TokenAddress,t.zeroAddress)||await m.waitForEthereumTransactionConfirmation(r,(await e.getContractWithSigner(r,n.ContractType.ERC20Contract,o[s].token.erc20TokenAddress).approve(i,o[s].balance)).hash)},x=async(e,n,r,i)=>{let a=Array.from(i.entries());for(let i=0;i<a.length;i+=1){let[o,s]=a[i],c=await e.contract(p.ERC20ABI,o).allowance(n,r).call({from:n});if(BigInt(String(c))<s){let{transaction:i}=await e.transactionBuilder.triggerSmartContract(o,`approve(address,uint256)`,{feeLimit:t.TRON_DEFAULT_FEE_LIMIT_SUN},[{type:`address`,value:r},{type:`uint256`,value:s.toString()}],n),a=await e.trx.sign(i),c=await e.trx.sendRawTransaction(a);if(!c.result){let e=c.code??`UNKNOWN`,t=c.message?Buffer.from(c.message,`hex`).toString():`no message`;throw Error(`Tron token approval failed: ${e} - ${t}`)}}}},S=e=>{let t=new Set;e.forEach(({extraRandomization:e,stealthAddress:n})=>{let r=`${e.toString()}:${n.toString()}`;if(t.has(r))throw Error(`Duplicate randomization and stealth address pair detected in stealthAddressStructures`);t.add(r)})},C=async(n,i,o,s,u)=>{let d=n.getTronWeb(),{hinkalAddress:f}=e.networkRegistry[i].contractData,p=c.evmHexToTronBase58Address(f),m=await n.getEthereumAddressByChain(i),g=o.map(e=>e.erc20TokenAddress),v=o.map(()=>0n),y=0n,b=new Map;for(let e=0;e<o.length;e+=1){let n=c.evmHexToTronBase58Address(o[e].erc20TokenAddress);if(a.caseInsensitiveEqual(o[e].erc20TokenAddress,t.zeroAddress))y+=s[e];else{let t=b.get(n)??0n;b.set(n,t+s[e])}}await x(d,m,p,b),await _.waitForTronErc20Approvals(d,m,p,Array.from(b.entries()).map(([e,t])=>({tokenAddress:e,requiredAmount:t})));let S=u.map(e=>({extraRandomization:e.extraRandomization.toString(),stealthAddress:e.stealthAddress.toString(),H0:e.H0.toString(),H1:e.H1.toString()}));if(await h.simulateTronTransaction(i,p,`prooflessDeposit`,e.networkRegistry[i].contractData.hinkalABI,[g,s.map(String),v.map(String),u.map(e=>[e.extraRandomization.toString(),e.stealthAddress.toString(),e.H0.toString(),e.H1.toString()])],m,y>0n?y:void 0),y>0n){let n=BigInt(await d.trx.getBalance(m)),a=BigInt(t.TRON_DEFAULT_FEE_LIMIT_SUN);try{let{hinkalABI:t}=e.networkRegistry[i].contractData;if(!t)throw Error(`Hinkal ABI not found`);a=await c.estimateTronFeeSunWithPadding(d,i,p,m,c.createTronCallData(t,`prooflessDeposit`,[g,s.map(String),v.map(String),u.map(e=>[e.extraRandomization.toString(),e.stealthAddress.toString(),e.H0.toString(),e.H1.toString()])]),y)}catch(e){l.Logger.error(`Error estimating Tron prooflessDeposit fee`,e)}if(n<y+a)throw Error(r.insufficientResourcesErrorCodes.INSUFFICIENT_TRON_BALANCE_FOR_FEE)}let{transaction:C}=await d.transactionBuilder.triggerSmartContract(p,`prooflessDeposit(address[],uint256[],uint256[],(uint256,uint256,uint256,uint256)[])`,{feeLimit:t.TRON_DEFAULT_FEE_LIMIT_SUN,callValue:y>0n?Number(y):0},[{type:`address[]`,value:g},{type:`uint256[]`,value:s.map(String)},{type:`uint256[]`,value:v.map(String)},{type:`tuple(uint256,uint256,uint256,uint256)[]`,value:S.map(e=>[e.extraRandomization,e.stealthAddress,e.H0,e.H1])}],m),w=await d.trx.sign(C),T=await d.trx.sendRawTransaction(w);if(!T.result)throw l.Logger.error(`Tron prooflessDeposit broadcast failed`,T),Error(`Tron prooflessDeposit broadcast failed`);let E=typeof T==`string`?T:T?.txid??T?.transaction?.txID;if(!E)throw Error(`Tron prooflessDeposit failed (missing txid)`);return E},w=async(r,c,l,p,m)=>{let h=u.validateAndGetChainId(c),x=e.isTronLike(h),w=await r.getEthereumAddressByChain(h),T=r.userKeys.getShieldedPrivateKey(),E=p??c.map(()=>d.calcStealthAddressStructure(o.Utxo.findCorrectRandomization(i.randomBigInt(31),T),T));if(E.length!==c.length)throw Error(`Stealth address structures length must be equal to erc20 tokens length`);S(E);let D;if(x)D=await C(r,h,c,l,E);else{let e=r.getContractWithSigner(h,n.ContractType.HinkalContract),i=r.getProviderAdapter(h),o=y(c,l),u=c.reduce((e,n,r)=>a.caseInsensitiveEqual(n.erc20TokenAddress,t.zeroAddress)?e+l[r]:e,0n),d=o.filter(({token:e,balance:n})=>!a.caseInsensitiveEqual(e.erc20TokenAddress,t.zeroAddress)&&n>0n),f;if(d.length>0&&await i.supportsBatchCall?.(h)&&i.sendBatchCallsTransaction){let t=g.buildApproveAndProoflessDepositCalls(d.map(({token:e})=>e.erc20TokenAddress),d.map(({balance:e})=>e),s.getContractAddress(e),e,c.map(({erc20TokenAddress:e})=>e),l,c.map(()=>0n),E,u);f=await i.sendBatchCallsTransaction(h,t)}else{await b(r,h,s.getContractAddress(e),o);let t=await r.getEthereumAddressByChain(h),n=o.map(({token:e,balance:t})=>({tokenAddress:e.erc20TokenAddress,requiredAmount:t}));await _.waitForErc20Approvals(r,h,t,s.getContractAddress(e),n),f=await e.prooflessDeposit(c.map(({erc20TokenAddress:e})=>e),l,c.map(()=>0n),E,{value:u>0n?u:void 0})}D=f.hash}return v.emitTxPublicData(f.constructAdminData(m,h,c.map(({erc20TokenAddress:e})=>e),l,w)),D};exports.hinkalProoflessDeposit=w;

package/common/src/data-structures/Hinkal/hinkalProoflessDeposit.d.ts

@@ -0,0 +1,5 @@
+import { ERC20Token } from '../../types/token.types';
+import { IHinkal } from './IHinkal';
+import { StealthAddressStructure } from '../../types/circom-data.types';
+import { AdminTransactionType } from '../../types/admin.types';
+export declare const hinkalProoflessDeposit: (hinkal: IHinkal, erc20Tokens: ERC20Token[], amountChanges: bigint[], stealthAddressStructuresOverride?: StealthAddressStructure[], action?: AdminTransactionType) => Promise<string>;

package/common/src/data-structures/Hinkal/hinkalProoflessDeposit.mjs

@@ -0,0 +1,167 @@
+import { isTronLike as e, networkRegistry as t } from "../../constants/chains.constants.mjs";
+import { TRON_DEFAULT_FEE_LIMIT_SUN as n, zeroAddress as r } from "../../constants/protocol.constants.mjs";
+import { ContractType as i } from "../../types/ethereum-network.types.mjs";
+import { insufficientResourcesErrorCodes as a } from "../../error-handling/error-codes.constants.mjs";
+import { randomBigInt as o } from "../../functions/web3/etherFunctions.mjs";
+import { caseInsensitiveEqual as s } from "../../functions/utils/caseInsensitive.utils.mjs";
+import { Utxo as c } from "../utxo/Utxo.mjs";
+import { getContractAddress as l } from "../../functions/utils/getContractAddress.mjs";
+import { createTronCallData as u, estimateTronFeeSunWithPadding as d, evmHexToTronBase58Address as f } from "../../functions/utils/tron.utils.mjs";
+import { Logger as p } from "../../error-handling/logger.mjs";
+import { isSameERC20Token as m, validateAndGetChainId as h } from "../../functions/utils/token-check.utils.mjs";
+import { calcStealthAddressStructure as g } from "../../functions/snarkjs/common.snarkjs.mjs";
+import { constructAdminData as _ } from "../../functions/pre-transaction/constructAdminData.mjs";
+import { ERC20ABI as v } from "../../externalABIs/index.mjs";
+import { waitForEthereumTransactionConfirmation as y } from "../../functions/utils/tx-confirmation.utils.mjs";
+import { simulateTronTransaction as b } from "../../functions/utils/tronSimulation.utils.mjs";
+import { buildApproveAndProoflessDepositCalls as x } from "../../functions/web3/functionCalls/constructBatchCall.mjs";
+import { waitForErc20Approvals as S, waitForTronErc20Approvals as C } from "../../functions/web3/functionCalls/waitForErc20Approvals.mjs";
+import { emitTxPublicData as w } from "../../API/admin-calls.mjs";
+//#region libs/shared/common/src/data-structures/Hinkal/hinkalProoflessDeposit.ts
+var T = (e, t) => {
+	let n = [], r = 0;
+	for (let i = 0; i < e.length; i += 1) {
+		let a = !1;
+		for (let o = 0; o < r; o += 1) if (m(n[o].token, e[i])) {
+			n[o].balance += t[i], a = !0;
+			break;
+		}
+		a || (n[r] = {
+			token: e[i],
+			balance: t[i]
+		}, r += 1);
+	}
+	return n;
+}, E = async (e, t, n, a) => {
+	for (let o = 0; o < a.length; o += 1) s(a[o].token.erc20TokenAddress, r) || await y(t, (await e.getContractWithSigner(t, i.ERC20Contract, a[o].token.erc20TokenAddress).approve(n, a[o].balance)).hash);
+}, D = async (e, t, r, i) => {
+	let a = Array.from(i.entries());
+	for (let i = 0; i < a.length; i += 1) {
+		let [o, s] = a[i], c = await e.contract(v, o).allowance(t, r).call({ from: t });
+		if (BigInt(String(c)) < s) {
+			let { transaction: i } = await e.transactionBuilder.triggerSmartContract(o, "approve(address,uint256)", { feeLimit: n }, [{
+				type: "address",
+				value: r
+			}, {
+				type: "uint256",
+				value: s.toString()
+			}], t), a = await e.trx.sign(i), c = await e.trx.sendRawTransaction(a);
+			if (!c.result) {
+				let e = c.code ?? "UNKNOWN", t = c.message ? Buffer.from(c.message, "hex").toString() : "no message";
+				throw Error(`Tron token approval failed: ${e} - ${t}`);
+			}
+		}
+	}
+}, O = (e) => {
+	let t = /* @__PURE__ */ new Set();
+	e.forEach(({ extraRandomization: e, stealthAddress: n }) => {
+		let r = `${e.toString()}:${n.toString()}`;
+		if (t.has(r)) throw Error("Duplicate randomization and stealth address pair detected in stealthAddressStructures");
+		t.add(r);
+	});
+}, k = async (e, i, o, c, l) => {
+	let m = e.getTronWeb(), { hinkalAddress: h } = t[i].contractData, g = f(h), _ = await e.getEthereumAddressByChain(i), v = o.map((e) => e.erc20TokenAddress), y = o.map(() => 0n), x = 0n, S = /* @__PURE__ */ new Map();
+	for (let e = 0; e < o.length; e += 1) {
+		let t = f(o[e].erc20TokenAddress);
+		if (s(o[e].erc20TokenAddress, r)) x += c[e];
+		else {
+			let n = S.get(t) ?? 0n;
+			S.set(t, n + c[e]);
+		}
+	}
+	await D(m, _, g, S), await C(m, _, g, Array.from(S.entries()).map(([e, t]) => ({
+		tokenAddress: e,
+		requiredAmount: t
+	})));
+	let w = l.map((e) => ({
+		extraRandomization: e.extraRandomization.toString(),
+		stealthAddress: e.stealthAddress.toString(),
+		H0: e.H0.toString(),
+		H1: e.H1.toString()
+	}));
+	if (await b(i, g, "prooflessDeposit", t[i].contractData.hinkalABI, [
+		v,
+		c.map(String),
+		y.map(String),
+		l.map((e) => [
+			e.extraRandomization.toString(),
+			e.stealthAddress.toString(),
+			e.H0.toString(),
+			e.H1.toString()
+		])
+	], _, x > 0n ? x : void 0), x > 0n) {
+		let e = BigInt(await m.trx.getBalance(_)), r = BigInt(n);
+		try {
+			let { hinkalABI: e } = t[i].contractData;
+			if (!e) throw Error("Hinkal ABI not found");
+			r = await d(m, i, g, _, u(e, "prooflessDeposit", [
+				v,
+				c.map(String),
+				y.map(String),
+				l.map((e) => [
+					e.extraRandomization.toString(),
+					e.stealthAddress.toString(),
+					e.H0.toString(),
+					e.H1.toString()
+				])
+			]), x);
+		} catch (e) {
+			p.error("Error estimating Tron prooflessDeposit fee", e);
+		}
+		if (e < x + r) throw Error(a.INSUFFICIENT_TRON_BALANCE_FOR_FEE);
+	}
+	let { transaction: T } = await m.transactionBuilder.triggerSmartContract(g, "prooflessDeposit(address[],uint256[],uint256[],(uint256,uint256,uint256,uint256)[])", {
+		feeLimit: n,
+		callValue: x > 0n ? Number(x) : 0
+	}, [
+		{
+			type: "address[]",
+			value: v
+		},
+		{
+			type: "uint256[]",
+			value: c.map(String)
+		},
+		{
+			type: "uint256[]",
+			value: y.map(String)
+		},
+		{
+			type: "tuple(uint256,uint256,uint256,uint256)[]",
+			value: w.map((e) => [
+				e.extraRandomization,
+				e.stealthAddress,
+				e.H0,
+				e.H1
+			])
+		}
+	], _), E = await m.trx.sign(T), O = await m.trx.sendRawTransaction(E);
+	if (!O.result) throw p.error("Tron prooflessDeposit broadcast failed", O), Error("Tron prooflessDeposit broadcast failed");
+	let k = typeof O == "string" ? O : O?.txid ?? O?.transaction?.txID;
+	if (!k) throw Error("Tron prooflessDeposit failed (missing txid)");
+	return k;
+}, A = async (t, n, a, u, d) => {
+	let f = h(n), p = e(f), m = await t.getEthereumAddressByChain(f), v = t.userKeys.getShieldedPrivateKey(), y = u ?? n.map(() => g(c.findCorrectRandomization(o(31), v), v));
+	if (y.length !== n.length) throw Error("Stealth address structures length must be equal to erc20 tokens length");
+	O(y);
+	let b;
+	if (p) b = await k(t, f, n, a, y);
+	else {
+		let e = t.getContractWithSigner(f, i.HinkalContract), o = t.getProviderAdapter(f), c = T(n, a), u = n.reduce((e, t, n) => s(t.erc20TokenAddress, r) ? e + a[n] : e, 0n), d = c.filter(({ token: e, balance: t }) => !s(e.erc20TokenAddress, r) && t > 0n), p;
+		if (d.length > 0 && await o.supportsBatchCall?.(f) && o.sendBatchCallsTransaction) {
+			let t = x(d.map(({ token: e }) => e.erc20TokenAddress), d.map(({ balance: e }) => e), l(e), e, n.map(({ erc20TokenAddress: e }) => e), a, n.map(() => 0n), y, u);
+			p = await o.sendBatchCallsTransaction(f, t);
+		} else {
+			await E(t, f, l(e), c);
+			let r = await t.getEthereumAddressByChain(f), i = c.map(({ token: e, balance: t }) => ({
+				tokenAddress: e.erc20TokenAddress,
+				requiredAmount: t
+			}));
+			await S(t, f, r, l(e), i), p = await e.prooflessDeposit(n.map(({ erc20TokenAddress: e }) => e), a, n.map(() => 0n), y, { value: u > 0n ? u : void 0 });
+		}
+		b = p.hash;
+	}
+	return w(_(d, f, n.map(({ erc20TokenAddress: e }) => e), a, m)), b;
+};
+//#endregion
+export { A as hinkalProoflessDeposit };

package/common/src/data-structures/Hinkal/hinkalProxySwap.cjs

@@ -0,0 +1 @@
+require(`../../constants/protocol.constants.cjs`);const e=require(`../../types/external-action.types.cjs`),t=require(`../../error-handling/error-codes.constants.cjs`),n=require(`../../functions/utils/token-check.utils.cjs`),r=require(`../AccountActions/AccountActions.cjs`),i=require(`../../functions/pre-transaction/getFeeStructure.cjs`),a=require(`../../constants/addresses.constants.cjs`),o=require(`../../functions/utils/convertEmporiumOpToCallInfo.cjs`),s=require(`../../functions/private-wallet/emporium.swap.helpers.cjs`);var c=async(c,l,u,d,f,p,m,h,g,_=!1,v,y)=>{if(!h)throw Error(`Fee token is required in hinkalProxySwap`);let b=n.validateAndGetChainId(l),x=r.AccountActions.getAddressFromSubAccount(b,m);if(!x)throw Error(`Public account address is not available`);let S=l.map(e=>e.erc20TokenAddress),C=await c.getRandomRelay(b,!0);if(!C)throw Error(t.transactionErrorCodes.RELAYER_NOT_AVAILABLE);let w=await s.createSwapToEmporiumOps(c,b,d,a.SWAP_ROUTER_ADDRESSES[d][b],f,S[0],u[0],u[1],S[1],p,x,C,!0),T=g??await i.getFeeStructure(b,h,S,e.ExternalActionId.Emporium,w.map(e=>o.convertEmporiumOpToCallInfo(e,x,b)),35n),E=l.map((e,t)=>({token:e,amount:u[t]}));return c.actionPrivateWallet(b,[],[],[],w,E,m,h,T,C,_,v,y,void 0)};exports.hinkalProxySwap=c;

package/common/src/data-structures/Hinkal/hinkalProxySwap.d.ts

@@ -0,0 +1,7 @@
+import { ERC20Token } from '../../types/token.types';
+import { ExternalActionId } from '../../types/external-action.types';
+import { FeeStructure } from '../../types/hinkal.types';
+import { IHinkal } from './IHinkal';
+import { SubAccount } from '../../types/proxy.types';
+import { AdminTransactionType } from '../../types/admin.types';
+export declare const hinkalProxySwap: (hinkal: IHinkal, erc20Tokens: ERC20Token[], deltaAmounts: bigint[], externalActionId: ExternalActionId, data: string, isTheSameChainSwap: boolean, subAccount: SubAccount, feeToken?: string, feeStructureOverride?: FeeStructure, autoDepositBack?: boolean, maxGasInDollar?: string, action?: AdminTransactionType) => Promise<string>;

package/common/src/data-structures/Hinkal/hinkalProxySwap.mjs

@@ -0,0 +1,24 @@
+import "../../constants/protocol.constants.mjs";
+import { ExternalActionId as e } from "../../types/external-action.types.mjs";
+import { transactionErrorCodes as t } from "../../error-handling/error-codes.constants.mjs";
+import { validateAndGetChainId as n } from "../../functions/utils/token-check.utils.mjs";
+import { AccountActions as r } from "../AccountActions/AccountActions.mjs";
+import { getFeeStructure as i } from "../../functions/pre-transaction/getFeeStructure.mjs";
+import { SWAP_ROUTER_ADDRESSES as a } from "../../constants/addresses.constants.mjs";
+import { convertEmporiumOpToCallInfo as o } from "../../functions/utils/convertEmporiumOpToCallInfo.mjs";
+import { createSwapToEmporiumOps as s } from "../../functions/private-wallet/emporium.swap.helpers.mjs";
+//#region libs/shared/common/src/data-structures/Hinkal/hinkalProxySwap.ts
+var c = async (c, l, u, d, f, p, m, h, g, _ = !1, v, y) => {
+	if (!h) throw Error("Fee token is required in hinkalProxySwap");
+	let b = n(l), x = r.getAddressFromSubAccount(b, m);
+	if (!x) throw Error("Public account address is not available");
+	let S = l.map((e) => e.erc20TokenAddress), C = await c.getRandomRelay(b, !0);
+	if (!C) throw Error(t.RELAYER_NOT_AVAILABLE);
+	let w = await s(c, b, d, a[d][b], f, S[0], u[0], u[1], S[1], p, x, C, !0), T = g ?? await i(b, h, S, e.Emporium, w.map((e) => o(e, x, b)), 35n), E = l.map((e, t) => ({
+		token: e,
+		amount: u[t]
+	}));
+	return c.actionPrivateWallet(b, [], [], [], w, E, m, h, T, C, _, v, y, void 0);
+};
+//#endregion
+export { c as hinkalProxySwap };

package/common/src/data-structures/Hinkal/hinkalProxyToPrivate.cjs

@@ -0,0 +1 @@
+const e=require(`../../types/external-action.types.cjs`),t=require(`../../error-handling/error-codes.constants.cjs`),n=require(`../../functions/utils/addresses.cjs`),r=require(`../../functions/utils/token-check.utils.cjs`),i=require(`../../functions/pre-transaction/getVolatileTransferAmount.cjs`),a=require(`../AccountActions/AccountActions.cjs`),o=require(`../../functions/pre-transaction/getFeeStructure.cjs`),s=require(`../../functions/utils/convertEmporiumOpToCallInfo.cjs`),c=require(`../../functions/private-wallet/emporium.helpers.cjs`);var l=async(l,u,d,f,p,m,h,g)=>{if(!h)throw Error(`hinkalProxyToPrivate: subAccount should be provided`);if(!p)throw Error(`Fee token is required in hinkalProxyToPrivate`);if(!n.isValidPrivateAddress(f))throw Error(t.transactionErrorCodes.RECIPIENT_FORMAT_INCORRECT);let _=r.validateAndGetChainId(u),v=a.AccountActions.getAddressFromSubAccount(_,h);if(!v)throw Error(`Public account address is not available`);let y=u.map(e=>e.erc20TokenAddress),b=await i.modifyVolatileTokenAmountChanges(_,u,d,v),x=c.createTransaferEmporiumOpsBatch(l,_,y,b),S=m??await o.getFeeStructure(_,p,y,e.ExternalActionId.Emporium,x.map(e=>s.convertEmporiumOpToCallInfo(e,v,_))),C=u.map((e,t)=>({token:e,amount:-1n*b[t]}));return l.actionPrivateWallet(_,[u[0]],[0n],[!1],x,C,h,p,S,void 0,void 0,void 0,g,{recipientInfo:f,amount:b[0],token:u[0]})};exports.hinkalProxyToPrivate=l;

package/common/src/data-structures/Hinkal/hinkalProxyToPrivate.d.ts

@@ -0,0 +1,6 @@
+import { ERC20Token } from '../../types/token.types';
+import { FeeStructure } from '../../types/hinkal.types';
+import { AdminTransactionType } from '../../types/admin.types';
+import { IHinkal } from './IHinkal';
+import { SubAccount } from '../../types/proxy.types';
+export declare const hinkalProxyToPrivate: (hinkal: IHinkal, erc20Tokens: ERC20Token[], deltaAmountsBase: bigint[], recipientInfo: string, feeToken?: string, feeStructureOverride?: FeeStructure, subAccount?: SubAccount, action?: AdminTransactionType) => Promise<string>;

package/common/src/data-structures/Hinkal/hinkalProxyToPrivate.mjs

@@ -0,0 +1,28 @@
+import { ExternalActionId as e } from "../../types/external-action.types.mjs";
+import { transactionErrorCodes as t } from "../../error-handling/error-codes.constants.mjs";
+import { isValidPrivateAddress as n } from "../../functions/utils/addresses.mjs";
+import { validateAndGetChainId as r } from "../../functions/utils/token-check.utils.mjs";
+import { modifyVolatileTokenAmountChanges as i } from "../../functions/pre-transaction/getVolatileTransferAmount.mjs";
+import { AccountActions as a } from "../AccountActions/AccountActions.mjs";
+import { getFeeStructure as o } from "../../functions/pre-transaction/getFeeStructure.mjs";
+import { convertEmporiumOpToCallInfo as s } from "../../functions/utils/convertEmporiumOpToCallInfo.mjs";
+import { createTransaferEmporiumOpsBatch as c } from "../../functions/private-wallet/emporium.helpers.mjs";
+//#region libs/shared/common/src/data-structures/Hinkal/hinkalProxyToPrivate.ts
+var l = async (l, u, d, f, p, m, h, g) => {
+	if (!h) throw Error("hinkalProxyToPrivate: subAccount should be provided");
+	if (!p) throw Error("Fee token is required in hinkalProxyToPrivate");
+	if (!n(f)) throw Error(t.RECIPIENT_FORMAT_INCORRECT);
+	let _ = r(u), v = a.getAddressFromSubAccount(_, h);
+	if (!v) throw Error("Public account address is not available");
+	let y = u.map((e) => e.erc20TokenAddress), b = await i(_, u, d, v), x = c(l, _, y, b), S = m ?? await o(_, p, y, e.Emporium, x.map((e) => s(e, v, _))), C = u.map((e, t) => ({
+		token: e,
+		amount: -1n * b[t]
+	}));
+	return l.actionPrivateWallet(_, [u[0]], [0n], [!1], x, C, h, p, S, void 0, void 0, void 0, g, {
+		recipientInfo: f,
+		amount: b[0],
+		token: u[0]
+	});
+};
+//#endregion
+export { l as hinkalProxyToPrivate };

package/common/src/data-structures/Hinkal/hinkalSignSubAccount.cjs

@@ -0,0 +1 @@
+const e=require(`../AccountActions/AccountActions.cjs`);require(`../AccountActions/index.cjs`);var t=async(t,n,r,i)=>{let a,o=e.AccountActions.getPrivateKeyFromSubAccount(t,i);if(!o)throw Error(`Private key is not available`);if(r)a=await e.AccountActions.signTypedDataFromPrivateKey(t,o,r.domain,r.types,r.value);else{if(!n)throw Error(`dataHash must be provided if typedData is not provided`);a=await e.AccountActions.signMessageFromPrivateKey(t,o,n)}return a};exports.hinkalSignSubAccount=t;

package/common/src/data-structures/Hinkal/hinkalSignSubAccount.d.ts

@@ -0,0 +1,4 @@
+import { SubAccount } from '../../types/proxy.types';
+import { TypedData } from '../../types/circom-data.types';
+export declare const hinkalSignSubAccount: (chainId: number, messageToSign: string | undefined, // it should be a hex number in string format
+typedData: TypedData | undefined, subAccount: SubAccount) => Promise<string>;

package/common/src/data-structures/Hinkal/hinkalSignSubAccount.mjs

@@ -0,0 +1,15 @@
+import { AccountActions as e } from "../AccountActions/AccountActions.mjs";
+import "../AccountActions/index.mjs";
+//#region libs/shared/common/src/data-structures/Hinkal/hinkalSignSubAccount.ts
+var t = async (t, n, r, i) => {
+	let a, o = e.getPrivateKeyFromSubAccount(t, i);
+	if (!o) throw Error("Private key is not available");
+	if (r) a = await e.signTypedDataFromPrivateKey(t, o, r.domain, r.types, r.value);
+	else {
+		if (!n) throw Error("dataHash must be provided if typedData is not provided");
+		a = await e.signMessageFromPrivateKey(t, o, n);
+	}
+	return a;
+};
+//#endregion
+export { t as hinkalSignSubAccount };

package/common/src/data-structures/Hinkal/hinkalSolanaClaimUtxo.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/external-action.types.cjs`),r=require(`../../types/admin.types.cjs`);require(`../../types/index.cjs`);const i=require(`../../error-handling/error-codes.constants.cjs`),a=require(`../../functions/web3/etherFunctions.cjs`),o=require(`../crypto-keys/keys.cjs`),s=require(`../../functions/utils/time.utils.cjs`),c=require(`../utxo/Utxo.cjs`),l=require(`../../functions/utils/token-check.utils.cjs`),u=require(`../../functions/snarkjs/common.snarkjs.cjs`),d=require(`../../functions/pre-transaction/constructAdminData.cjs`),f=require(`../../functions/pre-transaction/getFeeStructure.cjs`),p=require(`../../functions/pre-transaction/buildCommitmentValidationData.cjs`);require(`../../functions/pre-transaction/index.cjs`);const m=require(`../../functions/snarkjs/constructSolanaZkProof.cjs`),h=require(`../../functions/web3/functionCalls/transactCallRelayer.cjs`);let g=require(`ethers`);var _=async(_,v,y,b,x)=>{let S=l.validateAndGetChainId([v]),C=v.erc20TokenAddress;if(y.getTokenAddress(S)!==C)throw Error(`Off-chain UTXO token mismatch`);if(!y.shieldedPrivateKey)throw Error(`Claimable UTXO shieldedPrivateKey is missing`);let{originalDeployer:w,hinkalIdl:T}=e.networkRegistry[S].contractData;if(!w||!T)throw Error(`missing data`);let E=new o.UserKeys(void 0,y.shieldedPrivateKey),D=new c.Utxo({amount:y.amount,erc20TokenAddress:y.erc20TokenAddress,mintAddress:y.mintAddress,timeStamp:y.timeStamp,tokenId:y.tokenId,randomization:y.randomization,shieldedPrivateKey:E.getShieldedPrivateKey()}),O=b??await f.getFeeStructure(S,C,[C],n.ExternalActionId.Transact,void 0,void 0,{mintTo:C,nullifierCount:1});if(O.feeToken!==C)throw Error(`Claim fee token mismatch: fee must be paid from claimed UTXO token`);let k=O.variableRate>0n?O.variableRate:t.HINKAL_PRIVATE_SEND_VARIABLE_RATE;if(D.amount<=O.flatFee)throw Error(i.transactionErrorCodes.INSUFFICIENT_FUNDS_TO_TRANSACT);let A=D.amount-O.flatFee,j=A*k/10000n,M=A-j;if(M<=0n)throw Error(i.transactionErrorCodes.RECIPIENT_AMOUNT_INVALID);let N=O.flatFee+j,[P,F,I]=_.getRecipientInfo().split(`,`);if(!P||!F||!I)throw Error(`Invalid recipient info`);let L=s.getCurrentTimeInSeconds().toString(),R=new c.Utxo({amount:0n,erc20TokenAddress:D.erc20TokenAddress,mintAddress:D.mintAddress,tokenId:D.tokenId,shieldedPrivateKey:E.getShieldedPrivateKey()}),z=new c.Utxo({amount:0n,erc20TokenAddress:D.erc20TokenAddress,mintAddress:D.mintAddress,tokenId:D.tokenId,shieldedPrivateKey:E.getShieldedPrivateKey(),timeStamp:L}),B=new c.Utxo({amount:M,erc20TokenAddress:D.erc20TokenAddress,mintAddress:D.mintAddress,tokenId:D.tokenId,timeStamp:L,randomization:BigInt(P),stealthAddress:F,encryptionKey:I}),V=[D,R],H=[z,B],U=await _.getRandomRelay(S,!0);if(!U)throw Error(i.transactionErrorCodes.RELAYER_NOT_AVAILABLE);let W=c.Utxo.findCorrectRandomization(a.randomBigInt(31),E.getShieldedPrivateKey()),G={tokenNumber:1,nullifierAmount:V.length,outputAmount:H.length},K=u.calcEncryptedOutputs([H])[0].map(e=>Array.from(g.ethers.getBytes(e))),q=_.getSolanaProgram(T),[{proofAArr:J,proofBArr:Y,proofCArr:X,publicInputsArr:Z},Q]=await Promise.all([m.constructSolanaZkProof(_.generateProofRemotely,w,_.merkleTreeHinkalByChain[S],_.merkleTreeAccessTokenByChain[S],E,q,[C],[V],[H],W,N,0n,t.solanaNativeAddress,U,G,K,S),p.buildCommitmentValidationData(S,E,[C],[V])]),$={recipient:U,mint:C===`11111111111111111111111111111111`?void 0:C};return h.solanaTransactCallRelayer({chainId:S,relayAddress:U,functionName:`transfer`,args:{proofAArr:J,proofBArr:Y,proofCArr:X,publicInputsArr:Z,encryptedOutputs:K,relayerFee:N.toString(),dimensions:G},accounts:$,adminData:d.constructAdminData(x??r.AdminTransactionType.ClaimUtxo,S,[C],[-A],await _.getEthereumAddress()),commitmentValidationData:Q})};exports.hinkalSolanaClaimUtxo=_;

package/common/src/data-structures/Hinkal/hinkalSolanaClaimUtxo.d.ts

@@ -0,0 +1,5 @@
+import { AdminTransactionType, ERC20Token } from '../../types';
+import { FeeStructure } from '../../types/hinkal.types';
+import { Utxo } from '../utxo/Utxo';
+import { IHinkal } from './IHinkal';
+export declare const hinkalSolanaClaimUtxo: (hinkal: IHinkal, erc20Token: ERC20Token, utxo: Utxo, feeStructureOverride?: FeeStructure, action?: AdminTransactionType) => Promise<string>;

package/common/src/data-structures/Hinkal/hinkalSolanaClaimUtxo.mjs

@@ -0,0 +1,97 @@
+import { networkRegistry as e } from "../../constants/chains.constants.mjs";
+import { HINKAL_PRIVATE_SEND_VARIABLE_RATE as t, solanaNativeAddress as n } from "../../constants/protocol.constants.mjs";
+import { ExternalActionId as r } from "../../types/external-action.types.mjs";
+import { AdminTransactionType as i } from "../../types/admin.types.mjs";
+import "../../types/index.mjs";
+import { transactionErrorCodes as a } from "../../error-handling/error-codes.constants.mjs";
+import { randomBigInt as o } from "../../functions/web3/etherFunctions.mjs";
+import { UserKeys as s } from "../crypto-keys/keys.mjs";
+import { getCurrentTimeInSeconds as c } from "../../functions/utils/time.utils.mjs";
+import { Utxo as l } from "../utxo/Utxo.mjs";
+import { validateAndGetChainId as u } from "../../functions/utils/token-check.utils.mjs";
+import { calcEncryptedOutputs as d } from "../../functions/snarkjs/common.snarkjs.mjs";
+import { constructAdminData as f } from "../../functions/pre-transaction/constructAdminData.mjs";
+import { getFeeStructure as p } from "../../functions/pre-transaction/getFeeStructure.mjs";
+import { buildCommitmentValidationData as m } from "../../functions/pre-transaction/buildCommitmentValidationData.mjs";
+import "../../functions/pre-transaction/index.mjs";
+import { constructSolanaZkProof as h } from "../../functions/snarkjs/constructSolanaZkProof.mjs";
+import { solanaTransactCallRelayer as g } from "../../functions/web3/functionCalls/transactCallRelayer.mjs";
+import { ethers as _ } from "ethers";
+//#region libs/shared/common/src/data-structures/Hinkal/hinkalSolanaClaimUtxo.ts
+var v = async (v, y, b, x, S) => {
+	let C = u([y]), w = y.erc20TokenAddress;
+	if (b.getTokenAddress(C) !== w) throw Error("Off-chain UTXO token mismatch");
+	if (!b.shieldedPrivateKey) throw Error("Claimable UTXO shieldedPrivateKey is missing");
+	let { originalDeployer: T, hinkalIdl: E } = e[C].contractData;
+	if (!T || !E) throw Error("missing data");
+	let D = new s(void 0, b.shieldedPrivateKey), O = new l({
+		amount: b.amount,
+		erc20TokenAddress: b.erc20TokenAddress,
+		mintAddress: b.mintAddress,
+		timeStamp: b.timeStamp,
+		tokenId: b.tokenId,
+		randomization: b.randomization,
+		shieldedPrivateKey: D.getShieldedPrivateKey()
+	}), k = x ?? await p(C, w, [w], r.Transact, void 0, void 0, {
+		mintTo: w,
+		nullifierCount: 1
+	});
+	if (k.feeToken !== w) throw Error("Claim fee token mismatch: fee must be paid from claimed UTXO token");
+	let A = k.variableRate > 0n ? k.variableRate : t;
+	if (O.amount <= k.flatFee) throw Error(a.INSUFFICIENT_FUNDS_TO_TRANSACT);
+	let j = O.amount - k.flatFee, M = j * A / 10000n, N = j - M;
+	if (N <= 0n) throw Error(a.RECIPIENT_AMOUNT_INVALID);
+	let P = k.flatFee + M, [F, I, L] = v.getRecipientInfo().split(",");
+	if (!F || !I || !L) throw Error("Invalid recipient info");
+	let R = c().toString(), z = new l({
+		amount: 0n,
+		erc20TokenAddress: O.erc20TokenAddress,
+		mintAddress: O.mintAddress,
+		tokenId: O.tokenId,
+		shieldedPrivateKey: D.getShieldedPrivateKey()
+	}), B = new l({
+		amount: 0n,
+		erc20TokenAddress: O.erc20TokenAddress,
+		mintAddress: O.mintAddress,
+		tokenId: O.tokenId,
+		shieldedPrivateKey: D.getShieldedPrivateKey(),
+		timeStamp: R
+	}), V = new l({
+		amount: N,
+		erc20TokenAddress: O.erc20TokenAddress,
+		mintAddress: O.mintAddress,
+		tokenId: O.tokenId,
+		timeStamp: R,
+		randomization: BigInt(F),
+		stealthAddress: I,
+		encryptionKey: L
+	}), H = [O, z], U = [B, V], W = await v.getRandomRelay(C, !0);
+	if (!W) throw Error(a.RELAYER_NOT_AVAILABLE);
+	let G = l.findCorrectRandomization(o(31), D.getShieldedPrivateKey()), K = {
+		tokenNumber: 1,
+		nullifierAmount: H.length,
+		outputAmount: U.length
+	}, q = d([U])[0].map((e) => Array.from(_.getBytes(e))), J = v.getSolanaProgram(E), [{ proofAArr: Y, proofBArr: X, proofCArr: Z, publicInputsArr: Q }, $] = await Promise.all([h(v.generateProofRemotely, T, v.merkleTreeHinkalByChain[C], v.merkleTreeAccessTokenByChain[C], D, J, [w], [H], [U], G, P, 0n, n, W, K, q, C), m(C, D, [w], [H])]), ee = {
+		recipient: W,
+		mint: w === "11111111111111111111111111111111" ? void 0 : w
+	};
+	return g({
+		chainId: C,
+		relayAddress: W,
+		functionName: "transfer",
+		args: {
+			proofAArr: Y,
+			proofBArr: X,
+			proofCArr: Z,
+			publicInputsArr: Q,
+			encryptedOutputs: q,
+			relayerFee: P.toString(),
+			dimensions: K
+		},
+		accounts: ee,
+		adminData: f(S ?? i.ClaimUtxo, C, [w], [-j], await v.getEthereumAddress()),
+		commitmentValidationData: $
+	});
+};
+//#endregion
+export { v as hinkalSolanaClaimUtxo };

package/common/src/data-structures/Hinkal/hinkalSolanaDeposit.cjs

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../constants/chains.constants.cjs`);require(`../../constants/protocol.constants.cjs`);const t=require(`../../functions/pre-transaction/solana.cjs`),n=require(`./hinkalCheckSolanaTokenRegistry.cjs`),r=require(`../../types/admin.types.cjs`),i=require(`../../error-handling/error-codes.constants.cjs`),a=require(`../../functions/web3/etherFunctions.cjs`),o=require(`../utxo/Utxo.cjs`),s=require(`../../functions/utils/solanaMint.utils.cjs`),c=require(`../../functions/utils/addresses.cjs`),l=require(`../../API/API.cjs`),u=require(`../../functions/utils/token-check.utils.cjs`),d=require(`../../functions/snarkjs/common.snarkjs.cjs`),f=require(`../../functions/pre-transaction/constructAdminData.cjs`),p=require(`../../error-handling/retrySolanaError.cjs`),m=require(`../../API/admin-calls.cjs`);require(`../../API/index.cjs`);const h=require(`../../functions/web3/signAndSendSerializedTransaction.cjs`);let g=require(`@coral-xyz/anchor`),_=require(`@solana/web3.js`);var v=async(r,i,a,o,c)=>{if(a.length===0)throw Error(`amounts must not be empty`);if(a.length!==o.length)throw Error(`amounts and stealthAddressStructures length mismatch`);if(a.some(e=>e<=0n))throw Error(`all amounts must be positive`);let d=u.validateAndGetChainId([i]),v=i.erc20TokenAddress,{hinkalIdl:y,hinkalAddress:b,originalDeployer:x}=e.networkRegistry[d].contractData;if(!y)throw Error(`No IDL configured for Solana program on this network`);if(!x)throw Error(`missing original deployer`);let S=f.constructAdminData(c,d,Array(a.length).fill(v),a,await r.getEthereumAddress()),C=r.getSolanaProgram(y),w=r.getSolanaPublicKey(),T=new _.PublicKey(x),E=new _.PublicKey(b),{mintPublicKey:D}=s.formatMintAddress(v),O=D.toString(),k=t.getStorageAccountPublicKey(E,T),A=t.getStorageVaultPublicKey(E,T),j=t.getMerkleAccountPublicKey(E,T),M=o.map(e=>t.buildAnchorStealthAddressStructure(e)),N=a.reduce((e,t)=>e+t,0n),P=await n.hinkalCheckSolanaTokenRegistry(C,new _.PublicKey(T),[v],[N]),F=a.map(e=>e.toString()),I=t.getTokenLimitStorageAccountPublicKey(C.programId,T,D),L=O===`11111111111111111111111111111111`?null:D,R=O===`11111111111111111111111111111111`?null:void 0;for(let e=0;e<10;e+=1){let t=e===9;try{if(P){let{serializedTransaction:e,blockhash:t,lastValidBlockHeight:n}=await l.API.generateMultiPaymentDepositLimitless({amounts:F,payer:w.toBase58(),ethereumAddress:await r.getEthereumAddressByChain(d),mint:v,stealthAddressStructures:M,chainId:d,createBlockedUtxos:!1}),i=await h.signAndSendSerializedTransaction(C.provider,e,t,n);return await m.emitTxPublicData(S),i}let e=await C.methods.multiPaymentDeposit(F.map(e=>new g.BN(e)),M,!1).accounts({mint:L,signer:w,signerAta:R,originalDeployer:T,storageAccount:k,storageVault:A,merkleAccount:j,tokenLimitStorage:I,storageVaultAta:R,accessTokenOwner:null}).rpc();return await m.emitTxPublicData(S),e}catch(e){if(p.shouldRetryForSolanaError(e)&&!t)continue;throw e}}return``},y=async(e,t,n)=>{let i=e.userKeys.getShieldedPrivateKey(),s=d.calcStealthAddressStructure(o.Utxo.findCorrectRandomization(a.randomBigInt(31),i),i);return v(e,n,[t],[s],r.AdminTransactionType.ProoflessDeposit)},b=async(e,t,n,a)=>{if(!c.isValidPrivateAddress(a))throw Error(i.transactionErrorCodes.RECIPIENT_FORMAT_INCORRECT);let o=c.constructStealthAddressStructure(a);return v(e,n,[t],[o],r.AdminTransactionType.PaymentLink)};exports.hinkalSolanaDeposit=y,exports.hinkalSolanaDepositForOther=b,exports.submitSolanaProoflessDeposit=v;

package/common/src/data-structures/Hinkal/hinkalSolanaDeposit.d.ts

@@ -0,0 +1,7 @@
+import { StealthAddressStructure } from '../../types/circom-data.types';
+import { ERC20Token } from '../../types/token.types';
+import { IHinkal } from './IHinkal';
+import { AdminTransactionType } from '../../types/admin.types';
+export declare const submitSolanaProoflessDeposit: (hinkal: IHinkal, token: ERC20Token, amounts: bigint[], stealthAddressStructures: StealthAddressStructure[], action?: AdminTransactionType) => Promise<string>;
+export declare const hinkalSolanaDeposit: (hinkal: IHinkal, amount: bigint, token: ERC20Token) => Promise<string>;
+export declare const hinkalSolanaDepositForOther: (hinkal: IHinkal, amount: bigint, token: ERC20Token, recipientInfo: string) => Promise<string>;