@hinkal/common 0.2.12 → 0.2.14

package/data-structures/IndexedDB/contact-db.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("idb-keyval"),d=require("../../error-handling/logger.cjs");class l{STORAGE_KEY="contacts";checkForDuplicate(a,t,e){if(a.find(({ethereumAddress:o,nickname:r})=>(o===t.ethereumAddress||r===t.nickname)&&o!==e)!==void 0)throw new Error("Duplicate Contact attribute")}async createContact(a,t){const e=a.toLowerCase(),c=await s.get(this.STORAGE_KEY)??{},o=c[e]??[];this.checkForDuplicate(o,t),o.push(t),c[e]=o,await s.set(this.STORAGE_KEY,c)}async getContacts(a){try{const t=a.toLowerCase(),e=await s.get(this.STORAGE_KEY);return!e||!e[t]?[]:e[t]}catch(t){return d.Logger.error("Error while getting contacts:",t),[]}}async editContact(a,t,e){const c=a.toLowerCase(),o=await s.get(this.STORAGE_KEY),r=o?.[c];if(!o||!r)throw new Error("Contacts could not be fetched");this.checkForDuplicate(r,e,t);const n=r.findIndex(({ethereumAddress:i})=>i===t);if(n===-1)throw new Error("Contact to be edited was not found");r[n]=e,o[c]=r,await s.set(this.STORAGE_KEY,o)}async deleteContact(a,t){const e=a.toLowerCase(),c=await s.get(this.STORAGE_KEY),o=c?.[e];if(!c||!o)throw new Error("Contacts could not be fetched");const r=o.filter(({ethereumAddress:n})=>n!==t);c[e]=r,await s.set(this.STORAGE_KEY,c)}}const w=new l;exports.contactStorage=w;

package/data-structures/IndexedDB/contact-db.d.ts

@@ -0,0 +1,11 @@
+import { Contact } from '../../types/contacts.types';
+declare class ContactStorage {
+    private readonly STORAGE_KEY;
+    private checkForDuplicate;
+    createContact(walletAddress: string, newContact: Contact): Promise<void>;
+    getContacts(walletAddress: string): Promise<Contact[]>;
+    editContact(walletAddress: string, oldContactAddress: string, editedContact: Contact): Promise<void>;
+    deleteContact(walletAddress: string, contactAddressToDelete: string): Promise<void>;
+}
+export declare const contactStorage: ContactStorage;
+export {};

package/data-structures/IndexedDB/contact-db.mjs

@@ -0,0 +1,44 @@
+import { get as n, set as i } from "idb-keyval";
+import { Logger as w } from "../../error-handling/logger.mjs";
+class h {
+  STORAGE_KEY = "contacts";
+  checkForDuplicate(c, t, o) {
+    if (c.find(
+      ({ ethereumAddress: e, nickname: r }) => (e === t.ethereumAddress || r === t.nickname) && e !== o
+    ) !== void 0)
+      throw new Error("Duplicate Contact attribute");
+  }
+  async createContact(c, t) {
+    const o = c.toLowerCase(), a = await n(this.STORAGE_KEY) ?? {}, e = a[o] ?? [];
+    this.checkForDuplicate(e, t), e.push(t), a[o] = e, await i(this.STORAGE_KEY, a);
+  }
+  async getContacts(c) {
+    try {
+      const t = c.toLowerCase(), o = await n(this.STORAGE_KEY);
+      return !o || !o[t] ? [] : o[t];
+    } catch (t) {
+      return w.error("Error while getting contacts:", t), [];
+    }
+  }
+  async editContact(c, t, o) {
+    const a = c.toLowerCase(), e = await n(this.STORAGE_KEY), r = e?.[a];
+    if (!e || !r)
+      throw new Error("Contacts could not be fetched");
+    this.checkForDuplicate(r, o, t);
+    const s = r.findIndex(({ ethereumAddress: d }) => d === t);
+    if (s === -1)
+      throw new Error("Contact to be edited was not found");
+    r[s] = o, e[a] = r, await i(this.STORAGE_KEY, e);
+  }
+  async deleteContact(c, t) {
+    const o = c.toLowerCase(), a = await n(this.STORAGE_KEY), e = a?.[o];
+    if (!a || !e)
+      throw new Error("Contacts could not be fetched");
+    const r = e.filter(({ ethereumAddress: s }) => s !== t);
+    a[o] = r, await i(this.STORAGE_KEY, a);
+  }
+}
+const C = new h();
+export {
+  C as contactStorage
+};

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

@@ -0,0 +1,5 @@
+export * from './activity-db';
+export * from './balances-db';
+export * from './private-balances-db';
+export * from './prices-db';
+export * from './contact-db';

package/data-structures/IndexedDB/prices-db.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const P=require("idb-keyval"),p=require("../../API/API.cjs"),l=require("../../functions/utils/string.utils.cjs");class g{tokenPricesRecordLabel="tokenPrices";async getPrices(){return await P.get(this.tokenPricesRecordLabel)}async updatePrices(e,t){if(!t.length)return[];const{prices:r}=await p.API.getTokenPrices(e,t);return await P.update(this.tokenPricesRecordLabel,(i={})=>{const c={...i};return r.forEach((s,o)=>{c[l.getStateKey(t[o],e)]=s}),c}),r}async getAndUpdatePrices(e,t){const r=await this.getPrices();let i=new Array(t.length).fill(0);if(!r)i=await this.updatePrices(e,t);else{const c=[],s=[];t.forEach((a,n)=>{const u=l.getStateKey(a,e);r[u]?i[n]=r[u]:(c.push(a),s.push(n))});const o=await this.updatePrices(e,c);s.forEach((a,n)=>{i[a]=o[n]})}return i}async updateCachedPricesByChain(e){const t=await this.getPrices();if(!t||Object.keys(t).length===0)return;const r=Object.entries(t).filter(([c])=>{const[,s]=c.split("-");return parseInt(s,10)===e}).map(([c])=>c.split("-")[0]);if(r.length===0)return;const{prices:i}=await p.API.getTokenPrices(e,r);await P.update(this.tokenPricesRecordLabel,(c={})=>{const s={...c};return i.forEach((o,a)=>{const n=l.getStateKey(r[a],e);s[n]=o}),s})}}const h=new g;exports.pricesStorage=h;

