@aztec/standard-contracts 0.0.1-commit.8655d4a → 0.0.1-commit.9a89641

package/src/handshake-registry/lazy.ts

@@ -0,0 +1,35 @@
+import { type ContractArtifact, loadContractArtifact } from '@aztec/stdlib/abi';
+
+import { makeStandardContract } from '../make_standard_contract.js';
+import type { StandardContract } from '../standard_contract.js';
+
+export {
+  STANDARD_HANDSHAKE_REGISTRY_ADDRESS,
+  STANDARD_HANDSHAKE_REGISTRY_CLASS_ID,
+  STANDARD_HANDSHAKE_REGISTRY_SALT,
+} from './constants.js';
+
+let standardContract: StandardContract;
+let standardContractArtifact: ContractArtifact;
+
+export async function getHandshakeRegistryArtifact(): Promise<ContractArtifact> {
+  if (!standardContractArtifact) {
+    // 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: handshakeRegistryJson } = await import('../../artifacts/HandshakeRegistry.json');
+    standardContractArtifact = loadContractArtifact(handshakeRegistryJson);
+  }
+  return standardContractArtifact;
+}
+
+/** Returns the standard deployment of the handshake registry. */
+export async function getStandardHandshakeRegistry(): Promise<StandardContract> {
+  if (!standardContract) {
+    const artifact = await getHandshakeRegistryArtifact();
+    standardContract = makeStandardContract('HandshakeRegistry', artifact);
+  }
+  return standardContract;
+}

package/src/index.ts

@@ -1,3 +1,5 @@
 export * from './auth-registry/index.js';
+export * from './handshake-registry/index.js';
 export * from './multi-call-entrypoint/index.js';
 export * from './public-checks/index.js';
+export * from './publishable_standard_contracts.js';

package/src/multi-call-entrypoint/constants.ts

@@ -1,8 +1,10 @@
 // Lightweight metadata leaf export for browser bundles: importing from
 // `@aztec/standard-contracts/multi-call-entrypoint/constants` avoids dragging in the
 // `MultiCallEntrypoint.json` static import.
+import type { AztecAddress } from '@aztec/stdlib/aztec-address';
+
 import { StandardContractAddress, StandardContractClassId, StandardContractSalt } from '../standard_contract_data.js';
 
-export const STANDARD_MULTI_CALL_ENTRYPOINT_ADDRESS = StandardContractAddress.MultiCallEntrypoint;
+export const STANDARD_MULTI_CALL_ENTRYPOINT_ADDRESS: AztecAddress = StandardContractAddress.MultiCallEntrypoint;
 export const STANDARD_MULTI_CALL_ENTRYPOINT_CLASS_ID = StandardContractClassId.MultiCallEntrypoint;
 export const STANDARD_MULTI_CALL_ENTRYPOINT_SALT = StandardContractSalt.MultiCallEntrypoint;

package/src/public-checks/constants.ts

@@ -1,8 +1,10 @@
 // Lightweight metadata leaf export for browser bundles: importing from
 // `@aztec/standard-contracts/public-checks/constants` avoids dragging in the
 // `PublicChecks.json` static import.
+import type { AztecAddress } from '@aztec/stdlib/aztec-address';
+
 import { StandardContractAddress, StandardContractClassId, StandardContractSalt } from '../standard_contract_data.js';
 
-export const STANDARD_PUBLIC_CHECKS_ADDRESS = StandardContractAddress.PublicChecks;
+export const STANDARD_PUBLIC_CHECKS_ADDRESS: AztecAddress = StandardContractAddress.PublicChecks;
 export const STANDARD_PUBLIC_CHECKS_CLASS_ID = StandardContractClassId.PublicChecks;
 export const STANDARD_PUBLIC_CHECKS_SALT = StandardContractSalt.PublicChecks;

package/src/publishable_standard_contracts.ts

@@ -0,0 +1,22 @@
+import { getStandardAuthRegistry } from './auth-registry/index.js';
+import { getStandardHandshakeRegistry } from './handshake-registry/index.js';
+import { getStandardPublicChecks } from './public-checks/index.js';
+import type { StandardContract } from './standard_contract.js';
+
+/**
+ * Returns the standard contracts that are published on-chain (class registration + instance
+ * publication) before their public functions can be called: AuthRegistry, PublicChecks, and
+ * HandshakeRegistry. These are exactly the contracts guarded by the `ensure*Published` e2e setup
+ * helpers.
+ *
+ * MultiCallEntrypoint is deliberately excluded: it is a client-side entrypoint used to encode
+ * batched private calls and is never published for public execution.
+ *
+ * This is the single source of truth for the set of standard contracts that test environments seed
+ * at genesis (registration/deployment nullifiers) and preload into the archiver contract store, so
+ * the two stay consistent — preloading a class whose nullifier is not seeded would recreate the
+ * publish-collision bug that genesis seeding avoids.
+ */
+export function getPublishableStandardContracts(): Promise<StandardContract[]> {
+  return Promise.all([getStandardAuthRegistry(), getStandardPublicChecks(), getStandardHandshakeRegistry()]);
+}

