@sabaaa1/common 0.1.14 → 0.2.28

package/common/src/data-structures/IndexedDB/signatures-db.mjs

@@ -0,0 +1,40 @@
+import { StorageKeys as e } from "../../types/cache.types.mjs";
+import "../../types/index.mjs";
+import { Logger as t } from "../../error-handling/logger.mjs";
+import "../../error-handling/index.mjs";
+import { get as n, set as r } from "idb-keyval";
+new class {
+	generateMessageId() {
+		return `msg_${(/* @__PURE__ */ new Date()).getTime()}_${Math.random().toString(36).substring(2, 15)}`;
+	}
+	async saveSignedMessage(i, a, o, s, c, l) {
+		try {
+			let t = this.generateMessageId(), u = await n(e.SIGNED_MESSAGES) || {}, d = {
+				chainId: i,
+				messageText: a,
+				messageType: o,
+				subAccountAddress: s,
+				signature: c,
+				appMetaData: l
+			};
+			u[t] = {
+				timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+				...d
+			}, await r(e.SIGNED_MESSAGES, u);
+		} catch (e) {
+			t.error("Failed to save signed message:", e, {
+				chainId: i,
+				messageType: o
+			});
+		}
+	}
+	async getAllSignedMessages() {
+		try {
+			let t = await n(e.SIGNED_MESSAGES) || {};
+			return Object.values(t).sort((e, t) => new Date(t.timestamp).getTime() - new Date(e.timestamp).getTime());
+		} catch (e) {
+			return t.error("Failed to retrieve signed messages:", e), [];
+		}
+	}
+}();
+//#endregion

package/common/src/data-structures/MultiThreadedUtxoUtils/MultiThreadedUtxoUtils.cjs

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

package/common/src/data-structures/MultiThreadedUtxoUtils/MultiThreadedUtxoUtils.d.ts

@@ -0,0 +1,20 @@
+import { EncryptedOutputWithSign, OutputsWithSignAndLast } from '../../types/commitments.types';
+import { IMultiThreadedUtxoUtils } from '../../types/IMultiThreadedUtxoUtils';
+import { UserKeys } from '../crypto-keys/keys';
+import { Utxo } from '../utxo/Utxo';
+declare global {
+    interface Navigator {
+        deviceMemory: number | undefined;
+    }
+}
+export declare class MultiThreadedUtxoUtils implements IMultiThreadedUtxoUtils {
+    readonly NUM_WORKERS: number;
+    readonly NUM_WORKERS_BATCH_PROCESS: number;
+    constructor();
+    private createUtxoPromise;
+    batchFilterUtxosWithNullifier(allUtxos: Utxo[], nullifiers: Set<string>): Promise<Utxo[]>;
+    buildBatchProcess(encryptedOutputs: EncryptedOutputWithSign[], userKeys: UserKeys, chainId: number): Promise<Utxo[]>;
+    private sliceArrayIntoParts;
+    findLastOutput(lastOutputsArray: string[], lastOutput: string): string;
+    batchProcess(encryptedOutputs: EncryptedOutputWithSign[], lastOutput: string, userKeys: UserKeys, chainId: number): Promise<OutputsWithSignAndLast<boolean>>;
+}

package/common/src/data-structures/MultiThreadedUtxoUtils/MultiThreadedUtxoUtils.mjs

@@ -0,0 +1,73 @@
+import { isNode as e } from "../../constants/vite.constants.mjs";
+import { stealthAddressCacheDevice as t, stealthPairCacheDevice as n } from "../crypto-keys/keys.mjs";
+import { Utxo as r } from "../utxo/Utxo.mjs";
+import { WorkerVariant as i } from "../../webworker/worker.registry.mjs";
+import { performTaskWithWorker as a } from "../../webworker/performTaskWithWorker.mjs";
+import { UtxoWorkerActionType as o } from "../../webworker/utxoWorker/utxoWorker.types.mjs";
+//#region libs/shared/common/src/data-structures/MultiThreadedUtxoUtils/MultiThreadedUtxoUtils.ts
+var s = 16, c = class {
+	NUM_WORKERS;
+	NUM_WORKERS_BATCH_PROCESS;
+	constructor() {
+		e ? (this.NUM_WORKERS = 1, this.NUM_WORKERS_BATCH_PROCESS = 1) : (this.NUM_WORKERS = 3, this.NUM_WORKERS_BATCH_PROCESS = Math.min(s, Math.ceil(navigator.deviceMemory ?? 4)));
+	}
+	async createUtxoPromise(e) {
+		return await a({
+			type: i.UTXO,
+			payload: e
+		});
+	}
+	async batchFilterUtxosWithNullifier(e, i) {
+		let a = this.sliceArrayIntoParts(e, this.NUM_WORKERS).map((e) => this.createUtxoPromise({
+			type: o.BATCH_FILTER_UTXOS_WITH_NULLIFIER,
+			data: {
+				utxos: e.map((e) => e.getConstructableParams()),
+				nullifiers: i
+			}
+		})), s = await Promise.all(a);
+		return s.forEach((e) => {
+			n.mergeWithSerialized(e.stealthPairCache), t.mergeWithSerialized(e.stealthAddressCache);
+		}), s.flatMap((e) => e.utxoConstructors).map((e) => new r(e));
+	}
+	async buildBatchProcess(e, t, n) {
+		let i = this.sliceArrayIntoParts(e, this.NUM_WORKERS).map((e) => this.createUtxoPromise({
+			type: o.BUILD_UTXOS,
+			data: {
+				signature: t.getSignature(),
+				encryptedOutputs: e,
+				chainId: n
+			}
+		}));
+		return (await Promise.all(i)).flat().map((e) => new r(e));
+	}
+	sliceArrayIntoParts(e, t) {
+		let n = Math.ceil(e.length / t);
+		return Array.from({ length: t }, (t, r) => e.slice(n * r, n * (r + 1))).filter((e) => e.length > 0);
+	}
+	findLastOutput(e, t) {
+		let n = t;
+		return e.forEach((e) => {
+			e !== t && (n = e);
+		}), n;
+	}
+	async batchProcess(e, t, n, r) {
+		let i = this.sliceArrayIntoParts(e, this.NUM_WORKERS_BATCH_PROCESS), a = n.getSignature(), s = i.map((e) => {
+			let n = {
+				type: o.DECIPHER_OUTPUTS,
+				data: {
+					encryptedOutputs: e,
+					lastOutput: t,
+					signature: a,
+					chainId: r
+				}
+			};
+			return this.createUtxoPromise(n);
+		}), c = await Promise.all(s), l = c.map(({ additionalEncryptedOutputs: e }) => e).flat(), u = /* @__PURE__ */ new Set();
+		return {
+			additionalEncryptedOutputs: l.reduce((e, t) => u.has(t.value) ? e : (u.add(t.value), [...e, t]), []),
+			lastOutput: this.findLastOutput(c.map((e) => e.lastOutput), t) ?? t
+		};
+	}
+};
+//#endregion
+export { c as MultiThreadedUtxoUtils };

