@hinkal/common 0.2.40 → 0.3.1

package/common/src/data-structures/event-service/evm/BlockchainEventEmitter.mjs

@@ -0,0 +1,104 @@
+import { Logger as e } from "../../../error-handling/logger.mjs";
+import { getSequence as t, resolveSync as n } from "../../../functions/utils/resolve-sync.utils.mjs";
+import { blockReorgDepth as r } from "../../../constants/reorg-depths.constants.mjs";
+import { getProviderFromContract as i } from "../../../functions/utils/getSignerFromContract.mjs";
+import { BlockchainEvent as a } from "../../BlockchainEvent/BlockchainEvent.mjs";
+import { ethers as o } from "ethers";
+//#region libs/shared/common/src/data-structures/event-service/evm/BlockchainEventEmitter.ts
+var s = class {
+	RETRY_MIN_PAGE_SIZE = 100;
+	MAX_RETRIES = 20;
+	_chainId;
+	contract;
+	depositOnChainUtxosContract;
+	_latestBlockNumber;
+	_initialBlockNumber;
+	onEventsProcessed;
+	eventProcessors = /* @__PURE__ */ new Set();
+	maxPageSize;
+	_isReady = !1;
+	isServer;
+	inProgress;
+	eventsFetchingMutex;
+	constructor(e, t, n, r, i, a, o) {
+		this.contract = t, this.depositOnChainUtxosContract = o, this._chainId = e, this._initialBlockNumber = n, this.maxPageSize = a, this.isServer = r, this.inProgress = !1, this.eventsFetchingMutex = i;
+	}
+	get latestBlockNumber() {
+		return this._latestBlockNumber ?? this._initialBlockNumber;
+	}
+	get chainId() {
+		return this._chainId;
+	}
+	get isReady() {
+		return this._isReady;
+	}
+	syncFromAtMost(e) {
+		(this._latestBlockNumber === void 0 || e < this._latestBlockNumber) && (this._latestBlockNumber = e);
+	}
+	advanceLatestBlockNumber(e) {
+		e > (this._latestBlockNumber ?? this._initialBlockNumber) && (this._latestBlockNumber = e);
+	}
+	intervalClear() {
+		this._isReady = !1, this.eventProcessors = /* @__PURE__ */ new Set(), this.clear();
+	}
+	async init() {
+		if (this._isReady) throw Error("Already initialized");
+		this._isReady = !0, await this.retrieveEvents(this.latestBlockNumber + 1), this.startUpdateListener();
+	}
+	requireReady() {
+		if (!this._isReady) throw Error("Not ready");
+	}
+	async getEventsForSingleContract(e, t, n, r = 0) {
+		try {
+			return (await e.queryFilter("*", t, n)).filter((e) => e instanceof o.EventLog);
+		} catch (i) {
+			if (r < this.MAX_RETRIES && n - t > this.RETRY_MIN_PAGE_SIZE) {
+				let i = Math.floor((t + n) / 2), a = await this.getEventsForSingleContract(e, t, i, r + 1), o = await this.getEventsForSingleContract(e, i + 1, n, r + 1);
+				return [...a, ...o];
+			}
+			throw i;
+		}
+	}
+	addEventProcessorFunction(e) {
+		if (this._isReady) throw Error("Can't add event processor after event emitter initialized");
+		this.eventProcessors.add(e);
+	}
+	async getEventsInRange(e, r) {
+		let i = [], o = t(e, r, this.maxPageSize);
+		await n(o.map(({ from: e, to: t }) => async () => {
+			let n = await this.getEventsForSingleContract(this.contract, e, t);
+			i.push(...n);
+		}));
+		let s = this.depositOnChainUtxosContract;
+		return s && await n(o.map(({ from: e, to: t }) => async () => {
+			let n = await this.getEventsForSingleContract(s, e, t);
+			i.push(...n);
+		})), i.map((e) => a.fromEthers(e));
+	}
+	async getLastBlockNumberForEventRequest() {
+		let e = await i(this.contract).getBlockNumber();
+		if (!this.isServer) return e;
+		let { chainId: t } = await i(this.contract).getNetwork();
+		return Math.max(this.latestBlockNumber, e - r[Number(t)] + 1);
+	}
+	async retrieveEvents(t, n = !1) {
+		return this.requireReady(), await this.eventsFetchingMutex.runExclusive(async () => {
+			try {
+				if (this.inProgress && !n) return !1;
+				this.inProgress = !0;
+				let e = await this.getLastBlockNumberForEventRequest();
+				if (e < t) return this.inProgress = !1, !1;
+				let r = await this.getEventsInRange(t, e);
+				return await this.processEvents(r, e), this._latestBlockNumber = e, this.inProgress = !1, !0;
+			} catch (t) {
+				return e.error("retrieveEvents error", t), this.inProgress = !1, !1;
+			}
+		});
+	}
+	async processEvents(e, t) {
+		let n = (await Promise.all([...this.eventProcessors].map((n) => n(e, t)))).reduce((e, t) => e + t, 0);
+		this.onEventsProcessed?.(n);
+	}
+};
+//#endregion
+export { s as BlockchainEventEmitter };

package/common/src/data-structures/event-service/evm/ClientBlockchainEventEmitter.d.ts

@@ -0,0 +1,11 @@
+import { ethers } from 'ethers';
+import { EventCategory } from '../../../types/events.types';
+import { BlockchainEventEmitter } from './BlockchainEventEmitter';
+import { ChainBalanceFetchingLock } from '../../../mutexes/chainBalanceRwLock';
+import { ClientEventHelper } from '../helpers/ClientEventHelper';
+export declare class ClientBlockchainEventEmitter extends BlockchainEventEmitter {
+    clientEventHelper: ClientEventHelper;
+    constructor(eventCategory: EventCategory, chainId: number, contract: ethers.Contract, initialBlockNumber: number, eventsFetchingMutex: ChainBalanceFetchingLock, maxPageSize?: number, depositOnChainUtxosContract?: ethers.Contract);
+    protected clear(): void;
+    protected startUpdateListener(): void;
+}

package/common/src/data-structures/event-service/evm/PollingBlockchainEventEmitter.cjs

