@sabaaa1/common 0.0.1 → 0.0.2

package/functions/web3/events/balanceChangedHandler.mjs

@@ -0,0 +1,11 @@
+import "../../../types/circom-data.types.mjs";
+import { EventType as n } from "../../../types/hinkal.types.mjs";
+import "../../../types/transactions.types.mjs";
+import "../../../types/activities.types.mjs";
+const i = () => {
+  const e = n.BalanceChange;
+  typeof document < "u" ? document.dispatchEvent(new Event(e)) : process?.emit("message", e, void 0);
+};
+export {
+  i as balanceChangedHandler
+};

package/functions/web3/events/getApprovedBalance.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const A=require("../../utils/caseInsensitive.utils.cjs"),l=require("../../utils/cacheFunctions.cjs"),k=require("async-mutex"),y=require("ethers"),I=require("../../utils/erc20tokenFunctions.cjs"),g=require("../../../data-structures/TokenDBs/PrivateTokensDB.cjs"),m=require("../../../constants/vite.constants.cjs"),h=new k.Mutex,f=(e,c,n)=>(e.forEach(t=>{t.inHinkalAddress===n&&c.push(t)}),c),v=(e,c=!1)=>{const{userKeys:n}=e,t=e.getCurrentChainId();c&&l.resetInHinkalAddressesCache(e,t,n.getShieldedPublicKey());const{approvals:o}=e,r=l.getInHinkalAddressesCache(e,t,n.getShieldedPublicKey());let i=[];return o.forEach((d,u)=>{const s=r[u];let a;s?a=BigInt(s):(a=n.getInHinkalAddress(u),r[u]=a.toString()),i=f(d.map(p=>({...p,interactionAddress:u})),i,a)}),l.setInHinkalAddressesCache(r,e,t,n.getShieldedPublicKey()),i},x=(e,c,n)=>v(e,n).filter(o=>A.caseInsensitiveEqual(o.tokenAddress,c)).sort((o,r)=>o.amount===r.amount?0:o.amount>r.amount?-1:1),E=async(e,c,n)=>{const t=e.getCurrentChainId(),o=await e.getEthereumAddress();let r=[];const i=new Map;return await h.runExclusive(async()=>{const d=v(e,c);n&&m.isExtension&&await g.privateTokensDB.fetchAndUpdatePrivateTokens(d.map(s=>s.tokenAddress),t,o),r=(m.isExtension?await g.privateTokensDB.getPrivateTokens(t,o):I.getErc20TokensForChain(t)).map(s=>({token:s,balance:d.reduce((a,p)=>A.caseInsensitiveEqual(s.erc20TokenAddress,p.tokenAddress)?a+p.amount:a,0n),timestamp:"0",nfts:[]})),r.forEach(s=>{i.set(s.token.erc20TokenAddress.toLowerCase(),s)})}),i},T=(e,c,n)=>{const{userKeys:t,approvals:o}=e,r=y.ethers.utils.getAddress(c),i=o.get(r)??[],d=t.getInHinkalAddress(r);return i.reduce((s,a)=>A.caseInsensitiveEqual(a.tokenAddress,n)&&a.inHinkalAddress===d?s+a.amount:s,0n)};exports.getApprovedBalance=E;exports.getApprovedUtxos=v;exports.getApprovedUtxosForToken=x;exports.getMyApprovalAmountForInteraction=T;

package/functions/web3/events/getApprovedBalance.d.ts

@@ -0,0 +1,7 @@
+import type { ApprovedUtxoWithInteractionAddress } from '../../../types/hinkal.types';
+import { type IHinkal } from '../../../data-structures/Hinkal/IHinkal';
+import type { TokenBalance } from '../../../types/token.types';
+export declare const getApprovedUtxos: (hinkal: IHinkal, resetCacheBefore?: boolean) => ApprovedUtxoWithInteractionAddress[];
+export declare const getApprovedUtxosForToken: (hinkal: IHinkal, erc20Address: string, resetCacheBefore: boolean) => ApprovedUtxoWithInteractionAddress[];
+export declare const getApprovedBalance: (hinkal: IHinkal, resetCacheBefore: boolean, updateTokensListBefore: boolean) => Promise<Map<string, TokenBalance>>;
+export declare const getMyApprovalAmountForInteraction: (hinkal: IHinkal, interactionAddress: string, tokenAddress: string) => bigint;

package/functions/web3/events/getApprovedBalance.mjs