package/common/src/data-structures/TokenDBs/AlchemyPublicTokensDB.cjs

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../constants/chains.constants.cjs`),t=require(`../../constants/protocol.constants.cjs`),n=require(`../../types/cache.types.cjs`),r=require(`../../functions/utils/caseInsensitive.utils.cjs`),i=require(`../http/HttpClient.cjs`);require(`../http/index.cjs`);const a=require(`../../API/API.cjs`),o=require(`../../error-handling/logger.cjs`),s=require(`../../functions/utils/string.utils.cjs`),c=require(`./token-visibility-db.cjs`),l=require(`../../functions/utils/create-provider.cjs`),u=require(`../../functions/utils/publicBalance.utils.cjs`);let d=require(`@solana/web3.js`),f=require(`idb-keyval`),p=require(`@solana/spl-token`);var m=new class{fetchedTokens={};ALCHEMY_URLS={[e.chainIds.ethMainnet]:`eth-mainnet`,[e.chainIds.polygon]:`polygon-mainnet`,[e.chainIds.arbMainnet]:`arb-mainnet`,[e.chainIds.optimism]:`opt-mainnet`,[e.chainIds.base]:`base-mainnet`,[e.chainIds.solanaMainnet]:`solana-mainnet`};KNOWN_GOOD_NFTS={[e.chainIds.base]:[`0x20bc8d248fe9c18a947406cea50d716828ab821f`],[e.chainIds.optimism]:[`0x3c3e0e73b53a19bcaf4178b8f9c9428fd2a2775e`]};isWhitelistedNFT(e,t){return this.KNOWN_GOOD_NFTS[t]?this.KNOWN_GOOD_NFTS[t].some(t=>r.caseInsensitiveEqual(e,t)):!1}async getPublicTokens(e,t){let r=s.getStateKey(t,e);return(await(0,f.get)(n.StorageKeys.ALCHEMY_PUBLIC_TOKENS))?.[r]||[]}getFetchedTokens(e,t){let n=s.getStateKey(t,e);return this.fetchedTokens[n]||[]}fetchAndUpdatePublicTokens(t,n){return e.isSolanaLike(n)?this.fetchAndUpdateSolanaTokens(t,n):this.fetchAndUpdateEVMTokens(t,n)}async fetchAndUpdateSolanaTokens(e,t){let i=s.getStateKey(e,t),[o,l]=await Promise.all([this.getSolanaTokenAddresses(t,e),this.getNFTAddresses(t,e)]),u=Array.from(new Set([...o,...l]));if(!u.length)return;let d=(await a.API.tokensInfoCall(t,u)).filter(e=>!!e),p=await c.tokenVisibilityStorage.hideSpamsAndFetchHiddenTokensAddresses(t,d),m=d.filter(e=>!r.lowerCaseIncludes(p,e.erc20TokenAddress));await(0,f.update)(n.StorageKeys.ALCHEMY_PUBLIC_TOKENS,(e={})=>{let t={...e,[i]:m};return this.fetchedTokens=t,t})}async getWalletTokenAddresses(t,n){return e.isSolanaLike(t)?this.getSolanaTokenAddresses(t,n):this.getEVMTokenAddresses(t,n)}async fetchAndUpdateEVMTokens(e,i){let o=s.getStateKey(e,i),l=await this.getEVMTokenAddresses(i,e),u=await this.getNFTTokens(i,e),d=u.map(e=>e.contractAddress),p=[...l,...d];if(!p.length)return;let m=(await a.API.tokensInfoCall(i,p)).map((e,n)=>{if(e)return e;let a=p[n],o=u.find(e=>r.caseInsensitiveEqual(e.contractAddress,a));return o&&o.tokenIds&&o.tokenIds.length>0&&this.isWhitelistedNFT(a,i)?{chainId:i,name:`Unknown NFT`,symbol:`NFT`,erc20TokenAddress:a,decimals:0,nftTokenType:t.TokenType.ERC721,tokenIds:o.tokenIds}:null}).filter(e=>!!e),h=await c.tokenVisibilityStorage.hideSpamsAndFetchHiddenTokensAddresses(i,m),g=m.filter(e=>!r.lowerCaseIncludes(h,e.erc20TokenAddress)).map(e=>({...e,tokenIds:u.find(t=>r.caseInsensitiveEqual(t.contractAddress,e.erc20TokenAddress))?.tokenIds}));await(0,f.update)(n.StorageKeys.ALCHEMY_PUBLIC_TOKENS,(e={})=>{let t={...e,[o]:g};return this.fetchedTokens=t,t})}async getSolanaTokenAddresses(n,r){let{fetchRpcUrl:i}=e.networkRegistry[n];if(!i)throw Error(`RPC URL not found for the specified chain ID`);let a=l.createCustomSolanaConnection(i),o=await a.getBalance(new d.PublicKey(r)),[s,c]=await Promise.all([a.getParsedTokenAccountsByOwner(new d.PublicKey(r),{programId:p.TOKEN_PROGRAM_ID}),a.getParsedTokenAccountsByOwner(new d.PublicKey(r),{programId:p.TOKEN_2022_PROGRAM_ID})]),u=[...s.value,...c.value].filter(e=>{let{amount:t}=e.account.data.parsed.info.tokenAmount;return BigInt(t)>0n}).map(e=>e.account.data.parsed.info.mint);return o>0&&u.unshift(t.solanaNativeAddress),Array.from(new Set(u))}async getNFTAddresses(n,r){let{fetchRpcUrl:a}=e.networkRegistry[n];if(!a)throw Error(`RPC URL not found for the specified chain ID`);try{let e=[],n=1;do{let{items:o=[],page:s}=(await i.httpClient.post(a,{jsonrpc:`2.0`,id:1,method:`getAssetsByOwner`,params:{ownerAddress:r,page:n,limit:1e3,displayOptions:{showFungible:!1,showCollectionMetadata:!0}}})).result||{},c=o.filter(e=>e.interface&&t.SOLANA_NFT_INTERFACES.includes(e.interface)).map(e=>e.id);e.push(...c),n=s&&s>n?s:0}while(n>0);return e}catch(e){return o.Logger.error(`Failed to fetch NFTs from DAS API`,e),[]}}async getEVMTokenAddresses(n,r){let a=await u.getPublicBalanceByTokenAddress(n,r,t.zeroAddress),o=`https://${this.ALCHEMY_URLS[n]}.g.alchemy.com/v2/${e.ALCHEMY_API_KEY}`,s=[],c;do{let e=[r,`erc20`];c&&e.push({pageKey:c});let{result:t}=await i.httpClient.post(o,{jsonrpc:`2.0`,id:1,method:`alchemy_getTokenBalances`,params:e});s.push(...t?.tokenBalances??[]),c=t?.pageKey}while(c);a&&a>0n&&s.push({contractAddress:t.zeroAddress,tokenBalance:a.toString()});let l={};return s.forEach(e=>{(!l[e.contractAddress]||BigInt(e.tokenBalance)>0n)&&(l[e.contractAddress]=e)}),Object.keys(l)}async getNFTTokens(t,n){let r=`https://${this.ALCHEMY_URLS[t]}.g.alchemy.com/nft/v3/${e.ALCHEMY_API_KEY}/getNFTsForOwner`,a=[],o;do{let e=new URLSearchParams({owner:n,withMetadata:`false`,pageSize:`100`});o&&e.append(`pageKey`,o);let{ownedNfts:t=[],pageKey:s}=await i.httpClient.get(`${r}?${e.toString()}`);a.push(...t),o=s}while(o);let s=a.filter(({contractAddress:e,tokenId:t})=>e&&t).reduce((e,{contractAddress:t,tokenId:n})=>{let r=t.toLowerCase();return e.has(r)||e.set(r,[]),e.get(r)?.push(n),e},new Map);return Array.from(s.entries()).map(([e,t])=>({contractAddress:e,tokenIds:t}))}};exports.alchemyPublicTokensDB=m;

