@hinkal/react-native 0.3.1

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

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

@@ -0,0 +1,12 @@
+import { IHinkal } from '../../../data-structures/Hinkal/IHinkal';
+import { createTronCallData } from '../../utils/tron.utils';
+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 | bigint[], tokenToApprove: ERC20Token | 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>;
+/** Builds an unsigned Tron `transact` transaction (no approve/send). Used for PAL / deposit-and-withdraw prepare flows. */
+export declare const buildTronUnsignedTransactTransaction: (hinkal: IHinkal, chainId: number, amount: bigint, token: ERC20Token, newZkCallData: NewZkCallDataType, circomData: CircomDataType, dimData: DimDataType, contractAddressHex: string, contractAbi: Parameters<typeof createTronCallData>[0]) => Promise<TronWebTypes.Transaction>;

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

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

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

@@ -0,0 +1,10 @@
+import { zeroAddress as e } from "../../constants/protocol.constants.mjs";
+import { ContractType as t } from "../../types/ethereum-network.types.mjs";
+import { getProviderFromContract as n } from "../utils/getSignerFromContract.mjs";
+//#region common/src/functions/web3/getPublicAddressBalance.ts
+var r = async (r, i, a, o) => {
+	let s = r.getContractWithFetcher(i, t.ERC20Contract, a);
+	return a === e ? n(s).getBalance(o) : s.balanceOf(o);
+};
+//#endregion
+export { r as getPublicAddressBalance };

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

@@ -0,0 +1 @@
+const e=require(`../../constants/chains.constants.cjs`),t=require(`../../constants/protocol.constants.cjs`),n=require(`../../data-structures/http/HttpClient.cjs`);require(`../../data-structures/http/index.cjs`);const r=require(`../../error-handling/logger.cjs`),i=require(`../../types/fee.types.cjs`);var a=async(a,o=i.SolanaPriorityFeeMode.RECOMMENDED)=>{let s=a.map(e=>e.toBase58());try{let r=await n.httpClient.post(e.HELIUS_RPC_URL,{jsonrpc:`2.0`,id:`1`,method:`getPriorityFeeEstimate`,params:[{accountKeys:s,options:o===i.SolanaPriorityFeeMode.RECOMMENDED?{recommended:!0}:{includeAllPriorityFeeLevels:!0}}]}),a=o===i.SolanaPriorityFeeMode.RECOMMENDED?r.result?.priorityFeeEstimate:r.result?.priorityFeeLevels?.high;return Math.min(a??15e5,t.MAX_MICRO_LAMPORTS_PER_CU)}catch(e){return r.Logger.error(`Error getting solana priority fee:`,e),t.MAX_MICRO_LAMPORTS_PER_CU}};exports.getSolanaPriorityFee=a;

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

@@ -0,0 +1,3 @@
+import { PublicKey } from '@solana/web3.js';
+import { SolanaPriorityFeeMode } from '../../types/fee.types';
+export declare const getSolanaPriorityFee: (accounts: PublicKey[], priorityFeeMode?: SolanaPriorityFeeMode) => Promise<number>;

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

@@ -0,0 +1,26 @@
+import { HELIUS_RPC_URL as e } from "../../constants/chains.constants.mjs";
+import { MAX_MICRO_LAMPORTS_PER_CU as t } from "../../constants/protocol.constants.mjs";
+import { httpClient as n } from "../../data-structures/http/HttpClient.mjs";
+import "../../data-structures/http/index.mjs";
+import { Logger as r } from "../../error-handling/logger.mjs";
+import { SolanaPriorityFeeMode as i } from "../../types/fee.types.mjs";
+//#region common/src/functions/web3/getSolanaPriorityFee.ts
+var a = async (a, o = i.RECOMMENDED) => {
+	let s = a.map((e) => e.toBase58());
+	try {
+		let r = await n.post(e, {
+			jsonrpc: "2.0",
+			id: "1",
+			method: "getPriorityFeeEstimate",
+			params: [{
+				accountKeys: s,
+				options: o === i.RECOMMENDED ? { recommended: !0 } : { includeAllPriorityFeeLevels: !0 }
+			}]
+		}), a = o === i.RECOMMENDED ? r.result?.priorityFeeEstimate : r.result?.priorityFeeLevels?.high;
+		return Math.min(a ?? 15e5, t);
+	} catch (e) {
+		return r.error("Error getting solana priority fee:", e), t;
+	}
+};
+//#endregion
+export { a as getSolanaPriorityFee };

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

