@arcium-hq/client 0.9.2 → 0.9.3

package/build/{index.d.ts → types/idl/arcium.d.ts}

@@ -1,553 +1,14 @@
-import { IField } from '@noble/curves/abstract/modular';
-import { CurveFn } from '@noble/curves/abstract/edwards';
-import * as anchor from '@coral-xyz/anchor';
-import { AnchorProvider, Program, BN } from '@coral-xyz/anchor';
-import { PublicKey, ConfirmOptions, Finality } from '@solana/web3.js';
-export { x25519 } from '@noble/curves/ed25519';
-
-/**
- * Scalar field prime modulus for Curve25519: 2^252 + 27742317777372353535851937790883648493
- */
-declare const CURVE25519_SCALAR_FIELD_MODULUS: bigint;
-/**
- * Generate a random value within the field bound by q.
- * @param q - Upper bound (exclusive) for the random value.
- * @returns Random bigint value between 0 and q-1.
- */
-declare function generateRandomFieldElem(q: bigint): bigint;
-/**
- * Compute the positive modulo of a over m.
- * @param a - Dividend.
- * @param m - Modulus.
- * @returns Positive remainder of a mod m.
- */
-declare function positiveModulo(a: bigint, m: bigint): bigint;
-/**
- * Serialize a bigint to a little-endian Uint8Array of the specified length.
- * @param val - Bigint value to serialize.
- * @param lengthInBytes - Desired length of the output array.
- * @returns Serialized value as a Uint8Array.
- * @throws Error if the value is too large for the specified length.
- */
-declare function serializeLE(val: bigint, lengthInBytes: number): Uint8Array;
-/**
- * Deserialize a little-endian Uint8Array to a bigint.
- * @param bytes - Uint8Array to deserialize.
- * @returns Deserialized bigint value.
- */
-declare function deserializeLE(bytes: Uint8Array): bigint;
-/**
- * Compute the SHA-256 hash of an array of Uint8Arrays.
- * @param byteArrays - Arrays to hash.
- * @returns SHA-256 hash as a Buffer.
- */
-declare function sha256(byteArrays: Uint8Array[]): Buffer;
-
-/**
- * Matrix operations for MPC field arithmetic.
- * Used internally by Rescue cipher. Not part of public API.
- * @internal
- */
-declare class Matrix {
-    field: FpField;
-    data: readonly bigint[][];
-    constructor(field: FpField, data: readonly bigint[][]);
-    /**
-     * Matrix multiplication between `this` and `rhs`.
-     */
-    matMul(rhs: Matrix): Matrix;
-    /**
-     * Element-wise addition between `this` and `rhs`.
-     */
-    add(rhs: Matrix, ct?: boolean): Matrix;
-    /**
-     * Element-wise subtraction between `this` and `rhs`.
-     */
-    sub(rhs: Matrix, ct?: boolean): Matrix;
-    /**
-     * Raises each element of `this` to the power `e`.
-     */
-    pow(e: bigint): Matrix;
-    /**
-     * Compute the determinant using Gauss elimination.
-     * Match the determinant implementation in Arcis.
-     */
-    det(): bigint;
-    is_square(): boolean;
-}
-/**
- * Generate random matrix for testing.
- * @internal
- */
-declare function randMatrix(field: FpField, nrows: number, ncols: number): Matrix;
-
-/**
- * Represents the operational mode for the Rescue cryptographic primitive.
- * Can be either a block cipher mode with a key, or a hash function mode with parameters.
- */
-type RescueMode = BlockCipher | HashFunction;
-/**
- * Block cipher mode configuration for Rescue.
- * Use a key for encryption/decryption operations.
- */
-type BlockCipher = {
-    kind: 'cipher';
-    key: bigint[];
-};
-/**
- * Hash function mode configuration for Rescue.
- * @param m - Rate (number of field elements absorbed per round).
- * @param capacity - Capacity (number of field elements in the state that are not directly accessible).
- */
-type HashFunction = {
-    kind: 'hash';
-    m: number;
-    capacity: number;
-};
-/**
- * Field type.
- */
-type FpField = IField<bigint>;
-/**
- * Curve25519 base field as an IField instance.
- */
-declare const CURVE25519_BASE_FIELD: FpField;
-/**
- * Curve25519 scalar field as an IField instance.
- */
-declare const CURVE25519_SCALAR_FIELD: FpField;
-/**
- * Description and parameters for the Rescue cipher or hash function, including round constants, MDS matrix, and key schedule.
- * See: https://tosc.iacr.org/index.php/ToSC/article/view/8695/8287
- */
-declare class RescueDesc {
-    mode: RescueMode;
-    field: FpField;
-    alpha: bigint;
-    alphaInverse: bigint;
-    nRounds: number;
-    m: number;
-    mdsMat: Matrix;
-    mdsMatInverse: Matrix;
-    roundKeys: Matrix[];
-    /**
-     * Construct a RescueDesc for a given field and mode (cipher or hash).
-     * Initialize round constants, MDS matrix, and key schedule.
-     * @param field - Field to use (e.g., CURVE25519_BASE_FIELD).
-     * @param mode - Mode: block cipher or hash function.
-     */
-    constructor(field: FpField, mode: RescueMode);
-    /**
-     * Sample round constants for the Rescue permutation, using SHAKE256.
-     * @param nRounds - Number of rounds.
-     * @returns Array of round constant matrices.
-     */
-    sampleConstants(nRounds: number): Matrix[];
-    /**
-     * Apply the Rescue permutation to a state matrix.
-     * @param state - Input state matrix.
-     * @returns Permuted state matrix.
-     */
-    permute(state: Matrix): Matrix;
-    /**
-     * Apply the inverse Rescue permutation to a state matrix.
-     * @param state - Input state matrix.
-     * @returns Inverse-permuted state matrix.
-     */
-    permuteInverse(state: Matrix): Matrix;
-}
-declare function toVec(data: bigint[]): bigint[][];
-
-/**
- * The Rescue cipher in Counter (CTR) mode, with a fixed block size m = 5.
- * See: https://tosc.iacr.org/index.php/ToSC/article/view/8695/8287
- */
-declare class RescueCipherCommon {
-    desc: RescueDesc;
-    /**
-     * Construct a RescueCipherCommon instance using a shared secret.
-     * The key is derived using RescuePrimeHash and used to initialize the RescueDesc.
-     * @param sharedSecret - Shared secret to derive the cipher key from.
-     */
-    constructor(sharedSecret: Uint8Array, field: FpField);
-    /**
-     * Encrypt the plaintext vector in Counter (CTR) mode (raw, returns bigints).
-     * @param plaintext - Array of plaintext bigints to encrypt.
-     * @param nonce - 16-byte nonce for CTR mode.
-     * @returns Ciphertext as an array of bigints.
-     * @throws Error if the nonce is not 16 bytes long.
-     */
-    encrypt_raw(plaintext: bigint[], nonce: Uint8Array): bigint[];
-    /**
-     * Encrypt the plaintext vector in Counter (CTR) mode and serialize each block.
-     * @param plaintext - Array of plaintext bigints to encrypt.
-     * @param nonce - 16-byte nonce for CTR mode.
-     * @returns Ciphertext as an array of arrays of numbers (each 32 bytes).
-     */
-    encrypt(plaintext: bigint[], nonce: Uint8Array): number[][];
-    /**
-     * Decrypt the ciphertext vector in Counter (CTR) mode (raw, expects bigints).
-     * @param ciphertext - Array of ciphertext bigints to decrypt.
-     * @param nonce - 16-byte nonce for CTR mode.
-     * @returns Decrypted plaintext as an array of bigints.
-     * @throws Error if the nonce is not 16 bytes long.
-     */
-    decrypt_raw(ciphertext: bigint[], nonce: Uint8Array): bigint[];
-    /**
-     * Deserialize and decrypt the ciphertext vector in Counter (CTR) mode.
-     * @param ciphertext - Array of arrays of numbers (each 32 bytes) to decrypt.
-     * @param nonce - 16-byte nonce for CTR mode.
-     * @returns Decrypted plaintext as an array of bigints.
-     */
-    decrypt(ciphertext: number[][], nonce: Uint8Array): bigint[];
-}
-
-/**
- * The Rescue cipher over Curve25519's base field in Counter (CTR) mode, with a fixed block size m = 5.
- * See: https://tosc.iacr.org/index.php/ToSC/article/view/8695/8287
- */
-declare class RescueCipher {
-    cipher: RescueCipherCommon;
-    /**
-     * Construct a RescueCipher instance using a shared secret.
-     * The key is derived using RescuePrimeHash and used to initialize the RescueDesc.
-     * @param sharedSecret - Shared secret to derive the cipher key from.
-     */
-    constructor(sharedSecret: Uint8Array);
-    /**
-     * Encrypt the plaintext vector in Counter (CTR) mode and serialize each block.
-     * @param plaintext - Array of plaintext bigints to encrypt.
-     * @param nonce - 16-byte nonce for CTR mode.
-     * @returns Ciphertext as an array of arrays of numbers (each 32 bytes).
-     */
-    encrypt(plaintext: bigint[], nonce: Uint8Array): number[][];
-    /**
-     * Deserialize and decrypt the ciphertext vector in Counter (CTR) mode.
-     * @param ciphertext - Array of arrays of numbers (each 32 bytes) to decrypt.
-     * @param nonce - 16-byte nonce for CTR mode.
-     * @returns Decrypted plaintext as an array of bigints.
-     */
-    decrypt(ciphertext: number[][], nonce: Uint8Array): bigint[];
-}
-
-/**
- * The Rescue cipher over Curve25519's scalar field in Counter (CTR) mode, with a fixed block size m = 5.
- * See: https://tosc.iacr.org/index.php/ToSC/article/view/8695/8287
- */
-declare class CSplRescueCipher {
-    cipher: RescueCipherCommon;
-    /**
-     * Construct a CSplRescueCipher instance using a shared secret.
-     * The key is derived using RescuePrimeHash and used to initialize the RescueDesc.
-     * @param sharedSecret - Shared secret to derive the cipher key from.
-     */
-    constructor(sharedSecret: Uint8Array);
-    /**
-     * Encrypt the plaintext vector in Counter (CTR) mode and serialize each block.
-     * @param plaintext - Array of plaintext bigints to encrypt.
-     * @param nonce - 16-byte nonce for CTR mode.
-     * @returns Ciphertext as an array of arrays of numbers (each 32 bytes).
-     */
-    encrypt(plaintext: bigint[], nonce: Uint8Array): number[][];
-    /**
-     * Deserialize and decrypt the ciphertext vector in Counter (CTR) mode.
-     * @param ciphertext - Array of arrays of numbers (each 32 bytes) to decrypt.
-     * @param nonce - 16-byte nonce for CTR mode.
-     * @returns Decrypted plaintext as an array of bigints.
-     */
-    decrypt(ciphertext: number[][], nonce: Uint8Array): bigint[];
-}
-
-/**
- * The Rescue-Prime hash function, as described in https://eprint.iacr.org/2020/1143.pdf, offering 256 bits
- * of security against collision, preimage and second-preimage attacks for any field of size at least 102 bits.
- * We use the sponge construction with fixed rate = 7 and capacity = 5 (i.e., m = 12), and truncate the
- * output to 5 field elements.
- */
-declare class RescuePrimeHash {
-    desc: RescueDesc;
-    rate: number;
-    digestLength: number;
-    /**
-     * Construct a RescuePrimeHash instance with rate = 7 and capacity = 5.
-     */
-    constructor(field: FpField);
-    /**
-     * Compute the Rescue-Prime hash of a message, with padding as described in Algorithm 2 of the paper.
-     * @param message - Input message as an array of bigints.
-     * @returns Hash output as an array of bigints (length = digestLength).
-     */
-    digest(message: bigint[]): bigint[];
-}
-
-/**
- * Ed25519 curve instance using SHA3-512 for hashing, suitable for MPC (ArcisEd25519 signature scheme).
- * This is essentially Ed25519 but with SHA3-512 instead of SHA-512 for lower multiplicative depth.
- * See: https://datatracker.ietf.org/doc/html/rfc8032#section-5.1
- */
-declare const arcisEd25519: CurveFn;
-
-/**
- * Supported AES key sizes in bits.
- */
-type AesKeyBits = 128 | 192 | 256;
-/**
- * Generic AES cipher in Counter (CTR) mode, using SHA3-256 to derive the key from a shared secret.
- * See: https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38a.pdf (Section 6.5) for details on CTR mode.
- */
-declare class AesCtrCipher {
-    protected key: Uint8Array;
-    private readonly keyBits;
-    /**
-     * Construct an AES cipher instance using a shared secret.
-     * The key is derived using SHA3-256.
-     * @param sharedSecret - Shared secret to derive the AES key from.
-     * @param keyBits - AES key size in bits (128, 192, or 256).
-     */
-    constructor(sharedSecret: Uint8Array, keyBits: AesKeyBits);
-    /**
-     * Encrypt the plaintext array in Counter (CTR) mode.
-     * @param plaintext - Data to encrypt.
-     * @param nonce - 8-byte nonce for CTR mode.
-     * @returns Encrypted ciphertext as a Uint8Array.
-     * @throws Error if the nonce is not 8 bytes long.
-     */
-    encrypt(plaintext: Uint8Array, nonce: Uint8Array): Uint8Array;
-    /**
-     * Decrypt the ciphertext array in Counter (CTR) mode.
-     * @param ciphertext - Data to decrypt.
-     * @param nonce - 8-byte nonce for CTR mode.
-     * @returns Decrypted plaintext as a Uint8Array.
-     * @throws Error if the nonce is not 8 bytes long.
-     */
-    decrypt(ciphertext: Uint8Array, nonce: Uint8Array): Uint8Array;
-}
-
-/**
- * AES-128 cipher in Counter (CTR) mode, using SHA3-256 to derive the key from a shared secret.
- * See: https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38a.pdf (Section 6.5) for details on CTR mode.
- */
-declare class Aes128Cipher extends AesCtrCipher {
-    /**
-     * Construct an AES-128 cipher instance using a shared secret.
-     * The key is derived using SHA3-256.
-     * @param sharedSecret - Shared secret to derive the AES key from.
-     */
-    constructor(sharedSecret: Uint8Array);
-}
-
-/**
- * AES-192 cipher in Counter (CTR) mode, using SHA3-256 to derive the key from a shared secret.
- * See: https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38a.pdf (Section 6.5) for details on CTR mode.
- */
-declare class Aes192Cipher extends AesCtrCipher {
-    /**
-     * Construct an AES-192 cipher instance using a shared secret.
-     * The key is derived using SHA3-256.
-     * @param sharedSecret - Shared secret to derive the AES key from.
-     */
-    constructor(sharedSecret: Uint8Array);
-}
-
-/**
- * AES-256 cipher in Counter (CTR) mode, using SHA3-256 to derive the key from a shared secret.
- * See: https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38a.pdf (Section 6.5) for details on CTR mode.
- */
-declare class Aes256Cipher extends AesCtrCipher {
-    /**
-     * Construct an AES-256 cipher instance using a shared secret.
-     * The key is derived using SHA3-256.
-     * @param sharedSecret - Shared secret to derive the AES key from.
-     */
-    constructor(sharedSecret: Uint8Array);
-}
-
-/**
- * Size descriptor for a single field in circuit packing.
- * A "full" field occupies an entire slot; partial fields are bin-packed together.
- * @internal
- */
-declare class DataSize {
-    /** Whether this field occupies a full slot. */
-    isFull: boolean;
-    /** Bit width of the field (0 if full). */
-    size: number;
-    /** Original index in the fields array. */
-    index: number;
-    constructor(index: number, size?: number);
-}
-
-/**
- * Field definition for circuit input/output packing.
- * Pass an array of these to {@link createPacker} to create a type-safe packer.
- *
- * @example
- * import { FieldInfo } from '@arcium-hq/client';
- *
- * const fields: FieldInfo[] = [
- *   { name: 'amount', type: { Integer: { signed: false, width: 64 } } },
- *   { name: 'active', type: 'Bool' },
- * ];
- */
-interface FieldInfo {
-    /** Field name matching the circuit parameter. For array types, use indexed notation (`bytes[0]`, `bytes[1]`) - the packer groups these back into arrays on unpack. */
-    name: string;
-    /** Field type: Integer with sign/width, Bool, FullInteger (256-bit), Float, or Pubkey. */
-    type: {
-        Integer: {
-            signed: boolean;
-            width: number;
-        };
-    } | 'Bool' | 'FullInteger' | 'Float' | 'Pubkey';
-}
-declare enum ArcisValueKind {
-    Integer = 0,
-    FullInteger = 1,
-    Bool = 2,
-    Float = 3,
-    Pubkey = 4
-}
-/**
- * Integer type metadata. Used internally by packer.
- * @internal
- */
-declare class IntegerInfo {
-    signed: boolean;
-    width: bigint;
-    constructor(signed: boolean, width: bigint);
-    static fromJson(json: {
-        "signed": boolean;
-        "width": number;
-    }): IntegerInfo;
-    minValue(): bigint;
-    isWithinBounds(b: bigint): boolean;
-    name(): string;
-}
-/**
- * Runtime field representation. Used internally by packer.
- * @internal
- */
-declare class ArcisValueField {
-    name: string;
-    kind: ArcisValueKind;
-    info: IntegerInfo | undefined;
-    constructor(name: string, kind: ArcisValueKind, info?: IntegerInfo);
-    static fromJson(json: unknown): ArcisValueField;
-    toBigInt(arg: unknown): bigint;
-    fromBigInt(arg: bigint): boolean | number | bigint | Uint8Array;
-    static fromFieldInfo(info: FieldInfo): ArcisValueField;
-    toDataSize(index: number): DataSize;
-}
-/**
- * Type container for pack/unpack operations. Used internally by packer.
- * @internal
- */
-declare class ArcisType {
-    name: string;
-    fields: ArcisValueField[];
-    constructor(name: string, fields: ArcisValueField[]);
-    pack(rawData: unknown[]): bigint[];
-    unpack(packed: bigint[]): (boolean | number | bigint | Uint8Array)[];
-    static fromJson(name: string, json: unknown): ArcisType;
-}
-
-/**
- * Container for circuit type definitions.
- * Loaded from generated JSON files by build tools -- not typically used directly.
- * @internal
- */
-declare class ArcisModule {
-    /** Map of type name to parsed ArcisType. */
-    types: {
-        [typeName: string]: ArcisType;
-    };
-    constructor(types: {
-        [typeName: string]: ArcisType;
-    });
-    /**
-     * Parse module from JSON object (as produced by the Arcium compiler).
-     * @param json - Raw JSON object with type name keys.
-     */
-    static fromJson(json: unknown): ArcisModule;
-    /**
-     * Load module from a JSON file on disk.
-     * @param path - Absolute or relative path to the JSON file.
-     */
-    static loadFromFile(path: string): ArcisModule;
-}
-
-/**
- * Type-safe packer for converting between TypeScript objects and circuit-compatible bigint arrays.
- *
- * @template TInput - Input object type with field names as keys
- * @template TOutput - Output object type (typically same structure as input)
- */
-interface Packer<TInput, TOutput> {
-    /**
-     * Pack input values into bigint array for circuit execution.
-     * @param data - Object with field values matching the packer's field definitions.
-     * @returns Packed bigint array ready for encryption.
-     * @throws Error if a required field is missing.
-     */
-    pack(data: TInput): bigint[];
-    /**
-     * Unpack circuit output back to typed object.
-     * @param packed - Bigint array from decrypted circuit output.
-     * @returns Typed object with field values.
-     */
-    unpack(packed: bigint[]): TOutput;
-}
-/** Extracts base field name from array-indexed names: "bytes[0]" -> "bytes" */
-type ExtractBaseName<T extends string> = T extends `${infer Base}[${string}]` ? Base : T;
-/** Extracts all base field names from a readonly FieldInfo array. */
-type FieldBaseNames<T extends readonly FieldInfo[]> = ExtractBaseName<T[number]['name']>;
-/**
- * Validates that field base names match TInput keys. Returns `never` on mismatch.
- * Only validates when using `as const`; skipped if types widen to `string`.
- */
-type ValidateFieldNames<TInput, TFields extends readonly FieldInfo[]> = string extends FieldBaseNames<TFields> ? TFields : FieldBaseNames<TFields> extends keyof TInput ? TFields : never;
-/**
- * Create a type-safe packer from field definitions.
- *
- * Use `as const` on the fields array to enable compile-time field name validation.
- *
- * @param fields - Array of {@link FieldInfo} objects defining each field's name and type.
- * @param typeName - Optional name for debugging (default: 'Packer').
- * @returns Packer instance with pack() and unpack() methods.
- * @throws TypeError if field types don't match expected values during pack/unpack.
- * @throws RangeError if array index is out of bounds.
- *
- * @example
- * import { createPacker } from '@arcium-hq/client';
- *
- * // Define fields matching your circuit's input type
- * const fields = [
- *   { name: 'a', type: { Integer: { signed: false, width: 32 } } },
- *   { name: 'b', type: { Integer: { signed: false, width: 32 } } },
- * ] as const;
- *
- * // Create packer with explicit input/output types
- * const packer = createPacker<{ a: number; b: number }, { a: bigint; b: bigint }>(fields);
- *
- * // Pack values for circuit input
- * const packed = packer.pack({ a: 10, b: 20 });
- *
- * // Unpack circuit output (from decrypted computation result)
- * const result = packer.unpack(decryptedOutput);
- */
-declare function createPacker<TInput extends Record<string, unknown>, TOutput extends Record<string, unknown>, const TFields extends readonly FieldInfo[] = readonly FieldInfo[]>(fields: TFields & ValidateFieldNames<TInput, TFields>, typeName?: string): Packer<TInput, TOutput>;
-
 /**
  * Program IDL in camelCase format in order to be used in JS/TS.
  *
  * Note that this is only a type helper and is not the actual IDL. The original
  * IDL can be found at `target/idl/arcium.json`.
  */
