@sabaaa1/common 0.1.14 → 0.2.28

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

@@ -0,0 +1,43 @@
+import { advancedToBigInt as e } from "../../../functions/utils/amounts.utils.mjs";
+import { AbstractSolanaSnapshotService as t } from "./AbstractSolanaSnapshotService.mjs";
+import { ethers as n } from "ethers";
+//#region libs/shared/common/src/data-structures/event-service/solana/AbstractSolanaNullifierSnapshotService.ts
+var r = class extends t {
+	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.toBeHex(e(t.getArg("nullifier"))) };
+	}
+	getSnapshotPayload() {
+		return { nullifiers: this._nullifiers };
+	}
+	populateSnapshot({ payload: { nullifiers: e } }) {
+		this._nullifiers = e;
+	}
+};
+//#endregion
+export { r as AbstractSolanaNullifierSnapshotService };

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

@@ -0,0 +1 @@
+const e=require(`../../../constants/save-depths.cjs`),t=require(`./AbstractSolanaEventService.cjs`);var n=class extends t.AbstractSolanaEventService{savedLatestSlot=0;constructor(e,t){super(e,t)}async init(){await this.loadSnapshot()}async retrieveEventsFromLatestBlock(){await this.solanaBlockchainEventEmitter.retrieveEvents(this.latestBlockNumber)}async loadSnapshot(){let e=await this.fetchSnapshot(),t=this.deserializeSnapshot(e);this.populateSnapshot(t),this.solanaBlockchainEventEmitter.syncFromAtMost(t.latestBlockNumber),this.savedLatestSlot=t.latestBlockNumber}saveSnapshot(){return this.savedLatestSlot=this.latestBlockNumber,this.persistSnapshot(this.serializeSnapshot({latestBlockNumber:this.latestBlockNumber,payload:this.getSnapshotPayload()}))}async afterEventsAccepted(t){(t>0||this.savedLatestSlot+e.saveDepths[this.chainId]<this.latestBlockNumber)&&await this.saveSnapshot()}};exports.AbstractSolanaSnapshotService=n;

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

@@ -0,0 +1,21 @@
+import { AbstractSolanaEventService } from './AbstractSolanaEventService';
+import { SolanaBlockchainEventEmitter } from './SolanaBlockchainEventEmitter';
+export interface SolanaSnapshot<SnapshotPayloadType> {
+    readonly latestBlockNumber: number;
+    readonly payload: SnapshotPayloadType;
+}
+export declare abstract class AbstractSolanaSnapshotService<EventType, SnapshotPayloadType, SerializedSnapshotType> extends AbstractSolanaEventService<EventType> {
+    private savedLatestSlot;
+    protected constructor(solanaBlockchainEventEmitter: SolanaBlockchainEventEmitter, eventName: string);
+    init(): Promise<void>;
+    retrieveEventsFromLatestBlock(): Promise<void>;
+    private loadSnapshot;
+    protected saveSnapshot(): Promise<unknown>;
+    protected afterEventsAccepted(eventsCount: number): Promise<void>;
+    protected abstract getSnapshotPayload(): SnapshotPayloadType;
+    protected abstract populateSnapshot(snapshot: SolanaSnapshot<SnapshotPayloadType>): void;
+    protected abstract serializeSnapshot(snapshot: SolanaSnapshot<SnapshotPayloadType>): SerializedSnapshotType;
+    protected abstract deserializeSnapshot(serializedSnapshot: SerializedSnapshotType): SolanaSnapshot<SnapshotPayloadType>;
+    protected abstract fetchSnapshot(): Promise<SerializedSnapshotType>;
+    protected abstract persistSnapshot(serializedSnapshot: SerializedSnapshotType): Promise<unknown>;
+}

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

@@ -0,0 +1,30 @@
+import { saveDepths as e } from "../../../constants/save-depths.mjs";
+import { AbstractSolanaEventService as t } from "./AbstractSolanaEventService.mjs";
+//#region libs/shared/common/src/data-structures/event-service/solana/AbstractSolanaSnapshotService.ts
+var n = class extends t {
+	savedLatestSlot = 0;
+	constructor(e, t) {
+		super(e, t);
+	}
+	async init() {
+		await this.loadSnapshot();
+	}
+	async retrieveEventsFromLatestBlock() {
+		await this.solanaBlockchainEventEmitter.retrieveEvents(this.latestBlockNumber);
+	}
+	async loadSnapshot() {
+		let e = await this.fetchSnapshot(), t = this.deserializeSnapshot(e);
+		this.populateSnapshot(t), this.solanaBlockchainEventEmitter.syncFromAtMost(t.latestBlockNumber), this.savedLatestSlot = t.latestBlockNumber;
+	}
+	saveSnapshot() {
+		return this.savedLatestSlot = this.latestBlockNumber, this.persistSnapshot(this.serializeSnapshot({
+			latestBlockNumber: this.latestBlockNumber,
+			payload: this.getSnapshotPayload()
+		}));
+	}
+	async afterEventsAccepted(t) {
+		(t > 0 || this.savedLatestSlot + e[this.chainId] < this.latestBlockNumber) && await this.saveSnapshot();
+	}
+};
+//#endregion
+export { n as AbstractSolanaSnapshotService };

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

