@aztec/foundation 0.0.0-test.0 → 0.0.1-commit.001888fc

package/dest/curves/bn254/field.d.ts

@@ -0,0 +1,181 @@
+import { inspect } from 'util';
+import { BufferReader } from '../../serialize/buffer_reader.js';
+/**
+ * Represents a field derived from BaseField.
+ */
+type DerivedField<T extends BaseField> = {
+    new (value: any): T;
+    /**
+     * All derived fields will specify a MODULUS.
+     */
+    MODULUS: bigint;
+};
+/**
+ * Base field class.
+ * Uses bigint as the internal representation.
+ * Buffers are generated on demand from the bigint value.
+ */
+declare abstract class BaseField {
+    static SIZE_IN_BYTES: number;
+    private readonly asBigInt;
+    /**
+     * Return bigint representation.
+     * @deprecated Just to get things compiling. Use toBigInt().
+     * */
+    get value(): bigint;
+    /** Returns the size in bytes. */
+    get size(): number;
+    protected constructor(value: number | bigint | boolean | BaseField | Buffer);
+    protected abstract modulus(): bigint;
+    /**
+     * Converts the bigint to a Buffer.
+     */
+    toBuffer(): Buffer;
+    toString(): `0x${string}`;
+    toBigInt(): bigint;
+    toBool(): boolean;
+    /**
+     * Converts this field to a number.
+     * Throws if the underlying value is greater than MAX_SAFE_INTEGER.
+     */
+    toNumber(): number;
+    /**
+     * Converts this field to a number.
+     * May cause loss of precision if the underlying value is greater than MAX_SAFE_INTEGER.
+     */
+    toNumberUnsafe(): number;
+    toShortString(): string;
+    equals(rhs: BaseField): boolean;
+    lt(rhs: BaseField): boolean;
+    cmp(rhs: BaseField): -1 | 0 | 1;
+    static cmp(lhs: BaseField, rhs: BaseField): -1 | 0 | 1;
+    static cmpAsBigInt(lhs: bigint, rhs: bigint): -1 | 0 | 1;
+    isZero(): boolean;
+    isEmpty(): boolean;
+    toFriendlyJSON(): string;
+    toField(): this;
+}
+/**
+ * Constructs a field from a Buffer of BufferReader.
+ * It maybe not read the full 32 bytes if the Buffer is shorter, but it will padded in BaseField constructor.
+ */
+export declare function fromBuffer<T extends BaseField>(buffer: Buffer | BufferReader, f: DerivedField<T>): T;
+/** Branding to ensure fields are not interchangeable types. */
+export interface Fr {
+    /** Brand. */
+    _branding: 'Fr';
+}
+/**
+ * Fr field class.
+ * @dev This class is used to represent elements of BN254 scalar field or elements in the base field of Grumpkin.
+ * (Grumpkin's scalar field corresponds to BN254's base field and vice versa.)
+ */
+export declare class Fr extends BaseField {
+    static ZERO: Fr;
+    static ONE: Fr;
+    static MODULUS: bigint;
+    static MAX_FIELD_VALUE: Fr;
+    constructor(value: number | bigint | boolean | Fr | Buffer);
+    [inspect.custom](): string;
+    protected modulus(): bigint;
+    static random(): Fr;
+    static zero(): Fr;
+    static isZero(value: Fr): boolean;
+    static fromBuffer(buffer: Buffer | BufferReader): Fr;
+    static fromBufferReduce(buffer: Buffer): Fr;
+    /**
+     * Creates a Fr instance from a string.
+     * @param buf - the string to create a Fr from.
+     * @returns the Fr instance
+     * @remarks if the string only consists of numbers, we assume we are parsing a bigint,
+     * otherwise we require the hex string to be prepended with "0x", to ensure there is no misunderstanding
+     * as to what is being parsed.
+     */
+    static fromString(buf: string): Fr;
+    /**
+     * Creates a Fr instance from a hex string.
+     * @param buf - a hex encoded string.
+     * @returns the Fr instance
+     */
+    static fromHexString(buf: string): Fr;
+    /** Arithmetic */
+    add(rhs: Fr): Fr;
+    square(): Fr;
+    negate(): Fr;
+    sub(rhs: Fr): Fr;
+    mul(rhs: Fr): Fr;
+    div(rhs: Fr): Fr;
+    ediv(rhs: Fr): Fr;
+    /**
+     * Computes a square root of the field element.
+     * @returns A square root of the field element (null if it does not exist).
+     */
+    sqrt(): Promise<Fr | null>;
+    toJSON(): `0x${string}`;
+    /**
+     * Creates an Fr instance from a plain object without Zod validation.
+     * This method is optimized for performance and skips validation, making it suitable
+     * for deserializing trusted data (e.g., from C++ via MessagePack).
+     * Handles buffers, strings, numbers, bigints, or existing instances.
+     * @param obj - Plain object, buffer, string, number, bigint, boolean, or Fr instance
+     * @returns An Fr instance
+     */
+    static fromPlainObject(obj: any): Fr;
+    static get schema(): import("zod").ZodType<Fr, any, string>;
+}
+/**
+ * Branding to ensure fields are not interchangeable types.
+ */
+export interface Fq {
+    /** Brand. */
+    _branding: 'Fq';
+}
+/**
+ * Fq field class.
+ * @dev This class is used to represent elements of BN254 base field or elements in the scalar field of Grumpkin.
+ * (Grumpkin's scalar field corresponds to BN254's base field and vice versa.)
+ */
+export declare class Fq extends BaseField {
+    static ZERO: Fq;
+    static MODULUS: bigint;
+    private static HIGH_SHIFT;
+    private static LOW_MASK;
+    [inspect.custom](): string;
+    get lo(): Fr;
+    get hi(): Fr;
+    constructor(value: number | bigint | boolean | Fq | Buffer);
+    protected modulus(): bigint;
+    static random(): Fq;
+    static zero(): Fq;
+    static fromBuffer(buffer: Buffer | BufferReader): Fq;
+    static fromBufferReduce(buffer: Buffer): Fq;
+    /**
+     * Creates a Fq instance from a string.
+     * @param buf - the string to create a Fq from.
+     * @returns the Fq instance
+     * @remarks if the string only consists of numbers, we assume we are parsing a bigint,
+     * otherwise we require the hex string to be prepended with "0x", to ensure there is no misunderstanding
+     * as to what is being parsed.
+     */
+    static fromString(buf: string): Fq;
+    /**
+     * Creates a Fq instance from a hex string.
+     * @param buf - a hex encoded string.
+     * @returns the Fq instance
+     */
+    static fromHexString(buf: string): Fq;
+    static fromHighLow(high: Fr, low: Fr): Fq;
+    add(rhs: Fq): Fq;
+    /**
+     * Computes a square root of the field element.
+     * @returns A square root of the field element (null if it does not exist).
+     */
+    sqrt(): Promise<Fq | null>;
+    toJSON(): `0x${string}`;
+    toFields(): Fr[];
+    static get schema(): import("zod").ZodType<Fq, any, string>;
+}
+/** Wraps a function that returns a buffer so that all results are reduced into a field of the given type. */
+export declare function reduceFn<TInput, TField extends BaseField>(fn: (input: TInput) => Buffer, field: DerivedField<TField>): (input: TInput) => TField;
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmllbGQuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9jdXJ2ZXMvYm4yNTQvZmllbGQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLE1BQU0sQ0FBQztBQUsvQixPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFLaEU7O0dBRUc7QUFDSCxLQUFLLFlBQVksQ0FBQyxDQUFDLFNBQVMsU0FBUyxJQUFJO0lBQ3ZDLEtBQUssS0FBSyxFQUFFLEdBQUcsR0FBRyxDQUFDLENBQUM7SUFDcEI7O09BRUc7SUFDSCxPQUFPLEVBQUUsTUFBTSxDQUFDO0NBQ2pCLENBQUM7QUFFRjs7OztHQUlHO0FBQ0gsdUJBQWUsU0FBUztJQUN0QixNQUFNLENBQUMsYUFBYSxTQUFNO0lBQzFCLE9BQU8sQ0FBQyxRQUFRLENBQUMsUUFBUSxDQUFTO0lBRWxDOzs7U0FHSztJQUNMLElBQUksS0FBSyxJQUFJLE1BQU0sQ0FFbEI7SUFFRCxpQ0FBaUM7SUFDakMsSUFBSSxJQUFJLElBQUksTUFBTSxDQUVqQjtJQUVELFNBQVMsYUFBYSxLQUFLLEVBQUUsTUFBTSxHQUFHLE1BQU0sR0FBRyxPQUFPLEdBQUcsU0FBUyxHQUFHLE1BQU0sRUFtQjFFO0lBRUQsU0FBUyxDQUFDLFFBQVEsQ0FBQyxPQUFPLElBQUksTUFBTSxDQUFDO0lBRXJDOztPQUVHO0lBQ0gsUUFBUSxJQUFJLE1BQU0sQ0FFakI7SUFFRCxRQUFRLElBQUksS0FBSyxNQUFNLEVBQUUsQ0FFeEI7SUFFRCxRQUFRLElBQUksTUFBTSxDQUVqQjtJQUVELE1BQU0sSUFBSSxPQUFPLENBRWhCO0lBRUQ7OztPQUdHO0lBQ0gsUUFBUSxJQUFJLE1BQU0sQ0FLakI7SUFFRDs7O09BR0c7SUFDSCxjQUFjLElBQUksTUFBTSxDQUV2QjtJQUVELGFBQWEsSUFBSSxNQUFNLENBR3RCO0lBRUQsTUFBTSxDQUFDLEdBQUcsRUFBRSxTQUFTLEdBQUcsT0FBTyxDQUU5QjtJQUVELEVBQUUsQ0FBQyxHQUFHLEVBQUUsU0FBUyxHQUFHLE9BQU8sQ0FFMUI7SUFFRCxHQUFHLENBQUMsR0FBRyxFQUFFLFNBQVMsR0FBRyxDQUFDLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUU5QjtJQUVELE1BQU0sQ0FBQyxHQUFHLENBQUMsR0FBRyxFQUFFLFNBQVMsRUFBRSxHQUFHLEVBQUUsU0FBUyxHQUFHLENBQUMsQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLENBRXJEO0lBR0QsTUFBTSxDQUFDLFdBQVcsQ0FBQyxHQUFHLEVBQUUsTUFBTSxFQUFFLEdBQUcsRUFBRSxNQUFNLEdBQUcsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FFdkQ7SUFFRCxNQUFNLElBQUksT0FBTyxDQUVoQjtJQUVELE9BQU8sSUFBSSxPQUFPLENBRWpCO0lBRUQsY0FBYyxJQUFJLE1BQU0sQ0FFdkI7SUFFRCxPQUFPLFNBRU47Q0FDRjtBQUVEOzs7R0FHRztBQUNILHdCQUFnQixVQUFVLENBQUMsQ0FBQyxTQUFTLFNBQVMsRUFBRSxNQUFNLEVBQUUsTUFBTSxHQUFHLFlBQVksRUFBRSxDQUFDLEVBQUUsWUFBWSxDQUFDLENBQUMsQ0FBQyxLQUdoRztBQWlDRCwrREFBK0Q7QUFDL0QsTUFBTSxXQUFXLEVBQUU7SUFDakIsYUFBYTtJQUNiLFNBQVMsRUFBRSxJQUFJLENBQUM7Q0FDakI7QUFFRDs7OztHQUlHO0FBQ0gscUJBQWEsRUFBRyxTQUFRLFNBQVM7SUFDL0IsTUFBTSxDQUFDLElBQUksS0FBYztJQUN6QixNQUFNLENBQUMsR0FBRyxLQUFjO0lBQ3hCLE1BQU0sQ0FBQyxPQUFPLFNBQXVFO0lBQ3JGLE1BQU0sQ0FBQyxlQUFlLEtBQTZCO0lBRW5ELFlBQVksS0FBSyxFQUFFLE1BQU0sR0FBRyxNQUFNLEdBQUcsT0FBTyxHQUFHLEVBQUUsR0FBRyxNQUFNLEVBRXpEO0lBRUQsQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLFdBRWY7SUFFRCxTQUFTLENBQUMsT0FBTyxXQUVoQjtJQUVELE1BQU0sQ0FBQyxNQUFNLE9BRVo7SUFFRCxNQUFNLENBQUMsSUFBSSxPQUVWO0lBRUQsTUFBTSxDQUFDLE1BQU0sQ0FBQyxLQUFLLEVBQUUsRUFBRSxXQUV0QjtJQUVELE1BQU0sQ0FBQyxVQUFVLENBQUMsTUFBTSxFQUFFLE1BQU0sR0FBRyxZQUFZLE1BRTlDO0lBRUQsTUFBTSxDQUFDLGdCQUFnQixDQUFDLE1BQU0sRUFBRSxNQUFNLE1BRXJDO0lBRUQ7Ozs7Ozs7T0FPRztJQUNILE1BQU0sQ0FBQyxVQUFVLENBQUMsR0FBRyxFQUFFLE1BQU0sTUFTNUI7SUFFRDs7OztPQUlHO0lBQ0gsTUFBTSxDQUFDLGFBQWEsQ0FBQyxHQUFHLEVBQUUsTUFBTSxNQUUvQjtJQUVELGlCQUFpQjtJQUVqQixHQUFHLENBQUMsR0FBRyxFQUFFLEVBQUUsTUFFVjtJQUVELE1BQU0sT0FFTDtJQUVELE1BQU0sT0FFTDtJQUVELEdBQUcsQ0FBQyxHQUFHLEVBQUUsRUFBRSxNQUdWO0lBRUQsR0FBRyxDQUFDLEdBQUcsRUFBRSxFQUFFLE1BRVY7SUFFRCxHQUFHLENBQUMsR0FBRyxFQUFFLEVBQUUsTUFPVjtJQUdELElBQUksQ0FBQyxHQUFHLEVBQUUsRUFBRSxNQU1YO0lBRUQ7OztPQUdHO0lBQ0csSUFBSSxJQUFJLE9BQU8sQ0FBQyxFQUFFLEdBQUcsSUFBSSxDQUFDLENBUy9CO0lBRUQsTUFBTSxrQkFFTDtJQUVEOzs7Ozs7O09BT0c7SUFDSCxNQUFNLENBQUMsZUFBZSxDQUFDLEdBQUcsRUFBRSxHQUFHLEdBQUcsRUFBRSxDQUtuQztJQUVELE1BQU0sS0FBSyxNQUFNLDJDQUdoQjtDQUNGO0FBS0Q7O0dBRUc7QUFDSCxNQUFNLFdBQVcsRUFBRTtJQUNqQixhQUFhO0lBQ2IsU0FBUyxFQUFFLElBQUksQ0FBQztDQUNqQjtBQUVEOzs7O0dBSUc7QUFDSCxxQkFBYSxFQUFHLFNBQVEsU0FBUztJQUMvQixNQUFNLENBQUMsSUFBSSxLQUFjO0lBQ3pCLE1BQU0sQ0FBQyxPQUFPLFNBQXVFO0lBQ3JGLE9BQU8sQ0FBQyxNQUFNLENBQUMsVUFBVSxDQUE2QztJQUN0RSxPQUFPLENBQUMsTUFBTSxDQUFDLFFBQVEsQ0FBOEI7SUFFckQsQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLFdBRWY7SUFFRCxJQUFJLEVBQUUsSUFBSSxFQUFFLENBRVg7SUFFRCxJQUFJLEVBQUUsSUFBSSxFQUFFLENBRVg7SUFFRCxZQUFZLEtBQUssRUFBRSxNQUFNLEdBQUcsTUFBTSxHQUFHLE9BQU8sR0FBRyxFQUFFLEdBQUcsTUFBTSxFQUV6RDtJQUVELFNBQVMsQ0FBQyxPQUFPLFdBRWhCO0lBRUQsTUFBTSxDQUFDLE1BQU0sT0FFWjtJQUVELE1BQU0sQ0FBQyxJQUFJLE9BRVY7SUFFRCxNQUFNLENBQUMsVUFBVSxDQUFDLE1BQU0sRUFBRSxNQUFNLEdBQUcsWUFBWSxNQUU5QztJQUVELE1BQU0sQ0FBQyxnQkFBZ0IsQ0FBQyxNQUFNLEVBQUUsTUFBTSxNQUVyQztJQUVEOzs7Ozs7O09BT0c7SUFDSCxNQUFNLENBQUMsVUFBVSxDQUFDLEdBQUcsRUFBRSxNQUFNLE1BUzVCO0lBRUQ7Ozs7T0FJRztJQUNILE1BQU0sQ0FBQyxhQUFhLENBQUMsR0FBRyxFQUFFLE1BQU0sTUFFL0I7SUFFRCxNQUFNLENBQUMsV0FBVyxDQUFDLElBQUksRUFBRSxFQUFFLEVBQUUsR0FBRyxFQUFFLEVBQUUsR0FBRyxFQUFFLENBRXhDO0lBRUQsR0FBRyxDQUFDLEdBQUcsRUFBRSxFQUFFLE1BRVY7SUFFRDs7O09BR0c7SUFDRyxJQUFJLElBQUksT0FBTyxDQUFDLEVBQUUsR0FBRyxJQUFJLENBQUMsQ0FTL0I7SUFFRCxNQUFNLGtCQUVMO0lBRUQsUUFBUSxTQUtQO0lBRUQsTUFBTSxLQUFLLE1BQU0sMkNBRWhCO0NBQ0Y7QUFnQ0QsNkdBQTZHO0FBQzdHLHdCQUFnQixRQUFRLENBQUMsTUFBTSxFQUFFLE1BQU0sU0FBUyxTQUFTLEVBQUUsRUFBRSxFQUFFLENBQUMsS0FBSyxFQUFFLE1BQU0sS0FBSyxNQUFNLEVBQUUsS0FBSyxFQUFFLFlBQVksQ0FBQyxNQUFNLENBQUMsNkJBRXBIIn0=

