@sabaaa1/common 0.2.16

package/constants/token-data/popularTokens.constants.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=[{symbol:"hETH"},{symbol:"BNB"},{symbol:"DAI"},{symbol:"ETH"},{symbol:"MATIC"},{symbol:"USDC"},{symbol:"USDT"},{symbol:"WETH"},{symbol:"stETH"}];exports.PopularTokenSymbols=o;

package/constants/token-data/popularTokens.constants.d.ts

@@ -0,0 +1,3 @@
+export declare const PopularTokenSymbols: {
+    symbol: string;
+}[];

package/constants/token-data/popularTokens.constants.mjs

@@ -0,0 +1,14 @@
+const o = [
+  { symbol: "hETH" },
+  { symbol: "BNB" },
+  { symbol: "DAI" },
+  { symbol: "ETH" },
+  { symbol: "MATIC" },
+  { symbol: "USDC" },
+  { symbol: "USDT" },
+  { symbol: "WETH" },
+  { symbol: "stETH" }
+];
+export {
+  o as PopularTokenSymbols
+};

package/constants/token-data/tokenPricing.consts.d.ts

@@ -0,0 +1,2 @@
+export declare const urlForBeefyVaultTokens = "https://api.beefy.finance/vaults";
+export declare const urlForBeefyVaultLpTokens = "https://api.beefy.finance/lps";

package/constants/token.limits.constants.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=require("../functions/web3/etherFunctions.cjs"),u=require("../functions/utils/erc20tokenFunctions.cjs"),l=require("./chains.constants.cjs"),n={[l.chainIds.optimism]:{ETH:"0.5",WETH:"0.5",rETH:"0.5",USDC:"1000","USDC.e":"1000",USDT:"1000",DAI:"1000",WBTC:"0.0125"}},g=e=>{if(!(e in n))return{erc20Addresses:[],limits:[]};const o=Object.entries(n[e]),i=[],r=[];for(let t=0;t<o.length;t+=1){const[c,T]=o[t],s=u.getERC20TokenBySymbol(c,e);if(!s)throw Error("no token in getTokenLimit");i.push(s.erc20TokenAddress),r.push(m.getAmountInWei(s,T))}return{erc20Addresses:i,limits:r}};exports.TOKEN_LIMITS=n;exports.getTokensLimits=g;

package/constants/token.limits.constants.d.ts

@@ -0,0 +1,5 @@
+export declare const TOKEN_LIMITS: Record<number, Record<string, string>>;
+export declare const getTokensLimits: (chainId: number) => {
+    erc20Addresses: string[];
+    limits: bigint[];
+};

package/constants/token.limits.constants.mjs

@@ -0,0 +1,30 @@
+import { getAmountInWei as T } from "../functions/web3/etherFunctions.mjs";
+import { getERC20TokenBySymbol as l } from "../functions/utils/erc20tokenFunctions.mjs";
+import { chainIds as p } from "./chains.constants.mjs";
+const n = {
+  [p.optimism]: {
+    ETH: "0.5",
+    WETH: "0.5",
+    rETH: "0.5",
+    USDC: "1000",
+    "USDC.e": "1000",
+    USDT: "1000",
+    DAI: "1000",
+    WBTC: "0.0125"
+  }
+}, d = (t) => {
+  if (!(t in n))
+    return { erc20Addresses: [], limits: [] };
+  const s = Object.entries(n[t]), r = [], i = [];
+  for (let e = 0; e < s.length; e += 1) {
+    const [m, c] = s[e], o = l(m, t);
+    if (!o)
+      throw Error("no token in getTokenLimit");
+    r.push(o.erc20TokenAddress), i.push(T(o, c));
+  }
+  return { erc20Addresses: r, limits: i };
+};
+export {
+  n as TOKEN_LIMITS,
+  d as getTokensLimits
+};

package/constants/vite.constants.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("../functions/utils/enum.utils.cjs");var t=(e=>(e.DEVELOPMENT="development",e.PLAYGROUND="playground",e.PRODUCTION="production",e.STAGING="staging",e))(t||{});const i={development:["localhost","192.","127."],playground:["playground"],staging:["working","staging"]},r=typeof process<"u"&&process?.release?.name==="node",u=typeof process<"u"&&process.versions!=null&&process.versions.node!=null,y=!u&&typeof window<"u"&&window.origin==="null",m=typeof __webpack_require__<"u",f=typeof window<"u"&&window?.location?.protocol==="chrome-extension:";function s(e,o){return o.some(g=>e.includes(g))}const v=()=>(require("dotenv").config({path:"DOTENV_OVERRIDE"in process.env?process.env.DOTENV_OVERRIDE:void 0}),d.toEnumValue(t,process.env.DEPLOYMENT_MODE)||"development"),w=()=>{if(!r&&typeof window>"u")return;if(r)return v();if(window?.location?.protocol==="chrome-extension:"){const o=d.toEnumValue(t,WALLET_DEPLOYMENT_MODE);return o||"staging"}const e=window?.location?.host;return s(e,i.development)?"development":s(e,i.playground)?"playground":s(e,i.staging)?"staging":"production"},n=w(),c=n==="development",l=n==="playground",p=n==="staging",a=p||c||l,E=a||r&&n==="production";exports.DEPLOYMENT_MODE=t;exports.deploymentMode=n;exports.isDevelopment=c;exports.isExtension=f;exports.isNode=u;exports.isNotClientProduction=E;exports.isNotProduction=a;exports.isPlayground=l;exports.isSandbox=y;exports.isStaging=p;exports.isWebpack=m;

package/constants/vite.constants.d.ts

@@ -0,0 +1,16 @@
+export declare enum DEPLOYMENT_MODE {
+    DEVELOPMENT = "development",
+    PLAYGROUND = "playground",
+    PRODUCTION = "production",
+    STAGING = "staging"
+}
+export declare const isNode: boolean;
+export declare const isSandbox: boolean;
+export declare const isWebpack: boolean;
+export declare const isExtension: boolean;
+export declare const deploymentMode: DEPLOYMENT_MODE | undefined;
+export declare const isDevelopment: boolean;
+export declare const isPlayground: boolean;
+export declare const isStaging: boolean;
+export declare const isNotProduction: boolean;
+export declare const isNotClientProduction: boolean;

package/constants/vite.constants.mjs

