@kapa123456789/sdk 0.0.1

package/common/src/functions/web3/functionCalls/approveToken.mjs

@@ -0,0 +1,113 @@
+import { chainIds as e, getNonLocalhostChainId as t } from "../../../constants/chains.constants.mjs";
+import { permitSignatureValidFor as n } from "../../../constants/protocol.constants.mjs";
+import { ContractType as r } from "../../../types/ethereum-network.types.mjs";
+import { ApprovalType as i } from "../../../types/token.types.mjs";
+import { getContractAddress as a } from "../../utils/getContractAddress.mjs";
+import { getProviderFromContract as o, getSignerFromContract as s } from "../../utils/getSignerFromContract.mjs";
+import { recoverTransactionFromError as c } from "./recoverTransactionFromError.mjs";
+import { ethers as l } from "ethers";
+//#region libs/shared/common/src/functions/web3/functionCalls/approveToken.ts
+var u = async (e, t, n) => {
+	let r = s(n);
+	return await n.allowance(await r.getAddress(), t.target) >= e;
+}, d = async (n, r, i, o, c) => {
+	if (t(r) !== e.ethMainnet || o.symbol.toLowerCase() !== "usdt" || BigInt(await c.allowance(await s(c).getAddress(), i.target)) === 0n) return;
+	let l = await c.approve(a(i), 0n);
+	l && "hash" in l && await n.waitForTransaction(r, l.hash);
+}, f = async (t, s, f, p, m) => {
+	let h = t.getContractWithSigner(s, r.ERC20Contract, m.erc20TokenAddress), g = m.approvalType ?? i.Classic;
+	if (g === i.Classic || !t.isPermitterAvailable(s)) {
+		if (await u(p, f, h)) return;
+		await d(t, s, f, m, h);
+		let n = s === e.base ? 2 : 1;
+		try {
+			let e = await h.approve(a(f), p);
+			e && "hash" in e && await t.waitForTransaction(s, e.hash, n);
+		} catch (e) {
+			if (!e?.transactionHash || !await c(o(h), e.transactionHash, n)) throw e;
+		}
+		return;
+	}
+	let _ = await t.getEthereumAddressByChain(s), v = t.getContract(s, r.PermitterContract), y = await t.getContractWithFetcher(s, r.ContractWithNonces, m.erc20TokenAddress).nonces(_), b = BigInt(Date.now() + n) / 1000n, x = {
+		owner: _,
+		holder: _,
+		spender: a(v),
+		value: p,
+		nonce: y,
+		deadline: b,
+		expiry: b,
+		allowed: !0
+	}, { v: S, r: C, s: w } = l.Signature.from(await t.signTypedData({
+		name: await h.name(),
+		chainId: s,
+		version: "1",
+		verifyingContract: m.erc20TokenAddress
+	}, { Permit: g === i.ERC20Permit ? [
+		{
+			name: "owner",
+			type: "address"
+		},
+		{
+			name: "spender",
+			type: "address"
+		},
+		{
+			name: "value",
+			type: "uint256"
+		},
+		{
+			name: "nonce",
+			type: "uint256"
+		},
+		{
+			name: "deadline",
+			type: "uint256"
+		}
+	] : [
+		{
+			name: "holder",
+			type: "address"
+		},
+		{
+			name: "spender",
+			type: "address"
+		},
+		{
+			name: "nonce",
+			type: "uint256"
+		},
+		{
+			name: "expiry",
+			type: "uint256"
+		},
+		{
+			name: "allowed",
+			type: "bool"
+		}
+	] }, x));
+	if (g === i.ERC20Permit) {
+		let e = new l.Interface(["function permit(address owner,address spender,uint256 value,uint256 deadline,uint8 v,bytes32 r,bytes32 s) external"]);
+		return l.getBytesCopy(e.encodeFunctionData("permit", [
+			x.owner,
+			x.spender,
+			x.value,
+			x.deadline,
+			S,
+			l.getBytesCopy(C),
+			l.getBytesCopy(w)
+		])).slice(4);
+	}
+	let T = new l.Interface(["function permit(address holder,address spender,uint256 nonce,uint256 expiry,bool allowed,uint8 v,bytes32 r,bytes32 s) external"]);
+	return l.getBytesCopy(T.encodeFunctionData("permit", [
+		x.holder,
+		x.spender,
+		x.nonce,
+		x.expiry,
+		x.allowed,
+		S,
+		l.getBytesCopy(C),
+		l.getBytesCopy(w)
+	])).slice(4);
+};
+//#endregion
+export { f as approveTokenToHinkal };

package/common/src/functions/web3/functionCalls/approveTokensToHinkal.cjs

@@ -0,0 +1 @@
+const e=require(`../../../constants/protocol.constants.cjs`),t=require(`./approveToken.cjs`);var n=async(n,r,i,a,o)=>{for(let s=0;s<o.length;s+=1){let c=o[s],l=a[s];c>0n&&l.erc20TokenAddress!==e.zeroAddress&&await t.approveTokenToHinkal(n,r,i,c,l)}};exports.approveTokensToHinkal=n;

package/common/src/functions/web3/functionCalls/approveTokensToHinkal.d.ts

@@ -0,0 +1,4 @@
+import { ethers } from 'ethers';
+import { IHinkal } from '../../../data-structures/Hinkal/IHinkal';
+import { ERC20Token } from '../../../types/token.types';
+export declare const approveTokensToHinkal: (hinkal: IHinkal, chainId: number, contractForApproval: ethers.Contract, tokensToApprove: ERC20Token[], amounts: bigint[]) => Promise<void>;

package/common/src/functions/web3/functionCalls/approveTokensToHinkal.mjs