-type Arcium = {
+export type Arcium = {
     "address": "Arcj82pX7HxYKLR92qvgZUAd7vGS1k4hQvAFcPATFdEQ";
     "metadata": {
         "name": "arcium";
-        "version": "0.9.2";
+        "version": "0.9.3";
         "spec": "0.1.0";
         "description": "The Arcium program";
     };
@@ -10866,7 +10327,7 @@ type Arcium = {
                                         "name": "acccountAccessInfo";
                                     };
                                 },
-                                13
+                                15
                             ];
                         };
                     },
@@ -10875,7 +10336,7 @@ type Arcium = {
                         "type": {
                             "array": [
                                 "u8",
-                                6
+                                2
                             ];
                         };
                     }
@@ -12824,361 +12285,4 @@ type Arcium = {
         }
     ];
 };
-
-declare const ARCIUM_IDL: Arcium;
-/**
- * The deployed address of the Arcium program, as specified in the IDL.
- */
-declare const ARCIUM_ADDR: "Arcj82pX7HxYKLR92qvgZUAd7vGS1k4hQvAFcPATFdEQ";
-
-/**
- * Reference to a computation in a mempool or executing pool.
- * Contains the computation offset and priority fee information.
- */
-type ComputationReference = anchor.IdlTypes<Arcium>['computationReference'];
-/**
- * Check if a computation reference is null (all zeros).
- * @param ref - Computation reference to check.
- * @returns true if the reference is null, false otherwise.
- */
-declare function isNullRef(ref: ComputationReference): boolean;
-
-/**
- * Represents a mempool account of any size (tiny, small, medium, or large).
- * Mempools store pending computations prioritized by fee, with a time-to-live of 180 slots.
- * Each size supports different maximum heap capacities:
- * - Tiny: 1 computation
- * - Small: 3 computations
- * - Medium: 10 computations
- * - Large: 100 computations
- */
-type MempoolAccount = anchor.IdlTypes<Arcium>['tinyMempool'] | anchor.IdlTypes<Arcium>['smallMempool'] | anchor.IdlTypes<Arcium>['mediumMempool'] | anchor.IdlTypes<Arcium>['largeMempool'];
-/**
- * Represents an executing pool account of any size (tiny, small, medium, or large).
- * Executing pools manage parallel computation execution with account locking.
- * Each size supports different maximum parallel computations:
- * - Tiny: 1 parallel computation
- * - Small: 3 parallel computations
- * - Medium: 10 parallel computations
- * - Large: 100 parallel computations
- */
-type ExecutingPoolAccount = anchor.IdlTypes<Arcium>['tinyExecPool'] | anchor.IdlTypes<Arcium>['smallExecPool'] | anchor.IdlTypes<Arcium>['mediumExecPool'] | anchor.IdlTypes<Arcium>['largeExecPool'];
-/**
- * IDL-generated type for circuit source location.
- * Discriminated union with variants: local, onChain, offChain.
- */
-type CircuitSource = anchor.IdlTypes<Arcium>['circuitSource'];
-/**
- * Fetch and decode the mempool account info for any mempool account size.
- * @param provider - Anchor provider to use for fetching accounts.
- * @param mempoolAccPubkey - Public key of the mempool account.
- * @returns Decoded mempool account info.
- * @throws Error if the account cannot be fetched or the discriminator is unknown.
- */
-declare function getMempoolAccInfo(provider: AnchorProvider, mempoolAccPubkey: anchor.web3.PublicKey): Promise<MempoolAccount>;
-/**
- * Fetch and decode the executing pool account info for any pool size.
- * @param provider - Anchor provider to use for fetching accounts.
- * @param executingPoolAccPubkey - Public key of the executing pool account.
- * @returns Decoded executing pool account info.
- * @throws Error if the account cannot be fetched or the discriminator is unknown.
- */
-declare function getExecutingPoolAccInfo(provider: AnchorProvider, executingPoolAccPubkey: anchor.web3.PublicKey): Promise<ExecutingPoolAccount>;
-/**
- * Return all computation references in the mempool for a given account.
- * Only non-stake computations are included.
- * @param arciumProgram - Anchor program instance.
- * @param address - Public key of the mempool account.
- * @returns Array of ComputationReference objects.
- */
-declare function getComputationsInMempool(arciumProgram: anchor.Program<Arcium>, address: PublicKey): Promise<ComputationReference[]>;
-/**
- * Statistics about priority fees for computations in a mempool.
- * @property mean - Average priority fee across all computations.
- * @property median - Middle value of priority fees when sorted.
- * @property min - Lowest priority fee in the mempool.
- * @property max - Highest priority fee in the mempool.
- * @property count - Total number of computations in the mempool.
- */
-interface MempoolPriorityFeeStats {
-    mean: anchor.BN;
-    median: anchor.BN;
-    min: anchor.BN;
-    max: anchor.BN;
-    count: number;
-}
-/**
- * Calculate priority fee statistics for computations in a mempool.
- * @param arciumProgram - Anchor program instance.
- * @param mempoolAddress - Public key of the mempool account.
- * @returns Priority fee statistics (mean, median, min, max, count).
- */
-declare function getMempoolPriorityFeeStats(arciumProgram: anchor.Program<Arcium>, mempoolAddress: PublicKey): Promise<MempoolPriorityFeeStats>;
-/**
- * Fetch and extract the MXE X25519 public key from the MXE account.
- * @param provider - Anchor provider to use for fetching accounts.
- * @param mxeProgramId - Public key of the MXE program.
- * @returns MXE's X25519 public key as a Uint8Array, or null if not set.
- */
-declare function getMXEPublicKey(provider: AnchorProvider, mxeProgramId: anchor.web3.PublicKey): Promise<Uint8Array | null>;
-/**
- * Fetch and extract the MXE arcis Ed25519 verifying key from the MXE account.
- * @param provider - Anchor provider to use for fetching accounts.
- * @param mxeProgramId - Public key of the MXE program.
- * @returns MXE's arcis Ed25519 verifying key as a Uint8Array, or null if not set.
- */
-declare function getMXEArcisEd25519VerifyingKey(provider: AnchorProvider, mxeProgramId: anchor.web3.PublicKey): Promise<Uint8Array | null>;
-/**
- * Represents the current state of a circuit's on-chain presence.
- * @internal Used by `uploadCircuit` - most users don't need this directly.
- */
-type CircuitState = 'OnchainPending' | 'OnchainFinalized' | 'Offchain';
-/**
- * Determine the current state of a circuit based on its on-chain configuration.
- * @internal Called internally by `uploadCircuit` - most users don't need this directly.
- * @param circuitSource - circuitSource field from ComputationDefinitionAccount.
- * @returns Current state of the circuit.
- */
-declare function getCircuitState(circuitSource: CircuitSource): CircuitState;
-/**
- * Upload a circuit to the blockchain, splitting it into multiple accounts if necessary.
- * @param provider - Anchor provider to use for transactions.
- * @param circuitName - Name of the circuit.
- * @param mxeProgramId - Public key of the MXE program.
- * @param rawCircuit - Raw circuit data as a Uint8Array.
- * @param logging - Whether to log progress (default: true).
- * @param chunkSize - Number of upload transactions to send in parallel (default: 500).
- * @param confirmOptions - Transaction confirmation options.
- * @returns Array of transaction signatures for all upload and finalize transactions.
- */
-declare function uploadCircuit(provider: AnchorProvider, circuitName: string, mxeProgramId: anchor.web3.PublicKey, rawCircuit: Uint8Array, logging?: boolean, chunkSize?: number, confirmOptions?: ConfirmOptions): Promise<string[]>;
-/**
- * Queue a key recovery initialization for an MXE on a given cluster.
- * @param provider - Anchor provider for signing and sending.
- * @param clusterOffset - Cluster offset to recover keys from.
- * @param mxeProgramId - Public key of the MXE program.
- * @param confirmOptions - Transaction confirmation options.
- * @returns Array of transaction signatures.
- */
-declare function queueKeyRecoveryInit(provider: AnchorProvider, clusterOffset: number, mxeProgramId: anchor.web3.PublicKey, confirmOptions?: ConfirmOptions): Promise<string[]>;
-/**
- * Build a transaction to finalize a computation definition.
- * @param provider - Anchor provider to use for transactions.
- * @param compDefOffset - Offset of the computation definition.
- * @param mxeProgramId - Public key of the MXE program.
- * @returns Transaction to finalize the computation definition.
- */
-declare function buildFinalizeCompDefTx(provider: AnchorProvider, compDefOffset: number, mxeProgramId: anchor.web3.PublicKey): Promise<anchor.web3.Transaction>;
-/**
- * Return the base seed for an Arcium account, given its name.
- * @param accName - Name of the account.
- * @returns Base seed as a Uint8Array.
- */
-declare function getArciumAccountBaseSeed(accName: string): Uint8Array;
-/**
- * Compute the offset for a computation definition account, based on the circuit name.
- * @param circuitName - Name of the circuit.
- * @returns Offset as a 4-byte Uint8Array.
- */
-declare function getCompDefAccOffset(circuitName: string): Uint8Array;
-/**
- * Return an Anchor program instance for the Arcium program.
- * @param provider - Anchor provider to use.
- * @returns Anchor program instance for Arcium.
- */
-declare function getArciumProgram(provider: AnchorProvider): Program<Arcium>;
-/**
- * Set an MXE to Recovery status, initiating the key recovery process.
- * @param provider - Anchor provider to use for transactions.
- * @param mxeProgramId - Public key of the MXE program to recover.
- * @param confirmOptions - Transaction confirmation options.
- * @returns Transaction signature.
- */
-declare function recoverMxe(provider: AnchorProvider, mxeProgramId: anchor.web3.PublicKey, confirmOptions?: ConfirmOptions): Promise<string>;
-/**
- * Initialize key recovery execution by creating the MxeRecoveryAccount and
- * registering the key_recovery_final computation definition on the backup MXE.
- * This is split into two parts due to Solana's 10KB per-instruction allocation limit.
- * @param provider - Anchor provider to use for transactions.
- * @param originalMxeProgramId - Public key of the original MXE program being recovered.
- * @param backupMxeProgramId - Public key of the backup MXE program that will take over.
- * @param confirmOptions - Transaction confirmation options.
- * @returns Transaction signature from part2.
- */
-declare function initKeyRecoveryExecution(provider: AnchorProvider, originalMxeProgramId: anchor.web3.PublicKey, backupMxeProgramId: anchor.web3.PublicKey, confirmOptions?: ConfirmOptions): Promise<string>;
-/**
- * Submit a re-encrypted key recovery share from a recovery peer.
- * Recovery peers must decrypt shares using their x25519 private key and re-encrypt
- * them for the backup MXE before submission.
- * @param provider - Anchor provider to use for transactions.
- * @param originalMxeProgramId - Public key of the original MXE program being recovered.
- * @param backupMxeProgramId - Public key of the backup MXE program.
- * @param peerOffset - Offset of the recovery peer.
- * @param peerIndex - Index of this peer in the recovery peers list.
- * @param share - Re-encrypted share: 5 field elements of 32 bytes each (160 bytes total).
- * @param confirmOptions - Transaction confirmation options.
- * @returns Transaction signature.
- */
-declare function submitKeyRecoveryShare(provider: AnchorProvider, originalMxeProgramId: anchor.web3.PublicKey, backupMxeProgramId: anchor.web3.PublicKey, peerOffset: number, peerIndex: number, share: number[][] | Uint8Array[], confirmOptions?: ConfirmOptions): Promise<string>;
-/**
- * Finalize key recovery execution after the submission threshold is met.
- * This queues the key_recovery_finalize MPC computation on the backup cluster.
- * @param provider - Anchor provider to use for transactions.
- * @param originalMxeProgramId - Public key of the original MXE program being recovered.
- * @param backupMxeProgramId - Public key of the backup MXE program.
- * @param clusterOffset - Cluster offset where the backup MXE is deployed.
- * @param keyRecoveryFinalizeOffset - Computation offset for the key_recovery_finalize computation.
- * @param confirmOptions - Transaction confirmation options.
- * @returns Transaction signature.
- */
-declare function finalizeKeyRecoveryExecution(provider: AnchorProvider, originalMxeProgramId: anchor.web3.PublicKey, backupMxeProgramId: anchor.web3.PublicKey, clusterOffset: number, keyRecoveryFinalizeOffset: anchor.BN, confirmOptions?: ConfirmOptions): Promise<string>;
-/**
- * Initialize an MXE (part 1). Due to Solana's 10KB per-instruction allocation limit,
- * this only partially allocates recovery_cluster_acc.
- * Call initMxePart2 afterwards to finish allocation and add keygen to mempool.
- * @param provider - Anchor provider to use for transactions.
- * @param mxeProgramId - Public key to use as the MXE program ID.
- * @param confirmOptions - Transaction confirmation options.
- * @returns Transaction signature.
- */
-declare function initMxePart1(provider: AnchorProvider, mxeProgramId: anchor.web3.PublicKey, confirmOptions?: ConfirmOptions): Promise<string>;
-/**
- * Finish MXE initialization (part 2).
- * Reallocate recovery_cluster_acc to full size, initialize recovery_peers,
- * and add the keygen computation to the mempool.
- * @param provider - Anchor provider to use for transactions.
- * @param clusterOffset - Cluster offset to associate with the MXE.
- * @param mxeProgramId - Public key to use as the MXE program ID.
- * @param recoveryPeers - Array of 100 node offsets for recovery peers (0 for unused slots).
- * @param keygenOffset - Computation offset for the keygen computation.
- * @param keyRecoveryInitOffset - Computation offset for the key_recovery_init computation.
- * @param lutOffset - Lookup table offset for the MXE's address lookup table.
- * @param mxeAuthority - Optional authority for the MXE (defaults to provider.publicKey).
- * @param confirmOptions - Transaction confirmation options.
- * @returns Transaction signature.
- */
-declare function initMxePart2(provider: AnchorProvider, clusterOffset: number, mxeProgramId: anchor.web3.PublicKey, recoveryPeers: number[], keygenOffset: anchor.BN, keyRecoveryInitOffset: anchor.BN, lutOffset: anchor.BN, mxeAuthority?: anchor.web3.PublicKey, confirmOptions?: ConfirmOptions): Promise<string>;
-
-/**
- * Structure representing the local Arcium environment variables required for local development or testing.
- */
-type ArciumLocalEnv = {
-    arciumClusterOffset: number;
-    arciumBackupClusterOffset: number;
-};
-/**
- * Read local Arcium environment information from environment variables.
- * Only available in Node.js and when testing locally.
- * @returns Local Arcium environment configuration.
- * @throws Error if called in a browser or if required environment variables are missing or invalid.
- */
-declare function getArciumEnv(): ArciumLocalEnv;
-
-/**
- * Wait for a computation to finalize by polling the computation account
- * status via HTTP RPC. Does not use WebSocket subscriptions.
- *
- * Polls every 500ms (same as Agave's send_and_confirm_transaction_with_config).
- * Return the most recent transaction signature on the computation account
- * once finalization is detected.
- *
- * @param provider - Anchor provider.
- * @param computationOffset - Computation offset to wait for.
- * @param mxeProgramId - MXE program public key.
- * @param commitment - Commitment level for RPC calls (default: 'confirmed').
- * @param timeoutMs - Maximum wait time in milliseconds (default: 120000).
- * @returns Transaction signature from the finalization.
- * @throws Error if the MXE account has no cluster assigned.
- * @throws Error if the computation does not finalize within timeoutMs.
- */
-declare function awaitComputationFinalization(provider: AnchorProvider, computationOffset: BN, mxeProgramId: PublicKey, commitment?: Finality, timeoutMs?: number): Promise<string>;
-
-/**
- * Return the public key of the deployed Arcium program on Solana.
- * @returns Arcium program's public key.
- */
-declare function getArciumProgramId(): PublicKey;
-/**
- * Derive the computation account address for a given cluster and computation offset.
- * @param clusterOffset - Offset of the cluster this computation will be executed by.
- * @param computationOffset - Computation offset as an anchor.BN.
- * @returns Derived computation account public key.
- */
-declare function getComputationAccAddress(clusterOffset: number, computationOffset: anchor.BN): PublicKey;
-/**
- * Derive the mempool account address for a given cluster.
- * @param clusterOffset - Offset of the cluster.
- * @returns Derived mempool account public key.
- */
-declare function getMempoolAccAddress(clusterOffset: number): PublicKey;
-/**
- * Derive the executing pool account address for a given cluster.
- * @param clusterOffset - Offset of the cluster.
- * @returns Derived executing pool account public key.
- */
-declare function getExecutingPoolAccAddress(clusterOffset: number): PublicKey;
-/**
- * Derive the fee pool account address.
- * @returns Derived fee pool account public key.
- */
-declare function getFeePoolAccAddress(): PublicKey;
-/**
- * Derive the clock account address.
- * @returns Derived clock account public key.
- */
-declare function getClockAccAddress(): PublicKey;
-/**
- * Derive the cluster account address for a given offset.
- * @param clusterOffset - Cluster offset as a number.
- * @returns Derived cluster account public key.
- */
-declare function getClusterAccAddress(clusterOffset: number): PublicKey;
-/**
- * Derive the ArxNode account address for a given offset.
- * @param nodeOffset - ArxNode offset as a number.
- * @returns Derived ArxNode account public key.
- */
-declare function getArxNodeAccAddress(nodeOffset: number): PublicKey;
-/**
- * Derive the MXE account address for a given MXE program ID.
- * @param mxeProgramId - Public key of the MXE program.
- * @returns Derived MXE account public key.
- */
-declare function getMXEAccAddress(mxeProgramId: PublicKey): PublicKey;
-/**
- * Derive the computation definition account address for a given MXE program ID and offset.
- * @param mxeProgramId - Public key of the MXE program.
- * @param compDefOffset - Computation definition offset as a number.
- * @returns Derived computation definition account public key.
- */
-declare function getCompDefAccAddress(mxeProgramId: PublicKey, compDefOffset: number): PublicKey;
-/**
- * Derive the recovery cluster account address for a given MXE program ID.
- * @param mxeProgramId - Public key of the MXE program.
- * @returns Derived recovery cluster account public key.
- */
-declare function getRecoveryClusterAccAddress(mxeProgramId: PublicKey): PublicKey;
-/**
- * Derive the MXE recovery account address for a key recovery session.
- * @param backupMxeProgramId - Public key of the backup MXE program that will take over.
- * @param originalMxeProgramId - Public key of the original MXE program being recovered.
- * @returns Derived MXE recovery account public key.
- */
-declare function getMxeRecoveryAccAddress(backupMxeProgramId: PublicKey, originalMxeProgramId: PublicKey): PublicKey;
-/**
- * Derive the raw circuit account address for a given computation definition and index.
- * @param compDefPubkey - Public key of the computation definition account.
- * @param rawCircuitIndex - Index of the raw circuit account (0-based).
- * @returns Derived raw circuit account public key.
- */
-declare function getRawCircuitAccAddress(compDefPubkey: PublicKey, rawCircuitIndex: number): PublicKey;
-/**
- * Derive the address lookup table address for an MXE program.
- * @param mxeProgramId - Public key of the MXE program.
- * @param lutOffset - Index of the lookup table, to be fetched from the mxe account.
- * @returns Derived address lookup table public key.
- */
-declare function getLookupTableAddress(mxeProgramId: PublicKey, lutOffset: anchor.BN): PublicKey;
-
-export { ARCIUM_ADDR, ARCIUM_IDL, Aes128Cipher, Aes192Cipher, Aes256Cipher, ArcisModule, ArcisType, ArcisValueField, CSplRescueCipher, CURVE25519_BASE_FIELD, CURVE25519_SCALAR_FIELD, CURVE25519_SCALAR_FIELD_MODULUS, IntegerInfo, Matrix, RescueCipher, RescueDesc, RescuePrimeHash, arcisEd25519, awaitComputationFinalization, buildFinalizeCompDefTx, createPacker, deserializeLE, finalizeKeyRecoveryExecution, generateRandomFieldElem, getArciumAccountBaseSeed, getArciumEnv, getArciumProgram, getArciumProgramId, getArxNodeAccAddress, getCircuitState, getClockAccAddress, getClusterAccAddress, getCompDefAccAddress, getCompDefAccOffset, getComputationAccAddress, getComputationsInMempool, getExecutingPoolAccAddress, getExecutingPoolAccInfo, getFeePoolAccAddress, getLookupTableAddress, getMXEAccAddress, getMXEArcisEd25519VerifyingKey, getMXEPublicKey, getMempoolAccAddress, getMempoolAccInfo, getMempoolPriorityFeeStats, getMxeRecoveryAccAddress, getRawCircuitAccAddress, getRecoveryClusterAccAddress, initKeyRecoveryExecution, initMxePart1, initMxePart2, isNullRef, positiveModulo, queueKeyRecoveryInit, randMatrix, recoverMxe, serializeLE, sha256, submitKeyRecoveryShare, toVec, uploadCircuit };
-export type { Arcium as ArciumIdlType, ArciumLocalEnv, CircuitSource, CircuitState, ComputationReference, ExecutingPoolAccount, FieldInfo, FpField, MempoolAccount, MempoolPriorityFeeStats, Packer };
+//# sourceMappingURL=arcium.d.ts.map