@aztec/simulator 6.0.0-nightly.20260605 → 6.0.0-nightly.20260721

package/dest/public/cdb/generated/api_types.js

@@ -0,0 +1,314 @@
+// 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, ctx) {
+    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, ctx) {
+    const checked = assertU64(value, ctx);
+    return checked > 0xffffffff ? BigInt(checked) : checked;
+}
+function assertBin32(value, ctx) {
+    if (value.length !== 32) {
+        throw new Error(`${ctx}: expected 32 bytes, got ${value.length}`);
+    }
+    return value;
+}
+// Conversion functions (exported)
+export function toCdbGetContractInstance(o) {
+    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) {
+    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) {
+    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) {
+    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) {
+    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) {
+    if (o.forkId === undefined) {
+        throw new Error("Expected forkId in CdbCreateCheckpoint deserialization");
+    }
+    ;
+    return {
+        forkId: assertU64(o.forkId, "o.forkId")
+    };
+}
+export function toCdbCommitCheckpoint(o) {
+    if (o.forkId === undefined) {
+        throw new Error("Expected forkId in CdbCommitCheckpoint deserialization");
+    }
+    ;
+    return {
+        forkId: assertU64(o.forkId, "o.forkId")
+    };
+}
+export function toCdbRevertCheckpoint(o) {
+    if (o.forkId === undefined) {
+        throw new Error("Expected forkId in CdbRevertCheckpoint deserialization");
+    }
+    ;
+    return {
+        forkId: assertU64(o.forkId, "o.forkId")
+    };
+}
+export function toCdbGetContractInstanceResponse(o) {
+    ;
+    return {
+        instance: o.instance ?? null
+    };
+}
+export function toCdbGetContractClassResponse(o) {
+    ;
+    return {
+        contractClass: o.contractClass ?? null
+    };
+}
+export function toCdbGetBytecodeCommitmentResponse(o) {
+    ;
+    return {
+        commitment: o.commitment != null ? assertBin32(o.commitment, "o.commitment") : null
+    };
+}
+export function toCdbGetDebugFunctionNameResponse(o) {
+    ;
+    return {
+        name: o.name ?? null
+    };
+}
+export function toCdbAddContractsResponse(o) {
+    return {};
+}
+export function toCdbCreateCheckpointResponse(o) {
+    return {};
+}
+export function toCdbCommitCheckpointResponse(o) {
+    return {};
+}
+export function toCdbRevertCheckpointResponse(o) {
+    return {};
+}
+export function toCdbErrorResponse(o) {
+    if (o.message === undefined) {
+        throw new Error("Expected message in CdbErrorResponse deserialization");
+    }
+    ;
+    return {
+        message: o.message
+    };
+}
+export function fromCdbGetContractInstance(o) {
+    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) {
+    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) {
+    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) {
+    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) {
+    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) {
+    if (o.forkId === undefined) {
+        throw new Error("Expected forkId in CdbCreateCheckpoint serialization");
+    }
+    ;
+    return {
+        forkId: toWireU64(o.forkId, "o.forkId")
+    };
+}
+export function fromCdbCommitCheckpoint(o) {
+    if (o.forkId === undefined) {
+        throw new Error("Expected forkId in CdbCommitCheckpoint serialization");
+    }
+    ;
+    return {
+        forkId: toWireU64(o.forkId, "o.forkId")
+    };
+}
+export function fromCdbRevertCheckpoint(o) {
+    if (o.forkId === undefined) {
+        throw new Error("Expected forkId in CdbRevertCheckpoint serialization");
+    }
+    ;
+    return {
+        forkId: toWireU64(o.forkId, "o.forkId")
+    };
+}
+export function fromCdbGetContractInstanceResponse(o) {
+    ;
+    return {
+        instance: o.instance ?? null
+    };
+}
+export function fromCdbGetContractClassResponse(o) {
+    ;
+    return {
+        contractClass: o.contractClass ?? null
+    };
+}
+export function fromCdbGetBytecodeCommitmentResponse(o) {
+    ;
+    return {
+        commitment: o.commitment != null ? assertBin32(o.commitment, "o.commitment") : null
+    };
+}
+export function fromCdbGetDebugFunctionNameResponse(o) {
+    ;
+    return {
+        name: o.name ?? null
+    };
+}
+export function fromCdbAddContractsResponse(o) {
+    return {};
+}
+export function fromCdbCreateCheckpointResponse(o) {
+    return {};
+}
+export function fromCdbCommitCheckpointResponse(o) {
+    return {};
+}
+export function fromCdbRevertCheckpointResponse(o) {
+    return {};
+}
+export function fromCdbErrorResponse(o) {
+    if (o.message === undefined) {
+        throw new Error("Expected message in CdbErrorResponse serialization");
+    }
+    ;
+    return {
+        message: o.message
+    };
+}