@@ -0,0 +1,11 @@
+import { zeroAddress as e } from "../../../constants/protocol.constants.mjs";
+import { approveTokenToHinkal as t } from "./approveToken.mjs";
+//#region libs/shared/common/src/functions/web3/functionCalls/approveTokensToHinkal.ts
+var n = async (n, r, i, a, o) => {
+	for (let s = 0; s < o.length; s += 1) {
+		let c = o[s], l = a[s];
+		c > 0n && l.erc20TokenAddress !== e && await t(n, r, i, c, l);
+	}
+};
+//#endregion
+export { n as approveTokensToHinkal };

package/common/src/functions/web3/functionCalls/constructBatchCall.cjs

@@ -0,0 +1 @@
+require(`../../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../utils/getContractAddress.cjs`),t=require(`../../../externalABIs/index.cjs`);let n=require(`ethers`);var r=(e,r)=>new n.ethers.Interface(t.ERC20ABI).encodeFunctionData(`approve`,[e,r]),i=(e,t,n,r)=>r.encodeFunctionData(`transact`,[e[0],e[1],e[2],t,n]),a=(e,t,n,r,i)=>i.encodeFunctionData(`prooflessDeposit`,[e,t,n,r]),o=(e,t,i,a,o,s)=>{let c=[];for(let a=0;a<e.length;a+=1){let o=e[a],s=t[a];o!==n.ethers.ZeroAddress&&s>0n&&c.push({to:o,value:`0x0`,data:r(i,s)})}return c.push({to:a,value:s>0n?`0x${s.toString(16)}`:`0x0`,data:o}),c},s=(t,a,o,s,c,l,u,d)=>{let f=[];for(let e=0;e<t.length;e+=1){let i=t[e],s=a[e];i!==n.ethers.ZeroAddress&&s>0n&&f.push({to:i,value:`0x0`,data:r(o,s)})}return f.push({to:e.getContractAddress(s),value:d>0n?`0x${d.toString(16)}`:`0x0`,data:i(c,l,u,s.interface)}),f},c=(t,n,r,i,s,c,l,u,d)=>{let f=a(s,c,l,u,i.interface);return o(t,n,r,e.getContractAddress(i),f,d)};exports.buildApproveAndProoflessDepositCalls=c,exports.buildApproveAndTransactCalls=s;

package/common/src/functions/web3/functionCalls/constructBatchCall.d.ts

@@ -0,0 +1,6 @@
+import { ethers } from 'ethers';
+import { CircomDataType, DimDataType, StealthAddressStructure } from '../../../types/circom-data.types';
+import { NewZkCallDataType } from '../../../types/snark.types';
+import { Call } from '../../../types/eip5792.types';
+export declare const buildApproveAndTransactCalls: (tokenAddresses: string[], amounts: bigint[], spenderAddress: string, contractForTransaction: ethers.Contract, zkCallData: NewZkCallDataType, dimData: DimDataType, circomData: CircomDataType, ethValue: bigint) => Call[];
+export declare const buildApproveAndProoflessDepositCalls: (tokenAddresses: string[], amounts: bigint[], spenderAddress: string, contractForTransaction: ethers.Contract, prooflessDepositTokenAddresses: string[], prooflessDepositAmountChanges: bigint[], prooflessDepositTokenIds: bigint[], stealthAddressStructures: StealthAddressStructure[], ethValue: bigint) => Call[];

package/common/src/functions/web3/functionCalls/constructBatchCall.mjs

@@ -0,0 +1,51 @@
+import { getContractAddress as e } from "../../utils/getContractAddress.mjs";
+import { ERC20ABI as t } from "../../../externalABIs/index.mjs";
+import { ethers as n } from "ethers";
+//#region libs/shared/common/src/functions/web3/functionCalls/constructBatchCall.ts
+var r = (e, r) => new n.Interface(t).encodeFunctionData("approve", [e, r]), i = (e, t, n, r) => r.encodeFunctionData("transact", [
+	e[0],
+	e[1],
+	e[2],
+	t,
+	n
+]), a = (e, t, n, r, i) => i.encodeFunctionData("prooflessDeposit", [
+	e,
+	t,
+	n,
+	r
+]), o = (e, t, i, a, o, s) => {
+	let c = [];
+	for (let a = 0; a < e.length; a += 1) {
+		let o = e[a], s = t[a];
+		o !== n.ZeroAddress && s > 0n && c.push({
+			to: o,
+			value: "0x0",
+			data: r(i, s)
+		});
+	}
+	return c.push({
+		to: a,
+		value: s > 0n ? `0x${s.toString(16)}` : "0x0",
+		data: o
+	}), c;
+}, s = (t, a, o, s, c, l, u, d) => {
+	let f = [];
+	for (let e = 0; e < t.length; e += 1) {
+		let i = t[e], s = a[e];
+		i !== n.ZeroAddress && s > 0n && f.push({
+			to: i,
+			value: "0x0",
+			data: r(o, s)
+		});
+	}
+	return f.push({
+		to: e(s),
+		value: d > 0n ? `0x${d.toString(16)}` : "0x0",
+		data: i(c, l, u, s.interface)
+	}), f;
+}, c = (t, n, r, i, s, c, l, u, d) => {
+	let f = a(s, c, l, u, i.interface);
+	return o(t, n, r, e(i), f, d);
+};
+//#endregion
+export { c as buildApproveAndProoflessDepositCalls, s as buildApproveAndTransactCalls };

package/common/src/functions/web3/functionCalls/estimateGasRelayer.d.ts

@@ -0,0 +1,4 @@
+import { CircomDataType, DimDataType } from '../../../types/circom-data.types';
+import { NewZkCallDataType } from '../../../types/snark.types';
+import { AuthorizationData } from '../../../types/hinkal.types';
+export declare const estimateGasRelayer: (chainId: number, newZkCallData: NewZkCallDataType, dimData: DimDataType, circomData: CircomDataType, authorizationData?: AuthorizationData) => Promise<bigint>;