@@ -0,0 +1 @@
+const e=require(`../../constants/chains.constants.cjs`);require(`../../data-structures/http/index.cjs`),require(`../../externalABIs/index.cjs`),require(`../utils/index.cjs`),require(`ethers`),e.chainIds.base,e.chainIds.optimism,e.chainIds.arbMainnet,e.chainIds.polygon,e.chainIds.ethMainnet;

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

@@ -0,0 +1 @@
+export declare const getTokenHolder: (chainId: number, tokenAddress: string) => Promise<string | undefined>;

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

@@ -0,0 +1,7 @@
+import { chainIds as e } from "../../constants/chains.constants.mjs";
+import "../../data-structures/http/index.mjs";
+import "../../externalABIs/index.mjs";
+import "../utils/index.mjs";
+import "ethers";
+e.base, e.optimism, e.arbMainnet, e.polygon, e.ethMainnet;
+//#endregion

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

@@ -0,0 +1 @@
+require(`./etherFunctions.cjs`),require(`./events/getInputUtxoAndBalance.cjs`),require(`./events/getShieldedBalance.cjs`),require(`./getSolanaPriorityFee.cjs`),require(`./events/index.cjs`),require(`./uniswapAPI.cjs`),require(`./odosAPI.cjs`),require(`./oneInchAPI.cjs`),require(`./lifiAPI.cjs`),require(`./okxAPI.cjs`),require(`./runContractFunction.cjs`),require(`./getTokenHolder.cjs`),require(`./EIP-712.cjs`),require(`./signAndSendSerializedTransaction.cjs`),require(`./connectors.utils.cjs`);

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

@@ -0,0 +1,14 @@
+export * from './etherFunctions';
+export * from './events';
+export * from './uniswapAPI';
+export * from './odosAPI';
+export * from './oneInchAPI';
+export * from './lifiAPI';
+export * from './okxAPI';
+export * from './runContractFunction';
+export * from './getTokenHolder';
+export * from './EIP-712';
+export * from './signAndSendSerializedTransaction';
+export * from './connectors.utils';
+export * from './crypto';
+export * from './getSolanaPriorityFee';

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

@@ -0,0 +1,15 @@
+import "./etherFunctions.mjs";
+import "./events/getInputUtxoAndBalance.mjs";
+import "./events/getShieldedBalance.mjs";
+import "./getSolanaPriorityFee.mjs";
+import "./events/index.mjs";
+import "./uniswapAPI.mjs";
+import "./odosAPI.mjs";
+import "./oneInchAPI.mjs";
+import "./lifiAPI.mjs";
+import "./okxAPI.mjs";
+import "./runContractFunction.mjs";
+import "./getTokenHolder.mjs";
+import "./EIP-712.mjs";
+import "./signAndSendSerializedTransaction.mjs";
+import "./connectors.utils.mjs";

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

@@ -0,0 +1 @@
+require(`../../constants/chains.constants.cjs`),require(`../../constants/protocol.constants.cjs`),require(`../../error-handling/error-codes.constants.cjs`),require(`./etherFunctions.cjs`),require(`../utils/tron.utils.cjs`),require(`../../constants/lifi.constants.cjs`),require(`../../API/callLifiAPI.cjs`);

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

@@ -0,0 +1,6 @@
+import { ERC20Token } from '../../types/token.types';
+export declare const getLifiPrice: (inSwapToken: ERC20Token, outSwapToken: ERC20Token, inSwapAmount: string, bridgingSlippage: number, fromAddress: string, toAddress?: string) => Promise<{
+    lifiDataValue: string;
+    outSwapAmountValue: bigint;
+    extraNativeTokenFee: bigint;
+}>;

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