package/src/standard_contract_data.ts

@@ -3,7 +3,12 @@ import { Fr } from '@aztec/foundation/curves/bn254';
 import { FunctionSelector } from '@aztec/stdlib/abi';
 import { AztecAddress } from '@aztec/stdlib/aztec-address';
 
-export const standardContractNames = ['AuthRegistry', 'MultiCallEntrypoint', 'PublicChecks'] as const;
+export const standardContractNames = [
+  'AuthRegistry',
+  'MultiCallEntrypoint',
+  'PublicChecks',
+  'HandshakeRegistry',
+] as const;
 
 export type StandardContractName = (typeof standardContractNames)[number];
 
@@ -11,18 +16,25 @@ export const StandardContractSalt: Record<StandardContractName, Fr> = {
   AuthRegistry: new Fr(1),
   MultiCallEntrypoint: new Fr(1),
   PublicChecks: new Fr(1),
+  HandshakeRegistry: new Fr(1),
 };
 
 export const StandardContractAddress: Record<StandardContractName, AztecAddress> = {
-  AuthRegistry: AztecAddress.fromString('0x01de9d215d1845808cf388d3a88f9066af1e73ec280e979c3b1aec8ba6b149ea'),
-  MultiCallEntrypoint: AztecAddress.fromString('0x09a72c4cb473b087f59f28f913aa103c214b4f9bbf10d4157e06745169359210'),
-  PublicChecks: AztecAddress.fromString('0x05d900a6ed1b4ad3ff52cbe5f98d9b291b0f35c6dd5c41b1642659344d234bfe'),
+  AuthRegistry: AztecAddress.fromStringUnsafe('0x1fe01dde371ec27308a4e5d1f08d2e734b773352c1f47d9d5b0974c1729ac16e'),
+  MultiCallEntrypoint: AztecAddress.fromStringUnsafe(
+    '0x124b09dd9229a0e476e5d5affcbd917c16400d7673a6b589497650afc18456da',
+  ),
+  PublicChecks: AztecAddress.fromStringUnsafe('0x0de6d5fa41576a2289a289180c5ba3b1b75d19a630c779cfbef4480e27ac3e28'),
+  HandshakeRegistry: AztecAddress.fromStringUnsafe(
+    '0x1f81756ef59026857b437350d1123ea317cacf3a20b95c77586d618591b8bb93',
+  ),
 };
 
 export const StandardContractClassId: Record<StandardContractName, Fr> = {
-  AuthRegistry: Fr.fromString('0x2cfbdd0ce7cc31b5cc5f4eb8f680e0e245882b2208bd67828e41a8bd24a19292'),
-  MultiCallEntrypoint: Fr.fromString('0x188160c82cb3a9a24c6f156f270e962afa124cdd2dabce78aaa0bf04fdd799f6'),
-  PublicChecks: Fr.fromString('0x022bbd3c085d6a09ec500110852441419c7b1e6dc21a8d459233b72a84d03a1f'),
+  AuthRegistry: Fr.fromString('0x07429c3c22c191987452fe7c8daeb56b8a4ada6d94fed30e7fb6659da36c5099'),
+  MultiCallEntrypoint: Fr.fromString('0x28aa32d375f8c4acb57cf9ee899bd3b08a5a148cecf2064602fe818aafdf6e33'),
+  PublicChecks: Fr.fromString('0x0ac1bd3e46990fdcd9c4182ca9dab6d9b22dda5ee1a9fe581dde36a6ea639596'),
+  HandshakeRegistry: Fr.fromString('0x1544fd83a3880eca21d17789665e5281318ea4f9395aef53217463deb5b82619'),
 };
 
 export const StandardContractClassIdPreimage: Record<