@@ -0,0 +1,54 @@
+import { caseInsensitiveEqual as u } from "../../utils/caseInsensitive.utils.mjs";
+import { resetInHinkalAddressesCache as g, getInHinkalAddressesCache as v, setInHinkalAddressesCache as k } from "../../utils/cacheFunctions.mjs";
+import { Mutex as h } from "async-mutex";
+import { ethers as y } from "ethers";
+import { getErc20TokensForChain as I } from "../../utils/erc20tokenFunctions.mjs";
+import { privateTokensDB as l } from "../../../data-structures/TokenDBs/PrivateTokensDB.mjs";
+import { isExtension as A } from "../../../constants/vite.constants.mjs";
+const C = new h(), H = (e, d, r) => (e.forEach((t) => {
+  t.inHinkalAddress === r && d.push(t);
+}), d), f = (e, d = !1) => {
+  const { userKeys: r } = e, t = e.getCurrentChainId();
+  d && g(e, t, r.getShieldedPublicKey());
+  const { approvals: o } = e, n = v(e, t, r.getShieldedPublicKey());
+  let i = [];
+  return o.forEach((c, p) => {
+    const s = n[p];
+    let a;
+    s ? a = BigInt(s) : (a = r.getInHinkalAddress(p), n[p] = a.toString()), i = H(
+      c.map(
+        (m) => ({ ...m, interactionAddress: p })
+      ),
+      i,
+      a
+    );
+  }), k(n, e, t, r.getShieldedPublicKey()), i;
+}, P = (e, d, r) => f(e, r).filter((o) => u(o.tokenAddress, d)).sort((o, n) => o.amount === n.amount ? 0 : o.amount > n.amount ? -1 : 1), S = async (e, d, r) => {
+  const t = e.getCurrentChainId(), o = await e.getEthereumAddress();
+  let n = [];
+  const i = /* @__PURE__ */ new Map();
+  return await C.runExclusive(async () => {
+    const c = f(e, d);
+    r && A && await l.fetchAndUpdatePrivateTokens(
+      c.map((s) => s.tokenAddress),
+      t,
+      o
+    ), n = (A ? await l.getPrivateTokens(t, o) : I(t)).map((s) => ({
+      token: s,
+      balance: c.reduce((a, m) => u(s.erc20TokenAddress, m.tokenAddress) ? a + m.amount : a, 0n),
+      timestamp: "0",
+      nfts: []
+    })), n.forEach((s) => {
+      i.set(s.token.erc20TokenAddress.toLowerCase(), s);
+    });
+  }), i;
+}, U = (e, d, r) => {
+  const { userKeys: t, approvals: o } = e, n = y.utils.getAddress(d), i = o.get(n) ?? [], c = t.getInHinkalAddress(n);
+  return i.reduce((s, a) => u(a.tokenAddress, r) && a.inHinkalAddress === c ? s + a.amount : s, 0n);
+};
+export {
+  S as getApprovedBalance,
+  f as getApprovedUtxos,
+  P as getApprovedUtxosForToken,
+  U as getMyApprovalAmountForInteraction
+};

package/functions/web3/events/getInputUtxoAndBalance.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const N=require("../../../data-structures/utxo/Utxo.cjs"),v=require("../../utils/upToDateState.cjs"),A=require("../../utils/cacheFunctions.cjs"),S=require("../../utils/caseInsensitive.utils.cjs"),C=require("../../utils/encodeTokenWithId.cjs"),B=require("./getInputUtxosEnclave.cjs"),K=require("../../../error-handling/logger.cjs"),E=async(t,s,e,c,a,u,n,r,d)=>{d+=1;const U=u.slice(d),{lastOutput:f,additionalEncryptedOutputs:g}=await t.utxoUtils.batchProcess(U,r,s),l=[...n,...g];return await v.checkChainOrAddressNotUpdated(t,e,c),A.setHinkalCache({lastOutput:f,encryptedOutputs:l},t,e,a),await t.utxoUtils.buildBatchProcess(l,s)},b=async(t,s,e,c)=>{const{utxos:a,encryptedOutputs:u,lastOutput:n}=await B.getInputUtxosEnclave(t,e,s);return A.setHinkalCache({encryptedOutputs:u,lastOutput:n},t,e,c),a},m=async(t,s,e,c,a,u,n,r,d)=>{try{return await b(t,s,e,a)}catch{return E(t,s,e,c,a,u,n,r,d)}},R=t=>{if(Array.isArray(t))return t;if(t!==void 0)return[t]},F=async(t,s,e)=>await t.utxoUtils.batchFilterUtxosWithNullifier(s,e),H=(t,s,e,c,a,u)=>{for(t.sort((n,r)=>n.amount<=r.amount?1:-1);t.length<s||t.length>s&&t.length<6;)if(t.push(new N.Utxo({amount:0n,erc20TokenAddress:a,shieldedPrivateKey:c,tokenId:u})),e)for(;t.length>6;)t.splice(t.length-1)},P=async({hinkal:t,chainId:s=void 0,passedShieldedPublicKey:e=void 0,ethAddress:c=void 0,resetCacheBefore:a=!1,allowRemoteDecryption:u=!1})=>{if(!t.getCurrentChainId||!t.getSelectedNetwork())return K.Logger.log("returning empty balance"),{inputUtxos:[]};const n=c??await t.getEthereumAddress(),r=s??t.getCurrentChainId(),d=e??t.userKeys.getShieldedPublicKey(),{encryptedOutputs:U,nullifiers:f,userKeys:g}=t,l=Array.from(U);a&&A.resetCache(t,r,d);let{encryptedOutputs:i,lastOutput:o}=A.getHinkalCache(t,r,d);await v.checkChainOrAddressNotUpdated(t,r,n);const p=o!=="",y=l.findIndex(q=>q.value===o),x=y>-1,O=!p&&y===-1,I=t.areMerkleTreeUpdatesDisabled(),h=!I&&(x||!u&&O),T=!I&&u&&O,k=!h&&!T;let w=[];return h?w=await E(t,g,r,n,d,l,i,o,y):T?w=await m(t,g,r,n,d,l,i,o,y):k&&(w=await t.utxoUtils.buildBatchProcess(i,g)),await v.checkChainOrAddressNotUpdated(t,r,n),{inputUtxos:await F(t,w,f)}},L=async({hinkal:t,tokenWithId:s,minInput:e=2,sliceIfMore6:c=!0,chainId:a=void 0,passedShieldedPrivateKey:u=void 0,passedShieldedPublicKey:n=void 0,ethAddress:r=void 0,resetCacheBefore:d=!1,ensuredTokensWithId:U})=>{const f=u??t.userKeys.getShieldedPrivateKey(),{inputUtxos:g}=await P({hinkal:t,minInput:e,sliceIfMore6:c,chainId:a,passedShieldedPrivateKey:u,passedShieldedPublicKey:n,ethAddress:r,resetCacheBefore:d}),l=R(s),i=new Map;g.forEach(o=>{if(l&&!l.some(x=>S.caseInsensitiveEqual(x.erc20TokenAddress,o.erc20TokenAddress)&&x.tokenId===o.tokenId))return;const p=C.encodeTokenWithId({erc20TokenAddress:o.erc20TokenAddress,tokenId:o.tokenId}),y=i.get(p)??[];i.set(p,[...y,o])}),U?.forEach(o=>{const p=C.encodeTokenWithId({erc20TokenAddress:o.erc20TokenAddress,tokenId:o.tokenId});i.set(p,i.get(p)??[])});for(const[o,p]of i){const y=o.split("-")[0],x=Number(o.split("-")[1]);H(p,e,c,f,y,x)}return i};exports.attemptGetInputUtxosRemotely=m;exports.getInputUtxoAndBalance=P;exports.getInputUtxoAndBalancePerToken=L;exports.getInputUtxosRemotely=b;

