@aztec-labs/stdlib 6.0.0-nightly.20260829

package/dest/contract/contract_deployment_data.js

@@ -0,0 +1,99 @@
+import { ContractClassLog, PrivateLog } from '@aztec-labs/stdlib/logs';
+import { z } from 'zod';
+/**
+ * Class containing contract class logs and private logs which are both
+ * relevant for contract registrations and deployments.
+ */ export class ContractDeploymentData {
+    contractClassLogs;
+    privateLogs;
+    constructor(contractClassLogs, privateLogs){
+        this.contractClassLogs = contractClassLogs;
+        this.privateLogs = privateLogs;
+    }
+    getContractClassLogs() {
+        return this.contractClassLogs;
+    }
+    getPrivateLogs() {
+        return this.privateLogs;
+    }
+    static from(args) {
+        return new ContractDeploymentData(args.contractClassLogs, args.privateLogs);
+    }
+    static empty() {
+        return new ContractDeploymentData([], []);
+    }
+    static get schema() {
+        return z.object({
+            contractClassLogs: z.array(ContractClassLog.schema),
+            privateLogs: z.array(PrivateLog.schema)
+        }).transform(ContractDeploymentData.from);
+    }
+    /**
+   * Creates a ContractDeploymentData from a plain object without Zod validation.
+   * This method is optimized for performance and skips validation, making it suitable
+   * for deserializing trusted data (e.g., from C++ via MessagePack).
+   * @param obj - Plain object containing ContractDeploymentData fields
+   * @returns A ContractDeploymentData instance
+   */ static fromPlainObject(obj) {
+        if (obj instanceof ContractDeploymentData) {
+            return obj;
+        }
+        return new ContractDeploymentData(obj.contractClassLogs.map((log)=>ContractClassLog.fromPlainObject(log)), obj.privateLogs.map((log)=>PrivateLog.fromPlainObject(log)));
+    }
+}
+/**
+ * Class containing both revertible and non-revertible registration/deployment data.
+ */ export class AllContractDeploymentData {
+    nonRevertibleContractDeploymentData;
+    revertibleContractDeploymentData;
+    constructor(nonRevertibleContractDeploymentData, revertibleContractDeploymentData){
+        this.nonRevertibleContractDeploymentData = nonRevertibleContractDeploymentData;
+        this.revertibleContractDeploymentData = revertibleContractDeploymentData;
+    }
+    getNonRevertibleContractDeploymentData() {
+        return this.nonRevertibleContractDeploymentData;
+    }
+    getRevertibleContractDeploymentData() {
+        return this.revertibleContractDeploymentData;
+    }
+    /**
+   * Extracts all contract registration/deployment data from a tx separated by revertibility.
+   * This includes contract class logs and private logs.
+   *
+   * This method handles both private-only transactions and transactions with public calls,
+   * properly splitting logs between revertible and non-revertible categories.
+   * @param tx - The transaction to extract data from
+   * @returns The extracted deployment data separated by revertibility
+   */ static fromTx(tx) {
+        const hasPublicCalls = !!tx.data.forPublic;
+        // Extract contract class logs from the tx
+        const allClassLogs = tx.getContractClassLogs();
+        let nonRevertibleClassLogs;
+        let revertibleClassLogs;
+        if (hasPublicCalls) {
+            // Transactions with public calls can have both revertible and non-revertible contract class logs
+            // Split the logs up here based on revertibility
+            nonRevertibleClassLogs = tx.getSplitContractClassLogs(/*revertible=*/ false);
+            revertibleClassLogs = tx.getSplitContractClassLogs(/*revertible=*/ true);
+        } else {
+            // Private-only tx: all logs are non-revertible
+            nonRevertibleClassLogs = allClassLogs;
+            revertibleClassLogs = [];
+        }
+        // Extract contract instance logs from the transaction's private logs
+        let nonRevertibleInstanceLogs;
+        let revertibleInstanceLogs;
+        if (hasPublicCalls) {
+            // Transactions with public calls can have both revertible and non-revertible contract instance logs
+            // Split the logs up here based on revertibility
+            nonRevertibleInstanceLogs = tx.data.forPublic.nonRevertibleAccumulatedData.privateLogs.filter((l)=>!l.isEmpty());
+            revertibleInstanceLogs = tx.data.forPublic.revertibleAccumulatedData.privateLogs.filter((l)=>!l.isEmpty());
+        } else {
+            // Private-only tx: use logs from the `forRollup` member of the tx
+            // For private-only txs, all logs are non-revertible
+            nonRevertibleInstanceLogs = tx.data.forRollup.end.privateLogs.filter((l)=>!l.isEmpty());
+            revertibleInstanceLogs = [];
+        }
+        return new AllContractDeploymentData(new ContractDeploymentData(nonRevertibleClassLogs, nonRevertibleInstanceLogs), new ContractDeploymentData(revertibleClassLogs, revertibleInstanceLogs));
+    }
+}

package/dest/contract/contract_function_dao.d.ts