package/common/src/data-structures/TokenDBs/AlchemyPublicTokensDB.mjs

@@ -0,0 +1,167 @@
+import { ALCHEMY_API_KEY as e, chainIds as t, isSolanaLike as n, networkRegistry as r } from "../../constants/chains.constants.mjs";
+import { SOLANA_NFT_INTERFACES as i, TokenType as a, solanaNativeAddress as o, zeroAddress as s } from "../../constants/protocol.constants.mjs";
+import { StorageKeys as c } from "../../types/cache.types.mjs";
+import { caseInsensitiveEqual as l, lowerCaseIncludes as u } from "../../functions/utils/caseInsensitive.utils.mjs";
+import { httpClient as d } from "../http/HttpClient.mjs";
+import "../http/index.mjs";
+import { API as f } from "../../API/API.mjs";
+import { Logger as p } from "../../error-handling/logger.mjs";
+import { getStateKey as m } from "../../functions/utils/string.utils.mjs";
+import { tokenVisibilityStorage as h } from "./token-visibility-db.mjs";
+import { createCustomSolanaConnection as g } from "../../functions/utils/create-provider.mjs";
+import { getPublicBalanceByTokenAddress as _ } from "../../functions/utils/publicBalance.utils.mjs";
+import { PublicKey as v } from "@solana/web3.js";
+import { get as y, update as b } from "idb-keyval";
+import { TOKEN_2022_PROGRAM_ID as x, TOKEN_PROGRAM_ID as S } from "@solana/spl-token";
+var C = new class {
+	fetchedTokens = {};
+	ALCHEMY_URLS = {
+		[t.ethMainnet]: "eth-mainnet",
+		[t.polygon]: "polygon-mainnet",
+		[t.arbMainnet]: "arb-mainnet",
+		[t.optimism]: "opt-mainnet",
+		[t.base]: "base-mainnet",
+		[t.solanaMainnet]: "solana-mainnet"
+	};
+	KNOWN_GOOD_NFTS = {
+		[t.base]: ["0x20bc8d248fe9c18a947406cea50d716828ab821f"],
+		[t.optimism]: ["0x3c3e0e73b53a19bcaf4178b8f9c9428fd2a2775e"]
+	};
+	isWhitelistedNFT(e, t) {
+		return this.KNOWN_GOOD_NFTS[t] ? this.KNOWN_GOOD_NFTS[t].some((t) => l(e, t)) : !1;
+	}
+	async getPublicTokens(e, t) {
+		let n = m(t, e);
+		return (await y(c.ALCHEMY_PUBLIC_TOKENS))?.[n] || [];
+	}
+	getFetchedTokens(e, t) {
+		let n = m(t, e);
+		return this.fetchedTokens[n] || [];
+	}
+	fetchAndUpdatePublicTokens(e, t) {
+		return n(t) ? this.fetchAndUpdateSolanaTokens(e, t) : this.fetchAndUpdateEVMTokens(e, t);
+	}
+	async fetchAndUpdateSolanaTokens(e, t) {
+		let n = m(e, t), [r, i] = await Promise.all([this.getSolanaTokenAddresses(t, e), this.getNFTAddresses(t, e)]), a = Array.from(new Set([...r, ...i]));
+		if (!a.length) return;
+		let o = (await f.tokensInfoCall(t, a)).filter((e) => !!e), s = await h.hideSpamsAndFetchHiddenTokensAddresses(t, o), l = o.filter((e) => !u(s, e.erc20TokenAddress));
+		await b(c.ALCHEMY_PUBLIC_TOKENS, (e = {}) => {
+			let t = {
+				...e,
+				[n]: l
+			};
+			return this.fetchedTokens = t, t;
+		});
+	}
+	async getWalletTokenAddresses(e, t) {
+		return n(e) ? this.getSolanaTokenAddresses(e, t) : this.getEVMTokenAddresses(e, t);
+	}
+	async fetchAndUpdateEVMTokens(e, t) {
+		let n = m(e, t), r = await this.getEVMTokenAddresses(t, e), i = await this.getNFTTokens(t, e), o = i.map((e) => e.contractAddress), s = [...r, ...o];
+		if (!s.length) return;
+		let d = (await f.tokensInfoCall(t, s)).map((e, n) => {
+			if (e) return e;
+			let r = s[n], o = i.find((e) => l(e.contractAddress, r));
+			return o && o.tokenIds && o.tokenIds.length > 0 && this.isWhitelistedNFT(r, t) ? {
+				chainId: t,
+				name: "Unknown NFT",
+				symbol: "NFT",
+				erc20TokenAddress: r,
+				decimals: 0,
+				nftTokenType: a.ERC721,
+				tokenIds: o.tokenIds
+			} : null;
+		}).filter((e) => !!e), p = await h.hideSpamsAndFetchHiddenTokensAddresses(t, d), g = d.filter((e) => !u(p, e.erc20TokenAddress)).map((e) => ({
+			...e,
+			tokenIds: i.find((t) => l(t.contractAddress, e.erc20TokenAddress))?.tokenIds
+		}));
+		await b(c.ALCHEMY_PUBLIC_TOKENS, (e = {}) => {
+			let t = {
+				...e,
+				[n]: g
+			};
+			return this.fetchedTokens = t, t;
+		});
+	}
+	async getSolanaTokenAddresses(e, t) {
+		let { fetchRpcUrl: n } = r[e];
+		if (!n) throw Error("RPC URL not found for the specified chain ID");
+		let i = g(n), a = await i.getBalance(new v(t)), [s, c] = await Promise.all([i.getParsedTokenAccountsByOwner(new v(t), { programId: S }), i.getParsedTokenAccountsByOwner(new v(t), { programId: x })]), l = [...s.value, ...c.value].filter((e) => {
+			let { amount: t } = e.account.data.parsed.info.tokenAmount;
+			return BigInt(t) > 0n;
+		}).map((e) => e.account.data.parsed.info.mint);
+		return a > 0 && l.unshift(o), Array.from(new Set(l));
+	}
+	async getNFTAddresses(e, t) {
+		let { fetchRpcUrl: n } = r[e];
+		if (!n) throw Error("RPC URL not found for the specified chain ID");
+		try {
+			let e = [], r = 1;
+			do {
+				let { items: a = [], page: o } = (await d.post(n, {
+					jsonrpc: "2.0",
+					id: 1,
+					method: "getAssetsByOwner",
+					params: {
+						ownerAddress: t,
+						page: r,
+						limit: 1e3,
+						displayOptions: {
+							showFungible: !1,
+							showCollectionMetadata: !0
+						}
+					}
+				})).result || {}, s = a.filter((e) => e.interface && i.includes(e.interface)).map((e) => e.id);
+				e.push(...s), r = o && o > r ? o : 0;
+			} while (r > 0);
+			return e;
+		} catch (e) {
+			return p.error("Failed to fetch NFTs from DAS API", e), [];
+		}
+	}
+	async getEVMTokenAddresses(t, n) {
+		let r = await _(t, n, s), i = `https://${this.ALCHEMY_URLS[t]}.g.alchemy.com/v2/${e}`, a = [], o;
+		do {
+			let e = [n, "erc20"];
+			o && e.push({ pageKey: o });
+			let { result: t } = await d.post(i, {
+				jsonrpc: "2.0",
+				id: 1,
+				method: "alchemy_getTokenBalances",
+				params: e
+			});
+			a.push(...t?.tokenBalances ?? []), o = t?.pageKey;
+		} while (o);
+		r && r > 0n && a.push({
+			contractAddress: s,
+			tokenBalance: r.toString()
+		});
+		let c = {};
+		return a.forEach((e) => {
+			(!c[e.contractAddress] || BigInt(e.tokenBalance) > 0n) && (c[e.contractAddress] = e);
+		}), Object.keys(c);
+	}
+	async getNFTTokens(t, n) {
+		let r = `https://${this.ALCHEMY_URLS[t]}.g.alchemy.com/nft/v3/${e}/getNFTsForOwner`, i = [], a;
+		do {
+			let e = new URLSearchParams({
+				owner: n,
+				withMetadata: "false",
+				pageSize: "100"
+			});
+			a && e.append("pageKey", a);
+			let { ownedNfts: t = [], pageKey: o } = await d.get(`${r}?${e.toString()}`);
+			i.push(...t), a = o;
+		} while (a);
+		let o = i.filter(({ contractAddress: e, tokenId: t }) => e && t).reduce((e, { contractAddress: t, tokenId: n }) => {
+			let r = t.toLowerCase();
+			return e.has(r) || e.set(r, []), e.get(r)?.push(n), e;
+		}, /* @__PURE__ */ new Map());
+		return Array.from(o.entries()).map(([e, t]) => ({
+			contractAddress: e,
+			tokenIds: t
+		}));
+	}
+}();
+//#endregion
+export { C as alchemyPublicTokensDB };