@@ -0,0 +1,38 @@
+import { toEnumValue as d } from "../functions/utils/enum.utils.mjs";
+var s = /* @__PURE__ */ ((e) => (e.DEVELOPMENT = "development", e.PLAYGROUND = "playground", e.PRODUCTION = "production", e.STAGING = "staging", e))(s || {});
+const t = {
+  development: ["localhost", "192.", "127."],
+  playground: ["playground"],
+  staging: ["working", "staging"]
+}, r = typeof process < "u" && process?.release?.name === "node", p = typeof process < "u" && process.versions != null && process.versions.node != null, v = !p && typeof window < "u" && window.origin === "null", w = typeof __webpack_require__ < "u", D = typeof window < "u" && window?.location?.protocol === "chrome-extension:";
+function i(e, n) {
+  return n.some((c) => e.includes(c));
+}
+const u = () => (require("dotenv").config({
+  // allow overriding .env file path, see startServer.sh script for explenation on why it is needed
+  path: "DOTENV_OVERRIDE" in process.env ? process.env.DOTENV_OVERRIDE : void 0
+}), d(s, process.env.DEPLOYMENT_MODE) || "development"), l = () => {
+  if (!r && typeof window > "u")
+    return;
+  if (r)
+    return u();
+  if (window?.location?.protocol === "chrome-extension:") {
+    const n = d(s, WALLET_DEPLOYMENT_MODE);
+    return n || "staging";
+  }
+  const e = window?.location?.host;
+  return i(e, t.development) ? "development" : i(e, t.playground) ? "playground" : i(e, t.staging) ? "staging" : "production";
+}, o = l(), g = o === "development", a = o === "playground", f = o === "staging", m = f || g || a, E = m || r && o === "production";
+export {
+  s as DEPLOYMENT_MODE,
+  o as deploymentMode,
+  g as isDevelopment,
+  D as isExtension,
+  p as isNode,
+  E as isNotClientProduction,
+  m as isNotProduction,
+  a as isPlayground,
+  v as isSandbox,
+  f as isStaging,
+  w as isWebpack
+};

package/constants/wallet.constants.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t={mpcVault:"MPCVault - Multisig Wallet",utila:"UtilaWallet"},l={mpcVault:"com.mpcvault.console"};exports.UNSUPPORTED_WALLETS_WALLETCONNECT_NAMES=t;exports.UNSUPPORTED_WALLET_IDS=l;

package/constants/wallet.constants.d.ts

@@ -0,0 +1,7 @@
+export declare const UNSUPPORTED_WALLETS_WALLETCONNECT_NAMES: {
+    mpcVault: string;
+    utila: string;
+};
+export declare const UNSUPPORTED_WALLET_IDS: {
+    mpcVault: string;
+};

package/constants/wallet.constants.mjs

@@ -0,0 +1,10 @@
+const l = {
+  mpcVault: "MPCVault - Multisig Wallet",
+  utila: "UtilaWallet"
+}, t = {
+  mpcVault: "com.mpcvault.console"
+};
+export {
+  l as UNSUPPORTED_WALLETS_WALLETCONNECT_NAMES,
+  t as UNSUPPORTED_WALLET_IDS
+};

package/crypto/babyJub.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("circomlibjs-hinkal-fork");class e{babyjub=void 0;async init(){this.babyjub||(this.babyjub=await t.buildBabyjub())}getJub(){return this.babyjub}}const b=new e,u=()=>b.getJub();exports.babyJubInstance=u;exports.jubHolder=b;

package/crypto/babyJub.d.ts

@@ -0,0 +1,16 @@
+declare class JubHolder {
+    private babyjub;
+    init(): Promise<void>;
+    getJub(): any;
+}
+export declare const jubHolder: JubHolder;
+export declare const babyJubInstance: () => any;
+export type JubPoint = [bigint, bigint];
+export interface BabyJubType {
+    mulPointEscalar: (point: [Uint8Array, Uint8Array], s: bigint) => [Uint8Array, Uint8Array];
+    F: {
+        toString: (arr: Uint8Array) => string;
+    };
+    Base8: [Uint8Array, Uint8Array];
+}
+export {};

package/crypto/babyJub.mjs

@@ -0,0 +1,15 @@
+import { buildBabyjub as b } from "circomlibjs-hinkal-fork";
+class t {
+  babyjub = void 0;
+  async init() {
+    this.babyjub || (this.babyjub = await b());
+  }
+  getJub() {
+    return this.babyjub;
+  }
+}
+const u = new t(), e = () => u.getJub();
+export {
+  e as babyJubInstance,
+  u as jubHolder
+};

package/crypto/index.d.ts

@@ -0,0 +1,3 @@
+export * from './poseidon';
+export * from './babyJub';
+export * from './preProcessing';

package/crypto/poseidon.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("ethers"),t=require("../functions/utils/amounts.utils.cjs"),s=require("circomlibjs-hinkal-fork");class r{poseidon=void 0;async init(){this.poseidon||(this.poseidon=await s.buildPoseidon())}getPoseidon(){return this.poseidon}}const n=new r;function d(...e){const o=n.getPoseidon();return t.toBigInt(o.F.toString(o(e)))}const u=(...e)=>{const o=n.getPoseidon();return i.BigNumber.from(o.F.toString(o([...e]))).toHexString()};exports.poseidonFunction=d;exports.poseidonHash=u;exports.poseidonHolder=n;

package/crypto/poseidon.d.ts

@@ -0,0 +1,15 @@
+declare class PoseidonHolder {
+    private poseidon;
+    init(): Promise<void>;
+    getPoseidon(): any;
+}
+export declare const poseidonHolder: PoseidonHolder;
+export declare function poseidonFunction<T = any>(...args: T[]): bigint;
+/**
+ * hashing algorithm implementation
+ * @param args rest parameter to take unlimited number of arguments
+ * @returns poseidon hash in base 16
+ */
+export declare const poseidonHash: (...args: unknown[]) => string;
+export type PoseidonHasher = (...args: unknown[]) => string;
+export {};

package/crypto/poseidon.mjs

@@ -0,0 +1,26 @@
+import { BigNumber as t } from "ethers";
+import { toBigInt as e } from "../functions/utils/amounts.utils.mjs";
+import { buildPoseidon as s } from "circomlibjs-hinkal-fork";
+class r {
+  poseidon = void 0;
+  async init() {
+    this.poseidon || (this.poseidon = await s());
+  }
+  getPoseidon() {
+    return this.poseidon;
+  }
+}
+const n = new r();
+function g(...i) {
+  const o = n.getPoseidon();
+  return e(o.F.toString(o(i)));
+}
+const m = (...i) => {
+  const o = n.getPoseidon();
+  return t.from(o.F.toString(o([...i]))).toHexString();
+};
+export {
+  g as poseidonFunction,
+  m as poseidonHash,
+  n as poseidonHolder
+};

package/crypto/preProcessing.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./babyJub.cjs"),o=require("./poseidon.cjs"),i=require("libsodium-wrappers"),r=require("process"),n=require("buffer"),s=async()=>{(typeof window<"u"||typeof self<"u")&&(typeof window<"u"&&(window.global=window),globalThis.Buffer=n.Buffer,globalThis.process=r),await Promise.all([i.ready,o.poseidonHolder.init(),e.jubHolder.init()])};exports.preProcessing=s;

package/crypto/preProcessing.d.ts

@@ -0,0 +1 @@
+export declare const preProcessing: () => Promise<void>;

package/crypto/preProcessing.mjs

@@ -0,0 +1,11 @@
+import { jubHolder as o } from "./babyJub.mjs";
+import { poseidonHolder as i } from "./poseidon.mjs";
+import e from "libsodium-wrappers";
+import r from "process";
+import { Buffer as f } from "buffer";
+const m = async () => {
+  (typeof window < "u" || typeof self < "u") && (typeof window < "u" && (window.global = window), globalThis.Buffer = f, globalThis.process = r), await Promise.all([e.ready, i.init(), o.init()]);
+};
+export {
+  m as preProcessing
+};

