@aztec-labs/stdlib 6.0.0-nightly.20260829

package/dest/abi/function_selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function_selector.d.ts","sourceRoot":"","sources":["../../src/abi/function_selector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AAC9D,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAE7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,oFAAoF;AACpF,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,mCAAmC;IACnC,iBAAyB,SAAS,CAAqB;IACvD;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,oBAI9C;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,oBAEtB;IAED,MAAM,CAAC,oBAAoB,CAAC,EAAE,EAAE,EAAE,gCAMjC;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,oBAG3C;IAED;;;;OAIG;IACH,OAAa,aAAa,CAAC,SAAS,EAAE,MAAM,6BAS3C;IAED;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,oBAMjC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,qBAEX;IAED;;;;;OAKG;IACH,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,YAAY,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC5G,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAclG;;OAEG;IACH,MAAM,CAAC,MAAM,qBAEZ;IAED,MAAM,WAEL;IAED,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,gBAAgB,CAAC,CAE5C;CACF"}

package/dest/abi/function_selector.js

@@ -0,0 +1,91 @@
+import { fromHex, toBigIntBE } from '@aztec-labs/foundation/bigint-buffer';
+import { poseidon2HashBytes } from '@aztec-labs/foundation/crypto/poseidon';
+import { randomBytes } from '@aztec-labs/foundation/crypto/random';
+import { hexSchemaFor } from '@aztec-labs/foundation/schemas';
+import { BufferReader, FieldReader } from '@aztec-labs/foundation/serialize';
+import { decodeFunctionSignature } from './function_signature_decoder.js';
+import { Selector } from './selector.js';
+/** A function selector is the first 4 bytes of the hash of a function signature. */ export class FunctionSelector extends Selector {
+    /**
+   * Deserializes from a buffer or reader, corresponding to a write in cpp.
+   * @param buffer - Buffer  or BufferReader to read from.
+   * @returns The Selector.
+   */ static fromBuffer(buffer) {
+        const reader = BufferReader.asReader(buffer);
+        const value = Number(toBigIntBE(reader.readBytes(Selector.SIZE)));
+        return new FunctionSelector(value);
+    }
+    /**
+   * Converts a field to selector.
+   * @param fr - The field to convert.
+   * @returns The selector.
+   */ static fromField(fr) {
+        return new FunctionSelector(Number(fr.toBigInt()));
+    }
+    static fromFieldOrUndefined(fr) {
+        try {
+            return FunctionSelector.fromField(fr);
+        } catch  {
+            return undefined;
+        }
+    }
+    static fromFields(fields) {
+        const reader = FieldReader.asReader(fields);
+        return FunctionSelector.fromField(reader.readField());
+    }
+    /**
+   * Creates a selector from a signature.
+   * @param signature - Signature to generate the selector for (e.g. "transfer(field,field)").
+   * @returns selector.
+   */ static async fromSignature(signature) {
+        // throw if signature contains whitespace
+        if (/\s/.test(signature)) {
+            throw new Error('Signature cannot contain whitespace');
+        }
+        const hash = await poseidon2HashBytes(Buffer.from(signature));
+        // We take the last Selector.SIZE big endian bytes
+        const bytes = hash.toBuffer().slice(-Selector.SIZE);
+        return FunctionSelector.fromBuffer(bytes);
+    }
+    /**
+   * Create a Selector instance from a hex-encoded string.
+   *
+   * @param selector - The hex-encoded string representing the Selector.
+   * @returns An Selector instance.
+   * @throws If the selector length is invalid.
+   */ static fromString(selector) {
+        const buf = fromHex(selector);
+        if (buf.length !== Selector.SIZE) {
+            throw new Error(`Invalid FunctionSelector length ${buf.length} (expected ${Selector.SIZE}).`);
+        }
+        return FunctionSelector.fromBuffer(buf);
+    }
+    /**
+   * Creates an empty selector.
+   * @returns An empty selector.
+   */ static empty() {
+        return new FunctionSelector(0);
+    }
+    static async fromNameAndParameters(nameOrArgs, maybeParameters) {
+        const { name, parameters } = typeof nameOrArgs === 'string' ? {
+            name: nameOrArgs,
+            parameters: maybeParameters
+        } : nameOrArgs;
+        const signature = decodeFunctionSignature(name, parameters);
+        const selector = await this.fromSignature(signature);
+        // If using the debug logger here it kill the typing in the `server_world_state_synchronizer` and jest tests.
+        // console.log(`selector for ${signature} is ${selector}`);
+        return selector;
+    }
+    /**
+   * Creates a random instance.
+   */ static random() {
+        return FunctionSelector.fromBuffer(randomBytes(Selector.SIZE));
+    }
+    toJSON() {
+        return this.toString();
+    }
+    static get schema() {
+        return hexSchemaFor(FunctionSelector);
+    }
+}

package/dest/abi/function_signature_decoder.d.ts

