All files / kernel-browser-runtime/src/rpc-handlers launch-subcluster.ts

100% Statements 5/5
100% Branches 2/2
100% Functions 1/1
100% Lines 5/5

Press n or j to go to the next uncovered block, b, p or k for the previous block.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63                                          5x                   5x                             5x             3x   3x              
import type { CapData } from '@endo/marshal';
import type { MethodSpec, Handler } from '@metamask/kernel-rpc-methods';
import type { Kernel, ClusterConfig, KRef } from '@metamask/ocap-kernel';
import { ClusterConfigStruct, CapDataStruct } from '@metamask/ocap-kernel';
import {
  object,
  string,
  nullable,
  type as structType,
} from '@metamask/superstruct';
 
/**
 * JSON-compatible version of SubclusterLaunchResult for RPC.
 * Uses null instead of undefined for JSON serialization.
 */
type LaunchSubclusterRpcResult = {
  subclusterId: string;
  bootstrapRootKref: string;
  bootstrapResult: CapData<KRef> | null;
};
 
const LaunchSubclusterRpcResultStruct = structType({
  subclusterId: string(),
  bootstrapRootKref: string(),
  bootstrapResult: nullable(CapDataStruct),
});
 
export const launchSubclusterSpec: MethodSpec<
  'launchSubcluster',
  { config: ClusterConfig },
  Promise<LaunchSubclusterRpcResult>
> = {
  method: 'launchSubcluster',
  params: object({ config: ClusterConfigStruct }),
  result: LaunchSubclusterRpcResultStruct,
};
 
export type LaunchSubclusterHooks = {
  kernel: Pick<Kernel, 'launchSubcluster'>;
};
 
export const launchSubclusterHandler: Handler<
  'launchSubcluster',
  { config: ClusterConfig },
  Promise<LaunchSubclusterRpcResult>,
  LaunchSubclusterHooks
> = {
  ...launchSubclusterSpec,
  hooks: { kernel: true },
  implementation: async (
    { kernel }: LaunchSubclusterHooks,
    params: { config: ClusterConfig },
  ): Promise<LaunchSubclusterRpcResult> => {
    const result = await kernel.launchSubcluster(params.config);
    // Convert undefined to null for JSON compatibility
    return {
      subclusterId: result.subclusterId,
      bootstrapRootKref: result.bootstrapRootKref,
      bootstrapResult: result.bootstrapResult ?? null,
    };
  },
};