package/data-structures/ApprovalDBs/EventsPublicApprovalsDB.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const S=require("ethers"),w=require("idb-keyval"),T=require("async-mutex"),h=require("../../constants/chains.constants.cjs"),P=require("../../error-handling/logger.cjs"),L=require("../../functions/utils/string.utils.cjs"),I=require("../../types/cache.types.cjs"),q=require("../tor/HttpClient.cjs"),x=require("../../API/API.cjs"),f=require("../../types/approvals.types.cjs"),R=require("../../functions/utils/erc20tokenFunctions.cjs"),M=require("../../functions/utils/create-provider.cjs"),$=require("../../constants/events.constants.cjs"),m=require("../../functions/utils/caseInsensitive.utils.cjs"),_=require("../../constants/protocol.constants.cjs");class B{updateMutexes={};approvalTopic=S.ethers.utils.id("Approval(address,address,uint256)");approvalForAllTopic=S.ethers.utils.id("ApprovalForAll(address,address,bool)");getApprovedSelector=S.ethers.utils.id("getApproved(uint256)").substring(0,10);isApprovedForAllSelector=S.ethers.utils.id("isApprovedForAll(address,address)").substring(0,10);ALCHEMY_URLS={[h.chainIds.ethMainnet]:"eth-mainnet",[h.chainIds.polygon]:"polygon-mainnet",[h.chainIds.arbMainnet]:"arb-mainnet",[h.chainIds.optimism]:"opt-mainnet",[h.chainIds.base]:"base-mainnet",[h.chainIds.arcTestnet]:"arc-testnet",[h.chainIds.avalanche]:"avax-mainnet"};getMutex(t){return this.updateMutexes[t]||(this.updateMutexes[t]=new T.Mutex),this.updateMutexes[t]}getAlchemyUrl(t){const s=this.ALCHEMY_URLS[t];if(!s)throw new Error(`Unsupported chainId for Alchemy: ${t}`);return`https://${s}.g.alchemy.com/v2/${h.ALCHEMY_API_KEY}`}async getApprovals(t,s){const r=L.getStateKey(s,t);return(await w.get(I.StorageKeys.EVENTS_PUBLIC_APPROVALS))?.[r]||[]}async getLastProcessedBlock(t,s){const r=await w.get(I.StorageKeys.PUBLIC_APPROVALS_LAST_PROCESSED_BLOCKS)||{},d=L.getStateKey(s,t);return r[d]||$.EVENTS_INITIAL_BLOCKS[t]}async updateLastProcessedBlock(t,s,r){await w.update(I.StorageKeys.PUBLIC_APPROVALS_LAST_PROCESSED_BLOCKS,(d={})=>{const p=L.getStateKey(s,t);return{...d,[p]:r}})}async getApprovalEvents(t,s){try{const{fetchRpcUrl:r}=h.networkRegistry[s];if(!r)throw Error("No fetchRpcUrl in EventsPublicApprovalsDB");const d=M.createTorRpcProvider(r),p=await this.getLastProcessedBlock(s,t)+1,l=await d.getBlockNumber();if(p>l)return{approvalEvents:[],latestBlock:l};const E=S.ethers.utils.hexZeroPad(t.toLowerCase(),32),c={topics:[[this.approvalTopic,this.approvalForAllTopic],E],fromBlock:p,toBlock:l};return{approvalEvents:await d.getLogs(c),latestBlock:l}}catch(r){return P.Logger.error("Failed to fetch approval events",r),{approvalEvents:[],latestBlock:void 0}}}async checkCurrentAllowances(t,s,r){const d=this.getAlchemyUrl(t),p=`0x${s.substring(2).padStart(64,"0")}`,l=[...new Set(r.map(e=>e.contractAddress))],E=(await x.API.tokensInfoCall(t,l)).filter(e=>!!e),c=new Map(E.map(e=>[e.erc20TokenAddress.toLowerCase(),e])),i=[],k=[];if(r.forEach((e,o)=>{const a=c.get(e.contractAddress.toLowerCase());if(a)if(!R.isNFTToken(a))i.push({jsonrpc:"2.0",id:i.length,method:"alchemy_getTokenAllowance",params:[{contract:e.contractAddress,owner:s,spender:e.spenderAddress}]}),k.push({pairIndex:o,type:f.RevokeType.ERC20});else{const v=`0x${e.spenderAddress.substring(2).padStart(64,"0")}`,y=`${this.isApprovedForAllSelector}${p.substring(2)}${v.substring(2)}`;i.push({jsonrpc:"2.0",id:i.length,method:"eth_call",params:[{to:e.contractAddress,data:y},"latest"]}),k.push({pairIndex:o,type:f.RevokeType.approvedForAll}),e.tokenIds&&e.tokenIds.size>0&&e.tokenIds.forEach(g=>{const C=S.ethers.BigNumber.from(g).toHexString().substring(2).padStart(64,"0"),b=`${this.getApprovedSelector}${C}`;i.push({jsonrpc:"2.0",id:i.length,method:"eth_call",params:[{to:e.contractAddress,data:b},"latest"]}),k.push({pairIndex:o,type:f.RevokeType.tokenId,tokenId:g})})}}),i.length===0)return[];const n=await q.httpClient.post(d,i),u=[],A=new Set;return n.forEach((e,o)=>{const a=k[o];if(!a)return;const v=r[a.pairIndex],y=c.get(v.contractAddress.toLowerCase());if(!(!y||m.caseInsensitiveEqual(v.spenderAddress,_.zeroAddress))&&!e?.error&&e?.result&&e.result!=="0x")try{if(a.type===f.RevokeType.ERC20&&BigInt(e.result)>0n)u.push({token:y,spenderAddress:v.spenderAddress,allowance:BigInt(e.result)});else if(a.type===f.RevokeType.approvedForAll&&BigInt(e.result)===1n)A.add(a.pairIndex),u.push({token:y,spenderAddress:v.spenderAddress,allowance:1n});else if(a.type===f.RevokeType.tokenId&&!A.has(a.pairIndex)){const g=`0x${e.result.substring(26)}`.toLowerCase();!m.caseInsensitiveEqual(g,_.zeroAddress)&&m.caseInsensitiveEqual(g,v.spenderAddress)&&u.push({token:y,spenderAddress:v.spenderAddress,allowance:1n,tokenId:a.tokenId})}}catch(g){P.Logger.error("Error processing approval response",g)}}),u}async fetchAndUpdatePublicApprovals(t,s){const r=L.getStateKey(t,s);await this.getMutex(r).runExclusive(async()=>{try{const{approvalEvents:p,latestBlock:l}=await this.getApprovalEvents(t,s);if(!l)return;const E=await this.getApprovals(s,t),c=new Map;if(E.forEach(n=>{const u=n.token.erc20TokenAddress.toLowerCase(),A=n.spenderAddress.toLowerCase(),e=`${u}_${A}`;let o=c.get(e);o||(o={contractAddress:u,spenderAddress:A,tokenIds:new Set},c.set(e,o)),n.tokenId&&o.tokenIds&&o.tokenIds.add(n.tokenId)}),p.forEach(n=>{if(!n.topics[2])return;const u=n.address.toLowerCase(),A=`0x${n.topics[2].substring(26)}`.toLowerCase();if(m.caseInsensitiveEqual(A,_.zeroAddress))return;const e=`${u}_${A}`;let o=c.get(e);if(o||(o={contractAddress:u,spenderAddress:A,tokenIds:new Set},c.set(e,o)),n.topics.length===4&&o.tokenIds){const a=BigInt(n.topics[3]).toString();o.tokenIds.add(a)}}),c.size===0){await this.updateLastProcessedBlock(s,t,l);return}const i=Array.from(c.values()),k=await this.checkCurrentAllowances(s,t,i);await w.update(I.StorageKeys.EVENTS_PUBLIC_APPROVALS,(n={})=>({...n,[r]:k})),await this.updateLastProcessedBlock(s,t,l)}catch(p){P.Logger.error("Failed to sync approvals",p)}})}}const K=new B;exports.EventsPublicApprovalsDB=B;exports.eventsPublicApprovalsDB=K;