package/common/src/functions/web3/functionCalls/getRootHash.d.ts

@@ -0,0 +1,2 @@
+import { Contract } from 'ethers';
+export declare const getRootHash: (merkleTreeContract: Contract) => Promise<bigint>;

package/common/src/functions/web3/functionCalls/recoverTransactionFromError.cjs

@@ -0,0 +1 @@
+const e=require(`../../../types/transactions.types.cjs`);require(`../../../types/index.cjs`);const t=require(`../../utils/time.utils.cjs`);var n=1*1e3,r=30*1e3,i=async(i,a,o=0)=>{if((await i.getTransactionReceipt(a))?.status!==e.TransactionReceiptStatus.Succeeded)return;o>0&&await i.waitForTransaction(a,o);let s=r/n,c=null;for(let e=0;e<s;e+=1){try{if(c=await i.getTransaction(a),c)break}catch{}e<s-1&&await t.waitLittle(n)}return c??void 0};exports.recoverTransactionFromError=i;

package/common/src/functions/web3/functionCalls/recoverTransactionFromError.d.ts

@@ -0,0 +1,2 @@
+import { ethers } from 'ethers';
+export declare const recoverTransactionFromError: (provider: ethers.Provider, transactionHash: string, confirmations?: number) => Promise<ethers.TransactionResponse | undefined>;

package/common/src/functions/web3/functionCalls/recoverTransactionFromError.mjs

@@ -0,0 +1,18 @@
+import { TransactionReceiptStatus as e } from "../../../types/transactions.types.mjs";
+import "../../../types/index.mjs";
+import { waitLittle as t } from "../../utils/time.utils.mjs";
+//#region libs/shared/common/src/functions/web3/functionCalls/recoverTransactionFromError.ts
+var n = 1 * 1e3, r = 30 * 1e3, i = async (i, a, o = 0) => {
+	if ((await i.getTransactionReceipt(a))?.status !== e.Succeeded) return;
+	o > 0 && await i.waitForTransaction(a, o);
+	let s = r / n, c = null;
+	for (let e = 0; e < s; e += 1) {
+		try {
+			if (c = await i.getTransaction(a), c) break;
+		} catch {}
+		e < s - 1 && await t(n);
+	}
+	return c ?? void 0;
+};
+//#endregion
+export { i as recoverTransactionFromError };

package/common/src/functions/web3/functionCalls/relayFunctions.d.ts

@@ -0,0 +1,3 @@
+import { ethers } from 'ethers';
+export declare const getRelayPercentage: (contract: ethers.Contract) => Promise<bigint>;
+export declare const getRelay: (hinkalHelperContract: ethers.Contract) => Promise<string>;

package/common/src/functions/web3/functionCalls/transactCallDirect.cjs

@@ -0,0 +1 @@
+require(`../../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../../constants/protocol.constants.cjs`),t=require(`../../../types/ethereum-network.types.cjs`),n=require(`../../utils/time.utils.cjs`),r=require(`../../utils/getContractAddress.cjs`),i=require(`./recoverTransactionFromError.cjs`),a=require(`./approveTokensToHinkal.cjs`),o=require(`./constructBatchCall.cjs`),s=require(`./waitForErc20Approvals.cjs`);let c=require(`ethers`);var l=async(l,u,d,f,p,m,h,g,_,v=!0,y=!1)=>{let b=Array.isArray(d)?d:[d],x=Array.isArray(f)?f:[f];if(b.length!==x.length)throw Error(`token and amount length mismatch`);let S=l.getContractWithSigner(u,t.ContractType.HinkalContract),C=await l.getEthereumAddressByChain(u),w=g??S,T=_??S,E=`transact`,D=x.findIndex(({erc20TokenAddress:t})=>t===e.zeroAddress),O=x.some(({erc20TokenAddress:t})=>t!==e.zeroAddress),k=D===-1?0n:b[D],A=l.getProviderAdapter(u),j=await A.supportsBatchCall?.(u);if(!y&&O&&j&&A.sendBatchCallsTransaction){let e=o.buildApproveAndTransactCalls(x.map(e=>e.erc20TokenAddress),b,r.getContractAddress(w),T,p,h,m,k);return await A.sendBatchCallsTransaction(u,e)}if(!y&&(await a.approveTokensToHinkal(l,u,w,x,b),O)){let e=x.map(({erc20TokenAddress:e},t)=>({tokenAddress:e,requiredAmount:b[t]}));await s.waitForErc20Approvals(l,u,C,r.getContractAddress(w),e)}let M={value:k>0n?BigInt(k).toString():void 0,gasLimit:void 0},N,P=[p[0],p[1],p[2],h,m,{...M,from:C}],{runner:F}=T;if(!(F instanceof c.ethers.AbstractSigner))throw Error(`expected signer`);if(v)try{N=Number(await T[E].estimateGas(...P))}catch(e){console.log(`hinkalDeposit: gas estimation error`,{err:e})}let I=N&&N>=0?Math.ceil(N*12/10):void 0;I&&(P[5].gasLimit=I),await n.waitLittle();let L;try{L=y?await T[E].populateTransaction(...P):await T[E](...P)}catch(e){if(!e?.transactionHash)throw e;let t=await i.recoverTransactionFromError(F.provider,e.transactionHash);if(!t)throw e;L=t}return L};exports.transactCallDirect=l;

package/common/src/functions/web3/functionCalls/transactCallDirect.d.ts