@@ -0,0 +1 @@
+require(`./BlockchainEventEmitter.cjs`);

package/common/src/data-structures/event-service/evm/PollingBlockchainEventEmitter.mjs

@@ -0,0 +1 @@
+import "./BlockchainEventEmitter.mjs";

package/common/src/data-structures/event-service/helpers/ClientEventHelper.cjs

@@ -0,0 +1 @@
+const e=require(`../../../error-handling/logger.cjs`),t=require(`../../../API/API.cjs`),n=require(`../../BlockchainEvent/BlockchainEvent.cjs`);var r=5e3,i=class{chainId;eventCategory;pollIntervalId;constructor(e,t){this.chainId=e,this.eventCategory=t}clear(){this.pollIntervalId!=null&&(clearInterval(this.pollIntervalId),this.pollIntervalId=void 0)}startUpdateListener(i,a,o){let s=a,c=async()=>{try{let{events:e,latestBlockNumber:r}=await t.API.getSnapshotServerEvents(this.chainId,this.eventCategory,s);e.length>0&&await i(e.map(e=>n.BlockchainEvent.fromSerialized(e))),r>=s&&(s=r+1,o(s))}catch(t){e.Logger.error(`Snapshot events poll error`,t)}};this.pollIntervalId=setInterval(c,r)}};exports.ClientEventHelper=i;

package/common/src/data-structures/event-service/helpers/ClientEventHelper.mjs

@@ -0,0 +1,28 @@
+import { Logger as e } from "../../../error-handling/logger.mjs";
+import { API as t } from "../../../API/API.mjs";
+import { BlockchainEvent as n } from "../../BlockchainEvent/BlockchainEvent.mjs";
+//#region libs/shared/common/src/data-structures/event-service/helpers/ClientEventHelper.ts
+var r = 5e3, i = class {
+	chainId;
+	eventCategory;
+	pollIntervalId;
+	constructor(e, t) {
+		this.chainId = e, this.eventCategory = t;
+	}
+	clear() {
+		this.pollIntervalId != null && (clearInterval(this.pollIntervalId), this.pollIntervalId = void 0);
+	}
+	startUpdateListener(i, a, o) {
+		let s = a, c = async () => {
+			try {
+				let { events: e, latestBlockNumber: r } = await t.getSnapshotServerEvents(this.chainId, this.eventCategory, s);
+				e.length > 0 && await i(e.map((e) => n.fromSerialized(e))), r >= s && (s = r + 1, o(s));
+			} catch (t) {
+				e.error("Snapshot events poll error", t);
+			}
+		};
+		this.pollIntervalId = setInterval(c, r);
+	}
+};
+//#endregion
+export { i as ClientEventHelper };

package/common/src/data-structures/event-service/solana/AbstractSolanaCommitmentsSnapshotService.cjs

@@ -0,0 +1 @@
+const e=require(`../../../functions/utils/amounts.utils.cjs`),t=require(`../../../crypto/poseidon.cjs`),n=require(`../../crypto-keys/decodeUTXO.cjs`);require(`../../../crypto/index.cjs`);const r=require(`../../merkle-tree/MerkleTree.cjs`);require(`../../merkle-tree/index.cjs`);const i=require(`../../../functions/utils/merkleTree.utils.cjs`),a=require(`./AbstractSolanaSnapshotService.cjs`);var o=class extends a.AbstractSolanaSnapshotService{constructor(e){super(e,`NewCommitment`)}_merkleTree;_encryptedOutputs;_encryptedOutputsByCommitment=new Map;get merkleTree(){return this._merkleTree}get encryptedOutputs(){return this._encryptedOutputs}serializeSnapshot(e){return{merkleTree:e.payload.merkleTree.toJSON(),latestBlockNumber:e.latestBlockNumber,encryptedOutputs:e.payload.encryptedOutputs.map(e=>({value:e.value,isPositive:String(e.isPositive),isBlocked:e.isBlocked??!1})),encryptedOutputsByCommitment:Array.from(e.payload.encryptedOutputsByCommitment.entries()).map(([e,t])=>({commitment:e.toString(),encryptedOutput:t}))}}deserializeSnapshot(e){let n;n=e.latestBlockNumber&&e.merkleTree?i.contructMerkleTreeFromSerialized(e.merkleTree):r.MerkleTree.create(t.poseidonFunction,0n);let a=e.encryptedOutputs?.map(e=>({value:e.value,isPositive:JSON.parse(e.isPositive),isBlocked:e.isBlocked??!1})),o=new Map;return e.encryptedOutputsByCommitment?.forEach(({commitment:e,encryptedOutput:t})=>{o.set(BigInt(e),t)}),{latestBlockNumber:e.latestBlockNumber??0,payload:{merkleTree:n,encryptedOutputs:a||[],encryptedOutputsByCommitment:o}}}getSnapshotPayload(){return{merkleTree:this._merkleTree,encryptedOutputs:this._encryptedOutputs,encryptedOutputsByCommitment:this._encryptedOutputsByCommitment}}populateSnapshot({payload:{merkleTree:e,encryptedOutputs:t,encryptedOutputsByCommitment:n}}){this._merkleTree=e,this._encryptedOutputs=t,this._encryptedOutputsByCommitment=n}async mapEvent(t){let r=t.getArg(`commitment`),i=t.getArg(`index`),a=t.getArg(`encrypted_output`),o=t.getArg(`on_chain_data`),s=e.advancedToBigInt(r),c=e.advancedToBigInt(i);return a.length===0?{commitment:s,index:c,encryptedOutput:n.encodeSolanaOnChainUtxo(o)}:{commitment:s,index:c,encryptedOutput:`0x${Buffer.from(a).toString(`hex`)}`}}acceptEvent(e,t,r,i){let a=e.index>=0n?e.index:-1n*e.index,o=this._merkleTree.getValue(a);if(o===e.commitment)return!1;this._merkleTree.insert(e.commitment,a);let s=o===void 0?void 0:this._encryptedOutputsByCommitment.get(o);if(o!==void 0&&s!==void 0){let e=this.encryptedOutputs.findIndex(e=>e.value===s);e!==-1&&this.encryptedOutputs.splice(e,1),this._encryptedOutputsByCommitment.delete(o)}if(this._encryptedOutputsByCommitment.set(e.commitment,e.encryptedOutput),this.encryptedOutputs.map(e=>e.value).includes(e.encryptedOutput))return!0;let c={value:e.encryptedOutput,isPositive:!n.isSolanaOnChainUtxo(e.encryptedOutput),isBlocked:i??!1};return this._encryptedOutputs.push(c),!0}};exports.AbstractSolanaCommitmentsSnapshotService=o;

