@aztec/foundation 0.7.2 → 0.7.3

package/dest/serialize/buffer_reader.d.ts

@@ -0,0 +1,188 @@
+/// <reference types="node" resolution-mode="require"/>
+import { Fq, Fr } from '../fields/fields.js';
+import { Tuple } from './types.js';
+/**
+ * The BufferReader class provides a utility for reading various data types from a buffer.
+ * It supports reading numbers, booleans, byte arrays, Fr and Fq field elements,
+ * vectors, arrays, objects, strings, and maps. It maintains an internal index to
+ * keep track of the current reading position in the buffer.
+ *
+ * Usage:
+ * Create a new instance of BufferReader with a buffer and an optional offset.
+ * Use the provided methods to read desired data types from the buffer.
+ * The reading methods automatically advance the internal index.
+ *
+ * @example
+ * const reader = new BufferReader(someBuffer);
+ * const num = reader.readNumber();
+ * const bool = reader.readBoolean();
+ * const byteArray = reader.readBytes(4);
+ */
+export declare class BufferReader {
+    private buffer;
+    private index;
+    constructor(buffer: Buffer, offset?: number);
+    /**
+     * Creates a BufferReader instance from either a Buffer or an existing BufferReader.
+     * If the input is a Buffer, it creates a new BufferReader with the given buffer.
+     * If the input is already a BufferReader, it returns the input unchanged.
+     *
+     * @param bufferOrReader - A Buffer or BufferReader to initialize the BufferReader.
+     * @returns An instance of BufferReader.
+     */
+    static asReader(bufferOrReader: Buffer | BufferReader): BufferReader;
+    /**
+     * Reads a 32-bit unsigned integer from the buffer at the current index position.
+     * Updates the index position by 4 bytes after reading the number.
+     *
+     * @returns The read 32-bit unsigned integer value.
+     */
+    readNumber(): number;
+    /**
+     * Reads a 16-bit unsigned integer from the buffer at the current index position.
+     * Updates the index position by 2 bytes after reading the number.
+     *
+     * @returns The read 16 bit value.
+     */
+    readUInt16(): number;
+    /**
+     * Reads and returns the next boolean value from the buffer.
+     * Advances the internal index by 1, treating the byte at the current index as a boolean value.
+     * Returns true if the byte is non-zero, false otherwise.
+     *
+     * @returns A boolean value representing the byte at the current index.
+     */
+    readBoolean(): boolean;
+    /**
+     * Reads a specified number of bytes from the buffer and returns a new Buffer containing those bytes.
+     * Advances the reader's index by the number of bytes read. Throws an error if there are not enough
+     * bytes left in the buffer to satisfy the requested number of bytes.
+     *
+     * @param n - The number of bytes to read from the buffer.
+     * @returns A new Buffer containing the read bytes.
+     */
+    readBytes(n: number): Buffer;
+    /**
+     * Reads a Fr (finite field) element from the buffer using the 'fromBuffer' method of the Fr class.
+     * The Fr class should provide a 'fromBuffer' method that takes a BufferReader instance as input.
+     *
+     * @returns An instance of the Fr class representing the finite field element.
+     */
+    readFr(): Fr;
+    /**
+     * Reads the next Fq element from the buffer using the Fq.fromBuffer method.
+     * The Fq element represents a finite field in elliptic curve cryptography and is used for calculations.
+     * Advances the internal buffer index by the number of bytes read.
+     *
+     * @returns An Fq instance representing the finite field element.
+     */
+    readFq(): Fq;
+    /**
+     * Reads a vector of numbers from the buffer and returns it as an array of numbers.
+     * The method utilizes the 'readVector' method, passing a deserializer that reads numbers.
+     *
+     * @returns An array of numbers representing the vector read from the buffer.
+     */
+    readNumberVector(): number[];
+    /**
+     * Reads a vector of fixed size from the buffer and deserializes its elements using the provided itemDeserializer object.
+     * The 'itemDeserializer' object should have a 'fromBuffer' method that takes a BufferReader instance and returns the deserialized element.
+     * The method first reads the size of the vector (a number) from the buffer, then iterates through its elements,
+     * deserializing each one using the 'fromBuffer' method of 'itemDeserializer'.
+     *
+     * @param itemDeserializer - Object with 'fromBuffer' method to deserialize vector elements.
+     * @returns An array of deserialized elements of type T.
+     */
+    readVector<T>(itemDeserializer: {
+        /**
+         * A method to deserialize data from a buffer.
+         */
+        fromBuffer: (reader: BufferReader) => T;
+    }): T[];
+    /**
+     * Read an array of a fixed size with elements of type T from the buffer.
+     * The 'itemDeserializer' object should have a 'fromBuffer' method that takes a BufferReader instance as input,
+     * and returns an instance of the desired deserialized data type T.
+     * This method will call the 'fromBuffer' method for each element in the array and return the resulting array.
+     *
+     * @param size - The fixed number of elements in the array.
+     * @param itemDeserializer - An object with a 'fromBuffer' method to deserialize individual elements of type T.
+     * @returns An array of instances of type T.
+     */
+    readArray<T, N extends number>(size: N, itemDeserializer: {
+        /**
+         * A function for deserializing data from a BufferReader instance.
+         */
+        fromBuffer: (reader: BufferReader) => T;
+    }): Tuple<T, N>;
+    /**
+     * Read a variable sized Buffer array where elements are represented by length + data.
+     * The method consecutively looks for a number which is the size of the proceeding buffer,
+     * then reads the bytes until it reaches the end of the reader's internal buffer.
+     * NOTE: if `size` is not provided, this will run to the end of the reader's buffer.
+     * @param size - Size of the buffer array in bytes (full remaining buffer length if left empty).
+     * @returns An array of variable sized buffers.
+     */
+    readBufferArray(size?: number): Buffer[];
+    /**
+     * Reads a serialized object from a buffer and returns the deserialized object using the given deserializer.
+     *
+     * @typeparam T - The type of the deserialized object.
+     * @param deserializer - An object with a 'fromBuffer' method that takes a BufferReader instance and returns an instance of the deserialized object.
+     * @returns The deserialized object of type T.
+     */
+    readObject<T>(deserializer: {
+        /**
+         * A method that takes a BufferReader instance and returns an instance of the deserialized data type.
+         */
+        fromBuffer: (reader: BufferReader) => T;
+    }): T;
+    /**
+     * Returns a Buffer containing the next n bytes from the current buffer without modifying the reader's index position.
+     * If n is not provided or exceeds the remaining length of the buffer, it returns all bytes from the current position till the end of the buffer.
+     *
+     * @param n - The number of bytes to peek from the current buffer. (Optional).
+     * @returns A Buffer with the next n bytes or the remaining bytes if n is not provided or exceeds the buffer length.
+     */
+    peekBytes(n?: number): Buffer;
+    /**
+     * Reads a string from the buffer and returns it.
+     * The method first reads the size of the string, then reads the corresponding
+     * number of bytes from the buffer and converts them to a string.
+     *
+     * @returns The read string from the buffer.
+     */
+    readString(): string;
+    /**
+     * Reads a buffer from the current position of the reader and advances the index.
+     * The method first reads the size (number) of bytes to be read, and then returns
+     * a Buffer with that size containing the bytes. Useful for reading variable-length
+     * binary data encoded as (size, data) format.
+     *
+     * @returns A Buffer containing the read bytes.
+     */
+    readBuffer(): Buffer;
+    /**
+     * Reads and constructs a map object from the current buffer using the provided deserializer.
+     * The method reads the number of entries in the map, followed by iterating through each key-value pair.
+     * The key is read as a string, while the value is obtained using the passed deserializer's `fromBuffer` method.
+     * The resulting map object is returned, containing all the key-value pairs read from the buffer.
+     *
+     * @param deserializer - An object with a `fromBuffer` method to deserialize the values in the map.
+     * @returns A map object with string keys and deserialized values based on the provided deserializer.
+     */
+    readMap<T>(deserializer: {
+        /**
+         * Deserializes an element of type T from a BufferReader instance.
+         */
+        fromBuffer: (reader: BufferReader) => T;
+    }): {
+        [key: string]: T;
+    };
+    /**
+     * Get the length of the reader's buffer.
+     * @returns The length of the underlying reader's buffer.
+     */
+    getLength(): number;
+}
+//# sourceMappingURL=buffer_reader.d.ts.map