@@ -0,0 +1,6 @@
+import { ethers } from 'ethers';
+import { IHinkal } from '../../../data-structures/Hinkal/IHinkal';
+import { CircomDataType, DimDataType } from '../../../types/circom-data.types';
+import { ERC20Token } from '../../../types/token.types';
+import { NewZkCallDataType } from '../../../types/snark.types';
+export declare const transactCallDirect: (hinkal: IHinkal, chainId: number, amount: bigint | bigint[], tokenToApprove: ERC20Token | ERC20Token[], newZkCallData: NewZkCallDataType, circomData: CircomDataType, dimData: DimDataType, contractApproval?: ethers.Contract, contractTransaction?: ethers.Contract, preEstimateGas?: boolean, returnTxData?: boolean) => Promise<ethers.TransactionResponse | ethers.TransactionRequest>;

package/common/src/functions/web3/functionCalls/transactCallDirect.mjs

@@ -0,0 +1,60 @@
+import { zeroAddress as e } from "../../../constants/protocol.constants.mjs";
+import { ContractType as t } from "../../../types/ethereum-network.types.mjs";
+import { waitLittle as n } from "../../utils/time.utils.mjs";
+import { getContractAddress as r } from "../../utils/getContractAddress.mjs";
+import { recoverTransactionFromError as i } from "./recoverTransactionFromError.mjs";
+import { approveTokensToHinkal as a } from "./approveTokensToHinkal.mjs";
+import { buildApproveAndTransactCalls as o } from "./constructBatchCall.mjs";
+import { waitForErc20Approvals as s } from "./waitForErc20Approvals.mjs";
+import { ethers as c } from "ethers";
+//#region libs/shared/common/src/functions/web3/functionCalls/transactCallDirect.ts
+var l = async (l, u, d, f, p, m, h, g, _, v = !0, y = !1) => {
+	let b = Array.isArray(d) ? d : [d], x = Array.isArray(f) ? f : [f];
+	if (b.length !== x.length) throw Error("token and amount length mismatch");
+	let S = l.getContractWithSigner(u, t.HinkalContract), C = await l.getEthereumAddressByChain(u), w = g ?? S, T = _ ?? S, E = "transact", D = x.findIndex(({ erc20TokenAddress: t }) => t === e), O = x.some(({ erc20TokenAddress: t }) => t !== e), k = D === -1 ? 0n : b[D], A = l.getProviderAdapter(u), j = await A.supportsBatchCall?.(u);
+	if (!y && O && j && A.sendBatchCallsTransaction) {
+		let e = o(x.map((e) => e.erc20TokenAddress), b, r(w), T, p, h, m, k);
+		return await A.sendBatchCallsTransaction(u, e);
+	}
+	if (!y && (await a(l, u, w, x, b), O)) {
+		let e = x.map(({ erc20TokenAddress: e }, t) => ({
+			tokenAddress: e,
+			requiredAmount: b[t]
+		}));
+		await s(l, u, C, r(w), e);
+	}
+	let M = {
+		value: k > 0n ? BigInt(k).toString() : void 0,
+		gasLimit: void 0
+	}, N, P = [
+		p[0],
+		p[1],
+		p[2],
+		h,
+		m,
+		{
+			...M,
+			from: C
+		}
+	], { runner: F } = T;
+	if (!(F instanceof c.AbstractSigner)) throw Error("expected signer");
+	if (v) try {
+		N = Number(await T[E].estimateGas(...P));
+	} catch (e) {
+		console.log("hinkalDeposit: gas estimation error", { err: e });
+	}
+	let I = N && N >= 0 ? Math.ceil(N * 12 / 10) : void 0;
+	I && (P[5].gasLimit = I), await n();
+	let L;
+	try {
+		L = y ? await T[E].populateTransaction(...P) : await T[E](...P);
+	} catch (e) {
+		if (!e?.transactionHash) throw e;
+		let t = await i(F.provider, e.transactionHash);
+		if (!t) throw e;
+		L = t;
+	}
+	return L;
+};
+//#endregion
+export { l as transactCallDirect };

package/common/src/functions/web3/functionCalls/transactCallDirectTron.cjs

@@ -0,0 +1 @@
+const e=require(`../../../constants/chains.constants.cjs`),t=require(`../../../constants/protocol.constants.cjs`),n=require(`../../../error-handling/error-codes.constants.cjs`),r=require(`../../utils/caseInsensitive.utils.cjs`),i=require(`../../utils/tron.utils.cjs`),a=require(`../../../error-handling/logger.cjs`),o=require(`../../../externalABIs/index.cjs`),s=require(`../../utils/tronSimulation.utils.cjs`),c=require(`./waitForErc20Approvals.cjs`);var l=async(l,u,d,f,p,m,h,g,_,v=!0)=>{let y=l.getTronWeb(),b=i.evmHexToTronBase58Address(f.erc20TokenAddress),x=await l.getEthereumAddressByChain(u),{hinkalAddress:S,hinkalABI:C}=e.networkRegistry[u].contractData,w=y.contract(C,i.evmHexToTronBase58Address(S)),T=g??w,E=_??w;if(!T.address)throw Error(`contractForApproval address not set`);if(!E.address)throw Error(`contractForTransaction address not set`);let D=r.caseInsensitiveEqual(f.erc20TokenAddress,t.zeroAddress);if(!D&&d>0n){let e=T.address;if(!e)throw Error(`token approval spender not set`);let n=d,r=await y.contract(o.ERC20ABI,b).allowance(x,e).call({from:x});if(BigInt(String(r))<n){let{transaction:r}=await y.transactionBuilder.triggerSmartContract(b,`approve(address,uint256)`,{feeLimit:t.TRON_DEFAULT_FEE_LIMIT_SUN},[{type:`address`,value:e},{type:`uint256`,value:n.toString()}],x),i=await y.trx.sign(r),a=await y.trx.sendRawTransaction(i);if(!a.result){let e=a.code??`UNKNOWN`,t=a.message?Buffer.from(a.message,`hex`).toString():`no message`;throw Error(`Tron token approval failed: ${e} - ${t}`)}await c.waitForTronErc20Approvals(y,x,e,[{tokenAddress:b,requiredAmount:n}])}}let{a:O,b:k,c:A}=i.parseZkCalldata(p),j=await i.reorderZkCallData(!0,p,h,m,!1);if(!j)throw Error(`Tron proof signature not found`);let M=[j.v,j.r,j.s],N=[h.tokenNumber,h.nullifierAmount,h.outputAmount],P=i.circomDataToArray(m);if(v&&(await s.simulateTronTransaction(u,E.address,`transact`,E.abi,[M,O,k,A,N,P],x,D?d:0n),D)){let e=BigInt(await y.trx.getBalance(x)),r=BigInt(t.TRON_DEFAULT_FEE_LIMIT_SUN);try{let e=i.createTronCallData(E.abi,`transact`,[M,O,k,A,N,P]);r=await i.estimateTronFeeSunWithPadding(y,u,E.address,x,e,d)}catch(e){a.Logger.error(`Error estimating Tron transact fee`,e)}if(e<d+r)throw Error(n.insufficientResourcesErrorCodes.INSUFFICIENT_TRON_BALANCE_FOR_FEE)}let F=await E.transact(M,O,k,A,N,P).send({feeLimit:t.TRON_DEFAULT_FEE_LIMIT_SUN,callValue:D?Number(d):0}),I=typeof F==`string`?F:F?.txid??F?.transaction?.txID??F?.transaction?.txid;if(!I)throw Error(`Tron transact failed (missing txid)`);return I};exports.transactCallDirectTron=l;