package/functions/web3/events/getInputUtxoAndBalance.d.ts

@@ -0,0 +1,34 @@
+import { IHinkal } from '../../../data-structures/Hinkal/IHinkal';
+import { UserKeys } from '../../../data-structures/crypto-keys/keys';
+import { Utxo } from '../../../data-structures/utxo/Utxo';
+import { EncryptedOutputWithSign } from '../../../types/commitments.types';
+import { type TokenWithId } from '../../../types/token-with-id.types';
+interface IGetInputUtxos {
+    hinkal: IHinkal;
+    tokenWithId?: TokenWithId | TokenWithId[];
+    minInput?: number;
+    sliceIfMore6?: boolean;
+    tokenId?: number;
+    chainId?: number;
+    passedShieldedPrivateKey?: string;
+    passedShieldedPublicKey?: string;
+    ethAddress?: string;
+    resetCacheBefore?: boolean;
+    allowRemoteDecryption?: boolean;
+    ensuredTokensWithId?: TokenWithId[];
+}
+export declare const getInputUtxosRemotely: (hinkal: IHinkal, userKeys: UserKeys, currentChainId: number, shieldedPublicKey: string) => Promise<Utxo[]>;
+export declare const attemptGetInputUtxosRemotely: (hinkal: IHinkal, userKeys: UserKeys, currentChainId: number, ethereumAddress: string, shieldedPublicKey: string, hinkalOutputs: EncryptedOutputWithSign<boolean>[], cachedEncryptedOutputs: EncryptedOutputWithSign<boolean>[], lastOutput: string, lastOutputIndex: number) => Promise<Utxo[]>;
+/**
+ *
+ * @param hinkal instance of the hinkal class
+ * @param erc20TokenAddress erc20 token address
+ * @param minInput min number of input UTXOs
+ * @param sliceIfMore6 max upper bound on input UTXOs controller
+ * @returns UTXOs for particular erc20 token address
+ */
+export declare const getInputUtxoAndBalance: ({ hinkal, chainId, passedShieldedPublicKey, ethAddress, resetCacheBefore, allowRemoteDecryption, }: IGetInputUtxos) => Promise<{
+    inputUtxos: Utxo[];
+}>;
+export declare const getInputUtxoAndBalancePerToken: ({ hinkal, tokenWithId, minInput, sliceIfMore6, chainId, passedShieldedPrivateKey, passedShieldedPublicKey, ethAddress, resetCacheBefore, ensuredTokensWithId, }: IGetInputUtxos) => Promise<Map<string, Utxo[]>>;
+export {};

package/functions/web3/events/getInputUtxoAndBalance.mjs