package/common/src/data-structures/event-service/solana/AbstractSolanaCommitmentsSnapshotService.mjs

@@ -0,0 +1,98 @@
+import { advancedToBigInt as e } from "../../../functions/utils/amounts.utils.mjs";
+import { poseidonFunction as t } from "../../../crypto/poseidon.mjs";
+import { encodeSolanaOnChainUtxo as n, isSolanaOnChainUtxo as r } from "../../crypto-keys/decodeUTXO.mjs";
+import "../../../crypto/index.mjs";
+import { MerkleTree as i } from "../../merkle-tree/MerkleTree.mjs";
+import "../../merkle-tree/index.mjs";
+import { contructMerkleTreeFromSerialized as a } from "../../../functions/utils/merkleTree.utils.mjs";
+import { AbstractSolanaSnapshotService as o } from "./AbstractSolanaSnapshotService.mjs";
+//#region libs/shared/common/src/data-structures/event-service/solana/AbstractSolanaCommitmentsSnapshotService.ts
+var s = class extends o {
+	constructor(e) {
+		super(e, "NewCommitment");
+	}
+	_merkleTree;
+	_encryptedOutputs;
+	_encryptedOutputsByCommitment = /* @__PURE__ */ new Map();
+	get merkleTree() {
+		return this._merkleTree;
+	}
+	get encryptedOutputs() {
+		return this._encryptedOutputs;
+	}
+	serializeSnapshot(e) {
+		return {
+			merkleTree: e.payload.merkleTree.toJSON(),
+			latestBlockNumber: e.latestBlockNumber,
+			encryptedOutputs: e.payload.encryptedOutputs.map((e) => ({
+				value: e.value,
+				isPositive: String(e.isPositive),
+				isBlocked: e.isBlocked ?? !1
+			})),
+			encryptedOutputsByCommitment: Array.from(e.payload.encryptedOutputsByCommitment.entries()).map(([e, t]) => ({
+				commitment: e.toString(),
+				encryptedOutput: t
+			}))
+		};
+	}
+	deserializeSnapshot(e) {
+		let n;
+		n = e.latestBlockNumber && e.merkleTree ? a(e.merkleTree) : i.create(t, 0n);
+		let r = e.encryptedOutputs?.map((e) => ({
+			value: e.value,
+			isPositive: JSON.parse(e.isPositive),
+			isBlocked: e.isBlocked ?? !1
+		})), o = /* @__PURE__ */ new Map();
+		return e.encryptedOutputsByCommitment?.forEach(({ commitment: e, encryptedOutput: t }) => {
+			o.set(BigInt(e), t);
+		}), {
+			latestBlockNumber: e.latestBlockNumber ?? 0,
+			payload: {
+				merkleTree: n,
+				encryptedOutputs: r || [],
+				encryptedOutputsByCommitment: o
+			}
+		};
+	}
+	getSnapshotPayload() {
+		return {
+			merkleTree: this._merkleTree,
+			encryptedOutputs: this._encryptedOutputs,
+			encryptedOutputsByCommitment: this._encryptedOutputsByCommitment
+		};
+	}
+	populateSnapshot({ payload: { merkleTree: e, encryptedOutputs: t, encryptedOutputsByCommitment: n } }) {
+		this._merkleTree = e, this._encryptedOutputs = t, this._encryptedOutputsByCommitment = n;
+	}
+	async mapEvent(t) {
+		let r = t.getArg("commitment"), i = t.getArg("index"), a = t.getArg("encrypted_output"), o = t.getArg("on_chain_data"), s = e(r), c = e(i);
+		return a.length === 0 ? {
+			commitment: s,
+			index: c,
+			encryptedOutput: n(o)
+		} : {
+			commitment: s,
+			index: c,
+			encryptedOutput: `0x${Buffer.from(a).toString("hex")}`
+		};
+	}
+	acceptEvent(e, t, n, i) {
+		let a = e.index >= 0n ? e.index : -1n * e.index, o = this._merkleTree.getValue(a);
+		if (o === e.commitment) return !1;
+		this._merkleTree.insert(e.commitment, a);
+		let s = o === void 0 ? void 0 : this._encryptedOutputsByCommitment.get(o);
+		if (o !== void 0 && s !== void 0) {
+			let e = this.encryptedOutputs.findIndex((e) => e.value === s);
+			e !== -1 && this.encryptedOutputs.splice(e, 1), this._encryptedOutputsByCommitment.delete(o);
+		}
+		if (this._encryptedOutputsByCommitment.set(e.commitment, e.encryptedOutput), this.encryptedOutputs.map((e) => e.value).includes(e.encryptedOutput)) return !0;
+		let c = {
+			value: e.encryptedOutput,
+			isPositive: !r(e.encryptedOutput),
+			isBlocked: i ?? !1
+		};
+		return this._encryptedOutputs.push(c), !0;
+	}
+};
+//#endregion
+export { s as AbstractSolanaCommitmentsSnapshotService };

package/common/src/data-structures/event-service/solana/AbstractSolanaNullifierSnapshotService.cjs