package/common/src/functions/web3/functionCalls/transactCallDirectTron.d.ts

@@ -0,0 +1,9 @@
+import { IHinkal } from '../../../data-structures/Hinkal/IHinkal';
+import { CircomDataType, DimDataType } from '../../../types/circom-data.types';
+import { NewZkCallDataType } from '../../../types/snark.types';
+import { ERC20Token } from '../../../types/token.types';
+import { Types as TronWebTypes } from 'tronweb';
+export declare const transactCallDirectTron: (hinkal: IHinkal, chainId: number, amount: bigint, tokenToApprove: ERC20Token, // in hex format
+newZkCallData: NewZkCallDataType, circomData: CircomDataType, dimData: DimDataType, contractApproval?: TronWebTypes.ContractInstance<any>, // in base58 format
+contractTransaction?: TronWebTypes.ContractInstance<any>, // in base58 format
+preEstimateGas?: boolean) => Promise<string>;

package/common/src/functions/web3/functionCalls/transactCallDirectTron.mjs

@@ -0,0 +1,81 @@
+import { networkRegistry as e } from "../../../constants/chains.constants.mjs";
+import { TRON_DEFAULT_FEE_LIMIT_SUN as t, zeroAddress as n } from "../../../constants/protocol.constants.mjs";
+import { insufficientResourcesErrorCodes as r } from "../../../error-handling/error-codes.constants.mjs";
+import { caseInsensitiveEqual as i } from "../../utils/caseInsensitive.utils.mjs";
+import { circomDataToArray as a, createTronCallData as o, estimateTronFeeSunWithPadding as s, evmHexToTronBase58Address as c, parseZkCalldata as l, reorderZkCallData as u } from "../../utils/tron.utils.mjs";
+import { Logger as d } from "../../../error-handling/logger.mjs";
+import { ERC20ABI as f } from "../../../externalABIs/index.mjs";
+import { simulateTronTransaction as p } from "../../utils/tronSimulation.utils.mjs";
+import { waitForTronErc20Approvals as m } from "./waitForErc20Approvals.mjs";
+//#region libs/shared/common/src/functions/web3/functionCalls/transactCallDirectTron.ts
+var h = async (h, g, _, v, y, b, x, S, C, w = !0) => {
+	let T = h.getTronWeb(), E = c(v.erc20TokenAddress), D = await h.getEthereumAddressByChain(g), { hinkalAddress: O, hinkalABI: k } = e[g].contractData, A = T.contract(k, c(O)), j = S ?? A, M = C ?? A;
+	if (!j.address) throw Error("contractForApproval address not set");
+	if (!M.address) throw Error("contractForTransaction address not set");
+	let N = i(v.erc20TokenAddress, n);
+	if (!N && _ > 0n) {
+		let e = j.address;
+		if (!e) throw Error("token approval spender not set");
+		let n = _, r = await T.contract(f, E).allowance(D, e).call({ from: D });
+		if (BigInt(String(r)) < n) {
+			let { transaction: r } = await T.transactionBuilder.triggerSmartContract(E, "approve(address,uint256)", { feeLimit: t }, [{
+				type: "address",
+				value: e
+			}, {
+				type: "uint256",
+				value: n.toString()
+			}], D), i = await T.trx.sign(r), a = await T.trx.sendRawTransaction(i);
+			if (!a.result) {
+				let e = a.code ?? "UNKNOWN", t = a.message ? Buffer.from(a.message, "hex").toString() : "no message";
+				throw Error(`Tron token approval failed: ${e} - ${t}`);
+			}
+			await m(T, D, e, [{
+				tokenAddress: E,
+				requiredAmount: n
+			}]);
+		}
+	}
+	let { a: P, b: F, c: I } = l(y), L = await u(!0, y, x, b, !1);
+	if (!L) throw Error("Tron proof signature not found");
+	let R = [
+		L.v,
+		L.r,
+		L.s
+	], z = [
+		x.tokenNumber,
+		x.nullifierAmount,
+		x.outputAmount
+	], B = a(b);
+	if (w && (await p(g, M.address, "transact", M.abi, [
+		R,
+		P,
+		F,
+		I,
+		z,
+		B
+	], D, N ? _ : 0n), N)) {
+		let e = BigInt(await T.trx.getBalance(D)), n = BigInt(t);
+		try {
+			let e = o(M.abi, "transact", [
+				R,
+				P,
+				F,
+				I,
+				z,
+				B
+			]);
+			n = await s(T, g, M.address, D, e, _);
+		} catch (e) {
+			d.error("Error estimating Tron transact fee", e);
+		}
+		if (e < _ + n) throw Error(r.INSUFFICIENT_TRON_BALANCE_FOR_FEE);
+	}
+	let V = await M.transact(R, P, F, I, z, B).send({
+		feeLimit: t,
+		callValue: N ? Number(_) : 0
+	}), H = typeof V == "string" ? V : V?.txid ?? V?.transaction?.txID ?? V?.transaction?.txid;
+	if (!H) throw Error("Tron transact failed (missing txid)");
+	return H;
+};
+//#endregion
+export { h as transactCallDirectTron };