package/dest/curves/bn254/field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../../src/curves/bn254/field.ts"],"names":[],"mappings":"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"}

package/dest/{fields/fields.js → curves/bn254/field.js}

@@ -1,19 +1,17 @@
+var _computedKey, _computedKey1;
 import { BarretenbergSync } from '@aztec/bb.js';
 import { inspect } from 'util';
-import { toBigIntBE, toBufferBE } from '../bigint-buffer/index.js';
-import { randomBytes } from '../crypto/random/index.js';
-import { hexSchemaFor } from '../schemas/utils.js';
-import { BufferReader } from '../serialize/buffer_reader.js';
-import { TypeRegistry } from '../serialize/type_registry.js';
-const ZERO_BUFFER = Buffer.alloc(32);
+import { toBigIntBE, toBufferBE } from '../../bigint-buffer/index.js';
+import { randomBytes } from '../../crypto/random/index.js';
+import { hexSchemaFor } from '../../schemas/utils.js';
+import { BufferReader } from '../../serialize/buffer_reader.js';
+import { TypeRegistry } from '../../serialize/type_registry.js';
 /**
  * Base field class.
- * Conversions from Buffer to BigInt and vice-versa are not cheap.
- * We allow construction with either form and lazily convert to other as needed.
- * We only check we are within the field modulus when initializing with bigint.
+ * Uses bigint as the internal representation.
+ * Buffers are generated on demand from the bigint value.
  */ class BaseField {
     static SIZE_IN_BYTES = 32;
-    asBuffer;
     asBigInt;
     /**
    * Return bigint representation.
@@ -29,79 +27,71 @@ const ZERO_BUFFER = Buffer.alloc(32);
             if (value.length > BaseField.SIZE_IN_BYTES) {
                 throw new Error(`Value length ${value.length} exceeds ${BaseField.SIZE_IN_BYTES}`);
             }
-            this.asBuffer = value.length === BaseField.SIZE_IN_BYTES ? value : Buffer.concat([
-                Buffer.alloc(BaseField.SIZE_IN_BYTES - value.length),
-                value
-            ]);
+            this.asBigInt = toBigIntBE(value);
         } else if (typeof value === 'bigint' || typeof value === 'number' || typeof value === 'boolean') {
             this.asBigInt = BigInt(value);
-            if (this.asBigInt >= this.modulus()) {
-                throw new Error(`Value 0x${this.asBigInt.toString(16)} is greater or equal to field modulus.`);
-            }
         } else if (value instanceof BaseField) {
-            this.asBuffer = value.asBuffer;
             this.asBigInt = value.asBigInt;
         } else {
             throw new Error(`Type '${typeof value}' with value '${value}' passed to BaseField ctor.`);
         }
+        if (this.asBigInt < 0n) {
+            throw new Error(`Value 0x${this.asBigInt.toString(16)} is negative.`);
+        } else if (this.asBigInt >= this.modulus()) {
+            throw new Error(`Value 0x${this.asBigInt.toString(16)} is greater or equal to field modulus.`);
+        }
     }
     /**
-   * We return a copy of the Buffer to ensure this remains immutable.
+   * Converts the bigint to a Buffer.
    */ toBuffer() {
-        if (!this.asBuffer) {
-            this.asBuffer = toBufferBE(this.asBigInt, 32);
-        }
-        return Buffer.from(this.asBuffer);
+        return toBufferBE(this.asBigInt, 32);
     }
     toString() {
-        return `0x${this.toBuffer().toString('hex')}`;
+        return `0x${this.asBigInt.toString(16).padStart(64, '0')}`;
     }
     toBigInt() {
-        if (this.asBigInt === undefined) {
-            this.asBigInt = toBigIntBE(this.asBuffer);
-            if (this.asBigInt >= this.modulus()) {
-                throw new Error(`Value 0x${this.asBigInt.toString(16)} is greater or equal to field modulus.`);
-            }
-        }
         return this.asBigInt;
     }
     toBool() {
-        return Boolean(this.toBigInt());
+        return this.asBigInt !== 0n;
     }
     /**
    * Converts this field to a number.
    * Throws if the underlying value is greater than MAX_SAFE_INTEGER.
    */ toNumber() {
-        const value = this.toBigInt();
-        if (value > Number.MAX_SAFE_INTEGER) {
-            throw new Error(`Value ${value.toString(16)} greater than than max safe integer`);
+        if (this.asBigInt > Number.MAX_SAFE_INTEGER) {
+            throw new Error(`Value ${this.asBigInt.toString(16)} greater than than max safe integer`);
         }
-        return Number(value);
+        return Number(this.asBigInt);
     }
     /**
    * Converts this field to a number.
    * May cause loss of precision if the underlying value is greater than MAX_SAFE_INTEGER.
    */ toNumberUnsafe() {
-        const value = this.toBigInt();
-        return Number(value);
+        return Number(this.asBigInt);
     }
     toShortString() {
         const str = this.toString();
         return `${str.slice(0, 10)}...${str.slice(-4)}`;
     }
     equals(rhs) {
-        return this.toBuffer().equals(rhs.toBuffer());
+        return this.asBigInt === rhs.asBigInt;
     }
     lt(rhs) {
-        return this.toBigInt() < rhs.toBigInt();
+        return this.asBigInt < rhs.asBigInt;
     }
     cmp(rhs) {
-        const lhsBigInt = this.toBigInt();
-        const rhsBigInt = rhs.toBigInt();
-        return lhsBigInt === rhsBigInt ? 0 : lhsBigInt < rhsBigInt ? -1 : 1;
+        return BaseField.cmpAsBigInt(this.asBigInt, rhs.asBigInt);
+    }
+    static cmp(lhs, rhs) {
+        return lhs.cmp(rhs);
+    }
+    // Actual bigint comparison. Arguments must have been validated previously.
+    static cmpAsBigInt(lhs, rhs) {
+        return lhs === rhs ? 0 : lhs < rhs ? -1 : 1;
     }
     isZero() {
-        return this.toBuffer().equals(ZERO_BUFFER);
+        return this.asBigInt === 0n;
     }
     isEmpty() {
         return this.isZero();
@@ -141,8 +131,9 @@ const ZERO_BUFFER = Buffer.alloc(32);
         throw new Error(`Invalid hex-encoded string: "${buf}"`);
     }
     const buffer = Buffer.from(checked.length % 2 === 1 ? '0' + checked : checked, 'hex');
-    return new f(buffer);
+    return new f(toBigIntBE(buffer));
 }
+_computedKey = inspect.custom;
 /**
  * Fr field class.
  * @dev This class is used to represent elements of BN254 scalar field or elements in the base field of Grumpkin.
@@ -155,7 +146,7 @@ const ZERO_BUFFER = Buffer.alloc(32);
     constructor(value){
         super(value);
     }
-    [inspect.custom]() {
+    [_computedKey]() {
         return `Fr<${this.toString()}>`;
     }
     modulus() {
@@ -233,29 +224,41 @@ const ZERO_BUFFER = Buffer.alloc(32);
    * Computes a square root of the field element.
    * @returns A square root of the field element (null if it does not exist).
    */ async sqrt() {
-        const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
-        const wasm = api.getWasm();
-        const [buf] = wasm.callWasmExport('bn254_fr_sqrt', [
-            this.toBuffer()
-        ], [
-            Fr.SIZE_IN_BYTES + 1
-        ]);
-        const isSqrt = buf[0] === 1;
-        if (!isSqrt) {
+        await BarretenbergSync.initSingleton();
+        const api = BarretenbergSync.getSingleton();
+        const response = api.bn254FrSqrt({
+            input: this.toBuffer()
+        });
+        if (!response.isSquareRoot) {
             // Field element is not a quadratic residue mod p so it has no square root.
             return null;
         }
-        return new Fr(Buffer.from(buf.slice(1)));
+        return Fr.fromBuffer(Buffer.from(response.value));
     }
     toJSON() {
         return this.toString();
     }
+    /**
+   * Creates an Fr instance from a plain object without Zod validation.
+   * This method is optimized for performance and skips validation, making it suitable
+   * for deserializing trusted data (e.g., from C++ via MessagePack).
+   * Handles buffers, strings, numbers, bigints, or existing instances.
+   * @param obj - Plain object, buffer, string, number, bigint, boolean, or Fr instance
+   * @returns An Fr instance
+   */ static fromPlainObject(obj) {
+        if (obj instanceof Fr) {
+            return obj;
+        }
+        return new Fr(obj);
+    }
     static get schema() {
+        // Serialization from hex string.
         return hexSchemaFor(Fr);
     }
 }
 // For deserializing JSON.
 TypeRegistry.register('Fr', Fr);
+_computedKey1 = inspect.custom;
 /**
  * Fq field class.
  * @dev This class is used to represent elements of BN254 base field or elements in the scalar field of Grumpkin.
@@ -265,7 +268,7 @@ TypeRegistry.register('Fr', Fr);
     static MODULUS = 0x30644e72e131a029b85045b68181585d97816a916871ca8d3c208c16d87cfd47n;
     static HIGH_SHIFT = BigInt(BaseField.SIZE_IN_BYTES / 2 * 8);
     static LOW_MASK = (1n << Fq.HIGH_SHIFT) - 1n;
-    [inspect.custom]() {
+    [_computedKey1]() {
         return `Fq<${this.toString()}>`;
     }
     get lo() {
@@ -321,9 +324,33 @@ TypeRegistry.register('Fr', Fr);
     add(rhs) {
         return new Fq((this.toBigInt() + rhs.toBigInt()) % Fq.MODULUS);
     }
+    /**
+   * Computes a square root of the field element.
+   * @returns A square root of the field element (null if it does not exist).
+   */ async sqrt() {
+        await BarretenbergSync.initSingleton();
+        const api = BarretenbergSync.getSingleton();
+        const response = api.bn254FqSqrt({
+            input: this.toBuffer()
+        });
+        if (!response.isSquareRoot) {
+            // Field element is not a quadratic residue mod p so it has no square root.
+            return null;
+        }
+        return Fq.fromBuffer(Buffer.from(response.value));
+    }
     toJSON() {
         return this.toString();
     }
+    toFields() {
+        // The following has to match the order of the limbs in EmbeddedCurveScalar struct in noir::std. This is because
+        // this function is used when returning Scalar from the getAddressSecret oracle and in Noir the values get deserialized
+        // using the intrinsic serialization of Noir (which follows the order of the fields/members in the struct).
+        return [
+            this.lo,
+            this.hi
+        ];
+    }
     static get schema() {
         return hexSchemaFor(Fq);
     }
@@ -360,11 +387,10 @@ TypeRegistry.register('Fq', Fq);
         ];
     }
 }