@@ -0,0 +1 @@
+require(`../../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../../functions/utils/amounts.utils.cjs`),t=require(`./AbstractSolanaSnapshotService.cjs`);let n=require(`ethers`);var r=class extends t.AbstractSolanaSnapshotService{constructor(e){super(e,`Nullified`)}_nullifiers;get nullifiers(){return this._nullifiers}serializeSnapshot(e){return{nullifiers:Array.from(e.payload.nullifiers).map(e=>e.toString()),latestBlockNumber:e.latestBlockNumber}}deserializeSnapshot(e){return{latestBlockNumber:e.latestBlockNumber??0,payload:{nullifiers:new Set(e.nullifiers??[])}}}acceptEvent(e,t){try{return this._nullifiers.has(e.nullifier)?!1:(this._nullifiers.add(e.nullifier),!0)}catch(e){return console.error(e),!1}}mapEvent(t){return{nullifier:n.ethers.toBeHex(e.advancedToBigInt(t.getArg(`nullifier`)))}}getSnapshotPayload(){return{nullifiers:this._nullifiers}}populateSnapshot({payload:{nullifiers:e}}){this._nullifiers=e}};exports.AbstractSolanaNullifierSnapshotService=r;

package/common/src/data-structures/event-service/solana/ClientSolanaBlockchainEventEmitter.d.ts

@@ -0,0 +1,11 @@
+import { Connection, PublicKey } from '@solana/web3.js';
+import { Idl } from '@coral-xyz/anchor';
+import { SolanaBlockchainEventEmitter } from './SolanaBlockchainEventEmitter';
+import { ChainBalanceFetchingLock } from '../../../mutexes/chainBalanceRwLock';
+import { ClientEventHelper } from '../helpers/ClientEventHelper';
+export declare class ClientSolanaBlockchainEventEmitter extends SolanaBlockchainEventEmitter {
+    clientEventHelper: ClientEventHelper;
+    constructor(chainId: number, connection: Connection, programId: PublicKey, initialSlot: number, eventsFetchingMutex: ChainBalanceFetchingLock, maxPageSize?: number, idl?: Idl);
+    protected clear(): void;
+    protected startUpdateListener(): void;
+}

package/common/src/data-structures/event-service/solana/PollingSolanaBlockchainEventEmitter.cjs

@@ -0,0 +1 @@
+require(`./SolanaBlockchainEventEmitter.cjs`);

package/common/src/data-structures/event-service/solana/PollingSolanaBlockchainEventEmitter.mjs

@@ -0,0 +1 @@
+import "./SolanaBlockchainEventEmitter.mjs";

package/common/src/data-structures/event-service/solana/SolanaBlockchainEventEmitter.cjs

@@ -0,0 +1 @@
+require(`../../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../../functions/utils/serialize.utils.cjs`),t=require(`../../../error-handling/logger.cjs`),n=require(`../../../functions/utils/resolve-sync.utils.cjs`),r=require(`../../BlockchainEvent/BlockchainEvent.cjs`);let i=require(`@coral-xyz/anchor`);var a=1e3,o=20,s=class{_chainId;connection;programId;_latestSlot;_initialSlot;onEventsProcessed;eventProcessors=new Set;maxPageSize;_isReady=!1;isServer;inProgress;anchorParser;anchorCoder;eventsFetchingMutex;constructor(e,t,n,r,i,a,o){this._chainId=e,this.connection=t,this.programId=n,this._initialSlot=r,this.maxPageSize=o,this.isServer=i,this.inProgress=!1,this.eventsFetchingMutex=a}get chainId(){return this._chainId}get latestBlockNumber(){return this._latestSlot??this._initialSlot}get isReady(){return this._isReady}setIdl(e){try{let t=new i.BorshCoder(e);this.anchorCoder=t,this.anchorParser=new i.EventParser(this.programId,t)}catch(e){t.Logger.error(`Failed to initialize Anchor EventParser:`,e),this.anchorParser=void 0,this.anchorCoder=void 0}}syncFromAtMost(e){(this._latestSlot===void 0||e<this._latestSlot)&&(this._latestSlot=e)}advanceLatestBlockNumber(e){e>(this._latestSlot??this._initialSlot)&&(this._latestSlot=e)}intervalClear(){this._isReady=!1,this.eventProcessors=new Set,this.clear()}async init(){if(this._isReady)throw Error(`Already initialized`);this._isReady=!0,await this.retrieveEvents(this.latestBlockNumber+1,!1,!0),this.startUpdateListener()}requireReady(){if(!this._isReady)throw Error(`Not ready`)}addEventProcessorFunction(e){if(this._isReady)throw Error(`Can't add event processor after event emitter initialized`);this.eventProcessors.add(e)}async getEventsInRange(e,t){return(await this.getProgramEvents(e,t)).map(e=>r.BlockchainEvent.fromSolanaEvent(e))}async getLastBlockNumberForEventRequest(){let e=await this.connection.getSlot();return this.isServer?Math.max(this.latestBlockNumber,e-32+1):e}async retrieveEvents(e,i=!1,a=!1){let o=e;return this.requireReady(),await this.eventsFetchingMutex.runExclusive(async()=>{try{if(this.inProgress&&!i)return!1;this.inProgress=!0;let e=await this.getLastBlockNumberForEventRequest();if(e<o)return this.inProgress=!1,!1;let t=n.getSequence(o,e,this.maxPageSize),s=[];await n.resolveSync(t.map(({from:e,to:t})=>async()=>{let n=await this.getProgramEvents(e,t,a);s.push(...n)})),s.sort((e,t)=>e.slot-t.slot);let c=s.map(e=>r.BlockchainEvent.fromSolanaEvent(e));return await this.processEvents(c,e),this._latestSlot=e,this.inProgress=!1,!0}catch(e){return t.Logger.error(`retrieveEvents error:`,e),this.inProgress=!1,!1}})}async getProgramEvents(e,n,r=!1){let i=[],s=r?a:o;try{let r=await this.connection.getSignaturesForAddress(this.programId,{limit:s,before:void 0}),a=r.length;for(;a>=s&&r[r.length-1].slot>=e;){let e=r[r.length-1],t=await this.connection.getSignaturesForAddress(this.programId,{limit:s,before:e.signature});if(t.length===0)break;r.push(...t),a=t.length}let o=r.filter(t=>t.slot>=e&&t.slot<=n).map(async e=>{try{let t=await this.connection.getTransaction(e.signature,{commitment:`confirmed`,maxSupportedTransactionVersion:0});return t&&t.meta&&!t.meta.err?this.parseTransactionForEvents(t,e.signature,e.slot,t.blockTime||null):[]}catch(n){return t.Logger.error(`Failed to get transaction ${e.signature}:`,n),[]}}),c=await Promise.all(o);i.push(...c.flat())}catch(e){t.Logger.error(`Error getting program events:`,e)}return i}parseTransactionForEvents(t,n,r,i){let a=this.parseLogsForEvents(t?.meta?.logMessages??[],n,r,i),o=this.parseCpiForEvents(t,n,r,i),s=[...a,...o];if(s.length===0)return[];let c=new Set;return s.filter(t=>{let n=`${t.signature}:${t.eventName}:${e.safeJsonStringify(t.data)}`;return c.has(n)?!1:(c.add(n),!0)})}parseLogsForEvents(e,n,r,i){if(!this.anchorParser)return[];try{return Array.from(this.anchorParser.parseLogs(e)).map(({name:e,data:t})=>({signature:n,slot:r,blockTime:i||0,programId:this.programId,data:t,eventName:e}))}catch(e){return t.Logger.error(`Anchor EventParser failed; falling back to generic parsing:`,e),[]}}parseCpiForEvents(e,n,r,a){if(!e||!this.anchorCoder)return[];let o=e.meta?.innerInstructions??[];if(o.length===0)return[];try{return o.flatMap(e=>e.instructions??[]).map(e=>{try{if(!e?.data)return null;let t=i.utils.bytes.bs58.decode(e.data);if(t.length<=8)return null;let o=i.utils.bytes.base64.encode(t.subarray(8)),s=this.anchorCoder?.events.decode(o);return s?{signature:n,slot:r,blockTime:a||0,programId:this.programId,data:s.data,eventName:s.name}:null}catch{return null}}).filter(e=>e!==null)}catch(e){return t.Logger.error(`Failed to parse emit_cpi events:`,e),[]}}async processEvents(e,t){let n=(await Promise.all([...this.eventProcessors].map(n=>n(e,t)))).reduce((e,t)=>e+t,0);this.onEventsProcessed?.(n)}};exports.SolanaBlockchainEventEmitter=s;