package/common/src/functions/web3/functionCalls/transactCallRelayer.cjs

@@ -0,0 +1 @@
+const e=require(`../../../error-handling/customErrors/ErrorWithTx.cjs`),t=require(`../../../constants/server.constants.cjs`),n=require(`../../../API/getServerURL.cjs`),r=require(`../../../data-structures/http/HttpClient.cjs`),i=require(`../../../API/callRelayer.cjs`),a=require(`../../snarkjs/common.snarkjs.cjs`);require(`../../../error-handling/index.cjs`),require(`../../snarkjs/index.cjs`);var o=t=>{if(t.status===`success`)return t.message;throw t.message&&t.error?new e.ErrorWithRelayerTransaction(t.error,t.message):Error(t.error)},s=async(e,t,n,r,s,c,l,u,d)=>{let f=a.serializeCircomData(r);return o(await i.callRelayerTransactAPI({chainId:e,a:t[0],b:t[1],c:t[2],dimData:n,circomData:f,withUniswapWorkAround:c,authorizationData:l,adminData:u,tronProofSignature:d,commitmentValidationData:s}))},c=async e=>o(await r.httpClient.post(`${n.RELAYER_URL}${t.RELAYER_CONFIG.SOLANA_TRANSACT}`,e)),l=e=>{if(e.status===`success`)return e.message.scheduleId;throw Error(e.error||`Batch transaction failed`)},u=async(e,t,n,r,o,s)=>{let c=t.map(e=>a.serializeCircomData(e.circomData));return l(await i.callRelayerTransactBatchAPI({chainId:e,transactions:t.map((t,n)=>({chainId:e,a:t.zkCallData[0],b:t.zkCallData[1],c:t.zkCallData[2],dimData:t.dimData,circomData:c[n],commitmentValidationData:t.commitmentValidationData,withUniswapWorkAround:t.withUniswapWorkAround,authorizationData:t.authorizationData,adminData:t.adminData,recipientAddress:t.recipientAddress,tronProofSignature:t.tronProofSignature})),txCompletionTime:r,hashedEthereumAddress:n,ref:o,hashedDashboardAccountId:s}))},d=async(e,t,n,r,a,o)=>l(await i.callRelayerSolanaTransactBatchAPI({chainId:e,transactions:t,hashedEthereumAddress:n,txCompletionTime:r,ref:a,hashedDashboardAccountId:o}));exports.solanaTransactCallRelayer=c,exports.solanaTransactCallRelayerBatch=d,exports.transactCallRelayer=s,exports.transactCallRelayerBatch=u;

package/common/src/functions/web3/functionCalls/transactCallRelayer.d.ts

@@ -0,0 +1,37 @@
+import { AdminDataType, AuthorizationData, CircomDataType, CommitmentValidationDataType, DimDataType, NewZkCallDataType } from '../../../types';
+import { SolanaTransactionBody } from '../../../types/solana.types';
+export interface RelayerResponseInterface {
+    status: string;
+    message: string;
+    error?: string;
+}
+export declare const transactCallRelayer: (chainId: number, newZkCallData: NewZkCallDataType, dimData: DimDataType, circomData: CircomDataType, commitmentValidationData?: CommitmentValidationDataType, withUniswapWorkAround?: boolean, authorizationData?: AuthorizationData, adminData?: AdminDataType, tronProofSignature?: {
+    v: number;
+    r: string;
+    s: string;
+}) => Promise<string>;
+export declare const solanaTransactCallRelayer: (body: SolanaTransactionBody) => Promise<string>;
+export interface RelayerBatchResponseInterface {
+    status: string;
+    message: {
+        scheduleId: string;
+    };
+    error?: string;
+}
+export interface BatchTransactionParams {
+    zkCallData: NewZkCallDataType;
+    dimData: DimDataType;
+    circomData: CircomDataType;
+    commitmentValidationData?: CommitmentValidationDataType;
+    withUniswapWorkAround?: boolean;
+    authorizationData?: AuthorizationData;
+    adminData?: AdminDataType;
+    recipientAddress?: string;
+    tronProofSignature?: {
+        v: number;
+        r: string;
+        s: string;
+    };
+}
+export declare const transactCallRelayerBatch: (chainId: number, transactions: BatchTransactionParams[], hashedEthereumAddress: string, txCompletionTime?: number, ref?: string, hashedDashboardAccountId?: string) => Promise<string>;
+export declare const solanaTransactCallRelayerBatch: (chainId: number, transactions: SolanaTransactionBody[], hashedEthereumAddress: string, txCompletionTime?: number, ref?: string, hashedDashboardAccountId?: string) => Promise<string>;

package/common/src/functions/web3/functionCalls/transactCallRelayer.mjs

