@arcium-hq/client 0.6.0 → 0.6.1

package/build/index.cjs

@@ -281,6 +281,28 @@ function encodeAsRescueEncryptable(v) {
     }
     throw new Error('Invalid type to convert from number to bigint');
 }
+/**
+ * Decodes a Rescue-decrypted value back to a signed bigint.
+ * Handles the conversion from field element representation to signed integer.
+ * @param v - The decrypted field element value
+ * @returns The decoded signed bigint value
+ */
+function decodeRescueDecryptedToBigInt(v) {
+    const twoInv = (CURVE25519_BASE_FIELD.ORDER + 1n) / 2n;
+    const binSize = getBinSize(CURVE25519_BASE_FIELD.ORDER - 1n);
+    const isLtTwoInv = ctLt(v, twoInv, binSize);
+    return ctSelect(isLtTwoInv, v, ctSub(v, CURVE25519_BASE_FIELD.ORDER, binSize), binSize);
+}
+/**
+ * Decodes a Rescue-decrypted value back to a JavaScript number.
+ * Converts from field element representation to a floating-point number.
+ * @param v - The decrypted field element value
+ * @returns The decoded number value
+ */
+function decodeRescueDecryptedToNumber(v) {
+    const vSigned = decodeRescueDecryptedToBigInt(v);
+    return Number(vSigned) * 2 ** -DOUBLE_PRECISION_MANTISSA;
+}
 /**
  * Checks if a computation reference is null (all zeros).
  * @param ref - The computation reference to check
@@ -1271,22 +1293,22 @@ class Aes256Cipher extends AesCtrCipher {
 }
 
 class DataSize {
-    is_full;
+    isFull;
     size;
     index;
     constructor(index, size) {
-        const is_undefined = size == undefined;
-        this.is_full = is_undefined;
-        this.size = is_undefined ? 0 : size;
+        const isUndefined = size === undefined;
+        this.isFull = isUndefined;
+        this.size = isUndefined ? 0 : size;
         this.index = index;
     }
 }
 function sortDataSizes(arr) {
-    arr.sort((left, right) => {
-        if (left.is_full != right.is_full) {
-            return left.is_full ? -1 : 1;
+    return [...arr].sort((left, right) => {
+        if (left.isFull !== right.isFull) {
+            return left.isFull ? -1 : 1;
         }
-        if (left.size != right.size) {
+        if (left.size !== right.size) {
             return right.size - left.size;
         }
         return left.index - right.index;
@@ -1309,7 +1331,7 @@ class PackingState {
         this.maxSize = maxSize;
     }
     getCurrentLoad(index) {
-        return this.loads[index] == undefined ? 0 : this.loads[index];
+        return this.loads[index] === undefined ? 0 : this.loads[index];
     }
     canFit(index, size) {
         return this.getCurrentLoad(index) + size <= this.maxSize;
@@ -1324,7 +1346,7 @@ class PackingState {
         return this.lastInsert + 1;
     }
     insert(size) {
-        if (size.is_full) {
+        if (size.isFull) {
             this.lastInsert = this.nFull;
             this.nFull++;
             return new PackLocation(this.lastInsert, 0);
@@ -1339,23 +1361,27 @@ class PackingState {
     }
 }
 function packing(maxSize, arr) {
-    sortDataSizes(arr);
+    const sortedArr = sortDataSizes(arr);
     const inserts = [];
     const state = new PackingState(maxSize);
-    arr.forEach((value) => {
+    sortedArr.forEach((value) => {
         const pack = state.insert(value);
         inserts.push([value.index, pack]);
     });
-    const n_packs = state.loads.length;
+    const nPacks = state.nFull + state.loads.length;
     inserts.sort((left, right) => left[0] - right[0]);
     const res = inserts.map((arg) => arg[1]);
-    return [n_packs, res];
+    return [nPacks, res];
 }
 const ARCIS_PACKING_SIZE = 214;
 function arcisPacking(arr) {
     return packing(ARCIS_PACKING_SIZE, arr);
 }
 
+/** Length of a Pubkey in bytes (Solana public keys are 32 bytes) */
+const PUBKEY_BYTE_LENGTH = 32;
+/** Maximum value a Pubkey bigint can hold (2^256) */
+const PUBKEY_MAX_VALUE = 1n << 256n;
 var ArcisValueKind;
 (function (ArcisValueKind) {
     ArcisValueKind[ArcisValueKind["Integer"] = 0] = "Integer";
@@ -1377,10 +1403,10 @@ class IntegerInfo {
     minValue() {
         return this.signed ? -1n << (this.width - 1n) : 0n;
     }
-    is_within_bounds(b) {
-        const min_value = this.minValue();
-        const min_bigger_value = this.signed ? 1n << (this.width - 1n) : 1n << this.width;
-        return min_value <= b && b < min_bigger_value;
+    isWithinBounds(b) {
+        const minVal = this.minValue();
+        const maxVal = this.signed ? 1n << (this.width - 1n) : 1n << this.width;
+        return minVal <= b && b < maxVal;
     }
     name() {
         return (this.signed ? "i" : "u") + this.width;
@@ -1414,9 +1440,9 @@ class ArcisValueField {
                 kind = ArcisValueKind.Pubkey;
                 break;
         }
-        if (kind == ArcisValueKind.Integer) {
-            if (typeof rawType == "string") {
-                throw TypeError("Weird thfflkmk");
+        if (kind === ArcisValueKind.Integer) {
+            if (typeof rawType === "string") {
+                throw new TypeError("Expected Integer type object with signed/width properties");
             }
             const info = IntegerInfo.fromJson(rawType.Integer);
             return new ArcisValueField(name, kind, info);
@@ -1426,38 +1452,63 @@ class ArcisValueField {
         }
     }
     toBigInt(arg) {
+        if (this.kind === ArcisValueKind.Float) {
+            if (typeof arg !== 'number') {
+                throw new TypeError(`Field ${this.name} expected a number, got ${typeof arg}`);
+            }
+            return encodeAsRescueEncryptable(arg);
+        }
+        let value = arg;
+        if (typeof value === 'number') {
+            if (!Number.isInteger(value)) {
+                throw new TypeError(`Field ${this.name}: expected integer, got float ${value}`);
+            }
+            if (!Number.isSafeInteger(value)) {
+                throw new RangeError(`Field ${this.name}: ${value} exceeds safe integer range, use BigInt`);
+            }
+            value = BigInt(value);
+        }
         switch (this.kind) {
             case ArcisValueKind.Bool:
-                if (typeof arg != "boolean") {
-                    throw new TypeError("Field " + this.name + " expected a `boolean`, got `" + typeof arg + "`.");
+                if (typeof value !== 'boolean') {
+                    throw new TypeError(`Field ${this.name} expected a boolean, got ${typeof value}`);
                 }
-                return BigInt(arg);
-            case ArcisValueKind.Float:
-                if (typeof arg != "number") {
-                    throw new TypeError("Field " + this.name + " expected a `number`, got `" + typeof arg + "`.");
-                }
-                return encodeAsRescueEncryptable(arg);
+                return BigInt(value);
             case ArcisValueKind.FullInteger:
-                if (typeof arg != "bigint") {
-                    throw new TypeError("Field " + this.name + " expected a `bigint`, got `" + typeof arg + "`.");
+                if (typeof value !== 'bigint') {
+                    throw new TypeError(`Field ${this.name} expected a bigint, got ${typeof value}`);
                 }
-                return arg;
+                return value;
             case ArcisValueKind.Integer:
-                if (typeof arg != "bigint") {
-                    throw new TypeError("Field " + this.name + " expected a `bigint`, got `" + typeof arg + "`.");
+                if (typeof value !== 'bigint') {
+                    throw new TypeError(`Field ${this.name} expected a bigint, got ${typeof value}`);
                 }
-                if (typeof this.info == "undefined") {
-                    throw new TypeError("Field " + this.name + " is an integer, but signedness and width are unknown.");
+                if (this.info === undefined) {
+                    throw new TypeError(`Field ${this.name} is an integer, but signedness and width are unknown`);
                 }
-                if (!this.info.is_within_bounds(arg)) {
-                    throw new TypeError("Field " + this.name + " is a " + this.info.name() + ", and " + arg + " is not.");
+                if (!this.info.isWithinBounds(value)) {
+                    const min = this.info.minValue();
+                    const max = this.info.signed ? (1n << (this.info.width - 1n)) - 1n : (1n << this.info.width) - 1n;
+                    throw new RangeError(`Field "${this.name}" (${this.info.name()}): value ${value} out of range [${min}, ${max}]`);
                 }
-                return arg - this.info.minValue();
-            case ArcisValueKind.Pubkey:
-                if (!(arg instanceof Uint8Array)) {
-                    throw new TypeError("Field " + this.name + " expected a `Uint8Array`, got `" + typeof arg + "`.");
+                return value - this.info.minValue();
+            case ArcisValueKind.Pubkey: {
+                if (!(value instanceof Uint8Array)) {
+                    throw new TypeError(`Field ${this.name} expected a Uint8Array, got ${typeof value}`);
                 }
-                throw new TypeError("unimplemented pubkey ");
+                if (value.length !== PUBKEY_BYTE_LENGTH) {
+                    throw new RangeError(`Field ${this.name} expected ${PUBKEY_BYTE_LENGTH}-byte Uint8Array, got ${value.length} bytes`);
+                }
+                let pubkeyResult = 0n;
+                for (let i = 0; i < PUBKEY_BYTE_LENGTH; i++) {
+                    pubkeyResult |= BigInt(value[i]) << BigInt(i * 8);
+                }
+                return pubkeyResult;
+            }
+            default: {
+                const _exhaustive = this.kind;
+                throw new Error(`Unhandled ArcisValueKind: ${_exhaustive}`);
+            }
         }
     }
     fromBigInt(arg) {
@@ -1469,21 +1520,58 @@ class ArcisValueField {
                     case 1n:
                         return true;
                     default:
-                        throw new Error("Bool was neither 0 nor 1, it was " + arg);
+                        throw new RangeError(`Field ${this.name}: Bool must be 0 or 1, got ${arg}`);
                 }
             case ArcisValueKind.Float:
-                return Number(arg - (1n << 127n)) / (2 ** 52);
+                return decodeRescueDecryptedToNumber(arg);
             case ArcisValueKind.FullInteger:
                 return arg;
             case ArcisValueKind.Integer:
-                if (this.info == undefined) {
-                    throw TypeError("Integer type without integer info");
+                if (this.info === undefined) {
+                    throw new TypeError("Integer type without integer info");
                 }
                 return arg + this.info.minValue();
-            case ArcisValueKind.Pubkey:
-                throw new Error("unimplemented yet");
+            case ArcisValueKind.Pubkey: {
+                if (arg < 0n) {
+                    throw new RangeError(`Field ${this.name}: Pubkey cannot be negative`);
+                }
+                if (arg >= PUBKEY_MAX_VALUE) {
+                    throw new RangeError(`Field ${this.name}: Pubkey exceeds 256 bits`);
+                }
+                const pubkeyBytes = new Uint8Array(PUBKEY_BYTE_LENGTH);
+                let remaining = arg;
+                for (let i = 0; i < PUBKEY_BYTE_LENGTH; i++) {
+                    pubkeyBytes[i] = Number(remaining & 0xffn);
+                    remaining >>= 8n;
+                }
+                return pubkeyBytes;
+            }
+            default: {
+                const _exhaustive = this.kind;
+                throw new Error(`Unhandled ArcisValueKind: ${_exhaustive}`);
+            }
         }
     }
+    static fromFieldInfo(info) {
+        const name = info.name;
+        if (info.type === 'Bool') {
+            return new ArcisValueField(name, ArcisValueKind.Bool);
+        }
+        if (info.type === 'FullInteger') {
+            return new ArcisValueField(name, ArcisValueKind.FullInteger);
+        }
+        if (info.type === 'Float') {
+            return new ArcisValueField(name, ArcisValueKind.Float);
+        }
+        if (info.type === 'Pubkey') {
+            return new ArcisValueField(name, ArcisValueKind.Pubkey);
+        }
+        if (typeof info.type === 'object' && 'Integer' in info.type) {
+            const intInfo = new IntegerInfo(info.type.Integer.signed, BigInt(info.type.Integer.width));
+            return new ArcisValueField(name, ArcisValueKind.Integer, intInfo);
+        }
+        throw new TypeError(`Unknown field type for ${name}`);
+    }
     toDataSize(index) {
         switch (this.kind) {
             case ArcisValueKind.Pubkey:
@@ -1507,6 +1595,9 @@ class ArcisType {
         this.fields = fields;
     }
     pack(rawData) {
+        if (rawData.length !== this.fields.length) {
+            throw new RangeError(`Expected ${this.fields.length} fields, got ${rawData.length}`);
+        }
         const data = rawData.map((val, index) => this.fields[index].toBigInt(val));
         const dataSizes = this.fields.map((field, index) => field.toDataSize(index));
         const packing = arcisPacking(dataSizes);
@@ -1521,11 +1612,14 @@ class ArcisType {
     unpack(packed) {
         const dataSizes = this.fields.map((field, index) => field.toDataSize(index));
         const packing = arcisPacking(dataSizes);
+        if (packed.length < packing[0]) {
+            throw new RangeError(`Expected at least ${packing[0]} packed elements, got ${packed.length}`);
+        }
         const res = [];
         for (let idx = 0; idx < dataSizes.length; idx++) {
             const packLocation = packing[1][idx];
             const dataSize = dataSizes[idx];
-            const val = dataSize.is_full ? packed[packLocation.index] : (packed[packLocation.index] >> BigInt(packLocation.offset)) % (1n << BigInt(dataSize.size));
+            const val = dataSize.isFull ? packed[packLocation.index] : (packed[packLocation.index] >> BigInt(packLocation.offset)) % (1n << BigInt(dataSize.size));
             res.push(this.fields[idx].fromBigInt(val));
         }
         return res;
@@ -1557,10 +1651,76 @@ class ArcisModule {
     }
 }
 
-var address = "BpaW2ZmCJnDwizWY8eM34JtVqp2kRgnmQcedSVc9USdP";
+function parseFieldName(name) {
+    const match = name.match(/^(.+)\[(\d+)\]$/);
+    if (match) {
+        return { base: match[1], index: parseInt(match[2], 10) };
+    }
+    return { base: name, index: null };
+}
+function extractValue(data, fieldName) {
+    const { base, index } = parseFieldName(fieldName);
+    const value = data[base];
+    if (index !== null) {
+        if (!Array.isArray(value)) {
+            throw new TypeError(`Field "${base}" should be an array`);
+        }
+        if (index >= value.length) {
+            throw new RangeError(`Field "${base}[${index}]" out of bounds (array length: ${value.length})`);
+        }
+        return value[index];
+    }
+    return value;
+}
+function groupUnpackedValues(values, fieldNames) {
+    const result = {};
+    for (let i = 0; i < fieldNames.length; i++) {
+        const { base, index } = parseFieldName(fieldNames[i]);
+        const value = values[i];
+        if (index !== null) {
+            if (!result[base]) {
+                result[base] = [];
+            }
+            result[base][index] = value;
+        }
+        else {
+            result[base] = value;
+        }
+    }
+    return result;
+}
+/**
+ * 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.
+ */
+function createPacker(fields, typeName = 'Packer') {
+    const arcisFields = fields.map(f => ArcisValueField.fromFieldInfo(f));
+    const arcisType = new ArcisType(typeName, arcisFields);
+    const fieldNames = fields.map(f => f.name);
+    return {
+        pack(data) {
+            const arr = fieldNames.map(name => {
+                const value = extractValue(data, name);
+                if (value === undefined) {
+                    throw new Error(`Missing required field: "${name}"`);
+                }
+                return value;
+            });
+            return arcisType.pack(arr);
+        },
+        unpack(packed) {
+            const arr = arcisType.unpack(packed);
+            return groupUnpackedValues(arr, fieldNames);
+        }
+    };
+}
+
+var address = "Arcj82pX7HxYKLR92qvgZUAd7vGS1k4hQvAFcPATFdEQ";
 var metadata = {
 	name: "arcium",
-	version: "0.6.0",
+	version: "0.6.1",
 	spec: "0.1.0",
 	description: "The Arcium program"
 };
@@ -13452,8 +13612,10 @@ exports.Aes192Cipher = Aes192Cipher;
 exports.Aes256Cipher = Aes256Cipher;
 exports.ArcisModule = ArcisModule;
 exports.ArcisType = ArcisType;
+exports.ArcisValueField = ArcisValueField;
 exports.CURVE25519_BASE_FIELD = CURVE25519_BASE_FIELD;
 exports.CURVE25519_SCALAR_FIELD_MODULUS = CURVE25519_SCALAR_FIELD_MODULUS;
+exports.IntegerInfo = IntegerInfo;
 exports.Matrix = Matrix;
 exports.RescueCipher = RescueCipher;
 exports.RescueDesc = RescueDesc;
@@ -13461,6 +13623,7 @@ exports.RescuePrimeHash = RescuePrimeHash;
 exports.arcisEd25519 = arcisEd25519;
 exports.awaitComputationFinalization = awaitComputationFinalization;
 exports.buildFinalizeCompDefTx = buildFinalizeCompDefTx;
+exports.createPacker = createPacker;
 exports.deserializeLE = deserializeLE;
 exports.finalizeKeyRecoveryExecution = finalizeKeyRecoveryExecution;
 exports.generateRandomFieldElem = generateRandomFieldElem;

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.1";
         "spec": "0.1.0";
         "description": "The Arcium program";
     };
@@ -11337,7 +11371,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 +11670,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 };

package/build/index.mjs

@@ -262,6 +262,28 @@ function encodeAsRescueEncryptable(v) {
     }
     throw new Error('Invalid type to convert from number to bigint');
 }
+/**
+ * Decodes a Rescue-decrypted value back to a signed bigint.
+ * Handles the conversion from field element representation to signed integer.
+ * @param v - The decrypted field element value
+ * @returns The decoded signed bigint value
+ */
+function decodeRescueDecryptedToBigInt(v) {
+    const twoInv = (CURVE25519_BASE_FIELD.ORDER + 1n) / 2n;
+    const binSize = getBinSize(CURVE25519_BASE_FIELD.ORDER - 1n);
+    const isLtTwoInv = ctLt(v, twoInv, binSize);
+    return ctSelect(isLtTwoInv, v, ctSub(v, CURVE25519_BASE_FIELD.ORDER, binSize), binSize);
+}
+/**
+ * Decodes a Rescue-decrypted value back to a JavaScript number.
+ * Converts from field element representation to a floating-point number.
+ * @param v - The decrypted field element value
+ * @returns The decoded number value
+ */
+function decodeRescueDecryptedToNumber(v) {
+    const vSigned = decodeRescueDecryptedToBigInt(v);
+    return Number(vSigned) * 2 ** -DOUBLE_PRECISION_MANTISSA;
+}
 /**
  * Checks if a computation reference is null (all zeros).
  * @param ref - The computation reference to check
@@ -1252,22 +1274,22 @@ class Aes256Cipher extends AesCtrCipher {
 }
 
 class DataSize {
-    is_full;
+    isFull;
     size;
     index;
     constructor(index, size) {
-        const is_undefined = size == undefined;
-        this.is_full = is_undefined;
-        this.size = is_undefined ? 0 : size;
+        const isUndefined = size === undefined;
+        this.isFull = isUndefined;
+        this.size = isUndefined ? 0 : size;
         this.index = index;
     }
 }
 function sortDataSizes(arr) {
-    arr.sort((left, right) => {
-        if (left.is_full != right.is_full) {
-            return left.is_full ? -1 : 1;
+    return [...arr].sort((left, right) => {
+        if (left.isFull !== right.isFull) {
+            return left.isFull ? -1 : 1;
         }
-        if (left.size != right.size) {
+        if (left.size !== right.size) {
             return right.size - left.size;
         }
         return left.index - right.index;
@@ -1290,7 +1312,7 @@ class PackingState {
         this.maxSize = maxSize;
     }
     getCurrentLoad(index) {
-        return this.loads[index] == undefined ? 0 : this.loads[index];
+        return this.loads[index] === undefined ? 0 : this.loads[index];
     }
     canFit(index, size) {
         return this.getCurrentLoad(index) + size <= this.maxSize;
@@ -1305,7 +1327,7 @@ class PackingState {
         return this.lastInsert + 1;
     }
     insert(size) {
-        if (size.is_full) {
+        if (size.isFull) {
             this.lastInsert = this.nFull;
             this.nFull++;
             return new PackLocation(this.lastInsert, 0);
@@ -1320,23 +1342,27 @@ class PackingState {
     }
 }
 function packing(maxSize, arr) {
-    sortDataSizes(arr);
+    const sortedArr = sortDataSizes(arr);
     const inserts = [];
     const state = new PackingState(maxSize);
-    arr.forEach((value) => {
+    sortedArr.forEach((value) => {
         const pack = state.insert(value);
         inserts.push([value.index, pack]);
     });
-    const n_packs = state.loads.length;
+    const nPacks = state.nFull + state.loads.length;
     inserts.sort((left, right) => left[0] - right[0]);
     const res = inserts.map((arg) => arg[1]);
-    return [n_packs, res];
+    return [nPacks, res];
 }
 const ARCIS_PACKING_SIZE = 214;
 function arcisPacking(arr) {
     return packing(ARCIS_PACKING_SIZE, arr);
 }
 
+/** Length of a Pubkey in bytes (Solana public keys are 32 bytes) */
+const PUBKEY_BYTE_LENGTH = 32;
+/** Maximum value a Pubkey bigint can hold (2^256) */
+const PUBKEY_MAX_VALUE = 1n << 256n;
 var ArcisValueKind;
 (function (ArcisValueKind) {
     ArcisValueKind[ArcisValueKind["Integer"] = 0] = "Integer";
@@ -1358,10 +1384,10 @@ class IntegerInfo {
     minValue() {
         return this.signed ? -1n << (this.width - 1n) : 0n;
     }
-    is_within_bounds(b) {
-        const min_value = this.minValue();
-        const min_bigger_value = this.signed ? 1n << (this.width - 1n) : 1n << this.width;
-        return min_value <= b && b < min_bigger_value;
+    isWithinBounds(b) {
+        const minVal = this.minValue();
+        const maxVal = this.signed ? 1n << (this.width - 1n) : 1n << this.width;
+        return minVal <= b && b < maxVal;
     }
     name() {
         return (this.signed ? "i" : "u") + this.width;
@@ -1395,9 +1421,9 @@ class ArcisValueField {
                 kind = ArcisValueKind.Pubkey;
                 break;
         }
-        if (kind == ArcisValueKind.Integer) {
-            if (typeof rawType == "string") {
-                throw TypeError("Weird thfflkmk");
+        if (kind === ArcisValueKind.Integer) {
+            if (typeof rawType === "string") {
+                throw new TypeError("Expected Integer type object with signed/width properties");
             }
             const info = IntegerInfo.fromJson(rawType.Integer);
             return new ArcisValueField(name, kind, info);
@@ -1407,38 +1433,63 @@ class ArcisValueField {
         }
     }
     toBigInt(arg) {
+        if (this.kind === ArcisValueKind.Float) {
+            if (typeof arg !== 'number') {
+                throw new TypeError(`Field ${this.name} expected a number, got ${typeof arg}`);
+            }
+            return encodeAsRescueEncryptable(arg);
+        }
+        let value = arg;
+        if (typeof value === 'number') {
+            if (!Number.isInteger(value)) {
+                throw new TypeError(`Field ${this.name}: expected integer, got float ${value}`);
+            }
+            if (!Number.isSafeInteger(value)) {
+                throw new RangeError(`Field ${this.name}: ${value} exceeds safe integer range, use BigInt`);
+            }
+            value = BigInt(value);
+        }
         switch (this.kind) {
             case ArcisValueKind.Bool:
-                if (typeof arg != "boolean") {
-                    throw new TypeError("Field " + this.name + " expected a `boolean`, got `" + typeof arg + "`.");
+                if (typeof value !== 'boolean') {
+                    throw new TypeError(`Field ${this.name} expected a boolean, got ${typeof value}`);
                 }
-                return BigInt(arg);
-            case ArcisValueKind.Float:
-                if (typeof arg != "number") {
-                    throw new TypeError("Field " + this.name + " expected a `number`, got `" + typeof arg + "`.");
-                }
-                return encodeAsRescueEncryptable(arg);
+                return BigInt(value);
             case ArcisValueKind.FullInteger:
-                if (typeof arg != "bigint") {
-                    throw new TypeError("Field " + this.name + " expected a `bigint`, got `" + typeof arg + "`.");
+                if (typeof value !== 'bigint') {
+                    throw new TypeError(`Field ${this.name} expected a bigint, got ${typeof value}`);
                 }
-                return arg;
+                return value;
             case ArcisValueKind.Integer:
-                if (typeof arg != "bigint") {
-                    throw new TypeError("Field " + this.name + " expected a `bigint`, got `" + typeof arg + "`.");
+                if (typeof value !== 'bigint') {
+                    throw new TypeError(`Field ${this.name} expected a bigint, got ${typeof value}`);
                 }
-                if (typeof this.info == "undefined") {
-                    throw new TypeError("Field " + this.name + " is an integer, but signedness and width are unknown.");
+                if (this.info === undefined) {
+                    throw new TypeError(`Field ${this.name} is an integer, but signedness and width are unknown`);
                 }
-                if (!this.info.is_within_bounds(arg)) {
-                    throw new TypeError("Field " + this.name + " is a " + this.info.name() + ", and " + arg + " is not.");
+                if (!this.info.isWithinBounds(value)) {
+                    const min = this.info.minValue();
+                    const max = this.info.signed ? (1n << (this.info.width - 1n)) - 1n : (1n << this.info.width) - 1n;
+                    throw new RangeError(`Field "${this.name}" (${this.info.name()}): value ${value} out of range [${min}, ${max}]`);
                 }
-                return arg - this.info.minValue();
-            case ArcisValueKind.Pubkey:
-                if (!(arg instanceof Uint8Array)) {
-                    throw new TypeError("Field " + this.name + " expected a `Uint8Array`, got `" + typeof arg + "`.");
+                return value - this.info.minValue();
+            case ArcisValueKind.Pubkey: {
+                if (!(value instanceof Uint8Array)) {
+                    throw new TypeError(`Field ${this.name} expected a Uint8Array, got ${typeof value}`);
                 }
-                throw new TypeError("unimplemented pubkey ");
+                if (value.length !== PUBKEY_BYTE_LENGTH) {
+                    throw new RangeError(`Field ${this.name} expected ${PUBKEY_BYTE_LENGTH}-byte Uint8Array, got ${value.length} bytes`);
+                }
+                let pubkeyResult = 0n;
+                for (let i = 0; i < PUBKEY_BYTE_LENGTH; i++) {
+                    pubkeyResult |= BigInt(value[i]) << BigInt(i * 8);
+                }
+                return pubkeyResult;
+            }
+            default: {
+                const _exhaustive = this.kind;
+                throw new Error(`Unhandled ArcisValueKind: ${_exhaustive}`);
+            }
         }
     }
     fromBigInt(arg) {
@@ -1450,21 +1501,58 @@ class ArcisValueField {
                     case 1n:
                         return true;
                     default:
-                        throw new Error("Bool was neither 0 nor 1, it was " + arg);
+                        throw new RangeError(`Field ${this.name}: Bool must be 0 or 1, got ${arg}`);
                 }
             case ArcisValueKind.Float:
-                return Number(arg - (1n << 127n)) / (2 ** 52);
+                return decodeRescueDecryptedToNumber(arg);
             case ArcisValueKind.FullInteger:
                 return arg;
             case ArcisValueKind.Integer:
-                if (this.info == undefined) {
-                    throw TypeError("Integer type without integer info");
+                if (this.info === undefined) {
+                    throw new TypeError("Integer type without integer info");
                 }
                 return arg + this.info.minValue();
-            case ArcisValueKind.Pubkey:
-                throw new Error("unimplemented yet");
+            case ArcisValueKind.Pubkey: {
+                if (arg < 0n) {
+                    throw new RangeError(`Field ${this.name}: Pubkey cannot be negative`);
+                }
+                if (arg >= PUBKEY_MAX_VALUE) {
+                    throw new RangeError(`Field ${this.name}: Pubkey exceeds 256 bits`);
+                }
+                const pubkeyBytes = new Uint8Array(PUBKEY_BYTE_LENGTH);
+                let remaining = arg;
+                for (let i = 0; i < PUBKEY_BYTE_LENGTH; i++) {
+                    pubkeyBytes[i] = Number(remaining & 0xffn);
+                    remaining >>= 8n;
+                }
+                return pubkeyBytes;
+            }
+            default: {
+                const _exhaustive = this.kind;
+                throw new Error(`Unhandled ArcisValueKind: ${_exhaustive}`);
+            }
         }
     }
+    static fromFieldInfo(info) {
+        const name = info.name;
+        if (info.type === 'Bool') {
+            return new ArcisValueField(name, ArcisValueKind.Bool);
+        }
+        if (info.type === 'FullInteger') {
+            return new ArcisValueField(name, ArcisValueKind.FullInteger);
+        }
+        if (info.type === 'Float') {
+            return new ArcisValueField(name, ArcisValueKind.Float);
+        }
+        if (info.type === 'Pubkey') {
+            return new ArcisValueField(name, ArcisValueKind.Pubkey);
+        }
+        if (typeof info.type === 'object' && 'Integer' in info.type) {
+            const intInfo = new IntegerInfo(info.type.Integer.signed, BigInt(info.type.Integer.width));
+            return new ArcisValueField(name, ArcisValueKind.Integer, intInfo);
+        }
+        throw new TypeError(`Unknown field type for ${name}`);
+    }
     toDataSize(index) {
         switch (this.kind) {
             case ArcisValueKind.Pubkey:
@@ -1488,6 +1576,9 @@ class ArcisType {
         this.fields = fields;
     }
     pack(rawData) {
+        if (rawData.length !== this.fields.length) {
+            throw new RangeError(`Expected ${this.fields.length} fields, got ${rawData.length}`);
+        }
         const data = rawData.map((val, index) => this.fields[index].toBigInt(val));
         const dataSizes = this.fields.map((field, index) => field.toDataSize(index));
         const packing = arcisPacking(dataSizes);
@@ -1502,11 +1593,14 @@ class ArcisType {
     unpack(packed) {
         const dataSizes = this.fields.map((field, index) => field.toDataSize(index));
         const packing = arcisPacking(dataSizes);
+        if (packed.length < packing[0]) {
+            throw new RangeError(`Expected at least ${packing[0]} packed elements, got ${packed.length}`);
+        }
         const res = [];
         for (let idx = 0; idx < dataSizes.length; idx++) {
             const packLocation = packing[1][idx];
             const dataSize = dataSizes[idx];
-            const val = dataSize.is_full ? packed[packLocation.index] : (packed[packLocation.index] >> BigInt(packLocation.offset)) % (1n << BigInt(dataSize.size));
+            const val = dataSize.isFull ? packed[packLocation.index] : (packed[packLocation.index] >> BigInt(packLocation.offset)) % (1n << BigInt(dataSize.size));
             res.push(this.fields[idx].fromBigInt(val));
         }
         return res;
@@ -1538,10 +1632,76 @@ class ArcisModule {
     }
 }
 
-var address = "BpaW2ZmCJnDwizWY8eM34JtVqp2kRgnmQcedSVc9USdP";
+function parseFieldName(name) {
+    const match = name.match(/^(.+)\[(\d+)\]$/);
+    if (match) {
+        return { base: match[1], index: parseInt(match[2], 10) };
+    }
+    return { base: name, index: null };
+}
+function extractValue(data, fieldName) {
+    const { base, index } = parseFieldName(fieldName);
+    const value = data[base];
+    if (index !== null) {
+        if (!Array.isArray(value)) {
+            throw new TypeError(`Field "${base}" should be an array`);
+        }
+        if (index >= value.length) {
+            throw new RangeError(`Field "${base}[${index}]" out of bounds (array length: ${value.length})`);
+        }
+        return value[index];
+    }
+    return value;
+}
+function groupUnpackedValues(values, fieldNames) {
+    const result = {};
+    for (let i = 0; i < fieldNames.length; i++) {
+        const { base, index } = parseFieldName(fieldNames[i]);
+        const value = values[i];
+        if (index !== null) {
+            if (!result[base]) {
+                result[base] = [];
+            }
+            result[base][index] = value;
+        }
+        else {
+            result[base] = value;
+        }
+    }
+    return result;
+}
+/**
+ * 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.
+ */
+function createPacker(fields, typeName = 'Packer') {
+    const arcisFields = fields.map(f => ArcisValueField.fromFieldInfo(f));
+    const arcisType = new ArcisType(typeName, arcisFields);
+    const fieldNames = fields.map(f => f.name);
+    return {
+        pack(data) {
+            const arr = fieldNames.map(name => {
+                const value = extractValue(data, name);
+                if (value === undefined) {
+                    throw new Error(`Missing required field: "${name}"`);
+                }
+                return value;
+            });
+            return arcisType.pack(arr);
+        },
+        unpack(packed) {
+            const arr = arcisType.unpack(packed);
+            return groupUnpackedValues(arr, fieldNames);
+        }
+    };
+}
+
+var address = "Arcj82pX7HxYKLR92qvgZUAd7vGS1k4hQvAFcPATFdEQ";
 var metadata = {
 	name: "arcium",
-	version: "0.6.0",
+	version: "0.6.1",
 	spec: "0.1.0",
 	description: "The Arcium program"
 };
@@ -13422,4 +13582,4 @@ async function awaitEvent(eventListener, eventName, eventCheck, commitment = 'co
     return { event: foundEvent[0], sig: foundEvent[1] };
 }
 
-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 { 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcium-hq/client",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Client SDK for interacting with encrypted Solana programs",
   "author": "Arcium",
   "license": "GPL-3.0-only",