package/common/src/data-structures/event-service/solana/SolanaBlockchainEventEmitter.d.ts

@@ -0,0 +1,42 @@
+import { Connection, PublicKey } from '@solana/web3.js';
+import { Idl } from '@coral-xyz/anchor';
+import { ChainBalanceFetchingLock } from '../../../mutexes/chainBalanceRwLock';
+import { EventProcessorFunction } from '../../../types/events.types';
+import { BlockchainEvent } from '../../BlockchainEvent/BlockchainEvent';
+export declare abstract class SolanaBlockchainEventEmitter {
+    private readonly _chainId;
+    readonly connection: Connection;
+    readonly programId: PublicKey;
+    private _latestSlot;
+    private _initialSlot;
+    onEventsProcessed?: (acceptedEventCount: number) => void;
+    private eventProcessors;
+    private readonly maxPageSize?;
+    private _isReady;
+    protected isServer: boolean;
+    private inProgress;
+    private anchorParser?;
+    private anchorCoder?;
+    protected eventsFetchingMutex: ChainBalanceFetchingLock;
+    constructor(chainId: number, connection: Connection, programId: PublicKey, initialSlot: number, isServer: boolean, eventsFetchingMutex: ChainBalanceFetchingLock, maxPageSize?: number);
+    get chainId(): number;
+    get latestBlockNumber(): number;
+    get isReady(): boolean;
+    setIdl(idl: Idl): void;
+    syncFromAtMost(slot: number): void;
+    protected advanceLatestBlockNumber(slot: number): void;
+    intervalClear(): void;
+    init(): Promise<void>;
+    private requireReady;
+    addEventProcessorFunction(eventProcessorFunction: EventProcessorFunction): void;
+    getEventsInRange(fromSlot: number, toSlot: number): Promise<BlockchainEvent[]>;
+    getLastBlockNumberForEventRequest(): Promise<number>;
+    retrieveEvents(fromBlock: number, useForce?: boolean, initialLoading?: boolean): Promise<boolean>;
+    private getProgramEvents;
+    private parseTransactionForEvents;
+    private parseLogsForEvents;
+    private parseCpiForEvents;
+    protected processEvents(events: BlockchainEvent[], scannedToBlock?: number): Promise<void>;
+    protected abstract clear(): void;
+    protected abstract startUpdateListener(): void;
+}

package/common/src/data-structures/http/BasicHttpClient.cjs

@@ -0,0 +1 @@
+const e=require(`../../../../_virtual/_rolldown/runtime.cjs`);let t=require(`axios`);t=e.__toESM(t);var n=class{axiosInstance;constructor(){this.axiosInstance=t.default.create()}async get(e,t){return(await this.axiosInstance.get(e,t)).data}async post(e,t,n){return(await this.axiosInstance.post(e,t,n)).data}async put(e,t,n){return(await this.axiosInstance.put(e,t,n)).data}async patch(e,t,n){return(await this.axiosInstance.patch(e,t,n)).data}async delete(e,t){return(await this.axiosInstance.delete(e,t)).data}};exports.BasicHttpClient=n;

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

@@ -0,0 +1,22 @@
+export * from './ValueCache';
+export * from './crypto-keys';
+export * from './Hinkal';
+export * from './private-balances';
+export * from './merkle-tree';
+export * from './provider-adapter/IProviderAdapter';
+export * from './event-service';
+export * from './utxo/Utxo';
+export * from './custom-token-registry/CustomTokenRegistry';
+export * from './token-price-fetcher';
+export * from './transactions-manager';
+export * from './MultiThreadedUtxoUtils/MultiThreadedUtxoUtils';
+export * from './cacheDevices';
+export * from './IndexedDB';
+export * from './TokenDBs';
+export * from './presale';
+export * from './snapshot';
+export * from './http';
+export * from './ApprovalDBs';
+export * from './BlockchainEvent/BlockchainEvent';
+export * from './AccountActions';
+export * from './WalletManager';

package/common/src/data-structures/private-balances/BalanceChangedHandler.cjs

@@ -0,0 +1 @@
+var e=class{listeners=new Set;subscribe(e){return this.listeners.add(e),()=>this.listeners.delete(e)}dispatch(e){this.listeners.forEach(t=>t(e))}},t=new e;exports.BalanceChangedHandler=e,exports.balanceChangedHandler=t;