@@ -0,0 +1,13 @@
+import type { FunctionArtifact, FunctionSelector } from '../abi/index.js';
+/**
+ * A contract function Data Access Object (DAO).
+ * Extends the FunctionArtifact interface, adding a 'selector' property.
+ * The 'selector' is a unique identifier for the function within the contract.
+ */
+export interface ContractFunctionDao extends FunctionArtifact {
+    /**
+     * Unique identifier for a contract function.
+     */
+    selector: FunctionSelector;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udHJhY3RfZnVuY3Rpb25fZGFvLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29udHJhY3QvY29udHJhY3RfZnVuY3Rpb25fZGFvLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLGdCQUFnQixFQUFFLGdCQUFnQixFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFFMUU7Ozs7R0FJRztBQUNILE1BQU0sV0FBVyxtQkFBb0IsU0FBUSxnQkFBZ0I7SUFDM0Q7O09BRUc7SUFDSCxRQUFRLEVBQUUsZ0JBQWdCLENBQUM7Q0FDNUIifQ==

package/dest/contract/contract_function_dao.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract_function_dao.d.ts","sourceRoot":"","sources":["../../src/contract/contract_function_dao.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE1E;;;;GAIG;AACH,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D;;OAEG;IACH,QAAQ,EAAE,gBAAgB,CAAC;CAC5B"}

package/dest/contract/contract_function_dao.js

@@ -0,0 +1,5 @@
+/**
+ * A contract function Data Access Object (DAO).
+ * Extends the FunctionArtifact interface, adding a 'selector' property.
+ * The 'selector' is a unique identifier for the function within the contract.
+ */ export { };

package/dest/contract/contract_instance.d.ts

@@ -0,0 +1,55 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { BufferReader } from '@aztec-labs/foundation/serialize';
+import type { FieldsOf } from '@aztec-labs/foundation/types';
+import { type ContractArtifact, type FunctionAbi } from '../abi/index.js';
+import { AztecAddress } from '../aztec-address/index.js';
+import { PublicKeys } from '../keys/public_keys.js';
+import type { ContractInstance, ContractInstancePreimage, ContractInstancePreimageWithAddress, ContractInstanceWithAddress } from './interfaces/contract_instance.js';
+export type ContractInstantiationData = {
+    constructorArtifact?: FunctionAbi | string;
+    constructorArgs?: any[];
+    skipArgsDecoding?: boolean;
+    salt: Fr;
+    publicKeys?: PublicKeys;
+    deployer?: AztecAddress;
+    immutablesHash?: Fr;
+};
+export declare class SerializableContractInstance {
+    readonly version: 2;
+    readonly salt: Fr;
+    readonly deployer: AztecAddress;
+    readonly currentContractClassId: Fr;
+    readonly originalContractClassId: Fr;
+    readonly initializationHash: Fr;
+    readonly immutablesHash: Fr;
+    readonly publicKeys: PublicKeys;
+    constructor(instance: ContractInstance);
+    toBuffer(): Buffer<ArrayBufferLike>;
+    /** Returns a copy of this object with its address included. */
+    withAddress(address: AztecAddress): ContractInstanceWithAddress;
+    static fromBuffer(bufferOrReader: Buffer | BufferReader): SerializableContractInstance;
+    static random(opts?: Partial<FieldsOf<ContractInstance>>): Promise<SerializableContractInstance>;
+    static default(): SerializableContractInstance;
+}
+export declare class SerializableContractInstancePreimage {
+    readonly version: 2;
+    readonly salt: Fr;
+    readonly deployer: AztecAddress;
+    readonly originalContractClassId: Fr;
+    readonly initializationHash: Fr;
+    readonly immutablesHash: Fr;
+    readonly publicKeys: PublicKeys;
+    constructor(instance: ContractInstancePreimage);
+    toBuffer(): Buffer<ArrayBufferLike>;
+    /** Returns a copy of this object with its address included. */
+    withAddress(address: AztecAddress): ContractInstancePreimageWithAddress;
+    static fromBuffer(bufferOrReader: Buffer | BufferReader): SerializableContractInstancePreimage;
+}
+/**
+ * Generates a Contract Instance from some instantiation params.
+ * @param artifact - The account contract build artifact.
+ * @param opts - Options for the contract's instantiation.
+ * @returns - The contract instance
+ */
+export declare function getContractInstanceFromInstantiationParams(artifact: ContractArtifact, opts: ContractInstantiationData): Promise<ContractInstanceWithAddress>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udHJhY3RfaW5zdGFuY2UuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jb250cmFjdC9jb250cmFjdF9pbnN0YW5jZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0scUNBQXFDLENBQUM7QUFDekQsT0FBTyxFQUFFLFlBQVksRUFBaUMsTUFBTSxrQ0FBa0MsQ0FBQztBQUMvRixPQUFPLEtBQUssRUFBRSxRQUFRLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUU3RCxPQUFPLEVBQ0wsS0FBSyxnQkFBZ0IsRUFDckIsS0FBSyxXQUFXLEVBS2pCLE1BQU0saUJBQWlCLENBQUM7QUFDekIsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBRXpELE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQU1wRCxPQUFPLEtBQUssRUFDVixnQkFBZ0IsRUFDaEIsd0JBQXdCLEVBQ3hCLG1DQUFtQyxFQUNuQywyQkFBMkIsRUFDNUIsTUFBTSxtQ0FBbUMsQ0FBQztBQUkzQyxNQUFNLE1BQU0seUJBQXlCLEdBQUc7SUFDdEMsbUJBQW1CLENBQUMsRUFBRSxXQUFXLEdBQUcsTUFBTSxDQUFDO0lBQzNDLGVBQWUsQ0FBQyxFQUFFLEdBQUcsRUFBRSxDQUFDO0lBQ3hCLGdCQUFnQixDQUFDLEVBQUUsT0FBTyxDQUFDO0lBQzNCLElBQUksRUFBRSxFQUFFLENBQUM7SUFDVCxVQUFVLENBQUMsRUFBRSxVQUFVLENBQUM7SUFDeEIsUUFBUSxDQUFDLEVBQUUsWUFBWSxDQUFDO0lBQ3hCLGNBQWMsQ0FBQyxFQUFFLEVBQUUsQ0FBQztDQUNyQixDQUFDO0FBRUYscUJBQWEsNEJBQTRCO0lBQ3ZDLFNBQWdCLE9BQU8sSUFBVztJQUNsQyxTQUFnQixJQUFJLEVBQUUsRUFBRSxDQUFDO0lBQ3pCLFNBQWdCLFFBQVEsRUFBRSxZQUFZLENBQUM7SUFDdkMsU0FBZ0Isc0JBQXNCLEVBQUUsRUFBRSxDQUFDO0lBQzNDLFNBQWdCLHVCQUF1QixFQUFFLEVBQUUsQ0FBQztJQUM1QyxTQUFnQixrQkFBa0IsRUFBRSxFQUFFLENBQUM7SUFDdkMsU0FBZ0IsY0FBYyxFQUFFLEVBQUUsQ0FBQztJQUNuQyxTQUFnQixVQUFVLEVBQUUsVUFBVSxDQUFDO0lBRXZDLFlBQVksUUFBUSxFQUFFLGdCQUFnQixFQVdyQztJQUVNLFFBQVEsNEJBV2Q7SUFFRCwrREFBK0Q7SUFDL0QsV0FBVyxDQUFDLE9BQU8sRUFBRSxZQUFZLEdBQUcsMkJBQTJCLENBRTlEO0lBRUQsTUFBTSxDQUFDLFVBQVUsQ0FBQyxjQUFjLEVBQUUsTUFBTSxHQUFHLFlBQVksZ0NBWXREO0lBRUQsT0FBYSxNQUFNLENBQUMsSUFBSSxHQUFFLE9BQU8sQ0FBQyxRQUFRLENBQUMsZ0JBQWdCLENBQUMsQ0FBTSx5Q0FZakU7SUFFRCxNQUFNLENBQUMsT0FBTyxpQ0FXYjtDQUNGO0FBRUQscUJBQWEsb0NBQW9DO0lBQy9DLFNBQWdCLE9BQU8sSUFBVztJQUNsQyxTQUFnQixJQUFJLEVBQUUsRUFBRSxDQUFDO0lBQ3pCLFNBQWdCLFFBQVEsRUFBRSxZQUFZLENBQUM7SUFDdkMsU0FBZ0IsdUJBQXVCLEVBQUUsRUFBRSxDQUFDO0lBQzVDLFNBQWdCLGtCQUFrQixFQUFFLEVBQUUsQ0FBQztJQUN2QyxTQUFnQixjQUFjLEVBQUUsRUFBRSxDQUFDO0lBQ25DLFNBQWdCLFVBQVUsRUFBRSxVQUFVLENBQUM7SUFFdkMsWUFBWSxRQUFRLEVBQUUsd0JBQXdCLEVBVTdDO0lBRU0sUUFBUSw0QkFVZDtJQUVELCtEQUErRDtJQUMvRCxXQUFXLENBQUMsT0FBTyxFQUFFLFlBQVksR0FBRyxtQ0FBbUMsQ0FFdEU7SUFFRCxNQUFNLENBQUMsVUFBVSxDQUFDLGNBQWMsRUFBRSxNQUFNLEdBQUcsWUFBWSxHQUFHLG9DQUFvQyxDQWU3RjtDQUNGO0FBRUQ7Ozs7O0dBS0c7QUFDSCx3QkFBc0IsMENBQTBDLENBQzlELFFBQVEsRUFBRSxnQkFBZ0IsRUFDMUIsSUFBSSxFQUFFLHlCQUF5QixHQUM5QixPQUFPLENBQUMsMkJBQTJCLENBQUMsQ0EyQnRDIn0=

package/dest/contract/contract_instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract_instance.d.ts","sourceRoot":"","sources":["../../src/contract/contract_instance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AACzD,OAAO,EAAE,YAAY,EAAiC,MAAM,kCAAkC,CAAC;AAC/F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAKjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAMpD,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACxB,mCAAmC,EACnC,2BAA2B,EAC5B,MAAM,mCAAmC,CAAC;AAI3C,MAAM,MAAM,yBAAyB,GAAG;IACtC,mBAAmB,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3C,eAAe,CAAC,EAAE,GAAG,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,IAAI,EAAE,EAAE,CAAC;IACT,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,cAAc,CAAC,EAAE,EAAE,CAAC;CACrB,CAAC;AAEF,qBAAa,4BAA4B;IACvC,SAAgB,OAAO,IAAW;IAClC,SAAgB,IAAI,EAAE,EAAE,CAAC;IACzB,SAAgB,QAAQ,EAAE,YAAY,CAAC;IACvC,SAAgB,sBAAsB,EAAE,EAAE,CAAC;IAC3C,SAAgB,uBAAuB,EAAE,EAAE,CAAC;IAC5C,SAAgB,kBAAkB,EAAE,EAAE,CAAC;IACvC,SAAgB,cAAc,EAAE,EAAE,CAAC;IACnC,SAAgB,UAAU,EAAE,UAAU,CAAC;IAEvC,YAAY,QAAQ,EAAE,gBAAgB,EAWrC;IAEM,QAAQ,4BAWd;IAED,+DAA+D;IAC/D,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,2BAA2B,CAE9D;IAED,MAAM,CAAC,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,gCAYtD;IAED,OAAa,MAAM,CAAC,IAAI,GAAE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAM,yCAYjE;IAED,MAAM,CAAC,OAAO,iCAWb;CACF;AAED,qBAAa,oCAAoC;IAC/C,SAAgB,OAAO,IAAW;IAClC,SAAgB,IAAI,EAAE,EAAE,CAAC;IACzB,SAAgB,QAAQ,EAAE,YAAY,CAAC;IACvC,SAAgB,uBAAuB,EAAE,EAAE,CAAC;IAC5C,SAAgB,kBAAkB,EAAE,EAAE,CAAC;IACvC,SAAgB,cAAc,EAAE,EAAE,CAAC;IACnC,SAAgB,UAAU,EAAE,UAAU,CAAC;IAEvC,YAAY,QAAQ,EAAE,wBAAwB,EAU7C;IAEM,QAAQ,4BAUd;IAED,+DAA+D;IAC/D,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,mCAAmC,CAEtE;IAED,MAAM,CAAC,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,GAAG,oCAAoC,CAe7F;CACF;AAED;;;;;GAKG;AACH,wBAAsB,0CAA0C,CAC9D,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,2BAA2B,CAAC,CA2BtC"}

package/dest/contract/contract_instance.js

@@ -0,0 +1,161 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { BufferReader, numToUInt8, serializeToBuffer } from '@aztec-labs/foundation/serialize';
+import { FunctionSelector, getAllFunctionAbis, getDefaultInitializer } from '../abi/index.js';
+import { AztecAddress } from '../aztec-address/index.js';
+import { getContractClassFromArtifact } from '../contract/contract_class.js';
+import { PublicKeys } from '../keys/public_keys.js';
+import { computeContractAddressFromInstance, computeInitializationHash, computeInitializationHashFromEncodedArgs } from './contract_address.js';
+const VERSION = 2;
+export class SerializableContractInstance {
+    version = VERSION;
+    salt;
+    deployer;
+    currentContractClassId;
+    originalContractClassId;
+    initializationHash;
+    immutablesHash;
+    publicKeys;
+    constructor(instance){
+        if (instance.version !== VERSION) {
+            throw new Error(`Unexpected contract class version ${instance.version}`);
+        }
+        this.salt = instance.salt;
+        this.deployer = instance.deployer;
+        this.currentContractClassId = instance.currentContractClassId;
+        this.originalContractClassId = instance.originalContractClassId;
+        this.initializationHash = instance.initializationHash;
+        this.immutablesHash = instance.immutablesHash;
+        this.publicKeys = instance.publicKeys;
+    }
+    toBuffer() {
+        return serializeToBuffer(numToUInt8(this.version), this.salt, this.deployer, this.currentContractClassId, this.originalContractClassId, this.initializationHash, this.immutablesHash, this.publicKeys);
+    }
+    /** Returns a copy of this object with its address included. */ withAddress(address) {
+        return {
+            ...this,
+            address
+        };
+    }
+    static fromBuffer(bufferOrReader) {
+        const reader = BufferReader.asReader(bufferOrReader);
+        return new SerializableContractInstance({
+            version: reader.readUInt8(),
+            salt: reader.readObject(Fr),
+            deployer: reader.readObject(AztecAddress),
+            currentContractClassId: reader.readObject(Fr),
+            originalContractClassId: reader.readObject(Fr),
+            initializationHash: reader.readObject(Fr),
+            immutablesHash: reader.readObject(Fr),
+            publicKeys: reader.readObject(PublicKeys)
+        });
+    }
+    static async random(opts = {}) {
+        return new SerializableContractInstance({
+            version: VERSION,
+            salt: Fr.random(),
+            deployer: await AztecAddress.random(),
+            currentContractClassId: Fr.random(),
+            originalContractClassId: Fr.random(),
+            initializationHash: Fr.random(),
+            immutablesHash: Fr.random(),
+            publicKeys: await PublicKeys.random(),
+            ...opts
+        });
+    }
+    static default() {
+        return new SerializableContractInstance({
+            version: VERSION,
+            salt: Fr.zero(),
+            deployer: AztecAddress.zero(),
+            currentContractClassId: Fr.zero(),
+            originalContractClassId: Fr.zero(),
+            initializationHash: Fr.zero(),
+            immutablesHash: Fr.zero(),
+            publicKeys: PublicKeys.default()
+        });
+    }
+}
+export class SerializableContractInstancePreimage {
+    version = VERSION;
+    salt;
+    deployer;
+    originalContractClassId;
+    initializationHash;
+    immutablesHash;
+    publicKeys;
+    constructor(instance){
+        if (instance.version !== VERSION) {
+            throw new Error(`Unexpected contract class version ${instance.version}`);
+        }
+        this.salt = instance.salt;
+        this.deployer = instance.deployer;
+        this.originalContractClassId = instance.originalContractClassId;
+        this.initializationHash = instance.initializationHash;
+        this.immutablesHash = instance.immutablesHash;
+        this.publicKeys = instance.publicKeys;
+    }
+    toBuffer() {
+        return serializeToBuffer(numToUInt8(this.version), this.salt, this.deployer, this.originalContractClassId, this.initializationHash, this.immutablesHash, this.publicKeys);
+    }
+    /** Returns a copy of this object with its address included. */ withAddress(address) {
+        return {
+            ...this,
+            address
+        };
+    }
+    static fromBuffer(bufferOrReader) {
+        const reader = BufferReader.asReader(bufferOrReader);
+        const version = reader.readUInt8();
+        if (version !== VERSION) {
+            throw new Error(`Unexpected contract instance preimage version ${version}`);
+        }
+        return new SerializableContractInstancePreimage({
+            version: VERSION,
+            salt: reader.readObject(Fr),
+            deployer: reader.readObject(AztecAddress),
+            originalContractClassId: reader.readObject(Fr),
+            initializationHash: reader.readObject(Fr),
+            immutablesHash: reader.readObject(Fr),
+            publicKeys: reader.readObject(PublicKeys)
+        });
+    }
+}
+/**
+ * Generates a Contract Instance from some instantiation params.
+ * @param artifact - The account contract build artifact.
+ * @param opts - Options for the contract's instantiation.
+ * @returns - The contract instance
+ */ export async function getContractInstanceFromInstantiationParams(artifact, opts) {
+    const args = opts.constructorArgs ?? [];
+    const constructorArtifact = getConstructorArtifact(artifact, opts.constructorArtifact);
+    const deployer = opts.deployer ?? AztecAddress.ZERO;
+    const contractClass = await getContractClassFromArtifact(artifact);
+    const initializationHash = constructorArtifact && opts?.skipArgsDecoding ? await computeInitializationHashFromEncodedArgs(await FunctionSelector.fromNameAndParameters(constructorArtifact?.name, constructorArtifact?.parameters), args) : await computeInitializationHash(constructorArtifact, args);
+    const publicKeys = opts.publicKeys ?? PublicKeys.default();
+    const immutablesHash = opts.immutablesHash ?? Fr.ZERO;
+    const instance = {
+        currentContractClassId: contractClass.id,
+        originalContractClassId: contractClass.id,
+        initializationHash,
+        immutablesHash,
+        publicKeys,
+        salt: opts.salt,
+        deployer,
+        version: 2
+    };
+    return {
+        ...instance,
+        address: await computeContractAddressFromInstance(instance)
+    };
+}
+function getConstructorArtifact(artifact, requestedConstructorArtifact) {
+    if (typeof requestedConstructorArtifact === 'string') {
+        const found = getAllFunctionAbis(artifact).find((fn)=>fn.name === requestedConstructorArtifact);
+        if (!found) {
+            throw new Error(`No constructor found with name ${requestedConstructorArtifact}`);
+        }
+        return found;
+    }
+    // TODO: shouldn't we check that requestedConstructorArtifact exists on artifact before returning?
+    return requestedConstructorArtifact ?? getDefaultInitializer(artifact);
+}

package/dest/contract/contract_instance_update.d.ts

@@ -0,0 +1,16 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { BufferReader } from '@aztec-labs/foundation/serialize';
+import type { FieldsOf } from '@aztec-labs/foundation/types';
+import type { UInt64 } from '../types/shared.js';
+import type { ContractInstanceUpdate } from './interfaces/contract_instance_update.js';
+export declare class SerializableContractInstanceUpdate {
+    prevContractClassId: Fr;
+    newContractClassId: Fr;
+    timestampOfChange: UInt64;
+    constructor(instance: ContractInstanceUpdate);
+    toBuffer(): Buffer<ArrayBufferLike>;
+    static fromBuffer(bufferOrReader: Buffer | BufferReader): SerializableContractInstanceUpdate;
+    static random(opts?: Partial<FieldsOf<ContractInstanceUpdate>>): SerializableContractInstanceUpdate;
+    static default(): SerializableContractInstanceUpdate;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udHJhY3RfaW5zdGFuY2VfdXBkYXRlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29udHJhY3QvY29udHJhY3RfaW5zdGFuY2VfdXBkYXRlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxxQ0FBcUMsQ0FBQztBQUN6RCxPQUFPLEVBQUUsWUFBWSxFQUFxQixNQUFNLGtDQUFrQyxDQUFDO0FBQ25GLE9BQU8sS0FBSyxFQUFFLFFBQVEsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBRTdELE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBQ2pELE9BQU8sS0FBSyxFQUFFLHNCQUFzQixFQUFFLE1BQU0sMENBQTBDLENBQUM7QUFFdkYscUJBQWEsa0NBQWtDO0lBQzdDLG1CQUFtQixFQUFFLEVBQUUsQ0FBQztJQUN4QixrQkFBa0IsRUFBRSxFQUFFLENBQUM7SUFDdkIsaUJBQWlCLEVBQUUsTUFBTSxDQUFDO0lBRTFCLFlBQVksUUFBUSxFQUFFLHNCQUFzQixFQUkzQztJQUVNLFFBQVEsNEJBRWQ7SUFFRCxNQUFNLENBQUMsVUFBVSxDQUFDLGNBQWMsRUFBRSxNQUFNLEdBQUcsWUFBWSxzQ0FPdEQ7SUFFRCxNQUFNLENBQUMsTUFBTSxDQUFDLElBQUksR0FBRSxPQUFPLENBQUMsUUFBUSxDQUFDLHNCQUFzQixDQUFDLENBQU0sc0NBT2pFO0lBRUQsTUFBTSxDQUFDLE9BQU8sdUNBTWI7Q0FDRiJ9

package/dest/contract/contract_instance_update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract_instance_update.d.ts","sourceRoot":"","sources":["../../src/contract/contract_instance_update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AACzD,OAAO,EAAE,YAAY,EAAqB,MAAM,kCAAkC,CAAC;AACnF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAEvF,qBAAa,kCAAkC;IAC7C,mBAAmB,EAAE,EAAE,CAAC;IACxB,kBAAkB,EAAE,EAAE,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAE1B,YAAY,QAAQ,EAAE,sBAAsB,EAI3C;IAEM,QAAQ,4BAEd;IAED,MAAM,CAAC,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,sCAOtD;IAED,MAAM,CAAC,MAAM,CAAC,IAAI,GAAE,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAM,sCAOjE;IAED,MAAM,CAAC,OAAO,uCAMb;CACF"}

package/dest/contract/contract_instance_update.js

@@ -0,0 +1,38 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { BufferReader, serializeToBuffer } from '@aztec-labs/foundation/serialize';
+export class SerializableContractInstanceUpdate {
+    prevContractClassId;
+    newContractClassId;
+    timestampOfChange;
+    constructor(instance){
+        this.prevContractClassId = instance.prevContractClassId;
+        this.newContractClassId = instance.newContractClassId;
+        this.timestampOfChange = instance.timestampOfChange;
+    }
+    toBuffer() {
+        return serializeToBuffer(this.prevContractClassId, this.newContractClassId, this.timestampOfChange);
+    }
+    static fromBuffer(bufferOrReader) {
+        const reader = BufferReader.asReader(bufferOrReader);
+        return new SerializableContractInstanceUpdate({
+            prevContractClassId: reader.readObject(Fr),
+            newContractClassId: reader.readObject(Fr),
+            timestampOfChange: reader.readObject(Fr).toBigInt()
+        });
+    }
+    static random(opts = {}) {
+        return new SerializableContractInstanceUpdate({
+            prevContractClassId: Fr.random(),
+            newContractClassId: Fr.random(),
+            timestampOfChange: BigInt(Math.floor(Math.random() * 1000)),
+            ...opts
+        });
+    }
+    static default() {
+        return new SerializableContractInstanceUpdate({
+            prevContractClassId: Fr.zero(),
+            newContractClassId: Fr.zero(),
+            timestampOfChange: 0n
+        });
+    }
+}

package/dest/contract/index.d.ts

@@ -0,0 +1,13 @@
+export * from './artifact_hash.js';
+export * from './contract_address.js';
+export * from './contract_class.js';
+export * from './contract_class_id.js';
+export * from './contract_deployment_data.js';
+export * from './contract_instance.js';
+export * from './contract_instance_update.js';
+export * from './private_function.js';
+export * from './interfaces/index.js';
+export * from './contract_function_dao.js';
+export * from './partial_address.js';
+export * from './complete_address.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jb250cmFjdC9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLG9CQUFvQixDQUFDO0FBQ25DLGNBQWMsdUJBQXVCLENBQUM7QUFDdEMsY0FBYyxxQkFBcUIsQ0FBQztBQUNwQyxjQUFjLHdCQUF3QixDQUFDO0FBQ3ZDLGNBQWMsK0JBQStCLENBQUM7QUFDOUMsY0FBYyx3QkFBd0IsQ0FBQztBQUN2QyxjQUFjLCtCQUErQixDQUFDO0FBQzlDLGNBQWMsdUJBQXVCLENBQUM7QUFDdEMsY0FBYyx1QkFBdUIsQ0FBQztBQUN0QyxjQUFjLDRCQUE0QixDQUFDO0FBQzNDLGNBQWMsc0JBQXNCLENBQUM7QUFDckMsY0FBYyx1QkFBdUIsQ0FBQyJ9

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dest/contract/index.js

@@ -0,0 +1,12 @@
+export * from './artifact_hash.js';
+export * from './contract_address.js';
+export * from './contract_class.js';
+export * from './contract_class_id.js';
+export * from './contract_deployment_data.js';
+export * from './contract_instance.js';
+export * from './contract_instance_update.js';
+export * from './private_function.js';
+export * from './interfaces/index.js';
+export * from './contract_function_dao.js';
+export * from './partial_address.js';
+export * from './complete_address.js';

package/dest/contract/interfaces/contract_class.d.ts

@@ -0,0 +1,84 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { z } from 'zod';
+import { FunctionSelector } from '../../abi/index.js';
+declare const VERSION: 1;
+/**
+ * A Contract Class in the protocol. Aztec differentiates contracts classes and instances, where a
+ * contract class represents the code of the contract, but holds no state. Classes are identified by
+ * an id that is a commitment to all its data.
+ */
+export interface ContractClass {
+    /** Version of the contract class. */
+    version: typeof VERSION;
+    /**
+     * Hash of the contract artifact. The specification of this hash is not enforced by the protocol. Should include
+     * commitments to code of utility functions and compilation metadata. Intended to be used by clients to verify that
+     * an offchain fetched artifact matches a registered class.
+     */
+    artifactHash: Fr;
+    /** List of individual private functions, constructors included. */
+    privateFunctions: PrivateFunction[];
+    /** Bytecode for the public_dispatch function, or empty. */
+    packedBytecode: Buffer;
+}
+/** Private function definition within a contract class. */
+export interface PrivateFunction {
+    /** Selector of the function. Calculated as the hash of the method name and parameters. The specification of this is not enforced by the protocol. */
+    selector: FunctionSelector;
+    /** Hash of the verification key associated to this private function. */
+    vkHash: Fr;
+}
+export declare const ContractClassSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    artifactHash: z.ZodType<Fr, string, z.core.$ZodTypeInternals<Fr, string>>;
+    privateFunctions: z.ZodArray<z.ZodObject<{
+        selector: import("@aztec-labs/foundation/schemas").ZodFor<FunctionSelector>;
+        vkHash: z.ZodType<Fr, string, z.core.$ZodTypeInternals<Fr, string>>;
+    }, z.core.$strip>>;
+    packedBytecode: import("@aztec-labs/foundation/schemas").ZodFor<Buffer<ArrayBufferLike>>;
+}, z.core.$strip>;
+/** Commitments to fields of a contract class. */
+interface ContractClassCommitments {
+    /** Identifier of the contract class. */
+    id: Fr;
+    /** Commitment to the public bytecode. */
+    publicBytecodeCommitment: Fr;
+    /** Root of the private functions tree  */
+    privateFunctionsRoot: Fr;
+}
+/** A contract class with its precomputed id. */
+export type ContractClassWithId = ContractClass & Pick<ContractClassCommitments, 'id'>;
+export declare const ContractClassWithIdSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    artifactHash: z.ZodType<Fr, string, z.core.$ZodTypeInternals<Fr, string>>;
+    privateFunctions: z.ZodArray<z.ZodObject<{
+        selector: import("@aztec-labs/foundation/schemas").ZodFor<FunctionSelector>;
+        vkHash: z.ZodType<Fr, string, z.core.$ZodTypeInternals<Fr, string>>;
+    }, z.core.$strip>>;
+    packedBytecode: import("@aztec-labs/foundation/schemas").ZodFor<Buffer<ArrayBufferLike>>;
+    id: z.ZodType<Fr, string, z.core.$ZodTypeInternals<Fr, string>>;
+}, z.core.$strip>;
+/** A contract class with public bytecode information. */
+export type ContractClassPublic = Pick<ContractClassCommitments, 'id' | 'privateFunctionsRoot'> & Omit<ContractClass, 'privateFunctions'>;
+export type ContractClassPublicWithCommitment = ContractClassPublic & Pick<ContractClassCommitments, 'publicBytecodeCommitment'>;
+export declare const ContractClassPublicSchema: z.ZodIntersection<z.ZodObject<{
+    id: z.ZodType<Fr, string, z.core.$ZodTypeInternals<Fr, string>>;
+    privateFunctionsRoot: z.ZodType<Fr, string, z.core.$ZodTypeInternals<Fr, string>>;
+}, z.core.$strip>, z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    artifactHash: z.ZodType<Fr, string, z.core.$ZodTypeInternals<Fr, string>>;
+    packedBytecode: import("@aztec-labs/foundation/schemas").ZodFor<Buffer<ArrayBufferLike>>;
+}, z.core.$strip>>;
+/** The contract class with the block it was initially deployed at */
+export type ContractClassPublicWithBlockNumber = {
+    l2BlockNumber: number;
+} & ContractClassPublic;
+/**
+ * Creates a ContractClassPublic from a plain object without Zod validation.
+ * Suitable for deserializing trusted data (e.g., from C++ via MessagePack).
+ * Note: privateFunctions and utilityFunctions are set to empty arrays since
+ * C++ does not provide them.
+ */
+export declare function contractClassPublicFromPlainObject(obj: any): ContractClassPublic;
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udHJhY3RfY2xhc3MuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9jb250cmFjdC9pbnRlcmZhY2VzL2NvbnRyYWN0X2NsYXNzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxxQ0FBcUMsQ0FBQztBQUV6RCxPQUFPLEVBQUUsQ0FBQyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBRXhCLE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBRXRELFFBQUEsTUFBTSxPQUFPLEdBQWEsQ0FBQztBQUUzQjs7OztHQUlHO0FBQ0gsTUFBTSxXQUFXLGFBQWE7SUFDNUIscUNBQXFDO0lBQ3JDLE9BQU8sRUFBRSxPQUFPLE9BQU8sQ0FBQztJQUN4Qjs7OztPQUlHO0lBQ0gsWUFBWSxFQUFFLEVBQUUsQ0FBQztJQUNqQixtRUFBbUU7SUFDbkUsZ0JBQWdCLEVBQUUsZUFBZSxFQUFFLENBQUM7SUFDcEMsMkRBQTJEO0lBQzNELGNBQWMsRUFBRSxNQUFNLENBQUM7Q0FDeEI7QUFFRCwyREFBMkQ7QUFDM0QsTUFBTSxXQUFXLGVBQWU7SUFDOUIscUpBQXFKO0lBQ3JKLFFBQVEsRUFBRSxnQkFBZ0IsQ0FBQztJQUMzQix3RUFBd0U7SUFDeEUsTUFBTSxFQUFFLEVBQUUsQ0FBQztDQUNaO0FBU0QsZUFBTyxNQUFNLG1CQUFtQjs7Ozs7Ozs7aUJBTy9CLENBQUM7QUFFRixpREFBaUQ7QUFDakQsVUFBVSx3QkFBd0I7SUFDaEMsd0NBQXdDO0lBQ3hDLEVBQUUsRUFBRSxFQUFFLENBQUM7SUFDUCx5Q0FBeUM7SUFDekMsd0JBQXdCLEVBQUUsRUFBRSxDQUFDO0lBQzdCLDBDQUEwQztJQUMxQyxvQkFBb0IsRUFBRSxFQUFFLENBQUM7Q0FDMUI7QUFFRCxnREFBZ0Q7QUFDaEQsTUFBTSxNQUFNLG1CQUFtQixHQUFHLGFBQWEsR0FBRyxJQUFJLENBQUMsd0JBQXdCLEVBQUUsSUFBSSxDQUFDLENBQUM7QUFFdkYsZUFBTyxNQUFNLHlCQUF5Qjs7Ozs7Ozs7O2lCQUlyQyxDQUFDO0FBRUYseURBQXlEO0FBQ3pELE1BQU0sTUFBTSxtQkFBbUIsR0FBRyxJQUFJLENBQUMsd0JBQXdCLEVBQUUsSUFBSSxHQUFHLHNCQUFzQixDQUFDLEdBQzdGLElBQUksQ0FBQyxhQUFhLEVBQUUsa0JBQWtCLENBQUMsQ0FBQztBQUUxQyxNQUFNLE1BQU0saUNBQWlDLEdBQUcsbUJBQW1CLEdBQ2pFLElBQUksQ0FBQyx3QkFBd0IsRUFBRSwwQkFBMEIsQ0FBQyxDQUFDO0FBRTdELGVBQU8sTUFBTSx5QkFBeUI7Ozs7Ozs7a0JBT3JDLENBQUM7QUFFRixxRUFBcUU7QUFDckUsTUFBTSxNQUFNLGtDQUFrQyxHQUFHO0lBQUUsYUFBYSxFQUFFLE1BQU0sQ0FBQTtDQUFFLEdBQUcsbUJBQW1CLENBQUM7QUFFakc7Ozs7O0dBS0c7QUFDSCx3QkFBZ0Isa0NBQWtDLENBQUMsR0FBRyxFQUFFLEdBQUcsR0FBRyxtQkFBbUIsQ0FRaEYifQ==