package/common/src/data-structures/TokenDBs/ArcPublicTokensDB.cjs

@@ -0,0 +1 @@
+const e=require(`../../../../_virtual/_rolldown/runtime.cjs`),t=require(`../../constants/chains.constants.cjs`),n=require(`../../constants/protocol.constants.cjs`),r=require(`../../types/ethereum-network.types.cjs`),i=require(`../../types/cache.types.cjs`),a=require(`../../functions/utils/caseInsensitive.utils.cjs`),o=require(`../../API/API.cjs`),s=require(`../../error-handling/logger.cjs`),c=require(`../../functions/utils/string.utils.cjs`),l=require(`./token-visibility-db.cjs`),u=require(`../../functions/web3/getContractMetadata.cjs`);let d=require(`idb-keyval`),f=require(`axios`);f=e.__toESM(f);var p=class{API_BASE=`https://testnet.arcscan.app/api`;fetchedTokens={};async getPublicTokens(e){let n=c.getStateKey(e,t.chainIds.arcTestnet);return(await(0,d.get)(i.StorageKeys.ARC_PUBLIC_TOKENS))?.[n]||[]}getFetchedTokens(e){let n=c.getStateKey(e,t.chainIds.arcTestnet);return this.fetchedTokens[n]||[]}async fetchAndUpdatePublicTokens(e){let r=c.getStateKey(e,t.chainIds.arcTestnet),s=await this.getERC20TokenAddresses(e),u=await this.getNFTTokens(e),f=u.map(e=>e.contractAddress),p=[...s,...f];if(!p.length)return;let m=(await o.API.tokensInfoCall(t.chainIds.arcTestnet,p)).map((e,r)=>{if(e)return e;let i=p[r],o=u.find(e=>a.caseInsensitiveEqual(e.contractAddress,i));return o&&o.tokenIds&&o.tokenIds.length>0?{chainId:t.chainIds.arcTestnet,name:`Unknown NFT`,symbol:`NFT`,erc20TokenAddress:i,decimals:0,nftTokenType:n.TokenType.ERC721,tokenIds:o.tokenIds}:null}).filter(e=>!!e),h=await l.tokenVisibilityStorage.hideSpamsAndFetchHiddenTokensAddresses(t.chainIds.arcTestnet,m),g=m.filter(e=>!a.lowerCaseIncludes(h,e.erc20TokenAddress)).map(e=>({...e,tokenIds:u.find(t=>a.caseInsensitiveEqual(t.contractAddress,e.erc20TokenAddress))?.tokenIds}));await(0,d.update)(i.StorageKeys.ARC_PUBLIC_TOKENS,(e={})=>{let t={...e,[r]:g};return this.fetchedTokens=t,t})}async getERC20TokenAddresses(e){let n=[];try{let i=(await f.default.post(`${this.API_BASE}?module=account&action=tokentx&address=${e}`)).data;if(i.status===`1`&&i.result){let a=[...new Set(i.result.map(({contractAddress:e})=>e))];for(let i of a)try{let a=u.getContractWithFetcherByChainId(t.chainIds.arcTestnet,r.ContractType.ERC20Contract,i),o=BigInt(await a.balanceOf(e));o>0n&&n.push({contractAddress:i,tokenBalance:o.toString()})}catch(e){s.Logger.error(`Error fetching ARC testnet token balance:`,e)}}}catch(e){s.Logger.error(`Error fetching ARC testnet token transactions:`,e)}return n.filter(({tokenBalance:e})=>Number(e)!==0).map(({contractAddress:e})=>e)}async getNFTTokens(e){let t=`${this.API_BASE}/v2/addresses/${e}/nft?type=ERC-721,ERC-1155`,n=[],r;do{let e=r?`&${new URLSearchParams(r)}`:``,{data:i}=await f.default.get(`${t}${e}`),{items:a=[],next_page_params:o}=i;n.push(...a),r=o?{token_contract_address_hash:o.token_contract_address_hash,token_id:o.token_id,token_type:o.token_type}:void 0}while(r);let i=n.reduce((e,t)=>{let n=t.token.address_hash.toLowerCase(),r=t.id;return e.has(n)||e.set(n,[]),e.get(n)?.push(r),e},new Map);return Array.from(i.entries()).map(([e,t])=>({contractAddress:e,tokenIds:t}))}},m=new p;exports.ArcPublicTokensDB=p,exports.arcPublicTokensDB=m;