@@ -0,0 +1 @@
+const e=require(`../../../types/events.types.cjs`),t=require(`../helpers/ClientEventHelper.cjs`),n=require(`./SolanaBlockchainEventEmitter.cjs`);var r=class extends n.SolanaBlockchainEventEmitter{clientEventHelper;constructor(n,r,i,a,o,s,c){super(n,r,i,a,!1,o,s),c&&this.setIdl(c),this.clientEventHelper=new t.ClientEventHelper(n,e.EventCategory.MainContractEvents)}clear(){this.clientEventHelper.clear()}startUpdateListener(){this.clientEventHelper.startUpdateListener(async e=>{await this.eventsFetchingMutex.runExclusive(async()=>{await this.processEvents(e)})},this.latestBlockNumber+1,e=>this.advanceLatestBlockNumber(e))}};exports.ClientSolanaBlockchainEventEmitter=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 { Mutex } from 'async-mutex';
+import { ClientEventHelper } from '../helpers/ClientEventHelper';
+export declare class ClientSolanaBlockchainEventEmitter extends SolanaBlockchainEventEmitter {
+    clientEventHelper: ClientEventHelper;
+    constructor(chainId: number, connection: Connection, programId: PublicKey, initialSlot: number, eventsFetchingMutex: Mutex, maxPageSize?: number, idl?: Idl);
+    protected clear(): void;
+    protected startUpdateListener(): void;
+}

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

@@ -0,0 +1,22 @@
+import { EventCategory as e } from "../../../types/events.types.mjs";
+import { ClientEventHelper as t } from "../helpers/ClientEventHelper.mjs";
+import { SolanaBlockchainEventEmitter as n } from "./SolanaBlockchainEventEmitter.mjs";
+//#region libs/shared/common/src/data-structures/event-service/solana/ClientSolanaBlockchainEventEmitter.ts
+var r = class extends n {
+	clientEventHelper;
+	constructor(n, r, i, a, o, s, c) {
+		super(n, r, i, a, !1, o, s), c && this.setIdl(c), this.clientEventHelper = new t(n, e.MainContractEvents);
+	}
+	clear() {
+		this.clientEventHelper.clear();
+	}
+	startUpdateListener() {
+		this.clientEventHelper.startUpdateListener(async (e) => {
+			await this.eventsFetchingMutex.runExclusive(async () => {
+				await this.processEvents(e);
+			});
+		}, this.latestBlockNumber + 1, (e) => this.advanceLatestBlockNumber(e));
+	}
+};
+//#endregion
+export { r as ClientSolanaBlockchainEventEmitter };

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.d.ts

@@ -0,0 +1,6 @@
+import { SolanaBlockchainEventEmitter } from './SolanaBlockchainEventEmitter';
+export declare class PollingSolanaBlockchainEventEmitter extends SolanaBlockchainEventEmitter {
+    private pollingEventHelper;
+    protected clear(): void;
+    protected startUpdateListener(): void;
+}

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),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){let t=(await Promise.all([...this.eventProcessors].map(t=>t(e)))).reduce((e,t)=>e+t,0);this.onEventsProcessed?.(t)}};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 { Mutex } from 'async-mutex';
+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: Mutex;
+    constructor(chainId: number, connection: Connection, programId: PublicKey, initialSlot: number, isServer: boolean, eventsFetchingMutex: Mutex, 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[]): Promise<void>;
+    protected abstract clear(): void;
+    protected abstract startUpdateListener(): void;
+}

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