@@ -0,0 +1,150 @@
+import { Utxo as P } from "../../../data-structures/utxo/Utxo.mjs";
+import { checkChainOrAddressNotUpdated as U } from "../../utils/upToDateState.mjs";
+import { setHinkalCache as E, resetCache as K, getHinkalCache as N } from "../../utils/cacheFunctions.mjs";
+import { caseInsensitiveEqual as B } from "../../utils/caseInsensitive.utils.mjs";
+import { encodeTokenWithId as T } from "../../utils/encodeTokenWithId.mjs";
+import { getInputUtxosEnclave as S } from "./getInputUtxosEnclave.mjs";
+import { Logger as L } from "../../../error-handling/logger.mjs";
+const b = async (t, s, e, c, a, u, r, n, d) => {
+  d += 1;
+  const g = u.slice(d), { lastOutput: w, additionalEncryptedOutputs: f } = await t.utxoUtils.batchProcess(
+    g,
+    n,
+    s
+  ), i = [...r, ...f];
+  return await U(t, e, c), E(
+    {
+      lastOutput: w,
+      encryptedOutputs: i
+    },
+    t,
+    e,
+    a
+  ), await t.utxoUtils.buildBatchProcess(i, s);
+}, R = async (t, s, e, c) => {
+  const {
+    utxos: a,
+    encryptedOutputs: u,
+    lastOutput: r
+  } = await S(t, e, s);
+  return E(
+    {
+      encryptedOutputs: u,
+      lastOutput: r
+    },
+    t,
+    e,
+    c
+  ), a;
+}, k = async (t, s, e, c, a, u, r, n, d) => {
+  try {
+    return await R(t, s, e, a);
+  } catch {
+    return b(
+      t,
+      s,
+      e,
+      c,
+      a,
+      u,
+      r,
+      n,
+      d
+    );
+  }
+}, F = (t) => {
+  if (Array.isArray(t))
+    return t;
+  if (t !== void 0)
+    return [t];
+}, H = async (t, s, e) => await t.utxoUtils.batchFilterUtxosWithNullifier(s, e), q = (t, s, e, c, a, u) => {
+  for (t.sort((r, n) => r.amount <= n.amount ? 1 : -1); t.length < s || t.length > s && t.length < 6; )
+    if (t.push(new P({ amount: 0n, erc20TokenAddress: a, shieldedPrivateKey: c, tokenId: u })), e)
+      for (; t.length > 6; )
+        t.splice(t.length - 1);
+}, G = async ({
+  hinkal: t,
+  chainId: s = void 0,
+  passedShieldedPublicKey: e = void 0,
+  ethAddress: c = void 0,
+  resetCacheBefore: a = !1,
+  allowRemoteDecryption: u = !1
+}) => {
+  if (!t.getCurrentChainId || !t.getSelectedNetwork())
+    return L.log("returning empty balance"), { inputUtxos: [] };
+  const r = c ?? await t.getEthereumAddress(), n = s ?? t.getCurrentChainId(), d = e ?? t.userKeys.getShieldedPublicKey(), { encryptedOutputs: g, nullifiers: w, userKeys: f } = t, i = Array.from(g);
+  a && K(t, n, d);
+  let { encryptedOutputs: p, lastOutput: o } = N(
+    t,
+    n,
+    d
+  );
+  await U(t, n, r);
+  const l = o !== "", y = i.findIndex((C) => C.value === o), x = y > -1, v = !l && y === -1, A = t.areMerkleTreeUpdatesDisabled(), O = !A && (x || !u && v), I = !A && u && v, h = !O && !I;
+  let m = [];
+  return O ? m = await b(
+    t,
+    f,
+    n,
+    r,
+    d,
+    i,
+    p,
+    o,
+    y
+  ) : I ? m = await k(
+    t,
+    f,
+    n,
+    r,
+    d,
+    i,
+    p,
+    o,
+    y
+  ) : h && (m = await t.utxoUtils.buildBatchProcess(p, f)), await U(t, n, r), { inputUtxos: await H(t, m, w) };
+}, X = async ({
+  hinkal: t,
+  tokenWithId: s,
+  minInput: e = 2,
+  sliceIfMore6: c = !0,
+  chainId: a = void 0,
+  passedShieldedPrivateKey: u = void 0,
+  passedShieldedPublicKey: r = void 0,
+  ethAddress: n = void 0,
+  resetCacheBefore: d = !1,
+  ensuredTokensWithId: g
+}) => {
+  const w = u ?? t.userKeys.getShieldedPrivateKey(), { inputUtxos: f } = await G({
+    hinkal: t,
+    minInput: e,
+    sliceIfMore6: c,
+    chainId: a,
+    passedShieldedPrivateKey: u,
+    passedShieldedPublicKey: r,
+    ethAddress: n,
+    resetCacheBefore: d
+  }), i = F(s), p = /* @__PURE__ */ new Map();
+  f.forEach((o) => {
+    if (i && !i.some(
+      (x) => B(x.erc20TokenAddress, o.erc20TokenAddress) && x.tokenId === o.tokenId
+    ))
+      return;
+    const l = T({ erc20TokenAddress: o.erc20TokenAddress, tokenId: o.tokenId }), y = p.get(l) ?? [];
+    p.set(l, [...y, o]);
+  }), g?.forEach((o) => {
+    const l = T({ erc20TokenAddress: o.erc20TokenAddress, tokenId: o.tokenId });
+    p.set(l, p.get(l) ?? []);
+  });
+  for (const [o, l] of p) {
+    const y = o.split("-")[0], x = Number(o.split("-")[1]);
+    q(l, e, c, w, y, x);
+  }
+  return p;
+};
+export {
+  k as attemptGetInputUtxosRemotely,
+  G as getInputUtxoAndBalance,
+  X as getInputUtxoAndBalancePerToken,
+  R as getInputUtxosRemotely
+};

package/functions/web3/events/getInputUtxosEnclave.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("ethers"),v=require("../../../data-structures/utxo/Utxo.cjs"),g=require("../../../data-structures/crypto-keys/keys.cjs"),U=require("../../utils/encryptInputForEnclave.cjs"),h=async(a,i,r)=>{const e=r.getShieldedPrivateKey(),{privateKey:o,publicKey:s}=g.UserKeys.getEncryptionKeyPair(e),c=n.ethers.utils.solidityPack(["uint256","uint256","uint256"],[s,o,e]),u=n.ethers.utils.arrayify(c),{keyCiphertext:d,inputCiphertext:l}=await U.makeEnclaveHandshakeAndEncryptUint8Array(u),{utxos:y,lastOutput:p,encryptedOutputs:x}=await a.getAPI().decryptUtxoEnclaveCall(i,d,l);return{utxos:y.map(t=>new v.Utxo({...t,amount:BigInt(t.amount),randomization:t.randomization?BigInt(t.randomization):void 0,shieldedPrivateKey:e})),encryptedOutputs:x,lastOutput:p}};exports.getInputUtxosEnclave=h;

package/functions/web3/events/getInputUtxosEnclave.d.ts

@@ -0,0 +1,8 @@
+import { type IHinkal } from '../../../data-structures/Hinkal/IHinkal';
+import { Utxo } from '../../../data-structures/utxo/Utxo';
+import { UserKeys } from '../../../data-structures/crypto-keys/keys';
+export declare const getInputUtxosEnclave: (hinkal: IHinkal, chainId: number, userKeys: UserKeys) => Promise<{
+    utxos: Utxo[];
+    encryptedOutputs: import('../../../index.ts').EncryptedOutputWithSign<boolean>[];
+    lastOutput: string;
+}>;

package/functions/web3/events/getInputUtxosEnclave.mjs

@@ -0,0 +1,25 @@
+import { ethers as i } from "ethers";
+import { Utxo as x } from "../../../data-structures/utxo/Utxo.mjs";
+import { UserKeys as v } from "../../../data-structures/crypto-keys/keys.mjs";
+import { makeEnclaveHandshakeAndEncryptUint8Array as U } from "../../utils/encryptInputForEnclave.mjs";
+const z = async (n, a, o) => {
+  const e = o.getShieldedPrivateKey(), { privateKey: r, publicKey: s } = v.getEncryptionKeyPair(e), c = i.utils.solidityPack(
+    ["uint256", "uint256", "uint256"],
+    [s, r, e]
+  ), p = i.utils.arrayify(c), { keyCiphertext: d, inputCiphertext: u } = await U(p), { utxos: y, lastOutput: l, encryptedOutputs: m } = await n.getAPI().decryptUtxoEnclaveCall(a, d, u);
+  return {
+    utxos: y.map(
+      (t) => new x({
+        ...t,
+        amount: BigInt(t.amount),
+        randomization: t.randomization ? BigInt(t.randomization) : void 0,
+        shieldedPrivateKey: e
+      })
+    ),
+    encryptedOutputs: m,
+    lastOutput: l
+  };
+};
+export {
+  z as getInputUtxosEnclave
+};

