@arcium-hq/reader 0.9.1 → 0.9.3

package/build/types/accGetters.d.ts

@@ -0,0 +1,87 @@
+import * as anchor from '@coral-xyz/anchor';
+import { ArciumIdlType } from '@arcium-hq/client';
+import { ClusterAccount, Connection, MXEAccount, PublicKey, ArxNodeAccount, ComputationAccount, ComputationDefinitionAccount, RecoveryClusterAccount, MxeRecoveryAccount } from './types.js';
+/**
+ * Return all MXE account addresses.
+ * @param conn - Solana connection object.
+ * @returns Array of MXE account public keys.
+ */
+export declare function getMXEAccAddresses(conn: Connection): Promise<PublicKey[]>;
+/**
+ * Return all Cluster account addresses.
+ * @param conn - Solana connection object.
+ * @returns Array of Cluster account public keys.
+ */
+export declare function getClusterAccAddresses(conn: Connection): Promise<PublicKey[]>;
+/**
+ * Return all ArxNode account addresses.
+ * @param conn - Solana connection object.
+ * @returns Array of ArxNode account public keys.
+ */
+export declare function getArxNodeAccAddresses(conn: Connection): Promise<PublicKey[]>;
+/**
+ * Fetch and parse an MXE account.
+ *
+ * @param arciumProgram - Anchor program instance.
+ * @param address - Public key of the MXE account.
+ * @param commitment - RPC commitment level.
+ * @returns Parsed MXE account data.
+ *
+ * @example
+ * import { getArciumProgram, getMXEAccAddress, getMXEAccInfo } from '@arcium-hq/reader';
+ *
+ * const program = getArciumProgram(provider);
+ * const mxeAddress = getMXEAccAddress(mxeProgramId);
+ * const mxeAccount = await getMXEAccInfo(program, mxeAddress);
+ * console.log('MXE authority:', mxeAccount.authority?.toBase58());
+ */
+export declare function getMXEAccInfo(arciumProgram: anchor.Program<ArciumIdlType>, address: PublicKey, commitment?: anchor.web3.Commitment): Promise<MXEAccount>;
+/**
+ * Fetch and parse a Cluster account.
+ * @param arciumProgram - Anchor program instance.
+ * @param address - Public key of the Cluster account.
+ * @param commitment - RPC commitment level.
+ * @returns Parsed ClusterAccount data.
+ */
+export declare function getClusterAccInfo(arciumProgram: anchor.Program<ArciumIdlType>, address: PublicKey, commitment?: anchor.web3.Commitment): Promise<ClusterAccount>;
+/**
+ * Fetch and parse a recovery cluster account.
+ * @param arciumProgram - Anchor program instance.
+ * @param address - Public key of the recovery cluster account.
+ * @param commitment - RPC commitment level.
+ * @returns Parsed RecoveryClusterAccount data.
+ */
+export declare function getRecoveryClusterAccInfo(arciumProgram: anchor.Program<ArciumIdlType>, address: PublicKey, commitment?: anchor.web3.Commitment): Promise<RecoveryClusterAccount>;
+/**
+ * Fetch and parse an MxeRecovery account.
+ * @param arciumProgram - Anchor program instance.
+ * @param address - Public key of the MxeRecovery account.
+ * @param commitment - RPC commitment level.
+ * @returns Parsed MxeRecoveryAccount data.
+ */
+export declare function getMxeRecoveryAccInfo(arciumProgram: anchor.Program<ArciumIdlType>, address: PublicKey, commitment?: anchor.web3.Commitment): Promise<MxeRecoveryAccount>;
+/**
+ * Fetch and parse an ArxNode account.
+ * @param arciumProgram - Anchor program instance.
+ * @param address - Public key of the ArxNode account.
+ * @param commitment - RPC commitment level.
+ * @returns Parsed ArxNodeAccount data.
+ */
+export declare function getArxNodeAccInfo(arciumProgram: anchor.Program<ArciumIdlType>, address: PublicKey, commitment?: anchor.web3.Commitment): Promise<ArxNodeAccount>;
+/**
+ * Fetch and parse a ComputationDefinition account.
+ * @param arciumProgram - Anchor program instance.
+ * @param address - Public key of the ComputationDefinition account.
+ * @param commitment - RPC commitment level.
+ * @returns Parsed ComputationDefinitionAccount data.
+ */
+export declare function getCompDefAccInfo(arciumProgram: anchor.Program<ArciumIdlType>, address: PublicKey, commitment?: anchor.web3.Commitment): Promise<ComputationDefinitionAccount>;
+/**
+ * Fetch and parse a Computation account.
+ * @param arciumProgram - Anchor program instance.
+ * @param address - Public key of the Computation account.
+ * @param commitment - RPC commitment level.
+ * @returns Parsed ComputationAccount data.
+ */
+export declare function getComputationAccInfo(arciumProgram: anchor.Program<ArciumIdlType>, address: PublicKey, commitment?: anchor.web3.Commitment): Promise<ComputationAccount>;
+//# sourceMappingURL=accGetters.d.ts.map

package/build/types/accGetters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accGetters.d.ts","sourceRoot":"","sources":["../../src/accGetters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EACH,cAAc,EACd,UAAU,EACV,UAAU,EACV,SAAS,EACT,cAAc,EACd,kBAAkB,EAClB,4BAA4B,EAC5B,sBAAsB,EACtB,kBAAkB,EACrB,MAAM,YAAY,CAAC;AAQpB;;;;GAIG;AACH,wBAAsB,kBAAkB,CACpC,IAAI,EAAE,UAAU,GACjB,OAAO,CAAC,SAAS,EAAE,CAAC,CAEtB;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CACxC,IAAI,EAAE,UAAU,GACjB,OAAO,CAAC,SAAS,EAAE,CAAC,CAEtB;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CACxC,IAAI,EAAE,UAAU,GACjB,OAAO,CAAC,SAAS,EAAE,CAAC,CAEtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CAC/B,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAC5C,OAAO,EAAE,SAAS,EAClB,UAAU,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,GACpC,OAAO,CAAC,UAAU,CAAC,CAErB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACnC,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAC5C,OAAO,EAAE,SAAS,EAClB,UAAU,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,GACpC,OAAO,CAAC,cAAc,CAAC,CAEzB;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC3C,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAC5C,OAAO,EAAE,SAAS,EAClB,UAAU,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAEjC;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACvC,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAC5C,OAAO,EAAE,SAAS,EAClB,UAAU,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,GACpC,OAAO,CAAC,kBAAkB,CAAC,CAE7B;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACnC,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAC5C,OAAO,EAAE,SAAS,EAClB,UAAU,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,GACpC,OAAO,CAAC,cAAc,CAAC,CAEzB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACnC,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAC5C,OAAO,EAAE,SAAS,EAClB,UAAU,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,GACpC,OAAO,CAAC,4BAA4B,CAAC,CAKvC;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACvC,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAC5C,OAAO,EAAE,SAAS,EAClB,UAAU,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,GACpC,OAAO,CAAC,kBAAkB,CAAC,CAE7B"}