@@ -0,0 +1,178 @@
+import { safeJsonStringify as e } from "../../../functions/utils/serialize.utils.mjs";
+import { Logger as t } from "../../../error-handling/logger.mjs";
+import { getSequence as n, resolveSync as r } from "../../../functions/utils/resolve-sync.utils.mjs";
+import { BlockchainEvent as i } from "../../BlockchainEvent/BlockchainEvent.mjs";
+import { BorshCoder as a, EventParser as o, utils as s } from "@coral-xyz/anchor";
+//#region libs/shared/common/src/data-structures/event-service/solana/SolanaBlockchainEventEmitter.ts
+var c = 1e3, l = 20, u = class {
+	_chainId;
+	connection;
+	programId;
+	_latestSlot;
+	_initialSlot;
+	onEventsProcessed;
+	eventProcessors = /* @__PURE__ */ 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 a(e);
+			this.anchorCoder = t, this.anchorParser = new o(this.programId, t);
+		} catch (e) {
+			t.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 = /* @__PURE__ */ 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) => i.fromSolanaEvent(e));
+	}
+	async getLastBlockNumberForEventRequest() {
+		let e = await this.connection.getSlot();
+		return this.isServer ? Math.max(this.latestBlockNumber, e - 32 + 1) : e;
+	}
+	async retrieveEvents(e, a = !1, o = !1) {
+		let s = e;
+		return this.requireReady(), await this.eventsFetchingMutex.runExclusive(async () => {
+			try {
+				if (this.inProgress && !a) return !1;
+				this.inProgress = !0;
+				let e = await this.getLastBlockNumberForEventRequest();
+				if (e < s) return this.inProgress = !1, !1;
+				let t = n(s, e, this.maxPageSize), c = [];
+				await r(t.map(({ from: e, to: t }) => async () => {
+					let n = await this.getProgramEvents(e, t, o);
+					c.push(...n);
+				})), c.sort((e, t) => e.slot - t.slot);
+				let l = c.map((e) => i.fromSolanaEvent(e));
+				return await this.processEvents(l), this._latestSlot = e, this.inProgress = !1, !0;
+			} catch (e) {
+				return t.error("retrieveEvents error:", e), this.inProgress = !1, !1;
+			}
+		});
+	}
+	async getProgramEvents(e, n, r = !1) {
+		let i = [], a = r ? c : l;
+		try {
+			let r = await this.connection.getSignaturesForAddress(this.programId, {
+				limit: a,
+				before: void 0
+			}), o = r.length;
+			for (; o >= a && r[r.length - 1].slot >= e;) {
+				let e = r[r.length - 1], t = await this.connection.getSignaturesForAddress(this.programId, {
+					limit: a,
+					before: e.signature
+				});
+				if (t.length === 0) break;
+				r.push(...t), o = t.length;
+			}
+			let s = 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.error(`Failed to get transaction ${e.signature}:`, n), [];
+				}
+			}), c = await Promise.all(s);
+			i.push(...c.flat());
+		} catch (e) {
+			t.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 = /* @__PURE__ */ new Set();
+		return s.filter((t) => {
+			let n = `${t.signature}:${t.eventName}:${e(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.error("Anchor EventParser failed; falling back to generic parsing:", e), [];
+		}
+	}
+	parseCpiForEvents(e, n, r, i) {
+		if (!e || !this.anchorCoder) return [];
+		let a = e.meta?.innerInstructions ?? [];
+		if (a.length === 0) return [];
+		try {
+			return a.flatMap((e) => e.instructions ?? []).map((e) => {
+				try {
+					if (!e?.data) return null;
+					let t = s.bytes.bs58.decode(e.data);
+					if (t.length <= 8) return null;
+					let a = s.bytes.base64.encode(t.subarray(8)), o = this.anchorCoder?.events.decode(a);
+					return o ? {
+						signature: n,
+						slot: r,
+						blockTime: i || 0,
+						programId: this.programId,
+						data: o.data,
+						eventName: o.name
+					} : null;
+				} catch {
+					return null;
+				}
+			}).filter((e) => e !== null);
+		} catch (e) {
+			return t.error("Failed to parse emit_cpi events:", e), [];
+		}
+	}
+	async processEvents(e) {
+		let t = (await Promise.all([...this.eventProcessors].map((t) => t(e)))).reduce((e, t) => e + t, 0);
+		this.onEventsProcessed?.(t);
+	}
+};
+//#endregion
+export { u as SolanaBlockchainEventEmitter };

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/http/BasicHttpClient.mjs

@@ -0,0 +1,25 @@
+import e from "axios";
+//#region libs/shared/common/src/data-structures/http/BasicHttpClient.ts
+var t = class {
+	axiosInstance;
+	constructor() {
+		this.axiosInstance = e.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;
+	}
+};
+//#endregion
+export { t as BasicHttpClient };

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

@@ -0,0 +1 @@
+var e=new(require(`./BasicHttpClient.cjs`)).BasicHttpClient,t={setHttpClient:t=>{e=t},get:(t,n)=>e.get(t,n),post:(t,n,r)=>e.post(t,n,r),put:(t,n,r)=>e.put(t,n,r),patch:(t,n,r)=>e.patch(t,n,r),delete:(t,n)=>e.delete(t,n)};exports.httpClient=t;

package/common/src/data-structures/http/HttpClient.d.ts

@@ -0,0 +1,10 @@
+import { HttpClient } from '../../types/http.types';
+declare const httpClient: {
+    setHttpClient: (client: HttpClient) => void;
+    get: <T = any>(url: string, config?: any) => Promise<T>;
+    post: <T = any>(url: string, data?: any, config?: any) => Promise<T>;
+    put: <T = any>(url: string, data?: any, config?: any) => Promise<T>;
+    patch: <T = any>(url: string, data?: any, config?: any) => Promise<T>;
+    delete: <T = any>(url: string, config?: any) => Promise<T>;
+};
+export { httpClient };

package/common/src/data-structures/http/HttpClient.mjs

@@ -0,0 +1,14 @@
+import { BasicHttpClient as e } from "./BasicHttpClient.mjs";
+//#region libs/shared/common/src/data-structures/http/HttpClient.ts
+var t = new e(), n = {
+	setHttpClient: (e) => {
+		t = e;
+	},
+	get: (e, n) => t.get(e, n),
+	post: (e, n, r) => t.post(e, n, r),
+	put: (e, n, r) => t.put(e, n, r),
+	patch: (e, n, r) => t.patch(e, n, r),
+	delete: (e, n) => t.delete(e, n)
+};
+//#endregion
+export { n as httpClient };

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

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

package/common/src/data-structures/http/index.mjs

@@ -0,0 +1,2 @@
+import "./BasicHttpClient.mjs";
+import "./HttpClient.mjs";

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

@@ -0,0 +1,20 @@
+export * from './ValueCache';
+export * from './crypto-keys';
+export * from './Hinkal';
+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';

package/common/src/data-structures/merkle-tree/MerkleTree.cjs

@@ -0,0 +1 @@
+const e=require(`../../constants/protocol.constants.cjs`),t=require(`../../error-handling/logError.cjs`),n=require(`./MerkleTreeIncompleteError.cjs`);var r=class r{tree;count;index;reverseTree;static createWithData(e,t,n,i,a,o,s){return new r(a,o,s,e,t,n,i)}static create(t,n,i=e.MERKLE_LEVELS){return new r(t,i,n)}createReverseTree(){let e=new Map;for(let t=this.getStartIndex();t<this.getStartIndex()+this.count;t+=1n){let n=this.tree.get(t);n!==void 0&&e.set(n,t)}return e}constructor(e,t,n,r,i,a,o){this.hashFunction=e,this.levels=t,this.defaultNodeValue=n,this.tree=r??new Map,this.count=o??0n,this.index=a??2n**(t-1n),i?this.reverseTree=i:this.reverseTree=this.createReverseTree()}getStartIndex(){return 2n**(this.levels-1n)}logarithm2(e){let t=0n;for(;2n**t<e;)t+=1n;return t}bigIntMax(e,t){return e>t?e:t}forceInsert(e,t){if(t<this.getStartIndex())throw RangeError();this.tree.set(t,e),this.reverseTree.set(e,t);let n=this.index-this.getStartIndex(),r=this.logarithm2(n),i=t;for(let e=1n;e<=r;e+=1n){i/=2n;let e=this.hashFunction(this.tree.get(i*2n)||this.defaultNodeValue,this.tree.get(i*2n+1n)||this.defaultNodeValue);this.tree.set(i,e)}}insert(e,n){let r=!1;this.tree.has(n)&&(r=!0,t.logError(`Editing commitment index: ${n} `)),r||(this.count+=1n),this.index=this.bigIntMax(this.index,n+1n),this.forceInsert(e,n)}remove(e){this.forceInsert(this.defaultNodeValue,e)}completenessCheck(){if(this.count!==this.index-this.getStartIndex())throw new n.MerkleTreeIncompleteError}getRootHash(){this.completenessCheck();for(let e=1n;e<2n**this.levels;e*=2n)if(this.tree.get(e))return this.tree.get(e);return this.defaultNodeValue}getMerkleData(){return this.completenessCheck(),new Map(this.tree)}getValue(e){return this.tree.get(e)}getSiblingIndex(e){return e===1n?1n:e%2n==1n?e-1n:e+1n}getSiblingHashesForVerification(e){this.completenessCheck();let t=this.reverseTree.get(e);if(t===void 0)return Array(25).fill(0n);let n=[];for(;t!==0n;)n.push(this.tree.get(this.getSiblingIndex(t))||this.defaultNodeValue),t/=2n;return n.slice(0,25)}getSiblingSides(e){this.completenessCheck();let t=this.reverseTree.get(e);if(t===void 0)return Array(25).fill(0n);let n=[];for(;t!==0n;){let e=t%2n==0n?0n:1n;n.push(e),t/=2n}return n.slice(0,25)}toJSON(){let{tree:e,reverseTree:t,count:n,index:r}=this;return{tree:Object.fromEntries(e),reverseTree:Object.fromEntries(t),count:n.toString(),index:r.toString()}}toJSONLite(){let{tree:e,count:t,index:n}=this;return{tree:Object.fromEntries(e),count:t.toString(),index:n.toString()}}clone(){return r.createWithData(new Map(this.tree),new Map(this.reverseTree),this.index,this.count,this.hashFunction,this.levels,this.defaultNodeValue)}getIndex(){return this.index}};exports.MerkleTree=r;

package/common/src/data-structures/merkle-tree/MerkleTree.d.ts

@@ -0,0 +1,82 @@
+export type MerkleTreeJson = {
+    tree: Record<string, string>;
+    reverseTree?: Record<string, string>;
+    count: string;
+    index: string;
+};
+/**
+ * Merkle tree implementation that allows the user to insert in specific places in the tree
+ *
+ */
+export declare class MerkleTree<T> {
+    private hashFunction;
+    private levels;
+    private defaultNodeValue;
+    /**
+     * the map where the items are stored
+     */
+    private readonly tree;
+    /**
+     * amount of elements inserted inside the bottom row of the tree
+     */
+    private count;
+    /**
+     * the maximum index inserted into the tree
+     * used together with count to make sure that the merkle tree is complete.
+     * meaning that there aren't any missing elements between getStartIndex() and index
+     */
+    private index;
+    private reverseTree;
+    static createWithData<T>(tree: Map<bigint, T>, reverseTree: Map<T, bigint> | undefined, index: bigint, count: bigint, hashFunction: (a: T, b: T) => T, levels: bigint, defaultNodeValue: T): MerkleTree<T>;
+    /**
+     * @param hashFunction the hashFunction used to fill the upper layers of the merkle tree
+     * @param levels the amount of layers in the merkle tree
+     * @param defaultNodeValue the default value of an empty node in the merkle tree
+     */
+    static create<T>(hashFunction: (a: T, b: T) => T, defaultNodeValue: T, levels?: bigint): MerkleTree<T>;
+    private createReverseTree;
+    private constructor();
+    /**
+     * get starting nodeIndex from which inserts are allowed
+     */
+    getStartIndex(): bigint;
+    /**
+     * implementation of logarithm2 function from merkle contract
+     */
+    logarithm2(a: bigint): bigint;
+    bigIntMax(a: bigint, b: bigint): bigint;
+    private forceInsert;
+    /**
+     * insert value into the merkle tree
+     * @param value the value to insert
+     * @param nodeIndex the index to insert the value, you can get starting index from getStartIndex()
+     * @throws will throw RangeError if nodeIndex is less than getStartIndex()
+     */
+    insert(value: T, nodeIndex: bigint): void;
+    remove(nodeIndex: bigint): void;
+    private completenessCheck;
+    /**
+     * get root hash of the merkle tree
+     * @returns the hash, if the merkle tree is empty, will return
+     * @throws will throw MerkleTreeIncompleteError if there are missing elements in the tree
+     */
+    getRootHash(): T | undefined;
+    getMerkleData(): Map<bigint, T>;
+    getValue(index: bigint): T | undefined;
+    getSiblingIndex(index: bigint): bigint;
+    /**
+     * get sibling hashes needed by main.circom
+     * @throws will throw MerkleTreeIncompleteError if there are missing elements in the tree
+     */
+    getSiblingHashesForVerification(item: T): bigint[] | T[];
+    /**
+     * get item's sibling hashes side
+     * @returns sibling's indexes
+     * @throws will throw MerkleTreeIncompleteError if there are missing elements in the tree
+     */
+    getSiblingSides(item: T): bigint[];
+    toJSON(): MerkleTreeJson;
+    toJSONLite(): MerkleTreeJson;
+    clone(): MerkleTree<T>;
+    getIndex(): bigint;
+}