package/dest/contract/interfaces/contract_class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract_class.d.ts","sourceRoot":"","sources":["../../../src/contract/interfaces/contract_class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AAEzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,QAAA,MAAM,OAAO,GAAa,CAAC;AAE3B;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB;;;;OAIG;IACH,YAAY,EAAE,EAAE,CAAC;IACjB,mEAAmE;IACnE,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,qJAAqJ;IACrJ,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,wEAAwE;IACxE,MAAM,EAAE,EAAE,CAAC;CACZ;AASD,eAAO,MAAM,mBAAmB;;;;;;;;iBAO/B,CAAC;AAEF,iDAAiD;AACjD,UAAU,wBAAwB;IAChC,wCAAwC;IACxC,EAAE,EAAE,EAAE,CAAC;IACP,yCAAyC;IACzC,wBAAwB,EAAE,EAAE,CAAC;IAC7B,0CAA0C;IAC1C,oBAAoB,EAAE,EAAE,CAAC;CAC1B;AAED,gDAAgD;AAChD,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,IAAI,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;AAEvF,eAAO,MAAM,yBAAyB;;;;;;;;;iBAIrC,CAAC;AAEF,yDAAyD;AACzD,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,wBAAwB,EAAE,IAAI,GAAG,sBAAsB,CAAC,GAC7F,IAAI,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;AAE1C,MAAM,MAAM,iCAAiC,GAAG,mBAAmB,GACjE,IAAI,CAAC,wBAAwB,EAAE,0BAA0B,CAAC,CAAC;AAE7D,eAAO,MAAM,yBAAyB;;;;;;;kBAOrC,CAAC;AAEF,qEAAqE;AACrE,MAAM,MAAM,kCAAkC,GAAG;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,mBAAmB,CAAC;AAEjG;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,GAAG,GAAG,mBAAmB,CAQhF"}