package/common/src/data-structures/TokenDBs/ArcPublicTokensDB.mjs

@@ -0,0 +1,94 @@
+import { chainIds as e } from "../../constants/chains.constants.mjs";
+import { TokenType as t } from "../../constants/protocol.constants.mjs";
+import { ContractType as n } from "../../types/ethereum-network.types.mjs";
+import { StorageKeys as r } from "../../types/cache.types.mjs";
+import { caseInsensitiveEqual as i, lowerCaseIncludes as a } from "../../functions/utils/caseInsensitive.utils.mjs";
+import { API as o } from "../../API/API.mjs";
+import { Logger as s } from "../../error-handling/logger.mjs";
+import { getStateKey as c } from "../../functions/utils/string.utils.mjs";
+import { tokenVisibilityStorage as l } from "./token-visibility-db.mjs";
+import { getContractWithFetcherByChainId as u } from "../../functions/web3/getContractMetadata.mjs";
+import { get as d, update as f } from "idb-keyval";
+import p from "axios";
+//#region libs/shared/common/src/data-structures/TokenDBs/ArcPublicTokensDB.ts
+var m = class {
+	API_BASE = "https://testnet.arcscan.app/api";
+	fetchedTokens = {};
+	async getPublicTokens(t) {
+		let n = c(t, e.arcTestnet);
+		return (await d(r.ARC_PUBLIC_TOKENS))?.[n] || [];
+	}
+	getFetchedTokens(t) {
+		let n = c(t, e.arcTestnet);
+		return this.fetchedTokens[n] || [];
+	}
+	async fetchAndUpdatePublicTokens(n) {
+		let s = c(n, e.arcTestnet), u = await this.getERC20TokenAddresses(n), d = await this.getNFTTokens(n), p = d.map((e) => e.contractAddress), m = [...u, ...p];
+		if (!m.length) return;
+		let h = (await o.tokensInfoCall(e.arcTestnet, m)).map((n, r) => {
+			if (n) return n;
+			let a = m[r], o = d.find((e) => i(e.contractAddress, a));
+			return o && o.tokenIds && o.tokenIds.length > 0 ? {
+				chainId: e.arcTestnet,
+				name: "Unknown NFT",
+				symbol: "NFT",
+				erc20TokenAddress: a,
+				decimals: 0,
+				nftTokenType: t.ERC721,
+				tokenIds: o.tokenIds
+			} : null;
+		}).filter((e) => !!e), g = await l.hideSpamsAndFetchHiddenTokensAddresses(e.arcTestnet, h), _ = h.filter((e) => !a(g, e.erc20TokenAddress)).map((e) => ({
+			...e,
+			tokenIds: d.find((t) => i(t.contractAddress, e.erc20TokenAddress))?.tokenIds
+		}));
+		await f(r.ARC_PUBLIC_TOKENS, (e = {}) => {
+			let t = {
+				...e,
+				[s]: _
+			};
+			return this.fetchedTokens = t, t;
+		});
+	}
+	async getERC20TokenAddresses(t) {
+		let r = [];
+		try {
+			let i = (await p.post(`${this.API_BASE}?module=account&action=tokentx&address=${t}`)).data;
+			if (i.status === "1" && i.result) {
+				let a = [...new Set(i.result.map(({ contractAddress: e }) => e))];
+				for (let i of a) try {
+					let a = u(e.arcTestnet, n.ERC20Contract, i), o = BigInt(await a.balanceOf(t));
+					o > 0n && r.push({
+						contractAddress: i,
+						tokenBalance: o.toString()
+					});
+				} catch (e) {
+					s.error("Error fetching ARC testnet token balance:", e);
+				}
+			}
+		} catch (e) {
+			s.error("Error fetching ARC testnet token transactions:", e);
+		}
+		return r.filter(({ tokenBalance: e }) => Number(e) !== 0).map(({ contractAddress: e }) => e);
+	}
+	async getNFTTokens(e) {
+		let t = `${this.API_BASE}/v2/addresses/${e}/nft?type=ERC-721,ERC-1155`, n = [], r;
+		do {
+			let e = r ? `&${new URLSearchParams(r)}` : "", { data: i } = await p.get(`${t}${e}`), { items: a = [], next_page_params: o } = i;
+			n.push(...a), r = o ? {
+				token_contract_address_hash: o.token_contract_address_hash,
+				token_id: o.token_id,
+				token_type: o.token_type
+			} : void 0;
+		} while (r);
+		let i = n.reduce((e, t) => {
+			let n = t.token.address_hash.toLowerCase(), r = t.id;
+			return e.has(n) || e.set(n, []), e.get(n)?.push(r), e;
+		}, /* @__PURE__ */ new Map());
+		return Array.from(i.entries()).map(([e, t]) => ({
+			contractAddress: e,
+			tokenIds: t
+		}));
+	}
+}, h = new m();
+//#endregion
+export { m as ArcPublicTokensDB, h as arcPublicTokensDB };

