@aztec/foundation 0.0.0-test.0 → 0.0.1-commit.03f7ef2

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

@@ -0,0 +1,179 @@
+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;
+    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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmllbGQuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9jdXJ2ZXMvYm4yNTQvZmllbGQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLE1BQU0sQ0FBQztBQUsvQixPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFLaEU7O0dBRUc7QUFDSCxLQUFLLFlBQVksQ0FBQyxDQUFDLFNBQVMsU0FBUyxJQUFJO0lBQ3ZDLEtBQUssS0FBSyxFQUFFLEdBQUcsR0FBRyxDQUFDLENBQUM7SUFDcEI7O09BRUc7SUFDSCxPQUFPLEVBQUUsTUFBTSxDQUFDO0NBQ2pCLENBQUM7QUFFRjs7OztHQUlHO0FBQ0gsdUJBQWUsU0FBUztJQUN0QixNQUFNLENBQUMsYUFBYSxTQUFNO0lBQzFCLE9BQU8sQ0FBQyxRQUFRLENBQUMsUUFBUSxDQUFTO0lBRWxDOzs7U0FHSztJQUNMLElBQUksS0FBSyxJQUFJLE1BQU0sQ0FFbEI7SUFFRCxpQ0FBaUM7SUFDakMsSUFBSSxJQUFJLElBQUksTUFBTSxDQUVqQjtJQUVELFNBQVMsYUFBYSxLQUFLLEVBQUUsTUFBTSxHQUFHLE1BQU0sR0FBRyxPQUFPLEdBQUcsU0FBUyxHQUFHLE1BQU0sRUFtQjFFO0lBRUQsU0FBUyxDQUFDLFFBQVEsQ0FBQyxPQUFPLElBQUksTUFBTSxDQUFDO0lBRXJDOztPQUVHO0lBQ0gsUUFBUSxJQUFJLE1BQU0sQ0FFakI7SUFFRCxRQUFRLElBQUksS0FBSyxNQUFNLEVBQUUsQ0FFeEI7SUFFRCxRQUFRLElBQUksTUFBTSxDQUVqQjtJQUVELE1BQU0sSUFBSSxPQUFPLENBRWhCO0lBRUQ7OztPQUdHO0lBQ0gsUUFBUSxJQUFJLE1BQU0sQ0FLakI7SUFFRDs7O09BR0c7SUFDSCxjQUFjLElBQUksTUFBTSxDQUV2QjtJQUVELGFBQWEsSUFBSSxNQUFNLENBR3RCO0lBRUQsTUFBTSxDQUFDLEdBQUcsRUFBRSxT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

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,16 @@
 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 +26,65 @@ 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;
