@aztec-labs/foundation 6.0.0-nightly.20260829

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==

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/curves/grumpkin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAEvC,cAAc,YAAY,CAAC;AAE3B;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,EAAE,CAAC;AAChC,eAAO,MAAM,cAAc,WAAK,CAAC"}

package/dest/curves/grumpkin/index.js

@@ -0,0 +1,3 @@
+import { Fq } from '../bn254/field.js';
+export * from './point.js';
+export const GrumpkinScalar = Fq;

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

@@ -0,0 +1,168 @@
+import { BufferReader, FieldReader } from '../../serialize/index.js';
+import { Fr } from '../bn254/field.js';
+/**
+ * Represents a Point on an elliptic curve with x and y coordinates.
+ * The Point class provides methods for creating instances from different input types,
+ * converting instances to various output formats, and checking the equality of points.
+ * TODO(#7386): Clean up this class.
+ */
+export declare class Point {
+    /**
+     * The point's x coordinate
+     */
+    readonly x: Fr;
+    /**
+     * The point's y coordinate
+     */
+    readonly y: Fr;
+    static INFINITY: Point;
+    static SIZE_IN_BYTES: number;
+    static COMPRESSED_SIZE_IN_BYTES: number;
+    /** Used to differentiate this class from AztecAddress */
+    readonly kind = "point";
+    /** Whether the point is at infinity */
+    readonly isInfinite: boolean;
+    constructor(
+    /**
+     * The point's x coordinate
+     */
+    x: Fr, 
+    /**
+     * The point's y coordinate
+     */
+    y: Fr);
+    toJSON(): `0x${string}`;
+    static get schema(): import("zod").ZodType<Point, string, import("zod/v4/core").$ZodTypeInternals<Point, string>>;
+    /**
+     * Creates a Point 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, existing instances, or objects with x, y, and isInfinite fields.
+     * @param obj - Plain object, buffer, or Point instance
+     * @returns A Point instance
+     */
+    static fromPlainObject(obj: any): Point;
+    /**
+     * Generate a random Point instance that is on the curve.
+     *
+     * @returns A randomly generated Point instance.
+     */
+    static random(): Promise<Point>;
+    /**
+     * Create a Point instance from a given buffer or BufferReader.
+     * The input 'buffer' should have exactly 64 bytes representing the x and y coordinates.
+     *
+     * @param buffer - The buffer or BufferReader containing the x and y coordinates of the point.
+     * @returns A Point instance.
+     */
+    static fromBuffer(buffer: Buffer | BufferReader): Point;
+    /**
+     * Create a Point instance from a compressed buffer.
+     * The input 'buffer' should have exactly 33 bytes representing the x coordinate and the sign of the y coordinate.
+     *
+     * @param buffer - The buffer containing the x coordinate and the sign of the y coordinate.
+     * @returns A Point instance.
+     */
+    static fromCompressedBuffer(buffer: Buffer | BufferReader): Promise<Point>;
+    /**
+     * Create a Point instance from a hex-encoded string.
+     * The input should be prefixed with '0x' or not, and have exactly 128 hex characters representing the x and y coordinates.
+     * Throws an error if the input length is invalid or coordinate values are out of range.
+     *
+     * @param str - The hex-encoded string representing the Point coordinates.
+     * @returns A Point instance.
+     */
+    static fromString(str: string): Point;
+    /**
+     * Returns the contents of the point as an array of 2 fields.
+     * @returns The point as an array of 2 fields
+     */
+    toFields(): Fr[];
+    static fromFields(fields: Fr[] | FieldReader): Point;
+    /**
+     * Uses the x coordinate and isPositive flag (+/-) to reconstruct the point.
+     * @dev The y coordinate can be derived from the x coordinate and the "sign" flag by solving the grumpkin curve
+     * equation for y.
+     * @param x - The x coordinate of the point
+     * @param sign - The "sign" of the y coordinate - note that this is not a sign as is known in integer arithmetic.
+     * Instead it is a boolean flag that determines whether the y coordinate is <= (Fr.MODULUS - 1) / 2
+     * @returns The point as an array of 2 fields
+     */
+    static fromXAndSign(x: Fr, sign: boolean): Promise<Point>;
+    /**
+     * @param x - The x coordinate of the point
+     * @returns y^2 such that y^2 = x^3 - 17
+     */
+    static YFromX(x: Fr): Promise<Fr | null>;
+    /**
+     * Returns the x coordinate and the sign of the y coordinate.
+     * @dev The y sign can be determined by checking if the y coordinate is greater than half of the modulus.
+     * @returns The x coordinate and the sign of the y coordinate.
+     */
+    toXAndSign(): [Fr, boolean];
+    /**
+     * Returns the contents of the point as BigInts.
+     * @returns The point as BigInts
+     */
+    toBigInts(): {
+        x: bigint;
+        y: bigint;
+    };
+    /**
+     * Converts the Point instance to a Buffer representation of the coordinates.
+     * @returns A Buffer representation of the Point instance.
+     * @dev Note that toBuffer does not include the isInfinite flag. The point at infinity is serialized as (0, 0).
+     */
+    toBuffer(): Buffer<ArrayBufferLike>;
+    /**
+     * Converts the Point instance to a compressed Buffer representation of the coordinates.
+     * @returns A Buffer representation of the Point instance
+     */
+    toCompressedBuffer(): Buffer<ArrayBufferLike>;
+    /**
+     * Convert the Point instance to a hexadecimal string representation.
+     * The output string is prefixed with '0x' and consists of exactly 128 hex characters,
+     * representing the concatenated x and y coordinates of the point.
+     *
+     * @returns A hex-encoded string representing the Point instance.
+     */
+    toString(): `0x${string}`;
+    /**
+     * Generate a short string representation of the Point instance.
+     * The returned string includes the first 10 and last 4 characters of the full string representation,
+     * with '...' in between to indicate truncation. This is useful for displaying or logging purposes
+     * when the full string representation may be too long.
+     *
+     * @returns A truncated string representation of the Point instance.
+     */
+    toShortString(): string;
+    toNoirStruct(): {
+        x: Fr;
+        y: Fr;
+    };
+    toWrappedNoirStruct(): {
+        inner: {
+            x: Fr;
+            y: Fr;
+        };
+    };
+    /**
+     * Check if two Point instances are equal by comparing their buffer values.
+     * Returns true if the buffer values are the same, and false otherwise.
+     *
+     * @param rhs - The Point instance to compare with the current instance.
+     * @returns A boolean indicating whether the two Point instances are equal.
+     */
+    equals(rhs: Point): boolean;
+    isZero(): boolean;
+    /**
+     * @param x - The x coordinate of the point
+     * @param y - The y coordinate of the point
+     * @returns Whether the point exists on Grumpkin
+     */
+    isOnCurve(): boolean;
+}
+export declare class NotOnCurveError extends Error {
+    constructor(x: Fr);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicG9pbnQuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9jdXJ2ZXMvZ3J1bXBraW4vcG9pbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBR0EsT0FBTyxFQUFFLFlBQVksRUFBRSxXQUFXLEVBQXFCLE1BQU0sMEJBQTBCLENBQUM7QUFFeEYsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBRXZDOzs7OztHQUtHO0FBQ0gscUJBQWEsS0FBSztJQVlkOztPQUVHO2FBQ2EsQ0FBQyxFQUFFLEVBQUU7SUFDckI7O09BRUc7YUFDYSxDQUFDLEVBQUUsRUFBRTtJQWxCdkIsTUFBTSxDQUFDLFFBQVEsUUFBK0I7SUFDOUMsTUFBTSxDQUFDLGFBQWEsU0FBd0I7SUFDNUMsTUFBTSxDQUFDLHdCQUF3QixTQUFvQjtJQUVuRCx5REFBeUQ7SUFDekQsU0FBZ0IsSUFBSSxXQUFXO0lBRS9CLHVDQUF1QztJQUN2QyxTQUFnQixVQUFVLEVBQUUsT0FBTyxDQUFDO0lBRXBDO0lBQ0U7O09BRUc7SUFDYSxDQUFDLEVBQUUsRUFBRTtJQUNyQjs7T0FFRztJQUNhLENBQUMsRUFBRSxFQUFFLEVBS3RCO0lBRUQsTUFBTSxrQkFFTDtJQUVELE1BQU0sS0FBSyxNQUFNLGlHQUdoQjtJQUVEOzs7Ozs7O09BT0c7SUFDSCxNQUFNLENBQUMsZUFBZSxDQUFDLEdBQUcsRUFBRSxHQUFHLEdBQUcsS0FBSyxDQVF0QztJQUVEOzs7O09BSUc7SUFDSCxPQUFhLE1BQU0sbUJBWWxCO0lBRUQ7Ozs7OztPQU1HO0lBQ0gsTUFBTSxDQUFDLFVBQVUsQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLFlBQVksU0FHOUM7SUFFRDs7Ozs7O09BTUc7SUFDSCxNQUFNLENBQUMsb0JBQW9CLENBQUMsTUFBTSxFQUFFLE1BQU0sR0FBRyxZQUFZLEdBQUcsT0FBTyxDQUFDLEtBQUssQ0FBQyxDQVF6RTtJQUVEOzs7Ozs7O09BT0c7SUFDSCxNQUFNLENBQUMsVUFBVSxDQUFDLEdBQUcsRUFBRSxNQUFNLFNBRTVCO0lBRUQ7OztPQUdHO0lBQ0gsUUFBUSxTQUVQO0lBRUQsTUFBTSxDQUFDLFVBQVUsQ0FBQyxNQUFNLEVBQUUsRUFBRSxFQUFFLEdBQUcsV0FBVyxTQUkzQztJQUVEOzs7Ozs7OztPQVFHO0lBQ0gsT0FBYSxZQUFZLENBQUMsQ0FBQyxFQUFFLEVBQUUsRUFBRSxJQUFJLEVBQUUsT0FBTyxrQkFjN0M7SUFFRDs7O09BR0c7SUFDSCxNQUFNLENBQUMsTUFBTSxDQUFDLENBQUMsRUFBRSxFQUFFLEdBQUcsT0FBTyxDQUFDLEVBQUUsR0FBRyxJQUFJLENBQUMsQ0FPdkM7SUFFRDs7OztPQUlHO0lBQ0gsVUFBVSxJQUFJLENBQUMsRUFBRSxFQUFFLE9BQU8sQ0FBQyxDQUUxQjtJQUVEOzs7T0FHRztJQUNILFNBQVM7OztNQUtSO0lBRUQ7Ozs7T0FJRztJQUNILFFBQVEsNEJBTVA7SUFFRDs7O09BR0c7SUFDSCxrQkFBa0IsNEJBV2pCO0lBRUQ7Ozs7OztPQU1HO0lBQ0gsUUFBUSxrQkFFUDtJQUVEOzs7Ozs7O09BT0c7SUFDSCxhQUFhLFdBR1o7SUFFRCxZQUFZOzs7TUFFWDtJQUdELG1CQUFtQjs7Ozs7TUFFbEI7SUFFRDs7Ozs7O09BTUc7SUFDSCxNQUFNLENBQUMsR0FBRyxFQUFFLEtBQUssV0FFaEI7SUFFRCxNQUFNLFlBRUw7SUFFRDs7OztPQUlHO0lBQ0gsU0FBUyxZQVVSO0NBQ0Y7QUFFRCxxQkFBYSxlQUFnQixTQUFRLEtBQUs7SUFDeEMsWUFBWSxDQUFDLEVBQUUsRUFBRSxFQUdoQjtDQUNGIn0=

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

@@ -0,0 +1 @@
+{"version":3,"file":"point.d.ts","sourceRoot":"","sources":["../../../src/curves/grumpkin/point.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAqB,MAAM,0BAA0B,CAAC;AAExF,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAEvC;;;;;GAKG;AACH,qBAAa,KAAK;IAYd;;OAEG;aACa,CAAC,EAAE,EAAE;IACrB;;OAEG;aACa,CAAC,EAAE,EAAE;IAlBvB,MAAM,CAAC,QAAQ,QAA+B;IAC9C,MAAM,CAAC,aAAa,SAAwB;IAC5C,MAAM,CAAC,wBAAwB,SAAoB;IAEnD,yDAAyD;IACzD,SAAgB,IAAI,WAAW;IAE/B,uCAAuC;IACvC,SAAgB,UAAU,EAAE,OAAO,CAAC;IAEpC;IACE;;OAEG;IACa,CAAC,EAAE,EAAE;IACrB;;OAEG;IACa,CAAC,EAAE,EAAE,EAKtB;IAED,MAAM,kBAEL;IAED,MAAM,KAAK,MAAM,iGAGhB;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,KAAK,CAQtC;IAED;;;;OAIG;IACH,OAAa,MAAM,mBAYlB;IAED;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,SAG9C;IAED;;;;;;OAMG;IACH,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAQzE;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,SAE5B;IAED;;;OAGG;IACH,QAAQ,SAEP;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,SAI3C;IAED;;;;;;;;OAQG;IACH,OAAa,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,kBAc7C;IAED;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAOvC;IAED;;;;OAIG;IACH,UAAU,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAE1B;IAED;;;OAGG;IACH,SAAS;;;MAKR;IAED;;;;OAIG;IACH,QAAQ,4BAMP;IAED;;;OAGG;IACH,kBAAkB,4BAWjB;IAED;;;;;;OAMG;IACH,QAAQ,kBAEP;IAED;;;;;;;OAOG;IACH,aAAa,WAGZ;IAED,YAAY;;;MAEX;IAGD,mBAAmB;;;;;MAElB;IAED;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,KAAK,WAEhB;IAED,MAAM,YAEL;IAED;;;;OAIG;IACH,SAAS,YAUR;CACF;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,CAAC,EAAE,EAAE,EAGhB;CACF"}

package/dest/curves/grumpkin/point.js

@@ -0,0 +1,263 @@
+import { toBigIntBE } from '../../bigint-buffer/index.js';
+import { randomBoolean } from '../../crypto/random/index.js';
+import { hexSchemaFor } from '../../schemas/utils.js';
+import { BufferReader, FieldReader, serializeToBuffer } from '../../serialize/index.js';
+import { bufferToHex, hexToBuffer } from '../../string/index.js';
+import { Fr } from '../bn254/field.js';
+/**
+ * Represents a Point on an elliptic curve with x and y coordinates.
+ * The Point class provides methods for creating instances from different input types,
+ * converting instances to various output formats, and checking the equality of points.
+ * TODO(#7386): Clean up this class.
+ */ export class Point {
+    x;
+    y;
+    static INFINITY = new Point(Fr.ZERO, Fr.ZERO);
+    static SIZE_IN_BYTES = Fr.SIZE_IN_BYTES * 2;
+    static COMPRESSED_SIZE_IN_BYTES = Fr.SIZE_IN_BYTES;
+    /** Used to differentiate this class from AztecAddress */ kind;
+    /** Whether the point is at infinity */ isInfinite;
+    constructor(/**
+     * The point's x coordinate
+     */ x, /**
+     * The point's y coordinate
+     */ y){
+        this.x = x;
+        this.y = y;
+        this.kind = 'point';
+        // TODO(#7386): check if on curve
+        // NOTE: now there is no isInfinite in the struct, empty == inf, so an empty class would pass an on-curve check. This may be fine depending on the usage.
+        this.isInfinite = x.isZero() && y.isZero();
+    }
+    toJSON() {
+        return this.toString();
+    }
+    static get schema() {
+        // Serialization from hex string.
+        return hexSchemaFor(Point);
+    }
+    /**
+   * Creates a Point 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, existing instances, or objects with x, y, and isInfinite fields.
+   * @param obj - Plain object, buffer, or Point instance
+   * @returns A Point instance
+   */ static fromPlainObject(obj) {
+        if (obj instanceof Point) {
+            return obj;
+        }
+        if (obj instanceof Buffer || Buffer.isBuffer(obj)) {
+            return Point.fromBuffer(obj);
+        }
+        return new this(Fr.fromPlainObject(obj.x), Fr.fromPlainObject(obj.y));
+    }
+    /**
+   * Generate a random Point instance that is on the curve.
+   *
+   * @returns A randomly generated Point instance.
+   */ static async random() {
+        while(true){
+            try {
+                return await Point.fromXAndSign(Fr.random(), randomBoolean());
+            } catch (e) {
+                if (!(e instanceof NotOnCurveError)) {
+                    throw e;
+                }
+                continue;
+            }
+        }
+    }
+    /**
+   * Create a Point instance from a given buffer or BufferReader.
+   * The input 'buffer' should have exactly 64 bytes representing the x and y coordinates.
+   *
+   * @param buffer - The buffer or BufferReader containing the x and y coordinates of the point.
+   * @returns A Point instance.
+   */ static fromBuffer(buffer) {
+        const reader = BufferReader.asReader(buffer);
+        return new this(Fr.fromBuffer(reader), Fr.fromBuffer(reader));
+    }
+    /**
+   * Create a Point instance from a compressed buffer.
+   * The input 'buffer' should have exactly 33 bytes representing the x coordinate and the sign of the y coordinate.
+   *
+   * @param buffer - The buffer containing the x coordinate and the sign of the y coordinate.
+   * @returns A Point instance.
+   */ static fromCompressedBuffer(buffer) {
+        const reader = BufferReader.asReader(buffer);
+        const value = toBigIntBE(reader.readBytes(Point.COMPRESSED_SIZE_IN_BYTES));
+        const x = new Fr(value & (1n << 255n) - 1n);
+        const sign = (value & 1n << 255n) !== 0n;
+        return this.fromXAndSign(x, sign);
+    }
+    /**
+   * Create a Point instance from a hex-encoded string.
+   * The input should be prefixed with '0x' or not, and have exactly 128 hex characters representing the x and y coordinates.
+   * Throws an error if the input length is invalid or coordinate values are out of range.
+   *
+   * @param str - The hex-encoded string representing the Point coordinates.
+   * @returns A Point instance.
+   */ static fromString(str) {
+        return this.fromBuffer(hexToBuffer(str));
+    }
+    /**
+   * Returns the contents of the point as an array of 2 fields.
+   * @returns The point as an array of 2 fields
+   */ toFields() {
+        return [
+            this.x,
+            this.y
+        ];
+    }
+    static fromFields(fields) {
+        const reader = FieldReader.asReader(fields);
+        const [x, y] = [
+            reader.readField(),
+            reader.readField()
+        ];
+        return new this(x, y);
+    }
+    /**
+   * Uses the x coordinate and isPositive flag (+/-) to reconstruct the point.
+   * @dev The y coordinate can be derived from the x coordinate and the "sign" flag by solving the grumpkin curve
+   * equation for y.
+   * @param x - The x coordinate of the point
+   * @param sign - The "sign" of the y coordinate - note that this is not a sign as is known in integer arithmetic.
+   * Instead it is a boolean flag that determines whether the y coordinate is <= (Fr.MODULUS - 1) / 2
+   * @returns The point as an array of 2 fields
+   */ static async fromXAndSign(x, sign) {
+        const y = await Point.YFromX(x);
+        if (y == null) {
+            throw new NotOnCurveError(x);
+        }
+        const yPositiveBigInt = y.toBigInt() <= (Fr.MODULUS - 1n) / 2n ? y.toBigInt() : Fr.MODULUS - y.toBigInt();
+        const yNegativeBigInt = Fr.MODULUS - yPositiveBigInt;
+        // Choose the positive or negative root based on isPositive
+        const finalY = sign ? new Fr(yPositiveBigInt) : new Fr(yNegativeBigInt);
+        // Create and return the new Point
+        return new this(x, finalY);
+    }
+    /**
+   * @param x - The x coordinate of the point
+   * @returns y^2 such that y^2 = x^3 - 17
+   */ static YFromX(x) {
+        // Calculate y^2 = x^3 - 17 (i.e. the Grumpkin curve equation)
+        const ySquared = x.square().mul(x).sub(new Fr(17));
+        // y is then simply the square root. Note however that not all square roots exist in the field: if sqrt returns null
+        // then there is no point in the curve with this x coordinate.
+        return ySquared.sqrt();
+    }
+    /**
+   * Returns the x coordinate and the sign of the y coordinate.
+   * @dev The y sign can be determined by checking if the y coordinate is greater than half of the modulus.
+   * @returns The x coordinate and the sign of the y coordinate.
+   */ toXAndSign() {
+        return [
+            this.x,
+            this.y.toBigInt() <= (Fr.MODULUS - 1n) / 2n
+        ];
+    }
+    /**
+   * Returns the contents of the point as BigInts.
+   * @returns The point as BigInts
+   */ toBigInts() {
+        return {
+            x: this.x.toBigInt(),
+            y: this.y.toBigInt()
+        };
+    }
+    /**
+   * Converts the Point instance to a Buffer representation of the coordinates.
+   * @returns A Buffer representation of the Point instance.
+   * @dev Note that toBuffer does not include the isInfinite flag. The point at infinity is serialized as (0, 0).
+   */ toBuffer() {
+        const buf = serializeToBuffer([
+            this.x,
+            this.y
+        ]);
+        if (buf.length !== Point.SIZE_IN_BYTES) {
+            throw new Error(`Invalid buffer length for Point: ${buf.length}`);
+        }
+        return buf;
+    }
+    /**
+   * Converts the Point instance to a compressed Buffer representation of the coordinates.
+   * @returns A Buffer representation of the Point instance
+   */ toCompressedBuffer() {
+        const [x, sign] = this.toXAndSign();
+        // Here we leverage that Fr fits into 254 bits (log2(Fr.MODULUS) < 254) and given that we serialize Fr to 32 bytes
+        // and we use big-endian the 2 most significant bits are never populated. Hence we can use one of the bits as
+        // a sign bit.
+        const compressedValue = x.toBigInt() + (sign ? 2n ** 255n : 0n);
+        const buf = serializeToBuffer(compressedValue);
+        if (buf.length !== Point.COMPRESSED_SIZE_IN_BYTES) {
+            throw new Error(`Invalid buffer length for compressed Point: ${buf.length}`);
+        }
+        return buf;
+    }
+    /**
+   * Convert the Point instance to a hexadecimal string representation.
+   * The output string is prefixed with '0x' and consists of exactly 128 hex characters,
+   * representing the concatenated x and y coordinates of the point.
+   *
+   * @returns A hex-encoded string representing the Point instance.
+   */ toString() {
+        return bufferToHex(this.toBuffer());
+    }
+    /**
+   * Generate a short string representation of the Point instance.
+   * The returned string includes the first 10 and last 4 characters of the full string representation,
+   * with '...' in between to indicate truncation. This is useful for displaying or logging purposes
+   * when the full string representation may be too long.
+   *
+   * @returns A truncated string representation of the Point instance.
+   */ toShortString() {
+        const str = this.toString();
+        return `${str.slice(0, 10)}...${str.slice(-4)}`;
+    }
+    toNoirStruct() {
+        return {
+            x: this.x,
+            y: this.y
+        };
+    }
+    // Used for IvpkM. TODO(#8124): Consider removing this method.
+    toWrappedNoirStruct() {
+        return {
+            inner: this.toNoirStruct()
+        };
+    }
+    /**
+   * Check if two Point instances are equal by comparing their buffer values.
+   * Returns true if the buffer values are the same, and false otherwise.
+   *
+   * @param rhs - The Point instance to compare with the current instance.
+   * @returns A boolean indicating whether the two Point instances are equal.
+   */ equals(rhs) {
+        return this.x.equals(rhs.x) && this.y.equals(rhs.y);
+    }
+    isZero() {
+        return this.x.isZero() && this.y.isZero();
+    }
+    /**
+   * @param x - The x coordinate of the point
+   * @param y - The y coordinate of the point
+   * @returns Whether the point exists on Grumpkin
+   */ isOnCurve() {
+        if (this.isInfinite) {
+            return true;
+        }
+        // The Grumpkin equation is y^2 = x^3 - 17. We could use `YFromX` and then compare to `this.y`, but this would
+        // involve computing the square root of y, of which there are two possible valid values. This method is also faster.
+        const lhs = this.y.square();
+        const rhs = this.x.mul(this.x).mul(this.x).sub(new Fr(17));
+        return lhs.equals(rhs);
+    }
+}
+export class NotOnCurveError extends Error {
+    constructor(x){
+        super('The given x-coordinate is not on the Grumpkin curve: ' + x.toString());
+        this.name = 'NotOnCurveError';
+    }
+}

package/dest/decorators/index.d.ts

@@ -0,0 +1,2 @@
+export * from './memoize.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9kZWNvcmF0b3JzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsY0FBYyxDQUFDIn0=

package/dest/decorators/index.d.ts.map

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

package/dest/decorators/index.js

@@ -0,0 +1 @@
+export * from './memoize.js';

package/dest/decorators/memoize.d.ts

@@ -0,0 +1,2 @@
+export declare function memoize<This extends object, Result>(fn: () => Result, context: ClassMethodDecoratorContext): (this: This) => Result;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWVtb2l6ZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2RlY29yYXRvcnMvbWVtb2l6ZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSx3QkFBZ0IsT0FBTyxDQUFDLElBQUksU0FBUyxNQUFNLEVBQUUsTUFBTSxFQUFFLEVBQUUsRUFBRSxNQUFNLE1BQU0sRUFBRSxPQUFPLEVBQUUsMkJBQTJCLDBCQVUxRyJ9

package/dest/decorators/memoize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoize.d.ts","sourceRoot":"","sources":["../../src/decorators/memoize.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,MAAM,EAAE,OAAO,EAAE,2BAA2B,0BAU1G"}

package/dest/decorators/memoize.js

@@ -0,0 +1,11 @@
+export function memoize(fn, context) {
+    return function() {
+        const key = `__${String(context.name)}_value`;
+        const thisWithKey = this;
+        if (!(key in this)) {
+            const result = fn.call(this);
+            thisWithKey[key] = result;
+        }
+        return thisWithKey[key];
+    };
+}

package/dest/error/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Represents an error thrown when an operation is interrupted unexpectedly.
+ * This custom error class extends the built-in Error class in JavaScript and
+ * can be used to handle cases where a process or task is terminated before completion.
+ */
+export declare class InterruptError extends Error {
+    readonly name = "InterruptError";
+}
+/**
+ * An error thrown when an action times out.
+ */
+export declare class TimeoutError extends Error {
+    readonly name = "TimeoutError";
+}
+/**
+ * Represents an error thrown when an operation is aborted.
+ */
+export declare class AbortError extends Error {
+    readonly name = "AbortError";
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9lcnJvci9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7OztHQUlHO0FBQ0gscUJBQWEsY0FBZSxTQUFRLEtBQUs7SUFDdkMsU0FBeUIsSUFBSSxvQkFBb0I7Q0FDbEQ7QUFFRDs7R0FFRztBQUNILHFCQUFhLFlBQWEsU0FBUSxLQUFLO0lBQ3JDLFNBQXlCLElBQUksa0JBQWtCO0NBQ2hEO0FBRUQ7O0dBRUc7QUFDSCxxQkFBYSxVQUFXLFNBQVEsS0FBSztJQUNuQyxTQUF5QixJQUFJLGdCQUFnQjtDQUM5QyJ9

package/dest/error/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/error/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAyB,IAAI,oBAAoB;CAClD;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAyB,IAAI,kBAAkB;CAChD;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAyB,IAAI,gBAAgB;CAC9C"}