package/dest/serialize/buffer_reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer_reader.d.ts","sourceRoot":"","sources":["../../src/serialize/buffer_reader.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAY;IAEX,OAAO,CAAC,MAAM;IAD1B,OAAO,CAAC,KAAK,CAAS;gBACF,MAAM,EAAE,MAAM,EAAE,MAAM,SAAI;IAI9C;;;;;;;OAOG;WACW,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY;IAI5D;;;;;OAKG;IACI,UAAU,IAAI,MAAM;IAK3B;;;;;OAKG;IACI,UAAU,IAAI,MAAM;IAK3B;;;;;;OAMG;IACI,WAAW,IAAI,OAAO;IAK7B;;;;;;;OAOG;IACI,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAKnC;;;;;OAKG;IACI,MAAM,IAAI,EAAE;IAInB;;;;;;OAMG;IACI,MAAM,IAAI,EAAE;IAInB;;;;;OAKG;IACI,gBAAgB,IAAI,MAAM,EAAE;IAMnC;;;;;;;;OAQG;IACI,UAAU,CAAC,CAAC,EAAE,gBAAgB,EAAE;QACrC;;WAEG;QACH,UAAU,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,CAAC,CAAC;KACzC,GAAG,CAAC,EAAE;IASP;;;;;;;;;OASG;IACI,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAClC,IAAI,EAAE,CAAC,EACP,gBAAgB,EAAE;QAChB;;WAEG;QACH,UAAU,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,CAAC,CAAC;KACzC,GACA,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAKd;;;;;;;OAOG;IACI,eAAe,CAAC,IAAI,SAAK,GAAG,MAAM,EAAE;IAgB3C;;;;;;OAMG;IACI,UAAU,CAAC,CAAC,EAAE,YAAY,EAAE;QACjC;;WAEG;QACH,UAAU,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,CAAC,CAAC;KACzC,GAAG,CAAC;IAIL;;;;;;OAMG;IACI,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAIpC;;;;;;OAMG;IACI,UAAU,IAAI,MAAM;IAI3B;;;;;;;OAOG;IACI,UAAU,IAAI,MAAM;IAK3B;;;;;;;;OAQG;IACI,OAAO,CAAC,CAAC,EAAE,YAAY,EAAE;QAC9B;;WAEG;QACH,UAAU,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,CAAC,CAAC;KACzC,GAAG;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAA;KAAE;IAWxB;;;OAGG;IACI,SAAS,IAAI,MAAM;CAG3B"}