package/common/src/data-structures/TokenDBs/EventsPublicTokensDB.cjs

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../constants/protocol.constants.cjs`),t=require(`../../types/cache.types.cjs`),n=require(`../../functions/utils/erc20tokenFunctions.cjs`),r=require(`../../functions/utils/caseInsensitive.utils.cjs`),i=require(`../../API/API.cjs`),a=require(`../../error-handling/logger.cjs`),o=require(`../../functions/utils/string.utils.cjs`),s=require(`./token-visibility-db.cjs`),c=require(`../../functions/utils/create-provider.cjs`),l=require(`../../constants/events.constants.cjs`);require(`../../constants/index.cjs`),require(`../../functions/index.cjs`);let u=require(`ethers`),d=require(`idb-keyval`),f=require(`async-mutex`);var p=new class{fetchedTokens={};updateMutexes={};transferEventTopic=u.ethers.id(`Transfer(address,address,uint256)`);getMutex(e){return this.updateMutexes[e]||(this.updateMutexes[e]=new f.Mutex),this.updateMutexes[e]}async getPublicTokens(e,n){let r=o.getStateKey(n,e);return(await(0,d.get)(t.StorageKeys.EVENTS_PUBLIC_TOKENS))?.[r]||[]}getFetchedTokens(e,t){let n=o.getStateKey(t,e);return this.fetchedTokens[n]||[]}async fetchAndUpdatePublicTokens(e,n){let i=o.getStateKey(e,n);await this.getMutex(i).runExclusive(async()=>{try{let a=(await this.getPublicTokens(n,e)).map(e=>e.erc20TokenAddress),{toEvents:o,fromEvents:c,latestBlock:l}=await this.getEvents(e,n),u=[...o,...c],{erc20Tokens:f}=await this.fetchPublicTokens(u,n,a),p=await s.tokenVisibilityStorage.hideSpamsAndFetchHiddenTokensAddresses(n,f),m=f.filter(e=>!r.lowerCaseIncludes(p,e.erc20TokenAddress));await(0,d.update)(t.StorageKeys.EVENTS_PUBLIC_TOKENS,(e={})=>{let t=e[i]||[],n=t.map(e=>e.erc20TokenAddress),a=m.filter(e=>!r.lowerCaseIncludes(n,e.erc20TokenAddress));t.push(...a);let s=this.updateTokenIds(c,o,t),l={...e,[i]:s};return this.fetchedTokens=l,l}),l&&await this.updateLastProcessedBlock(n,e,l)}catch(e){a.Logger.error(`public tokens db error`,e)}})}async getLastProcessedBlock(e,n){return(await(0,d.get)(t.StorageKeys.PUBLIC_TOKENS_LAST_PROCESSED_BLOCKS)||{})[o.getStateKey(n,e)]||l.EVENTS_INITIAL_BLOCKS[e]}async updateLastProcessedBlock(e,n,r){await(0,d.update)(t.StorageKeys.PUBLIC_TOKENS_LAST_PROCESSED_BLOCKS,(t={})=>{let i=o.getStateKey(n,e);return{...t,[i]:r}})}async getEvents(e,t){try{let n=c.createJsonRpcProvider(t),r=await this.getLastProcessedBlock(t,e)+1,i=await n.getBlockNumber(),a=u.ethers.zeroPadValue(e.toLowerCase(),32),o={topics:[this.transferEventTopic,null,a],fromBlock:r,toBlock:i},s={topics:[this.transferEventTopic,a,null],fromBlock:r,toBlock:i},[l,d]=await Promise.all([n.getLogs(o),n.getLogs(s)]);return{toEvents:l,fromEvents:d,latestBlock:i}}catch(e){return a.Logger.error(`Error fetching events:`,e),{toEvents:[],fromEvents:[],latestBlock:void 0}}}updateTokenIds(e,t,r){let i=new Map;return r.forEach(e=>{if(n.isNFTToken(e)&&e.tokenIds){let t=e.erc20TokenAddress.toLowerCase();i.set(t,[...e.tokenIds])}}),t.forEach(e=>{if(e.topics.length<=3)return;let t=e.address.toLowerCase(),n=BigInt(e.topics[3]).toString();i.has(t)||i.set(t,[]),i.get(t)?.push(n)}),e.forEach(e=>{if(e.topics.length<=3)return;let t=e.address.toLowerCase(),n=i.get(t);if(n?.length){let t=BigInt(e.topics[3]).toString(),r=n.indexOf(t);r!==-1&&n.splice(r,1)}}),r.forEach(e=>{if(n.isNFTToken(e)){let t=e.erc20TokenAddress.toLowerCase(),n=i.get(t);e.tokenIds=n?.length&&n.length>0?n:void 0}}),r}async fetchPublicTokens(t,n,o){try{let a=[e.zeroAddress,...new Set(t.map(e=>e.address))].filter(e=>e&&!r.lowerCaseIncludes(o,e));return a.length?{erc20Tokens:(await i.API.tokensInfoCall(n,a)).filter(e=>!!e)}:{erc20Tokens:[]}}catch(e){return a.Logger.error(`Error fetching public tokens:`,e),{erc20Tokens:[]}}}};exports.eventsPublicTokensDB=p;

package/common/src/data-structures/TokenDBs/EventsPublicTokensDB.mjs

@@ -0,0 +1,129 @@
+import { zeroAddress as e } from "../../constants/protocol.constants.mjs";
+import { StorageKeys as t } from "../../types/cache.types.mjs";
+import { isNFTToken as n } from "../../functions/utils/erc20tokenFunctions.mjs";
+import { lowerCaseIncludes as r } from "../../functions/utils/caseInsensitive.utils.mjs";
+import { API as i } from "../../API/API.mjs";
+import { Logger as a } from "../../error-handling/logger.mjs";
+import { getStateKey as o } from "../../functions/utils/string.utils.mjs";
+import { tokenVisibilityStorage as s } from "./token-visibility-db.mjs";
+import { createJsonRpcProvider as c } from "../../functions/utils/create-provider.mjs";
+import { EVENTS_INITIAL_BLOCKS as l } from "../../constants/events.constants.mjs";
+import "../../constants/index.mjs";
+import "../../functions/index.mjs";
+import { ethers as u } from "ethers";
+import { get as d, update as f } from "idb-keyval";
+import { Mutex as p } from "async-mutex";
+var m = new class {
+	fetchedTokens = {};
+	updateMutexes = {};
+	transferEventTopic = u.id("Transfer(address,address,uint256)");
+	getMutex(e) {
+		return this.updateMutexes[e] || (this.updateMutexes[e] = new p()), this.updateMutexes[e];
+	}
+	async getPublicTokens(e, n) {
+		let r = o(n, e);
+		return (await d(t.EVENTS_PUBLIC_TOKENS))?.[r] || [];
+	}
+	getFetchedTokens(e, t) {
+		let n = o(t, e);
+		return this.fetchedTokens[n] || [];
+	}
+	async fetchAndUpdatePublicTokens(e, n) {
+		let i = o(e, n);
+		await this.getMutex(i).runExclusive(async () => {
+			try {
+				let a = (await this.getPublicTokens(n, e)).map((e) => e.erc20TokenAddress), { toEvents: o, fromEvents: c, latestBlock: l } = await this.getEvents(e, n), u = [...o, ...c], { erc20Tokens: d } = await this.fetchPublicTokens(u, n, a), p = await s.hideSpamsAndFetchHiddenTokensAddresses(n, d), m = d.filter((e) => !r(p, e.erc20TokenAddress));
+				await f(t.EVENTS_PUBLIC_TOKENS, (e = {}) => {
+					let t = e[i] || [], n = t.map((e) => e.erc20TokenAddress), a = m.filter((e) => !r(n, e.erc20TokenAddress));
+					t.push(...a);
+					let s = this.updateTokenIds(c, o, t), l = {
+						...e,
+						[i]: s
+					};
+					return this.fetchedTokens = l, l;
+				}), l && await this.updateLastProcessedBlock(n, e, l);
+			} catch (e) {
+				a.error("public tokens db error", e);
+			}
+		});
+	}
+	async getLastProcessedBlock(e, n) {
+		return (await d(t.PUBLIC_TOKENS_LAST_PROCESSED_BLOCKS) || {})[o(n, e)] || l[e];
+	}
+	async updateLastProcessedBlock(e, n, r) {
+		await f(t.PUBLIC_TOKENS_LAST_PROCESSED_BLOCKS, (t = {}) => {
+			let i = o(n, e);
+			return {
+				...t,
+				[i]: r
+			};
+		});
+	}
+	async getEvents(e, t) {
+		try {
+			let n = c(t), r = await this.getLastProcessedBlock(t, e) + 1, i = await n.getBlockNumber(), a = u.zeroPadValue(e.toLowerCase(), 32), o = {
+				topics: [
+					this.transferEventTopic,
+					null,
+					a
+				],
+				fromBlock: r,
+				toBlock: i
+			}, s = {
+				topics: [
+					this.transferEventTopic,
+					a,
+					null
+				],
+				fromBlock: r,
+				toBlock: i
+			}, [l, d] = await Promise.all([n.getLogs(o), n.getLogs(s)]);
+			return {
+				toEvents: l,
+				fromEvents: d,
+				latestBlock: i
+			};
+		} catch (e) {
+			return a.error("Error fetching events:", e), {
+				toEvents: [],
+				fromEvents: [],
+				latestBlock: void 0
+			};
+		}
+	}
+	updateTokenIds(e, t, r) {
+		let i = /* @__PURE__ */ new Map();
+		return r.forEach((e) => {
+			if (n(e) && e.tokenIds) {
+				let t = e.erc20TokenAddress.toLowerCase();
+				i.set(t, [...e.tokenIds]);
+			}
+		}), t.forEach((e) => {
+			if (e.topics.length <= 3) return;
+			let t = e.address.toLowerCase(), n = BigInt(e.topics[3]).toString();
+			i.has(t) || i.set(t, []), i.get(t)?.push(n);
+		}), e.forEach((e) => {
+			if (e.topics.length <= 3) return;
+			let t = e.address.toLowerCase(), n = i.get(t);
+			if (n?.length) {
+				let t = BigInt(e.topics[3]).toString(), r = n.indexOf(t);
+				r !== -1 && n.splice(r, 1);
+			}
+		}), r.forEach((e) => {
+			if (n(e)) {
+				let t = e.erc20TokenAddress.toLowerCase(), n = i.get(t);
+				e.tokenIds = n?.length && n.length > 0 ? n : void 0;
+			}
+		}), r;
+	}
+	async fetchPublicTokens(t, n, o) {
+		try {
+			let a = [e, ...new Set(t.map((e) => e.address))].filter((e) => e && !r(o, e));
+			return a.length ? { erc20Tokens: (await i.tokensInfoCall(n, a)).filter((e) => !!e) } : { erc20Tokens: [] };
+		} catch (e) {
+			return a.error("Error fetching public tokens:", e), { erc20Tokens: [] };
+		}
+	}
+}();
+//#endregion
+export { m as eventsPublicTokensDB };

package/common/src/data-structures/TokenDBs/PrivateTokensDB.cjs

@@ -0,0 +1 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../types/cache.types.cjs`),t=require(`../../functions/utils/caseInsensitive.utils.cjs`),n=require(`../../API/API.cjs`),r=require(`../../error-handling/logger.cjs`),i=require(`../../functions/utils/string.utils.cjs`),a=require(`./token-visibility-db.cjs`);let o=require(`idb-keyval`);var s=class{fetchedTokens={};initalFetched=!1;async updateFetchedTokens(){let t=await(0,o.get)(e.StorageKeys.PRIVATE_TOKENS);this.fetchedTokens=t??{},this.initalFetched=!0}async getPrivateTokens(t,n){let r=i.getStateKey(n,t);return(await(0,o.get)(e.StorageKeys.PRIVATE_TOKENS))?.[r]||[]}async fetchPrivateTokens(e,i,a){try{let r=[...new Set(i)].filter(e=>e&&!t.lowerCaseIncludes(a,e));if(!r.length)return[];let o=(await n.API.tokensInfoCall(e,r)).filter(e=>!!e),s=new Map;return o.forEach(e=>{s.set(e.erc20TokenAddress.toLowerCase(),e)}),Array.from(s.values())}catch(e){return r.Logger.error(`Error fetching private tokens:`,e),[]}}async fetchAndUpdatePrivateTokens(n,r,s,c){let l=(await this.getPrivateTokens(r,s)).map(e=>e.erc20TokenAddress),u=c??await this.fetchPrivateTokens(r,n,l),d=await a.tokenVisibilityStorage.hideSpamsAndFetchHiddenTokensAddresses(r,u),f=i.getStateKey(s,r);await(0,o.update)(e.StorageKeys.PRIVATE_TOKENS,(e={})=>{let n=e?.[f]||[],r=n.map(e=>e.erc20TokenAddress),i=u.filter(e=>!t.lowerCaseIncludes(r,e.erc20TokenAddress));n.push(...i);let a=n.filter(e=>!t.lowerCaseIncludes(d,e.erc20TokenAddress)),o={...e,[f]:a};return this.fetchedTokens=o,o})}getFetchedTokens(e,t){let n=i.getStateKey(t,e);return this.fetchedTokens[n]||[]}},c=new s;exports.PrivateTokensDB=s,exports.privateTokensDB=c;