package/dest/public/cdb/generated/server.d.ts

@@ -0,0 +1,26 @@
+import type { CdbAddContracts, CdbAddContractsResponse, CdbCommitCheckpoint, CdbCommitCheckpointResponse, CdbCreateCheckpoint, CdbCreateCheckpointResponse, CdbGetBytecodeCommitment, CdbGetBytecodeCommitmentResponse, CdbGetContractClass, CdbGetContractClassResponse, CdbGetContractInstance, CdbGetContractInstanceResponse, CdbGetDebugFunctionName, CdbGetDebugFunctionNameResponse, CdbRevertCheckpoint, CdbRevertCheckpointResponse } 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 declare function dispatch(handler: Handler, commandName: string, payload: any): Promise<[string, any]>;
+/**
+ * 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 declare function handleRequest(handler: Handler, requestBytes: Uint8Array): Promise<Uint8Array>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VydmVyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvcHVibGljL2NkYi9nZW5lcmF0ZWQvc2VydmVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUlBLE9BQU8sS0FBSyxFQUFFLGVBQWUsRUFBRSx1QkFBdUIsRUFBRSxtQkFBbUIsRUFBRSwyQkFBMkIsRUFBRSxtQkFBbUIsRUFBRSwyQkFBMkIsRUFBRSx3QkFBd0IsRUFBRSxnQ0FBZ0MsRUFBRSxtQkFBbUIsRUFBRSwyQkFBMkIsRUFBRSxzQkFBc0IsRUFBRSw4QkFBOEIsRUFBRSx1QkFBdUIsRUFBRSwrQkFBK0IsRUFBRSxtQkFBbUIsRUFBRSwyQkFBMkIsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBR3JjLDhEQUE0RDtBQUM1RCxNQUFNLFdBQVcsT0FBTztJQUN0QixtQkFBbUIsQ0FBQyxPQUFPLEVBQUUsc0JBQXNCLEdBQUcsT0FBTyxDQUFDLDhCQUE4QixDQUFDLENBQUM7SUFDOUYsZ0JBQWdCLENBQUMsT0FBTyxFQUFFLG1CQUFtQixHQUFHLE9BQU8sQ0FBQywyQkFBMkIsQ0FBQyxDQUFDO0lBQ3JGLHFCQUFxQixDQUFDLE9BQU8sRUFBRSx3QkFBd0IsR0FBRyxPQUFPLENBQUMsZ0NBQWdDLENBQUMsQ0FBQztJQUNwRyxvQkFBb0IsQ0FBQyxPQUFPLEVBQUUsdUJBQXVCLEdBQUcsT0FBTyxDQUFDLCtCQUErQixDQUFDLENBQUM7SUFDakcsWUFBWSxDQUFDLE9BQU8sRUFBRSxlQUFlLEdBQUcsT0FBTyxDQUFDLHVCQUF1QixDQUFDLENBQUM7SUFDekUsZ0JBQWdCLENBQUMsT0FBTyxFQUFFLG1CQUFtQixHQUFHLE9BQU8sQ0FBQywyQkFBMkIsQ0FBQyxDQUFDO0lBQ3JGLGdCQUFnQixDQUFDLE9BQU8sRUFBRSxtQkFBbUIsR0FBRyxPQUFPLENBQUMsMkJBQTJCLENBQUMsQ0FBQztJQUNyRixnQkFBZ0IsQ0FBQyxPQUFPLEVBQUUsbUJBQW1CLEdBQUcsT0FBTyxDQUFDLDJCQUEyQixDQUFDLENBQUM7Q0FDdEY7QUFFRDs7OztHQUlHO0FBQ0gsd0JBQXNCLFFBQVEsQ0FDNUIsT0FBTyxFQUFFLE9BQU8sRUFDaEIsV0FBVyxFQUFFLE1BQU0sRUFDbkIsT0FBTyxFQUFFLEdBQUcsR0FDWCxPQUFPLENBQUMsQ0FBQyxNQUFNLEVBQUUsR0FBRyxDQUFDLENBQUMsQ0FpRHhCO0FBS0Q7Ozs7O0dBS0c7QUFDSCx3QkFBc0IsYUFBYSxDQUNqQyxPQUFPLEVBQUUsT0FBTyxFQUNoQixZQUFZLEVBQUUsVUFBVSxHQUN2QixPQUFPLENBQUMsVUFBVSxDQUFDLENBaUJyQiJ9

package/dest/public/cdb/generated/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/public/cdb/generated/server.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,gCAAgC,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,uBAAuB,EAAE,+BAA+B,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAGrc,8DAA4D;AAC5D,MAAM,WAAW,OAAO;IACtB,mBAAmB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC9F,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACrF,qBAAqB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,gCAAgC,CAAC,CAAC;IACpG,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAAC;IACjG,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACzE,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACrF,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACrF,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACtF;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,GAAG,GACX,OAAO,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAiDxB;AAKD;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,UAAU,GACvB,OAAO,CAAC,UAAU,CAAC,CAiBrB"}

package/dest/public/cdb/generated/server.js

@@ -0,0 +1,135 @@
+// AUTOGENERATED FILE - DO NOT EDIT
+// Server-side dispatch for IPC protocol
+import { Decoder, Encoder } from 'msgpackr';
+import { fromCdbAddContractsResponse, fromCdbCommitCheckpointResponse, fromCdbCreateCheckpointResponse, fromCdbGetBytecodeCommitmentResponse, fromCdbGetContractClassResponse, fromCdbGetContractInstanceResponse, fromCdbGetDebugFunctionNameResponse, fromCdbRevertCheckpointResponse, toCdbAddContracts, toCdbCommitCheckpoint, toCdbCreateCheckpoint, toCdbGetBytecodeCommitment, toCdbGetContractClass, toCdbGetContractInstance, toCdbGetDebugFunctionName, toCdbRevertCheckpoint } from './api_types.js';
+/**
+ * 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, commandName, payload) {
+    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) {
+        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, requestBytes) {
+    let commandName;
+    let payload;
+    try {
+        const request = requestDecoder.unpack(requestBytes);
+        [[commandName, payload]] = request;
+        if (typeof commandName !== 'string') {
+            throw new Error('expected [name, payload] request framing');
+        }
+    } catch (err) {
+        return responseEncoder.pack([
+            'CdbErrorResponse',
+            {
+                message: `Malformed request: ${err?.message ?? String(err)}`
+            }
+        ]);
+    }
+    const [respName, respPayload] = await dispatch(handler, commandName, payload ?? {});
+    return responseEncoder.pack([
+        respName,
+        respPayload
+    ]);
+}

package/dest/public/cdb_ipc_server.d.ts

@@ -0,0 +1,33 @@
+import { type ContractInstanceWithAddress } from '@aztec/stdlib/contract';
+import type { CdbAddContracts, CdbAddContractsResponse, CdbCommitCheckpoint, CdbCommitCheckpointResponse, CdbCreateCheckpoint, CdbCreateCheckpointResponse, CdbGetBytecodeCommitment, CdbGetBytecodeCommitmentResponse, CdbGetContractClass, CdbGetContractClassResponse, CdbGetContractInstance, CdbGetContractInstanceResponse, CdbGetDebugFunctionName, CdbGetDebugFunctionNameResponse, CdbRevertCheckpoint, CdbRevertCheckpointResponse } from './cdb/generated/api_types.js';
+import { type Handler as CdbHandler } from './cdb/generated/server.js';
+import type { PublicContractsDB } from './public_db_sources.js';
+/** Serializes contract instances to the AVM CDB wire shape. */
+export declare function serializeContractInstance(instance: ContractInstanceWithAddress): Record<string, unknown>;
+/** Routes AVM CDB IPC requests to registered PublicContractsDB forks. */
+export declare class CdbIpcServer implements CdbHandler {
+    readonly ipcPath: string;
+    private server;
+    private log;
+    /** Maps WSDB fork IDs to contracts DB/timestamp pairs for concurrent simulations. */
+    private forks;
+    constructor();
+    /** Register a PublicContractsDB for a given WSDB fork ID. */
+    registerFork(forkId: number, contractsDB: PublicContractsDB, timestamp: bigint): void;
+    /** Unregister a fork's contracts DB (call after simulation completes). */
+    unregisterFork(forkId: number): void;
+    /** Close the server and all active connections. */
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+    /** Look up the contracts DB for a given fork ID, throwing if not registered. */
+    private getFork;
+    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>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2RiX2lwY19zZXJ2ZXIuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9wdWJsaWMvY2RiX2lwY19zZXJ2ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBYUEsT0FBTyxFQUEwQixLQUFLLDJCQUEyQixFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFPbEcsT0FBTyxLQUFLLEVBQ1YsZUFBZSxFQUNmLHVCQUF1QixFQUN2QixtQkFBbUIsRUFDbkIsMkJBQTJCLEVBQzNCLG1CQUFtQixFQUNuQiwyQkFBMkIsRUFDM0Isd0JBQXdCLEVBQ3hCLGdDQUFnQyxFQUNoQyxtQkFBbUIsRUFDbkIsMkJBQTJCLEVBQzNCLHNCQUFzQixFQUN0Qiw4QkFBOEIsRUFDOUIsdUJBQXVCLEVBQ3ZCLCtCQUErQixFQUMvQixtQkFBbUIsRUFDbkIsMkJBQTJCLEVBQzVCLE1BQU0sOEJBQThCLENBQUM7QUFDdEMsT0FBTyxFQUFFLEtBQUssT0FBTyxJQUFJLFVBQVUsRUFBaUIsTUFBTSwyQkFBMkIsQ0FBQztBQUN0RixPQUFPLEtBQUssRUFBRSxpQkFBaUIsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBV2hFLCtEQUErRDtBQUMvRCx3QkFBZ0IseUJBQXlCLENBQUMsUUFBUSxFQUFFLDJCQUEyQixHQUFHLE1BQU0sQ0FBQyxNQUFNLEVBQUUsT0FBTyxDQUFDLENBb0J4RztBQWlCRCx5RUFBeUU7QUFDekUscUJBQWEsWUFBYSxZQUFXLFVBQVU7SUFDN0MsU0FBZ0IsT0FBTyxFQUFFLE1BQU0sQ0FBQztJQUNoQyxPQUFPLENBQUMsTUFBTSxDQUF3QjtJQUN0QyxPQUFPLENBQUMsR0FBRyxDQUFTO0lBQ3BCLHFGQUFxRjtJQUNyRixPQUFPLENBQUMsS0FBSyxDQUFtRTtJQUVoRixjQVVDO0lBRUQsNkRBQTZEO0lBQzdELFlBQVksQ0FBQyxNQUFNLEVBQUUsTUFBTSxFQUFFLFdBQVcsRUFBRSxpQkFBaUIsRUFBRSxTQUFTLEVBQUUsTUFBTSxHQUFHLElBQUksQ0FFcEY7SUFFRCwwRUFBMEU7SUFDMUUsY0FBYyxDQUFDLE1BQU0sRUFBRSxNQUFNLEdBQUcsSUFBSSxDQUVuQztJQUVELG1EQUFtRDtJQUM3QyxLQUFLLElBQUksT0FBTyxDQUFDLElBQUksQ0FBQyxDQUczQjtJQUVLLENBQUMsTUFBTSxDQUFDLFlBQVksQ0FBQyxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FFM0M7SUFFRCxnRkFBZ0Y7SUFDaEYsT0FBTyxDQUFDLE9BQU87SUFXVCxtQkFBbUIsQ0FBQyxPQUFPLEVBQUUsc0JBQXNCLEdBQUcsT0FBTyxDQUFDLDhCQUE4QixDQUFDLENBS2xHO0lBRUssZ0JBQWdCLENBQUMsT0FBTyxFQUFFLG1CQUFtQixHQUFHLE9BQU8sQ0FBQywyQkFBMkIsQ0FBQyxDQUt6RjtJQUVLLHFCQUFxQixDQUFDLE9BQU8sRUFBRSx3QkFBd0IsR0FBRyxPQUFPLENBQUMsZ0NBQWdDLENBQUMsQ0FLeEc7SUFFSyxvQkFBb0IsQ0FBQyxPQUFPLEVBQUUsdUJBQXVCLEdBQUcsT0FBTyxDQUFDLCtCQUErQixDQUFDLENBT3JHO0lBRUQsWUFBWSxDQUFDLE9BQU8sRUFBRSxlQUFlLEdBQUcsT0FBTyxDQUFDLHVCQUF1QixDQUFDLENBT3ZFO0lBRUQsZ0JBQWdCLENBQUMsT0FBTyxFQUFFLG1CQUFtQixHQUFHLE9BQU8sQ0FBQywyQkFBMkIsQ0FBQyxDQUluRjtJQUVELGdCQUFnQixDQUFDLE9BQU8sRUFBRSxtQkFBbUIsR0FBRyxPQUFPLENBQUMsMkJBQTJCLENBQUMsQ0FJbkY7SUFFRCxnQkFBZ0IsQ0FBQyxPQUFPLEVBQUUsbUJBQW1CLEdBQUcsT0FBTyxDQUFDLDJCQUEyQixDQUFDLENBSW5GO0NBQ0YifQ==

package/dest/public/cdb_ipc_server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdb_ipc_server.d.ts","sourceRoot":"","sources":["../../src/public/cdb_ipc_server.ts"],"names":[],"mappings":"AAaA,OAAO,EAA0B,KAAK,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAOlG,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,mBAAmB,EACnB,2BAA2B,EAC3B,wBAAwB,EACxB,gCAAgC,EAChC,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,EACtB,8BAA8B,EAC9B,uBAAuB,EACvB,+BAA+B,EAC/B,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,KAAK,OAAO,IAAI,UAAU,EAAiB,MAAM,2BAA2B,CAAC;AACtF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAWhE,+DAA+D;AAC/D,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,2BAA2B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBxG;AAiBD,yEAAyE;AACzE,qBAAa,YAAa,YAAW,UAAU;IAC7C,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,GAAG,CAAS;IACpB,qFAAqF;IACrF,OAAO,CAAC,KAAK,CAAmE;IAEhF,cAUC;IAED,6DAA6D;IAC7D,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAEpF;IAED,0EAA0E;IAC1E,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEnC;IAED,mDAAmD;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;IAEK,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3C;IAED,gFAAgF;IAChF,OAAO,CAAC,OAAO;IAWT,mBAAmB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAKlG;IAEK,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAKzF;IAEK,qBAAqB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,gCAAgC,CAAC,CAKxG;IAEK,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAOrG;IAED,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAOvE;IAED,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAInF;IAED,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAInF;IAED,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAInF;CACF"}

package/dest/public/cdb_ipc_server.js

@@ -0,0 +1,153 @@
+/**
+ * UDS server for AVM CDB requests.
+ *
+ * Transport (socket, framing, per-connection response ordering) is handled by the shared
+ * `UdsIpcServer` from `@aztec/ipc-runtime`; message dispatch comes from the generated CDB
+ * server. This class only implements the generated handler interface and routes requests to
+ * PublicContractsDB instances by fork ID.
+ */ var _computedKey;
+import { Fr } from '@aztec/foundation/curves/bn254';
+import { createLogger } from '@aztec/foundation/log';
+import { UdsIpcServer } from '@aztec/ipc-runtime';
+import { FunctionSelector } from '@aztec/stdlib/abi';
+import { AztecAddress } from '@aztec/stdlib/aztec-address';
+import { ContractDeploymentData } from '@aztec/stdlib/contract';
+import { Decoder, Encoder } from 'msgpackr';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { threadId } from 'node:worker_threads';
+import { handleRequest } from './cdb/generated/server.js';
+const encoder = new Encoder({
+    useRecords: false
+});
+const decoder = new Decoder({
+    useRecords: false
+});
+let instanceCounter = 0;
+function toFieldBuffer(field) {
+    return field.toBuffer();
+}
+/** Serializes contract instances to the AVM CDB wire shape. */ export function serializeContractInstance(instance) {
+    return {
+        salt: toFieldBuffer(instance.salt),
+        deployer: toFieldBuffer(instance.deployer),
+        currentContractClassId: toFieldBuffer(instance.currentContractClassId),
+        originalContractClassId: toFieldBuffer(instance.originalContractClassId),
+        initializationHash: toFieldBuffer(instance.initializationHash),
+        immutablesHash: toFieldBuffer(instance.immutablesHash),
+        publicKeys: {
+            npkMHash: toFieldBuffer(instance.publicKeys.npkMHash),
+            ivpkM: {
+                x: toFieldBuffer(instance.publicKeys.ivpkM.x),
+                y: toFieldBuffer(instance.publicKeys.ivpkM.y)
+            },
+            ovpkMHash: toFieldBuffer(instance.publicKeys.ovpkMHash),
+            tpkMHash: toFieldBuffer(instance.publicKeys.tpkMHash),
+            mspkMHash: toFieldBuffer(instance.publicKeys.mspkMHash),
+            fbpkMHash: toFieldBuffer(instance.publicKeys.fbpkMHash)
+        }
+    };
+}
+/** Serializes contract classes to the AVM CDB wire shape. */ function serializeContractClass(contractClass) {
+    return {
+        id: toFieldBuffer(contractClass.id),
+        artifactHash: toFieldBuffer(contractClass.artifactHash),
+        privateFunctionsRoot: toFieldBuffer(contractClass.privateFunctionsRoot),
+        packedBytecode: contractClass.packedBytecode
+    };
+}
+_computedKey = Symbol.asyncDispose;
+/** Routes AVM CDB IPC requests to registered PublicContractsDB forks. */ export class CdbIpcServer {
+    ipcPath;
+    server;
+    log;
+    /** Maps WSDB fork IDs to contracts DB/timestamp pairs for concurrent simulations. */ forks = new Map();
+    constructor(){
+        this.log = createLogger('cdb-ipc-server');
+        this.ipcPath = path.join(os.tmpdir(), `cdb-ts-${process.pid}-${threadId}-${instanceCounter++}.sock`);
+        // Listen asynchronously; the C++ AVM retries connecting until the socket is up.
+        this.server = UdsIpcServer.listen(this.ipcPath, (_clientId, request)=>handleRequest(this, request));
+        this.server.then(()=>this.log.debug(`CDB IPC server listening on ${this.ipcPath}`), (err)=>this.log.error(`CDB IPC server failed to listen on ${this.ipcPath}`, {
+                err
+            }));
+    }
+    /** Register a PublicContractsDB for a given WSDB fork ID. */ registerFork(forkId, contractsDB, timestamp) {
+        this.forks.set(forkId, {
+            db: contractsDB,
+            timestamp
+        });
+    }
+    /** Unregister a fork's contracts DB (call after simulation completes). */ unregisterFork(forkId) {
+        this.forks.delete(forkId);
+    }
+    /** Close the server and all active connections. */ async close() {
+        const server = await this.server.catch(()=>undefined);
+        await server?.close();
+    }
+    async [_computedKey]() {
+        await this.close();
+    }
+    /** Look up the contracts DB for a given fork ID, throwing if not registered. */ getFork(forkId) {
+        const fork = this.forks.get(forkId);
+        if (!fork) {
+            const registered = Array.from(this.forks.keys()).sort((a, b)=>a - b);
+            throw new Error(`CDB server: no contracts DB registered for forkId ${forkId} (registered=[${registered.join(',')}])`);
+        }
+        return fork;
+    }
+    async getContractInstance(command) {
+        const { db, timestamp } = this.getFork(command.forkId);
+        const address = AztecAddress.fromBuffer(Buffer.from(command.address));
+        const instance = await db.getContractInstance(address, timestamp);
+        return {
+            instance: instance ? encoder.encode(serializeContractInstance(instance)) : null
+        };
+    }
+    async getContractClass(command) {
+        const { db } = this.getFork(command.forkId);
+        const classId = Fr.fromBuffer(Buffer.from(command.classId));
+        const contractClass = await db.getContractClass(classId);
+        return {
+            contractClass: contractClass ? encoder.encode(serializeContractClass(contractClass)) : null
+        };
+    }
+    async getBytecodeCommitment(command) {
+        const { db } = this.getFork(command.forkId);
+        const classId = Fr.fromBuffer(Buffer.from(command.classId));
+        const commitment = await db.getBytecodeCommitment(classId);
+        return {
+            commitment: commitment ? toFieldBuffer(commitment) : null
+        };
+    }
+    async getDebugFunctionName(command) {
+        const { db } = this.getFork(command.forkId);
+        const address = AztecAddress.fromBuffer(Buffer.from(command.address));
+        const selectorField = Fr.fromBuffer(Buffer.from(command.selector));
+        const selector = FunctionSelector.fromFieldOrUndefined(selectorField);
+        const name = selector ? await db.getDebugFunctionName(address, selector) : undefined;
+        return {
+            name: name ?? null
+        };
+    }
+    addContracts(command) {
+        const { db } = this.getFork(command.forkId);
+        const contractDeploymentData = ContractDeploymentData.fromPlainObject(decoder.decode(command.contractDeploymentData));
+        db.addContractsFromLogs(contractDeploymentData);
+        return Promise.resolve({});
+    }
+    createCheckpoint(command) {
+        const { db } = this.getFork(command.forkId);
+        db.createCheckpoint();
+        return Promise.resolve({});
+    }
+    commitCheckpoint(command) {
+        const { db } = this.getFork(command.forkId);
+        db.commitCheckpoint();
+        return Promise.resolve({});
+    }
+    revertCheckpoint(command) {
+        const { db } = this.getFork(command.forkId);
+        db.revertCheckpoint();
+        return Promise.resolve({});
+    }
+}