package/data-structures/IndexedDB/prices-db.d.ts

@@ -0,0 +1,9 @@
+declare class PricesStorage {
+    readonly tokenPricesRecordLabel = "tokenPrices";
+    getPrices(): Promise<Record<string, number> | undefined>;
+    updatePrices(chainId: number, erc20Addresses: string[]): Promise<number[]>;
+    getAndUpdatePrices(currentChainId: number, erc20Addresses: string[]): Promise<number[]>;
+    updateCachedPricesByChain(chainId: number): Promise<void>;
+}
+export declare const pricesStorage: PricesStorage;
+export {};

package/data-structures/IndexedDB/prices-db.mjs

@@ -0,0 +1,62 @@
+import { get as u, update as l } from "idb-keyval";
+import { API as h } from "../../API/API.mjs";
+import { getStateKey as P } from "../../functions/utils/string.utils.mjs";
+class f {
+  tokenPricesRecordLabel = "tokenPrices";
+  async getPrices() {
+    return await u(this.tokenPricesRecordLabel);
+  }
+  async updatePrices(e, t) {
+    if (!t.length)
+      return [];
+    const { prices: r } = await h.getTokenPrices(e, t);
+    return await l(this.tokenPricesRecordLabel, (i = {}) => {
+      const c = { ...i };
+      return r.forEach((s, o) => {
+        c[P(t[o], e)] = s;
+      }), c;
+    }), r;
+  }
+  // Fetches token prices and updates missing prices as needed.
+  async getAndUpdatePrices(e, t) {
+    const r = await this.getPrices();
+    let i = new Array(t.length).fill(0);
+    if (!r)
+      i = await this.updatePrices(e, t);
+    else {
+      const c = [], s = [];
+      t.forEach((a, n) => {
+        const p = P(a, e);
+        r[p] ? i[n] = r[p] : (c.push(a), s.push(n));
+      });
+      const o = await this.updatePrices(e, c);
+      s.forEach((a, n) => {
+        i[a] = o[n];
+      });
+    }
+    return i;
+  }
+  async updateCachedPricesByChain(e) {
+    const t = await this.getPrices();
+    if (!t || Object.keys(t).length === 0)
+      return;
+    const r = Object.entries(t).filter(([c]) => {
+      const [, s] = c.split("-");
+      return parseInt(s, 10) === e;
+    }).map(([c]) => c.split("-")[0]);
+    if (r.length === 0)
+      return;
+    const { prices: i } = await h.getTokenPrices(e, r);
+    await l(this.tokenPricesRecordLabel, (c = {}) => {
+      const s = { ...c };
+      return i.forEach((o, a) => {
+        const n = P(r[a], e);
+        s[n] = o;
+      }), s;
+    });
+  }
+}
+const m = new f();
+export {
+  m as pricesStorage
+};

package/data-structures/IndexedDB/private-balances-db.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("idb-keyval"),n=require("../../functions/utils/string.utils.cjs");class r{balancesRecordLabel="privateWalletsBalances";async getBalances(){return await l.get(this.balancesRecordLabel)}async getBalancesByWallet(e,t){const a=await this.getBalances();if(!a)return;const s=n.getStateKey(e,t,!0);return a[s]}async setBalances(e,t,a){await l.update(this.balancesRecordLabel,(s={})=>{const c=n.getStateKey(e,t,!0);return{...s,[c]:a}})}}const i=new r;exports.privateBalancesStorage=i;

package/data-structures/IndexedDB/private-balances-db.d.ts

@@ -0,0 +1,9 @@
+import { TokenBalance } from '../../types/token.types';
+declare class PrivateBalancesStorage {
+    readonly balancesRecordLabel = "privateWalletsBalances";
+    getBalances(): Promise<Record<string, TokenBalance[]> | undefined>;
+    getBalancesByWallet(address: string, chainId: number): Promise<TokenBalance[] | undefined>;
+    setBalances(address: string, chainId: number, newBalances: TokenBalance[]): Promise<void>;
+}
+export declare const privateBalancesStorage: PrivateBalancesStorage;
+export {};

package/data-structures/IndexedDB/private-balances-db.mjs

@@ -0,0 +1,28 @@
+import { get as c, update as r } from "idb-keyval";
+import { getStateKey as l } from "../../functions/utils/string.utils.mjs";
+class o {
+  balancesRecordLabel = "privateWalletsBalances";
+  async getBalances() {
+    return await c(this.balancesRecordLabel);
+  }
+  async getBalancesByWallet(a, t) {
+    const e = await this.getBalances();
+    if (!e)
+      return;
+    const s = l(a, t, !0);
+    return e[s];
+  }
+  async setBalances(a, t, e) {
+    await r(this.balancesRecordLabel, (s = {}) => {
+      const n = l(a, t, !0);
+      return {
+        ...s,
+        [n]: e
+      };
+    });
+  }
+}
+const u = new o();
+export {
+  u as privateBalancesStorage
+};

