@agoric/vats 0.15.2-dev-02c06c4.0 → 0.15.2-dev-fd68b6a.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/vats",
-  "version": "0.15.2-dev-02c06c4.0+02c06c4",
+  "version": "0.15.2-dev-fd68b6a.0+fd68b6a",
   "description": "Agoric's Vat library",
   "type": "module",
   "main": "./index.js",
@@ -22,19 +22,19 @@
   "author": "Agoric",
   "license": "Apache-2.0",
   "dependencies": {
-    "@agoric/cosmic-proto": "0.4.1-dev-02c06c4.0+02c06c4",
-    "@agoric/ertp": "0.16.3-dev-02c06c4.0+02c06c4",
-    "@agoric/governance": "0.10.4-dev-02c06c4.0+02c06c4",
-    "@agoric/internal": "0.3.3-dev-02c06c4.0+02c06c4",
-    "@agoric/network": "0.1.1-dev-02c06c4.0+02c06c4",
-    "@agoric/notifier": "0.6.3-dev-02c06c4.0+02c06c4",
-    "@agoric/store": "0.9.3-dev-02c06c4.0+02c06c4",
-    "@agoric/swingset-vat": "0.32.3-dev-02c06c4.0+02c06c4",
-    "@agoric/time": "0.3.3-dev-02c06c4.0+02c06c4",
-    "@agoric/vat-data": "0.5.3-dev-02c06c4.0+02c06c4",
-    "@agoric/vow": "0.1.1-dev-02c06c4.0+02c06c4",
-    "@agoric/zoe": "0.26.3-dev-02c06c4.0+02c06c4",
-    "@agoric/zone": "0.2.3-dev-02c06c4.0+02c06c4",
+    "@agoric/cosmic-proto": "0.4.1-dev-fd68b6a.0+fd68b6a",
+    "@agoric/ertp": "0.16.3-dev-fd68b6a.0+fd68b6a",
+    "@agoric/governance": "0.10.4-dev-fd68b6a.0+fd68b6a",
+    "@agoric/internal": "0.3.3-dev-fd68b6a.0+fd68b6a",
+    "@agoric/network": "0.1.1-dev-fd68b6a.0+fd68b6a",
+    "@agoric/notifier": "0.6.3-dev-fd68b6a.0+fd68b6a",
+    "@agoric/store": "0.9.3-dev-fd68b6a.0+fd68b6a",
+    "@agoric/swingset-vat": "0.32.3-dev-fd68b6a.0+fd68b6a",
+    "@agoric/time": "0.3.3-dev-fd68b6a.0+fd68b6a",
+    "@agoric/vat-data": "0.5.3-dev-fd68b6a.0+fd68b6a",
+    "@agoric/vow": "0.1.1-dev-fd68b6a.0+fd68b6a",
+    "@agoric/zoe": "0.26.3-dev-fd68b6a.0+fd68b6a",
+    "@agoric/zone": "0.2.3-dev-fd68b6a.0+fd68b6a",
     "@endo/errors": "^1.2.7",
     "@endo/far": "^1.1.8",
     "@endo/import-bundle": "^1.3.1",
@@ -47,7 +47,7 @@
     "jessie.js": "^0.3.4"
   },
   "devDependencies": {
-    "@agoric/swingset-liveslots": "0.10.3-dev-02c06c4.0+02c06c4",
+    "@agoric/swingset-liveslots": "0.10.3-dev-fd68b6a.0+fd68b6a",
     "@endo/bundle-source": "^3.4.2",
     "@endo/init": "^1.1.6",
     "ava": "^5.3.0",
@@ -79,5 +79,5 @@
   "typeCoverage": {
     "atLeast": 91.52
   },
-  "gitHead": "02c06c489677233c0daa112284d16c314aff97c6"
+  "gitHead": "fd68b6ac1620d3ac9b6e98eeee7a507c3ccb3d79"
 }

