@aztec/simulator 0.0.1-commit.4d3c002 → 0.0.1-commit.4d9804df

package/src/public/cdb/generated/api_types.ts

@@ -0,0 +1,457 @@
+// AUTOGENERATED FILE - DO NOT EDIT
+
+/** Schema version hash for compatibility checking */
+export const SCHEMA_HASH = 'ef6a34b441b65d90238d2b3616a763136f5f53f9239ecabe9163ebf9388c89bd';
+
+// Runtime guards for wire types that JS cannot represent natively.
+// TODO: migrate u64 fields to bigint end-to-end and drop these.
+//
+// Decode: msgpackr returns uint64/int64 wire values as bigint once they
+// exceed 32 bits; values must fit in the JS safe integer range.
+function assertU64(value: number | bigint, ctx: string): number {
+  if (typeof value === "bigint") {
+    if (value < 0n || value > BigInt(Number.MAX_SAFE_INTEGER)) {
+      throw new Error(`${ctx}: u64 value ${value} is outside JS safe integer range`);
+    }
+    return Number(value);
+  }
+  if (!Number.isSafeInteger(value) || value < 0) {
+    throw new Error(`${ctx}: u64 value ${value} is outside JS safe integer range`);
+  }
+  return value;
+}
+
+// Encode: msgpackr encodes JS numbers above 2^32 as float64, which strict
+// u64 decoders reject; route them through bigint so the wire type stays uint.
+function toWireU64(value: number | bigint, ctx: string): number | bigint {
+  const checked = assertU64(value, ctx);
+  return checked > 0xffffffff ? BigInt(checked) : checked;
+}
+
+function assertBin32(value: Uint8Array, ctx: string): Uint8Array {
+  if (value.length !== 32) {
+    throw new Error(`${ctx}: expected 32 bytes, got ${value.length}`);
+  }
+  return value;
+}
+
+// Type aliases for primitive types
+export type AztecAddress = Uint8Array;
+export type ContractClassId = Uint8Array;
+export type ForkId = number;
+export type Fr = Uint8Array;
+export type FunctionSelector = Uint8Array;
+
+// Public interfaces (exported)
+export interface CdbGetContractInstance {
+  address: AztecAddress;
+  forkId: ForkId;
+}
+
+export interface CdbGetContractClass {
+  classId: ContractClassId;
+  forkId: ForkId;
+}
+
+export interface CdbGetBytecodeCommitment {
+  classId: ContractClassId;
+  forkId: ForkId;
+}
+
+export interface CdbGetDebugFunctionName {
+  address: AztecAddress;
+  selector: FunctionSelector;
+  forkId: ForkId;
+}
+
+export interface CdbAddContracts {
+  contractDeploymentData: Uint8Array;
+  forkId: ForkId;
+}
+
+export interface CdbCreateCheckpoint {
+  forkId: ForkId;
+}
+
+export interface CdbCommitCheckpoint {
+  forkId: ForkId;
+}
+
+export interface CdbRevertCheckpoint {
+  forkId: ForkId;
+}
+
+export interface CdbGetContractInstanceResponse {
+  instance: Uint8Array | null;
+}
+
+export interface CdbGetContractClassResponse {
+  contractClass: Uint8Array | null;
+}
+
+export interface CdbGetBytecodeCommitmentResponse {
+  commitment: Fr | null;
+}
+
+export interface CdbGetDebugFunctionNameResponse {
+  name: string | null;
+}
+
+export interface CdbAddContractsResponse {
+
+}
+
+export interface CdbCreateCheckpointResponse {
+
+}
+
+export interface CdbCommitCheckpointResponse {
+
+}
+
+export interface CdbRevertCheckpointResponse {
+
+}
+
+export interface CdbErrorResponse {
+  message: string;
+}
+
+// Private Msgpack interfaces (not exported)
+interface MsgpackCdbGetContractInstance {
+  address: Uint8Array;
+  forkId: number | bigint;
+}
+
+interface MsgpackCdbGetContractClass {
+  classId: Uint8Array;
+  forkId: number | bigint;
+}
+
+interface MsgpackCdbGetBytecodeCommitment {
+  classId: Uint8Array;
+  forkId: number | bigint;
+}
+
+interface MsgpackCdbGetDebugFunctionName {
+  address: Uint8Array;
+  selector: Uint8Array;
+  forkId: number | bigint;
+}
+
+interface MsgpackCdbAddContracts {
+  contractDeploymentData: Uint8Array;
+  forkId: number | bigint;
+}
+
+interface MsgpackCdbCreateCheckpoint {
+  forkId: number | bigint;
+}
+
+interface MsgpackCdbCommitCheckpoint {
+  forkId: number | bigint;
+}
+
+interface MsgpackCdbRevertCheckpoint {
+  forkId: number | bigint;
+}
+
+interface MsgpackCdbGetContractInstanceResponse {
+  instance: Uint8Array | null;
+}
+
+interface MsgpackCdbGetContractClassResponse {
+  contractClass: Uint8Array | null;
+}
+
+interface MsgpackCdbGetBytecodeCommitmentResponse {
+  commitment: Uint8Array | null;
+}
+
+interface MsgpackCdbGetDebugFunctionNameResponse {
+  name: string | null;
+}
+
+interface MsgpackCdbAddContractsResponse {
+
+}
+
+interface MsgpackCdbCreateCheckpointResponse {
+
+}
+
+interface MsgpackCdbCommitCheckpointResponse {
+
+}
+
+interface MsgpackCdbRevertCheckpointResponse {
+
+}
+
+interface MsgpackCdbErrorResponse {
+  message: string;
+}
+
+// Conversion functions (exported)
+export function toCdbGetContractInstance(o: MsgpackCdbGetContractInstance): CdbGetContractInstance {
+  if (o.address === undefined) { throw new Error("Expected address in CdbGetContractInstance deserialization"); }
+  if (o.forkId === undefined) { throw new Error("Expected forkId in CdbGetContractInstance deserialization"); };
+  return {
+    address: assertBin32(o.address, "o.address"),
+    forkId: assertU64(o.forkId, "o.forkId"),
+  };
+}
+
+export function toCdbGetContractClass(o: MsgpackCdbGetContractClass): CdbGetContractClass {
+  if (o.classId === undefined) { throw new Error("Expected classId in CdbGetContractClass deserialization"); }
+  if (o.forkId === undefined) { throw new Error("Expected forkId in CdbGetContractClass deserialization"); };
+  return {
+    classId: assertBin32(o.classId, "o.classId"),
+    forkId: assertU64(o.forkId, "o.forkId"),
+  };
+}
+
+export function toCdbGetBytecodeCommitment(o: MsgpackCdbGetBytecodeCommitment): CdbGetBytecodeCommitment {
+  if (o.classId === undefined) { throw new Error("Expected classId in CdbGetBytecodeCommitment deserialization"); }
+  if (o.forkId === undefined) { throw new Error("Expected forkId in CdbGetBytecodeCommitment deserialization"); };
+  return {
+    classId: assertBin32(o.classId, "o.classId"),
+    forkId: assertU64(o.forkId, "o.forkId"),
+  };
+}
+
+export function toCdbGetDebugFunctionName(o: MsgpackCdbGetDebugFunctionName): CdbGetDebugFunctionName {
+  if (o.address === undefined) { throw new Error("Expected address in CdbGetDebugFunctionName deserialization"); }
+  if (o.selector === undefined) { throw new Error("Expected selector in CdbGetDebugFunctionName deserialization"); }
+  if (o.forkId === undefined) { throw new Error("Expected forkId in CdbGetDebugFunctionName deserialization"); };
+  return {
+    address: assertBin32(o.address, "o.address"),
+    selector: assertBin32(o.selector, "o.selector"),
+    forkId: assertU64(o.forkId, "o.forkId"),
+  };
+}
+
+export function toCdbAddContracts(o: MsgpackCdbAddContracts): CdbAddContracts {
+  if (o.contractDeploymentData === undefined) { throw new Error("Expected contractDeploymentData in CdbAddContracts deserialization"); }
+  if (o.forkId === undefined) { throw new Error("Expected forkId in CdbAddContracts deserialization"); };
+  return {
+    contractDeploymentData: o.contractDeploymentData,
+    forkId: assertU64(o.forkId, "o.forkId"),
+  };
+}
+
+export function toCdbCreateCheckpoint(o: MsgpackCdbCreateCheckpoint): CdbCreateCheckpoint {
+  if (o.forkId === undefined) { throw new Error("Expected forkId in CdbCreateCheckpoint deserialization"); };
+  return {
+    forkId: assertU64(o.forkId, "o.forkId"),
+  };
+}
+
+export function toCdbCommitCheckpoint(o: MsgpackCdbCommitCheckpoint): CdbCommitCheckpoint {
+  if (o.forkId === undefined) { throw new Error("Expected forkId in CdbCommitCheckpoint deserialization"); };
+  return {
+    forkId: assertU64(o.forkId, "o.forkId"),
+  };
+}
+
+export function toCdbRevertCheckpoint(o: MsgpackCdbRevertCheckpoint): CdbRevertCheckpoint {
+  if (o.forkId === undefined) { throw new Error("Expected forkId in CdbRevertCheckpoint deserialization"); };
+  return {
+    forkId: assertU64(o.forkId, "o.forkId"),
+  };
+}
+
+export function toCdbGetContractInstanceResponse(o: MsgpackCdbGetContractInstanceResponse): CdbGetContractInstanceResponse {
+;
+  return {
+    instance: o.instance ?? null,
+  };
+}
+
+export function toCdbGetContractClassResponse(o: MsgpackCdbGetContractClassResponse): CdbGetContractClassResponse {
+;
+  return {
+    contractClass: o.contractClass ?? null,
+  };
+}
+
+export function toCdbGetBytecodeCommitmentResponse(o: MsgpackCdbGetBytecodeCommitmentResponse): CdbGetBytecodeCommitmentResponse {
+;
+  return {
+    commitment: o.commitment != null ? assertBin32(o.commitment, "o.commitment") : null,
+  };
+}
+
+export function toCdbGetDebugFunctionNameResponse(o: MsgpackCdbGetDebugFunctionNameResponse): CdbGetDebugFunctionNameResponse {
+;
+  return {
+    name: o.name ?? null,
+  };
+}
+
+export function toCdbAddContractsResponse(o: MsgpackCdbAddContractsResponse): CdbAddContractsResponse {
+  return {};
+}
+
+export function toCdbCreateCheckpointResponse(o: MsgpackCdbCreateCheckpointResponse): CdbCreateCheckpointResponse {
+  return {};
+}
+
+export function toCdbCommitCheckpointResponse(o: MsgpackCdbCommitCheckpointResponse): CdbCommitCheckpointResponse {
+  return {};
+}
+
+export function toCdbRevertCheckpointResponse(o: MsgpackCdbRevertCheckpointResponse): CdbRevertCheckpointResponse {
+  return {};
+}
+
+export function toCdbErrorResponse(o: MsgpackCdbErrorResponse): CdbErrorResponse {
+  if (o.message === undefined) { throw new Error("Expected message in CdbErrorResponse deserialization"); };
+  return {
+    message: o.message,
+  };
+}
+
+export function fromCdbGetContractInstance(o: CdbGetContractInstance): MsgpackCdbGetContractInstance {
+  if (o.address === undefined) { throw new Error("Expected address in CdbGetContractInstance serialization"); }
+  if (o.forkId === undefined) { throw new Error("Expected forkId in CdbGetContractInstance serialization"); };
+  return {
+  address: assertBin32(o.address, "o.address"),
+  forkId: toWireU64(o.forkId, "o.forkId"),
+  };
+}
+
+export function fromCdbGetContractClass(o: CdbGetContractClass): MsgpackCdbGetContractClass {
+  if (o.classId === undefined) { throw new Error("Expected classId in CdbGetContractClass serialization"); }
+  if (o.forkId === undefined) { throw new Error("Expected forkId in CdbGetContractClass serialization"); };
+  return {
+  classId: assertBin32(o.classId, "o.classId"),
+  forkId: toWireU64(o.forkId, "o.forkId"),
+  };
+}
+
+export function fromCdbGetBytecodeCommitment(o: CdbGetBytecodeCommitment): MsgpackCdbGetBytecodeCommitment {
+  if (o.classId === undefined) { throw new Error("Expected classId in CdbGetBytecodeCommitment serialization"); }
+  if (o.forkId === undefined) { throw new Error("Expected forkId in CdbGetBytecodeCommitment serialization"); };
+  return {
+  classId: assertBin32(o.classId, "o.classId"),
+  forkId: toWireU64(o.forkId, "o.forkId"),
+  };
+}
+
+export function fromCdbGetDebugFunctionName(o: CdbGetDebugFunctionName): MsgpackCdbGetDebugFunctionName {
+  if (o.address === undefined) { throw new Error("Expected address in CdbGetDebugFunctionName serialization"); }
+  if (o.selector === undefined) { throw new Error("Expected selector in CdbGetDebugFunctionName serialization"); }
+  if (o.forkId === undefined) { throw new Error("Expected forkId in CdbGetDebugFunctionName serialization"); };
+  return {
+  address: assertBin32(o.address, "o.address"),
+  selector: assertBin32(o.selector, "o.selector"),
+  forkId: toWireU64(o.forkId, "o.forkId"),
+  };
+}
+
+export function fromCdbAddContracts(o: CdbAddContracts): MsgpackCdbAddContracts {
+  if (o.contractDeploymentData === undefined) { throw new Error("Expected contractDeploymentData in CdbAddContracts serialization"); }
+  if (o.forkId === undefined) { throw new Error("Expected forkId in CdbAddContracts serialization"); };
+  return {
+  contractDeploymentData: o.contractDeploymentData,
+  forkId: toWireU64(o.forkId, "o.forkId"),
+  };
+}
+
+export function fromCdbCreateCheckpoint(o: CdbCreateCheckpoint): MsgpackCdbCreateCheckpoint {
+  if (o.forkId === undefined) { throw new Error("Expected forkId in CdbCreateCheckpoint serialization"); };
+  return {
+  forkId: toWireU64(o.forkId, "o.forkId"),
+  };
+}
+
+export function fromCdbCommitCheckpoint(o: CdbCommitCheckpoint): MsgpackCdbCommitCheckpoint {
+  if (o.forkId === undefined) { throw new Error("Expected forkId in CdbCommitCheckpoint serialization"); };
+  return {
+  forkId: toWireU64(o.forkId, "o.forkId"),
+  };
+}
+
+export function fromCdbRevertCheckpoint(o: CdbRevertCheckpoint): MsgpackCdbRevertCheckpoint {
+  if (o.forkId === undefined) { throw new Error("Expected forkId in CdbRevertCheckpoint serialization"); };
+  return {
+  forkId: toWireU64(o.forkId, "o.forkId"),
+  };
+}
+
+export function fromCdbGetContractInstanceResponse(o: CdbGetContractInstanceResponse): MsgpackCdbGetContractInstanceResponse {
+;
+  return {
+  instance: o.instance ?? null,
+  };
+}
+
+export function fromCdbGetContractClassResponse(o: CdbGetContractClassResponse): MsgpackCdbGetContractClassResponse {
+;
+  return {
+  contractClass: o.contractClass ?? null,
+  };
+}
+
+export function fromCdbGetBytecodeCommitmentResponse(o: CdbGetBytecodeCommitmentResponse): MsgpackCdbGetBytecodeCommitmentResponse {
+;
+  return {
+  commitment: o.commitment != null ? assertBin32(o.commitment, "o.commitment") : null,
+  };
+}
+
+export function fromCdbGetDebugFunctionNameResponse(o: CdbGetDebugFunctionNameResponse): MsgpackCdbGetDebugFunctionNameResponse {
+;
+  return {
+  name: o.name ?? null,
+  };
+}
+
+export function fromCdbAddContractsResponse(o: CdbAddContractsResponse): MsgpackCdbAddContractsResponse {
+  return {};
+}
+
+export function fromCdbCreateCheckpointResponse(o: CdbCreateCheckpointResponse): MsgpackCdbCreateCheckpointResponse {
+  return {};
+}
+
+export function fromCdbCommitCheckpointResponse(o: CdbCommitCheckpointResponse): MsgpackCdbCommitCheckpointResponse {
+  return {};
+}
+
+export function fromCdbRevertCheckpointResponse(o: CdbRevertCheckpointResponse): MsgpackCdbRevertCheckpointResponse {
+  return {};
+}
+
+export function fromCdbErrorResponse(o: CdbErrorResponse): MsgpackCdbErrorResponse {
+  if (o.message === undefined) { throw new Error("Expected message in CdbErrorResponse serialization"); };
+  return {
+  message: o.message,
+  };
+}
+
+// Base API interfaces
+export interface AsyncApiBase {
+  getContractInstance(command: CdbGetContractInstance): Promise<CdbGetContractInstanceResponse>;
+  getContractClass(command: CdbGetContractClass): Promise<CdbGetContractClassResponse>;
+  getBytecodeCommitment(command: CdbGetBytecodeCommitment): Promise<CdbGetBytecodeCommitmentResponse>;
+  getDebugFunctionName(command: CdbGetDebugFunctionName): Promise<CdbGetDebugFunctionNameResponse>;
+  addContracts(command: CdbAddContracts): Promise<CdbAddContractsResponse>;
+  createCheckpoint(command: CdbCreateCheckpoint): Promise<CdbCreateCheckpointResponse>;
+  commitCheckpoint(command: CdbCommitCheckpoint): Promise<CdbCommitCheckpointResponse>;
+  revertCheckpoint(command: CdbRevertCheckpoint): Promise<CdbRevertCheckpointResponse>;
+  destroy(): Promise<void>;
+}
+
+export interface SyncApiBase {
+  getContractInstance(command: CdbGetContractInstance): CdbGetContractInstanceResponse;
+  getContractClass(command: CdbGetContractClass): CdbGetContractClassResponse;
+  getBytecodeCommitment(command: CdbGetBytecodeCommitment): CdbGetBytecodeCommitmentResponse;
+  getDebugFunctionName(command: CdbGetDebugFunctionName): CdbGetDebugFunctionNameResponse;
+  addContracts(command: CdbAddContracts): CdbAddContractsResponse;
+  createCheckpoint(command: CdbCreateCheckpoint): CdbCreateCheckpointResponse;
+  commitCheckpoint(command: CdbCommitCheckpoint): CdbCommitCheckpointResponse;
+  revertCheckpoint(command: CdbRevertCheckpoint): CdbRevertCheckpointResponse;
+  destroy(): void;
+}