package/common/src/data-structures/TokenDBs/PrivateTokensDB.mjs

@@ -0,0 +1,50 @@
+import { StorageKeys as e } from "../../types/cache.types.mjs";
+import { lowerCaseIncludes as t } from "../../functions/utils/caseInsensitive.utils.mjs";
+import { API as n } from "../../API/API.mjs";
+import { Logger as r } from "../../error-handling/logger.mjs";
+import { getStateKey as i } from "../../functions/utils/string.utils.mjs";
+import { tokenVisibilityStorage as a } from "./token-visibility-db.mjs";
+import { get as o, update as s } from "idb-keyval";
+//#region libs/shared/common/src/data-structures/TokenDBs/PrivateTokensDB.ts
+var c = class {
+	fetchedTokens = {};
+	initalFetched = !1;
+	async updateFetchedTokens() {
+		let t = await o(e.PRIVATE_TOKENS);
+		this.fetchedTokens = t ?? {}, this.initalFetched = !0;
+	}
+	async getPrivateTokens(t, n) {
+		let r = i(n, t);
+		return (await o(e.PRIVATE_TOKENS))?.[r] || [];
+	}
+	async fetchPrivateTokens(e, i, a) {
+		try {
+			let r = [...new Set(i)].filter((e) => e && !t(a, e));
+			if (!r.length) return [];
+			let o = (await n.tokensInfoCall(e, r)).filter((e) => !!e), s = /* @__PURE__ */ new Map();
+			return o.forEach((e) => {
+				s.set(e.erc20TokenAddress.toLowerCase(), e);
+			}), Array.from(s.values());
+		} catch (e) {
+			return r.error("Error fetching private tokens:", e), [];
+		}
+	}
+	async fetchAndUpdatePrivateTokens(n, r, o, c) {
+		let l = (await this.getPrivateTokens(r, o)).map((e) => e.erc20TokenAddress), u = c ?? await this.fetchPrivateTokens(r, n, l), d = await a.hideSpamsAndFetchHiddenTokensAddresses(r, u), f = i(o, r);
+		await s(e.PRIVATE_TOKENS, (e = {}) => {
+			let n = e?.[f] || [], r = n.map((e) => e.erc20TokenAddress), i = u.filter((e) => !t(r, e.erc20TokenAddress));
+			n.push(...i);
+			let a = n.filter((e) => !t(d, e.erc20TokenAddress)), o = {
+				...e,
+				[f]: a
+			};
+			return this.fetchedTokens = o, o;
+		});
+	}
+	getFetchedTokens(e, t) {
+		let n = i(t, e);
+		return this.fetchedTokens[n] || [];
+	}
+}, l = new c();
+//#endregion
+export { c as PrivateTokensDB, l as privateTokensDB };