package/scripts/build-bundles.d.ts

@@ -0,0 +1,3 @@
+#! /usr/bin/env node
+export {};
+//# sourceMappingURL=build-bundles.d.ts.map

package/scripts/build-bundles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-bundles.d.ts","sourceRoot":"","sources":["build-bundles.js"],"names":[],"mappings":""}

package/src/core/basic-behaviors.d.ts

@@ -26,7 +26,7 @@ export function installBootContracts({ consume: { vatAdminSvc, zoe }, installati
 export function mintInitialSupply({ vatParameters: { argv: { bootMsg }, }, consume: { feeMintAccess: feeMintAccessP, zoe }, produce: { initialSupply }, installation: { consume: { centralSupply }, }, }: BootstrapPowers & {
     vatParameters: {
         argv: {
-            bootMsg?: typeof bootMsgEx;
+            bootMsg?: import("@agoric/internal/src/chain-utils.js").InitMsg;
         };
     };
 }): Promise<void>;
@@ -34,18 +34,5 @@ export function addBankAssets({ consume: { agoricNamesAdmin, initialSupply, brid
 /** @type {import('./lib-boot.js').BootstrapManifest} */
 export const BASIC_BOOTSTRAP_PERMITS: import("./lib-boot.js").BootstrapManifest;
 export type VatStore = MapStore<string, CreateVatResults>;
-declare namespace bootMsgEx {
-    let type: string;
-    let chainID: string;
-    let storagePort: number;
-    let supplyCoins: {
-        denom: string;
-        amount: string;
-    }[];
-    let swingsetPort: number;
-    let vbankPort: number;
-    let vibcPort: number;
-}
 import type { CreateVatResults } from '@agoric/swingset-vat';
-export {};
 //# sourceMappingURL=basic-behaviors.d.ts.map

package/src/core/basic-behaviors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"basic-behaviors.d.ts","sourceRoot":"","sources":["basic-behaviors.js"],"names":[],"mappings":"AA+DO,mIATI,eAAe,GAAG;IACxB,OAAO,EAAE;QACP,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC7B,eAAe,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;KACtC,CAAC;CACH,iBA4DH;AAIM,gDADK,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,iBAW/C;AAGM,0FADK,cAAc,GAAG;IAAE,IAAI,EAAE,OAAO,cAAc,EAAE,IAAI,CAAA;CAAE,iBAiCjE;AAqGM,uMAPI,cAAc,GAAG;IACvB,IAAI,EAAE,OAAO,cAAc,EAAE,IAAI,CAAC;IAClC,OAAO,EAAE;QACP,6BAA6B,EAAE,OAAO,wDAAwD,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC,+BAA+B,CAAC,CAAC;KACpK,CAAC;CACH,iBA6DH;AAMM,gOAFI,eAAe,iBAyBzB;AAMM,gGAFI,eAAe,iBAgBzB;AAQM,mHAFI,eAAe,GAAG,cAAc,iBAe1C;AAIM,gIADK,eAAe,GAAG,cAAc,iBAW3C;AAOM,qHAFI,eAAe,iBAWzB;AAcM,+JAFI,eAAe,iBAwBzB;AAQM,kGAFI,cAAc,iBA6BxB;AAIM,uHADK,cAAc,iBAkCzB;AAIM,oIADK,cAAc,iBAiBzB;AASM,0MAJI,eAAe,GAAG;IACxB,aAAa,EAAE;QAAE,IAAI,EAAE;YAAE,OAAO,CAAC,EAAE,OAAO,SAAS,CAAA;SAAE,CAAA;KAAE,CAAC;CACzD,iBAmCH;AAQM,kTAFI,cAAc,iBAsFxB;AAGD,wDAAwD;AACxD,sCADW,OAAO,eAAe,EAAE,iBAAiB,CA0IlD;uBA5wBY,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;;;;;;;;;;;;;sCASb,sBAAsB"}
+{"version":3,"file":"basic-behaviors.d.ts","sourceRoot":"","sources":["basic-behaviors.js"],"names":[],"mappings":"AAwCO,mIATI,eAAe,GAAG;IACxB,OAAO,EAAE;QACP,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC7B,eAAe,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;KACtC,CAAC;CACH,iBA4DH;AAIM,gDADK,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,iBAW/C;AAGM,0FADK,cAAc,GAAG;IAAE,IAAI,EAAE,OAAO,cAAc,EAAE,IAAI,CAAA;CAAE,iBAiCjE;AAqGM,uMAPI,cAAc,GAAG;IACvB,IAAI,EAAE,OAAO,cAAc,EAAE,IAAI,CAAC;IAClC,OAAO,EAAE;QACP,6BAA6B,EAAE,OAAO,wDAAwD,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC,+BAA+B,CAAC,CAAC;KACpK,CAAC;CACH,iBA6DH;AAMM,gOAFI,eAAe,iBAyBzB;AAMM,gGAFI,eAAe,iBAgBzB;AAQM,mHAFI,eAAe,GAAG,cAAc,iBAe1C;AAIM,gIADK,eAAe,GAAG,cAAc,iBAW3C;AAOM,qHAFI,eAAe,iBAWzB;AAcM,+JAFI,eAAe,iBAwBzB;AAQM,kGAFI,cAAc,iBA6BxB;AAIM,uHADK,cAAc,iBAkCzB;AAIM,oIADK,cAAc,iBAiBzB;AAaM,0MARI,eAAe,GAAG;IACxB,aAAa,EAAE;QACb,IAAI,EAAE;YACJ,OAAO,CAAC,EAAE,OAAO,qCAAqC,EAAE,OAAO,CAAC;SACjE,CAAC;KACH,CAAC;CACH,iBAmCH;AAQM,kTAFI,cAAc,iBAsFxB;AAGD,wDAAwD;AACxD,sCADW,OAAO,eAAe,EAAE,iBAAiB,CA0IlD;uBAhxBY,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;sCASb,sBAAsB"}

package/src/core/basic-behaviors.js

@@ -21,29 +21,6 @@ import { makeScopedBridge } from '../bridge.js';
 
 /** @import {GovernableStartFn, GovernanceFacetKit} from '@agoric/governance/src/types.js'; */
 
-/**
- * In golang/cosmos/app/app.go, we define cosmosInitAction with type
- * AG_COSMOS_INIT, with the following shape.
- *
- * The uist supplyCoins value is taken from genesis, thereby authorizing the
- * minting an initial supply of RUN.
- */
-// eslint-disable-next-line no-unused-vars
-const bootMsgEx = {
-  type: 'AG_COSMOS_INIT',
-  chainID: 'agoric',
-  storagePort: 1,
-  supplyCoins: [
-    { denom: 'provisionpass', amount: '100' },
-    { denom: 'sendpacketpass', amount: '100' },
-    { denom: 'ubld', amount: '1000000000000000' },
-    { denom: 'uist', amount: '50000000000' },
-  ],
-  swingsetPort: 4,
-  vbankPort: 3,
-  vibcPort: 2,
-};
-
 /**
  * TODO: review behaviors carefully for powers that go out of scope, since we
  * may want/need them later.
@@ -560,7 +537,11 @@ export const installBootContracts = async ({
  * Mint IST genesis supply.
  *
  * @param {BootstrapPowers & {
- *   vatParameters: { argv: { bootMsg?: typeof bootMsgEx } };
+ *   vatParameters: {
+ *     argv: {
+ *       bootMsg?: import('@agoric/internal/src/chain-utils.js').InitMsg;
+ *     };
+ *   };
  * }} powers
  */
 export const mintInitialSupply = async ({

package/src/core/boot-chain.d.ts

@@ -48,18 +48,7 @@ export namespace modules {
         mintInitialSupply: ({ vatParameters: { argv: { bootMsg }, }, consume: { feeMintAccess: feeMintAccessP, zoe }, produce: { initialSupply }, installation: { consume: { centralSupply }, }, }: BootstrapPowers & {
             vatParameters: {
                 argv: {
-                    bootMsg?: {
-                        type: string;
-                        chainID: string;
-                        storagePort: number;
-                        supplyCoins: {
-                            denom: string;
-                            amount: string;
-                        }[];
-                        swingsetPort: number;
-                        vbankPort: number;
-                        vibcPort: number;
-                    };
+                    bootMsg?: import("@agoric/internal/src/chain-utils.js").InitMsg;
                 };
             };
         }) => Promise<void>;

package/src/core/boot-chain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"boot-chain.d.ts","sourceRoot":"","sources":["boot-chain.js"],"names":[],"mappings":";;;;;;;oBAkDwvK,CAAC;;;;;;;;mBAA07N,CAAC;kCAA6B,CAAC;4BAAqB,CAAC;;;;;;;;;;;;;yBAA3pS,mBAAc;;;yBAA0/G,mBAAc;;+CAA6D,OAAQ,wDAAwD,mCAAmC;;;;;;;;;;;;;;;2BAAguQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;qCAA17Z,GAAG;;;;;;;;;4DAAilG,aAAa;;;;uDAAkpB,aAAa;;;;;;;;gCAA2xC,aAAa;qCAAyC,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iGAA7kH,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA/BtkH,iDAAiD;AAEjD,iEAAiD;AAc1C,2CATI,SAAS,GAAG;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,CAAC,GAAG,KAAA,KAAK,IAAI,CAAC;CACvB,iBACO;IACN,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC,WACO,OAAO,kBAAkB,EAAE,OAAO;;;;;;;;;;;;;;GAc5C;+BA5Ba,OAAO,OAAO"}
+{"version":3,"file":"boot-chain.d.ts","sourceRoot":"","sources":["boot-chain.js"],"names":[],"mappings":";;;;;;;oBAkDwvK,CAAC;;;;;;;;mBAA07N,CAAC;kCAA6B,CAAC;4BAAqB,CAAC;;;;;;;;;;;;;yBAAtxT,mBAAc;;;yBAA0/G,mBAAc;;+CAA6D,OAAQ,wDAAwD,mCAAmC;;;;;;;;;;;;;;;2BAAgvQ,CAAC,SAAS,qCAAqC;;;;;;;;;;;;;;;qCAA73Y,GAAG;;;;;;;;;4DAAilG,aAAa;;;;uDAAkpB,aAAa;;;;;;;;gCAA2xC,aAAa;qCAAyC,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iGAA7kH,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA/BtkH,iDAAiD;AAEjD,iEAAiD;AAc1C,2CATI,SAAS,GAAG;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,CAAC,GAAG,KAAA,KAAK,IAAI,CAAC;CACvB,iBACO;IACN,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC,WACO,OAAO,kBAAkB,EAAE,OAAO;;;;;;;;;;;;;;GAc5C;+BA5Ba,OAAO,OAAO"}

package/src/core/lib-boot.d.ts

@@ -1,6 +1,6 @@
 export function makeBootstrap(vatPowers: import("@agoric/swingset-vat").VatPowers & {
     D: DProxy;
-    logger: (msg: any) => void;
+    logger?: typeof console.log;
 }, vatParameters: Record<string, unknown>, bootManifest: BootstrapManifest, behaviors: Record<string, BootBehavior>, modules: BootModules, zone?: import("@agoric/base-zone").Zone | undefined): {
     /**
      * Bootstrap vats and devices.

package/src/core/lib-boot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lib-boot.d.ts","sourceRoot":"","sources":["lib-boot.js"],"names":[],"mappings":"AAyDO,yCAVI,OAAO,sBAAsB,EAAE,SAAS,GAAG;IACjD,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,CAAC,GAAG,KAAA,KAAK,IAAI,CAAC;CACvB,iBACO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,gBACvB,iBAAiB,aACjB,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,WAC5B,WAAW;IAoHlB;;;;;OAKG;sBAFQ,YAAY,WACZ,WAAW,GAAG,YAAY;IAerC,6BAA6B;wBAAjB,MAAM;;IASlB,6BAA6B;sBAAjB,MAAM;;IAclB;;;OAGG;oBAFU,CAAC,EAAE,CAAC,SACN,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;;IA5CzB;;;;;OAKG;sBAFQ,YAAY,WACZ,WAAW,GAAG,YAAY;IAerC,6BAA6B;wBAAjB,MAAM;;IASlB,6BAA6B;sBAAjB,MAAM;;IAclB;;;OAGG;oBAFU,CAAC,EAAE,CAAC,SACN,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;GAK5B;sCAhNY,IAAI,GACV,MAAM,GACN;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAAA;CAAE;;;;;;;;;;;;;;gCAgBhD,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC;2BAIvC,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC;8BAE5C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;0BAEvB;IAAE,KAAK,EAAE,cAAc,YAAY,CAAC,CAAA;CAAE,GAAG,MAAM,CAC3D,MAAU,EACN,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CACpB;kCAoLU,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC"}
+{"version":3,"file":"lib-boot.d.ts","sourceRoot":"","sources":["lib-boot.js"],"names":[],"mappings":"AAyDO,yCAVI,OAAO,sBAAsB,EAAE,SAAS,GAAG;IACjD,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,CAAC,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC;CAC7B,iBACO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,gBACvB,iBAAiB,aACjB,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,WAC5B,WAAW;IAoHlB;;;;;OAKG;sBAFQ,YAAY,WACZ,WAAW,GAAG,YAAY;IAerC,6BAA6B;wBAAjB,MAAM;;IASlB,6BAA6B;sBAAjB,MAAM;;IAclB;;;OAGG;oBAFU,CAAC,EAAE,CAAC,SACN,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;;IA5CzB;;;;;OAKG;sBAFQ,YAAY,WACZ,WAAW,GAAG,YAAY;IAerC,6BAA6B;wBAAjB,MAAM;;IASlB,6BAA6B;sBAAjB,MAAM;;IAclB;;;OAGG;oBAFU,CAAC,EAAE,CAAC,SACN,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;GAK5B;sCAhNY,IAAI,GACV,MAAM,GACN;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAAA;CAAE;;;;;;;;;;;;;;gCAgBhD,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC;2BAIvC,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC;8BAE5C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;0BAEvB;IAAE,KAAK,EAAE,cAAc,YAAY,CAAC,CAAA;CAAE,GAAG,MAAM,CAC3D,MAAU,EACN,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CACpB;kCAoLU,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/src/core/lib-boot.js

@@ -47,7 +47,7 @@ const setDiff = (a, b) => a.filter(x => !b.includes(x));
 /**
  * @param {import('@agoric/swingset-vat').VatPowers & {
  *   D: DProxy;
- *   logger: (msg) => void;
+ *   logger?: typeof console.log;
  * }} vatPowers
  * @param {Record<string, unknown>} vatParameters
  * @param {BootstrapManifest} bootManifest

package/tools/bootstrap-chain-reflective.js

@@ -0,0 +1,194 @@
+/**
+ * @file Source code for a bootstrap vat that runs blockchain behaviors (such as
+ *   bridge vat integration) and exposes reflective methods for use in testing.
+ *
+ *   TODO: Share code with packages/SwingSet/tools/bootstrap-relay.js
+ */
+
+import { Fail, q } from '@endo/errors';
+import { Far, E } from '@endo/far';
+import { makePromiseKit } from '@endo/promise-kit';
+import { buildManualTimer } from '@agoric/swingset-vat/tools/manual-timer.js';
+import { makeReflectionMethods } from '@agoric/swingset-vat/tools/vat-puppet.js';
+import { makeDurableZone } from '@agoric/zone/durable.js';
+import { makeBootstrap } from '../src/core/lib-boot.js';
+import * as basicBehaviorsNamespace from '../src/core/basic-behaviors.js';
+import * as chainBehaviorsNamespace from '../src/core/chain-behaviors.js';
+import * as utils from '../src/core/utils.js';
+
+// Gather up all defined bootstrap behaviors.
+const { BASIC_BOOTSTRAP_PERMITS: BASIC_BOOTSTRAP, ...basicBehaviors } =
+  basicBehaviorsNamespace;
+const {
+  CHAIN_BOOTSTRAP_MANIFEST: CHAIN_BOOTSTRAP,
+  SHARED_CHAIN_BOOTSTRAP_MANIFEST: SHARED_CHAIN_BOOTSTRAP,
+  ...chainBehaviors
+} = chainBehaviorsNamespace;
+const manifests = { BASIC_BOOTSTRAP, CHAIN_BOOTSTRAP, SHARED_CHAIN_BOOTSTRAP };
+const allBehaviors = { ...basicBehaviors, ...chainBehaviors };
+export const modules = {
+  behaviors: { ...allBehaviors },
+  utils: { ...utils },
+};
+
+// Support constructing a new manifest as a subset from the union of all
+// standard manifests.
+const allPermits = Object.fromEntries(
+  Object.values(manifests)
+    .map(manifest => Object.entries(manifest))
+    .flat(),
+);
+const makeManifestForBehaviors = behaviors => {
+  const manifest = {};
+  for (const behavior of behaviors) {
+    const { name } = behavior;
+    Object.hasOwn(allPermits, name) || Fail`missing permit for ${name}`;
+    manifest[name] = allPermits[name];
+  }
+  return manifest;
+};
+
+// Define a minimal manifest of entries plucked from the above union.
+manifests.MINIMAL = makeManifestForBehaviors([
+  allBehaviors.bridgeCoreEval,
+  allBehaviors.makeBridgeManager,
+  allBehaviors.makeVatsFromBundles,
+  allBehaviors.startTimerService,
+  allBehaviors.setupClientManager,
+]);
+
+/**
+ * @param {VatPowers & { D: DProxy; testLog: typeof console.log }} vatPowers
+ * @param {{
+ *   baseManifest?: string;
+ *   addBehaviors?: string[];
+ *   coreProposalCodeSteps?: string[];
+ * }} bootstrapParameters
+ * @param {import('@agoric/vat-data').Baggage} baggage
+ */
+export const buildRootObject = (vatPowers, bootstrapParameters, baggage) => {
+  const manualTimer = buildManualTimer();
+  let vatAdmin;
+  const { promise: vatAdminP, resolve: captureVatAdmin } = makePromiseKit();
+  void vatAdminP.then(value => (vatAdmin = value)); // for better debugging
+  /** @typedef {{ root: object; incarnationNumber?: number }} VatRecord */
+  /**
+   * @typedef {VatRecord &
+   *   import('@agoric/swingset-vat').CreateVatResults & {
+   *     bundleCap: unknown;
+   *   }} DynamicVatRecord
+   */
+  /** @type {Map<string, VatRecord | DynamicVatRecord>} */
+  const vatRecords = new Map();
+  const devicesByName = new Map();
+
+  const { baseManifest: manifestName = 'MINIMAL', addBehaviors = [] } =
+    bootstrapParameters;
+  Object.hasOwn(manifests, manifestName) ||
+    Fail`missing manifest ${manifestName}`;
+  const manifest = {
+    ...manifests[manifestName],
+    ...makeManifestForBehaviors(addBehaviors),
+  };
+
+  /**
+   * bootstrapBase provides CORE_EVAL support, and also exposes:
+   *
+   * - promise-space functions consumeItem(name), produceItem(name, resolution),
+   *   resetItem(name)
+   * - awaitVatObject(presence: object, path?: PropertyKey[])
+   * - snapshotStore<K, V>(store: { entries: () => Iterable<[K, V]> }): Array<[K,
+   *   V]>
+   */
+  const bootstrapBase = makeBootstrap(
+    { ...vatPowers, logger: vatPowers.testLog },
+    bootstrapParameters,
+    manifest,
+    allBehaviors,
+    modules,
+    makeDurableZone(baggage),
+  );
+
+  const reflectionMethods = makeReflectionMethods(vatPowers, baggage);
+
+  return Far('root', {
+    ...reflectionMethods,
+
+    ...bootstrapBase,
+    bootstrap: async (vats, devices) => {
+      await bootstrapBase.bootstrap(vats, devices);
+
+      // createVatAdminService is idempotent (despite the name).
+      captureVatAdmin(E(vats.vatAdmin).createVatAdminService(devices.vatAdmin));
+
+      // Capture references to static vats and devices.
+      for (const [name, root] of Object.entries(vats)) {
+        if (name !== 'vatAdmin') {
+          vatRecords.set(name, { root });
+        }
+      }
+      for (const [name, device] of Object.entries(devices)) {
+        devicesByName.set(name, device);
+      }
+    },
+
+    getDevice: deviceName => devicesByName.get(deviceName),
+
+    getManualTimer: () => manualTimer,
+
+    getVatAdmin: () => vatAdmin || vatAdminP,
+
+    getVatAdminNode: vatName => {
+      const vat =
+        vatRecords.get(vatName) || Fail`unknown vat name: ${q(vatName)}`;
+      const { adminNode } = /** @type {DynamicVatRecord} */ (vat);
+      return adminNode;
+    },
+
+    getVatRoot: vatName => {
+      const vat =
+        vatRecords.get(vatName) || Fail`unknown vat name: ${q(vatName)}`;
+      const { root } = vat;
+      return root;
+    },
+
+    /**
+     * @param {string} vatName
+     * @param {string} [bundleCapName]
+     * @param {{ vatParameters?: object } & Record<string, unknown>} [vatOptions]
+     * @returns {Promise<DynamicVatRecord['root']>} root object of the new vat
+     */
+    createVat: async (vatName, bundleCapName = vatName, vatOptions = {}) => {
+      const bundleCap = await E(vatAdminP).getNamedBundleCap(bundleCapName);
+      const { root, adminNode } = await E(vatAdminP).createVat(bundleCap, {
+        vatParameters: {},
+        ...vatOptions,
+      });
+      vatRecords.set(vatName, { root, adminNode, bundleCap });
+      return root;
+    },
+
+    /**
+     * @param {string} vatName
+     * @param {string} [bundleCapName]
+     * @param {{ vatParameters?: object } & Record<string, unknown>} [vatOptions]
+     * @returns {Promise<number>} the resulting incarnation number
+     */
+    upgradeVat: async (vatName, bundleCapName, vatOptions = {}) => {
+      const vatRecord = /** @type {DynamicVatRecord} */ (
+        vatRecords.get(vatName) || Fail`unknown vat name: ${q(vatName)}`
+      );
+      const bundleCap = await (bundleCapName
+        ? E(vatAdminP).getNamedBundleCap(bundleCapName)
+        : vatRecord.bundleCap);
+      const upgradeOptions = { vatParameters: {}, ...vatOptions };
+      const { incarnationNumber } = await E(vatRecord.adminNode).upgrade(
+        bundleCap,
+        upgradeOptions,
+      );
+      vatRecord.incarnationNumber = incarnationNumber;
+      return incarnationNumber;
+    },
+  });
+};
+harden(buildRootObject);