package/build/types/computationGetters.d.ts

@@ -0,0 +1,41 @@
+import * as anchor from '@coral-xyz/anchor';
+import { ArciumEventName, ArciumEventData, Connection, PublicKey } from './types.js';
+/**
+ * Subscribe to computation events for an MXE program.
+ *
+ * Listens for queue, execute, and finalize events via Solana log subscriptions.
+ *
+ * @param conn - Solana connection object.
+ * @param mxeProgramId - Public key of the MXE program to monitor.
+ * @param callback - Handler called for each event with event data and event name.
+ * @returns Subscription ID for cleanup with {@link unsubscribeComputations}.
+ *
+ * @example
+ * const subId = await subscribeComputations(
+ *   connection,
+ *   mxeProgramId,
+ *   (event, name) => {
+ *     if (name === 'FinalizeComputationEvent') {
+ *       console.log('Computation finalized:', event.computationOffset.toString());
+ *     }
+ *   },
+ * );
+ *
+ * // When done, clean up the subscription
+ * await unsubscribeComputations(connection, subId);
+ */
+export declare function subscribeComputations(conn: Connection, mxeProgramId: PublicKey, callback: (event: ArciumEventData, name: ArciumEventName) => void): Promise<number>;
+/**
+ * Unsubscribe from computation events.
+ * @param conn - Solana connection object.
+ * @param subscriptionId - Subscription ID returned by {@link subscribeComputations}.
+ */
+export declare function unsubscribeComputations(conn: Connection, subscriptionId: number): Promise<void>;
+/**
+ * Get the computation offset from a transaction.
+ * @param tx - Transaction to extract the computation offset from.
+ * @returns Computation offset if found, otherwise undefined.
+ * @throws Error if multiple computation offsets are found in the transaction.
+ */
+export declare function getComputationOffset(tx: anchor.web3.VersionedTransactionResponse): anchor.BN | undefined;
+//# sourceMappingURL=computationGetters.d.ts.map

package/build/types/computationGetters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computationGetters.d.ts","sourceRoot":"","sources":["../../src/computationGetters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EACH,eAAe,EACf,eAAe,EACf,UAAU,EACV,SAAS,EACZ,MAAM,YAAY,CAAC;AAGpB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,qBAAqB,CACvC,IAAI,EAAE,UAAU,EAChB,YAAY,EAAE,SAAS,EACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,KAAK,IAAI,GAClE,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CACzC,IAAI,EAAE,UAAU,EAChB,cAAc,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,4BAA4B,GAC7C,MAAM,CAAC,EAAE,GAAG,SAAS,CAkBvB"}

package/build/types/constants.d.ts

@@ -0,0 +1,60 @@
+import { ArciumIdlType } from '@arcium-hq/client';
+import * as anchor from '@coral-xyz/anchor';
+import { ArciumEventName, CallbackComputationIx, PublicKey, QueueComputationIx } from './types.js';
+type ArciumArxNodeAccount = ArciumIdlType['accounts']['0'];
+type ArciumClusterAccount = ArciumIdlType['accounts']['2'];
+type ArciumMXEAccount = ArciumIdlType['accounts']['10'];
+/**
+ * Prefix for program data logs in Solana transaction logs.
+ * @constant {string}
+ */
+export declare const PROGRAM_DATA_PREFIX = "Program data: ";
+/**
+ * Prefix for program log messages in Solana transaction logs.
+ * @constant {string}
+ */
+export declare const PROGRAM_LOG_PREFIX = "Program log: ";
+/**
+ * Valid Arcium event names for computation lifecycle tracking.
+ * @constant {ArciumEventName[]}
+ */
+export declare const ARCIUM_EVENT_NAMES: ArciumEventName[];
+/**
+ * Discriminator for the ArxNode account type. Used to filter and identify ArxNode accounts on-chain.
+ */
+export declare const ARX_NODE_ACC_DISCRIMINATOR: ArciumArxNodeAccount['discriminator'];
+/**
+ * Discriminator for the Cluster account type. Used to filter and identify Cluster accounts on-chain.
+ */
+export declare const CLUSTER_ACC_DISCRIMINATOR: ArciumClusterAccount['discriminator'];
+/**
+ * Discriminator for the MXE account type. Used to filter and identify MXE accounts on-chain.
+ */
+export declare const MXE_ACC_DISCRIMINATOR: ArciumMXEAccount['discriminator'];
+/**
+ * Discriminator for the queueComputation instruction. Used to identify the queueComputation instruction in transaction data.
+ */
+export declare const QUEUE_COMPUTATION_IX_DISCRIMINATOR: QueueComputationIx['discriminator'];
+/**
+ * Discriminator for the callbackComputation instruction. Used to identify the callbackComputation instruction in transaction data.
+ */
+export declare const CALLBACK_COMPUTATION_IX_DISCRIMINATOR: CallbackComputationIx['discriminator'];
+/**
+ * The public key of the deployed Arcium program on Solana.
+ */
+export declare const ARCIUM_PROGRAM_ID: PublicKey;
+/**
+ * Anchor coder for encoding and decoding Arcium program instructions.
+ */
+export declare const ARCIUM_IX_CODER: anchor.BorshInstructionCoder;
+/**
+ * Anchor event parser for parsing Arcium program events from transaction logs.
+ */
+export declare const ARCIUM_EVENT_CODER: anchor.EventParser;
+/**
+ * BorshCoder instance for decoding Arcium events.
+ * Used directly instead of accessing EventParser's private coder property.
+ */
+export declare const ARCIUM_BORSH_CODER: anchor.BorshCoder<string, string>;
+export {};
+//# sourceMappingURL=constants.d.ts.map