@@ -30,26 +42,32 @@ export const StandardContractClassIdPreimage: Record<
   { artifactHash: Fr; privateFunctionsRoot: Fr; publicBytecodeCommitment: Fr }
 > = {
   AuthRegistry: {
-    artifactHash: Fr.fromString('0x0dd24a86cce5ff4ef33ca14f16359c5a154ce3f1ed91a9570dd5343569f5386f'),
-    privateFunctionsRoot: Fr.fromString('0x17b584350f4c3ccafd8f688729afb9feab8976114fb40012e9dee65022c072a4'),
-    publicBytecodeCommitment: Fr.fromString('0x2545f39893766508ce37bb5cea5e4dcab04c6f7f79f3089b1c076876e9d268b2'),
+    artifactHash: Fr.fromString('0x0d029bbbf1f83e4c8c088213c7b7d200d2e89d2085183f53151d59ba369e1fab'),
+    privateFunctionsRoot: Fr.fromString('0x211b33685bcb41a5d3a2a84d8ec021c7280392cb4aae5a778eafe5282dbba740'),
+    publicBytecodeCommitment: Fr.fromString('0x0c7984b020afc901da3b5898b8f94d1d9a09ea2b37d6e0043409abc0b0332906'),
   },
   MultiCallEntrypoint: {
-    artifactHash: Fr.fromString('0x1f8c5717b0e478e63f462f9792969865684f8403b4608980b1a83324c03dd498'),
-    privateFunctionsRoot: Fr.fromString('0x0e68dfbb256e80b08b3aef47aca1f2669e97a9c6259787893c1223ac083ad5d5'),
+    artifactHash: Fr.fromString('0x28f8874c4768c1072922ca41c49ba1f302aefb7f858ebb289dc17c993abc8528'),
+    privateFunctionsRoot: Fr.fromString('0x2cd2008a79f59c3f2caa996962b0b35889f5ee8fcf175282406a2a521550cc70'),
     publicBytecodeCommitment: Fr.fromString('0x0ce4c618c3ed7f3a20410e618c06bb701e150af7fe28a3e92f68e7733809f33e'),
   },
   PublicChecks: {
-    artifactHash: Fr.fromString('0x030776b58475bf6a0545eaa4f4002f5fe6701bd0d306b68065f4b40ef4fdbe60'),
+    artifactHash: Fr.fromString('0x1149d0cd4421cb20fccdcf2c73c79df4e773e30f6c4b8d24e8c1cd718d34d50b'),
     privateFunctionsRoot: Fr.fromString('0x202860adb1b8975971eeaf571aaaa88a27f4035290d58532ae7d60b0dfaad54c'),
     publicBytecodeCommitment: Fr.fromString('0x013c4f854a5c87c9daf86c5f9bc07a42c2a061f1d924a5b3564ec7edc8e18cb7'),
   },
+  HandshakeRegistry: {
+    artifactHash: Fr.fromString('0x1c02c2ba7d53ec4fd5450d6dc7f86ab1b17a6fcfa5a50850405e7529acc9638b'),
+    privateFunctionsRoot: Fr.fromString('0x10288478f6ce295fa9a831e0b712773f4c59287a6bc6ae57b5948519b94f7171'),
+    publicBytecodeCommitment: Fr.fromString('0x0ce4c618c3ed7f3a20410e618c06bb701e150af7fe28a3e92f68e7733809f33e'),
+  },
 };
 
 export const StandardContractInitializationHash: Record<StandardContractName, Fr> = {
   AuthRegistry: Fr.fromString('0x0000000000000000000000000000000000000000000000000000000000000000'),
   MultiCallEntrypoint: Fr.fromString('0x0000000000000000000000000000000000000000000000000000000000000000'),
   PublicChecks: Fr.fromString('0x0000000000000000000000000000000000000000000000000000000000000000'),
+  HandshakeRegistry: Fr.fromString('0x0000000000000000000000000000000000000000000000000000000000000000'),
 };
 
 export const StandardContractPrivateFunctions: Record<
@@ -61,7 +79,7 @@ export const StandardContractPrivateFunctions: Record<
       selector: FunctionSelector.fromField(
         Fr.fromString('0x0000000000000000000000000000000000000000000000000000000079a3d418'),
       ),
-      vkHash: Fr.fromString('0x06a5c1b3a636c954a90be43cb56a4bdd9dc8aec764151a012e0018753694ff54'),
+      vkHash: Fr.fromString('0x2979f430e7a6d4c2222a35a5e00f9c8c0e41c5ad9afa95d8d718f5c1f57ac4f2'),
     },
   ],
   MultiCallEntrypoint: [
@@ -69,8 +87,28 @@ export const StandardContractPrivateFunctions: Record<
       selector: FunctionSelector.fromField(
         Fr.fromString('0x00000000000000000000000000000000000000000000000000000000f04908a9'),
       ),
-      vkHash: Fr.fromString('0x0b19b2f937f2581922c2ead5411ad9ff4ed9710efe9849bde494d9a0f94812ec'),
+      vkHash: Fr.fromString('0x1bc6ab9244a92fe2143e42a1856ea0b29415e0530eda89dd634a0b8630780593'),
     },
   ],
   PublicChecks: [],
+  HandshakeRegistry: [
+    {
+      selector: FunctionSelector.fromField(
+        Fr.fromString('0x0000000000000000000000000000000000000000000000000000000019f8b409'),
+      ),
+      vkHash: Fr.fromString('0x136fb94bf8b1bfdb25f4d6c6ced06b8db140a268330308027b32ced3151faa81'),
+    },
+    {
+      selector: FunctionSelector.fromField(
+        Fr.fromString('0x00000000000000000000000000000000000000000000000000000000db548fcf'),
+      ),
+      vkHash: Fr.fromString('0x06bfb80a0e8d1c8f941c7f91c233e56febcb60300c4dcbf878df87120aa9a89f'),
+    },
+    {
+      selector: FunctionSelector.fromField(
+        Fr.fromString('0x00000000000000000000000000000000000000000000000000000000f1ff839b'),
+      ),
+      vkHash: Fr.fromString('0x05eef6388f1678ef7a24ed7829a15abf8fb76922ed73477114ff4828e2772535'),
+    },
+  ],
 };