@@ -0,0 +1,63 @@
+import { ErrorWithRelayerTransaction as e } from "../../../error-handling/customErrors/ErrorWithTx.mjs";
+import { RELAYER_CONFIG as t } from "../../../constants/server.constants.mjs";
+import { RELAYER_URL as n } from "../../../API/getServerURL.mjs";
+import { httpClient as r } from "../../../data-structures/http/HttpClient.mjs";
+import { callRelayerSolanaTransactBatchAPI as i, callRelayerTransactAPI as a, callRelayerTransactBatchAPI as o } from "../../../API/callRelayer.mjs";
+import { serializeCircomData as s } from "../../snarkjs/common.snarkjs.mjs";
+import "../../../error-handling/index.mjs";
+import "../../snarkjs/index.mjs";
+//#region libs/shared/common/src/functions/web3/functionCalls/transactCallRelayer.ts
+var c = (t) => {
+	if (t.status === "success") return t.message;
+	throw t.message && t.error ? new e(t.error, t.message) : Error(t.error);
+}, l = async (e, t, n, r, i, o, l, u, d) => {
+	let f = s(r);
+	return c(await a({
+		chainId: e,
+		a: t[0],
+		b: t[1],
+		c: t[2],
+		dimData: n,
+		circomData: f,
+		withUniswapWorkAround: o,
+		authorizationData: l,
+		adminData: u,
+		tronProofSignature: d,
+		commitmentValidationData: i
+	}));
+}, u = async (e) => c(await r.post(`${n}${t.SOLANA_TRANSACT}`, e)), d = (e) => {
+	if (e.status === "success") return e.message.scheduleId;
+	throw Error(e.error || "Batch transaction failed");
+}, f = async (e, t, n, r, i, a) => {
+	let c = t.map((e) => s(e.circomData));
+	return d(await o({
+		chainId: e,
+		transactions: t.map((t, n) => ({
+			chainId: e,
+			a: t.zkCallData[0],
+			b: t.zkCallData[1],
+			c: t.zkCallData[2],
+			dimData: t.dimData,
+			circomData: c[n],
+			commitmentValidationData: t.commitmentValidationData,
+			withUniswapWorkAround: t.withUniswapWorkAround,
+			authorizationData: t.authorizationData,
+			adminData: t.adminData,
+			recipientAddress: t.recipientAddress,
+			tronProofSignature: t.tronProofSignature
+		})),
+		txCompletionTime: r,
+		hashedEthereumAddress: n,
+		ref: i,
+		hashedDashboardAccountId: a
+	}));
+}, p = async (e, t, n, r, a, o) => d(await i({
+	chainId: e,
+	transactions: t,
+	hashedEthereumAddress: n,
+	txCompletionTime: r,
+	ref: a,
+	hashedDashboardAccountId: o
+}));
+//#endregion
+export { u as solanaTransactCallRelayer, p as solanaTransactCallRelayerBatch, l as transactCallRelayer, f as transactCallRelayerBatch };

package/common/src/functions/web3/functionCalls/waitForErc20Approvals.cjs

@@ -0,0 +1 @@
+const e=require(`../../../constants/protocol.constants.cjs`),t=require(`../../../types/ethereum-network.types.cjs`),n=require(`../../utils/caseInsensitive.utils.cjs`),r=require(`../../utils/time.utils.cjs`),i=require(`../../../externalABIs/index.cjs`);var a=async(i,a,o,s,c,l=30,u=1e3)=>{let d=c.filter(({tokenAddress:t,requiredAmount:r})=>r>0n&&!n.caseInsensitiveEqual(t,e.zeroAddress));if(d.length===0)return;let f=d.map(({tokenAddress:e})=>i.getContractWithSigner(a,t.ContractType.ERC20Contract,e));for(let e=0;e<l;e+=1){let e=!0;for(let t=0;t<d.length;t+=1){let{requiredAmount:n}=d[t],r=f[t];if(BigInt(await r.allowance(o,s))<n){e=!1;break}}if(e)break;await r.waitLittle(u)}},o=async(t,a,o,s,c=30,l=1e3)=>{let u=s.filter(({tokenAddress:t,requiredAmount:r})=>r>0n&&!n.caseInsensitiveEqual(t,e.zeroAddress)&&!!t);if(u.length===0)return;let d=await Promise.all(u.map(async({tokenAddress:e})=>t.contract(i.ERC20ABI,e)));for(let e=0;e<c;e+=1){let e=!0;for(let t=0;t<u.length;t+=1){let{requiredAmount:n}=u[t],r=await d[t].allowance(a,o).call({from:a});if(BigInt(String(r))<n){e=!1;break}}if(e)break;await r.waitLittle(l)}};exports.waitForErc20Approvals=a,exports.waitForTronErc20Approvals=o;

package/common/src/functions/web3/functionCalls/waitForErc20Approvals.d.ts

@@ -0,0 +1,11 @@
+import { IHinkal } from '../../../data-structures/Hinkal/IHinkal';
+import { TronWeb } from 'tronweb';
+type ApprovalRequirement = {
+    tokenAddress: string;
+    requiredAmount: bigint;
+};
+export declare const waitForErc20Approvals: (hinkal: IHinkal, chainId: number, ownerAddress: string, spenderAddress: string, requirements: ApprovalRequirement[], maxAttempts?: number, intervalMs?: number) => Promise<void>;
+export declare const waitForTronErc20Approvals: (tronWeb: TronWeb, ownerAddress: string, // Tron base58 owner address
+spenderAddress: string, // Tron base58 spender address
+requirements: ApprovalRequirement[], maxAttempts?: number, intervalMs?: number) => Promise<void>;
+export {};

package/common/src/functions/web3/functionCalls/waitForErc20Approvals.mjs