package/common/src/data-structures/TokenDBs/PublicTokensDB.cjs

@@ -0,0 +1 @@
+const e=require(`../../constants/chains.constants.cjs`),t=require(`../../functions/utils/string.utils.cjs`),n=require(`./AlchemyPublicTokensDB.cjs`),r=require(`./EventsPublicTokensDB.cjs`),i=require(`./ArcPublicTokensDB.cjs`);var a=class{useAlternativeDB={};async getPublicTokens(a,o){let s=t.getStateKey(o,a);return a===e.chainIds.arcTestnet?i.arcPublicTokensDB.getPublicTokens(o):this.useAlternativeDB[s]?r.eventsPublicTokensDB.getPublicTokens(a,o):n.alchemyPublicTokensDB.getPublicTokens(a,o)}getFetchedTokens(a,o){let s=t.getStateKey(o,a);return a===e.chainIds.arcTestnet?i.arcPublicTokensDB.getFetchedTokens(o):this.useAlternativeDB[s]?r.eventsPublicTokensDB.getFetchedTokens(a,o):n.alchemyPublicTokensDB.getFetchedTokens(a,o)}async fetchAndUpdatePublicTokens(a,o){let s=t.getStateKey(a,o);try{o===e.chainIds.arcTestnet?await i.arcPublicTokensDB.fetchAndUpdatePublicTokens(a):(await n.alchemyPublicTokensDB.fetchAndUpdatePublicTokens(a,o),this.useAlternativeDB[s]=!1)}catch{if(e.isSolanaLike(o))return;await r.eventsPublicTokensDB.fetchAndUpdatePublicTokens(a,o),this.useAlternativeDB[s]=!0}}};new a,exports.PublicTokensDB=a;

package/common/src/data-structures/TokenDBs/PublicTokensDB.mjs

@@ -0,0 +1,29 @@
+import { chainIds as e, isSolanaLike as t } from "../../constants/chains.constants.mjs";
+import { getStateKey as n } from "../../functions/utils/string.utils.mjs";
+import { alchemyPublicTokensDB as r } from "./AlchemyPublicTokensDB.mjs";
+import { eventsPublicTokensDB as i } from "./EventsPublicTokensDB.mjs";
+import { arcPublicTokensDB as a } from "./ArcPublicTokensDB.mjs";
+//#region libs/shared/common/src/data-structures/TokenDBs/PublicTokensDB.ts
+var o = class {
+	useAlternativeDB = {};
+	async getPublicTokens(t, o) {
+		let s = n(o, t);
+		return t === e.arcTestnet ? a.getPublicTokens(o) : this.useAlternativeDB[s] ? i.getPublicTokens(t, o) : r.getPublicTokens(t, o);
+	}
+	getFetchedTokens(t, o) {
+		let s = n(o, t);
+		return t === e.arcTestnet ? a.getFetchedTokens(o) : this.useAlternativeDB[s] ? i.getFetchedTokens(t, o) : r.getFetchedTokens(t, o);
+	}
+	async fetchAndUpdatePublicTokens(o, s) {
+		let c = n(o, s);
+		try {
+			s === e.arcTestnet ? await a.fetchAndUpdatePublicTokens(o) : (await r.fetchAndUpdatePublicTokens(o, s), this.useAlternativeDB[c] = !1);
+		} catch {
+			if (t(s)) return;
+			await i.fetchAndUpdatePublicTokens(o, s), this.useAlternativeDB[c] = !0;
+		}
+	}
+};
+new o();
+//#endregion
+export { o as PublicTokensDB };

package/common/src/data-structures/TokenDBs/index.cjs

@@ -0,0 +1 @@
+require(`./token-visibility-db.cjs`),require(`./PrivateTokensDB.cjs`),require(`./ArcPublicTokensDB.cjs`),require(`./PublicTokensDB.cjs`);