package/data-structures/ApprovalDBs/EventsPublicApprovalsDB.d.ts

@@ -0,0 +1,18 @@
+import { TokenApproval } from '../../types/approvals.types';
+export declare class EventsPublicApprovalsDB {
+    private updateMutexes;
+    private readonly approvalTopic;
+    private readonly approvalForAllTopic;
+    private readonly getApprovedSelector;
+    private readonly isApprovedForAllSelector;
+    private readonly ALCHEMY_URLS;
+    private getMutex;
+    private getAlchemyUrl;
+    getApprovals(chainId: number, walletAddress: string): Promise<TokenApproval[]>;
+    private getLastProcessedBlock;
+    private updateLastProcessedBlock;
+    private getApprovalEvents;
+    private checkCurrentAllowances;
+    fetchAndUpdatePublicApprovals(walletAddress: string, chainId: number): Promise<void>;
+}
+export declare const eventsPublicApprovalsDB: EventsPublicApprovalsDB;

package/data-structures/ApprovalDBs/EventsPublicApprovalsDB.mjs

@@ -0,0 +1,175 @@
+import { ethers as k } from "ethers";
+import { get as P, update as I } from "idb-keyval";
+import { Mutex as b } from "async-mutex";
+import { chainIds as f, ALCHEMY_API_KEY as T, networkRegistry as M } from "../../constants/chains.constants.mjs";
+import { Logger as B } from "../../error-handling/logger.mjs";
+import { getStateKey as L } from "../../functions/utils/string.utils.mjs";
+import { StorageKeys as S } from "../../types/cache.types.mjs";
+import { httpClient as R } from "../tor/HttpClient.mjs";
+import { API as $ } from "../../API/API.mjs";
+import { RevokeType as w } from "../../types/approvals.types.mjs";
+import { isNFTToken as U } from "../../functions/utils/erc20tokenFunctions.mjs";
+import { createTorRpcProvider as F } from "../../functions/utils/create-provider.mjs";
+import { EVENTS_INITIAL_BLOCKS as O } from "../../constants/events.constants.mjs";
+import { caseInsensitiveEqual as y } from "../../functions/utils/caseInsensitive.utils.mjs";
+import { zeroAddress as C } from "../../constants/protocol.constants.mjs";
+class N {
+  updateMutexes = {};
+  approvalTopic = k.utils.id("Approval(address,address,uint256)");
+  approvalForAllTopic = k.utils.id("ApprovalForAll(address,address,bool)");
+  getApprovedSelector = k.utils.id("getApproved(uint256)").substring(0, 10);
+  isApprovedForAllSelector = k.utils.id("isApprovedForAll(address,address)").substring(0, 10);
+  ALCHEMY_URLS = {
+    [f.ethMainnet]: "eth-mainnet",
+    [f.polygon]: "polygon-mainnet",
+    [f.arbMainnet]: "arb-mainnet",
+    [f.optimism]: "opt-mainnet",
+    [f.base]: "base-mainnet",
+    [f.arcTestnet]: "arc-testnet",
+    [f.avalanche]: "avax-mainnet"
+  };
+  getMutex(e) {
+    return this.updateMutexes[e] || (this.updateMutexes[e] = new b()), this.updateMutexes[e];
+  }
+  getAlchemyUrl(e) {
+    const s = this.ALCHEMY_URLS[e];
+    if (!s)
+      throw new Error(`Unsupported chainId for Alchemy: ${e}`);
+    return `https://${s}.g.alchemy.com/v2/${T}`;
+  }
+  async getApprovals(e, s) {
+    const r = L(s, e);
+    return (await P(S.EVENTS_PUBLIC_APPROVALS))?.[r] || [];
+  }
+  async getLastProcessedBlock(e, s) {
+    const r = await P(S.PUBLIC_APPROVALS_LAST_PROCESSED_BLOCKS) || {}, d = L(s, e);
+    return r[d] || O[e];
+  }
+  async updateLastProcessedBlock(e, s, r) {
+    await I(S.PUBLIC_APPROVALS_LAST_PROCESSED_BLOCKS, (d = {}) => {
+      const i = L(s, e);
+      return {
+        ...d,
+        [i]: r
+      };
+    });
+  }
+  async getApprovalEvents(e, s) {
+    try {
+      const { fetchRpcUrl: r } = M[s];
+      if (!r)
+        throw Error("No fetchRpcUrl in EventsPublicApprovalsDB");
+      const d = F(r), i = await this.getLastProcessedBlock(s, e) + 1, l = await d.getBlockNumber();
+      if (i > l)
+        return { approvalEvents: [], latestBlock: l };
+      const E = k.utils.hexZeroPad(e.toLowerCase(), 32), p = {
+        topics: [[this.approvalTopic, this.approvalForAllTopic], E],
+        fromBlock: i,
+        toBlock: l
+      };
+      return { approvalEvents: await d.getLogs(p), latestBlock: l };
+    } catch (r) {
+      return B.error("Failed to fetch approval events", r), { approvalEvents: [], latestBlock: void 0 };
+    }
+  }
+  async checkCurrentAllowances(e, s, r) {
+    const d = this.getAlchemyUrl(e), i = `0x${s.substring(2).padStart(64, "0")}`, l = [...new Set(r.map((t) => t.contractAddress))], E = (await $.tokensInfoCall(e, l)).filter((t) => !!t), p = new Map(E.map((t) => [t.erc20TokenAddress.toLowerCase(), t])), c = [], v = [];
+    if (r.forEach((t, o) => {
+      const a = p.get(t.contractAddress.toLowerCase());
+      if (a)
+        if (!U(a))
+          c.push({
+            jsonrpc: "2.0",
+            id: c.length,
+            method: "alchemy_getTokenAllowance",
+            params: [{ contract: t.contractAddress, owner: s, spender: t.spenderAddress }]
+          }), v.push({ pairIndex: o, type: w.ERC20 });
+        else {
+          const m = `0x${t.spenderAddress.substring(2).padStart(64, "0")}`, g = `${this.isApprovedForAllSelector}${i.substring(2)}${m.substring(2)}`;
+          c.push({
+            jsonrpc: "2.0",
+            id: c.length,
+            method: "eth_call",
+            params: [{ to: t.contractAddress, data: g }, "latest"]
+          }), v.push({ pairIndex: o, type: w.approvedForAll }), t.tokenIds && t.tokenIds.size > 0 && t.tokenIds.forEach((h) => {
+            const _ = k.BigNumber.from(h).toHexString().substring(2).padStart(64, "0"), x = `${this.getApprovedSelector}${_}`;
+            c.push({
+              jsonrpc: "2.0",
+              id: c.length,
+              method: "eth_call",
+              params: [{ to: t.contractAddress, data: x }, "latest"]
+            }), v.push({ pairIndex: o, type: w.tokenId, tokenId: h });
+          });
+        }
+    }), c.length === 0)
+      return [];
+    const n = await R.post(d, c), u = [], A = /* @__PURE__ */ new Set();
+    return n.forEach((t, o) => {
+      const a = v[o];
+      if (!a)
+        return;
+      const m = r[a.pairIndex], g = p.get(m.contractAddress.toLowerCase());
+      if (!(!g || y(m.spenderAddress, C)) && !t?.error && t?.result && t.result !== "0x")
+        try {
+          if (a.type === w.ERC20 && BigInt(t.result) > 0n)
+            u.push({ token: g, spenderAddress: m.spenderAddress, allowance: BigInt(t.result) });
+          else if (a.type === w.approvedForAll && BigInt(t.result) === 1n)
+            A.add(a.pairIndex), u.push({ token: g, spenderAddress: m.spenderAddress, allowance: 1n });
+          else if (a.type === w.tokenId && !A.has(a.pairIndex)) {
+            const h = `0x${t.result.substring(26)}`.toLowerCase();
+            !y(h, C) && y(h, m.spenderAddress) && u.push({
+              token: g,
+              spenderAddress: m.spenderAddress,
+              allowance: 1n,
+              tokenId: a.tokenId
+            });
+          }
+        } catch (h) {
+          B.error("Error processing approval response", h);
+        }
+    }), u;
+  }
+  async fetchAndUpdatePublicApprovals(e, s) {
+    const r = L(e, s);
+    await this.getMutex(r).runExclusive(async () => {
+      try {
+        const { approvalEvents: i, latestBlock: l } = await this.getApprovalEvents(e, s);
+        if (!l)
+          return;
+        const E = await this.getApprovals(s, e), p = /* @__PURE__ */ new Map();
+        if (E.forEach((n) => {
+          const u = n.token.erc20TokenAddress.toLowerCase(), A = n.spenderAddress.toLowerCase(), t = `${u}_${A}`;
+          let o = p.get(t);
+          o || (o = { contractAddress: u, spenderAddress: A, tokenIds: /* @__PURE__ */ new Set() }, p.set(t, o)), n.tokenId && o.tokenIds && o.tokenIds.add(n.tokenId);
+        }), i.forEach((n) => {
+          if (!n.topics[2])
+            return;
+          const u = n.address.toLowerCase(), A = `0x${n.topics[2].substring(26)}`.toLowerCase();
+          if (y(A, C))
+            return;
+          const t = `${u}_${A}`;
+          let o = p.get(t);
+          if (o || (o = { contractAddress: u, spenderAddress: A, tokenIds: /* @__PURE__ */ new Set() }, p.set(t, o)), n.topics.length === 4 && o.tokenIds) {
+            const a = BigInt(n.topics[3]).toString();
+            o.tokenIds.add(a);
+          }
+        }), p.size === 0) {
+          await this.updateLastProcessedBlock(s, e, l);
+          return;
+        }
+        const c = Array.from(p.values()), v = await this.checkCurrentAllowances(s, e, c);
+        await I(S.EVENTS_PUBLIC_APPROVALS, (n = {}) => ({
+          ...n,
+          [r]: v
+        })), await this.updateLastProcessedBlock(s, e, l);
+      } catch (i) {
+        B.error("Failed to sync approvals", i);
+      }
+    });
+  }
+}
+const st = new N();
+export {
+  N as EventsPublicApprovalsDB,
+  st as eventsPublicApprovalsDB
+};