package/common/src/data-structures/private-balances/BalanceChangedHandler.d.ts

@@ -0,0 +1,9 @@
+import { PrivateBalanceUpdateEventType } from '../../types';
+type BalanceChangeListener = (detail?: PrivateBalanceUpdateEventType) => void;
+export declare class BalanceChangedHandler {
+    private readonly listeners;
+    subscribe(listener: BalanceChangeListener): () => void;
+    dispatch(detail: PrivateBalanceUpdateEventType): void;
+}
+export declare const balanceChangedHandler: BalanceChangedHandler;
+export {};

package/common/src/data-structures/private-balances/BalanceChangedHandler.mjs

@@ -0,0 +1,12 @@
+//#region libs/shared/common/src/data-structures/private-balances/BalanceChangedHandler.ts
+var e = class {
+	listeners = /* @__PURE__ */ new Set();
+	subscribe(e) {
+		return this.listeners.add(e), () => this.listeners.delete(e);
+	}
+	dispatch(e) {
+		this.listeners.forEach((t) => t(e));
+	}
+}, t = new e();
+//#endregion
+export { e as BalanceChangedHandler, t as balanceChangedHandler };

package/common/src/data-structures/private-balances/HinkalPrivateBalanceController.cjs

@@ -0,0 +1 @@
+const e=require(`../../functions/web3/etherFunctions.cjs`),t=require(`../../functions/utils/upToDateState.cjs`),n=require(`../../types/balances.types.cjs`),r=require(`../../error-handling/logger.cjs`),i=require(`../../functions/utils/string.utils.cjs`),a=require(`./BalanceChangedHandler.cjs`),o=require(`../IndexedDB/private-balances-db.cjs`),s=require(`../IndexedDB/prices-db.cjs`),c=require(`./privateBalancesReducer.cjs`);var l=class{privateBalancesState={};privateBalancesListeners=new Set;hinkal;unsubscribeBalanceChange;constructor(e){this.hinkal=e,this.unsubscribeBalanceChange=a.balanceChangedHandler.subscribe(e=>{this.applyRefreshFromBalanceChangeEvent(e).catch(e=>{r.Logger.error(`Private balance refresh from balance change failed:`,e)})})}getSnapshot(){return this.privateBalancesState}onPrivateBalancesWithUSDChange(e){return this.privateBalancesListeners.add(e),()=>this.privateBalancesListeners.delete(e)}dispose(){this.unsubscribeBalanceChange(),this.privateBalancesListeners.clear()}async applyRefreshFromBalanceChangeEvent(e){if(!e){await this.refreshInternal(n.PrivateBalanceUpdateType.FreshWithoutLoader);return}let{updateType:t,balanceChangeState:r,chainIdToUpdate:i,resetCacheBefore:a,updateTokensListBefore:o}=e;await this.refreshInternal(t,r,a,o,i)}dispatch(e){this.privateBalancesState=c.privateBalancesReducer(this.privateBalancesState,e);let t=this.privateBalancesState;this.privateBalancesListeners.forEach(e=>e(t))}async getAddressAndChain(e){try{return{ethAdd:e?.ethereumAddress??await this.hinkal.getEthereumAddress(),userKeys:e?.userKeys??this.hinkal.userKeys}}catch{return{ethAdd:void 0,userKeys:void 0}}}async hasCache(e,t){return await o.privateBalancesStorage.getBalancesByWallet(e,t)!==void 0}async getBalancesWithUsdValues(t,n){try{if(!n)return[];let r=t.map(e=>e.token.erc20TokenAddress);if(!r.length)return[];let i=await s.pricesStorage.getAndUpdatePrices(n,r),a=new Map(r.map((e,t)=>[e,i[t]]));return[...t.map(t=>{try{let n=t.token.erc20TokenAddress,r=a.get(n)??0,i=t.balance,o=Number(e.getAmountInToken(t.token,i))*r;return{...t,usdValue:o}}catch{return{...t,usdValue:0}}})]}catch{return r.Logger.log(`Error fetching private token balances`),[]}}handleCached=async(n,a)=>{try{await t.checkAddressNotUpdated(this.hinkal,n),this.dispatch({type:`SET_BALANCES`,chainId:a,balances:void 0});let r=await o.privateBalancesStorage.getBalancesByWallet(n,a),c=await s.pricesStorage.getPrices();if(await t.checkAddressNotUpdated(this.hinkal,n),!r||(this.dispatch({type:`SET_BALANCES`,chainId:a,balances:r}),!c))return;let l=r.map(t=>{let n=i.getTokenStateKey(t.token.erc20TokenAddress,a);return{...t,usdValue:c[n]?Number(e.getAmountInToken(t.token,t.balance))*c[n]:0}});this.dispatch({type:`SET_USD_BALANCES`,chainId:a,balances:l})}catch(e){r.Logger.error(`Error refreshing cached private balance:`,e)}};handleFresh=async(e,n,i,a,s,c)=>{let l=s;try{await t.checkAddressNotUpdated(this.hinkal,e);let r=await this.hasCache(e,n);await t.checkAddressNotUpdated(this.hinkal,e),l=s||!r,l&&this.dispatch({type:`SET_LOADING`,chainId:n,newValue:!0}),await t.checkAddressNotUpdated(this.hinkal,e),a&&await this.hinkal.resetMerkle([n]);let u=await this.hinkal.getTotalBalance(n,i,e,a,c);await t.checkAddressNotUpdated(this.hinkal,e);let d=u.filter(e=>e.balance>0n);this.dispatch({type:`SET_BALANCES`,chainId:n,balances:d}),await o.privateBalancesStorage.setBalances(e,n,d),await t.checkAddressNotUpdated(this.hinkal,e),l&&(this.dispatch({type:`SET_USD_LOADING`,chainId:n,newValue:!0}),this.dispatch({type:`SET_LOADING`,chainId:n,newValue:!1})),await t.checkAddressNotUpdated(this.hinkal,e);let f=await this.getBalancesWithUsdValues(d,n);await t.checkAddressNotUpdated(this.hinkal,e),f.length>0&&this.dispatch({type:`SET_USD_BALANCES`,chainId:n,balances:f})}catch(e){r.Logger.error(`Error refreshing private balance:`,e)}finally{l&&(this.dispatch({type:`SET_LOADING`,chainId:n,newValue:!1}),this.dispatch({type:`SET_USD_LOADING`,chainId:n,newValue:!1}))}};getSupportedChainsToUpdate(e){let t=this.hinkal.getSupportedChains();return e?t.includes(e)?[e]:[]:t}async refreshInternal(e=n.PrivateBalanceUpdateType.FreshWithoutLoader,t,r=!1,i=!1,a){let{ethAdd:o,userKeys:s}=await this.getAddressAndChain(t);!o||!s?.getShieldedPublicKey()||await Promise.all(this.getSupportedChainsToUpdate(a).map(async t=>{switch(e){case n.PrivateBalanceUpdateType.OnlyCache:await this.handleCached(o,t);break;case n.PrivateBalanceUpdateType.Fresh:await this.handleFresh(o,t,s,r,!0,i);break;case n.PrivateBalanceUpdateType.FreshWithoutLoader:await this.handleFresh(o,t,s,r,!1,i);break;default:break}}))}};exports.HinkalPrivateBalanceController=l;

