@agoric/vats 0.16.0-u18.3 → 0.16.0-u18.5

package/tools/board-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"board-utils.d.ts","sourceRoot":"","sources":["board-utils.js"],"names":[],"mappings":";AAoCO,sEAHI,OAAO,4CAA4C,EAAE,cAAc,GACjE,kBAAkB,CA0C9B;AAYM;;;;;;;;;;;;;;;;;;;;;GAGN;+BA1FY;IACR,KAAK,EAAE,OAAO,iCAAiC,EAAE,WAAW,CAAC;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,OAAO,iCAAiC,EAAE,WAAW,CAAC;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;iCAGS;IACR,KAAK,EAAE,MAAM,CACjB,MAAY,EACZ,OAAa,iCAAiC,EAAE,WAAW,CACtD,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC"}
+{"version":3,"file":"board-utils.d.ts","sourceRoot":"","sources":["board-utils.js"],"names":[],"mappings":";AAoCO,sEAHI,OAAO,4CAA4C,EAAE,cAAc,GACjE,kBAAkB,CA0C9B;AAYM,6CALI,MAAM,GAAG,MAAM,YAEvB;IAAyB,MAAM;IACN,SAAS;CAAC;;;;;;;;;;;;;;;;;;GAKrC;+BA1FY;IACR,KAAK,EAAE,OAAO,iCAAiC,EAAE,WAAW,CAAC;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,OAAO,iCAAiC,EAAE,WAAW,CAAC;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;iCAGS;IACR,KAAK,EAAE,MAAM,CACjB,MAAY,EACZ,OAAa,iCAAiC,EAAE,WAAW,CACtD,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC"}

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);

package/tools/fake-bridge.d.ts

