@arcium-hq/client 0.6.0 → 0.6.2

package/build/index.d.ts

@@ -297,12 +297,21 @@ declare class Aes256Cipher extends AesCtrCipher {
 }
 
 declare class DataSize {
-    is_full: boolean;
+    isFull: boolean;
     size: number;
     index: number;
     constructor(index: number, size?: number);
 }
 
+interface FieldInfo {
+    name: string;
+    type: {
+        Integer: {
+            signed: boolean;
+            width: number;
+        };
+    } | 'Bool' | 'FullInteger' | 'Float' | 'Pubkey';
+}
 declare enum ArcisValueKind {
     Integer = 0,
     FullInteger = 1,
@@ -319,7 +328,7 @@ declare class IntegerInfo {
         "width": number;
     }): IntegerInfo;
     minValue(): bigint;
-    is_within_bounds(b: bigint): boolean;
+    isWithinBounds(b: bigint): boolean;
     name(): string;
 }
 declare class ArcisValueField {
@@ -330,6 +339,7 @@ declare class ArcisValueField {
     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;
 }
 declare class ArcisType {
@@ -352,6 +362,30 @@ declare class ArcisModule {
     static loadFromFile(path: string): ArcisModule;
 }
 
+/**
+ * Type-safe packer interface for generated code.
+ */
+interface Packer<TInput, TOutput> {
+    pack(data: TInput): bigint[];
+    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;
+/**
+ * Creates a type-safe packer from field definitions.
+ * Use `as const` on the fields array for compile-time field name validation.
+ * @param fields - Field definitions from generated code.
+ * @param typeName - Type name for debugging.
+ */
+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.
  *
@@ -359,10 +393,10 @@ declare class ArcisModule {
  * IDL can be found at `target/idl/arcium.json`.
  */
 type Arcium = {
-    "address": "BpaW2ZmCJnDwizWY8eM34JtVqp2kRgnmQcedSVc9USdP";
+    "address": "Arcj82pX7HxYKLR92qvgZUAd7vGS1k4hQvAFcPATFdEQ";
     "metadata": {
         "name": "arcium";
-        "version": "0.6.0";
+        "version": "0.6.2";
         "spec": "0.1.0";
         "description": "The Arcium program";
     };
@@ -1535,18 +1569,24 @@ type Arcium = {
                             {
                                 "kind": "const";
                                 "value": [
-                                    109,
+                                    77,
                                     120,
                                     101,
-                                    95,
-                                    114,
+                                    82,
                                     101,
                                     99,
                                     111,
                                     118,
                                     101,
                                     114,
-                                    121
+                                    121,
+                                    65,
+                                    99,
+                                    99,
+                                    111,
+                                    117,
+                                    110,
+                                    116
                                 ];
                             },
                             {
@@ -2311,18 +2351,24 @@ type Arcium = {
                             {
                                 "kind": "const";
                                 "value": [
-                                    109,
+                                    77,
                                     120,
                                     101,
-                                    95,
-                                    114,
+                                    82,
                                     101,
                                     99,
                                     111,
                                     118,
                                     101,
                                     114,
-                                    121
+                                    121,
+                                    65,
+                                    99,
+                                    99,
+                                    111,
+                                    117,
+                                    110,
+                                    116
                                 ];
                             },
                             {
@@ -2666,18 +2712,24 @@ type Arcium = {
                             {
                                 "kind": "const";
                                 "value": [
-                                    109,
+                                    77,
                                     120,
                                     101,
-                                    95,
-                                    114,
+                                    82,
                                     101,
                                     99,
                                     111,
                                     118,
                                     101,
                                     114,
-                                    121
+                                    121,
+                                    65,
+                                    99,
+                                    99,
+                                    111,
+                                    117,
+                                    110,
+                                    116
                                 ];
                             },
                             {
@@ -3780,18 +3832,24 @@ type Arcium = {
                             {
                                 "kind": "const";
                                 "value": [
-                                    109,
+                                    77,
                                     120,
                                     101,
-                                    95,
-                                    114,
+                                    82,
                                     101,
                                     99,
                                     111,
                                     118,
                                     101,
                                     114,
-                                    121
+                                    121,
+                                    65,
+                                    99,
+                                    99,
+                                    111,
+                                    117,
+                                    110,
+                                    116
                                 ];
                             },
                             {
@@ -3953,18 +4011,24 @@ type Arcium = {
                             {
                                 "kind": "const";
                                 "value": [
-                                    109,
+                                    77,
                                     120,
                                     101,
-                                    95,
-                                    114,
+                                    82,
                                     101,
                                     99,
                                     111,
                                     118,
                                     101,
                                     114,
-                                    121
+                                    121,
+                                    65,
+                                    99,
+                                    99,
+                                    111,
+                                    117,
+                                    110,
+                                    116
                                 ];
                             },
                             {
@@ -6120,18 +6184,24 @@ type Arcium = {
                             {
                                 "kind": "const";
                                 "value": [
-                                    109,
+                                    77,
                                     120,
                                     101,
-                                    95,
-                                    114,
+                                    82,
                                     101,
                                     99,
                                     111,
                                     118,
                                     101,
                                     114,
-                                    121
+                                    121,
+                                    65,
+                                    99,
+                                    99,
+                                    111,
+                                    117,
+                                    110,
+                                    116
                                 ];
                             },
                             {
@@ -7360,18 +7430,24 @@ type Arcium = {
                             {
                                 "kind": "const";
                                 "value": [
-                                    109,
+                                    77,
                                     120,
                                     101,
-                                    95,
-                                    114,
+                                    82,
                                     101,
                                     99,
                                     111,
                                     118,
                                     101,
                                     114,
-                                    121
+                                    121,
+                                    65,
+                                    99,
+                                    99,
+                                    111,
+                                    117,
+                                    110,
+                                    116
                                 ];
                             },
                             {
@@ -8484,6 +8560,11 @@ type Arcium = {
             "code": 6713;
             "name": "backupClusterNotSet";
             "msg": "Backup MXE cluster is not set";
+        },
+        {
+            "code": 6714;
+            "name": "shareAlreadySubmitted";
+            "msg": "Share already submitted";
         }
     ];
     "types": [
@@ -10344,17 +10425,11 @@ type Arcium = {
                 "kind": "struct";
                 "fields": [
                     {
-                        "name": "bitmap";
+                        "name": "keyRecoveryFinalizeOffset";
                         "docs": [
-                            "Bitmap tracking which peers have uploaded their shares.",
-                            "Bit index corresponds to the index in the original MXE's recovery_peers array."
+                            "The computation offset for the queued key_recovery_finalize circuit."
                         ];
-                        "type": {
-                            "array": [
-                                "u8",
-                                13
-                            ];
-                        };
+                        "type": "u64";
                     },
                     {
                         "name": "shares";
@@ -10380,52 +10455,32 @@ type Arcium = {
                         };
                     },
                     {
-                        "name": "isFinalized";
-                        "docs": [
-                            "Whether the recovery has been finalized (threshold met and marked ready)."
-                        ];
-                        "type": "u8";
+                        "name": "originalMxePubkey";
+                        "type": "pubkey";
                     },
                     {
-                        "name": "padding1";
-                        "docs": [
-                            "Padding for u64 alignment (need 5 bytes to align key_recovery_final_offset at 8-byte",
-                            "boundary)"
-                        ];
-                        "type": {
-                            "array": [
-                                "u8",
-                                2
-                            ];
-                        };
+                        "name": "backupMxePubkey";
+                        "type": "pubkey";
                     },
                     {
-                        "name": "keyRecoveryFinalizeOffset";
+                        "name": "isFinalized";
                         "docs": [
-                            "The computation offset for the queued key_recovery_finalize circuit."
+                            "Whether the recovery has been finalized (threshold met and marked ready)."
                         ];
-                        "type": "u64";
+                        "type": "u8";
                     },
                     {
                         "name": "padding2";
                         "docs": [
-                            "Padding to ensure struct size is multiple of 8 (for zero_copy alignment after bump field)"
+                            "Padding to ensure struct size is u64 aligned (6 bytes)"
                         ];
                         "type": {
                             "array": [
                                 "u8",
-                                7
+                                6
                             ];
                         };
                     },
-                    {
-                        "name": "originalMxePubkey";
-                        "type": "pubkey";
-                    },
-                    {
-                        "name": "backupMxePubkey";
-                        "type": "pubkey";
-                    },
                     {
                         "name": "bump";
                         "type": "u8";
@@ -11337,7 +11392,7 @@ declare const ARCIUM_IDL: Arcium;
 /**
  * The deployed address of the Arcium program, as specified in the IDL.
  */
-declare const ARCIUM_ADDR: "BpaW2ZmCJnDwizWY8eM34JtVqp2kRgnmQcedSVc9USdP";
+declare const ARCIUM_ADDR: "Arcj82pX7HxYKLR92qvgZUAd7vGS1k4hQvAFcPATFdEQ";
 
 /**
  * Reference to a computation in a mempool or executing pool.
@@ -11636,5 +11691,5 @@ declare function getRecoveryClusterAccAddress(mxeProgramId: PublicKey): PublicKe
  */
 declare function getMxeRecoveryAccAddress(backupMxeProgramId: PublicKey, originalMxeProgramId: PublicKey): PublicKey;
 
-export { ARCIUM_ADDR, ARCIUM_IDL, Aes128Cipher, Aes192Cipher, Aes256Cipher, ArcisModule, ArcisType, CURVE25519_BASE_FIELD, CURVE25519_SCALAR_FIELD_MODULUS, Matrix, RescueCipher, RescueDesc, RescuePrimeHash, arcisEd25519, awaitComputationFinalization, buildFinalizeCompDefTx, deserializeLE, finalizeKeyRecoveryExecution, generateRandomFieldElem, getArciumAccountBaseSeed, getArciumEnv, getArciumProgram, getArciumProgramId, getArxNodeAccAddress, getClockAccAddress, getClusterAccAddress, getCompDefAccAddress, getCompDefAccOffset, getComputationAccAddress, getComputationsInMempool, getExecutingPoolAccAddress, getExecutingPoolAccInfo, getFeePoolAccAddress, getMXEAccAddress, getMXEArcisEd25519VerifyingKey, getMXEPublicKey, getMempoolAccAddress, getMempoolAccInfo, getMempoolPriorityFeeStats, getMxeRecoveryAccAddress, getRecoveryClusterAccAddress, initKeyRecoveryExecution, initMxePart1, initMxePart2, isNullRef, positiveModulo, queueKeyRecoveryInit, randMatrix, recoverMxe, serializeLE, sha256, submitKeyRecoveryShare, toVec, uploadCircuit };
-export type { Arcium as ArciumIdlType, ArciumLocalEnv, ComputationErrorType, ComputationReference, ExecutingPoolAccount, FpField, MempoolAccount, MempoolPriorityFeeStats };
+export { ARCIUM_ADDR, ARCIUM_IDL, Aes128Cipher, Aes192Cipher, Aes256Cipher, ArcisModule, ArcisType, ArcisValueField, CURVE25519_BASE_FIELD, CURVE25519_SCALAR_FIELD_MODULUS, IntegerInfo, Matrix, RescueCipher, RescueDesc, RescuePrimeHash, arcisEd25519, awaitComputationFinalization, buildFinalizeCompDefTx, createPacker, deserializeLE, finalizeKeyRecoveryExecution, generateRandomFieldElem, getArciumAccountBaseSeed, getArciumEnv, getArciumProgram, getArciumProgramId, getArxNodeAccAddress, getClockAccAddress, getClusterAccAddress, getCompDefAccAddress, getCompDefAccOffset, getComputationAccAddress, getComputationsInMempool, getExecutingPoolAccAddress, getExecutingPoolAccInfo, getFeePoolAccAddress, getMXEAccAddress, getMXEArcisEd25519VerifyingKey, getMXEPublicKey, getMempoolAccAddress, getMempoolAccInfo, getMempoolPriorityFeeStats, getMxeRecoveryAccAddress, getRecoveryClusterAccAddress, initKeyRecoveryExecution, initMxePart1, initMxePart2, isNullRef, positiveModulo, queueKeyRecoveryInit, randMatrix, recoverMxe, serializeLE, sha256, submitKeyRecoveryShare, toVec, uploadCircuit };
+export type { Arcium as ArciumIdlType, ArciumLocalEnv, ComputationErrorType, ComputationReference, ExecutingPoolAccount, FieldInfo, FpField, MempoolAccount, MempoolPriorityFeeStats, Packer };