-export const GrumpkinScalar = Fq;
 /** Wraps a function that returns a buffer so that all results are reduced into a field of the given type. */ export function reduceFn(fn, field) {
     return (input)=>fromBufferReduce(fn(input), field);
 }
-/** If we are in test mode, we register a special equality for fields. */ if (process.env.NODE_ENV === 'test' && typeof expect !== 'undefined') {
+/** If we are in test mode, we register a special equality for fields. */ if (process.env.NODE_ENV === 'test') {
     const areFieldsEqual = (a, b)=>{
         const isAField = a instanceof BaseField;
         const isBField = b instanceof BaseField;
@@ -376,8 +402,13 @@ export const GrumpkinScalar = Fq;
             return false;
         }
     };
-    // `addEqualityTesters` doesn't seem to be in the types yet.
-    expect.addEqualityTesters([
-        areFieldsEqual
-    ]);
+    if (typeof expect !== 'undefined') {
+        // `addEqualityTesters` doesn't seem to be in the types yet.
+        expect.addEqualityTesters([
+            areFieldsEqual
+        ]);
+    } else {
+        globalThis.__extraEqualityTesters ??= [];
+        globalThis.__extraEqualityTesters.push(areFieldsEqual);
+    }
 }

package/dest/curves/bn254/index.d.ts

