@agoric/swingset-vat 0.32.3-dev-f20cc05.0 → 0.32.3-dev-9f8a76e.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/swingset-vat",
-  "version": "0.32.3-dev-f20cc05.0+f20cc05",
+  "version": "0.32.3-dev-9f8a76e.0+9f8a76e",
   "description": "Vat/Container Launcher",
   "type": "module",
   "main": "src/index.js",
@@ -27,16 +27,16 @@
     "@types/yargs-parser": "^21.0.0"
   },
   "dependencies": {
-    "@agoric/assert": "0.6.1-dev-f20cc05.0+f20cc05",
-    "@agoric/internal": "0.3.3-dev-f20cc05.0+f20cc05",
-    "@agoric/store": "0.9.3-dev-f20cc05.0+f20cc05",
-    "@agoric/swing-store": "0.9.2-dev-f20cc05.0+f20cc05",
-    "@agoric/swingset-liveslots": "0.10.3-dev-f20cc05.0+f20cc05",
-    "@agoric/swingset-xsnap-supervisor": "0.10.3-dev-f20cc05.0+f20cc05",
-    "@agoric/time": "0.3.3-dev-f20cc05.0+f20cc05",
-    "@agoric/vat-data": "0.5.3-dev-f20cc05.0+f20cc05",
-    "@agoric/xsnap": "0.14.3-dev-f20cc05.0+f20cc05",
-    "@agoric/xsnap-lockdown": "0.14.1-dev-f20cc05.0+f20cc05",
+    "@agoric/assert": "0.6.1-dev-9f8a76e.0+9f8a76e",
+    "@agoric/internal": "0.3.3-dev-9f8a76e.0+9f8a76e",
+    "@agoric/store": "0.9.3-dev-9f8a76e.0+9f8a76e",
+    "@agoric/swing-store": "0.9.2-dev-9f8a76e.0+9f8a76e",
+    "@agoric/swingset-liveslots": "0.10.3-dev-9f8a76e.0+9f8a76e",
+    "@agoric/swingset-xsnap-supervisor": "0.10.3-dev-9f8a76e.0+9f8a76e",
+    "@agoric/time": "0.3.3-dev-9f8a76e.0+9f8a76e",
+    "@agoric/vat-data": "0.5.3-dev-9f8a76e.0+9f8a76e",
+    "@agoric/xsnap": "0.14.3-dev-9f8a76e.0+9f8a76e",
+    "@agoric/xsnap-lockdown": "0.14.1-dev-9f8a76e.0+9f8a76e",
     "@endo/base64": "^0.2.32",
     "@endo/bundle-source": "^2.5.2",
     "@endo/captp": "^3.1.2",
@@ -93,5 +93,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "f20cc0580a0a6cb947f3a5c1ef1281fccca879f0"
+  "gitHead": "9f8a76ee66bd74f028158b689c4b437921613f63"
 }

package/tools/bootstrap-relay.js