package/functions/web3/events/getShieldedBalance.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const x=require("../../utils/erc20tokenFunctions.cjs"),m=require("../../utils/caseInsensitive.utils.cjs"),w=require("../../../data-structures/utxo/Utxo.cjs"),A=require("../etherFunctions.cjs"),P=require("../../../error-handling/customErrors/ErrorWithAmount.cjs");require("../../../error-handling/error-codes.constants.cjs");const U=require("./getInputUtxoAndBalance.cjs"),p=require("../../../data-structures/TokenDBs/PrivateTokensDB.cjs"),y=require("../../../constants/vite.constants.cjs"),v=require("../../utils/encodeTokenWithId.cjs"),E=require("../../utils/mutexes.utils.cjs"),I=async(u,o,f,a,i,k=!1,g,d=!1)=>E.balanceFetchingMutex.runExclusive(async()=>{const{inputUtxos:s}=await U.getInputUtxoAndBalance({hinkal:u,sliceIfMore6:!1,chainId:o,passedShieldedPrivateKey:f,passedShieldedPublicKey:a,ethAddress:i,resetCacheBefore:k,allowRemoteDecryption:g});d&&y.isExtension&&await p.privateTokensDB.fetchAndUpdatePrivateTokens(s.map(e=>e.erc20TokenAddress),o,i);const l=(y.isExtension?await p.privateTokensDB.getPrivateTokens(o,i):x.getErc20TokensForChain(o)).map(e=>({token:e,balance:s.reduce((t,r)=>{const c=e.erc20TokenAddress;return m.caseInsensitiveEqual(c,r.erc20TokenAddress)?t+r.amount:t},0n),timestamp:s.filter(t=>m.caseInsensitiveEqual(t.erc20TokenAddress,e.erc20TokenAddress))[0]?.timeStamp,nfts:s.filter(t=>m.caseInsensitiveEqual(t.erc20TokenAddress,e.erc20TokenAddress)&&t.tokenId!==0).map(t=>({tokenId:t.tokenId,timestamp:t.timeStamp}))})),n=new Map;return l.forEach(e=>{n.set(e.token.erc20TokenAddress.toLowerCase(),e)}),n}),S=async(u,o,f,a=6,i=o.map(()=>0),k=!1)=>{const{userKeys:g}=u,d=[],s=[],h=await U.getInputUtxoAndBalancePerToken({hinkal:u,sliceIfMore6:!1,ensuredTokensWithId:o.map((n,e)=>({erc20TokenAddress:o[e],tokenId:i[e]})),allowRemoteDecryption:!1});let l=0;for(let n=0;n<o.length;n+=1)if(k===!1){const e=h.get(v.encodeTokenWithId({erc20TokenAddress:o[n],tokenId:i[n]}))??[];if(!e)throw new Error("Missing utxos for token");l=Math.max(e.length,l),s.push(e)}else s.push([]);return l===2?s:(s.forEach((n,e)=>{if(n.length>a){const t=n.slice(0,a),r=t.reduce((c,T)=>c+T.amount,0n);if(f[e]<0n&&r<-f[e]){const c=x.getERC20Token(o[e],u.getCurrentChainId()),T=Number(A.getAmountWithPrecision(r,c,2)),q=`Unfortunately your transaction did not go through due to UTXOs limitations. 
+ Please try again with ${c.symbol}`;throw new P.ErrorWithAmount(T,q)}d.push(t)}else if(n.length<=a){const t=[...n];let r=a-n.length;for(;r>0;)r-=1,t.push(new w.Utxo({amount:0n,erc20TokenAddress:o[e],shieldedPrivateKey:g.getShieldedPrivateKey(),tokenId:i[e]}));d.push(t)}}),d)};exports.addPaddingToUtxos=S;exports.getShieldedBalance=I;

package/functions/web3/events/getShieldedBalance.d.ts

@@ -0,0 +1,18 @@
+import { TokenBalance } from '../../../types/token.types';
+import { Utxo } from '../../../data-structures/utxo/Utxo';
+import { IHinkal } from '../../../data-structures/Hinkal/IHinkal';
+/**
+ *
+ * @param UserKeys to access user's encryption keys
+ * @returns shielded balance
+ */
+export declare const getShieldedBalance: (hinkal: IHinkal, chainId: number, passedShieldedPrivateKey: string, passedShieldedPublicKey: string, ethAddress: string, resetCacheBefore?: boolean, allowRemoteDecryption?: boolean, updateTokensListBefore?: boolean) => Promise<Map<string, TokenBalance>>;
+/**
+ *
+ * @param hinkal hinkal instance to get userKeys
+ * @param erc20Addresses array of erc20 tokens
+ * @param amountChanges array of token amounts
+ * @param maxInput to pad until maxInput number
+ * @returns return padded UTXOs for every erc20 token
+ */
+export declare const addPaddingToUtxos: (hinkal: IHinkal, erc20Addresses: string[], amountChanges: bigint[], maxInput?: number, tokenIds?: number[], forceEmptyUtxos?: boolean) => Promise<Utxo[][]>;

package/functions/web3/events/getShieldedBalance.mjs

