@aztec/stdlib 0.77.0-testnet-ignition.17

package/dest/contract/contract_instance.js

@@ -0,0 +1,109 @@
+import { Fr } from '@aztec/foundation/fields';
+import { BufferReader, numToUInt8, serializeToBuffer } from '@aztec/foundation/serialize';
+import { FunctionSelector, 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 = 1;
+export class SerializableContractInstance {
+    version = VERSION;
+    salt;
+    deployer;
+    currentContractClassId;
+    originalContractClassId;
+    initializationHash;
+    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.publicKeys = instance.publicKeys;
+    }
+    toBuffer() {
+        return serializeToBuffer(numToUInt8(this.version), this.salt, this.deployer, this.currentContractClassId, this.originalContractClassId, this.initializationHash, 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),
+            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(),
+            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(),
+            publicKeys: PublicKeys.default()
+        });
+    }
+}
+/**
+ * Generates a Contract Instance from the deployment params.
+ * @param artifact - The account contract build artifact.
+ * @param opts - Options for the deployment.
+ * @returns - The contract instance
+ */ export async function getContractInstanceFromDeployParams(artifact, opts) {
+    const args = opts.constructorArgs ?? [];
+    const salt = opts.salt ?? Fr.random();
+    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 instance = {
+        currentContractClassId: contractClass.id,
+        originalContractClassId: contractClass.id,
+        initializationHash,
+        publicKeys,
+        salt,
+        deployer,
+        version: 1
+    };
+    return {
+        ...instance,
+        address: await computeContractAddressFromInstance(instance)
+    };
+}
+function getConstructorArtifact(artifact, requestedConstructorArtifact) {
+    if (typeof requestedConstructorArtifact === 'string') {
+        const found = artifact.functions.find((fn)=>fn.name === requestedConstructorArtifact);
+        if (!found) {
+            throw new Error(`No constructor found with name ${requestedConstructorArtifact}`);
+        }
+        return found;
+    }
+    return requestedConstructorArtifact ?? getDefaultInitializer(artifact);
+}

package/dest/contract/contract_instance_update.d.ts

@@ -0,0 +1,17 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+import { Fr } from '@aztec/foundation/fields';
+import { BufferReader } from '@aztec/foundation/serialize';
+import type { FieldsOf } from '@aztec/foundation/types';
+import type { ContractInstanceUpdate } from './interfaces/contract_instance_update.js';
+export declare class SerializableContractInstanceUpdate {
+    prevContractClassId: Fr;
+    newContractClassId: Fr;
+    blockOfChange: number;
+    constructor(instance: ContractInstanceUpdate);
+    toBuffer(): Buffer;
+    static fromBuffer(bufferOrReader: Buffer | BufferReader): SerializableContractInstanceUpdate;
+    static random(opts?: Partial<FieldsOf<ContractInstanceUpdate>>): SerializableContractInstanceUpdate;
+    static default(): SerializableContractInstanceUpdate;
+}
+//# sourceMappingURL=contract_instance_update.d.ts.map

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,0BAA0B,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAqB,MAAM,6BAA6B,CAAC;AAC9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAEvF,qBAAa,kCAAkC;IAC7C,mBAAmB,EAAE,EAAE,CAAC;IACxB,kBAAkB,EAAE,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;gBAEV,QAAQ,EAAE,sBAAsB;IAMrC,QAAQ;IAIf,MAAM,CAAC,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY;IASvD,MAAM,CAAC,MAAM,CAAC,IAAI,GAAE,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAM;IASlE,MAAM,CAAC,OAAO;CAOf"}

package/dest/contract/contract_instance_update.js

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

package/dest/contract/deployment_info.d.ts

@@ -0,0 +1,24 @@
+import type { Fr } from '@aztec/foundation/fields';
+import type { CompleteAddress } from './complete_address.js';
+/**
+ * Represents the data generated as part of contract deployment.
+ */
+export type DeploymentInfo = {
+    /**
+     * The complete address of the deployed contract.
+     */
+    completeAddress: CompleteAddress;
+    /**
+     * The contract's constructor verification key hash.
+     */
+    constructorVkHash: Fr;
+    /**
+     * The contract's constructor hash.
+     */
+    constructorHash: Fr;
+    /**
+     * The root of the contract's function tree.
+     */
+    functionTreeRoot: Fr;
+};
+//# sourceMappingURL=deployment_info.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deployment_info.d.ts","sourceRoot":"","sources":["../../src/contract/deployment_info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAEnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,eAAe,EAAE,eAAe,CAAC;IACjC;;OAEG;IACH,iBAAiB,EAAE,EAAE,CAAC;IACtB;;OAEG;IACH,eAAe,EAAE,EAAE,CAAC;IACpB;;OAEG;IACH,gBAAgB,EAAE,EAAE,CAAC;CACtB,CAAC"}

package/dest/contract/deployment_info.js

@@ -0,0 +1,3 @@
+/**
+ * Represents the data generated as part of contract deployment.
+ */ export { };

package/dest/contract/index.d.ts

@@ -0,0 +1,15 @@
+export * from './artifact_hash.js';
+export * from './contract_address.js';
+export * from './contract_class.js';
+export * from './contract_class_id.js';
+export * from './contract_instance.js';
+export * from './contract_instance_update.js';
+export * from './private_function.js';
+export * from './private_function_membership_proof.js';
+export * from './unconstrained_function_membership_proof.js';
+export * from './interfaces/index.js';
+export * from './contract_function_dao.js';
+export * from './partial_address.js';
+export * from './deployment_info.js';
+export * from './complete_address.js';
+//# sourceMappingURL=index.d.ts.map

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,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wCAAwC,CAAC;AACvD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dest/contract/index.js

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