@@ -0,0 +1,126 @@
+import { assert } from '@agoric/assert';
+import { objectMap } from '@agoric/internal';
+import { Far, E } from '@endo/far';
+import { buildManualTimer } from './manual-timer.js';
+import { makePassableEncoding } from './passableEncoding.js';
+
+const { Fail, quote: q } = assert;
+
+export const buildRootObject = () => {
+  const timer = buildManualTimer();
+  let vatAdmin;
+  const vatData = new Map();
+  const devicesByName = new Map();
+  const callLogsByRemotable = new Map();
+
+  const { encodePassable, decodePassable } = makePassableEncoding();
+
+  return Far('root', {
+    bootstrap: async (vats, devices) => {
+      vatAdmin = await E(vats.vatAdmin).createVatAdminService(devices.vatAdmin);
+      for (const [name, root] of Object.entries(vats)) {
+        if (name !== 'vatAdmin') {
+          vatData.set(name, { root });
+        }
+      }
+      for (const [name, device] of Object.entries(devices)) {
+        devicesByName.set(name, device);
+      }
+    },
+
+    getDevice: async deviceName =>
+      encodePassable(devicesByName.get(deviceName)),
+
+    getVatAdmin: async () => encodePassable(vatAdmin),
+
+    getTimer: async () => encodePassable(timer),
+
+    getVatRoot: async ({ name, rawOutput = false }) => {
+      const vat = vatData.get(name) || Fail`unknown vat name: ${q(name)}`;
+      const { root } = vat;
+      return rawOutput ? root : encodePassable(root);
+    },
+
+    createVat: async ({ name, bundleCapName, vatParameters = {} }) => {
+      const bcap = await E(vatAdmin).getNamedBundleCap(bundleCapName);
+      const options = { vatParameters };
+      const { adminNode, root } = await E(vatAdmin).createVat(bcap, options);
+      vatData.set(name, { adminNode, root });
+      return encodePassable(root);
+    },
+
+    upgradeVat: async ({ name, bundleCapName, vatParameters = {} }) => {
+      const vat = vatData.get(name) || Fail`unknown vat name: ${q(name)}`;
+      const bcap = await E(vatAdmin).getNamedBundleCap(bundleCapName);
+      const options = { vatParameters };
+      const incarnationNumber = await E(vat.adminNode).upgrade(bcap, options);
+      vat.incarnationNumber = incarnationNumber;
+      return incarnationNumber;
+    },
+
+    /**
+     * Derives a remotable from an object by mapping each object property into a method that returns the value.
+     * This function is intended to be called from testing code outside of the vat environment,
+     * but methods of the returned remotable are intended to be called from *inside* that environment
+     * and therefore do not perform argument/response translation.
+     *
+     * @param {string} label
+     * @param {Record<string, any>} encodedMethodReturnValues
+     */
+    makeRemotable: (label, encodedMethodReturnValues) => {
+      const callLogs = [];
+      const makeGetterFunction = (value, name) => {
+        const getValue = (...args) => {
+          callLogs.push([name, ...args]);
+          return value;
+        };
+        return getValue;
+      };
+      const methodReturnValues = decodePassable(encodedMethodReturnValues);
+      // `objectMap` hardens its result, but...
+      const methods = objectMap(methodReturnValues, makeGetterFunction);
+      // ... `Far` requires its methods argument not to be hardened.
+      const unhardenedMethods = { ...methods };
+      const remotable = Far(label, unhardenedMethods);
+      callLogsByRemotable.set(remotable, callLogs);
+      return encodePassable(remotable);
+    },
+
+    /**
+     * Returns a copy of a remotable's logs.
+     *
+     * @param {object} encodedRemotable
+     */
+    getLogForRemotable: encodedRemotable => {
+      const remotable = decodePassable(encodedRemotable);
+      const decodedLogs =
+        callLogsByRemotable.get(remotable) ||
+        Fail`logs not found for ${q(remotable)}`;
+      // Return a copy so that the original remains mutable.
+      return encodePassable(harden([...decodedLogs]));
+    },
+
+    messageVat: async ({ name, methodName, args = [] }) => {
+      const vat = vatData.get(name) || Fail`unknown vat name: ${q(name)}`;
+      const { root } = vat;
+      const decodedArgs = args.map(decodePassable);
+      const result = await E(root)[methodName](...decodedArgs);
+      return encodePassable(result);
+    },
+
+    messageVatObject: async ({ presence, methodName, args = [] }) => {
+      const object = decodePassable(presence);
+      const decodedArgs = args.map(decodePassable);
+      const result = await E(object)[methodName](...decodedArgs);
+      return encodePassable(result);
+    },
+
+    awaitVatObject: async ({ presence, path = [], rawOutput = false }) => {
+      let value = await decodePassable(presence);
+      for (const key of path) {
+        value = await value[key];
+      }
+      return rawOutput ? value : encodePassable(value);
+    },
+  });
+};