@@ -0,0 +1,88 @@
+import { getErc20TokensForChain as A, getERC20Token as U } from "../../utils/erc20tokenFunctions.mjs";
+import { caseInsensitiveEqual as g } from "../../utils/caseInsensitive.utils.mjs";
+import { Utxo as x } from "../../../data-structures/utxo/Utxo.mjs";
+import { getAmountWithPrecision as P } from "../etherFunctions.mjs";
+import { ErrorWithAmount as E } from "../../../error-handling/customErrors/ErrorWithAmount.mjs";
+import "../../../error-handling/error-codes.constants.mjs";
+import { getInputUtxoAndBalance as I, getInputUtxoAndBalancePerToken as M } from "./getInputUtxoAndBalance.mjs";
+import { privateTokensDB as h } from "../../../data-structures/TokenDBs/PrivateTokensDB.mjs";
+import { isExtension as y } from "../../../constants/vite.constants.mjs";
+import { encodeTokenWithId as S } from "../../utils/encodeTokenWithId.mjs";
+import { balanceFetchingMutex as v } from "../../utils/mutexes.utils.mjs";
+const O = async (c, n, l, a, i, p = !1, u, d = !1) => v.runExclusive(async () => {
+  const { inputUtxos: r } = await I({
+    hinkal: c,
+    sliceIfMore6: !1,
+    chainId: n,
+    passedShieldedPrivateKey: l,
+    passedShieldedPublicKey: a,
+    ethAddress: i,
+    resetCacheBefore: p,
+    allowRemoteDecryption: u
+  });
+  d && y && await h.fetchAndUpdatePrivateTokens(
+    r.map((e) => e.erc20TokenAddress),
+    n,
+    i
+  );
+  const f = (y ? await h.getPrivateTokens(n, i) : A(n)).map((e) => ({
+    token: e,
+    balance: r.reduce((t, s) => {
+      const m = e.erc20TokenAddress;
+      return g(m, s.erc20TokenAddress) ? t + s.amount : t;
+    }, 0n),
+    timestamp: r.filter(
+      (t) => g(t.erc20TokenAddress, e.erc20TokenAddress)
+    )[0]?.timeStamp,
+    nfts: r.filter(
+      (t) => g(t.erc20TokenAddress, e.erc20TokenAddress) && t.tokenId !== 0
+    ).map((t) => ({ tokenId: t.tokenId, timestamp: t.timeStamp }))
+  })), o = /* @__PURE__ */ new Map();
+  return f.forEach((e) => {
+    o.set(e.token.erc20TokenAddress.toLowerCase(), e);
+  }), o;
+}), X = async (c, n, l, a = 6, i = n.map(() => 0), p = !1) => {
+  const { userKeys: u } = c, d = [], r = [], T = await M({
+    hinkal: c,
+    sliceIfMore6: !1,
+    ensuredTokensWithId: n.map((o, e) => ({ erc20TokenAddress: n[e], tokenId: i[e] })),
+    allowRemoteDecryption: !1
+  });
+  let f = 0;
+  for (let o = 0; o < n.length; o += 1)
+    if (p === !1) {
+      const e = T.get(S({ erc20TokenAddress: n[o], tokenId: i[o] })) ?? [];
+      if (!e)
+        throw new Error("Missing utxos for token");
+      f = Math.max(e.length, f), r.push(e);
+    } else
+      r.push([]);
+  return f === 2 ? r : (r.forEach((o, e) => {
+    if (o.length > a) {
+      const t = o.slice(0, a), s = t.reduce((m, k) => m + k.amount, 0n);
+      if (l[e] < 0n && s < -l[e]) {
+        const m = U(n[e], c.getCurrentChainId()), k = Number(P(s, m, 2)), w = `Unfortunately your transaction did not go through due to UTXOs limitations. 
+ Please try again with ${m.symbol}`;
+        throw new E(k, w);
+      }
+      d.push(t);
+    } else if (o.length <= a) {
+      const t = [...o];
+      let s = a - o.length;
+      for (; s > 0; )
+        s -= 1, t.push(
+          new x({
+            amount: 0n,
+            erc20TokenAddress: n[e],
+            shieldedPrivateKey: u.getShieldedPrivateKey(),
+            tokenId: i[e]
+          })
+        );
+      d.push(t);
+    }
+  }), d);
+};
+export {
+  X as addPaddingToUtxos,
+  O as getShieldedBalance
+};

package/functions/web3/events/getTransactionLogEvents.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("../../../constants/token-data/index.cjs");const c=require("../../../constants/chains.constants.cjs");require("../../../constants/contracts.constants.cjs");require("../../../constants/kyc.constants.cjs");require("../../../constants/server.constants.cjs");require("../../../constants/vite.constants.cjs");require("../../../constants/coingecko.constants.cjs");require("../../../constants/reorg-depths.constants.cjs");require("../../../constants/addresses.constants.cjs");require("../../../constants/token.limits.constants.cjs");require("../../../constants/presale.constants.cjs");require("../../../constants/mystery-boxes.constants.cjs");require("../../../constants/activity.constants.cjs");require("../../../constants/tasks.constants.cjs");require("../../../constants/events.constants.cjs");const a=require("ethers");require("idb-keyval");const q=require("../../utils/create-provider.cjs");require("../../../error-handling/error-codes.constants.cjs");require("../../utils/convertIntegrationProviderToExternalActionId.cjs");require("../../../types/circom-data.types.cjs");require("../../../types/transactions.types.cjs");require("../../../types/activities.types.cjs");require("circomlibjs-hinkal-fork");require("../../../data-structures/crypto-keys/keys.cjs");require("../../../data-structures/tor/TorClient.cjs");require("@hazae41/binary");require("@hazae41/cascade");require("../../../data-structures/tor/HttpClient.cjs");require("../../../API/getServerURL.cjs");require("../../utils/mutexes.utils.cjs");require("libsodium-wrappers");require("process");require("buffer");require("../../../constants/save-depths.cjs");require("../../utils/userAgent.cjs");require("multiformats");require("axios");require("../../../API/tenderly.api.cjs");const l=(o,n)=>{const u=new a.ethers.utils.Interface(n);try{const e=u.parseLog(o);return{name:e.name,args:e.args}}catch{return console.warn("Could not decode log"),null}};async function d(o,n,u,e){try{const t=c.networkRegistry[o].fetchRpcUrl;if(!t)throw new Error("RPC URL not found for the specified chain ID");const r=await q.createTorRpcProvider(t).getTransactionReceipt(n);if(!r)throw new Error("Transaction receipt not found");if(r.status!==1)throw new Error("Transaction failed");const s=r.logs.filter(i=>i.address.toLowerCase()===u.toLowerCase()).map(i=>l(i,e)).filter(i=>i!==null);return{transactionHash:r.transactionHash,from:r.from,to:r.to,blockNumber:r.blockNumber,events:s}}catch(t){throw console.error("Error retrieving transaction events:",t),t}}exports.getTransactionLogEvents=d;