@@ -0,0 +1,43 @@
+import type { ABIParameter } from './abi.js';
+/**
+ * Decodes the signature of a function from the name and parameters.
+ */
+export declare class FunctionSignatureDecoder {
+    private name;
+    private parameters;
+    private includeNames;
+    private separator;
+    constructor(name: string, parameters: ABIParameter[], includeNames?: boolean);
+    /**
+     * Decodes a single function parameter type for the function signature.
+     * @param param - The parameter type to decode.
+     * @returns A string representing the parameter type.
+     */
+    private getParameterType;
+    /**
+     * Decodes a single function parameter for the function signature.
+     * @param param - The parameter to decode.
+     * @returns A string representing the parameter type and optionally its name.
+     */
+    private decodeParameter;
+    /**
+     * Decodes all the parameters and build the function signature
+     * @returns The function signature.
+     */
+    decode(): string;
+}
+/**
+ * Decodes a function signature from the name and parameters.
+ * @param name - The name of the function.
+ * @param parameters - The parameters of the function.
+ * @returns - The function signature.
+ */
+export declare function decodeFunctionSignature(name: string, parameters: ABIParameter[]): string;
+/**
+ * Decodes a function signature from the name and parameters including parameter names.
+ * @param name - The name of the function.
+ * @param parameters - The parameters of the function.
+ * @returns - The user-friendly function signature.
+ */
+export declare function decodeFunctionSignatureWithParameterNames(name: string, parameters: ABIParameter[]): string;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb25fc2lnbmF0dXJlX2RlY29kZXIuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9hYmkvZnVuY3Rpb25fc2lnbmF0dXJlX2RlY29kZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUF3QixNQUFNLFVBQVUsQ0FBQztBQUVuRTs7R0FFRztBQUNILHFCQUFhLHdCQUF3QjtJQUdqQyxPQUFPLENBQUMsSUFBSTtJQUNaLE9BQU8sQ0FBQyxVQUFVO0lBQ2xCLE9BQU8sQ0FBQyxZQUFZO0lBSnRCLE9BQU8sQ0FBQyxTQUFTLENBQVM7SUFDMUIsWUFDVSxJQUFJLEVBQUUsTUFBTSxFQUNaLFVBQVUsRUFBRSxZQUFZLEVBQUUsRUFDMUIsWUFBWSxVQUFRLEVBRzdCO0lBRUQ7Ozs7T0FJRztJQUNILE9BQU8sQ0FBQyxnQkFBZ0I7SUFtQnhCOzs7O09BSUc7SUFDSCxPQUFPLENBQUMsZUFBZTtJQUt2Qjs7O09BR0c7SUFDSSxNQUFNLElBQUksTUFBTSxDQUV0QjtDQUNGO0FBRUQ7Ozs7O0dBS0c7QUFDSCx3QkFBZ0IsdUJBQXVCLENBQUMsSUFBSSxFQUFFLE1BQU0sRUFBRSxVQUFVLEVBQUUsWUFBWSxFQUFFLFVBRS9FO0FBRUQ7Ozs7O0dBS0c7QUFDSCx3QkFBZ0IseUNBQXlDLENBQUMsSUFBSSxFQUFFLE1BQU0sRUFBRSxVQUFVLEVBQUUsWUFBWSxFQUFFLFVBRWpHIn0=

package/dest/abi/function_signature_decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function_signature_decoder.d.ts","sourceRoot":"","sources":["../../src/abi/function_signature_decoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAwB,MAAM,UAAU,CAAC;AAEnE;;GAEG;AACH,qBAAa,wBAAwB;IAGjC,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,YAAY;IAJtB,OAAO,CAAC,SAAS,CAAS;IAC1B,YACU,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,YAAY,EAAE,EAC1B,YAAY,UAAQ,EAG7B;IAED;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAmBxB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAKvB;;;OAGG;IACI,MAAM,IAAI,MAAM,CAEtB;CACF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,UAE/E;AAED;;;;;GAKG;AACH,wBAAgB,yCAAyC,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,UAEjG"}

package/dest/abi/function_signature_decoder.js

