@hinkal/common 0.2.13 → 0.2.14

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>;
 }

package/data-structures/cacheDevices/FileCacheDevice.mjs

@@ -1,6 +1,7 @@
+import { CustomJSONStringify as h } from "../../functions/utils/serialize.utils.mjs";
 import { logError as r } from "../../error-handling/logError.mjs";
-import { BaseCacheDevice as h } from "./BaseCacheDevice.mjs";
-class l extends h {
+import { BaseCacheDevice as o } from "./BaseCacheDevice.mjs";
+class m extends o {
   filePath;
   useFileCache;
   constructor(e, i) {
@@ -31,7 +32,10 @@ class l extends h {
         r("FileCacheDevice set function", { err: t });
       }
   }
+  serialize() {
+    return Object.fromEntries([...this.inMemoryCache].map(([e, i]) => [e, h(i)]));
+  }
 }
 export {
-  l as FileCacheDevice
+  m as FileCacheDevice
 };

package/data-structures/cacheDevices/LocalStorageCacheDevice.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./BaseCacheDevice.cjs");class o extends a.BaseCacheDevice{localDataStorage;constructor(){super(),typeof localStorage<"u"&&(this.localDataStorage=localStorage)}get(e){return this.localDataStorage?this.localDataStorage.getItem(e)??void 0:this.getInMemory(e)}set(e,t){this.localDataStorage?this.localDataStorage.setItem(e,t):this.setInMemory(e,t)}}exports.LocalStorageCacheDevice=o;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("../../functions/utils/serialize.utils.cjs"),r=require("./BaseCacheDevice.cjs");class i extends r.BaseCacheDevice{localDataStorage;constructor(e,t){super(),!e&&typeof localStorage<"u"&&(this.localDataStorage=localStorage),t&&this.mergeWithSerialized(t)}get(e){return this.localDataStorage?this.localDataStorage.getItem(e)??void 0:this.getInMemory(e)}set(e,t){this.localDataStorage?this.localDataStorage.setItem(e,t):this.setInMemory(e,t)}serialize(){const e=this.localDataStorage?Object.entries(localStorage):[...this.inMemoryCache];return Object.fromEntries(e.map(([t,a])=>[t,o.CustomJSONStringify(a)]))}}exports.LocalStorageCacheDevice=i;

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

@@ -1,7 +1,8 @@
 import { BaseCacheDevice } from './BaseCacheDevice';
 export declare class LocalStorageCacheDevice extends BaseCacheDevice {
     private localDataStorage;
-    constructor();
+    constructor(disableCaching?: boolean, serializedCache?: Record<string, string>);
     get(key: string): string | undefined;
     set(key: string, value: string): void;
+    serialize(): Record<string, string>;
 }

package/data-structures/cacheDevices/LocalStorageCacheDevice.mjs

@@ -1,8 +1,9 @@
-import { BaseCacheDevice as a } from "./BaseCacheDevice.mjs";
-class l extends a {
+import { CustomJSONStringify as o } from "../../functions/utils/serialize.utils.mjs";
+import { BaseCacheDevice as r } from "./BaseCacheDevice.mjs";
+class c extends r {
   localDataStorage;
-  constructor() {
-    super(), typeof localStorage < "u" && (this.localDataStorage = localStorage);
+  constructor(t, e) {
+    super(), !t && typeof localStorage < "u" && (this.localDataStorage = localStorage), e && this.mergeWithSerialized(e);
   }
   get(t) {
     return this.localDataStorage ? this.localDataStorage.getItem(t) ?? void 0 : this.getInMemory(t);
@@ -10,7 +11,11 @@ class l extends a {
   set(t, e) {
     this.localDataStorage ? this.localDataStorage.setItem(t, e) : this.setInMemory(t, e);
   }
+  serialize() {
+    const t = this.localDataStorage ? Object.entries(localStorage) : [...this.inMemoryCache];
+    return Object.fromEntries(t.map(([e, a]) => [e, o(a)]));
+  }
 }
 export {
-  l as LocalStorageCacheDevice
+  c as LocalStorageCacheDevice
 };

package/data-structures/crypto-keys/decodeUTXO.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const U=require("ethers"),x=require("../utxo/Utxo.cjs"),m=require("./keys.cjs"),i=e=>{const t=U.ethers.utils.defaultAbiCoder.decode(["uint256","address","tuple(uint256, uint256, uint256, uint256)","uint256","uint256"],e),n=t[0].toBigInt(),r=t[1],s=t[2][0].toBigInt(),o=t[2][1].toHexString(),c=t[2][2].toBigInt(),u=t[2][3].toBigInt(),a=t[3].toString(),g=t[4].toNumber();return{amount:n,erc20TokenAddress:r,randomization:s,stealthAddress:o,H0:c,H1:u,timeStamp:a,tokenId:g}},d=(e,t)=>{const{amount:n,erc20TokenAddress:r,timeStamp:s,tokenId:o,randomization:c}=i(e);return{amount:n,erc20TokenAddress:r,timeStamp:s,tokenId:o,randomization:c,shieldedPrivateKey:t}},l=(e,t)=>new x.Utxo(d(e,t)),S=(e,t)=>{const{randomization:n,H0:r,H1:s}=i(e),o=m.UserKeys.checkSignature(n,r,s,t);if(!o)throw new Error("UTXO doesn't belong to user");return o};exports.abiDecodeUtxo=i;exports.checkUtxoSignature=S;exports.decodeUtxo=l;exports.decodeUtxoConstructorArgs=d;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const U=require("ethers"),x=require("../utxo/Utxo.cjs"),l=require("./keys.cjs"),i=e=>{const t=U.ethers.utils.defaultAbiCoder.decode(["uint256","address","tuple(uint256, uint256, uint256, uint256)","uint256","uint256"],e),n=t[0].toBigInt(),r=t[1],s=t[2][0].toBigInt(),o=t[2][1].toHexString(),c=t[2][2].toBigInt(),d=t[2][3].toBigInt(),a=t[3].toString(),g=t[4].toNumber();return{amount:n,erc20TokenAddress:r,randomization:s,stealthAddress:o,H0:c,H1:d,timeStamp:a,tokenId:g}},u=(e,t)=>{const{amount:n,erc20TokenAddress:r,timeStamp:s,tokenId:o,randomization:c,stealthAddress:d}=i(e);return{amount:n,erc20TokenAddress:r,timeStamp:s,tokenId:o,randomization:c,shieldedPrivateKey:t,stealthAddress:d}},m=(e,t)=>new x.Utxo(u(e,t)),h=(e,t)=>{const{randomization:n,H0:r,H1:s}=i(e),o=l.UserKeys.checkSignature(n,r,s,t);if(!o)throw new Error("UTXO doesn't belong to user");return o};exports.abiDecodeUtxo=i;exports.checkUtxoSignature=h;exports.decodeUtxo=m;exports.decodeUtxoConstructorArgs=u;

package/data-structures/crypto-keys/decodeUTXO.mjs

@@ -5,36 +5,37 @@ const c = (o) => {
   const t = m.utils.defaultAbiCoder.decode(
     ["uint256", "address", "tuple(uint256, uint256, uint256, uint256)", "uint256", "uint256"],
     o
-  ), e = t[0].toBigInt(), r = t[1], s = t[2][0].toBigInt(), n = t[2][1].toHexString(), i = t[2][2].toBigInt(), d = t[2][3].toBigInt(), u = t[3].toString(), a = t[4].toNumber();
+  ), n = t[0].toBigInt(), r = t[1], s = t[2][0].toBigInt(), e = t[2][1].toHexString(), i = t[2][2].toBigInt(), d = t[2][3].toBigInt(), u = t[3].toString(), a = t[4].toNumber();
   return {
-    amount: e,
+    amount: n,
     erc20TokenAddress: r,
     randomization: s,
-    stealthAddress: n,
+    stealthAddress: e,
     H0: i,
     H1: d,
     timeStamp: u,
     tokenId: a
   };
 }, U = (o, t) => {
-  const { amount: e, erc20TokenAddress: r, timeStamp: s, tokenId: n, randomization: i } = c(o);
+  const { amount: n, erc20TokenAddress: r, timeStamp: s, tokenId: e, randomization: i, stealthAddress: d } = c(o);
   return {
-    amount: e,
+    amount: n,
     erc20TokenAddress: r,
     timeStamp: s,
-    tokenId: n,
+    tokenId: e,
     randomization: i,
-    shieldedPrivateKey: t
+    shieldedPrivateKey: t,
+    stealthAddress: d
   };
-}, k = (o, t) => new g(U(o, t)), I = (o, t) => {
-  const { randomization: e, H0: r, H1: s } = c(o), n = x.checkSignature(e, r, s, t);
-  if (!n)
+}, k = (o, t) => new g(U(o, t)), A = (o, t) => {
+  const { randomization: n, H0: r, H1: s } = c(o), e = x.checkSignature(n, r, s, t);
+  if (!e)
     throw new Error("UTXO doesn't belong to user");
-  return n;
+  return e;
 };
 export {
   c as abiDecodeUtxo,
-  I as checkUtxoSignature,
+  A as checkUtxoSignature,
   k as decodeUtxo,
   U as decodeUtxoConstructorArgs
 };

package/data-structures/crypto-keys/keys.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("ethers"),y=require("libsodium-wrappers"),g=require("../../constants/protocol.constants.cjs"),S=require("../../crypto/babyJub.cjs"),o=require("../../crypto/poseidon.cjs"),h=require("../../functions/utils/memoize.utils.cjs"),c=require("./keyUtils.cjs"),p={privateKey:"",publicKey:""};class K{signature;constructor(e){this.signature=e}getSignature(){return this.requireSignature(),this.signature}setSignature(e){this.signature=e}requireSignature(){if(!this.signature)throw Error("No signature provided")}verifyMessage(e){return this.requireSignature(),u.utils.verifyMessage(e,this.signature)}getShieldedPrivateKey=()=>(this.requireSignature(),u.ethers.utils.keccak256(this.signature));getShieldedPublicKey=()=>(this.requireSignature(),o.poseidonHash(this.getShieldedPrivateKey()));getAccessKey=()=>(this.requireSignature(),o.poseidonHash(this.getShieldedPrivateKey(),this.getShieldedPublicKey()));getWalletSalt=e=>(this.requireSignature(),o.poseidonHash(this.getShieldedPublicKey(),this.getShieldedPrivateKey(),e));getBackendToken=()=>(this.requireSignature(),o.poseidonHash(this.getAccessKey(),this.getShieldedPublicKey()));static getRandomizedStealthPair=h.memoizeFunc((e,i)=>{const t=S.babyJubInstance(),s=BigInt(i)%g.CIRCOM_P,n=e*s%g.CIRCOM_P,r=t.mulPointEscalar(t.Base8,e),a=t.mulPointEscalar(t.Base8,n),d=[BigInt(t.F.toString(r[0])),BigInt(t.F.toString(r[1]))],l=[BigInt(t.F.toString(a[0])),BigInt(t.F.toString(a[1]))];return{H0:d,H1:l}});static getStealthAddressCompressedPoints=(e,i)=>{const{H0:t,H1:s}=this.getRandomizedStealthPair(e,i),[n,r]=[t,s].map(a=>BigInt(a[1])+2n**255n*c.getCircomSign(a[0]));return{h0:n,h1:r}};static getStealthAddress=h.memoizeFunc((e,i)=>{const{H0:t,H1:s}=this.getRandomizedStealthPair(e,i),r=[2n*c.getCircomSign(t[0])+c.getCircomSign(s[0]),t[1],s[1]];return o.poseidonHash(...r)});static getStealthAddressWithEKey=(e,i)=>({stealthAddress:this.getStealthAddress(e,i),encryptionKey:this.getEncryptionKeyPair(i).publicKey});static checkSignature=(e,i,t,s)=>{const{h0:n,h1:r}=this.getStealthAddressCompressedPoints(e,s);return i===n&&t===r};static getEncryptionKeyPair=e=>{const i=y.crypto_box_seed_keypair(u.ethers.utils.arrayify(e));return{privateKey:u.ethers.utils.hexlify(i.privateKey),publicKey:u.ethers.utils.hexlify(i.publicKey)}}}exports.EncryptionKeyPairDefaultValue=p;exports.UserKeys=K;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("ethers"),p=require("libsodium-wrappers"),u=require("../../constants/protocol.constants.cjs"),K=require("../../crypto/babyJub.cjs"),a=require("../../crypto/poseidon.cjs"),o=require("./keyUtils.cjs"),g=require("../cacheDevices/AttachableMemoryCacheDevice.cjs"),d=new g.AttachableMemoryCacheDevice,l=new g.AttachableMemoryCacheDevice,P={privateKey:"",publicKey:""};class b{signature;constructor(e){this.signature=e}getSignature(){return this.requireSignature(),this.signature}setSignature(e){this.signature=e}requireSignature(){if(!this.signature)throw Error("No signature provided")}verifyMessage(e){return this.requireSignature(),h.utils.verifyMessage(e,this.signature)}getShieldedPrivateKey=()=>(this.requireSignature(),h.ethers.utils.keccak256(this.signature));getShieldedPublicKey=()=>(this.requireSignature(),a.poseidonHash(this.getShieldedPrivateKey()));getAccessKey=()=>(this.requireSignature(),a.poseidonHash(this.getShieldedPrivateKey(),this.getShieldedPublicKey()));getWalletSalt=e=>(this.requireSignature(),a.poseidonHash(this.getShieldedPublicKey(),this.getShieldedPrivateKey(),e));getInHinkalAddress=e=>{this.requireSignature();const t=a.poseidonHash(this.getShieldedPrivateKey(),e);return BigInt(t)};getBackendToken=()=>(this.requireSignature(),a.poseidonHash(this.getAccessKey(),this.getShieldedPublicKey()));static getRandomizedStealthPair=d.attach((e,t)=>{const i=K.babyJubInstance(),s=BigInt(t)%u.CIRCOM_P,n=e*s%u.CIRCOM_P,r=i.mulPointEscalar(i.Base8,e),c=i.mulPointEscalar(i.Base8,n),y=[BigInt(i.F.toString(r[0])),BigInt(i.F.toString(r[1]))],S=[BigInt(i.F.toString(c[0])),BigInt(i.F.toString(c[1]))];return{H0:y,H1:S}});static getStealthAddressCompressedPoints=(e,t)=>{const{H0:i,H1:s}=this.getRandomizedStealthPair(e,t),[n,r]=[i,s].map(c=>BigInt(c[1])+2n**255n*o.getCircomSign(c[0]));return{h0:n,h1:r}};static getStealthAddress=l.attach((e,t)=>{const{H0:i,H1:s}=this.getRandomizedStealthPair(e,t),r=[2n*o.getCircomSign(i[0])+o.getCircomSign(s[0]),i[1],s[1]];return a.poseidonHash(...r)});static getStealthAddressWithEKey=(e,t)=>({stealthAddress:this.getStealthAddress(e,t),encryptionKey:this.getEncryptionKeyPair(t).publicKey});static checkSignature=(e,t,i,s)=>{const{h0:n,h1:r}=this.getStealthAddressCompressedPoints(e,s);return t===n&&i===r};static getEncryptionKeyPair=e=>{const t=p.crypto_box_seed_keypair(h.ethers.utils.arrayify(e));return{privateKey:h.ethers.utils.hexlify(t.privateKey),publicKey:h.ethers.utils.hexlify(t.publicKey)}}}exports.EncryptionKeyPairDefaultValue=P;exports.UserKeys=b;exports.stealthAddressCacheDevice=l;exports.stealthPairCacheDevice=d;

package/data-structures/crypto-keys/keys.d.ts

@@ -1,4 +1,9 @@
-import { JubPoint } from '../../crypto/babyJub';
+import { AttachableMemoryCacheDevice } from '../cacheDevices/AttachableMemoryCacheDevice';
+export declare const stealthPairCacheDevice: AttachableMemoryCacheDevice<{
+    H0: [bigint, bigint];
+    H1: [bigint, bigint];
+}>;
+export declare const stealthAddressCacheDevice: AttachableMemoryCacheDevice<string>;
 export interface EncryptionKeyPair {
     privateKey: string;
     publicKey: string;
@@ -30,14 +35,19 @@ export declare class UserKeys {
      */
     getAccessKey: () => string;
     getWalletSalt: (walletNonce: bigint) => string;
+    /**
+     * generate inHinkalAddress - a user unique address linking him with a specific app
+     * @returns inHinkalAddress in bigint
+     */
+    getInHinkalAddress: (interactionAddress: string) => bigint;
     /**
      * generate backend token, which is used for access control on backend
      * @returns accessKey in hexstring with 0x prefixed
      */
     getBackendToken: () => string;
     static getRandomizedStealthPair: (s: bigint, privateKey: string) => {
-        H0: JubPoint;
-        H1: JubPoint;
+        H0: [bigint, bigint];
+        H1: [bigint, bigint];
     };
     static getStealthAddressCompressedPoints: (s: bigint, privateKey: string) => {
         h0: bigint;

package/data-structures/crypto-keys/keys.mjs

@@ -1,31 +1,31 @@
 import { utils as y, ethers as o } from "ethers";
 import S from "libsodium-wrappers";
-import { CIRCOM_P as h } from "../../constants/protocol.constants.mjs";
+import { CIRCOM_P as g } from "../../constants/protocol.constants.mjs";
 import { babyJubInstance as m } from "../../crypto/babyJub.mjs";
-import { poseidonHash as u } from "../../crypto/poseidon.mjs";
-import { memoizeFunc as c } from "../../functions/utils/memoize.utils.mjs";
-import { getCircomSign as g } from "./keyUtils.mjs";
-const q = {
+import { poseidonHash as a } from "../../crypto/poseidon.mjs";
+import { getCircomSign as u } from "./keyUtils.mjs";
+import { AttachableMemoryCacheDevice as c } from "../cacheDevices/AttachableMemoryCacheDevice.mjs";
+const p = new c(), K = new c(), H = {
   privateKey: "",
   publicKey: ""
 };
-class H {
+class k {
   signature;
-  constructor(t) {
-    this.signature = t;
+  constructor(e) {
+    this.signature = e;
   }
   getSignature() {
     return this.requireSignature(), this.signature;
   }
-  setSignature(t) {
-    this.signature = t;
+  setSignature(e) {
+    this.signature = e;
   }
   requireSignature() {
     if (!this.signature)
       throw Error("No signature provided");
   }
-  verifyMessage(t) {
-    return this.requireSignature(), y.verifyMessage(t, this.signature);
+  verifyMessage(e) {
+    return this.requireSignature(), y.verifyMessage(e, this.signature);
   }
   /**
    * get shielded private key from message signature used to login to the application,
@@ -39,51 +39,62 @@ class H {
    * that the user provided
    * @retuns shielded public key in hexstring with 0x prefixed
    */
-  getShieldedPublicKey = () => (this.requireSignature(), u(this.getShieldedPrivateKey()));
+  getShieldedPublicKey = () => (this.requireSignature(), a(this.getShieldedPrivateKey()));
   /**
    * generate access token, this accessKey is what should be sent to the server for signing
    * @returns accessKey in hexstring with 0x prefixed
    */
-  getAccessKey = () => (this.requireSignature(), u(this.getShieldedPrivateKey(), this.getShieldedPublicKey()));
-  getWalletSalt = (t) => (this.requireSignature(), u(this.getShieldedPublicKey(), this.getShieldedPrivateKey(), t));
+  getAccessKey = () => (this.requireSignature(), a(this.getShieldedPrivateKey(), this.getShieldedPublicKey()));
+  getWalletSalt = (e) => (this.requireSignature(), a(this.getShieldedPublicKey(), this.getShieldedPrivateKey(), e));
+  /**
+   * generate inHinkalAddress - a user unique address linking him with a specific app
+   * @returns inHinkalAddress in bigint
+   */
+  getInHinkalAddress = (e) => {
+    this.requireSignature();
+    const t = a(this.getShieldedPrivateKey(), e);
+    return BigInt(t);
+  };
   /**
    * generate backend token, which is used for access control on backend
    * @returns accessKey in hexstring with 0x prefixed
    */
-  getBackendToken = () => (this.requireSignature(), u(this.getAccessKey(), this.getShieldedPublicKey()));
-  static getRandomizedStealthPair = c(
-    (t, i) => {
-      const e = m(), r = BigInt(i) % h, n = t * r % h, s = e.mulPointEscalar(e.Base8, t), a = e.mulPointEscalar(e.Base8, n), d = [BigInt(e.F.toString(s[0])), BigInt(e.F.toString(s[1]))], l = [BigInt(e.F.toString(a[0])), BigInt(e.F.toString(a[1]))];
+  getBackendToken = () => (this.requireSignature(), a(this.getAccessKey(), this.getShieldedPublicKey()));
+  static getRandomizedStealthPair = p.attach(
+    (e, t) => {
+      const i = m(), r = BigInt(t) % g, n = e * r % g, s = i.mulPointEscalar(i.Base8, e), h = i.mulPointEscalar(i.Base8, n), d = [BigInt(i.F.toString(s[0])), BigInt(i.F.toString(s[1]))], l = [BigInt(i.F.toString(h[0])), BigInt(i.F.toString(h[1]))];
       return { H0: d, H1: l };
     }
   );
-  static getStealthAddressCompressedPoints = (t, i) => {
-    const { H0: e, H1: r } = this.getRandomizedStealthPair(t, i), [n, s] = [e, r].map((a) => BigInt(a[1]) + 2n ** 255n * g(a[0]));
+  static getStealthAddressCompressedPoints = (e, t) => {
+    const { H0: i, H1: r } = this.getRandomizedStealthPair(e, t), [n, s] = [i, r].map((h) => BigInt(h[1]) + 2n ** 255n * u(h[0]));
     return { h0: n, h1: s };
   };
-  static getStealthAddress = c((t, i) => {
-    const { H0: e, H1: r } = this.getRandomizedStealthPair(t, i), s = [2n * g(e[0]) + g(r[0]), e[1], r[1]];
-    return u(...s);
+  static getStealthAddress = K.attach((e, t) => {
+    const { H0: i, H1: r } = this.getRandomizedStealthPair(e, t), s = [2n * u(i[0]) + u(r[0]), i[1], r[1]];
+    return a(...s);
   });
-  static getStealthAddressWithEKey = (t, i) => ({ stealthAddress: this.getStealthAddress(t, i), encryptionKey: this.getEncryptionKeyPair(i).publicKey });
-  static checkSignature = (t, i, e, r) => {
-    const { h0: n, h1: s } = this.getStealthAddressCompressedPoints(t, r);
-    return i === n && e === s;
+  static getStealthAddressWithEKey = (e, t) => ({ stealthAddress: this.getStealthAddress(e, t), encryptionKey: this.getEncryptionKeyPair(t).publicKey });
+  static checkSignature = (e, t, i, r) => {
+    const { h0: n, h1: s } = this.getStealthAddressCompressedPoints(e, r);
+    return t === n && i === s;
   };
   /**
    * generate private and public keypair
    * @param seed seed to use to deterministically generate key, must be in DataHexString format
    * and must correspond to 32 bytes
    */
-  static getEncryptionKeyPair = (t) => {
-    const i = S.crypto_box_seed_keypair(o.utils.arrayify(t));
+  static getEncryptionKeyPair = (e) => {
+    const t = S.crypto_box_seed_keypair(o.utils.arrayify(e));
     return {
-      privateKey: o.utils.hexlify(i.privateKey),
-      publicKey: o.utils.hexlify(i.publicKey)
+      privateKey: o.utils.hexlify(t.privateKey),
+      publicKey: o.utils.hexlify(t.publicKey)
     };
   };
 }
 export {
-  q as EncryptionKeyPairDefaultValue,
-  H as UserKeys
+  H as EncryptionKeyPairDefaultValue,
+  k as UserKeys,
+  K as stealthAddressCacheDevice,
+  p as stealthPairCacheDevice
 };

package/data-structures/custom-token-registry/CustomTokenRegistry.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class o{localStorageKey="tokenRegistry";tokenRegistry;constructor(){if(this.tokenRegistry=[],typeof localStorage<"u"){const t=localStorage.getItem(this.localStorageKey);t&&(this.tokenRegistry=JSON.parse(t))}}persistRegistry(){typeof localStorage<"u"&&localStorage.setItem(this.localStorageKey,JSON.stringify(this.tokenRegistry))}getCustomTokens(t){return this.tokenRegistry.filter(e=>e.chainId===t)}tokenExists(t,e){return t.find(s=>s.erc20TokenAddress===e.erc20TokenAddress||s.symbol===e.symbol||s.name===e.name)}addCustomToken(t){const{chainId:e}=t,s=this.getCustomTokens(e);this.tokenExists(s,t)||this.tokenRegistry.push(t),this.persistRegistry()}removeCustomToken(t){const{chainId:e}=t,r=this.getCustomTokens(e).filter(i=>i.erc20TokenAddress!==t.erc20TokenAddress);this.tokenRegistry=r,this.persistRegistry()}}const n=new o;exports.customTokenRegistry=n;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class i{tokenRegistry;constructor(){this.tokenRegistry=[]}setTokensFromCache(s){this.tokenRegistry=s}getCustomTokens(s){return this.tokenRegistry.filter(t=>t.chainId===s)}tokenExists(s,t){return s.find(e=>e.erc20TokenAddress===t.erc20TokenAddress||e.symbol===t.symbol||e.name===t.name)}addCustomToken(s){const{chainId:t}=s,e=this.getCustomTokens(t);this.tokenExists(e,s)||this.tokenRegistry.push(s)}removeCustomToken(s){const{chainId:t}=s,r=this.getCustomTokens(t).filter(o=>o.erc20TokenAddress!==s.erc20TokenAddress);this.tokenRegistry=r}}const n=new i;exports.customTokenRegistry=n;

package/data-structures/custom-token-registry/CustomTokenRegistry.d.ts

@@ -1,9 +1,8 @@
-import { ERC20Token } from '../../types/token.types';
+import { ERC20Token } from '../../types';
 declare class CustomTokenRegistry {
-    private localStorageKey;
     tokenRegistry: ERC20Token[];
     constructor();
-    private persistRegistry;
+    setTokensFromCache(newTokenRegistries: ERC20Token[]): void;
     getCustomTokens(chainId: number): ERC20Token[];
     tokenExists(registry: ERC20Token[], tokenToCheck: ERC20Token): ERC20Token | undefined;
     addCustomToken(token: ERC20Token): void;

package/data-structures/custom-token-registry/CustomTokenRegistry.mjs

@@ -1,33 +1,29 @@
-class o {
-  localStorageKey = "tokenRegistry";
+class i {
   tokenRegistry;
   constructor() {
-    if (this.tokenRegistry = [], typeof localStorage < "u") {
-      const t = localStorage.getItem(this.localStorageKey);
-      t && (this.tokenRegistry = JSON.parse(t));
-    }
+    this.tokenRegistry = [];
   }
-  persistRegistry() {
-    typeof localStorage < "u" && localStorage.setItem(this.localStorageKey, JSON.stringify(this.tokenRegistry));
+  setTokensFromCache(s) {
+    this.tokenRegistry = s;
   }
-  getCustomTokens(t) {
-    return this.tokenRegistry.filter((s) => s.chainId === t);
+  getCustomTokens(s) {
+    return this.tokenRegistry.filter((t) => t.chainId === s);
   }
-  tokenExists(t, s) {
-    return t.find(
-      (e) => e.erc20TokenAddress === s.erc20TokenAddress || e.symbol === s.symbol || e.name === s.name
+  tokenExists(s, t) {
+    return s.find(
+      (e) => e.erc20TokenAddress === t.erc20TokenAddress || e.symbol === t.symbol || e.name === t.name
     );
   }
-  addCustomToken(t) {
-    const { chainId: s } = t, e = this.getCustomTokens(s);
-    this.tokenExists(e, t) || this.tokenRegistry.push(t), this.persistRegistry();
+  addCustomToken(s) {
+    const { chainId: t } = s, e = this.getCustomTokens(t);
+    this.tokenExists(e, s) || this.tokenRegistry.push(s);
   }
-  removeCustomToken(t) {
-    const { chainId: s } = t, r = this.getCustomTokens(s).filter((i) => i.erc20TokenAddress !== t.erc20TokenAddress);
-    this.tokenRegistry = r, this.persistRegistry();
+  removeCustomToken(s) {
+    const { chainId: t } = s, r = this.getCustomTokens(t).filter((n) => n.erc20TokenAddress !== s.erc20TokenAddress);
+    this.tokenRegistry = r;
   }
 }
-const g = new o();
+const c = new i();
 export {
-  g as customTokenRegistry
+  c as customTokenRegistry
 };

package/data-structures/event-service/AbstractAccessTokenSnapshotService.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("../../constants/protocol.constants.cjs"),c=require("../../crypto/poseidon.cjs");require("circomlibjs-hinkal-fork");require("libsodium-wrappers");require("process");require("buffer");const n=require("../../functions/utils/amounts.utils.cjs"),o=require("../merkle-tree/MerkleTree.cjs"),u=require("./AbstractSnapshotService.cjs");class A extends u.AbstractSnapshotService{constructor(e,s,r,d){super(e,{name:"NewAccessKeyAdded",args:["accessKey","index","senderAddress"]},s,r,d)}_merkleTree;_senderAddresses;_senderAddressIndexMap;get merkleTree(){return this._merkleTree}get senderAddresses(){return this._senderAddresses}get senderAddressIndexMap(){return this._senderAddressIndexMap}serializeSnapshot(e){return{merkleTree:e.payload.merkleTree.toJSON(),senderAddresses:Array.from(e.payload.senderAddresses),latestBlockNumber:e.latestBlockNumber,reserveBlockNumber:e.reserveBlockNumber,senderAddressIndexMap:Array.from(e.payload.senderAddressIndexMap).map(([s,r])=>({address:s,index:r}))}}deserializeSnapshot(e){let s,r;if(e.latestBlockNumber&&e.merkleTree){const d=new Map(Object.entries(e.merkleTree.tree).map(([t,a])=>[BigInt(t),BigInt(a)]));s=o.MerkleTree.createWithData(d,n.toBigInt(e.merkleTree.index),n.toBigInt(e.merkleTree.count),c.poseidonFunction,25n,0n)}else s=o.MerkleTree.create(c.poseidonFunction,25n,0n);return e.latestBlockNumber&&e.senderAddressIndexMap?r=new Map(e.senderAddressIndexMap.map(({address:d,index:t})=>[d,t])):r=new Map,{latestBlockNumber:e.latestBlockNumber??0,reserveBlockNumber:e.reserveBlockNumber??0,payload:{merkleTree:s,senderAddresses:e.senderAddresses??[],senderAddressIndexMap:r}}}acceptEvent(e,s){try{return this._merkleTree.insert(e.accessKey,e.index),this._senderAddressIndexMap.set(e.senderAddress,Math.max(Number(e.index),this._senderAddressIndexMap.get(e.senderAddress)??0)),this._senderAddresses.includes(e.senderAddress)||this._senderAddresses.push(e.senderAddress),e.accessKey===0n&&e.senderAddress===l.zeroAddress&&this._merkleTree.remove(e.index),!0}catch(r){return console.error(r),!1}}mapEvent(e){const{accessKey:s,index:r,senderAddress:d}=e;return{accessKey:n.toBigInt(s),index:n.toBigInt(r),senderAddress:d}}getSnapshotPayload(){return{merkleTree:this._merkleTree,senderAddresses:this._senderAddresses,senderAddressIndexMap:this._senderAddressIndexMap}}populateSnapshot({payload:{merkleTree:e,senderAddresses:s,senderAddressIndexMap:r}}){this._merkleTree=e,this._senderAddresses=s,this._senderAddressIndexMap=r}}exports.AbstractAccessTokenSnapshotService=A;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("../../constants/protocol.constants.cjs"),a=require("../../crypto/poseidon.cjs");require("circomlibjs-hinkal-fork");require("libsodium-wrappers");require("process");require("buffer");const n=require("../../functions/utils/amounts.utils.cjs"),o=require("../merkle-tree/MerkleTree.cjs");require("ethers");require("../../error-handling/error-codes.constants.cjs");const l=require("./AbstractSnapshotService.cjs"),u=require("../../functions/utils/merkleTree.utils.cjs");class i extends l.AbstractSnapshotService{constructor(e,s,r,d){super(e,{name:"NewAccessKeyAdded",args:["accessKey","index","senderAddress"]},s,r,d)}_merkleTree;_senderAddresses;_senderAddressIndexMap;get merkleTree(){return this._merkleTree}get senderAddresses(){return this._senderAddresses}get senderAddressIndexMap(){return this._senderAddressIndexMap}serializeSnapshot(e){return{merkleTree:e.payload.merkleTree.toJSON(),senderAddresses:Array.from(e.payload.senderAddresses),latestBlockNumber:e.latestBlockNumber,reserveBlockNumber:e.reserveBlockNumber,senderAddressIndexMap:Array.from(e.payload.senderAddressIndexMap).map(([s,r])=>({address:s,index:r}))}}deserializeSnapshot(e){let s,r;return e.latestBlockNumber&&e.merkleTree?s=u.contructMerkleTreeFromSerialized(e.merkleTree):s=o.MerkleTree.create(a.poseidonFunction,25n,0n),e.latestBlockNumber&&e.senderAddressIndexMap?r=new Map(e.senderAddressIndexMap.map(({address:d,index:t})=>[d,t])):r=new Map,{latestBlockNumber:e.latestBlockNumber??0,reserveBlockNumber:e.reserveBlockNumber??0,payload:{merkleTree:s,senderAddresses:e.senderAddresses??[],senderAddressIndexMap:r}}}acceptEvent(e,s){try{return this._merkleTree.insert(e.accessKey,e.index),this._senderAddressIndexMap.set(e.senderAddress,Math.max(Number(e.index),this._senderAddressIndexMap.get(e.senderAddress)??0)),this._senderAddresses.includes(e.senderAddress)||this._senderAddresses.push(e.senderAddress),e.accessKey===0n&&e.senderAddress===c.zeroAddress&&this._merkleTree.remove(e.index),!0}catch(r){return console.error(r),!1}}mapEvent(e){const{accessKey:s,index:r,senderAddress:d}=e;return{accessKey:n.toBigInt(s),index:n.toBigInt(r),senderAddress:d}}getSnapshotPayload(){return{merkleTree:this._merkleTree,senderAddresses:this._senderAddresses,senderAddressIndexMap:this._senderAddressIndexMap}}populateSnapshot({payload:{merkleTree:e,senderAddresses:s,senderAddressIndexMap:r}}){this._merkleTree=e,this._senderAddresses=s,this._senderAddressIndexMap=r}}exports.AbstractAccessTokenSnapshotService=i;