@@ -0,0 +1,7 @@
+import "../../constants/chains.constants.mjs";
+import "../../constants/protocol.constants.mjs";
+import "../../error-handling/error-codes.constants.mjs";
+import "./etherFunctions.mjs";
+import "../utils/tron.utils.mjs";
+import "../../constants/lifi.constants.mjs";
+import "../../API/callLifiAPI.mjs";

package/common/src/functions/web3/odosAPI.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(`./etherFunctions.cjs`),i=require(`../../API/callOdosAPI.cjs`);require(`../../error-handling/index.cjs`),require(`../../constants/index.cjs`);var a=async(a,o,s,c,l=.7)=>{try{let{odosResponse:n,status:u}=await i.callOdosAPI(a,{chainId:a===31337?e.localhostNetwork:a,inputTokens:[{tokenAddress:o?.wrappedErc20TokenAddress??o.erc20TokenAddress,amount:r.getAmountInWei(o,c).toString()}],outputTokens:[{tokenAddress:s?.wrappedErc20TokenAddress??s.erc20TokenAddress,proportion:1}],userAddr:e.networkRegistry[a].contractData.odosExternalActionInstanceAddress||t.zeroAddress,slippageLimitPercent:l,disableRFQs:!0});if(u!==`success`)throw Error(`Odos API Fetch Error`);return{outSwapAmountValue:BigInt(n.outputTokens[0].amount),odosDataValue:n.transaction.data}}catch(e){throw console.log({error:e}),Error(n.transactionErrorCodes.NO_ODOS_PRICE)}};exports.getOdosPrice=a;

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

@@ -0,0 +1,5 @@
+import { ERC20Token } from '../../types';
+export declare const getOdosPrice: (chainId: number, inSwapToken: ERC20Token, outSwapToken: ERC20Token, inSwapAmount: string, slippagePercentage?: number) => Promise<{
+    outSwapAmountValue: bigint;
+    odosDataValue: string;
+}>;

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

@@ -0,0 +1,35 @@
+import { localhostNetwork as e, networkRegistry as t } from "../../constants/chains.constants.mjs";
+import { zeroAddress as n } from "../../constants/protocol.constants.mjs";
+import { transactionErrorCodes as r } from "../../error-handling/error-codes.constants.mjs";
+import { getAmountInWei as i } from "./etherFunctions.mjs";
+import { callOdosAPI as a } from "../../API/callOdosAPI.mjs";
+import "../../error-handling/index.mjs";
+import "../../constants/index.mjs";
+//#region common/src/functions/web3/odosAPI.ts
+var o = async (o, s, c, l, u = .7) => {
+	try {
+		let { odosResponse: r, status: d } = await a(o, {
+			chainId: o === 31337 ? e : o,
+			inputTokens: [{
+				tokenAddress: s?.wrappedErc20TokenAddress ?? s.erc20TokenAddress,
+				amount: i(s, l).toString()
+			}],
+			outputTokens: [{
+				tokenAddress: c?.wrappedErc20TokenAddress ?? c.erc20TokenAddress,
+				proportion: 1
+			}],
+			userAddr: t[o].contractData.odosExternalActionInstanceAddress || n,
+			slippageLimitPercent: u,
+			disableRFQs: !0
+		});
+		if (d !== "success") throw Error("Odos API Fetch Error");
+		return {
+			outSwapAmountValue: BigInt(r.outputTokens[0].amount),
+			odosDataValue: r.transaction.data
+		};
+	} catch (e) {
+		throw console.log({ error: e }), Error(r.NO_ODOS_PRICE);
+	}
+};
+//#endregion
+export { o as getOdosPrice };

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