@@ -0,0 +1,66 @@
+/**
+ * Decodes the signature of a function from the name and parameters.
+ */ export class FunctionSignatureDecoder {
+    name;
+    parameters;
+    includeNames;
+    separator;
+    constructor(name, parameters, includeNames = false){
+        this.name = name;
+        this.parameters = parameters;
+        this.includeNames = includeNames;
+        this.separator = includeNames ? ', ' : ',';
+    }
+    /**
+   * Decodes a single function parameter type for the function signature.
+   * @param param - The parameter type to decode.
+   * @returns A string representing the parameter type.
+   */ getParameterType(param) {
+        switch(param.kind){
+            case 'field':
+                return 'Field';
+            case 'integer':
+                return param.sign === 'signed' ? `i${param.width}` : `u${param.width}`;
+            case 'boolean':
+                return 'bool';
+            case 'array':
+                return `[${this.getParameterType(param.type)};${param.length}]`;
+            case 'string':
+                return `str<${param.length}>`;
+            case 'struct':
+                return `(${param.fields.map((field)=>`${this.decodeParameter(field)}`).join(this.separator)})`;
+            default:
+                throw new Error(`Unsupported type: ${param.kind}`);
+        }
+    }
+    /**
+   * Decodes a single function parameter for the function signature.
+   * @param param - The parameter to decode.
+   * @returns A string representing the parameter type and optionally its name.
+   */ decodeParameter(param) {
+        const type = this.getParameterType(param.type);
+        return this.includeNames ? `${param.name}: ${type}` : type;
+    }
+    /**
+   * Decodes all the parameters and build the function signature
+   * @returns The function signature.
+   */ decode() {
+        return `${this.name}(${this.parameters.map((param)=>this.decodeParameter(param)).join(this.separator)})`;
+    }
+}
+/**
+ * Decodes a function signature from the name and parameters.
+ * @param name - The name of the function.
+ * @param parameters - The parameters of the function.
+ * @returns - The function signature.
+ */ export function decodeFunctionSignature(name, parameters) {
+    return new FunctionSignatureDecoder(name, parameters).decode();
+}
+/**
+ * Decodes a function signature from the name and parameters including parameter names.
+ * @param name - The name of the function.
+ * @param parameters - The parameters of the function.
+ * @returns - The user-friendly function signature.
+ */ export function decodeFunctionSignatureWithParameterNames(name, parameters) {
+    return new FunctionSignatureDecoder(name, parameters, true).decode();
+}

package/dest/abi/index.d.ts

@@ -0,0 +1,14 @@
+export * from './abi.js';
+export * from './buffer.js';
+export * from './decoder.js';
+export * from './function_signature_decoder.js';
+export * from './encoder.js';
+export * from './authorization_selector.js';
+export * from './event_metadata_definition.js';
+export * from './event_selector.js';
+export * from './function_selector.js';
+export * from './note_selector.js';
+export * from './utils.js';
+export * from './contract_artifact.js';
+export * from './function_call.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9hYmkvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxVQUFVLENBQUM7QUFDekIsY0FBYyxhQUFhLENBQUM7QUFDNUIsY0FBYyxjQUFjLENBQUM7QUFDN0IsY0FBYyxpQ0FBaUMsQ0FBQztBQUNoRCxjQUFjLGNBQWMsQ0FBQztBQUM3QixjQUFjLDZCQUE2QixDQUFDO0FBQzVDLGNBQWMsZ0NBQWdDLENBQUM7QUFDL0MsY0FBYyxxQkFBcUIsQ0FBQztBQUNwQyxjQUFjLHdCQUF3QixDQUFDO0FBQ3ZDLGNBQWMsb0JBQW9CLENBQUM7QUFDbkMsY0FBYyxZQUFZLENBQUM7QUFDM0IsY0FBYyx3QkFBd0IsQ0FBQztBQUN2QyxjQUFjLG9CQUFvQixDQUFDIn0=

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/abi/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iCAAiC,CAAC;AAChD,cAAc,cAAc,CAAC;AAC7B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC"}

package/dest/abi/index.js

@@ -0,0 +1,13 @@
+export * from './abi.js';
+export * from './buffer.js';
+export * from './decoder.js';
+export * from './function_signature_decoder.js';
+export * from './encoder.js';
+export * from './authorization_selector.js';
+export * from './event_metadata_definition.js';
+export * from './event_selector.js';
+export * from './function_selector.js';
+export * from './note_selector.js';
+export * from './utils.js';
+export * from './contract_artifact.js';
+export * from './function_call.js';

package/dest/abi/note_selector.d.ts