package/common/src/data-structures/private-balances/HinkalPrivateBalanceController.d.ts

@@ -0,0 +1,21 @@
+import { PrivateBalancesState } from '../../types/balances.types';
+import { IHinkal } from '../Hinkal/IHinkal';
+export declare class HinkalPrivateBalanceController {
+    private privateBalancesState;
+    private readonly privateBalancesListeners;
+    private readonly hinkal;
+    private readonly unsubscribeBalanceChange;
+    constructor(hinkal: IHinkal);
+    getSnapshot(): PrivateBalancesState;
+    onPrivateBalancesWithUSDChange(callback: (state: PrivateBalancesState) => void): () => void;
+    dispose(): void;
+    private applyRefreshFromBalanceChangeEvent;
+    private dispatch;
+    private getAddressAndChain;
+    private hasCache;
+    private getBalancesWithUsdValues;
+    private handleCached;
+    private handleFresh;
+    private getSupportedChainsToUpdate;
+    private refreshInternal;
+}

package/common/src/data-structures/private-balances/HinkalPrivateBalanceController.mjs

@@ -0,0 +1,183 @@
+import { getAmountInToken as e } from "../../functions/web3/etherFunctions.mjs";
+import { checkAddressNotUpdated as t } from "../../functions/utils/upToDateState.mjs";
+import { PrivateBalanceUpdateType as n } from "../../types/balances.types.mjs";
+import { Logger as r } from "../../error-handling/logger.mjs";
+import { getTokenStateKey as i } from "../../functions/utils/string.utils.mjs";
+import { balanceChangedHandler as a } from "./BalanceChangedHandler.mjs";
+import { privateBalancesStorage as o } from "../IndexedDB/private-balances-db.mjs";
+import { pricesStorage as s } from "../IndexedDB/prices-db.mjs";
+import { privateBalancesReducer as c } from "./privateBalancesReducer.mjs";
+//#region libs/shared/common/src/data-structures/private-balances/HinkalPrivateBalanceController.ts
+var l = class {
+	privateBalancesState = {};
+	privateBalancesListeners = /* @__PURE__ */ new Set();
+	hinkal;
+	unsubscribeBalanceChange;
+	constructor(e) {
+		this.hinkal = e, this.unsubscribeBalanceChange = a.subscribe((e) => {
+			this.applyRefreshFromBalanceChangeEvent(e).catch((e) => {
+				r.error("Private balance refresh from balance change failed:", e);
+			});
+		});
+	}
+	getSnapshot() {
+		return this.privateBalancesState;
+	}
+	onPrivateBalancesWithUSDChange(e) {
+		return this.privateBalancesListeners.add(e), () => this.privateBalancesListeners.delete(e);
+	}
+	dispose() {
+		this.unsubscribeBalanceChange(), this.privateBalancesListeners.clear();
+	}
+	async applyRefreshFromBalanceChangeEvent(e) {
+		if (!e) {
+			await this.refreshInternal(n.FreshWithoutLoader);
+			return;
+		}
+		let { updateType: t, balanceChangeState: r, chainIdToUpdate: i, resetCacheBefore: a, updateTokensListBefore: o } = e;
+		await this.refreshInternal(t, r, a, o, i);
+	}
+	dispatch(e) {
+		this.privateBalancesState = c(this.privateBalancesState, e);
+		let t = this.privateBalancesState;
+		this.privateBalancesListeners.forEach((e) => e(t));
+	}
+	async getAddressAndChain(e) {
+		try {
+			return {
+				ethAdd: e?.ethereumAddress ?? await this.hinkal.getEthereumAddress(),
+				userKeys: e?.userKeys ?? this.hinkal.userKeys
+			};
+		} catch {
+			return {
+				ethAdd: void 0,
+				userKeys: void 0
+			};
+		}
+	}
+	async hasCache(e, t) {
+		return await o.getBalancesByWallet(e, t) !== void 0;
+	}
+	async getBalancesWithUsdValues(t, n) {
+		try {
+			if (!n) return [];
+			let r = t.map((e) => e.token.erc20TokenAddress);
+			if (!r.length) return [];
+			let i = await s.getAndUpdatePrices(n, r), a = new Map(r.map((e, t) => [e, i[t]]));
+			return [...t.map((t) => {
+				try {
+					let n = t.token.erc20TokenAddress, r = a.get(n) ?? 0, i = t.balance, o = Number(e(t.token, i)) * r;
+					return {
+						...t,
+						usdValue: o
+					};
+				} catch {
+					return {
+						...t,
+						usdValue: 0
+					};
+				}
+			})];
+		} catch {
+			return r.log("Error fetching private token balances"), [];
+		}
+	}
+	handleCached = async (n, a) => {
+		try {
+			await t(this.hinkal, n), this.dispatch({
+				type: "SET_BALANCES",
+				chainId: a,
+				balances: void 0
+			});
+			let r = await o.getBalancesByWallet(n, a), c = await s.getPrices();
+			if (await t(this.hinkal, n), !r || (this.dispatch({
+				type: "SET_BALANCES",
+				chainId: a,
+				balances: r
+			}), !c)) return;
+			let l = r.map((t) => {
+				let n = i(t.token.erc20TokenAddress, a);
+				return {
+					...t,
+					usdValue: c[n] ? Number(e(t.token, t.balance)) * c[n] : 0
+				};
+			});
+			this.dispatch({
+				type: "SET_USD_BALANCES",
+				chainId: a,
+				balances: l
+			});
+		} catch (e) {
+			r.error("Error refreshing cached private balance:", e);
+		}
+	};
+	handleFresh = async (e, n, i, a, s, c) => {
+		let l = s;
+		try {
+			await t(this.hinkal, e);
+			let r = await this.hasCache(e, n);
+			await t(this.hinkal, e), l = s || !r, l && this.dispatch({
+				type: "SET_LOADING",
+				chainId: n,
+				newValue: !0
+			}), await t(this.hinkal, e), a && await this.hinkal.resetMerkle([n]);
+			let u = await this.hinkal.getTotalBalance(n, i, e, a, c);
+			await t(this.hinkal, e);
+			let d = u.filter((e) => e.balance > 0n);
+			this.dispatch({
+				type: "SET_BALANCES",
+				chainId: n,
+				balances: d
+			}), await o.setBalances(e, n, d), await t(this.hinkal, e), l && (this.dispatch({
+				type: "SET_USD_LOADING",
+				chainId: n,
+				newValue: !0
+			}), this.dispatch({
+				type: "SET_LOADING",
+				chainId: n,
+				newValue: !1
+			})), await t(this.hinkal, e);
+			let f = await this.getBalancesWithUsdValues(d, n);
+			await t(this.hinkal, e), f.length > 0 && this.dispatch({
+				type: "SET_USD_BALANCES",
+				chainId: n,
+				balances: f
+			});
+		} catch (e) {
+			r.error("Error refreshing private balance:", e);
+		} finally {
+			l && (this.dispatch({
+				type: "SET_LOADING",
+				chainId: n,
+				newValue: !1
+			}), this.dispatch({
+				type: "SET_USD_LOADING",
+				chainId: n,
+				newValue: !1
+			}));
+		}
+	};
+	getSupportedChainsToUpdate(e) {
+		let t = this.hinkal.getSupportedChains();
+		return e ? t.includes(e) ? [e] : [] : t;
+	}
+	async refreshInternal(e = n.FreshWithoutLoader, t, r = !1, i = !1, a) {
+		let { ethAdd: o, userKeys: s } = await this.getAddressAndChain(t);
+		!o || !s?.getShieldedPublicKey() || await Promise.all(this.getSupportedChainsToUpdate(a).map(async (t) => {
+			switch (e) {
+				case n.OnlyCache:
+					await this.handleCached(o, t);
+					break;
+				case n.Fresh:
+					await this.handleFresh(o, t, s, r, !0, i);
+					break;
+				case n.FreshWithoutLoader:
+					await this.handleFresh(o, t, s, r, !1, i);
+					break;
+				default: break;
+			}
+		}));
+	}
+};
+//#endregion
+export { l as HinkalPrivateBalanceController };