package/data-structures/MultiThreadedUtxoUtils/MultiThreadedUtxoUtils.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("../utxo/Utxo.cjs"),u=require("../../webworker/utxoWorker/utxoWorker.types.cjs"),y=require("../../webworker/performTaskWithWorker.cjs"),d=require("../../webworker/worker.registry.cjs"),m=require("../../constants/vite.constants.cjs");class S{NUM_WORKERS;NUM_WORKERS_BATCH_PROCESS;constructor(){m.isNode?(this.NUM_WORKERS=1,this.NUM_WORKERS_BATCH_PROCESS=1):(this.NUM_WORKERS=3,this.NUM_WORKERS_BATCH_PROCESS=Math.ceil(navigator.deviceMemory??4))}async createUtxoPromise(s){return await y.performTaskWithWorker({type:d.WorkerVariant.UTXO,payload:s})}async batchFilterUtxosWithNullifier(s,t){const r=this.sliceArrayIntoParts(s,this.NUM_WORKERS).map(o=>this.createUtxoPromise({type:u.UtxoWorkerActionType.BATCH_FILTER_UTXOS_WITH_NULLIFIER,data:{utxos:o.map(a=>a.getConstructableParams()),nullifiers:t}}));return(await Promise.all(r)).flat().map(o=>new p.Utxo(o))}async buildBatchProcess(s,t){const r=this.sliceArrayIntoParts(s,this.NUM_WORKERS).map(a=>this.createUtxoPromise({type:u.UtxoWorkerActionType.BUILD_UTXOS,data:{signature:t.getSignature(),encryptedOutputs:a}}));return(await Promise.all(r)).flat().map(a=>new p.Utxo(a))}sliceArrayIntoParts(s,t){const e=Math.ceil(s.length/t);return Array.from({length:t},(c,o)=>s.slice(e*o,e*(o+1)))}findLastOutput(s,t){let e=t;return s.forEach(r=>{r!==t&&(e=r)}),e}async batchProcess(s,t,e){const r=this.sliceArrayIntoParts(s,this.NUM_WORKERS_BATCH_PROCESS),c=e.getSignature(),o=r.map(i=>{const n={type:u.UtxoWorkerActionType.DECIPHER_OUTPUTS,data:{encryptedOutputs:i,lastOutput:t,signature:c}};return this.createUtxoPromise(n)}),a=await Promise.all(o),R=a.map(({additionalEncryptedOutputs:i})=>i).flat(),l=new Set,h=R.reduce((i,n)=>l.has(n.value)?i:(l.add(n.value),[...i,n]),[]),U=this.findLastOutput(a.map(i=>i.lastOutput),t);return{additionalEncryptedOutputs:h,lastOutput:U??t}}}exports.MultiThreadedUtxoUtils=S;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("../crypto-keys/keys.cjs"),d=require("../utxo/Utxo.cjs"),l=require("../../webworker/utxoWorker/utxoWorker.types.cjs"),U=require("../../webworker/performTaskWithWorker.cjs"),S=require("../../webworker/worker.registry.cjs"),m=require("../../constants/vite.constants.cjs");class _{NUM_WORKERS;NUM_WORKERS_BATCH_PROCESS;constructor(){m.isNode?(this.NUM_WORKERS=1,this.NUM_WORKERS_BATCH_PROCESS=1):(this.NUM_WORKERS=3,this.NUM_WORKERS_BATCH_PROCESS=Math.ceil(navigator.deviceMemory??4))}async createUtxoPromise(s){return await U.performTaskWithWorker({type:S.WorkerVariant.UTXO,payload:s})}async batchFilterUtxosWithNullifier(s,t){const a=this.sliceArrayIntoParts(s,this.NUM_WORKERS).map(e=>this.createUtxoPromise({type:l.UtxoWorkerActionType.BATCH_FILTER_UTXOS_WITH_NULLIFIER,data:{utxos:e.map(n=>n.getConstructableParams()),nullifiers:t}})),i=await Promise.all(a);return i.forEach(e=>{h.stealthPairCacheDevice.mergeWithSerialized(e.stealthPairCache),h.stealthAddressCacheDevice.mergeWithSerialized(e.stealthAddressCache)}),i.flatMap(e=>e.utxoConstructors).map(e=>new d.Utxo(e))}async buildBatchProcess(s,t){const a=this.sliceArrayIntoParts(s,this.NUM_WORKERS).map(c=>this.createUtxoPromise({type:l.UtxoWorkerActionType.BUILD_UTXOS,data:{signature:t.getSignature(),encryptedOutputs:c}}));return(await Promise.all(a)).flat().map(c=>new d.Utxo(c))}sliceArrayIntoParts(s,t){const r=Math.ceil(s.length/t);return Array.from({length:t},(i,e)=>s.slice(r*e,r*(e+1)))}findLastOutput(s,t){let r=t;return s.forEach(a=>{a!==t&&(r=a)}),r}async batchProcess(s,t,r){const a=this.sliceArrayIntoParts(s,this.NUM_WORKERS_BATCH_PROCESS),i=r.getSignature(),e=a.map(o=>{const u={type:l.UtxoWorkerActionType.DECIPHER_OUTPUTS,data:{encryptedOutputs:o,lastOutput:t,signature:i}};return this.createUtxoPromise(u)}),n=await Promise.all(e),c=n.map(({additionalEncryptedOutputs:o})=>o).flat(),p=new Set,R=c.reduce((o,u)=>p.has(u.value)?o:(p.add(u.value),[...o,u]),[]),y=this.findLastOutput(n.map(o=>o.lastOutput),t);return{additionalEncryptedOutputs:R,lastOutput:y??t}}}exports.MultiThreadedUtxoUtils=_;