@@ -0,0 +1,41 @@
+import { zeroAddress as e } from "../../../constants/protocol.constants.mjs";
+import { ContractType as t } from "../../../types/ethereum-network.types.mjs";
+import { caseInsensitiveEqual as n } from "../../utils/caseInsensitive.utils.mjs";
+import { waitLittle as r } from "../../utils/time.utils.mjs";
+import { ERC20ABI as i } from "../../../externalABIs/index.mjs";
+//#region libs/shared/common/src/functions/web3/functionCalls/waitForErc20Approvals.ts
+var a = async (i, a, o, s, c, l = 30, u = 1e3) => {
+	let d = c.filter(({ tokenAddress: t, requiredAmount: r }) => r > 0n && !n(t, e));
+	if (d.length === 0) return;
+	let f = d.map(({ tokenAddress: e }) => i.getContractWithSigner(a, t.ERC20Contract, e));
+	for (let e = 0; e < l; e += 1) {
+		let e = !0;
+		for (let t = 0; t < d.length; t += 1) {
+			let { requiredAmount: n } = d[t], r = f[t];
+			if (BigInt(await r.allowance(o, s)) < n) {
+				e = !1;
+				break;
+			}
+		}
+		if (e) break;
+		await r(u);
+	}
+}, o = async (t, a, o, s, c = 30, l = 1e3) => {
+	let u = s.filter(({ tokenAddress: t, requiredAmount: r }) => r > 0n && !n(t, e) && !!t);
+	if (u.length === 0) return;
+	let d = await Promise.all(u.map(async ({ tokenAddress: e }) => t.contract(i, e)));
+	for (let e = 0; e < c; e += 1) {
+		let e = !0;
+		for (let t = 0; t < u.length; t += 1) {
+			let { requiredAmount: n } = u[t], r = await d[t].allowance(a, o).call({ from: a });
+			if (BigInt(String(r)) < n) {
+				e = !1;
+				break;
+			}
+		}
+		if (e) break;
+		await r(l);
+	}
+};
+//#endregion
+export { a as waitForErc20Approvals, o as waitForTronErc20Approvals };

package/common/src/functions/web3/getContractMetadata.cjs

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../constants/chains.constants.cjs`),t=require(`../../error-handling/error-codes.constants.cjs`),n=require(`../utils/tron.utils.cjs`),r=require(`../utils/create-provider.cjs`),i=require(`../../constants/contracts.constants.cjs`);let a=require(`ethers`);var o=(n,r)=>{let a=e.networkRegistry[r];if(!a)throw Error(t.transactionErrorCodes.UNSUPPORTED_NETWORK);let o=i.contractMetadataMapping[n];if(!o)throw Error(`Unsupported contractType: ${n}`);return o(a.contractData)},s=(e,t,r,i)=>{let s=o(e,t);if(!s.abi)throw Error(`No ABI configured for contractType: ${e}`);if(s.address&&r)throw Error(`Overriding address is not supported for contractType: ${e}`);let c=s.address??r;if(!c)throw Error(`No contractAddress configured for contractType: ${e}`);return new a.ethers.Contract(n.addressToHexFormat(c),s.abi,i)},c=(e,t,n=void 0)=>s(t,e,n,r.createJsonRpcProvider(e));exports.getContract=s,exports.getContractMetadata=o,exports.getContractWithFetcherByChainId=c;

package/common/src/functions/web3/getContractMetadata.d.ts

@@ -0,0 +1,5 @@
+import { ContractMetadata, ContractType } from '../../types/ethereum-network.types';
+import { ethers } from 'ethers';
+export declare const getContractMetadata: (contractType: ContractType, chainId: number) => ContractMetadata;
+export declare const getContract: (contractType: ContractType, chainId: number, contractAddress?: string, runner?: ethers.ContractRunner) => ethers.Contract;
+export declare const getContractWithFetcherByChainId: (chainId: number, contractType: ContractType, contractAddress?: string | undefined) => ethers.Contract;

package/common/src/functions/web3/getContractMetadata.mjs

@@ -0,0 +1,23 @@
+import { networkRegistry as e } from "../../constants/chains.constants.mjs";
+import { transactionErrorCodes as t } from "../../error-handling/error-codes.constants.mjs";
+import { addressToHexFormat as n } from "../utils/tron.utils.mjs";
+import { createJsonRpcProvider as r } from "../utils/create-provider.mjs";
+import { contractMetadataMapping as i } from "../../constants/contracts.constants.mjs";
+import { ethers as a } from "ethers";
+//#region libs/shared/common/src/functions/web3/getContractMetadata.ts
+var o = (n, r) => {
+	let a = e[r];
+	if (!a) throw Error(t.UNSUPPORTED_NETWORK);
+	let o = i[n];
+	if (!o) throw Error(`Unsupported contractType: ${n}`);
+	return o(a.contractData);
+}, s = (e, t, r, i) => {
+	let s = o(e, t);
+	if (!s.abi) throw Error(`No ABI configured for contractType: ${e}`);
+	if (s.address && r) throw Error(`Overriding address is not supported for contractType: ${e}`);
+	let c = s.address ?? r;
+	if (!c) throw Error(`No contractAddress configured for contractType: ${e}`);
+	return new a.Contract(n(c), s.abi, i);
+}, c = (e, t, n = void 0) => s(t, e, n, r(e));
+//#endregion
+export { s as getContract, o as getContractMetadata, c as getContractWithFetcherByChainId };

package/common/src/functions/web3/getPublicAddressBalance.cjs

@@ -0,0 +1 @@
+const e=require(`../../constants/protocol.constants.cjs`),t=require(`../../types/ethereum-network.types.cjs`),n=require(`../utils/getSignerFromContract.cjs`);var r=async(r,i,a,o)=>{let s=r.getContractWithFetcher(i,t.ContractType.ERC20Contract,a);return a===e.zeroAddress?n.getProviderFromContract(s).getBalance(o):s.balanceOf(o)};exports.getPublicAddressBalance=r;

package/common/src/functions/web3/getPublicAddressBalance.d.ts

@@ -0,0 +1,2 @@
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+export declare const getPublicAddressBalance: (hinkal: IHinkal, chainId: number, tokenAddress: string, ethereumAddress: string) => Promise<bigint>;