@@ -0,0 +1,37 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { BufferReader } from '@aztec-labs/foundation/serialize';
+import { Selector } from './selector.js';
+/**
+ * A note selector is a 7 bit long value that identifies a note type within a contract.
+ * TODO(#10952): Encoding of note type id can be reduced to 7 bits.
+ */
+export declare class NoteSelector extends Selector {
+    /** Branding for nominal typing. */
+    private readonly _branding;
+    /**
+     * Deserializes from a buffer or reader, corresponding to a write in cpp.
+     * @param buffer - Buffer  or BufferReader to read from.
+     * @returns The Selector.
+     */
+    static fromBuffer(buffer: Buffer | BufferReader): NoteSelector;
+    static fromString(buf: string): NoteSelector;
+    /**
+     * Converts a field to selector.
+     * @param fr - The field to convert.
+     * @returns The selector.
+     */
+    static fromField(fr: Fr): NoteSelector;
+    /**
+     * Creates an empty selector.
+     * @returns An empty selector.
+     */
+    static empty(): NoteSelector;
+    /**
+     * Creates a random selector.
+     * @returns A random selector.
+     */
+    static random(): NoteSelector;
+    toJSON(): string;
+    static get schema(): import("zod").ZodType<NoteSelector, string, import("zod/v4/core").$ZodTypeInternals<NoteSelector, string>>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibm90ZV9zZWxlY3Rvci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2FiaS9ub3RlX3NlbGVjdG9yLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxxQ0FBcUMsQ0FBQztBQUV6RCxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFFaEUsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLGVBQWUsQ0FBQztBQUV6Qzs7O0dBR0c7QUFDSCxxQkFBYSxZQUFhLFNBQVEsUUFBUTtJQUN4QyxtQ0FBbUM7SUFDbkMsaUJBQXlCLFNBQVMsQ0FBaUI7SUFDbkQ7Ozs7T0FJRztJQUNILE1BQU0sQ0FBQyxVQUFVLENBQUMsTUFBTSxFQUFFLE1BQU0sR0FBRyxZQUFZLGdCQU85QztJQUVELE1BQU0sQ0FBQyxVQUFVLENBQUMsR0FBRyxFQUFFLE1BQU0sZ0JBSTVCO0lBRUQ7Ozs7T0FJRztJQUNILE1BQU0sQ0FBQyxTQUFTLENBQUMsRUFBRSxFQUFFLEVBQUUsZ0JBRXRCO0lBRUQ7OztPQUdHO0lBQ0gsTUFBTSxDQUFDLEtBQUssaUJBRVg7SUFFRDs7O09BR0c7SUFDSCxNQUFNLENBQUMsTUFBTSxpQkFHWjtJQUVELE1BQU0sV0FFTDtJQUVELE1BQU0sS0FBSyxNQUFNLCtHQUVoQjtDQUNGIn0=

package/dest/abi/note_selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note_selector.d.ts","sourceRoot":"","sources":["../../src/abi/note_selector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;GAGG;AACH,qBAAa,YAAa,SAAQ,QAAQ;IACxC,mCAAmC;IACnC,iBAAyB,SAAS,CAAiB;IACnD;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,gBAO9C;IAED,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,gBAI5B;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,gBAEtB;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,iBAEX;IAED;;;OAGG;IACH,MAAM,CAAC,MAAM,iBAGZ;IAED,MAAM,WAEL;IAED,MAAM,KAAK,MAAM,+GAEhB;CACF"}

package/dest/abi/note_selector.js

@@ -0,0 +1,54 @@
+import { toBigIntBE } from '@aztec-labs/foundation/bigint-buffer';
+import { randomInt } from '@aztec-labs/foundation/crypto/random';
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { hexSchemaFor } from '@aztec-labs/foundation/schemas';
+import { BufferReader } from '@aztec-labs/foundation/serialize';
+import { Selector } from './selector.js';
+/**
+ * A note selector is a 7 bit long value that identifies a note type within a contract.
+ * TODO(#10952): Encoding of note type id can be reduced to 7 bits.
+ */ export class NoteSelector extends Selector {
+    /**
+   * Deserializes from a buffer or reader, corresponding to a write in cpp.
+   * @param buffer - Buffer  or BufferReader to read from.
+   * @returns The Selector.
+   */ static fromBuffer(buffer) {
+        const reader = BufferReader.asReader(buffer);
+        const value = Number(toBigIntBE(reader.readBytes(Selector.SIZE)));
+        if (value >= 1 << 7) {
+            throw new Error(`Invalid note selector: ${value}`);
+        }
+        return new NoteSelector(value);
+    }
+    static fromString(buf) {
+        const withoutPrefix = buf.replace(/^0x/i, '').slice(-8);
+        const buffer = Buffer.from(withoutPrefix, 'hex');
+        return NoteSelector.fromBuffer(buffer);
+    }
+    /**
+   * Converts a field to selector.
+   * @param fr - The field to convert.
+   * @returns The selector.
+   */ static fromField(fr) {
+        return new NoteSelector(Number(fr.toBigInt()));
+    }
+    /**
+   * Creates an empty selector.
+   * @returns An empty selector.
+   */ static empty() {
+        return new NoteSelector(0);
+    }
+    /**
+   * Creates a random selector.
+   * @returns A random selector.
+   */ static random() {
+        const value = randomInt(1 << 7);
+        return NoteSelector.fromField(new Fr(value));
+    }
+    toJSON() {
+        return this.toString();
+    }
+    static get schema() {
+        return hexSchemaFor(NoteSelector);
+    }
+}

package/dest/abi/selector.d.ts

@@ -0,0 +1,39 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { inspect } from 'util';
+/** A selector is the low 4 bytes of the poseidon2 hash of a signature. */
+export declare abstract class Selector {
+    value: number;
+    /** The size of the selector in bytes. */
+    static SIZE: number;
+    constructor(/** Value of the selector */ value: number);
+    /**
+     * Checks if the selector is empty (all bytes are 0).
+     * @returns True if the selector is empty (all bytes are 0).
+     */
+    isEmpty(): boolean;
+    /**
+     * Serialize as a buffer.
+     * @param bufferSize - The buffer size.
+     * @returns The buffer.
+     */
+    toBuffer(bufferSize?: number): Buffer;
+    /**
+     * Serialize as a hex string.
+     * @returns The string.
+     */
+    toString(): string;
+    [inspect.custom](): string;
+    /**
+     * Checks if this selector is equal to another.
+     * @param other - The other selector.
+     * @returns True if the selectors are equal.
+     */
+    equals(other: Selector): boolean;
+    /**
+     * Returns a new field with the same contents as this EthAddress.
+     *
+     * @returns An Fr instance.
+     */
+    toField(): Fr;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VsZWN0b3IuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9hYmkvc2VsZWN0b3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLHFDQUFxQyxDQUFDO0FBRXpELE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxNQUFNLENBQUM7QUFFL0IsMEVBQTBFO0FBQzFFLDhCQUFzQixRQUFRO0lBSW9CLEtBQUssRUFBRSxNQUFNO0lBSDdELHlDQUF5QztJQUN6QyxPQUFjLElBQUksU0FBSztJQUV2QixZQUFZLDRCQUE0QixDQUFRLEtBQUssRUFBRSxNQUFNLEVBSTVEO0lBRUQ7OztPQUdHO0lBQ0ksT0FBTyxJQUFJLE9BQU8sQ0FFeEI7SUFFRDs7OztPQUlHO0lBQ0gsUUFBUSxDQUFDLFVBQVUsU0FBZ0IsR0FBRyxNQUFNLENBRTNDO0lBRUQ7OztPQUdHO0lBQ0gsUUFBUSxJQUFJLE1BQU0sQ0FFakI7SUFFRCxDQUFDLE9BQU8sQ0FBQyxNQUFNLENBQUMsV0FFZjtJQUVEOzs7O09BSUc7SUFDSCxNQUFNLENBQUMsS0FBSyxFQUFFLFFBQVEsR0FBRyxPQUFPLENBRS9CO0lBRUQ7Ozs7T0FJRztJQUNJLE9BQU8sT0FFYjtDQUNGIn0=

package/dest/abi/selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../src/abi/selector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AAEzD,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,0EAA0E;AAC1E,8BAAsB,QAAQ;IAIoB,KAAK,EAAE,MAAM;IAH7D,yCAAyC;IACzC,OAAc,IAAI,SAAK;IAEvB,YAAY,4BAA4B,CAAQ,KAAK,EAAE,MAAM,EAI5D;IAED;;;OAGG;IACI,OAAO,IAAI,OAAO,CAExB;IAED;;;;OAIG;IACH,QAAQ,CAAC,UAAU,SAAgB,GAAG,MAAM,CAE3C;IAED;;;OAGG;IACH,QAAQ,IAAI,MAAM,CAEjB;IAED,CAAC,OAAO,CAAC,MAAM,CAAC,WAEf;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAE/B;IAED;;;;OAIG;IACI,OAAO,OAEb;CACF"}

package/dest/abi/selector.js

@@ -0,0 +1,52 @@
+var _computedKey;
+import { toBufferBE } from '@aztec-labs/foundation/bigint-buffer';
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { bufferToHex } from '@aztec-labs/foundation/string';
+import { inspect } from 'util';
+_computedKey = inspect.custom;
+/** A selector is the low 4 bytes of the poseidon2 hash of a signature. */ export class Selector {
+    value;
+    /** The size of the selector in bytes. */ static SIZE = 4;
+    constructor(/** Value of the selector */ value){
+        this.value = value;
+        if (value > 2 ** (Selector.SIZE * 8) - 1) {
+            throw new Error(`Selector must fit in ${Selector.SIZE} bytes (got value ${value}).`);
+        }
+    }
+    /**
+   * Checks if the selector is empty (all bytes are 0).
+   * @returns True if the selector is empty (all bytes are 0).
+   */ isEmpty() {
+        return this.value === 0;
+    }
+    /**
+   * Serialize as a buffer.
+   * @param bufferSize - The buffer size.
+   * @returns The buffer.
+   */ toBuffer(bufferSize = Selector.SIZE) {
+        return toBufferBE(BigInt(this.value), bufferSize);
+    }
+    /**
+   * Serialize as a hex string.
+   * @returns The string.
+   */ toString() {
+        return bufferToHex(this.toBuffer());
+    }
+    [_computedKey]() {
+        return `Selector<${this.toString()}>`;
+    }
+    /**
+   * Checks if this selector is equal to another.
+   * @param other - The other selector.
+   * @returns True if the selectors are equal.
+   */ equals(other) {
+        return this.value === other.value;
+    }
+    /**
+   * Returns a new field with the same contents as this EthAddress.
+   *
+   * @returns An Fr instance.
+   */ toField() {
+        return new Fr(BigInt(this.value));
+    }
+}

package/dest/abi/utils.d.ts

@@ -0,0 +1,62 @@
+import type { AbiType } from './abi.js';
+/**
+ * Returns whether the ABI type is an Aztec or Ethereum Address defined in Aztec.nr.
+ * @param abiType - Type to check.
+ * @returns Boolean.
+ */
+export declare function isAddressStruct(abiType: AbiType): boolean;
+/**
+ * Returns whether the ABI type is an Ethereum Address defined in Aztec.nr.
+ * @param abiType - Type to check.
+ * @returns Boolean.
+ */
+export declare function isEthAddressStruct(abiType: AbiType): boolean;
+/**
+ * Returns whether the ABI type is an Aztec Address defined in Aztec.nr.
+ * @param abiType - Type to check.
+ * @returns Boolean.
+ */
+export declare function isAztecAddressStruct(abiType: AbiType): boolean;
+/**
+ * Returns whether the ABI type is an Function Selector defined in Aztec.nr.
+ * @param abiType - Type to check.
+ * @returns Boolean.
+ */
+export declare function isFunctionSelectorStruct(abiType: AbiType): boolean;
+/**
+ * Returns whether the ABI type is a struct with a single `inner` field.
+ * @param abiType - Type to check.
+ */
+export declare function isWrappedFieldStruct(abiType: AbiType): boolean;
+/**
+ * Returns whether the ABI type is a PublicKeys struct from Aztec.nr.
+ * @param abiType - Type to check.
+ * @returns A boolean indicating whether the ABI type is a PublicKeys struct.
+ */
+export declare function isPublicKeysStruct(abiType: AbiType): boolean;
+/**
+ * Returns whether the ABI type is a BoundedVec struct from Noir's std::collections::bounded_vec.
+ * @param abiType - Type to check.
+ * @returns A boolean indicating whether the ABI type is a BoundedVec struct.
+ */
+export declare function isBoundedVecStruct(abiType: AbiType): boolean;
+/**
+ * Returns whether the ABI type is Noir's std::option::Option lowered to a struct.
+ * @param abiType - Type to check.
+ * @returns A boolean indicating whether the ABI type is an Option struct.
+ */
+export declare function isOptionStruct(abiType: AbiType): boolean;
+/**
+ * Returns whether `null` or `undefined` can be mapped to a valid ABI value for this type.
+ *
+ * @param abiType - Type to check.
+ * @returns A boolean indicating whether nullish values are valid shorthand for this ABI type.
+ */
+export declare function canBeMappedFromNullOrUndefined(abiType: AbiType): boolean;
+/**
+ * Returns a bigint by parsing a serialized 2's complement signed int.
+ * @param b - The signed int as a buffer
+ * @returns - a deserialized bigint
+ */
+export declare function parseSignedInt(b: Buffer, width?: number): bigint;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9hYmkvdXRpbHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sVUFBVSxDQUFDO0FBRXhDOzs7O0dBSUc7QUFDSCx3QkFBZ0IsZUFBZSxDQUFDLE9BQU8sRUFBRSxPQUFPLFdBRS9DO0FBRUQ7Ozs7R0FJRztBQUNILHdCQUFnQixrQkFBa0IsQ0FBQyxPQUFPLEVBQUUsT0FBTyxXQUVsRDtBQUVEOzs7O0dBSUc7QUFDSCx3QkFBZ0Isb0JBQW9CLENBQUMsT0FBTyxFQUFFLE9BQU8sV0FFcEQ7QUFFRDs7OztHQUlHO0FBQ0gsd0JBQWdCLHdCQUF3QixDQUFDLE9BQU8sRUFBRSxPQUFPLFdBRXhEO0FBRUQ7OztHQUdHO0FBQ0gsd0JBQWdCLG9CQUFvQixDQUFDLE9BQU8sRUFBRSxPQUFPLFdBT3BEO0FBRUQ7Ozs7R0FJRztBQUNILHdCQUFnQixrQkFBa0IsQ0FBQyxPQUFPLEVBQUUsT0FBTyxXQVlsRDtBQUVEOzs7O0dBSUc7QUFDSCx3QkFBZ0Isa0JBQWtCLENBQUMsT0FBTyxFQUFFLE9BQU8sV0FRbEQ7QUFFRDs7OztHQUlHO0FBQ0gsd0JBQWdCLGNBQWMsQ0FBQyxPQUFPLEVBQUUsT0FBTyxXQVE5QztBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLDhCQUE4QixDQUFDLE9BQU8sRUFBRSxPQUFPLFdBRTlEO0FBRUQ7Ozs7R0FJRztBQUNILHdCQUFnQixjQUFjLENBQUMsQ0FBQyxFQUFFLE1BQU0sRUFBRSxLQUFLLENBQUMsRUFBRSxNQUFNLFVBcUJ2RCJ9

package/dest/abi/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/abi/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,WAE/C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,WAElD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,WAEpD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,WAExD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,WAOpD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,WAYlD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,WAQlD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,WAQ9C;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,WAE9D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,UAqBvD"}

package/dest/abi/utils.js

@@ -0,0 +1,84 @@
+/**
+ * Returns whether the ABI type is an Aztec or Ethereum Address defined in Aztec.nr.
+ * @param abiType - Type to check.
+ * @returns Boolean.
+ */ export function isAddressStruct(abiType) {
+    return isEthAddressStruct(abiType) || isAztecAddressStruct(abiType);
+}
+/**
+ * Returns whether the ABI type is an Ethereum Address defined in Aztec.nr.
+ * @param abiType - Type to check.
+ * @returns Boolean.
+ */ export function isEthAddressStruct(abiType) {
+    return abiType.kind === 'struct' && abiType.path.endsWith('address::EthAddress');
+}
+/**
+ * Returns whether the ABI type is an Aztec Address defined in Aztec.nr.
+ * @param abiType - Type to check.
+ * @returns Boolean.
+ */ export function isAztecAddressStruct(abiType) {
+    return abiType.kind === 'struct' && abiType.path.endsWith('address::AztecAddress');
+}
+/**
+ * Returns whether the ABI type is an Function Selector defined in Aztec.nr.
+ * @param abiType - Type to check.
+ * @returns Boolean.
+ */ export function isFunctionSelectorStruct(abiType) {
+    return abiType.kind === 'struct' && abiType.path.endsWith('types::abis::function_selector::FunctionSelector');
+}
+/**
+ * Returns whether the ABI type is a struct with a single `inner` field.
+ * @param abiType - Type to check.
+ */ export function isWrappedFieldStruct(abiType) {
+    return abiType.kind === 'struct' && abiType.fields.length === 1 && abiType.fields[0].name === 'inner' && abiType.fields[0].type.kind === 'field';
+}
+/**
+ * Returns whether the ABI type is a PublicKeys struct from Aztec.nr.
+ * @param abiType - Type to check.
+ * @returns A boolean indicating whether the ABI type is a PublicKeys struct.
+ */ export function isPublicKeysStruct(abiType) {
+    return abiType.kind === 'struct' && abiType.path === 'aztec::protocol_types::public_keys::PublicKeys' && abiType.fields.length === 6 && abiType.fields[0].name === 'npk_m_hash' && abiType.fields[1].name === 'ivpk_m' && abiType.fields[2].name === 'ovpk_m_hash' && abiType.fields[3].name === 'tpk_m_hash' && abiType.fields[4].name === 'mspk_m_hash' && abiType.fields[5].name === 'fbpk_m_hash';
+}
+/**
+ * Returns whether the ABI type is a BoundedVec struct from Noir's std::collections::bounded_vec.
+ * @param abiType - Type to check.
+ * @returns A boolean indicating whether the ABI type is a BoundedVec struct.
+ */ export function isBoundedVecStruct(abiType) {
+    return abiType.kind === 'struct' && abiType.path === 'std::collections::bounded_vec::BoundedVec' && abiType.fields.length === 2 && abiType.fields[0].name === 'storage' && abiType.fields[1].name === 'len';
+}
+/**
+ * Returns whether the ABI type is Noir's std::option::Option lowered to a struct.
+ * @param abiType - Type to check.
+ * @returns A boolean indicating whether the ABI type is an Option struct.
+ */ export function isOptionStruct(abiType) {
+    return abiType.kind === 'struct' && abiType.path === 'std::option::Option' && abiType.fields.length === 2 && abiType.fields[0].name === '_is_some' && abiType.fields[1].name === '_value';
+}
+/**
+ * Returns whether `null` or `undefined` can be mapped to a valid ABI value for this type.
+ *
+ * @param abiType - Type to check.
+ * @returns A boolean indicating whether nullish values are valid shorthand for this ABI type.
+ */ export function canBeMappedFromNullOrUndefined(abiType) {
+    return isOptionStruct(abiType);
+}
+/**
+ * Returns a bigint by parsing a serialized 2's complement signed int.
+ * @param b - The signed int as a buffer
+ * @returns - a deserialized bigint
+ */ export function parseSignedInt(b, width) {
+    const buf = Buffer.from(b);
+    // We get the last (width / 8) bytes where width = bits of type (i64, i32 etc)
+    const slicedBuf = width !== undefined ? buf.subarray(-(width / 8)) : buf;
+    // Then manually deserialize with 2's complement, with the process as follows:
+    // If our most significant bit is high...
+    if (0x80 & slicedBuf.subarray(0, 1).readUInt8()) {
+        // We flip the bits
+        for(let i = 0; i < slicedBuf.length; i++){
+            slicedBuf[i] = ~slicedBuf[i];
+        }
+        // Add one, then negate it
+        return -(BigInt(`0x${slicedBuf.toString('hex')}`) + 1n);
+    }
+    // ...otherwise we just return our positive int
+    return BigInt(`0x${slicedBuf.toString('hex')}`);
+}

package/dest/auth_witness/auth_witness.d.ts

@@ -0,0 +1,45 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { BufferReader } from '@aztec-labs/foundation/serialize';
+import type { AztecAddress } from '../aztec-address/index.js';
+/**
+ * An authentication witness. Used to authorize an action by a user.
+ */
+export declare class AuthWitness {
+    /** Hash of the request to authorize */
+    readonly requestHash: Fr;
+    /** Authentication witness for the hash  */
+    readonly witness: Fr[];
+    constructor(
+    /** Hash of the request to authorize */
+    requestHash: Fr, 
+    /** Authentication witness for the hash  */
+    witness: (Fr | number)[]);
+    static get schema(): import("zod").ZodType<AuthWitness, string, import("zod/v4/core").$ZodTypeInternals<AuthWitness, string>>;
+    toJSON(): `0x${string}`;
+    toBuffer(): Buffer<ArrayBufferLike>;
+    static fromBuffer(buffer: Buffer | BufferReader): AuthWitness;
+    toString(): `0x${string}`;
+    static fromString(str: string): AuthWitness;
+    static random(): AuthWitness;
+}
+/**
+ * Compute the inner hash for an authentication witness.
+ * This is the "intent" of the message, before siloed with the consumer.
+ * @param args - The arguments to hash
+ * @returns The inner hash for the witness
+ */
+export declare const computeInnerAuthWitHash: (args: Fr[]) => Promise<Fr>;
+/**
+ * Compute the outer hash for an authentication witness.
+ * This is the value siloed with its "consumer" and what the `on_behalf_of`
+ * should be signing.
+ * The consumer is who will be consuming the message, for token approvals it
+ * is the token contract itself (because the token makes the call to check the approval).
+ * @param consumer - The address that can "consume" the authwit
+ * @param chainId - The chain id that can "consume" the authwit
+ * @param version - The version that can "consume" the authwit
+ * @param innerHash - The inner hash for the witness
+ * @returns The outer hash for the witness
+ */
+export declare const computeOuterAuthWitHash: (consumer: AztecAddress, chainId: Fr, version: Fr, innerHash: Fr) => Promise<Fr>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXV0aF93aXRuZXNzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYXV0aF93aXRuZXNzL2F1dGhfd2l0bmVzcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFFQSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0scUNBQXFDLENBQUM7QUFDekQsT0FBTyxFQUFFLFlBQVksRUFBcUIsTUFBTSxrQ0FBa0MsQ0FBQztBQUduRixPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUk5RDs7R0FFRztBQUNILHFCQUFhLFdBQVc7SUFLcEIsdUNBQXVDO2FBQ3ZCLFdBQVcsRUFBRSxFQUFFO0lBTGpDLDJDQUEyQztJQUMzQyxTQUFnQixPQUFPLEVBQUUsRUFBRSxFQUFFLENBQUM7SUFFOUI7SUFDRSx1Q0FBdUM7SUFDdkIsV0FBVyxFQUFFLEVBQUU7SUFDL0IsMkNBQTJDO0lBQzNDLE9BQU8sRUFBRSxDQUFDLEVBQUUsR0FBRyxNQUFNLENBQUMsRUFBRSxFQUd6QjtJQUVELE1BQU0sS0FBSyxNQUFNLDZHQUVoQjtJQUVELE1BQU0sa0JBRUw7SUFFRCxRQUFRLDRCQUVQO0lBRUQsTUFBTSxDQUFDLFVBQVUsQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLFlBQVksR0FBRyxXQUFXLENBRzVEO0lBRUQsUUFBUSxrQkFFUDtJQUVELE1BQU0sQ0FBQyxVQUFVLENBQUMsR0FBRyxFQUFFLE1BQU0sZUFFNUI7SUFFRCxNQUFNLENBQUMsTUFBTSxnQkFFWjtDQUNGO0FBRUQ7Ozs7O0dBS0c7QUFDSCxlQUFPLE1BQU0sdUJBQXVCLDZCQUVuQyxDQUFDO0FBRUY7Ozs7Ozs7Ozs7O0dBV0c7QUFDSCxlQUFPLE1BQU0sdUJBQXVCLGtGQUVuQyxDQUFDIn0=

package/dest/auth_witness/auth_witness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth_witness.d.ts","sourceRoot":"","sources":["../../src/auth_witness/auth_witness.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AACzD,OAAO,EAAE,YAAY,EAAqB,MAAM,kCAAkC,CAAC;AAGnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D;;GAEG;AACH,qBAAa,WAAW;IAKpB,uCAAuC;aACvB,WAAW,EAAE,EAAE;IALjC,2CAA2C;IAC3C,SAAgB,OAAO,EAAE,EAAE,EAAE,CAAC;IAE9B;IACE,uCAAuC;IACvB,WAAW,EAAE,EAAE;IAC/B,2CAA2C;IAC3C,OAAO,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,EAGzB;IAED,MAAM,KAAK,MAAM,6GAEhB;IAED,MAAM,kBAEL;IAED,QAAQ,4BAEP;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,WAAW,CAG5D;IAED,QAAQ,kBAEP;IAED,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,eAE5B;IAED,MAAM,CAAC,MAAM,gBAEZ;CACF;AAED;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,6BAEnC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,kFAEnC,CAAC"}