package/functions/web3/events/getTransactionLogEvents.d.ts

@@ -0,0 +1,12 @@
+import { ethers } from 'ethers';
+import { Fragment, JsonFragment } from '@ethersproject/abi';
+export declare function getTransactionLogEvents(chainId: number, txHash: string, contractAddress: string, contractABI: string | readonly (string | Fragment | JsonFragment)[]): Promise<{
+    transactionHash: string;
+    from: string;
+    to: string;
+    blockNumber: number;
+    events: {
+        name: string;
+        args: ethers.utils.Result;
+    }[];
+}>;

package/functions/web3/events/getTransactionLogEvents.mjs

@@ -0,0 +1,76 @@
+import "../../../constants/token-data/index.mjs";
+import { networkRegistry as a } from "../../../constants/chains.constants.mjs";
+import "../../../constants/contracts.constants.mjs";
+import "../../../constants/kyc.constants.mjs";
+import "../../../constants/server.constants.mjs";
+import "../../../constants/vite.constants.mjs";
+import "../../../constants/coingecko.constants.mjs";
+import "../../../constants/reorg-depths.constants.mjs";
+import "../../../constants/addresses.constants.mjs";
+import "../../../constants/token.limits.constants.mjs";
+import "../../../constants/presale.constants.mjs";
+import "../../../constants/mystery-boxes.constants.mjs";
+import "../../../constants/activity.constants.mjs";
+import "../../../constants/tasks.constants.mjs";
+import "../../../constants/events.constants.mjs";
+import { ethers as s } from "ethers";
+import "idb-keyval";
+import { createTorRpcProvider as c } from "../../utils/create-provider.mjs";
+import "../../../error-handling/error-codes.constants.mjs";
+import "../../utils/convertIntegrationProviderToExternalActionId.mjs";
+import "../../../types/circom-data.types.mjs";
+import "../../../types/transactions.types.mjs";
+import "../../../types/activities.types.mjs";
+import "circomlibjs-hinkal-fork";
+import "../../../data-structures/crypto-keys/keys.mjs";
+import "../../../data-structures/tor/TorClient.mjs";
+import "@hazae41/binary";
+import "@hazae41/cascade";
+import "../../../data-structures/tor/HttpClient.mjs";
+import "../../../API/getServerURL.mjs";
+import "../../utils/mutexes.utils.mjs";
+import "libsodium-wrappers";
+import "process";
+import "buffer";
+import "../../../constants/save-depths.mjs";
+import "../../utils/userAgent.mjs";
+import "multiformats";
+import "axios";
+import "../../../API/tenderly.api.mjs";
+const f = (e, n) => {
+  const p = new s.utils.Interface(n);
+  try {
+    const o = p.parseLog(e);
+    return {
+      name: o.name,
+      args: o.args
+    };
+  } catch {
+    return console.warn("Could not decode log"), null;
+  }
+};
+async function _(e, n, p, o) {
+  try {
+    const t = a[e].fetchRpcUrl;
+    if (!t)
+      throw new Error("RPC URL not found for the specified chain ID");
+    const r = await c(t).getTransactionReceipt(n);
+    if (!r)
+      throw new Error("Transaction receipt not found");
+    if (r.status !== 1)
+      throw new Error("Transaction failed");
+    const m = r.logs.filter((i) => i.address.toLowerCase() === p.toLowerCase()).map((i) => f(i, o)).filter((i) => i !== null);
+    return {
+      transactionHash: r.transactionHash,
+      from: r.from,
+      to: r.to,
+      blockNumber: r.blockNumber,
+      events: m
+    };
+  } catch (t) {
+    throw console.error("Error retrieving transaction events:", t), t;
+  }
+}
+export {
+  _ as getTransactionLogEvents
+};

package/functions/web3/events/web3RetrieveEvents.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=async(e,s,...r)=>{if(!e.filters?.[s])throw new Error("Contract Event not found");return await e.queryFilter(e.filters?.[s](...r),39561411)},o=async(e,s)=>(await n(e,"NewTransaction")).map(t=>t.args[1]===s&&BigInt(t.args[2])>=0n?new Date(t.args[0]*1e3):new Date(0)).filter(t=>t.getTime()!==0);exports.getDepositEvents=o;exports.retrieveEvents=n;

package/functions/web3/events/web3RetrieveEvents.d.ts

@@ -0,0 +1,14 @@
+import { Contract, ethers } from 'ethers';
+/**
+ * to get contract events
+ * @param eventName to retrieve specific events
+ * @param eventArgs event arguments
+ * @returns array of the specific events
+ */
+export declare const retrieveEvents: (hinkalContract: ethers.Contract, eventName: string, ...eventArgs: unknown[]) => Promise<ethers.Event[]>;
+/**
+ *
+ * @param web3Provider instance to get hinkal contract
+ * @returns array of deposit timestamps in JS new Date format
+ */
+export declare const getDepositEvents: (hinkalContract: Contract, erc20TokenAddress: string) => Promise<Date[]>;