package/data-structures/ApprovalDBs/index.d.ts

@@ -0,0 +1 @@
+export * from './EventsPublicApprovalsDB';

package/data-structures/Hinkal/Hinkal.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const q=require("../../types/hinkal.types.cjs"),v=require("../../types/ethereum-network.types.cjs"),C=require("../../functions/web3/functionCalls/accessTokenCalls.cjs"),F=require("../../functions/web3/events/getShieldedBalance.cjs"),k=require("../crypto-keys/keys.cjs"),m=require("./hinkalDeposit.cjs"),E=require("./hinkalSwap.cjs"),M=require("./hinkalWithdraw.cjs"),R=require("./resetMerkleTrees.cjs"),P=require("../merkle-tree/MerkleTree.cjs");require("ethers");const f=require("../../error-handling/error-codes.constants.cjs"),S=require("../../crypto/poseidon.cjs");require("circomlibjs-hinkal-fork");require("libsodium-wrappers");require("process");require("buffer");const H=require("../../constants/chains.constants.cjs");require("../../API/getServerURL.cjs");require("axios");require("../../constants/coingecko.constants.cjs");require("../../constants/server.constants.cjs");require("../tor/TorClient.cjs");require("@hazae41/binary");require("@hazae41/cascade");require("../tor/HttpClient.cjs");const U=require("../../constants/vite.constants.cjs"),A=require("../../API/API.cjs");require("../../constants/token-data/index.cjs");require("../../constants/contracts.constants.cjs");const B=require("../../constants/kyc.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");require("../../API/tenderly.api.cjs");const b=require("../../functions/utils/reloadPage.cjs"),W=require("../MultiThreadedUtxoUtils/MultiThreadedUtxoUtils.cjs"),D=require("./hinkalPrivateWallet.cjs"),K=require("../../functions/utils/cacheFunctions.cjs"),x=require("../../functions/utils/cacheDevice.utils.cjs"),N=require("../../functions/web3/getContractMetadata.cjs"),L=require("./hinkalGetRecipientInfo.cjs"),O=require("./hinkalApprove.cjs"),_=require("./hinkalInsideTransact.cjs"),p=require("../../functions/web3/events/getApprovedBalance.cjs"),y=require("../../functions/web3/functionCalls/inHinkalApprovalCalls.cjs"),j=require("./hinkalSignSubAccount.cjs"),G=require("./hinkalCheckTokenRegistry.cjs"),z=require("./hinkalActionReceive.cjs"),J=require("./hinkalActionFundApproveAndTransact.cjs"),Q=require("../TokenDBs/PrivateTokensDB.cjs");require("idb-keyval");const V=require("../../functions/utils/erc20tokenFunctions.cjs");require("multiformats");require("async-mutex");require("../../functions/utils/convertIntegrationProviderToExternalActionId.cjs");require("../../types/circom-data.types.cjs");require("../../types/transactions.types.cjs");require("../../types/activities.types.cjs");require("../../functions/utils/userAgent.cjs");require("../../functions/utils/mutexes.utils.cjs");require("node-forge");require("../../functions/web3/getTokenHolder.cjs");require("ethers-v6h");const X=require("./hinkalProoflessDeposit.cjs"),Y=require("./hinkalProxySwap.cjs"),Z=require("./hinkalMultiSend.cjs"),$=require("./hinkalTransfer.cjs");class ee{providerAdapter;userKeys;signingMessage="Login to Hinkal Protocol";merkleTreeHinkal;merkleTreeAccessToken;nullifiers;encryptedOutputs;approvals;commitmentsSnapshotService;nullifierSnapshotService;accessTokenSnapshotService;approvalsSnapshotService;utxoUtils;cacheDevice;generateProofRemotely;disableMerkleTreeUpdates;constructor(e){this.userKeys=new k.UserKeys(void 0),this.merkleTreeHinkal=P.MerkleTree.create(S.poseidonFunction,0n),this.merkleTreeAccessToken=P.MerkleTree.create(S.poseidonFunction,0n),this.nullifiers=new Set,this.encryptedOutputs=[],this.approvals=new Map,this.generateProofRemotely=e?.generateProofRemotely??!1,this.utxoUtils=new W.MultiThreadedUtxoUtils,this.cacheDevice=x.createCacheDevice(e),this.disableMerkleTreeUpdates=e?.disableMerkleTreeUpdates??!1}async initProviderAdapter(e,t){await this.updateProviderAdapter(t),this.providerAdapter?.initConnector(e);const r=await this.connectAndPatchProvider(e);await t.init(r),await this.setListeners()}async initUserKeys(){this.userKeys=new k.UserKeys(await this.getProviderAdapter().signMessage(this.signingMessage))}async initUserKeysWithPassword(e){this.userKeys=new k.UserKeys(e)}async resetMerkle(){this.disableMerkleTreeUpdates||this.isSelectedNetworkSupported()&&await R.resetMerkleTrees(this)}getProviderAdapter(){if(!this.providerAdapter)throw new Error("ProviderAdapter is not initialized");return this.providerAdapter}async waitForTransaction(e,t=1){return!!await this.providerAdapter?.waitForTransaction(e,t)}getContractMetadata(e,t){return this.getProviderAdapter().getContractMetadata(e,t)}getContract(e,t=void 0,r){return this.getProviderAdapter().getContract(e,t,r)}getContractWithFetcherByChainId(e,t,r=void 0){return N.getContractWithFetcherByChainId(e,t,r)}async signMessage(e){return await this.getProviderAdapter().signMessage(e)}async signTypedData(e,t,r){return await this.getProviderAdapter().signTypedData(e,t,r)}async signWithSubAccount(e,t,r){return j.hinkalSignSubAccount(this,e,t,r)}getContractWithSigner(e,t=""){return this.getProviderAdapter().getContractWithSigner(e,t)}getContractWithFetcher(e,t=""){return this.getProviderAdapter().getContractWithFetcher(e,t)}getContractWithFetcherForEthereum(e,t){return this.getProviderAdapter().getContractWithFetcherForEthereum(e,t)}isSelectedNetworkSupported(){return!!H.networkRegistry[this.getCurrentChainId()]}async switchNetwork(e){try{await this.getProviderAdapter().switchNetwork(e)}catch{throw new Error(f.transactionErrorCodes.FAILED_TO_SWITCH_NETWORKS)}}async switchAccount(e){await this.getProviderAdapter().switchAccount(e)}getCurrentChainId(){const{chainId:e}=this.getProviderAdapter();if(!e)throw new Error("Illegal State: no chainId");return e}getSelectedNetwork(){return this.providerAdapter?.getSelectedNetwork()}isPermitterAvailable(){return this.getProviderAdapter().isPermitterAvailable()}async connectAndPatchProvider(e){return await this.getProviderAdapter().connectAndPatchProvider(e)}async disconnectFromConnector(){await this.getProviderAdapter().disconnectFromConnector()}async updateProviderAdapter(e){try{this.providerAdapter&&this.providerAdapter.release(),this.providerAdapter=e}catch(t){throw console.error(t),Error("updateProviderAdapter failed, please try again.")}}async setListeners(){this.providerAdapter?.setChainEventListener({onAccountChanged:()=>{this.onAccountChanged()},onChainChanged:e=>{this.onChainChanged(e)}})}async onAccountChanged(){await this.getProviderAdapter().onAccountChanged();const e=q.EventType.AccountChanged;typeof document<"u"?document?.dispatchEvent(new Event(e)):process?.emit("message",e,void 0)}async onChainChanged(e){if(e){await this.getProviderAdapter().onChainChanged(e);const t=q.EventType.NetworkChange;typeof document<"u"?document.dispatchEvent(new Event(t)):process?.emit("message",t,void 0)}else await this.disconnectFromConnector(),b.reloadPage()}async monitorConnectedAddress(){await A.API.monitor(await this.getEthereumAddress(),this.getCurrentChainId())}async getBalances(e,t,r,i,s=!1,n){return F.getShieldedBalance(this,e,t,r,i,s,this.generateProofRemotely,n)}async getApprovedBalances(e=!1,t=!1){return p.getApprovedBalance(this,e,t)}async getTotalBalance(e,t,r,i=!1,s){const n=e??this.getCurrentChainId(),a=r??await this.getEthereumAddress(),o=t??this.userKeys,c=await this.getBalances(n,o.getShieldedPrivateKey(),o.getShieldedPublicKey(),a,i,s),h=await this.getApprovedBalances(i,s),d=U.isExtension?await Q.privateTokensDB.getPrivateTokens(n,a):V.getErc20TokensForChain(n),l=[];return d.forEach(u=>{const T=u.erc20TokenAddress.toLowerCase(),g=c.get(T),w=h.get(T),I={token:u,balance:(g?.balance??0n)+(w?.balance??0n),timestamp:g?.timestamp||w?.timestamp||"0",nfts:g?.nfts||[]};l.push(I)}),l}getSupportedPassportLinks(){return B.supportedPassportLinks}checkAccessToken(){return C.checkHinkalAccessToken(this)}async mintHinkalAccessToken(e,t){return C.mintAccessToken(this,e,t)}async getHinkalTreeRootHash(){return this.getContractWithFetcher(v.ContractType.HinkalContract).getRootHash()}async getAccessTokenTreeRootHash(){return this.getContractWithFetcher(v.ContractType.AccessTokenContract).getRootHash()}async resetMerkleTreesIfNecessary(){if(!this.isSelectedNetworkSupported())throw new Error(f.transactionErrorCodes.UNSUPPORTED_NETWORK);const[e,t]=await Promise.all([this.getHinkalTreeRootHash(),this.getAccessTokenTreeRootHash()]);(e.toBigInt()!==this.merkleTreeHinkal.getRootHash()||t.toBigInt()!==this.merkleTreeAccessToken.getRootHash())&&(console.log("resetting merkle tree in resetMerkleTreesIfNecessary"),await this.resetMerkle())}async getEventsFromHinkal(){await Promise.all([this.accessTokenSnapshotService?.retrieveEventsFromLatestBlock(),this.commitmentsSnapshotService?.retrieveEventsFromLatestBlock(),this.nullifierSnapshotService?.retrieveEventsFromLatestBlock(),this.approvalsSnapshotService?.retrieveEventsFromLatestBlock()])}getEthereumAddress(){return this.getProviderAdapter().getAddress()}async getRandomRelay(e=!1){return(await A.API.getIdleRelay(this.getCurrentChainId(),e)).relay}getGasPrice(){if(!this.providerAdapter?.chainId)throw new Error("Illegal State of providerAdapter in Hinkal: no chainId");return this.providerAdapter.getGasPrice()}getAPI(){return A.API}resetCache(){K.resetCache(this,this.getCurrentChainId(),this.userKeys.getShieldedPublicKey())}snapshotsClearInterval(){this.commitmentsSnapshotService?.intervalClear(),this.accessTokenSnapshotService?.intervalClear(),this.nullifierSnapshotService?.intervalClear(),this.approvalsSnapshotService?.intervalClear()}checkTokenRegistry(e,t){const r=this.getContractWithFetcher(v.ContractType.HinkalHelperContract);return G.hinkalCheckTokenRegistry(r,e,t)}getRecipientInfo(e=!1){return L.getRecipientInfo(this,e)}async getInteractionApprovals(e){return await y.getInteractionApprovals(this,e)}getApprovedUtxos(e=!1){return p.getApprovedUtxos(this,e)}getApprovedUtxosForToken(e,t=!1){return p.getApprovedUtxosForToken(this,e,t)}getMyApprovalAmountForInteraction(e,t){return p.getMyApprovalAmountForInteraction(this,e,t)}async checkExistingApprovalFromHinkal(e,t){return await y.checkExistingApprovalFromHinkal(this,e,t)}async getBufferEntry(e,t,r){return y.getBufferEntry(this,e,t,r)}async deposit(e,t){return m.hinkalDeposit(this,e,t)}async depositForOther(e,t,r){return m.hinkalDepositForOther(this,e,t,r)}async prooflessDeposit(e,t,r){return X.hinkalProoflessDeposit(this,e,t,r)}async transfer(e,t,r,i,s,n,a=!1){return $.hinkalTransfer(this,e,t,r,i,s,n,a)}async withdraw(e,t,r,i,s,n,a,o=!1){return M.hinkalWithdraw(this,e,t,r,i,s,n,a,o)}async swap(e,t,r,i,s,n,a,o=!1,c=!1){return E.hinkalSwap(this,e,t,r,i,s,n,a,o,c)}async actionReceive(e,t,r,i,s,n,a=!1){return z.hinkalActionReceive(this,e,t,r,i,s,n,a)}async actionFundApproveAndTransact(e,t,r,i,s,n,a,o,c=!1,h,d,l){return J.hinkalActionFundApproveAndTransact(this,e,t,r,i,s,n,a,o,c,h,d,l)}async actionPrivateWallet(e,t,r,i,s,n,a,o,c,h=!1,d,l,u=!1){return D.hinkalPrivateWallet(this,e,t,r,i,s,n,a,o,c,h,d,l,u)}async approve(e,t,r,i,s,n=!1){return O.hinkalApprove(this,e,t,r,i,s,n)}async hinkalInsideTransact(e,t,r,i,s,n,a,o,c,h=!1){return _.hinkalInsideTransact(this,e,t,r,i,s,n,a,o,c,h)}async proxySwap(e,t,r,i,s,n,a,o,c=!1,h,d,l=!1){return Y.hinkalProxySwap(this,e,t,r,i,s,n,a,o,c,h,d,l)}async multiSendPrivateRecipients(e,t,r){return Z.hinkalMultiSendPrivateRecipients(this,e,t,r)}areMerkleTreeUpdatesDisabled(){return this.disableMerkleTreeUpdates}updateMerkleTreeUpdates(e){this.disableMerkleTreeUpdates=e}}exports.Hinkal=ee;