package/data-structures/MultiThreadedUtxoUtils/MultiThreadedUtxoUtils.mjs

@@ -1,77 +1,80 @@
-import { Utxo as l } from "../utxo/Utxo.mjs";
-import { UtxoWorkerActionType as u } from "../../webworker/utxoWorker/utxoWorker.types.mjs";
-import { performTaskWithWorker as S } from "../../webworker/performTaskWithWorker.mjs";
-import { WorkerVariant as d } from "../../webworker/worker.registry.mjs";
-import { isNode as O } from "../../constants/vite.constants.mjs";
-class W {
+import { stealthPairCacheDevice as d, stealthAddressCacheDevice as S } from "../crypto-keys/keys.mjs";
+import { Utxo as h } from "../utxo/Utxo.mjs";
+import { UtxoWorkerActionType as l } from "../../webworker/utxoWorker/utxoWorker.types.mjs";
+import { performTaskWithWorker as O } from "../../webworker/performTaskWithWorker.mjs";
+import { WorkerVariant as U } from "../../webworker/worker.registry.mjs";
+import { isNode as y } from "../../constants/vite.constants.mjs";
+class T {
   NUM_WORKERS;
   NUM_WORKERS_BATCH_PROCESS;
   constructor() {
-    O ? (this.NUM_WORKERS = 1, this.NUM_WORKERS_BATCH_PROCESS = 1) : (this.NUM_WORKERS = 3, this.NUM_WORKERS_BATCH_PROCESS = Math.ceil(navigator.deviceMemory ?? 4));
+    y ? (this.NUM_WORKERS = 1, this.NUM_WORKERS_BATCH_PROCESS = 1) : (this.NUM_WORKERS = 3, this.NUM_WORKERS_BATCH_PROCESS = Math.ceil(navigator.deviceMemory ?? 4));
   }
-  async createUtxoPromise(s) {
-    return await S({
-      type: d.UTXO,
-      payload: s
+  async createUtxoPromise(e) {
+    return await O({
+      type: U.UTXO,
+      payload: e
     });
   }
-  async batchFilterUtxosWithNullifier(s, t) {
-    const r = this.sliceArrayIntoParts(s, this.NUM_WORKERS).map(
-      (a) => this.createUtxoPromise({
-        type: u.BATCH_FILTER_UTXOS_WITH_NULLIFIER,
+  async batchFilterUtxosWithNullifier(e, t) {
+    const a = this.sliceArrayIntoParts(e, this.NUM_WORKERS).map(
+      (s) => this.createUtxoPromise({
+        type: l.BATCH_FILTER_UTXOS_WITH_NULLIFIER,
         data: {
-          utxos: a.map((o) => o.getConstructableParams()),
+          utxos: s.map((n) => n.getConstructableParams()),
           nullifiers: t
         }
       })
-    );
-    return (await Promise.all(r)).flat().map((a) => new l(a));
+    ), i = await Promise.all(a);
+    return i.forEach((s) => {
+      d.mergeWithSerialized(s.stealthPairCache), S.mergeWithSerialized(s.stealthAddressCache);
+    }), i.flatMap((s) => s.utxoConstructors).map((s) => new h(s));
   }
-  async buildBatchProcess(s, t) {
-    const r = this.sliceArrayIntoParts(s, this.NUM_WORKERS).map(
-      (o) => this.createUtxoPromise({
-        type: u.BUILD_UTXOS,
-        data: { signature: t.getSignature(), encryptedOutputs: o }
+  async buildBatchProcess(e, t) {
+    const a = this.sliceArrayIntoParts(e, this.NUM_WORKERS).map(
+      (c) => this.createUtxoPromise({
+        type: l.BUILD_UTXOS,
+        data: { signature: t.getSignature(), encryptedOutputs: c }
       })
     );
-    return (await Promise.all(r)).flat().map((o) => new l(o));
+    return (await Promise.all(a)).flat().map((c) => new h(c));
   }
-  sliceArrayIntoParts(s, t) {
-    const e = Math.ceil(s.length / t);
+  sliceArrayIntoParts(e, t) {
+    const r = Math.ceil(e.length / t);
     return Array.from(
       { length: t },
-      (c, a) => s.slice(e * a, e * (a + 1))
+      (i, s) => e.slice(r * s, r * (s + 1))
     );
   }
-  findLastOutput(s, t) {
-    let e = t;
-    return s.forEach((r) => {
-      r !== t && (e = r);
-    }), e;
+  findLastOutput(e, t) {
+    let r = t;
+    return e.forEach((a) => {
+      a !== t && (r = a);
+    }), r;
   }
-  async batchProcess(s, t, e) {
-    const r = this.sliceArrayIntoParts(s, this.NUM_WORKERS_BATCH_PROCESS), c = e.getSignature(), a = r.map((i) => {
-      const n = {
-        type: u.DECIPHER_OUTPUTS,
+  async batchProcess(e, t, r) {
+    const a = this.sliceArrayIntoParts(e, this.NUM_WORKERS_BATCH_PROCESS), i = r.getSignature(), s = a.map((o) => {
+      const u = {
+        type: l.DECIPHER_OUTPUTS,
         data: {
-          encryptedOutputs: i,
+          encryptedOutputs: o,
           lastOutput: t,
           // doesn't matter what we pass here, it will not be used regardless
-          signature: c
+          signature: i
         }
       };
-      return this.createUtxoPromise(n);
-    }), o = await Promise.all(a), m = o.map(({ additionalEncryptedOutputs: i }) => i).flat(), p = /* @__PURE__ */ new Set(), R = m.reduce((i, n) => p.has(n.value) ? i : (p.add(n.value), [...i, n]), []), h = this.findLastOutput(
-      o.map((i) => i.lastOutput),
+      return this.createUtxoPromise(u);
+    }), n = await Promise.all(s), c = n.map(({ additionalEncryptedOutputs: o }) => o).flat(), p = /* @__PURE__ */ new Set(), m = c.reduce((o, u) => p.has(u.value) ? o : (p.add(u.value), [...o, u]), []), R = this.findLastOutput(
+      n.map((o) => o.lastOutput),
       t
     );
     return {
-      additionalEncryptedOutputs: R,
-      lastOutput: h ?? t
+      additionalEncryptedOutputs: m,
+      lastOutput: R ?? t
       // keep the last output the same if no new output is present
     };
   }
 }
 export {
-  W as MultiThreadedUtxoUtils
+  T as MultiThreadedUtxoUtils
 };

package/data-structures/TokenDBs/PrivateTokensDB.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("idb-keyval"),P=require("../../API/API.cjs"),g=require("../../error-handling/logger.cjs"),h=require("../../functions/utils/caseInsensitive.utils.cjs"),k=require("../../types/cache.types.cjs"),T=require("../../functions/utils/string.utils.cjs");class l{fetchedTokens={};initalFetched=!1;async updateFetchedTokens(){const e=await i.get(k.StorageKeys.PRIVATE_TOKENS);this.fetchedTokens=e??{},this.initalFetched=!0}async getPrivateTokens(e,t){const s=T.getStateKey(t,e);return(await i.get(k.StorageKeys.PRIVATE_TOKENS))?.[s]||[]}async fetchPrivateTokens(e,t,s){try{const r=[...new Set(t.map(n=>n.toLowerCase()))].filter(n=>n&&!h.lowerCaseIncludes(s,n));return g.Logger.log("tokenAddresses",r),r.length?(await P.API.tokensInfoCall(e,r)).filter(n=>!!n):[]}catch(r){return g.Logger.error("Error fetching private tokens:",r),[]}}async fetchAndUpdatePrivateTokens(e,t,s,r){const n=(await this.getPrivateTokens(t,s)).map(o=>o.erc20TokenAddress),y=r??await this.fetchPrivateTokens(t,e,n),d=T.getStateKey(s,t);await i.update(k.StorageKeys.PRIVATE_TOKENS,(o={})=>{const a=o?.[d]||[],p=a.map(c=>c.erc20TokenAddress),f=y.filter(c=>!h.lowerCaseIncludes(p,c.erc20TokenAddress));a.push(...f);const u={...o,[d]:a};return this.fetchedTokens=u,u})}getFetchedTokens(e,t){const s=T.getStateKey(t,e);return this.fetchedTokens[s]||[]}}const w=new l;exports.PrivateTokensDB=l;exports.privateTokensDB=w;

package/data-structures/TokenDBs/PrivateTokensDB.d.ts

@@ -0,0 +1,11 @@
+import { ERC20Token } from '../../types/token.types';
+export declare class PrivateTokensDB {
+    private fetchedTokens;
+    initalFetched: boolean;
+    updateFetchedTokens(): Promise<void>;
+    getPrivateTokens(chainId: number, walletAddress: string): Promise<ERC20Token[]>;
+    private fetchPrivateTokens;
+    fetchAndUpdatePrivateTokens(erc20Addresses: string[], chainId: number, walletAddress: string, preFetchedTokens?: ERC20Token[]): Promise<void>;
+    getFetchedTokens(chainId: number, walletAddress: string): ERC20Token[];
+}
+export declare const privateTokensDB: PrivateTokensDB;

package/data-structures/TokenDBs/PrivateTokensDB.mjs

@@ -0,0 +1,53 @@
+import { get as p, update as l } from "idb-keyval";
+import { API as w } from "../../API/API.mjs";
+import { Logger as f } from "../../error-handling/logger.mjs";
+import { lowerCaseIncludes as h } from "../../functions/utils/caseInsensitive.utils.mjs";
+import { StorageKeys as i } from "../../types/cache.types.mjs";
+import { getStateKey as k } from "../../functions/utils/string.utils.mjs";
+class A {
+  fetchedTokens = {};
+  initalFetched = !1;
+  async updateFetchedTokens() {
+    const e = await p(i.PRIVATE_TOKENS);
+    this.fetchedTokens = e ?? {}, this.initalFetched = !0;
+  }
+  async getPrivateTokens(e, t) {
+    const s = k(t, e);
+    return (await p(i.PRIVATE_TOKENS))?.[s] || [];
+  }
+  async fetchPrivateTokens(e, t, s) {
+    try {
+      const r = [...new Set(t.map((o) => o.toLowerCase()))].filter(
+        (o) => o && !h(s, o)
+      );
+      return f.log("tokenAddresses", r), r.length ? (await w.tokensInfoCall(e, r)).filter(
+        (o) => !!o
+      ) : [];
+    } catch (r) {
+      return f.error("Error fetching private tokens:", r), [];
+    }
+  }
+  async fetchAndUpdatePrivateTokens(e, t, s, r) {
+    const o = (await this.getPrivateTokens(t, s)).map((n) => n.erc20TokenAddress), v = r ?? await this.fetchPrivateTokens(t, e, o), T = k(s, t);
+    await l(i.PRIVATE_TOKENS, (n = {}) => {
+      const a = n?.[T] || [], u = a.map((c) => c.erc20TokenAddress), g = v.filter(
+        (c) => !h(u, c.erc20TokenAddress)
+      );
+      a.push(...g);
+      const d = {
+        ...n,
+        [T]: a
+      };
+      return this.fetchedTokens = d, d;
+    });
+  }
+  getFetchedTokens(e, t) {
+    const s = k(t, e);
+    return this.fetchedTokens[s] || [];
+  }
+}
+const C = new A();
+export {
+  A as PrivateTokensDB,
+  C as privateTokensDB
+};

package/data-structures/TokenDBs/PublicTokensDB.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("ethers"),d=require("idb-keyval"),b=require("../../API/API.cjs"),y=require("../../constants/chains.constants.cjs"),L=require("../../error-handling/logger.cjs"),P=require("../../functions/utils/caseInsensitive.utils.cjs"),g=require("../../types/cache.types.cjs"),k=require("../../functions/utils/string.utils.cjs"),K=require("../../constants/protocol.constants.cjs");class B{fetchedTokens={};transferEventTopic=f.ethers.utils.id("Transfer(address,address,uint256)");INITIAL_BLOCKS={[y.chainIds.optimism]:124883692};async getPublicTokens(e,t){const o=k.getStateKey(t,e);return(await d.get(g.StorageKeys.PUBLIC_TOKENS))?.[o]||[]}async getLastProcessedBlock(e,t){const o=await d.get(g.StorageKeys.PUBLIC_TOKENS_LAST_PROCESSED_BLOCKS)||{},s=k.getStateKey(t,e);return o[s]||this.INITIAL_BLOCKS[e]}async updateLastProcessedBlock(e,t,o){await d.update(g.StorageKeys.PUBLIC_TOKENS_LAST_PROCESSED_BLOCKS,(s={})=>{const r=k.getStateKey(t,e);return{...s,[r]:o}})}async fetchPublicTokens(e,t,o){try{const{fetchRpcUrl:s}=y.networkRegistry[t];if(!s)throw Error("No fetchRpcUrl in PublicTokensDB");const r=new f.ethers.providers.JsonRpcProvider(s),i=await this.getLastProcessedBlock(t,e),a=await r.getBlockNumber(),n=f.ethers.utils.hexZeroPad(e.toLowerCase(),32),l={topics:[this.transferEventTopic,null,n],fromBlock:i},p={topics:[this.transferEventTopic,n,null],fromBlock:i},[S,T]=await Promise.all([r.getLogs(l),r.getLogs(p)]),u=[...S,...T],h=[K.zeroAddress,...new Set(u.map(c=>c.address))].filter(c=>c&&!P.lowerCaseIncludes(o,c));return h.length?{erc20Tokens:(await b.API.tokensInfoCall(t,h)).filter(c=>!!c),latestBlock:a}:{erc20Tokens:[],latestBlock:a}}catch(s){return L.Logger.error("Error fetching public tokens:",s),{erc20Tokens:[],latestBlock:void 0}}}async fetchAndUpdatePublicTokens(e,t){const s=(await this.getPublicTokens(t,e)).map(n=>n.erc20TokenAddress),{erc20Tokens:r,latestBlock:i}=await this.fetchPublicTokens(e,t,s),a=k.getStateKey(e,t);await d.update(g.StorageKeys.PUBLIC_TOKENS,(n={})=>{const l=n[a]||[],p=l.map(u=>u.erc20TokenAddress),S=r.filter(u=>!P.lowerCaseIncludes(p,u.erc20TokenAddress));l.push(...S);const T={...n,[a]:l};return this.fetchedTokens=T,T}),i&&await this.updateLastProcessedBlock(t,e,i)}getFetchedTokens(e,t){const o=k.getStateKey(t,e);return this.fetchedTokens[o]||[]}}const w=new B;exports.PublicTokensDB=B;exports.publicTokensDB=w;

package/data-structures/TokenDBs/PublicTokensDB.d.ts

@@ -0,0 +1,13 @@
+import { ERC20Token } from '../../types/token.types';
+export declare class PublicTokensDB {
+    private fetchedTokens;
+    private readonly transferEventTopic;
+    private readonly INITIAL_BLOCKS;
+    getPublicTokens(chainId: number, walletAddress: string): Promise<ERC20Token[]>;
+    private getLastProcessedBlock;
+    private updateLastProcessedBlock;
+    private fetchPublicTokens;
+    fetchAndUpdatePublicTokens(walletAddress: string, chainId: number): Promise<void>;
+    getFetchedTokens(chainId: number, walletAddress: string): ERC20Token[];
+}
+export declare const publicTokensDB: PublicTokensDB;

package/data-structures/TokenDBs/PublicTokensDB.mjs

@@ -0,0 +1,81 @@
+import { ethers as m } from "ethers";
+import { get as B, update as h } from "idb-keyval";
+import { API as g } from "../../API/API.mjs";
+import { chainIds as S, networkRegistry as w } from "../../constants/chains.constants.mjs";
+import { Logger as E } from "../../error-handling/logger.mjs";
+import { lowerCaseIncludes as L } from "../../functions/utils/caseInsensitive.utils.mjs";
+import { StorageKeys as u } from "../../types/cache.types.mjs";
+import { getStateKey as T } from "../../functions/utils/string.utils.mjs";
+import { zeroAddress as b } from "../../constants/protocol.constants.mjs";
+class y {
+  fetchedTokens = {};
+  transferEventTopic = m.utils.id("Transfer(address,address,uint256)");
+  //  ToDo: replace this with hinkal deployment block
+  INITIAL_BLOCKS = {
+    [S.optimism]: 124883692
+  };
+  async getPublicTokens(e, t) {
+    const o = T(t, e);
+    return (await B(u.PUBLIC_TOKENS))?.[o] || [];
+  }
+  async getLastProcessedBlock(e, t) {
+    const o = await B(u.PUBLIC_TOKENS_LAST_PROCESSED_BLOCKS) || {}, s = T(t, e);
+    return o[s] || this.INITIAL_BLOCKS[e];
+  }
+  async updateLastProcessedBlock(e, t, o) {
+    await h(u.PUBLIC_TOKENS_LAST_PROCESSED_BLOCKS, (s = {}) => {
+      const r = T(t, e);
+      return {
+        ...s,
+        [r]: o
+      };
+    });
+  }
+  async fetchPublicTokens(e, t, o) {
+    try {
+      const { fetchRpcUrl: s } = w[t];
+      if (!s)
+        throw Error("No fetchRpcUrl in PublicTokensDB");
+      const r = new m.providers.JsonRpcProvider(s), i = await this.getLastProcessedBlock(t, e), a = await r.getBlockNumber(), n = m.utils.hexZeroPad(e.toLowerCase(), 32), k = {
+        topics: [this.transferEventTopic, null, n],
+        fromBlock: i
+      }, f = {
+        topics: [this.transferEventTopic, n, null],
+        fromBlock: i
+      }, [d, p] = await Promise.all([r.getLogs(k), r.getLogs(f)]), l = [...d, ...p], P = [b, ...new Set(l.map((c) => c.address))].filter(
+        (c) => c && !L(o, c)
+      );
+      return P.length ? { erc20Tokens: (await g.tokensInfoCall(t, P)).filter(
+        (c) => !!c
+      ), latestBlock: a } : { erc20Tokens: [], latestBlock: a };
+    } catch (s) {
+      return E.error("Error fetching public tokens:", s), { erc20Tokens: [], latestBlock: void 0 };
+    }
+  }
+  // this function should be called when:
+  // 1) user first initiates wallet on a given chain
+  // 2) user manually press refresh balances button
+  async fetchAndUpdatePublicTokens(e, t) {
+    const s = (await this.getPublicTokens(t, e)).map((n) => n.erc20TokenAddress), { erc20Tokens: r, latestBlock: i } = await this.fetchPublicTokens(e, t, s), a = T(e, t);
+    await h(u.PUBLIC_TOKENS, (n = {}) => {
+      const k = n[a] || [], f = k.map((l) => l.erc20TokenAddress), d = r.filter(
+        (l) => !L(f, l.erc20TokenAddress)
+      );
+      k.push(...d);
+      const p = {
+        ...n,
+        [a]: k
+      };
+      return this.fetchedTokens = p, p;
+    }), i && await this.updateLastProcessedBlock(t, e, i);
+  }
+  getFetchedTokens(e, t) {
+    const o = T(t, e);
+    return this.fetchedTokens[o] || [];
+  }
+}
+const x = new y();
+export {
+  y as PublicTokensDB,
+  x as publicTokensDB
+};

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

@@ -0,0 +1,2 @@
+export * from './PrivateTokensDB';
+export * from './PublicTokensDB';

package/data-structures/cacheDevices/AttachableMemoryCacheDevice.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("../../functions/utils/serialize.utils.cjs"),n=require("./BaseCacheDevice.cjs");class h extends n.BaseCacheDevice{isAttached=!1;get(e){return this.getInMemory(e)}set(e,t){this.setInMemory(e,t)}serialize(){return Object.fromEntries([...this.inMemoryCache].map(([e,t])=>[e,s.CustomJSONStringify(t)]))}attach(e){if(this.isAttached)throw new Error("can't reattach cache device");return this.isAttached=!0,(...i)=>{const r=s.CustomJSONStringify(i),c=this.get(r);if(c!==void 0)return c;const a=e(...i);return this.set(r,a),a}}}exports.AttachableMemoryCacheDevice=h;

package/data-structures/cacheDevices/AttachableMemoryCacheDevice.d.ts

@@ -0,0 +1,8 @@
+import { BaseCacheDevice } from './BaseCacheDevice';
+export declare class AttachableMemoryCacheDevice<T> extends BaseCacheDevice<T> {
+    private isAttached;
+    get(key: string): T | undefined;
+    set(key: string, value: T): void;
+    serialize(): Record<string, string>;
+    attach<ArgsType extends unknown[]>(func: (...args: ArgsType) => T): (...args: ArgsType) => T;
+}

package/data-structures/cacheDevices/AttachableMemoryCacheDevice.mjs

@@ -0,0 +1,28 @@
+import { CustomJSONStringify as s } from "../../functions/utils/serialize.utils.mjs";
+import { BaseCacheDevice as h } from "./BaseCacheDevice.mjs";
+class l extends h {
+  isAttached = !1;
+  get(t) {
+    return this.getInMemory(t);
+  }
+  set(t, e) {
+    this.setInMemory(t, e);
+  }
+  serialize() {
+    return Object.fromEntries([...this.inMemoryCache].map(([t, e]) => [t, s(e)]));
+  }
+  attach(t) {
+    if (this.isAttached)
+      throw new Error("can't reattach cache device");
+    return this.isAttached = !0, (...r) => {
+      const a = s(r), c = this.get(a);
+      if (c !== void 0)
+        return c;
+      const i = t(...r);
+      return this.set(a, i), i;
+    };
+  }
+}
+export {
+  l as AttachableMemoryCacheDevice
+};

package/data-structures/cacheDevices/BaseCacheDevice.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class a{inMemoryCache=new Map;getInMemory(e){return this.inMemoryCache.get(e)??void 0}setInMemory(e,t){this.inMemoryCache.set(e,t)}}exports.BaseCacheDevice=a;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../../functions/utils/serialize.utils.cjs");class s{inMemoryCache=new Map;constructor(e){e&&this.mergeWithSerialized(e)}getInMemory(e){return this.inMemoryCache.get(e)??void 0}setInMemory(e,t){this.inMemoryCache.set(e,t)}mergeWithSerialized(e){Object.entries(e).forEach(([t,i])=>{this.set(t,r.CustomJSONParse(i))})}}exports.BaseCacheDevice=s;

package/data-structures/cacheDevices/BaseCacheDevice.d.ts

@@ -1,8 +1,11 @@
 import { ICacheDevice } from '../../types/ICacheDevice';
-export declare abstract class BaseCacheDevice implements ICacheDevice {
-    protected inMemoryCache: Map<string, string>;
-    protected getInMemory(key: string): string | undefined;
-    protected setInMemory(key: string, value: string): void;
-    abstract get(key: string): string | undefined;
-    abstract set(key: string, value: string): void;
+export declare abstract class BaseCacheDevice<T = string> implements ICacheDevice<T> {
+    protected inMemoryCache: Map<string, T>;
+    constructor(serialized?: Record<string, string>);
+    protected getInMemory(key: string): T | undefined;
+    protected setInMemory(key: string, value: T): void;
+    abstract get(key: string): T | undefined;
+    abstract set(key: string, value: T): void;
+    abstract serialize(): Record<string, string>;
+    mergeWithSerialized(serialized: Record<string, string>): void;
 }

package/data-structures/cacheDevices/BaseCacheDevice.mjs

@@ -1,12 +1,21 @@
-class a {
+import { CustomJSONParse as i } from "../../functions/utils/serialize.utils.mjs";
+class h {
   inMemoryCache = /* @__PURE__ */ new Map();
+  constructor(e) {
+    e && this.mergeWithSerialized(e);
+  }
   getInMemory(e) {
     return this.inMemoryCache.get(e) ?? void 0;
   }
-  setInMemory(e, r) {
-    this.inMemoryCache.set(e, r);
+  setInMemory(e, t) {
+    this.inMemoryCache.set(e, t);
+  }
+  mergeWithSerialized(e) {
+    Object.entries(e).forEach(([t, r]) => {
+      this.set(t, i(r));
+    });
   }
 }
 export {
-  a as BaseCacheDevice
+  h as BaseCacheDevice
 };

package/data-structures/cacheDevices/FileCacheDevice.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../../error-handling/logError.cjs"),h=require("./BaseCacheDevice.cjs");class o extends h.BaseCacheDevice{filePath;useFileCache;constructor(e,i){super(),this.useFileCache=!!e,this.filePath=i,this.readFileFromDevice()}readFileFromDevice(){if(this.useFileCache&&this.filePath)try{const e=require("fs");if(e.existsSync(this.filePath)){const i=JSON.parse(e.readFileSync(this.filePath).toString());Object.entries(i).forEach(([s,c])=>{this.setInMemory(s,c)})}}catch(e){r.logError("FileCacheDevice Constructor Error",{err:e})}}get(e){return this.getInMemory(e)}set(e,i){if(this.readFileFromDevice(),this.setInMemory(e,i),this.useFileCache&&this.filePath)try{require("fs").writeFileSync(this.filePath,JSON.stringify(Object.fromEntries(this.inMemoryCache)))}catch(t){r.logError("FileCacheDevice set function",{err:t})}}}exports.FileCacheDevice=o;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("../../functions/utils/serialize.utils.cjs"),r=require("../../error-handling/logError.cjs"),o=require("./BaseCacheDevice.cjs");class a extends o.BaseCacheDevice{filePath;useFileCache;constructor(e,i){super(),this.useFileCache=!!e,this.filePath=i,this.readFileFromDevice()}readFileFromDevice(){if(this.useFileCache&&this.filePath)try{const e=require("fs");if(e.existsSync(this.filePath)){const i=JSON.parse(e.readFileSync(this.filePath).toString());Object.entries(i).forEach(([s,c])=>{this.setInMemory(s,c)})}}catch(e){r.logError("FileCacheDevice Constructor Error",{err:e})}}get(e){return this.getInMemory(e)}set(e,i){if(this.readFileFromDevice(),this.setInMemory(e,i),this.useFileCache&&this.filePath)try{require("fs").writeFileSync(this.filePath,JSON.stringify(Object.fromEntries(this.inMemoryCache)))}catch(t){r.logError("FileCacheDevice set function",{err:t})}}serialize(){return Object.fromEntries([...this.inMemoryCache].map(([e,i])=>[e,h.CustomJSONStringify(i)]))}}exports.FileCacheDevice=a;

package/data-structures/cacheDevices/FileCacheDevice.d.ts

@@ -6,4 +6,5 @@ export declare class FileCacheDevice extends BaseCacheDevice {
     private readFileFromDevice;
     get(key: string): string | undefined;
     set(key: string, value: string): void;
+    serialize(): Record<string, string>;
 }