package/common/src/data-structures/private-balances/index.cjs

@@ -0,0 +1 @@
+require(`./BalanceChangedHandler.cjs`),require(`./privateBalancesReducer.cjs`),require(`./HinkalPrivateBalanceController.cjs`);

package/common/src/data-structures/private-balances/index.d.ts

@@ -0,0 +1,3 @@
+export * from './BalanceChangedHandler';
+export * from './HinkalPrivateBalanceController';
+export * from './privateBalancesReducer';

package/common/src/data-structures/private-balances/index.mjs

@@ -0,0 +1,3 @@
+import "./BalanceChangedHandler.mjs";
+import "./privateBalancesReducer.mjs";
+import "./HinkalPrivateBalanceController.mjs";

package/common/src/data-structures/private-balances/privateBalancesReducer.cjs

@@ -0,0 +1 @@
+const e=require(`../../functions/utils/token-check.utils.cjs`);var t=(t,n)=>{switch(n.type){case`SET_BALANCES`:{let r=t[n.chainId];if(n.balances===void 0){let e={...t};return delete e[n.chainId],Object.keys(e).length>0?e:{}}if(r===void 0)return{...t,[n.chainId]:n.balances};let i=n.balances,a=i.filter(t=>!r.some(n=>e.isSameERC20Token(t.token,n.token))),o=r.map(t=>({...t,balance:i.find(n=>e.isSameERC20Token(n.token,t.token))?.balance??0n})).filter(e=>e.balance>0n);return o=[...o,...a],{...t,[n.chainId]:o}}case`SET_USD_BALANCES`:{let r=t[n.chainId];if(r===void 0||n.balances===void 0)return t;let i=n.balances,a=r.map(t=>({...t,usdValue:i.find(n=>e.isSameERC20Token(n.token,t.token))?.usdValue??0}));return{...t,[n.chainId]:a}}case`CLEAR_BALANCES`:{if(n.chainId===void 0)return{};let e={...t};return delete e[n.chainId],Object.keys(e).length>0?e:{}}case`SET_LOADING`:{let e=t[n.chainId];if(e===void 0)return t;if(e.length===0&&n.newValue)return{...t,[n.chainId]:void 0};let r=e.map(e=>({...e,isBalanceLoading:n.newValue}));return{...t,[n.chainId]:r}}case`SET_USD_LOADING`:{let e=t[n.chainId];if(e===void 0)return t;let r=e.map(e=>({...e,isUsdValueLoading:n.newValue}));return{...t,[n.chainId]:r}}default:return t}};exports.privateBalancesReducer=t;

package/common/src/data-structures/private-balances/privateBalancesReducer.d.ts

@@ -0,0 +1,2 @@
+import { PrivateBalancesAction, PrivateBalancesState } from '../../types/balances.types';
+export declare const privateBalancesReducer: (currentState: PrivateBalancesState, action: PrivateBalancesAction) => PrivateBalancesState;