package/dest/contract/interfaces/contract_class.js

@@ -0,0 +1,38 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { schemas, zodFor } from '@aztec-labs/foundation/schemas';
+import { z } from 'zod';
+import { FunctionSelector } from '../../abi/index.js';
+const VERSION = 1;
+const PrivateFunctionSchema = zodFor()(z.object({
+    selector: FunctionSelector.schema,
+    vkHash: schemas.Fr
+}));
+export const ContractClassSchema = zodFor()(z.object({
+    version: z.literal(VERSION),
+    artifactHash: schemas.Fr,
+    privateFunctions: z.array(PrivateFunctionSchema),
+    packedBytecode: schemas.Buffer
+}));
+export const ContractClassWithIdSchema = zodFor()(ContractClassSchema.extend({
+    id: schemas.Fr
+}));
+export const ContractClassPublicSchema = zodFor()(z.object({
+    id: schemas.Fr,
+    privateFunctionsRoot: schemas.Fr
+}).and(ContractClassSchema.omit({
+    privateFunctions: true
+})));
+/**
+ * Creates a ContractClassPublic from a plain object without Zod validation.
+ * Suitable for deserializing trusted data (e.g., from C++ via MessagePack).
+ * Note: privateFunctions and utilityFunctions are set to empty arrays since
+ * C++ does not provide them.
+ */ export function contractClassPublicFromPlainObject(obj) {
+    return {
+        id: Fr.fromPlainObject(obj.id),
+        version: 1,
+        artifactHash: Fr.fromPlainObject(obj.artifactHash),
+        privateFunctionsRoot: Fr.fromPlainObject(obj.privateFunctionsRoot),
+        packedBytecode: obj.packedBytecode instanceof Buffer ? obj.packedBytecode : Buffer.from(obj.packedBytecode)
+    };
+}

