@aztec-labs/protocol-contracts 6.0.0-nightly.20260829

package/dest/class-registry/contract_class_published_event.d.ts

@@ -0,0 +1,20 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { type ContractClassPublic, type ContractClassPublicWithCommitment } from '@aztec-labs/stdlib/contract';
+import type { ContractClassLog } from '@aztec-labs/stdlib/logs';
+/** Event emitted from the ContractClassRegistry. */
+export declare class ContractClassPublishedEvent {
+    readonly contractClassId: Fr;
+    readonly version: number;
+    readonly artifactHash: Fr;
+    readonly privateFunctionsRoot: Fr;
+    readonly packedPublicBytecode: Buffer;
+    constructor(contractClassId: Fr, version: number, artifactHash: Fr, privateFunctionsRoot: Fr, packedPublicBytecode: Buffer);
+    static isContractClassPublishedEvent(log: ContractClassLog): boolean;
+    static fromLog(log: ContractClassLog): ContractClassPublishedEvent;
+    /** Converts the event to a contract class, without computing or validating the bytecode commitment. */
+    toContractClassPublic(): ContractClassPublic;
+    /** Converts the event to a contract class with its bytecode commitment (expensive). */
+    toContractClassPublicWithBytecodeCommitment(): Promise<ContractClassPublicWithCommitment>;
+    static extractContractClassEvents(logs: ContractClassLog[]): ContractClassPublishedEvent[];
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udHJhY3RfY2xhc3NfcHVibGlzaGVkX2V2ZW50LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY2xhc3MtcmVnaXN0cnkvY29udHJhY3RfY2xhc3NfcHVibGlzaGVkX2V2ZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxxQ0FBcUMsQ0FBQztBQUd6RCxPQUFPLEVBQ0wsS0FBSyxtQkFBbUIsRUFDeEIsS0FBSyxpQ0FBaUMsRUFFdkMsTUFBTSw2QkFBNkIsQ0FBQztBQUNyQyxPQUFPLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBSWhFLG9EQUFvRDtBQUNwRCxxQkFBYSwyQkFBMkI7YUFFcEIsZUFBZSxFQUFFLEVBQUU7YUFDbkIsT0FBTyxFQUFFLE1BQU07YUFDZixZQUFZLEVBQUUsRUFBRTthQUNoQixvQkFBb0IsRUFBRSxFQUFFO2FBQ3hCLG9CQUFvQixFQUFFLE1BQU07SUFMOUMsWUFDa0IsZUFBZSxFQUFFLEVBQUUsRUFDbkIsT0FBTyxFQUFFLE1BQU0sRUFDZixZQUFZLEVBQUUsRUFBRSxFQUNoQixvQkFBb0IsRUFBRSxFQUFFLEVBQ3hCLG9CQUFvQixFQUFFLE1BQU0sRUFDMUM7SUFFSixNQUFNLENBQUMsNkJBQTZCLENBQUMsR0FBRyxFQUFFLGdCQUFnQixXQUt6RDtJQUVELE1BQU0sQ0FBQyxPQUFPLENBQUMsR0FBRyxFQUFFLGdCQUFnQiwrQkFzQm5DO0lBRUQsdUdBQXVHO0lBQ3ZHLHFCQUFxQixJQUFJLG1CQUFtQixDQVEzQztJQUVELHVGQUF1RjtJQUNqRiwyQ0FBMkMsSUFBSSxPQUFPLENBQUMsaUNBQWlDLENBQUMsQ0FHOUY7SUFFRCxPQUFjLDBCQUEwQixDQUFDLElBQUksRUFBRSxnQkFBZ0IsRUFBRSxHQUFHLDJCQUEyQixFQUFFLENBSWhHO0NBQ0YifQ==

package/dest/class-registry/contract_class_published_event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract_class_published_event.d.ts","sourceRoot":"","sources":["../../src/class-registry/contract_class_published_event.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AAGzD,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,iCAAiC,EAEvC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,oDAAoD;AACpD,qBAAa,2BAA2B;aAEpB,eAAe,EAAE,EAAE;aACnB,OAAO,EAAE,MAAM;aACf,YAAY,EAAE,EAAE;aAChB,oBAAoB,EAAE,EAAE;aACxB,oBAAoB,EAAE,MAAM;IAL9C,YACkB,eAAe,EAAE,EAAE,EACnB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,EAAE,EAChB,oBAAoB,EAAE,EAAE,EACxB,oBAAoB,EAAE,MAAM,EAC1C;IAEJ,MAAM,CAAC,6BAA6B,CAAC,GAAG,EAAE,gBAAgB,WAKzD;IAED,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,gBAAgB,+BAsBnC;IAED,uGAAuG;IACvG,qBAAqB,IAAI,mBAAmB,CAQ3C;IAED,uFAAuF;IACjF,2CAA2C,IAAI,OAAO,CAAC,iCAAiC,CAAC,CAG9F;IAED,OAAc,0BAA0B,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,2BAA2B,EAAE,CAIhG;CACF"}

package/dest/class-registry/contract_class_published_event.js

@@ -0,0 +1,58 @@
+import { CONTRACT_CLASS_PUBLISHED_MAGIC_VALUE } from '@aztec-labs/constants';
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { FieldReader } from '@aztec-labs/foundation/serialize';
+import { bufferFromFields } from '@aztec-labs/stdlib/abi';
+import { computePublicBytecodeCommitment } from '@aztec-labs/stdlib/contract';
+import { ProtocolContractAddress } from '../protocol_contract_data.js';
+/** Event emitted from the ContractClassRegistry. */ export class ContractClassPublishedEvent {
+    contractClassId;
+    version;
+    artifactHash;
+    privateFunctionsRoot;
+    packedPublicBytecode;
+    constructor(contractClassId, version, artifactHash, privateFunctionsRoot, packedPublicBytecode){
+        this.contractClassId = contractClassId;
+        this.version = version;
+        this.artifactHash = artifactHash;
+        this.privateFunctionsRoot = privateFunctionsRoot;
+        this.packedPublicBytecode = packedPublicBytecode;
+    }
+    static isContractClassPublishedEvent(log) {
+        return log.contractAddress.equals(ProtocolContractAddress.ContractClassRegistry) && log.fields.fields[0].toBigInt() === CONTRACT_CLASS_PUBLISHED_MAGIC_VALUE;
+    }
+    static fromLog(log) {
+        // See how the log is serialized in `noir-projects/fnd/noir-contracts/contracts/protocol/contract_class_registry_contract/src/events/class_published.nr`.
+        const fieldsWithoutTag = log.fields.fields.slice(1);
+        const reader = new FieldReader(fieldsWithoutTag);
+        const contractClassId = reader.readField();
+        const version = reader.readField().toNumber();
+        const artifactHash = reader.readField();
+        const privateFunctionsRoot = reader.readField();
+        const bytecodeFields = reader.readFieldArray(fieldsWithoutTag.length - reader.cursor);
+        // The fixed-size class log can hold at most this many packed-bytecode bytes (every payload field
+        // carries 31 bytes). Bound the declared length to it so a malformed log can't declare a multi-MiB
+        // length backed by a tiny payload and force a large allocation during early (pre-proof) validation.
+        const maxByteLength = (bytecodeFields.length - 1) * (Fr.SIZE_IN_BYTES - 1);
+        const packedPublicBytecode = bufferFromFields(bytecodeFields, maxByteLength);
+        return new ContractClassPublishedEvent(contractClassId, version, artifactHash, privateFunctionsRoot, packedPublicBytecode);
+    }
+    /** Converts the event to a contract class, without computing or validating the bytecode commitment. */ toContractClassPublic() {
+        return {
+            id: this.contractClassId,
+            artifactHash: this.artifactHash,
+            packedBytecode: this.packedPublicBytecode,
+            privateFunctionsRoot: this.privateFunctionsRoot,
+            version: this.version
+        };
+    }
+    /** Converts the event to a contract class with its bytecode commitment (expensive). */ async toContractClassPublicWithBytecodeCommitment() {
+        const publicBytecodeCommitment = await computePublicBytecodeCommitment(this.packedPublicBytecode);
+        return {
+            ...this.toContractClassPublic(),
+            publicBytecodeCommitment
+        };
+    }
+    static extractContractClassEvents(logs) {
+        return logs.filter((log)=>ContractClassPublishedEvent.isContractClassPublishedEvent(log)).map((log)=>ContractClassPublishedEvent.fromLog(log));
+    }
+}

package/dest/class-registry/index.d.ts

@@ -0,0 +1,6 @@
+import type { ProtocolContract } from '../protocol_contract.js';
+export * from './contract_class_published_event.js';
+export declare const ContractClassRegistryArtifact: import("@aztec-labs/stdlib/abi").ContractArtifact;
+/** Returns the canonical deployment of the contract. */
+export declare function getCanonicalClassRegistry(): Promise<ProtocolContract>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jbGFzcy1yZWdpc3RyeS9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFLQSxPQUFPLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBRWhFLGNBQWMscUNBQXFDLENBQUM7QUFFcEQsZUFBTyxNQUFNLDZCQUE2QixtREFBMEUsQ0FBQztBQUlySCx3REFBd0Q7QUFDeEQsd0JBQWdCLHlCQUF5QixJQUFJLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQyxDQU1yRSJ9

package/dest/class-registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/class-registry/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,cAAc,qCAAqC,CAAC;AAEpD,eAAO,MAAM,6BAA6B,mDAA0E,CAAC;AAIrH,wDAAwD;AACxD,wBAAgB,yBAAyB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAMrE"}

package/dest/class-registry/index.js

@@ -0,0 +1,15 @@
+import { loadContractArtifact } from '@aztec-labs/stdlib/abi';
+import ContractClassRegistryJson from '../../artifacts/ContractClassRegistry.json' with {
+    type: 'json'
+};
+import { makeProtocolContract } from '../make_protocol_contract.js';
+export * from './contract_class_published_event.js';
+export const ContractClassRegistryArtifact = loadContractArtifact(ContractClassRegistryJson);
+let protocolContract;
+/** Returns the canonical deployment of the contract. */ export function getCanonicalClassRegistry() {
+    if (!protocolContract) {
+        const artifact = ContractClassRegistryArtifact;
+        protocolContract = makeProtocolContract('ContractClassRegistry', artifact);
+    }
+    return Promise.resolve(protocolContract);
+}

package/dest/class-registry/lazy.d.ts

@@ -0,0 +1,7 @@
+import { type ContractArtifact } from '@aztec-labs/stdlib/abi';
+import type { ProtocolContract } from '../protocol_contract.js';
+export * from './contract_class_published_event.js';
+export declare function getContractClassRegistryArtifact(): Promise<ContractArtifact>;
+/** Returns the canonical deployment of the auth registry. */
+export declare function getCanonicalClassRegistry(): Promise<ProtocolContract>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibGF6eS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NsYXNzLXJlZ2lzdHJ5L2xhenkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLEtBQUssZ0JBQWdCLEVBQXdCLE1BQU0sd0JBQXdCLENBQUM7QUFHckYsT0FBTyxLQUFLLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUVoRSxjQUFjLHFDQUFxQyxDQUFDO0FBS3BELHdCQUFzQixnQ0FBZ0MsSUFBSSxPQUFPLENBQUMsZ0JBQWdCLENBQUMsQ0FXbEY7QUFFRCw2REFBNkQ7QUFDN0Qsd0JBQXNCLHlCQUF5QixJQUFJLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQyxDQU0zRSJ9

package/dest/class-registry/lazy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../../src/class-registry/lazy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAwB,MAAM,wBAAwB,CAAC;AAGrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,cAAc,qCAAqC,CAAC;AAKpD,wBAAsB,gCAAgC,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAWlF;AAED,6DAA6D;AAC7D,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAM3E"}

package/dest/class-registry/lazy.js

@@ -0,0 +1,24 @@
+import { loadContractArtifact } from '@aztec-labs/stdlib/abi';
+import { makeProtocolContract } from '../make_protocol_contract.js';
+export * from './contract_class_published_event.js';
+let protocolContract;
+let protocolContractArtifact;
+export async function getContractClassRegistryArtifact() {
+    if (!protocolContractArtifact) {
+        // Cannot assert this import as it's incompatible with bundlers like vite
+        // https://github.com/vitejs/vite/issues/19095#issuecomment-2566074352
+        // Even if now supported by all major browsers, the MIME type is replaced with
+        // "text/javascript"
+        // In the meantime, this lazy import is INCOMPATIBLE WITH NODEJS
+        const { default: contractClassRegistryJson } = await import('../../artifacts/ContractClassRegistry.json');
+        protocolContractArtifact = loadContractArtifact(contractClassRegistryJson);
+    }
+    return protocolContractArtifact;
+}
+/** Returns the canonical deployment of the auth registry. */ export async function getCanonicalClassRegistry() {
+    if (!protocolContract) {
+        const contractClassRegistryArtifact = await getContractClassRegistryArtifact();
+        protocolContract = makeProtocolContract('ContractClassRegistry', contractClassRegistryArtifact);
+    }
+    return protocolContract;
+}

package/dest/fee-juice/index.d.ts

@@ -0,0 +1,15 @@
+import type { Fr } from '@aztec-labs/foundation/curves/bn254';
+import type { AztecAddress } from '@aztec-labs/stdlib/aztec-address';
+import type { ProtocolContract } from '../protocol_contract.js';
+export declare const FeeJuiceArtifact: import("@aztec-labs/stdlib/abi").ContractArtifact;
+/** Returns the canonical deployment of the contract. */
+export declare function getCanonicalFeeJuice(): Promise<ProtocolContract>;
+/**
+ * Computes the storage slot within the Fee Juice contract for the balance of the fee payer.
+ */
+export declare function computeFeePayerBalanceStorageSlot(feePayer: AztecAddress): Promise<Fr>;
+/**
+ * Computes the leaf slot in the public data tree for the balance of the fee payer in the Fee Juice.
+ */
+export declare function computeFeePayerBalanceLeafSlot(feePayer: AztecAddress): Promise<Fr>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9mZWUtanVpY2UvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsRUFBRSxFQUFFLE1BQU0scUNBQXFDLENBQUM7QUFFOUQsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFNckUsT0FBTyxLQUFLLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUdoRSxlQUFPLE1BQU0sZ0JBQWdCLG1EQUE2RCxDQUFDO0FBSTNGLHdEQUF3RDtBQUN4RCx3QkFBZ0Isb0JBQW9CLElBQUksT0FBTyxDQUFDLGdCQUFnQixDQUFDLENBS2hFO0FBRUQ7O0dBRUc7QUFDSCx3QkFBZ0IsaUNBQWlDLENBQUMsUUFBUSxFQUFFLFlBQVksR0FBRyxPQUFPLENBQUMsRUFBRSxDQUFDLENBRXJGO0FBRUQ7O0dBRUc7QUFDSCx3QkFBc0IsOEJBQThCLENBQUMsUUFBUSxFQUFFLFlBQVksR0FBRyxPQUFPLENBQUMsRUFBRSxDQUFDLENBR3hGIn0=

package/dest/fee-juice/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fee-juice/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAMrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,eAAO,MAAM,gBAAgB,mDAA6D,CAAC;AAI3F,wDAAwD;AACxD,wBAAgB,oBAAoB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAKhE;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,EAAE,CAAC,CAErF;AAED;;GAEG;AACH,wBAAsB,8BAA8B,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,EAAE,CAAC,CAGxF"}

package/dest/fee-juice/index.js

@@ -0,0 +1,26 @@
+import { loadContractArtifact } from '@aztec-labs/stdlib/abi';
+import { computePublicDataTreeLeafSlot, deriveStorageSlotInMap } from '@aztec-labs/stdlib/hash';
+import FeeJuiceJson from '../../artifacts/FeeJuice.json' with {
+    type: 'json'
+};
+import { makeProtocolContract } from '../make_protocol_contract.js';
+import { ProtocolContractAddress } from '../protocol_contract_data.js';
+export const FeeJuiceArtifact = loadContractArtifact(FeeJuiceJson);
+let protocolContract;
+/** Returns the canonical deployment of the contract. */ export function getCanonicalFeeJuice() {
+    if (!protocolContract) {
+        protocolContract = makeProtocolContract('FeeJuice', FeeJuiceArtifact);
+    }
+    return Promise.resolve(protocolContract);
+}
+/**
+ * Computes the storage slot within the Fee Juice contract for the balance of the fee payer.
+ */ export function computeFeePayerBalanceStorageSlot(feePayer) {
+    return deriveStorageSlotInMap(FeeJuiceArtifact.storageLayout.balances.slot, feePayer);
+}
+/**
+ * Computes the leaf slot in the public data tree for the balance of the fee payer in the Fee Juice.
+ */ export async function computeFeePayerBalanceLeafSlot(feePayer) {
+    const balanceSlot = await computeFeePayerBalanceStorageSlot(feePayer);
+    return computePublicDataTreeLeafSlot(ProtocolContractAddress.FeeJuice, balanceSlot);
+}

package/dest/fee-juice/lazy.d.ts

@@ -0,0 +1,6 @@
+import { type ContractArtifact } from '@aztec-labs/stdlib/abi';
+import type { ProtocolContract } from '../protocol_contract.js';
+export declare function getFeeJuiceArtifact(): Promise<ContractArtifact>;
+/** Returns the canonical deployment of the auth registry. */
+export declare function getCanonicalFeeJuice(): Promise<ProtocolContract>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibGF6eS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2ZlZS1qdWljZS9sYXp5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxLQUFLLGdCQUFnQixFQUF3QixNQUFNLHdCQUF3QixDQUFDO0FBR3JGLE9BQU8sS0FBSyxFQUFFLGdCQUFnQixFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFLaEUsd0JBQXNCLG1CQUFtQixJQUFJLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQyxDQVdyRTtBQUVELDZEQUE2RDtBQUM3RCx3QkFBc0Isb0JBQW9CLElBQUksT0FBTyxDQUFDLGdCQUFnQixDQUFDLENBTXRFIn0=

package/dest/fee-juice/lazy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../../src/fee-juice/lazy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAwB,MAAM,wBAAwB,CAAC;AAGrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAKhE,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAWrE;AAED,6DAA6D;AAC7D,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAMtE"}

package/dest/fee-juice/lazy.js

@@ -0,0 +1,23 @@
+import { loadContractArtifact } from '@aztec-labs/stdlib/abi';
+import { makeProtocolContract } from '../make_protocol_contract.js';
+let protocolContract;
+let protocolContractArtifact;
+export async function getFeeJuiceArtifact() {
+    if (!protocolContractArtifact) {
+        // Cannot assert this import as it's incompatible with bundlers like vite
+        // https://github.com/vitejs/vite/issues/19095#issuecomment-2566074352
+        // Even if now supported by all major browsers, the MIME type is replaced with
+        // "text/javascript"
+        // In the meantime, this lazy import is INCOMPATIBLE WITH NODEJS
+        const { default: feeJuiceJson } = await import('../../artifacts/FeeJuice.json');
+        protocolContractArtifact = loadContractArtifact(feeJuiceJson);
+    }
+    return protocolContractArtifact;
+}
+/** Returns the canonical deployment of the auth registry. */ export async function getCanonicalFeeJuice() {
+    if (!protocolContract) {
+        const feeJuiceArtifact = await getFeeJuiceArtifact();
+        protocolContract = makeProtocolContract('FeeJuice', feeJuiceArtifact);
+    }
+    return protocolContract;
+}

package/dest/index.d.ts

@@ -0,0 +1,3 @@
+export * from './protocol_contract.js';
+export * from './protocol_contract_data.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLHdCQUF3QixDQUFDO0FBQ3ZDLGNBQWMsNkJBQTZCLENBQUMifQ==

package/dest/index.d.ts.map

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

package/dest/index.js

@@ -0,0 +1,2 @@
+export * from './protocol_contract.js';
+export * from './protocol_contract_data.js';

package/dest/instance-registry/contract_instance_published_event.d.ts

@@ -0,0 +1,22 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { AztecAddress } from '@aztec-labs/stdlib/aztec-address';
+import type { ContractInstanceWithAddress } from '@aztec-labs/stdlib/contract';
+import { PublicKeys } from '@aztec-labs/stdlib/keys';
+import type { PrivateLog } from '@aztec-labs/stdlib/logs';
+/** Event emitted from the ContractInstanceRegistry. */
+export declare class ContractInstancePublishedEvent {
+    readonly address: AztecAddress;
+    readonly version: number;
+    readonly salt: Fr;
+    readonly contractClassId: Fr;
+    readonly initializationHash: Fr;
+    readonly immutablesHash: Fr;
+    readonly publicKeys: PublicKeys;
+    readonly deployer: AztecAddress;
+    constructor(address: AztecAddress, version: number, salt: Fr, contractClassId: Fr, initializationHash: Fr, immutablesHash: Fr, publicKeys: PublicKeys, deployer: AztecAddress);
+    static isContractInstancePublishedEvent(log: PrivateLog): boolean;
+    static fromLog(log: PrivateLog): ContractInstancePublishedEvent;
+    toContractInstance(): ContractInstanceWithAddress;
+    static extractContractInstanceEvents(logs: PrivateLog[]): ContractInstancePublishedEvent[];
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udHJhY3RfaW5zdGFuY2VfcHVibGlzaGVkX2V2ZW50LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5zdGFuY2UtcmVnaXN0cnkvY29udHJhY3RfaW5zdGFuY2VfcHVibGlzaGVkX2V2ZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxxQ0FBcUMsQ0FBQztBQUV6RCxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFDaEUsT0FBTyxLQUFLLEVBQUUsMkJBQTJCLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUMvRSxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFDckQsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFJMUQsdURBQXVEO0FBQ3ZELHFCQUFhLDhCQUE4QjthQUV2QixPQUFPLEVBQUUsWUFBWTthQUNyQixPQUFPLEVBQUUsTUFBTTthQUNmLElBQUksRUFBRSxFQUFFO2FBQ1IsZUFBZSxFQUFFLEVBQUU7YUFDbkIsa0JBQWtCLEVBQUUsRUFBRTthQUN0QixjQUFjLEVBQUUsRUFBRTthQUNsQixVQUFVLEVBQUUsVUFBVTthQUN0QixRQUFRLEVBQUUsWUFBWTtJQVJ4QyxZQUNrQixPQUFPLEVBQUUsWUFBWSxFQUNyQixPQUFPLEVBQUUsTUFBTSxFQUNmLElBQUksRUFBRSxFQUFFLEVBQ1IsZUFBZSxFQUFFLEVBQUUsRUFDbkIsa0JBQWtCLEVBQUUsRUFBRSxFQUN0QixjQUFjLEVBQUUsRUFBRSxFQUNsQixVQUFVLEVBQUUsVUFBVSxFQUN0QixRQUFRLEVBQUUsWUFBWSxFQUNwQztJQUVKLE1BQU0sQ0FBQyxnQ0FBZ0MsQ0FBQyxHQUFHLEVBQUUsVUFBVSxXQUV0RDtJQUVELE1BQU0sQ0FBQyxPQUFPLENBQUMsR0FBRyxFQUFFLFVBQVUsa0NBc0I3QjtJQUVELGtCQUFrQixJQUFJLDJCQUEyQixDQWdCaEQ7SUFFRCxPQUFjLDZCQUE2QixDQUFDLElBQUksRUFBRSxVQUFVLEVBQUUsR0FBRyw4QkFBOEIsRUFBRSxDQUloRztDQUNGIn0=

package/dest/instance-registry/contract_instance_published_event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract_instance_published_event.d.ts","sourceRoot":"","sources":["../../src/instance-registry/contract_instance_published_event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAI1D,uDAAuD;AACvD,qBAAa,8BAA8B;aAEvB,OAAO,EAAE,YAAY;aACrB,OAAO,EAAE,MAAM;aACf,IAAI,EAAE,EAAE;aACR,eAAe,EAAE,EAAE;aACnB,kBAAkB,EAAE,EAAE;aACtB,cAAc,EAAE,EAAE;aAClB,UAAU,EAAE,UAAU;aACtB,QAAQ,EAAE,YAAY;IARxC,YACkB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,EAAE,EACR,eAAe,EAAE,EAAE,EACnB,kBAAkB,EAAE,EAAE,EACtB,cAAc,EAAE,EAAE,EAClB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,YAAY,EACpC;IAEJ,MAAM,CAAC,gCAAgC,CAAC,GAAG,EAAE,UAAU,WAEtD;IAED,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,kCAsB7B;IAED,kBAAkB,IAAI,2BAA2B,CAgBhD;IAED,OAAc,6BAA6B,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,8BAA8B,EAAE,CAIhG;CACF"}

package/dest/instance-registry/contract_instance_published_event.js

@@ -0,0 +1,60 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { BufferReader } from '@aztec-labs/foundation/serialize';
+import { AztecAddress } from '@aztec-labs/stdlib/aztec-address';
+import { PublicKeys } from '@aztec-labs/stdlib/keys';
+import { CONTRACT_INSTANCE_PUBLISHED_EVENT_TAG } from '../protocol_contract_data.js';
+/** Event emitted from the ContractInstanceRegistry. */ export class ContractInstancePublishedEvent {
+    address;
+    version;
+    salt;
+    contractClassId;
+    initializationHash;
+    immutablesHash;
+    publicKeys;
+    deployer;
+    constructor(address, version, salt, contractClassId, initializationHash, immutablesHash, publicKeys, deployer){
+        this.address = address;
+        this.version = version;
+        this.salt = salt;
+        this.contractClassId = contractClassId;
+        this.initializationHash = initializationHash;
+        this.immutablesHash = immutablesHash;
+        this.publicKeys = publicKeys;
+        this.deployer = deployer;
+    }
+    static isContractInstancePublishedEvent(log) {
+        return log.fields[0].equals(CONTRACT_INSTANCE_PUBLISHED_EVENT_TAG);
+    }
+    static fromLog(log) {
+        const bufferWithoutTag = log.toBuffer().subarray(32);
+        const reader = new BufferReader(bufferWithoutTag);
+        const address = reader.readObject(AztecAddress);
+        const version = reader.readObject(Fr).toNumber();
+        const salt = reader.readObject(Fr);
+        const contractClassId = reader.readObject(Fr);
+        const initializationHash = reader.readObject(Fr);
+        const immutablesHash = reader.readObject(Fr);
+        const publicKeys = reader.readObject(PublicKeys);
+        const deployer = reader.readObject(AztecAddress);
+        return new ContractInstancePublishedEvent(address, version, salt, contractClassId, initializationHash, immutablesHash, publicKeys, deployer);
+    }
+    toContractInstance() {
+        if (this.version !== 2) {
+            throw new Error(`Unexpected contract instance version ${this.version}`);
+        }
+        return {
+            address: this.address,
+            version: this.version,
+            currentContractClassId: this.contractClassId,
+            originalContractClassId: this.contractClassId,
+            initializationHash: this.initializationHash,
+            immutablesHash: this.immutablesHash,
+            publicKeys: this.publicKeys,
+            salt: this.salt,
+            deployer: this.deployer
+        };
+    }
+    static extractContractInstanceEvents(logs) {
+        return logs.filter((log)=>ContractInstancePublishedEvent.isContractInstancePublishedEvent(log)).map((log)=>ContractInstancePublishedEvent.fromLog(log));
+    }
+}

package/dest/instance-registry/contract_instance_updated_event.d.ts

@@ -0,0 +1,17 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { AztecAddress } from '@aztec-labs/stdlib/aztec-address';
+import type { ContractInstanceUpdateWithAddress } from '@aztec-labs/stdlib/contract';
+import type { PublicLog } from '@aztec-labs/stdlib/logs';
+import type { UInt64 } from '@aztec-labs/stdlib/types';
+/** Event emitted from the ContractInstanceRegistry. */
+export declare class ContractInstanceUpdatedEvent {
+    readonly address: AztecAddress;
+    readonly prevContractClassId: Fr;
+    readonly newContractClassId: Fr;
+    readonly timestampOfChange: UInt64;
+    constructor(address: AztecAddress, prevContractClassId: Fr, newContractClassId: Fr, timestampOfChange: UInt64);
+    static isContractInstanceUpdatedEvent(log: PublicLog): boolean;
+    static fromLog(log: PublicLog): ContractInstanceUpdatedEvent;
+    toContractInstanceUpdate(): ContractInstanceUpdateWithAddress;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udHJhY3RfaW5zdGFuY2VfdXBkYXRlZF9ldmVudC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2luc3RhbmNlLXJlZ2lzdHJ5L2NvbnRyYWN0X2luc3RhbmNlX3VwZGF0ZWRfZXZlbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLHFDQUFxQyxDQUFDO0FBRXpELE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxrQ0FBa0MsQ0FBQztBQUNoRSxPQUFPLEtBQUssRUFBRSxpQ0FBaUMsRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBQ3JGLE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQ3pELE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBSXZELHVEQUF1RDtBQUN2RCxxQkFBYSw0QkFBNEI7YUFFckIsT0FBTyxFQUFFLFlBQVk7YUFDckIsbUJBQW1CLEVBQUUsRUFBRTthQUN2QixrQkFBa0IsRUFBRSxFQUFFO2FBQ3RCLGlCQUFpQixFQUFFLE1BQU07SUFKM0MsWUFDa0IsT0FBTyxFQUFFLFlBQVksRUFDckIsbUJBQW1CLEVBQUUsRUFBRSxFQUN2QixrQkFBa0IsRUFBRSxFQUFFLEVBQ3RCLGlCQUFpQixFQUFFLE1BQU0sRUFDdkM7SUFFSixNQUFNLENBQUMsOEJBQThCLENBQUMsR0FBRyxFQUFFLFNBQVMsV0FLbkQ7SUFFRCxNQUFNLENBQUMsT0FBTyxDQUFDLEdBQUcsRUFBRSxTQUFTLGdDQU81QjtJQUVELHdCQUF3QixJQUFJLGlDQUFpQyxDQU81RDtDQUNGIn0=

package/dest/instance-registry/contract_instance_updated_event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract_instance_updated_event.d.ts","sourceRoot":"","sources":["../../src/instance-registry/contract_instance_updated_event.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAIvD,uDAAuD;AACvD,qBAAa,4BAA4B;aAErB,OAAO,EAAE,YAAY;aACrB,mBAAmB,EAAE,EAAE;aACvB,kBAAkB,EAAE,EAAE;aACtB,iBAAiB,EAAE,MAAM;IAJ3C,YACkB,OAAO,EAAE,YAAY,EACrB,mBAAmB,EAAE,EAAE,EACvB,kBAAkB,EAAE,EAAE,EACtB,iBAAiB,EAAE,MAAM,EACvC;IAEJ,MAAM,CAAC,8BAA8B,CAAC,GAAG,EAAE,SAAS,WAKnD;IAED,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,gCAO5B;IAED,wBAAwB,IAAI,iCAAiC,CAO5D;CACF"}

package/dest/instance-registry/contract_instance_updated_event.js

@@ -0,0 +1,35 @@
+import { CONTRACT_INSTANCE_UPDATED_MAGIC_VALUE } from '@aztec-labs/constants';
+import { FieldReader } from '@aztec-labs/foundation/serialize';
+import { AztecAddress } from '@aztec-labs/stdlib/aztec-address';
+import { ProtocolContractAddress } from '../protocol_contract_data.js';
+/** Event emitted from the ContractInstanceRegistry. */ export class ContractInstanceUpdatedEvent {
+    address;
+    prevContractClassId;
+    newContractClassId;
+    timestampOfChange;
+    constructor(address, prevContractClassId, newContractClassId, timestampOfChange){
+        this.address = address;
+        this.prevContractClassId = prevContractClassId;
+        this.newContractClassId = newContractClassId;
+        this.timestampOfChange = timestampOfChange;
+    }
+    static isContractInstanceUpdatedEvent(log) {
+        return log.contractAddress.equals(ProtocolContractAddress.ContractInstanceRegistry) && log.fields[0].toBigInt() === CONTRACT_INSTANCE_UPDATED_MAGIC_VALUE;
+    }
+    static fromLog(log) {
+        const reader = new FieldReader(log.fields.slice(1));
+        const address = reader.readObject(AztecAddress);
+        const prevContractClassId = reader.readField();
+        const newContractClassId = reader.readField();
+        const timestampOfChange = reader.readField().toBigInt();
+        return new ContractInstanceUpdatedEvent(address, prevContractClassId, newContractClassId, timestampOfChange);
+    }
+    toContractInstanceUpdate() {
+        return {
+            address: this.address,
+            prevContractClassId: this.prevContractClassId,
+            newContractClassId: this.newContractClassId,
+            timestampOfChange: this.timestampOfChange
+        };
+    }
+}

package/dest/instance-registry/index.d.ts

@@ -0,0 +1,7 @@
+import type { ProtocolContract } from '../protocol_contract.js';
+export * from './contract_instance_published_event.js';
+export * from './contract_instance_updated_event.js';
+export declare const ContractInstanceRegistryArtifact: import("@aztec-labs/stdlib/abi").ContractArtifact;
+/** Returns the canonical deployment of the contract. */
+export declare function getCanonicalInstanceRegistry(): Promise<ProtocolContract>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9pbnN0YW5jZS1yZWdpc3RyeS9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFLQSxPQUFPLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBRWhFLGNBQWMsd0NBQXdDLENBQUM7QUFDdkQsY0FBYyxzQ0FBc0MsQ0FBQztBQUVyRCxlQUFPLE1BQU0sZ0NBQWdDLG1EQUU1QyxDQUFDO0FBSUYsd0RBQXdEO0FBQ3hELHdCQUFnQiw0QkFBNEIsSUFBSSxPQUFPLENBQUMsZ0JBQWdCLENBQUMsQ0FLeEUifQ==

package/dest/instance-registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/instance-registry/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AAErD,eAAO,MAAM,gCAAgC,mDAE5C,CAAC;AAIF,wDAAwD;AACxD,wBAAgB,4BAA4B,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAKxE"}

package/dest/instance-registry/index.js

@@ -0,0 +1,15 @@
+import { loadContractArtifact } from '@aztec-labs/stdlib/abi';
+import ContractInstanceRegistryJson from '../../artifacts/ContractInstanceRegistry.json' with {
+    type: 'json'
+};
+import { makeProtocolContract } from '../make_protocol_contract.js';
+export * from './contract_instance_published_event.js';
+export * from './contract_instance_updated_event.js';
+export const ContractInstanceRegistryArtifact = loadContractArtifact(ContractInstanceRegistryJson);
+let protocolContract;
+/** Returns the canonical deployment of the contract. */ export function getCanonicalInstanceRegistry() {
+    if (!protocolContract) {
+        protocolContract = makeProtocolContract('ContractInstanceRegistry', ContractInstanceRegistryArtifact);
+    }
+    return Promise.resolve(protocolContract);
+}

package/dest/instance-registry/lazy.d.ts

@@ -0,0 +1,8 @@
+import { type ContractArtifact } from '@aztec-labs/stdlib/abi';
+import type { ProtocolContract } from '../protocol_contract.js';
+export * from './contract_instance_published_event.js';
+export * from './contract_instance_updated_event.js';
+export declare function getContractInstanceRegistryArtifact(): Promise<ContractArtifact>;
+/** Returns the canonical deployment of the auth registry. */
+export declare function getCanonicalInstanceRegistry(): Promise<ProtocolContract>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibGF6eS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2luc3RhbmNlLXJlZ2lzdHJ5L2xhenkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLEtBQUssZ0JBQWdCLEVBQXdCLE1BQU0sd0JBQXdCLENBQUM7QUFHckYsT0FBTyxLQUFLLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUVoRSxjQUFjLHdDQUF3QyxDQUFDO0FBQ3ZELGNBQWMsc0NBQXNDLENBQUM7QUFLckQsd0JBQXNCLG1DQUFtQyxJQUFJLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQyxDQVdyRjtBQUVELDZEQUE2RDtBQUM3RCx3QkFBc0IsNEJBQTRCLElBQUksT0FBTyxDQUFDLGdCQUFnQixDQUFDLENBTTlFIn0=

package/dest/instance-registry/lazy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../../src/instance-registry/lazy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAwB,MAAM,wBAAwB,CAAC;AAGrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AAKrD,wBAAsB,mCAAmC,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAWrF;AAED,6DAA6D;AAC7D,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAM9E"}

package/dest/instance-registry/lazy.js

@@ -0,0 +1,25 @@
+import { loadContractArtifact } from '@aztec-labs/stdlib/abi';
+import { makeProtocolContract } from '../make_protocol_contract.js';
+export * from './contract_instance_published_event.js';
+export * from './contract_instance_updated_event.js';
+let protocolContract;
+let protocolContractArtifact;
+export async function getContractInstanceRegistryArtifact() {
+    if (!protocolContractArtifact) {
+        // Cannot assert this import as it's incompatible with bundlers like vite
+        // https://github.com/vitejs/vite/issues/19095#issuecomment-2566074352
+        // Even if now supported by all major browsers, the MIME type is replaced with
+        // "text/javascript"
+        // In the meantime, this lazy import is INCOMPATIBLE WITH NODEJS
+        const { default: contractInstanceRegistryJson } = await import('../../artifacts/ContractInstanceRegistry.json');
+        protocolContractArtifact = loadContractArtifact(contractInstanceRegistryJson);
+    }
+    return protocolContractArtifact;
+}
+/** Returns the canonical deployment of the auth registry. */ export async function getCanonicalInstanceRegistry() {
+    if (!protocolContract) {
+        const contractInstanceRegistryArtifact = await getContractInstanceRegistryArtifact();
+        protocolContract = makeProtocolContract('ContractInstanceRegistry', contractInstanceRegistryArtifact);
+    }
+    return protocolContract;
+}

package/dest/make_protocol_contract.d.ts

@@ -0,0 +1,9 @@
+import type { ContractArtifact } from '@aztec-labs/stdlib/abi';
+import type { ProtocolContract } from './protocol_contract.js';
+import { type ProtocolContractName } from './protocol_contract_data.js';
+/**
+ * Reconstructs a ProtocolContract from precomputed data without performing any hash computations.
+ * Internal to the protocol-contracts package — not part of the public API.
+ */
+export declare function makeProtocolContract(name: ProtocolContractName, artifact: ContractArtifact): ProtocolContract;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWFrZV9wcm90b2NvbF9jb250cmFjdC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL21ha2VfcHJvdG9jb2xfY29udHJhY3QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUcvRCxPQUFPLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQy9ELE9BQU8sRUFLTCxLQUFLLG9CQUFvQixFQUcxQixNQUFNLDZCQUE2QixDQUFDO0FBRXJDOzs7R0FHRztBQUNILHdCQUFnQixvQkFBb0IsQ0FBQyxJQUFJLEVBQUUsb0JBQW9CLEVBQUUsUUFBUSxFQUFFLGdCQUFnQixHQUFHLGdCQUFnQixDQThCN0cifQ==

package/dest/make_protocol_contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make_protocol_contract.d.ts","sourceRoot":"","sources":["../src/make_protocol_contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAKL,KAAK,oBAAoB,EAG1B,MAAM,6BAA6B,CAAC;AAErC;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,gBAAgB,GAAG,gBAAgB,CA8B7G"}

package/dest/make_protocol_contract.js

@@ -0,0 +1,39 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { PublicKeys } from '@aztec-labs/stdlib/keys';
+import { ProtocolContractAddress, ProtocolContractClassId, ProtocolContractClassIdPreimage, ProtocolContractInitializationHash, ProtocolContractPrivateFunctions, ProtocolContractSalt } from './protocol_contract_data.js';
+/**
+ * Reconstructs a ProtocolContract from precomputed data without performing any hash computations.
+ * Internal to the protocol-contracts package — not part of the public API.
+ */ export function makeProtocolContract(name, artifact) {
+    const address = ProtocolContractAddress[name];
+    const salt = ProtocolContractSalt[name];
+    const classId = ProtocolContractClassId[name];
+    const { artifactHash, privateFunctionsRoot, publicBytecodeCommitment } = ProtocolContractClassIdPreimage[name];
+    const initializationHash = ProtocolContractInitializationHash[name];
+    const contractClass = {
+        id: classId,
+        version: 1,
+        artifactHash,
+        privateFunctionsRoot,
+        publicBytecodeCommitment,
+        packedBytecode: artifact.functions.find((f)=>f.name === 'public_dispatch')?.bytecode ?? Buffer.alloc(0),
+        privateFunctions: ProtocolContractPrivateFunctions[name]
+    };
+    const instance = {
+        version: 2,
+        currentContractClassId: classId,
+        originalContractClassId: classId,
+        initializationHash,
+        immutablesHash: Fr.ZERO,
+        publicKeys: PublicKeys.default(),
+        salt,
+        deployer: address,
+        address
+    };
+    return {
+        instance,
+        contractClass,
+        artifact,
+        address
+    };
+}

package/dest/protocol_contract.d.ts

@@ -0,0 +1,20 @@
+import type { Fr } from '@aztec-labs/foundation/curves/bn254';
+import type { ContractArtifact } from '@aztec-labs/stdlib/abi';
+import type { AztecAddress } from '@aztec-labs/stdlib/aztec-address';
+import type { ContractClassIdPreimage, ContractClassWithId, ContractInstanceWithAddress } from '@aztec-labs/stdlib/contract';
+/** Represents a canonical contract in the protocol. */
+export interface ProtocolContract {
+    /** Canonical deployed instance. */
+    instance: ContractInstanceWithAddress;
+    /** Contract class of this contract. */
+    contractClass: ContractClassWithId & ContractClassIdPreimage;
+    /** Complete contract artifact. */
+    artifact: ContractArtifact;
+    /** Deployment address for the canonical instance.  */
+    address: AztecAddress;
+}
+export declare function isProtocolContract(address: AztecAddress): boolean;
+/** Returns whether the given contract class id belongs to a bundled protocol contract. */
+export declare function isProtocolContractClass(classId: Fr): boolean;
+export { type ProtocolContractsProvider } from './provider/protocol_contracts_provider.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvdG9jb2xfY29udHJhY3QuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9wcm90b2NvbF9jb250cmFjdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxFQUFFLEVBQUUsTUFBTSxxQ0FBcUMsQ0FBQztBQUM5RCxPQUFPLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQy9ELE9BQU8sS0FBSyxFQUFFLFlBQVksRUFBRSxNQUFNLGtDQUFrQyxDQUFDO0FBQ3JFLE9BQU8sS0FBSyxFQUNWLHVCQUF1QixFQUN2QixtQkFBbUIsRUFDbkIsMkJBQTJCLEVBQzVCLE1BQU0sNkJBQTZCLENBQUM7QUFJckMsdURBQXVEO0FBQ3ZELE1BQU0sV0FBVyxnQkFBZ0I7SUFDL0IsbUNBQW1DO0lBQ25DLFFBQVEsRUFBRSwyQkFBMkIsQ0FBQztJQUN0Qyx1Q0FBdUM7SUFDdkMsYUFBYSxFQUFFLG1CQUFtQixHQUFHLHVCQUF1QixDQUFDO0lBQzdELGtDQUFrQztJQUNsQyxRQUFRLEVBQUUsZ0JBQWdCLENBQUM7SUFDM0Isc0RBQXNEO0lBQ3RELE9BQU8sRUFBRSxZQUFZLENBQUM7Q0FDdkI7QUFFRCx3QkFBZ0Isa0JBQWtCLENBQUMsT0FBTyxFQUFFLFlBQVksV0FFdkQ7QUFJRCwwRkFBMEY7QUFDMUYsd0JBQWdCLHVCQUF1QixDQUFDLE9BQU8sRUFBRSxFQUFFLEdBQUcsT0FBTyxDQUU1RDtBQUVELE9BQU8sRUFBRSxLQUFLLHlCQUF5QixFQUFFLE1BQU0sMkNBQTJDLENBQUMifQ==

package/dest/protocol_contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol_contract.d.ts","sourceRoot":"","sources":["../src/protocol_contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EACV,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,6BAA6B,CAAC;AAIrC,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,QAAQ,EAAE,2BAA2B,CAAC;IACtC,uCAAuC;IACvC,aAAa,EAAE,mBAAmB,GAAG,uBAAuB,CAAC;IAC7D,kCAAkC;IAClC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,sDAAsD;IACtD,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,WAEvD;AAID,0FAA0F;AAC1F,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,CAE5D;AAED,OAAO,EAAE,KAAK,yBAAyB,EAAE,MAAM,2CAA2C,CAAC"}

package/dest/protocol_contract.js

@@ -0,0 +1,8 @@
+import { ProtocolContractAddress, ProtocolContractClassId } from './protocol_contract_data.js';
+export function isProtocolContract(address) {
+    return Object.values(ProtocolContractAddress).some((a)=>a.equals(address));
+}
+const protocolContractClassIds = new Set(Object.values(ProtocolContractClassId).map((id)=>id.toString()));
+/** Returns whether the given contract class id belongs to a bundled protocol contract. */ export function isProtocolContractClass(classId) {
+    return protocolContractClassIds.has(classId.toString());
+}

package/dest/protocol_contract_data.d.ts

@@ -0,0 +1,28 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { FunctionSelector } from '@aztec-labs/stdlib/abi';
+import { AztecAddress } from '@aztec-labs/stdlib/aztec-address';
+import { ProtocolContracts } from '@aztec-labs/stdlib/tx';
+export declare const protocolContractNames: readonly ["ContractInstanceRegistry", "ContractClassRegistry", "FeeJuice"];
+export type ProtocolContractName = typeof protocolContractNames[number];
+export declare const ProtocolContractSalt: Record<ProtocolContractName, Fr>;
+export declare const ProtocolContractAddress: Record<ProtocolContractName, AztecAddress>;
+export declare const ProtocolContractDerivedAddress: {
+    ContractInstanceRegistry: AztecAddress;
+    ContractClassRegistry: AztecAddress;
+    FeeJuice: AztecAddress;
+};
+export declare const ProtocolContractClassId: Record<ProtocolContractName, Fr>;
+export declare const ProtocolContractClassIdPreimage: Record<ProtocolContractName, {
+    artifactHash: Fr;
+    privateFunctionsRoot: Fr;
+    publicBytecodeCommitment: Fr;
+}>;
+export declare const ProtocolContractInitializationHash: Record<ProtocolContractName, Fr>;
+export declare const ProtocolContractPrivateFunctions: Record<ProtocolContractName, {
+    selector: FunctionSelector;
+    vkHash: Fr;
+}[]>;
+export declare const ProtocolContractsList: ProtocolContracts;
+export declare const protocolContractsHash: Fr;
+export declare const CONTRACT_INSTANCE_PUBLISHED_EVENT_TAG: Fr;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvdG9jb2xfY29udHJhY3RfZGF0YS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL3Byb3RvY29sX2NvbnRyYWN0X2RhdGEudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUksT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLHFDQUFxQyxDQUFDO0FBQ3pELE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQzFELE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxrQ0FBa0MsQ0FBQztBQUNoRSxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUcxRCxlQUFPLE1BQU0scUJBQXFCLDRFQUl4QixDQUFDO0FBRVgsTUFBTSxNQUFNLG9CQUFvQixHQUFHLE9BQU8scUJBQXFCLENBQUMsTUFBTSxDQUFDLENBQUM7QUFJeEUsZUFBTyxNQUFNLG9CQUFvQixFQUFFLE1BQU0sQ0FBQyxvQkFBb0IsRUFBRSxFQUFFLENBSWpFLENBQUM7QUFJRixlQUFPLE1BQU0sdUJBQXVCLEVBQUUsTUFBTSxDQUFDLG9CQUFvQixFQUFFLFlBQVksQ0FJOUUsQ0FBQztBQUlGLGVBQU8sTUFBTSw4QkFBOEI7Ozs7Q0FJMUMsQ0FBQztBQUlGLGVBQU8sTUFBTSx1QkFBdUIsRUFBRSxNQUFNLENBQUMsb0JBQW9CLEVBQUUsRUFBRSxDQUlwRSxDQUFDO0FBRUYsZUFBTyxNQUFNLCtCQUErQixFQUFFLE1BQU0sQ0FBQyxvQkFBb0IsRUFBRTtJQUFFLFlBQVksRUFBRSxFQUFFLENBQUM7SUFBQyxvQkFBb0IsRUFBRSxFQUFFLENBQUM7SUFBQyx3QkFBd0IsRUFBRSxFQUFFLENBQUE7Q0FBRSxDQWdCdEosQ0FBQztBQUVGLGVBQU8sTUFBTSxrQ0FBa0MsRUFBRSxNQUFNLENBQUMsb0JBQW9CLEVBQUUsRUFBRSxDQUkvRSxDQUFDO0FBRUYsZUFBTyxNQUFNLGdDQUFnQyxFQUFFLE1BQU0sQ0FBQyxvQkFBb0IsRUFBRTtJQUFFLFFBQVEsRUFBRSxnQkFBZ0IsQ0FBQztJQUFDLE1BQU0sRUFBRSxFQUFFLENBQUE7Q0FBRSxFQUFFLENBSXZILENBQUM7QUFJRixlQUFPLE1BQU0scUJBQXFCLG1CQVloQyxDQUFDO0FBRUgsZUFBTyxNQUFNLHFCQUFxQixJQUFzRixDQUFDO0FBSTNILGVBQU8sTUFBTSxxQ0FBcUMsSUFBeUYsQ0FBQyJ9

package/dest/protocol_contract_data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol_contract_data.d.ts","sourceRoot":"","sources":["../src/protocol_contract_data.ts"],"names":[],"mappings":"AAEI,OAAO,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG1D,eAAO,MAAM,qBAAqB,4EAIxB,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAIxE,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,oBAAoB,EAAE,EAAE,CAIjE,CAAC;AAIF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,oBAAoB,EAAE,YAAY,CAI9E,CAAC;AAIF,eAAO,MAAM,8BAA8B;;;;CAI1C,CAAC;AAIF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,oBAAoB,EAAE,EAAE,CAIpE,CAAC;AAEF,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,oBAAoB,EAAE;IAAE,YAAY,EAAE,EAAE,CAAC;IAAC,oBAAoB,EAAE,EAAE,CAAC;IAAC,wBAAwB,EAAE,EAAE,CAAA;CAAE,CAgBtJ,CAAC;AAEF,eAAO,MAAM,kCAAkC,EAAE,MAAM,CAAC,oBAAoB,EAAE,EAAE,CAI/E,CAAC;AAEF,eAAO,MAAM,gCAAgC,EAAE,MAAM,CAAC,oBAAoB,EAAE;IAAE,QAAQ,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,EAAE,CAAA;CAAE,EAAE,CAIvH,CAAC;AAIF,eAAO,MAAM,qBAAqB,mBAYhC,CAAC;AAEH,eAAO,MAAM,qBAAqB,IAAsF,CAAC;AAI3H,eAAO,MAAM,qCAAqC,IAAyF,CAAC"}