@arcium-hq/reader 0.9.6 → 0.10.0

package/README.md

@@ -1,292 +1,68 @@
-# Arcium Reader SDK
+<div align="center">
+  <img src="https://raw.githubusercontent.com/arcium-hq/.github/refs/heads/main/profile/arcium.svg" alt="Arcium" width="200"/>
 
-The Arcium Reader SDK is a TypeScript library for passively observing and querying the Arcium network state. It provides read-only access to account data, computation tracking, and event monitoring without requiring a wallet or signer.
+<h1>@arcium-hq/reader</h1>
 
-## Installation
-
-```bash
-npm install @arcium-hq/reader
-# or
-yarn add @arcium-hq/reader
-# or
-pnpm add @arcium-hq/reader
-```
-
-## Quick Start
-
-### 1. Setup
-
-```typescript
-import * as anchor from "@coral-xyz/anchor";
-import { getArciumProgram } from "@arcium-hq/reader";
-
-// Setup connection (no wallet required)
-const connection = new anchor.web3.Connection("https://api.mainnet-beta.solana.com");
-const provider = new anchor.AnchorProvider(connection, null, {});
-const arciumProgram = getArciumProgram(provider);
-```
-
-### 2. Query Account Information
-
-```typescript
-import {
-  getMXEAccAddresses,
-  getMXEAccInfo,
-  getClusterAccAddresses,
-  getClusterAccInfo,
-} from "@arcium-hq/reader";
+<p>Read-only TypeScript SDK for querying Arcium network state.</p>
 
-// Get all MXE accounts
-const mxeAddresses = await getMXEAccAddresses(connection);
-console.log(`Found ${mxeAddresses.length} MXE accounts`);
+[![npm](https://img.shields.io/npm/v/@arcium-hq/reader)](https://www.npmjs.com/package/@arcium-hq/reader)
 
-// Get detailed information for first MXE
-if (mxeAddresses.length > 0) {
-  const mxeInfo = await getMXEAccInfo(arciumProgram, mxeAddresses[0]);
-  console.log("MXE Info:", {
-    authority: mxeInfo.authority,
-    cluster: mxeInfo.cluster,
-    computationDefinitions: mxeInfo.computationDefinitions.length,
-  });
-}
-```
-
-### 3. Monitor Computations
-
-```typescript
-import { subscribeComputations } from "@arcium-hq/reader";
-
-// Subscribe to computation events for an MXE program
-const mxeProgramId = new anchor.web3.PublicKey("YOUR_MXE_PROGRAM_ID");
-
-const subscriptionId = await subscribeComputations(
-  connection,
-  mxeProgramId,
-  (eventData, eventName) => {
-    console.log(`Event: ${eventName}`, eventData);
-  }
-);
-```
-
-## Account Types and Queries
-
-### MXE (Multi-party eXecution Environment) Accounts
-
-MXE accounts represent execution environments for secure computations.
+**[API Docs](https://ts.arcium.com/api)** | **[Developer Docs](https://docs.arcium.com/developers/js-client-library)**
 
-```typescript
-import { getMXEAccAddresses, getMXEAccInfo } from "@arcium-hq/reader";
+</div>
 
-// Get all MXE account addresses
-const mxeAddresses = await getMXEAccAddresses(connection);
-
-// Fetch detailed MXE information
-for (const address of mxeAddresses) {
-  const mxeInfo = await getMXEAccInfo(arciumProgram, address);
-  
-  console.log("MXE Account:", {
-    address: address.toBase58(),
-    authority: mxeInfo.authority?.toBase58(),
-    cluster: mxeInfo.cluster,
-    x25519KeySet: 'set' in mxeInfo.x25519Pubkey,
-    computationDefinitions: mxeInfo.computationDefinitions,
-    fallbackClusters: mxeInfo.fallbackClusters,
-  });
-}
-```
-
-### Cluster Accounts
-
-Cluster accounts manage collections of ARX nodes that execute computations.
-
-```typescript
-import { getClusterAccAddresses, getClusterAccInfo } from "@arcium-hq/reader";
-
-// Get all cluster addresses
-const clusterAddresses = await getClusterAccAddresses(connection);
-
-// Analyze cluster information
-for (const address of clusterAddresses) {
-  const clusterInfo = await getClusterAccInfo(arciumProgram, address);
-  
-  console.log("Cluster:", {
-    address: address.toBase58(),
-    nodeCount: clusterInfo.nodes.length,
-    mxeCount: clusterInfo.mxes.length,
-    threshold: clusterInfo.threshold,
-    state: clusterInfo.state,
-  });
-}
-```
+## When To Use
 
-### ArxNode Accounts
+- Listing MXE, cluster, and ARX node accounts
+- Fetching typed account state from the Arcium program
+- Monitoring computation activity without writing transactions
 
-ArxNode accounts represent individual computation nodes in the network.
+## Requirements
 
-```typescript
-import { getArxNodeAccAddresses, getArxNodeAccInfo } from "@arcium-hq/reader";
+- Node.js `20.18+`
+- `@anchor-lang/core` `^0.32.1`
 
-// Get all ARX node addresses
-const arxNodeAddresses = await getArxNodeAccAddresses(connection);
-
-// Get node information
-for (const address of arxNodeAddresses) {
-  const nodeInfo = await getArxNodeAccInfo(arciumProgram, address);
-  
-  console.log("ARX Node:", {
-    address: address.toBase58(),
-    authority: nodeInfo.authority?.toBase58(),
-    clusterMemberships: nodeInfo.clusterMemberships,
-    encryptionPubkey: Buffer.from(nodeInfo.encryptionPubkey).toString('hex'),
-  });
-}
-```
-
-### Computation Definition Accounts
-
-Track available computation definitions and their configurations.
-
-```typescript
-import { getCompDefAccInfo, getCompDefAccAddress } from "@arcium-hq/reader";
-
-// Get computation definition for a specific circuit
-const mxeProgramId = new anchor.web3.PublicKey("YOUR_MXE_PROGRAM_ID");
-const compDefOffset = 0; // Your computation definition offset
-const compDefAddress = getCompDefAccAddress(mxeProgramId, compDefOffset);
-const compDefInfo = await getCompDefAccInfo(arciumProgram, compDefAddress);
-
-console.log("Computation Definition:", {
-  finalizationAuthority: compDefInfo.finalizationAuthority?.toBase58(),
-  finalizesDuringCallback: compDefInfo.finalizeDuringCallback,
-  cuAmount: compDefInfo.cuAmount.toString(),
-  circuitSource: compDefInfo.circuitSource,
-});
-```
-
-### Computation Accounts
-
-Monitor individual computation instances and their status.
-
-```typescript
-import { getComputationAccInfo, getComputationAccAddress } from "@arcium-hq/reader";
-
-// Get computation account info
-const clusterOffset = 0; // Your cluster offset
-const computationOffset = new anchor.BN("123456789");
-const computationAddress = getComputationAccAddress(clusterOffset, computationOffset);
-const computationInfo = await getComputationAccInfo(arciumProgram, computationAddress);
+## Installation
 
-console.log("Computation:", {
-  status: computationInfo.status,
-  arguments: computationInfo.arguments,
-  results: computationInfo.results,
-  submitter: computationInfo.submitter.toBase58(),
-});
+```bash
+npm install @arcium-hq/reader @anchor-lang/core
 ```
 
-## Mempool Analysis
+## Quick Start
 
-Analyze pending computations in the network's memory pools.
+A wallet-less `AnchorProvider` is sufficient since this SDK never signs transactions.
 
-```typescript
+```ts
 import {
-  getComputationsInMempool,
-  getMempoolAccAddress
-} from "@arcium-hq/reader";
-
-// Get mempool for a cluster (use your cluster offset)
-const clusterOffset = 0; // Your cluster offset
-const mempoolAddress = getMempoolAccAddress(clusterOffset);
-const pendingComputations = await getComputationsInMempool(arciumProgram, mempoolAddress);
-
-console.log(`Found ${pendingComputations.length} pending computations:`);
-
-for (const compRef of pendingComputations) {
-  console.log("Pending Computation:", {
-    computationOffset: compRef.computationOffset.toString(),
-    priorityFee: compRef.priorityFee.toString(),
-    computationDefinitionOffset: compRef.computationDefinitionOffset,
-  });
-}
-```
-
-## Event Monitoring
-
-### Real-time Event Subscription
-
-Monitor computation lifecycle events in real-time:
-
-```typescript
-import { 
-  subscribeComputations,
-  unsubscribeComputations,
-  ArciumEventData,
-  ArciumEventName 
+  getArciumProgram,
+  getClusterAccAddresses,
+  getMXEAccAddresses,
+  getMXEAccInfo,
 } from "@arcium-hq/reader";
 
-const eventLog: Array<{event: ArciumEventData, name: ArciumEventName, timestamp: Date}> = [];
-
-// Subscribe to events
-const subscriptionId = await subscribeComputations(
-  connection,
-  mxeProgramId,
-  (eventData, eventName) => {
-    eventLog.push({
-      event: eventData,
-      name: eventName,
-      timestamp: new Date()
-    });
-
-    console.log(`[${eventName}] Computation ${eventData.computationOffset.toString()}`);
-    
-    // Handle specific event types
-    switch (eventName) {
-      case 'QueueComputationEvent':
-        console.log("  → Computation queued for execution");
-        break;
-      case 'InitComputationEvent':
-        console.log("  → Computation execution started");
-        break;
-      case 'CallbackComputationEvent':
-        console.log("  → Computation callback received");
-        break;
-      case 'FinalizeComputationEvent':
-        console.log("  → Computation finalized");
-        break;
-    }
-  }
-);
-
-console.log(`Subscribed to events with ID: ${subscriptionId}`);
-
-// Later, unsubscribe
-// await unsubscribeComputations(connection, subscriptionId);
+// `provider` is an `AnchorProvider` you've already constructed.
+const program = getArciumProgram(provider);
+const mxes = await getMXEAccAddresses(provider.connection);
+const clusters = await getClusterAccAddresses(provider.connection);
+const firstMxe = await getMXEAccInfo(program, mxes[0]);
 ```
 
-### Transaction Analysis
+## Main Exports
 
-Extract computation events from transaction logs:
+| Area | Description |
+|------|-------------|
+| Account discovery | `getMXEAccAddresses`, `getClusterAccAddresses`, `getArxNodeAccAddresses` |
+| Account fetching | `getMXEAccInfo`, `getClusterAccInfo`, `getCompDefAccInfo`, `getComputationAccInfo` |
+| PDA helpers | Re-exported from `@arcium-hq/client` for convenient read flows |
+| Types | Typed account models for Arcium state |
 
-```typescript
-import { getComputationOffset } from "@arcium-hq/reader";
+## Notes
 
-// Analyze a specific transaction
-const txSignature = "YOUR_TRANSACTION_SIGNATURE";
-const tx = await connection.getTransaction(txSignature, {
-  commitment: "confirmed",
-  maxSupportedTransactionVersion: 0
-});
-
-if (tx) {
-  const computationOffset = getComputationOffset(tx);
-  if (computationOffset) {
-    console.log(`Transaction contains computation: ${computationOffset.toString()}`);
-  }
-}
-```
+- `@arcium-hq/reader` is read-only; use [`@arcium-hq/client`](https://www.npmjs.com/package/@arcium-hq/client) for encryption and write flows.
+- The package re-exports several PDA helpers from the client SDK.
 
-## API Reference
+## See Also
 
-- **[API Reference](https://ts.arcium.com/api)** - Complete API documentation
-- **[Developer Docs](https://docs.arcium.com/developers/js-client-library)** - Guides and tutorials
-- **[Examples](https://github.com/arcium-hq/examples)** - Code examples
+- [`@arcium-hq/client`](https://www.npmjs.com/package/@arcium-hq/client)
+- [API Docs](https://ts.arcium.com/api)
+- [Developer Docs](https://docs.arcium.com/developers/js-client-library)

package/build/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var client = require('@arcium-hq/client');
-var anchor = require('@coral-xyz/anchor');
+var anchor = require('@anchor-lang/core');
 
 function _interopNamespaceDefault(e) {
     var n = Object.create(null);

package/build/index.mjs

@@ -1,6 +1,6 @@
 import { ARCIUM_ADDR, ARCIUM_IDL } 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';
+import * as anchor from '@anchor-lang/core';
 
 /**
  * Prefix for program data logs in Solana transaction logs.

package/build/types/accGetters.d.ts

@@ -1,4 +1,4 @@
-import * as anchor from '@coral-xyz/anchor';
+import * as anchor from '@anchor-lang/core';
 import { ArciumIdlType } from '@arcium-hq/client';
 import { ClusterAccount, Connection, MXEAccount, PublicKey, ArxNodeAccount, ComputationAccount, ComputationDefinitionAccount, RecoveryClusterAccount, MxeRecoveryAccount } from './types.js';
 /**

package/build/types/computationGetters.d.ts

@@ -1,5 +1,5 @@
-import * as anchor from '@coral-xyz/anchor';
-import { ArciumEventName, ArciumEventData, Connection, PublicKey } from './types.js';
+import * as anchor from '@anchor-lang/core';
+import { ArciumEventName, ComputationEventData, Connection, PublicKey } from './types.js';
 /**
  * Subscribe to computation events for an MXE program.
  *
@@ -24,7 +24,7 @@ import { ArciumEventName, ArciumEventData, Connection, PublicKey } from './types
  * // 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>;
+export declare function subscribeComputations(conn: Connection, mxeProgramId: PublicKey, callback: (event: ComputationEventData, name: ArciumEventName) => void): Promise<number>;
 /**
  * Unsubscribe from computation events.
  * @param conn - Solana connection object.

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

@@ -1 +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"}
+{"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,oBAAoB,EACpB,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,oBAAoB,EAAE,IAAI,EAAE,eAAe,KAAK,IAAI,GACvE,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

@@ -1,9 +1,12 @@
 import { ArciumIdlType } from '@arcium-hq/client';
-import * as anchor from '@coral-xyz/anchor';
+import * as anchor from '@anchor-lang/core';
 import { ArciumEventName, CallbackComputationIx, PublicKey, QueueComputationIx } from './types.js';
-type ArciumArxNodeAccount = ArciumIdlType['accounts']['0'];
-type ArciumClusterAccount = ArciumIdlType['accounts']['2'];
-type ArciumMXEAccount = ArciumIdlType['accounts']['10'];
+type FindAccount<Name extends string> = Extract<ArciumIdlType['accounts'][number], {
+    name: Name;
+}>;
+type ArciumArxNodeAccount = FindAccount<'arxNode'>;
+type ArciumClusterAccount = FindAccount<'cluster'>;
+type ArciumMXEAccount = FindAccount<'mxeAccount'>;
 /**
  * Prefix for program data logs in Solana transaction logs.
  * @constant {string}

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

@@ -1 +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"}
+{"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,WAAW,CAAC,IAAI,SAAS,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC,CAAC;AACnG,KAAK,oBAAoB,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;AACnD,KAAK,oBAAoB,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;AACnD,KAAK,gBAAgB,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;AAElD;;;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/types.d.ts

@@ -3,7 +3,7 @@
  * 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';
+import * as anchor from '@anchor-lang/core';
 /**
  * Solana PublicKey type alias for convenience.
  */
@@ -20,6 +20,13 @@ 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>;
+/**
+ * Finds an instruction type from the Arcium IDL by name,
+ * avoiding fragile hardcoded numeric indices.
+ */
+export type FindInstruction<Name extends string> = Extract<ArciumIdlType['instructions'][number], {
+    name: Name;
+}>;
 /**
  * All events emitted by the Arcium program, keyed by event name.
  */
@@ -32,6 +39,14 @@ export type ArciumEventName = Capitalize<keyof ArciumEvent>;
  * Data structure for any Arcium event, as parsed from logs.
  */
 export type ArciumEventData = ArciumEvent[keyof ArciumEvent];
+/**
+ * Computation event names that all have computationOffset field.
+ */
+export type ComputationEventName = 'queueComputationEvent' | 'initComputationEvent' | 'callbackComputationEvent' | 'finalizeComputationEvent';
+/**
+ * Data structure for computation events (events that have computationOffset).
+ */
+export type ComputationEventData = ArciumEvent[ComputationEventName];
 /**
  * MXE (Multi-party eXecution Environment) account data structure.
  */
@@ -67,11 +82,11 @@ export type ComputationDefinitionAccount = ArciumTypes['computationDefinitionAcc
 /**
  * Queue computation instruction type from the Arcium IDL.
  */
-export type QueueComputationIx = ArciumIdlType['instructions']['38'];
+export type QueueComputationIx = FindInstruction<'queueComputation'>;
 /**
  * Callback computation instruction type from the Arcium IDL.
  */
-export type CallbackComputationIx = ArciumIdlType['instructions']['4'];
+export type CallbackComputationIx = FindInstruction<'callbackComputation'>;
 /**
  * Valid instruction names from the Arcium IDL.
  */

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

@@ -1 +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"}
+{"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;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,IAAI,SAAS,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC,CAAC;AAElH;;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,oBAAoB,GAAG,uBAAuB,GAAG,sBAAsB,GAAG,0BAA0B,GAAG,0BAA0B,CAAC;AAE9I;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,oBAAoB,CAAC,CAAC;AAErE;;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,eAAe,CAAC,kBAAkB,CAAC,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAC,qBAAqB,CAAC,CAAC;AAE3E;;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.6",
+  "version": "0.10.0",
   "description": "Reader SDK for fetching onchain data for Arcium network programs",
   "author": "Arcium",
   "license": "GPL-3.0-only",
@@ -55,10 +55,10 @@
     "typescript-eslint": "^8.15.0"
   },
   "dependencies": {
-    "@coral-xyz/anchor": "^0.32.1",
+    "@anchor-lang/core": "^1.0.1",
     "@noble/curves": "^1.9.5",
     "@noble/hashes": "^1.7.1",
-    "@arcium-hq/client": "0.9.6"
+    "@arcium-hq/client": "0.10.0"
   },
   "keywords": [
     "Cryptography",

package/src/accGetters.ts

@@ -1,4 +1,4 @@
-import * as anchor from '@coral-xyz/anchor';
+import * as anchor from '@anchor-lang/core';
 import { ArciumIdlType } from '@arcium-hq/client';
 import {
     ClusterAccount,

package/src/computationGetters.ts

@@ -1,7 +1,7 @@
-import * as anchor from '@coral-xyz/anchor';
+import * as anchor from '@anchor-lang/core';
 import {
     ArciumEventName,
-    ArciumEventData,
+    ComputationEventData,
     Connection,
     PublicKey,
 } from './types.js';
@@ -34,7 +34,7 @@ import { ARCIUM_BORSH_CODER, PROGRAM_DATA_PREFIX, PROGRAM_LOG_PREFIX, ARCIUM_EVE
 export async function subscribeComputations(
     conn: Connection,
     mxeProgramId: PublicKey,
-    callback: (event: ArciumEventData, name: ArciumEventName) => void,
+    callback: (event: ComputationEventData, name: ArciumEventName) => void,
 ): Promise<number> {
     return conn.onLogs(mxeProgramId, (logs) => {
         const events = getComputationEventsFromLogs(logs.logs);
@@ -113,7 +113,7 @@ export function getComputationOffset(
  */
 function getComputationEventsFromLogs(
     logs: string[],
-): { event: ArciumEventData; name: ArciumEventName }[] {
+): { event: ComputationEventData; name: ArciumEventName }[] {
     const events: Array<{ name: string; data: Record<string, unknown> }> = [];
 
     // Scan all event logs and rely on discriminators to identify valid Arcium events.
@@ -139,10 +139,10 @@ function getComputationEventsFromLogs(
 
     // Map to existing return format
     return events.map((e) => {
-        const eventData: ArciumEventData = {
+        const eventData: ComputationEventData = {
             computationOffset: e.data.computation_offset,
             ...(e.data as object),
-        } as ArciumEventData;
+        } as ComputationEventData;
 
         if (e.data.mxe_program_id) {
             eventData.mxeProgramId = e.data.mxe_program_id as PublicKey;

package/src/constants.ts

@@ -1,12 +1,13 @@
 import { ArciumIdlType, ARCIUM_IDL, ARCIUM_ADDR } from '@arcium-hq/client';
-import * as anchor from '@coral-xyz/anchor';
+import * as anchor from '@anchor-lang/core';
 import {
     ArciumEventName, CallbackComputationIx, PublicKey, QueueComputationIx,
 } from './types.js';
 
-type ArciumArxNodeAccount = ArciumIdlType['accounts']['0'];
-type ArciumClusterAccount = ArciumIdlType['accounts']['2'];
-type ArciumMXEAccount = ArciumIdlType['accounts']['10'];
+type FindAccount<Name extends string> = Extract<ArciumIdlType['accounts'][number], { name: Name }>;
+type ArciumArxNodeAccount = FindAccount<'arxNode'>;
+type ArciumClusterAccount = FindAccount<'cluster'>;
+type ArciumMXEAccount = FindAccount<'mxeAccount'>;
 
 /**
  * Prefix for program data logs in Solana transaction logs.

package/src/types.ts

@@ -3,7 +3,7 @@
  * 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';
+import * as anchor from '@anchor-lang/core';
 
 /**
  * Solana PublicKey type alias for convenience.
@@ -25,6 +25,12 @@ export type Program<T extends anchor.Idl> = anchor.Program<T>;
  */
 export type ArciumTypes = anchor.IdlTypes<ArciumIdlType>;
 
+/**
+ * Finds an instruction type from the Arcium IDL by name,
+ * avoiding fragile hardcoded numeric indices.
+ */
+export type FindInstruction<Name extends string> = Extract<ArciumIdlType['instructions'][number], { name: Name }>;
+
 /**
  * All events emitted by the Arcium program, keyed by event name.
  */
@@ -40,6 +46,16 @@ export type ArciumEventName = Capitalize<keyof ArciumEvent>;
  */
 export type ArciumEventData = ArciumEvent[keyof ArciumEvent];
 
+/**
+ * Computation event names that all have computationOffset field.
+ */
+export type ComputationEventName = 'queueComputationEvent' | 'initComputationEvent' | 'callbackComputationEvent' | 'finalizeComputationEvent';
+
+/**
+ * Data structure for computation events (events that have computationOffset).
+ */
+export type ComputationEventData = ArciumEvent[ComputationEventName];
+
 /**
  * MXE (Multi-party eXecution Environment) account data structure.
  */
@@ -83,12 +99,12 @@ export type ComputationDefinitionAccount = ArciumTypes['computationDefinitionAcc
 /**
  * Queue computation instruction type from the Arcium IDL.
  */
-export type QueueComputationIx = ArciumIdlType['instructions']['38'];
+export type QueueComputationIx = FindInstruction<'queueComputation'>;
 
 /**
  * Callback computation instruction type from the Arcium IDL.
  */
-export type CallbackComputationIx = ArciumIdlType['instructions']['4'];
+export type CallbackComputationIx = FindInstruction<'callbackComputation'>;
 
 /**
  * Valid instruction names from the Arcium IDL.