package/build/types/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA2B,MAAM,mBAAmB,CAAC;AAC3E,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EACH,eAAe,EAAE,qBAAqB,EAAE,SAAS,EAAE,kBAAkB,EACxE,MAAM,YAAY,CAAC;AAEpB,KAAK,oBAAoB,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC;AAC3D,KAAK,oBAAoB,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC;AAC3D,KAAK,gBAAgB,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,eAAe,EAK/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,oBAAoB,CAAC,eAAe,CAAwC,CAAC;AAEtH;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,oBAAoB,CAAC,eAAe,CAA0C,CAAC;AAEvH;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,gBAAgB,CAAC,eAAe,CAAyC,CAAC;AAE9G;;GAEG;AACH,eAAO,MAAM,kCAAkC,EAAE,kBAAkB,CAAC,eAAe,CAAwC,CAAC;AAE5H;;GAEG;AACH,eAAO,MAAM,qCAAqC,EAAE,qBAAqB,CAAC,eAAe,CAAuC,CAAC;AAEjI;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAkD,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,eAAe,8BAA2E,CAAC;AAExG;;GAEG;AACH,eAAO,MAAM,kBAAkB,oBAA2G,CAAC;AAE3I;;;GAGG;AACH,eAAO,MAAM,kBAAkB,mCAAgE,CAAC"}

package/build/types/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Read-only SDK for querying Arcium network state on Solana.
+ *
+ * Key exports:
+ * - {@link getMXEAccInfo}, {@link getClusterAccInfo} - Account getters
+ * - {@link subscribeComputations} - Event monitoring
+ * - Types for all Arcium accounts
+ *
+ * @packageDocumentation
+ */
+export { getClusterAccAddress, getArxNodeAccAddress, getMXEAccAddress, getArciumProgram, getComputationAccAddress, getMempoolAccAddress, getClockAccAddress, getFeePoolAccAddress, getExecutingPoolAccAddress, getCompDefAccAddress, getComputationsInMempool, getMempoolPriorityFeeStats, } from '@arcium-hq/client';
+export * from './accGetters.js';
+export * from './computationGetters.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/build/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACH,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,GAC7B,MAAM,mBAAmB,CAAC;AAE3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC"}

package/build/types/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Shared type aliases and utility types for the Arcium program.
+ * Many types are derived from the Anchor-generated IDL and are used throughout the reader package.
+ */
+import { ArciumIdlType } from '@arcium-hq/client';
+import * as anchor from '@coral-xyz/anchor';
+/**
+ * Solana PublicKey type alias for convenience.
+ */
+export type PublicKey = anchor.web3.PublicKey;
+/**
+ * Solana Connection type alias for convenience.
+ */
+export type Connection = anchor.web3.Connection;
+/**
+ * Anchor Program type alias with generic IDL support.
+ */
+export type Program<T extends anchor.Idl> = anchor.Program<T>;
+/**
+ * Arcium IDL types derived from the Arcium program interface.
+ */
+export type ArciumTypes = anchor.IdlTypes<ArciumIdlType>;
+/**
+ * All events emitted by the Arcium program, keyed by event name.
+ */
+export type ArciumEvent = anchor.IdlEvents<ArciumIdlType>;
+/**
+ * Capitalized event names, matching the format as emitted by the program.
+ */
+export type ArciumEventName = Capitalize<keyof ArciumEvent>;
+/**
+ * Data structure for any Arcium event, as parsed from logs.
+ */
+export type ArciumEventData = ArciumEvent[keyof ArciumEvent];
+/**
+ * MXE (Multi-party eXecution Environment) account data structure.
+ */
+export type MXEAccount = ArciumTypes['mxeAccount'];
+/**
+ * Cluster account data structure containing node information.
+ */
+export type ClusterAccount = ArciumTypes['cluster'];
+/**
+ * Recovery cluster account data structure containing recovery peers information.
+ */
+export type RecoveryClusterAccount = ArciumTypes['recoveryClusterAccount'];
+/**
+ * MXE recovery account data structure tracking key recovery session state.
+ */
+export type MxeRecoveryAccount = ArciumTypes['mxeRecoveryAccount'];
+/**
+ * ArxNode account data structure for individual computation nodes.
+ */
+export type ArxNodeAccount = ArciumTypes['arxNode'];
+/**
+ * Computation account data structure tracking computation state.
+ */
+export type ComputationAccount = ArciumTypes['computationAccount'];
+/**
+ * Reference to a computation in a mempool or executing pool.
+ */
+export type ComputationReference = ArciumTypes['computationReference'];
+/**
+ * Computation definition account containing circuit configuration.
+ */
+export type ComputationDefinitionAccount = ArciumTypes['computationDefinitionAccount'];
+/**
+ * Queue computation instruction type from the Arcium IDL.
+ */
+export type QueueComputationIx = ArciumIdlType['instructions']['38'];
+/**
+ * Callback computation instruction type from the Arcium IDL.
+ */
+export type CallbackComputationIx = ArciumIdlType['instructions']['4'];
+/**
+ * Valid instruction names from the Arcium IDL.
+ */
+export type ArciumInstructionName = ArciumIdlType['instructions'][number]['name'];
+/**
+ * Status values for a computation, as defined by the Arcium protocol.
+ */
+export type ComputationStatus = 'queued' | 'executing' | 'executed' | 'finalized' | 'failed';
+//# sourceMappingURL=types.d.ts.map

package/build/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,WAAW,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,MAAM,WAAW,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,WAAW,CAAC,wBAAwB,CAAC,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC,oBAAoB,CAAC,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC,oBAAoB,CAAC,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,sBAAsB,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,WAAW,CAAC,8BAA8B,CAAC,CAAC;AAEvF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAElF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcium-hq/reader",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "description": "Reader SDK for fetching onchain data for Arcium network programs",
   "author": "Arcium",
   "license": "GPL-3.0-only",
@@ -14,20 +14,21 @@
     "compile": "yarn bundle:cjs && yarn bundle:esm && yarn bundle:dts",
     "bundle:cjs": "node ../../node_modules/rollup/dist/bin/rollup --config config/rollup.config.cjs.js",
     "bundle:esm": "node ../../node_modules/rollup/dist/bin/rollup --config config/rollup.config.esm.js",
-    "bundle:dts": "node ../../node_modules/rollup/dist/bin/rollup --config config/rollup.config.dts.js",
+    "bundle:dts": "tsc --emitDeclarationOnly",
     "test-single": "mocha $1 --exit"
   },
   "type": "module",
   "module": "build/index.mjs",