package/dest/serialize/buffer_reader.js

@@ -0,0 +1,229 @@
+import { Fq, Fr } from '../fields/fields.js';
+/**
+ * The BufferReader class provides a utility for reading various data types from a buffer.
+ * It supports reading numbers, booleans, byte arrays, Fr and Fq field elements,
+ * vectors, arrays, objects, strings, and maps. It maintains an internal index to
+ * keep track of the current reading position in the buffer.
+ *
+ * Usage:
+ * Create a new instance of BufferReader with a buffer and an optional offset.
+ * Use the provided methods to read desired data types from the buffer.
+ * The reading methods automatically advance the internal index.
+ *
+ * @example
+ * const reader = new BufferReader(someBuffer);
+ * const num = reader.readNumber();
+ * const bool = reader.readBoolean();
+ * const byteArray = reader.readBytes(4);
+ */
+export class BufferReader {
+    constructor(buffer, offset = 0) {
+        this.buffer = buffer;
+        this.index = offset;
+    }
+    /**
+     * Creates a BufferReader instance from either a Buffer or an existing BufferReader.
+     * If the input is a Buffer, it creates a new BufferReader with the given buffer.
+     * If the input is already a BufferReader, it returns the input unchanged.
+     *
+     * @param bufferOrReader - A Buffer or BufferReader to initialize the BufferReader.
+     * @returns An instance of BufferReader.
+     */
+    static asReader(bufferOrReader) {
+        return Buffer.isBuffer(bufferOrReader) ? new BufferReader(bufferOrReader) : bufferOrReader;
+    }
+    /**
+     * Reads a 32-bit unsigned integer from the buffer at the current index position.
+     * Updates the index position by 4 bytes after reading the number.
+     *
+     * @returns The read 32-bit unsigned integer value.
+     */
+    readNumber() {
+        this.index += 4;
+        return this.buffer.readUint32BE(this.index - 4);
+    }
+    /**
+     * Reads a 16-bit unsigned integer from the buffer at the current index position.
+     * Updates the index position by 2 bytes after reading the number.
+     *
+     * @returns The read 16 bit value.
+     */
+    readUInt16() {
+        this.index += 2;
+        return this.buffer.readUInt16BE(this.index - 2);
+    }
+    /**
+     * Reads and returns the next boolean value from the buffer.
+     * Advances the internal index by 1, treating the byte at the current index as a boolean value.
+     * Returns true if the byte is non-zero, false otherwise.
+     *
+     * @returns A boolean value representing the byte at the current index.
+     */
+    readBoolean() {
+        this.index += 1;
+        return Boolean(this.buffer.at(this.index - 1));
+    }
+    /**
+     * Reads a specified number of bytes from the buffer and returns a new Buffer containing those bytes.
+     * Advances the reader's index by the number of bytes read. Throws an error if there are not enough
+     * bytes left in the buffer to satisfy the requested number of bytes.
+     *
+     * @param n - The number of bytes to read from the buffer.
+     * @returns A new Buffer containing the read bytes.
+     */
+    readBytes(n) {
+        this.index += n;
+        return Buffer.from(this.buffer.subarray(this.index - n, this.index));
+    }
+    /**
+     * Reads a Fr (finite field) element from the buffer using the 'fromBuffer' method of the Fr class.
+     * The Fr class should provide a 'fromBuffer' method that takes a BufferReader instance as input.
+     *
+     * @returns An instance of the Fr class representing the finite field element.
+     */
+    readFr() {
+        return Fr.fromBuffer(this);
+    }
+    /**
+     * Reads the next Fq element from the buffer using the Fq.fromBuffer method.
+     * The Fq element represents a finite field in elliptic curve cryptography and is used for calculations.
+     * Advances the internal buffer index by the number of bytes read.
+     *
+     * @returns An Fq instance representing the finite field element.
+     */
+    readFq() {
+        return Fq.fromBuffer(this);
+    }
+    /**
+     * Reads a vector of numbers from the buffer and returns it as an array of numbers.
+     * The method utilizes the 'readVector' method, passing a deserializer that reads numbers.
+     *
+     * @returns An array of numbers representing the vector read from the buffer.
+     */
+    readNumberVector() {
+        return this.readVector({
+            fromBuffer: (reader) => reader.readNumber(),
+        });
+    }
+    /**
+     * Reads a vector of fixed size from the buffer and deserializes its elements using the provided itemDeserializer object.
+     * The 'itemDeserializer' object should have a 'fromBuffer' method that takes a BufferReader instance and returns the deserialized element.
+     * The method first reads the size of the vector (a number) from the buffer, then iterates through its elements,
+     * deserializing each one using the 'fromBuffer' method of 'itemDeserializer'.
+     *
+     * @param itemDeserializer - Object with 'fromBuffer' method to deserialize vector elements.
+     * @returns An array of deserialized elements of type T.
+     */
+    readVector(itemDeserializer) {
+        const size = this.readNumber();
+        const result = new Array(size);
+        for (let i = 0; i < size; i++) {
+            result[i] = itemDeserializer.fromBuffer(this);
+        }
+        return result;
+    }
+    /**
+     * Read an array of a fixed size with elements of type T from the buffer.
+     * The 'itemDeserializer' object should have a 'fromBuffer' method that takes a BufferReader instance as input,
+     * and returns an instance of the desired deserialized data type T.
+     * This method will call the 'fromBuffer' method for each element in the array and return the resulting array.
+     *
+     * @param size - The fixed number of elements in the array.
+     * @param itemDeserializer - An object with a 'fromBuffer' method to deserialize individual elements of type T.
+     * @returns An array of instances of type T.
+     */
+    readArray(size, itemDeserializer) {
+        const result = Array.from({ length: size }, () => itemDeserializer.fromBuffer(this));
+        return result;
+    }
+    /**
+     * Read a variable sized Buffer array where elements are represented by length + data.
+     * The method consecutively looks for a number which is the size of the proceeding buffer,
+     * then reads the bytes until it reaches the end of the reader's internal buffer.
+     * NOTE: if `size` is not provided, this will run to the end of the reader's buffer.
+     * @param size - Size of the buffer array in bytes (full remaining buffer length if left empty).
+     * @returns An array of variable sized buffers.
+     */
+    readBufferArray(size = -1) {
+        const result = [];
+        const end = size >= 0 ? this.index + size : this.buffer.length;
+        while (this.index < end) {
+            const item = this.readBuffer();
+            result.push(item);
+        }
+        // Ensure that all bytes have been read.
+        if (this.index !== end) {
+            throw new Error(`Reader buffer was not fully consumed. Consumed up to ${this.index} bytes. End of data: ${end} bytes.`);
+        }
+        return result;
+    }
+    /**
+     * Reads a serialized object from a buffer and returns the deserialized object using the given deserializer.
+     *
+     * @typeparam T - The type of the deserialized object.
+     * @param deserializer - An object with a 'fromBuffer' method that takes a BufferReader instance and returns an instance of the deserialized object.
+     * @returns The deserialized object of type T.
+     */
+    readObject(deserializer) {
+        return deserializer.fromBuffer(this);
+    }
+    /**
+     * Returns a Buffer containing the next n bytes from the current buffer without modifying the reader's index position.
+     * If n is not provided or exceeds the remaining length of the buffer, it returns all bytes from the current position till the end of the buffer.
+     *
+     * @param n - The number of bytes to peek from the current buffer. (Optional).
+     * @returns A Buffer with the next n bytes or the remaining bytes if n is not provided or exceeds the buffer length.
+     */
+    peekBytes(n) {
+        return this.buffer.subarray(this.index, n ? this.index + n : undefined);
+    }
+    /**
+     * Reads a string from the buffer and returns it.
+     * The method first reads the size of the string, then reads the corresponding
+     * number of bytes from the buffer and converts them to a string.
+     *
+     * @returns The read string from the buffer.
+     */
+    readString() {
+        return this.readBuffer().toString();
+    }
+    /**
+     * Reads a buffer from the current position of the reader and advances the index.
+     * The method first reads the size (number) of bytes to be read, and then returns
+     * a Buffer with that size containing the bytes. Useful for reading variable-length
+     * binary data encoded as (size, data) format.
+     *
+     * @returns A Buffer containing the read bytes.
+     */
+    readBuffer() {
+        const size = this.readNumber();
+        return this.readBytes(size);
+    }
+    /**
+     * Reads and constructs a map object from the current buffer using the provided deserializer.
+     * The method reads the number of entries in the map, followed by iterating through each key-value pair.
+     * The key is read as a string, while the value is obtained using the passed deserializer's `fromBuffer` method.
+     * The resulting map object is returned, containing all the key-value pairs read from the buffer.
+     *
+     * @param deserializer - An object with a `fromBuffer` method to deserialize the values in the map.
+     * @returns A map object with string keys and deserialized values based on the provided deserializer.
+     */
+    readMap(deserializer) {
+        const numEntries = this.readNumber();
+        const map = {};
+        for (let i = 0; i < numEntries; i++) {
+            const key = this.readString();
+            const value = this.readObject(deserializer);
+            map[key] = value;
+        }
+        return map;
+    }
+    /**
+     * Get the length of the reader's buffer.
+     * @returns The length of the underlying reader's buffer.
+     */
+    getLength() {
+        return this.buffer.length;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVmZmVyX3JlYWRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zZXJpYWxpemUvYnVmZmVyX3JlYWRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBRzdDOzs7Ozs7Ozs7Ozs7Ozs7O0dBZ0JHO0FBQ0gsTUFBTSxPQUFPLFlBQVk7SUFFdkIsWUFBb0IsTUFBYyxFQUFFLE1BQU0sR0FBRyxDQUFDO1FBQTFCLFdBQU0sR0FBTixNQUFNLENBQVE7UUFDaEMsSUFBSSxDQUFDLEtBQUssR0FBRyxNQUFNLENBQUM7SUFDdEIsQ0FBQztJQUVEOzs7Ozs7O09BT0c7SUFDSSxNQUFNLENBQUMsUUFBUSxDQUFDLGNBQXFDO1FBQzFELE9BQU8sTUFBTSxDQUFDLFFBQVEsQ0FBQyxjQUFjLENBQUMsQ0FBQyxDQUFDLENBQUMsSUFBSSxZQUFZLENBQUMsY0FBYyxDQUFDLENBQUMsQ0FBQyxDQUFDLGNBQWMsQ0FBQztJQUM3RixDQUFDO0lBRUQ7Ozs7O09BS0c7SUFDSSxVQUFVO1FBQ2YsSUFBSSxDQUFDLEtBQUssSUFBSSxDQUFDLENBQUM7UUFDaEIsT0FBTyxJQUFJLENBQUMsTUFBTSxDQUFDLFlBQVksQ0FBQyxJQUFJLENBQUMsS0FBSyxHQUFHLENBQUMsQ0FBQyxDQUFDO0lBQ2xELENBQUM7SUFFRDs7Ozs7T0FLRztJQUNJLFVBQVU7UUFDZixJQUFJLENBQUMsS0FBSyxJQUFJLENBQUMsQ0FBQztRQUNoQixPQUFPLElBQUksQ0FBQyxNQUFNLENBQUMsWUFBWSxDQUFDLElBQUksQ0FBQyxLQUFLLEdBQUcsQ0FBQyxDQUFDLENBQUM7SUFDbEQsQ0FBQztJQUVEOzs7Ozs7T0FNRztJQUNJLFdBQVc7UUFDaEIsSUFBSSxDQUFDLEtBQUssSUFBSSxDQUFDLENBQUM7UUFDaEIsT0FBTyxPQUFPLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxFQUFF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

package/dest/serialize/buffer_reader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=buffer_reader.test.d.ts.map

package/dest/serialize/buffer_reader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer_reader.test.d.ts","sourceRoot":"","sources":["../../src/serialize/buffer_reader.test.ts"],"names":[],"mappings":""}

package/dest/serialize/buffer_reader.test.js

@@ -0,0 +1,156 @@
+import { jest } from '@jest/globals';
+import { randomBytes } from '../crypto/index.js';
+import { Fq, Fr } from '../fields/fields.js';
+import { BufferReader } from './buffer_reader.js';
+import { serializeBufferArrayToVector } from './free_funcs.js';
+const ARRAY = Array.from(Array(32)).map((_, idx) => (idx % 2 === 0 ? 0 : 1));
+const BUFFER = Buffer.from(ARRAY);
+const NUMBER = 65537;
+const sizes = [16, 48, 32];
+describe('buffer reader', () => {
+    let bufferReader;
+    beforeEach(() => {
+        bufferReader = new BufferReader(BUFFER);
+    });
+    describe('readNumber', () => {
+        it('should return number', () => {
+            expect(bufferReader.readNumber()).toBe(NUMBER);
+        });
+    });
+    describe('readBoolean', () => {
+        it('should read true when 1 and false when 0', () => {
+            ARRAY.forEach(element => {
+                if (element !== 0) {
+                    expect(bufferReader.readBoolean()).toBe(true);
+                }
+                else {
+                    expect(bufferReader.readBoolean()).toBe(false);
+                }
+            });
+        });
+    });
+    describe('readBytes', () => {
+        it('should read buffer by slices', () => {
+            expect(bufferReader.readBytes(2)).toEqual(Buffer.from(ARRAY.slice(0, 2)));
+            expect(bufferReader.readBytes(3)).toEqual(Buffer.from(ARRAY.slice(2, 5)));
+        });
+    });
+    describe('readFr', () => {
+        it('should get Fr from buffer', () => {
+            expect(bufferReader.readFr()).toEqual(Fr.fromBuffer(BUFFER));
+        });
+    });
+    describe('readFq', () => {
+        it('should get Fq from buffer', () => {
+            expect(bufferReader.readFq()).toEqual(Fq.fromBuffer(BUFFER));
+        });
+    });
+    describe('readNumberVector', () => {
+        let vectorBufferReader;
+        beforeEach(() => {
+            const uintArr = [7, 13, 16];
+            const uintBufArr = uintArr.map(num => {
+                const uintBuf = Buffer.alloc(4);
+                uintBuf.writeUInt32BE(num, 0);
+                return uintBuf;
+            });
+            const uintArrVec = serializeBufferArrayToVector(uintBufArr);
+            vectorBufferReader = new BufferReader(uintArrVec);
+        });
+        it('should read number vector', () => {
+            expect(vectorBufferReader.readNumberVector()).toEqual([7, 13, 16]);
+        });
+    });
+    describe('readVector', () => {
+        it('should read vector and generate result array', () => {
+            const fn = jest.fn();
+            let i = -1;
+            const result = bufferReader.readVector({
+                fromBuffer: () => {
+                    fn();
+                    i++;
+                    return i;
+                },
+            });
+            expect(result.length).toBe(NUMBER);
+            expect(result).toEqual(Array.from(Array(NUMBER).keys()));
+            expect(fn).toHaveBeenCalledTimes(NUMBER);
+        });
+    });
+    describe('readArray', () => {
+        it('should read array from buffer', () => {
+            const fn = jest.fn();
+            let i = -1;
+            expect(bufferReader.readArray(10, {
+                fromBuffer: () => {
+                    fn();
+                    i++;
+                    return i;
+                },
+            })).toEqual([0, 1, 2, 3, 4, 5, 6, 7, 8, 9]);
+        });
+    });
+    describe('readBufferArray', () => {
+        it('should read variable length array from buffer', () => {
+            // Testing `readBufferArray` with a buffer that ONLY contains the data that will be read.
+            // No `size` variable is passed in this case.
+            const bufferArray = [];
+            let buf = Buffer.alloc(0);
+            for (const size of sizes) {
+                const sizeBuf = Buffer.alloc(4);
+                sizeBuf.writeUInt32BE(size);
+                const bytes = randomBytes(size);
+                const ranBuf = Buffer.concat([sizeBuf, bytes]);
+                bufferArray.push(bytes);
+                buf = Buffer.concat([buf, ranBuf]);
+            }
+            const reader = BufferReader.asReader(buf);
+            const res = reader.readBufferArray();
+            expect(res).toEqual(bufferArray);
+        });
+        it('should read variable length array from buffer with other contents', () => {
+            // testing `readBufferArray` with a buffer that includes some other data before and after the data that will be read.
+            // The `size` variable needs to be passed in this case.
+            const bufferArray = [];
+            const prefixBytes = randomBytes(32);
+            const postfixBytes = randomBytes(16);
+            let bufLen = 0;
+            let buf = Buffer.alloc(32, prefixBytes);
+            for (const size of sizes) {
+                const sizeBuf = Buffer.alloc(4);
+                sizeBuf.writeUInt32BE(size);
+                const bytes = randomBytes(size);
+                const ranBuf = Buffer.concat([sizeBuf, bytes]);
+                buf = Buffer.concat([buf, ranBuf]);
+                bufferArray.push(bytes);
+                bufLen += ranBuf.length;
+            }
+            buf = Buffer.concat([buf, postfixBytes]);
+            const reader = BufferReader.asReader(buf);
+            const preRes = reader.readBytes(prefixBytes.length);
+            expect(preRes).toEqual(prefixBytes);
+            expect(reader.readBufferArray(bufLen)).toEqual(bufferArray);
+            expect(reader.readBytes(postfixBytes.length)).toEqual(postfixBytes);
+        });
+    });
+    describe('readObject', () => {
+        it('should read object from buffer', () => {
+            const fn = jest.fn();
+            const object = bufferReader.readObject({
+                fromBuffer: (reader) => {
+                    fn();
+                    return { value: 'test-string', buffer: reader };
+                },
+            });
+            expect(object.value).toEqual('test-string');
+            expect(object.buffer).toEqual(bufferReader);
+            expect(fn).toHaveBeenCalledTimes(1);
+        });
+    });
+    describe('peekBytes', () => {
+        it('should return bytes from buffer', () => {
+            expect(bufferReader.peekBytes(10)).toEqual(Buffer.from(ARRAY.slice(0, 10)));
+        });
+    });
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVmZmVyX3JlYWRlci50ZXN0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3NlcmlhbGl6ZS9idWZmZXJfcmVhZGVyLnRlc3QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLElBQUksRUFBRSxNQUFNLGVBQWUsQ0FBQztBQUVyQyxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFDakQsT0FBTyxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUM3QyxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFDbEQsT0FBTyxFQUFFLDRCQUE0QixFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFFL0QsTUFBTSxLQUFLLEdBQUcsS0FBSyxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLEVBQUUsR0FBRyxFQUFFLEVBQUUsQ0FBQyxDQUFDLEdBQUcsR0FBRyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUM7QUFDN0UsTUFBTSxNQUFNLEdBQUcsTUFBTSxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQztBQUNsQyxNQUFNLE1BQU0sR0FBRyxLQUFLLENBQUM7QUFDckIsTUFBTSxLQUFLLEdBQUcsQ0FBQyxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsQ0FBQyxDQUFDO0FBRTNCLFFBQVEsQ0FBQyxlQUFlLEVBQUUsR0FBRyxFQUFFO0lBQzdCLElBQUksWUFBMEIsQ0FBQztJQUUvQixVQUFVLENBQUMsR0FBRyxFQUFFO1FBQ2QsWUFBWSxHQUFHLElBQUksWUFBWSxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQzFDLENBQUMsQ0FBQyxDQUFDO0lBRUgsUUFBUSxDQUFDLFlBQVksRUFBRSxHQUFHLEVBQUU7UUFD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