@@ -0,0 +1,3 @@
+export * from './field.js';
+export * from './point.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9jdXJ2ZXMvYm4yNTQvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxZQUFZLENBQUM7QUFDM0IsY0FBYyxZQUFZLENBQUMifQ==

package/dest/curves/bn254/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/curves/bn254/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dest/curves/bn254/index.js

@@ -0,0 +1,2 @@
+export * from './field.js';
+export * from './point.js';

package/dest/curves/bn254/point.d.ts

@@ -0,0 +1,54 @@
+import { Fq, Fr } from './field.js';
+/**
+ * BN254 G1 point using foundation field classes.
+ * Represents a point on the BN254 elliptic curve in affine coordinates.
+ */
+export declare class Bn254G1Point {
+    readonly x: Fq;
+    readonly y: Fq;
+    constructor(x: Fq, y: Fq);
+    private toBbApiPoint;
+    private static fromBbApiPoint;
+    isOnCurve(): Promise<boolean>;
+    /**
+     * Get the generator point for BN254 G1, or perform scalar multiplication.
+     * When called without arguments, returns the base generator point.
+     * When called with a scalar, returns scalar * generator (useful for public key derivation).
+     */
+    static generator(scalar?: Fr): Promise<Bn254G1Point>;
+    /**
+     * Decompress a BN254 G1 point from compressed form (32 bytes).
+     * The compressed format encodes the x-coordinate and the sign bit of the y-coordinate
+     * in the most significant bit.
+     */
+    static fromCompressed(compressed: Buffer): Promise<Bn254G1Point>;
+    /**
+     * Compress this BN254 G1 point to 32 bytes.
+     * The compressed format encodes the x-coordinate and the sign bit of the y-coordinate
+     * in the most significant bit (bit 255).
+     */
+    compress(): Buffer;
+    equals(other: Bn254G1Point): boolean;
+    toString(): string;
+}
+/**
+ * BN254 G2 point using foundation field classes.
+ * Represents a point on the BN254 G2 curve (twist curve) in affine coordinates.
+ * G2 points use extension field coordinates (Fq2).
+ */
+export declare class Bn254G2Point {
+    readonly x: [Fq, Fq];
+    readonly y: [Fq, Fq];
+    constructor(x: [Fq, Fq], y: [Fq, Fq]);
+    private toBbApiPoint;
+    private static fromBbApiPoint;
+    /**
+     * Get the generator point for BN254 G2, or perform scalar multiplication.
+     * When called without arguments, returns the base generator point.
+     * When called with a scalar, returns scalar * generator.
+     */
+    static generator(scalar?: Fr): Promise<Bn254G2Point>;
+    equals(other: Bn254G2Point): boolean;
+    toString(): string;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicG9pbnQuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9jdXJ2ZXMvYm4yNTQvcG9pbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBUUEsT0FBTyxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFFcEM7OztHQUdHO0FBQ0gscUJBQWEsWUFBWTthQUVMLENBQUMsRUFBRSxFQUFFO2FBQ0wsQ0FBQyxFQUFFLEVBQUU7SUFGdkIsWUFDa0IsQ0FBQyxFQUFFLEVBQUUsRUFDTCxDQUFDLEVBQUUsRUFBRSxFQUNuQjtJQUVKLE9BQU8sQ0FBQyxZQUFZO0lBT3BCLE9BQU8sQ0FBQyxNQUFNLENBQUMsY0FBYztJQUl2QixTQUFTLElBQUksT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQU9sQztJQUVEOzs7O09BSUc7SUFDSCxPQUFhLFNBQVMsQ0FBQyxNQUFNLENBQUMsRUFBRSxFQUFFLEdBQUcsT0FBTyxDQUFDLFlBQVksQ0FBQyxDQWlCekQ7SUFFRDs7OztPQUlHO0lBQ0gsT0FBYSxjQUFjLENBQUMsVUFBVSxFQUFFLE1BQU0sR0FBRyxPQUFPLENBQUMsWUFBWSxDQUFDLENBWXJFO0lBRUQ7Ozs7T0FJRztJQUNILFFBQVEsSUFBSSxNQUFNLENBU2pCO0lBRUQsTUFBTSxDQUFDLEtBQUssRUFBRSxZQUFZLEdBQUcsT0FBTyxDQUVuQztJQUVELFFBQVEsSUFBSSxNQUFNLENBRWpCO0NBQ0Y7QUFFRDs7OztHQUlHO0FBQ0gscUJBQWEsWUFBWTthQUVMLENBQUMsRUFBRSxDQUFDLEVBQUUsRUFBRSxFQUFFLENBQUM7YUFDWCxDQUFDLEVBQUUsQ0FBQyxFQUFFLEVBQUUsRUFBRSxDQUFDO0lBRjdCLFlBQ2tCLENBQUMsRUFBRSxDQUFDLEVBQUUsRUFBRSxFQUFFLENBQUMsRUFDWCxDQUFDLEVBQUUsQ0FBQyxFQUFFLEVBQUUsRUFBRSxDQUFDLEVBQ3pCO0lBRUosT0FBTyxDQUFDLFlBQVk7SUFPcEIsT0FBTyxDQUFDLE1BQU0sQ0FBQyxjQUFjO0lBTzdCOzs7O09BSUc7SUFDSCxPQUFhLFNBQVMsQ0FBQyxNQUFNLENBQUMsRUFBRSxFQUFFLEdBQUcsT0FBTyxDQUFDLFlBQVksQ0FBQyxDQWlCekQ7SUFFRCxNQUFNLENBQUMsS0FBSyxFQUFFLFlBQVksR0FBRyxPQUFPLENBT25DO0lBRUQsUUFBUSxJQUFJLE1BQU0sQ0FFakI7Q0FDRiJ9

package/dest/curves/bn254/point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"point.d.ts","sourceRoot":"","sources":["../../../src/curves/bn254/point.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAEpC;;;GAGG;AACH,qBAAa,YAAY;aAEL,CAAC,EAAE,EAAE;aACL,CAAC,EAAE,EAAE;IAFvB,YACkB,CAAC,EAAE,EAAE,EACL,CAAC,EAAE,EAAE,EACnB;IAEJ,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,MAAM,CAAC,cAAc;IAIvB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAOlC;IAED;;;;OAIG;IACH,OAAa,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAiBzD;IAED;;;;OAIG;IACH,OAAa,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAYrE;IAED;;;;OAIG;IACH,QAAQ,IAAI,MAAM,CASjB;IAED,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAEnC;IAED,QAAQ,IAAI,MAAM,CAEjB;CACF;AAED;;;;GAIG;AACH,qBAAa,YAAY;aAEL,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;aACX,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IAF7B,YACkB,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EACX,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EACzB;IAEJ,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,MAAM,CAAC,cAAc;IAO7B;;;;OAIG;IACH,OAAa,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAiBzD;IAED,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAOnC;IAED,QAAQ,IAAI,MAAM,CAEjB;CACF"}