package/src/public/cdb/generated/server.ts

@@ -0,0 +1,109 @@
+// AUTOGENERATED FILE - DO NOT EDIT
+// Server-side dispatch for IPC protocol
+
+import { Decoder, Encoder } from 'msgpackr';
+import type { CdbAddContracts, CdbAddContractsResponse, CdbCommitCheckpoint, CdbCommitCheckpointResponse, CdbCreateCheckpoint, CdbCreateCheckpointResponse, CdbGetBytecodeCommitment, CdbGetBytecodeCommitmentResponse, CdbGetContractClass, CdbGetContractClassResponse, CdbGetContractInstance, CdbGetContractInstanceResponse, CdbGetDebugFunctionName, CdbGetDebugFunctionNameResponse, CdbRevertCheckpoint, CdbRevertCheckpointResponse } from './api_types.js';
+import { fromCdbAddContractsResponse, fromCdbCommitCheckpointResponse, fromCdbCreateCheckpointResponse, fromCdbGetBytecodeCommitmentResponse, fromCdbGetContractClassResponse, fromCdbGetContractInstanceResponse, fromCdbGetDebugFunctionNameResponse, fromCdbRevertCheckpointResponse, toCdbAddContracts, toCdbCommitCheckpoint, toCdbCreateCheckpoint, toCdbGetBytecodeCommitment, toCdbGetContractClass, toCdbGetContractInstance, toCdbGetDebugFunctionName, toCdbRevertCheckpoint } from './api_types.js';
+
+/** Handler interface — implement this to serve commands. */
+export interface Handler {
+  getContractInstance(command: CdbGetContractInstance): Promise<CdbGetContractInstanceResponse>;
+  getContractClass(command: CdbGetContractClass): Promise<CdbGetContractClassResponse>;
+  getBytecodeCommitment(command: CdbGetBytecodeCommitment): Promise<CdbGetBytecodeCommitmentResponse>;
+  getDebugFunctionName(command: CdbGetDebugFunctionName): Promise<CdbGetDebugFunctionNameResponse>;
+  addContracts(command: CdbAddContracts): Promise<CdbAddContractsResponse>;
+  createCheckpoint(command: CdbCreateCheckpoint): Promise<CdbCreateCheckpointResponse>;
+  commitCheckpoint(command: CdbCommitCheckpoint): Promise<CdbCommitCheckpointResponse>;
+  revertCheckpoint(command: CdbRevertCheckpoint): Promise<CdbRevertCheckpointResponse>;
+}
+
+/**
+ * Dispatch a [commandName, payload] pair to the handler.
+ * Returns [responseName, responsePayload] for serialization.
+ * Handler failures are wrapped into the schema error variant.
+ */
+export async function dispatch(
+  handler: Handler,
+  commandName: string,
+  payload: any,
+): Promise<[string, any]> {
+  try {
+    switch (commandName) {
+      case 'CdbGetContractInstance': {
+        const cmd = toCdbGetContractInstance(payload);
+        const result = await handler.getContractInstance(cmd);
+        return ['CdbGetContractInstanceResponse', fromCdbGetContractInstanceResponse(result)];
+      }
+      case 'CdbGetContractClass': {
+        const cmd = toCdbGetContractClass(payload);
+        const result = await handler.getContractClass(cmd);
+        return ['CdbGetContractClassResponse', fromCdbGetContractClassResponse(result)];
+      }
+      case 'CdbGetBytecodeCommitment': {
+        const cmd = toCdbGetBytecodeCommitment(payload);
+        const result = await handler.getBytecodeCommitment(cmd);
+        return ['CdbGetBytecodeCommitmentResponse', fromCdbGetBytecodeCommitmentResponse(result)];
+      }
+      case 'CdbGetDebugFunctionName': {
+        const cmd = toCdbGetDebugFunctionName(payload);
+        const result = await handler.getDebugFunctionName(cmd);
+        return ['CdbGetDebugFunctionNameResponse', fromCdbGetDebugFunctionNameResponse(result)];
+      }
+      case 'CdbAddContracts': {
+        const cmd = toCdbAddContracts(payload);
+        const result = await handler.addContracts(cmd);
+        return ['CdbAddContractsResponse', fromCdbAddContractsResponse(result)];
+      }
+      case 'CdbCreateCheckpoint': {
+        const cmd = toCdbCreateCheckpoint(payload);
+        const result = await handler.createCheckpoint(cmd);
+        return ['CdbCreateCheckpointResponse', fromCdbCreateCheckpointResponse(result)];
+      }
+      case 'CdbCommitCheckpoint': {
+        const cmd = toCdbCommitCheckpoint(payload);
+        const result = await handler.commitCheckpoint(cmd);
+        return ['CdbCommitCheckpointResponse', fromCdbCommitCheckpointResponse(result)];
+      }
+      case 'CdbRevertCheckpoint': {
+        const cmd = toCdbRevertCheckpoint(payload);
+        const result = await handler.revertCheckpoint(cmd);
+        return ['CdbRevertCheckpointResponse', fromCdbRevertCheckpointResponse(result)];
+      }
+      default:
+        return ['CdbErrorResponse', { message: `Unknown command: ${commandName}` }];
+    }
+  } catch (err: any) {
+    return ['CdbErrorResponse', { message: err?.message ?? String(err) }];
+  }
+}
+
+const requestDecoder = new Decoder({ useRecords: false });
+const responseEncoder = new Encoder({ useRecords: false, variableMapSize: true });
+
+/**
+ * Decode a framed request, dispatch it, and encode the framed response.
+ * All failures (malformed framing included) produce a decodable error
+ * variant rather than a throw, so transports can use this directly as
+ * their request handler.
+ */
+export async function handleRequest(
+  handler: Handler,
+  requestBytes: Uint8Array,
+): Promise<Uint8Array> {
+  let commandName: string;
+  let payload: any;
+  try {
+    const request = requestDecoder.unpack(requestBytes) as [[string, any]];
+    [[commandName, payload]] = request;
+    if (typeof commandName !== 'string') {
+      throw new Error('expected [name, payload] request framing');
+    }
+  } catch (err: any) {
+    return responseEncoder.pack([
+      'CdbErrorResponse',
+      { message: `Malformed request: ${err?.message ?? String(err)}` },
+    ]);
+  }
+  const [respName, respPayload] = await dispatch(handler, commandName, payload ?? {});
+  return responseEncoder.pack([respName, respPayload]);
+}