package/data-structures/Hinkal/Hinkal.d.ts

@@ -0,0 +1,108 @@
+import { ethers } from 'ethers';
+import { type ApprovedUtxo, ApprovedUtxoWithInteractionAddress, FeeStructure, HinkalConfig, type ParsedInLogicMetadata } from '../../types/hinkal.types';
+import { type ContractMetadata, ContractType, EthereumNetwork } from '../../types/ethereum-network.types';
+import type { EncryptedOutputWithSign } from '../../types/commitments.types';
+import { ExternalActionId } from '../../types/external-action.types';
+import { type IMultiThreadedUtxoUtils } from '../../types/IMultiThreadedUtxoUtils';
+import { type RelayerTransaction } from '../../types/relayer.types';
+import { type SignatureData } from '../../types/crypto.types';
+import type { ERC20Token, TokenBalance, TokenChanges } from '../../types/token.types';
+import { UserKeys } from '../crypto-keys/keys';
+import { type ClientAccessTokenSnapshotService } from '../snapshot/ClientAccessTokenSnapshotService';
+import { type ClientCommitmentsSnapshotService } from '../snapshot/ClientCommitmentsSnapshotService';
+import { type ClientNullifierSnapshotService } from '../snapshot/ClientNullifierSnapshotService';
+import { type ClientApprovalsSnapshotService } from '../snapshot/ClientApprovalsSnapshotService';
+import { type IProviderAdapter } from '../provider-adapter/IProviderAdapter';
+import { type IHinkal } from './IHinkal';
+import { MerkleTree } from '../merkle-tree';
+import { IAPI } from '../../API';
+import { type ICacheDevice } from '../../types/ICacheDevice';
+import type { StealthAddressStructure, TypedData } from '../../types/circom-data.types';
+import { SubAccount } from '../../types/proxy.types';
+import { AdminTransactionType } from '../../types/admin.types';
+export declare class Hinkal<ConnectorType> implements IHinkal {
+    private providerAdapter?;
+    userKeys: UserKeys;
+    readonly signingMessage: string;
+    merkleTreeHinkal: MerkleTree<bigint>;
+    merkleTreeAccessToken: MerkleTree<bigint>;
+    nullifiers: Set<string>;
+    encryptedOutputs: EncryptedOutputWithSign[];
+    approvals: Map<string, ApprovedUtxo[]>;
+    commitmentsSnapshotService?: ClientCommitmentsSnapshotService;
+    nullifierSnapshotService?: ClientNullifierSnapshotService;
+    accessTokenSnapshotService?: ClientAccessTokenSnapshotService;
+    approvalsSnapshotService?: ClientApprovalsSnapshotService;
+    utxoUtils: IMultiThreadedUtxoUtils;
+    cacheDevice: ICacheDevice;
+    generateProofRemotely: boolean;
+    private disableMerkleTreeUpdates;
+    constructor(hinkalConfig?: HinkalConfig);
+    initProviderAdapter(connector: ConnectorType, providerAdapter: IProviderAdapter<ConnectorType>): Promise<void>;
+    initUserKeys(): Promise<void>;
+    initUserKeysWithPassword(password: string): Promise<void>;
+    resetMerkle(): Promise<void>;
+    getProviderAdapter(): IProviderAdapter<ConnectorType>;
+    waitForTransaction(transactionHash: string, confirmations?: number): Promise<boolean>;
+    getContractMetadata(contractType: ContractType, chainId?: number): ContractMetadata;
+    getContract(contractType: ContractType, contractAddress?: undefined, chainId?: number): ethers.Contract;
+    getContractWithFetcherByChainId(chainId: number, contractType: ContractType, contractAddress?: undefined): ethers.Contract;
+    signMessage(message: string): Promise<string>;
+    signTypedData(domain: ethers.TypedDataDomain, types: Record<string, ethers.TypedDataField[]>, value: Record<string, unknown>): Promise<string>;
+    signWithSubAccount(messageToSign: string | undefined, typedData: TypedData | undefined, subAccount: SubAccount): Promise<string>;
+    getContractWithSigner(contract: ContractType, contractAddress?: string): ethers.Contract;
+    getContractWithFetcher(contract: ContractType, contractAddress?: string): ethers.Contract;
+    getContractWithFetcherForEthereum(contract: ContractType, address: string): ethers.Contract;
+    isSelectedNetworkSupported(): boolean;
+    switchNetwork(network: EthereumNetwork): Promise<void>;
+    switchAccount(signer: ethers.Signer): Promise<void>;
+    getCurrentChainId(): number;
+    getSelectedNetwork(): EthereumNetwork | undefined;
+    isPermitterAvailable(): boolean;
+    connectAndPatchProvider(connector: ConnectorType): Promise<number>;
+    disconnectFromConnector(): Promise<void>;
+    updateProviderAdapter(providerAdapter: IProviderAdapter): Promise<void>;
+    setListeners(): Promise<void>;
+    private onAccountChanged;
+    private onChainChanged;
+    monitorConnectedAddress(): Promise<void>;
+    getBalances(chainId: number, passedShieldedPrivateKey: string, passedShieldedPublicKey: string, ethAddress: string, resetCacheBefore?: boolean, updateTokensListBefore?: boolean): Promise<Map<string, TokenBalance>>;
+    getApprovedBalances(resetCacheBefore?: boolean, updateTokensListBefore?: boolean): Promise<Map<string, TokenBalance>>;
+    getTotalBalance(_chainId?: number, _userKeys?: UserKeys, _ethAddress?: string, resetCacheBefore?: boolean, updateTokensListBefore?: boolean): Promise<TokenBalance[]>;
+    getSupportedPassportLinks(): string[];
+    checkAccessToken(): Promise<boolean>;
+    mintHinkalAccessToken(signatureData: SignatureData, fromWallet?: boolean): Promise<ethers.ContractTransaction>;
+    getHinkalTreeRootHash(): Promise<any>;
+    getAccessTokenTreeRootHash(): Promise<any>;
+    resetMerkleTreesIfNecessary(): Promise<void>;
+    getEventsFromHinkal(): Promise<void>;
+    getEthereumAddress(): Promise<string>;
+    getRandomRelay(markAsPending?: boolean): Promise<string | undefined>;
+    getGasPrice(): Promise<bigint>;
+    getAPI(): IAPI;
+    resetCache(): void;
+    snapshotsClearInterval(): void;
+    checkTokenRegistry(erc20Addresses: string[], amountChanges: bigint[]): Promise<boolean>;
+    getRecipientInfo(extendedInfo?: boolean): string;
+    getInteractionApprovals(interactionAddress: string): Promise<ApprovedUtxo[]>;
+    getApprovedUtxos(resetCacheBefore?: boolean): ApprovedUtxoWithInteractionAddress[];
+    getApprovedUtxosForToken(erc20Address: string, resetCacheBefore?: boolean): ApprovedUtxoWithInteractionAddress[];
+    getMyApprovalAmountForInteraction(interactionAddress: string, tokenAddress: string): bigint;
+    checkExistingApprovalFromHinkal(erc20Address: string, interactionAddress: string): Promise<bigint>;
+    getBufferEntry(approveTo: string, tokenAddress: string, inHinkalAddress: bigint): Promise<bigint>;
+    deposit(erc20Tokens: ERC20Token[], amountChanges: bigint[]): Promise<ethers.ContractTransaction>;
+    depositForOther(erc20Tokens: ERC20Token[], amountChanges: bigint[], recipientInfo: string): Promise<ethers.ContractTransaction>;
+    prooflessDeposit(erc20Tokens: ERC20Token[], amountChanges: bigint[], stealthAddressStructures?: StealthAddressStructure[]): Promise<ethers.ContractTransaction>;
+    transfer(erc20Tokens: ERC20Token[], amountChanges: bigint[], recipientAddress: string, feeToken?: string, feeStructureOverride?: FeeStructure, action?: AdminTransactionType, onlyGasEstimate?: boolean): Promise<RelayerTransaction | bigint>;
+    withdraw(erc20Tokens: ERC20Token[], deltaAmounts: bigint[], recipientAddress: string, isRelayerOff: boolean, feeToken?: string, feeStructureOverride?: FeeStructure, action?: AdminTransactionType, onlyGasEstimate?: boolean): Promise<ethers.ContractTransaction | RelayerTransaction | bigint>;
+    swap(erc20Tokens: ERC20Token[], deltaAmounts: bigint[], externalActionId: ExternalActionId, swapData: string, feeToken?: string, feeStructureOverride?: FeeStructure, action?: AdminTransactionType, onlyGasEstimate?: boolean, withPrivateMempool?: boolean): Promise<RelayerTransaction | bigint>;
+    actionReceive(erc20Tokens: ERC20Token[], deltaAmounts: bigint[], feeToken?: string, feeStructureOverride?: FeeStructure, subAccount?: SubAccount, action?: AdminTransactionType, onlyGasEstimate?: boolean): Promise<RelayerTransaction | bigint>;
+    actionFundApproveAndTransact(tokenChanges: TokenChanges<bigint>[], subAccount: SubAccount, spenderAddress?: string, to?: string, callDataString?: string, value?: bigint, feeToken?: string, feeStructureOverride?: FeeStructure, autoDepositBack?: boolean, maxGasInDollar?: string, action?: AdminTransactionType, onlyGasEstimate?: boolean): Promise<RelayerTransaction | bigint>;
+    actionPrivateWallet(erc20Addresses: string[], deltaAmounts: bigint[], onChainCreation: boolean[], ops: string[], emporiumTokenChanges: TokenChanges<bigint>[], subAccount: SubAccount, feeToken?: string, feeStructureOverride?: FeeStructure, relayOverride?: string, autoDepositBack?: boolean, maxGasInDollar?: string, action?: AdminTransactionType, onlyGasEstimate?: boolean): Promise<RelayerTransaction | bigint>;
+    approve(erc20Addresses: string[], amount: bigint, approveTo: string, feeToken?: string, feeStructureOverride?: FeeStructure, onlyGasEstimate?: boolean): Promise<RelayerTransaction | bigint>;
+    hinkalInsideTransact(erc20Addresses: string[], deltaChanges: bigint[], approvalChanges: bigint[], externalAddress: string, externalActionMetadata: string, parsedInLogicMetadata: ParsedInLogicMetadata, feeToken?: string, feeStructureOverride?: FeeStructure, action?: AdminTransactionType, onlyGasEstimate?: boolean): Promise<RelayerTransaction | bigint>;
+    proxySwap(erc20Tokens: ERC20Token[], deltaAmounts: bigint[], externalActionId: ExternalActionId, swapData: string, isTheSameChainSwap: boolean, subAccount: SubAccount, feeToken?: string, feeStructureOverride?: FeeStructure, autoDepositBack?: boolean, maxGasInDollar?: string, action?: AdminTransactionType, onlyGasEstimate?: boolean): Promise<RelayerTransaction | bigint>;
+    multiSendPrivateRecipients(erc20Tokens: ERC20Token[], amounts: bigint[], extendedRecipientInfos?: string[]): Promise<ethers.ContractTransaction>;
+    areMerkleTreeUpdatesDisabled(): boolean;
+    updateMerkleTreeUpdates(value: boolean): void;
+}