@@ -3,7 +3,7 @@ export const FAUCET_ADDRESS: "faucet";
 export function makeFakeBankBridge(zone: import("@agoric/zone").Zone, { balances, onToBridge }?: {
     balances?: Balances | undefined;
     onToBridge?: ((obj: any) => void) | undefined;
-} | undefined): ScopedBridgeManager<"bank">;
+}): ScopedBridgeManager<"bank">;
 export function makeFakeIbcBridge(zone: import("@agoric/zone").Zone, onToBridge: (obj: any) => void): ScopedBridgeManager<"dibc">;
 export const LOCALCHAIN_DEFAULT_ADDRESS: "agoric1fakeLCAAddress";
 export namespace SIMULATED_ERRORS {
@@ -16,8 +16,8 @@ export const LOCALCHAIN_QUERY_ALL_BALANCES_RESPONSE: {
     denom: string;
 }[];
 export function fakeLocalChainBridgeQueryHandler(message: object): unknown;
-export function makeFakeLocalchainBridge(zone: import("@agoric/zone").Zone, onToBridge?: ((obj: any) => void) | undefined): ScopedBridgeManager<"vlocalchain">;
-export function makeFakeTransferBridge(zone: import("@agoric/zone").Zone, onToBridge?: ((obj: any) => void) | undefined): ScopedBridgeManager<"vtransfer">;
+export function makeFakeLocalchainBridge(zone: import("@agoric/zone").Zone, onToBridge?: (obj: any) => void, makeAddressFn?: (number: any) => string): ScopedBridgeManager<"vlocalchain">;
+export function makeFakeTransferBridge(zone: import("@agoric/zone").Zone, onToBridge?: (obj: any) => void): ScopedBridgeManager<"vtransfer">;
 export type Balances = {
     [address: string]: {
         [denom: string]: bigint;

package/tools/fake-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fake-bridge.d.ts","sourceRoot":"","sources":["fake-bridge.js"],"names":[],"mappings":"AAkBA,6EAA6E;AAE7E,sCAAuC;AAehC,yCAPI,OAAO,cAAc,EAAE,IAAI;;gCAGlB,IAAI;gBACX,oBAAoB,MAAM,CAAC,CA4FvC;AAOM,wCAJI,OAAO,cAAc,EAAE,IAAI,cAC3B,CAAC,GAAG,KAAA,KAAK,IAAI,GACX,oBAAoB,MAAM,CAAC,CAwCvC;AAED,iEAAkE;;;;;AAwB3D,0DALI,MAAM,YACN,MAAM,GACJ,OAAO,CAsCnB;AAED;;;IASE;AAWK,0DAHI,MAAM,GACJ,OAAO,CAsCnB;AAOM,+CAJI,OAAO,cAAc,EAAE,IAAI,8BAClB,IAAI,gBACX,oBAAoB,aAAa,CAAC,CAgD9C;AAOM,6CAJI,OAAO,cAAc,EAAE,IAAI,8BAClB,IAAI,gBACX,oBAAoB,WAAW,CAAC,CAuC5C;uBA/Wa;IAAE,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAA;CAAE;yCAPX,iBAAiB"}
+{"version":3,"file":"fake-bridge.d.ts","sourceRoot":"","sources":["fake-bridge.js"],"names":[],"mappings":"AAkBA,6EAA6E;AAE7E,6BAA8B,QAAQ,CAAC;AAehC,yCAPI,OAAO,cAAc,EAAE,IAAI,6BAEnC;IAAwB,QAAQ;IACH,UAAU,kBAAtB,IAAI;CACrB,GAAU,oBAAoB,MAAM,CAAC,CA4FvC;AAOM,wCAJI,OAAO,cAAc,EAAE,IAAI,cAC3B,CAAC,GAAG,KAAA,KAAK,IAAI,GACX,oBAAoB,MAAM,CAAC,CAwCvC;AAED,yCAA0C,uBAAuB,CAAC;;;;;AAwB3D,0DALI,MAAM,YACN,MAAM,GACJ,OAAO,CAsCnB;AAED;;;IASE;AAWK,0DAHI,MAAM,GACJ,OAAO,CAsCnB;AAQM,+CALI,OAAO,cAAc,EAAE,IAAI,eAC3B,CAAC,GAAG,KAAA,KAAK,IAAI,kBACb,CAAC,MAAM,KAAA,KAAK,MAAM,GAChB,oBAAoB,aAAa,CAAC,CAoD9C;AAOM,6CAJI,OAAO,cAAc,EAAE,IAAI,eAC3B,CAAC,GAAG,KAAA,KAAK,IAAI,GACX,oBAAoB,WAAW,CAAC,CAuC5C;uBApXa;IAAE,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAA;CAAE;yCAPX,iBAAiB"}

package/tools/fake-bridge.js

@@ -291,9 +291,14 @@ export const fakeLocalChainBridgeQueryHandler = message => {
 /**
  * @param {import('@agoric/zone').Zone} zone
  * @param {(obj) => void} [onToBridge]
+ * @param {(number) => string} makeAddressFn
  * @returns {ScopedBridgeManager<'vlocalchain'>}
  */
-export const makeFakeLocalchainBridge = (zone, onToBridge = () => {}) => {
+export const makeFakeLocalchainBridge = (
+  zone,
+  onToBridge = () => {},
+  makeAddressFn = index => `${LOCALCHAIN_DEFAULT_ADDRESS}${index || ''}`,
+) => {
   /** @type {Remote<BridgeHandler>} */
   let hndlr;
   let lcaExecuteTxSequence = 0;
@@ -306,7 +311,7 @@ export const makeFakeLocalchainBridge = (zone, onToBridge = () => {}) => {
       trace('toBridge', type, method, params);
       switch (type) {
         case 'VLOCALCHAIN_ALLOCATE_ADDRESS': {
-          const address = `${LOCALCHAIN_DEFAULT_ADDRESS}${accountsCreated || ''}`;
+          const address = makeAddressFn(accountsCreated);
           accountsCreated += 1;
           return address;
         }

package/src/proposals/upgrade-orch-core-proposal.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"upgrade-orch-core-proposal.d.ts","sourceRoot":"","sources":["upgrade-orch-core-proposal.js"],"names":[],"mappings":"AAeO,wEAZI,eAAe,GAAG;IACxB,OAAO,EAAE;QACP,WAAW,EAAE,WAAW,CAAC;QACzB,QAAQ,EAAE,QAAQ,CACxB,MAAc,EACd,OAAe,sBAAsB,EAAE,gBAAgB,CAChD,CAAC;KACH,CAAC;CACH,WAED;IAAqE,OAAO,EAApE;QAAE,UAAU,EAAE;YAAE,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAAA;SAAE,CAAA;KAAE;CAC7D,iBAeA;AAEM;;;;;;;;;;;;;;;EAWL"}