@@ -0,0 +1 @@
+require("../../../../_virtual/_rolldown/runtime.cjs");const e=require(`../utils/serialize.utils.cjs`),t=require(`../../constants/chains.constants.cjs`),n=require(`./etherFunctions.cjs`),r=require(`../pre-transaction/solana.cjs`),i=require(`../../API/callOkxAPI.cjs`);let a=require(`@solana/web3.js`);var o=(e,t,n,r,i=.7)=>({amount:`${n}`,chainIndex:`501`,fromTokenAddress:e.toString(),toTokenAddress:t.toString(),userWalletAddress:r,slippagePercent:`${i}`,directRoute:!0}),s=async(s,c,l,u,d=.5,f,p)=>{if(!t.isSolanaLike(s))throw Error(`OKX is only supported on Solana`);let m=n.randomBigInt(31),h=n.getAmountInWei(c,u),{hinkalAddress:g,originalDeployer:_}=t.networkRegistry[s].contractData;if(!_)throw Error(`No original deployer configured for Solana program`);if(p&&!f)throw Error(`Proxy wallet address is required`);let v=new a.PublicKey(g),y=new a.PublicKey(_),b=p&&f?new a.PublicKey(f):r.getSwapperAccountPublicKeyFromSalt(v,y,m),{okxResponse:x,status:S}=await i.callOkxAPI({quote:o(new a.PublicKey(c.erc20TokenAddress),new a.PublicKey(l.erc20TokenAddress),h,b.toString(),d)});if(S!==`success`)throw Error(`OKX API Fetch Error`);if(x.code!==`0`)throw Error(`OKX API error: ${x.msg}`);return{outSwapAmountValue:BigInt(x.data.routerResult.toTokenAmount),okxDataValue:e.safeJsonStringify({...x,swapperAccountSalt:m.toString()})}};exports.createOKXQuote=o,exports.getOKXPrice=s;

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

@@ -0,0 +1,8 @@
+import { PublicKey } from '@solana/web3.js';
+import { ERC20Token } from '../../types';
+import { OKXQuote } from '../../types/okx.types';
+export declare const createOKXQuote: (fromTokenAddress: PublicKey, toTokenAddress: PublicKey, amount: bigint, userWalletAddress: string, slippagePercent?: number) => OKXQuote;
+export declare const getOKXPrice: (chainId: number, inSwapToken: ERC20Token, outSwapToken: ERC20Token, inSwapAmount: string, slippagePercentage?: number, proxyWalletAddress?: string, isProxyEnvironment?: boolean) => Promise<{
+    outSwapAmountValue: bigint;
+    okxDataValue: string;
+}>;

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

@@ -0,0 +1,33 @@
+import { safeJsonStringify as e } from "../utils/serialize.utils.mjs";
+import { isSolanaLike as t, networkRegistry as n } from "../../constants/chains.constants.mjs";
+import { getAmountInWei as r, randomBigInt as i } from "./etherFunctions.mjs";
+import { getSwapperAccountPublicKeyFromSalt as a } from "../pre-transaction/solana.mjs";
+import { callOkxAPI as o } from "../../API/callOkxAPI.mjs";
+import { PublicKey as s } from "@solana/web3.js";
+//#region common/src/functions/web3/okxAPI.ts
+var c = (e, t, n, r, i = .7) => ({
+	amount: `${n}`,
+	chainIndex: "501",
+	fromTokenAddress: e.toString(),
+	toTokenAddress: t.toString(),
+	userWalletAddress: r,
+	slippagePercent: `${i}`,
+	directRoute: !0
+}), l = async (l, u, d, f, p = .5, m, h) => {
+	if (!t(l)) throw Error("OKX is only supported on Solana");
+	let g = i(31), _ = r(u, f), { hinkalAddress: v, originalDeployer: y } = n[l].contractData;
+	if (!y) throw Error("No original deployer configured for Solana program");
+	if (h && !m) throw Error("Proxy wallet address is required");
+	let b = new s(v), x = new s(y), S = h && m ? new s(m) : a(b, x, g), { okxResponse: C, status: w } = await o({ quote: c(new s(u.erc20TokenAddress), new s(d.erc20TokenAddress), _, S.toString(), p) });
+	if (w !== "success") throw Error("OKX API Fetch Error");
+	if (C.code !== "0") throw Error(`OKX API error: ${C.msg}`);
+	return {
+		outSwapAmountValue: BigInt(C.data.routerResult.toTokenAmount),
+		okxDataValue: e({
+			...C,
+			swapperAccountSalt: g.toString()
+		})
+	};
+};
+//#endregion
+export { c as createOKXQuote, l as getOKXPrice };