refactor(bbapi): migrate bb + bb.js to ipc-codegen/ipc-runtime; delete legacy bb::ipc

[charlielye]

Combined redo of #23612 + #23614 off next. Those PRs predate envelope ids (the 8-byte request-id frame prefix), which broke wire compatibility between old and new stacks — bb, bb.js, and bb-rs must move together, so this is one PR. The old PRs were used as the recipe; they'll be closed pointing here.

bb (C++)

• Schema-first bbapi: bbapi/bb_schema.json checked in, in the friendly ipc-codegen dialect (same as avm/cdb/wsdb). CMake runs ipc-codegen at build time (client+server, bb::bbapi namespace); the schema is also embedded so bb msgpack schema prints it.
• Handlers: bbapi_handlers.* implement the generated dispatch (Responder-style, exactly-once ok/error), as thin adapters over the existing domain Cmd{...}.execute(ctx) commands. All 64 commands.
• Serve: bb msgpack run serves every transport through ipc-runtime — -/empty → stdio pipe server, .sock → UDS, .shm → shared memory — one generated handler, envelope framing everywhere. A plain-file input keeps the offline bare-frame replay for wasm/debug flows.
• FFI/wasm: typed-cbind bbapi() replaced by the ipc-codegen FFI contract ipc_ffi_entry(input, len, out, out_len) — same msgpack payload as the transports, no envelope, output is free()-compatible.
• Deletions (consumer-free after the above): legacy barretenberg/ipc/ + ipc_bench, nodejs_module/msgpack_client/ (nodejs_module now only exports LMDBStore), bbapi_execute.* (Command/CommandResponse named unions + dispatcher), func_traits/schema reflection + CBIND macros + msgpack_schema test.

ipc-runtime

• New pipe transport (C++): PipeServer/PipeClient over an fd pair or stdio, identical envelope framing to UDS, peer EOF → shutdown. Used by bb msgpack run on stdio and by bb-rs.
• TS: unref option on SpawnedProcessBackend (child + idle-socket unref, re-ref while calls are in flight) so bb.js callers that never destroy() can't hang node.

bb.js

• Generator consumes the checked-in bb_schema.json (vendored friendly-schema lowering), runs on plain node --experimental-strip-types (ts-node dropped), and strips the Bb service prefix from identifiers so the public API surface is unchanged while wire tags carry the prefix.
• Backends: UDS backend is a thin wrapper over SpawnedProcessBackend; SHM sync/async backends use ipc-runtime's NAPI clients (request-id correlation replaces FIFO queues); wasm backends call the ipc_ffi_entry export. Unused stdio pipe backend deleted.
• Rust client (barretenberg-rs generated sources) regenerates from the same pipeline; Shutdown is gone (pipe EOF replaces it — it was the only sender).

bb-rs

• Pipe backend speaks the envelope framing (serial ids, echoed-id verification); FFI backend binds ipc_ffi_entry.
• Fixed a latent generator gap surfaced by the friendly schema: fq[2] (Fq2) fields now get serde_array2_bytes, so G2 coordinates serialize as bin32 rather than integer arrays.

Schema dialect notes (vs the raw dump the old PRs used)

• Shutdown removed; CircuitKind is a plain u8 on the wire (the alias collided with the domain enum at bb::bbapi scope); Fq2/G2 coords are fq[2]; the shared vk-data struct is VkData (prefix-stripping made the old name collide with CircuitComputeVkResponse).

Drive-by fixes

Two latent breakages from the ts/ → ts/bb.js/ restructure, both one directory short, both blocking local validation of this change (verified untouched by this branch on next):

• src/barretenberg_wasm/*.wasm.gz symlinks resolved to barretenberg/ts/cpp/..., so any src-based wasm test failed with ENOENT.
• chonk_pinned_inputs.test.ts's findRepoRoot() produced barretenberg/barretenberg/cpp/chonk-pinned-flows.

Validation

• ipc-runtime: C++ tests incl. 6 new pipe tests, + ASAN; TS tests 18/18.
• bb: bbapi_tests green (the known ChonkPinnedIvcInputsTest fixture flake passed on rerun); c_bind exception tests green through ipc_ffi_entry.
• bb.js full suite 10/10 suites, 50 passed / 0 failed, exercising every transport — wasm, native socket, socket pipelined, SHM async, SHM pipelined, SHM sync (the SHM legs cover the NAPI clients' request-id correlation under pipelining).
• Pinned Chonk IVC flows prove and verify through bb.js on both the native and wasm backends.
• Live UDS smoke against real bb: pipelined poseidon2, correct hashes, clean SIGTERM. The wasm ipc_ffi_entry path returns the identical hash. (In wasm a failing command aborts via the throw_or_abort host import rather than returning an error response — unchanged behavior, since the wasm preset defines BB_NO_EXCEPTIONS and the old cbind guarded its catch the same way.)
• bb-rs: pipe leg 14/14 against the new bb binary; FFI leg 75/75 against libbb-external.a.

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	npm/​@​aztec/​ipc-runtime@​0.0.0-use.local

View full report