package/functions/web3/events/web3RetrieveEvents.mjs

@@ -0,0 +1,9 @@
+const i = async (e, s, ...n) => {
+  if (!e.filters?.[s])
+    throw new Error("Contract Event not found");
+  return await e.queryFilter(e.filters?.[s](...n), 39561411);
+}, o = async (e, s) => (await i(e, "NewTransaction")).map((t) => t.args[1] === s && BigInt(t.args[2]) >= 0n ? new Date(t.args[0] * 1e3) : /* @__PURE__ */ new Date(0)).filter((t) => t.getTime() !== 0);
+export {
+  o as getDepositEvents,
+  i as retrieveEvents
+};

package/functions/web3/functionCalls/accessTokenCalls.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("../../../types/circom-data.types.cjs");const n=require("../../../types/ethereum-network.types.cjs");require("../../../types/transactions.types.cjs");require("../../../types/activities.types.cjs");const r=async e=>(await e.getContractWithFetcher(n.ContractType.AccessTokenContract).functions.hasToken(e.userKeys.getAccessKey()))[0],a=async(e,t,c)=>{const s=e.getContractWithSigner(n.ContractType.AccessTokenContract),o={value:0n,...c&&{type:0}};return await s.addToken(t,o)};exports.checkHinkalAccessToken=r;exports.mintAccessToken=a;

package/functions/web3/functionCalls/accessTokenCalls.d.ts

@@ -0,0 +1,5 @@
+import { ethers } from 'ethers';
+import { IHinkal } from '../../../data-structures/Hinkal/IHinkal';
+import { SignatureData } from '../../../types';
+export declare const checkHinkalAccessToken: (hinkal: IHinkal) => Promise<any>;
+export declare const mintAccessToken: (hinkal: IHinkal, signatureData: SignatureData, fromWallet?: boolean) => Promise<ethers.ContractTransaction>;

package/functions/web3/functionCalls/accessTokenCalls.mjs

@@ -0,0 +1,15 @@
+import "../../../types/circom-data.types.mjs";
+import { ContractType as n } from "../../../types/ethereum-network.types.mjs";
+import "../../../types/transactions.types.mjs";
+import "../../../types/activities.types.mjs";
+const p = async (t) => (await t.getContractWithFetcher(n.AccessTokenContract).functions.hasToken(t.userKeys.getAccessKey()))[0], m = async (t, e, c) => {
+  const s = t.getContractWithSigner(n.AccessTokenContract), o = {
+    value: 0n,
+    ...c && { type: 0 }
+  };
+  return await s.addToken(e, o);
+};
+export {
+  p as checkHinkalAccessToken,
+  m as mintAccessToken
+};

package/functions/web3/functionCalls/approveToken.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("ethers"),f=require("../../../constants/chains.constants.cjs"),T=require("../../../constants/protocol.constants.cjs"),d=require("../../../types/token.types.cjs"),l=require("../../../types/ethereum-network.types.cjs"),A=async(e,n,s)=>{const t=BigInt(await s.allowance(await s.signer.getAddress(),n.address));return e===t},I=async(e,n,s,t)=>{if(f.getNonLocalhostChainId(e.getCurrentChainId())!==f.chainIds.ethMainnet||s.symbol.toLowerCase()!=="usdt"||BigInt(await t.allowance(await t.signer.getAddress(),n.address))===0n)return;const i=await t.approve(n.address,0n);i&&"hash"in i&&await e.waitForTransaction(i.hash)},b=async(e,n,s,t)=>{const o=e.getContractWithSigner(l.ContractType.ERC20Contract,t.erc20TokenAddress),i=t.approvalType??d.ApprovalType.Classic;if(i===d.ApprovalType.Classic||!e.isPermitterAvailable()){if(await A(s,n,o))return;await I(e,n,t,o);const p=await o.approve(n.address,s);p&&"hash"in p&&await e.waitForTransaction(p.hash);return}const c=await e.getEthereumAddress(),v=e.getContract(l.ContractType.PermitterContract),g=await e.getContractWithFetcher(l.ContractType.ContractWithNonces,t.erc20TokenAddress).nonces(c),u=BigInt(Date.now()+T.permitSignatureValidFor)/1000n,r={owner:c,holder:c,spender:v.address,value:s,nonce:g,deadline:u,expiry:u,allowed:!0},{v:y,r:w,s:h}=a.ethers.utils.splitSignature(await e.signTypedData({name:await o.name(),chainId:e.getCurrentChainId(),version:"1",verifyingContract:t.erc20TokenAddress},{Permit:i===d.ApprovalType.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"}]},r));if(i===d.ApprovalType.ERC20Permit){const m=new a.ethers.utils.Interface(["function permit(address owner,address spender,uint256 value,uint256 deadline,uint8 v,bytes32 r,bytes32 s) external"]);return a.ethers.utils.arrayify(m.encodeFunctionData("permit",[r.owner,r.spender,r.value,r.deadline,y,a.ethers.utils.arrayify(w),a.ethers.utils.arrayify(h)])).slice(4)}const C=new a.ethers.utils.Interface(["function permit(address holder,address spender,uint256 nonce,uint256 expiry,bool allowed,uint8 v,bytes32 r,bytes32 s) external"]);return a.ethers.utils.arrayify(C.encodeFunctionData("permit",[r.holder,r.spender,r.nonce,r.expiry,r.allowed,y,a.ethers.utils.arrayify(w),a.ethers.utils.arrayify(h)])).slice(4)};exports.approveTokenToHinkal=b;

package/functions/web3/functionCalls/approveToken.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 approveTokenToHinkal: (hinkal: IHinkal, contractToApprove: ethers.Contract, amount: bigint, token: ERC20Token) => Promise<Uint8Array | undefined>;