-  "types": "build/index.d.ts",
+  "types": "build/types/index.d.ts",
   "files": [
     "build/index.cjs",
     "build/index.mjs",
-    "build/index.d.ts"
+    "build/types/",
+    "src/"
   ],
   "exports": [
     {
-      "types": "./build/index.d.ts",
+      "types": "./build/types/index.d.ts",
       "import": "./build/index.mjs",
       "require": "./build/index.cjs"
     }
@@ -49,7 +50,6 @@
     "eslint-plugin-import": "^2.31.0",
     "mocha": "^10.8.2",
     "rollup": "^4.24.0",
-    "rollup-plugin-dts": "^6.1.1",
     "ts-node": "^10.9.2",
     "typescript": "^5.6.3",
     "typescript-eslint": "^8.15.0"
@@ -58,7 +58,7 @@
     "@coral-xyz/anchor": "^0.32.1",
     "@noble/curves": "^1.9.5",
     "@noble/hashes": "^1.7.1",
-    "@arcium-hq/client": "0.9.1"
+    "@arcium-hq/client": "0.9.3"
   },
   "keywords": [
     "Cryptography",

package/src/accGetters.ts

@@ -0,0 +1,188 @@
+import * as anchor from '@coral-xyz/anchor';
+import { ArciumIdlType } from '@arcium-hq/client';
+import {
+    ClusterAccount,
+    Connection,
+    MXEAccount,
+    PublicKey,
+    ArxNodeAccount,
+    ComputationAccount,
+    ComputationDefinitionAccount,
+    RecoveryClusterAccount,
+    MxeRecoveryAccount,
+} from './types.js';
+import {
+    ARCIUM_PROGRAM_ID,
+    ARX_NODE_ACC_DISCRIMINATOR,
+    CLUSTER_ACC_DISCRIMINATOR,
+    MXE_ACC_DISCRIMINATOR,
+} from './constants.js';
+
+/**
+ * Return all MXE account addresses.
+ * @param conn - Solana connection object.
+ * @returns Array of MXE account public keys.
+ */
+export async function getMXEAccAddresses(
+    conn: Connection,
+): Promise<PublicKey[]> {
+    return getArciumAccPubkeys(conn, MXE_ACC_DISCRIMINATOR);
+}
+
+/**
+ * Return all Cluster account addresses.
+ * @param conn - Solana connection object.
+ * @returns Array of Cluster account public keys.
+ */
+export async function getClusterAccAddresses(
+    conn: Connection,
+): Promise<PublicKey[]> {
+    return getArciumAccPubkeys(conn, CLUSTER_ACC_DISCRIMINATOR);
+}
+
+/**
+ * Return all ArxNode account addresses.
+ * @param conn - Solana connection object.
+ * @returns Array of ArxNode account public keys.
+ */
+export async function getArxNodeAccAddresses(
+    conn: Connection,
+): Promise<PublicKey[]> {
+    return getArciumAccPubkeys(conn, ARX_NODE_ACC_DISCRIMINATOR);
+}
+
+/**
+ * Fetch and parse an MXE account.
+ *
+ * @param arciumProgram - Anchor program instance.
+ * @param address - Public key of the MXE account.
+ * @param commitment - RPC commitment level.
+ * @returns Parsed MXE account data.
+ *
+ * @example
+ * import { getArciumProgram, getMXEAccAddress, getMXEAccInfo } from '@arcium-hq/reader';
+ *
+ * const program = getArciumProgram(provider);
+ * const mxeAddress = getMXEAccAddress(mxeProgramId);
+ * const mxeAccount = await getMXEAccInfo(program, mxeAddress);
+ * console.log('MXE authority:', mxeAccount.authority?.toBase58());
+ */
+export async function getMXEAccInfo(
+    arciumProgram: anchor.Program<ArciumIdlType>,
+    address: PublicKey,
+    commitment?: anchor.web3.Commitment,
+): Promise<MXEAccount> {
+    return arciumProgram.account.mxeAccount.fetch(address, commitment);
+}
+
+/**
+ * Fetch and parse a Cluster account.
+ * @param arciumProgram - Anchor program instance.
+ * @param address - Public key of the Cluster account.
+ * @param commitment - RPC commitment level.
+ * @returns Parsed ClusterAccount data.
+ */
+export async function getClusterAccInfo(
+    arciumProgram: anchor.Program<ArciumIdlType>,
+    address: PublicKey,
+    commitment?: anchor.web3.Commitment,
+): Promise<ClusterAccount> {
+    return arciumProgram.account.cluster.fetch(address, commitment);
+}
+
+/**
+ * Fetch and parse a recovery cluster account.
+ * @param arciumProgram - Anchor program instance.
+ * @param address - Public key of the recovery cluster account.
+ * @param commitment - RPC commitment level.
+ * @returns Parsed RecoveryClusterAccount data.
+ */
+export async function getRecoveryClusterAccInfo(
+    arciumProgram: anchor.Program<ArciumIdlType>,
+    address: PublicKey,
+    commitment?: anchor.web3.Commitment,
+): Promise<RecoveryClusterAccount> {
+    return arciumProgram.account.recoveryClusterAccount.fetch(address, commitment);
+}
+
+/**
+ * Fetch and parse an MxeRecovery account.
+ * @param arciumProgram - Anchor program instance.
+ * @param address - Public key of the MxeRecovery account.
+ * @param commitment - RPC commitment level.
+ * @returns Parsed MxeRecoveryAccount data.
+ */
+export async function getMxeRecoveryAccInfo(
+    arciumProgram: anchor.Program<ArciumIdlType>,
+    address: PublicKey,
+    commitment?: anchor.web3.Commitment,
+): Promise<MxeRecoveryAccount> {
+    return arciumProgram.account.mxeRecoveryAccount.fetch(address, commitment);
+}
+
+/**
+ * Fetch and parse an ArxNode account.
+ * @param arciumProgram - Anchor program instance.
+ * @param address - Public key of the ArxNode account.
+ * @param commitment - RPC commitment level.
+ * @returns Parsed ArxNodeAccount data.
+ */
+export async function getArxNodeAccInfo(
+    arciumProgram: anchor.Program<ArciumIdlType>,
+    address: PublicKey,
+    commitment?: anchor.web3.Commitment,
+): Promise<ArxNodeAccount> {
+    return arciumProgram.account.arxNode.fetch(address, commitment);
+}
+
+/**
+ * Fetch and parse a ComputationDefinition account.
+ * @param arciumProgram - Anchor program instance.
+ * @param address - Public key of the ComputationDefinition account.
+ * @param commitment - RPC commitment level.
+ * @returns Parsed ComputationDefinitionAccount data.
+ */
+export async function getCompDefAccInfo(
+    arciumProgram: anchor.Program<ArciumIdlType>,
+    address: PublicKey,
+    commitment?: anchor.web3.Commitment,
+): Promise<ComputationDefinitionAccount> {
+    return arciumProgram.account.computationDefinitionAccount.fetch(
+        address,
+        commitment,
+    );
+}
+
+/**
+ * Fetch and parse a Computation account.
+ * @param arciumProgram - Anchor program instance.
+ * @param address - Public key of the Computation account.
+ * @param commitment - RPC commitment level.
+ * @returns Parsed ComputationAccount data.
+ */
+export async function getComputationAccInfo(
+    arciumProgram: anchor.Program<ArciumIdlType>,
+    address: PublicKey,
+    commitment?: anchor.web3.Commitment,
+): Promise<ComputationAccount> {
+    return arciumProgram.account.computationAccount.fetch(address, commitment);
+}
+
+async function getArciumAccPubkeys(
+    conn: Connection,
+    discriminator: number[],
+): Promise<PublicKey[]> {
+    const accs = await conn.getProgramAccounts(ARCIUM_PROGRAM_ID, {
+        dataSlice: { offset: 0, length: 0 },
+        filters: [
+            {
+                memcmp: {
+                    offset: 0,
+                    encoding: 'base64',
+                    bytes: Buffer.from(discriminator).toString('base64'),
+                },
+            },
+        ],
+    });
+    return accs.map((acc) => acc.pubkey);
+}

package/src/computationGetters.ts

@@ -0,0 +1,156 @@
+import * as anchor from '@coral-xyz/anchor';
+import {
+    ArciumEventName,
+    ArciumEventData,
+    Connection,
+    PublicKey,
+} from './types.js';
+import { ARCIUM_BORSH_CODER, PROGRAM_DATA_PREFIX, PROGRAM_LOG_PREFIX, ARCIUM_EVENT_NAMES } from './constants.js';
+
+/**
+ * Subscribe to computation events for an MXE program.
+ *
+ * Listens for queue, execute, and finalize events via Solana log subscriptions.
+ *
+ * @param conn - Solana connection object.
+ * @param mxeProgramId - Public key of the MXE program to monitor.
+ * @param callback - Handler called for each event with event data and event name.
+ * @returns Subscription ID for cleanup with {@link unsubscribeComputations}.
+ *
+ * @example
+ * const subId = await subscribeComputations(
+ *   connection,
+ *   mxeProgramId,
+ *   (event, name) => {
+ *     if (name === 'FinalizeComputationEvent') {
+ *       console.log('Computation finalized:', event.computationOffset.toString());
+ *     }
+ *   },
+ * );
+ *
+ * // When done, clean up the subscription
+ * await unsubscribeComputations(connection, subId);
+ */
+export async function subscribeComputations(
+    conn: Connection,
+    mxeProgramId: PublicKey,
+    callback: (event: ArciumEventData, name: ArciumEventName) => void,
+): Promise<number> {
+    return conn.onLogs(mxeProgramId, (logs) => {
+        const events = getComputationEventsFromLogs(logs.logs);
+        for (const event of events) {
+            callback(event.event, event.name);
+        }
+    });
+}
+
+/**
+ * Unsubscribe from computation events.
+ * @param conn - Solana connection object.
+ * @param subscriptionId - Subscription ID returned by {@link subscribeComputations}.
+ */
+export async function unsubscribeComputations(
+    conn: Connection,
+    subscriptionId: number,
+): Promise<void> {
+    conn.removeOnLogsListener(subscriptionId);
+}
+
+/**
+ * Get the computation offset from a transaction.
+ * @param tx - Transaction to extract the computation offset from.
+ * @returns Computation offset if found, otherwise undefined.
+ * @throws Error if multiple computation offsets are found in the transaction.
+ */
+export function getComputationOffset(
+    tx: anchor.web3.VersionedTransactionResponse,
+): anchor.BN | undefined {
+    const events = getComputationEventsFromLogs(tx.meta?.logMessages ?? []);
+    if (events.length === 0) {
+        return undefined;
+    }
+
+    const computationOffsets = events.map((e) => e.event.computationOffset);
+    const computationOffset = computationOffsets[0];
+
+    if (computationOffsets.some((offset) => !offset.eq(computationOffset))) {
+        throw new Error(
+            `Multiple computation offsets found in computation: ${JSON.stringify(
+                computationOffsets,
+            )}`,
+        );
+    }
+
+    return computationOffset;
+}
+
+/**
+ * Get the events related to Arcium computations from a transaction's logs.
+ *
+ * Note: This implements a direct decode approach instead of using Anchor's EventParser.parseLogs().
+ *
+ * BREAKING CHANGE IN ANCHOR v0.32.0 (PR #3657, commit 34b6d19):
+ * EventParser.parseLogs was hardened to prevent malicious log injection attacks. It now:
+ * 1. Requires the first log to match "Program X invoke [1]" (root invocation)
+ * 2. Pre-seeds the execution stack with program X from the first log
+ * 3. Only parses events when execution.program() === EventParser.programId
+ *
+ * This breaks our use case:
+ * - We subscribe to MXE program logs via conn.onLogs(mxeProgramId, ...) in {@link subscribeComputations}
+ * - But we need to parse Arcium events emitted during MXE→Arcium CPI calls
+ * - When MXE is the root program, execution.program() = MXE_PROGRAM_ID
+ * - EventParser expects execution.program() = ARCIUM_PROGRAM_ID
+ * - Result: All Arcium events are silently skipped
+ *
+ * Our discriminator-based approach:
+ * - Scans all logs for "Program data:" and "Program log:" prefixes
+ * - Uses event discriminators to identify valid Arcium events (no program context check)
+ * - Works regardless of which program is root or subscription target
+ * - Handles both MXE→Arcium and Arcium→MXE CPI patterns
+ *
+ * @param logs - Logs to get the events from.
+ * @returns Array of parsed Arcium computation events.
+ */
+function getComputationEventsFromLogs(
+    logs: string[],
+): { event: ArciumEventData; name: ArciumEventName }[] {
+    const events: Array<{ name: string; data: Record<string, unknown> }> = [];
+
+    // Scan all event logs and rely on discriminators to identify valid Arcium events.
+    // This works for both MXE→Arcium CPI and Arcium→MXE CPI transactions.
+    for (const log of logs) {
+        if (log.startsWith(PROGRAM_DATA_PREFIX)) {
+            const eventData = log.slice(PROGRAM_DATA_PREFIX.length);
+            const decoded = ARCIUM_BORSH_CODER.events.decode(eventData);
+
+            if (decoded && ARCIUM_EVENT_NAMES.includes(decoded.name as ArciumEventName)) {
+                events.push(decoded);
+            }
+        }
+        else if (log.startsWith(PROGRAM_LOG_PREFIX)) {
+            const eventData = log.slice(PROGRAM_LOG_PREFIX.length);
+            const decoded = ARCIUM_BORSH_CODER.events.decode(eventData);
+
+            if (decoded && ARCIUM_EVENT_NAMES.includes(decoded.name as ArciumEventName)) {
+                events.push(decoded);
+            }
+        }
+    }
+
+    // Map to existing return format
+    return events.map((e) => {
+        const eventData: ArciumEventData = {
+            computationOffset: e.data.computation_offset,
+            ...(e.data as object),
+        } as ArciumEventData;
+
+        if (e.data.mxe_program_id) {
+            eventData.mxeProgramId = e.data.mxe_program_id as PublicKey;
+        }
+
+        return {
+            event: eventData,
+            name: e.name as ArciumEventName,
+        };
+    });
+}

package/src/constants.ts

@@ -0,0 +1,78 @@
+import { ArciumIdlType, ARCIUM_IDL, ARCIUM_ADDR } from '@arcium-hq/client';
+import * as anchor from '@coral-xyz/anchor';
+import {
+    ArciumEventName, CallbackComputationIx, PublicKey, QueueComputationIx,
+} from './types.js';
+
+type ArciumArxNodeAccount = ArciumIdlType['accounts']['0'];
+type ArciumClusterAccount = ArciumIdlType['accounts']['2'];
+type ArciumMXEAccount = ArciumIdlType['accounts']['10'];
+
+/**
+ * Prefix for program data logs in Solana transaction logs.
+ * @constant {string}
+ */
+export const PROGRAM_DATA_PREFIX = 'Program data: ';
+
+/**
+ * Prefix for program log messages in Solana transaction logs.
+ * @constant {string}
+ */
+export const PROGRAM_LOG_PREFIX = 'Program log: ';
+
+/**
+ * Valid Arcium event names for computation lifecycle tracking.
+ * @constant {ArciumEventName[]}
+ */
+export const ARCIUM_EVENT_NAMES: ArciumEventName[] = [
+    'QueueComputationEvent',
+    'InitComputationEvent',
+    'CallbackComputationEvent',
+    'FinalizeComputationEvent',
+];
+
+/**
+ * Discriminator for the ArxNode account type. Used to filter and identify ArxNode accounts on-chain.
+ */
+export const ARX_NODE_ACC_DISCRIMINATOR: ArciumArxNodeAccount['discriminator'] = [2, 207, 122, 223, 93, 97, 231, 199];
+
+/**
+ * Discriminator for the Cluster account type. Used to filter and identify Cluster accounts on-chain.
+ */
+export const CLUSTER_ACC_DISCRIMINATOR: ArciumClusterAccount['discriminator'] = [236, 225, 118, 228, 173, 106, 18, 60];
+
+/**
+ * Discriminator for the MXE account type. Used to filter and identify MXE accounts on-chain.
+ */
+export const MXE_ACC_DISCRIMINATOR: ArciumMXEAccount['discriminator'] = [103, 26, 85, 250, 179, 159, 17, 117];
+
+/**
+ * Discriminator for the queueComputation instruction. Used to identify the queueComputation instruction in transaction data.
+ */
+export const QUEUE_COMPUTATION_IX_DISCRIMINATOR: QueueComputationIx['discriminator'] = [1, 149, 103, 13, 102, 227, 93, 164];
+
+/**
+ * Discriminator for the callbackComputation instruction. Used to identify the callbackComputation instruction in transaction data.
+ */
+export const CALLBACK_COMPUTATION_IX_DISCRIMINATOR: CallbackComputationIx['discriminator'] = [11, 224, 42, 236, 0, 154, 74, 163];
+
+/**
+ * The public key of the deployed Arcium program on Solana.
+ */
+export const ARCIUM_PROGRAM_ID: PublicKey = new anchor.web3.PublicKey(ARCIUM_ADDR);
+
+/**
+ * Anchor coder for encoding and decoding Arcium program instructions.
+ */
+export const ARCIUM_IX_CODER = new anchor.BorshInstructionCoder(ARCIUM_IDL as unknown as ArciumIdlType);
+
+/**
+ * Anchor event parser for parsing Arcium program events from transaction logs.
+ */
+export const ARCIUM_EVENT_CODER = new anchor.EventParser(ARCIUM_PROGRAM_ID, new anchor.BorshCoder(ARCIUM_IDL as unknown as ArciumIdlType));
+
+/**
+ * BorshCoder instance for decoding Arcium events.
+ * Used directly instead of accessing EventParser's private coder property.
+ */
+export const ARCIUM_BORSH_CODER = new anchor.BorshCoder(ARCIUM_IDL as unknown as ArciumIdlType);

package/src/index.ts

@@ -0,0 +1,28 @@
+/**
+ * Read-only SDK for querying Arcium network state on Solana.
+ *
+ * Key exports:
+ * - {@link getMXEAccInfo}, {@link getClusterAccInfo} - Account getters
+ * - {@link subscribeComputations} - Event monitoring
+ * - Types for all Arcium accounts
+ *
+ * @packageDocumentation
+ */
+export {
+    getClusterAccAddress,
+    getArxNodeAccAddress,
+    getMXEAccAddress,
+    getArciumProgram,
+    getComputationAccAddress,
+    getMempoolAccAddress,
+    getClockAccAddress,
+    getFeePoolAccAddress,
+    getExecutingPoolAccAddress,
+    getCompDefAccAddress,
+    getComputationsInMempool,
+    getMempoolPriorityFeeStats,
+} from '@arcium-hq/client';
+
+export * from './accGetters.js';
+export * from './computationGetters.js';
+export * from './types.js';

package/src/types.ts

@@ -0,0 +1,101 @@
+/**
+ * Shared type aliases and utility types for the Arcium program.
+ * Many types are derived from the Anchor-generated IDL and are used throughout the reader package.
+ */
+import { ArciumIdlType } from '@arcium-hq/client';
+import * as anchor from '@coral-xyz/anchor';
+
+/**
+ * Solana PublicKey type alias for convenience.
+ */
+export type PublicKey = anchor.web3.PublicKey;
+
+/**
+ * Solana Connection type alias for convenience.
+ */
+export type Connection = anchor.web3.Connection;
+
+/**
+ * Anchor Program type alias with generic IDL support.
+ */
+export type Program<T extends anchor.Idl> = anchor.Program<T>;
+
+/**
+ * Arcium IDL types derived from the Arcium program interface.
+ */
+export type ArciumTypes = anchor.IdlTypes<ArciumIdlType>;
+
+/**
+ * All events emitted by the Arcium program, keyed by event name.
+ */
+export type ArciumEvent = anchor.IdlEvents<ArciumIdlType>;
+
+/**
+ * Capitalized event names, matching the format as emitted by the program.
+ */
+export type ArciumEventName = Capitalize<keyof ArciumEvent>;
+
+/**
+ * Data structure for any Arcium event, as parsed from logs.
+ */
+export type ArciumEventData = ArciumEvent[keyof ArciumEvent];
+
+/**
+ * MXE (Multi-party eXecution Environment) account data structure.
+ */
+export type MXEAccount = ArciumTypes['mxeAccount'];
+
+/**
+ * Cluster account data structure containing node information.
+ */
+export type ClusterAccount = ArciumTypes['cluster'];
+
+/**
+ * Recovery cluster account data structure containing recovery peers information.
+ */
+export type RecoveryClusterAccount = ArciumTypes['recoveryClusterAccount'];
+
+/**
+ * MXE recovery account data structure tracking key recovery session state.
+ */
+export type MxeRecoveryAccount = ArciumTypes['mxeRecoveryAccount'];
+
+/**
+ * ArxNode account data structure for individual computation nodes.
+ */
+export type ArxNodeAccount = ArciumTypes['arxNode'];
+
+/**
+ * Computation account data structure tracking computation state.
+ */
+export type ComputationAccount = ArciumTypes['computationAccount'];
+
+/**
+ * Reference to a computation in a mempool or executing pool.
+ */
+export type ComputationReference = ArciumTypes['computationReference'];
+
+/**
+ * Computation definition account containing circuit configuration.
+ */
+export type ComputationDefinitionAccount = ArciumTypes['computationDefinitionAccount'];
+
+/**
+ * Queue computation instruction type from the Arcium IDL.
+ */
+export type QueueComputationIx = ArciumIdlType['instructions']['38'];
+
+/**
+ * Callback computation instruction type from the Arcium IDL.
+ */
+export type CallbackComputationIx = ArciumIdlType['instructions']['4'];
+
+/**
+ * Valid instruction names from the Arcium IDL.
+ */
+export type ArciumInstructionName = ArciumIdlType['instructions'][number]['name'];
+
+/**
+ * Status values for a computation, as defined by the Arcium protocol.
+ */
+export type ComputationStatus = 'queued' | 'executing' | 'executed' | 'finalized' | 'failed';

package/build/index.d.ts

@@ -1,211 +0,0 @@
-import { ArciumIdlType } from '@arcium-hq/client';
-export { getArciumProgram, getArxNodeAccAddress, getClockAccAddress, getClusterAccAddress, getCompDefAccAddress, getComputationAccAddress, getComputationsInMempool, getExecutingPoolAccAddress, getFeePoolAccAddress, getMXEAccAddress, getMempoolAccAddress, getMempoolPriorityFeeStats } from '@arcium-hq/client';
-import * as anchor from '@coral-xyz/anchor';
-
-/**
- * Shared type aliases and utility types for the Arcium program.
- * Many types are derived from the Anchor-generated IDL and are used throughout the reader package.
- */
-
-/**
- * Solana PublicKey type alias for convenience.
- */
-type PublicKey = anchor.web3.PublicKey;
-/**
- * Solana Connection type alias for convenience.
- */
-type Connection = anchor.web3.Connection;
-/**
- * Anchor Program type alias with generic IDL support.
- */
-type Program<T extends anchor.Idl> = anchor.Program<T>;
-/**
- * Arcium IDL types derived from the Arcium program interface.
- */
-type ArciumTypes = anchor.IdlTypes<ArciumIdlType>;
-/**
- * All events emitted by the Arcium program, keyed by event name.
- */
-type ArciumEvent = anchor.IdlEvents<ArciumIdlType>;
-/**
- * Capitalized event names, matching the format as emitted by the program.
- */
-type ArciumEventName = Capitalize<keyof ArciumEvent>;
-/**
- * Data structure for any Arcium event, as parsed from logs.
- */
-type ArciumEventData = ArciumEvent[keyof ArciumEvent];
-/**
- * MXE (Multi-party eXecution Environment) account data structure.
- */
-type MXEAccount = ArciumTypes['mxeAccount'];
-/**
- * Cluster account data structure containing node information.
- */
-type ClusterAccount = ArciumTypes['cluster'];
-/**
- * Recovery cluster account data structure containing recovery peers information.
- */
-type RecoveryClusterAccount = ArciumTypes['recoveryClusterAccount'];
-/**
- * MXE recovery account data structure tracking key recovery session state.
- */
-type MxeRecoveryAccount = ArciumTypes['mxeRecoveryAccount'];
-/**
- * ArxNode account data structure for individual computation nodes.
- */
-type ArxNodeAccount = ArciumTypes['arxNode'];
-/**
- * Computation account data structure tracking computation state.
- */
-type ComputationAccount = ArciumTypes['computationAccount'];
-/**
- * Reference to a computation in a mempool or executing pool.
- */
-type ComputationReference = ArciumTypes['computationReference'];
-/**
- * Computation definition account containing circuit configuration.
- */
-type ComputationDefinitionAccount = ArciumTypes['computationDefinitionAccount'];
-/**
- * Queue computation instruction type from the Arcium IDL.
- */
-type QueueComputationIx = ArciumIdlType['instructions']['38'];
-/**
- * Callback computation instruction type from the Arcium IDL.
- */
-type CallbackComputationIx = ArciumIdlType['instructions']['4'];
-/**
- * Valid instruction names from the Arcium IDL.
- */
-type ArciumInstructionName = ArciumIdlType['instructions'][number]['name'];
-/**
- * Status values for a computation, as defined by the Arcium protocol.
- */
-type ComputationStatus = 'queued' | 'executing' | 'executed' | 'finalized' | 'failed';
-
-/**
- * Return all MXE account addresses.
- * @param conn - Solana connection object.
- * @returns Array of MXE account public keys.
- */
-declare function getMXEAccAddresses(conn: Connection): Promise<PublicKey[]>;
-/**
- * Return all Cluster account addresses.
- * @param conn - Solana connection object.
- * @returns Array of Cluster account public keys.
- */
-declare function getClusterAccAddresses(conn: Connection): Promise<PublicKey[]>;
-/**
- * Return all ArxNode account addresses.
- * @param conn - Solana connection object.
- * @returns Array of ArxNode account public keys.
- */
-declare function getArxNodeAccAddresses(conn: Connection): Promise<PublicKey[]>;
-/**
- * Fetch and parse an MXE account.
- *
- * @param arciumProgram - Anchor program instance.
- * @param address - Public key of the MXE account.
- * @param commitment - RPC commitment level.
- * @returns Parsed MXE account data.
- *
- * @example
- * import { getArciumProgram, getMXEAccAddress, getMXEAccInfo } from '@arcium-hq/reader';
- *
- * const program = getArciumProgram(provider);
- * const mxeAddress = getMXEAccAddress(mxeProgramId);
- * const mxeAccount = await getMXEAccInfo(program, mxeAddress);
- * console.log('MXE authority:', mxeAccount.authority?.toBase58());
- */
-declare function getMXEAccInfo(arciumProgram: anchor.Program<ArciumIdlType>, address: PublicKey, commitment?: anchor.web3.Commitment): Promise<MXEAccount>;
-/**
- * Fetch and parse a Cluster account.
- * @param arciumProgram - Anchor program instance.
- * @param address - Public key of the Cluster account.
- * @param commitment - RPC commitment level.
- * @returns Parsed ClusterAccount data.
- */
-declare function getClusterAccInfo(arciumProgram: anchor.Program<ArciumIdlType>, address: PublicKey, commitment?: anchor.web3.Commitment): Promise<ClusterAccount>;
-/**
- * Fetch and parse a recovery cluster account.
- * @param arciumProgram - Anchor program instance.
- * @param address - Public key of the recovery cluster account.
- * @param commitment - RPC commitment level.
- * @returns Parsed RecoveryClusterAccount data.
- */
-declare function getRecoveryClusterAccInfo(arciumProgram: anchor.Program<ArciumIdlType>, address: PublicKey, commitment?: anchor.web3.Commitment): Promise<RecoveryClusterAccount>;
-/**
- * Fetch and parse an MxeRecovery account.
- * @param arciumProgram - Anchor program instance.
- * @param address - Public key of the MxeRecovery account.
- * @param commitment - RPC commitment level.
- * @returns Parsed MxeRecoveryAccount data.
- */
-declare function getMxeRecoveryAccInfo(arciumProgram: anchor.Program<ArciumIdlType>, address: PublicKey, commitment?: anchor.web3.Commitment): Promise<MxeRecoveryAccount>;
-/**
- * Fetch and parse an ArxNode account.
- * @param arciumProgram - Anchor program instance.
- * @param address - Public key of the ArxNode account.
- * @param commitment - RPC commitment level.
- * @returns Parsed ArxNodeAccount data.
- */
-declare function getArxNodeAccInfo(arciumProgram: anchor.Program<ArciumIdlType>, address: PublicKey, commitment?: anchor.web3.Commitment): Promise<ArxNodeAccount>;
-/**
- * Fetch and parse a ComputationDefinition account.
- * @param arciumProgram - Anchor program instance.
- * @param address - Public key of the ComputationDefinition account.
- * @param commitment - RPC commitment level.
- * @returns Parsed ComputationDefinitionAccount data.
- */
-declare function getCompDefAccInfo(arciumProgram: anchor.Program<ArciumIdlType>, address: PublicKey, commitment?: anchor.web3.Commitment): Promise<ComputationDefinitionAccount>;
-/**
- * Fetch and parse a Computation account.
- * @param arciumProgram - Anchor program instance.
- * @param address - Public key of the Computation account.
- * @param commitment - RPC commitment level.
- * @returns Parsed ComputationAccount data.
- */
-declare function getComputationAccInfo(arciumProgram: anchor.Program<ArciumIdlType>, address: PublicKey, commitment?: anchor.web3.Commitment): Promise<ComputationAccount>;
-
-/**
- * Subscribe to computation events for an MXE program.
- *
- * Listens for queue, execute, and finalize events via Solana log subscriptions.
- *
- * @param conn - Solana connection object.
- * @param mxeProgramId - Public key of the MXE program to monitor.
- * @param callback - Handler called for each event with event data and event name.
- * @returns Subscription ID for cleanup with {@link unsubscribeComputations}.
- *
- * @example
- * const subId = await subscribeComputations(
- *   connection,
- *   mxeProgramId,
- *   (event, name) => {
- *     if (name === 'FinalizeComputationEvent') {
- *       console.log('Computation finalized:', event.computationOffset.toString());
- *     }
- *   },
- * );
- *
- * // When done, clean up the subscription
- * await unsubscribeComputations(connection, subId);
- */
-declare function subscribeComputations(conn: Connection, mxeProgramId: PublicKey, callback: (event: ArciumEventData, name: ArciumEventName) => void): Promise<number>;
-/**
- * Unsubscribe from computation events.
- * @param conn - Solana connection object.
- * @param subscriptionId - Subscription ID returned by {@link subscribeComputations}.
- */
-declare function unsubscribeComputations(conn: Connection, subscriptionId: number): Promise<void>;
-/**
- * Get the computation offset from a transaction.
- * @param tx - Transaction to extract the computation offset from.
- * @returns Computation offset if found, otherwise undefined.
- * @throws Error if multiple computation offsets are found in the transaction.
- */
-declare function getComputationOffset(tx: anchor.web3.VersionedTransactionResponse): anchor.BN | undefined;
-
-export { getArxNodeAccAddresses, getArxNodeAccInfo, getClusterAccAddresses, getClusterAccInfo, getCompDefAccInfo, getComputationAccInfo, getComputationOffset, getMXEAccAddresses, getMXEAccInfo, getMxeRecoveryAccInfo, getRecoveryClusterAccInfo, subscribeComputations, unsubscribeComputations };
-export type { ArciumEvent, ArciumEventData, ArciumEventName, ArciumInstructionName, ArciumTypes, ArxNodeAccount, CallbackComputationIx, ClusterAccount, ComputationAccount, ComputationDefinitionAccount, ComputationReference, ComputationStatus, Connection, MXEAccount, MxeRecoveryAccount, Program, PublicKey, QueueComputationIx, RecoveryClusterAccount };