+        const rhsBigInt = rhs.asBigInt;
+        return this.asBigInt === rhsBigInt ? 0 : this.asBigInt < rhsBigInt ? -1 : 1;
     }
     isZero() {
-        return this.toBuffer().equals(ZERO_BUFFER);
+        return this.asBigInt === 0n;
     }
     isEmpty() {
         return this.isZero();
@@ -141,7 +124,7 @@ 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));
 }
 /**
  * Fr field class.
@@ -233,24 +216,35 @@ 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);
     }
 }
@@ -321,9 +315,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 +378,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 +393,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"}

package/dest/curves/bn254/point.js

@@ -0,0 +1,143 @@
+import { BN254_G1_GENERATOR, BN254_G2_GENERATOR, BarretenbergSync } from '@aztec/bb.js';
+import { Fq } from './field.js';
+/**
+ * BN254 G1 point using foundation field classes.
+ * Represents a point on the BN254 elliptic curve in affine coordinates.
+ */ export class Bn254G1Point {
+    x;
+    y;
+    constructor(x, y){
+        this.x = x;
+        this.y = y;
+    }
+    toBbApiPoint() {
+        return {
+            x: this.x.toBuffer(),
+            y: this.y.toBuffer()
+        };
+    }
+    static fromBbApiPoint(point) {
+        return new Bn254G1Point(Fq.fromBuffer(Buffer.from(point.x)), Fq.fromBuffer(Buffer.from(point.y)));
+    }
+    async isOnCurve() {
+        await BarretenbergSync.initSingleton();
+        const api = BarretenbergSync.getSingleton();
+        const apiPoint = this.toBbApiPoint();
+        const response = api.bn254G1IsOnCurve({
+            point: apiPoint
+        });
+        return response.isOnCurve;
+    }
+    /**
+   * 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 async generator(scalar) {
+        if (!scalar) {
+            return new Bn254G1Point(Fq.fromBuffer(Buffer.from(BN254_G1_GENERATOR.x)), Fq.fromBuffer(Buffer.from(BN254_G1_GENERATOR.y)));
+        }
+        await BarretenbergSync.initSingleton();
+        const api = BarretenbergSync.getSingleton();
+        const response = api.bn254G1Mul({
+            point: BN254_G1_GENERATOR,
+            scalar: scalar.toBuffer()
+        });
+        return Bn254G1Point.fromBbApiPoint(response.point);
+    }
+    /**
+   * 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 async fromCompressed(compressed) {
+        if (compressed.length !== 32) {
+            throw new Error('Invalid compressed point length');
+        }
+        await BarretenbergSync.initSingleton();
+        const api = BarretenbergSync.getSingleton();
+        const response = api.bn254G1FromCompressed({
+            compressed: new Uint8Array(compressed)
+        });
+        return Bn254G1Point.fromBbApiPoint(response.point);
+    }
+    /**
+   * 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() {
+        const xBytes = this.x.toBuffer();
+        // Get the least significant bit of y to determine the sign
+        const yLsb = this.y.toBigInt() & 1n;
+        // If y is odd, set the most significant bit (bit 255) of the output
+        if (yLsb === 1n) {
+            xBytes[0] |= 0x80;
+        }
+        return xBytes;
+    }
+    equals(other) {
+        return this.x.equals(other.x) && this.y.equals(other.y);
+    }
+    toString() {
+        return `Bn254G1Point(x: ${this.x.toString()}, y: ${this.y.toString()})`;
+    }
+}
+/**
+ * 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 class Bn254G2Point {
+    x;
+    y;
+    constructor(x, y){
+        this.x = x;
+        this.y = y;
+    }
+    toBbApiPoint() {
+        return {
+            x: [
+                this.x[0].toBuffer(),
+                this.x[1].toBuffer()
+            ],
+            y: [
+                this.y[0].toBuffer(),
+                this.y[1].toBuffer()
+            ]
+        };
+    }
+    static fromBbApiPoint(point) {
+        return new Bn254G2Point([
+            Fq.fromBuffer(Buffer.from(point.x[0])),
+            Fq.fromBuffer(Buffer.from(point.x[1]))
+        ], [
+            Fq.fromBuffer(Buffer.from(point.y[0])),
+            Fq.fromBuffer(Buffer.from(point.y[1]))
+        ]);
+    }
+    /**
+   * 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 async generator(scalar) {
+        if (!scalar) {
+            return new Bn254G2Point([
+                Fq.fromBuffer(Buffer.from(BN254_G2_GENERATOR.x[0])),
+                Fq.fromBuffer(Buffer.from(BN254_G2_GENERATOR.x[1]))
+            ], [
+                Fq.fromBuffer(Buffer.from(BN254_G2_GENERATOR.y[0])),
+                Fq.fromBuffer(Buffer.from(BN254_G2_GENERATOR.y[1]))
+            ]);
+        }
+        await BarretenbergSync.initSingleton();
+        const api = BarretenbergSync.getSingleton();
+        const response = api.bn254G2Mul({
+            point: BN254_G2_GENERATOR,
+            scalar: scalar.toBuffer()
+        });
+        return Bn254G2Point.fromBbApiPoint(response.point);
+    }
+    equals(other) {
+        return this.x[0].equals(other.x[0]) && this.x[1].equals(other.x[1]) && this.y[0].equals(other.y[0]) && this.y[1].equals(other.y[1]);
+    }
+    toString() {
+        return `Bn254G2Point(x: (${this.x[0].toString()}, ${this.x[1].toString()}), y: (${this.y[0].toString()}, ${this.y[1].toString()}))`;
+    }
+}

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

@@ -0,0 +1,10 @@
+import { Fq } from '../bn254/field.js';
+export * from './point.js';
+/**
+ * GrumpkinScalar is an Fq.
+ * @remarks Called GrumpkinScalar because it is used to represent elements in Grumpkin's scalar field as defined in
+ *          the Aztec Protocol Specs.
+ */
+export type GrumpkinScalar = Fq;
+export declare const GrumpkinScalar: typeof Fq;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9jdXJ2ZXMvZ3J1bXBraW4vaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBRXZDLGNBQWMsWUFBWSxDQUFDO0FBRTNCOzs7O0dBSUc7QUFDSCxNQUFNLE1BQU0sY0FBYyxHQUFHLEVBQUUsQ0FBQztBQUNoQyxlQUFPLE1BQU0sY0FBYyxXQUFLLENBQUMifQ==