package/dest/contract/interfaces/contract_data_source.d.ts

@@ -0,0 +1,35 @@
+import type { BlockNumber } from '@aztec-labs/foundation/branded-types';
+import type { Fr } from '@aztec-labs/foundation/curves/bn254';
+import type { FunctionSelector } from '../../abi/index.js';
+import type { AztecAddress } from '../../aztec-address/index.js';
+import type { UInt64 } from '../../types/shared.js';
+import type { ContractClassPublic } from './contract_class.js';
+import type { ContractInstanceWithAddress } from './contract_instance.js';
+export interface ContractDataSource {
+    /**
+     * Gets the number of the latest L2 block processed by the implementation.
+     * @returns The number of the latest L2 block processed by the implementation.
+     */
+    getBlockNumber(): Promise<BlockNumber>;
+    /**
+     * Returns the contract class for a given contract class id, or undefined if not found.
+     * @param id - Contract class id.
+     */
+    getContractClass(id: Fr): Promise<ContractClassPublic | undefined>;
+    getBytecodeCommitment(id: Fr): Promise<Fr | undefined>;
+    /**
+     * Returns a publicly deployed contract instance given its address.
+     * @param address - Address of the deployed contract.
+     * @param timestamp - Timestamp at which to resolve the contract instance's current class id.
+     */
+    getContract(address: AztecAddress, timestamp: UInt64): Promise<ContractInstanceWithAddress | undefined>;
+    /**
+     * Returns the list of all class ids known.
+     */
+    getContractClassIds(): Promise<Fr[]>;
+    /** Returns a function's name. It's only available if provided by calling `registerContractFunctionSignatures`. */
+    getDebugFunctionName(address: AztecAddress, selector: FunctionSelector): Promise<string | undefined>;
+    /** Registers a function names. Useful for debugging. */
+    registerContractFunctionSignatures(signatures: string[]): Promise<void>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udHJhY3RfZGF0YV9zb3VyY2UuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9jb250cmFjdC9pbnRlcmZhY2VzL2NvbnRyYWN0X2RhdGFfc291cmNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxNQUFNLHNDQUFzQyxDQUFDO0FBQ3hFLE9BQU8sS0FBSyxFQUFFLEVBQUUsRUFBRSxNQUFNLHFDQUFxQyxDQUFDO0FBRTlELE9BQU8sS0FBSyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFDM0QsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFDakUsT0FBTyxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFDcEQsT0FBTyxLQUFLLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUMvRCxPQUFPLEtBQUssRUFBRSwyQkFBMkIsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBRTFFLE1BQU0sV0FBVyxrQkFBa0I7SUFDakM7OztPQUdHO0lBQ0gsY0FBYyxJQUFJLE9BQU8sQ0FBQyxXQUFXLENBQUMsQ0FBQztJQUV2Qzs7O09BR0c7SUFDSCxnQkFBZ0IsQ0FBQyxFQUFFLEVBQUUsRUFBRSxHQUFHLE9BQU8sQ0FBQyxtQkFBbUIsR0FBRyxTQUFTLENBQUMsQ0FBQztJQUVuRSxxQkFBcUIsQ0FBQyxFQUFFLEVBQUUsRUFBRSxHQUFHLE9BQU8sQ0FBQyxFQUFFLEdBQUcsU0FBUyxDQUFDLENBQUM7SUFFdkQ7Ozs7T0FJRztJQUNILFdBQVcsQ0FBQyxPQUFPLEVBQUUsWUFBWSxFQUFFLFNBQVMsRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLDJCQUEyQixHQUFHLFNBQVMsQ0FBQyxDQUFDO0lBRXhHOztPQUVHO0lBQ0gsbUJBQW1CLElBQUksT0FBTyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUM7SUFFckMsa0hBQWtIO0lBQ2xILG9CQUFvQixDQUFDLE9BQU8sRUFBRSxZQUFZLEVBQUUsUUFBUSxFQUFFLGdCQUFnQixHQUFHLE9BQU8sQ0FBQyxNQUFNLEdBQUcsU0FBUyxDQUFDLENBQUM7SUFFckcsd0RBQXdEO0lBQ3hELGtDQUFrQyxDQUFDLFVBQVUsRUFBRSxNQUFNLEVBQUUsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUM7Q0FDekUifQ==

package/dest/contract/interfaces/contract_data_source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract_data_source.d.ts","sourceRoot":"","sources":["../../../src/contract/interfaces/contract_data_source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAE1E,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAEvC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC;IAEnE,qBAAqB,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC;IAEvD;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC,CAAC;IAExG;;OAEG;IACH,mBAAmB,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IAErC,kHAAkH;IAClH,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAErG,wDAAwD;IACxD,kCAAkC,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE"}

package/dest/contract/interfaces/contract_data_source.js

@@ -0,0 +1 @@
+export { };